@1claw/openapi-spec 0.43.1 → 0.43.3

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (3) hide show
  1. package/openapi.json +366 -16
  2. package/openapi.yaml +242 -14
  3. package/package.json +1 -1
package/openapi.json CHANGED
@@ -2,8 +2,8 @@
2
2
  "openapi": "3.1.0",
3
3
  "info": {
4
4
  "title": "1Claw API",
5
- "version": "2.30.0",
6
- "description": "Secure secret management for AI agents. Provides vaults, secrets,\npolicy-based access control, agent identity, Intents API,\nsharing, billing, and audit logging. Automations (workflow_spec),\ncloud runtimes with interactive shell sessions, agent memory,\nand discovery.\n\nAll endpoints require JWT Bearer authentication unless marked with\n`security: []`.\n",
5
+ "version": "2.31.0",
6
+ "description": "Secure secret management for AI agents. Provides vaults, secrets,\npolicy-based access control, agent identity, Intents API,\nsharing, billing, and audit logging. Automations (workflow_spec,\nwebhook tokens, event triggers, Assist), cloud runtimes with\ninteractive shell sessions, agent memory, and discovery.\n\nAll endpoints require JWT Bearer authentication unless marked with\n`security: []`.\n",
7
7
  "contact": {
8
8
  "email": "ops@1claw.xyz"
9
9
  }
@@ -10400,11 +10400,11 @@
10400
10400
  },
10401
10401
  "responses": {
10402
10402
  "201": {
10403
- "description": "Automation created",
10403
+ "description": "Automation created (includes one-time webhook credentials when trigger_type is webhook)",
10404
10404
  "content": {
10405
10405
  "application/json": {
10406
10406
  "schema": {
10407
- "$ref": "#/components/schemas/AutomationResponse"
10407
+ "$ref": "#/components/schemas/AutomationCreatedResponse"
10408
10408
  }
10409
10409
  }
10410
10410
  }
@@ -10648,6 +10648,183 @@
10648
10648
  }
10649
10649
  }
10650
10650
  },
10651
+ "/v1/automations/assist/draft": {
10652
+ "post": {
10653
+ "tags": [
10654
+ "Automations"
10655
+ ],
10656
+ "summary": "Draft automation from natural language",
10657
+ "operationId": "assistDraftAutomation",
10658
+ "requestBody": {
10659
+ "required": true,
10660
+ "content": {
10661
+ "application/json": {
10662
+ "schema": {
10663
+ "type": "object",
10664
+ "required": [
10665
+ "message"
10666
+ ],
10667
+ "properties": {
10668
+ "message": {
10669
+ "type": "string"
10670
+ },
10671
+ "agent_id": {
10672
+ "type": "string",
10673
+ "format": "uuid"
10674
+ },
10675
+ "timezone": {
10676
+ "type": "string"
10677
+ }
10678
+ }
10679
+ }
10680
+ }
10681
+ }
10682
+ },
10683
+ "responses": {
10684
+ "200": {
10685
+ "description": "Reviewable automation draft",
10686
+ "content": {
10687
+ "application/json": {
10688
+ "schema": {
10689
+ "$ref": "#/components/schemas/AssistDraftResponse"
10690
+ }
10691
+ }
10692
+ }
10693
+ },
10694
+ "401": {
10695
+ "$ref": "#/components/responses/Unauthorized"
10696
+ }
10697
+ }
10698
+ }
10699
+ },
10700
+ "/v1/automations/assist/session": {
10701
+ "post": {
10702
+ "tags": [
10703
+ "Automations"
10704
+ ],
10705
+ "summary": "Mint short-lived Assist session token",
10706
+ "operationId": "assistAutomationSession",
10707
+ "requestBody": {
10708
+ "content": {
10709
+ "application/json": {
10710
+ "schema": {
10711
+ "type": "object",
10712
+ "properties": {
10713
+ "runtime_id": {
10714
+ "type": "string",
10715
+ "format": "uuid"
10716
+ }
10717
+ }
10718
+ }
10719
+ }
10720
+ }
10721
+ },
10722
+ "responses": {
10723
+ "200": {
10724
+ "description": "Assist session token",
10725
+ "content": {
10726
+ "application/json": {
10727
+ "schema": {
10728
+ "$ref": "#/components/schemas/AssistSessionResponse"
10729
+ }
10730
+ }
10731
+ }
10732
+ },
10733
+ "401": {
10734
+ "$ref": "#/components/responses/Unauthorized"
10735
+ }
10736
+ }
10737
+ }
10738
+ },
10739
+ "/v1/automations/webhook/{automationId}/{token}": {
10740
+ "post": {
10741
+ "tags": [
10742
+ "Automations"
10743
+ ],
10744
+ "summary": "Public webhook trigger",
10745
+ "operationId": "webhookTriggerAutomation",
10746
+ "security": [],
10747
+ "parameters": [
10748
+ {
10749
+ "name": "automationId",
10750
+ "in": "path",
10751
+ "required": true,
10752
+ "schema": {
10753
+ "type": "string",
10754
+ "format": "uuid"
10755
+ }
10756
+ },
10757
+ {
10758
+ "name": "token",
10759
+ "in": "path",
10760
+ "required": true,
10761
+ "schema": {
10762
+ "type": "string",
10763
+ "description": "whk_ prefixed webhook token (SHA-256 verified server-side)"
10764
+ }
10765
+ }
10766
+ ],
10767
+ "responses": {
10768
+ "201": {
10769
+ "description": "Automation run queued",
10770
+ "content": {
10771
+ "application/json": {
10772
+ "schema": {
10773
+ "$ref": "#/components/schemas/AutomationRunResponse"
10774
+ }
10775
+ }
10776
+ }
10777
+ },
10778
+ "401": {
10779
+ "$ref": "#/components/responses/Unauthorized"
10780
+ },
10781
+ "404": {
10782
+ "$ref": "#/components/responses/NotFound"
10783
+ }
10784
+ }
10785
+ }
10786
+ },
10787
+ "/v1/automations/{automationId}/rotate-webhook-token": {
10788
+ "post": {
10789
+ "tags": [
10790
+ "Automations"
10791
+ ],
10792
+ "summary": "Rotate webhook token",
10793
+ "operationId": "rotateAutomationWebhookToken",
10794
+ "parameters": [
10795
+ {
10796
+ "name": "automationId",
10797
+ "in": "path",
10798
+ "required": true,
10799
+ "schema": {
10800
+ "type": "string",
10801
+ "format": "uuid"
10802
+ }
10803
+ }
10804
+ ],
10805
+ "responses": {
10806
+ "200": {
10807
+ "description": "New one-time webhook URL and token",
10808
+ "content": {
10809
+ "application/json": {
10810
+ "schema": {
10811
+ "$ref": "#/components/schemas/WebhookTokenRotatedResponse"
10812
+ }
10813
+ }
10814
+ }
10815
+ },
10816
+ "400": {
10817
+ "$ref": "#/components/responses/BadRequest"
10818
+ },
10819
+ "401": {
10820
+ "$ref": "#/components/responses/Unauthorized"
10821
+ },
10822
+ "404": {
10823
+ "$ref": "#/components/responses/NotFound"
10824
+ }
10825
+ }
10826
+ }
10827
+ },
10651
10828
  "/v1/runtimes": {
10652
10829
  "post": {
10653
10830
  "tags": [
@@ -10917,21 +11094,13 @@
10917
11094
  }
10918
11095
  },
10919
11096
  {
10920
- "name": "since",
10921
- "in": "query",
10922
- "schema": {
10923
- "type": "string",
10924
- "format": "date-time"
10925
- },
10926
- "description": "Only return logs after this timestamp"
10927
- },
10928
- {
10929
- "name": "limit",
11097
+ "name": "tail",
10930
11098
  "in": "query",
10931
11099
  "schema": {
10932
11100
  "type": "integer",
10933
11101
  "default": 100
10934
- }
11102
+ },
11103
+ "description": "Number of recent log lines to return"
10935
11104
  }
10936
11105
  ],
10937
11106
  "responses": {
@@ -10941,11 +11110,17 @@
10941
11110
  "application/json": {
10942
11111
  "schema": {
10943
11112
  "type": "object",
11113
+ "required": [
11114
+ "entries"
11115
+ ],
10944
11116
  "properties": {
10945
- "lines": {
11117
+ "entries": {
10946
11118
  "type": "array",
10947
11119
  "items": {
10948
11120
  "type": "object",
11121
+ "required": [
11122
+ "message"
11123
+ ],
10949
11124
  "properties": {
10950
11125
  "timestamp": {
10951
11126
  "type": "string",
@@ -11106,6 +11281,67 @@
11106
11281
  }
11107
11282
  }
11108
11283
  },
11284
+ "/v1/runtimes/{runtimeId}/chat": {
11285
+ "post": {
11286
+ "tags": [
11287
+ "Runtimes"
11288
+ ],
11289
+ "summary": "Chat with a running runtime agent",
11290
+ "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",
11291
+ "operationId": "runtimeChat",
11292
+ "parameters": [
11293
+ {
11294
+ "name": "runtimeId",
11295
+ "in": "path",
11296
+ "required": true,
11297
+ "schema": {
11298
+ "type": "string",
11299
+ "format": "uuid"
11300
+ }
11301
+ }
11302
+ ],
11303
+ "requestBody": {
11304
+ "required": true,
11305
+ "content": {
11306
+ "application/json": {
11307
+ "schema": {
11308
+ "$ref": "#/components/schemas/RuntimeChatRequest"
11309
+ }
11310
+ }
11311
+ }
11312
+ },
11313
+ "responses": {
11314
+ "200": {
11315
+ "description": "Chat completion (JSON) or SSE stream",
11316
+ "content": {
11317
+ "application/json": {
11318
+ "schema": {
11319
+ "type": "object",
11320
+ "additionalProperties": true
11321
+ }
11322
+ },
11323
+ "text/event-stream": {
11324
+ "schema": {
11325
+ "type": "string"
11326
+ }
11327
+ }
11328
+ }
11329
+ },
11330
+ "400": {
11331
+ "$ref": "#/components/responses/BadRequest"
11332
+ },
11333
+ "401": {
11334
+ "$ref": "#/components/responses/Unauthorized"
11335
+ },
11336
+ "403": {
11337
+ "$ref": "#/components/responses/Forbidden"
11338
+ },
11339
+ "404": {
11340
+ "$ref": "#/components/responses/NotFound"
11341
+ }
11342
+ }
11343
+ }
11344
+ },
11109
11345
  "/v1/agents/{agent_id}/memory": {
11110
11346
  "get": {
11111
11347
  "tags": [
@@ -20227,6 +20463,92 @@
20227
20463
  }
20228
20464
  }
20229
20465
  },
20466
+ "AutomationCreatedResponse": {
20467
+ "allOf": [
20468
+ {
20469
+ "$ref": "#/components/schemas/AutomationResponse"
20470
+ },
20471
+ {
20472
+ "type": "object",
20473
+ "properties": {
20474
+ "webhook_url": {
20475
+ "type": "string",
20476
+ "description": "Full POST URL including token (one-time on create)"
20477
+ },
20478
+ "webhook_token": {
20479
+ "type": "string",
20480
+ "description": "whk_ token segment (one-time on create)"
20481
+ }
20482
+ }
20483
+ }
20484
+ ]
20485
+ },
20486
+ "WebhookTokenRotatedResponse": {
20487
+ "type": "object",
20488
+ "required": [
20489
+ "webhook_url",
20490
+ "webhook_token"
20491
+ ],
20492
+ "properties": {
20493
+ "webhook_url": {
20494
+ "type": "string"
20495
+ },
20496
+ "webhook_token": {
20497
+ "type": "string"
20498
+ }
20499
+ }
20500
+ },
20501
+ "AssistDraftResponse": {
20502
+ "type": "object",
20503
+ "required": [
20504
+ "draft",
20505
+ "reply"
20506
+ ],
20507
+ "properties": {
20508
+ "draft": {
20509
+ "type": "object",
20510
+ "additionalProperties": true
20511
+ },
20512
+ "reply": {
20513
+ "type": "string"
20514
+ }
20515
+ }
20516
+ },
20517
+ "AssistSessionResponse": {
20518
+ "type": "object",
20519
+ "required": [
20520
+ "access_token",
20521
+ "expires_in",
20522
+ "scopes",
20523
+ "cli_hint"
20524
+ ],
20525
+ "properties": {
20526
+ "access_token": {
20527
+ "type": "string"
20528
+ },
20529
+ "expires_in": {
20530
+ "type": "integer"
20531
+ },
20532
+ "scopes": {
20533
+ "type": "array",
20534
+ "items": {
20535
+ "type": "string"
20536
+ }
20537
+ },
20538
+ "runtime_id": {
20539
+ "type": "string",
20540
+ "format": "uuid",
20541
+ "nullable": true
20542
+ },
20543
+ "runtime_status": {
20544
+ "type": "string",
20545
+ "nullable": true
20546
+ },
20547
+ "cli_hint": {
20548
+ "type": "string"
20549
+ }
20550
+ }
20551
+ },
20230
20552
  "AutomationListResponse": {
20231
20553
  "type": "object",
20232
20554
  "required": [
@@ -20623,6 +20945,34 @@
20623
20945
  }
20624
20946
  }
20625
20947
  },
20948
+ "RuntimeChatRequest": {
20949
+ "type": "object",
20950
+ "description": "Chat with the agent inside a runtime. Provide `message` and/or\na full OpenAI-style `messages` array (ephemeral history).\n",
20951
+ "properties": {
20952
+ "message": {
20953
+ "type": "string",
20954
+ "description": "Latest user message"
20955
+ },
20956
+ "messages": {
20957
+ "type": "array",
20958
+ "items": {
20959
+ "type": "object",
20960
+ "additionalProperties": true
20961
+ },
20962
+ "description": "OpenAI chat messages (optional history)"
20963
+ },
20964
+ "model": {
20965
+ "type": "string"
20966
+ },
20967
+ "provider": {
20968
+ "type": "string"
20969
+ },
20970
+ "stream": {
20971
+ "type": "boolean",
20972
+ "description": "Request SSE streaming (default true when Accept is text/event-stream)"
20973
+ }
20974
+ }
20975
+ },
20626
20976
  "MemoryEntry": {
20627
20977
  "type": "object",
20628
20978
  "required": [
package/openapi.yaml CHANGED
@@ -2,13 +2,13 @@ openapi: 3.1.0
2
2
 
3
3
  info:
4
4
  title: 1Claw API
5
- version: 2.30.0
5
+ version: 2.31.0
6
6
  description: |
7
7
  Secure secret management for AI agents. Provides vaults, secrets,
8
8
  policy-based access control, agent identity, Intents API,
9
- sharing, billing, and audit logging. Automations (workflow_spec),
10
- cloud runtimes with interactive shell sessions, agent memory,
11
- and discovery.
9
+ sharing, billing, and audit logging. Automations (workflow_spec,
10
+ webhook tokens, event triggers, Assist), cloud runtimes with
11
+ interactive shell sessions, agent memory, and discovery.
12
12
 
13
13
  All endpoints require JWT Bearer authentication unless marked with
14
14
  `security: []`.
@@ -6628,11 +6628,11 @@ paths:
6628
6628
  $ref: "#/components/schemas/CreateAutomationRequest"
6629
6629
  responses:
6630
6630
  "201":
6631
- description: Automation created
6631
+ description: Automation created (includes one-time webhook credentials when trigger_type is webhook)
6632
6632
  content:
6633
6633
  application/json:
6634
6634
  schema:
6635
- $ref: "#/components/schemas/AutomationResponse"
6635
+ $ref: "#/components/schemas/AutomationCreatedResponse"
6636
6636
  "400":
6637
6637
  $ref: "#/components/responses/BadRequest"
6638
6638
  "401":
@@ -6781,6 +6781,117 @@ paths:
6781
6781
  "404":
6782
6782
  $ref: "#/components/responses/NotFound"
6783
6783
 
6784
+ /v1/automations/assist/draft:
6785
+ post:
6786
+ tags: [Automations]
6787
+ summary: Draft automation from natural language
6788
+ operationId: assistDraftAutomation
6789
+ requestBody:
6790
+ required: true
6791
+ content:
6792
+ application/json:
6793
+ schema:
6794
+ type: object
6795
+ required: [message]
6796
+ properties:
6797
+ message:
6798
+ type: string
6799
+ agent_id:
6800
+ type: string
6801
+ format: uuid
6802
+ timezone:
6803
+ type: string
6804
+ responses:
6805
+ "200":
6806
+ description: Reviewable automation draft
6807
+ content:
6808
+ application/json:
6809
+ schema:
6810
+ $ref: "#/components/schemas/AssistDraftResponse"
6811
+ "401":
6812
+ $ref: "#/components/responses/Unauthorized"
6813
+
6814
+ /v1/automations/assist/session:
6815
+ post:
6816
+ tags: [Automations]
6817
+ summary: Mint short-lived Assist session token
6818
+ operationId: assistAutomationSession
6819
+ requestBody:
6820
+ content:
6821
+ application/json:
6822
+ schema:
6823
+ type: object
6824
+ properties:
6825
+ runtime_id:
6826
+ type: string
6827
+ format: uuid
6828
+ responses:
6829
+ "200":
6830
+ description: Assist session token
6831
+ content:
6832
+ application/json:
6833
+ schema:
6834
+ $ref: "#/components/schemas/AssistSessionResponse"
6835
+ "401":
6836
+ $ref: "#/components/responses/Unauthorized"
6837
+
6838
+ /v1/automations/webhook/{automationId}/{token}:
6839
+ post:
6840
+ tags: [Automations]
6841
+ summary: Public webhook trigger
6842
+ operationId: webhookTriggerAutomation
6843
+ security: []
6844
+ parameters:
6845
+ - name: automationId
6846
+ in: path
6847
+ required: true
6848
+ schema:
6849
+ type: string
6850
+ format: uuid
6851
+ - name: token
6852
+ in: path
6853
+ required: true
6854
+ schema:
6855
+ type: string
6856
+ description: whk_ prefixed webhook token (SHA-256 verified server-side)
6857
+ responses:
6858
+ "201":
6859
+ description: Automation run queued
6860
+ content:
6861
+ application/json:
6862
+ schema:
6863
+ $ref: "#/components/schemas/AutomationRunResponse"
6864
+ "401":
6865
+ $ref: "#/components/responses/Unauthorized"
6866
+ "404":
6867
+ $ref: "#/components/responses/NotFound"
6868
+
6869
+ /v1/automations/{automationId}/rotate-webhook-token:
6870
+ post:
6871
+ tags: [Automations]
6872
+ summary: Rotate webhook token
6873
+ operationId: rotateAutomationWebhookToken
6874
+ parameters:
6875
+ - name: automationId
6876
+ in: path
6877
+ required: true
6878
+ schema:
6879
+ type: string
6880
+ format: uuid
6881
+ responses:
6882
+ "200":
6883
+ description: New one-time webhook URL and token
6884
+ content:
6885
+ application/json:
6886
+ schema:
6887
+ $ref: "#/components/schemas/WebhookTokenRotatedResponse"
6888
+ "400":
6889
+ $ref: "#/components/responses/BadRequest"
6890
+ "401":
6891
+ $ref: "#/components/responses/Unauthorized"
6892
+ "404":
6893
+ $ref: "#/components/responses/NotFound"
6894
+
6784
6895
  # ---------------------------------------------------------------------------
6785
6896
  # Runtimes
6786
6897
  # ---------------------------------------------------------------------------
@@ -6953,17 +7064,12 @@ paths:
6953
7064
  schema:
6954
7065
  type: string
6955
7066
  format: uuid
6956
- - name: since
6957
- in: query
6958
- schema:
6959
- type: string
6960
- format: date-time
6961
- description: Only return logs after this timestamp
6962
- - name: limit
7067
+ - name: tail
6963
7068
  in: query
6964
7069
  schema:
6965
7070
  type: integer
6966
7071
  default: 100
7072
+ description: Number of recent log lines to return
6967
7073
  responses:
6968
7074
  "200":
6969
7075
  description: Runtime logs
@@ -6971,11 +7077,13 @@ paths:
6971
7077
  application/json:
6972
7078
  schema:
6973
7079
  type: object
7080
+ required: [entries]
6974
7081
  properties:
6975
- lines:
7082
+ entries:
6976
7083
  type: array
6977
7084
  items:
6978
7085
  type: object
7086
+ required: [message]
6979
7087
  properties:
6980
7088
  timestamp:
6981
7089
  type: string
@@ -7082,6 +7190,50 @@ paths:
7082
7190
  "404":
7083
7191
  $ref: "#/components/responses/NotFound"
7084
7192
 
7193
+ /v1/runtimes/{runtimeId}/chat:
7194
+ post:
7195
+ tags: [Runtimes]
7196
+ summary: Chat with a running runtime agent
7197
+ description: |
7198
+ Human-only. Proxies to the runtime container's OpenAI-compatible
7199
+ `POST /v1/chat/completions` (hermes / openclaw / openclaude chat bridge).
7200
+ Starts the runtime if stopped. Streams SSE when `Accept: text/event-stream`
7201
+ or `stream: true`. Conversation history is ephemeral (pass `messages`).
7202
+ Requires a public URL (shell access, Shroud sidecar, or HTTP hosting).
7203
+ operationId: runtimeChat
7204
+ parameters:
7205
+ - name: runtimeId
7206
+ in: path
7207
+ required: true
7208
+ schema:
7209
+ type: string
7210
+ format: uuid
7211
+ requestBody:
7212
+ required: true
7213
+ content:
7214
+ application/json:
7215
+ schema:
7216
+ $ref: "#/components/schemas/RuntimeChatRequest"
7217
+ responses:
7218
+ "200":
7219
+ description: Chat completion (JSON) or SSE stream
7220
+ content:
7221
+ application/json:
7222
+ schema:
7223
+ type: object
7224
+ additionalProperties: true
7225
+ text/event-stream:
7226
+ schema:
7227
+ type: string
7228
+ "400":
7229
+ $ref: "#/components/responses/BadRequest"
7230
+ "401":
7231
+ $ref: "#/components/responses/Unauthorized"
7232
+ "403":
7233
+ $ref: "#/components/responses/Forbidden"
7234
+ "404":
7235
+ $ref: "#/components/responses/NotFound"
7236
+
7085
7237
  # ---------------------------------------------------------------------------
7086
7238
  # Agent Memory
7087
7239
  # ---------------------------------------------------------------------------
@@ -13311,6 +13463,59 @@ components:
13311
13463
  type: string
13312
13464
  format: date-time
13313
13465
 
13466
+ AutomationCreatedResponse:
13467
+ allOf:
13468
+ - $ref: "#/components/schemas/AutomationResponse"
13469
+ - type: object
13470
+ properties:
13471
+ webhook_url:
13472
+ type: string
13473
+ description: Full POST URL including token (one-time on create)
13474
+ webhook_token:
13475
+ type: string
13476
+ description: whk_ token segment (one-time on create)
13477
+
13478
+ WebhookTokenRotatedResponse:
13479
+ type: object
13480
+ required: [webhook_url, webhook_token]
13481
+ properties:
13482
+ webhook_url:
13483
+ type: string
13484
+ webhook_token:
13485
+ type: string
13486
+
13487
+ AssistDraftResponse:
13488
+ type: object
13489
+ required: [draft, reply]
13490
+ properties:
13491
+ draft:
13492
+ type: object
13493
+ additionalProperties: true
13494
+ reply:
13495
+ type: string
13496
+
13497
+ AssistSessionResponse:
13498
+ type: object
13499
+ required: [access_token, expires_in, scopes, cli_hint]
13500
+ properties:
13501
+ access_token:
13502
+ type: string
13503
+ expires_in:
13504
+ type: integer
13505
+ scopes:
13506
+ type: array
13507
+ items:
13508
+ type: string
13509
+ runtime_id:
13510
+ type: string
13511
+ format: uuid
13512
+ nullable: true
13513
+ runtime_status:
13514
+ type: string
13515
+ nullable: true
13516
+ cli_hint:
13517
+ type: string
13518
+
13314
13519
  AutomationListResponse:
13315
13520
  type: object
13316
13521
  required: [automations]
@@ -13563,6 +13768,29 @@ components:
13563
13768
  max_session_minutes:
13564
13769
  type: integer
13565
13770
 
13771
+ RuntimeChatRequest:
13772
+ type: object
13773
+ description: |
13774
+ Chat with the agent inside a runtime. Provide `message` and/or
13775
+ a full OpenAI-style `messages` array (ephemeral history).
13776
+ properties:
13777
+ message:
13778
+ type: string
13779
+ description: Latest user message
13780
+ messages:
13781
+ type: array
13782
+ items:
13783
+ type: object
13784
+ additionalProperties: true
13785
+ description: OpenAI chat messages (optional history)
13786
+ model:
13787
+ type: string
13788
+ provider:
13789
+ type: string
13790
+ stream:
13791
+ type: boolean
13792
+ description: Request SSE streaming (default true when Accept is text/event-stream)
13793
+
13566
13794
  # --- Agent Memory ---
13567
13795
 
13568
13796
  MemoryEntry:
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@1claw/openapi-spec",
3
- "version": "0.43.1",
3
+ "version": "0.43.3",
4
4
  "description": "OpenAPI 3.1.0 specification for the 1Claw Vault API \u2014 generate clients in any language",
5
5
  "license": "MIT",
6
6
  "repository": {