@caupulican/pi-adaptative 0.86.2 → 0.86.5

package/dist/core/delegation/worker-delegation-request.d.ts

@@ -36,6 +36,8 @@ export interface WorkerDelegationRequest {
     instructions: string;
     profileId?: string;
     authority?: WorkerDelegationAuthorityRequest;
+    /** Tool-facing immutable birth-context selection for a newly admitted logical worker. */
+    forkTurns?: string;
     /** Runtime-owned creator identity for recursive delegation; never accepted from a model argument. */
     parentAgentId?: string;
     /** Runtime-owned correlation for an automatically dispatched verifier; never model-settable. */

package/dist/core/delegation/worker-delegation-request.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"worker-delegation-request.d.ts","sourceRoot":"","sources":["../../../src/core/delegation/worker-delegation-request.ts"],"names":[],"mappings":"AACA,OAAO,EACN,KAAK,iBAAiB,EAOtB,KAAK,0BAA0B,EAC/B,KAAK,UAAU,EAEf,KAAK,UAAU,EACf,MAAM,+BAA+B,CAAC;AAIvC,oGAAoG;AACpG,MAAM,WAAW,2BAA2B;IAC3C,cAAc,EAAE,SAAS,MAAM,EAAE,CAAC;IAClC,gBAAgB,EAAE,SAAS,MAAM,EAAE,CAAC;IACpC,sBAAsB,EAAE,SAAS,MAAM,EAAE,CAAC;IAC1C;;;;OAIG;IACH,kBAAkB,EAAE,SAAS,MAAM,EAAE,CAAC;CACtC;AAED,MAAM,WAAW,4BAA4B;IAC5C,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;CAChB;AAED,gGAAgG;AAChG,MAAM,WAAW,gCAAgC;IAChD,IAAI,CAAC,EAAE,UAAU,CAAC;IAClB,KAAK,CAAC,EAAE,4BAA4B,CAAC;IACrC,aAAa,CAAC,EAAE,0BAA0B,CAAC;IAC3C,YAAY,CAAC,EAAE,SAAS,iBAAiB,EAAE,CAAC;IAC5C,SAAS,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAC9B,SAAS,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAC9B,UAAU,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAC/B,MAAM,CAAC,EAAE,UAAU,CAAC;CACpB;AAED,qBAAa,4BAA6B,SAAQ,KAAK;IACtD,YAAY,OAAO,EAAE,MAAM,EAG1B;CACD;AAYD,6FAA6F;AAC7F,wBAAgB,qCAAqC,CAAC,KAAK,EAAE,OAAO,GAAG,gCAAgC,CA4EtG;AAED,wFAAwF;AACxF,MAAM,WAAW,uBAAuB;IACvC,YAAY,EAAE,MAAM,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,gCAAgC,CAAC;IAC7C,qGAAqG;IACrG,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,gGAAgG;IAChG,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B,iGAAiG;IACjG,WAAW,CAAC,EAAE,2BAA2B,CAAC;CAC1C"}
+{"version":3,"file":"worker-delegation-request.d.ts","sourceRoot":"","sources":["../../../src/core/delegation/worker-delegation-request.ts"],"names":[],"mappings":"AACA,OAAO,EACN,KAAK,iBAAiB,EAOtB,KAAK,0BAA0B,EAC/B,KAAK,UAAU,EAEf,KAAK,UAAU,EACf,MAAM,+BAA+B,CAAC;AAIvC,oGAAoG;AACpG,MAAM,WAAW,2BAA2B;IAC3C,cAAc,EAAE,SAAS,MAAM,EAAE,CAAC;IAClC,gBAAgB,EAAE,SAAS,MAAM,EAAE,CAAC;IACpC,sBAAsB,EAAE,SAAS,MAAM,EAAE,CAAC;IAC1C;;;;OAIG;IACH,kBAAkB,EAAE,SAAS,MAAM,EAAE,CAAC;CACtC;AAED,MAAM,WAAW,4BAA4B;IAC5C,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;CAChB;AAED,gGAAgG;AAChG,MAAM,WAAW,gCAAgC;IAChD,IAAI,CAAC,EAAE,UAAU,CAAC;IAClB,KAAK,CAAC,EAAE,4BAA4B,CAAC;IACrC,aAAa,CAAC,EAAE,0BAA0B,CAAC;IAC3C,YAAY,CAAC,EAAE,SAAS,iBAAiB,EAAE,CAAC;IAC5C,SAAS,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAC9B,SAAS,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAC9B,UAAU,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAC/B,MAAM,CAAC,EAAE,UAAU,CAAC;CACpB;AAED,qBAAa,4BAA6B,SAAQ,KAAK;IACtD,YAAY,OAAO,EAAE,MAAM,EAG1B;CACD;AAYD,6FAA6F;AAC7F,wBAAgB,qCAAqC,CAAC,KAAK,EAAE,OAAO,GAAG,gCAAgC,CA4EtG;AAED,wFAAwF;AACxF,MAAM,WAAW,uBAAuB;IACvC,YAAY,EAAE,MAAM,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,gCAAgC,CAAC;IAC7C,yFAAyF;IACzF,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,qGAAqG;IACrG,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,gGAAgG;IAChG,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B,iGAAiG;IACjG,WAAW,CAAC,EAAE,2BAA2B,CAAC;CAC1C"}

package/dist/core/delegation/worker-delegation-request.js.map

@@ -1 +1 @@
-{"version":3,"file":"worker-delegation-request.js","sourceRoot":"","sources":["../../../src/core/delegation/worker-delegation-request.ts"],"names":[],"mappings":"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","sourcesContent":["import { parseBoundedStringArray } from \"../orchestration/bounded-string-array.ts\";\nimport {\n\ttype HarnessCapability,\n\tisHarnessCapability,\n\tMAX_ORCHESTRATION_MODEL_ID_LENGTH,\n\tMAX_ORCHESTRATION_MODEL_PROVIDER_LENGTH,\n\tMAX_WORKER_AUTHORITY_PATH_LENGTH,\n\tMAX_WORKER_AUTHORITY_PATHS,\n\tORCHESTRATION_THINKING_LEVELS,\n\ttype OrchestrationThinkingLevel,\n\ttype RiskBudget,\n\tWORKER_ROLES,\n\ttype WorkerRole,\n} from \"../orchestration/contracts.ts\";\nimport { parseRiskBudget } from \"../orchestration/risk-budget.ts\";\nimport { hasOnlyKeys, isPlainRecord } from \"../util/value-guards.ts\";\n\n/** Runtime-owned task correlation retained with a durable worker dispatch. Never model-settable. */\nexport interface WorkerDelegationTaskContext {\n\trequirementIds: readonly string[];\n\tdependsOnTaskIds: readonly string[];\n\tacceptanceCriterionIds: readonly string[];\n\t/**\n\t * Optional runtime narrowing of the owner-admitted profile resources. An empty list does not\n\t * suppress owner resources: admission expands it to the immutable profile pointer set and\n\t * persists that exact selection with the attempt.\n\t */\n\tresourcePointerIds: readonly string[];\n}\n\nexport interface WorkerDelegationModelRequest {\n\tprovider: string;\n\tmodelId: string;\n}\n\n/** Model-authored execution preferences compiled into an immutable, inherited runtime grant. */\nexport interface WorkerDelegationAuthorityRequest {\n\trole?: WorkerRole;\n\tmodel?: WorkerDelegationModelRequest;\n\tthinkingLevel?: OrchestrationThinkingLevel;\n\tcapabilities?: readonly HarnessCapability[];\n\ttoolNames?: readonly string[];\n\treadPaths?: readonly string[];\n\twritePaths?: readonly string[];\n\tbudget?: RiskBudget;\n}\n\nexport class WorkerDelegationRequestError extends Error {\n\tconstructor(message: string) {\n\t\tsuper(message);\n\t\tthis.name = \"WorkerDelegationRequestError\";\n\t}\n}\n\nfunction uniqueStringArray(value: unknown, label: string, options: { maxEntries?: number; maxLength?: number } = {}) {\n\treturn parseBoundedStringArray(value, {\n\t\t...options,\n\t\ttrim: true,\n\t\tinvalidMessage: `${label} must contain bounded, non-empty strings.`,\n\t\tduplicateMessage: `${label} must contain unique strings.`,\n\t\tcreateError: (message) => new WorkerDelegationRequestError(message),\n\t});\n}\n\n/** Parse the model-facing authority request before it reaches admission or durable state. */\nexport function parseWorkerDelegationAuthorityRequest(value: unknown): WorkerDelegationAuthorityRequest {\n\tif (!isPlainRecord(value)) throw new WorkerDelegationRequestError(\"Delegation authority must be an object.\");\n\tif (\n\t\t!hasOnlyKeys(value, [\n\t\t\t\"role\",\n\t\t\t\"model\",\n\t\t\t\"thinkingLevel\",\n\t\t\t\"capabilities\",\n\t\t\t\"toolNames\",\n\t\t\t\"readPaths\",\n\t\t\t\"writePaths\",\n\t\t\t\"budget\",\n\t\t])\n\t) {\n\t\tthrow new WorkerDelegationRequestError(\"Delegation authority contains an unsupported field.\");\n\t}\n\tif (value.role !== undefined && !WORKER_ROLES.includes(value.role as WorkerRole)) {\n\t\tthrow new WorkerDelegationRequestError(\"Delegation authority role is invalid.\");\n\t}\n\tif (\n\t\tvalue.thinkingLevel !== undefined &&\n\t\t!ORCHESTRATION_THINKING_LEVELS.includes(value.thinkingLevel as OrchestrationThinkingLevel)\n\t) {\n\t\tthrow new WorkerDelegationRequestError(\"Delegation authority thinkingLevel is invalid.\");\n\t}\n\tlet model: WorkerDelegationModelRequest | undefined;\n\tif (value.model !== undefined) {\n\t\tif (\n\t\t\t!isPlainRecord(value.model) ||\n\t\t\t!hasOnlyKeys(value.model, [\"provider\", \"modelId\"]) ||\n\t\t\ttypeof value.model.provider !== \"string\" ||\n\t\t\t!value.model.provider.trim() ||\n\t\t\tvalue.model.provider.length > MAX_ORCHESTRATION_MODEL_PROVIDER_LENGTH ||\n\t\t\ttypeof value.model.modelId !== \"string\" ||\n\t\t\t!value.model.modelId.trim() ||\n\t\t\tvalue.model.modelId.length > MAX_ORCHESTRATION_MODEL_ID_LENGTH\n\t\t) {\n\t\t\tthrow new WorkerDelegationRequestError(\"Delegation authority model is invalid.\");\n\t\t}\n\t\tmodel = { provider: value.model.provider.trim(), modelId: value.model.modelId.trim() };\n\t}\n\tlet capabilities: HarnessCapability[] | undefined;\n\tif (value.capabilities !== undefined) {\n\t\tconst parsed = uniqueStringArray(value.capabilities, \"Delegation authority capabilities\");\n\t\tif (!parsed.every(isHarnessCapability)) {\n\t\t\tthrow new WorkerDelegationRequestError(\"Delegation authority contains an unknown capability.\");\n\t\t}\n\t\tcapabilities = parsed;\n\t}\n\tconst toolNames =\n\t\tvalue.toolNames === undefined ? undefined : uniqueStringArray(value.toolNames, \"Delegation authority toolNames\");\n\tconst pathOptions = { maxEntries: MAX_WORKER_AUTHORITY_PATHS, maxLength: MAX_WORKER_AUTHORITY_PATH_LENGTH };\n\tconst readPaths =\n\t\tvalue.readPaths === undefined\n\t\t\t? undefined\n\t\t\t: uniqueStringArray(value.readPaths, \"Delegation authority readPaths\", pathOptions);\n\tconst writePaths =\n\t\tvalue.writePaths === undefined\n\t\t\t? undefined\n\t\t\t: uniqueStringArray(value.writePaths, \"Delegation authority writePaths\", pathOptions);\n\tlet budget: RiskBudget | undefined;\n\ttry {\n\t\tbudget = value.budget === undefined ? undefined : parseRiskBudget(value.budget, \"Delegation authority budget\");\n\t} catch (error) {\n\t\tthrow new WorkerDelegationRequestError(error instanceof Error ? error.message : String(error));\n\t}\n\treturn {\n\t\t...(value.role ? { role: value.role as WorkerRole } : {}),\n\t\t...(model ? { model } : {}),\n\t\t...(value.thinkingLevel ? { thinkingLevel: value.thinkingLevel as OrchestrationThinkingLevel } : {}),\n\t\t...(capabilities ? { capabilities } : {}),\n\t\t...(toolNames ? { toolNames } : {}),\n\t\t...(readPaths ? { readPaths } : {}),\n\t\t...(writePaths ? { writePaths } : {}),\n\t\t...(budget ? { budget } : {}),\n\t};\n}\n\n/** A profile is an optional preset; authority is compiled and persisted by the host. */\nexport interface WorkerDelegationRequest {\n\tinstructions: string;\n\tprofileId?: string;\n\tauthority?: WorkerDelegationAuthorityRequest;\n\t/** Runtime-owned creator identity for recursive delegation; never accepted from a model argument. */\n\tparentAgentId?: string;\n\t/** Runtime-owned correlation for an automatically dispatched verifier; never model-settable. */\n\tverificationOfTaskId?: string;\n\t/** Runtime-owned durable task correlation; the delegate tool schema intentionally omits this. */\n\ttaskContext?: WorkerDelegationTaskContext;\n}\n"]}
+{"version":3,"file":"worker-delegation-request.js","sourceRoot":"","sources":["../../../src/core/delegation/worker-delegation-request.ts"],"names":[],"mappings":"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","sourcesContent":["import { parseBoundedStringArray } from \"../orchestration/bounded-string-array.ts\";\nimport {\n\ttype HarnessCapability,\n\tisHarnessCapability,\n\tMAX_ORCHESTRATION_MODEL_ID_LENGTH,\n\tMAX_ORCHESTRATION_MODEL_PROVIDER_LENGTH,\n\tMAX_WORKER_AUTHORITY_PATH_LENGTH,\n\tMAX_WORKER_AUTHORITY_PATHS,\n\tORCHESTRATION_THINKING_LEVELS,\n\ttype OrchestrationThinkingLevel,\n\ttype RiskBudget,\n\tWORKER_ROLES,\n\ttype WorkerRole,\n} from \"../orchestration/contracts.ts\";\nimport { parseRiskBudget } from \"../orchestration/risk-budget.ts\";\nimport { hasOnlyKeys, isPlainRecord } from \"../util/value-guards.ts\";\n\n/** Runtime-owned task correlation retained with a durable worker dispatch. Never model-settable. */\nexport interface WorkerDelegationTaskContext {\n\trequirementIds: readonly string[];\n\tdependsOnTaskIds: readonly string[];\n\tacceptanceCriterionIds: readonly string[];\n\t/**\n\t * Optional runtime narrowing of the owner-admitted profile resources. An empty list does not\n\t * suppress owner resources: admission expands it to the immutable profile pointer set and\n\t * persists that exact selection with the attempt.\n\t */\n\tresourcePointerIds: readonly string[];\n}\n\nexport interface WorkerDelegationModelRequest {\n\tprovider: string;\n\tmodelId: string;\n}\n\n/** Model-authored execution preferences compiled into an immutable, inherited runtime grant. */\nexport interface WorkerDelegationAuthorityRequest {\n\trole?: WorkerRole;\n\tmodel?: WorkerDelegationModelRequest;\n\tthinkingLevel?: OrchestrationThinkingLevel;\n\tcapabilities?: readonly HarnessCapability[];\n\ttoolNames?: readonly string[];\n\treadPaths?: readonly string[];\n\twritePaths?: readonly string[];\n\tbudget?: RiskBudget;\n}\n\nexport class WorkerDelegationRequestError extends Error {\n\tconstructor(message: string) {\n\t\tsuper(message);\n\t\tthis.name = \"WorkerDelegationRequestError\";\n\t}\n}\n\nfunction uniqueStringArray(value: unknown, label: string, options: { maxEntries?: number; maxLength?: number } = {}) {\n\treturn parseBoundedStringArray(value, {\n\t\t...options,\n\t\ttrim: true,\n\t\tinvalidMessage: `${label} must contain bounded, non-empty strings.`,\n\t\tduplicateMessage: `${label} must contain unique strings.`,\n\t\tcreateError: (message) => new WorkerDelegationRequestError(message),\n\t});\n}\n\n/** Parse the model-facing authority request before it reaches admission or durable state. */\nexport function parseWorkerDelegationAuthorityRequest(value: unknown): WorkerDelegationAuthorityRequest {\n\tif (!isPlainRecord(value)) throw new WorkerDelegationRequestError(\"Delegation authority must be an object.\");\n\tif (\n\t\t!hasOnlyKeys(value, [\n\t\t\t\"role\",\n\t\t\t\"model\",\n\t\t\t\"thinkingLevel\",\n\t\t\t\"capabilities\",\n\t\t\t\"toolNames\",\n\t\t\t\"readPaths\",\n\t\t\t\"writePaths\",\n\t\t\t\"budget\",\n\t\t])\n\t) {\n\t\tthrow new WorkerDelegationRequestError(\"Delegation authority contains an unsupported field.\");\n\t}\n\tif (value.role !== undefined && !WORKER_ROLES.includes(value.role as WorkerRole)) {\n\t\tthrow new WorkerDelegationRequestError(\"Delegation authority role is invalid.\");\n\t}\n\tif (\n\t\tvalue.thinkingLevel !== undefined &&\n\t\t!ORCHESTRATION_THINKING_LEVELS.includes(value.thinkingLevel as OrchestrationThinkingLevel)\n\t) {\n\t\tthrow new WorkerDelegationRequestError(\"Delegation authority thinkingLevel is invalid.\");\n\t}\n\tlet model: WorkerDelegationModelRequest | undefined;\n\tif (value.model !== undefined) {\n\t\tif (\n\t\t\t!isPlainRecord(value.model) ||\n\t\t\t!hasOnlyKeys(value.model, [\"provider\", \"modelId\"]) ||\n\t\t\ttypeof value.model.provider !== \"string\" ||\n\t\t\t!value.model.provider.trim() ||\n\t\t\tvalue.model.provider.length > MAX_ORCHESTRATION_MODEL_PROVIDER_LENGTH ||\n\t\t\ttypeof value.model.modelId !== \"string\" ||\n\t\t\t!value.model.modelId.trim() ||\n\t\t\tvalue.model.modelId.length > MAX_ORCHESTRATION_MODEL_ID_LENGTH\n\t\t) {\n\t\t\tthrow new WorkerDelegationRequestError(\"Delegation authority model is invalid.\");\n\t\t}\n\t\tmodel = { provider: value.model.provider.trim(), modelId: value.model.modelId.trim() };\n\t}\n\tlet capabilities: HarnessCapability[] | undefined;\n\tif (value.capabilities !== undefined) {\n\t\tconst parsed = uniqueStringArray(value.capabilities, \"Delegation authority capabilities\");\n\t\tif (!parsed.every(isHarnessCapability)) {\n\t\t\tthrow new WorkerDelegationRequestError(\"Delegation authority contains an unknown capability.\");\n\t\t}\n\t\tcapabilities = parsed;\n\t}\n\tconst toolNames =\n\t\tvalue.toolNames === undefined ? undefined : uniqueStringArray(value.toolNames, \"Delegation authority toolNames\");\n\tconst pathOptions = { maxEntries: MAX_WORKER_AUTHORITY_PATHS, maxLength: MAX_WORKER_AUTHORITY_PATH_LENGTH };\n\tconst readPaths =\n\t\tvalue.readPaths === undefined\n\t\t\t? undefined\n\t\t\t: uniqueStringArray(value.readPaths, \"Delegation authority readPaths\", pathOptions);\n\tconst writePaths =\n\t\tvalue.writePaths === undefined\n\t\t\t? undefined\n\t\t\t: uniqueStringArray(value.writePaths, \"Delegation authority writePaths\", pathOptions);\n\tlet budget: RiskBudget | undefined;\n\ttry {\n\t\tbudget = value.budget === undefined ? undefined : parseRiskBudget(value.budget, \"Delegation authority budget\");\n\t} catch (error) {\n\t\tthrow new WorkerDelegationRequestError(error instanceof Error ? error.message : String(error));\n\t}\n\treturn {\n\t\t...(value.role ? { role: value.role as WorkerRole } : {}),\n\t\t...(model ? { model } : {}),\n\t\t...(value.thinkingLevel ? { thinkingLevel: value.thinkingLevel as OrchestrationThinkingLevel } : {}),\n\t\t...(capabilities ? { capabilities } : {}),\n\t\t...(toolNames ? { toolNames } : {}),\n\t\t...(readPaths ? { readPaths } : {}),\n\t\t...(writePaths ? { writePaths } : {}),\n\t\t...(budget ? { budget } : {}),\n\t};\n}\n\n/** A profile is an optional preset; authority is compiled and persisted by the host. */\nexport interface WorkerDelegationRequest {\n\tinstructions: string;\n\tprofileId?: string;\n\tauthority?: WorkerDelegationAuthorityRequest;\n\t/** Tool-facing immutable birth-context selection for a newly admitted logical worker. */\n\tforkTurns?: string;\n\t/** Runtime-owned creator identity for recursive delegation; never accepted from a model argument. */\n\tparentAgentId?: string;\n\t/** Runtime-owned correlation for an automatically dispatched verifier; never model-settable. */\n\tverificationOfTaskId?: string;\n\t/** Runtime-owned durable task correlation; the delegate tool schema intentionally omits this. */\n\ttaskContext?: WorkerDelegationTaskContext;\n}\n"]}

package/dist/core/delegation/worker-dispatch-scheduler.d.ts

@@ -1,17 +1,20 @@
 import type { WorkerDelegationRunOutcome } from "../agent-session-contracts.ts";
 import type { LaneRecord } from "../autonomy/lane-tracker.ts";
+import { registerInFlightWork } from "../reload-blockers.ts";
 import type { WorkerDelegationRequest } from "./worker-delegation-request.ts";
 export type WorkerDispatchAdmission = {
     action: "start";
 } | {
     action: "wait";
-    reason?: "capacity" | "write_reservation";
+    reason?: "capacity" | "dependencies" | "objective" | "write_reservation";
 } | {
     action: "cancel";
     reasonCode: string;
 };
 export interface WorkerDispatchSchedulerOptions {
     agentDir: string;
+    /** Test seam for proving queue insertion rollback when reload-gate registration fails. */
+    registerInFlightWork?: typeof registerInFlightWork;
     isDisposed(): boolean;
     admit(request: WorkerDelegationRequest, record: LaneRecord): WorkerDispatchAdmission;
     getRecord(laneId: string): LaneRecord | undefined;
@@ -28,15 +31,31 @@ export declare class WorkerDispatchScheduler {
     private readonly queued;
     private readonly queuedDeregisters;
     private readonly running;
+    private readonly pendingCancellations;
     private readonly reservationBlocked;
+    private readonly queueCapacityListeners;
     private draining;
+    private redrainRequested;
+    private reservationAvailabilityRequested;
+    private queueCapacityNotificationPending;
     constructor(options: WorkerDispatchSchedulerOptions);
     get queuedCount(): number;
+    hasQueueCapacity(priority?: boolean): boolean;
+    /** Notify retained priority work when a bounded queue slot is released. */
+    onQueueCapacityAvailable(listener: () => void): () => void;
     enqueue(record: LaneRecord, request: WorkerDelegationRequest, recovered?: boolean, priority?: boolean): void;
     track(laneId: string, promise: Promise<WorkerDelegationRunOutcome>): void;
+    private retainPendingCancellation;
+    private registerPendingCancellation;
+    private retryPendingCancellations;
+    private removePendingCancellation;
+    private cancelBestEffort;
+    private finishTrackedRun;
+    private warnBestEffort;
     drain(reservationAvailable?: boolean): void;
     cancelQueued(): void;
     dropQueued(laneId: string): boolean;
     private removeQueued;
+    private notifyQueueCapacityAvailable;
 }
 //# sourceMappingURL=worker-dispatch-scheduler.d.ts.map

package/dist/core/delegation/worker-dispatch-scheduler.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"worker-dispatch-scheduler.d.ts","sourceRoot":"","sources":["../../../src/core/delegation/worker-dispatch-scheduler.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,+BAA+B,CAAC;AAChF,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,6BAA6B,CAAC;AAE9D,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,gCAAgC,CAAC;AAE9E,MAAM,MAAM,uBAAuB,GAChC;IAAE,MAAM,EAAE,OAAO,CAAA;CAAE,GACnB;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,UAAU,GAAG,mBAAmB,CAAA;CAAE,GAC7D;IAAE,MAAM,EAAE,QAAQ,CAAC;IAAC,UAAU,EAAE,MAAM,CAAA;CAAE,CAAC;AAE5C,MAAM,WAAW,8BAA8B;IAC9C,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,IAAI,OAAO,CAAC;IACtB,KAAK,CAAC,OAAO,EAAE,uBAAuB,EAAE,MAAM,EAAE,UAAU,GAAG,uBAAuB,CAAC;IACrF,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,UAAU,GAAG,SAAS,CAAC;IAClD,GAAG,CAAC,OAAO,EAAE,uBAAuB,EAAE,MAAM,EAAE,UAAU,GAAG,OAAO,CAAC,0BAA0B,CAAC,CAAC;IAC/F,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IACjD,IAAI,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;CAC5B;AAED;;;GAGG;AACH,qBAAa,uBAAuB;IACnC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAiC;IACzD,OAAO,CAAC,QAAQ,CAAC,MAAM,CAA8C;IACrE,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAAiC;IACnE,OAAO,CAAC,QAAQ,CAAC,OAAO,CAA0D;IAClF,OAAO,CAAC,QAAQ,CAAC,kBAAkB,CAAqB;IACxD,OAAO,CAAC,QAAQ,CAAS;IAEzB,YAAY,OAAO,EAAE,8BAA8B,EAElD;IAED,IAAI,WAAW,IAAI,MAAM,CAExB;IAED,OAAO,CAAC,MAAM,EAAE,UAAU,EAAE,OAAO,EAAE,uBAAuB,EAAE,SAAS,UAAQ,EAAE,QAAQ,UAAQ,GAAG,IAAI,CAkBvG;IAED,KAAK,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,CAAC,0BAA0B,CAAC,GAAG,IAAI,CAexE;IAED,KAAK,CAAC,oBAAoB,UAAQ,GAAG,IAAI,CA2BxC;IAED,YAAY,IAAI,IAAI,CAOnB;IAED,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAIlC;IAED,OAAO,CAAC,YAAY;CAMpB"}
+{"version":3,"file":"worker-dispatch-scheduler.d.ts","sourceRoot":"","sources":["../../../src/core/delegation/worker-dispatch-scheduler.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,+BAA+B,CAAC;AAChF,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,6BAA6B,CAAC;AAC9D,OAAO,EAAE,oBAAoB,EAAE,MAAM,uBAAuB,CAAC;AAC7D,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,gCAAgC,CAAC;AAG9E,MAAM,MAAM,uBAAuB,GAChC;IAAE,MAAM,EAAE,OAAO,CAAA;CAAE,GACnB;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,UAAU,GAAG,cAAc,GAAG,WAAW,GAAG,mBAAmB,CAAA;CAAE,GAC5F;IAAE,MAAM,EAAE,QAAQ,CAAC;IAAC,UAAU,EAAE,MAAM,CAAA;CAAE,CAAC;AAE5C,MAAM,WAAW,8BAA8B;IAC9C,QAAQ,EAAE,MAAM,CAAC;IACjB,0FAA0F;IAC1F,oBAAoB,CAAC,EAAE,OAAO,oBAAoB,CAAC;IACnD,UAAU,IAAI,OAAO,CAAC;IACtB,KAAK,CAAC,OAAO,EAAE,uBAAuB,EAAE,MAAM,EAAE,UAAU,GAAG,uBAAuB,CAAC;IACrF,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,UAAU,GAAG,SAAS,CAAC;IAClD,GAAG,CAAC,OAAO,EAAE,uBAAuB,EAAE,MAAM,EAAE,UAAU,GAAG,OAAO,CAAC,0BAA0B,CAAC,CAAC;IAC/F,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IACjD,IAAI,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;CAC5B;AAOD;;;GAGG;AACH,qBAAa,uBAAuB;IACnC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAiC;IACzD,OAAO,CAAC,QAAQ,CAAC,MAAM,CAA8C;IACrE,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAAiC;IACnE,OAAO,CAAC,QAAQ,CAAC,OAAO,CAA0D;IAClF,OAAO,CAAC,QAAQ,CAAC,oBAAoB,CAA0C;IAC/E,OAAO,CAAC,QAAQ,CAAC,kBAAkB,CAAqB;IACxD,OAAO,CAAC,QAAQ,CAAC,sBAAsB,CAAyB;IAChE,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,gBAAgB,CAAS;IACjC,OAAO,CAAC,gCAAgC,CAAS;IACjD,OAAO,CAAC,gCAAgC,CAAS;IAEjD,YAAY,OAAO,EAAE,8BAA8B,EAElD;IAED,IAAI,WAAW,IAAI,MAAM,CAExB;IAED,gBAAgB,CAAC,QAAQ,UAAQ,GAAG,OAAO,CAE1C;IAED,2EAA2E;IAC3E,wBAAwB,CAAC,QAAQ,EAAE,MAAM,IAAI,GAAG,MAAM,IAAI,CAGzD;IAED,OAAO,CAAC,MAAM,EAAE,UAAU,EAAE,OAAO,EAAE,uBAAuB,EAAE,SAAS,UAAQ,EAAE,QAAQ,UAAQ,GAAG,IAAI,CAiCvG;IAED,KAAK,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,CAAC,0BAA0B,CAAC,GAAG,IAAI,CA4BxE;IAED,OAAO,CAAC,yBAAyB;IAOjC,OAAO,CAAC,2BAA2B;IAenC,OAAO,CAAC,yBAAyB;IAQjC,OAAO,CAAC,yBAAyB;IAajC,OAAO,CAAC,gBAAgB;IAYxB,OAAO,CAAC,gBAAgB;IAiBxB,OAAO,CAAC,cAAc;IAQtB,KAAK,CAAC,oBAAoB,UAAQ,GAAG,IAAI,CAwDxC;IAED,YAAY,IAAI,IAAI,CAenB;IAED,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAIlC;IAED,OAAO,CAAC,YAAY;IAepB,OAAO,CAAC,4BAA4B;CAgBpC"}

package/dist/core/delegation/worker-dispatch-scheduler.js

@@ -1,4 +1,5 @@
 import { registerInFlightWork } from "../reload-blockers.js";
+import { workerQueueHasCapacity } from "./worker-fleet-limits.js";
 /**
  * Single owner of worker queue and promise transitions. Execution policy and durable lifecycle stay
  * outside; this class only decides when a prepared durable attempt moves from queued to running.
@@ -8,16 +9,34 @@ export class WorkerDispatchScheduler {
         this.queued = new Map();
         this.queuedDeregisters = new Map();
         this.running = new Map();
+        this.pendingCancellations = new Map();
         this.reservationBlocked = new Set();
+        this.queueCapacityListeners = new Set();
         this.draining = false;
+        this.redrainRequested = false;
+        this.reservationAvailabilityRequested = false;
+        this.queueCapacityNotificationPending = false;
         this.options = options;
     }
     get queuedCount() {
         return this.queued.size;
     }
+    hasQueueCapacity(priority = false) {
+        return workerQueueHasCapacity(this.queued.size, priority);
+    }
+    /** Notify retained priority work when a bounded queue slot is released. */
+    onQueueCapacityAvailable(listener) {
+        this.queueCapacityListeners.add(listener);
+        return () => this.queueCapacityListeners.delete(listener);
+    }
     enqueue(record, request, recovered = false, priority = false) {
-        if (this.queued.has(record.laneId) || this.running.has(record.laneId))
+        if (this.queued.has(record.laneId) ||
+            this.running.has(record.laneId) ||
+            this.pendingCancellations.has(record.laneId)) {
             return;
+        }
+        if (!this.hasQueueCapacity(priority))
+            throw new Error("worker_dispatch_queue_full");
         if (priority) {
             const waiting = [...this.queued];
             this.queued.clear();
@@ -28,51 +47,173 @@ export class WorkerDispatchScheduler {
         else {
             this.queued.set(record.laneId, request);
         }
-        this.queuedDeregisters.set(record.laneId, registerInFlightWork(this.options.agentDir, "lane", recovered ? `worker-recovered:${record.laneId}` : `worker-queued:${record.laneId}`));
+        try {
+            this.queuedDeregisters.set(record.laneId, (this.options.registerInFlightWork ?? registerInFlightWork)(this.options.agentDir, "lane", recovered ? `worker-recovered:${record.laneId}` : `worker-queued:${record.laneId}`));
+        }
+        catch (error) {
+            // Queue insertion and reload-gate registration are one process-local transition. A failed
+            // registration must not leave a lane that appears queued but has no matching blocker.
+            this.queued.delete(record.laneId);
+            this.reservationBlocked.delete(record.laneId);
+            throw error;
+        }
     }
     track(laneId, promise) {
         this.running.set(laneId, promise);
         void promise.then((outcome) => {
-            if (!outcome.started)
-                this.options.cancel(laneId, outcome.skipReason ?? "worker_not_started");
-            this.running.delete(laneId);
-            if (!this.options.isDisposed())
-                this.drain();
+            try {
+                if (!outcome.started) {
+                    const reasonCode = outcome.skipReason ?? "worker_not_started";
+                    if (!this.cancelBestEffort(laneId, reasonCode)) {
+                        this.retainPendingCancellation(laneId, reasonCode);
+                    }
+                }
+            }
+            finally {
+                this.finishTrackedRun(laneId);
+            }
         }, (error) => {
-            this.options.cancel(laneId, "worker_background_error");
-            this.options.warn(`Worker ${laneId} rejected: ${error instanceof Error ? error.message : String(error)}`);
-            this.running.delete(laneId);
-            if (!this.options.isDisposed())
-                this.drain();
+            try {
+                if (!this.cancelBestEffort(laneId, "worker_background_error")) {
+                    this.retainPendingCancellation(laneId, "worker_background_error");
+                }
+                this.warnBestEffort(`Worker ${laneId} rejected: ${error instanceof Error ? error.message : String(error)}`);
+            }
+            finally {
+                this.finishTrackedRun(laneId);
+            }
         });
     }
+    retainPendingCancellation(laneId, reasonCode) {
+        if (this.pendingCancellations.has(laneId))
+            return;
+        const pending = { reasonCode };
+        this.pendingCancellations.set(laneId, pending);
+        this.registerPendingCancellation(laneId, pending);
+    }
+    registerPendingCancellation(laneId, pending) {
+        if (pending.deregister)
+            return;
+        try {
+            pending.deregister = (this.options.registerInFlightWork ?? registerInFlightWork)(this.options.agentDir, "lane", `worker-cancellation-pending:${laneId}`);
+        }
+        catch (error) {
+            this.warnBestEffort(`Worker ${laneId} cancellation reload-gate registration failed: ${error instanceof Error ? error.message : String(error)}`);
+        }
+    }
+    retryPendingCancellations() {
+        for (const [laneId, pending] of [...this.pendingCancellations]) {
+            this.registerPendingCancellation(laneId, pending);
+            if (!this.cancelBestEffort(laneId, pending.reasonCode))
+                continue;
+            this.removePendingCancellation(laneId);
+        }
+    }
+    removePendingCancellation(laneId) {
+        const pending = this.pendingCancellations.get(laneId);
+        if (!pending)
+            return;
+        this.pendingCancellations.delete(laneId);
+        try {
+            pending.deregister?.();
+        }
+        catch (error) {
+            this.warnBestEffort(`Worker ${laneId} cancellation reload-gate deregistration failed: ${error instanceof Error ? error.message : String(error)}`);
+        }
+    }
+    cancelBestEffort(laneId, reasonCode) {
+        try {
+            this.options.cancel(laneId, reasonCode);
+            return true;
+        }
+        catch (error) {
+            this.warnBestEffort(`Worker ${laneId} cancellation failed: ${error instanceof Error ? error.message : String(error)}`);
+            return false;
+        }
+    }
+    finishTrackedRun(laneId) {
+        this.running.delete(laneId);
+        if (this.options.isDisposed()) {
+            // A disposed generation has no future scheduler signal. Its durable state is recovered by the
+            // next generation, so do not leak this generation's process-local reload blocker.
+            this.removePendingCancellation(laneId);
+            return;
+        }
+        try {
+            this.drain();
+        }
+        catch (error) {
+            this.warnBestEffort(`Worker ${laneId} scheduler redrain failed: ${error instanceof Error ? error.message : String(error)}`);
+        }
+    }
+    warnBestEffort(message) {
+        try {
+            this.options.warn(message);
+        }
+        catch {
+            // Diagnostics cannot retain a completed promise in the running set.
+        }
+    }
     drain(reservationAvailable = false) {
-        if (this.draining || this.options.isDisposed())
+        if (this.options.isDisposed())
+            return;
+        if (reservationAvailable)
+            this.reservationAvailabilityRequested = true;
+        if (this.draining) {
+            this.redrainRequested = true;
             return;
+        }
         this.draining = true;
         try {
-            for (const [laneId, request] of [...this.queued]) {
-                if (this.reservationBlocked.has(laneId) && !reservationAvailable)
-                    continue;
-                const record = this.options.getRecord(laneId);
-                if (!record) {
+            // Promise settlement and every later scheduler signal retry each retained durable cancellation
+            // once. Keep this outside the redrain loop so a reentrant signal cannot create a busy retry.
+            this.retryPendingCancellations();
+            do {
+                this.redrainRequested = false;
+                const passReservationAvailable = this.reservationAvailabilityRequested;
+                this.reservationAvailabilityRequested = false;
+                for (const [laneId, request] of [...this.queued]) {
+                    if (this.reservationBlocked.has(laneId) && !passReservationAvailable)
+                        continue;
+                    const record = this.options.getRecord(laneId);
+                    if (!record) {
+                        this.removeQueued(laneId);
+                        continue;
+                    }
+                    const admission = this.options.admit(request, record);
+                    if (admission.action === "wait") {
+                        if (admission.reason === "write_reservation")
+                            this.reservationBlocked.add(laneId);
+                        else
+                            this.reservationBlocked.delete(laneId);
+                        continue;
+                    }
+                    if (admission.action === "cancel") {
+                        this.reservationBlocked.delete(laneId);
+                        // Durable cancellation owns this transition. Retain the scheduler entry when
+                        // that write fails so a later explicit drain can retry it without a busy loop.
+                        if (!this.cancelBestEffort(laneId, admission.reasonCode))
+                            continue;
+                        this.removeQueued(laneId);
+                        // Cancellation can synchronously block another queued task that appeared earlier.
+                        // Re-evaluate the bounded queue until that dependency cascade reaches a fixed point.
+                        this.redrainRequested = true;
+                        continue;
+                    }
+                    this.reservationBlocked.delete(laneId);
                     this.removeQueued(laneId);
-                    continue;
-                }
-                const admission = this.options.admit(request, record);
-                if (admission.action === "wait") {
-                    if (admission.reason === "write_reservation")
-                        this.reservationBlocked.add(laneId);
-                    continue;
+                    let run;
+                    try {
+                        run = this.options.run(request, record);
+                    }
+                    catch (error) {
+                        // Preserve synchronous start semantics while routing a throwing implementation
+                        // through the same cancellation and cleanup owner as a rejected run promise.
+                        run = Promise.reject(error);
+                    }
+                    this.track(laneId, run);
                 }
-                this.reservationBlocked.delete(laneId);
-                this.removeQueued(laneId);
-                if (admission.action === "cancel") {
-                    this.options.cancel(laneId, admission.reasonCode);
-                    continue;
-                }
-                this.track(laneId, this.options.run(request, record));
-            }
+            } while ((this.redrainRequested || this.reservationAvailabilityRequested) && !this.options.isDisposed());
         }
         finally {
             this.draining = false;
@@ -81,10 +222,18 @@ export class WorkerDispatchScheduler {
     cancelQueued() {
         for (const laneId of [...this.queued.keys()]) {
             // The controller owns durable cancellation and any pre-admission resources (for example a
-            // write reservation). Dropping this scheduler-only reference would leak those resources.
-            this.options.cancel(laneId, "session_disposed");
+            // write reservation). Disposal must still visit every lane and release every process-local
+            // blocker when one durable write fails; the next controller generation recovers any retained
+            // durable queued attempt.
+            this.cancelBestEffort(laneId, "session_disposed");
             this.removeQueued(laneId);
         }
+        for (const [laneId, pending] of [...this.pendingCancellations]) {
+            this.cancelBestEffort(laneId, pending.reasonCode);
+            // Disposal hands any remaining durable recovery to the next controller generation. Release
+            // this generation's process-local reload blocker even when its last cancellation attempt fails.
+            this.removePendingCancellation(laneId);
+        }
     }
     dropQueued(laneId) {
         if (!this.queued.has(laneId))
@@ -93,10 +242,34 @@ export class WorkerDispatchScheduler {
         return true;
     }
     removeQueued(laneId) {
-        this.queued.delete(laneId);
+        const removed = this.queued.delete(laneId);
         this.reservationBlocked.delete(laneId);
-        this.queuedDeregisters.get(laneId)?.();
+        const deregister = this.queuedDeregisters.get(laneId);
         this.queuedDeregisters.delete(laneId);
+        try {
+            deregister?.();
+        }
+        catch (error) {
+            this.warnBestEffort(`Worker ${laneId} reload-gate deregistration failed: ${error instanceof Error ? error.message : String(error)}`);
+        }
+        if (removed)
+            this.notifyQueueCapacityAvailable();
+    }
+    notifyQueueCapacityAvailable() {
+        if (this.queueCapacityNotificationPending || this.queueCapacityListeners.size === 0)
+            return;
+        this.queueCapacityNotificationPending = true;
+        queueMicrotask(() => {
+            this.queueCapacityNotificationPending = false;
+            for (const listener of this.queueCapacityListeners) {
+                try {
+                    listener();
+                }
+                catch (error) {
+                    this.warnBestEffort(`Worker queue-capacity listener failed: ${error instanceof Error ? error.message : String(error)}`);
+                }
+            }
+        });
     }
 }
 //# sourceMappingURL=worker-dispatch-scheduler.js.map

package/dist/core/delegation/worker-dispatch-scheduler.js.map

@@ -1 +1 @@
-{"version":3,"file":"worker-dispatch-scheduler.js","sourceRoot":"","sources":["../../../src/core/delegation/worker-dispatch-scheduler.ts"],"names":[],"mappings":"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","sourcesContent":["import type { WorkerDelegationRunOutcome } from \"../agent-session-contracts.ts\";\nimport type { LaneRecord } from \"../autonomy/lane-tracker.ts\";\nimport { registerInFlightWork } from \"../reload-blockers.ts\";\nimport type { WorkerDelegationRequest } from \"./worker-delegation-request.ts\";\n\nexport type WorkerDispatchAdmission =\n\t| { action: \"start\" }\n\t| { action: \"wait\"; reason?: \"capacity\" | \"write_reservation\" }\n\t| { action: \"cancel\"; reasonCode: string };\n\nexport interface WorkerDispatchSchedulerOptions {\n\tagentDir: string;\n\tisDisposed(): boolean;\n\tadmit(request: WorkerDelegationRequest, record: LaneRecord): WorkerDispatchAdmission;\n\tgetRecord(laneId: string): LaneRecord | undefined;\n\trun(request: WorkerDelegationRequest, record: LaneRecord): Promise<WorkerDelegationRunOutcome>;\n\tcancel(laneId: string, reasonCode: string): void;\n\twarn(message: string): void;\n}\n\n/**\n * Single owner of worker queue and promise transitions. Execution policy and durable lifecycle stay\n * outside; this class only decides when a prepared durable attempt moves from queued to running.\n */\nexport class WorkerDispatchScheduler {\n\tprivate readonly options: WorkerDispatchSchedulerOptions;\n\tprivate readonly queued = new Map<string, WorkerDelegationRequest>();\n\tprivate readonly queuedDeregisters = new Map<string, () => void>();\n\tprivate readonly running = new Map<string, Promise<WorkerDelegationRunOutcome>>();\n\tprivate readonly reservationBlocked = new Set<string>();\n\tprivate draining = false;\n\n\tconstructor(options: WorkerDispatchSchedulerOptions) {\n\t\tthis.options = options;\n\t}\n\n\tget queuedCount(): number {\n\t\treturn this.queued.size;\n\t}\n\n\tenqueue(record: LaneRecord, request: WorkerDelegationRequest, recovered = false, priority = false): void {\n\t\tif (this.queued.has(record.laneId) || this.running.has(record.laneId)) return;\n\t\tif (priority) {\n\t\t\tconst waiting = [...this.queued];\n\t\t\tthis.queued.clear();\n\t\t\tthis.queued.set(record.laneId, request);\n\t\t\tfor (const [laneId, queuedRequest] of waiting) this.queued.set(laneId, queuedRequest);\n\t\t} else {\n\t\t\tthis.queued.set(record.laneId, request);\n\t\t}\n\t\tthis.queuedDeregisters.set(\n\t\t\trecord.laneId,\n\t\t\tregisterInFlightWork(\n\t\t\t\tthis.options.agentDir,\n\t\t\t\t\"lane\",\n\t\t\t\trecovered ? `worker-recovered:${record.laneId}` : `worker-queued:${record.laneId}`,\n\t\t\t),\n\t\t);\n\t}\n\n\ttrack(laneId: string, promise: Promise<WorkerDelegationRunOutcome>): void {\n\t\tthis.running.set(laneId, promise);\n\t\tvoid promise.then(\n\t\t\t(outcome) => {\n\t\t\t\tif (!outcome.started) this.options.cancel(laneId, outcome.skipReason ?? \"worker_not_started\");\n\t\t\t\tthis.running.delete(laneId);\n\t\t\t\tif (!this.options.isDisposed()) this.drain();\n\t\t\t},\n\t\t\t(error: unknown) => {\n\t\t\t\tthis.options.cancel(laneId, \"worker_background_error\");\n\t\t\t\tthis.options.warn(`Worker ${laneId} rejected: ${error instanceof Error ? error.message : String(error)}`);\n\t\t\t\tthis.running.delete(laneId);\n\t\t\t\tif (!this.options.isDisposed()) this.drain();\n\t\t\t},\n\t\t);\n\t}\n\n\tdrain(reservationAvailable = false): void {\n\t\tif (this.draining || this.options.isDisposed()) return;\n\t\tthis.draining = true;\n\t\ttry {\n\t\t\tfor (const [laneId, request] of [...this.queued]) {\n\t\t\t\tif (this.reservationBlocked.has(laneId) && !reservationAvailable) continue;\n\t\t\t\tconst record = this.options.getRecord(laneId);\n\t\t\t\tif (!record) {\n\t\t\t\t\tthis.removeQueued(laneId);\n\t\t\t\t\tcontinue;\n\t\t\t\t}\n\t\t\t\tconst admission = this.options.admit(request, record);\n\t\t\t\tif (admission.action === \"wait\") {\n\t\t\t\t\tif (admission.reason === \"write_reservation\") this.reservationBlocked.add(laneId);\n\t\t\t\t\tcontinue;\n\t\t\t\t}\n\t\t\t\tthis.reservationBlocked.delete(laneId);\n\t\t\t\tthis.removeQueued(laneId);\n\t\t\t\tif (admission.action === \"cancel\") {\n\t\t\t\t\tthis.options.cancel(laneId, admission.reasonCode);\n\t\t\t\t\tcontinue;\n\t\t\t\t}\n\t\t\t\tthis.track(laneId, this.options.run(request, record));\n\t\t\t}\n\t\t} finally {\n\t\t\tthis.draining = false;\n\t\t}\n\t}\n\n\tcancelQueued(): void {\n\t\tfor (const laneId of [...this.queued.keys()]) {\n\t\t\t// The controller owns durable cancellation and any pre-admission resources (for example a\n\t\t\t// write reservation). Dropping this scheduler-only reference would leak those resources.\n\t\t\tthis.options.cancel(laneId, \"session_disposed\");\n\t\t\tthis.removeQueued(laneId);\n\t\t}\n\t}\n\n\tdropQueued(laneId: string): boolean {\n\t\tif (!this.queued.has(laneId)) return false;\n\t\tthis.removeQueued(laneId);\n\t\treturn true;\n\t}\n\n\tprivate removeQueued(laneId: string): void {\n\t\tthis.queued.delete(laneId);\n\t\tthis.reservationBlocked.delete(laneId);\n\t\tthis.queuedDeregisters.get(laneId)?.();\n\t\tthis.queuedDeregisters.delete(laneId);\n\t}\n}\n"]}
+{"version":3,"file":"worker-dispatch-scheduler.js","sourceRoot":"","sources":["../../../src/core/delegation/worker-dispatch-scheduler.ts"],"names":[],"mappings":"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","sourcesContent":["import type { WorkerDelegationRunOutcome } from \"../agent-session-contracts.ts\";\nimport type { LaneRecord } from \"../autonomy/lane-tracker.ts\";\nimport { registerInFlightWork } from \"../reload-blockers.ts\";\nimport type { WorkerDelegationRequest } from \"./worker-delegation-request.ts\";\nimport { workerQueueHasCapacity } from \"./worker-fleet-limits.ts\";\n\nexport type WorkerDispatchAdmission =\n\t| { action: \"start\" }\n\t| { action: \"wait\"; reason?: \"capacity\" | \"dependencies\" | \"objective\" | \"write_reservation\" }\n\t| { action: \"cancel\"; reasonCode: string };\n\nexport interface WorkerDispatchSchedulerOptions {\n\tagentDir: string;\n\t/** Test seam for proving queue insertion rollback when reload-gate registration fails. */\n\tregisterInFlightWork?: typeof registerInFlightWork;\n\tisDisposed(): boolean;\n\tadmit(request: WorkerDelegationRequest, record: LaneRecord): WorkerDispatchAdmission;\n\tgetRecord(laneId: string): LaneRecord | undefined;\n\trun(request: WorkerDelegationRequest, record: LaneRecord): Promise<WorkerDelegationRunOutcome>;\n\tcancel(laneId: string, reasonCode: string): void;\n\twarn(message: string): void;\n}\n\ninterface PendingCancellation {\n\treasonCode: string;\n\tderegister?: () => void;\n}\n\n/**\n * Single owner of worker queue and promise transitions. Execution policy and durable lifecycle stay\n * outside; this class only decides when a prepared durable attempt moves from queued to running.\n */\nexport class WorkerDispatchScheduler {\n\tprivate readonly options: WorkerDispatchSchedulerOptions;\n\tprivate readonly queued = new Map<string, WorkerDelegationRequest>();\n\tprivate readonly queuedDeregisters = new Map<string, () => void>();\n\tprivate readonly running = new Map<string, Promise<WorkerDelegationRunOutcome>>();\n\tprivate readonly pendingCancellations = new Map<string, PendingCancellation>();\n\tprivate readonly reservationBlocked = new Set<string>();\n\tprivate readonly queueCapacityListeners = new Set<() => void>();\n\tprivate draining = false;\n\tprivate redrainRequested = false;\n\tprivate reservationAvailabilityRequested = false;\n\tprivate queueCapacityNotificationPending = false;\n\n\tconstructor(options: WorkerDispatchSchedulerOptions) {\n\t\tthis.options = options;\n\t}\n\n\tget queuedCount(): number {\n\t\treturn this.queued.size;\n\t}\n\n\thasQueueCapacity(priority = false): boolean {\n\t\treturn workerQueueHasCapacity(this.queued.size, priority);\n\t}\n\n\t/** Notify retained priority work when a bounded queue slot is released. */\n\tonQueueCapacityAvailable(listener: () => void): () => void {\n\t\tthis.queueCapacityListeners.add(listener);\n\t\treturn () => this.queueCapacityListeners.delete(listener);\n\t}\n\n\tenqueue(record: LaneRecord, request: WorkerDelegationRequest, recovered = false, priority = false): void {\n\t\tif (\n\t\t\tthis.queued.has(record.laneId) ||\n\t\t\tthis.running.has(record.laneId) ||\n\t\t\tthis.pendingCancellations.has(record.laneId)\n\t\t) {\n\t\t\treturn;\n\t\t}\n\t\tif (!this.hasQueueCapacity(priority)) throw new Error(\"worker_dispatch_queue_full\");\n\t\tif (priority) {\n\t\t\tconst waiting = [...this.queued];\n\t\t\tthis.queued.clear();\n\t\t\tthis.queued.set(record.laneId, request);\n\t\t\tfor (const [laneId, queuedRequest] of waiting) this.queued.set(laneId, queuedRequest);\n\t\t} else {\n\t\t\tthis.queued.set(record.laneId, request);\n\t\t}\n\t\ttry {\n\t\t\tthis.queuedDeregisters.set(\n\t\t\t\trecord.laneId,\n\t\t\t\t(this.options.registerInFlightWork ?? registerInFlightWork)(\n\t\t\t\t\tthis.options.agentDir,\n\t\t\t\t\t\"lane\",\n\t\t\t\t\trecovered ? `worker-recovered:${record.laneId}` : `worker-queued:${record.laneId}`,\n\t\t\t\t),\n\t\t\t);\n\t\t} catch (error) {\n\t\t\t// Queue insertion and reload-gate registration are one process-local transition. A failed\n\t\t\t// registration must not leave a lane that appears queued but has no matching blocker.\n\t\t\tthis.queued.delete(record.laneId);\n\t\t\tthis.reservationBlocked.delete(record.laneId);\n\t\t\tthrow error;\n\t\t}\n\t}\n\n\ttrack(laneId: string, promise: Promise<WorkerDelegationRunOutcome>): void {\n\t\tthis.running.set(laneId, promise);\n\t\tvoid promise.then(\n\t\t\t(outcome) => {\n\t\t\t\ttry {\n\t\t\t\t\tif (!outcome.started) {\n\t\t\t\t\t\tconst reasonCode = outcome.skipReason ?? \"worker_not_started\";\n\t\t\t\t\t\tif (!this.cancelBestEffort(laneId, reasonCode)) {\n\t\t\t\t\t\t\tthis.retainPendingCancellation(laneId, reasonCode);\n\t\t\t\t\t\t}\n\t\t\t\t\t}\n\t\t\t\t} finally {\n\t\t\t\t\tthis.finishTrackedRun(laneId);\n\t\t\t\t}\n\t\t\t},\n\t\t\t(error: unknown) => {\n\t\t\t\ttry {\n\t\t\t\t\tif (!this.cancelBestEffort(laneId, \"worker_background_error\")) {\n\t\t\t\t\t\tthis.retainPendingCancellation(laneId, \"worker_background_error\");\n\t\t\t\t\t}\n\t\t\t\t\tthis.warnBestEffort(\n\t\t\t\t\t\t`Worker ${laneId} rejected: ${error instanceof Error ? error.message : String(error)}`,\n\t\t\t\t\t);\n\t\t\t\t} finally {\n\t\t\t\t\tthis.finishTrackedRun(laneId);\n\t\t\t\t}\n\t\t\t},\n\t\t);\n\t}\n\n\tprivate retainPendingCancellation(laneId: string, reasonCode: string): void {\n\t\tif (this.pendingCancellations.has(laneId)) return;\n\t\tconst pending: PendingCancellation = { reasonCode };\n\t\tthis.pendingCancellations.set(laneId, pending);\n\t\tthis.registerPendingCancellation(laneId, pending);\n\t}\n\n\tprivate registerPendingCancellation(laneId: string, pending: PendingCancellation): void {\n\t\tif (pending.deregister) return;\n\t\ttry {\n\t\t\tpending.deregister = (this.options.registerInFlightWork ?? registerInFlightWork)(\n\t\t\t\tthis.options.agentDir,\n\t\t\t\t\"lane\",\n\t\t\t\t`worker-cancellation-pending:${laneId}`,\n\t\t\t);\n\t\t} catch (error) {\n\t\t\tthis.warnBestEffort(\n\t\t\t\t`Worker ${laneId} cancellation reload-gate registration failed: ${error instanceof Error ? error.message : String(error)}`,\n\t\t\t);\n\t\t}\n\t}\n\n\tprivate retryPendingCancellations(): void {\n\t\tfor (const [laneId, pending] of [...this.pendingCancellations]) {\n\t\t\tthis.registerPendingCancellation(laneId, pending);\n\t\t\tif (!this.cancelBestEffort(laneId, pending.reasonCode)) continue;\n\t\t\tthis.removePendingCancellation(laneId);\n\t\t}\n\t}\n\n\tprivate removePendingCancellation(laneId: string): void {\n\t\tconst pending = this.pendingCancellations.get(laneId);\n\t\tif (!pending) return;\n\t\tthis.pendingCancellations.delete(laneId);\n\t\ttry {\n\t\t\tpending.deregister?.();\n\t\t} catch (error) {\n\t\t\tthis.warnBestEffort(\n\t\t\t\t`Worker ${laneId} cancellation reload-gate deregistration failed: ${error instanceof Error ? error.message : String(error)}`,\n\t\t\t);\n\t\t}\n\t}\n\n\tprivate cancelBestEffort(laneId: string, reasonCode: string): boolean {\n\t\ttry {\n\t\t\tthis.options.cancel(laneId, reasonCode);\n\t\t\treturn true;\n\t\t} catch (error) {\n\t\t\tthis.warnBestEffort(\n\t\t\t\t`Worker ${laneId} cancellation failed: ${error instanceof Error ? error.message : String(error)}`,\n\t\t\t);\n\t\t\treturn false;\n\t\t}\n\t}\n\n\tprivate finishTrackedRun(laneId: string): void {\n\t\tthis.running.delete(laneId);\n\t\tif (this.options.isDisposed()) {\n\t\t\t// A disposed generation has no future scheduler signal. Its durable state is recovered by the\n\t\t\t// next generation, so do not leak this generation's process-local reload blocker.\n\t\t\tthis.removePendingCancellation(laneId);\n\t\t\treturn;\n\t\t}\n\t\ttry {\n\t\t\tthis.drain();\n\t\t} catch (error) {\n\t\t\tthis.warnBestEffort(\n\t\t\t\t`Worker ${laneId} scheduler redrain failed: ${error instanceof Error ? error.message : String(error)}`,\n\t\t\t);\n\t\t}\n\t}\n\n\tprivate warnBestEffort(message: string): void {\n\t\ttry {\n\t\t\tthis.options.warn(message);\n\t\t} catch {\n\t\t\t// Diagnostics cannot retain a completed promise in the running set.\n\t\t}\n\t}\n\n\tdrain(reservationAvailable = false): void {\n\t\tif (this.options.isDisposed()) return;\n\t\tif (reservationAvailable) this.reservationAvailabilityRequested = true;\n\t\tif (this.draining) {\n\t\t\tthis.redrainRequested = true;\n\t\t\treturn;\n\t\t}\n\t\tthis.draining = true;\n\t\ttry {\n\t\t\t// Promise settlement and every later scheduler signal retry each retained durable cancellation\n\t\t\t// once. Keep this outside the redrain loop so a reentrant signal cannot create a busy retry.\n\t\t\tthis.retryPendingCancellations();\n\t\t\tdo {\n\t\t\t\tthis.redrainRequested = false;\n\t\t\t\tconst passReservationAvailable = this.reservationAvailabilityRequested;\n\t\t\t\tthis.reservationAvailabilityRequested = false;\n\t\t\t\tfor (const [laneId, request] of [...this.queued]) {\n\t\t\t\t\tif (this.reservationBlocked.has(laneId) && !passReservationAvailable) continue;\n\t\t\t\t\tconst record = this.options.getRecord(laneId);\n\t\t\t\t\tif (!record) {\n\t\t\t\t\t\tthis.removeQueued(laneId);\n\t\t\t\t\t\tcontinue;\n\t\t\t\t\t}\n\t\t\t\t\tconst admission = this.options.admit(request, record);\n\t\t\t\t\tif (admission.action === \"wait\") {\n\t\t\t\t\t\tif (admission.reason === \"write_reservation\") this.reservationBlocked.add(laneId);\n\t\t\t\t\t\telse this.reservationBlocked.delete(laneId);\n\t\t\t\t\t\tcontinue;\n\t\t\t\t\t}\n\t\t\t\t\tif (admission.action === \"cancel\") {\n\t\t\t\t\t\tthis.reservationBlocked.delete(laneId);\n\t\t\t\t\t\t// Durable cancellation owns this transition. Retain the scheduler entry when\n\t\t\t\t\t\t// that write fails so a later explicit drain can retry it without a busy loop.\n\t\t\t\t\t\tif (!this.cancelBestEffort(laneId, admission.reasonCode)) continue;\n\t\t\t\t\t\tthis.removeQueued(laneId);\n\t\t\t\t\t\t// Cancellation can synchronously block another queued task that appeared earlier.\n\t\t\t\t\t\t// Re-evaluate the bounded queue until that dependency cascade reaches a fixed point.\n\t\t\t\t\t\tthis.redrainRequested = true;\n\t\t\t\t\t\tcontinue;\n\t\t\t\t\t}\n\t\t\t\t\tthis.reservationBlocked.delete(laneId);\n\t\t\t\t\tthis.removeQueued(laneId);\n\t\t\t\t\tlet run: Promise<WorkerDelegationRunOutcome>;\n\t\t\t\t\ttry {\n\t\t\t\t\t\trun = this.options.run(request, record);\n\t\t\t\t\t} catch (error) {\n\t\t\t\t\t\t// Preserve synchronous start semantics while routing a throwing implementation\n\t\t\t\t\t\t// through the same cancellation and cleanup owner as a rejected run promise.\n\t\t\t\t\t\trun = Promise.reject(error);\n\t\t\t\t\t}\n\t\t\t\t\tthis.track(laneId, run);\n\t\t\t\t}\n\t\t\t} while ((this.redrainRequested || this.reservationAvailabilityRequested) && !this.options.isDisposed());\n\t\t} finally {\n\t\t\tthis.draining = false;\n\t\t}\n\t}\n\n\tcancelQueued(): void {\n\t\tfor (const laneId of [...this.queued.keys()]) {\n\t\t\t// The controller owns durable cancellation and any pre-admission resources (for example a\n\t\t\t// write reservation). Disposal must still visit every lane and release every process-local\n\t\t\t// blocker when one durable write fails; the next controller generation recovers any retained\n\t\t\t// durable queued attempt.\n\t\t\tthis.cancelBestEffort(laneId, \"session_disposed\");\n\t\t\tthis.removeQueued(laneId);\n\t\t}\n\t\tfor (const [laneId, pending] of [...this.pendingCancellations]) {\n\t\t\tthis.cancelBestEffort(laneId, pending.reasonCode);\n\t\t\t// Disposal hands any remaining durable recovery to the next controller generation. Release\n\t\t\t// this generation's process-local reload blocker even when its last cancellation attempt fails.\n\t\t\tthis.removePendingCancellation(laneId);\n\t\t}\n\t}\n\n\tdropQueued(laneId: string): boolean {\n\t\tif (!this.queued.has(laneId)) return false;\n\t\tthis.removeQueued(laneId);\n\t\treturn true;\n\t}\n\n\tprivate removeQueued(laneId: string): void {\n\t\tconst removed = this.queued.delete(laneId);\n\t\tthis.reservationBlocked.delete(laneId);\n\t\tconst deregister = this.queuedDeregisters.get(laneId);\n\t\tthis.queuedDeregisters.delete(laneId);\n\t\ttry {\n\t\t\tderegister?.();\n\t\t} catch (error) {\n\t\t\tthis.warnBestEffort(\n\t\t\t\t`Worker ${laneId} reload-gate deregistration failed: ${error instanceof Error ? error.message : String(error)}`,\n\t\t\t);\n\t\t}\n\t\tif (removed) this.notifyQueueCapacityAvailable();\n\t}\n\n\tprivate notifyQueueCapacityAvailable(): void {\n\t\tif (this.queueCapacityNotificationPending || this.queueCapacityListeners.size === 0) return;\n\t\tthis.queueCapacityNotificationPending = true;\n\t\tqueueMicrotask(() => {\n\t\t\tthis.queueCapacityNotificationPending = false;\n\t\t\tfor (const listener of this.queueCapacityListeners) {\n\t\t\t\ttry {\n\t\t\t\t\tlistener();\n\t\t\t\t} catch (error) {\n\t\t\t\t\tthis.warnBestEffort(\n\t\t\t\t\t\t`Worker queue-capacity listener failed: ${error instanceof Error ? error.message : String(error)}`,\n\t\t\t\t\t);\n\t\t\t\t}\n\t\t\t}\n\t\t});\n\t}\n}\n"]}

package/dist/core/delegation/worker-fleet-limits.d.ts

@@ -0,0 +1,38 @@
+import { type AgentBindingContract } from "../orchestration/contracts.ts";
+import type { TaskRuntimeProjection } from "../orchestration/task-runtime.ts";
+/**
+ * Process-independent safety ceilings for one durable session fleet. These limits bound persisted
+ * identity growth and scheduler fan-out; model/provider budgets remain separately authoritative.
+ */
+export interface WorkerFleetLimits {
+    maxDepth: number;
+    maxAgentsPerSession: number;
+    maxChildrenPerAgent: number;
+    maxQueuedDispatches: number;
+}
+export declare const DEFAULT_WORKER_FLEET_LIMITS: Readonly<WorkerFleetLimits>;
+export type NewWorkerAdmission = {
+    ok: true;
+    depth: number;
+} | {
+    ok: false;
+    reasonCode: "worker_agent_parent_unknown" | "worker_agent_parent_retired" | "worker_agent_depth_limit_reached" | "worker_agent_child_limit_reached" | "worker_agent_session_limit_reached";
+};
+export type WorkerIdentityHeadroomAdmission = {
+    ok: true;
+} | {
+    ok: false;
+    reasonCode: "worker_agent_session_limit_reached";
+};
+/** Subjects whose admitted verifier identity has not yet been materialized. */
+export declare function pendingVerifierSubjectTaskIds(snapshot: Pick<TaskRuntimeProjection, "agents" | "tasks" | "attempts">): Set<string>;
+/**
+ * A persistent-agent turn consumes no implementation identity, but its retained immutable contract
+ * can still require a fresh verifier. Protect both that verifier and every earlier reservation.
+ */
+export declare function evaluateReusableWorkerTaskAdmission(snapshot: Pick<TaskRuntimeProjection, "agents" | "tasks" | "attempts">, agentId: string, limits?: Readonly<WorkerFleetLimits>): WorkerIdentityHeadroomAdmission;
+/** Evaluate a new durable identity before a task, conversation, or scheduler entry is created. */
+export declare function evaluateNewWorkerAdmission(agents: Readonly<Record<string, AgentBindingContract>>, parentAgentId?: string, limits?: Readonly<WorkerFleetLimits>, requiredAgentSlots?: number): NewWorkerAdmission;
+/** Keep one queue slot reserved for an already-admitted mandatory verifier. */
+export declare function workerQueueHasCapacity(queuedCount: number, priority: boolean, limits?: Readonly<WorkerFleetLimits>): boolean;
+//# sourceMappingURL=worker-fleet-limits.d.ts.map

package/dist/core/delegation/worker-fleet-limits.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"worker-fleet-limits.d.ts","sourceRoot":"","sources":["../../../src/core/delegation/worker-fleet-limits.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,KAAK,oBAAoB,EAAoC,MAAM,+BAA+B,CAAC;AAC5G,OAAO,KAAK,EAAuB,qBAAqB,EAAE,MAAM,kCAAkC,CAAC;AAEnG;;;GAGG;AACH,MAAM,WAAW,iBAAiB;IACjC,QAAQ,EAAE,MAAM,CAAC;IACjB,mBAAmB,EAAE,MAAM,CAAC;IAC5B,mBAAmB,EAAE,MAAM,CAAC;IAC5B,mBAAmB,EAAE,MAAM,CAAC;CAC5B;AAED,eAAO,MAAM,2BAA2B,EAAE,QAAQ,CAAC,iBAAiB,CAKlE,CAAC;AAEH,MAAM,MAAM,kBAAkB,GAC3B;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GAC3B;IACA,EAAE,EAAE,KAAK,CAAC;IACV,UAAU,EACP,6BAA6B,GAC7B,6BAA6B,GAC7B,kCAAkC,GAClC,kCAAkC,GAClC,oCAAoC,CAAC;CACvC,CAAC;AAEL,MAAM,MAAM,+BAA+B,GACxC;IAAE,EAAE,EAAE,IAAI,CAAA;CAAE,GACZ;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,UAAU,EAAE,oCAAoC,CAAA;CAAE,CAAC;AAEnE,+EAA+E;AAC/E,wBAAgB,6BAA6B,CAC5C,QAAQ,EAAE,IAAI,CAAC,qBAAqB,EAAE,QAAQ,GAAG,OAAO,GAAG,UAAU,CAAC,GACpE,GAAG,CAAC,MAAM,CAAC,CA0Cb;AAgBD;;;GAGG;AACH,wBAAgB,mCAAmC,CAClD,QAAQ,EAAE,IAAI,CAAC,qBAAqB,EAAE,QAAQ,GAAG,OAAO,GAAG,UAAU,CAAC,EACtE,OAAO,EAAE,MAAM,EACf,MAAM,GAAE,QAAQ,CAAC,iBAAiB,CAA+B,GAC/D,+BAA+B,CAKjC;AAED,kGAAkG;AAClG,wBAAgB,0BAA0B,CACzC,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,oBAAoB,CAAC,CAAC,EACtD,aAAa,CAAC,EAAE,MAAM,EACtB,MAAM,GAAE,QAAQ,CAAC,iBAAiB,CAA+B,EACjE,kBAAkB,SAAI,GACpB,kBAAkB,CAoBpB;AAED,+EAA+E;AAC/E,wBAAgB,sBAAsB,CACrC,WAAW,EAAE,MAAM,EACnB,QAAQ,EAAE,OAAO,EACjB,MAAM,GAAE,QAAQ,CAAC,iBAAiB,CAA+B,GAC/D,OAAO,CAIT"}