Skip to content

ulams operations

Generated from front/cli (ulams schema)

Show the state of a long-running operation by its handle.

Handles come from commands run with –no-wait (or from a timeout, exit 10): :, e.g. video:42.

Kind: read (idempotent). Stability: stable. MCP tool: operations_get. Scopes: none.

Flag Type Required Description
--handle (positional) string yes Operation handle :.
Terminal window
# Check a video
ulams operations get video:42 --json
Input JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"type": "object",
"properties": {
"handle": {
"type": "string",
"description": "Operation handle <kind>:<id>."
}
},
"required": [
"handle"
]
}

List the operation kinds this CLI can wait for.

Kind: read (idempotent). Stability: stable. MCP tool: operations_kinds. Scopes: none.

Terminal window
# Kinds
ulams operations kinds --json
Input JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"type": "object",
"properties": {}
}

Wait until an operation finishes (exit 10 on timeout).

Kind: read (idempotent). Stability: stable. MCP tool: operations_wait. Scopes: none.

Flag Type Required Description
--handle (positional) string yes Operation handle :.
Terminal window
# Wait up to 5 minutes
ulams operations wait video:42 --timeout 300 --json
Input JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"type": "object",
"properties": {
"handle": {
"type": "string",
"description": "Operation handle <kind>:<id>."
}
},
"required": [
"handle"
]
}