Deferred tool result

App backend は user message を作らず、model に tool を再呼び出しさせずに現在の tool call result を defer できます。Core が理解するのは operation id と opaque app data だけで、login、approval、payment、device pairing などは app logic です。

JSON

{
  "_sota": {
    "deferredToolResult": {
      "operationId": "app-defined-globally-unique-id",
      "data": { "anyAppOwnedValue": true }
    }
  }
}

Core は exact run、tool call、tool name、installation、environment を登録し、output-pending と exact panel の pendingToolResults を公開します。Model はまだ tool result を受け取りません。

YAML

coreToolGrants:
  - tool: core.app-operations.complete
    scope: write
  # 長寿命 job callback token が必要な場合のみ:
  - tool: core.tokens.issueJobCallback
    scope: write

Callback は app backend から Core origin へ送ります。Bearer value は original invocation の x-sota-core-token header で受け取った delegated capability です。

コード

POST /v1/app-operations/app-defined-globally-unique-id/complete
Authorization: Bearer <delegated-token>
Content-Type: application/json

{
  "status": "completed",
  "result": { "events": [] }
}

Failure は任意の error と status: "failed" で返します。Completion は original tool result に atomic に結び付き、同じ agent run が続きます。Parallel call は個別 operation id を持ち、その step の全 call が settle 後に model が続行します。

JSON

{
  "status": "failed",
  "error": {
    "code": "ACTION_NOT_COMPLETED",
    "message": "The requested action was not completed"
  }
}

core.app-operations.complete:write を grant します。
Operation id は trim 済み 1–200 文字で、tool call ごとに globally unique。Identical retry は idempotent です。
登録は deferred response 受信後なので app_operation_not_found を bounded backoff で retry します。
60 秒 delegation token より長い場合、original invocation が valid な間に job callback token へ交換し、安全に保存して x-sota-job-id を送ります。
data は小さく secret を含めません。Core には opaque でも client-visible であり、app UI で shape を narrow します。
現在の primitive は live run に結び付きます。Stop／steer は pending operation を operation_cancelled にします。App expiry は failed completion で表現し、background job queue として使いません。