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