agent-dealer 1.2.13 → 1.2.15

package/bundle/shared/dist/runtime-capacity.d.ts

@@ -25,6 +25,30 @@ export type CapacityUnavailableReason = z.infer<typeof CapacityUnavailableReason
  */
 export declare const CapacityCriticalRole: z.ZodEnum<["five_hour", "weekly"]>;
 export type CapacityCriticalRole = z.infer<typeof CapacityCriticalRole>;
+/**
+ * NOT-366: why a window could not be acquired, as operator-readable text plus
+ * the failure streak — so a three-day break reads differently from one
+ * transient miss. `message` is plain prose (never an internal failure-kind
+ * or sentinel identifier). Absent/null whenever the window carries a reading
+ * from a successful acquisition.
+ */
+export declare const CapacityUnavailableDetail: z.ZodObject<{
+    message: z.ZodString;
+    consecutiveFailures: z.ZodNumber;
+    firstFailureAt: z.ZodString;
+    lastFailureAt: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    message: string;
+    consecutiveFailures: number;
+    firstFailureAt: string;
+    lastFailureAt: string;
+}, {
+    message: string;
+    consecutiveFailures: number;
+    firstFailureAt: string;
+    lastFailureAt: string;
+}>;
+export type CapacityUnavailableDetail = z.infer<typeof CapacityUnavailableDetail>;
 export declare const CapacityWindowSnapshot: z.ZodObject<{
     /** Stable per-runtime key for this window (e.g. `weekly_all_models`). */
     windowKey: z.ZodString;
@@ -49,6 +73,23 @@ export declare const CapacityWindowSnapshot: z.ZodObject<{
     expiresAt: z.ZodNullable<z.ZodString>;
     source: z.ZodEnum<["supported_protocol", "observed_event", "experimental_api", "unavailable"]>;
     unavailableReason: z.ZodNullable<z.ZodEnum<["unsupported", "missing", "expired", "unparsable", "stale"]>>;
+    /** NOT-366: acquisition-failure explanation and streak (see above). */
+    unavailableDetail: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+        message: z.ZodString;
+        consecutiveFailures: z.ZodNumber;
+        firstFailureAt: z.ZodString;
+        lastFailureAt: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        message: string;
+        consecutiveFailures: number;
+        firstFailureAt: string;
+        lastFailureAt: string;
+    }, {
+        message: string;
+        consecutiveFailures: number;
+        firstFailureAt: string;
+        lastFailureAt: string;
+    }>>>;
     criticalRole: z.ZodNullable<z.ZodEnum<["five_hour", "weekly"]>>;
 }, "strip", z.ZodTypeAny, {
     observedAt: string;
@@ -65,6 +106,12 @@ export declare const CapacityWindowSnapshot: z.ZodObject<{
     expiresAt: string | null;
     unavailableReason: "unsupported" | "missing" | "expired" | "unparsable" | "stale" | null;
     criticalRole: "five_hour" | "weekly" | null;
+    unavailableDetail?: {
+        message: string;
+        consecutiveFailures: number;
+        firstFailureAt: string;
+        lastFailureAt: string;
+    } | null | undefined;
 }, {
     observedAt: string;
     source: "unavailable" | "supported_protocol" | "observed_event" | "experimental_api";
@@ -80,6 +127,12 @@ export declare const CapacityWindowSnapshot: z.ZodObject<{
     expiresAt: string | null;
     unavailableReason: "unsupported" | "missing" | "expired" | "unparsable" | "stale" | null;
     criticalRole: "five_hour" | "weekly" | null;
+    unavailableDetail?: {
+        message: string;
+        consecutiveFailures: number;
+        firstFailureAt: string;
+        lastFailureAt: string;
+    } | null | undefined;
 }>;
 export type CapacityWindowSnapshot = z.infer<typeof CapacityWindowSnapshot>;
 export declare const RuntimeCapacityEntry: z.ZodObject<{
@@ -109,6 +162,23 @@ export declare const RuntimeCapacityEntry: z.ZodObject<{
         expiresAt: z.ZodNullable<z.ZodString>;
         source: z.ZodEnum<["supported_protocol", "observed_event", "experimental_api", "unavailable"]>;
         unavailableReason: z.ZodNullable<z.ZodEnum<["unsupported", "missing", "expired", "unparsable", "stale"]>>;
+        /** NOT-366: acquisition-failure explanation and streak (see above). */
+        unavailableDetail: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+            message: z.ZodString;
+            consecutiveFailures: z.ZodNumber;
+            firstFailureAt: z.ZodString;
+            lastFailureAt: z.ZodString;
+        }, "strip", z.ZodTypeAny, {
+            message: string;
+            consecutiveFailures: number;
+            firstFailureAt: string;
+            lastFailureAt: string;
+        }, {
+            message: string;
+            consecutiveFailures: number;
+            firstFailureAt: string;
+            lastFailureAt: string;
+        }>>>;
         criticalRole: z.ZodNullable<z.ZodEnum<["five_hour", "weekly"]>>;
     }, "strip", z.ZodTypeAny, {
         observedAt: string;
@@ -125,6 +195,12 @@ export declare const RuntimeCapacityEntry: z.ZodObject<{
         expiresAt: string | null;
         unavailableReason: "unsupported" | "missing" | "expired" | "unparsable" | "stale" | null;
         criticalRole: "five_hour" | "weekly" | null;
+        unavailableDetail?: {
+            message: string;
+            consecutiveFailures: number;
+            firstFailureAt: string;
+            lastFailureAt: string;
+        } | null | undefined;
     }, {
         observedAt: string;
         source: "unavailable" | "supported_protocol" | "observed_event" | "experimental_api";
@@ -140,6 +216,12 @@ export declare const RuntimeCapacityEntry: z.ZodObject<{
         expiresAt: string | null;
         unavailableReason: "unsupported" | "missing" | "expired" | "unparsable" | "stale" | null;
         criticalRole: "five_hour" | "weekly" | null;
+        unavailableDetail?: {
+            message: string;
+            consecutiveFailures: number;
+            firstFailureAt: string;
+            lastFailureAt: string;
+        } | null | undefined;
     }>, "many">;
     /** Whole-entry fallback reason when no window carries a current value. */
     unavailableReason: z.ZodNullable<z.ZodEnum<["unsupported", "missing", "expired", "unparsable", "stale"]>>;
@@ -161,6 +243,12 @@ export declare const RuntimeCapacityEntry: z.ZodObject<{
         expiresAt: string | null;
         unavailableReason: "unsupported" | "missing" | "expired" | "unparsable" | "stale" | null;
         criticalRole: "five_hour" | "weekly" | null;
+        unavailableDetail?: {
+            message: string;
+            consecutiveFailures: number;
+            firstFailureAt: string;
+            lastFailureAt: string;
+        } | null | undefined;
     }[];
 }, {
     runtime: "claude_code" | "cursor_local" | "codex_local" | "muse_code";
@@ -180,6 +268,12 @@ export declare const RuntimeCapacityEntry: z.ZodObject<{
         expiresAt: string | null;
         unavailableReason: "unsupported" | "missing" | "expired" | "unparsable" | "stale" | null;
         criticalRole: "five_hour" | "weekly" | null;
+        unavailableDetail?: {
+            message: string;
+            consecutiveFailures: number;
+            firstFailureAt: string;
+            lastFailureAt: string;
+        } | null | undefined;
     }[];
 }>;
 export type RuntimeCapacityEntry = z.infer<typeof RuntimeCapacityEntry>;
@@ -211,6 +305,23 @@ export declare const RuntimeCapacityResponse: z.ZodObject<{
             expiresAt: z.ZodNullable<z.ZodString>;
             source: z.ZodEnum<["supported_protocol", "observed_event", "experimental_api", "unavailable"]>;
             unavailableReason: z.ZodNullable<z.ZodEnum<["unsupported", "missing", "expired", "unparsable", "stale"]>>;
+            /** NOT-366: acquisition-failure explanation and streak (see above). */
+            unavailableDetail: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+                message: z.ZodString;
+                consecutiveFailures: z.ZodNumber;
+                firstFailureAt: z.ZodString;
+                lastFailureAt: z.ZodString;
+            }, "strip", z.ZodTypeAny, {
+                message: string;
+                consecutiveFailures: number;
+                firstFailureAt: string;
+                lastFailureAt: string;
+            }, {
+                message: string;
+                consecutiveFailures: number;
+                firstFailureAt: string;
+                lastFailureAt: string;
+            }>>>;
             criticalRole: z.ZodNullable<z.ZodEnum<["five_hour", "weekly"]>>;
         }, "strip", z.ZodTypeAny, {
             observedAt: string;
@@ -227,6 +338,12 @@ export declare const RuntimeCapacityResponse: z.ZodObject<{
             expiresAt: string | null;
             unavailableReason: "unsupported" | "missing" | "expired" | "unparsable" | "stale" | null;
             criticalRole: "five_hour" | "weekly" | null;
+            unavailableDetail?: {
+                message: string;
+                consecutiveFailures: number;
+                firstFailureAt: string;
+                lastFailureAt: string;
+            } | null | undefined;
         }, {
             observedAt: string;
             source: "unavailable" | "supported_protocol" | "observed_event" | "experimental_api";
@@ -242,6 +359,12 @@ export declare const RuntimeCapacityResponse: z.ZodObject<{
             expiresAt: string | null;
             unavailableReason: "unsupported" | "missing" | "expired" | "unparsable" | "stale" | null;
             criticalRole: "five_hour" | "weekly" | null;
+            unavailableDetail?: {
+                message: string;
+                consecutiveFailures: number;
+                firstFailureAt: string;
+                lastFailureAt: string;
+            } | null | undefined;
         }>, "many">;
         /** Whole-entry fallback reason when no window carries a current value. */
         unavailableReason: z.ZodNullable<z.ZodEnum<["unsupported", "missing", "expired", "unparsable", "stale"]>>;
@@ -263,6 +386,12 @@ export declare const RuntimeCapacityResponse: z.ZodObject<{
             expiresAt: string | null;
             unavailableReason: "unsupported" | "missing" | "expired" | "unparsable" | "stale" | null;
             criticalRole: "five_hour" | "weekly" | null;
+            unavailableDetail?: {
+                message: string;
+                consecutiveFailures: number;
+                firstFailureAt: string;
+                lastFailureAt: string;
+            } | null | undefined;
         }[];
     }, {
         runtime: "claude_code" | "cursor_local" | "codex_local" | "muse_code";
@@ -282,6 +411,12 @@ export declare const RuntimeCapacityResponse: z.ZodObject<{
             expiresAt: string | null;
             unavailableReason: "unsupported" | "missing" | "expired" | "unparsable" | "stale" | null;
             criticalRole: "five_hour" | "weekly" | null;
+            unavailableDetail?: {
+                message: string;
+                consecutiveFailures: number;
+                firstFailureAt: string;
+                lastFailureAt: string;
+            } | null | undefined;
         }[];
     }>, "many">;
     generatedAt: z.ZodString;
@@ -305,6 +440,12 @@ export declare const RuntimeCapacityResponse: z.ZodObject<{
             expiresAt: string | null;
             unavailableReason: "unsupported" | "missing" | "expired" | "unparsable" | "stale" | null;
             criticalRole: "five_hour" | "weekly" | null;
+            unavailableDetail?: {
+                message: string;
+                consecutiveFailures: number;
+                firstFailureAt: string;
+                lastFailureAt: string;
+            } | null | undefined;
         }[];
     }[];
 }, {
@@ -327,6 +468,12 @@ export declare const RuntimeCapacityResponse: z.ZodObject<{
             expiresAt: string | null;
             unavailableReason: "unsupported" | "missing" | "expired" | "unparsable" | "stale" | null;
             criticalRole: "five_hour" | "weekly" | null;
+            unavailableDetail?: {
+                message: string;
+                consecutiveFailures: number;
+                firstFailureAt: string;
+                lastFailureAt: string;
+            } | null | undefined;
         }[];
     }[];
 }>;

package/bundle/shared/dist/runtime-capacity.js

@@ -44,6 +44,19 @@ export const CapacityUnavailableReason = z.enum([
  * provider/window this contract has no opinion on).
  */
 export const CapacityCriticalRole = z.enum(["five_hour", "weekly"]);
+/**
+ * NOT-366: why a window could not be acquired, as operator-readable text plus
+ * the failure streak — so a three-day break reads differently from one
+ * transient miss. `message` is plain prose (never an internal failure-kind
+ * or sentinel identifier). Absent/null whenever the window carries a reading
+ * from a successful acquisition.
+ */
+export const CapacityUnavailableDetail = z.object({
+    message: z.string().min(1),
+    consecutiveFailures: z.number().int().positive(),
+    firstFailureAt: z.string(),
+    lastFailureAt: z.string(),
+});
 export const CapacityWindowSnapshot = z.object({
     /** Stable per-runtime key for this window (e.g. `weekly_all_models`). */
     windowKey: z.string().min(1),
@@ -68,6 +81,8 @@ export const CapacityWindowSnapshot = z.object({
     expiresAt: z.string().nullable(),
     source: CapacitySource,
     unavailableReason: CapacityUnavailableReason.nullable(),
+    /** NOT-366: acquisition-failure explanation and streak (see above). */
+    unavailableDetail: CapacityUnavailableDetail.nullable().optional(),
     criticalRole: CapacityCriticalRole.nullable(),
 });
 export const RuntimeCapacityEntry = z.object({

package/bundle/shared/dist/workflow.d.ts

@@ -24,7 +24,7 @@ export declare const WorkflowInstance: z.ZodObject<{
     outcome: "done" | "closed" | "migrated" | null;
 }>;
 export type WorkflowInstance = z.infer<typeof WorkflowInstance>;
-export declare const WorkflowEventType: z.ZodEnum<["issue.created", "issue.reassigned", "workflow.started", "worker.started", "worker.completed", "worker.failed", "worker.deferred", "worktree.ready", "worktree.deps_ready", "deck.connected", "brief.resolved", "branch.pushed", "checks.started", "pull_request.opened", "pull_request.updated", "checks.completed", "review.submitted", "repair.started", "guidance.added", "task_snapshot.refreshed", "human_action.requested", "human_action.resolved", "final_review.requested", "issue.completed", "issue.closed", "queue.enqueued", "queue.wait_reason_changed", "queue.admitted", "queue.removed", "agent.started", "agent.completed", "host.suspended", "checkpoint.observed", "retry.reused", "auto_merge.conflict_sync", "auto_merge.conflict_repair_queued", "base.probe", "base.advanced", "operator_verification.waived", "legacy.imported"]>;
+export declare const WorkflowEventType: z.ZodEnum<["issue.created", "issue.reassigned", "issue.source_reloaded", "workflow.started", "worker.started", "worker.completed", "worker.failed", "worker.deferred", "worktree.ready", "worktree.deps_ready", "inputs.materialized", "deck.connected", "brief.resolved", "branch.pushed", "checks.started", "pull_request.opened", "pull_request.updated", "checks.completed", "review.submitted", "repair.started", "guidance.added", "task_snapshot.refreshed", "human_action.requested", "human_action.resolved", "final_review.requested", "issue.completed", "issue.closed", "queue.enqueued", "queue.wait_reason_changed", "queue.admitted", "queue.removed", "agent.started", "agent.completed", "host.suspended", "checkpoint.observed", "retry.reused", "auto_merge.conflict_sync", "auto_merge.conflict_repair_queued", "base.probe", "base.advanced", "operator_verification.waived", "legacy.imported"]>;
 export type WorkflowEventType = z.infer<typeof WorkflowEventType>;
 export declare const WorkflowEvent: z.ZodObject<{
     id: z.ZodString;
@@ -32,7 +32,7 @@ export declare const WorkflowEvent: z.ZodObject<{
     /** Nullable only for issue creation/guidance emitted before any workflow starts. */
     workflowInstanceId: z.ZodNullable<z.ZodString>;
     workerSessionId: z.ZodNullable<z.ZodString>;
-    type: z.ZodEnum<["issue.created", "issue.reassigned", "workflow.started", "worker.started", "worker.completed", "worker.failed", "worker.deferred", "worktree.ready", "worktree.deps_ready", "deck.connected", "brief.resolved", "branch.pushed", "checks.started", "pull_request.opened", "pull_request.updated", "checks.completed", "review.submitted", "repair.started", "guidance.added", "task_snapshot.refreshed", "human_action.requested", "human_action.resolved", "final_review.requested", "issue.completed", "issue.closed", "queue.enqueued", "queue.wait_reason_changed", "queue.admitted", "queue.removed", "agent.started", "agent.completed", "host.suspended", "checkpoint.observed", "retry.reused", "auto_merge.conflict_sync", "auto_merge.conflict_repair_queued", "base.probe", "base.advanced", "operator_verification.waived", "legacy.imported"]>;
+    type: z.ZodEnum<["issue.created", "issue.reassigned", "issue.source_reloaded", "workflow.started", "worker.started", "worker.completed", "worker.failed", "worker.deferred", "worktree.ready", "worktree.deps_ready", "inputs.materialized", "deck.connected", "brief.resolved", "branch.pushed", "checks.started", "pull_request.opened", "pull_request.updated", "checks.completed", "review.submitted", "repair.started", "guidance.added", "task_snapshot.refreshed", "human_action.requested", "human_action.resolved", "final_review.requested", "issue.completed", "issue.closed", "queue.enqueued", "queue.wait_reason_changed", "queue.admitted", "queue.removed", "agent.started", "agent.completed", "host.suspended", "checkpoint.observed", "retry.reused", "auto_merge.conflict_sync", "auto_merge.conflict_repair_queued", "base.probe", "base.advanced", "operator_verification.waived", "legacy.imported"]>;
     actorType: z.ZodEnum<["human", "developer", "reviewer", "system"]>;
     actorRef: z.ZodNullable<z.ZodString>;
     /** Issue status at emit time — lets the timeline render without re-deriving state. */
@@ -45,7 +45,7 @@ export declare const WorkflowEvent: z.ZodObject<{
     causationEventId: z.ZodNullable<z.ZodString>;
     ts: z.ZodString;
 }, "strip", z.ZodTypeAny, {
-    type: "issue.created" | "issue.reassigned" | "workflow.started" | "worker.started" | "worker.completed" | "worker.failed" | "worker.deferred" | "worktree.ready" | "worktree.deps_ready" | "deck.connected" | "brief.resolved" | "branch.pushed" | "checks.started" | "pull_request.opened" | "pull_request.updated" | "checks.completed" | "review.submitted" | "repair.started" | "guidance.added" | "task_snapshot.refreshed" | "human_action.requested" | "human_action.resolved" | "final_review.requested" | "issue.completed" | "issue.closed" | "queue.enqueued" | "queue.wait_reason_changed" | "queue.admitted" | "queue.removed" | "agent.started" | "agent.completed" | "host.suspended" | "checkpoint.observed" | "retry.reused" | "auto_merge.conflict_sync" | "auto_merge.conflict_repair_queued" | "base.probe" | "base.advanced" | "operator_verification.waived" | "legacy.imported";
+    type: "issue.created" | "issue.reassigned" | "issue.source_reloaded" | "workflow.started" | "worker.started" | "worker.completed" | "worker.failed" | "worker.deferred" | "worktree.ready" | "worktree.deps_ready" | "inputs.materialized" | "deck.connected" | "brief.resolved" | "branch.pushed" | "checks.started" | "pull_request.opened" | "pull_request.updated" | "checks.completed" | "review.submitted" | "repair.started" | "guidance.added" | "task_snapshot.refreshed" | "human_action.requested" | "human_action.resolved" | "final_review.requested" | "issue.completed" | "issue.closed" | "queue.enqueued" | "queue.wait_reason_changed" | "queue.admitted" | "queue.removed" | "agent.started" | "agent.completed" | "host.suspended" | "checkpoint.observed" | "retry.reused" | "auto_merge.conflict_sync" | "auto_merge.conflict_repair_queued" | "base.probe" | "base.advanced" | "operator_verification.waived" | "legacy.imported";
     id: string;
     issueId: string;
     round: number | null;
@@ -60,7 +60,7 @@ export declare const WorkflowEvent: z.ZodObject<{
     causationEventId: string | null;
     ts: string;
 }, {
-    type: "issue.created" | "issue.reassigned" | "workflow.started" | "worker.started" | "worker.completed" | "worker.failed" | "worker.deferred" | "worktree.ready" | "worktree.deps_ready" | "deck.connected" | "brief.resolved" | "branch.pushed" | "checks.started" | "pull_request.opened" | "pull_request.updated" | "checks.completed" | "review.submitted" | "repair.started" | "guidance.added" | "task_snapshot.refreshed" | "human_action.requested" | "human_action.resolved" | "final_review.requested" | "issue.completed" | "issue.closed" | "queue.enqueued" | "queue.wait_reason_changed" | "queue.admitted" | "queue.removed" | "agent.started" | "agent.completed" | "host.suspended" | "checkpoint.observed" | "retry.reused" | "auto_merge.conflict_sync" | "auto_merge.conflict_repair_queued" | "base.probe" | "base.advanced" | "operator_verification.waived" | "legacy.imported";
+    type: "issue.created" | "issue.reassigned" | "issue.source_reloaded" | "workflow.started" | "worker.started" | "worker.completed" | "worker.failed" | "worker.deferred" | "worktree.ready" | "worktree.deps_ready" | "inputs.materialized" | "deck.connected" | "brief.resolved" | "branch.pushed" | "checks.started" | "pull_request.opened" | "pull_request.updated" | "checks.completed" | "review.submitted" | "repair.started" | "guidance.added" | "task_snapshot.refreshed" | "human_action.requested" | "human_action.resolved" | "final_review.requested" | "issue.completed" | "issue.closed" | "queue.enqueued" | "queue.wait_reason_changed" | "queue.admitted" | "queue.removed" | "agent.started" | "agent.completed" | "host.suspended" | "checkpoint.observed" | "retry.reused" | "auto_merge.conflict_sync" | "auto_merge.conflict_repair_queued" | "base.probe" | "base.advanced" | "operator_verification.waived" | "legacy.imported";
     id: string;
     issueId: string;
     round: number | null;

package/bundle/shared/dist/workflow.js

@@ -14,6 +14,11 @@ export const WorkflowEventType = z.enum([
      * developer/reviewer assignment). Payload carries before/after repo + agent ids.
      * Emitted transactionally with the PATCH. */
     "issue.reassigned",
+    /** NOT-363: operator reloaded title/description/acceptance criteria from the
+     * linked Linear ticket on a pre-execution `ready` issue. Payload carries the
+     * source, external id/label, and previous/new task-text digests — never the
+     * full description. Emitted transactionally with the reload. */
+    "issue.source_reloaded",
     "workflow.started",
     "worker.started",
     "worker.completed",
@@ -23,6 +28,8 @@ export const WorkflowEventType = z.enum([
     "worktree.ready",
     /** NOT-315: pre-spawn dependency provisioning settled (ran or skipped). */
     "worktree.deps_ready",
+    /** NOT-364: frozen Linear source attachments materialized into the worktree. */
+    "inputs.materialized",
     "deck.connected",
     "brief.resolved",
     "branch.pushed",

package/bundle/shared/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agent-dealer/shared",
-  "version": "1.2.13",
+  "version": "1.2.15",
   "type": "module",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "agent-dealer",
-  "version": "1.2.13",
+  "version": "1.2.15",
   "description": "Human control plane for agent execution — queue, plan approval, audit",
   "license": "MIT",
   "type": "module",