@zhin.js/agent 1.1.13 → 1.1.14

package/lib/plugin-runtime/workroom-scheduler-portfolio-supply.js

@@ -0,0 +1,122 @@
+import { createToken } from '@zhin.js/plugin-runtime';
+import { parsePortfolioCapacityRequest } from '../portfolio/portfolio-journal.js';
+import { parseWorkroomDispatchTaskDecision, } from '../workroom/workroom-scheduler.js';
+import { WorkroomSchedulerAssignmentRouteUnavailableError, } from './workroom-scheduler-runtime.js';
+import { workroomSchedulerPortfolioOpaqueHeadId, workroomSchedulerPortfolioPayloadDigest, workroomSchedulerPortfolioRequestId, } from './workroom-scheduler-portfolio-contract.js';
+export const workroomSchedulerPortfolioRequestAuthorityToken = createToken('zhin.agent.workroom-scheduler-portfolio-request-authority', 'Trusted pinned Profile/Catalog/Task to content-free Portfolio Capacity Request projection');
+export class WorkroomSchedulerPortfolioCapacityUnavailableError extends WorkroomSchedulerAssignmentRouteUnavailableError {
+    constructor(decision, options) {
+        super(decision, options);
+        this.name = 'WorkroomSchedulerPortfolioCapacityUnavailableError';
+    }
+}
+/**
+ * The only production Scheduler supply: it can publish a content-free Capacity
+ * Request, but it has no Local/Remote Assignment issuer. The P11 Grant outbox
+ * and consume-first saga own all eventual Assignment claims.
+ */
+export class PortfolioFirstWorkroomSchedulerDispatchSupply {
+    options;
+    #generation;
+    constructor(options) {
+        this.options = options;
+        this.#generation = nonNegativeInteger(options.generation, 'generation');
+    }
+    async probe(decision) {
+        try {
+            await this.#resolve(decision);
+            return true;
+        }
+        catch {
+            return false;
+        }
+    }
+    async deliver(decision) {
+        const exactDecision = parseWorkroomDispatchTaskDecision(decision);
+        const resolved = await this.#resolve(exactDecision);
+        try {
+            await this.options.capacity.request(resolved.request);
+        }
+        catch (error) {
+            throw new WorkroomSchedulerPortfolioCapacityUnavailableError(exactDecision, { cause: error });
+        }
+    }
+    async #resolve(decision) {
+        const catalog = await this.options.catalog.read();
+        const definition = catalog.definitions[decision.projectId];
+        if (!definition || definition.enabled === false) {
+            throw new WorkroomSchedulerAssignmentRouteUnavailableError(decision);
+        }
+        const route = await this.options.routes.resolve({ decision, catalog });
+        if (!route)
+            throw new WorkroomSchedulerAssignmentRouteUnavailableError(decision);
+        let proposed;
+        try {
+            proposed = await this.options.requests.resolve({
+                generation: this.#generation,
+                decision,
+                route,
+                catalog,
+            });
+        }
+        catch (error) {
+            throw new WorkroomSchedulerPortfolioCapacityUnavailableError(decision, { cause: error });
+        }
+        if (!proposed)
+            throw new WorkroomSchedulerPortfolioCapacityUnavailableError(decision);
+        const request = parseExactRequest(proposed, this.#generation, decision, route);
+        return Object.freeze({ route, request });
+    }
+}
+function parseExactRequest(value, generation, decision, route) {
+    exactKeys(value, [
+        'generation', 'portfolioId', 'tenantId', 'catalogRevision', 'catalogDigest', 'capacityRequest',
+    ]);
+    const capacityRequest = parsePortfolioCapacityRequest(value.capacityRequest);
+    const canonical = Object.freeze({
+        generation: nonNegativeInteger(value.generation, 'request generation'),
+        portfolioId: text(value.portfolioId, 'portfolioId'),
+        tenantId: text(value.tenantId, 'tenantId'),
+        catalogRevision: nonNegativeInteger(value.catalogRevision, 'catalogRevision'),
+        catalogDigest: canonicalDigest(value.catalogDigest, 'catalogDigest'),
+        capacityRequest,
+    });
+    if (canonical.generation !== generation
+        || capacityRequest.requestId !== workroomSchedulerPortfolioRequestId(decision, route)
+        || capacityRequest.projectId !== decision.projectId
+        || capacityRequest.workRef.runId !== decision.runId
+        || capacityRequest.schedulerRevision !== decision.policy.digest
+        || capacityRequest.schedulerSequence !== decision.expectedSequence + 1
+        || capacityRequest.opaqueHeadId !== workroomSchedulerPortfolioOpaqueHeadId(decision)
+        || capacityRequest.payloadDigest !== workroomSchedulerPortfolioPayloadDigest(decision, route)) {
+        throw new Error('Portfolio Capacity Request is not bound to the exact Scheduler decision/route');
+    }
+    return canonical;
+}
+function exactKeys(value, expected) {
+    const actual = Object.keys(value).sort();
+    const canonical = [...expected].sort();
+    if (actual.length !== canonical.length
+        || actual.some((key, index) => key !== canonical[index])) {
+        throw new Error('Portfolio Capacity Request exact keys are invalid');
+    }
+}
+function text(value, label) {
+    if (typeof value !== 'string' || !value.trim() || value !== value.trim()) {
+        throw new Error(`Portfolio Capacity Request ${label} is invalid`);
+    }
+    return value;
+}
+function canonicalDigest(value, label) {
+    if (typeof value !== 'string' || !/^sha256:[a-f0-9]{64}$/u.test(value)) {
+        throw new Error(`Portfolio Capacity Request ${label} is invalid`);
+    }
+    return value;
+}
+function nonNegativeInteger(value, label) {
+    if (!Number.isSafeInteger(value) || Number(value) < 0) {
+        throw new Error(`Portfolio Capacity Request ${label} is invalid`);
+    }
+    return Number(value);
+}
+//# sourceMappingURL=workroom-scheduler-portfolio-supply.js.map

package/lib/plugin-runtime/workroom-scheduler-portfolio-supply.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"workroom-scheduler-portfolio-supply.js","sourceRoot":"","sources":["../../src/plugin-runtime/workroom-scheduler-portfolio-supply.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAEtD,OAAO,EAAE,6BAA6B,EAAE,MAAM,mCAAmC,CAAC;AAClF,OAAO,EACL,iCAAiC,GAElC,MAAM,mCAAmC,CAAC;AAK3C,OAAO,EACL,gDAAgD,GAIjD,MAAM,iCAAiC,CAAC;AACzC,OAAO,EACL,sCAAsC,EACtC,uCAAuC,EACvC,mCAAmC,GACpC,MAAM,4CAA4C,CAAC;AAYpD,MAAM,CAAC,MAAM,+CAA+C,GAC1D,WAAW,CACT,2DAA2D,EAC3D,2FAA2F,CAC5F,CAAC;AAUJ,MAAM,OAAO,kDACb,SAAQ,gDAAgD;IACtD,YAAY,QAAsC,EAAE,OAAsB;QACxE,KAAK,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;QACzB,IAAI,CAAC,IAAI,GAAG,oDAAoD,CAAC;IACnE,CAAC;CACF;AAED;;;;GAIG;AACH,MAAM,OAAO,6CAA6C;IAInC;IAFZ,WAAW,CAAS;IAE7B,YAAqB,OAA6D;QAA7D,YAAO,GAAP,OAAO,CAAsD;QAChF,IAAI,CAAC,WAAW,GAAG,kBAAkB,CAAC,OAAO,CAAC,UAAU,EAAE,YAAY,CAAC,CAAC;IAC1E,CAAC;IAED,KAAK,CAAC,KAAK,CAAC,QAAsC;QAChD,IAAI,CAAC;YACH,MAAM,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;YAC9B,OAAO,IAAI,CAAC;QACd,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,KAAK,CAAC;QACf,CAAC;IACH,CAAC;IAED,KAAK,CAAC,OAAO,CAAC,QAAsC;QAClD,MAAM,aAAa,GAAG,iCAAiC,CAAC,QAAQ,CAAC,CAAC;QAClE,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,QAAQ,CAAC,aAAa,CAAC,CAAC;QACpD,IAAI,CAAC;YACH,MAAM,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;QACxD,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,IAAI,kDAAkD,CAAC,aAAa,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC,CAAC;QAChG,CAAC;IACH,CAAC;IAED,KAAK,CAAC,QAAQ,CAAC,QAAsC;QAInD,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC;QAClD,MAAM,UAAU,GAAG,OAAO,CAAC,WAAW,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC;QAC3D,IAAI,CAAC,UAAU,IAAI,UAAU,CAAC,OAAO,KAAK,KAAK,EAAE,CAAC;YAChD,MAAM,IAAI,gDAAgD,CAAC,QAAQ,CAAC,CAAC;QACvE,CAAC;QACD,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,OAAO,CAAC,EAAE,QAAQ,EAAE,OAAO,EAAE,CAAC,CAAC;QACvE,IAAI,CAAC,KAAK;YAAE,MAAM,IAAI,gDAAgD,CAAC,QAAQ,CAAC,CAAC;QACjF,IAAI,QAAsD,CAAC;QAC3D,IAAI,CAAC;YACH,QAAQ,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAC;gBAC7C,UAAU,EAAE,IAAI,CAAC,WAAW;gBAC5B,QAAQ;gBACR,KAAK;gBACL,OAAO;aACR,CAAC,CAAC;QACL,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,IAAI,kDAAkD,CAAC,QAAQ,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC,CAAC;QAC3F,CAAC;QACD,IAAI,CAAC,QAAQ;YAAE,MAAM,IAAI,kDAAkD,CAAC,QAAQ,CAAC,CAAC;QACtF,MAAM,OAAO,GAAG,iBAAiB,CAAC,QAAQ,EAAE,IAAI,CAAC,WAAW,EAAE,QAAQ,EAAE,KAAK,CAAC,CAAC;QAC/E,OAAO,MAAM,CAAC,MAAM,CAAC,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC,CAAC;IAC3C,CAAC;CACF;AAED,SAAS,iBAAiB,CACxB,KAAuC,EACvC,UAAkB,EAClB,QAAsC,EACtC,KAAuC;IAEvC,SAAS,CAAC,KAAK,EAAE;QACf,YAAY,EAAE,aAAa,EAAE,UAAU,EAAE,iBAAiB,EAAE,eAAe,EAAE,iBAAiB;KAC/F,CAAC,CAAC;IACH,MAAM,eAAe,GAAG,6BAA6B,CAAC,KAAK,CAAC,eAAe,CAAC,CAAC;IAC7E,MAAM,SAAS,GAAqC,MAAM,CAAC,MAAM,CAAC;QAChE,UAAU,EAAE,kBAAkB,CAAC,KAAK,CAAC,UAAU,EAAE,oBAAoB,CAAC;QACtE,WAAW,EAAE,IAAI,CAAC,KAAK,CAAC,WAAW,EAAE,aAAa,CAAC;QACnD,QAAQ,EAAE,IAAI,CAAC,KAAK,CAAC,QAAQ,EAAE,UAAU,CAAC;QAC1C,eAAe,EAAE,kBAAkB,CAAC,KAAK,CAAC,eAAe,EAAE,iBAAiB,CAAC;QAC7E,aAAa,EAAE,eAAe,CAAC,KAAK,CAAC,aAAa,EAAE,eAAe,CAAC;QACpE,eAAe;KAChB,CAAC,CAAC;IACH,IAAI,SAAS,CAAC,UAAU,KAAK,UAAU;WAClC,eAAe,CAAC,SAAS,KAAK,mCAAmC,CAAC,QAAQ,EAAE,KAAK,CAAC;WAClF,eAAe,CAAC,SAAS,KAAK,QAAQ,CAAC,SAAS;WAChD,eAAe,CAAC,OAAO,CAAC,KAAK,KAAK,QAAQ,CAAC,KAAK;WAChD,eAAe,CAAC,iBAAiB,KAAK,QAAQ,CAAC,MAAM,CAAC,MAAM;WAC5D,eAAe,CAAC,iBAAiB,KAAK,QAAQ,CAAC,gBAAgB,GAAG,CAAC;WACnE,eAAe,CAAC,YAAY,KAAK,sCAAsC,CAAC,QAAQ,CAAC;WACjF,eAAe,CAAC,aAAa,KAAK,uCAAuC,CAAC,QAAQ,EAAE,KAAK,CAAC,EAAE,CAAC;QAChG,MAAM,IAAI,KAAK,CAAC,+EAA+E,CAAC,CAAC;IACnG,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,SAAS,SAAS,CAAC,KAAa,EAAE,QAA2B;IAC3D,MAAM,MAAM,GAAG,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,IAAI,EAAE,CAAC;IACzC,MAAM,SAAS,GAAG,CAAC,GAAG,QAAQ,CAAC,CAAC,IAAI,EAAE,CAAC;IACvC,IAAI,MAAM,CAAC,MAAM,KAAK,SAAS,CAAC,MAAM;WACjC,MAAM,CAAC,IAAI,CAAC,CAAC,GAAG,EAAE,KAAK,EAAE,EAAE,CAAC,GAAG,KAAK,SAAS,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC;QAC3D,MAAM,IAAI,KAAK,CAAC,mDAAmD,CAAC,CAAC;IACvE,CAAC;AACH,CAAC;AAED,SAAS,IAAI,CAAC,KAAc,EAAE,KAAa;IACzC,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,IAAI,KAAK,KAAK,KAAK,CAAC,IAAI,EAAE,EAAE,CAAC;QACzE,MAAM,IAAI,KAAK,CAAC,8BAA8B,KAAK,aAAa,CAAC,CAAC;IACpE,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED,SAAS,eAAe,CAAC,KAAc,EAAE,KAAa;IACpD,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,CAAC,wBAAwB,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC;QACvE,MAAM,IAAI,KAAK,CAAC,8BAA8B,KAAK,aAAa,CAAC,CAAC;IACpE,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED,SAAS,kBAAkB,CAAC,KAAc,EAAE,KAAa;IACvD,IAAI,CAAC,MAAM,CAAC,aAAa,CAAC,KAAK,CAAC,IAAI,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC;QACtD,MAAM,IAAI,KAAK,CAAC,8BAA8B,KAAK,aAAa,CAAC,CAAC;IACpE,CAAC;IACD,OAAO,MAAM,CAAC,KAAK,CAAC,CAAC;AACvB,CAAC"}

package/lib/plugin-runtime/workroom-scheduler-route-registry.d.ts

@@ -0,0 +1,27 @@
+import type { ProjectProfileRegistry } from '../workroom/profile-registry.js';
+import type { WorkroomSchedulerAssignmentRoute, WorkroomSchedulerAssignmentRoutePort } from './workroom-scheduler-runtime.js';
+export interface WorkroomSchedulerAssignmentRouteProvider {
+    readonly providerId: string;
+    readonly generation: number;
+    resolve(input: Parameters<WorkroomSchedulerAssignmentRoutePort['resolve']>[0]): Promise<WorkroomSchedulerAssignmentRoute | null>;
+}
+export interface GenerationOwnedWorkroomSchedulerAssignmentRouteRegistryOptions {
+    readonly generation: number;
+    readonly signal: AbortSignal;
+    readonly profiles: Pick<ProjectProfileRegistry, 'read'>;
+}
+export declare const workroomSchedulerAssignmentRouteRegistryToken: import("@zhin.js/plugin-runtime").Token<GenerationOwnedWorkroomSchedulerAssignmentRouteRegistry>;
+/**
+ * Combines independently installed local/remote route authorities without a
+ * first-wins policy. Exactly one provider must prove the route against the
+ * pinned Profile and current Catalog; zero or multiple candidates fail closed.
+ */
+export declare class GenerationOwnedWorkroomSchedulerAssignmentRouteRegistry implements WorkroomSchedulerAssignmentRoutePort {
+    #private;
+    readonly options: GenerationOwnedWorkroomSchedulerAssignmentRouteRegistryOptions;
+    constructor(options: GenerationOwnedWorkroomSchedulerAssignmentRouteRegistryOptions);
+    get generation(): number;
+    register(provider: WorkroomSchedulerAssignmentRouteProvider): () => void;
+    resolve(input: Parameters<WorkroomSchedulerAssignmentRoutePort['resolve']>[0]): Promise<WorkroomSchedulerAssignmentRoute | null>;
+}
+//# sourceMappingURL=workroom-scheduler-route-registry.d.ts.map

package/lib/plugin-runtime/workroom-scheduler-route-registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"workroom-scheduler-route-registry.d.ts","sourceRoot":"","sources":["../../src/plugin-runtime/workroom-scheduler-route-registry.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,iCAAiC,CAAC;AAG9E,OAAO,KAAK,EACV,gCAAgC,EAChC,oCAAoC,EACrC,MAAM,iCAAiC,CAAC;AAEzC,MAAM,WAAW,wCAAwC;IACvD,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,OAAO,CACL,KAAK,EAAE,UAAU,CAAC,oCAAoC,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,GACpE,OAAO,CAAC,gCAAgC,GAAG,IAAI,CAAC,CAAC;CACrD;AAED,MAAM,WAAW,8DAA8D;IAC7E,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAC;IAC7B,QAAQ,CAAC,QAAQ,EAAE,IAAI,CAAC,sBAAsB,EAAE,MAAM,CAAC,CAAC;CACzD;AAED,eAAO,MAAM,6CAA6C,kGAIvD,CAAC;AAEJ;;;;GAIG;AACH,qBAAa,uDACb,YAAW,oCAAoC;;IAIjC,QAAQ,CAAC,OAAO,EAAE,8DAA8D;gBAAvE,OAAO,EAAE,8DAA8D;IAI5F,IAAI,UAAU,IAAI,MAAM,CAEvB;IAED,QAAQ,CAAC,QAAQ,EAAE,wCAAwC,GAAG,MAAM,IAAI;IAelE,OAAO,CACX,KAAK,EAAE,UAAU,CAAC,oCAAoC,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,GACpE,OAAO,CAAC,gCAAgC,GAAG,IAAI,CAAC;CA8CpD"}

package/lib/plugin-runtime/workroom-scheduler-route-registry.js

@@ -0,0 +1,136 @@
+import { createToken } from '@zhin.js/plugin-runtime';
+import { compareCanonicalWorkroomText } from '../workroom/canonical-value.js';
+import { parseWorkroomDispatchTaskDecision } from '../workroom/workroom-scheduler.js';
+export const workroomSchedulerAssignmentRouteRegistryToken = createToken('zhin.agent.workroom-scheduler-assignment-route-registry', 'Generation-owned exact local/remote Assignment route registry');
+/**
+ * Combines independently installed local/remote route authorities without a
+ * first-wins policy. Exactly one provider must prove the route against the
+ * pinned Profile and current Catalog; zero or multiple candidates fail closed.
+ */
+export class GenerationOwnedWorkroomSchedulerAssignmentRouteRegistry {
+    options;
+    #generation;
+    #providers = new Map();
+    constructor(options) {
+        this.options = options;
+        this.#generation = nonNegativeInteger(options.generation, 'generation');
+    }
+    get generation() {
+        return this.#generation;
+    }
+    register(provider) {
+        this.options.signal.throwIfAborted();
+        const providerId = text(provider.providerId, 'providerId');
+        if (provider.generation !== this.#generation) {
+            throw new Error('Workroom Scheduler route provider generation is stale');
+        }
+        if (this.#providers.has(providerId)) {
+            throw new Error(`Workroom Scheduler route provider ${providerId} is already registered`);
+        }
+        this.#providers.set(providerId, provider);
+        return () => {
+            if (this.#providers.get(providerId) === provider)
+                this.#providers.delete(providerId);
+        };
+    }
+    async resolve(input) {
+        this.options.signal.throwIfAborted();
+        const decision = parseWorkroomDispatchTaskDecision(input.decision);
+        const catalog = input.catalog;
+        const definition = catalog.definitions[decision.projectId];
+        if (!definition || definition.enabled === false)
+            return null;
+        const pinnedAgentIds = await this.#pinnedAgentIds(decision.projectId, decision.runId, decision.role)
+            .catch(() => null);
+        if (!pinnedAgentIds)
+            return null;
+        const candidates = [];
+        for (const provider of [...this.#providers.values()]
+            .sort((left, right) => compareCanonicalWorkroomText(left.providerId, right.providerId))) {
+            this.options.signal.throwIfAborted();
+            let candidate;
+            try {
+                candidate = await provider.resolve({ decision, catalog });
+            }
+            catch {
+                return null;
+            }
+            if (!candidate)
+                continue;
+            const route = parseRoute(candidate);
+            const catalogMatches = definition.members.filter(member => member.role === decision.role && member.agent === route.agentDefinitionId);
+            if (catalogMatches.length !== 1 || !pinnedAgentIds.has(route.agentDefinitionId))
+                return null;
+            if (!matchesPersistedRoute(catalogMatches[0].assignmentRoute, route))
+                continue;
+            candidates.push(route);
+        }
+        return candidates.length === 1 ? candidates[0] : null;
+    }
+    async #pinnedAgentIds(projectId, runId, role) {
+        const registry = await this.options.profiles.read(projectId);
+        const pin = registry.runPins[runId];
+        if (!pin || pin.projectId !== projectId || pin.runId !== runId)
+            return null;
+        const revision = registry.revisions[pin.profileRevisionId];
+        if (!revision || revision.projectId !== projectId
+            || revision.compiledDigest !== pin.profileDigest
+            || revision.compiledProfile.revisionId !== pin.profileRevisionId
+            || revision.compiledProfile.projectId !== projectId
+            || revision.compiledProfile.digest !== pin.profileDigest)
+            return null;
+        const ids = revision.compiledProfile.agents
+            .filter(agent => agent.role === role)
+            .map(agent => agent.id);
+        return new Set(ids);
+    }
+}
+function matchesPersistedRoute(authority, route) {
+    if (!authority || authority.kind === 'local')
+        return route.kind === 'local';
+    return route.kind === 'remote' && route.endpointId === authority.endpointId;
+}
+function parseRoute(value) {
+    if (!value || typeof value !== 'object' || Array.isArray(value)) {
+        throw new Error('Workroom Scheduler route shape is invalid');
+    }
+    if (value.kind === 'local') {
+        exactKeys(value, ['kind', 'agentDefinitionId', 'authorityRef']);
+        return Object.freeze({
+            kind: 'local',
+            agentDefinitionId: text(value.agentDefinitionId, 'agentDefinitionId'),
+            authorityRef: text(value.authorityRef, 'authorityRef'),
+        });
+    }
+    if (value.kind === 'remote') {
+        exactKeys(value, ['kind', 'agentDefinitionId', 'endpointId', 'authorityRef']);
+        return Object.freeze({
+            kind: 'remote',
+            agentDefinitionId: text(value.agentDefinitionId, 'agentDefinitionId'),
+            endpointId: text(value.endpointId, 'endpointId'),
+            authorityRef: text(value.authorityRef, 'authorityRef'),
+        });
+    }
+    throw new Error('Workroom Scheduler route kind is invalid');
+}
+function exactKeys(value, expected) {
+    const actual = Object.keys(value).sort();
+    const canonical = [...expected].sort();
+    if (actual.length !== canonical.length
+        || actual.some((key, index) => key !== canonical[index])) {
+        throw new Error('Workroom Scheduler route keys are invalid');
+    }
+}
+function text(value, label) {
+    if (typeof value !== 'string' || !value.trim() || value !== value.trim()) {
+        throw new Error(`Workroom Scheduler route ${label} is invalid`);
+    }
+    return value;
+}
+function nonNegativeInteger(value, label) {
+    if (!Number.isSafeInteger(value) || Number(value) < 0) {
+        throw new Error(`Workroom Scheduler route ${label} is invalid`);
+    }
+    return Number(value);
+}
+//# sourceMappingURL=workroom-scheduler-route-registry.js.map

package/lib/plugin-runtime/workroom-scheduler-route-registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"workroom-scheduler-route-registry.js","sourceRoot":"","sources":["../../src/plugin-runtime/workroom-scheduler-route-registry.ts"],"names":[],"mappings":"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"}

package/lib/plugin-runtime/workroom-scheduler-runtime.d.ts

@@ -0,0 +1,84 @@
+import type { WorkroomRunState } from '../workroom/kernel-contracts.js';
+import type { WorkroomJournal } from '../workroom/journal.js';
+import type { WorkroomCatalog } from '../workroom/catalog.js';
+import type { RemoteAssignmentDispatchCommandService } from '../workroom/remote-assignment-dispatch-command.js';
+import { type WorkroomSchedulerKernelCommandPort } from '../workroom/workroom-scheduler-application.js';
+export { createWorkroomSchedulerKernelCommandPort } from '../workroom/workroom-scheduler-application.js';
+import { type WorkroomDispatchTaskDecision } from '../workroom/workroom-scheduler.js';
+export interface WorkroomSchedulerDispatchSupplyPort {
+    /** Side-effect-free exact readiness probe used only to recover this decision's supply blocker. */
+    probe?(decision: WorkroomDispatchTaskDecision): Promise<boolean>;
+    /** Idempotently consumes a durable scheduler.dispatch_requested fact. */
+    deliver(decision: WorkroomDispatchTaskDecision): Promise<void>;
+}
+export interface RemoteWorkroomSchedulerDispatchSupplyOptions {
+    readonly catalog: Pick<WorkroomCatalog, 'read'>;
+    readonly runState: Readonly<{
+        read(projectId: string, runId: string): Promise<WorkroomRunState>;
+        pinTaskAcceptance(projectId: string, runId: string, taskKey: string): Promise<WorkroomRunState>;
+    }>;
+    readonly dispatch: Pick<RemoteAssignmentDispatchCommandService, 'issue'>;
+    readonly route: WorkroomSchedulerAssignmentRoutePort;
+}
+export interface WorkroomSchedulerAssignmentRoutePort {
+    resolve(input: Readonly<{
+        decision: WorkroomDispatchTaskDecision;
+        catalog: Awaited<ReturnType<WorkroomCatalog['read']>>;
+    }>): Promise<WorkroomSchedulerAssignmentRoute | null>;
+}
+export type WorkroomSchedulerAssignmentRoute = Readonly<{
+    kind: 'local';
+    agentDefinitionId: string;
+    authorityRef: string;
+}> | Readonly<{
+    kind: 'remote';
+    agentDefinitionId: string;
+    endpointId: string;
+    authorityRef: string;
+}>;
+export declare class WorkroomSchedulerAssignmentRouteUnavailableError extends Error {
+    readonly decision: WorkroomDispatchTaskDecision;
+    constructor(decision: WorkroomDispatchTaskDecision, options?: ErrorOptions);
+}
+/** Supply owns an exact durable blocker outside the Kernel Journal. */
+export declare class WorkroomSchedulerDurablyBlockedError extends Error {
+    readonly decision: WorkroomDispatchTaskDecision;
+    readonly blockerRef: string;
+    constructor(decision: WorkroomDispatchTaskDecision, blockerRef: string);
+}
+/** Exact, ambiguity-free Catalog + remote command adapter for Scheduler outbox facts. */
+export declare class RemoteWorkroomSchedulerDispatchSupply implements WorkroomSchedulerDispatchSupplyPort {
+    readonly options: RemoteWorkroomSchedulerDispatchSupplyOptions;
+    constructor(options: RemoteWorkroomSchedulerDispatchSupplyOptions);
+    deliver(decision: WorkroomDispatchTaskDecision): Promise<void>;
+}
+export declare const workroomSchedulerDispatchSupplyToken: import("@zhin.js/plugin-runtime").Token<WorkroomSchedulerDispatchSupplyPort>;
+export declare const workroomSchedulerRuntimeToken: import("@zhin.js/plugin-runtime").Token<WorkroomSchedulerRuntime>;
+export declare class WorkroomSchedulerSupplyUnavailableError extends Error {
+    constructor();
+}
+export interface WorkroomSchedulerRuntimeOptions {
+    readonly journal: Pick<WorkroomJournal, 'listRunIds' | 'read'>;
+    readonly commands: WorkroomSchedulerKernelCommandPort;
+    readonly resolveSupply: () => WorkroomSchedulerDispatchSupplyPort | undefined;
+    readonly unavailableControl?: Readonly<{
+        block(decision: WorkroomDispatchTaskDecision): Promise<void>;
+        recover(decision: WorkroomDispatchTaskDecision): Promise<void>;
+    }>;
+    readonly intervalMs?: number;
+    readonly onError?: (error: unknown) => void;
+}
+export interface WorkroomSchedulerDrainResult {
+    readonly scheduled: number;
+    readonly delivered: number;
+}
+/** Generation-owned wake/recovery loop; all queue truth remains in Journal. */
+export declare class WorkroomSchedulerRuntime {
+    #private;
+    readonly options: WorkroomSchedulerRuntimeOptions;
+    constructor(options: WorkroomSchedulerRuntimeOptions);
+    start(): void;
+    drain(): Promise<WorkroomSchedulerDrainResult>;
+    dispose(): Promise<void>;
+}
+//# sourceMappingURL=workroom-scheduler-runtime.d.ts.map

package/lib/plugin-runtime/workroom-scheduler-runtime.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"workroom-scheduler-runtime.d.ts","sourceRoot":"","sources":["../../src/plugin-runtime/workroom-scheduler-runtime.ts"],"names":[],"mappings":"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"}

package/lib/plugin-runtime/workroom-scheduler-runtime.js

@@ -0,0 +1,231 @@
+import { compareCanonicalWorkroomText } from '../workroom/canonical-value.js';
+import { createToken } from '@zhin.js/plugin-runtime';
+import { WorkroomSchedulerApplication, } from '../workroom/workroom-scheduler-application.js';
+export { createWorkroomSchedulerKernelCommandPort } from '../workroom/workroom-scheduler-application.js';
+import { decideWorkroomSchedule, parseWorkroomDispatchTaskDecision, } from '../workroom/workroom-scheduler.js';
+export class WorkroomSchedulerAssignmentRouteUnavailableError extends Error {
+    decision;
+    constructor(decision, options) {
+        super(`Workroom Scheduler Assignment route is unavailable for ${decision.taskKey}`, options);
+        this.decision = decision;
+        this.name = 'WorkroomSchedulerAssignmentRouteUnavailableError';
+    }
+}
+/** Supply owns an exact durable blocker outside the Kernel Journal. */
+export class WorkroomSchedulerDurablyBlockedError extends Error {
+    decision;
+    blockerRef;
+    constructor(decision, blockerRef) {
+        super(`Workroom Scheduler supply remains durably blocked for ${decision.taskKey}`);
+        this.decision = decision;
+        this.blockerRef = blockerRef;
+        this.name = 'WorkroomSchedulerDurablyBlockedError';
+    }
+}
+/** Exact, ambiguity-free Catalog + remote command adapter for Scheduler outbox facts. */
+export class RemoteWorkroomSchedulerDispatchSupply {
+    options;
+    constructor(options) {
+        this.options = options;
+    }
+    async deliver(decision) {
+        const catalog = await this.options.catalog.read();
+        const definition = catalog.definitions[decision.projectId];
+        if (!definition || definition.enabled === false) {
+            throw new Error(`Workroom Scheduler Project ${decision.projectId} is not enabled in Catalog`);
+        }
+        const route = await this.options.route.resolve({ decision, catalog });
+        if (!route || route.kind !== 'remote') {
+            throw new WorkroomSchedulerAssignmentRouteUnavailableError(decision);
+        }
+        const agentDefinitionId = requiredText(route.agentDefinitionId, 'agentDefinitionId');
+        const endpointId = requiredText(route.endpointId, 'endpointId');
+        requiredText(route.authorityRef, 'authorityRef');
+        if (!definition.members.some(member => member.role === decision.role && member.agent === agentDefinitionId)) {
+            throw new Error('Workroom Scheduler Assignment route is outside the exact Catalog role binding');
+        }
+        let state = await this.options.runState.read(decision.projectId, decision.runId);
+        let task = state.tasks[decision.taskKey];
+        if (!task || task.revision !== decision.taskRevision || task.status !== 'ready') {
+            throw new Error('Workroom Scheduler dispatch decision is stale for current Task state');
+        }
+        if (!task.acceptanceContract) {
+            state = await this.options.runState.pinTaskAcceptance(decision.projectId, decision.runId, decision.taskKey);
+            task = state.tasks[decision.taskKey];
+            if (!task?.acceptanceContract) {
+                throw new Error('Workroom Scheduler supply failed to pin Task Acceptance Contract');
+            }
+        }
+        await this.options.dispatch.issue({
+            operationId: decision.decisionId,
+            projectId: decision.projectId,
+            runId: decision.runId,
+            taskKey: decision.taskKey,
+            agentDefinitionId,
+            endpointId,
+        });
+    }
+}
+export const workroomSchedulerDispatchSupplyToken = createToken('zhin.agent.workroom-scheduler-dispatch-supply', 'Generation-owned Assignment authority/supply consuming durable Workroom Scheduler decisions');
+export const workroomSchedulerRuntimeToken = createToken('zhin.agent.workroom-scheduler-runtime', 'Generation-owned deterministic Workroom Scheduler recovery loop');
+export class WorkroomSchedulerSupplyUnavailableError extends Error {
+    constructor() {
+        super('Workroom Scheduler Assignment authority/supply is not installed');
+        this.name = 'WorkroomSchedulerSupplyUnavailableError';
+    }
+}
+/** Generation-owned wake/recovery loop; all queue truth remains in Journal. */
+export class WorkroomSchedulerRuntime {
+    options;
+    #application;
+    #intervalMs;
+    #timer;
+    #running;
+    #stopped = false;
+    constructor(options) {
+        this.options = options;
+        this.#intervalMs = positiveInteger(options.intervalMs ?? 1_000, 'intervalMs');
+        this.#application = new WorkroomSchedulerApplication({
+            journal: options.journal,
+            commands: options.commands,
+        });
+    }
+    start() {
+        if (this.#stopped)
+            throw new Error('Workroom Scheduler Runtime is stopped');
+        if (this.#timer)
+            return;
+        this.#schedule(0);
+    }
+    async drain() {
+        if (this.#stopped)
+            throw new Error('Workroom Scheduler Runtime is stopped');
+        if (this.#running)
+            return await this.#running;
+        const running = this.#drain();
+        this.#running = running;
+        try {
+            return await running;
+        }
+        finally {
+            if (this.#running === running)
+                this.#running = undefined;
+        }
+    }
+    async dispose() {
+        this.#stopped = true;
+        if (this.#timer)
+            clearTimeout(this.#timer);
+        this.#timer = undefined;
+        await this.#running;
+    }
+    async #drain() {
+        const supply = this.options.resolveSupply();
+        if (!supply) {
+            if (this.options.unavailableControl) {
+                for (const runId of [...await this.options.journal.listRunIds()].sort()) {
+                    const decision = decideWorkroomSchedule(await this.options.journal.read(runId));
+                    if (decision?.type === 'dispatch_task')
+                        await this.options.unavailableControl.block(decision);
+                }
+            }
+            throw new WorkroomSchedulerSupplyUnavailableError();
+        }
+        const attempted = new Set();
+        let delivered = await this.#recoverPending(supply, attempted);
+        const scheduled = (await this.#application.recover())
+            .filter(result => result.status === 'committed').length;
+        delivered += await this.#recoverPending(supply, attempted);
+        return Object.freeze({ scheduled, delivered });
+    }
+    async #recoverPending(supply, attempted) {
+        let delivered = 0;
+        for (const runId of [...await this.options.journal.listRunIds()].sort()) {
+            const events = await this.options.journal.read(runId);
+            for (const decision of pendingDispatches(events)) {
+                if (attempted.has(decision.decisionId))
+                    continue;
+                attempted.add(decision.decisionId);
+                try {
+                    if (supply.probe) {
+                        const ready = await supply.probe(decision);
+                        if (!ready) {
+                            await this.options.unavailableControl?.block(decision);
+                            continue;
+                        }
+                    }
+                    await supply.deliver(decision);
+                    await this.options.unavailableControl?.recover(decision);
+                }
+                catch (error) {
+                    if (error instanceof WorkroomSchedulerDurablyBlockedError)
+                        continue;
+                    if (error instanceof WorkroomSchedulerAssignmentRouteUnavailableError
+                        && this.options.unavailableControl) {
+                        await this.options.unavailableControl.block(decision);
+                        continue;
+                    }
+                    throw error;
+                }
+                delivered += 1;
+            }
+        }
+        return delivered;
+    }
+    #schedule(delay) {
+        this.#timer = setTimeout(() => {
+            this.#timer = undefined;
+            if (this.#stopped)
+                return;
+            void this.drain()
+                .catch(error => this.options.onError?.(error))
+                .finally(() => {
+                if (!this.#stopped)
+                    this.#schedule(this.#intervalMs);
+            });
+        }, delay);
+        this.#timer.unref?.();
+    }
+}
+function pendingDispatches(events) {
+    const latestTerminal = new Map();
+    const latestClaim = new Map();
+    const latestRevision = new Map();
+    let cancelledAt = Number.POSITIVE_INFINITY;
+    for (const event of events) {
+        if (event.type === 'run.cancel_requested' || event.type === 'run.cancelled') {
+            cancelledAt = Math.min(cancelledAt, event.sequence);
+        }
+        if (event.type === 'assignment.claimed') {
+            latestClaim.set(`${String(event.payload.taskKey)}:${Number(event.payload.taskRevision)}`, event.sequence);
+        }
+        if (event.type === 'task.accepted' || event.type === 'task.failed' || event.type === 'task.cancelled') {
+            latestTerminal.set(String(event.payload.taskKey), event.sequence);
+        }
+        if (event.type === 'task.revised' || event.type === 'task.rework_requested') {
+            latestRevision.set(String(event.payload.taskKey), event.sequence);
+        }
+    }
+    return Object.freeze(events
+        .filter(event => event.type === 'scheduler.dispatch_requested')
+        .map(event => Object.freeze({ event, decision: parseWorkroomDispatchTaskDecision(event.payload) }))
+        .filter(({ event, decision }) => event.sequence < cancelledAt
+        && (latestClaim.get(`${decision.taskKey}:${decision.taskRevision}`) ?? -1) <= event.sequence
+        && (latestTerminal.get(decision.taskKey) ?? -1) <= event.sequence
+        && (latestRevision.get(decision.taskKey) ?? -1) <= event.sequence)
+        .map(({ decision }) => decision)
+        .sort((left, right) => compareCanonicalWorkroomText(left.decisionId, right.decisionId)));
+}
+function positiveInteger(value, label) {
+    if (!Number.isSafeInteger(value) || Number(value) < 1) {
+        throw new Error(`Workroom Scheduler Runtime ${label} must be a positive safe integer`);
+    }
+    return Number(value);
+}
+function requiredText(value, label) {
+    if (typeof value !== 'string' || !value.trim() || value !== value.trim()) {
+        throw new Error(`Remote Workroom Scheduler supply ${label} is required`);
+    }
+    return value;
+}
+//# sourceMappingURL=workroom-scheduler-runtime.js.map