@1claw/openapi-spec 0.45.0 → 0.46.0

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 +427 -3
  2. package/openapi.yaml +290 -3
  3. package/package.json +1 -1
package/openapi.json CHANGED
@@ -2,7 +2,7 @@
2
2
  "openapi": "3.1.0",
3
3
  "info": {
4
4
  "title": "1Claw API",
5
- "version": "2.34.0",
5
+ "version": "2.35.0",
6
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"
@@ -162,6 +162,10 @@
162
162
  {
163
163
  "name": "OAuth Connect",
164
164
  "description": "OAuth connected accounts for agents (provider registry, connect flows, app credentials)"
165
+ },
166
+ {
167
+ "name": "Delegations",
168
+ "description": "Agent-to-agent delegation management (human-controlled authorization)"
165
169
  }
166
170
  ],
167
171
  "paths": {
@@ -3856,6 +3860,237 @@
3856
3860
  }
3857
3861
  }
3858
3862
  },
3863
+ "/v1/agents/{agent_id}/delegations": {
3864
+ "post": {
3865
+ "tags": [
3866
+ "Delegations"
3867
+ ],
3868
+ "summary": "Create a delegation",
3869
+ "description": "Grant an agent (delegator) permission to delegate tasks to another agent (delegate).\nHuman-only — agents cannot create their own delegations.\n",
3870
+ "operationId": "createDelegation",
3871
+ "parameters": [
3872
+ {
3873
+ "$ref": "#/components/parameters/AgentId"
3874
+ }
3875
+ ],
3876
+ "requestBody": {
3877
+ "required": true,
3878
+ "content": {
3879
+ "application/json": {
3880
+ "schema": {
3881
+ "$ref": "#/components/schemas/CreateDelegationRequest"
3882
+ }
3883
+ }
3884
+ }
3885
+ },
3886
+ "responses": {
3887
+ "201": {
3888
+ "description": "Delegation created",
3889
+ "content": {
3890
+ "application/json": {
3891
+ "schema": {
3892
+ "$ref": "#/components/schemas/DelegationResponse"
3893
+ }
3894
+ }
3895
+ }
3896
+ },
3897
+ "400": {
3898
+ "$ref": "#/components/responses/BadRequest"
3899
+ },
3900
+ "403": {
3901
+ "$ref": "#/components/responses/Forbidden"
3902
+ },
3903
+ "409": {
3904
+ "description": "Delegation already exists for this delegator/delegate pair",
3905
+ "content": {
3906
+ "application/json": {
3907
+ "schema": {
3908
+ "$ref": "#/components/schemas/ProblemDetails"
3909
+ }
3910
+ }
3911
+ }
3912
+ }
3913
+ }
3914
+ },
3915
+ "get": {
3916
+ "tags": [
3917
+ "Delegations"
3918
+ ],
3919
+ "summary": "List delegations for an agent",
3920
+ "description": "List all delegations where this agent is the delegator.\n",
3921
+ "operationId": "listDelegations",
3922
+ "parameters": [
3923
+ {
3924
+ "$ref": "#/components/parameters/AgentId"
3925
+ }
3926
+ ],
3927
+ "responses": {
3928
+ "200": {
3929
+ "description": "List of delegations",
3930
+ "content": {
3931
+ "application/json": {
3932
+ "schema": {
3933
+ "$ref": "#/components/schemas/DelegationListResponse"
3934
+ }
3935
+ }
3936
+ }
3937
+ },
3938
+ "404": {
3939
+ "$ref": "#/components/responses/NotFound"
3940
+ }
3941
+ }
3942
+ }
3943
+ },
3944
+ "/v1/agents/{agent_id}/delegations/effective": {
3945
+ "get": {
3946
+ "tags": [
3947
+ "Delegations"
3948
+ ],
3949
+ "summary": "Get effective delegations",
3950
+ "description": "Get the effective delegations for an agent, including daily usage statistics.\nAgents can call this on their own ID to discover what they are authorized to delegate to.\n",
3951
+ "operationId": "getEffectiveDelegations",
3952
+ "parameters": [
3953
+ {
3954
+ "$ref": "#/components/parameters/AgentId"
3955
+ }
3956
+ ],
3957
+ "responses": {
3958
+ "200": {
3959
+ "description": "Effective delegations with usage stats",
3960
+ "content": {
3961
+ "application/json": {
3962
+ "schema": {
3963
+ "$ref": "#/components/schemas/DelegationListResponse"
3964
+ }
3965
+ }
3966
+ }
3967
+ },
3968
+ "404": {
3969
+ "$ref": "#/components/responses/NotFound"
3970
+ }
3971
+ }
3972
+ }
3973
+ },
3974
+ "/v1/agents/{agent_id}/delegations/{delegation_id}": {
3975
+ "get": {
3976
+ "tags": [
3977
+ "Delegations"
3978
+ ],
3979
+ "summary": "Get a specific delegation",
3980
+ "operationId": "getDelegation",
3981
+ "parameters": [
3982
+ {
3983
+ "$ref": "#/components/parameters/AgentId"
3984
+ },
3985
+ {
3986
+ "name": "delegation_id",
3987
+ "in": "path",
3988
+ "required": true,
3989
+ "schema": {
3990
+ "type": "string",
3991
+ "format": "uuid"
3992
+ }
3993
+ }
3994
+ ],
3995
+ "responses": {
3996
+ "200": {
3997
+ "description": "Delegation details",
3998
+ "content": {
3999
+ "application/json": {
4000
+ "schema": {
4001
+ "$ref": "#/components/schemas/DelegationResponse"
4002
+ }
4003
+ }
4004
+ }
4005
+ },
4006
+ "404": {
4007
+ "$ref": "#/components/responses/NotFound"
4008
+ }
4009
+ }
4010
+ },
4011
+ "patch": {
4012
+ "tags": [
4013
+ "Delegations"
4014
+ ],
4015
+ "summary": "Update a delegation",
4016
+ "description": "Update delegation tools, limits, mode, or active status. Human-only.\n",
4017
+ "operationId": "updateDelegation",
4018
+ "parameters": [
4019
+ {
4020
+ "$ref": "#/components/parameters/AgentId"
4021
+ },
4022
+ {
4023
+ "name": "delegation_id",
4024
+ "in": "path",
4025
+ "required": true,
4026
+ "schema": {
4027
+ "type": "string",
4028
+ "format": "uuid"
4029
+ }
4030
+ }
4031
+ ],
4032
+ "requestBody": {
4033
+ "required": true,
4034
+ "content": {
4035
+ "application/json": {
4036
+ "schema": {
4037
+ "$ref": "#/components/schemas/UpdateDelegationRequest"
4038
+ }
4039
+ }
4040
+ }
4041
+ },
4042
+ "responses": {
4043
+ "200": {
4044
+ "description": "Delegation updated",
4045
+ "content": {
4046
+ "application/json": {
4047
+ "schema": {
4048
+ "$ref": "#/components/schemas/DelegationResponse"
4049
+ }
4050
+ }
4051
+ }
4052
+ },
4053
+ "400": {
4054
+ "$ref": "#/components/responses/BadRequest"
4055
+ },
4056
+ "403": {
4057
+ "$ref": "#/components/responses/Forbidden"
4058
+ },
4059
+ "404": {
4060
+ "$ref": "#/components/responses/NotFound"
4061
+ }
4062
+ }
4063
+ },
4064
+ "delete": {
4065
+ "tags": [
4066
+ "Delegations"
4067
+ ],
4068
+ "summary": "Revoke a delegation",
4069
+ "operationId": "revokeDelegation",
4070
+ "parameters": [
4071
+ {
4072
+ "$ref": "#/components/parameters/AgentId"
4073
+ },
4074
+ {
4075
+ "name": "delegation_id",
4076
+ "in": "path",
4077
+ "required": true,
4078
+ "schema": {
4079
+ "type": "string",
4080
+ "format": "uuid"
4081
+ }
4082
+ }
4083
+ ],
4084
+ "responses": {
4085
+ "204": {
4086
+ "description": "Delegation revoked"
4087
+ },
4088
+ "404": {
4089
+ "$ref": "#/components/responses/NotFound"
4090
+ }
4091
+ }
4092
+ }
4093
+ },
3859
4094
  "/v1/agents/{agent_id}/sign": {
3860
4095
  "post": {
3861
4096
  "tags": [
@@ -16882,6 +17117,195 @@
16882
17117
  }
16883
17118
  }
16884
17119
  },
17120
+ "CreateDelegationRequest": {
17121
+ "type": "object",
17122
+ "required": [
17123
+ "delegate_id"
17124
+ ],
17125
+ "properties": {
17126
+ "delegate_id": {
17127
+ "type": "string",
17128
+ "format": "uuid",
17129
+ "description": "The agent ID to delegate to."
17130
+ },
17131
+ "allowed_tools": {
17132
+ "type": "array",
17133
+ "items": {
17134
+ "type": "string"
17135
+ },
17136
+ "description": "Tool names the delegate may use. Empty means all tools allowed."
17137
+ },
17138
+ "blocked_tools": {
17139
+ "type": "array",
17140
+ "items": {
17141
+ "type": "string"
17142
+ },
17143
+ "description": "Tool names the delegate may NOT use."
17144
+ },
17145
+ "max_daily_delegations": {
17146
+ "type": "integer",
17147
+ "description": "Maximum delegation calls per UTC day. NULL means unlimited."
17148
+ },
17149
+ "max_depth": {
17150
+ "type": "integer",
17151
+ "description": "Maximum delegation chain depth (default 3).",
17152
+ "default": 3
17153
+ },
17154
+ "guardrails": {
17155
+ "type": "object",
17156
+ "description": "Additional guardrail constraints for this delegation."
17157
+ },
17158
+ "delegation_mode": {
17159
+ "type": "string",
17160
+ "enum": [
17161
+ "caller",
17162
+ "target",
17163
+ "both"
17164
+ ],
17165
+ "description": "Execution mode: caller (use delegator's creds), target (use delegate's config), or both.",
17166
+ "default": "caller"
17167
+ },
17168
+ "expires_at": {
17169
+ "type": "string",
17170
+ "format": "date-time",
17171
+ "description": "Optional expiration timestamp."
17172
+ }
17173
+ }
17174
+ },
17175
+ "UpdateDelegationRequest": {
17176
+ "type": "object",
17177
+ "properties": {
17178
+ "allowed_tools": {
17179
+ "type": "array",
17180
+ "items": {
17181
+ "type": "string"
17182
+ }
17183
+ },
17184
+ "blocked_tools": {
17185
+ "type": "array",
17186
+ "items": {
17187
+ "type": "string"
17188
+ }
17189
+ },
17190
+ "max_daily_delegations": {
17191
+ "type": "integer"
17192
+ },
17193
+ "max_depth": {
17194
+ "type": "integer"
17195
+ },
17196
+ "guardrails": {
17197
+ "type": "object"
17198
+ },
17199
+ "delegation_mode": {
17200
+ "type": "string",
17201
+ "enum": [
17202
+ "caller",
17203
+ "target",
17204
+ "both"
17205
+ ]
17206
+ },
17207
+ "is_active": {
17208
+ "type": "boolean"
17209
+ },
17210
+ "expires_at": {
17211
+ "type": "string",
17212
+ "format": "date-time",
17213
+ "nullable": true
17214
+ }
17215
+ }
17216
+ },
17217
+ "DelegationResponse": {
17218
+ "type": "object",
17219
+ "properties": {
17220
+ "id": {
17221
+ "type": "string",
17222
+ "format": "uuid"
17223
+ },
17224
+ "org_id": {
17225
+ "type": "string",
17226
+ "format": "uuid"
17227
+ },
17228
+ "delegator_id": {
17229
+ "type": "string",
17230
+ "format": "uuid"
17231
+ },
17232
+ "delegate_id": {
17233
+ "type": "string",
17234
+ "format": "uuid"
17235
+ },
17236
+ "delegator_name": {
17237
+ "type": "string"
17238
+ },
17239
+ "delegate_name": {
17240
+ "type": "string"
17241
+ },
17242
+ "allowed_tools": {
17243
+ "type": "array",
17244
+ "items": {
17245
+ "type": "string"
17246
+ }
17247
+ },
17248
+ "blocked_tools": {
17249
+ "type": "array",
17250
+ "items": {
17251
+ "type": "string"
17252
+ }
17253
+ },
17254
+ "max_daily_delegations": {
17255
+ "type": "integer",
17256
+ "nullable": true
17257
+ },
17258
+ "max_depth": {
17259
+ "type": "integer"
17260
+ },
17261
+ "guardrails": {
17262
+ "type": "object"
17263
+ },
17264
+ "delegation_mode": {
17265
+ "type": "string",
17266
+ "enum": [
17267
+ "caller",
17268
+ "target",
17269
+ "both"
17270
+ ]
17271
+ },
17272
+ "is_active": {
17273
+ "type": "boolean"
17274
+ },
17275
+ "created_by": {
17276
+ "type": "string",
17277
+ "format": "uuid"
17278
+ },
17279
+ "expires_at": {
17280
+ "type": "string",
17281
+ "format": "date-time",
17282
+ "nullable": true
17283
+ },
17284
+ "created_at": {
17285
+ "type": "string",
17286
+ "format": "date-time"
17287
+ },
17288
+ "updated_at": {
17289
+ "type": "string",
17290
+ "format": "date-time"
17291
+ },
17292
+ "delegations_today": {
17293
+ "type": "integer",
17294
+ "description": "Number of delegations used today (present in effective endpoint)."
17295
+ }
17296
+ }
17297
+ },
17298
+ "DelegationListResponse": {
17299
+ "type": "object",
17300
+ "properties": {
17301
+ "delegations": {
17302
+ "type": "array",
17303
+ "items": {
17304
+ "$ref": "#/components/schemas/DelegationResponse"
17305
+ }
17306
+ }
17307
+ }
17308
+ },
16885
17309
  "SignIntentRequest": {
16886
17310
  "type": "object",
16887
17311
  "required": [
@@ -22677,7 +23101,7 @@
22677
23101
  },
22678
23102
  "slash_commands_enabled": {
22679
23103
  "type": "boolean",
22680
- "description": "Enable slash commands on this channel"
23104
+ "description": "Enable Hermes-compatible slash commands on this channel. When true,\nmessages starting with `/` are handled before the LLM. Commands:\n/help, /new, /reset, /clear, /model, /mode, /personality, /retry,\n/undo, /compress, /summarize, /stop, /status, /skills, /usage, /sethome.\n"
22681
23105
  },
22682
23106
  "voice_transcription_enabled": {
22683
23107
  "type": "boolean",
@@ -22771,7 +23195,7 @@
22771
23195
  },
22772
23196
  "slash_commands_enabled": {
22773
23197
  "type": "boolean",
22774
- "description": "Whether slash commands are enabled for this channel"
23198
+ "description": "Whether Hermes-compatible slash commands are enabled for this channel.\nCommands: /help, /new, /reset, /clear, /model, /mode, /personality, /retry,\n/undo, /compress, /summarize, /stop, /status, /skills, /usage, /sethome.\n"
22775
23199
  },
22776
23200
  "voice_transcription_enabled": {
22777
23201
  "type": "boolean",
package/openapi.yaml CHANGED
@@ -2,7 +2,7 @@ openapi: 3.1.0
2
2
 
3
3
  info:
4
4
  title: 1Claw API
5
- version: 2.34.0
5
+ version: 2.35.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,
@@ -96,6 +96,8 @@ tags:
96
96
  description: External messaging channels (Telegram, WhatsApp, Discord)
97
97
  - name: OAuth Connect
98
98
  description: OAuth connected accounts for agents (provider registry, connect flows, app credentials)
99
+ - name: Delegations
100
+ description: Agent-to-agent delegation management (human-controlled authorization)
99
101
 
100
102
  # =============================================================================
101
103
  # PATHS
@@ -2526,6 +2528,154 @@ paths:
2526
2528
  "404":
2527
2529
  $ref: "#/components/responses/NotFound"
2528
2530
 
2531
+ # ---------------------------------------------------------------------------
2532
+ # Agent Delegations
2533
+ # ---------------------------------------------------------------------------
2534
+
2535
+ /v1/agents/{agent_id}/delegations:
2536
+ post:
2537
+ tags: [Delegations]
2538
+ summary: Create a delegation
2539
+ description: |
2540
+ Grant an agent (delegator) permission to delegate tasks to another agent (delegate).
2541
+ Human-only — agents cannot create their own delegations.
2542
+ operationId: createDelegation
2543
+ parameters:
2544
+ - $ref: "#/components/parameters/AgentId"
2545
+ requestBody:
2546
+ required: true
2547
+ content:
2548
+ application/json:
2549
+ schema:
2550
+ $ref: "#/components/schemas/CreateDelegationRequest"
2551
+ responses:
2552
+ "201":
2553
+ description: Delegation created
2554
+ content:
2555
+ application/json:
2556
+ schema:
2557
+ $ref: "#/components/schemas/DelegationResponse"
2558
+ "400":
2559
+ $ref: "#/components/responses/BadRequest"
2560
+ "403":
2561
+ $ref: "#/components/responses/Forbidden"
2562
+ "409":
2563
+ description: Delegation already exists for this delegator/delegate pair
2564
+ content:
2565
+ application/json:
2566
+ schema:
2567
+ $ref: "#/components/schemas/ProblemDetails"
2568
+ get:
2569
+ tags: [Delegations]
2570
+ summary: List delegations for an agent
2571
+ description: |
2572
+ List all delegations where this agent is the delegator.
2573
+ operationId: listDelegations
2574
+ parameters:
2575
+ - $ref: "#/components/parameters/AgentId"
2576
+ responses:
2577
+ "200":
2578
+ description: List of delegations
2579
+ content:
2580
+ application/json:
2581
+ schema:
2582
+ $ref: "#/components/schemas/DelegationListResponse"
2583
+ "404":
2584
+ $ref: "#/components/responses/NotFound"
2585
+
2586
+ /v1/agents/{agent_id}/delegations/effective:
2587
+ get:
2588
+ tags: [Delegations]
2589
+ summary: Get effective delegations
2590
+ description: |
2591
+ Get the effective delegations for an agent, including daily usage statistics.
2592
+ Agents can call this on their own ID to discover what they are authorized to delegate to.
2593
+ operationId: getEffectiveDelegations
2594
+ parameters:
2595
+ - $ref: "#/components/parameters/AgentId"
2596
+ responses:
2597
+ "200":
2598
+ description: Effective delegations with usage stats
2599
+ content:
2600
+ application/json:
2601
+ schema:
2602
+ $ref: "#/components/schemas/DelegationListResponse"
2603
+ "404":
2604
+ $ref: "#/components/responses/NotFound"
2605
+
2606
+ /v1/agents/{agent_id}/delegations/{delegation_id}:
2607
+ get:
2608
+ tags: [Delegations]
2609
+ summary: Get a specific delegation
2610
+ operationId: getDelegation
2611
+ parameters:
2612
+ - $ref: "#/components/parameters/AgentId"
2613
+ - name: delegation_id
2614
+ in: path
2615
+ required: true
2616
+ schema:
2617
+ type: string
2618
+ format: uuid
2619
+ responses:
2620
+ "200":
2621
+ description: Delegation details
2622
+ content:
2623
+ application/json:
2624
+ schema:
2625
+ $ref: "#/components/schemas/DelegationResponse"
2626
+ "404":
2627
+ $ref: "#/components/responses/NotFound"
2628
+ patch:
2629
+ tags: [Delegations]
2630
+ summary: Update a delegation
2631
+ description: |
2632
+ Update delegation tools, limits, mode, or active status. Human-only.
2633
+ operationId: updateDelegation
2634
+ parameters:
2635
+ - $ref: "#/components/parameters/AgentId"
2636
+ - name: delegation_id
2637
+ in: path
2638
+ required: true
2639
+ schema:
2640
+ type: string
2641
+ format: uuid
2642
+ requestBody:
2643
+ required: true
2644
+ content:
2645
+ application/json:
2646
+ schema:
2647
+ $ref: "#/components/schemas/UpdateDelegationRequest"
2648
+ responses:
2649
+ "200":
2650
+ description: Delegation updated
2651
+ content:
2652
+ application/json:
2653
+ schema:
2654
+ $ref: "#/components/schemas/DelegationResponse"
2655
+ "400":
2656
+ $ref: "#/components/responses/BadRequest"
2657
+ "403":
2658
+ $ref: "#/components/responses/Forbidden"
2659
+ "404":
2660
+ $ref: "#/components/responses/NotFound"
2661
+ delete:
2662
+ tags: [Delegations]
2663
+ summary: Revoke a delegation
2664
+ operationId: revokeDelegation
2665
+ parameters:
2666
+ - $ref: "#/components/parameters/AgentId"
2667
+ - name: delegation_id
2668
+ in: path
2669
+ required: true
2670
+ schema:
2671
+ type: string
2672
+ format: uuid
2673
+ responses:
2674
+ "204":
2675
+ description: Delegation revoked
2676
+ "404":
2677
+ $ref: "#/components/responses/NotFound"
2678
+
2529
2679
  # ---------------------------------------------------------------------------
2530
2680
  # Unified Signing Intent
2531
2681
  # ---------------------------------------------------------------------------
@@ -11017,6 +11167,136 @@ components:
11017
11167
  items:
11018
11168
  $ref: "#/components/schemas/BankrKeyLeaseResponse"
11019
11169
 
11170
+ # Agent Delegations
11171
+ CreateDelegationRequest:
11172
+ type: object
11173
+ required: [delegate_id]
11174
+ properties:
11175
+ delegate_id:
11176
+ type: string
11177
+ format: uuid
11178
+ description: The agent ID to delegate to.
11179
+ allowed_tools:
11180
+ type: array
11181
+ items:
11182
+ type: string
11183
+ description: Tool names the delegate may use. Empty means all tools allowed.
11184
+ blocked_tools:
11185
+ type: array
11186
+ items:
11187
+ type: string
11188
+ description: Tool names the delegate may NOT use.
11189
+ max_daily_delegations:
11190
+ type: integer
11191
+ description: Maximum delegation calls per UTC day. NULL means unlimited.
11192
+ max_depth:
11193
+ type: integer
11194
+ description: Maximum delegation chain depth (default 3).
11195
+ default: 3
11196
+ guardrails:
11197
+ type: object
11198
+ description: Additional guardrail constraints for this delegation.
11199
+ delegation_mode:
11200
+ type: string
11201
+ enum: [caller, target, both]
11202
+ description: "Execution mode: caller (use delegator's creds), target (use delegate's config), or both."
11203
+ default: caller
11204
+ expires_at:
11205
+ type: string
11206
+ format: date-time
11207
+ description: Optional expiration timestamp.
11208
+
11209
+ UpdateDelegationRequest:
11210
+ type: object
11211
+ properties:
11212
+ allowed_tools:
11213
+ type: array
11214
+ items:
11215
+ type: string
11216
+ blocked_tools:
11217
+ type: array
11218
+ items:
11219
+ type: string
11220
+ max_daily_delegations:
11221
+ type: integer
11222
+ max_depth:
11223
+ type: integer
11224
+ guardrails:
11225
+ type: object
11226
+ delegation_mode:
11227
+ type: string
11228
+ enum: [caller, target, both]
11229
+ is_active:
11230
+ type: boolean
11231
+ expires_at:
11232
+ type: string
11233
+ format: date-time
11234
+ nullable: true
11235
+
11236
+ DelegationResponse:
11237
+ type: object
11238
+ properties:
11239
+ id:
11240
+ type: string
11241
+ format: uuid
11242
+ org_id:
11243
+ type: string
11244
+ format: uuid
11245
+ delegator_id:
11246
+ type: string
11247
+ format: uuid
11248
+ delegate_id:
11249
+ type: string
11250
+ format: uuid
11251
+ delegator_name:
11252
+ type: string
11253
+ delegate_name:
11254
+ type: string
11255
+ allowed_tools:
11256
+ type: array
11257
+ items:
11258
+ type: string
11259
+ blocked_tools:
11260
+ type: array
11261
+ items:
11262
+ type: string
11263
+ max_daily_delegations:
11264
+ type: integer
11265
+ nullable: true
11266
+ max_depth:
11267
+ type: integer
11268
+ guardrails:
11269
+ type: object
11270
+ delegation_mode:
11271
+ type: string
11272
+ enum: [caller, target, both]
11273
+ is_active:
11274
+ type: boolean
11275
+ created_by:
11276
+ type: string
11277
+ format: uuid
11278
+ expires_at:
11279
+ type: string
11280
+ format: date-time
11281
+ nullable: true
11282
+ created_at:
11283
+ type: string
11284
+ format: date-time
11285
+ updated_at:
11286
+ type: string
11287
+ format: date-time
11288
+ delegations_today:
11289
+ type: integer
11290
+ description: Number of delegations used today (present in effective endpoint).
11291
+
11292
+ DelegationListResponse:
11293
+ type: object
11294
+ properties:
11295
+ delegations:
11296
+ type: array
11297
+ items:
11298
+ $ref: "#/components/schemas/DelegationResponse"
11299
+
11020
11300
  # Unified Signing Intent
11021
11301
  SignIntentRequest:
11022
11302
  type: object
@@ -14932,7 +15212,11 @@ components:
14932
15212
  Discord: { bot_token, application_id }.
14933
15213
  slash_commands_enabled:
14934
15214
  type: boolean
14935
- description: Enable slash commands on this channel
15215
+ description: |
15216
+ Enable Hermes-compatible slash commands on this channel. When true,
15217
+ messages starting with `/` are handled before the LLM. Commands:
15218
+ /help, /new, /reset, /clear, /model, /mode, /personality, /retry,
15219
+ /undo, /compress, /summarize, /stop, /status, /skills, /usage, /sethome.
14936
15220
  voice_transcription_enabled:
14937
15221
  type: boolean
14938
15222
  description: Enable voice message transcription
@@ -15000,7 +15284,10 @@ components:
15000
15284
  - auto_respond_enabled (boolean): whether the agent auto-responds to inbound messages
15001
15285
  slash_commands_enabled:
15002
15286
  type: boolean
15003
- description: Whether slash commands are enabled for this channel
15287
+ description: |
15288
+ Whether Hermes-compatible slash commands are enabled for this channel.
15289
+ Commands: /help, /new, /reset, /clear, /model, /mode, /personality, /retry,
15290
+ /undo, /compress, /summarize, /stop, /status, /skills, /usage, /sethome.
15004
15291
  voice_transcription_enabled:
15005
15292
  type: boolean
15006
15293
  description: Whether voice message transcription is enabled
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@1claw/openapi-spec",
3
- "version": "0.45.0",
3
+ "version": "0.46.0",
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": {