@bastani/atomic 0.9.18 → 0.9.19-alpha.10

package/dist/core/workflow-stage-admission.js.map

@@ -1 +1 @@
-{"version":3,"file":"workflow-stage-admission.js","sourceRoot":"","sources":["../../src/core/workflow-stage-admission.ts"],"names":[],"mappings":"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","sourcesContent":["import { AsyncLocalStorage } from \"node:async_hooks\";\n\nexport type WorkflowStageAdmissionDecision = \"admitted\" | \"late\" | \"duplicate\";\n\nexport interface WorkflowStageAdmissionResult {\n\treadonly decision: WorkflowStageAdmissionDecision;\n\treadonly completion: Promise<void>;\n}\n\n/**\n * Linearizable admission boundary for externally-produced workflow-stage traffic.\n * JavaScript execution between the state check and state transition is synchronous:\n * an enqueue that wins belongs to the stage, while close makes every later enqueue\n * use the external route. Stable keys make either outcome exactly-once.\n */\n\nexport interface PersistedWorkflowStageAdmission {\n\treadonly type: string;\n\treadonly stageAdmissionKey?: string;\n}\nexport class WorkflowStageAdmissionBoundary {\n\tprivate open = true;\n\tprivate readonly completed: Set<string>;\n\tprivate readonly inFlight = new Map<string, Promise<void>>();\n\tprivate readonly pending = new Set<Promise<void>>();\n\tprivate readonly invocationContext = new AsyncLocalStorage<string>();\n\tprivate closePromise: Promise<void> | undefined;\n\tprivate readonly closeController = new AbortController();\n\tprivate readonly ownedSubagentRunIds = new Set<string>();\n\n\t/** Aborts synchronously when close begins so stage-owned work can terminate before late delivery. */\n\tget closeSignal(): AbortSignal {\n\t\treturn this.closeController.signal;\n\t}\n\tprivate readonly drainAdmittedWork: () => Promise<void>;\n\n\tconstructor(drainAdmittedWork: (() => Promise<void>) | undefined = undefined, completedKeys: Iterable<string> = []) {\n\t\tthis.drainAdmittedWork = drainAdmittedWork ?? (async () => {});\n\t\tthis.completed = new Set(completedKeys);\n\t}\n\n\tstatic restore(\n\t\tentries: Iterable<PersistedWorkflowStageAdmission>,\n\t\tdrainAdmittedWork?: () => Promise<void>,\n\t): WorkflowStageAdmissionBoundary {\n\t\treturn new WorkflowStageAdmissionBoundary(\n\t\t\tdrainAdmittedWork,\n\t\t\tArray.from(entries).flatMap((entry) =>\n\t\t\t\tentry.type === \"custom_message\" && typeof entry.stageAdmissionKey === \"string\"\n\t\t\t\t\t? [entry.stageAdmissionKey]\n\t\t\t\t\t: [],\n\t\t\t),\n\t\t);\n\t}\n\n\tadmit(\n\t\tkey: string | undefined,\n\t\tdeliver: () => void | Promise<void>,\n\t\trouteLate: () => void | Promise<void>,\n\t): WorkflowStageAdmissionResult {\n\t\tif (key !== undefined) {\n\t\t\tif (this.completed.has(key)) return { decision: \"duplicate\", completion: Promise.resolve() };\n\t\t\tconst inFlight = this.inFlight.get(key);\n\t\t\tif (inFlight) {\n\t\t\t\treturn {\n\t\t\t\t\tdecision: \"duplicate\",\n\t\t\t\t\tcompletion: this.invocationContext.getStore() === key ? Promise.resolve() : inFlight,\n\t\t\t\t};\n\t\t\t}\n\t\t}\n\t\tconst decision: WorkflowStageAdmissionDecision = this.open ? \"admitted\" : \"late\";\n\t\tlet completion: Promise<void>;\n\t\tif (key === undefined) {\n\t\t\tcompletion = this.invoke(this.open ? deliver : routeLate);\n\t\t} else {\n\t\t\tlet resolveCompletion!: () => void;\n\t\t\tlet rejectCompletion!: (reason?: unknown) => void;\n\t\t\tcompletion = new Promise<void>((resolve, reject) => {\n\t\t\t\tresolveCompletion = resolve;\n\t\t\t\trejectCompletion = reject;\n\t\t\t});\n\t\t\tvoid completion.catch(() => {});\n\t\t\tthis.inFlight.set(key, completion);\n\t\t\tconst delivery = this.invocationContext.run(key, () => this.invoke(this.open ? deliver : routeLate));\n\t\t\tvoid delivery.then(resolveCompletion, rejectCompletion);\n\t\t\tvoid completion.then(\n\t\t\t\t() => {\n\t\t\t\t\tif (this.inFlight.get(key) !== completion) return;\n\t\t\t\t\tthis.inFlight.delete(key);\n\t\t\t\t\tthis.completed.add(key);\n\t\t\t\t},\n\t\t\t\t() => {\n\t\t\t\t\tif (this.inFlight.get(key) === completion) this.inFlight.delete(key);\n\t\t\t\t},\n\t\t\t);\n\t\t}\n\t\tif (decision === \"admitted\") this.trackAdmittedWork(completion);\n\t\treturn { decision, completion };\n\t}\n\n\ttrackAdmittedWork(completion: Promise<void>): void {\n\t\tthis.pending.add(completion);\n\t\tvoid completion.then(\n\t\t\t() => this.pending.delete(completion),\n\t\t\t() => this.pending.delete(completion),\n\t\t);\n\t}\n\n\tregisterOwnedSubagentRun(runId: string): void {\n\t\tthis.ownedSubagentRunIds.add(runId);\n\t}\n\n\townsSubagentRun(runId: string): boolean {\n\t\treturn this.ownedSubagentRunIds.has(runId);\n\t}\n\n\tisOpen(): boolean {\n\t\treturn this.open;\n\t}\n\n\tseal(): void {\n\t\tthis.open = false;\n\t}\n\n\tclose(): Promise<void> {\n\t\tthis.seal();\n\t\tif (!this.closeController.signal.aborted) this.closeController.abort();\n\t\tthis.closePromise ??= this.finishClose();\n\t\treturn this.closePromise;\n\t}\n\n\tprivate async finishClose(): Promise<void> {\n\t\tawait Promise.allSettled([...this.pending]);\n\t\tawait this.drainAdmittedWork();\n\t}\n\n\tprivate invoke(callback: () => void | Promise<void>): Promise<void> {\n\t\ttry {\n\t\t\treturn Promise.resolve(callback());\n\t\t} catch (error) {\n\t\t\treturn Promise.reject(error);\n\t\t}\n\t}\n}\n"]}
+{"version":3,"file":"workflow-stage-admission.js","sourceRoot":"","sources":["../../src/core/workflow-stage-admission.ts"],"names":[],"mappings":"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","sourcesContent":["import { AsyncLocalStorage } from \"node:async_hooks\";\nimport { randomUUID } from \"node:crypto\";\nimport { AgentTaskHost, type AgentTaskHostBinding } from \"./tasks/agent-adapter.js\";\nimport type { OwnerScope } from \"./tasks/contracts.js\";\n\nexport type WorkflowStageAdmissionDecision = \"admitted\" | \"late\" | \"duplicate\";\n\nexport interface WorkflowStageAdmissionResult {\n\treadonly decision: WorkflowStageAdmissionDecision;\n\treadonly completion: Promise<void>;\n}\n\n/**\n * Linearizable admission boundary for externally-produced workflow-stage traffic.\n * JavaScript execution between the state check and state transition is synchronous:\n * an enqueue that wins belongs to the stage, while close makes every later enqueue\n * use the external route. Stable keys make either outcome exactly-once.\n */\n\nexport interface PersistedWorkflowStageAdmission {\n\treadonly type: string;\n\treadonly stageAdmissionKey?: string;\n}\nexport class WorkflowStageAdmissionBoundary {\n\tprivate open = true;\n\tprivate readonly completed: Set<string>;\n\tprivate readonly inFlight = new Map<string, Promise<void>>();\n\tprivate readonly pending = new Set<Promise<void>>();\n\tprivate readonly invocationContext = new AsyncLocalStorage<string>();\n\tprivate closePromise: Promise<void> | undefined;\n\tprivate readonly closeController = new AbortController();\n\tprivate readonly ownedSubagentRunIds = new Set<string>();\n\tprivate readonly stageAttemptId = randomUUID();\n\tprivate taskScope: Extract<OwnerScope, { kind: \"workflow-stage\" }> | undefined;\n\tprivate taskHost: AgentTaskHost | undefined;\n\tprivate readonly messageDeliveryContext = new AsyncLocalStorage<boolean>();\n\tprivate readonly messageAdmissionContext = new AsyncLocalStorage<{ active: boolean }>();\n\tprivate readonly messageDeliveries = new Set<Promise<void>>();\n\tprivate messageDeliveryTail: Promise<void> | undefined;\n\tprivate taskClose: ReturnType<AgentTaskHost[\"close\"]> | undefined;\n\n\t/** Called by the actual stage session; replacement sessions retain the original identity. */\n\tbindTaskIdentity(sessionId: string, runId: string, stageId: string): void {\n\t\tthis.taskScope ??= { kind: \"workflow-stage\", sessionId, runId, stageId, stageAttemptId: this.stageAttemptId };\n\t}\n\n\t/** Trusted companion integration only; the existing launch guard remains mandatory. */\n\tbindAgentTaskHost(binding: Omit<AgentTaskHostBinding, \"scope\">): AgentTaskHost {\n\t\tif (!this.open) throw new Error(\"Workflow stage generation is closed\");\n\t\tif (!this.taskScope) throw new Error(\"Workflow stage task identity is not bound\");\n\t\tthis.taskHost ??= new AgentTaskHost({ ...binding, scope: this.taskScope });\n\t\tthis.taskHost.updateBinding(binding);\n\t\treturn this.taskHost;\n\t}\n\thasAgentTaskHost(): boolean {\n\t\treturn this.taskHost !== undefined;\n\t}\n\n\t/** Aborts synchronously when close begins so stage-owned work can terminate before late delivery. */\n\tget closeSignal(): AbortSignal {\n\t\treturn this.closeController.signal;\n\t}\n\tprivate readonly drainAdmittedWork: () => Promise<void>;\n\n\tconstructor(drainAdmittedWork: (() => Promise<void>) | undefined = undefined, completedKeys: Iterable<string> = []) {\n\t\tthis.drainAdmittedWork = drainAdmittedWork ?? (async () => {});\n\t\tthis.completed = new Set(completedKeys);\n\t}\n\n\tstatic restore(\n\t\tentries: Iterable<PersistedWorkflowStageAdmission>,\n\t\tdrainAdmittedWork?: () => Promise<void>,\n\t): WorkflowStageAdmissionBoundary {\n\t\treturn new WorkflowStageAdmissionBoundary(\n\t\t\tdrainAdmittedWork,\n\t\t\tArray.from(entries).flatMap((entry) =>\n\t\t\t\tentry.type === \"custom_message\" && typeof entry.stageAdmissionKey === \"string\"\n\t\t\t\t\t? [entry.stageAdmissionKey]\n\t\t\t\t\t: [],\n\t\t\t),\n\t\t);\n\t}\n\n\t/** One FIFO position for an external operation, including its retry waits. */\n\trunMessageDelivery(\n\t\tdeliver: () => void | Promise<void>,\n\t\trouteLate?: () => void | Promise<void>,\n\t\tpreserveDestination = false,\n\t): Promise<void> {\n\t\tconst late =\n\t\t\trouteLate ??\n\t\t\t(() => {\n\t\t\t\tthrow new Error(\"Message admission is closed\");\n\t\t\t});\n\t\tconst invoke = (): void | Promise<void> => {\n\t\t\tif (!preserveDestination) return deliver();\n\t\t\t// Stage close drains the destination reserved at arrival. SDK commits\n\t\t\t// inside this operation must not be reclassified as late on retry or\n\t\t\t// after waiting for an earlier FIFO slot. Revoke on settlement so detached\n\t\t\t// descendants cannot admit new work into a closed generation.\n\t\t\tconst reservation = { active: true };\n\t\t\treturn this.messageAdmissionContext.run(reservation, async () => {\n\t\t\t\ttry {\n\t\t\t\t\tawait deliver();\n\t\t\t\t} finally {\n\t\t\t\t\treservation.active = false;\n\t\t\t\t}\n\t\t\t});\n\t\t};\n\t\treturn this.admit(undefined, () => this.serializeMessageDelivery(invoke), late).completion;\n\t}\n\n\t/** Reentrant SDK commits stay inside their producer's FIFO position. */\n\tserializeMessageDelivery(deliver: () => void | Promise<void>): Promise<void> {\n\t\tif (this.messageDeliveryContext.getStore()) return this.invoke(deliver);\n\t\tconst invoke = () => this.messageDeliveryContext.run(true, () => this.invoke(deliver));\n\t\tconst delivery = this.messageDeliveryTail ? this.messageDeliveryTail.then(invoke) : invoke();\n\t\tconst settled = delivery.catch(() => undefined);\n\t\tthis.messageDeliveryTail = settled;\n\t\tthis.messageDeliveries.add(settled);\n\t\tvoid settled.then(() => {\n\t\t\tthis.messageDeliveries.delete(settled);\n\t\t\tif (this.messageDeliveryTail === settled) this.messageDeliveryTail = undefined;\n\t\t});\n\t\treturn delivery;\n\t}\n\n\t/** Excludes tracked model turns: joining those from a native poll would deadlock. */\n\tasync waitForMessageDeliveries(): Promise<void> {\n\t\twhile (this.messageDeliveries.size > 0) await Promise.all([...this.messageDeliveries]);\n\t}\n\n\thasMessageDeliveries(): boolean {\n\t\treturn this.messageDeliveries.size > 0;\n\t}\n\n\tadmit(\n\t\tkey: string | undefined,\n\t\tdeliver: () => void | Promise<void>,\n\t\trouteLate: () => void | Promise<void>,\n\t): WorkflowStageAdmissionResult {\n\t\tif (key !== undefined) {\n\t\t\tif (this.completed.has(key)) return { decision: \"duplicate\", completion: Promise.resolve() };\n\t\t\tconst inFlight = this.inFlight.get(key);\n\t\t\tif (inFlight) {\n\t\t\t\treturn {\n\t\t\t\t\tdecision: \"duplicate\",\n\t\t\t\t\tcompletion: this.invocationContext.getStore() === key ? Promise.resolve() : inFlight,\n\t\t\t\t};\n\t\t\t}\n\t\t}\n\t\tconst admitted = this.open || this.messageAdmissionContext.getStore()?.active === true;\n\t\tconst decision: WorkflowStageAdmissionDecision = admitted ? \"admitted\" : \"late\";\n\t\tlet completion: Promise<void>;\n\t\tif (key === undefined) {\n\t\t\tcompletion = this.invoke(admitted ? deliver : routeLate);\n\t\t} else {\n\t\t\tlet resolveCompletion!: () => void;\n\t\t\tlet rejectCompletion!: (reason?: unknown) => void;\n\t\t\tcompletion = new Promise<void>((resolve, reject) => {\n\t\t\t\tresolveCompletion = resolve;\n\t\t\t\trejectCompletion = reject;\n\t\t\t});\n\t\t\tvoid completion.catch(() => {});\n\t\t\tthis.inFlight.set(key, completion);\n\t\t\tconst delivery = this.invocationContext.run(key, () => this.invoke(admitted ? deliver : routeLate));\n\t\t\tvoid delivery.then(resolveCompletion, rejectCompletion);\n\t\t\tvoid completion.then(\n\t\t\t\t() => {\n\t\t\t\t\tif (this.inFlight.get(key) !== completion) return;\n\t\t\t\t\tthis.inFlight.delete(key);\n\t\t\t\t\tthis.completed.add(key);\n\t\t\t\t},\n\t\t\t\t() => {\n\t\t\t\t\tif (this.inFlight.get(key) === completion) this.inFlight.delete(key);\n\t\t\t\t},\n\t\t\t);\n\t\t}\n\t\tif (decision === \"admitted\") this.trackAdmittedWork(completion);\n\t\treturn { decision, completion };\n\t}\n\n\ttrackAdmittedWork(completion: Promise<void>): void {\n\t\tthis.pending.add(completion);\n\t\tvoid completion.then(\n\t\t\t() => this.pending.delete(completion),\n\t\t\t() => this.pending.delete(completion),\n\t\t);\n\t}\n\n\t/** Join already-reserved queue commits before a native turn polls its input. */\n\tasync waitForPendingDeliveries(): Promise<void> {\n\t\tawait Promise.allSettled([...this.pending]);\n\t}\n\n\thasPendingDeliveries(): boolean {\n\t\treturn this.pending.size > 0;\n\t}\n\n\tregisterOwnedSubagentRun(runId: string): void {\n\t\tthis.ownedSubagentRunIds.add(runId);\n\t}\n\n\townsSubagentRun(runId: string): boolean {\n\t\treturn this.ownedSubagentRunIds.has(runId);\n\t}\n\n\tisOpen(): boolean {\n\t\treturn this.open;\n\t}\n\n\tseal(): void {\n\t\tthis.open = false;\n\t\tthis.taskClose ??= this.taskHost?.close(\"stage-close\");\n\t}\n\n\tclose(): Promise<void> {\n\t\tthis.seal();\n\t\tif (!this.closeController.signal.aborted) this.closeController.abort();\n\t\tthis.closePromise ??= this.finishClose();\n\t\treturn this.closePromise;\n\t}\n\n\tprivate async finishClose(): Promise<void> {\n\t\tawait Promise.allSettled([...this.pending]);\n\t\tawait this.drainAdmittedWork();\n\t\tconst closed = await this.taskClose;\n\t\tif (closed && !closed.ok) throw new Error(`${closed.error.code}: ${closed.error.message}`);\n\t}\n\n\tprivate invoke(callback: () => void | Promise<void>): Promise<void> {\n\t\ttry {\n\t\t\treturn Promise.resolve(callback());\n\t\t} catch (error) {\n\t\t\treturn Promise.reject(error);\n\t\t}\n\t}\n}\n"]}

package/dist/extensions/herdr/activity.d.ts

@@ -0,0 +1,15 @@
+import type { WorkflowActivityReason, WorkflowActivityState, WorkflowRootActivity } from "../../core/extensions/workflow-events.js";
+export interface SessionActivity {
+    state: WorkflowActivityState;
+    reason: WorkflowActivityReason;
+    message?: "Waiting for approval" | "Workflow needs attention";
+}
+export interface SessionActivityInput {
+    agentRunning: boolean;
+    tasksRunning?: boolean;
+    openPromptCount: number;
+    roots: readonly WorkflowRootActivity[];
+    availability: "ready" | "recovering" | "unavailable";
+}
+export declare function deriveSessionActivity(input: SessionActivityInput): SessionActivity | undefined;
+//# sourceMappingURL=activity.d.ts.map

package/dist/extensions/herdr/activity.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"activity.d.ts","sourceRoot":"","sources":["../../../src/extensions/herdr/activity.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACX,sBAAsB,EACtB,qBAAqB,EACrB,oBAAoB,EACpB,MAAM,0CAA0C,CAAC;AAElD,MAAM,WAAW,eAAe;IAC/B,KAAK,EAAE,qBAAqB,CAAC;IAC7B,MAAM,EAAE,sBAAsB,CAAC;IAC/B,OAAO,CAAC,EAAE,sBAAsB,GAAG,0BAA0B,CAAC;CAC9D;AAED,MAAM,WAAW,oBAAoB;IACpC,YAAY,EAAE,OAAO,CAAC;IACtB,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,eAAe,EAAE,MAAM,CAAC;IACxB,KAAK,EAAE,SAAS,oBAAoB,EAAE,CAAC;IACvC,YAAY,EAAE,OAAO,GAAG,YAAY,GAAG,aAAa,CAAC;CACrD;AAED,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,oBAAoB,GAAG,eAAe,GAAG,SAAS,CAoB9F"}

package/dist/extensions/herdr/activity.js

@@ -0,0 +1,24 @@
+export function deriveSessionActivity(input) {
+    const working = input.roots.find((root) => root.state === "working");
+    const attention = input.roots.some((root) => root.needsAttention || root.state === "blocked");
+    if (working || input.tasksRunning || (input.agentRunning && input.openPromptCount === 0)) {
+        return {
+            state: "working",
+            reason: working?.reason ?? "executing",
+            ...(attention ? { message: "Workflow needs attention" } : {}),
+        };
+    }
+    if (input.openPromptCount > 0)
+        return { state: "blocked", reason: "awaiting_input", message: "Waiting for approval" };
+    const blocked = input.roots.find((root) => root.state === "blocked");
+    if (blocked)
+        return { state: "blocked", reason: blocked.reason, message: "Workflow needs attention" };
+    if (input.availability !== "ready")
+        return undefined;
+    return {
+        state: "idle",
+        reason: input.roots.some((root) => root.reason === "paused") ? "paused" : "quiescent",
+        ...(attention ? { message: "Workflow needs attention" } : {}),
+    };
+}
+//# sourceMappingURL=activity.js.map

package/dist/extensions/herdr/activity.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"activity.js","sourceRoot":"","sources":["../../../src/extensions/herdr/activity.ts"],"names":[],"mappings":"AAoBA,MAAM,UAAU,qBAAqB,CAAC,KAA2B;IAChE,MAAM,OAAO,GAAG,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC;IACrE,MAAM,SAAS,GAAG,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,cAAc,IAAI,IAAI,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC;IAC9F,IAAI,OAAO,IAAI,KAAK,CAAC,YAAY,IAAI,CAAC,KAAK,CAAC,YAAY,IAAI,KAAK,CAAC,eAAe,KAAK,CAAC,CAAC,EAAE,CAAC;QAC1F,OAAO;YACN,KAAK,EAAE,SAAS;YAChB,MAAM,EAAE,OAAO,EAAE,MAAM,IAAI,WAAW;YACtC,GAAG,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,0BAAmC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SACtE,CAAC;IACH,CAAC;IACD,IAAI,KAAK,CAAC,eAAe,GAAG,CAAC;QAC5B,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,MAAM,EAAE,gBAAgB,EAAE,OAAO,EAAE,sBAAsB,EAAE,CAAC;IACxF,MAAM,OAAO,GAAG,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC;IACrE,IAAI,OAAO;QAAE,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,MAAM,EAAE,OAAO,CAAC,MAAM,EAAE,OAAO,EAAE,0BAA0B,EAAE,CAAC;IACtG,IAAI,KAAK,CAAC,YAAY,KAAK,OAAO;QAAE,OAAO,SAAS,CAAC;IACrD,OAAO;QACN,KAAK,EAAE,MAAM;QACb,MAAM,EAAE,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,MAAM,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,WAAW;QACrF,GAAG,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,0BAAmC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KACtE,CAAC;AACH,CAAC","sourcesContent":["import type {\n\tWorkflowActivityReason,\n\tWorkflowActivityState,\n\tWorkflowRootActivity,\n} from \"../../core/extensions/workflow-events.js\";\n\nexport interface SessionActivity {\n\tstate: WorkflowActivityState;\n\treason: WorkflowActivityReason;\n\tmessage?: \"Waiting for approval\" | \"Workflow needs attention\";\n}\n\nexport interface SessionActivityInput {\n\tagentRunning: boolean;\n\ttasksRunning?: boolean;\n\topenPromptCount: number;\n\troots: readonly WorkflowRootActivity[];\n\tavailability: \"ready\" | \"recovering\" | \"unavailable\";\n}\n\nexport function deriveSessionActivity(input: SessionActivityInput): SessionActivity | undefined {\n\tconst working = input.roots.find((root) => root.state === \"working\");\n\tconst attention = input.roots.some((root) => root.needsAttention || root.state === \"blocked\");\n\tif (working || input.tasksRunning || (input.agentRunning && input.openPromptCount === 0)) {\n\t\treturn {\n\t\t\tstate: \"working\",\n\t\t\treason: working?.reason ?? \"executing\",\n\t\t\t...(attention ? { message: \"Workflow needs attention\" as const } : {}),\n\t\t};\n\t}\n\tif (input.openPromptCount > 0)\n\t\treturn { state: \"blocked\", reason: \"awaiting_input\", message: \"Waiting for approval\" };\n\tconst blocked = input.roots.find((root) => root.state === \"blocked\");\n\tif (blocked) return { state: \"blocked\", reason: blocked.reason, message: \"Workflow needs attention\" };\n\tif (input.availability !== \"ready\") return undefined;\n\treturn {\n\t\tstate: \"idle\",\n\t\treason: input.roots.some((root) => root.reason === \"paused\") ? \"paused\" : \"quiescent\",\n\t\t...(attention ? { message: \"Workflow needs attention\" as const } : {}),\n\t};\n}\n"]}

package/dist/extensions/herdr/environment.d.ts

@@ -0,0 +1,7 @@
+export interface HerdrEnvironment {
+    bin: string;
+    paneId: string;
+    socketPath: string;
+}
+export declare function captureHerdrEnvironment(env: NodeJS.ProcessEnv): HerdrEnvironment | undefined;
+//# sourceMappingURL=environment.d.ts.map

package/dist/extensions/herdr/environment.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"environment.d.ts","sourceRoot":"","sources":["../../../src/extensions/herdr/environment.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,gBAAgB;IAChC,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;CACnB;AAED,wBAAgB,uBAAuB,CAAC,GAAG,EAAE,MAAM,CAAC,UAAU,GAAG,gBAAgB,GAAG,SAAS,CAG5F"}

package/dist/extensions/herdr/environment.js

@@ -0,0 +1,6 @@
+export function captureHerdrEnvironment(env) {
+    if (env.HERDR_ENV !== "1" || !env.HERDR_BIN_PATH || !env.HERDR_PANE_ID || !env.HERDR_SOCKET_PATH)
+        return undefined;
+    return { bin: env.HERDR_BIN_PATH, paneId: env.HERDR_PANE_ID, socketPath: env.HERDR_SOCKET_PATH };
+}
+//# sourceMappingURL=environment.js.map

package/dist/extensions/herdr/environment.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"environment.js","sourceRoot":"","sources":["../../../src/extensions/herdr/environment.ts"],"names":[],"mappings":"AAMA,MAAM,UAAU,uBAAuB,CAAC,GAAsB;IAC7D,IAAI,GAAG,CAAC,SAAS,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,cAAc,IAAI,CAAC,GAAG,CAAC,aAAa,IAAI,CAAC,GAAG,CAAC,iBAAiB;QAAE,OAAO,SAAS,CAAC;IACnH,OAAO,EAAE,GAAG,EAAE,GAAG,CAAC,cAAc,EAAE,MAAM,EAAE,GAAG,CAAC,aAAa,EAAE,UAAU,EAAE,GAAG,CAAC,iBAAiB,EAAE,CAAC;AAClG,CAAC","sourcesContent":["export interface HerdrEnvironment {\n\tbin: string;\n\tpaneId: string;\n\tsocketPath: string;\n}\n\nexport function captureHerdrEnvironment(env: NodeJS.ProcessEnv): HerdrEnvironment | undefined {\n\tif (env.HERDR_ENV !== \"1\" || !env.HERDR_BIN_PATH || !env.HERDR_PANE_ID || !env.HERDR_SOCKET_PATH) return undefined;\n\treturn { bin: env.HERDR_BIN_PATH, paneId: env.HERDR_PANE_ID, socketPath: env.HERDR_SOCKET_PATH };\n}\n"]}

package/dist/extensions/herdr/index.d.ts

@@ -0,0 +1,9 @@
+import type { ExtensionAPI, ExtensionContext, ExtensionFactory } from "../../core/extensions/types.ts";
+import { type PaneReportingOptions } from "./pane-owner.js";
+export interface HerdrExtensionOptions extends PaneReportingOptions {
+    env?: NodeJS.ProcessEnv;
+    enabled?: (ctx: ExtensionContext) => boolean;
+}
+export declare function createHerdrExtension(options?: HerdrExtensionOptions): ExtensionFactory;
+export default function herdrExtension(pi: ExtensionAPI): void;
+//# sourceMappingURL=index.d.ts.map

package/dist/extensions/herdr/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/extensions/herdr/index.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,YAAY,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,gCAAgC,CAAC;AAMvG,OAAO,EAGN,KAAK,oBAAoB,EAIzB,MAAM,iBAAiB,CAAC;AAGzB,MAAM,WAAW,qBAAsB,SAAQ,oBAAoB;IAClE,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAC;IACxB,OAAO,CAAC,EAAE,CAAC,GAAG,EAAE,gBAAgB,KAAK,OAAO,CAAC;CAC7C;AAOD,wBAAgB,oBAAoB,CAAC,OAAO,GAAE,qBAA0B,GAAG,gBAAgB,CA2L1F;AAED,MAAM,CAAC,OAAO,UAAU,cAAc,CAAC,EAAE,EAAE,YAAY,GAAG,IAAI,CAE7D"}

package/dist/extensions/herdr/index.js

@@ -0,0 +1,225 @@
+import { getExtensionContextOwner, publishExtensionContextEffect } from "../../core/extensions/runner-context.js";
+import { SettingsManager } from "../../core/settings-manager.js";
+import { OwnerTaskStore } from "../../core/tasks/owner-store.js";
+import { deriveSessionActivity } from "./activity.js";
+import { captureHerdrEnvironment } from "./environment.js";
+import { claimPaneReporting, releasePaneReporting, reportPaneActivity, retirePaneReporting, } from "./pane-owner.js";
+function enabled(ctx) {
+    const settings = SettingsManager.create(ctx.cwd, undefined, { projectTrusted: ctx.isProjectTrusted() });
+    return (settings.getProjectSettings().herdr?.enabled ?? settings.getGlobalSettings().herdr?.enabled) !== false;
+}
+export function createHerdrExtension(options = {}) {
+    return (pi) => {
+        if (!captureHerdrEnvironment(options.env ?? process.env))
+            return;
+        let owner;
+        // Supplied loaders can share closures across sessions and overlapping reload runners.
+        let boundSessionManager;
+        let boundRunner;
+        const retiredRunners = new WeakSet();
+        const ownsBinding = (ctx) => boundSessionManager !== undefined && getExtensionContextOwner(ctx) === boundRunner;
+        let lease;
+        let taskStore;
+        let unsubscribeTasks;
+        let agentRunning = false;
+        let openPromptCount = 0;
+        let availability = "unavailable";
+        const roots = new Map();
+        const acknowledgedBlocks = new Map();
+        const updateRoot = (root) => {
+            const acknowledged = acknowledgedBlocks.get(root.rootRunId);
+            if (acknowledged &&
+                (root.state !== acknowledged.state ||
+                    root.reason !== acknowledged.reason ||
+                    root.actionableBlockCount !== acknowledged.actionableBlockCount ||
+                    root.activeExecutionCount !== acknowledged.activeExecutionCount ||
+                    root.needsAttention !== acknowledged.needsAttention))
+                acknowledgedBlocks.delete(root.rootRunId);
+            roots.set(root.rootRunId, root);
+        };
+        const seenDiagnostics = new Set();
+        let generation = 0;
+        const diagnostic = (value) => {
+            const key = `${value.kind}:${value.owner ?? ""}`;
+            if (seenDiagnostics.has(key))
+                return;
+            seenDiagnostics.add(key);
+            if (options.diagnostic)
+                options.diagnostic(value);
+            else
+                console.error(`[Herdr] ${value.kind}${value.owner ? `: deferring to ${value.owner}` : ""}`);
+        };
+        const tasksRunning = () => taskStore?.tasks.some((task) => task.execution.kind !== "settled") ?? false;
+        const report = () => {
+            if (!owner)
+                return;
+            const activity = deriveSessionActivity({
+                agentRunning,
+                tasksRunning: tasksRunning(),
+                openPromptCount,
+                roots: [...roots.values()].filter((root) => !acknowledgedBlocks.has(root.rootRunId)),
+                availability,
+            });
+            if (activity)
+                reportPaneActivity(owner, activity);
+        };
+        const start = async (ctx) => {
+            const runner = getExtensionContextOwner(ctx);
+            if (retiredRunners.has(runner))
+                return;
+            if (boundSessionManager && ctx.sessionManager !== boundSessionManager)
+                return;
+            const environment = captureHerdrEnvironment(options.env ?? process.env);
+            if (!environment || ctx.mode !== "tui" || !ctx.hasUI || ctx.subagentPolicy || ctx.orchestrationContext)
+                return;
+            if (!(options.enabled ?? enabled)(ctx))
+                return;
+            const conflict = ctx
+                .getExtensionPaths?.()
+                .find((path) => /herdr-atomic-reporter|herdr-agent-state/.test(path));
+            if (conflict) {
+                diagnostic({ kind: "unsupported", owner: conflict });
+                return;
+            }
+            if (boundRunner && boundRunner !== runner)
+                retiredRunners.add(boundRunner);
+            boundRunner = runner;
+            boundSessionManager = ctx.sessionManager;
+            const current = ++generation;
+            lease?.dispose();
+            lease = undefined;
+            unsubscribeTasks?.();
+            taskStore?.dispose();
+            unsubscribeTasks = undefined;
+            taskStore = undefined;
+            openPromptCount = 0;
+            roots.clear();
+            acknowledgedBlocks.clear();
+            availability = "unavailable";
+            const claimed = await claimPaneReporting(environment, { id: ctx.sessionManager.getSessionId(), path: ctx.sessionManager.getSessionFile() }, { ...options, diagnostic });
+            if (current !== generation) {
+                await releasePaneReporting(claimed);
+                return;
+            }
+            owner = claimed;
+            agentRunning = !ctx.isIdle();
+            const taskHost = ctx.getAgentTaskHost?.();
+            if (taskHost) {
+                const { supervisor, owner: taskOwner } = taskHost.ownerBinding;
+                taskStore = new OwnerTaskStore(supervisor, taskOwner);
+                taskStore.connect();
+                let running = tasksRunning();
+                unsubscribeTasks = taskStore.subscribe(() => {
+                    if (current !== generation)
+                        return;
+                    const next = tasksRunning();
+                    if (next === running)
+                        return;
+                    running = next;
+                    report();
+                });
+            }
+            lease = ctx.observeWorkflowActivity((frame) => {
+                if (current !== generation)
+                    return;
+                if (frame.kind === "snapshot") {
+                    availability = frame.availability;
+                    roots.clear();
+                    if (frame.availability === "ready") {
+                        for (const root of frame.roots)
+                            updateRoot(root);
+                        for (const id of acknowledgedBlocks.keys())
+                            if (!roots.has(id))
+                                acknowledgedBlocks.delete(id);
+                    }
+                }
+                else if (frame.kind === "changed")
+                    updateRoot(frame.root);
+                else {
+                    roots.delete(frame.rootRunId);
+                    acknowledgedBlocks.delete(frame.rootRunId);
+                }
+                report();
+            });
+        };
+        pi.on("session_start", (_event, ctx) => publishExtensionContextEffect(ctx, () => start(ctx)));
+        pi.on("input", (event, ctx) => {
+            if (!ownsBinding(ctx) || event.source !== "interactive")
+                return;
+            let changed = false;
+            for (const root of roots.values()) {
+                if (root.state === "blocked" && !acknowledgedBlocks.has(root.rootRunId)) {
+                    acknowledgedBlocks.set(root.rootRunId, { ...root });
+                    changed = true;
+                }
+            }
+            if (changed)
+                report();
+        });
+        pi.on("workflow_lifecycle", (event, ctx) => {
+            if (!ownsBinding(ctx) || event.delivery !== "live")
+                return;
+            const target = event.target;
+            const newBlock = target.kind === "prompt"
+                ? target.status === "opened"
+                : (target.kind === "run" || target.kind === "stage") &&
+                    (target.status === "blocked" || target.status === "awaiting_input") &&
+                    target.previousStatus !== target.status;
+            if (newBlock && acknowledgedBlocks.delete(event.rootRunId))
+                report();
+        });
+        pi.on("agent_start", (_event, ctx) => {
+            if (!ownsBinding(ctx))
+                return;
+            agentRunning = true;
+            report();
+        });
+        pi.on("agent_settled", (_event, ctx) => {
+            if (!ownsBinding(ctx))
+                return;
+            agentRunning = false;
+            report();
+        });
+        pi.on("ui_prompt_start", (_event, ctx) => {
+            if (!ownsBinding(ctx))
+                return;
+            openPromptCount++;
+            report();
+        });
+        pi.on("ui_prompt_end", (_event, ctx) => {
+            if (!ownsBinding(ctx))
+                return;
+            openPromptCount = Math.max(0, openPromptCount - 1);
+            report();
+        });
+        pi.on("session_shutdown", async (event, ctx) => {
+            if (!ownsBinding(ctx))
+                return;
+            // A non-quit stop may restart this runner, unless a successor supersedes it first.
+            if (event.reason === "quit")
+                retiredRunners.add(boundRunner);
+            generation++;
+            lease?.dispose();
+            lease = undefined;
+            unsubscribeTasks?.();
+            taskStore?.dispose();
+            unsubscribeTasks = undefined;
+            taskStore = undefined;
+            const previous = owner;
+            owner = undefined;
+            // Clear before awaiting transport: a successor can bind while retirement drains,
+            // and this shutdown's completion must never clear that newer binding.
+            boundSessionManager = undefined;
+            if (previous) {
+                if (event.reason === "quit")
+                    await releasePaneReporting(previous);
+                else
+                    await retirePaneReporting(previous);
+            }
+        });
+    };
+}
+export default function herdrExtension(pi) {
+    createHerdrExtension()(pi);
+}
+//# sourceMappingURL=index.js.map

package/dist/extensions/herdr/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/extensions/herdr/index.ts"],"names":[],"mappings":"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","sourcesContent":["import { getExtensionContextOwner, publishExtensionContextEffect } from \"../../core/extensions/runner-context.ts\";\nimport type { ExtensionAPI, ExtensionContext, ExtensionFactory } from \"../../core/extensions/types.ts\";\nimport type { WorkflowRootActivity } from \"../../core/extensions/workflow-events.js\";\nimport { SettingsManager } from \"../../core/settings-manager.ts\";\nimport { OwnerTaskStore } from \"../../core/tasks/owner-store.js\";\nimport { deriveSessionActivity } from \"./activity.js\";\nimport { captureHerdrEnvironment } from \"./environment.js\";\nimport {\n\tclaimPaneReporting,\n\ttype PaneOwner,\n\ttype PaneReportingOptions,\n\treleasePaneReporting,\n\treportPaneActivity,\n\tretirePaneReporting,\n} from \"./pane-owner.js\";\nimport type { HerdrDiagnostic } from \"./transport.js\";\n\nexport interface HerdrExtensionOptions extends PaneReportingOptions {\n\tenv?: NodeJS.ProcessEnv;\n\tenabled?: (ctx: ExtensionContext) => boolean;\n}\n\nfunction enabled(ctx: ExtensionContext): boolean {\n\tconst settings = SettingsManager.create(ctx.cwd, undefined, { projectTrusted: ctx.isProjectTrusted() });\n\treturn (settings.getProjectSettings().herdr?.enabled ?? settings.getGlobalSettings().herdr?.enabled) !== false;\n}\n\nexport function createHerdrExtension(options: HerdrExtensionOptions = {}): ExtensionFactory {\n\treturn (pi) => {\n\t\tif (!captureHerdrEnvironment(options.env ?? process.env)) return;\n\t\tlet owner: PaneOwner | undefined;\n\t\t// Supplied loaders can share closures across sessions and overlapping reload runners.\n\t\tlet boundSessionManager: ExtensionContext[\"sessionManager\"] | undefined;\n\t\tlet boundRunner: object | undefined;\n\t\tconst retiredRunners = new WeakSet<object>();\n\t\tconst ownsBinding = (ctx: ExtensionContext) =>\n\t\t\tboundSessionManager !== undefined && getExtensionContextOwner(ctx) === boundRunner;\n\t\tlet lease: { dispose(): void } | undefined;\n\t\tlet taskStore: OwnerTaskStore | undefined;\n\t\tlet unsubscribeTasks: (() => void) | undefined;\n\t\tlet agentRunning = false;\n\t\tlet openPromptCount = 0;\n\t\tlet availability: \"ready\" | \"unavailable\" | \"recovering\" = \"unavailable\";\n\t\tconst roots = new Map<string, WorkflowRootActivity>();\n\t\tconst acknowledgedBlocks = new Map<string, WorkflowRootActivity>();\n\t\tconst updateRoot = (root: WorkflowRootActivity) => {\n\t\t\tconst acknowledged = acknowledgedBlocks.get(root.rootRunId);\n\t\t\tif (\n\t\t\t\tacknowledged &&\n\t\t\t\t(root.state !== acknowledged.state ||\n\t\t\t\t\troot.reason !== acknowledged.reason ||\n\t\t\t\t\troot.actionableBlockCount !== acknowledged.actionableBlockCount ||\n\t\t\t\t\troot.activeExecutionCount !== acknowledged.activeExecutionCount ||\n\t\t\t\t\troot.needsAttention !== acknowledged.needsAttention)\n\t\t\t)\n\t\t\t\tacknowledgedBlocks.delete(root.rootRunId);\n\t\t\troots.set(root.rootRunId, root);\n\t\t};\n\t\tconst seenDiagnostics = new Set<string>();\n\t\tlet generation = 0;\n\t\tconst diagnostic = (value: HerdrDiagnostic) => {\n\t\t\tconst key = `${value.kind}:${value.owner ?? \"\"}`;\n\t\t\tif (seenDiagnostics.has(key)) return;\n\t\t\tseenDiagnostics.add(key);\n\t\t\tif (options.diagnostic) options.diagnostic(value);\n\t\t\telse console.error(`[Herdr] ${value.kind}${value.owner ? `: deferring to ${value.owner}` : \"\"}`);\n\t\t};\n\t\tconst tasksRunning = () => taskStore?.tasks.some((task) => task.execution.kind !== \"settled\") ?? false;\n\t\tconst report = () => {\n\t\t\tif (!owner) return;\n\t\t\tconst activity = deriveSessionActivity({\n\t\t\t\tagentRunning,\n\t\t\t\ttasksRunning: tasksRunning(),\n\t\t\t\topenPromptCount,\n\t\t\t\troots: [...roots.values()].filter((root) => !acknowledgedBlocks.has(root.rootRunId)),\n\t\t\t\tavailability,\n\t\t\t});\n\t\t\tif (activity) reportPaneActivity(owner, activity);\n\t\t};\n\t\tconst start = async (ctx: ExtensionContext) => {\n\t\t\tconst runner = getExtensionContextOwner(ctx);\n\t\t\tif (retiredRunners.has(runner)) return;\n\t\t\tif (boundSessionManager && ctx.sessionManager !== boundSessionManager) return;\n\t\t\tconst environment = captureHerdrEnvironment(options.env ?? process.env);\n\t\t\tif (!environment || ctx.mode !== \"tui\" || !ctx.hasUI || ctx.subagentPolicy || ctx.orchestrationContext) return;\n\t\t\tif (!(options.enabled ?? enabled)(ctx)) return;\n\t\t\tconst conflict = ctx\n\t\t\t\t.getExtensionPaths?.()\n\t\t\t\t.find((path) => /herdr-atomic-reporter|herdr-agent-state/.test(path));\n\t\t\tif (conflict) {\n\t\t\t\tdiagnostic({ kind: \"unsupported\", owner: conflict });\n\t\t\t\treturn;\n\t\t\t}\n\t\t\tif (boundRunner && boundRunner !== runner) retiredRunners.add(boundRunner);\n\t\t\tboundRunner = runner;\n\t\t\tboundSessionManager = ctx.sessionManager;\n\t\t\tconst current = ++generation;\n\t\t\tlease?.dispose();\n\t\t\tlease = undefined;\n\t\t\tunsubscribeTasks?.();\n\t\t\ttaskStore?.dispose();\n\t\t\tunsubscribeTasks = undefined;\n\t\t\ttaskStore = undefined;\n\t\t\topenPromptCount = 0;\n\t\t\troots.clear();\n\t\t\tacknowledgedBlocks.clear();\n\t\t\tavailability = \"unavailable\";\n\t\t\tconst claimed = await claimPaneReporting(\n\t\t\t\tenvironment,\n\t\t\t\t{ id: ctx.sessionManager.getSessionId(), path: ctx.sessionManager.getSessionFile() },\n\t\t\t\t{ ...options, diagnostic },\n\t\t\t);\n\t\t\tif (current !== generation) {\n\t\t\t\tawait releasePaneReporting(claimed);\n\t\t\t\treturn;\n\t\t\t}\n\t\t\towner = claimed;\n\t\t\tagentRunning = !ctx.isIdle();\n\t\t\tconst taskHost = ctx.getAgentTaskHost?.();\n\t\t\tif (taskHost) {\n\t\t\t\tconst { supervisor, owner: taskOwner } = taskHost.ownerBinding;\n\t\t\t\ttaskStore = new OwnerTaskStore(supervisor, taskOwner);\n\t\t\t\ttaskStore.connect();\n\t\t\t\tlet running = tasksRunning();\n\t\t\t\tunsubscribeTasks = taskStore.subscribe(() => {\n\t\t\t\t\tif (current !== generation) return;\n\t\t\t\t\tconst next = tasksRunning();\n\t\t\t\t\tif (next === running) return;\n\t\t\t\t\trunning = next;\n\t\t\t\t\treport();\n\t\t\t\t});\n\t\t\t}\n\t\t\tlease = ctx.observeWorkflowActivity((frame) => {\n\t\t\t\tif (current !== generation) return;\n\t\t\t\tif (frame.kind === \"snapshot\") {\n\t\t\t\t\tavailability = frame.availability;\n\t\t\t\t\troots.clear();\n\t\t\t\t\tif (frame.availability === \"ready\") {\n\t\t\t\t\t\tfor (const root of frame.roots) updateRoot(root);\n\t\t\t\t\t\tfor (const id of acknowledgedBlocks.keys()) if (!roots.has(id)) acknowledgedBlocks.delete(id);\n\t\t\t\t\t}\n\t\t\t\t} else if (frame.kind === \"changed\") updateRoot(frame.root);\n\t\t\t\telse {\n\t\t\t\t\troots.delete(frame.rootRunId);\n\t\t\t\t\tacknowledgedBlocks.delete(frame.rootRunId);\n\t\t\t\t}\n\t\t\t\treport();\n\t\t\t});\n\t\t};\n\t\tpi.on(\"session_start\", (_event, ctx) => publishExtensionContextEffect(ctx, () => start(ctx)));\n\t\tpi.on(\"input\", (event, ctx) => {\n\t\t\tif (!ownsBinding(ctx) || event.source !== \"interactive\") return;\n\t\t\tlet changed = false;\n\t\t\tfor (const root of roots.values()) {\n\t\t\t\tif (root.state === \"blocked\" && !acknowledgedBlocks.has(root.rootRunId)) {\n\t\t\t\t\tacknowledgedBlocks.set(root.rootRunId, { ...root });\n\t\t\t\t\tchanged = true;\n\t\t\t\t}\n\t\t\t}\n\t\t\tif (changed) report();\n\t\t});\n\t\tpi.on(\"workflow_lifecycle\", (event, ctx) => {\n\t\t\tif (!ownsBinding(ctx) || event.delivery !== \"live\") return;\n\t\t\tconst target = event.target;\n\t\t\tconst newBlock =\n\t\t\t\ttarget.kind === \"prompt\"\n\t\t\t\t\t? target.status === \"opened\"\n\t\t\t\t\t: (target.kind === \"run\" || target.kind === \"stage\") &&\n\t\t\t\t\t\t(target.status === \"blocked\" || target.status === \"awaiting_input\") &&\n\t\t\t\t\t\ttarget.previousStatus !== target.status;\n\t\t\tif (newBlock && acknowledgedBlocks.delete(event.rootRunId)) report();\n\t\t});\n\t\tpi.on(\"agent_start\", (_event, ctx) => {\n\t\t\tif (!ownsBinding(ctx)) return;\n\t\t\tagentRunning = true;\n\t\t\treport();\n\t\t});\n\t\tpi.on(\"agent_settled\", (_event, ctx) => {\n\t\t\tif (!ownsBinding(ctx)) return;\n\t\t\tagentRunning = false;\n\t\t\treport();\n\t\t});\n\t\tpi.on(\"ui_prompt_start\", (_event, ctx) => {\n\t\t\tif (!ownsBinding(ctx)) return;\n\t\t\topenPromptCount++;\n\t\t\treport();\n\t\t});\n\t\tpi.on(\"ui_prompt_end\", (_event, ctx) => {\n\t\t\tif (!ownsBinding(ctx)) return;\n\t\t\topenPromptCount = Math.max(0, openPromptCount - 1);\n\t\t\treport();\n\t\t});\n\t\tpi.on(\"session_shutdown\", async (event, ctx) => {\n\t\t\tif (!ownsBinding(ctx)) return;\n\t\t\t// A non-quit stop may restart this runner, unless a successor supersedes it first.\n\t\t\tif (event.reason === \"quit\") retiredRunners.add(boundRunner!);\n\t\t\tgeneration++;\n\t\t\tlease?.dispose();\n\t\t\tlease = undefined;\n\t\t\tunsubscribeTasks?.();\n\t\t\ttaskStore?.dispose();\n\t\t\tunsubscribeTasks = undefined;\n\t\t\ttaskStore = undefined;\n\t\t\tconst previous = owner;\n\t\t\towner = undefined;\n\t\t\t// Clear before awaiting transport: a successor can bind while retirement drains,\n\t\t\t// and this shutdown's completion must never clear that newer binding.\n\t\t\tboundSessionManager = undefined;\n\t\t\tif (previous) {\n\t\t\t\tif (event.reason === \"quit\") await releasePaneReporting(previous);\n\t\t\t\telse await retirePaneReporting(previous);\n\t\t\t}\n\t\t});\n\t};\n}\n\nexport default function herdrExtension(pi: ExtensionAPI): void {\n\tcreateHerdrExtension()(pi);\n}\n"]}

package/dist/extensions/herdr/pane-owner.d.ts

@@ -0,0 +1,30 @@
+import type { SessionActivity } from "./activity.js";
+import type { HerdrEnvironment } from "./environment.js";
+import { type HerdrDiagnostic } from "./transport.js";
+export interface PaneIdentity {
+    id: string;
+    path?: string;
+}
+export interface PaneReportingOptions {
+    clock?: () => number;
+    timeoutMs?: number;
+    diagnostic?: (diagnostic: HerdrDiagnostic) => void;
+}
+export interface PaneOwner {
+    environment: HerdrEnvironment;
+    identity: PaneIdentity;
+    options: PaneReportingOptions;
+    status: "active" | "releasing" | "retired";
+    seq: number;
+    identitySent: boolean;
+    pending?: SessionActivity;
+    flight?: Promise<void>;
+    release?: Promise<void>;
+    flush(): Promise<void>;
+}
+export declare function claimPaneReporting(environment: HerdrEnvironment, identity: PaneIdentity, options?: PaneReportingOptions): Promise<PaneOwner>;
+export declare function reportPaneActivity(owner: PaneOwner, activity: SessionActivity): void;
+/** Fence and drain a local reporter without unregistering the still-running agent. */
+export declare function retirePaneReporting(owner: PaneOwner): Promise<void>;
+export declare function releasePaneReporting(owner: PaneOwner): Promise<void>;
+//# sourceMappingURL=pane-owner.d.ts.map

package/dist/extensions/herdr/pane-owner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pane-owner.d.ts","sourceRoot":"","sources":["../../../src/extensions/herdr/pane-owner.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AACrD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AACzD,OAAO,EAAgB,KAAK,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAEpE,MAAM,WAAW,YAAY;IAC5B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,CAAC,EAAE,MAAM,CAAC;CACd;AACD,MAAM,WAAW,oBAAoB;IACpC,KAAK,CAAC,EAAE,MAAM,MAAM,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,CAAC,UAAU,EAAE,eAAe,KAAK,IAAI,CAAC;CACnD;AACD,MAAM,WAAW,SAAS;IACzB,WAAW,EAAE,gBAAgB,CAAC;IAC9B,QAAQ,EAAE,YAAY,CAAC;IACvB,OAAO,EAAE,oBAAoB,CAAC;IAC9B,MAAM,EAAE,QAAQ,GAAG,WAAW,GAAG,SAAS,CAAC;IAC3C,GAAG,EAAE,MAAM,CAAC;IACZ,YAAY,EAAE,OAAO,CAAC;IACtB,OAAO,CAAC,EAAE,eAAe,CAAC;IAC1B,MAAM,CAAC,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC;IACvB,OAAO,CAAC,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC;IACxB,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACvB;AAmCD,wBAAsB,kBAAkB,CACvC,WAAW,EAAE,gBAAgB,EAC7B,QAAQ,EAAE,YAAY,EACtB,OAAO,GAAE,oBAAyB,GAChC,OAAO,CAAC,SAAS,CAAC,CAoBpB;AAED,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,SAAS,EAAE,QAAQ,EAAE,eAAe,GAAG,IAAI,CAwBpF;AAED,sFAAsF;AACtF,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC,CAEnE;AAED,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC,CAEpE"}

package/dist/extensions/herdr/pane-owner.js

@@ -0,0 +1,111 @@
+import { isAbsolute } from "node:path";
+import { executeHerdr } from "./transport.js";
+// Host module lifetime outlives inline extension factories and runner generations.
+const owners = new Map();
+let highWater = 0;
+function diagnostic(owner, value) {
+    owner.options.diagnostic?.(value);
+}
+/** Every admitted command, including release, takes a fresh strictly increasing sequence: Herdr ignores equal or older `--seq`. */
+function allocateSequence(owner) {
+    owner.seq = highWater = Math.max((owner.options.clock ?? Date.now)(), highWater + 1);
+}
+function argv(owner, command) {
+    return [
+        "pane",
+        command,
+        owner.environment.paneId,
+        "--source",
+        "custom:atomic",
+        "--agent",
+        "atomic",
+        "--seq",
+        String(owner.seq),
+    ];
+}
+async function send(owner, args) {
+    const result = await executeHerdr(owner.environment, args, owner.options.timeoutMs);
+    if (result)
+        diagnostic(owner, result);
+    return result === undefined;
+}
+export async function claimPaneReporting(environment, identity, options = {}) {
+    let previous;
+    do {
+        previous = owners.get(environment.paneId);
+        if (previous)
+            await retirePaneReporting(previous);
+    } while (owners.get(environment.paneId) !== previous);
+    const owner = {
+        environment,
+        identity,
+        options,
+        status: "active",
+        // Inherit the registration even if recovery produces no successor report before quit.
+        seq: previous?.seq ?? 0,
+        identitySent: false,
+        async flush() {
+            await this.flight;
+        },
+    };
+    owners.set(environment.paneId, owner);
+    return owner;
+}
+export function reportPaneActivity(owner, activity) {
+    if (owner.status !== "active" || owners.get(owner.environment.paneId) !== owner) {
+        diagnostic(owner, { kind: "stale_owner" });
+        return;
+    }
+    owner.pending = activity;
+    if (owner.flight)
+        return;
+    owner.flight = (async () => {
+        while (owner.pending && owner.status === "active") {
+            const next = owner.pending;
+            owner.pending = undefined;
+            allocateSequence(owner);
+            const args = [...argv(owner, "report-agent"), "--state", next.state];
+            if (next.message)
+                args.push("--message", next.message);
+            if (!owner.identitySent) {
+                args.push("--agent-session-id", owner.identity.id);
+                if (owner.identity.path && isAbsolute(owner.identity.path))
+                    args.push("--agent-session-path", owner.identity.path);
+            }
+            if (await send(owner, args))
+                owner.identitySent = true;
+        }
+    })().finally(() => {
+        owner.flight = undefined;
+    });
+}
+/** Fence and drain a local reporter without unregistering the still-running agent. */
+export function retirePaneReporting(owner) {
+    return stopPaneReporting(owner, false);
+}
+export function releasePaneReporting(owner) {
+    return stopPaneReporting(owner, true);
+}
+function stopPaneReporting(owner, releaseRegistration) {
+    if (owner.release)
+        return owner.release;
+    if (owners.get(owner.environment.paneId) !== owner || owner.status !== "active") {
+        diagnostic(owner, { kind: "stale_owner" });
+        return Promise.resolve();
+    }
+    owner.status = "releasing";
+    owner.pending = undefined;
+    owner.release = (async () => {
+        await owner.flight;
+        // A failed command may still have claimed authority before its response was lost.
+        if (releaseRegistration && owner.seq > 0) {
+            allocateSequence(owner);
+            await send(owner, argv(owner, "release-agent"));
+        }
+        owner.status = "retired";
+        if (releaseRegistration && owners.get(owner.environment.paneId) === owner)
+            owners.delete(owner.environment.paneId);
+    })();
+    return owner.release;
+}
+//# sourceMappingURL=pane-owner.js.map

package/dist/extensions/herdr/pane-owner.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pane-owner.js","sourceRoot":"","sources":["../../../src/extensions/herdr/pane-owner.ts"],"names":[],"mappings":"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","sourcesContent":["import { isAbsolute } from \"node:path\";\nimport type { SessionActivity } from \"./activity.js\";\nimport type { HerdrEnvironment } from \"./environment.js\";\nimport { executeHerdr, type HerdrDiagnostic } from \"./transport.js\";\n\nexport interface PaneIdentity {\n\tid: string;\n\tpath?: string;\n}\nexport interface PaneReportingOptions {\n\tclock?: () => number;\n\ttimeoutMs?: number;\n\tdiagnostic?: (diagnostic: HerdrDiagnostic) => void;\n}\nexport interface PaneOwner {\n\tenvironment: HerdrEnvironment;\n\tidentity: PaneIdentity;\n\toptions: PaneReportingOptions;\n\tstatus: \"active\" | \"releasing\" | \"retired\";\n\tseq: number;\n\tidentitySent: boolean;\n\tpending?: SessionActivity;\n\tflight?: Promise<void>;\n\trelease?: Promise<void>;\n\tflush(): Promise<void>;\n}\n\n// Host module lifetime outlives inline extension factories and runner generations.\nconst owners = new Map<string, PaneOwner>();\nlet highWater = 0;\n\nfunction diagnostic(owner: PaneOwner, value: HerdrDiagnostic): void {\n\towner.options.diagnostic?.(value);\n}\n\n/** Every admitted command, including release, takes a fresh strictly increasing sequence: Herdr ignores equal or older `--seq`. */\nfunction allocateSequence(owner: PaneOwner): void {\n\towner.seq = highWater = Math.max((owner.options.clock ?? Date.now)(), highWater + 1);\n}\n\nfunction argv(owner: PaneOwner, command: string): string[] {\n\treturn [\n\t\t\"pane\",\n\t\tcommand,\n\t\towner.environment.paneId,\n\t\t\"--source\",\n\t\t\"custom:atomic\",\n\t\t\"--agent\",\n\t\t\"atomic\",\n\t\t\"--seq\",\n\t\tString(owner.seq),\n\t];\n}\n\nasync function send(owner: PaneOwner, args: string[]): Promise<boolean> {\n\tconst result = await executeHerdr(owner.environment, args, owner.options.timeoutMs);\n\tif (result) diagnostic(owner, result);\n\treturn result === undefined;\n}\n\nexport async function claimPaneReporting(\n\tenvironment: HerdrEnvironment,\n\tidentity: PaneIdentity,\n\toptions: PaneReportingOptions = {},\n): Promise<PaneOwner> {\n\tlet previous: PaneOwner | undefined;\n\tdo {\n\t\tprevious = owners.get(environment.paneId);\n\t\tif (previous) await retirePaneReporting(previous);\n\t} while (owners.get(environment.paneId) !== previous);\n\tconst owner: PaneOwner = {\n\t\tenvironment,\n\t\tidentity,\n\t\toptions,\n\t\tstatus: \"active\",\n\t\t// Inherit the registration even if recovery produces no successor report before quit.\n\t\tseq: previous?.seq ?? 0,\n\t\tidentitySent: false,\n\t\tasync flush() {\n\t\t\tawait this.flight;\n\t\t},\n\t};\n\towners.set(environment.paneId, owner);\n\treturn owner;\n}\n\nexport function reportPaneActivity(owner: PaneOwner, activity: SessionActivity): void {\n\tif (owner.status !== \"active\" || owners.get(owner.environment.paneId) !== owner) {\n\t\tdiagnostic(owner, { kind: \"stale_owner\" });\n\t\treturn;\n\t}\n\towner.pending = activity;\n\tif (owner.flight) return;\n\towner.flight = (async () => {\n\t\twhile (owner.pending && owner.status === \"active\") {\n\t\t\tconst next = owner.pending;\n\t\t\towner.pending = undefined;\n\t\t\tallocateSequence(owner);\n\t\t\tconst args = [...argv(owner, \"report-agent\"), \"--state\", next.state];\n\t\t\tif (next.message) args.push(\"--message\", next.message);\n\t\t\tif (!owner.identitySent) {\n\t\t\t\targs.push(\"--agent-session-id\", owner.identity.id);\n\t\t\t\tif (owner.identity.path && isAbsolute(owner.identity.path))\n\t\t\t\t\targs.push(\"--agent-session-path\", owner.identity.path);\n\t\t\t}\n\t\t\tif (await send(owner, args)) owner.identitySent = true;\n\t\t}\n\t})().finally(() => {\n\t\towner.flight = undefined;\n\t});\n}\n\n/** Fence and drain a local reporter without unregistering the still-running agent. */\nexport function retirePaneReporting(owner: PaneOwner): Promise<void> {\n\treturn stopPaneReporting(owner, false);\n}\n\nexport function releasePaneReporting(owner: PaneOwner): Promise<void> {\n\treturn stopPaneReporting(owner, true);\n}\n\nfunction stopPaneReporting(owner: PaneOwner, releaseRegistration: boolean): Promise<void> {\n\tif (owner.release) return owner.release;\n\tif (owners.get(owner.environment.paneId) !== owner || owner.status !== \"active\") {\n\t\tdiagnostic(owner, { kind: \"stale_owner\" });\n\t\treturn Promise.resolve();\n\t}\n\towner.status = \"releasing\";\n\towner.pending = undefined;\n\towner.release = (async () => {\n\t\tawait owner.flight;\n\t\t// A failed command may still have claimed authority before its response was lost.\n\t\tif (releaseRegistration && owner.seq > 0) {\n\t\t\tallocateSequence(owner);\n\t\t\tawait send(owner, argv(owner, \"release-agent\"));\n\t\t}\n\t\towner.status = \"retired\";\n\t\tif (releaseRegistration && owners.get(owner.environment.paneId) === owner)\n\t\t\towners.delete(owner.environment.paneId);\n\t})();\n\treturn owner.release;\n}\n"]}

package/dist/extensions/herdr/transport.d.ts

@@ -0,0 +1,8 @@
+import type { HerdrEnvironment } from "./environment.js";
+export interface HerdrDiagnostic {
+    kind: "spawn_failed" | "timeout" | "protocol_rejected" | "stale_owner" | "unsupported";
+    owner?: string;
+}
+export declare const HERDR_TIMEOUT_MS = 5000;
+export declare function executeHerdr(environment: HerdrEnvironment, argv: string[], timeoutMs?: number): Promise<HerdrDiagnostic | undefined>;
+//# sourceMappingURL=transport.d.ts.map

package/dist/extensions/herdr/transport.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transport.d.ts","sourceRoot":"","sources":["../../../src/extensions/herdr/transport.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AAEzD,MAAM,WAAW,eAAe;IAC/B,IAAI,EAAE,cAAc,GAAG,SAAS,GAAG,mBAAmB,GAAG,aAAa,GAAG,aAAa,CAAC;IACvF,KAAK,CAAC,EAAE,MAAM,CAAC;CACf;AAED,eAAO,MAAM,gBAAgB,OAAQ,CAAC;AAEtC,wBAAgB,YAAY,CAC3B,WAAW,EAAE,gBAAgB,EAC7B,IAAI,EAAE,MAAM,EAAE,EACd,SAAS,SAAmB,GAC1B,OAAO,CAAC,eAAe,GAAG,SAAS,CAAC,CAyBtC"}