@kitman-sh/sdk 0.7.3 → 0.7.5

package/dist/build/index.js

@@ -4,12 +4,12 @@ import {
   KitInstallationDeclaration,
   KitAssignmentDeclaration,
   PackageDeclarations
-} from "../chunk-zp7s46pz.js";
+} from "../chunk-8byx9rx2.js";
 import {
   RunnerRpcProtocolVersion,
   describeFlag2,
   Described2
-} from "../chunk-7hwhxthh.js";
+} from "../chunk-72z6zbfz.js";
 
 // packages/core/src/crypto.ts
 import { createHash, createHmac, createSign, randomBytes, timingSafeEqual } from "crypto";

package/dist/{chunk-7hwhxthh.js → chunk-72z6zbfz.js}

@@ -19,7 +19,7 @@ import {
   executeLoop2,
   LoopCheckError2,
   checkLoop2
-} from "./chunk-zp7s46pz.js";
+} from "./chunk-8byx9rx2.js";
 // packages/core/src/repo-binding.ts
 import * as Schema from "effect/Schema";
 var RepoBindingPathPrefixPattern = "^(?!/)(?!.*\\\\)(?!.*(?:^|/)\\.\\.?(?:/|$))(?!.*//)\\S+$";

package/dist/{chunk-zp7s46pz.js → chunk-8byx9rx2.js}

@@ -164,7 +164,7 @@ var SkillSource = Schema5.Union([
   Schema5.Struct({
     kind: Schema5.Literal("git"),
     url: Schema5.String.check(Schema5.isMinLength(1)),
-    ref: Schema5.String.check(Schema5.isMinLength(1)),
+    ref: Schema5.optionalKey(Schema5.String.check(Schema5.isMinLength(1))),
     path: Schema5.optionalKey(SourcePath),
     sha256: Schema5.optionalKey(Sha256)
   }),
@@ -254,7 +254,7 @@ var AgentSkillRequirement = Schema5.Struct({
 var AgentPluginRequirement = Schema5.Struct({
   name: Schema5.String.check(Schema5.isMinLength(1)),
   policy: AgentEnvironmentPolicy,
-  source: PluginSource
+  sources: Schema5.NonEmptyArray(PluginSource)
 });
 var AgentMcpServerRequirement = Schema5.Struct({
   name: Schema5.String.check(Schema5.isMinLength(1)),
@@ -1085,11 +1085,6 @@ var WorkspacePolicyKitBackfillCancelResult = Schema6.Struct({
 var LoopLayers = ["project", "workspace", "shipped"];
 var AgentEfforts = ["low", "medium", "high", "xhigh"];
 
-// packages/core/src/schedule.ts
-import * as Schema13 from "effect/Schema";
-import * as DateTime from "effect/DateTime";
-import * as Option from "effect/Option";
-
 // packages/core/src/loop.ts
 import * as Effect from "effect/Effect";
 import * as Schema12 from "effect/Schema";
@@ -2786,6 +2781,16 @@ var StepSessionUpdate = Schema12.Struct({
   kind: Schema12.String.check(Schema12.isMinLength(1), Schema12.isMaxLength(80)),
   content: Schema12.String.check(Schema12.isMinLength(1), Schema12.isMaxLength(4000))
 });
+var StepAttemptSessionUpdate = Schema12.Struct({
+  id: Id,
+  kind: Schema12.String,
+  content: Schema12.String,
+  createdAt: Timestamp
+});
+var StepAttemptSessionUpdateList = Schema12.Struct({
+  items: Schema12.Array(StepAttemptSessionUpdate),
+  next: Schema12.optionalKey(Schema12.String)
+});
 var StepOutputSubmissionResult = Schema12.Union([
   Schema12.Struct({ status: Schema12.Literal("accepted") }),
   Schema12.Struct({
@@ -2898,7 +2903,9 @@ var RunStepSummary = Schema12.Struct({
     id: Id,
     attempt: Schema12.Int.check(Schema12.isGreaterThanOrEqualTo(1)),
     status: StepAttemptStatus,
-    failureSummary: Schema12.optionalKey(Schema12.String)
+    failureSummary: Schema12.optionalKey(Schema12.String),
+    output: Schema12.optionalKey(Schema12.Unknown),
+    revision: Schema12.optionalKey(Schema12.String)
   }))
 });
 var RunSteerDeliveries = ["queued", "delivered", "failed"];
@@ -2911,14 +2918,73 @@ var RunSteer = Schema12.Struct({
 });
 var RunSteerInput = Schema12.Struct({
   text: LoopSafeText,
+  stepAttemptId: Schema12.optionalKey(Id),
   idempotencyKey: Schema12.String.check(Schema12.isMinLength(1), Schema12.isMaxLength(240))
 });
 var RunSteerSent = Schema12.Struct({
   steer: RunSteer,
   target: Schema12.Literals(["session", "next_step"])
 });
+var RunDisplayStates = [
+  "queued",
+  "running",
+  "needs_you",
+  "blocked",
+  "failed",
+  "stopped",
+  "succeeded",
+  "partial"
+];
+var RunDisplay = Schema12.Struct({
+  state: Schema12.Literals(RunDisplayStates),
+  retried: Schema12.Boolean,
+  summary: Schema12.optionalKey(Schema12.String)
+});
+var RunGraphNodeKinds = ["agent", "check", "question", "child", "wait", "activity"];
+var RunGraphNode = Schema12.Struct({
+  id: Id,
+  name: Schema12.String,
+  kind: Schema12.Literals(RunGraphNodeKinds),
+  status: Schema12.Literals(RunDisplayStates),
+  startedAt: Timestamp,
+  endedAt: Schema12.optionalKey(Timestamp),
+  attempts: Schema12.Array(Schema12.Struct({
+    id: Id,
+    attempt: Schema12.Int.check(Schema12.isGreaterThanOrEqualTo(1)),
+    status: Schema12.Literals(RunDisplayStates),
+    failureSummary: Schema12.optionalKey(Schema12.String)
+  })),
+  agent: Schema12.optionalKey(Schema12.Struct({
+    id: Id,
+    harness: Schema12.optionalKey(Schema12.String),
+    model: Schema12.optionalKey(Schema12.String),
+    runner: Schema12.optionalKey(Schema12.Struct({ id: Id, name: Schema12.String }))
+  })),
+  child: Schema12.optionalKey(Schema12.Struct({
+    runId: Id,
+    loopTitle: Schema12.String,
+    display: RunDisplay,
+    task: Schema12.optionalKey(Schema12.Struct({ id: Id, key: Schema12.String, title: Schema12.String }))
+  }))
+});
+var RunGraph = Schema12.Struct({
+  columns: Schema12.Array(Schema12.Array(RunGraphNode)),
+  needs: Schema12.Array(Schema12.Struct({ from: Id, to: Id }))
+});
+var RunHeader = Schema12.Struct({
+  loopTitle: Schema12.String,
+  branch: Schema12.optionalKey(Schema12.String),
+  changeRequest: Schema12.optionalKey(Schema12.Struct({ id: Id, title: Schema12.String, url: Schema12.String })),
+  startedBy: Schema12.optionalKey(Schema12.Union([
+    Schema12.Struct({ kind: Schema12.Literal("person"), name: Schema12.String }),
+    Schema12.Struct({ kind: Schema12.Literal("event"), event: Schema12.String })
+  ]))
+});
 var RunShow = Schema12.Struct({
   run: Run,
+  header: RunHeader,
+  display: RunDisplay,
+  graph: RunGraph,
   steps: Schema12.Array(RunStepSummary),
   questions: Schema12.Array(Question),
   children: Schema12.Array(Schema12.Struct({ runId: Id, name: Schema12.String, status: RunStatus, createdAt: Timestamp })),
@@ -2929,6 +2995,7 @@ var RunShow = Schema12.Struct({
     recordedAt: Timestamp
   })),
   artifacts: Schema12.Array(RunArtifact),
+  findings: Schema12.Array(RunArtifact),
   events: Schema12.Array(Schema12.Struct({ id: Id, type: Schema12.String, occurredAt: Timestamp })),
   evidence: Schema12.Array(RunEvidence),
   steers: Schema12.Array(RunSteer),
@@ -2959,7 +3026,6 @@ var ProgramLoop = Schema12.Struct({
   publishedAt: Timestamp,
   package: Schema12.String
 });
-var LoopDetail = Schema12.Struct({ id: Schema12.String, resolved: Schema12.optionalKey(ProgramLoop) });
 var AutomaticStart = Schema12.Struct({
   eventId: Schema12.String,
   eventType: Schema12.String,
@@ -2994,7 +3060,17 @@ var ProgramAgent = Schema12.Struct({
 });
 var ProgramAgentList = Schema12.Struct({ items: Schema12.Array(ProgramAgent) });
 var ProgramLoopList = Schema12.Struct({ items: Schema12.Array(ProgramLoop) });
-var RunList = Schema12.Struct({ items: Schema12.Array(Run) });
+var RunListItem = Schema12.Struct({
+  run: Run,
+  loop: Schema12.Struct({ id: Schema12.String, title: Schema12.String }),
+  task: Schema12.optionalKey(Schema12.Struct({ id: Id, key: Schema12.String, title: Schema12.String })),
+  display: RunDisplay,
+  miniGraph: Schema12.Array(Schema12.Literals(RunDisplayStates))
+});
+var RunList = Schema12.Struct({
+  items: Schema12.Array(RunListItem),
+  next: Schema12.optionalKey(Schema12.String)
+});
 var RunWaitReasons = ["question", "completed", "failed", "stopped", "timeout"];
 var RunWaitResult = Schema12.Struct({
   reason: Schema12.Literals(RunWaitReasons),
@@ -3017,6 +3093,9 @@ var RunActionList = Schema12.Struct({ items: Schema12.Array(RunActionSummary) })
 var RunActionTaken = Schema12.Struct({ action: Schema12.String, run: Run });
 
 // packages/core/src/schedule.ts
+import * as Schema13 from "effect/Schema";
+import * as DateTime from "effect/DateTime";
+import * as Option from "effect/Option";
 var ScheduleFrequency = ["daily", "weekly"];
 var ScheduleMisfirePolicies = ["skip", "fire_once", "catch_up"];
 var ScheduleOverlapPolicies = ["allow", "skip", "coalesce"];
@@ -3134,6 +3213,10 @@ var LoopManifest = Schema14.Struct({
   secrets: Schema14.optionalKey(Schema14.Array(SecretName)),
   network: Schema14.optionalKey(AgentSandboxNetwork)
 });
+var LoopDetail = Schema14.Struct({
+  id: Schema14.String,
+  resolved: Schema14.optionalKey(Schema14.Struct({ ...ProgramLoop.fields, agents: LoopManifest.fields.agents, when: LoopManifest.fields.when }))
+});
 var AgentDeclaration = Schema14.Struct({
   extends: Schema14.optionalKey(Schema14.String),
   instructions: Schema14.optionalKey(Schema14.String),

package/dist/loop/index.js

@@ -94,7 +94,7 @@ import {
   LoopCheckError2,
   checkLoop2,
   defineConfig2
-} from "../chunk-zp7s46pz.js";
+} from "../chunk-8byx9rx2.js";
 export {
   ArtifactActivity2 as ArtifactActivity,
   ArtifactRequest2 as ArtifactRequest,

package/dist/program/index.js

@@ -1,5 +1,5 @@
 // @bun
-import"../chunk-zp7s46pz.js";
+import"../chunk-8byx9rx2.js";
 import {
   JournalWriteFailed2,
   refusedStep2,
@@ -13,7 +13,7 @@ import {
   undeclaredHostsEnv2,
   networkGuard2,
   runPackage2
-} from "../chunk-7hwhxthh.js";
+} from "../chunk-72z6zbfz.js";
 export {
   Described2 as Described,
   JournalWriteFailed2 as JournalWriteFailed,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kitman-sh/sdk",
-  "version": "0.7.3",
+  "version": "0.7.5",
   "type": "module",
   "license": "UNLICENSED",
   "exports": {

package/types/packages/core/src/agent-environment.d.ts

@@ -19,7 +19,7 @@ export declare const SkillSource: Schema.Union<readonly [Schema.Struct<{
 }>, Schema.Struct<{
     readonly kind: Schema.Literal<"git">;
     readonly url: Schema.String;
-    readonly ref: Schema.String;
+    readonly ref: Schema.optionalKey<Schema.String>;
     readonly path: Schema.optionalKey<Schema.String>;
     readonly sha256: Schema.optionalKey<Schema.String>;
 }>, Schema.Struct<{
@@ -89,7 +89,7 @@ export declare const AgentSkillRequirement: Schema.Struct<{
     }>, Schema.Struct<{
         readonly kind: Schema.Literal<"git">;
         readonly url: Schema.String;
-        readonly ref: Schema.String;
+        readonly ref: Schema.optionalKey<Schema.String>;
         readonly path: Schema.optionalKey<Schema.String>;
         readonly sha256: Schema.optionalKey<Schema.String>;
     }>, Schema.Struct<{
@@ -110,7 +110,7 @@ export declare const AgentSkillRequirement: Schema.Struct<{
 export declare const AgentPluginRequirement: Schema.Struct<{
     readonly name: Schema.String;
     readonly policy: Schema.Union<readonly [Schema.Literal<"recommended">, Schema.Literal<"required">]>;
-    readonly source: Schema.Union<readonly [Schema.Struct<{
+    readonly sources: Schema.NonEmptyArray<Schema.Union<readonly [Schema.Struct<{
         readonly kind: Schema.Literal<"package">;
         readonly packageName: Schema.String;
         readonly version: Schema.optionalKey<Schema.String>;
@@ -125,7 +125,7 @@ export declare const AgentPluginRequirement: Schema.Struct<{
     }>, Schema.Struct<{
         readonly kind: Schema.Literal<"local_path">;
         readonly path: Schema.String;
-    }>]>;
+    }>]>>;
 }>;
 export declare const AgentMcpServerRequirement: Schema.Struct<{
     readonly name: Schema.String;
@@ -188,7 +188,7 @@ export declare const AgentEnvironmentFragment: Schema.Struct<{
         }>, Schema.Struct<{
             readonly kind: Schema.Literal<"git">;
             readonly url: Schema.String;
-            readonly ref: Schema.String;
+            readonly ref: Schema.optionalKey<Schema.String>;
             readonly path: Schema.optionalKey<Schema.String>;
             readonly sha256: Schema.optionalKey<Schema.String>;
         }>, Schema.Struct<{
@@ -209,7 +209,7 @@ export declare const AgentEnvironmentFragment: Schema.Struct<{
     readonly plugins: Schema.optionalKey<Schema.$Array<Schema.Struct<{
         readonly name: Schema.String;
         readonly policy: Schema.Union<readonly [Schema.Literal<"recommended">, Schema.Literal<"required">]>;
-        readonly source: Schema.Union<readonly [Schema.Struct<{
+        readonly sources: Schema.NonEmptyArray<Schema.Union<readonly [Schema.Struct<{
             readonly kind: Schema.Literal<"package">;
             readonly packageName: Schema.String;
             readonly version: Schema.optionalKey<Schema.String>;
@@ -224,7 +224,7 @@ export declare const AgentEnvironmentFragment: Schema.Struct<{
         }>, Schema.Struct<{
             readonly kind: Schema.Literal<"local_path">;
             readonly path: Schema.String;
-        }>]>;
+        }>]>>;
     }>>>;
     readonly mcpServers: Schema.optionalKey<Schema.$Array<Schema.Struct<{
         readonly name: Schema.String;
@@ -373,7 +373,7 @@ export declare const UserAgentPreferences: Schema.Struct<{
             }>, Schema.Struct<{
                 readonly kind: Schema.Literal<"git">;
                 readonly url: Schema.String;
-                readonly ref: Schema.String;
+                readonly ref: Schema.optionalKey<Schema.String>;
                 readonly path: Schema.optionalKey<Schema.String>;
                 readonly sha256: Schema.optionalKey<Schema.String>;
             }>, Schema.Struct<{
@@ -394,7 +394,7 @@ export declare const UserAgentPreferences: Schema.Struct<{
         readonly plugins: Schema.optionalKey<Schema.$Array<Schema.Struct<{
             readonly name: Schema.String;
             readonly policy: Schema.Union<readonly [Schema.Literal<"recommended">, Schema.Literal<"required">]>;
-            readonly source: Schema.Union<readonly [Schema.Struct<{
+            readonly sources: Schema.NonEmptyArray<Schema.Union<readonly [Schema.Struct<{
                 readonly kind: Schema.Literal<"package">;
                 readonly packageName: Schema.String;
                 readonly version: Schema.optionalKey<Schema.String>;
@@ -409,7 +409,7 @@ export declare const UserAgentPreferences: Schema.Struct<{
             }>, Schema.Struct<{
                 readonly kind: Schema.Literal<"local_path">;
                 readonly path: Schema.String;
-            }>]>;
+            }>]>>;
         }>>>;
         readonly mcpServers: Schema.optionalKey<Schema.$Array<Schema.Struct<{
             readonly name: Schema.String;
@@ -625,7 +625,7 @@ export declare const AgentEnvironment: Schema.Struct<{
             }>, Schema.Struct<{
                 readonly kind: Schema.Literal<"git">;
                 readonly url: Schema.String;
-                readonly ref: Schema.String;
+                readonly ref: Schema.optionalKey<Schema.String>;
                 readonly path: Schema.optionalKey<Schema.String>;
                 readonly sha256: Schema.optionalKey<Schema.String>;
             }>, Schema.Struct<{
@@ -718,7 +718,7 @@ export declare const AgentEnvironment: Schema.Struct<{
         readonly item: Schema.Struct<{
             readonly name: Schema.String;
             readonly policy: Schema.Union<readonly [Schema.Literal<"recommended">, Schema.Literal<"required">]>;
-            readonly source: Schema.Union<readonly [Schema.Struct<{
+            readonly sources: Schema.NonEmptyArray<Schema.Union<readonly [Schema.Struct<{
                 readonly kind: Schema.Literal<"package">;
                 readonly packageName: Schema.String;
                 readonly version: Schema.optionalKey<Schema.String>;
@@ -733,7 +733,7 @@ export declare const AgentEnvironment: Schema.Struct<{
             }>, Schema.Struct<{
                 readonly kind: Schema.Literal<"local_path">;
                 readonly path: Schema.String;
-            }>]>;
+            }>]>>;
         }>;
         readonly source: Schema.Union<readonly [Schema.Struct<{
             readonly kind: Schema.Literal<"built_in">;
@@ -1486,7 +1486,7 @@ export declare const AgentEnvironmentSyncPlan: Schema.Struct<{
                 }>, Schema.Struct<{
                     readonly kind: Schema.Literal<"git">;
                     readonly url: Schema.String;
-                    readonly ref: Schema.String;
+                    readonly ref: Schema.optionalKey<Schema.String>;
                     readonly path: Schema.optionalKey<Schema.String>;
                     readonly sha256: Schema.optionalKey<Schema.String>;
                 }>, Schema.Struct<{
@@ -1579,7 +1579,7 @@ export declare const AgentEnvironmentSyncPlan: Schema.Struct<{
             readonly item: Schema.Struct<{
                 readonly name: Schema.String;
                 readonly policy: Schema.Union<readonly [Schema.Literal<"recommended">, Schema.Literal<"required">]>;
-                readonly source: Schema.Union<readonly [Schema.Struct<{
+                readonly sources: Schema.NonEmptyArray<Schema.Union<readonly [Schema.Struct<{
                     readonly kind: Schema.Literal<"package">;
                     readonly packageName: Schema.String;
                     readonly version: Schema.optionalKey<Schema.String>;
@@ -1594,7 +1594,7 @@ export declare const AgentEnvironmentSyncPlan: Schema.Struct<{
                 }>, Schema.Struct<{
                     readonly kind: Schema.Literal<"local_path">;
                     readonly path: Schema.String;
-                }>]>;
+                }>]>>;
             }>;
             readonly source: Schema.Union<readonly [Schema.Struct<{
                 readonly kind: Schema.Literal<"built_in">;

package/types/packages/core/src/engineering-resources.d.ts

@@ -12,15 +12,13 @@ declare const marketplace: {
         readonly preservesExistingInstallations: true;
     };
 };
-type EngineeringKit = Omit<KitCreate, 'metadata' | 'kind'> & {
+type ShippedKit = Omit<KitCreate, 'metadata' | 'kind' | 'slug'> & {
+    readonly slug: string;
     readonly kind: 'process' | 'technology';
     readonly metadata: {
         readonly marketplace: typeof marketplace;
     };
 };
-export declare const MattPocockProcessKit: EngineeringKit;
-export declare const AddyOsmaniProcessKit: EngineeringKit;
-export declare const PonytailProcessKit: EngineeringKit;
-export declare const EngineeringTechnologyKitCatalog: readonly EngineeringKit[];
-export declare const EngineeringProcessKitCatalog: readonly EngineeringKit[];
+/** The Kits every Workspace gets by default: the owner's Claude Code setup, for every Harness, at the latest versions. */
+export declare const ShippedKitCatalog: readonly ShippedKit[];
 export {};

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

@@ -11,7 +11,6 @@ export * from './sync-kit';
 export * from './agent-sandbox-policy';
 export * from './agent-launch-snapshot';
 export * from './kit';
-export * from './kit-taxonomy';
 export * from './memory';
 export * from './proposal';
 export * from './decision';
@@ -67,6 +66,8 @@ export * from './observability';
 export * from './following';
 export * from './approval-queue';
 export * from './data-lifecycle';
+export * from './run-display';
+export * from './run-graph';
 export * from './run-journal';
 export * from './loop-layers';
 export * from './package-declarations';

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

@@ -38,7 +38,7 @@ export declare const Kit: Schema.Struct<{
             }>, Schema.Struct<{
                 readonly kind: Schema.Literal<"git">;
                 readonly url: Schema.String;
-                readonly ref: Schema.String;
+                readonly ref: Schema.optionalKey<Schema.String>;
                 readonly path: Schema.optionalKey<Schema.String>;
                 readonly sha256: Schema.optionalKey<Schema.String>;
             }>, Schema.Struct<{
@@ -59,7 +59,7 @@ export declare const Kit: Schema.Struct<{
         readonly plugins: Schema.optionalKey<Schema.$Array<Schema.Struct<{
             readonly name: Schema.String;
             readonly policy: Schema.Union<readonly [Schema.Literal<"recommended">, Schema.Literal<"required">]>;
-            readonly source: Schema.Union<readonly [Schema.Struct<{
+            readonly sources: Schema.NonEmptyArray<Schema.Union<readonly [Schema.Struct<{
                 readonly kind: Schema.Literal<"package">;
                 readonly packageName: Schema.String;
                 readonly version: Schema.optionalKey<Schema.String>;
@@ -74,7 +74,7 @@ export declare const Kit: Schema.Struct<{
             }>, Schema.Struct<{
                 readonly kind: Schema.Literal<"local_path">;
                 readonly path: Schema.String;
-            }>]>;
+            }>]>>;
         }>>>;
         readonly mcpServers: Schema.optionalKey<Schema.$Array<Schema.Struct<{
             readonly name: Schema.String;
@@ -844,7 +844,7 @@ export declare const KitCreate: Schema.Struct<{
             }>, Schema.Struct<{
                 readonly kind: Schema.Literal<"git">;
                 readonly url: Schema.String;
-                readonly ref: Schema.String;
+                readonly ref: Schema.optionalKey<Schema.String>;
                 readonly path: Schema.optionalKey<Schema.String>;
                 readonly sha256: Schema.optionalKey<Schema.String>;
             }>, Schema.Struct<{
@@ -865,7 +865,7 @@ export declare const KitCreate: Schema.Struct<{
         readonly plugins: Schema.optionalKey<Schema.$Array<Schema.Struct<{
             readonly name: Schema.String;
             readonly policy: Schema.Union<readonly [Schema.Literal<"recommended">, Schema.Literal<"required">]>;
-            readonly source: Schema.Union<readonly [Schema.Struct<{
+            readonly sources: Schema.NonEmptyArray<Schema.Union<readonly [Schema.Struct<{
                 readonly kind: Schema.Literal<"package">;
                 readonly packageName: Schema.String;
                 readonly version: Schema.optionalKey<Schema.String>;
@@ -880,7 +880,7 @@ export declare const KitCreate: Schema.Struct<{
             }>, Schema.Struct<{
                 readonly kind: Schema.Literal<"local_path">;
                 readonly path: Schema.String;
-            }>]>;
+            }>]>>;
         }>>>;
         readonly mcpServers: Schema.optionalKey<Schema.$Array<Schema.Struct<{
             readonly name: Schema.String;
@@ -989,7 +989,7 @@ export declare const KitUpdate: Schema.Struct<{
             }>, Schema.Struct<{
                 readonly kind: Schema.Literal<"git">;
                 readonly url: Schema.String;
-                readonly ref: Schema.String;
+                readonly ref: Schema.optionalKey<Schema.String>;
                 readonly path: Schema.optionalKey<Schema.String>;
                 readonly sha256: Schema.optionalKey<Schema.String>;
             }>, Schema.Struct<{
@@ -1010,7 +1010,7 @@ export declare const KitUpdate: Schema.Struct<{
         readonly plugins: Schema.optionalKey<Schema.$Array<Schema.Struct<{
             readonly name: Schema.String;
             readonly policy: Schema.Union<readonly [Schema.Literal<"recommended">, Schema.Literal<"required">]>;
-            readonly source: Schema.Union<readonly [Schema.Struct<{
+            readonly sources: Schema.NonEmptyArray<Schema.Union<readonly [Schema.Struct<{
                 readonly kind: Schema.Literal<"package">;
                 readonly packageName: Schema.String;
                 readonly version: Schema.optionalKey<Schema.String>;
@@ -1025,7 +1025,7 @@ export declare const KitUpdate: Schema.Struct<{
             }>, Schema.Struct<{
                 readonly kind: Schema.Literal<"local_path">;
                 readonly path: Schema.String;
-            }>]>;
+            }>]>>;
         }>>>;
         readonly mcpServers: Schema.optionalKey<Schema.$Array<Schema.Struct<{
             readonly name: Schema.String;
@@ -1149,7 +1149,7 @@ export declare const KitList: Schema.Struct<{
                 }>, Schema.Struct<{
                     readonly kind: Schema.Literal<"git">;
                     readonly url: Schema.String;
-                    readonly ref: Schema.String;
+                    readonly ref: Schema.optionalKey<Schema.String>;
                     readonly path: Schema.optionalKey<Schema.String>;
                     readonly sha256: Schema.optionalKey<Schema.String>;
                 }>, Schema.Struct<{
@@ -1170,7 +1170,7 @@ export declare const KitList: Schema.Struct<{
             readonly plugins: Schema.optionalKey<Schema.$Array<Schema.Struct<{
                 readonly name: Schema.String;
                 readonly policy: Schema.Union<readonly [Schema.Literal<"recommended">, Schema.Literal<"required">]>;
-                readonly source: Schema.Union<readonly [Schema.Struct<{
+                readonly sources: Schema.NonEmptyArray<Schema.Union<readonly [Schema.Struct<{
                     readonly kind: Schema.Literal<"package">;
                     readonly packageName: Schema.String;
                     readonly version: Schema.optionalKey<Schema.String>;
@@ -1185,7 +1185,7 @@ export declare const KitList: Schema.Struct<{
                 }>, Schema.Struct<{
                     readonly kind: Schema.Literal<"local_path">;
                     readonly path: Schema.String;
-                }>]>;
+                }>]>>;
             }>>>;
             readonly mcpServers: Schema.optionalKey<Schema.$Array<Schema.Struct<{
                 readonly name: Schema.String;

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

@@ -205,6 +205,7 @@ export declare const LiveEventPayload: Schema.Union<readonly [Schema.Struct<{
     readonly loopId: Schema.optionalKey<Schema.String>;
     readonly status: Schema.optionalKey<Schema.String>;
     readonly stepKey: Schema.optionalKey<Schema.String>;
+    readonly stepAttemptId: Schema.optionalKey<Schema.String>;
     readonly sequence: Schema.optionalKey<Schema.Int>;
 }>, Schema.Struct<{
     readonly operation: Schema.Union<readonly [Schema.Literal<"created">, Schema.Literal<"updated">, Schema.Literal<"deleted">, Schema.Literal<"status_changed">, Schema.Literal<"assignment_changed">, Schema.Literal<"moved">, Schema.Literal<"heartbeat">, Schema.Literal<"access_changed">, Schema.Literal<"resolved">, Schema.Literal<"approved">, Schema.Literal<"rejected">, Schema.Literal<"completed">, Schema.Literal<"claimed">, Schema.Literal<"failed">, Schema.Literal<"invalidated">, Schema.Literal<"opened">, Schema.Literal<"closed">, Schema.Literal<"changed">, Schema.Literal<"promoted">, Schema.Literal<"waived">, Schema.Literal<"available">, Schema.Literal<"removed">, Schema.Literal<"lease_changed">, Schema.Literal<"step_changed">, Schema.Literal<"message_created">, Schema.Literal<"acknowledged">]>;
@@ -484,6 +485,7 @@ export declare const LiveEvent: Schema.Struct<{
         readonly loopId: Schema.optionalKey<Schema.String>;
         readonly status: Schema.optionalKey<Schema.String>;
         readonly stepKey: Schema.optionalKey<Schema.String>;
+        readonly stepAttemptId: Schema.optionalKey<Schema.String>;
         readonly sequence: Schema.optionalKey<Schema.Int>;
     }>, Schema.Struct<{
         readonly operation: Schema.Union<readonly [Schema.Literal<"created">, Schema.Literal<"updated">, Schema.Literal<"deleted">, Schema.Literal<"status_changed">, Schema.Literal<"assignment_changed">, Schema.Literal<"moved">, Schema.Literal<"heartbeat">, Schema.Literal<"access_changed">, Schema.Literal<"resolved">, Schema.Literal<"approved">, Schema.Literal<"rejected">, Schema.Literal<"completed">, Schema.Literal<"claimed">, Schema.Literal<"failed">, Schema.Literal<"invalidated">, Schema.Literal<"opened">, Schema.Literal<"closed">, Schema.Literal<"changed">, Schema.Literal<"promoted">, Schema.Literal<"waived">, Schema.Literal<"available">, Schema.Literal<"removed">, Schema.Literal<"lease_changed">, Schema.Literal<"step_changed">, Schema.Literal<"message_created">, Schema.Literal<"acknowledged">]>;
@@ -650,6 +652,7 @@ export declare const LiveEventTypes: {
     readonly RunCreated: 'dev.kitman.run.created.v1';
     readonly RunStatusChanged: 'dev.kitman.run.status.changed.v1';
     readonly RunStepChanged: 'dev.kitman.run.step.changed.v1';
+    readonly RunSessionUpdateCreated: 'dev.kitman.run.session_update.created.v1';
     readonly LoopChangeCreated: 'dev.kitman.loop_change.created.v1';
     readonly LoopChangeUpdated: 'dev.kitman.loop_change.updated.v1';
     readonly ApprovalRequested: 'dev.kitman.approval.requested.v1';
@@ -1041,6 +1044,7 @@ export declare const LiveWebEvent: Schema.Union<readonly [...(Schema.Struct<{
         readonly loopId: Schema.optionalKey<Schema.String>;
         readonly status: Schema.optionalKey<Schema.String>;
         readonly stepKey: Schema.optionalKey<Schema.String>;
+        readonly stepAttemptId: Schema.optionalKey<Schema.String>;
         readonly sequence: Schema.optionalKey<Schema.Int>;
     }>;
 }> | Schema.Struct<{
@@ -1809,6 +1813,7 @@ export declare const LiveMutationOutcome: Schema.Union<readonly [Schema.Struct<{
             readonly loopId: Schema.optionalKey<Schema.String>;
             readonly status: Schema.optionalKey<Schema.String>;
             readonly stepKey: Schema.optionalKey<Schema.String>;
+            readonly stepAttemptId: Schema.optionalKey<Schema.String>;
             readonly sequence: Schema.optionalKey<Schema.Int>;
         }>;
     }> | Schema.Struct<{
@@ -2577,6 +2582,7 @@ export declare const LiveMutationOutcome: Schema.Union<readonly [Schema.Struct<{
             readonly loopId: Schema.optionalKey<Schema.String>;
             readonly status: Schema.optionalKey<Schema.String>;
             readonly stepKey: Schema.optionalKey<Schema.String>;
+            readonly stepAttemptId: Schema.optionalKey<Schema.String>;
             readonly sequence: Schema.optionalKey<Schema.Int>;
         }>;
     }> | Schema.Struct<{
@@ -3364,6 +3370,7 @@ export declare const LiveFrame: Schema.Union<readonly [Schema.Struct<{
             readonly loopId: Schema.optionalKey<Schema.String>;
             readonly status: Schema.optionalKey<Schema.String>;
             readonly stepKey: Schema.optionalKey<Schema.String>;
+            readonly stepAttemptId: Schema.optionalKey<Schema.String>;
             readonly sequence: Schema.optionalKey<Schema.Int>;
         }>;
     }> | Schema.Struct<{
@@ -4136,6 +4143,7 @@ export declare const LiveFrame: Schema.Union<readonly [Schema.Struct<{
             readonly loopId: Schema.optionalKey<Schema.String>;
             readonly status: Schema.optionalKey<Schema.String>;
             readonly stepKey: Schema.optionalKey<Schema.String>;
+            readonly stepAttemptId: Schema.optionalKey<Schema.String>;
             readonly sequence: Schema.optionalKey<Schema.Int>;
         }>;
     }> | Schema.Struct<{
@@ -4978,6 +4986,7 @@ export declare const LiveSubscribeResult: Schema.Struct<{
             readonly loopId: Schema.optionalKey<Schema.String>;
             readonly status: Schema.optionalKey<Schema.String>;
             readonly stepKey: Schema.optionalKey<Schema.String>;
+            readonly stepAttemptId: Schema.optionalKey<Schema.String>;
             readonly sequence: Schema.optionalKey<Schema.Int>;
         }>, Schema.Struct<{
             readonly operation: Schema.Union<readonly [Schema.Literal<"created">, Schema.Literal<"updated">, Schema.Literal<"deleted">, Schema.Literal<"status_changed">, Schema.Literal<"assignment_changed">, Schema.Literal<"moved">, Schema.Literal<"heartbeat">, Schema.Literal<"access_changed">, Schema.Literal<"resolved">, Schema.Literal<"approved">, Schema.Literal<"rejected">, Schema.Literal<"completed">, Schema.Literal<"claimed">, Schema.Literal<"failed">, Schema.Literal<"invalidated">, Schema.Literal<"opened">, Schema.Literal<"closed">, Schema.Literal<"changed">, Schema.Literal<"promoted">, Schema.Literal<"waived">, Schema.Literal<"available">, Schema.Literal<"removed">, Schema.Literal<"lease_changed">, Schema.Literal<"step_changed">, Schema.Literal<"message_created">, Schema.Literal<"acknowledged">]>;
@@ -5757,6 +5766,7 @@ export declare const LiveWebReplayResult: Schema.Struct<{
             readonly loopId: Schema.optionalKey<Schema.String>;
             readonly status: Schema.optionalKey<Schema.String>;
             readonly stepKey: Schema.optionalKey<Schema.String>;
+            readonly stepAttemptId: Schema.optionalKey<Schema.String>;
             readonly sequence: Schema.optionalKey<Schema.Int>;
         }>;
     }> | Schema.Struct<{