release_parcel_with_signature
Updates parcel state to Picked Up, records the pickup timestamp and recipient name, securely saves the digital signature PNG layout to Firebase Storage, and emits a PARCEL_RELEASED telemetry event.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"businessId": "<businessId>",
"parcelId": "<parcelId>",
"pickedUpBy": "<pickedUpBy>"
},
"name": "release_parcel_with_signature"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| actor | No | Audit identity of the staff user or AI agent releasing the parcel. | |
| parcelId | Yes | Firestore parcel document ID under businesses/{businessId}/parcels/{parcelId}. | |
| businessId | Yes | Tenant business identifier owning the parcel (1-128 alphanumeric/dash/underscore chars). | |
| pickedUpBy | Yes | Full name of the resident or authorized person who signed for and collected the parcel (1-120 characters). | |
| datePickedUp | No | Optional pickup date in YYYY-MM-DD format (defaults to current UTC date). | |
| releaseNotes | No | Optional audit note recorded in PARCEL_RELEASED telemetry (maximum 500 characters). | |
| signatureUrl | No | Trusted HTTPS Firebase Cloud Storage URL of the captured recipient signature PNG. Either signatureUrl or signatureBase64 must be supplied. | |
| timePickedUp | No | Optional pickup time string (e.g. "4:15 PM", defaults to current UTC time). | |
| signatureBase64 | No | Base64-encoded PNG signature image (up to 2MB decoded). Automatically uploaded to businesses/{businessId}/signatures/{parcelId}.png when signatureUrl is omitted. |