@kitman-sh/sdk 0.9.0 → 0.10.52

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
@@ -3,51 +3,198 @@ import { type ProgramRpcClient } from '../../../live/src/rpc/runner-client';
3
3
  import * as Effect from 'effect/Effect';
4
4
  import * as Option from 'effect/Option';
5
5
  import * as Schema from 'effect/Schema';
6
- import type { PackageConfig } from '../loop/config';
6
+ import type { KitConfig } from '../loop/config';
7
7
  import { ManifestInvalid } from '../loop/define';
8
8
  import { type ProgramJournal } from './engine';
9
9
  /** Asks a bundle for its declarations and check results instead of running a program. */
10
10
  export declare const describeFlag = "--kitman-describe";
11
+ /** Each Kit the bundle carries, the built Kit first, or the first refusal. */
11
12
  export declare const Described: Schema.Union<readonly [Schema.TaggedStruct<"Described", {
12
- readonly loops: Schema.$Array<Schema.Struct<{
13
- readonly id: Schema.String;
14
- readonly title: Schema.String;
15
- readonly input: Schema.$Record<Schema.String, Schema.Codec<Schema.Json, Schema.Json, never, never>>;
16
- readonly output: Schema.$Record<Schema.String, Schema.Codec<Schema.Json, Schema.Json, never, never>>;
17
- readonly outcome: Schema.optionalKey<Schema.Literals<readonly ["feature", "bug", "refactor", "investigation", "docs", "migration"]>>;
18
- readonly agents: Schema.$Record<Schema.String, Schema.String>;
19
- readonly checkout: Schema.Literals<readonly ["none", "read", "write"]>;
20
- readonly when: Schema.$Array<Schema.Struct<{
21
- readonly event: Schema.String;
22
- readonly filter: Schema.optionalKey<Schema.$Record<Schema.String, Schema.Union<readonly [Schema.Union<readonly [Schema.String, Schema.Finite, Schema.Boolean, Schema.Null]>, Schema.$Array<Schema.Union<readonly [Schema.String, Schema.Finite, Schema.Boolean, Schema.Null]>>]>>>;
23
- readonly input: Schema.$Record<Schema.String, Schema.String>;
24
- }>>;
25
- readonly offers: Schema.$Array<Schema.Struct<{
13
+ readonly kits: Schema.$Array<Schema.Struct<{
14
+ readonly name: Schema.String;
15
+ readonly version: Schema.String;
16
+ readonly loops: Schema.$Array<Schema.Struct<{
26
17
  readonly id: Schema.String;
27
18
  readonly title: Schema.String;
28
- readonly loop: Schema.String;
19
+ readonly version: Schema.optionalKey<Schema.String>;
20
+ readonly input: Schema.$Record<Schema.String, Schema.Codec<Schema.Json, Schema.Json, never, never>>;
21
+ readonly output: Schema.$Record<Schema.String, Schema.Codec<Schema.Json, Schema.Json, never, never>>;
22
+ readonly outcome: Schema.optionalKey<Schema.Literals<readonly ["feature", "bug", "refactor", "investigation", "docs", "migration", "performance"]>>;
23
+ readonly agents: Schema.$Record<Schema.String, Schema.String>;
24
+ readonly checkout: Schema.Literals<readonly ["none", "read", "write"]>;
25
+ readonly when: Schema.$Array<Schema.Struct<{
26
+ readonly event: Schema.String;
27
+ readonly filter: Schema.optionalKey<Schema.$Record<Schema.String, Schema.Union<readonly [Schema.Union<readonly [Schema.String, Schema.Finite, Schema.Boolean, Schema.Null]>, Schema.$Array<Schema.Union<readonly [Schema.String, Schema.Finite, Schema.Boolean, Schema.Null]>>]>>>;
28
+ readonly input: Schema.$Record<Schema.String, Schema.String>;
29
+ readonly values: Schema.optionalKey<Schema.$Record<Schema.String, Schema.Codec<Schema.Json, Schema.Json, never, never>>>;
30
+ }>>;
31
+ readonly offers: Schema.$Array<Schema.Struct<{
32
+ readonly id: Schema.String;
33
+ readonly title: Schema.String;
34
+ readonly loop: Schema.String;
35
+ readonly from: Schema.optionalKey<Schema.String>;
36
+ }>>;
37
+ readonly capabilities: Schema.$Array<Schema.Literals<readonly ["agent_work", "ask", "call", "verify", "change_request", "write_back", "post_comment", "create_tasks", "merge_change_request", "approve_change_request", "publish_release", "read_transcripts", "read_change_request", "measure", "claim", "propose", "read_project", "draft_update"]>>;
38
+ readonly secrets: Schema.optionalKey<Schema.$Array<Schema.String>>;
39
+ readonly network: Schema.optionalKey<Schema.Union<readonly [Schema.Struct<{
40
+ readonly hosts: Schema.$Array<Schema.String>;
41
+ }>, Schema.Literal<"open">]>>;
42
+ readonly schedule: Schema.optionalKey<Schema.Struct<{
43
+ readonly rule: Schema.Union<readonly [Schema.Struct<{
44
+ readonly frequency: Schema.Literals<readonly ["daily", "weekly"]>;
45
+ readonly hour: Schema.Int;
46
+ readonly minute: Schema.Int;
47
+ readonly second: Schema.optionalKey<Schema.Int>;
48
+ readonly daysOfWeek: Schema.optionalKey<Schema.$Array<Schema.Int>>;
49
+ }>, Schema.Struct<{
50
+ readonly cron: Schema.String;
51
+ }>]>;
52
+ readonly timezone: Schema.String;
53
+ }>>;
29
54
  }>>;
30
- readonly capabilities: Schema.$Array<Schema.Literals<readonly ["agent_work", "ask", "call", "verify", "change_request", "write_back", "post_comment", "create_tasks", "merge_change_request", "publish_release", "read_transcripts", "propose", "read_project", "draft_update"]>>;
31
- readonly secrets: Schema.optionalKey<Schema.$Array<Schema.String>>;
32
- readonly network: Schema.optionalKey<Schema.Union<readonly [Schema.Struct<{
33
- readonly hosts: Schema.$Array<Schema.String>;
34
- }>, Schema.Literal<"open">]>>;
35
- readonly schedule: Schema.optionalKey<Schema.Struct<{
36
- readonly rule: Schema.Union<readonly [Schema.Struct<{
37
- readonly frequency: Schema.Literals<readonly ["daily", "weekly"]>;
38
- readonly hour: Schema.Int;
39
- readonly minute: Schema.Int;
40
- readonly second: Schema.optionalKey<Schema.Int>;
41
- readonly daysOfWeek: Schema.optionalKey<Schema.$Array<Schema.Int>>;
55
+ readonly agents: Schema.$Record<Schema.String, Schema.Codec<Schema.Json, Schema.Json, never, never>>;
56
+ readonly schedules: Schema.optionalKey<Schema.$Record<Schema.String, Schema.Codec<Schema.Json, Schema.Json, never, never>>>;
57
+ readonly setup: Schema.optionalKey<Schema.Struct<{
58
+ readonly skills: Schema.optionalKey<Schema.$Array<Schema.Struct<{
59
+ readonly name: Schema.String;
60
+ readonly policy: Schema.Union<readonly [Schema.Literal<"recommended">, Schema.Literal<"required">]>;
61
+ readonly source: Schema.Union<readonly [Schema.Struct<{
62
+ readonly kind: Schema.Literal<"skills_sh">;
63
+ readonly slug: Schema.String;
64
+ readonly version: Schema.optionalKey<Schema.String>;
65
+ }>, Schema.Struct<{
66
+ readonly kind: Schema.Literal<"kitman">;
67
+ readonly skillId: Schema.optionalKey<Schema.String>;
68
+ readonly name: Schema.optionalKey<Schema.String>;
69
+ readonly contentMarkdown: Schema.optionalKey<Schema.String>;
70
+ readonly files: Schema.optionalKey<Schema.$Record<Schema.String, Schema.String>>;
71
+ }>, Schema.Struct<{
72
+ readonly kind: Schema.Literal<"git">;
73
+ readonly url: Schema.String;
74
+ readonly ref: Schema.optionalKey<Schema.String>;
75
+ readonly path: Schema.optionalKey<Schema.String>;
76
+ readonly sha256: Schema.optionalKey<Schema.String>;
77
+ }>, Schema.Struct<{
78
+ readonly kind: Schema.Literal<"package">;
79
+ readonly packageName: Schema.String;
80
+ readonly version: Schema.String;
81
+ readonly path: Schema.optionalKey<Schema.String>;
82
+ readonly sha256: Schema.optionalKey<Schema.String>;
83
+ }>, Schema.Struct<{
84
+ readonly kind: Schema.Literal<"url">;
85
+ readonly url: Schema.String;
86
+ readonly sha256: Schema.String;
87
+ }>, Schema.Struct<{
88
+ readonly kind: Schema.Literal<"local_path">;
89
+ readonly path: Schema.String;
90
+ }>]>;
91
+ readonly appliesTo: Schema.optionalKey<Schema.Struct<{
92
+ readonly dependencies: Schema.optionalKey<Schema.$Array<Schema.String>>;
93
+ readonly files: Schema.optionalKey<Schema.$Array<Schema.String>>;
94
+ }>>;
95
+ }>>>;
96
+ readonly plugins: Schema.optionalKey<Schema.$Array<Schema.Struct<{
97
+ readonly name: Schema.String;
98
+ readonly policy: Schema.Union<readonly [Schema.Literal<"recommended">, Schema.Literal<"required">]>;
99
+ readonly sources: Schema.NonEmptyArray<Schema.Union<readonly [Schema.Struct<{
100
+ readonly kind: Schema.Literal<"package">;
101
+ readonly packageName: Schema.String;
102
+ readonly version: Schema.optionalKey<Schema.String>;
103
+ }>, Schema.Struct<{
104
+ readonly kind: Schema.Literal<"git">;
105
+ readonly url: Schema.String;
106
+ readonly ref: Schema.optionalKey<Schema.String>;
107
+ }>, Schema.Struct<{
108
+ readonly kind: Schema.Literal<"url">;
109
+ readonly url: Schema.String;
110
+ readonly sha256: Schema.String;
111
+ }>, Schema.Struct<{
112
+ readonly kind: Schema.Literal<"local_path">;
113
+ readonly path: Schema.String;
114
+ }>]>>;
115
+ }>>>;
116
+ readonly mcpServers: Schema.optionalKey<Schema.$Array<Schema.Struct<{
117
+ readonly name: Schema.String;
118
+ readonly policy: Schema.Union<readonly [Schema.Literal<"recommended">, Schema.Literal<"required">]>;
119
+ readonly transport: Schema.Union<readonly [Schema.Struct<{
120
+ readonly kind: Schema.Literal<"stdio">;
121
+ readonly command: Schema.String;
122
+ readonly args: Schema.optionalKey<Schema.$Array<Schema.String>>;
123
+ readonly env: Schema.optionalKey<Schema.$Record<Schema.String, Schema.String>>;
124
+ }>, Schema.Struct<{
125
+ readonly kind: Schema.Literal<"streamable_http">;
126
+ readonly url: Schema.String;
127
+ readonly headers: Schema.optionalKey<Schema.$Record<Schema.String, Schema.String>>;
128
+ }>]>;
129
+ }>>>;
130
+ readonly harnessSettings: Schema.optionalKey<Schema.$Array<Schema.Struct<{
131
+ readonly harness: Schema.Union<readonly [Schema.Literal<"opencode">, Schema.Literal<"claude-code">, Schema.Literal<"codex">, Schema.Literal<"pi">]>;
132
+ readonly key: Schema.String;
133
+ readonly policy: Schema.Union<readonly [Schema.Literal<"recommended">, Schema.Literal<"required">]>;
134
+ readonly value: Schema.Unknown;
135
+ }>>>;
136
+ readonly providerAuthRefs: Schema.optionalKey<Schema.$Array<Schema.Union<readonly [Schema.Struct<{
137
+ readonly provider: Schema.String;
138
+ readonly policy: Schema.Union<readonly [Schema.Literal<"recommended">, Schema.Literal<"required">]>;
139
+ readonly kind: Schema.Literal<"existing_harness_login">;
140
+ readonly accountHint: Schema.optionalKey<Schema.String>;
141
+ }>, Schema.Struct<{
142
+ readonly provider: Schema.String;
143
+ readonly policy: Schema.Union<readonly [Schema.Literal<"recommended">, Schema.Literal<"required">]>;
144
+ readonly kind: Schema.Literal<"local_env">;
145
+ readonly envName: Schema.String;
42
146
  }>, Schema.Struct<{
43
- readonly cron: Schema.String;
44
- }>]>;
45
- readonly timezone: Schema.String;
147
+ readonly provider: Schema.String;
148
+ readonly policy: Schema.Union<readonly [Schema.Literal<"recommended">, Schema.Literal<"required">]>;
149
+ readonly kind: Schema.Literal<"runner_secret">;
150
+ readonly runnerSecretName: Schema.String;
151
+ }>, Schema.Struct<{
152
+ readonly provider: Schema.String;
153
+ readonly policy: Schema.Union<readonly [Schema.Literal<"recommended">, Schema.Literal<"required">]>;
154
+ readonly kind: Schema.Literal<"managed_oauth">;
155
+ readonly grantId: Schema.optionalKey<Schema.String>;
156
+ }>]>>>;
157
+ readonly runnerSecretRefs: Schema.optionalKey<Schema.$Array<Schema.Struct<{
158
+ readonly name: Schema.String;
159
+ readonly policy: Schema.Union<readonly [Schema.Literal<"recommended">, Schema.Literal<"required">]>;
160
+ readonly source: Schema.Union<readonly [Schema.Struct<{
161
+ readonly kind: Schema.Literal<"env">;
162
+ readonly envName: Schema.String;
163
+ }>, Schema.Struct<{
164
+ readonly kind: Schema.Literal<"file">;
165
+ readonly pathRef: Schema.String;
166
+ }>, Schema.Struct<{
167
+ readonly kind: Schema.Literal<"exec">;
168
+ readonly commandRef: Schema.String;
169
+ }>]>;
170
+ readonly capabilities: Schema.optionalKey<Schema.$Array<Schema.String>>;
171
+ }>>>;
172
+ readonly permissions: Schema.optionalKey<Schema.$Array<Schema.Struct<{
173
+ readonly key: Schema.String;
174
+ readonly policy: Schema.Union<readonly [Schema.Literal<"recommended">, Schema.Literal<"required">]>;
175
+ readonly value: Schema.Unknown;
176
+ }>>>;
177
+ readonly hooks: Schema.optionalKey<Schema.$Array<Schema.Struct<{
178
+ readonly name: Schema.String;
179
+ readonly event: Schema.String;
180
+ readonly policy: Schema.Union<readonly [Schema.Literal<"recommended">, Schema.Literal<"required">]>;
181
+ readonly command: Schema.String;
182
+ readonly args: Schema.optionalKey<Schema.$Array<Schema.String>>;
183
+ readonly timeoutMs: Schema.optionalKey<Schema.Finite>;
184
+ }>>>;
185
+ readonly runtimeConstraints: Schema.optionalKey<Schema.$Array<Schema.Struct<{
186
+ readonly key: Schema.String;
187
+ readonly policy: Schema.Union<readonly [Schema.Literal<"recommended">, Schema.Literal<"required">]>;
188
+ readonly value: Schema.Unknown;
189
+ }>>>;
190
+ readonly sandboxPolicyRequirements: Schema.optionalKey<Schema.$Array<Schema.Struct<{
191
+ readonly key: Schema.String;
192
+ readonly policy: Schema.Union<readonly [Schema.Literal<"recommended">, Schema.Literal<"required">]>;
193
+ readonly value: Schema.Unknown;
194
+ }>>>;
195
+ readonly instructions: Schema.optionalKey<Schema.String>;
46
196
  }>>;
47
197
  }>>;
48
- readonly agents: Schema.$Record<Schema.String, Schema.Codec<Schema.Json, Schema.Json, never, never>>;
49
- readonly schedules: Schema.optionalKey<Schema.$Record<Schema.String, Schema.Codec<Schema.Json, Schema.Json, never, never>>>;
50
- readonly kits: Schema.optionalKey<Schema.$Record<Schema.String, Schema.Codec<Schema.Json, Schema.Json, never, never>>>;
51
198
  }>, Schema.TaggedStruct<"Refused", {
52
199
  readonly error: Schema.Union<readonly [typeof ManifestInvalid, Schema.Union<readonly [typeof import("../loop").CheckFailed, typeof import("../loop").StepNamedTwice, typeof import("../loop").ReplayDiverged]>]>;
53
200
  }>]>;
@@ -77,6 +224,21 @@ export declare const networkGuard: (input: {
77
224
  fetch: Fetch;
78
225
  journal: <Journal extends Pick<ProgramJournal, 'suspend' | 'finish'>>(journal: Journal) => Journal;
79
226
  };
80
- /** The entry of every Package bundle. */
81
- export declare const runPackage: (config: PackageConfig) => void;
227
+ /** A Kit's package name and version, as its build reads them from `package.json`. */
228
+ export type KitIdentity = {
229
+ readonly name: string;
230
+ readonly version: string;
231
+ };
232
+ type CarriedKit = {
233
+ readonly identity: KitIdentity;
234
+ readonly config: KitConfig;
235
+ };
236
+ /**
237
+ * The Kit and each Kit it extends, in priority order: the Kit, then each `extends` entry and what it extends, in turn.
238
+ * A Kit met twice keeps its first place and its highest version. `packages` names each Kit module the build found; a
239
+ * Kit in `extends` that none names is refused.
240
+ */
241
+ export declare const carriedKits: (config: KitConfig, identity: KitIdentity, packages: readonly (readonly [KitConfig, KitIdentity])[]) => readonly CarriedKit[];
242
+ /** The entry of every Kit bundle, given the Kit's identity and that of each Kit package it depends on. */
243
+ export declare const runKit: (config: KitConfig, identity: KitIdentity, packages: readonly (readonly [KitConfig, KitIdentity])[]) => void;
82
244
  export {};
@@ -1,24 +0,0 @@
1
- import type { KitCreate } from './kit';
2
- declare const marketplace: {
3
- readonly source: 'kitman-engineering-loop';
4
- readonly publisher: 'Kitman Platform';
5
- readonly visibility: 'public';
6
- readonly trusted: true;
7
- readonly reviewStatus: 'approved';
8
- readonly installable: true;
9
- readonly rollout: {
10
- readonly channel: 'default';
11
- readonly installDefault: true;
12
- readonly preservesExistingInstallations: true;
13
- };
14
- };
15
- type ShippedKit = Omit<KitCreate, 'metadata' | 'kind' | 'slug'> & {
16
- readonly slug: string;
17
- readonly kind: 'process' | 'technology';
18
- readonly metadata: {
19
- readonly marketplace: typeof marketplace;
20
- };
21
- };
22
- /** The Kits every Workspace gets by default: the owner's Claude Code setup, for every Harness, at the latest versions. */
23
- export declare const ShippedKitCatalog: readonly ShippedKit[];
24
- export {};
@@ -1,369 +0,0 @@
1
- import * as Schema from 'effect/Schema';
2
- /** A Package's name, from its `package.json`. */
3
- export declare const PackageName: Schema.String;
4
- export declare const PackageDigest: Schema.String;
5
- export declare const PackageLayer: Schema.Union<readonly [Schema.Literal<"team">, Schema.Literal<"workspace">, Schema.Literal<"shipped">]>;
6
- export type PackageLayer = (typeof PackageLayer)['Type'];
7
- export declare const PackageProvenance: Schema.Struct<{
8
- readonly repository: Schema.optionalKey<Schema.String>;
9
- readonly commit: Schema.optionalKey<Schema.String>;
10
- readonly clean: Schema.Boolean;
11
- }>;
12
- export type PackageProvenance = (typeof PackageProvenance)['Type'];
13
- /** A built bundle, base64-encoded. */
14
- export declare const PackageBundleUpload: Schema.Struct<{
15
- readonly bundle: Schema.String;
16
- }>;
17
- export type PackageBundleUpload = (typeof PackageBundleUpload)['Type'];
18
- /** A Package already built and its bundle uploaded, to plan. */
19
- export declare const PackagePlanRequest: Schema.Struct<{
20
- name: Schema.String;
21
- /** The Team layer; without it, the Workspace's. */
22
- teamId: Schema.optionalKey<Schema.String>;
23
- digest: Schema.String;
24
- /** As the build read them out: `loops`, `agents`, and any other kind the Package declares. */
25
- declarations: Schema.$Record<Schema.String, Schema.Unknown>;
26
- protocolVersion: Schema.Int;
27
- provenance: Schema.Struct<{
28
- readonly repository: Schema.optionalKey<Schema.String>;
29
- readonly commit: Schema.optionalKey<Schema.String>;
30
- readonly clean: Schema.Boolean;
31
- }>;
32
- }>;
33
- export type PackagePlanRequest = (typeof PackagePlanRequest)['Type'];
34
- /** Deploys against the version the plan was made from; `null` when the Package has none yet. */
35
- export declare const PackageDeployRequest: Schema.Struct<{
36
- readonly name: Schema.String;
37
- readonly teamId: Schema.optionalKey<Schema.String>;
38
- readonly digest: Schema.String;
39
- readonly declarations: Schema.$Record<Schema.String, Schema.Unknown>;
40
- readonly protocolVersion: Schema.Int;
41
- readonly provenance: Schema.Struct<{
42
- readonly repository: Schema.optionalKey<Schema.String>;
43
- readonly commit: Schema.optionalKey<Schema.String>;
44
- readonly clean: Schema.Boolean;
45
- }>;
46
- readonly expectedVersion: Schema.Union<readonly [Schema.Int, Schema.Null]>;
47
- }>;
48
- export type PackageDeployRequest = (typeof PackageDeployRequest)['Type'];
49
- /** A build of the author's working tree, to run with `kitman dev` and resolve for no one. */
50
- export declare const PackageDevRequest: Schema.Struct<{
51
- digest: Schema.String;
52
- /** As the build read them out: `loops`, `agents`, and any other kind the Package declares. */
53
- declarations: Schema.$Record<Schema.String, Schema.Unknown>;
54
- protocolVersion: Schema.Int;
55
- provenance: Schema.Struct<{
56
- readonly repository: Schema.optionalKey<Schema.String>;
57
- readonly commit: Schema.optionalKey<Schema.String>;
58
- readonly clean: Schema.Boolean;
59
- }>;
60
- }>;
61
- export type PackageDevRequest = (typeof PackageDevRequest)['Type'];
62
- export declare const PackageDevVersion: Schema.Struct<{
63
- readonly id: Schema.String;
64
- readonly digest: Schema.String;
65
- readonly loops: Schema.$Array<Schema.String>;
66
- }>;
67
- export type PackageDevVersion = (typeof PackageDevVersion)['Type'];
68
- /** A field of a Package-owned record edited since the deploy, which the next deploy resets. */
69
- export declare const PackageDrift: Schema.Struct<{
70
- readonly kind: Schema.Union<readonly [Schema.Literal<"schedule">, Schema.Literal<"kit">, Schema.Literal<"kit_installation">, Schema.Literal<"kit_assignment">]>;
71
- readonly key: Schema.String;
72
- readonly field: Schema.String;
73
- /** As the Package last deployed it. */
74
- readonly declared: Schema.Unknown;
75
- readonly live: Schema.Unknown;
76
- readonly changedBy: Schema.optionalKey<Schema.Struct<{
77
- readonly actorType: Schema.String;
78
- readonly actorId: Schema.String;
79
- }>>;
80
- readonly changedAt: Schema.optionalKey<Schema.String>;
81
- }>;
82
- export type PackageDrift = (typeof PackageDrift)['Type'];
83
- export declare const PackagePlanResult: Schema.Struct<{
84
- readonly name: Schema.String;
85
- readonly layer: Schema.Union<readonly [Schema.Literal<"team">, Schema.Literal<"workspace">, Schema.Literal<"shipped">]>;
86
- readonly currentVersion: Schema.Union<readonly [Schema.Int, Schema.Null]>;
87
- /** The commit the current version was built from; a deploy must descend from it. */
88
- readonly currentCommit: Schema.optionalKey<Schema.String>;
89
- readonly loops: Schema.Struct<{
90
- readonly created: Schema.$Array<Schema.String>;
91
- readonly changed: Schema.$Array<Schema.String>;
92
- readonly removed: Schema.$Array<Schema.String>;
93
- }>;
94
- readonly agents: Schema.Struct<{
95
- readonly created: Schema.$Array<Schema.String>;
96
- readonly changed: Schema.$Array<Schema.String>;
97
- readonly removed: Schema.$Array<Schema.String>;
98
- }>;
99
- readonly schedules: Schema.Struct<{
100
- readonly created: Schema.$Array<Schema.String>;
101
- readonly changed: Schema.$Array<Schema.String>;
102
- readonly removed: Schema.$Array<Schema.String>;
103
- /** Unowned records of the same name a first deploy takes over, by key. */
104
- readonly adopted: Schema.$Array<Schema.Struct<{
105
- readonly key: Schema.String;
106
- readonly id: Schema.String;
107
- }>>;
108
- }>;
109
- readonly kits: Schema.Struct<{
110
- readonly created: Schema.$Array<Schema.String>;
111
- readonly changed: Schema.$Array<Schema.String>;
112
- readonly removed: Schema.$Array<Schema.String>;
113
- /** Unowned records of the same name a first deploy takes over, by key. */
114
- readonly adopted: Schema.$Array<Schema.Struct<{
115
- readonly key: Schema.String;
116
- readonly id: Schema.String;
117
- }>>;
118
- }>;
119
- readonly kitInstallations: Schema.Struct<{
120
- readonly created: Schema.$Array<Schema.String>;
121
- readonly changed: Schema.$Array<Schema.String>;
122
- readonly removed: Schema.$Array<Schema.String>;
123
- /** Unowned records of the same name a first deploy takes over, by key. */
124
- readonly adopted: Schema.$Array<Schema.Struct<{
125
- readonly key: Schema.String;
126
- readonly id: Schema.String;
127
- }>>;
128
- }>;
129
- readonly kitAssignments: Schema.Struct<{
130
- readonly created: Schema.$Array<Schema.String>;
131
- readonly changed: Schema.$Array<Schema.String>;
132
- readonly removed: Schema.$Array<Schema.String>;
133
- /** Unowned records of the same name a first deploy takes over, by key. */
134
- readonly adopted: Schema.$Array<Schema.Struct<{
135
- readonly key: Schema.String;
136
- readonly id: Schema.String;
137
- }>>;
138
- }>;
139
- readonly drift: Schema.$Array<Schema.Struct<{
140
- readonly kind: Schema.Union<readonly [Schema.Literal<"schedule">, Schema.Literal<"kit">, Schema.Literal<"kit_installation">, Schema.Literal<"kit_assignment">]>;
141
- readonly key: Schema.String;
142
- readonly field: Schema.String;
143
- /** As the Package last deployed it. */
144
- readonly declared: Schema.Unknown;
145
- readonly live: Schema.Unknown;
146
- readonly changedBy: Schema.optionalKey<Schema.Struct<{
147
- readonly actorType: Schema.String;
148
- readonly actorId: Schema.String;
149
- }>>;
150
- readonly changedAt: Schema.optionalKey<Schema.String>;
151
- }>>;
152
- readonly conflicts: Schema.$Array<Schema.Union<readonly [Schema.Struct<{
153
- readonly kind: Schema.Literal<"id_taken">;
154
- readonly resource: Schema.Union<readonly [Schema.Literal<"loop">, Schema.Literal<"agent">]>;
155
- readonly id: Schema.String;
156
- readonly package: Schema.String;
157
- }>, Schema.Struct<{
158
- readonly kind: Schema.Literal<"not_for_team">;
159
- readonly declaration: Schema.String;
160
- }>, Schema.Struct<{
161
- readonly kind: Schema.Literal<"schedule_team">;
162
- readonly key: Schema.String;
163
- readonly problem: Schema.Union<readonly [Schema.Literal<"missing">, Schema.Literal<"not_allowed">, Schema.Literal<"unknown">]>;
164
- }>, Schema.Struct<{
165
- readonly kind: Schema.Literal<"loop_unresolved">;
166
- readonly record: Schema.Literal<"schedule">;
167
- readonly key: Schema.String;
168
- readonly loop: Schema.String;
169
- }>, Schema.Struct<{
170
- readonly kind: Schema.Literal<"kit_unresolved">;
171
- readonly record: Schema.Union<readonly [Schema.Literal<"agent">, Schema.Literal<"kit_assignment">]>;
172
- readonly key: Schema.String;
173
- readonly kit: Schema.String;
174
- }>, Schema.Struct<{
175
- readonly kind: Schema.Literal<"kit_source">;
176
- readonly key: Schema.String;
177
- readonly problem: Schema.Union<readonly [Schema.Literal<"unknown">, Schema.Literal<"untrusted">, Schema.Literal<"version_unknown">]>;
178
- }>, Schema.Struct<{
179
- readonly kind: Schema.Literal<"kit_policy_disabled">;
180
- readonly key: Schema.String;
181
- }>, Schema.Struct<{
182
- readonly kind: Schema.Literal<"kit_team_unknown">;
183
- readonly key: Schema.String;
184
- readonly team: Schema.String;
185
- }>]>>;
186
- /** Loops and Agents the deploy removes that records outside the Package still name. */
187
- readonly warnings: Schema.$Array<Schema.Struct<{
188
- readonly kind: Schema.Literal<"still_named">;
189
- readonly resource: Schema.Union<readonly [Schema.Literal<"loop">, Schema.Literal<"agent">]>;
190
- readonly id: Schema.String;
191
- readonly record: Schema.String;
192
- }>>;
193
- /** Declared Secrets with no value in the Package's layer; a Run that reads one is refused. */
194
- readonly secretsWithoutValue: Schema.$Array<Schema.String>;
195
- }>;
196
- export type PackagePlanResult = (typeof PackagePlanResult)['Type'];
197
- export declare const PackageVersionSummary: Schema.Struct<{
198
- readonly number: Schema.Int;
199
- readonly digest: Schema.String;
200
- readonly protocolVersion: Schema.Int;
201
- readonly provenance: Schema.Struct<{
202
- readonly repository: Schema.optionalKey<Schema.String>;
203
- readonly commit: Schema.optionalKey<Schema.String>;
204
- readonly clean: Schema.Boolean;
205
- }>;
206
- readonly deployedByActorType: Schema.Union<readonly [Schema.Literal<"human">, Schema.Literal<"delegated_agent">, Schema.Literal<"agent">]>;
207
- readonly deployedByActorId: Schema.String;
208
- /** The Deploy Binding a pipeline deployed it through; a person deployed it when absent. */
209
- readonly deployBindingId: Schema.optionalKey<Schema.String>;
210
- readonly deployedAt: Schema.String;
211
- readonly status: Schema.Union<readonly [Schema.Literal<"current">, Schema.Literal<"superseded">, Schema.Literal<"dev">, Schema.Literal<"removed">]>;
212
- }>;
213
- export type PackageVersionSummary = (typeof PackageVersionSummary)['Type'];
214
- export declare const PackageSummary: Schema.Struct<{
215
- name: Schema.String;
216
- layer: Schema.Union<readonly [Schema.Literal<"team">, Schema.Literal<"workspace">, Schema.Literal<"shipped">]>;
217
- teamId: Schema.optionalKey<Schema.String>;
218
- current: Schema.optionalKey<Schema.Struct<{
219
- readonly number: Schema.Int;
220
- readonly digest: Schema.String;
221
- readonly protocolVersion: Schema.Int;
222
- readonly provenance: Schema.Struct<{
223
- readonly repository: Schema.optionalKey<Schema.String>;
224
- readonly commit: Schema.optionalKey<Schema.String>;
225
- readonly clean: Schema.Boolean;
226
- }>;
227
- readonly deployedByActorType: Schema.Union<readonly [Schema.Literal<"human">, Schema.Literal<"delegated_agent">, Schema.Literal<"agent">]>;
228
- readonly deployedByActorId: Schema.String;
229
- /** The Deploy Binding a pipeline deployed it through; a person deployed it when absent. */
230
- readonly deployBindingId: Schema.optionalKey<Schema.String>;
231
- readonly deployedAt: Schema.String;
232
- readonly status: Schema.Union<readonly [Schema.Literal<"current">, Schema.Literal<"superseded">, Schema.Literal<"dev">, Schema.Literal<"removed">]>;
233
- }>>;
234
- loops: Schema.$Array<Schema.String>;
235
- agents: Schema.$Array<Schema.String>;
236
- }>;
237
- export type PackageSummary = (typeof PackageSummary)['Type'];
238
- export declare const PackageList: Schema.Struct<{
239
- readonly items: Schema.$Array<Schema.Struct<{
240
- name: Schema.String;
241
- layer: Schema.Union<readonly [Schema.Literal<"team">, Schema.Literal<"workspace">, Schema.Literal<"shipped">]>;
242
- teamId: Schema.optionalKey<Schema.String>;
243
- current: Schema.optionalKey<Schema.Struct<{
244
- readonly number: Schema.Int;
245
- readonly digest: Schema.String;
246
- readonly protocolVersion: Schema.Int;
247
- readonly provenance: Schema.Struct<{
248
- readonly repository: Schema.optionalKey<Schema.String>;
249
- readonly commit: Schema.optionalKey<Schema.String>;
250
- readonly clean: Schema.Boolean;
251
- }>;
252
- readonly deployedByActorType: Schema.Union<readonly [Schema.Literal<"human">, Schema.Literal<"delegated_agent">, Schema.Literal<"agent">]>;
253
- readonly deployedByActorId: Schema.String;
254
- /** The Deploy Binding a pipeline deployed it through; a person deployed it when absent. */
255
- readonly deployBindingId: Schema.optionalKey<Schema.String>;
256
- readonly deployedAt: Schema.String;
257
- readonly status: Schema.Union<readonly [Schema.Literal<"current">, Schema.Literal<"superseded">, Schema.Literal<"dev">, Schema.Literal<"removed">]>;
258
- }>>;
259
- loops: Schema.$Array<Schema.String>;
260
- agents: Schema.$Array<Schema.String>;
261
- }>>;
262
- }>;
263
- export type PackageList = (typeof PackageList)['Type'];
264
- /** A Package with every version, newest first. */
265
- export declare const PackageDetail: Schema.Struct<{
266
- readonly name: Schema.String;
267
- readonly layer: Schema.Union<readonly [Schema.Literal<"team">, Schema.Literal<"workspace">, Schema.Literal<"shipped">]>;
268
- readonly teamId: Schema.optionalKey<Schema.String>;
269
- readonly current: Schema.optionalKey<Schema.Struct<{
270
- readonly number: Schema.Int;
271
- readonly digest: Schema.String;
272
- readonly protocolVersion: Schema.Int;
273
- readonly provenance: Schema.Struct<{
274
- readonly repository: Schema.optionalKey<Schema.String>;
275
- readonly commit: Schema.optionalKey<Schema.String>;
276
- readonly clean: Schema.Boolean;
277
- }>;
278
- readonly deployedByActorType: Schema.Union<readonly [Schema.Literal<"human">, Schema.Literal<"delegated_agent">, Schema.Literal<"agent">]>;
279
- readonly deployedByActorId: Schema.String;
280
- /** The Deploy Binding a pipeline deployed it through; a person deployed it when absent. */
281
- readonly deployBindingId: Schema.optionalKey<Schema.String>;
282
- readonly deployedAt: Schema.String;
283
- readonly status: Schema.Union<readonly [Schema.Literal<"current">, Schema.Literal<"superseded">, Schema.Literal<"dev">, Schema.Literal<"removed">]>;
284
- }>>;
285
- readonly loops: Schema.$Array<Schema.String>;
286
- readonly agents: Schema.$Array<Schema.String>;
287
- readonly versions: Schema.$Array<Schema.Struct<{
288
- readonly number: Schema.Int;
289
- readonly digest: Schema.String;
290
- readonly protocolVersion: Schema.Int;
291
- readonly provenance: Schema.Struct<{
292
- readonly repository: Schema.optionalKey<Schema.String>;
293
- readonly commit: Schema.optionalKey<Schema.String>;
294
- readonly clean: Schema.Boolean;
295
- }>;
296
- readonly deployedByActorType: Schema.Union<readonly [Schema.Literal<"human">, Schema.Literal<"delegated_agent">, Schema.Literal<"agent">]>;
297
- readonly deployedByActorId: Schema.String;
298
- /** The Deploy Binding a pipeline deployed it through; a person deployed it when absent. */
299
- readonly deployBindingId: Schema.optionalKey<Schema.String>;
300
- readonly deployedAt: Schema.String;
301
- readonly status: Schema.Union<readonly [Schema.Literal<"current">, Schema.Literal<"superseded">, Schema.Literal<"dev">, Schema.Literal<"removed">]>;
302
- }>>;
303
- /** The Schedules the Package owns, by declared key. */
304
- readonly schedules: Schema.$Array<Schema.Struct<{
305
- readonly key: Schema.String;
306
- readonly id: Schema.String;
307
- readonly name: Schema.optionalKey<Schema.String>;
308
- }>>;
309
- /** The Kits, installations and assignments the Package owns, by declared key; an assignment's id is its Kit's. */
310
- readonly kits: Schema.$Array<Schema.Struct<{
311
- readonly kind: Schema.Union<readonly [Schema.Literal<"kit">, Schema.Literal<"kit_installation">, Schema.Literal<"kit_assignment">]>;
312
- readonly key: Schema.String;
313
- readonly id: Schema.String;
314
- }>>;
315
- readonly drift: Schema.$Array<Schema.Struct<{
316
- readonly kind: Schema.Union<readonly [Schema.Literal<"schedule">, Schema.Literal<"kit">, Schema.Literal<"kit_installation">, Schema.Literal<"kit_assignment">]>;
317
- readonly key: Schema.String;
318
- readonly field: Schema.String;
319
- /** As the Package last deployed it. */
320
- readonly declared: Schema.Unknown;
321
- readonly live: Schema.Unknown;
322
- readonly changedBy: Schema.optionalKey<Schema.Struct<{
323
- readonly actorType: Schema.String;
324
- readonly actorId: Schema.String;
325
- }>>;
326
- readonly changedAt: Schema.optionalKey<Schema.String>;
327
- }>>;
328
- }>;
329
- export type PackageDetail = (typeof PackageDetail)['Type'];
330
- export declare const PackageScopeQuery: Schema.Struct<{
331
- readonly teamId: Schema.optionalKey<Schema.String>;
332
- }>;
333
- /** A Workspace owner's or admin's trust in one repository branch to deploy one Package to one layer from CI. */
334
- export declare const DeployBinding: Schema.Struct<{
335
- readonly id: Schema.String;
336
- readonly repoBindingId: Schema.String;
337
- /** The RepoBinding's repository, as `owner/name`. */
338
- readonly repository: Schema.String;
339
- readonly branch: Schema.String;
340
- readonly packageName: Schema.String;
341
- readonly layer: Schema.Union<readonly [Schema.Literal<"team">, Schema.Literal<"workspace">, Schema.Literal<"shipped">]>;
342
- readonly teamId: Schema.optionalKey<Schema.String>;
343
- readonly createdByUserId: Schema.String;
344
- readonly createdAt: Schema.String;
345
- }>;
346
- export type DeployBinding = (typeof DeployBinding)['Type'];
347
- /** Binds a RepoBinding's branch to a Package in a Team's layer, or the Workspace's without `teamId`. */
348
- export declare const DeployBindingCreate: Schema.Struct<{
349
- readonly repoBindingId: Schema.String;
350
- readonly branch: Schema.String;
351
- readonly packageName: Schema.String;
352
- readonly teamId: Schema.optionalKey<Schema.String>;
353
- }>;
354
- export type DeployBindingCreate = (typeof DeployBindingCreate)['Type'];
355
- export declare const DeployBindingList: Schema.Struct<{
356
- readonly items: Schema.$Array<Schema.Struct<{
357
- readonly id: Schema.String;
358
- readonly repoBindingId: Schema.String;
359
- /** The RepoBinding's repository, as `owner/name`. */
360
- readonly repository: Schema.String;
361
- readonly branch: Schema.String;
362
- readonly packageName: Schema.String;
363
- readonly layer: Schema.Union<readonly [Schema.Literal<"team">, Schema.Literal<"workspace">, Schema.Literal<"shipped">]>;
364
- readonly teamId: Schema.optionalKey<Schema.String>;
365
- readonly createdByUserId: Schema.String;
366
- readonly createdAt: Schema.String;
367
- }>>;
368
- }>;
369
- export type DeployBindingList = (typeof DeployBindingList)['Type'];