fix(chat): never leave a client tool call unanswered on the server

apps/website/content/docs/chat/api/api-docs.json

@@ -6952,6 +6952,12 @@
         "description": "",
         "optional": true
       },
+      {
+        "name": "settleWithoutContinuing",
+        "type": "(toolCall: ToolCall, result: ClientToolResult) => void",
+        "description": "Settlement for calls that must NOT continue the run (user abort, teardown).",
+        "optional": true
+      },
       {
         "name": "shouldExecuteToolCall",
         "type": "(toolCall: ToolCall) => boolean",
@@ -7024,6 +7030,12 @@
       }
     ],
     "methods": [
+      {
+        "name": "flush",
+        "signature": "flush(): void | Promise<void>",
+        "description": "Make every result recorded via settle durable on the server\nWITHOUT continuing the run. No-op for adapters whose settle() is already\ndurable. Adapters that buffer locally MUST clear their buffer only on a\nsuccessful write, so a failure degrades to a later flush or submit.",
+        "params": []
+      },
       {
         "name": "resolve",
         "signature": "resolve(toolCallId: string, result: ClientToolResult): void",
@@ -8698,6 +8710,25 @@
     },
     "examples": []
   },
+  {
+    "name": "cancelledClientToolResult",
+    "kind": "function",
+    "description": "Result recorded when the user stops a run while a client tool is running.",
+    "signature": "cancelledClientToolResult(toolCallId: string): ClientToolResult",
+    "params": [
+      {
+        "name": "toolCallId",
+        "type": "string",
+        "description": "",
+        "optional": false
+      }
+    ],
+    "returns": {
+      "type": "ClientToolResult",
+      "description": ""
+    },
+    "examples": []
+  },
   {
     "name": "citationSourceVisual",
     "kind": "function",

apps/website/content/docs/middleware/api/api-docs.json

@@ -381,7 +381,7 @@
       {
         "name": "tenantId",
         "type": "string | null",
-        "description": "",
+        "description": "Tenant scope for every read and write. Defaults to `''` (the single-tenant scope).",
         "optional": true
       }
     ],
@@ -472,7 +472,7 @@
     "name": "THREADPLANE_CLIENT_TOOL_EXECUTIONS_SCHEMA",
     "kind": "const",
     "description": "",
-    "signature": "\"\\nCREATE TABLE IF NOT EXISTS threadplane_client_tool_executions (\\n  tenant_id     text,\\n  thread_id     text        NOT NULL,\\n  tool_call_id  text        NOT NULL,\\n  status        text        NOT NULL,\\n  result        jsonb,\\n  created_at    timestamptz NOT NULL DEFAULT now(),\\n  updated_at    timestamptz NOT NULL DEFAULT now(),\\n  PRIMARY KEY (thread_id, tool_call_id)\\n);\\n\"",
+    "signature": "\"\\nCREATE TABLE IF NOT EXISTS threadplane_client_tool_executions (\\n  tenant_id     text        NOT NULL DEFAULT '',\\n  thread_id     text        NOT NULL,\\n  tool_call_id  text        NOT NULL,\\n  status        text        NOT NULL,\\n  result        jsonb,\\n  created_at    timestamptz NOT NULL DEFAULT now(),\\n  updated_at    timestamptz NOT NULL DEFAULT now(),\\n  PRIMARY KEY (tenant_id, thread_id, tool_call_id)\\n);\\n\"",
     "examples": []
   },
   {