@kitman-sh/sdk 0.9.0 → 0.10.53

package/types/packages/core/src/runner.d.ts

@@ -5,15 +5,15 @@ import type { ControlCommandList } from './run';
 export { RunnerExecutionRouting } from './runner-routing';
 export type { RunnerExecutionRouting as RunnerExecutionRoutingValue } from './runner-routing';
 export declare const DefaultRunnerHeartbeatStaleAfterSeconds = 120;
-export declare const RunnerProblemCodes: readonly ['credential_missing', 'credential_refused', 'runner_removed', 'sandbox_missing', 'update_failed'];
+export declare const RunnerProblemCodes: readonly ['credential_missing', 'credential_refused', 'clock_skew', 'runner_removed', 'sandbox_missing', 'herdr_core_missing', 'update_failed'];
 /** A Runner Problem as the Runner reports it: what only a person can fix, and the one command or action that fixes it. */
 export declare const RunnerProblemReport: Schema.Struct<{
-    readonly code: Schema.Literals<readonly ["credential_missing", "credential_refused", "runner_removed", "sandbox_missing", "update_failed"]>;
+    readonly code: Schema.Literals<readonly ["credential_missing", "credential_refused", "clock_skew", "runner_removed", "sandbox_missing", "herdr_core_missing", "update_failed"]>;
     readonly message: Schema.String;
     readonly fix: Schema.String;
 }>;
 export declare const RunnerProblem: Schema.Struct<{
-    readonly code: Schema.Literals<readonly ["credential_missing", "credential_refused", "runner_removed", "sandbox_missing", "update_failed"]>;
+    readonly code: Schema.Literals<readonly ["credential_missing", "credential_refused", "clock_skew", "runner_removed", "sandbox_missing", "herdr_core_missing", "update_failed"]>;
     readonly message: Schema.String;
     readonly fix: Schema.String;
     readonly startedAt: Schema.String;
@@ -27,7 +27,7 @@ export declare const RunnerState: Schema.Union<readonly [Schema.Struct<{
 }>, Schema.Struct<{
     readonly kind: Schema.Literal<"needs_attention">;
     readonly problems: Schema.$Array<Schema.Struct<{
-        readonly code: Schema.Literals<readonly ["credential_missing", "credential_refused", "runner_removed", "sandbox_missing", "update_failed"]>;
+        readonly code: Schema.Literals<readonly ["credential_missing", "credential_refused", "clock_skew", "runner_removed", "sandbox_missing", "herdr_core_missing", "update_failed"]>;
         readonly message: Schema.String;
         readonly fix: Schema.String;
         readonly startedAt: Schema.String;
@@ -148,6 +148,8 @@ export declare const RunnerCapabilities: Schema.Struct<{
         readonly maxMemoryMb: Schema.optionalKey<Schema.Finite>;
         readonly maxRunSeconds: Schema.optionalKey<Schema.Finite>;
     }>>;
+    /** It benchmarks a verification's measure; a Runner without it is offered none, as one from before measures was. */
+    readonly measure: Schema.optionalKey<Schema.Boolean>;
 }>;
 export declare const Runner: Schema.Struct<{
     readonly id: Schema.String;
@@ -177,7 +179,7 @@ export declare const Runner: Schema.Struct<{
     }>, Schema.Struct<{
         readonly kind: Schema.Literal<"needs_attention">;
         readonly problems: Schema.$Array<Schema.Struct<{
-            readonly code: Schema.Literals<readonly ["credential_missing", "credential_refused", "runner_removed", "sandbox_missing", "update_failed"]>;
+            readonly code: Schema.Literals<readonly ["credential_missing", "credential_refused", "clock_skew", "runner_removed", "sandbox_missing", "herdr_core_missing", "update_failed"]>;
             readonly message: Schema.String;
             readonly fix: Schema.String;
             readonly startedAt: Schema.String;
@@ -257,6 +259,8 @@ export declare const Runner: Schema.Struct<{
             readonly maxMemoryMb: Schema.optionalKey<Schema.Finite>;
             readonly maxRunSeconds: Schema.optionalKey<Schema.Finite>;
         }>>;
+        /** It benchmarks a verification's measure; a Runner without it is offered none, as one from before measures was. */
+        readonly measure: Schema.optionalKey<Schema.Boolean>;
     }>;
     /** The owner's choice of default Harness; `capabilities.defaultHarness` is the one in effect. */
     readonly preferredHarness: Schema.optionalKey<Schema.Literals<readonly ["pi", "claude", "codex"]>>;
@@ -578,6 +582,8 @@ export declare const RunnerCreate: Schema.Struct<{
             readonly maxMemoryMb: Schema.optionalKey<Schema.Finite>;
             readonly maxRunSeconds: Schema.optionalKey<Schema.Finite>;
         }>>;
+        /** It benchmarks a verification's measure; a Runner without it is offered none, as one from before measures was. */
+        readonly measure: Schema.optionalKey<Schema.Boolean>;
     }>>;
     readonly labels: Schema.optionalKey<Schema.$Array<Schema.String>>;
 }>;
@@ -613,7 +619,7 @@ export declare const RunnerRegistrationResult: Schema.Struct<{
         }>, Schema.Struct<{
             readonly kind: Schema.Literal<"needs_attention">;
             readonly problems: Schema.$Array<Schema.Struct<{
-                readonly code: Schema.Literals<readonly ["credential_missing", "credential_refused", "runner_removed", "sandbox_missing", "update_failed"]>;
+                readonly code: Schema.Literals<readonly ["credential_missing", "credential_refused", "clock_skew", "runner_removed", "sandbox_missing", "herdr_core_missing", "update_failed"]>;
                 readonly message: Schema.String;
                 readonly fix: Schema.String;
                 readonly startedAt: Schema.String;
@@ -693,6 +699,8 @@ export declare const RunnerRegistrationResult: Schema.Struct<{
                 readonly maxMemoryMb: Schema.optionalKey<Schema.Finite>;
                 readonly maxRunSeconds: Schema.optionalKey<Schema.Finite>;
             }>>;
+            /** It benchmarks a verification's measure; a Runner without it is offered none, as one from before measures was. */
+            readonly measure: Schema.optionalKey<Schema.Boolean>;
         }>;
         /** The owner's choice of default Harness; `capabilities.defaultHarness` is the one in effect. */
         readonly preferredHarness: Schema.optionalKey<Schema.Literals<readonly ["pi", "claude", "codex"]>>;
@@ -727,7 +735,7 @@ export declare const RunnerHeartbeatInput: Schema.Struct<{
     readonly container: Schema.optionalKey<Schema.Boolean>;
     /** The Runner's open Problems, replacing those it reported before; empty clears them. */
     readonly problems: Schema.optionalKey<Schema.$Array<Schema.Struct<{
-        readonly code: Schema.Literals<readonly ["credential_missing", "credential_refused", "runner_removed", "sandbox_missing", "update_failed"]>;
+        readonly code: Schema.Literals<readonly ["credential_missing", "credential_refused", "clock_skew", "runner_removed", "sandbox_missing", "herdr_core_missing", "update_failed"]>;
         readonly message: Schema.String;
         readonly fix: Schema.String;
     }>>>;
@@ -804,6 +812,8 @@ export declare const RunnerHeartbeatInput: Schema.Struct<{
             readonly maxMemoryMb: Schema.optionalKey<Schema.Finite>;
             readonly maxRunSeconds: Schema.optionalKey<Schema.Finite>;
         }>>;
+        /** It benchmarks a verification's measure; a Runner without it is offered none, as one from before measures was. */
+        readonly measure: Schema.optionalKey<Schema.Boolean>;
     }>>;
     readonly labels: Schema.optionalKey<Schema.$Array<Schema.String>>;
 }>;
@@ -881,6 +891,8 @@ export declare const RunnerCapabilitiesUpdate: Schema.Struct<{
             readonly maxMemoryMb: Schema.optionalKey<Schema.Finite>;
             readonly maxRunSeconds: Schema.optionalKey<Schema.Finite>;
         }>>;
+        /** It benchmarks a verification's measure; a Runner without it is offered none, as one from before measures was. */
+        readonly measure: Schema.optionalKey<Schema.Boolean>;
     }>;
     readonly labels: Schema.optionalKey<Schema.$Array<Schema.String>>;
 }>;
@@ -1038,11 +1050,14 @@ export declare const RunnerStepAttempt: Schema.Struct<{
                 readonly contentMarkdown: Schema.String;
             }>>;
             readonly outputSchema: Schema.$Record<Schema.String, Schema.Codec<Schema.Json, Schema.Json, never, never>>;
-            readonly skills: Schema.optionalKey<Schema.$Array<Schema.Struct<{
+            readonly kits: Schema.optionalKey<Schema.$Array<Schema.Struct<{
                 readonly name: Schema.String;
-                readonly files: Schema.$Record<Schema.String, Schema.String>;
+                readonly version: Schema.String;
+                readonly setupDigest: Schema.String;
             }>>>;
             readonly toolless: Schema.optionalKey<Schema.Literal<true>>;
+            readonly tools: Schema.optionalKey<Schema.$Array<Schema.Literals<readonly ["web", "subagents", "artifacts", "browser"]>>>;
+            readonly listedSkills: Schema.optionalKey<Schema.$Array<Schema.String>>;
         }>>;
         readonly failureSummary: Schema.optionalKey<Schema.String>;
         readonly reviewEvidence: Schema.$Array<Schema.Struct<{
@@ -1052,6 +1067,13 @@ export declare const RunnerStepAttempt: Schema.Struct<{
             readonly provider: Schema.optionalKey<Schema.String>;
             readonly title: Schema.optionalKey<Schema.String>;
         }>>;
+        readonly skippedChoices: Schema.optionalKey<Schema.$Array<Schema.Struct<{
+            readonly harness: Schema.optionalKey<Schema.String>;
+            readonly model: Schema.optionalKey<Schema.String>;
+            readonly effort: Schema.optionalKey<Schema.Literals<readonly ["low", "medium", "high", "xhigh"]>>;
+            readonly reason: Schema.Literals<readonly ["not_on_runner", "out_of_quota", "failed_to_start"]>;
+            readonly until: Schema.optionalKey<Schema.String>;
+        }>>>;
         readonly lease: Schema.optionalKey<Schema.Struct<{
             readonly ownerId: Schema.String;
             readonly runnerReplicaId: Schema.optionalKey<Schema.String>;
@@ -1481,7 +1503,7 @@ export declare const RunnerOperationsOverview: Schema.Struct<{
         }>, Schema.Struct<{
             readonly kind: Schema.Literal<"needs_attention">;
             readonly problems: Schema.$Array<Schema.Struct<{
-                readonly code: Schema.Literals<readonly ["credential_missing", "credential_refused", "runner_removed", "sandbox_missing", "update_failed"]>;
+                readonly code: Schema.Literals<readonly ["credential_missing", "credential_refused", "clock_skew", "runner_removed", "sandbox_missing", "herdr_core_missing", "update_failed"]>;
                 readonly message: Schema.String;
                 readonly fix: Schema.String;
                 readonly startedAt: Schema.String;
@@ -1561,6 +1583,8 @@ export declare const RunnerOperationsOverview: Schema.Struct<{
                 readonly maxMemoryMb: Schema.optionalKey<Schema.Finite>;
                 readonly maxRunSeconds: Schema.optionalKey<Schema.Finite>;
             }>>;
+            /** It benchmarks a verification's measure; a Runner without it is offered none, as one from before measures was. */
+            readonly measure: Schema.optionalKey<Schema.Boolean>;
         }>;
         /** The owner's choice of default Harness; `capabilities.defaultHarness` is the one in effect. */
         readonly preferredHarness: Schema.optionalKey<Schema.Literals<readonly ["pi", "claude", "codex"]>>;
@@ -1709,7 +1733,7 @@ export declare const RunnerOperationsLiveSnapshot: Schema.Struct<{
             }>, Schema.Struct<{
                 readonly kind: Schema.Literal<"needs_attention">;
                 readonly problems: Schema.$Array<Schema.Struct<{
-                    readonly code: Schema.Literals<readonly ["credential_missing", "credential_refused", "runner_removed", "sandbox_missing", "update_failed"]>;
+                    readonly code: Schema.Literals<readonly ["credential_missing", "credential_refused", "clock_skew", "runner_removed", "sandbox_missing", "herdr_core_missing", "update_failed"]>;
                     readonly message: Schema.String;
                     readonly fix: Schema.String;
                     readonly startedAt: Schema.String;
@@ -1789,6 +1813,8 @@ export declare const RunnerOperationsLiveSnapshot: Schema.Struct<{
                     readonly maxMemoryMb: Schema.optionalKey<Schema.Finite>;
                     readonly maxRunSeconds: Schema.optionalKey<Schema.Finite>;
                 }>>;
+                /** It benchmarks a verification's measure; a Runner without it is offered none, as one from before measures was. */
+                readonly measure: Schema.optionalKey<Schema.Boolean>;
             }>;
             /** The owner's choice of default Harness; `capabilities.defaultHarness` is the one in effect. */
             readonly preferredHarness: Schema.optionalKey<Schema.Literals<readonly ["pi", "claude", "codex"]>>;
@@ -2091,7 +2117,7 @@ export declare const RunnerFlightDeck: Schema.Struct<{
         }>, Schema.Struct<{
             readonly kind: Schema.Literal<"needs_attention">;
             readonly problems: Schema.$Array<Schema.Struct<{
-                readonly code: Schema.Literals<readonly ["credential_missing", "credential_refused", "runner_removed", "sandbox_missing", "update_failed"]>;
+                readonly code: Schema.Literals<readonly ["credential_missing", "credential_refused", "clock_skew", "runner_removed", "sandbox_missing", "herdr_core_missing", "update_failed"]>;
                 readonly message: Schema.String;
                 readonly fix: Schema.String;
                 readonly startedAt: Schema.String;
@@ -2267,7 +2293,7 @@ export declare const RunnerFlightDeckLiveSnapshot: Schema.Struct<{
             }>, Schema.Struct<{
                 readonly kind: Schema.Literal<"needs_attention">;
                 readonly problems: Schema.$Array<Schema.Struct<{
-                    readonly code: Schema.Literals<readonly ["credential_missing", "credential_refused", "runner_removed", "sandbox_missing", "update_failed"]>;
+                    readonly code: Schema.Literals<readonly ["credential_missing", "credential_refused", "clock_skew", "runner_removed", "sandbox_missing", "herdr_core_missing", "update_failed"]>;
                     readonly message: Schema.String;
                     readonly fix: Schema.String;
                     readonly startedAt: Schema.String;
@@ -2508,7 +2534,7 @@ export declare const RunnerList: Schema.Struct<{
         }>, Schema.Struct<{
             readonly kind: Schema.Literal<"needs_attention">;
             readonly problems: Schema.$Array<Schema.Struct<{
-                readonly code: Schema.Literals<readonly ["credential_missing", "credential_refused", "runner_removed", "sandbox_missing", "update_failed"]>;
+                readonly code: Schema.Literals<readonly ["credential_missing", "credential_refused", "clock_skew", "runner_removed", "sandbox_missing", "herdr_core_missing", "update_failed"]>;
                 readonly message: Schema.String;
                 readonly fix: Schema.String;
                 readonly startedAt: Schema.String;
@@ -2588,6 +2614,8 @@ export declare const RunnerList: Schema.Struct<{
                 readonly maxMemoryMb: Schema.optionalKey<Schema.Finite>;
                 readonly maxRunSeconds: Schema.optionalKey<Schema.Finite>;
             }>>;
+            /** It benchmarks a verification's measure; a Runner without it is offered none, as one from before measures was. */
+            readonly measure: Schema.optionalKey<Schema.Boolean>;
         }>;
         /** The owner's choice of default Harness; `capabilities.defaultHarness` is the one in effect. */
         readonly preferredHarness: Schema.optionalKey<Schema.Literals<readonly ["pi", "claude", "codex"]>>;
@@ -2674,6 +2702,10 @@ export declare const RunnerEnvironmentMatchInput: Schema.Struct<{
                     readonly kind: Schema.Literal<"local_path">;
                     readonly path: Schema.String;
                 }>]>;
+                readonly appliesTo: Schema.optionalKey<Schema.Struct<{
+                    readonly dependencies: Schema.optionalKey<Schema.$Array<Schema.String>>;
+                    readonly files: Schema.optionalKey<Schema.$Array<Schema.String>>;
+                }>>;
             }>;
             readonly source: Schema.Union<readonly [Schema.Struct<{
                 readonly kind: Schema.Literal<"built_in">;
@@ -3949,7 +3981,6 @@ export declare function findForbiddenRunnerCapabilitiesPath<ValueType>(value: Va
 export declare function matchRunnerReplicaForWork(input: {
     readonly runner: Runner;
     readonly replica: RunnerReplica;
-    readonly activeWorkUnits?: number;
     readonly now: Date;
     readonly staleAfterSeconds?: number;
 }): {

package/types/packages/core/src/secret.d.ts

@@ -3,11 +3,25 @@ import * as Schema from 'effect/Schema';
 export declare const SecretName: Schema.String;
 export declare const SecretScope: Schema.Union<readonly [Schema.Literal<"workspace">, Schema.Literal<"team">]>;
 export type SecretScope = (typeof SecretScope)['Type'];
+/** Where a Secret's reference may be swapped for its value: `host`, `host:port`, or `*.domain` for its subdomains. */
+export declare const SecretHost: Schema.String;
+export declare const SecretHosts: Schema.$Array<Schema.String>;
+/**
+ * What a Step holds in place of a Secret's value. A proxy outside its sandbox swaps the value in where the Step sends
+ * the reference, and only to the Secret's hosts.
+ */
+export declare const secretReference: (owner: string, name: string) => string;
+/** `text` with each reference in it replaced by `swap`'s answer for it. */
+export declare const replaceSecretReferences: (text: string, swap: (reference: string) => string) => string;
+/** The references in `text`, each once. */
+export declare const secretReferencesIn: (text: string) => string[];
 /** A Secret as anyone may see it: never its value. */
 export declare const SecretSummary: Schema.Struct<{
     readonly name: Schema.String;
     readonly scope: Schema.Union<readonly [Schema.Literal<"workspace">, Schema.Literal<"team">]>;
     readonly teamId: Schema.optionalKey<Schema.String>;
+    /** Where a Step's reference to it may be swapped for its value; with none, no Step may take it. */
+    readonly hosts: Schema.$Array<Schema.String>;
     readonly setByActorType: Schema.Union<readonly [Schema.Literal<"human">, Schema.Literal<"delegated_agent">, Schema.Literal<"agent">]>;
     readonly setByActorId: Schema.String;
     readonly setAt: Schema.String;
@@ -18,17 +32,20 @@ export declare const SecretList: Schema.Struct<{
         readonly name: Schema.String;
         readonly scope: Schema.Union<readonly [Schema.Literal<"workspace">, Schema.Literal<"team">]>;
         readonly teamId: Schema.optionalKey<Schema.String>;
+        /** Where a Step's reference to it may be swapped for its value; with none, no Step may take it. */
+        readonly hosts: Schema.$Array<Schema.String>;
         readonly setByActorType: Schema.Union<readonly [Schema.Literal<"human">, Schema.Literal<"delegated_agent">, Schema.Literal<"agent">]>;
         readonly setByActorId: Schema.String;
         readonly setAt: Schema.String;
     }>>;
 }>;
 export type SecretList = (typeof SecretList)['Type'];
-export declare const secretSetRefused = "A Secret takes a value of 1 to 65536 characters and an optional teamId";
+export declare const secretSetRefused = "A Secret takes a value of 1 to 65536 characters, an optional teamId, and up to 32 hosts such as api.github.com, *.example.com or example.com:8443";
 /** Sets a Secret for the Workspace, or for one of its Teams; a refusal never quotes the value. */
 export declare const SecretSet: Schema.Struct<{
     readonly value: Schema.String;
     readonly teamId: Schema.optionalKey<Schema.String>;
+    readonly hosts: Schema.optionalKey<Schema.$Array<Schema.String>>;
 }>;
 export type SecretSet = (typeof SecretSet)['Type'];
 export declare const SecretScopeQuery: Schema.Struct<{

package/types/packages/core/src/step-brief.d.ts

@@ -13,7 +13,8 @@ export declare function validateAgentOutput(schema: JsonObject, output: JsonObje
     readonly ok: false;
     readonly message: string;
 };
-/** The first message an agent receives. */
+export declare const maxOutputTextLength: number;
+/** The Step brief: the Harness's system prompt where it takes one there, otherwise the first message. */
 export declare function renderStepBriefPrompt(input: {
     readonly instruction: string;
     readonly contextPackMarkdown?: string;
@@ -24,15 +25,18 @@ type ContextArtifact = {
     readonly kind: string;
     readonly text: string;
 };
+/** How much of one artifact's text a brief carries, about 1.5k tokens; the rest stays on the Run. */
+export declare const BriefArtifactCap = 6000;
 /**
- * A program agent Step's ContextPack: its Task's context, this Run's artifacts, related artifacts from earlier Runs,
- * and what earlier attempts of the Step recorded; then the Run's Intent and steering. Undefined when there is nothing to say.
+ * A program agent Step's ContextPack: its Task's context, the newest artifact of each kind in this Run and in the
+ * Task's earlier Runs, each capped, and what earlier attempts of the Step recorded; then the Run's Intent and
+ * steering. Undefined when there is nothing to say.
  */
 export declare function programStepContext(input: {
     readonly taskContext?: string;
-    /** The Team's Kits, for a Run with no Task whose ContextPack would carry them. */
-    readonly kits?: string;
+    /** Oldest first. */
     readonly runArtifacts: readonly ContextArtifact[];
+    /** Newest first. */
     readonly earlierArtifacts: readonly ContextArtifact[];
     readonly handoff: readonly {
         readonly attempt: number;
@@ -43,8 +47,18 @@ export declare function programStepContext(input: {
     readonly intent?: string;
     readonly steering?: readonly string[];
 }): string | undefined;
-/** The program's prompt, and how the agent leaves a trail a retry on another Runner can follow. */
-export declare const programStepInstruction: (prompt: string) => string;
+/**
+ * The skill the Step runs, then the program's prompt, then the Kitman tools every Step has: its trail for a retry,
+ * asking, files and skills.
+ */
+export declare const programStepInstruction: (prompt: string, options?: {
+    readonly missingSkills?: readonly string[];
+    /** The skill the Step runs, with its SKILL.md, which is undefined when no Kit of the Run provides it. */
+    readonly runSkill?: {
+        readonly name: string;
+        readonly skill: string | undefined;
+    };
+}) => string;
 type StepCredentialLease = {
     readonly stepAttemptId: string;
     readonly leaseId: string;

package/types/packages/core/src/sync-kit.d.ts

@@ -78,6 +78,10 @@ export declare const SyncKitActiveKit: Schema.Struct<{
                 readonly kind: Schema.Literal<"local_path">;
                 readonly path: Schema.String;
             }>]>;
+            readonly appliesTo: Schema.optionalKey<Schema.Struct<{
+                readonly dependencies: Schema.optionalKey<Schema.$Array<Schema.String>>;
+                readonly files: Schema.optionalKey<Schema.$Array<Schema.String>>;
+            }>>;
         }>>>;
         readonly mcpServers: Schema.optionalKey<Schema.$Array<Schema.Struct<{
             readonly name: Schema.String;
@@ -148,6 +152,10 @@ export declare const SyncKitActiveKit: Schema.Struct<{
                     readonly kind: Schema.Literal<"local_path">;
                     readonly path: Schema.String;
                 }>]>;
+                readonly appliesTo: Schema.optionalKey<Schema.Struct<{
+                    readonly dependencies: Schema.optionalKey<Schema.$Array<Schema.String>>;
+                    readonly files: Schema.optionalKey<Schema.$Array<Schema.String>>;
+                }>>;
             }>>>;
             readonly plugins: Schema.optionalKey<Schema.$Array<Schema.Struct<{
                 readonly name: Schema.String;

package/types/packages/core/src/task-detail.d.ts

@@ -90,6 +90,9 @@ export declare const TaskDetailAggregate: Schema.Struct<{
         }>, Schema.Struct<{
             readonly kind: Schema.Literal<"event">;
             readonly eventId: Schema.String;
+        }>, Schema.Struct<{
+            readonly kind: Schema.Literal<"alert">;
+            readonly fingerprint: Schema.String;
         }>, Schema.Struct<{
             readonly kind: Schema.Literal<"migrated">;
             readonly previousKeys: Schema.$Array<Schema.String>;
@@ -320,11 +323,14 @@ export declare const TaskDetailAggregate: Schema.Struct<{
                 readonly contentMarkdown: Schema.String;
             }>>;
             readonly outputSchema: Schema.$Record<Schema.String, Schema.Codec<Schema.Json, Schema.Json, never, never>>;
-            readonly skills: Schema.optionalKey<Schema.$Array<Schema.Struct<{
+            readonly kits: Schema.optionalKey<Schema.$Array<Schema.Struct<{
                 readonly name: Schema.String;
-                readonly files: Schema.$Record<Schema.String, Schema.String>;
+                readonly version: Schema.String;
+                readonly setupDigest: Schema.String;
             }>>>;
             readonly toolless: Schema.optionalKey<Schema.Literal<true>>;
+            readonly tools: Schema.optionalKey<Schema.$Array<Schema.Literals<readonly ["web", "subagents", "artifacts", "browser"]>>>;
+            readonly listedSkills: Schema.optionalKey<Schema.$Array<Schema.String>>;
         }>>;
         readonly failureSummary: Schema.optionalKey<Schema.String>;
         readonly reviewEvidence: Schema.$Array<Schema.Struct<{
@@ -334,6 +340,13 @@ export declare const TaskDetailAggregate: Schema.Struct<{
             readonly provider: Schema.optionalKey<Schema.String>;
             readonly title: Schema.optionalKey<Schema.String>;
         }>>;
+        readonly skippedChoices: Schema.optionalKey<Schema.$Array<Schema.Struct<{
+            readonly harness: Schema.optionalKey<Schema.String>;
+            readonly model: Schema.optionalKey<Schema.String>;
+            readonly effort: Schema.optionalKey<Schema.Literals<readonly ["low", "medium", "high", "xhigh"]>>;
+            readonly reason: Schema.Literals<readonly ["not_on_runner", "out_of_quota", "failed_to_start"]>;
+            readonly until: Schema.optionalKey<Schema.String>;
+        }>>>;
         readonly lease: Schema.optionalKey<Schema.Struct<{
             readonly ownerId: Schema.String;
             readonly runnerReplicaId: Schema.optionalKey<Schema.String>;

package/types/packages/core/src/task.d.ts

@@ -13,6 +13,9 @@ export declare const TaskOrigin: Schema.Union<readonly [Schema.Struct<{
 }>, Schema.Struct<{
     readonly kind: Schema.Literal<"event">;
     readonly eventId: Schema.String;
+}>, Schema.Struct<{
+    readonly kind: Schema.Literal<"alert">;
+    readonly fingerprint: Schema.String;
 }>, Schema.Struct<{
     readonly kind: Schema.Literal<"migrated">;
     readonly previousKeys: Schema.$Array<Schema.String>;
@@ -58,6 +61,9 @@ export declare const Task: Schema.Struct<{
     }>, Schema.Struct<{
         readonly kind: Schema.Literal<"event">;
         readonly eventId: Schema.String;
+    }>, Schema.Struct<{
+        readonly kind: Schema.Literal<"alert">;
+        readonly fingerprint: Schema.String;
     }>, Schema.Struct<{
         readonly kind: Schema.Literal<"migrated">;
         readonly previousKeys: Schema.$Array<Schema.String>;
@@ -107,6 +113,9 @@ export declare const TaskList: Schema.Struct<{
         }>, Schema.Struct<{
             readonly kind: Schema.Literal<"event">;
             readonly eventId: Schema.String;
+        }>, Schema.Struct<{
+            readonly kind: Schema.Literal<"alert">;
+            readonly fingerprint: Schema.String;
         }>, Schema.Struct<{
             readonly kind: Schema.Literal<"migrated">;
             readonly previousKeys: Schema.$Array<Schema.String>;

package/types/packages/core/src/transcript.d.ts

@@ -31,9 +31,14 @@ export declare const AgentEvent: Schema.Union<readonly [Schema.Struct<{
     readonly kind: Schema.Literal<"steer">;
     readonly messageId: Schema.String;
     readonly text: Schema.String;
+}>, Schema.Struct<{
+    readonly kind: Schema.Literal<"secret_refused">;
+    readonly reference: Schema.optionalKey<Schema.String>;
+    readonly host: Schema.String;
+    readonly reason: Schema.String;
 }>, Schema.Struct<{
     readonly kind: Schema.Literal<"lifecycle">;
-    readonly state: Schema.Literals<readonly ["started", "resumed", "finished", "failed", "canceled"]>;
+    readonly state: Schema.Literals<readonly ["started", "resumed", "parked", "finished", "failed", "canceled"]>;
 }>]>;
 export type AgentEvent = (typeof AgentEvent)['Type'];
 /** What replaces the words of an erased person's steers and answers. */
@@ -71,9 +76,14 @@ export declare const TranscriptAppendEntry: Schema.Struct<{
         readonly kind: Schema.Literal<"steer">;
         readonly messageId: Schema.String;
         readonly text: Schema.String;
+    }>, Schema.Struct<{
+        readonly kind: Schema.Literal<"secret_refused">;
+        readonly reference: Schema.optionalKey<Schema.String>;
+        readonly host: Schema.String;
+        readonly reason: Schema.String;
     }>, Schema.Struct<{
         readonly kind: Schema.Literal<"lifecycle">;
-        readonly state: Schema.Literals<readonly ["started", "resumed", "finished", "failed", "canceled"]>;
+        readonly state: Schema.Literals<readonly ["started", "resumed", "parked", "finished", "failed", "canceled"]>;
     }>]>;
 }>;
 export type TranscriptAppendEntry = (typeof TranscriptAppendEntry)['Type'];
@@ -110,9 +120,14 @@ export declare const TranscriptEntry: Schema.Struct<{
         readonly kind: Schema.Literal<"steer">;
         readonly messageId: Schema.String;
         readonly text: Schema.String;
+    }>, Schema.Struct<{
+        readonly kind: Schema.Literal<"secret_refused">;
+        readonly reference: Schema.optionalKey<Schema.String>;
+        readonly host: Schema.String;
+        readonly reason: Schema.String;
     }>, Schema.Struct<{
         readonly kind: Schema.Literal<"lifecycle">;
-        readonly state: Schema.Literals<readonly ["started", "resumed", "finished", "failed", "canceled"]>;
+        readonly state: Schema.Literals<readonly ["started", "resumed", "parked", "finished", "failed", "canceled"]>;
     }>]>;
     readonly createdAt: Schema.String;
 }>;
@@ -157,9 +172,14 @@ export declare const TranscriptPage: Schema.Struct<{
             readonly kind: Schema.Literal<"steer">;
             readonly messageId: Schema.String;
             readonly text: Schema.String;
+        }>, Schema.Struct<{
+            readonly kind: Schema.Literal<"secret_refused">;
+            readonly reference: Schema.optionalKey<Schema.String>;
+            readonly host: Schema.String;
+            readonly reason: Schema.String;
         }>, Schema.Struct<{
             readonly kind: Schema.Literal<"lifecycle">;
-            readonly state: Schema.Literals<readonly ["started", "resumed", "finished", "failed", "canceled"]>;
+            readonly state: Schema.Literals<readonly ["started", "resumed", "parked", "finished", "failed", "canceled"]>;
         }>]>;
         readonly createdAt: Schema.String;
     }>>;

package/types/packages/core/src/trust-panel.d.ts

@@ -1,4 +1,4 @@
-import type { ChangeRequest } from './change-request';
+import { type ChangeRequest } from './change-request';
 import type { RunShow } from './loop';
 export type TrustStatus = 'failed' | 'partial' | 'unproved' | 'verified' | 'claims';
 /** One kind of evidence a person reads before merging, with where it came from. */

package/types/packages/core/src/waiting-on.d.ts

@@ -0,0 +1,14 @@
+import * as Schema from 'effect/Schema';
+/** The open blockers a Task waits on; `hidden` counts those in Teams the reader cannot see. */
+export declare const WaitingOn: Schema.Struct<{
+    readonly keys: Schema.$Array<Schema.String>;
+    readonly hidden: Schema.Int;
+}>;
+export type WaitingOn = typeof WaitingOn.Type;
+/** What a reader may see of a Task's open blockers. */
+export declare const waitingOnFrom: (blockers: readonly {
+    readonly key: string;
+    readonly readable: boolean;
+}[]) => WaitingOn;
+/** The blockers in words: `KIT-158, KIT-159 and 1 Task you cannot see`. */
+export declare const waitingOnWords: ({ keys, hidden }: WaitingOn) => string;