@1claw/openapi-spec 0.43.2 → 0.43.3

package/openapi.json

@@ -11281,6 +11281,67 @@
         }
       }
     },
+    "/v1/runtimes/{runtimeId}/chat": {
+      "post": {
+        "tags": [
+          "Runtimes"
+        ],
+        "summary": "Chat with a running runtime agent",
+        "description": "Human-only. Proxies to the runtime container's OpenAI-compatible\n`POST /v1/chat/completions` (hermes / openclaw / openclaude chat bridge).\nStarts the runtime if stopped. Streams SSE when `Accept: text/event-stream`\nor `stream: true`. Conversation history is ephemeral (pass `messages`).\nRequires a public URL (shell access, Shroud sidecar, or HTTP hosting).\n",
+        "operationId": "runtimeChat",
+        "parameters": [
+          {
+            "name": "runtimeId",
+            "in": "path",
+            "required": true,
+            "schema": {
+              "type": "string",
+              "format": "uuid"
+            }
+          }
+        ],
+        "requestBody": {
+          "required": true,
+          "content": {
+            "application/json": {
+              "schema": {
+                "$ref": "#/components/schemas/RuntimeChatRequest"
+              }
+            }
+          }
+        },
+        "responses": {
+          "200": {
+            "description": "Chat completion (JSON) or SSE stream",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "type": "object",
+                  "additionalProperties": true
+                }
+              },
+              "text/event-stream": {
+                "schema": {
+                  "type": "string"
+                }
+              }
+            }
+          },
+          "400": {
+            "$ref": "#/components/responses/BadRequest"
+          },
+          "401": {
+            "$ref": "#/components/responses/Unauthorized"
+          },
+          "403": {
+            "$ref": "#/components/responses/Forbidden"
+          },
+          "404": {
+            "$ref": "#/components/responses/NotFound"
+          }
+        }
+      }
+    },
     "/v1/agents/{agent_id}/memory": {
       "get": {
         "tags": [
@@ -20884,6 +20945,34 @@
           }
         }
       },
+      "RuntimeChatRequest": {
+        "type": "object",
+        "description": "Chat with the agent inside a runtime. Provide `message` and/or\na full OpenAI-style `messages` array (ephemeral history).\n",
+        "properties": {
+          "message": {
+            "type": "string",
+            "description": "Latest user message"
+          },
+          "messages": {
+            "type": "array",
+            "items": {
+              "type": "object",
+              "additionalProperties": true
+            },
+            "description": "OpenAI chat messages (optional history)"
+          },
+          "model": {
+            "type": "string"
+          },
+          "provider": {
+            "type": "string"
+          },
+          "stream": {
+            "type": "boolean",
+            "description": "Request SSE streaming (default true when Accept is text/event-stream)"
+          }
+        }
+      },
       "MemoryEntry": {
         "type": "object",
         "required": [

package/openapi.yaml

@@ -7190,6 +7190,50 @@ paths:
                 "404":
                     $ref: "#/components/responses/NotFound"
 
+    /v1/runtimes/{runtimeId}/chat:
+        post:
+            tags: [Runtimes]
+            summary: Chat with a running runtime agent
+            description: |
+                Human-only. Proxies to the runtime container's OpenAI-compatible
+                `POST /v1/chat/completions` (hermes / openclaw / openclaude chat bridge).
+                Starts the runtime if stopped. Streams SSE when `Accept: text/event-stream`
+                or `stream: true`. Conversation history is ephemeral (pass `messages`).
+                Requires a public URL (shell access, Shroud sidecar, or HTTP hosting).
+            operationId: runtimeChat
+            parameters:
+                - name: runtimeId
+                  in: path
+                  required: true
+                  schema:
+                      type: string
+                      format: uuid
+            requestBody:
+                required: true
+                content:
+                    application/json:
+                        schema:
+                            $ref: "#/components/schemas/RuntimeChatRequest"
+            responses:
+                "200":
+                    description: Chat completion (JSON) or SSE stream
+                    content:
+                        application/json:
+                            schema:
+                                type: object
+                                additionalProperties: true
+                        text/event-stream:
+                            schema:
+                                type: string
+                "400":
+                    $ref: "#/components/responses/BadRequest"
+                "401":
+                    $ref: "#/components/responses/Unauthorized"
+                "403":
+                    $ref: "#/components/responses/Forbidden"
+                "404":
+                    $ref: "#/components/responses/NotFound"
+
     # ---------------------------------------------------------------------------
     # Agent Memory
     # ---------------------------------------------------------------------------
@@ -13724,6 +13768,29 @@ components:
                 max_session_minutes:
                     type: integer
 
+        RuntimeChatRequest:
+            type: object
+            description: |
+                Chat with the agent inside a runtime. Provide `message` and/or
+                a full OpenAI-style `messages` array (ephemeral history).
+            properties:
+                message:
+                    type: string
+                    description: Latest user message
+                messages:
+                    type: array
+                    items:
+                        type: object
+                        additionalProperties: true
+                    description: OpenAI chat messages (optional history)
+                model:
+                    type: string
+                provider:
+                    type: string
+                stream:
+                    type: boolean
+                    description: Request SSE streaming (default true when Accept is text/event-stream)
+
         # --- Agent Memory ---
 
         MemoryEntry:

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@1claw/openapi-spec",
-  "version": "0.43.2",
+  "version": "0.43.3",
   "description": "OpenAPI 3.1.0 specification for the 1Claw Vault API \u2014 generate clients in any language",
   "license": "MIT",
   "repository": {