@kitman-sh/sdk 0.9.0 → 0.10.53

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 (63) hide show
  1. package/dist/build/index.js +531 -116
  2. package/dist/{chunk-36jhc745.js → chunk-tcbgb4wm.js} +1841 -1574
  3. package/dist/{chunk-e1tqypyy.js → chunk-zvzw3zs4.js} +824 -419
  4. package/dist/loop/index.js +117 -3
  5. package/dist/program/index.js +8 -4
  6. package/package.json +6 -6
  7. package/types/packages/core/src/agent-capabilities.d.ts +6 -0
  8. package/types/packages/core/src/agent-environment.d.ts +32 -216
  9. package/types/packages/core/src/agent-sandbox-policy.d.ts +17 -3
  10. package/types/packages/core/src/change-request-review.d.ts +20 -5
  11. package/types/packages/core/src/change-request.d.ts +33 -208
  12. package/types/packages/core/src/crypto.d.ts +2 -0
  13. package/types/packages/core/src/index.d.ts +8 -4
  14. package/types/packages/core/src/{package-declarations.d.ts → kit-declarations.d.ts} +84 -180
  15. package/types/packages/core/src/kit-install.d.ts +130 -0
  16. package/types/packages/core/src/kit-setup.d.ts +316 -0
  17. package/types/packages/core/src/kit.d.ts +302 -1444
  18. package/types/packages/core/src/loop-layers.d.ts +33 -4
  19. package/types/packages/core/src/loop.d.ts +325 -55
  20. package/types/packages/core/src/marketplace.d.ts +51 -10
  21. package/types/packages/core/src/my-teams.d.ts +135 -20
  22. package/types/packages/core/src/network-host.d.ts +41 -0
  23. package/types/packages/core/src/notification.d.ts +8 -0
  24. package/types/packages/core/src/npm-registry.d.ts +65 -0
  25. package/types/packages/core/src/proposal.d.ts +0 -76
  26. package/types/packages/core/src/push.d.ts +68 -0
  27. package/types/packages/core/src/question-recommendation.d.ts +28 -0
  28. package/types/packages/core/src/redaction.d.ts +15 -3
  29. package/types/packages/core/src/resource-claim.d.ts +79 -0
  30. package/types/packages/core/src/run-display.d.ts +7 -1
  31. package/types/packages/core/src/run-graph.d.ts +1 -1
  32. package/types/packages/core/src/run-launch.d.ts +15 -2
  33. package/types/packages/core/src/run-queue.d.ts +28 -0
  34. package/types/packages/core/src/runner-eligibility.d.ts +21 -2
  35. package/types/packages/core/src/runner.d.ts +46 -15
  36. package/types/packages/core/src/secret.d.ts +18 -1
  37. package/types/packages/core/src/step-brief.d.ts +21 -7
  38. package/types/packages/core/src/sync-kit.d.ts +8 -0
  39. package/types/packages/core/src/task-detail.d.ts +15 -2
  40. package/types/packages/core/src/task.d.ts +9 -0
  41. package/types/packages/core/src/transcript.d.ts +24 -4
  42. package/types/packages/core/src/trust-panel.d.ts +1 -1
  43. package/types/packages/core/src/waiting-on.d.ts +14 -0
  44. package/types/packages/core/src/work-unit.d.ts +339 -8
  45. package/types/packages/live/src/rpc/runner-client.d.ts +505 -10
  46. package/types/packages/live/src/rpc/runner-group.d.ts +958 -28
  47. package/types/packages/sdk/src/build/index.d.ts +45 -9
  48. package/types/packages/sdk/src/loop/activities.d.ts +382 -2
  49. package/types/packages/sdk/src/loop/claims.d.ts +57 -0
  50. package/types/packages/sdk/src/loop/config.d.ts +38 -31
  51. package/types/packages/sdk/src/loop/continuing.d.ts +22 -0
  52. package/types/packages/sdk/src/loop/define.d.ts +30 -5
  53. package/types/packages/sdk/src/loop/evidence.d.ts +18 -3
  54. package/types/packages/sdk/src/loop/index.d.ts +4 -0
  55. package/types/packages/sdk/src/loop/measure.d.ts +132 -0
  56. package/types/packages/sdk/src/loop/plan.d.ts +2 -2
  57. package/types/packages/sdk/src/loop/steps.d.ts +127 -17
  58. package/types/packages/sdk/src/loop/sync.d.ts +53 -0
  59. package/types/packages/sdk/src/loop/test-loop.d.ts +25 -5
  60. package/types/packages/sdk/src/program/engine.d.ts +95 -3
  61. package/types/packages/sdk/src/program/host.d.ts +198 -36
  62. package/types/packages/core/src/engineering-resources.d.ts +0 -24
  63. package/types/packages/core/src/package.d.ts +0 -369
@@ -14,6 +14,8 @@ export declare const StepAttemptStatus: Schema.Literals<readonly ["pending", "ru
14
14
  export declare const QuestionStatus: Schema.Literals<readonly ["open", "answered", "resume_requested", "resumed", "resume_failed", "expired", "cancelled"]>;
15
15
  export declare const LoopSourceMode: Schema.Literals<readonly ["direct", "git_backed"]>;
16
16
  export declare const LoopCapabilityKind: Schema.Literals<readonly ["read_task", "read_repo_binding", "read_agent_environment", "read_kit", "update_task_status", "read_change_request", "read_change_request_review", "read_task_link", "refresh_change_request_metadata", "record_change_request_review", "record_session_update", "create_task_link", "create_task_dependency", "create_task_asset", "create_follow_up_task", "execute_agent", "read_step_attempt", "record_task_thread_entry", "write_provider_repository", "write_provider_change_request", "publish_provider_check", "write_provider_comment", "request_provider_changes", "approve_provider_change_request", "merge_provider_change_request", "wait_for_event", "request_human_approval", "execute_package_ref", "read_context_feedback", "read_session_update", "read_repo_binding", "read_agent_environment", "read_kit", "read_memory", "read_decision", "create_task_dependency", "propose_memory", "propose_kit", "propose_decision", "propose_agent_environment_policy", "propose_team_context", "propose_context_relevance", "execute_runner_sandbox"]>;
17
+ /** A Question's recommendation as its default, when it can be stored as one: a default must be LoopSafeText. */
18
+ export declare const recommendedDefault: (recommended: string | undefined) => string | undefined;
17
19
  export declare const LoopDataSchemaRef: Schema.Struct<{
18
20
  readonly kind: Schema.Literal<"typebox_ref">;
19
21
  readonly name: Schema.String;
@@ -1152,6 +1154,13 @@ export declare const RunWaiting: Schema.Union<readonly [Schema.Struct<{
1152
1154
  readonly kind: Schema.Literal<"verification">;
1153
1155
  readonly name: Schema.String;
1154
1156
  readonly verificationId: Schema.String;
1157
+ }>, Schema.Struct<{
1158
+ readonly kind: Schema.Literal<"queue">;
1159
+ readonly name: Schema.String;
1160
+ readonly workUnitId: Schema.String;
1161
+ readonly rank: Schema.Literals<readonly ["in_progress", "finishing", "new"]>;
1162
+ readonly position: Schema.Int;
1163
+ readonly reason: Schema.String;
1155
1164
  }>]>;
1156
1165
  /** A check a Runner ran at a tree for one of the Run's `verify` Steps. Evidence, unlike an Output's claims. */
1157
1166
  export declare const RunEvidence: Schema.Struct<{
@@ -1160,7 +1169,7 @@ export declare const RunEvidence: Schema.Struct<{
1160
1169
  readonly name: Schema.String;
1161
1170
  readonly command: Schema.String;
1162
1171
  readonly status: Schema.Literals<readonly ["passed", "failed"]>;
1163
- /** It also fails on the default branch, so the Run did not cause it. */
1172
+ /** It also fails on the baseline, so the Run did not cause it. */
1164
1173
  readonly preExisting: Schema.Boolean;
1165
1174
  readonly revision: Schema.String;
1166
1175
  readonly tree: Schema.String;
@@ -1178,6 +1187,7 @@ export declare const ApprovedVerification: Schema.Struct<{
1178
1187
  readonly name: Schema.String;
1179
1188
  readonly command: Schema.String;
1180
1189
  readonly workingDirectory: Schema.optionalKey<Schema.String>;
1190
+ readonly pipeline: Schema.optionalKey<Schema.Boolean>;
1181
1191
  readonly approvedByUserId: Schema.String;
1182
1192
  readonly createdAt: Schema.String;
1183
1193
  }>;
@@ -1189,6 +1199,7 @@ export declare const ApprovedVerificationList: Schema.Struct<{
1189
1199
  readonly name: Schema.String;
1190
1200
  readonly command: Schema.String;
1191
1201
  readonly workingDirectory: Schema.optionalKey<Schema.String>;
1202
+ readonly pipeline: Schema.optionalKey<Schema.Boolean>;
1192
1203
  readonly approvedByUserId: Schema.String;
1193
1204
  readonly createdAt: Schema.String;
1194
1205
  }>>;
@@ -1258,10 +1269,10 @@ export declare const Run: Schema.Struct<{
1258
1269
  readonly teamId: Schema.optionalKey<Schema.String>;
1259
1270
  readonly taskId: Schema.optionalKey<Schema.String>;
1260
1271
  readonly sessionId: Schema.optionalKey<Schema.String>;
1261
- /** The Loop's id in the Package that declared it. */
1272
+ /** The Loop's id in the Kit that declared it. */
1262
1273
  readonly loopId: Schema.String;
1263
- /** The Package version the Run was admitted with. */
1264
- readonly packageVersionId: Schema.optionalKey<Schema.String>;
1274
+ /** The Kit version the Run was admitted with. */
1275
+ readonly kitVersionId: Schema.optionalKey<Schema.String>;
1265
1276
  readonly resourceVersion: Schema.Int;
1266
1277
  readonly status: Schema.Literals<readonly ["pending", "running", "blocked", "completed", "failed", "canceled", "expired"]>;
1267
1278
  readonly trigger: Schema.Struct<{
@@ -1343,8 +1354,12 @@ export declare const Run: Schema.Struct<{
1343
1354
  readonly loopDigest: Schema.optionalKey<Schema.String>;
1344
1355
  /** The layer a program Run's Loop resolved from. */
1345
1356
  readonly loopLayer: Schema.optionalKey<Schema.Literals<readonly ["team", "workspace", "shipped"]>>;
1357
+ /** The semver the program Run's Loop declared when it was admitted. */
1358
+ readonly loopVersion: Schema.optionalKey<Schema.String>;
1346
1359
  /** A Child Run's parent. */
1347
1360
  readonly parentRunId: Schema.optionalKey<Schema.String>;
1361
+ /** The earlier Run whose branch and ChangeRequest this Run continues. */
1362
+ readonly continuesRunId: Schema.optionalKey<Schema.String>;
1348
1363
  readonly waiting: Schema.optionalKey<Schema.$Array<Schema.Union<readonly [Schema.Struct<{
1349
1364
  readonly kind: Schema.Literal<"question">;
1350
1365
  readonly name: Schema.String;
@@ -1370,6 +1385,13 @@ export declare const Run: Schema.Struct<{
1370
1385
  readonly kind: Schema.Literal<"verification">;
1371
1386
  readonly name: Schema.String;
1372
1387
  readonly verificationId: Schema.String;
1388
+ }>, Schema.Struct<{
1389
+ readonly kind: Schema.Literal<"queue">;
1390
+ readonly name: Schema.String;
1391
+ readonly workUnitId: Schema.String;
1392
+ readonly rank: Schema.Literals<readonly ["in_progress", "finishing", "new"]>;
1393
+ readonly position: Schema.Int;
1394
+ readonly reason: Schema.String;
1373
1395
  }>]>>>;
1374
1396
  readonly output: Schema.optionalKey<Schema.Unknown>;
1375
1397
  readonly failureSummary: Schema.optionalKey<Schema.String>;
@@ -1479,14 +1501,18 @@ export declare const StepBrief: Schema.Struct<{
1479
1501
  }>>;
1480
1502
  /** The JSON Schema the Output is validated against. */
1481
1503
  readonly outputSchema: Schema.$Record<Schema.String, Schema.Codec<Schema.Json, Schema.Json, never, never>>;
1482
- /** The skills of the Step's Kits, which the Runner writes where the Harness loads skills. */
1483
- readonly skills: Schema.optionalKey<Schema.$Array<Schema.Struct<{
1504
+ /** The Run's Kits in priority order, each by its setup archive's digest; the first to name an entry wins. */
1505
+ readonly kits: Schema.optionalKey<Schema.$Array<Schema.Struct<{
1484
1506
  readonly name: Schema.String;
1485
- /** By path relative to the skill's directory; `SKILL.md` among them. */
1486
- readonly files: Schema.$Record<Schema.String, Schema.String>;
1507
+ readonly version: Schema.String;
1508
+ readonly setupDigest: Schema.String;
1487
1509
  }>>>;
1488
- /** The agent may use no tool but reading this brief and submitting its Output. */
1510
+ /** The agent may use no tool but reading this brief and submitting its Output; it outranks `tools`. */
1489
1511
  readonly toolless: Schema.optionalKey<Schema.Literal<true>>;
1512
+ /** The Agent's tool capabilities beyond the base tools; none when absent. */
1513
+ readonly tools: Schema.optionalKey<Schema.$Array<Schema.Literals<readonly ["web", "subagents", "artifacts", "browser"]>>>;
1514
+ /** The skills the Harness lists; the Kits' others are loaded by name. None when absent. */
1515
+ readonly listedSkills: Schema.optionalKey<Schema.$Array<Schema.String>>;
1490
1516
  }>;
1491
1517
  export type StepBrief = (typeof StepBrief)['Type'];
1492
1518
  export declare const StepOutputSubmission: Schema.Struct<{
@@ -1528,6 +1554,20 @@ export declare const StepOutputSubmissionResult: Schema.Union<readonly [Schema.S
1528
1554
  readonly message: Schema.String;
1529
1555
  }>]>;
1530
1556
  export type StepOutputSubmissionResult = (typeof StepOutputSubmissionResult)['Type'];
1557
+ /** Why a Runner holds a Harness: it reported the Harness out of quota, or it failed to start. */
1558
+ export declare const HarnessHoldReasons: readonly ['out_of_quota', 'failed_to_start'];
1559
+ export type HarnessHoldReason = (typeof HarnessHoldReasons)[number];
1560
+ export declare const SkippedChoiceReasons: readonly ["not_on_runner", "out_of_quota", "failed_to_start"];
1561
+ /** A choice the attempt passed over, and why; a choice that names no Harness needed the Runner's default. */
1562
+ export declare const SkippedChoice: Schema.Struct<{
1563
+ readonly harness: Schema.optionalKey<Schema.String>;
1564
+ readonly model: Schema.optionalKey<Schema.String>;
1565
+ readonly effort: Schema.optionalKey<Schema.Literals<readonly ["low", "medium", "high", "xhigh"]>>;
1566
+ readonly reason: Schema.Literals<readonly ["not_on_runner", "out_of_quota", "failed_to_start"]>;
1567
+ /** When the choice can be tried again. */
1568
+ readonly until: Schema.optionalKey<Schema.String>;
1569
+ }>;
1570
+ export type SkippedChoice = (typeof SkippedChoice)['Type'];
1531
1571
  export declare const StepAttempt: Schema.Struct<{
1532
1572
  readonly id: Schema.String;
1533
1573
  readonly workspaceId: Schema.String;
@@ -1646,14 +1686,18 @@ export declare const StepAttempt: Schema.Struct<{
1646
1686
  }>>;
1647
1687
  /** The JSON Schema the Output is validated against. */
1648
1688
  readonly outputSchema: Schema.$Record<Schema.String, Schema.Codec<Schema.Json, Schema.Json, never, never>>;
1649
- /** The skills of the Step's Kits, which the Runner writes where the Harness loads skills. */
1650
- readonly skills: Schema.optionalKey<Schema.$Array<Schema.Struct<{
1689
+ /** The Run's Kits in priority order, each by its setup archive's digest; the first to name an entry wins. */
1690
+ readonly kits: Schema.optionalKey<Schema.$Array<Schema.Struct<{
1651
1691
  readonly name: Schema.String;
1652
- /** By path relative to the skill's directory; `SKILL.md` among them. */
1653
- readonly files: Schema.$Record<Schema.String, Schema.String>;
1692
+ readonly version: Schema.String;
1693
+ readonly setupDigest: Schema.String;
1654
1694
  }>>>;
1655
- /** The agent may use no tool but reading this brief and submitting its Output. */
1695
+ /** The agent may use no tool but reading this brief and submitting its Output; it outranks `tools`. */
1656
1696
  readonly toolless: Schema.optionalKey<Schema.Literal<true>>;
1697
+ /** The Agent's tool capabilities beyond the base tools; none when absent. */
1698
+ readonly tools: Schema.optionalKey<Schema.$Array<Schema.Literals<readonly ["web", "subagents", "artifacts", "browser"]>>>;
1699
+ /** The skills the Harness lists; the Kits' others are loaded by name. None when absent. */
1700
+ readonly listedSkills: Schema.optionalKey<Schema.$Array<Schema.String>>;
1657
1701
  }>>;
1658
1702
  readonly failureSummary: Schema.optionalKey<Schema.String>;
1659
1703
  readonly reviewEvidence: Schema.$Array<Schema.Struct<{
@@ -1663,6 +1707,15 @@ export declare const StepAttempt: Schema.Struct<{
1663
1707
  readonly provider: Schema.optionalKey<Schema.String>;
1664
1708
  readonly title: Schema.optionalKey<Schema.String>;
1665
1709
  }>>;
1710
+ /** The choices of its Agent this attempt passed over to launch the one it did. */
1711
+ readonly skippedChoices: Schema.optionalKey<Schema.$Array<Schema.Struct<{
1712
+ readonly harness: Schema.optionalKey<Schema.String>;
1713
+ readonly model: Schema.optionalKey<Schema.String>;
1714
+ readonly effort: Schema.optionalKey<Schema.Literals<readonly ["low", "medium", "high", "xhigh"]>>;
1715
+ readonly reason: Schema.Literals<readonly ["not_on_runner", "out_of_quota", "failed_to_start"]>;
1716
+ /** When the choice can be tried again. */
1717
+ readonly until: Schema.optionalKey<Schema.String>;
1718
+ }>>>;
1666
1719
  readonly lease: Schema.optionalKey<Schema.Struct<{
1667
1720
  readonly ownerId: Schema.String;
1668
1721
  readonly runnerReplicaId: Schema.optionalKey<Schema.String>;
@@ -1798,14 +1851,18 @@ export declare const StepAttemptList: Schema.Struct<{
1798
1851
  }>>;
1799
1852
  /** The JSON Schema the Output is validated against. */
1800
1853
  readonly outputSchema: Schema.$Record<Schema.String, Schema.Codec<Schema.Json, Schema.Json, never, never>>;
1801
- /** The skills of the Step's Kits, which the Runner writes where the Harness loads skills. */
1802
- readonly skills: Schema.optionalKey<Schema.$Array<Schema.Struct<{
1854
+ /** The Run's Kits in priority order, each by its setup archive's digest; the first to name an entry wins. */
1855
+ readonly kits: Schema.optionalKey<Schema.$Array<Schema.Struct<{
1803
1856
  readonly name: Schema.String;
1804
- /** By path relative to the skill's directory; `SKILL.md` among them. */
1805
- readonly files: Schema.$Record<Schema.String, Schema.String>;
1857
+ readonly version: Schema.String;
1858
+ readonly setupDigest: Schema.String;
1806
1859
  }>>>;
1807
- /** The agent may use no tool but reading this brief and submitting its Output. */
1860
+ /** The agent may use no tool but reading this brief and submitting its Output; it outranks `tools`. */
1808
1861
  readonly toolless: Schema.optionalKey<Schema.Literal<true>>;
1862
+ /** The Agent's tool capabilities beyond the base tools; none when absent. */
1863
+ readonly tools: Schema.optionalKey<Schema.$Array<Schema.Literals<readonly ["web", "subagents", "artifacts", "browser"]>>>;
1864
+ /** The skills the Harness lists; the Kits' others are loaded by name. None when absent. */
1865
+ readonly listedSkills: Schema.optionalKey<Schema.$Array<Schema.String>>;
1809
1866
  }>>;
1810
1867
  readonly failureSummary: Schema.optionalKey<Schema.String>;
1811
1868
  readonly reviewEvidence: Schema.$Array<Schema.Struct<{
@@ -1815,6 +1872,15 @@ export declare const StepAttemptList: Schema.Struct<{
1815
1872
  readonly provider: Schema.optionalKey<Schema.String>;
1816
1873
  readonly title: Schema.optionalKey<Schema.String>;
1817
1874
  }>>;
1875
+ /** The choices of its Agent this attempt passed over to launch the one it did. */
1876
+ readonly skippedChoices: Schema.optionalKey<Schema.$Array<Schema.Struct<{
1877
+ readonly harness: Schema.optionalKey<Schema.String>;
1878
+ readonly model: Schema.optionalKey<Schema.String>;
1879
+ readonly effort: Schema.optionalKey<Schema.Literals<readonly ["low", "medium", "high", "xhigh"]>>;
1880
+ readonly reason: Schema.Literals<readonly ["not_on_runner", "out_of_quota", "failed_to_start"]>;
1881
+ /** When the choice can be tried again. */
1882
+ readonly until: Schema.optionalKey<Schema.String>;
1883
+ }>>>;
1818
1884
  readonly lease: Schema.optionalKey<Schema.Struct<{
1819
1885
  readonly ownerId: Schema.String;
1820
1886
  readonly runnerReplicaId: Schema.optionalKey<Schema.String>;
@@ -1842,7 +1908,10 @@ export declare const QuestionResponderPolicy: Schema.Struct<{
1842
1908
  }>;
1843
1909
  export declare const QuestionAnswer: Schema.Struct<{
1844
1910
  readonly value: Schema.String;
1845
- readonly answeredByUserId: Schema.String;
1911
+ /** Left out when the Run took the Question's default. */
1912
+ readonly answeredByUserId: Schema.optionalKey<Schema.String>;
1913
+ /** The Run took the default: nobody was attending, or nobody answered before `defaultAt`. */
1914
+ readonly byDefault: Schema.optionalKey<Schema.Boolean>;
1846
1915
  readonly answeredAt: Schema.String;
1847
1916
  readonly idempotencyKey: Schema.String;
1848
1917
  }>;
@@ -1860,6 +1929,17 @@ export declare const Question: Schema.Struct<{
1860
1929
  /** A program's closed options; an answer outside them is refused. */
1861
1930
  readonly options: Schema.optionalKey<Schema.$Array<Schema.String>>;
1862
1931
  readonly freeText: Schema.optionalKey<Schema.Boolean>;
1932
+ /** A short trade-off for an option, by option. */
1933
+ readonly optionDescriptions: Schema.optionalKey<Schema.$Record<Schema.String, Schema.String>>;
1934
+ /** The answer the asker would pick: one of the options, or a suggested free-text answer. */
1935
+ readonly recommended: Schema.optionalKey<Schema.String>;
1936
+ /** Why the asker recommends it, or, for an `informationOnly` Question, why it cannot. */
1937
+ readonly recommendationReason: Schema.optionalKey<Schema.String>;
1938
+ /** It only asks for something the asker cannot guess, such as a secret's name, so it recommends nothing. */
1939
+ readonly informationOnly: Schema.optionalKey<Schema.Boolean>;
1940
+ /** What the Run takes when nobody answers: at once when it is unattended, else at `defaultAt`. */
1941
+ readonly default: Schema.optionalKey<Schema.String>;
1942
+ readonly defaultAt: Schema.optionalKey<Schema.String>;
1863
1943
  readonly responderPolicy: Schema.Struct<{
1864
1944
  readonly eligibleMemberIds: Schema.$Array<Schema.String>;
1865
1945
  readonly allowWorkspaceAdmins: Schema.Boolean;
@@ -1867,7 +1947,10 @@ export declare const Question: Schema.Struct<{
1867
1947
  readonly status: Schema.Literals<readonly ["open", "answered", "resume_requested", "resumed", "resume_failed", "expired", "cancelled"]>;
1868
1948
  readonly answer: Schema.optionalKey<Schema.Struct<{
1869
1949
  readonly value: Schema.String;
1870
- readonly answeredByUserId: Schema.String;
1950
+ /** Left out when the Run took the Question's default. */
1951
+ readonly answeredByUserId: Schema.optionalKey<Schema.String>;
1952
+ /** The Run took the default: nobody was attending, or nobody answered before `defaultAt`. */
1953
+ readonly byDefault: Schema.optionalKey<Schema.Boolean>;
1871
1954
  readonly answeredAt: Schema.String;
1872
1955
  readonly idempotencyKey: Schema.String;
1873
1956
  }>>;
@@ -1895,6 +1978,17 @@ export declare const QuestionList: Schema.Struct<{
1895
1978
  /** A program's closed options; an answer outside them is refused. */
1896
1979
  readonly options: Schema.optionalKey<Schema.$Array<Schema.String>>;
1897
1980
  readonly freeText: Schema.optionalKey<Schema.Boolean>;
1981
+ /** A short trade-off for an option, by option. */
1982
+ readonly optionDescriptions: Schema.optionalKey<Schema.$Record<Schema.String, Schema.String>>;
1983
+ /** The answer the asker would pick: one of the options, or a suggested free-text answer. */
1984
+ readonly recommended: Schema.optionalKey<Schema.String>;
1985
+ /** Why the asker recommends it, or, for an `informationOnly` Question, why it cannot. */
1986
+ readonly recommendationReason: Schema.optionalKey<Schema.String>;
1987
+ /** It only asks for something the asker cannot guess, such as a secret's name, so it recommends nothing. */
1988
+ readonly informationOnly: Schema.optionalKey<Schema.Boolean>;
1989
+ /** What the Run takes when nobody answers: at once when it is unattended, else at `defaultAt`. */
1990
+ readonly default: Schema.optionalKey<Schema.String>;
1991
+ readonly defaultAt: Schema.optionalKey<Schema.String>;
1898
1992
  readonly responderPolicy: Schema.Struct<{
1899
1993
  readonly eligibleMemberIds: Schema.$Array<Schema.String>;
1900
1994
  readonly allowWorkspaceAdmins: Schema.Boolean;
@@ -1902,7 +1996,10 @@ export declare const QuestionList: Schema.Struct<{
1902
1996
  readonly status: Schema.Literals<readonly ["open", "answered", "resume_requested", "resumed", "resume_failed", "expired", "cancelled"]>;
1903
1997
  readonly answer: Schema.optionalKey<Schema.Struct<{
1904
1998
  readonly value: Schema.String;
1905
- readonly answeredByUserId: Schema.String;
1999
+ /** Left out when the Run took the Question's default. */
2000
+ readonly answeredByUserId: Schema.optionalKey<Schema.String>;
2001
+ /** The Run took the default: nobody was attending, or nobody answered before `defaultAt`. */
2002
+ readonly byDefault: Schema.optionalKey<Schema.Boolean>;
1906
2003
  readonly answeredAt: Schema.String;
1907
2004
  readonly idempotencyKey: Schema.String;
1908
2005
  }>>;
@@ -1943,8 +2040,20 @@ export declare const RunStart: Schema.Struct<{
1943
2040
  readonly devVersionId: Schema.optionalKey<Schema.String>;
1944
2041
  /** The Intent's launch constraints; `rule:protected_paths:<glob>[,<glob>…]` spells a rule. */
1945
2042
  readonly constraints: Schema.optionalKey<Schema.$Array<Schema.String>>;
2043
+ /**
2044
+ * Starts on a new branch even when the Task has an open ChangeRequest an earlier Run left, which this Run's own then
2045
+ * replaces; without it, the Run continues that ChangeRequest.
2046
+ */
2047
+ readonly fresh: Schema.optionalKey<Schema.Boolean>;
2048
+ /** Starts this one Run though the Task's blockers are open. A person or their delegated agent may ask. */
2049
+ readonly overrideBlockers: Schema.optionalKey<Schema.Boolean>;
1946
2050
  }>;
1947
2051
  export type RunStart = (typeof RunStart)['Type'];
2052
+ /** Takes a Run's offered action; `overrideBlockers` as on `RunStart`. */
2053
+ export declare const RunActionTake: Schema.Struct<{
2054
+ readonly overrideBlockers: Schema.optionalKey<Schema.Boolean>;
2055
+ }>;
2056
+ export type RunActionTake = (typeof RunActionTake)['Type'];
1948
2057
  export declare const RunStarted: Schema.Struct<{
1949
2058
  readonly run: Schema.Struct<{
1950
2059
  readonly id: Schema.String;
@@ -1952,10 +2061,10 @@ export declare const RunStarted: Schema.Struct<{
1952
2061
  readonly teamId: Schema.optionalKey<Schema.String>;
1953
2062
  readonly taskId: Schema.optionalKey<Schema.String>;
1954
2063
  readonly sessionId: Schema.optionalKey<Schema.String>;
1955
- /** The Loop's id in the Package that declared it. */
2064
+ /** The Loop's id in the Kit that declared it. */
1956
2065
  readonly loopId: Schema.String;
1957
- /** The Package version the Run was admitted with. */
1958
- readonly packageVersionId: Schema.optionalKey<Schema.String>;
2066
+ /** The Kit version the Run was admitted with. */
2067
+ readonly kitVersionId: Schema.optionalKey<Schema.String>;
1959
2068
  readonly resourceVersion: Schema.Int;
1960
2069
  readonly status: Schema.Literals<readonly ["pending", "running", "blocked", "completed", "failed", "canceled", "expired"]>;
1961
2070
  readonly trigger: Schema.Struct<{
@@ -2037,8 +2146,12 @@ export declare const RunStarted: Schema.Struct<{
2037
2146
  readonly loopDigest: Schema.optionalKey<Schema.String>;
2038
2147
  /** The layer a program Run's Loop resolved from. */
2039
2148
  readonly loopLayer: Schema.optionalKey<Schema.Literals<readonly ["team", "workspace", "shipped"]>>;
2149
+ /** The semver the program Run's Loop declared when it was admitted. */
2150
+ readonly loopVersion: Schema.optionalKey<Schema.String>;
2040
2151
  /** A Child Run's parent. */
2041
2152
  readonly parentRunId: Schema.optionalKey<Schema.String>;
2153
+ /** The earlier Run whose branch and ChangeRequest this Run continues. */
2154
+ readonly continuesRunId: Schema.optionalKey<Schema.String>;
2042
2155
  readonly waiting: Schema.optionalKey<Schema.$Array<Schema.Union<readonly [Schema.Struct<{
2043
2156
  readonly kind: Schema.Literal<"question">;
2044
2157
  readonly name: Schema.String;
@@ -2064,6 +2177,13 @@ export declare const RunStarted: Schema.Struct<{
2064
2177
  readonly kind: Schema.Literal<"verification">;
2065
2178
  readonly name: Schema.String;
2066
2179
  readonly verificationId: Schema.String;
2180
+ }>, Schema.Struct<{
2181
+ readonly kind: Schema.Literal<"queue">;
2182
+ readonly name: Schema.String;
2183
+ readonly workUnitId: Schema.String;
2184
+ readonly rank: Schema.Literals<readonly ["in_progress", "finishing", "new"]>;
2185
+ readonly position: Schema.Int;
2186
+ readonly reason: Schema.String;
2067
2187
  }>]>>>;
2068
2188
  readonly output: Schema.optionalKey<Schema.Unknown>;
2069
2189
  readonly failureSummary: Schema.optionalKey<Schema.String>;
@@ -2133,6 +2253,14 @@ export declare const RunSteerInput: Schema.Struct<{
2133
2253
  readonly idempotencyKey: Schema.String;
2134
2254
  }>;
2135
2255
  export type RunSteerInput = (typeof RunSteerInput)['Type'];
2256
+ /** A resume, with an optional note the retried Step's agent reads first. */
2257
+ export declare const RunResumeInput: Schema.Struct<{
2258
+ readonly steer: Schema.optionalKey<Schema.Struct<{
2259
+ readonly text: Schema.String;
2260
+ readonly idempotencyKey: Schema.String;
2261
+ }>>;
2262
+ }>;
2263
+ export type RunResumeInput = (typeof RunResumeInput)['Type'];
2136
2264
  /** Where a steer went: into a live Session, or queued for the Run's next agent Step. */
2137
2265
  export declare const RunSteerSent: Schema.Struct<{
2138
2266
  readonly steer: Schema.Struct<{
@@ -2275,10 +2403,10 @@ export declare const RunShow: Schema.Struct<{
2275
2403
  readonly teamId: Schema.optionalKey<Schema.String>;
2276
2404
  readonly taskId: Schema.optionalKey<Schema.String>;
2277
2405
  readonly sessionId: Schema.optionalKey<Schema.String>;
2278
- /** The Loop's id in the Package that declared it. */
2406
+ /** The Loop's id in the Kit that declared it. */
2279
2407
  readonly loopId: Schema.String;
2280
- /** The Package version the Run was admitted with. */
2281
- readonly packageVersionId: Schema.optionalKey<Schema.String>;
2408
+ /** The Kit version the Run was admitted with. */
2409
+ readonly kitVersionId: Schema.optionalKey<Schema.String>;
2282
2410
  readonly resourceVersion: Schema.Int;
2283
2411
  readonly status: Schema.Literals<readonly ["pending", "running", "blocked", "completed", "failed", "canceled", "expired"]>;
2284
2412
  readonly trigger: Schema.Struct<{
@@ -2360,8 +2488,12 @@ export declare const RunShow: Schema.Struct<{
2360
2488
  readonly loopDigest: Schema.optionalKey<Schema.String>;
2361
2489
  /** The layer a program Run's Loop resolved from. */
2362
2490
  readonly loopLayer: Schema.optionalKey<Schema.Literals<readonly ["team", "workspace", "shipped"]>>;
2491
+ /** The semver the program Run's Loop declared when it was admitted. */
2492
+ readonly loopVersion: Schema.optionalKey<Schema.String>;
2363
2493
  /** A Child Run's parent. */
2364
2494
  readonly parentRunId: Schema.optionalKey<Schema.String>;
2495
+ /** The earlier Run whose branch and ChangeRequest this Run continues. */
2496
+ readonly continuesRunId: Schema.optionalKey<Schema.String>;
2365
2497
  readonly waiting: Schema.optionalKey<Schema.$Array<Schema.Union<readonly [Schema.Struct<{
2366
2498
  readonly kind: Schema.Literal<"question">;
2367
2499
  readonly name: Schema.String;
@@ -2387,6 +2519,13 @@ export declare const RunShow: Schema.Struct<{
2387
2519
  readonly kind: Schema.Literal<"verification">;
2388
2520
  readonly name: Schema.String;
2389
2521
  readonly verificationId: Schema.String;
2522
+ }>, Schema.Struct<{
2523
+ readonly kind: Schema.Literal<"queue">;
2524
+ readonly name: Schema.String;
2525
+ readonly workUnitId: Schema.String;
2526
+ readonly rank: Schema.Literals<readonly ["in_progress", "finishing", "new"]>;
2527
+ readonly position: Schema.Int;
2528
+ readonly reason: Schema.String;
2390
2529
  }>]>>>;
2391
2530
  readonly output: Schema.optionalKey<Schema.Unknown>;
2392
2531
  readonly failureSummary: Schema.optionalKey<Schema.String>;
@@ -2510,6 +2649,17 @@ export declare const RunShow: Schema.Struct<{
2510
2649
  /** A program's closed options; an answer outside them is refused. */
2511
2650
  readonly options: Schema.optionalKey<Schema.$Array<Schema.String>>;
2512
2651
  readonly freeText: Schema.optionalKey<Schema.Boolean>;
2652
+ /** A short trade-off for an option, by option. */
2653
+ readonly optionDescriptions: Schema.optionalKey<Schema.$Record<Schema.String, Schema.String>>;
2654
+ /** The answer the asker would pick: one of the options, or a suggested free-text answer. */
2655
+ readonly recommended: Schema.optionalKey<Schema.String>;
2656
+ /** Why the asker recommends it, or, for an `informationOnly` Question, why it cannot. */
2657
+ readonly recommendationReason: Schema.optionalKey<Schema.String>;
2658
+ /** It only asks for something the asker cannot guess, such as a secret's name, so it recommends nothing. */
2659
+ readonly informationOnly: Schema.optionalKey<Schema.Boolean>;
2660
+ /** What the Run takes when nobody answers: at once when it is unattended, else at `defaultAt`. */
2661
+ readonly default: Schema.optionalKey<Schema.String>;
2662
+ readonly defaultAt: Schema.optionalKey<Schema.String>;
2513
2663
  readonly responderPolicy: Schema.Struct<{
2514
2664
  readonly eligibleMemberIds: Schema.$Array<Schema.String>;
2515
2665
  readonly allowWorkspaceAdmins: Schema.Boolean;
@@ -2517,7 +2667,10 @@ export declare const RunShow: Schema.Struct<{
2517
2667
  readonly status: Schema.Literals<readonly ["open", "answered", "resume_requested", "resumed", "resume_failed", "expired", "cancelled"]>;
2518
2668
  readonly answer: Schema.optionalKey<Schema.Struct<{
2519
2669
  readonly value: Schema.String;
2520
- readonly answeredByUserId: Schema.String;
2670
+ /** Left out when the Run took the Question's default. */
2671
+ readonly answeredByUserId: Schema.optionalKey<Schema.String>;
2672
+ /** The Run took the default: nobody was attending, or nobody answered before `defaultAt`. */
2673
+ readonly byDefault: Schema.optionalKey<Schema.Boolean>;
2521
2674
  readonly answeredAt: Schema.String;
2522
2675
  readonly idempotencyKey: Schema.String;
2523
2676
  }>>;
@@ -2531,6 +2684,8 @@ export declare const RunShow: Schema.Struct<{
2531
2684
  readonly name: Schema.String;
2532
2685
  readonly status: Schema.Literals<readonly ["pending", "running", "blocked", "completed", "failed", "canceled", "expired"]>;
2533
2686
  readonly createdAt: Schema.String;
2687
+ /** What this Child Run and the Runs below it report left open. */
2688
+ readonly unsettled: Schema.optional<Schema.$Array<Schema.String>>;
2534
2689
  }>>;
2535
2690
  /** The program's own Activities, from the journal. */
2536
2691
  readonly activities: Schema.$Array<Schema.Struct<{
@@ -2576,7 +2731,7 @@ export declare const RunShow: Schema.Struct<{
2576
2731
  readonly name: Schema.String;
2577
2732
  readonly command: Schema.String;
2578
2733
  readonly status: Schema.Literals<readonly ["passed", "failed"]>;
2579
- /** It also fails on the default branch, so the Run did not cause it. */
2734
+ /** It also fails on the baseline, so the Run did not cause it. */
2580
2735
  readonly preExisting: Schema.Boolean;
2581
2736
  readonly revision: Schema.String;
2582
2737
  readonly tree: Schema.String;
@@ -2619,6 +2774,13 @@ export declare const RunShow: Schema.Struct<{
2619
2774
  readonly kind: Schema.Literal<"verification">;
2620
2775
  readonly name: Schema.String;
2621
2776
  readonly verificationId: Schema.String;
2777
+ }>, Schema.Struct<{
2778
+ readonly kind: Schema.Literal<"queue">;
2779
+ readonly name: Schema.String;
2780
+ readonly workUnitId: Schema.String;
2781
+ readonly rank: Schema.Literals<readonly ["in_progress", "finishing", "new"]>;
2782
+ readonly position: Schema.Int;
2783
+ readonly reason: Schema.String;
2622
2784
  }>]>>;
2623
2785
  /** Every Closure, newest first; the first is the Run's. */
2624
2786
  readonly closures: Schema.$Array<Schema.Struct<{
@@ -2639,6 +2801,13 @@ export declare const RunStartPreview: Schema.Struct<{
2639
2801
  readonly inputSchema: Schema.$Record<Schema.String, Schema.Unknown>;
2640
2802
  readonly input: Schema.$Record<Schema.String, Schema.Unknown>;
2641
2803
  readonly missing: Schema.$Array<Schema.String>;
2804
+ /** What a person has to choose for a missing field, naming the choices. */
2805
+ readonly message: Schema.optionalKey<Schema.String>;
2806
+ /** The open blockers that refuse this start unless it overrides them. */
2807
+ readonly waitingOn: Schema.optionalKey<Schema.Struct<{
2808
+ readonly keys: Schema.$Array<Schema.String>;
2809
+ readonly hidden: Schema.Int;
2810
+ }>>;
2642
2811
  readonly teamId: Schema.optionalKey<Schema.String>;
2643
2812
  readonly inferred: Schema.Struct<{
2644
2813
  readonly repoBindingId: Schema.optionalKey<Schema.String>;
@@ -2650,9 +2819,13 @@ export declare const RunStartPreview: Schema.Struct<{
2650
2819
  }>;
2651
2820
  export type RunStartPreview = (typeof RunStartPreview)['Type'];
2652
2821
  /** A Loop as Runs resolve it: the layer it comes from and the digest a new Run pins. */
2822
+ /** A Loop's semver, which its author bumps: major for changed input, output or behaviour people rely on. */
2823
+ export declare const LoopVersion: Schema.String;
2653
2824
  export declare const ProgramLoop: Schema.Struct<{
2654
2825
  readonly id: Schema.String;
2655
2826
  readonly title: Schema.String;
2827
+ /** The semver the Loop declares, shown under its title. */
2828
+ readonly version: Schema.optionalKey<Schema.String>;
2656
2829
  readonly layer: Schema.Literals<readonly ["team", "workspace", "shipped"]>;
2657
2830
  readonly digest: Schema.String;
2658
2831
  readonly outcome: Schema.optionalKey<Schema.String>;
@@ -2660,10 +2833,12 @@ export declare const ProgramLoop: Schema.Struct<{
2660
2833
  readonly id: Schema.String;
2661
2834
  readonly title: Schema.String;
2662
2835
  readonly loop: Schema.String;
2836
+ /** The Output field holding the offered Loop's Input; the offer shows only when the Output has it. */
2837
+ readonly from: Schema.optionalKey<Schema.String>;
2663
2838
  }>>;
2664
2839
  readonly publishedAt: Schema.String;
2665
- /** The Package that declares it. */
2666
- readonly package: Schema.String;
2840
+ /** The Kit that declares it. */
2841
+ readonly kit: Schema.String;
2667
2842
  }>;
2668
2843
  export type ProgramLoop = (typeof ProgramLoop)['Type'];
2669
2844
  /** What an Event did to one program Loop: the Run it started, or why it started none. */
@@ -2689,18 +2864,37 @@ export declare const AutomaticStartList: Schema.Struct<{
2689
2864
  }>>;
2690
2865
  }>;
2691
2866
  export type AutomaticStartList = (typeof AutomaticStartList)['Type'];
2867
+ /** A Harness an Agent launches on when the ones before it are not offered. */
2868
+ export declare const AgentFallback: Schema.Struct<{
2869
+ readonly harness: Schema.String;
2870
+ /** Left out, the Step runs on the Harness's own model, whatever the Agent names. */
2871
+ readonly model: Schema.optionalKey<Schema.String>;
2872
+ /** Left out, the Step runs at the Agent's effort. */
2873
+ readonly effort: Schema.optionalKey<Schema.Literals<readonly ["low", "medium", "high", "xhigh"]>>;
2874
+ }>;
2875
+ export type AgentFallback = (typeof AgentFallback)['Type'];
2692
2876
  /** An Agent as it resolves where it was asked about, merged with what it extends. */
2693
2877
  export declare const ProgramAgent: Schema.Struct<{
2694
2878
  readonly id: Schema.String;
2695
2879
  readonly layer: Schema.Literals<readonly ["team", "workspace", "shipped"]>;
2696
- /** The Package that declares it. */
2697
- readonly package: Schema.String;
2880
+ /** The Kit that declares it. */
2881
+ readonly kit: Schema.String;
2698
2882
  readonly extends: Schema.optionalKey<Schema.String>;
2699
2883
  readonly instructions: Schema.optionalKey<Schema.String>;
2700
2884
  readonly harness: Schema.optionalKey<Schema.String>;
2701
2885
  readonly model: Schema.optionalKey<Schema.String>;
2702
2886
  readonly effort: Schema.optionalKey<Schema.Literals<readonly ["low", "medium", "high", "xhigh"]>>;
2703
- readonly kits: Schema.optionalKey<Schema.$Array<Schema.String>>;
2887
+ readonly fallbacks: Schema.optionalKey<Schema.$Array<Schema.Struct<{
2888
+ readonly harness: Schema.String;
2889
+ /** Left out, the Step runs on the Harness's own model, whatever the Agent names. */
2890
+ readonly model: Schema.optionalKey<Schema.String>;
2891
+ /** Left out, the Step runs at the Agent's effort. */
2892
+ readonly effort: Schema.optionalKey<Schema.Literals<readonly ["low", "medium", "high", "xhigh"]>>;
2893
+ }>>>;
2894
+ /** Tool capabilities beyond the base tools. */
2895
+ readonly tools: Schema.optionalKey<Schema.$Array<Schema.Literals<readonly ["web", "subagents", "artifacts", "browser"]>>>;
2896
+ /** The skills its Steps list. */
2897
+ readonly skills: Schema.optionalKey<Schema.$Array<Schema.String>>;
2704
2898
  readonly network: Schema.optionalKey<Schema.Union<readonly [Schema.Struct<{
2705
2899
  readonly hosts: Schema.$Array<Schema.String>;
2706
2900
  }>, Schema.Literal<"open">]>>;
@@ -2712,7 +2906,9 @@ export declare const ProgramAgent: Schema.Struct<{
2712
2906
  readonly harness: Schema.optionalKey<Schema.Literals<readonly ["team", "workspace", "shipped"]>>;
2713
2907
  readonly model: Schema.optionalKey<Schema.Literals<readonly ["team", "workspace", "shipped"]>>;
2714
2908
  readonly effort: Schema.optionalKey<Schema.Literals<readonly ["team", "workspace", "shipped"]>>;
2715
- readonly kits: Schema.optionalKey<Schema.Literals<readonly ["team", "workspace", "shipped"]>>;
2909
+ readonly fallbacks: Schema.optionalKey<Schema.Literals<readonly ["team", "workspace", "shipped"]>>;
2910
+ readonly tools: Schema.optionalKey<Schema.Literals<readonly ["team", "workspace", "shipped"]>>;
2911
+ readonly skills: Schema.optionalKey<Schema.Literals<readonly ["team", "workspace", "shipped"]>>;
2716
2912
  readonly network: Schema.optionalKey<Schema.Literals<readonly ["team", "workspace", "shipped"]>>;
2717
2913
  readonly sandbox: Schema.optionalKey<Schema.Literals<readonly ["team", "workspace", "shipped"]>>;
2718
2914
  }>>;
@@ -2722,14 +2918,24 @@ export declare const ProgramAgentList: Schema.Struct<{
2722
2918
  readonly items: Schema.$Array<Schema.Struct<{
2723
2919
  readonly id: Schema.String;
2724
2920
  readonly layer: Schema.Literals<readonly ["team", "workspace", "shipped"]>;
2725
- /** The Package that declares it. */
2726
- readonly package: Schema.String;
2921
+ /** The Kit that declares it. */
2922
+ readonly kit: Schema.String;
2727
2923
  readonly extends: Schema.optionalKey<Schema.String>;
2728
2924
  readonly instructions: Schema.optionalKey<Schema.String>;
2729
2925
  readonly harness: Schema.optionalKey<Schema.String>;
2730
2926
  readonly model: Schema.optionalKey<Schema.String>;
2731
2927
  readonly effort: Schema.optionalKey<Schema.Literals<readonly ["low", "medium", "high", "xhigh"]>>;
2732
- readonly kits: Schema.optionalKey<Schema.$Array<Schema.String>>;
2928
+ readonly fallbacks: Schema.optionalKey<Schema.$Array<Schema.Struct<{
2929
+ readonly harness: Schema.String;
2930
+ /** Left out, the Step runs on the Harness's own model, whatever the Agent names. */
2931
+ readonly model: Schema.optionalKey<Schema.String>;
2932
+ /** Left out, the Step runs at the Agent's effort. */
2933
+ readonly effort: Schema.optionalKey<Schema.Literals<readonly ["low", "medium", "high", "xhigh"]>>;
2934
+ }>>>;
2935
+ /** Tool capabilities beyond the base tools. */
2936
+ readonly tools: Schema.optionalKey<Schema.$Array<Schema.Literals<readonly ["web", "subagents", "artifacts", "browser"]>>>;
2937
+ /** The skills its Steps list. */
2938
+ readonly skills: Schema.optionalKey<Schema.$Array<Schema.String>>;
2733
2939
  readonly network: Schema.optionalKey<Schema.Union<readonly [Schema.Struct<{
2734
2940
  readonly hosts: Schema.$Array<Schema.String>;
2735
2941
  }>, Schema.Literal<"open">]>>;
@@ -2741,7 +2947,9 @@ export declare const ProgramAgentList: Schema.Struct<{
2741
2947
  readonly harness: Schema.optionalKey<Schema.Literals<readonly ["team", "workspace", "shipped"]>>;
2742
2948
  readonly model: Schema.optionalKey<Schema.Literals<readonly ["team", "workspace", "shipped"]>>;
2743
2949
  readonly effort: Schema.optionalKey<Schema.Literals<readonly ["team", "workspace", "shipped"]>>;
2744
- readonly kits: Schema.optionalKey<Schema.Literals<readonly ["team", "workspace", "shipped"]>>;
2950
+ readonly fallbacks: Schema.optionalKey<Schema.Literals<readonly ["team", "workspace", "shipped"]>>;
2951
+ readonly tools: Schema.optionalKey<Schema.Literals<readonly ["team", "workspace", "shipped"]>>;
2952
+ readonly skills: Schema.optionalKey<Schema.Literals<readonly ["team", "workspace", "shipped"]>>;
2745
2953
  readonly network: Schema.optionalKey<Schema.Literals<readonly ["team", "workspace", "shipped"]>>;
2746
2954
  readonly sandbox: Schema.optionalKey<Schema.Literals<readonly ["team", "workspace", "shipped"]>>;
2747
2955
  }>>;
@@ -2752,6 +2960,8 @@ export declare const ProgramLoopList: Schema.Struct<{
2752
2960
  readonly items: Schema.$Array<Schema.Struct<{
2753
2961
  readonly id: Schema.String;
2754
2962
  readonly title: Schema.String;
2963
+ /** The semver the Loop declares, shown under its title. */
2964
+ readonly version: Schema.optionalKey<Schema.String>;
2755
2965
  readonly layer: Schema.Literals<readonly ["team", "workspace", "shipped"]>;
2756
2966
  readonly digest: Schema.String;
2757
2967
  readonly outcome: Schema.optionalKey<Schema.String>;
@@ -2759,10 +2969,12 @@ export declare const ProgramLoopList: Schema.Struct<{
2759
2969
  readonly id: Schema.String;
2760
2970
  readonly title: Schema.String;
2761
2971
  readonly loop: Schema.String;
2972
+ /** The Output field holding the offered Loop's Input; the offer shows only when the Output has it. */
2973
+ readonly from: Schema.optionalKey<Schema.String>;
2762
2974
  }>>;
2763
2975
  readonly publishedAt: Schema.String;
2764
- /** The Package that declares it. */
2765
- readonly package: Schema.String;
2976
+ /** The Kit that declares it. */
2977
+ readonly kit: Schema.String;
2766
2978
  }>>;
2767
2979
  }>;
2768
2980
  export type ProgramLoopList = (typeof ProgramLoopList)['Type'];
@@ -2774,10 +2986,10 @@ export declare const RunListItem: Schema.Struct<{
2774
2986
  readonly teamId: Schema.optionalKey<Schema.String>;
2775
2987
  readonly taskId: Schema.optionalKey<Schema.String>;
2776
2988
  readonly sessionId: Schema.optionalKey<Schema.String>;
2777
- /** The Loop's id in the Package that declared it. */
2989
+ /** The Loop's id in the Kit that declared it. */
2778
2990
  readonly loopId: Schema.String;
2779
- /** The Package version the Run was admitted with. */
2780
- readonly packageVersionId: Schema.optionalKey<Schema.String>;
2991
+ /** The Kit version the Run was admitted with. */
2992
+ readonly kitVersionId: Schema.optionalKey<Schema.String>;
2781
2993
  readonly resourceVersion: Schema.Int;
2782
2994
  readonly status: Schema.Literals<readonly ["pending", "running", "blocked", "completed", "failed", "canceled", "expired"]>;
2783
2995
  readonly trigger: Schema.Struct<{
@@ -2859,8 +3071,12 @@ export declare const RunListItem: Schema.Struct<{
2859
3071
  readonly loopDigest: Schema.optionalKey<Schema.String>;
2860
3072
  /** The layer a program Run's Loop resolved from. */
2861
3073
  readonly loopLayer: Schema.optionalKey<Schema.Literals<readonly ["team", "workspace", "shipped"]>>;
3074
+ /** The semver the program Run's Loop declared when it was admitted. */
3075
+ readonly loopVersion: Schema.optionalKey<Schema.String>;
2862
3076
  /** A Child Run's parent. */
2863
3077
  readonly parentRunId: Schema.optionalKey<Schema.String>;
3078
+ /** The earlier Run whose branch and ChangeRequest this Run continues. */
3079
+ readonly continuesRunId: Schema.optionalKey<Schema.String>;
2864
3080
  readonly waiting: Schema.optionalKey<Schema.$Array<Schema.Union<readonly [Schema.Struct<{
2865
3081
  readonly kind: Schema.Literal<"question">;
2866
3082
  readonly name: Schema.String;
@@ -2886,6 +3102,13 @@ export declare const RunListItem: Schema.Struct<{
2886
3102
  readonly kind: Schema.Literal<"verification">;
2887
3103
  readonly name: Schema.String;
2888
3104
  readonly verificationId: Schema.String;
3105
+ }>, Schema.Struct<{
3106
+ readonly kind: Schema.Literal<"queue">;
3107
+ readonly name: Schema.String;
3108
+ readonly workUnitId: Schema.String;
3109
+ readonly rank: Schema.Literals<readonly ["in_progress", "finishing", "new"]>;
3110
+ readonly position: Schema.Int;
3111
+ readonly reason: Schema.String;
2889
3112
  }>]>>>;
2890
3113
  readonly output: Schema.optionalKey<Schema.Unknown>;
2891
3114
  readonly failureSummary: Schema.optionalKey<Schema.String>;
@@ -2935,10 +3158,10 @@ export declare const RunList: Schema.Struct<{
2935
3158
  readonly teamId: Schema.optionalKey<Schema.String>;
2936
3159
  readonly taskId: Schema.optionalKey<Schema.String>;
2937
3160
  readonly sessionId: Schema.optionalKey<Schema.String>;
2938
- /** The Loop's id in the Package that declared it. */
3161
+ /** The Loop's id in the Kit that declared it. */
2939
3162
  readonly loopId: Schema.String;
2940
- /** The Package version the Run was admitted with. */
2941
- readonly packageVersionId: Schema.optionalKey<Schema.String>;
3163
+ /** The Kit version the Run was admitted with. */
3164
+ readonly kitVersionId: Schema.optionalKey<Schema.String>;
2942
3165
  readonly resourceVersion: Schema.Int;
2943
3166
  readonly status: Schema.Literals<readonly ["pending", "running", "blocked", "completed", "failed", "canceled", "expired"]>;
2944
3167
  readonly trigger: Schema.Struct<{
@@ -3020,8 +3243,12 @@ export declare const RunList: Schema.Struct<{
3020
3243
  readonly loopDigest: Schema.optionalKey<Schema.String>;
3021
3244
  /** The layer a program Run's Loop resolved from. */
3022
3245
  readonly loopLayer: Schema.optionalKey<Schema.Literals<readonly ["team", "workspace", "shipped"]>>;
3246
+ /** The semver the program Run's Loop declared when it was admitted. */
3247
+ readonly loopVersion: Schema.optionalKey<Schema.String>;
3023
3248
  /** A Child Run's parent. */
3024
3249
  readonly parentRunId: Schema.optionalKey<Schema.String>;
3250
+ /** The earlier Run whose branch and ChangeRequest this Run continues. */
3251
+ readonly continuesRunId: Schema.optionalKey<Schema.String>;
3025
3252
  readonly waiting: Schema.optionalKey<Schema.$Array<Schema.Union<readonly [Schema.Struct<{
3026
3253
  readonly kind: Schema.Literal<"question">;
3027
3254
  readonly name: Schema.String;
@@ -3047,6 +3274,13 @@ export declare const RunList: Schema.Struct<{
3047
3274
  readonly kind: Schema.Literal<"verification">;
3048
3275
  readonly name: Schema.String;
3049
3276
  readonly verificationId: Schema.String;
3277
+ }>, Schema.Struct<{
3278
+ readonly kind: Schema.Literal<"queue">;
3279
+ readonly name: Schema.String;
3280
+ readonly workUnitId: Schema.String;
3281
+ readonly rank: Schema.Literals<readonly ["in_progress", "finishing", "new"]>;
3282
+ readonly position: Schema.Int;
3283
+ readonly reason: Schema.String;
3050
3284
  }>]>>>;
3051
3285
  readonly output: Schema.optionalKey<Schema.Unknown>;
3052
3286
  readonly failureSummary: Schema.optionalKey<Schema.String>;
@@ -3102,10 +3336,10 @@ export declare const RunWaitResult: Schema.Struct<{
3102
3336
  readonly teamId: Schema.optionalKey<Schema.String>;
3103
3337
  readonly taskId: Schema.optionalKey<Schema.String>;
3104
3338
  readonly sessionId: Schema.optionalKey<Schema.String>;
3105
- /** The Loop's id in the Package that declared it. */
3339
+ /** The Loop's id in the Kit that declared it. */
3106
3340
  readonly loopId: Schema.String;
3107
- /** The Package version the Run was admitted with. */
3108
- readonly packageVersionId: Schema.optionalKey<Schema.String>;
3341
+ /** The Kit version the Run was admitted with. */
3342
+ readonly kitVersionId: Schema.optionalKey<Schema.String>;
3109
3343
  readonly resourceVersion: Schema.Int;
3110
3344
  readonly status: Schema.Literals<readonly ["pending", "running", "blocked", "completed", "failed", "canceled", "expired"]>;
3111
3345
  readonly trigger: Schema.Struct<{
@@ -3187,8 +3421,12 @@ export declare const RunWaitResult: Schema.Struct<{
3187
3421
  readonly loopDigest: Schema.optionalKey<Schema.String>;
3188
3422
  /** The layer a program Run's Loop resolved from. */
3189
3423
  readonly loopLayer: Schema.optionalKey<Schema.Literals<readonly ["team", "workspace", "shipped"]>>;
3424
+ /** The semver the program Run's Loop declared when it was admitted. */
3425
+ readonly loopVersion: Schema.optionalKey<Schema.String>;
3190
3426
  /** A Child Run's parent. */
3191
3427
  readonly parentRunId: Schema.optionalKey<Schema.String>;
3428
+ /** The earlier Run whose branch and ChangeRequest this Run continues. */
3429
+ readonly continuesRunId: Schema.optionalKey<Schema.String>;
3192
3430
  readonly waiting: Schema.optionalKey<Schema.$Array<Schema.Union<readonly [Schema.Struct<{
3193
3431
  readonly kind: Schema.Literal<"question">;
3194
3432
  readonly name: Schema.String;
@@ -3214,6 +3452,13 @@ export declare const RunWaitResult: Schema.Struct<{
3214
3452
  readonly kind: Schema.Literal<"verification">;
3215
3453
  readonly name: Schema.String;
3216
3454
  readonly verificationId: Schema.String;
3455
+ }>, Schema.Struct<{
3456
+ readonly kind: Schema.Literal<"queue">;
3457
+ readonly name: Schema.String;
3458
+ readonly workUnitId: Schema.String;
3459
+ readonly rank: Schema.Literals<readonly ["in_progress", "finishing", "new"]>;
3460
+ readonly position: Schema.Int;
3461
+ readonly reason: Schema.String;
3217
3462
  }>]>>>;
3218
3463
  readonly output: Schema.optionalKey<Schema.Unknown>;
3219
3464
  readonly failureSummary: Schema.optionalKey<Schema.String>;
@@ -3249,6 +3494,17 @@ export declare const RunWaitResult: Schema.Struct<{
3249
3494
  /** A program's closed options; an answer outside them is refused. */
3250
3495
  readonly options: Schema.optionalKey<Schema.$Array<Schema.String>>;
3251
3496
  readonly freeText: Schema.optionalKey<Schema.Boolean>;
3497
+ /** A short trade-off for an option, by option. */
3498
+ readonly optionDescriptions: Schema.optionalKey<Schema.$Record<Schema.String, Schema.String>>;
3499
+ /** The answer the asker would pick: one of the options, or a suggested free-text answer. */
3500
+ readonly recommended: Schema.optionalKey<Schema.String>;
3501
+ /** Why the asker recommends it, or, for an `informationOnly` Question, why it cannot. */
3502
+ readonly recommendationReason: Schema.optionalKey<Schema.String>;
3503
+ /** It only asks for something the asker cannot guess, such as a secret's name, so it recommends nothing. */
3504
+ readonly informationOnly: Schema.optionalKey<Schema.Boolean>;
3505
+ /** What the Run takes when nobody answers: at once when it is unattended, else at `defaultAt`. */
3506
+ readonly default: Schema.optionalKey<Schema.String>;
3507
+ readonly defaultAt: Schema.optionalKey<Schema.String>;
3252
3508
  readonly responderPolicy: Schema.Struct<{
3253
3509
  readonly eligibleMemberIds: Schema.$Array<Schema.String>;
3254
3510
  readonly allowWorkspaceAdmins: Schema.Boolean;
@@ -3256,7 +3512,10 @@ export declare const RunWaitResult: Schema.Struct<{
3256
3512
  readonly status: Schema.Literals<readonly ["open", "answered", "resume_requested", "resumed", "resume_failed", "expired", "cancelled"]>;
3257
3513
  readonly answer: Schema.optionalKey<Schema.Struct<{
3258
3514
  readonly value: Schema.String;
3259
- readonly answeredByUserId: Schema.String;
3515
+ /** Left out when the Run took the Question's default. */
3516
+ readonly answeredByUserId: Schema.optionalKey<Schema.String>;
3517
+ /** The Run took the default: nobody was attending, or nobody answered before `defaultAt`. */
3518
+ readonly byDefault: Schema.optionalKey<Schema.Boolean>;
3260
3519
  readonly answeredAt: Schema.String;
3261
3520
  readonly idempotencyKey: Schema.String;
3262
3521
  }>>;
@@ -3299,10 +3558,10 @@ export declare const RunActionTaken: Schema.Struct<{
3299
3558
  readonly teamId: Schema.optionalKey<Schema.String>;
3300
3559
  readonly taskId: Schema.optionalKey<Schema.String>;
3301
3560
  readonly sessionId: Schema.optionalKey<Schema.String>;
3302
- /** The Loop's id in the Package that declared it. */
3561
+ /** The Loop's id in the Kit that declared it. */
3303
3562
  readonly loopId: Schema.String;
3304
- /** The Package version the Run was admitted with. */
3305
- readonly packageVersionId: Schema.optionalKey<Schema.String>;
3563
+ /** The Kit version the Run was admitted with. */
3564
+ readonly kitVersionId: Schema.optionalKey<Schema.String>;
3306
3565
  readonly resourceVersion: Schema.Int;
3307
3566
  readonly status: Schema.Literals<readonly ["pending", "running", "blocked", "completed", "failed", "canceled", "expired"]>;
3308
3567
  readonly trigger: Schema.Struct<{
@@ -3384,8 +3643,12 @@ export declare const RunActionTaken: Schema.Struct<{
3384
3643
  readonly loopDigest: Schema.optionalKey<Schema.String>;
3385
3644
  /** The layer a program Run's Loop resolved from. */
3386
3645
  readonly loopLayer: Schema.optionalKey<Schema.Literals<readonly ["team", "workspace", "shipped"]>>;
3646
+ /** The semver the program Run's Loop declared when it was admitted. */
3647
+ readonly loopVersion: Schema.optionalKey<Schema.String>;
3387
3648
  /** A Child Run's parent. */
3388
3649
  readonly parentRunId: Schema.optionalKey<Schema.String>;
3650
+ /** The earlier Run whose branch and ChangeRequest this Run continues. */
3651
+ readonly continuesRunId: Schema.optionalKey<Schema.String>;
3389
3652
  readonly waiting: Schema.optionalKey<Schema.$Array<Schema.Union<readonly [Schema.Struct<{
3390
3653
  readonly kind: Schema.Literal<"question">;
3391
3654
  readonly name: Schema.String;
@@ -3411,6 +3674,13 @@ export declare const RunActionTaken: Schema.Struct<{
3411
3674
  readonly kind: Schema.Literal<"verification">;
3412
3675
  readonly name: Schema.String;
3413
3676
  readonly verificationId: Schema.String;
3677
+ }>, Schema.Struct<{
3678
+ readonly kind: Schema.Literal<"queue">;
3679
+ readonly name: Schema.String;
3680
+ readonly workUnitId: Schema.String;
3681
+ readonly rank: Schema.Literals<readonly ["in_progress", "finishing", "new"]>;
3682
+ readonly position: Schema.Int;
3683
+ readonly reason: Schema.String;
3414
3684
  }>]>>>;
3415
3685
  readonly output: Schema.optionalKey<Schema.Unknown>;
3416
3686
  readonly failureSummary: Schema.optionalKey<Schema.String>;