publ betaReference (MCP guide)
Open publ console

publ Reference

All toolsView Markdown source

autonomous_room_image_apply

Upload one autonomous room image in the Messenger app (pApp D00003). Requires change {action:"upload"}. Upload from this computer: target upload {kind:"local-file", filename, byteLength, sha256} returns one presigned PUT with its headers and the console room screen link; send the file, then call again with upload {kind:"complete", uploadId, parts:[{partNumber:1, etag}]}. The server never receives the file or downloads a link. Write: uploads to storage only; use the taskId in autonomous_room_create_apply (no roomId) or autonomous_room_image_replace_apply (same roomId). A lost receipt stays pending and is never resent; task_resume only observes, and prepared work needs the identical apply. Called without confirmToken it previews and returns a confirmToken; repeating the same input with it executes once.

Inputs

Field Required here Contract
target Yes object; upload: start with {kind:"local-file", filename, byteLength, sha256} for a JPEG, PNG or GIF under 10,000,000 bytes on this computer, send it with the returned PUT, then finish with {kind:"complete", uploadId, parts}. A Google Drive or other link must be downloaded to this computer first. Add roomId for an existing room; omit it for a new room.
target.upload Yes one of: local-file, more-parts, complete, cancel (by kind)
target.upload.filename Yes When target.upload.kind is local-file: string; min length 1; max length 240; pattern ^[^/\\:\x00-\x1f\x7f]+$; The name of the file on this computer, with its extension.
target.upload.byteLength Yes When target.upload.kind is local-file: integer; greater than 0; The exact file size in bytes (for example from wc -c < FILE or stat).
target.upload.sha256 No When target.upload.kind is local-file: string; pattern ^[0-9a-f]{64}$; The SHA-256 of the file in lowercase hex (shasum -a 256 FILE). Required when the upload answers UPLOAD_CHECKSUM_REQUIRED.
target.upload.uploadId Yes When target.upload.kind is more-parts: string; pattern ^upl_[A-Za-z0-9_-]{22}$
target.upload.fromPart Yes When target.upload.kind is more-parts: integer; minimum 1; maximum 10000
target.upload.uploadId Yes When target.upload.kind is complete: string; pattern ^upl_[A-Za-z0-9_-]{22}$
target.upload.parts Yes When target.upload.kind is complete: array; min items 1; max items 10000
target.upload.parts[].partNumber Yes When target.upload.kind is complete: integer; minimum 1; maximum 10000
target.upload.parts[].etag Yes When target.upload.kind is complete: string; min length 1; max length 200
target.upload.measured No When target.upload.kind is complete: object; What the video measures on this computer, read with measureCommand.
target.upload.measured.durationSeconds Yes When target.upload.kind is complete: number; maximum 1000000; greater than 0; Video duration in seconds (ffprobe format.duration).
target.upload.measured.frameRate Yes When target.upload.kind is complete: number; maximum 1000; greater than 0; Frames per second (ffprobe avg_frame_rate, for example 30000/1001 = 29.97).
target.upload.measured.width Yes When target.upload.kind is complete: integer; maximum 100000; greater than 0
target.upload.measured.height Yes When target.upload.kind is complete: integer; maximum 100000; greater than 0
target.upload.measured.frameRateMode No When target.upload.kind is complete: CFR, VFR; Constant or variable frame rate, when the tool reports it.
target.upload.measured.minFrameRate No When target.upload.kind is complete: number; maximum 1000; greater than 0
target.upload.measured.maxFrameRate No When target.upload.kind is complete: number; maximum 1000; greater than 0
target.upload.uploadId Yes When target.upload.kind is cancel: string; pattern ^upl_[A-Za-z0-9_-]{22}$
target.roomId No string; min length 1; max length 200; pattern ^[^/?#%\\\s]+$
change Yes object
change.action Yes upload
confirmToken No string; pattern ^ct[a-f\d]{32}$; The confirmToken from this tool's preview result. Omit it to preview; repeat the same input with it to execute.