@claudexor/schema 3.8.0 → 3.8.1

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 (92) hide show
  1. package/dist/agent-capabilities.d.ts +16 -16
  2. package/dist/config.d.ts +20 -20
  3. package/dist/control-harness-list.d.ts +18 -18
  4. package/dist/control-operation-responses.d.ts +16 -13
  5. package/dist/control-operation-responses.d.ts.map +1 -1
  6. package/dist/control-run-detail.d.ts +33 -46
  7. package/dist/control-run-detail.d.ts.map +1 -1
  8. package/dist/control-run-detail.js +10 -19
  9. package/dist/control-run-detail.js.map +1 -1
  10. package/dist/control-run-execution.d.ts +16 -0
  11. package/dist/control-run-execution.d.ts.map +1 -0
  12. package/dist/control-run-execution.js +19 -0
  13. package/dist/control-run-execution.js.map +1 -0
  14. package/dist/control-run-failure.d.ts +4 -4
  15. package/dist/control-run-failure.d.ts.map +1 -1
  16. package/dist/control-run-failure.js +6 -4
  17. package/dist/control-run-failure.js.map +1 -1
  18. package/dist/control-run-retry.d.ts +21 -0
  19. package/dist/control-run-retry.d.ts.map +1 -1
  20. package/dist/control-run-retry.js +6 -0
  21. package/dist/control-run-retry.js.map +1 -1
  22. package/dist/control-trust.d.ts +13 -13
  23. package/dist/control.d.ts +365 -36
  24. package/dist/control.d.ts.map +1 -1
  25. package/dist/control.js +12 -18
  26. package/dist/control.js.map +1 -1
  27. package/dist/credential-profile-snapshot.d.ts +78 -36
  28. package/dist/credential-profile-snapshot.d.ts.map +1 -1
  29. package/dist/credential-profile.d.ts +44 -0
  30. package/dist/credential-profile.d.ts.map +1 -1
  31. package/dist/credential-profile.js +11 -0
  32. package/dist/credential-profile.js.map +1 -1
  33. package/dist/harness-confinement.d.ts +37 -30
  34. package/dist/harness-confinement.d.ts.map +1 -1
  35. package/dist/harness-confinement.js +18 -26
  36. package/dist/harness-confinement.js.map +1 -1
  37. package/dist/harness.d.ts +18 -48
  38. package/dist/harness.d.ts.map +1 -1
  39. package/dist/harness.js +1 -6
  40. package/dist/harness.js.map +1 -1
  41. package/dist/mcp-run-result.d.ts +10 -10
  42. package/dist/primitives.d.ts +6 -1
  43. package/dist/primitives.d.ts.map +1 -1
  44. package/dist/primitives.js +8 -2
  45. package/dist/primitives.js.map +1 -1
  46. package/dist/readiness.d.ts +14 -14
  47. package/dist/run-strategy.d.ts +51 -3
  48. package/dist/run-strategy.d.ts.map +1 -1
  49. package/dist/run-strategy.js +58 -2
  50. package/dist/run-strategy.js.map +1 -1
  51. package/dist/task.d.ts +641 -19
  52. package/dist/task.d.ts.map +1 -1
  53. package/dist/task.js +40 -5
  54. package/dist/task.js.map +1 -1
  55. package/dist/telemetry.d.ts +2 -2
  56. package/dist/telemetry.js +3 -3
  57. package/dist/telemetry.js.map +1 -1
  58. package/dist/thread.d.ts +1 -1
  59. package/dist/thread.js +2 -2
  60. package/dist/thread.js.map +1 -1
  61. package/generated/AgentCapabilityCatalog.schema.json +1 -2
  62. package/generated/ControlCredentialProfileCreateResponse.schema.json +9 -0
  63. package/generated/ControlCredentialProfileUpdateResponse.schema.json +9 -0
  64. package/generated/ControlCredentialProfilesQueryResponse.schema.json +12 -3
  65. package/generated/ControlCredentialProfilesResponse.schema.json +9 -0
  66. package/generated/ControlCredentialProfilesSnapshotResponse.schema.json +12 -3
  67. package/generated/ControlHarnessListResponse.schema.json +3 -3
  68. package/generated/ControlRunAgainDraft.schema.json +20 -3
  69. package/generated/ControlRunDetail.schema.json +10 -8
  70. package/generated/ControlRunListResponse.schema.json +6 -4
  71. package/generated/ControlRunStartRequest.schema.json +5 -2
  72. package/generated/ControlRunSummary.schema.json +6 -4
  73. package/generated/ControlThread.schema.json +3 -3
  74. package/generated/ControlThreadCreateRequest.schema.json +0 -1
  75. package/generated/ControlThreadDetail.schema.json +3 -3
  76. package/generated/ControlThreadListResponse.schema.json +3 -3
  77. package/generated/ControlThreadTurnRequest.schema.json +0 -1
  78. package/generated/ControlThreadUpdateRequest.schema.json +1 -2
  79. package/generated/ControlTrustListResponse.schema.json +0 -1
  80. package/generated/ControlTrustState.schema.json +0 -1
  81. package/generated/ControlTrustUpdateRequest.schema.json +0 -1
  82. package/generated/CredentialProfileStatus.schema.json +9 -0
  83. package/generated/HarnessManifest.schema.json +3 -3
  84. package/generated/HarnessStatusDto.schema.json +3 -3
  85. package/generated/McpRunHandleResult.schema.json +4 -2
  86. package/generated/McpRunToolResult.schema.json +4 -2
  87. package/generated/RunFailure.schema.json +4 -2
  88. package/generated/RunTelemetry.schema.json +5 -5
  89. package/generated/TaskContract.schema.json +8 -8
  90. package/generated/Thread.schema.json +3 -3
  91. package/generated/TrustConfig.schema.json +0 -2
  92. package/package.json +2 -2
package/dist/control.d.ts CHANGED
@@ -1,16 +1,6 @@
1
1
  import { z } from "zod/v3";
2
2
  export { ControlQuotaResponse } from "./quota.js";
3
- export declare const RunExecution: z.ZodObject<{
4
- isolation: z.ZodDefault<z.ZodEnum<["envelope", "live"]>>;
5
- delegated: z.ZodDefault<z.ZodBoolean>;
6
- }, "strict", z.ZodTypeAny, {
7
- isolation: "envelope" | "live";
8
- delegated: boolean;
9
- }, {
10
- isolation?: "envelope" | "live" | undefined;
11
- delegated?: boolean | undefined;
12
- }>;
13
- export type RunExecution = z.infer<typeof RunExecution>;
3
+ export { RunExecution } from "./control-run-execution.js";
14
4
  export declare const ControlReviewerPanelEntry: z.ZodObject<{
15
5
  /** Explicit reviewer harness id. Repeated harness ids are allowed so one
16
6
  * native provider can review through multiple requested models. */
@@ -70,12 +60,15 @@ export declare const ControlRunStartRequest: z.ZodObject<{
70
60
  execution: z.ZodDefault<z.ZodObject<{
71
61
  isolation: z.ZodDefault<z.ZodEnum<["envelope", "live"]>>;
72
62
  delegated: z.ZodDefault<z.ZodBoolean>;
63
+ workspaceRoot: z.ZodOptional<z.ZodString>;
73
64
  }, "strict", z.ZodTypeAny, {
74
65
  isolation: "envelope" | "live";
75
66
  delegated: boolean;
67
+ workspaceRoot?: string | undefined;
76
68
  }, {
77
69
  isolation?: "envelope" | "live" | undefined;
78
70
  delegated?: boolean | undefined;
71
+ workspaceRoot?: string | undefined;
79
72
  }>>;
80
73
  harnesses: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
81
74
  primaryHarness: z.ZodOptional<z.ZodString>;
@@ -132,7 +125,7 @@ export declare const ControlRunStartRequest: z.ZodObject<{
132
125
  maxUsd: number;
133
126
  }>]>>;
134
127
  /** Requested access profile. Effective access is derived by the engine and never client-supplied. */
135
- access: z.ZodOptional<z.ZodEnum<["readonly", "workspace_write", "full", "external_sandbox_full", "inherit_native"]>>;
128
+ access: z.ZodOptional<z.ZodEnum<["readonly", "workspace_write", "full", "inherit_native"]>>;
136
129
  web: z.ZodOptional<z.ZodEnum<["off", "auto", "cached", "live"]>>;
137
130
  externalContextPolicy: z.ZodOptional<z.ZodEnum<["off", "auto", "cached", "live"]>>;
138
131
  /** Opt this run into the agent-driven browser (Playwright MCP). */
@@ -273,6 +266,7 @@ export declare const ControlRunStartRequest: z.ZodObject<{
273
266
  execution: {
274
267
  isolation: "envelope" | "live";
275
268
  delegated: boolean;
269
+ workspaceRoot?: string | undefined;
276
270
  };
277
271
  harnesses?: string[] | undefined;
278
272
  primaryHarness?: string | undefined;
@@ -296,7 +290,7 @@ export declare const ControlRunStartRequest: z.ZodObject<{
296
290
  kind: "finite";
297
291
  maxUsd: number;
298
292
  } | undefined;
299
- access?: "external_sandbox_full" | "full" | "inherit_native" | "readonly" | "workspace_write" | undefined;
293
+ access?: "full" | "inherit_native" | "readonly" | "workspace_write" | undefined;
300
294
  web?: "auto" | "cached" | "live" | "off" | undefined;
301
295
  externalContextPolicy?: "auto" | "cached" | "live" | "off" | undefined;
302
296
  browser?: boolean | undefined;
@@ -351,6 +345,7 @@ export declare const ControlRunStartRequest: z.ZodObject<{
351
345
  execution?: {
352
346
  isolation?: "envelope" | "live" | undefined;
353
347
  delegated?: boolean | undefined;
348
+ workspaceRoot?: string | undefined;
354
349
  } | undefined;
355
350
  harnesses?: string[] | undefined;
356
351
  primaryHarness?: string | undefined;
@@ -374,7 +369,7 @@ export declare const ControlRunStartRequest: z.ZodObject<{
374
369
  kind: "finite";
375
370
  maxUsd: number;
376
371
  } | undefined;
377
- access?: "external_sandbox_full" | "full" | "inherit_native" | "readonly" | "workspace_write" | undefined;
372
+ access?: "full" | "inherit_native" | "readonly" | "workspace_write" | undefined;
378
373
  web?: "auto" | "cached" | "live" | "off" | undefined;
379
374
  externalContextPolicy?: "auto" | "cached" | "live" | "off" | undefined;
380
375
  browser?: boolean | undefined;
@@ -413,6 +408,320 @@ export declare const ControlRunStartRequest: z.ZodObject<{
413
408
  maxTurns?: number | undefined;
414
409
  }>;
415
410
  export type ControlRunStartRequest = z.infer<typeof ControlRunStartRequest>;
411
+ /** Bounded decoder for immutable accepted request bodies. Active ingress must
412
+ * continue to parse with ControlRunStartRequest. */
413
+ export declare const RecordedControlRunStartRequest: z.ZodObject<{
414
+ prompt: z.ZodDefault<z.ZodString>;
415
+ instructions: z.ZodOptional<z.ZodString>;
416
+ attachments: z.ZodOptional<z.ZodArray<z.ZodObject<{
417
+ resourceId: z.ZodString;
418
+ }, "strict", z.ZodTypeAny, {
419
+ resourceId: string;
420
+ }, {
421
+ resourceId: string;
422
+ }>, "many">>;
423
+ mode: z.ZodDefault<z.ZodEnum<["ask", "plan", "agent"]>>;
424
+ scope: z.ZodDefault<z.ZodDiscriminatedUnion<"kind", [z.ZodObject<{
425
+ kind: z.ZodLiteral<"project">;
426
+ root: z.ZodString;
427
+ context: z.ZodDefault<z.ZodEnum<["auto"]>>;
428
+ ephemeral: z.ZodDefault<z.ZodBoolean>;
429
+ }, "strict", z.ZodTypeAny, {
430
+ kind: "project";
431
+ root: string;
432
+ context: "auto";
433
+ ephemeral: boolean;
434
+ }, {
435
+ kind: "project";
436
+ root: string;
437
+ context?: "auto" | undefined;
438
+ ephemeral?: boolean | undefined;
439
+ }>, z.ZodObject<{
440
+ kind: z.ZodLiteral<"none">;
441
+ }, "strict", z.ZodTypeAny, {
442
+ kind: "none";
443
+ }, {
444
+ kind: "none";
445
+ }>]>>;
446
+ execution: z.ZodDefault<z.ZodObject<{
447
+ isolation: z.ZodDefault<z.ZodEnum<["envelope", "live"]>>;
448
+ delegated: z.ZodDefault<z.ZodBoolean>;
449
+ workspaceRoot: z.ZodOptional<z.ZodString>;
450
+ }, "strict", z.ZodTypeAny, {
451
+ isolation: "envelope" | "live";
452
+ delegated: boolean;
453
+ workspaceRoot?: string | undefined;
454
+ }, {
455
+ isolation?: "envelope" | "live" | undefined;
456
+ delegated?: boolean | undefined;
457
+ workspaceRoot?: string | undefined;
458
+ }>>;
459
+ harnesses: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
460
+ primaryHarness: z.ZodOptional<z.ZodString>;
461
+ routingGoal: z.ZodOptional<z.ZodEnum<["auto", "quality", "economy"]>>;
462
+ model: z.ZodOptional<z.ZodString>;
463
+ models: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
464
+ effort: z.ZodOptional<z.ZodString>;
465
+ efforts: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
466
+ reviewerModels: z.ZodOptional<z.ZodRecord<z.ZodEnum<["openai", "anthropic", "google", "cursor", "opencode", "xai", "local", "unknown"]>, z.ZodString>>;
467
+ reviewerEfforts: z.ZodOptional<z.ZodRecord<z.ZodEnum<["openai", "anthropic", "google", "cursor", "opencode", "xai", "local", "unknown"]>, z.ZodString>>;
468
+ n: z.ZodOptional<z.ZodNumber>;
469
+ attempts: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
470
+ untilClean: z.ZodOptional<z.ZodBoolean>;
471
+ deepScan: z.ZodOptional<z.ZodBoolean>;
472
+ create: z.ZodOptional<z.ZodBoolean>;
473
+ council: z.ZodOptional<z.ZodBoolean>;
474
+ synthesis: z.ZodOptional<z.ZodEnum<["auto", "always", "never"]>>;
475
+ paidBudget: z.ZodOptional<z.ZodDiscriminatedUnion<"kind", [z.ZodObject<{
476
+ kind: z.ZodLiteral<"unlimited">;
477
+ }, "strict", z.ZodTypeAny, {
478
+ kind: "unlimited";
479
+ }, {
480
+ kind: "unlimited";
481
+ }>, z.ZodObject<{
482
+ kind: z.ZodLiteral<"finite">;
483
+ maxUsd: z.ZodNumber;
484
+ }, "strict", z.ZodTypeAny, {
485
+ kind: "finite";
486
+ maxUsd: number;
487
+ }, {
488
+ kind: "finite";
489
+ maxUsd: number;
490
+ }>]>>;
491
+ web: z.ZodOptional<z.ZodEnum<["off", "auto", "cached", "live"]>>;
492
+ externalContextPolicy: z.ZodOptional<z.ZodEnum<["off", "auto", "cached", "live"]>>;
493
+ browser: z.ZodOptional<z.ZodBoolean>;
494
+ tests: z.ZodOptional<z.ZodArray<z.ZodObject<{
495
+ program: z.ZodString;
496
+ args: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
497
+ cwd: z.ZodOptional<z.ZodString>;
498
+ envAllowlist: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
499
+ }, "strict", z.ZodTypeAny, {
500
+ program: string;
501
+ args: string[];
502
+ cwd?: string | undefined;
503
+ envAllowlist: string[];
504
+ }, {
505
+ program: string;
506
+ args?: string[] | undefined;
507
+ cwd?: string | undefined;
508
+ envAllowlist?: string[] | undefined;
509
+ }>, "many">>;
510
+ protectedPathApprovals: z.ZodOptional<z.ZodArray<z.ZodObject<{
511
+ path: z.ZodString;
512
+ reason: z.ZodOptional<z.ZodString>;
513
+ }, "strict", z.ZodTypeAny, {
514
+ path: string;
515
+ reason?: string | undefined;
516
+ }, {
517
+ path: string;
518
+ reason?: string | undefined;
519
+ }>, "many">>;
520
+ threadId: z.ZodOptional<z.ZodString>;
521
+ turnId: z.ZodOptional<z.ZodString>;
522
+ parentRunId: z.ZodOptional<z.ZodString>;
523
+ delegatedFromRunId: z.ZodOptional<z.ZodString>;
524
+ retryOf: z.ZodOptional<z.ZodString>;
525
+ planRunId: z.ZodOptional<z.ZodString>;
526
+ planRef: z.ZodOptional<z.ZodObject<{
527
+ runId: z.ZodString;
528
+ sha256: z.ZodString;
529
+ path: z.ZodString;
530
+ }, "strict", z.ZodTypeAny, {
531
+ runId: string;
532
+ sha256: string;
533
+ path: string;
534
+ }, {
535
+ runId: string;
536
+ sha256: string;
537
+ path: string;
538
+ }>>;
539
+ reviewerPanel: z.ZodOptional<z.ZodArray<z.ZodObject<{
540
+ /** Explicit reviewer harness id. Repeated harness ids are allowed so one
541
+ * native provider can review through multiple requested models. */
542
+ harness: z.ZodString;
543
+ /** Optional per-reviewer model hint, passed to that harness only. */
544
+ model: z.ZodOptional<z.ZodString>;
545
+ /** Optional per-reviewer effort hint, passed to that harness only. */
546
+ effort: z.ZodOptional<z.ZodString>;
547
+ }, "strict", z.ZodTypeAny, {
548
+ harness: string;
549
+ model?: string | undefined;
550
+ effort?: string | undefined;
551
+ }, {
552
+ harness: string;
553
+ model?: string | undefined;
554
+ effort?: string | undefined;
555
+ }>, "many">>;
556
+ authPreference: z.ZodOptional<z.ZodEnum<["subscription", "api_key", "auto"]>>;
557
+ credentialProfileId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
558
+ delegate: z.ZodOptional<z.ZodBoolean>;
559
+ maxSeconds: z.ZodOptional<z.ZodNumber>;
560
+ denyPaths: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
561
+ outputSchema: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
562
+ maxTurns: z.ZodOptional<z.ZodNumber>;
563
+ } & {
564
+ access: z.ZodOptional<z.ZodEnum<["readonly", "workspace_write", "full", "inherit_native", "external_sandbox_full"]>>;
565
+ }, "strict", z.ZodTypeAny, {
566
+ prompt: string;
567
+ instructions?: string | undefined;
568
+ attachments?: {
569
+ resourceId: string;
570
+ }[] | undefined;
571
+ mode: "agent" | "ask" | "plan";
572
+ scope: {
573
+ kind: "project";
574
+ root: string;
575
+ context: "auto";
576
+ ephemeral: boolean;
577
+ } | {
578
+ kind: "none";
579
+ };
580
+ execution: {
581
+ isolation: "envelope" | "live";
582
+ delegated: boolean;
583
+ workspaceRoot?: string | undefined;
584
+ };
585
+ harnesses?: string[] | undefined;
586
+ primaryHarness?: string | undefined;
587
+ routingGoal?: "auto" | "economy" | "quality" | undefined;
588
+ model?: string | undefined;
589
+ models?: Record<string, string> | undefined;
590
+ effort?: string | undefined;
591
+ efforts?: Record<string, string> | undefined;
592
+ reviewerModels?: Partial<Record<"anthropic" | "cursor" | "google" | "local" | "openai" | "opencode" | "unknown" | "xai", string>> | undefined;
593
+ reviewerEfforts?: Partial<Record<"anthropic" | "cursor" | "google" | "local" | "openai" | "opencode" | "unknown" | "xai", string>> | undefined;
594
+ n?: number | undefined;
595
+ attempts?: number | null | undefined;
596
+ untilClean?: boolean | undefined;
597
+ deepScan?: boolean | undefined;
598
+ create?: boolean | undefined;
599
+ council?: boolean | undefined;
600
+ synthesis?: "always" | "auto" | "never" | undefined;
601
+ paidBudget?: {
602
+ kind: "unlimited";
603
+ } | {
604
+ kind: "finite";
605
+ maxUsd: number;
606
+ } | undefined;
607
+ web?: "auto" | "cached" | "live" | "off" | undefined;
608
+ externalContextPolicy?: "auto" | "cached" | "live" | "off" | undefined;
609
+ browser?: boolean | undefined;
610
+ tests?: {
611
+ program: string;
612
+ args: string[];
613
+ cwd?: string | undefined;
614
+ envAllowlist: string[];
615
+ }[] | undefined;
616
+ protectedPathApprovals?: {
617
+ path: string;
618
+ reason?: string | undefined;
619
+ }[] | undefined;
620
+ threadId?: string | undefined;
621
+ turnId?: string | undefined;
622
+ parentRunId?: string | undefined;
623
+ delegatedFromRunId?: string | undefined;
624
+ retryOf?: string | undefined;
625
+ planRunId?: string | undefined;
626
+ planRef?: {
627
+ runId: string;
628
+ sha256: string;
629
+ path: string;
630
+ } | undefined;
631
+ reviewerPanel?: {
632
+ harness: string;
633
+ model?: string | undefined;
634
+ effort?: string | undefined;
635
+ }[] | undefined;
636
+ authPreference?: "api_key" | "auto" | "subscription" | undefined;
637
+ credentialProfileId?: string | null | undefined;
638
+ delegate?: boolean | undefined;
639
+ maxSeconds?: number | undefined;
640
+ denyPaths?: string[] | undefined;
641
+ outputSchema?: Record<string, unknown> | undefined;
642
+ maxTurns?: number | undefined;
643
+ access?: "external_sandbox_full" | "full" | "inherit_native" | "readonly" | "workspace_write" | undefined;
644
+ }, {
645
+ prompt?: string | undefined;
646
+ instructions?: string | undefined;
647
+ attachments?: {
648
+ resourceId: string;
649
+ }[] | undefined;
650
+ mode?: "agent" | "ask" | "plan" | undefined;
651
+ scope?: {
652
+ kind: "project";
653
+ root: string;
654
+ context?: "auto" | undefined;
655
+ ephemeral?: boolean | undefined;
656
+ } | {
657
+ kind: "none";
658
+ } | undefined;
659
+ execution?: {
660
+ isolation?: "envelope" | "live" | undefined;
661
+ delegated?: boolean | undefined;
662
+ workspaceRoot?: string | undefined;
663
+ } | undefined;
664
+ harnesses?: string[] | undefined;
665
+ primaryHarness?: string | undefined;
666
+ routingGoal?: "auto" | "economy" | "quality" | undefined;
667
+ model?: string | undefined;
668
+ models?: Record<string, string> | undefined;
669
+ effort?: string | undefined;
670
+ efforts?: Record<string, string> | undefined;
671
+ reviewerModels?: Partial<Record<"anthropic" | "cursor" | "google" | "local" | "openai" | "opencode" | "unknown" | "xai", string>> | undefined;
672
+ reviewerEfforts?: Partial<Record<"anthropic" | "cursor" | "google" | "local" | "openai" | "opencode" | "unknown" | "xai", string>> | undefined;
673
+ n?: number | undefined;
674
+ attempts?: number | null | undefined;
675
+ untilClean?: boolean | undefined;
676
+ deepScan?: boolean | undefined;
677
+ create?: boolean | undefined;
678
+ council?: boolean | undefined;
679
+ synthesis?: "always" | "auto" | "never" | undefined;
680
+ paidBudget?: {
681
+ kind: "unlimited";
682
+ } | {
683
+ kind: "finite";
684
+ maxUsd: number;
685
+ } | undefined;
686
+ web?: "auto" | "cached" | "live" | "off" | undefined;
687
+ externalContextPolicy?: "auto" | "cached" | "live" | "off" | undefined;
688
+ browser?: boolean | undefined;
689
+ tests?: {
690
+ program: string;
691
+ args?: string[] | undefined;
692
+ cwd?: string | undefined;
693
+ envAllowlist?: string[] | undefined;
694
+ }[] | undefined;
695
+ protectedPathApprovals?: {
696
+ path: string;
697
+ reason?: string | undefined;
698
+ }[] | undefined;
699
+ threadId?: string | undefined;
700
+ turnId?: string | undefined;
701
+ parentRunId?: string | undefined;
702
+ delegatedFromRunId?: string | undefined;
703
+ retryOf?: string | undefined;
704
+ planRunId?: string | undefined;
705
+ planRef?: {
706
+ runId: string;
707
+ sha256: string;
708
+ path: string;
709
+ } | undefined;
710
+ reviewerPanel?: {
711
+ harness: string;
712
+ model?: string | undefined;
713
+ effort?: string | undefined;
714
+ }[] | undefined;
715
+ authPreference?: "api_key" | "auto" | "subscription" | undefined;
716
+ credentialProfileId?: string | null | undefined;
717
+ delegate?: boolean | undefined;
718
+ maxSeconds?: number | undefined;
719
+ denyPaths?: string[] | undefined;
720
+ outputSchema?: Record<string, unknown> | undefined;
721
+ maxTurns?: number | undefined;
722
+ access?: "external_sandbox_full" | "full" | "inherit_native" | "readonly" | "workspace_write" | undefined;
723
+ }>;
724
+ export type RecordedControlRunStartRequest = z.infer<typeof RecordedControlRunStartRequest>;
416
725
  export declare const ControlRunStartInfo: z.ZodObject<{
417
726
  jobId: z.ZodOptional<z.ZodString>;
418
727
  runId: z.ZodString;
@@ -492,12 +801,15 @@ export declare const ControlRunAgainDraft: z.ZodObject<{
492
801
  execution: z.ZodDefault<z.ZodObject<{
493
802
  isolation: z.ZodDefault<z.ZodEnum<["envelope", "live"]>>;
494
803
  delegated: z.ZodDefault<z.ZodBoolean>;
804
+ workspaceRoot: z.ZodOptional<z.ZodString>;
495
805
  }, "strict", z.ZodTypeAny, {
496
806
  isolation: "envelope" | "live";
497
807
  delegated: boolean;
808
+ workspaceRoot?: string | undefined;
498
809
  }, {
499
810
  isolation?: "envelope" | "live" | undefined;
500
811
  delegated?: boolean | undefined;
812
+ workspaceRoot?: string | undefined;
501
813
  }>>;
502
814
  harnesses: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
503
815
  primaryHarness: z.ZodOptional<z.ZodString>;
@@ -554,7 +866,7 @@ export declare const ControlRunAgainDraft: z.ZodObject<{
554
866
  maxUsd: number;
555
867
  }>]>>;
556
868
  /** Requested access profile. Effective access is derived by the engine and never client-supplied. */
557
- access: z.ZodOptional<z.ZodEnum<["readonly", "workspace_write", "full", "external_sandbox_full", "inherit_native"]>>;
869
+ access: z.ZodOptional<z.ZodEnum<["readonly", "workspace_write", "full", "inherit_native"]>>;
558
870
  web: z.ZodOptional<z.ZodEnum<["off", "auto", "cached", "live"]>>;
559
871
  externalContextPolicy: z.ZodOptional<z.ZodEnum<["off", "auto", "cached", "live"]>>;
560
872
  /** Opt this run into the agent-driven browser (Playwright MCP). */
@@ -695,6 +1007,7 @@ export declare const ControlRunAgainDraft: z.ZodObject<{
695
1007
  execution: {
696
1008
  isolation: "envelope" | "live";
697
1009
  delegated: boolean;
1010
+ workspaceRoot?: string | undefined;
698
1011
  };
699
1012
  harnesses?: string[] | undefined;
700
1013
  primaryHarness?: string | undefined;
@@ -718,7 +1031,7 @@ export declare const ControlRunAgainDraft: z.ZodObject<{
718
1031
  kind: "finite";
719
1032
  maxUsd: number;
720
1033
  } | undefined;
721
- access?: "external_sandbox_full" | "full" | "inherit_native" | "readonly" | "workspace_write" | undefined;
1034
+ access?: "full" | "inherit_native" | "readonly" | "workspace_write" | undefined;
722
1035
  web?: "auto" | "cached" | "live" | "off" | undefined;
723
1036
  externalContextPolicy?: "auto" | "cached" | "live" | "off" | undefined;
724
1037
  browser?: boolean | undefined;
@@ -773,6 +1086,7 @@ export declare const ControlRunAgainDraft: z.ZodObject<{
773
1086
  execution?: {
774
1087
  isolation?: "envelope" | "live" | undefined;
775
1088
  delegated?: boolean | undefined;
1089
+ workspaceRoot?: string | undefined;
776
1090
  } | undefined;
777
1091
  harnesses?: string[] | undefined;
778
1092
  primaryHarness?: string | undefined;
@@ -796,7 +1110,7 @@ export declare const ControlRunAgainDraft: z.ZodObject<{
796
1110
  kind: "finite";
797
1111
  maxUsd: number;
798
1112
  } | undefined;
799
- access?: "external_sandbox_full" | "full" | "inherit_native" | "readonly" | "workspace_write" | undefined;
1113
+ access?: "full" | "inherit_native" | "readonly" | "workspace_write" | undefined;
800
1114
  web?: "auto" | "cached" | "live" | "off" | undefined;
801
1115
  externalContextPolicy?: "auto" | "cached" | "live" | "off" | undefined;
802
1116
  browser?: boolean | undefined;
@@ -834,6 +1148,13 @@ export declare const ControlRunAgainDraft: z.ZodObject<{
834
1148
  outputSchema?: Record<string, unknown> | undefined;
835
1149
  maxTurns?: number | undefined;
836
1150
  }>;
1151
+ accessChoice: z.ZodObject<{
1152
+ required: z.ZodBoolean;
1153
+ }, "strict", z.ZodTypeAny, {
1154
+ required: boolean;
1155
+ }, {
1156
+ required: boolean;
1157
+ }>;
837
1158
  differences: z.ZodDefault<z.ZodArray<z.ZodObject<{
838
1159
  field: z.ZodString;
839
1160
  change: z.ZodLiteral<"omitted">;
@@ -867,6 +1188,7 @@ export declare const ControlRunAgainDraft: z.ZodObject<{
867
1188
  execution: {
868
1189
  isolation: "envelope" | "live";
869
1190
  delegated: boolean;
1191
+ workspaceRoot?: string | undefined;
870
1192
  };
871
1193
  harnesses?: string[] | undefined;
872
1194
  primaryHarness?: string | undefined;
@@ -890,7 +1212,7 @@ export declare const ControlRunAgainDraft: z.ZodObject<{
890
1212
  kind: "finite";
891
1213
  maxUsd: number;
892
1214
  } | undefined;
893
- access?: "external_sandbox_full" | "full" | "inherit_native" | "readonly" | "workspace_write" | undefined;
1215
+ access?: "full" | "inherit_native" | "readonly" | "workspace_write" | undefined;
894
1216
  web?: "auto" | "cached" | "live" | "off" | undefined;
895
1217
  externalContextPolicy?: "auto" | "cached" | "live" | "off" | undefined;
896
1218
  browser?: boolean | undefined;
@@ -928,6 +1250,9 @@ export declare const ControlRunAgainDraft: z.ZodObject<{
928
1250
  outputSchema?: Record<string, unknown> | undefined;
929
1251
  maxTurns?: number | undefined;
930
1252
  };
1253
+ accessChoice: {
1254
+ required: boolean;
1255
+ };
931
1256
  differences: {
932
1257
  field: string;
933
1258
  change: "omitted";
@@ -953,6 +1278,7 @@ export declare const ControlRunAgainDraft: z.ZodObject<{
953
1278
  execution?: {
954
1279
  isolation?: "envelope" | "live" | undefined;
955
1280
  delegated?: boolean | undefined;
1281
+ workspaceRoot?: string | undefined;
956
1282
  } | undefined;
957
1283
  harnesses?: string[] | undefined;
958
1284
  primaryHarness?: string | undefined;
@@ -976,7 +1302,7 @@ export declare const ControlRunAgainDraft: z.ZodObject<{
976
1302
  kind: "finite";
977
1303
  maxUsd: number;
978
1304
  } | undefined;
979
- access?: "external_sandbox_full" | "full" | "inherit_native" | "readonly" | "workspace_write" | undefined;
1305
+ access?: "full" | "inherit_native" | "readonly" | "workspace_write" | undefined;
980
1306
  web?: "auto" | "cached" | "live" | "off" | undefined;
981
1307
  externalContextPolicy?: "auto" | "cached" | "live" | "off" | undefined;
982
1308
  browser?: boolean | undefined;
@@ -1014,6 +1340,9 @@ export declare const ControlRunAgainDraft: z.ZodObject<{
1014
1340
  outputSchema?: Record<string, unknown> | undefined;
1015
1341
  maxTurns?: number | undefined;
1016
1342
  };
1343
+ accessChoice: {
1344
+ required: boolean;
1345
+ };
1017
1346
  differences?: {
1018
1347
  field: string;
1019
1348
  change: "omitted";
@@ -1251,7 +1580,7 @@ export declare const ControlRunSummary: z.ZodObject<{
1251
1580
  failure: z.ZodDefault<z.ZodNullable<z.ZodObject<{
1252
1581
  phase: z.ZodDefault<z.ZodString>;
1253
1582
  category: z.ZodDefault<z.ZodEnum<["validation", "project", "auth", "harness_unavailable", "harness_error", "config_error", "budget", "policy", "cancelled", "internal", "unknown"]>>;
1254
- code: z.ZodDefault<z.ZodNullable<z.ZodEnum<["finite_zero", "hard_cap", "estimate_headroom", "unknown_paid_in_flight", "budget_overshoot", "cost_unverifiable", "delegation_child_drain_timeout", "subscription_window_exhausted", "credential_pool_exhausted", "delegated_home_unavailable", "delegated_confinement_unavailable", "delegated_evidence_incomplete"]>>>;
1583
+ code: z.ZodDefault<z.ZodNullable<z.ZodEnum<["finite_zero", "hard_cap", "estimate_headroom", "unknown_paid_in_flight", "budget_overshoot", "cost_unverifiable", "delegation_child_drain_timeout", "subscription_window_exhausted", "credential_pool_exhausted", "delegated_home_unavailable", "delegated_confinement_unavailable", "delegated_evidence_incomplete", "access_profile_incompatible", "retired_access_profile"]>>>;
1255
1584
  harnessId: z.ZodDefault<z.ZodNullable<z.ZodString>>;
1256
1585
  attemptId: z.ZodDefault<z.ZodNullable<z.ZodString>>;
1257
1586
  safeMessage: z.ZodString;
@@ -1264,7 +1593,7 @@ export declare const ControlRunSummary: z.ZodObject<{
1264
1593
  }, "strip", z.ZodTypeAny, {
1265
1594
  phase: string;
1266
1595
  category: "auth" | "budget" | "cancelled" | "config_error" | "harness_error" | "harness_unavailable" | "internal" | "policy" | "project" | "unknown" | "validation";
1267
- code: "budget_overshoot" | "cost_unverifiable" | "credential_pool_exhausted" | "delegated_confinement_unavailable" | "delegated_evidence_incomplete" | "delegated_home_unavailable" | "delegation_child_drain_timeout" | "estimate_headroom" | "finite_zero" | "hard_cap" | "subscription_window_exhausted" | "unknown_paid_in_flight" | null;
1596
+ code: "access_profile_incompatible" | "budget_overshoot" | "cost_unverifiable" | "credential_pool_exhausted" | "delegated_confinement_unavailable" | "delegated_evidence_incomplete" | "delegated_home_unavailable" | "delegation_child_drain_timeout" | "estimate_headroom" | "finite_zero" | "hard_cap" | "retired_access_profile" | "subscription_window_exhausted" | "unknown_paid_in_flight" | null;
1268
1597
  harnessId: string | null;
1269
1598
  attemptId: string | null;
1270
1599
  safeMessage: string;
@@ -1277,7 +1606,7 @@ export declare const ControlRunSummary: z.ZodObject<{
1277
1606
  }, {
1278
1607
  phase?: string | undefined;
1279
1608
  category?: "auth" | "budget" | "cancelled" | "config_error" | "harness_error" | "harness_unavailable" | "internal" | "policy" | "project" | "unknown" | "validation" | undefined;
1280
- code?: "budget_overshoot" | "cost_unverifiable" | "credential_pool_exhausted" | "delegated_confinement_unavailable" | "delegated_evidence_incomplete" | "delegated_home_unavailable" | "delegation_child_drain_timeout" | "estimate_headroom" | "finite_zero" | "hard_cap" | "subscription_window_exhausted" | "unknown_paid_in_flight" | null | undefined;
1609
+ code?: "access_profile_incompatible" | "budget_overshoot" | "cost_unverifiable" | "credential_pool_exhausted" | "delegated_confinement_unavailable" | "delegated_evidence_incomplete" | "delegated_home_unavailable" | "delegation_child_drain_timeout" | "estimate_headroom" | "finite_zero" | "hard_cap" | "retired_access_profile" | "subscription_window_exhausted" | "unknown_paid_in_flight" | null | undefined;
1281
1610
  harnessId?: string | null | undefined;
1282
1611
  attemptId?: string | null | undefined;
1283
1612
  safeMessage: string;
@@ -1416,9 +1745,9 @@ export declare const ControlRunSummary: z.ZodObject<{
1416
1745
  observed: string;
1417
1746
  } | null | undefined;
1418
1747
  }>>>;
1419
- access: z.ZodOptional<z.ZodEnum<["readonly", "workspace_write", "full", "external_sandbox_full", "inherit_native"]>>;
1420
- requestedAccess: z.ZodOptional<z.ZodEnum<["readonly", "workspace_write", "full", "external_sandbox_full", "inherit_native"]>>;
1421
- effectiveAccess: z.ZodOptional<z.ZodEnum<["readonly", "workspace_write", "full", "external_sandbox_full", "inherit_native"]>>;
1748
+ access: z.ZodOptional<z.ZodEnum<["readonly", "workspace_write", "full", "inherit_native", "external_sandbox_full"]>>;
1749
+ requestedAccess: z.ZodOptional<z.ZodEnum<["readonly", "workspace_write", "full", "inherit_native", "external_sandbox_full"]>>;
1750
+ effectiveAccess: z.ZodOptional<z.ZodEnum<["readonly", "workspace_write", "full", "inherit_native", "external_sandbox_full"]>>;
1422
1751
  externalContextPolicy: z.ZodOptional<z.ZodEnum<["off", "auto", "cached", "live"]>>;
1423
1752
  webRequired: z.ZodOptional<z.ZodBoolean>;
1424
1753
  webMode: z.ZodOptional<z.ZodEnum<["off", "auto", "cached", "live"]>>;
@@ -1730,7 +2059,7 @@ export declare const ControlRunSummary: z.ZodObject<{
1730
2059
  failure: {
1731
2060
  phase: string;
1732
2061
  category: "auth" | "budget" | "cancelled" | "config_error" | "harness_error" | "harness_unavailable" | "internal" | "policy" | "project" | "unknown" | "validation";
1733
- code: "budget_overshoot" | "cost_unverifiable" | "credential_pool_exhausted" | "delegated_confinement_unavailable" | "delegated_evidence_incomplete" | "delegated_home_unavailable" | "delegation_child_drain_timeout" | "estimate_headroom" | "finite_zero" | "hard_cap" | "subscription_window_exhausted" | "unknown_paid_in_flight" | null;
2062
+ code: "access_profile_incompatible" | "budget_overshoot" | "cost_unverifiable" | "credential_pool_exhausted" | "delegated_confinement_unavailable" | "delegated_evidence_incomplete" | "delegated_home_unavailable" | "delegation_child_drain_timeout" | "estimate_headroom" | "finite_zero" | "hard_cap" | "retired_access_profile" | "subscription_window_exhausted" | "unknown_paid_in_flight" | null;
1734
2063
  harnessId: string | null;
1735
2064
  attemptId: string | null;
1736
2065
  safeMessage: string;
@@ -1899,7 +2228,7 @@ export declare const ControlRunSummary: z.ZodObject<{
1899
2228
  failure?: {
1900
2229
  phase?: string | undefined;
1901
2230
  category?: "auth" | "budget" | "cancelled" | "config_error" | "harness_error" | "harness_unavailable" | "internal" | "policy" | "project" | "unknown" | "validation" | undefined;
1902
- code?: "budget_overshoot" | "cost_unverifiable" | "credential_pool_exhausted" | "delegated_confinement_unavailable" | "delegated_evidence_incomplete" | "delegated_home_unavailable" | "delegation_child_drain_timeout" | "estimate_headroom" | "finite_zero" | "hard_cap" | "subscription_window_exhausted" | "unknown_paid_in_flight" | null | undefined;
2231
+ code?: "access_profile_incompatible" | "budget_overshoot" | "cost_unverifiable" | "credential_pool_exhausted" | "delegated_confinement_unavailable" | "delegated_evidence_incomplete" | "delegated_home_unavailable" | "delegation_child_drain_timeout" | "estimate_headroom" | "finite_zero" | "hard_cap" | "retired_access_profile" | "subscription_window_exhausted" | "unknown_paid_in_flight" | null | undefined;
1903
2232
  harnessId?: string | null | undefined;
1904
2233
  attemptId?: string | null | undefined;
1905
2234
  safeMessage: string;
@@ -2591,7 +2920,7 @@ export declare const ControlThread: z.ZodObject<{
2591
2920
  * create/PATCH, so the projection must report it back (round-15 #3). */
2592
2921
  credentialProfileId: z.ZodDefault<z.ZodNullable<z.ZodString>>;
2593
2922
  /** Sticky write scope for write turns (D26); null = repo trust default. */
2594
- access: z.ZodDefault<z.ZodNullable<z.ZodEnum<["readonly", "workspace_write", "full", "external_sandbox_full", "inherit_native"]>>>;
2923
+ access: z.ZodDefault<z.ZodNullable<z.ZodEnum<["readonly", "workspace_write", "full", "inherit_native", "external_sandbox_full"]>>>;
2595
2924
  state: z.ZodDefault<z.ZodEnum<["active", "closed", "trashed", "purged"]>>;
2596
2925
  trashedAt: z.ZodDefault<z.ZodNullable<z.ZodString>>;
2597
2926
  purgeAfter: z.ZodDefault<z.ZodNullable<z.ZodString>>;
@@ -3479,7 +3808,7 @@ export declare const ControlThreadCreateRequest: z.ZodObject<{
3479
3808
  primaryHarness: z.ZodOptional<z.ZodString>;
3480
3809
  /** Sticky eligible pool for the thread; turns inherit it when unset. */
3481
3810
  eligibleHarnesses: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
3482
- access: z.ZodOptional<z.ZodEnum<["readonly", "workspace_write", "full", "external_sandbox_full", "inherit_native"]>>;
3811
+ access: z.ZodOptional<z.ZodEnum<["readonly", "workspace_write", "full", "inherit_native"]>>;
3483
3812
  }, "strict", z.ZodTypeAny, {
3484
3813
  title?: string | undefined;
3485
3814
  scope: {
@@ -3496,7 +3825,7 @@ export declare const ControlThreadCreateRequest: z.ZodObject<{
3496
3825
  credentialProfileId?: string | undefined;
3497
3826
  primaryHarness?: string | undefined;
3498
3827
  eligibleHarnesses?: string[] | undefined;
3499
- access?: "external_sandbox_full" | "full" | "inherit_native" | "readonly" | "workspace_write" | undefined;
3828
+ access?: "full" | "inherit_native" | "readonly" | "workspace_write" | undefined;
3500
3829
  }, {
3501
3830
  title?: string | undefined;
3502
3831
  scope?: {
@@ -3513,7 +3842,7 @@ export declare const ControlThreadCreateRequest: z.ZodObject<{
3513
3842
  credentialProfileId?: string | undefined;
3514
3843
  primaryHarness?: string | undefined;
3515
3844
  eligibleHarnesses?: string[] | undefined;
3516
- access?: "external_sandbox_full" | "full" | "inherit_native" | "readonly" | "workspace_write" | undefined;
3845
+ access?: "full" | "inherit_native" | "readonly" | "workspace_write" | undefined;
3517
3846
  }>;
3518
3847
  export type ControlThreadCreateRequest = z.infer<typeof ControlThreadCreateRequest>;
3519
3848
  /** Mutate a thread's title, open/closed state, or sticky routing (rename,
@@ -3524,21 +3853,21 @@ export declare const ControlThreadUpdateRequest: z.ZodObject<{
3524
3853
  primaryHarness: z.ZodOptional<z.ZodNullable<z.ZodString>>;
3525
3854
  credentialProfileId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
3526
3855
  eligibleHarnesses: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
3527
- access: z.ZodOptional<z.ZodNullable<z.ZodEnum<["readonly", "workspace_write", "full", "external_sandbox_full", "inherit_native"]>>>;
3856
+ access: z.ZodOptional<z.ZodNullable<z.ZodEnum<["readonly", "workspace_write", "full", "inherit_native"]>>>;
3528
3857
  }, "strict", z.ZodTypeAny, {
3529
3858
  title?: string | undefined;
3530
3859
  state?: "active" | "closed" | undefined;
3531
3860
  primaryHarness?: string | null | undefined;
3532
3861
  credentialProfileId?: string | null | undefined;
3533
3862
  eligibleHarnesses?: string[] | undefined;
3534
- access?: "external_sandbox_full" | "full" | "inherit_native" | "readonly" | "workspace_write" | null | undefined;
3863
+ access?: "full" | "inherit_native" | "readonly" | "workspace_write" | null | undefined;
3535
3864
  }, {
3536
3865
  title?: string | undefined;
3537
3866
  state?: "active" | "closed" | undefined;
3538
3867
  primaryHarness?: string | null | undefined;
3539
3868
  credentialProfileId?: string | null | undefined;
3540
3869
  eligibleHarnesses?: string[] | undefined;
3541
- access?: "external_sandbox_full" | "full" | "inherit_native" | "readonly" | "workspace_write" | null | undefined;
3870
+ access?: "full" | "inherit_native" | "readonly" | "workspace_write" | null | undefined;
3542
3871
  }>;
3543
3872
  export type ControlThreadUpdateRequest = z.infer<typeof ControlThreadUpdateRequest>;
3544
3873
  /** A registered project skipped during thread listing because its root is no
@@ -3577,7 +3906,7 @@ export declare const ControlThreadListResponse: z.ZodObject<{
3577
3906
  * create/PATCH, so the projection must report it back (round-15 #3). */
3578
3907
  credentialProfileId: z.ZodDefault<z.ZodNullable<z.ZodString>>;
3579
3908
  /** Sticky write scope for write turns (D26); null = repo trust default. */
3580
- access: z.ZodDefault<z.ZodNullable<z.ZodEnum<["readonly", "workspace_write", "full", "external_sandbox_full", "inherit_native"]>>>;
3909
+ access: z.ZodDefault<z.ZodNullable<z.ZodEnum<["readonly", "workspace_write", "full", "inherit_native", "external_sandbox_full"]>>>;
3581
3910
  state: z.ZodDefault<z.ZodEnum<["active", "closed", "trashed", "purged"]>>;
3582
3911
  trashedAt: z.ZodDefault<z.ZodNullable<z.ZodString>>;
3583
3912
  purgeAfter: z.ZodDefault<z.ZodNullable<z.ZodString>>;
@@ -3714,7 +4043,7 @@ export declare const ControlThreadDetail: z.ZodObject<{
3714
4043
  * create/PATCH, so the projection must report it back (round-15 #3). */
3715
4044
  credentialProfileId: z.ZodDefault<z.ZodNullable<z.ZodString>>;
3716
4045
  /** Sticky write scope for write turns (D26); null = repo trust default. */
3717
- access: z.ZodDefault<z.ZodNullable<z.ZodEnum<["readonly", "workspace_write", "full", "external_sandbox_full", "inherit_native"]>>>;
4046
+ access: z.ZodDefault<z.ZodNullable<z.ZodEnum<["readonly", "workspace_write", "full", "inherit_native", "external_sandbox_full"]>>>;
3718
4047
  state: z.ZodDefault<z.ZodEnum<["active", "closed", "trashed", "purged"]>>;
3719
4048
  trashedAt: z.ZodDefault<z.ZodNullable<z.ZodString>>;
3720
4049
  purgeAfter: z.ZodDefault<z.ZodNullable<z.ZodString>>;