@agent-os-sdk/client 0.5.1 → 0.5.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.
@@ -481,6 +481,16 @@
481
481
  }
482
482
  }
483
483
  }
484
+ },
485
+ "422": {
486
+ "description": "Unprocessable Content",
487
+ "content": {
488
+ "application/json": {
489
+ "schema": {
490
+ "$ref": "#/components/schemas/ProblemDetails"
491
+ }
492
+ }
493
+ }
484
494
  }
485
495
  }
486
496
  }
@@ -568,7 +578,7 @@
568
578
  "content": {
569
579
  "application/json": {
570
580
  "schema": {
571
- "$ref": "#/components/schemas/AgentDraftResponse"
581
+ "$ref": "#/components/schemas/AgentDraftResponseApiEnvelope"
572
582
  }
573
583
  }
574
584
  }
@@ -3305,6 +3315,256 @@
3305
3315
  }
3306
3316
  }
3307
3317
  },
3318
+ "/v1/api/graph/commit": {
3319
+ "post": {
3320
+ "tags": [
3321
+ "GraphSpec"
3322
+ ],
3323
+ "summary": "Commit GraphSpec — atomic, idempotent, validated.",
3324
+ "description": "**Flow:**\n1. Validate spec_version (reject unsupported)\n2. Verify agent exists in workspace\n3. Check optimistic concurrency (expected_revision)\n4. Call DataPlane to validate/normalize\n5. Canonicalize JSON for deterministic hashing\n6. Idempotence: if revision unchanged, return no_change\n7. Persist with atomic check\n8. Return canonical spec + new revision\n\n**Status Codes:**\n- 200: Success (includes no_change case)\n- 400: Missing workspace\n- 404: Agent not found\n- 409: Revision mismatch (concurrent edit)\n- 422: Validation failed / unsupported spec version\n- 502: DataPlane unreachable",
3325
+ "requestBody": {
3326
+ "content": {
3327
+ "application/json": {
3328
+ "schema": {
3329
+ "$ref": "#/components/schemas/CommitGraphSpecRequest"
3330
+ }
3331
+ },
3332
+ "text/json": {
3333
+ "schema": {
3334
+ "$ref": "#/components/schemas/CommitGraphSpecRequest"
3335
+ }
3336
+ },
3337
+ "application/*+json": {
3338
+ "schema": {
3339
+ "$ref": "#/components/schemas/CommitGraphSpecRequest"
3340
+ }
3341
+ }
3342
+ }
3343
+ },
3344
+ "responses": {
3345
+ "200": {
3346
+ "description": "OK",
3347
+ "content": {
3348
+ "application/json": {
3349
+ "schema": {
3350
+ "$ref": "#/components/schemas/CommitGraphSpecResponseApiEnvelope"
3351
+ }
3352
+ }
3353
+ }
3354
+ },
3355
+ "400": {
3356
+ "description": "Bad Request",
3357
+ "content": {
3358
+ "application/json": {
3359
+ "schema": {
3360
+ "$ref": "#/components/schemas/ProblemDetails"
3361
+ }
3362
+ }
3363
+ }
3364
+ },
3365
+ "404": {
3366
+ "description": "Not Found",
3367
+ "content": {
3368
+ "application/json": {
3369
+ "schema": {
3370
+ "$ref": "#/components/schemas/ProblemDetails"
3371
+ }
3372
+ }
3373
+ }
3374
+ },
3375
+ "409": {
3376
+ "description": "Conflict",
3377
+ "content": {
3378
+ "application/json": {
3379
+ "schema": {
3380
+ "$ref": "#/components/schemas/ProblemDetails"
3381
+ }
3382
+ }
3383
+ }
3384
+ },
3385
+ "422": {
3386
+ "description": "Unprocessable Content",
3387
+ "content": {
3388
+ "application/json": {
3389
+ "schema": {
3390
+ "$ref": "#/components/schemas/ProblemDetails"
3391
+ }
3392
+ }
3393
+ }
3394
+ },
3395
+ "502": {
3396
+ "description": "Bad Gateway",
3397
+ "content": {
3398
+ "application/json": {
3399
+ "schema": {
3400
+ "$ref": "#/components/schemas/ProblemDetails"
3401
+ }
3402
+ }
3403
+ }
3404
+ }
3405
+ }
3406
+ }
3407
+ },
3408
+ "/v1/api/graph/{agentId}": {
3409
+ "get": {
3410
+ "tags": [
3411
+ "GraphSpec"
3412
+ ],
3413
+ "summary": "Get current graph spec with revision.",
3414
+ "parameters": [
3415
+ {
3416
+ "name": "agentId",
3417
+ "in": "path",
3418
+ "required": true,
3419
+ "schema": {
3420
+ "type": "string",
3421
+ "format": "uuid"
3422
+ }
3423
+ }
3424
+ ],
3425
+ "responses": {
3426
+ "200": {
3427
+ "description": "OK",
3428
+ "content": {
3429
+ "application/json": {
3430
+ "schema": {
3431
+ "$ref": "#/components/schemas/GetGraphSpecResponseApiEnvelope"
3432
+ }
3433
+ }
3434
+ }
3435
+ },
3436
+ "400": {
3437
+ "description": "Bad Request",
3438
+ "content": {
3439
+ "application/json": {
3440
+ "schema": {
3441
+ "$ref": "#/components/schemas/ProblemDetails"
3442
+ }
3443
+ }
3444
+ }
3445
+ },
3446
+ "404": {
3447
+ "description": "Not Found",
3448
+ "content": {
3449
+ "application/json": {
3450
+ "schema": {
3451
+ "$ref": "#/components/schemas/ProblemDetails"
3452
+ }
3453
+ }
3454
+ }
3455
+ },
3456
+ "500": {
3457
+ "description": "Internal Server Error",
3458
+ "content": {
3459
+ "application/json": {
3460
+ "schema": {
3461
+ "$ref": "#/components/schemas/ProblemDetails"
3462
+ }
3463
+ }
3464
+ }
3465
+ }
3466
+ }
3467
+ }
3468
+ },
3469
+ "/v1/api/graph/{agentId}/revisions": {
3470
+ "get": {
3471
+ "tags": [
3472
+ "GraphSpec"
3473
+ ],
3474
+ "summary": "List revision history for an agent (metadata only, not full spec).",
3475
+ "parameters": [
3476
+ {
3477
+ "name": "agentId",
3478
+ "in": "path",
3479
+ "required": true,
3480
+ "schema": {
3481
+ "type": "string",
3482
+ "format": "uuid"
3483
+ }
3484
+ },
3485
+ {
3486
+ "name": "limit",
3487
+ "in": "query",
3488
+ "schema": {
3489
+ "type": "integer",
3490
+ "format": "int32",
3491
+ "default": 50
3492
+ }
3493
+ }
3494
+ ],
3495
+ "responses": {
3496
+ "200": {
3497
+ "description": "OK",
3498
+ "content": {
3499
+ "application/json": {
3500
+ "schema": {
3501
+ "$ref": "#/components/schemas/RevisionListResponseApiEnvelope"
3502
+ }
3503
+ }
3504
+ }
3505
+ },
3506
+ "400": {
3507
+ "description": "Bad Request",
3508
+ "content": {
3509
+ "application/json": {
3510
+ "schema": {
3511
+ "$ref": "#/components/schemas/ProblemDetails"
3512
+ }
3513
+ }
3514
+ }
3515
+ }
3516
+ }
3517
+ }
3518
+ },
3519
+ "/v1/api/graph/{agentId}/revisions/{revision}": {
3520
+ "get": {
3521
+ "tags": [
3522
+ "GraphSpec"
3523
+ ],
3524
+ "summary": "Get a specific revision with full graph spec.",
3525
+ "parameters": [
3526
+ {
3527
+ "name": "agentId",
3528
+ "in": "path",
3529
+ "required": true,
3530
+ "schema": {
3531
+ "type": "string",
3532
+ "format": "uuid"
3533
+ }
3534
+ },
3535
+ {
3536
+ "name": "revision",
3537
+ "in": "path",
3538
+ "required": true,
3539
+ "schema": {
3540
+ "type": "string"
3541
+ }
3542
+ }
3543
+ ],
3544
+ "responses": {
3545
+ "200": {
3546
+ "description": "OK",
3547
+ "content": {
3548
+ "application/json": {
3549
+ "schema": {
3550
+ "$ref": "#/components/schemas/RevisionDetailResponseApiEnvelope"
3551
+ }
3552
+ }
3553
+ }
3554
+ },
3555
+ "404": {
3556
+ "description": "Not Found",
3557
+ "content": {
3558
+ "application/json": {
3559
+ "schema": {
3560
+ "$ref": "#/components/schemas/ProblemDetails"
3561
+ }
3562
+ }
3563
+ }
3564
+ }
3565
+ }
3566
+ }
3567
+ },
3308
3568
  "/v1/api/knowledge/datasets": {
3309
3569
  "get": {
3310
3570
  "tags": [
@@ -6370,8 +6630,25 @@
6370
6630
  }
6371
6631
  },
6372
6632
  "responses": {
6373
- "200": {
6374
- "description": "OK"
6633
+ "201": {
6634
+ "description": "Created",
6635
+ "content": {
6636
+ "application/json": {
6637
+ "schema": {
6638
+ "$ref": "#/components/schemas/TriggerSecretResponse"
6639
+ }
6640
+ }
6641
+ }
6642
+ },
6643
+ "400": {
6644
+ "description": "Bad Request",
6645
+ "content": {
6646
+ "application/json": {
6647
+ "schema": {
6648
+ "$ref": "#/components/schemas/ProblemDetails"
6649
+ }
6650
+ }
6651
+ }
6375
6652
  }
6376
6653
  }
6377
6654
  },
@@ -6379,7 +6656,7 @@
6379
6656
  "tags": [
6380
6657
  "Triggers"
6381
6658
  ],
6382
- "summary": "List triggers for a workspace.",
6659
+ "summary": "List triggers for a workspace.\nUse ?focus=triggerId to include request_contract for that item only.",
6383
6660
  "parameters": [
6384
6661
  {
6385
6662
  "name": "workspaceId",
@@ -6388,10 +6665,26 @@
6388
6665
  "type": "string",
6389
6666
  "format": "uuid"
6390
6667
  }
6391
- }
6392
- ],
6393
- "responses": {
6394
- "200": {
6668
+ },
6669
+ {
6670
+ "name": "agent_id",
6671
+ "in": "query",
6672
+ "schema": {
6673
+ "type": "string",
6674
+ "format": "uuid"
6675
+ }
6676
+ },
6677
+ {
6678
+ "name": "focus",
6679
+ "in": "query",
6680
+ "schema": {
6681
+ "type": "string",
6682
+ "format": "uuid"
6683
+ }
6684
+ }
6685
+ ],
6686
+ "responses": {
6687
+ "200": {
6395
6688
  "description": "OK"
6396
6689
  }
6397
6690
  }
@@ -6484,6 +6777,57 @@
6484
6777
  }
6485
6778
  }
6486
6779
  },
6780
+ "/v1/api/triggers/{triggerId}/secret": {
6781
+ "get": {
6782
+ "tags": [
6783
+ "Triggers"
6784
+ ],
6785
+ "summary": "Get trigger with secret (Law 065 - Security DTO).\nSECURITY: Requires explicit Workspace context (Anti-IDOR).",
6786
+ "parameters": [
6787
+ {
6788
+ "name": "triggerId",
6789
+ "in": "path",
6790
+ "required": true,
6791
+ "schema": {
6792
+ "type": "string",
6793
+ "format": "uuid"
6794
+ }
6795
+ }
6796
+ ],
6797
+ "responses": {
6798
+ "200": {
6799
+ "description": "OK",
6800
+ "content": {
6801
+ "application/json": {
6802
+ "schema": {
6803
+ "$ref": "#/components/schemas/TriggerSecretResponse"
6804
+ }
6805
+ }
6806
+ }
6807
+ },
6808
+ "401": {
6809
+ "description": "Unauthorized",
6810
+ "content": {
6811
+ "application/json": {
6812
+ "schema": {
6813
+ "$ref": "#/components/schemas/ProblemDetails"
6814
+ }
6815
+ }
6816
+ }
6817
+ },
6818
+ "404": {
6819
+ "description": "Not Found",
6820
+ "content": {
6821
+ "application/json": {
6822
+ "schema": {
6823
+ "$ref": "#/components/schemas/ProblemDetails"
6824
+ }
6825
+ }
6826
+ }
6827
+ }
6828
+ }
6829
+ }
6830
+ },
6487
6831
  "/v1/api/triggers/invoke/{triggerId}": {
6488
6832
  "post": {
6489
6833
  "tags": [
@@ -6532,6 +6876,50 @@
6532
6876
  }
6533
6877
  }
6534
6878
  },
6879
+ "/v1/api/triggers/{triggerId}/test": {
6880
+ "post": {
6881
+ "tags": [
6882
+ "Triggers"
6883
+ ],
6884
+ "summary": "Test a trigger by executing a run directly (no HMAC required).\nSECURITY: Requires authenticated session, no secret leakage.\nWave 3: Server-side testing with workspace isolation.",
6885
+ "description": "Executes a run using either the provided payload or the template's example_payload.\nUses Channel.Test for audit trail differentiation.",
6886
+ "parameters": [
6887
+ {
6888
+ "name": "triggerId",
6889
+ "in": "path",
6890
+ "required": true,
6891
+ "schema": {
6892
+ "type": "string",
6893
+ "format": "uuid"
6894
+ }
6895
+ }
6896
+ ],
6897
+ "requestBody": {
6898
+ "content": {
6899
+ "application/json": {
6900
+ "schema": {
6901
+ "$ref": "#/components/schemas/TestTriggerRequest"
6902
+ }
6903
+ },
6904
+ "text/json": {
6905
+ "schema": {
6906
+ "$ref": "#/components/schemas/TestTriggerRequest"
6907
+ }
6908
+ },
6909
+ "application/*+json": {
6910
+ "schema": {
6911
+ "$ref": "#/components/schemas/TestTriggerRequest"
6912
+ }
6913
+ }
6914
+ }
6915
+ },
6916
+ "responses": {
6917
+ "200": {
6918
+ "description": "OK"
6919
+ }
6920
+ }
6921
+ }
6922
+ },
6535
6923
  "/v1/api/quotas": {
6536
6924
  "get": {
6537
6925
  "tags": [
@@ -7389,7 +7777,7 @@
7389
7777
  "type": "string",
7390
7778
  "nullable": true
7391
7779
  },
7392
- "draft_graph_json": {
7780
+ "draft_graph_revision": {
7393
7781
  "type": "string",
7394
7782
  "nullable": true
7395
7783
  },
@@ -7410,6 +7798,22 @@
7410
7798
  },
7411
7799
  "additionalProperties": false
7412
7800
  },
7801
+ "AgentDraftResponseApiEnvelope": {
7802
+ "type": "object",
7803
+ "properties": {
7804
+ "data": {
7805
+ "$ref": "#/components/schemas/AgentDraftResponse"
7806
+ },
7807
+ "hints": {
7808
+ "type": "array",
7809
+ "items": {
7810
+ "$ref": "#/components/schemas/ApiHint"
7811
+ },
7812
+ "nullable": true
7813
+ }
7814
+ },
7815
+ "additionalProperties": false
7816
+ },
7413
7817
  "AgentExportAgent": {
7414
7818
  "type": "object",
7415
7819
  "properties": {
@@ -7453,6 +7857,36 @@
7453
7857
  },
7454
7858
  "additionalProperties": false
7455
7859
  },
7860
+ "ApiHint": {
7861
+ "type": "object",
7862
+ "properties": {
7863
+ "type": {
7864
+ "type": "string",
7865
+ "nullable": true
7866
+ },
7867
+ "severity": {
7868
+ "type": "string",
7869
+ "nullable": true
7870
+ },
7871
+ "message": {
7872
+ "type": "string",
7873
+ "nullable": true
7874
+ },
7875
+ "node_id": {
7876
+ "type": "string",
7877
+ "nullable": true
7878
+ },
7879
+ "path": {
7880
+ "type": "string",
7881
+ "nullable": true
7882
+ },
7883
+ "required": {
7884
+ "type": "string",
7885
+ "nullable": true
7886
+ }
7887
+ },
7888
+ "additionalProperties": false
7889
+ },
7456
7890
  "ApprovalDecision": {
7457
7891
  "type": "object",
7458
7892
  "properties": {
@@ -7497,7 +7931,8 @@
7497
7931
  "type": "string",
7498
7932
  "nullable": true
7499
7933
  },
7500
- "input": {
7934
+ "input_json": {
7935
+ "type": "string",
7501
7936
  "nullable": true
7502
7937
  }
7503
7938
  },
@@ -7584,6 +8019,13 @@
7584
8019
  "type": "string",
7585
8020
  "nullable": true
7586
8021
  },
8022
+ "history": {
8023
+ "type": "array",
8024
+ "items": {
8025
+ "$ref": "#/components/schemas/ChatHistoryMessage"
8026
+ },
8027
+ "nullable": true
8028
+ },
7587
8029
  "base_graph_etag": {
7588
8030
  "type": "string",
7589
8031
  "nullable": true
@@ -7634,6 +8076,22 @@
7634
8076
  "label": {
7635
8077
  "type": "string",
7636
8078
  "nullable": true
8079
+ },
8080
+ "webhook_trigger_ids": {
8081
+ "type": "array",
8082
+ "items": {
8083
+ "type": "string",
8084
+ "format": "uuid"
8085
+ },
8086
+ "nullable": true
8087
+ },
8088
+ "scheduled_trigger_ids": {
8089
+ "type": "array",
8090
+ "items": {
8091
+ "type": "string",
8092
+ "format": "uuid"
8093
+ },
8094
+ "nullable": true
7637
8095
  }
7638
8096
  },
7639
8097
  "additionalProperties": false
@@ -7670,11 +8128,26 @@
7670
8128
  0,
7671
8129
  1,
7672
8130
  2,
7673
- 3
8131
+ 3,
8132
+ 4
7674
8133
  ],
7675
8134
  "type": "integer",
7676
8135
  "format": "int32"
7677
8136
  },
8137
+ "ChatHistoryMessage": {
8138
+ "type": "object",
8139
+ "properties": {
8140
+ "role": {
8141
+ "type": "string",
8142
+ "nullable": true
8143
+ },
8144
+ "content": {
8145
+ "type": "string",
8146
+ "nullable": true
8147
+ }
8148
+ },
8149
+ "additionalProperties": false
8150
+ },
7678
8151
  "CheckpointDetail": {
7679
8152
  "type": "object",
7680
8153
  "properties": {
@@ -7812,6 +8285,88 @@
7812
8285
  },
7813
8286
  "additionalProperties": false
7814
8287
  },
8288
+ "CommitGraphSpecRequest": {
8289
+ "type": "object",
8290
+ "properties": {
8291
+ "spec_version": {
8292
+ "type": "string",
8293
+ "nullable": true
8294
+ },
8295
+ "agent_id": {
8296
+ "type": "string",
8297
+ "format": "uuid"
8298
+ },
8299
+ "graph_spec": { },
8300
+ "expected_revision": {
8301
+ "type": "string",
8302
+ "nullable": true
8303
+ },
8304
+ "source": {
8305
+ "type": "string",
8306
+ "description": "Source of the commit: ui.dragdrop, ui.json, meta_builder, system",
8307
+ "nullable": true
8308
+ }
8309
+ },
8310
+ "additionalProperties": false
8311
+ },
8312
+ "CommitGraphSpecResponse": {
8313
+ "type": "object",
8314
+ "properties": {
8315
+ "status": {
8316
+ "type": "string",
8317
+ "description": "Explicit status: committed, no_change, conflict",
8318
+ "nullable": true
8319
+ },
8320
+ "agent_id": {
8321
+ "type": "string",
8322
+ "format": "uuid"
8323
+ },
8324
+ "revision": {
8325
+ "type": "string",
8326
+ "nullable": true
8327
+ },
8328
+ "current_revision": {
8329
+ "type": "string",
8330
+ "description": "Only present in conflict response (409 body).",
8331
+ "nullable": true
8332
+ },
8333
+ "canonical_spec": {
8334
+ "nullable": true
8335
+ },
8336
+ "committed_at": {
8337
+ "type": "string",
8338
+ "format": "date-time",
8339
+ "nullable": true
8340
+ },
8341
+ "warnings": {
8342
+ "type": "array",
8343
+ "items": {
8344
+ "$ref": "#/components/schemas/ValidationMessage"
8345
+ },
8346
+ "nullable": true
8347
+ },
8348
+ "validation": {
8349
+ "$ref": "#/components/schemas/ValidationResult"
8350
+ }
8351
+ },
8352
+ "additionalProperties": false
8353
+ },
8354
+ "CommitGraphSpecResponseApiEnvelope": {
8355
+ "type": "object",
8356
+ "properties": {
8357
+ "data": {
8358
+ "$ref": "#/components/schemas/CommitGraphSpecResponse"
8359
+ },
8360
+ "hints": {
8361
+ "type": "array",
8362
+ "items": {
8363
+ "$ref": "#/components/schemas/ApiHint"
8364
+ },
8365
+ "nullable": true
8366
+ }
8367
+ },
8368
+ "additionalProperties": false
8369
+ },
7815
8370
  "ConfirmUploadRequest": {
7816
8371
  "type": "object",
7817
8372
  "properties": {
@@ -8104,7 +8659,8 @@
8104
8659
  "type": "string",
8105
8660
  "nullable": true
8106
8661
  },
8107
- "input": {
8662
+ "input_json": {
8663
+ "type": "string",
8108
8664
  "nullable": true
8109
8665
  },
8110
8666
  "webhook_url": {
@@ -8226,6 +8782,10 @@
8226
8782
  "type": "string",
8227
8783
  "nullable": true
8228
8784
  },
8785
+ "template_slug": {
8786
+ "type": "string",
8787
+ "nullable": true
8788
+ },
8229
8789
  "config": {
8230
8790
  "nullable": true
8231
8791
  }
@@ -8482,21 +9042,69 @@
8482
9042
  },
8483
9043
  "additionalProperties": false
8484
9044
  },
8485
- "GrantAccessRequest": {
9045
+ "GetGraphSpecResponse": {
8486
9046
  "type": "object",
8487
9047
  "properties": {
8488
- "workspace_id": {
9048
+ "agent_id": {
8489
9049
  "type": "string",
8490
9050
  "format": "uuid"
8491
9051
  },
8492
- "permission": {
9052
+ "revision": {
8493
9053
  "type": "string",
8494
9054
  "nullable": true
8495
- }
8496
- },
8497
- "additionalProperties": false
8498
- },
8499
- "IntrospectGraphRequest": {
9055
+ },
9056
+ "canonical_spec": {
9057
+ "nullable": true
9058
+ },
9059
+ "committed_at": {
9060
+ "type": "string",
9061
+ "format": "date-time",
9062
+ "nullable": true
9063
+ },
9064
+ "warnings": {
9065
+ "type": "array",
9066
+ "items": {
9067
+ "$ref": "#/components/schemas/ValidationMessage"
9068
+ },
9069
+ "nullable": true
9070
+ },
9071
+ "validation": {
9072
+ "$ref": "#/components/schemas/ValidationResult"
9073
+ }
9074
+ },
9075
+ "additionalProperties": false
9076
+ },
9077
+ "GetGraphSpecResponseApiEnvelope": {
9078
+ "type": "object",
9079
+ "properties": {
9080
+ "data": {
9081
+ "$ref": "#/components/schemas/GetGraphSpecResponse"
9082
+ },
9083
+ "hints": {
9084
+ "type": "array",
9085
+ "items": {
9086
+ "$ref": "#/components/schemas/ApiHint"
9087
+ },
9088
+ "nullable": true
9089
+ }
9090
+ },
9091
+ "additionalProperties": false
9092
+ },
9093
+ "GrantAccessRequest": {
9094
+ "type": "object",
9095
+ "properties": {
9096
+ "workspace_id": {
9097
+ "type": "string",
9098
+ "format": "uuid"
9099
+ },
9100
+ "permission": {
9101
+ "type": "string",
9102
+ "nullable": true
9103
+ }
9104
+ },
9105
+ "additionalProperties": false
9106
+ },
9107
+ "IntrospectGraphRequest": {
8500
9108
  "type": "object",
8501
9109
  "properties": {
8502
9110
  "graph_spec": {
@@ -8956,6 +9564,117 @@
8956
9564
  },
8957
9565
  "additionalProperties": false
8958
9566
  },
9567
+ "RevisionDetailResponse": {
9568
+ "type": "object",
9569
+ "properties": {
9570
+ "agent_id": {
9571
+ "type": "string",
9572
+ "format": "uuid"
9573
+ },
9574
+ "revision": {
9575
+ "type": "string",
9576
+ "nullable": true
9577
+ },
9578
+ "graph_spec": { },
9579
+ "created_at": {
9580
+ "type": "string",
9581
+ "format": "date-time"
9582
+ },
9583
+ "source": {
9584
+ "type": "string",
9585
+ "nullable": true
9586
+ },
9587
+ "actor_user_id": {
9588
+ "type": "string",
9589
+ "format": "uuid",
9590
+ "nullable": true
9591
+ },
9592
+ "warnings": {
9593
+ "type": "array",
9594
+ "items": {
9595
+ "$ref": "#/components/schemas/ValidationMessage"
9596
+ },
9597
+ "nullable": true
9598
+ }
9599
+ },
9600
+ "additionalProperties": false
9601
+ },
9602
+ "RevisionDetailResponseApiEnvelope": {
9603
+ "type": "object",
9604
+ "properties": {
9605
+ "data": {
9606
+ "$ref": "#/components/schemas/RevisionDetailResponse"
9607
+ },
9608
+ "hints": {
9609
+ "type": "array",
9610
+ "items": {
9611
+ "$ref": "#/components/schemas/ApiHint"
9612
+ },
9613
+ "nullable": true
9614
+ }
9615
+ },
9616
+ "additionalProperties": false
9617
+ },
9618
+ "RevisionListItem": {
9619
+ "type": "object",
9620
+ "properties": {
9621
+ "revision": {
9622
+ "type": "string",
9623
+ "nullable": true
9624
+ },
9625
+ "created_at": {
9626
+ "type": "string",
9627
+ "format": "date-time"
9628
+ },
9629
+ "source": {
9630
+ "type": "string",
9631
+ "nullable": true
9632
+ },
9633
+ "actor_user_id": {
9634
+ "type": "string",
9635
+ "format": "uuid",
9636
+ "nullable": true
9637
+ }
9638
+ },
9639
+ "additionalProperties": false
9640
+ },
9641
+ "RevisionListResponse": {
9642
+ "type": "object",
9643
+ "properties": {
9644
+ "agent_id": {
9645
+ "type": "string",
9646
+ "format": "uuid"
9647
+ },
9648
+ "total": {
9649
+ "type": "integer",
9650
+ "format": "int32"
9651
+ },
9652
+ "items": {
9653
+ "type": "array",
9654
+ "items": {
9655
+ "$ref": "#/components/schemas/RevisionListItem"
9656
+ },
9657
+ "nullable": true
9658
+ }
9659
+ },
9660
+ "additionalProperties": false
9661
+ },
9662
+ "RevisionListResponseApiEnvelope": {
9663
+ "type": "object",
9664
+ "properties": {
9665
+ "data": {
9666
+ "$ref": "#/components/schemas/RevisionListResponse"
9667
+ },
9668
+ "hints": {
9669
+ "type": "array",
9670
+ "items": {
9671
+ "$ref": "#/components/schemas/ApiHint"
9672
+ },
9673
+ "nullable": true
9674
+ }
9675
+ },
9676
+ "additionalProperties": false
9677
+ },
8959
9678
  "RunDetailResponse": {
8960
9679
  "type": "object",
8961
9680
  "properties": {
@@ -8987,15 +9706,19 @@
8987
9706
  "$ref": "#/components/schemas/RunStatus"
8988
9707
  },
8989
9708
  "input_json": {
9709
+ "type": "string",
8990
9710
  "nullable": true
8991
9711
  },
8992
9712
  "output_json": {
9713
+ "type": "string",
8993
9714
  "nullable": true
8994
9715
  },
8995
9716
  "error_json": {
9717
+ "type": "string",
8996
9718
  "nullable": true
8997
9719
  },
8998
9720
  "metrics_json": {
9721
+ "type": "string",
8999
9722
  "nullable": true
9000
9723
  },
9001
9724
  "started_at": {
@@ -9243,6 +9966,36 @@
9243
9966
  },
9244
9967
  "additionalProperties": false
9245
9968
  },
9969
+ "SigningContract": {
9970
+ "type": "object",
9971
+ "properties": {
9972
+ "algorithm": {
9973
+ "type": "string",
9974
+ "nullable": true
9975
+ },
9976
+ "signature_header": {
9977
+ "type": "string",
9978
+ "nullable": true
9979
+ },
9980
+ "timestamp_header": {
9981
+ "type": "string",
9982
+ "nullable": true
9983
+ },
9984
+ "timestamp_format": {
9985
+ "type": "string",
9986
+ "nullable": true
9987
+ },
9988
+ "string_to_sign": {
9989
+ "type": "string",
9990
+ "nullable": true
9991
+ },
9992
+ "signature_format": {
9993
+ "type": "string",
9994
+ "nullable": true
9995
+ }
9996
+ },
9997
+ "additionalProperties": false
9998
+ },
9246
9999
  "SpanData": {
9247
10000
  "type": "object",
9248
10001
  "properties": {
@@ -9339,7 +10092,8 @@
9339
10092
  "type": "string",
9340
10093
  "nullable": true
9341
10094
  },
9342
- "input": {
10095
+ "input_json": {
10096
+ "type": "string",
9343
10097
  "nullable": true
9344
10098
  },
9345
10099
  "stream_mode": {
@@ -9349,6 +10103,16 @@
9349
10103
  },
9350
10104
  "additionalProperties": false
9351
10105
  },
10106
+ "TestTriggerRequest": {
10107
+ "type": "object",
10108
+ "properties": {
10109
+ "payload": {
10110
+ "nullable": true
10111
+ }
10112
+ },
10113
+ "additionalProperties": false,
10114
+ "description": "Request body for POST /triggers/{id}/test.\nPayload is optional - falls back to template example_payload."
10115
+ },
9352
10116
  "ThreadCopyRequest": {
9353
10117
  "type": "object",
9354
10118
  "properties": {
@@ -9464,6 +10228,86 @@
9464
10228
  },
9465
10229
  "additionalProperties": false
9466
10230
  },
10231
+ "TriggerRequestContract": {
10232
+ "type": "object",
10233
+ "properties": {
10234
+ "method": {
10235
+ "type": "string",
10236
+ "nullable": true
10237
+ },
10238
+ "invoke_url": {
10239
+ "type": "string",
10240
+ "nullable": true
10241
+ },
10242
+ "headers": {
10243
+ "type": "object",
10244
+ "additionalProperties": {
10245
+ "type": "string"
10246
+ },
10247
+ "nullable": true
10248
+ },
10249
+ "signing": {
10250
+ "$ref": "#/components/schemas/SigningContract"
10251
+ },
10252
+ "body_schema_json": {
10253
+ "type": "string",
10254
+ "nullable": true
10255
+ },
10256
+ "example_payload_json": {
10257
+ "type": "string",
10258
+ "nullable": true
10259
+ },
10260
+ "curl_example": {
10261
+ "type": "string",
10262
+ "nullable": true
10263
+ }
10264
+ },
10265
+ "additionalProperties": false
10266
+ },
10267
+ "TriggerSecretResponse": {
10268
+ "type": "object",
10269
+ "properties": {
10270
+ "id": {
10271
+ "type": "string",
10272
+ "format": "uuid"
10273
+ },
10274
+ "name": {
10275
+ "type": "string",
10276
+ "nullable": true
10277
+ },
10278
+ "agent_id": {
10279
+ "type": "string",
10280
+ "format": "uuid"
10281
+ },
10282
+ "workspace_id": {
10283
+ "type": "string",
10284
+ "format": "uuid"
10285
+ },
10286
+ "trigger_type": {
10287
+ "type": "string",
10288
+ "nullable": true
10289
+ },
10290
+ "secret_key": {
10291
+ "type": "string",
10292
+ "nullable": true
10293
+ },
10294
+ "invoke_url": {
10295
+ "type": "string",
10296
+ "nullable": true
10297
+ },
10298
+ "request_contract": {
10299
+ "$ref": "#/components/schemas/TriggerRequestContract"
10300
+ },
10301
+ "is_active": {
10302
+ "type": "boolean"
10303
+ },
10304
+ "created_at": {
10305
+ "type": "string",
10306
+ "format": "date-time"
10307
+ }
10308
+ },
10309
+ "additionalProperties": false
10310
+ },
9467
10311
  "TriggerTemplateDto": {
9468
10312
  "required": [
9469
10313
  "kind",
@@ -9785,6 +10629,49 @@
9785
10629
  "additionalProperties": false,
9786
10630
  "description": "Validation error from graph validation.\nAligned with Data Plane validator output (RFC 6901 JSON Pointer paths)."
9787
10631
  },
10632
+ "ValidationMessage": {
10633
+ "type": "object",
10634
+ "properties": {
10635
+ "code": {
10636
+ "type": "string",
10637
+ "nullable": true
10638
+ },
10639
+ "message": {
10640
+ "type": "string",
10641
+ "nullable": true
10642
+ },
10643
+ "path": {
10644
+ "type": "string",
10645
+ "nullable": true
10646
+ },
10647
+ "node_id": {
10648
+ "type": "string",
10649
+ "nullable": true
10650
+ },
10651
+ "severity": {
10652
+ "type": "string",
10653
+ "nullable": true
10654
+ }
10655
+ },
10656
+ "additionalProperties": false
10657
+ },
10658
+ "ValidationResult": {
10659
+ "type": "object",
10660
+ "properties": {
10661
+ "valid": {
10662
+ "type": "boolean"
10663
+ },
10664
+ "errors": {
10665
+ "type": "array",
10666
+ "items": {
10667
+ "$ref": "#/components/schemas/ValidationMessage"
10668
+ },
10669
+ "nullable": true
10670
+ }
10671
+ },
10672
+ "additionalProperties": false,
10673
+ "description": "Validation result block returned in all commit responses."
10674
+ },
9788
10675
  "VectorQueryRequest": {
9789
10676
  "type": "object",
9790
10677
  "properties": {
@@ -9940,7 +10827,8 @@
9940
10827
  "type": "string",
9941
10828
  "nullable": true
9942
10829
  },
9943
- "input": {
10830
+ "input_json": {
10831
+ "type": "string",
9944
10832
  "nullable": true
9945
10833
  },
9946
10834
  "timeout_seconds": {
@@ -9963,9 +10851,11 @@
9963
10851
  "nullable": true
9964
10852
  },
9965
10853
  "output_json": {
10854
+ "type": "string",
9966
10855
  "nullable": true
9967
10856
  },
9968
10857
  "error_json": {
10858
+ "type": "string",
9969
10859
  "nullable": true
9970
10860
  },
9971
10861
  "duration_ms": {
@@ -10030,6 +10920,9 @@
10030
10920
  {
10031
10921
  "name": "Graphs"
10032
10922
  },
10923
+ {
10924
+ "name": "GraphSpec"
10925
+ },
10033
10926
  {
10034
10927
  "name": "Knowledge"
10035
10928
  },