@agent-os-sdk/client 0.5.2 → 0.6.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.
@@ -3289,6 +3289,274 @@ export interface paths {
3289
3289
  patch?: never;
3290
3290
  trace?: never;
3291
3291
  };
3292
+ "/v1/api/graph/commit": {
3293
+ parameters: {
3294
+ query?: never;
3295
+ header?: never;
3296
+ path?: never;
3297
+ cookie?: never;
3298
+ };
3299
+ get?: never;
3300
+ put?: never;
3301
+ /**
3302
+ * Commit GraphSpec — atomic, idempotent, validated.
3303
+ * @description **Flow:**
3304
+ * 1. Validate spec_version (reject unsupported)
3305
+ * 2. Verify agent exists in workspace
3306
+ * 3. Check optimistic concurrency (expected_revision)
3307
+ * 4. Call DataPlane to validate/normalize
3308
+ * 5. Canonicalize JSON for deterministic hashing
3309
+ * 6. Idempotence: if revision unchanged, return no_change
3310
+ * 7. Persist with atomic check
3311
+ * 8. Return canonical spec + new revision
3312
+ *
3313
+ * **Status Codes:**
3314
+ * - 200: Success (includes no_change case)
3315
+ * - 400: Missing workspace
3316
+ * - 404: Agent not found
3317
+ * - 409: Revision mismatch (concurrent edit)
3318
+ * - 422: Validation failed / unsupported spec version
3319
+ * - 502: DataPlane unreachable
3320
+ */
3321
+ post: {
3322
+ parameters: {
3323
+ query?: never;
3324
+ header?: never;
3325
+ path?: never;
3326
+ cookie?: never;
3327
+ };
3328
+ requestBody?: {
3329
+ content: {
3330
+ "application/json": components["schemas"]["CommitGraphSpecRequest"];
3331
+ "text/json": components["schemas"]["CommitGraphSpecRequest"];
3332
+ "application/*+json": components["schemas"]["CommitGraphSpecRequest"];
3333
+ };
3334
+ };
3335
+ responses: {
3336
+ /** @description OK */
3337
+ 200: {
3338
+ headers: {
3339
+ [name: string]: unknown;
3340
+ };
3341
+ content: {
3342
+ "application/json": components["schemas"]["CommitGraphSpecResponseApiEnvelope"];
3343
+ };
3344
+ };
3345
+ /** @description Bad Request */
3346
+ 400: {
3347
+ headers: {
3348
+ [name: string]: unknown;
3349
+ };
3350
+ content: {
3351
+ "application/json": components["schemas"]["ProblemDetails"];
3352
+ };
3353
+ };
3354
+ /** @description Not Found */
3355
+ 404: {
3356
+ headers: {
3357
+ [name: string]: unknown;
3358
+ };
3359
+ content: {
3360
+ "application/json": components["schemas"]["ProblemDetails"];
3361
+ };
3362
+ };
3363
+ /** @description Conflict */
3364
+ 409: {
3365
+ headers: {
3366
+ [name: string]: unknown;
3367
+ };
3368
+ content: {
3369
+ "application/json": components["schemas"]["ProblemDetails"];
3370
+ };
3371
+ };
3372
+ /** @description Unprocessable Content */
3373
+ 422: {
3374
+ headers: {
3375
+ [name: string]: unknown;
3376
+ };
3377
+ content: {
3378
+ "application/json": components["schemas"]["ProblemDetails"];
3379
+ };
3380
+ };
3381
+ /** @description Bad Gateway */
3382
+ 502: {
3383
+ headers: {
3384
+ [name: string]: unknown;
3385
+ };
3386
+ content: {
3387
+ "application/json": components["schemas"]["ProblemDetails"];
3388
+ };
3389
+ };
3390
+ };
3391
+ };
3392
+ delete?: never;
3393
+ options?: never;
3394
+ head?: never;
3395
+ patch?: never;
3396
+ trace?: never;
3397
+ };
3398
+ "/v1/api/graph/{agentId}": {
3399
+ parameters: {
3400
+ query?: never;
3401
+ header?: never;
3402
+ path?: never;
3403
+ cookie?: never;
3404
+ };
3405
+ /** Get current graph spec with revision. */
3406
+ get: {
3407
+ parameters: {
3408
+ query?: never;
3409
+ header?: never;
3410
+ path: {
3411
+ agentId: string;
3412
+ };
3413
+ cookie?: never;
3414
+ };
3415
+ requestBody?: never;
3416
+ responses: {
3417
+ /** @description OK */
3418
+ 200: {
3419
+ headers: {
3420
+ [name: string]: unknown;
3421
+ };
3422
+ content: {
3423
+ "application/json": components["schemas"]["GetGraphSpecResponseApiEnvelope"];
3424
+ };
3425
+ };
3426
+ /** @description Bad Request */
3427
+ 400: {
3428
+ headers: {
3429
+ [name: string]: unknown;
3430
+ };
3431
+ content: {
3432
+ "application/json": components["schemas"]["ProblemDetails"];
3433
+ };
3434
+ };
3435
+ /** @description Not Found */
3436
+ 404: {
3437
+ headers: {
3438
+ [name: string]: unknown;
3439
+ };
3440
+ content: {
3441
+ "application/json": components["schemas"]["ProblemDetails"];
3442
+ };
3443
+ };
3444
+ /** @description Internal Server Error */
3445
+ 500: {
3446
+ headers: {
3447
+ [name: string]: unknown;
3448
+ };
3449
+ content: {
3450
+ "application/json": components["schemas"]["ProblemDetails"];
3451
+ };
3452
+ };
3453
+ };
3454
+ };
3455
+ put?: never;
3456
+ post?: never;
3457
+ delete?: never;
3458
+ options?: never;
3459
+ head?: never;
3460
+ patch?: never;
3461
+ trace?: never;
3462
+ };
3463
+ "/v1/api/graph/{agentId}/revisions": {
3464
+ parameters: {
3465
+ query?: never;
3466
+ header?: never;
3467
+ path?: never;
3468
+ cookie?: never;
3469
+ };
3470
+ /** List revision history for an agent (metadata only, not full spec). */
3471
+ get: {
3472
+ parameters: {
3473
+ query?: {
3474
+ limit?: number;
3475
+ };
3476
+ header?: never;
3477
+ path: {
3478
+ agentId: string;
3479
+ };
3480
+ cookie?: never;
3481
+ };
3482
+ requestBody?: never;
3483
+ responses: {
3484
+ /** @description OK */
3485
+ 200: {
3486
+ headers: {
3487
+ [name: string]: unknown;
3488
+ };
3489
+ content: {
3490
+ "application/json": components["schemas"]["RevisionListResponseApiEnvelope"];
3491
+ };
3492
+ };
3493
+ /** @description Bad Request */
3494
+ 400: {
3495
+ headers: {
3496
+ [name: string]: unknown;
3497
+ };
3498
+ content: {
3499
+ "application/json": components["schemas"]["ProblemDetails"];
3500
+ };
3501
+ };
3502
+ };
3503
+ };
3504
+ put?: never;
3505
+ post?: never;
3506
+ delete?: never;
3507
+ options?: never;
3508
+ head?: never;
3509
+ patch?: never;
3510
+ trace?: never;
3511
+ };
3512
+ "/v1/api/graph/{agentId}/revisions/{revision}": {
3513
+ parameters: {
3514
+ query?: never;
3515
+ header?: never;
3516
+ path?: never;
3517
+ cookie?: never;
3518
+ };
3519
+ /** Get a specific revision with full graph spec. */
3520
+ get: {
3521
+ parameters: {
3522
+ query?: never;
3523
+ header?: never;
3524
+ path: {
3525
+ agentId: string;
3526
+ revision: string;
3527
+ };
3528
+ cookie?: never;
3529
+ };
3530
+ requestBody?: never;
3531
+ responses: {
3532
+ /** @description OK */
3533
+ 200: {
3534
+ headers: {
3535
+ [name: string]: unknown;
3536
+ };
3537
+ content: {
3538
+ "application/json": components["schemas"]["RevisionDetailResponseApiEnvelope"];
3539
+ };
3540
+ };
3541
+ /** @description Not Found */
3542
+ 404: {
3543
+ headers: {
3544
+ [name: string]: unknown;
3545
+ };
3546
+ content: {
3547
+ "application/json": components["schemas"]["ProblemDetails"];
3548
+ };
3549
+ };
3550
+ };
3551
+ };
3552
+ put?: never;
3553
+ post?: never;
3554
+ delete?: never;
3555
+ options?: never;
3556
+ head?: never;
3557
+ patch?: never;
3558
+ trace?: never;
3559
+ };
3292
3560
  "/v1/api/knowledge/datasets": {
3293
3561
  parameters: {
3294
3562
  query?: never;
@@ -6795,12 +7063,23 @@ export interface paths {
6795
7063
  };
6796
7064
  };
6797
7065
  responses: {
6798
- /** @description OK */
6799
- 200: {
7066
+ /** @description Created */
7067
+ 201: {
6800
7068
  headers: {
6801
7069
  [name: string]: unknown;
6802
7070
  };
6803
- content?: never;
7071
+ content: {
7072
+ "application/json": components["schemas"]["TriggerSecretResponse"];
7073
+ };
7074
+ };
7075
+ /** @description Bad Request */
7076
+ 400: {
7077
+ headers: {
7078
+ [name: string]: unknown;
7079
+ };
7080
+ content: {
7081
+ "application/json": components["schemas"]["ProblemDetails"];
7082
+ };
6804
7083
  };
6805
7084
  };
6806
7085
  };
@@ -6919,7 +7198,27 @@ export interface paths {
6919
7198
  headers: {
6920
7199
  [name: string]: unknown;
6921
7200
  };
6922
- content?: never;
7201
+ content: {
7202
+ "application/json": components["schemas"]["TriggerSecretResponse"];
7203
+ };
7204
+ };
7205
+ /** @description Unauthorized */
7206
+ 401: {
7207
+ headers: {
7208
+ [name: string]: unknown;
7209
+ };
7210
+ content: {
7211
+ "application/json": components["schemas"]["ProblemDetails"];
7212
+ };
7213
+ };
7214
+ /** @description Not Found */
7215
+ 404: {
7216
+ headers: {
7217
+ [name: string]: unknown;
7218
+ };
7219
+ content: {
7220
+ "application/json": components["schemas"]["ProblemDetails"];
7221
+ };
6923
7222
  };
6924
7223
  };
6925
7224
  };
@@ -8018,6 +8317,33 @@ export interface components {
8018
8317
  created_at?: string;
8019
8318
  children?: components["schemas"]["CheckpointNode"][] | null;
8020
8319
  };
8320
+ CommitGraphSpecRequest: {
8321
+ spec_version?: string | null;
8322
+ /** Format: uuid */
8323
+ agent_id?: string;
8324
+ graph_spec?: unknown;
8325
+ expected_revision?: string | null;
8326
+ /** @description Source of the commit: ui.dragdrop, ui.json, meta_builder, system */
8327
+ source?: string | null;
8328
+ };
8329
+ CommitGraphSpecResponse: {
8330
+ /** @description Explicit status: committed, no_change, conflict */
8331
+ status?: string | null;
8332
+ /** Format: uuid */
8333
+ agent_id?: string;
8334
+ revision?: string | null;
8335
+ /** @description Only present in conflict response (409 body). */
8336
+ current_revision?: string | null;
8337
+ canonical_spec?: unknown;
8338
+ /** Format: date-time */
8339
+ committed_at?: string | null;
8340
+ warnings?: components["schemas"]["ValidationMessage"][] | null;
8341
+ validation?: components["schemas"]["ValidationResult"];
8342
+ };
8343
+ CommitGraphSpecResponseApiEnvelope: {
8344
+ data?: components["schemas"]["CommitGraphSpecResponse"];
8345
+ hints?: components["schemas"]["ApiHint"][] | null;
8346
+ };
8021
8347
  ConfirmUploadRequest: {
8022
8348
  sha256?: string | null;
8023
8349
  };
@@ -8253,6 +8579,20 @@ export interface components {
8253
8579
  /** Format: date-time */
8254
8580
  created_at?: string;
8255
8581
  };
8582
+ GetGraphSpecResponse: {
8583
+ /** Format: uuid */
8584
+ agent_id?: string;
8585
+ revision?: string | null;
8586
+ canonical_spec?: unknown;
8587
+ /** Format: date-time */
8588
+ committed_at?: string | null;
8589
+ warnings?: components["schemas"]["ValidationMessage"][] | null;
8590
+ validation?: components["schemas"]["ValidationResult"];
8591
+ };
8592
+ GetGraphSpecResponseApiEnvelope: {
8593
+ data?: components["schemas"]["GetGraphSpecResponse"];
8594
+ hints?: components["schemas"]["ApiHint"][] | null;
8595
+ };
8256
8596
  GrantAccessRequest: {
8257
8597
  /** Format: uuid */
8258
8598
  workspace_id?: string;
@@ -8417,6 +8757,41 @@ export interface components {
8417
8757
  [key: string]: unknown;
8418
8758
  } | null;
8419
8759
  };
8760
+ RevisionDetailResponse: {
8761
+ /** Format: uuid */
8762
+ agent_id?: string;
8763
+ revision?: string | null;
8764
+ graph_spec?: unknown;
8765
+ /** Format: date-time */
8766
+ created_at?: string;
8767
+ source?: string | null;
8768
+ /** Format: uuid */
8769
+ actor_user_id?: string | null;
8770
+ warnings?: components["schemas"]["ValidationMessage"][] | null;
8771
+ };
8772
+ RevisionDetailResponseApiEnvelope: {
8773
+ data?: components["schemas"]["RevisionDetailResponse"];
8774
+ hints?: components["schemas"]["ApiHint"][] | null;
8775
+ };
8776
+ RevisionListItem: {
8777
+ revision?: string | null;
8778
+ /** Format: date-time */
8779
+ created_at?: string;
8780
+ source?: string | null;
8781
+ /** Format: uuid */
8782
+ actor_user_id?: string | null;
8783
+ };
8784
+ RevisionListResponse: {
8785
+ /** Format: uuid */
8786
+ agent_id?: string;
8787
+ /** Format: int32 */
8788
+ total?: number;
8789
+ items?: components["schemas"]["RevisionListItem"][] | null;
8790
+ };
8791
+ RevisionListResponseApiEnvelope: {
8792
+ data?: components["schemas"]["RevisionListResponse"];
8793
+ hints?: components["schemas"]["ApiHint"][] | null;
8794
+ };
8420
8795
  RunDetailResponse: {
8421
8796
  /** Format: uuid */
8422
8797
  run_id?: string;
@@ -8524,6 +8899,14 @@ export interface components {
8524
8899
  /** Format: int32 */
8525
8900
  version_number?: number;
8526
8901
  };
8902
+ SigningContract: {
8903
+ algorithm?: string | null;
8904
+ signature_header?: string | null;
8905
+ timestamp_header?: string | null;
8906
+ timestamp_format?: string | null;
8907
+ string_to_sign?: string | null;
8908
+ signature_format?: string | null;
8909
+ };
8527
8910
  SpanData: {
8528
8911
  trace_id?: string | null;
8529
8912
  span_id?: string | null;
@@ -8608,6 +8991,33 @@ export interface components {
8608
8991
  name?: string | null;
8609
8992
  arguments?: unknown;
8610
8993
  };
8994
+ TriggerRequestContract: {
8995
+ method?: string | null;
8996
+ invoke_url?: string | null;
8997
+ headers?: {
8998
+ [key: string]: string;
8999
+ } | null;
9000
+ signing?: components["schemas"]["SigningContract"];
9001
+ body_schema_json?: string | null;
9002
+ example_payload_json?: string | null;
9003
+ curl_example?: string | null;
9004
+ };
9005
+ TriggerSecretResponse: {
9006
+ /** Format: uuid */
9007
+ id?: string;
9008
+ name?: string | null;
9009
+ /** Format: uuid */
9010
+ agent_id?: string;
9011
+ /** Format: uuid */
9012
+ workspace_id?: string;
9013
+ trigger_type?: string | null;
9014
+ secret_key?: string | null;
9015
+ invoke_url?: string | null;
9016
+ request_contract?: components["schemas"]["TriggerRequestContract"];
9017
+ is_active?: boolean;
9018
+ /** Format: date-time */
9019
+ created_at?: string;
9020
+ };
8611
9021
  TriggerTemplateDto: {
8612
9022
  slug: string | null;
8613
9023
  kind: string | null;
@@ -8702,6 +9112,18 @@ export interface components {
8702
9112
  node_id?: string | null;
8703
9113
  severity?: string | null;
8704
9114
  };
9115
+ ValidationMessage: {
9116
+ code?: string | null;
9117
+ message?: string | null;
9118
+ path?: string | null;
9119
+ node_id?: string | null;
9120
+ severity?: string | null;
9121
+ };
9122
+ /** @description Validation result block returned in all commit responses. */
9123
+ ValidationResult: {
9124
+ valid?: boolean;
9125
+ errors?: components["schemas"]["ValidationMessage"][] | null;
9126
+ };
8705
9127
  VectorQueryRequest: {
8706
9128
  query?: string | null;
8707
9129
  /** Format: int32 */