@1claw/openapi-spec 0.43.1 → 0.43.2

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 +277 -16
  2. package/openapi.yaml +175 -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",
@@ -20227,6 +20402,92 @@
20227
20402
  }
20228
20403
  }
20229
20404
  },
20405
+ "AutomationCreatedResponse": {
20406
+ "allOf": [
20407
+ {
20408
+ "$ref": "#/components/schemas/AutomationResponse"
20409
+ },
20410
+ {
20411
+ "type": "object",
20412
+ "properties": {
20413
+ "webhook_url": {
20414
+ "type": "string",
20415
+ "description": "Full POST URL including token (one-time on create)"
20416
+ },
20417
+ "webhook_token": {
20418
+ "type": "string",
20419
+ "description": "whk_ token segment (one-time on create)"
20420
+ }
20421
+ }
20422
+ }
20423
+ ]
20424
+ },
20425
+ "WebhookTokenRotatedResponse": {
20426
+ "type": "object",
20427
+ "required": [
20428
+ "webhook_url",
20429
+ "webhook_token"
20430
+ ],
20431
+ "properties": {
20432
+ "webhook_url": {
20433
+ "type": "string"
20434
+ },
20435
+ "webhook_token": {
20436
+ "type": "string"
20437
+ }
20438
+ }
20439
+ },
20440
+ "AssistDraftResponse": {
20441
+ "type": "object",
20442
+ "required": [
20443
+ "draft",
20444
+ "reply"
20445
+ ],
20446
+ "properties": {
20447
+ "draft": {
20448
+ "type": "object",
20449
+ "additionalProperties": true
20450
+ },
20451
+ "reply": {
20452
+ "type": "string"
20453
+ }
20454
+ }
20455
+ },
20456
+ "AssistSessionResponse": {
20457
+ "type": "object",
20458
+ "required": [
20459
+ "access_token",
20460
+ "expires_in",
20461
+ "scopes",
20462
+ "cli_hint"
20463
+ ],
20464
+ "properties": {
20465
+ "access_token": {
20466
+ "type": "string"
20467
+ },
20468
+ "expires_in": {
20469
+ "type": "integer"
20470
+ },
20471
+ "scopes": {
20472
+ "type": "array",
20473
+ "items": {
20474
+ "type": "string"
20475
+ }
20476
+ },
20477
+ "runtime_id": {
20478
+ "type": "string",
20479
+ "format": "uuid",
20480
+ "nullable": true
20481
+ },
20482
+ "runtime_status": {
20483
+ "type": "string",
20484
+ "nullable": true
20485
+ },
20486
+ "cli_hint": {
20487
+ "type": "string"
20488
+ }
20489
+ }
20490
+ },
20230
20491
  "AutomationListResponse": {
20231
20492
  "type": "object",
20232
20493
  "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
@@ -13311,6 +13419,59 @@ components:
13311
13419
  type: string
13312
13420
  format: date-time
13313
13421
 
13422
+ AutomationCreatedResponse:
13423
+ allOf:
13424
+ - $ref: "#/components/schemas/AutomationResponse"
13425
+ - type: object
13426
+ properties:
13427
+ webhook_url:
13428
+ type: string
13429
+ description: Full POST URL including token (one-time on create)
13430
+ webhook_token:
13431
+ type: string
13432
+ description: whk_ token segment (one-time on create)
13433
+
13434
+ WebhookTokenRotatedResponse:
13435
+ type: object
13436
+ required: [webhook_url, webhook_token]
13437
+ properties:
13438
+ webhook_url:
13439
+ type: string
13440
+ webhook_token:
13441
+ type: string
13442
+
13443
+ AssistDraftResponse:
13444
+ type: object
13445
+ required: [draft, reply]
13446
+ properties:
13447
+ draft:
13448
+ type: object
13449
+ additionalProperties: true
13450
+ reply:
13451
+ type: string
13452
+
13453
+ AssistSessionResponse:
13454
+ type: object
13455
+ required: [access_token, expires_in, scopes, cli_hint]
13456
+ properties:
13457
+ access_token:
13458
+ type: string
13459
+ expires_in:
13460
+ type: integer
13461
+ scopes:
13462
+ type: array
13463
+ items:
13464
+ type: string
13465
+ runtime_id:
13466
+ type: string
13467
+ format: uuid
13468
+ nullable: true
13469
+ runtime_status:
13470
+ type: string
13471
+ nullable: true
13472
+ cli_hint:
13473
+ type: string
13474
+
13314
13475
  AutomationListResponse:
13315
13476
  type: object
13316
13477
  required: [automations]
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.2",
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": {