@zhin.js/agent 1.1.13 → 1.1.14

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

@@ -0,0 +1,179 @@
+import { WorkroomEffectLedger, WorkroomEffectSequenceConflictError, replayWorkroomEffectLedger, } from '../workroom/effect-ledger.js';
+export class WorkroomEffectOutcomeUnknownError extends Error {
+    receipt;
+    constructor(receipt) {
+        super('Workroom Effect outcome is unknown and requires reconciliation');
+        this.receipt = receipt;
+        this.name = 'WorkroomEffectOutcomeUnknownError';
+        if (receipt.outcome !== 'outcome_unknown') {
+            throw new Error('OutcomeUnknown error requires an outcome_unknown receipt');
+        }
+    }
+}
+/**
+ * Restart-safe outbox worker. The Effect Journal is the outbox: an attempt is
+ * durable before dispatch. A recovered attempt is reconciled, never executed
+ * again blindly.
+ */
+export class WorkroomEffectRuntime {
+    options;
+    #ledger;
+    #now;
+    #intervalMs;
+    #timer;
+    #running;
+    #stopped = false;
+    constructor(options) {
+        this.options = options;
+        if (!options.workerId.trim())
+            throw new Error('Effect Runtime workerId is required');
+        if (!Number.isSafeInteger(options.fence) || options.fence < 1) {
+            throw new Error('Effect Runtime fence is invalid');
+        }
+        this.#ledger = new WorkroomEffectLedger(options.journal, options.authorization);
+        this.#now = options.now ?? Date.now;
+        this.#intervalMs = positive(options.intervalMs ?? 1_000, 'intervalMs');
+        if (Boolean(options.blockers) !== Boolean(options.blockerPolicy)) {
+            throw new Error('Effect Runtime durable blocker control requires trusted blocker policy');
+        }
+        options.signal?.addEventListener('abort', () => { void this.dispose(); }, { once: true });
+    }
+    start() {
+        if (this.#stopped)
+            throw new Error('Effect Runtime is stopped');
+        if (this.#timer)
+            return;
+        this.#schedule(0);
+    }
+    async drain(signal = this.options.signal ?? new AbortController().signal) {
+        if (this.#stopped)
+            throw new Error('Effect Runtime is stopped');
+        if (!this.options.projects)
+            throw new Error('Effect Runtime Project source is unavailable');
+        if (this.#running)
+            return await this.#running;
+        const running = this.#drain(signal);
+        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 runOnce(projectId, signal) {
+        signal.throwIfAborted();
+        const initial = replayWorkroomEffectLedger(projectId, await this.options.journal.read(projectId));
+        const results = [];
+        for (const effectId of Object.keys(initial).sort()) {
+            signal.throwIfAborted();
+            const state = await this.#ledger.read(projectId, effectId);
+            if (state.status === 'pending_authorization') {
+                try {
+                    await this.options.gateway.prepare?.(state, signal);
+                    const startedAt = this.options.clock
+                        ? await this.options.clock.read(state)
+                        : this.#now();
+                    const started = await this.#ledger.startAuthorizedAttempt(projectId, effectId, {
+                        operationId: `effect-operation:${effectId}:${this.options.fence}`,
+                        workerId: this.options.workerId,
+                        fence: this.options.fence,
+                        startedAt,
+                    });
+                    const settled = await this.#dispatch(started, signal);
+                    await this.options.blockers?.recover(projectId, effectId);
+                    results.push(settled);
+                }
+                catch (error) {
+                    if (error instanceof WorkroomEffectSequenceConflictError)
+                        continue;
+                    await this.#block(state, 'prepare_or_authorize', error);
+                }
+            }
+            else if (state.status === 'executing' || state.status === 'outcome_unknown') {
+                try {
+                    const settled = await this.#reconcile(state, signal);
+                    await this.options.blockers?.recover(projectId, effectId);
+                    results.push(settled);
+                }
+                catch (error) {
+                    if (error instanceof WorkroomEffectSequenceConflictError)
+                        continue;
+                    await this.#block(state, 'reconcile', error);
+                }
+            }
+        }
+        return Object.freeze(results);
+    }
+    async #dispatch(state, signal) {
+        try {
+            return await this.#ledger.recordReceipt(state.projectId, state.intent.id, await this.options.gateway.execute(state, signal));
+        }
+        catch (error) {
+            if (!(error instanceof WorkroomEffectOutcomeUnknownError))
+                throw error;
+            return await this.#ledger.recordReceipt(state.projectId, state.intent.id, error.receipt);
+        }
+    }
+    async #reconcile(state, signal) {
+        try {
+            return await this.#ledger.recordReceipt(state.projectId, state.intent.id, await this.options.gateway.reconcile(state, signal));
+        }
+        catch (error) {
+            if (!(error instanceof WorkroomEffectOutcomeUnknownError))
+                throw error;
+            if (state.status === 'outcome_unknown'
+                && state.receipt?.receiptId === error.receipt.receiptId)
+                return state;
+            return await this.#ledger.recordReceipt(state.projectId, state.intent.id, error.receipt);
+        }
+    }
+    async #drain(signal) {
+        const results = [];
+        for (const projectId of [...await this.options.projects.listProjectIds()].sort()) {
+            results.push(...await this.runOnce(projectId, signal));
+        }
+        return Object.freeze(results);
+    }
+    async #block(state, phase, error) {
+        if (!this.options.blockers)
+            throw error;
+        const reason = error instanceof Error ? error.message : String(error);
+        const policy = await this.options.blockerPolicy.resolve({ state, phase, reason });
+        await this.options.blockers.block(Object.freeze({
+            projectId: state.projectId,
+            effectId: state.intent.id,
+            owner: policy.owner,
+            policy: policy.policy,
+            reason,
+            deadline: policy.deadline,
+            allowedSuccessors: policy.allowedSuccessors,
+        }));
+    }
+    #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 positive(value, label) {
+    if (!Number.isSafeInteger(value) || Number(value) < 1)
+        throw new Error(`${label} is invalid`);
+    return Number(value);
+}
+//# sourceMappingURL=workroom-effect-runtime.js.map

package/lib/plugin-runtime/workroom-effect-runtime.js.map

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

package/lib/plugin-runtime/workroom-governed-dispatch-composition.d.ts

@@ -0,0 +1,27 @@
+import type { WorkroomDisclosureManifestAuthorityPort } from './workroom-data-governance-runtime.js';
+export interface WorkroomGovernedDispatchGenerationBinding {
+    readonly generation: number;
+    readonly port: Pick<WorkroomDisclosureManifestAuthorityPort, 'revalidate'>;
+}
+export interface WorkroomGovernedOutboundComposition {
+    readonly projection: WorkroomDisclosureManifestAuthorityPort;
+    readonly remote: Pick<WorkroomDisclosureManifestAuthorityPort, 'revalidate'>;
+}
+/**
+ * Generation composition for the two outbound sinks. Projection needs trusted
+ * materialization; Remote gets revalidation only and cannot mint a Manifest.
+ */
+export declare function createGenerationOwnedWorkroomGovernedOutboundComposition(options: Readonly<{
+    generation: number;
+    signal: AbortSignal;
+    runtime: Readonly<{
+        generation: number;
+        disclosureManifest: WorkroomDisclosureManifestAuthorityPort;
+    }>;
+}>): WorkroomGovernedOutboundComposition;
+export declare function createGenerationOwnedWorkroomGovernedDispatchPort(options: Readonly<{
+    generation: number;
+    signal: AbortSignal;
+    resolve(): WorkroomGovernedDispatchGenerationBinding | undefined;
+}>): Pick<WorkroomDisclosureManifestAuthorityPort, 'revalidate'>;
+//# sourceMappingURL=workroom-governed-dispatch-composition.d.ts.map

package/lib/plugin-runtime/workroom-governed-dispatch-composition.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"workroom-governed-dispatch-composition.d.ts","sourceRoot":"","sources":["../../src/plugin-runtime/workroom-governed-dispatch-composition.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,uCAAuC,EACxC,MAAM,uCAAuC,CAAC;AAE/C,MAAM,WAAW,yCAAyC;IACxD,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,IAAI,EAAE,IAAI,CAAC,uCAAuC,EAAE,YAAY,CAAC,CAAC;CAC5E;AAED,MAAM,WAAW,mCAAmC;IAClD,QAAQ,CAAC,UAAU,EAAE,uCAAuC,CAAC;IAC7D,QAAQ,CAAC,MAAM,EAAE,IAAI,CAAC,uCAAuC,EAAE,YAAY,CAAC,CAAC;CAC9E;AAED;;;GAGG;AACH,wBAAgB,wDAAwD,CAAC,OAAO,EAAE,QAAQ,CAAC;IACzF,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,WAAW,CAAC;IACpB,OAAO,EAAE,QAAQ,CAAC;QAChB,UAAU,EAAE,MAAM,CAAC;QACnB,kBAAkB,EAAE,uCAAuC,CAAC;KAC7D,CAAC,CAAC;CACJ,CAAC,GAAG,mCAAmC,CAevC;AAED,wBAAgB,iDAAiD,CAAC,OAAO,EAAE,QAAQ,CAAC;IAClF,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,WAAW,CAAC;IACpB,OAAO,IAAI,yCAAyC,GAAG,SAAS,CAAC;CAClE,CAAC,GAAG,IAAI,CAAC,uCAAuC,EAAE,YAAY,CAAC,CAiB/D"}

package/lib/plugin-runtime/workroom-governed-dispatch-composition.js

@@ -0,0 +1,40 @@
+/**
+ * Generation composition for the two outbound sinks. Projection needs trusted
+ * materialization; Remote gets revalidation only and cannot mint a Manifest.
+ */
+export function createGenerationOwnedWorkroomGovernedOutboundComposition(options) {
+    if (options.runtime.generation !== options.generation) {
+        throw new Error('Workroom governed outbound authority targets another Root generation');
+    }
+    return Object.freeze({
+        projection: options.runtime.disclosureManifest,
+        remote: createGenerationOwnedWorkroomGovernedDispatchPort({
+            generation: options.generation,
+            signal: options.signal,
+            resolve: () => Object.freeze({
+                generation: options.runtime.generation,
+                port: options.runtime.disclosureManifest,
+            }),
+        }),
+    });
+}
+export function createGenerationOwnedWorkroomGovernedDispatchPort(options) {
+    if (!Number.isSafeInteger(options.generation) || options.generation < 1) {
+        throw new Error('Workroom governed dispatch generation is invalid');
+    }
+    return Object.freeze({
+        revalidate: async (...args) => {
+            options.signal.throwIfAborted();
+            const current = options.resolve();
+            if (!current)
+                throw new Error('Workroom governed dispatch authority is unavailable');
+            if (current.generation !== options.generation) {
+                throw new Error('Workroom governed dispatch authority escaped its Root generation');
+            }
+            const operationSignal = args[1];
+            const signal = AbortSignal.any([options.signal, operationSignal]);
+            return await current.port.revalidate(args[0], signal);
+        },
+    });
+}
+//# sourceMappingURL=workroom-governed-dispatch-composition.js.map

package/lib/plugin-runtime/workroom-governed-dispatch-composition.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"workroom-governed-dispatch-composition.js","sourceRoot":"","sources":["../../src/plugin-runtime/workroom-governed-dispatch-composition.ts"],"names":[],"mappings":"AAcA;;;GAGG;AACH,MAAM,UAAU,wDAAwD,CAAC,OAOvE;IACA,IAAI,OAAO,CAAC,OAAO,CAAC,UAAU,KAAK,OAAO,CAAC,UAAU,EAAE,CAAC;QACtD,MAAM,IAAI,KAAK,CAAC,sEAAsE,CAAC,CAAC;IAC1F,CAAC;IACD,OAAO,MAAM,CAAC,MAAM,CAAC;QACnB,UAAU,EAAE,OAAO,CAAC,OAAO,CAAC,kBAAkB;QAC9C,MAAM,EAAE,iDAAiD,CAAC;YACxD,UAAU,EAAE,OAAO,CAAC,UAAU;YAC9B,MAAM,EAAE,OAAO,CAAC,MAAM;YACtB,OAAO,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,MAAM,CAAC;gBAC3B,UAAU,EAAE,OAAO,CAAC,OAAO,CAAC,UAAU;gBACtC,IAAI,EAAE,OAAO,CAAC,OAAO,CAAC,kBAAkB;aACzC,CAAC;SACH,CAAC;KACH,CAAC,CAAC;AACL,CAAC;AAED,MAAM,UAAU,iDAAiD,CAAC,OAIhE;IACA,IAAI,CAAC,MAAM,CAAC,aAAa,CAAC,OAAO,CAAC,UAAU,CAAC,IAAI,OAAO,CAAC,UAAU,GAAG,CAAC,EAAE,CAAC;QACxE,MAAM,IAAI,KAAK,CAAC,kDAAkD,CAAC,CAAC;IACtE,CAAC;IACD,OAAO,MAAM,CAAC,MAAM,CAAC;QACnB,UAAU,EAAE,KAAK,EAAE,GAAG,IAAuE,EAAE,EAAE;YAC/F,OAAO,CAAC,MAAM,CAAC,cAAc,EAAE,CAAC;YAChC,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,EAAE,CAAC;YAClC,IAAI,CAAC,OAAO;gBAAE,MAAM,IAAI,KAAK,CAAC,qDAAqD,CAAC,CAAC;YACrF,IAAI,OAAO,CAAC,UAAU,KAAK,OAAO,CAAC,UAAU,EAAE,CAAC;gBAC9C,MAAM,IAAI,KAAK,CAAC,kEAAkE,CAAC,CAAC;YACtF,CAAC;YACD,MAAM,eAAe,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;YAChC,MAAM,MAAM,GAAG,WAAW,CAAC,GAAG,CAAC,CAAC,OAAO,CAAC,MAAM,EAAE,eAAe,CAAC,CAAC,CAAC;YAClE,OAAO,MAAM,OAAO,CAAC,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC;QACxD,CAAC;KACF,CAAC,CAAC;AACL,CAAC"}

package/lib/plugin-runtime/workroom-governed-dispatch-reasons.d.ts

@@ -0,0 +1,10 @@
+import type { GovernedDisclosureBlockReason } from './workroom-data-governance-runtime.js';
+export type WorkroomGovernedDispatchRecoveryAction = 'rematerialize' | 'operator_repair' | 'authority_repair' | 'new_generation';
+export interface WorkroomGovernedDispatchReason {
+    readonly version: 1;
+    readonly code: GovernedDisclosureBlockReason;
+    readonly retryable: boolean;
+    readonly action: WorkroomGovernedDispatchRecoveryAction;
+}
+export declare function createWorkroomGovernedDispatchReason(value: string): WorkroomGovernedDispatchReason;
+//# sourceMappingURL=workroom-governed-dispatch-reasons.d.ts.map

package/lib/plugin-runtime/workroom-governed-dispatch-reasons.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"workroom-governed-dispatch-reasons.d.ts","sourceRoot":"","sources":["../../src/plugin-runtime/workroom-governed-dispatch-reasons.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,6BAA6B,EAAE,MAAM,uCAAuC,CAAC;AAE3F,MAAM,MAAM,sCAAsC,GAC9C,eAAe,GACf,iBAAiB,GACjB,kBAAkB,GAClB,gBAAgB,CAAC;AAErB,MAAM,WAAW,8BAA8B;IAC7C,QAAQ,CAAC,OAAO,EAAE,CAAC,CAAC;IACpB,QAAQ,CAAC,IAAI,EAAE,6BAA6B,CAAC;IAC7C,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;IAC5B,QAAQ,CAAC,MAAM,EAAE,sCAAsC,CAAC;CACzD;AAkBD,wBAAgB,oCAAoC,CAClD,KAAK,EAAE,MAAM,GACZ,8BAA8B,CAMhC"}

package/lib/plugin-runtime/workroom-governed-dispatch-reasons.js

@@ -0,0 +1,20 @@
+const reasons = Object.freeze({
+    project_authority_unavailable: { retryable: true, action: 'authority_repair' },
+    payload_vault_key_unavailable: { retryable: true, action: 'operator_repair' },
+    source_classification_quarantined: { retryable: false, action: 'authority_repair' },
+    source_authority_conflict: { retryable: false, action: 'rematerialize' },
+    disclosure_denied: { retryable: false, action: 'authority_repair' },
+    disclosure_approval_required: { retryable: false, action: 'rematerialize' },
+    disclosure_manifest_stale: { retryable: false, action: 'rematerialize' },
+    disclosure_manifest_expired: { retryable: false, action: 'rematerialize' },
+    disclosure_recipient_revoked: { retryable: false, action: 'rematerialize' },
+    generation_retired: { retryable: false, action: 'new_generation' },
+});
+export function createWorkroomGovernedDispatchReason(value) {
+    if (!Object.hasOwn(reasons, value)) {
+        throw new Error('Workroom governed dispatch reason is unknown');
+    }
+    const code = value;
+    return Object.freeze({ version: 1, code, ...reasons[code] });
+}
+//# sourceMappingURL=workroom-governed-dispatch-reasons.js.map

package/lib/plugin-runtime/workroom-governed-dispatch-reasons.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"workroom-governed-dispatch-reasons.js","sourceRoot":"","sources":["../../src/plugin-runtime/workroom-governed-dispatch-reasons.ts"],"names":[],"mappings":"AAeA,MAAM,OAAO,GAAG,MAAM,CAAC,MAAM,CAGxB;IACH,6BAA6B,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,MAAM,EAAE,kBAAkB,EAAE;IAC9E,6BAA6B,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,MAAM,EAAE,iBAAiB,EAAE;IAC7E,iCAAiC,EAAE,EAAE,SAAS,EAAE,KAAK,EAAE,MAAM,EAAE,kBAAkB,EAAE;IACnF,yBAAyB,EAAE,EAAE,SAAS,EAAE,KAAK,EAAE,MAAM,EAAE,eAAe,EAAE;IACxE,iBAAiB,EAAE,EAAE,SAAS,EAAE,KAAK,EAAE,MAAM,EAAE,kBAAkB,EAAE;IACnE,4BAA4B,EAAE,EAAE,SAAS,EAAE,KAAK,EAAE,MAAM,EAAE,eAAe,EAAE;IAC3E,yBAAyB,EAAE,EAAE,SAAS,EAAE,KAAK,EAAE,MAAM,EAAE,eAAe,EAAE;IACxE,2BAA2B,EAAE,EAAE,SAAS,EAAE,KAAK,EAAE,MAAM,EAAE,eAAe,EAAE;IAC1E,4BAA4B,EAAE,EAAE,SAAS,EAAE,KAAK,EAAE,MAAM,EAAE,eAAe,EAAE;IAC3E,kBAAkB,EAAE,EAAE,SAAS,EAAE,KAAK,EAAE,MAAM,EAAE,gBAAgB,EAAE;CACnE,CAAC,CAAC;AAEH,MAAM,UAAU,oCAAoC,CAClD,KAAa;IAEb,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,OAAO,EAAE,KAAK,CAAC,EAAE,CAAC;QACnC,MAAM,IAAI,KAAK,CAAC,8CAA8C,CAAC,CAAC;IAClE,CAAC;IACD,MAAM,IAAI,GAAG,KAAsC,CAAC;IACpD,OAAO,MAAM,CAAC,MAAM,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;AAC/D,CAAC"}

package/lib/plugin-runtime/workroom-journal-payload-composition.d.ts

@@ -0,0 +1,16 @@
+import { type WorkroomJournalPayloadPort } from '../workroom/journal.js';
+export interface GenerationOwnedWorkroomJournalPayloadPort {
+    readonly generation: number;
+    readonly payloads: WorkroomJournalPayloadPort;
+    activate(authority: WorkroomJournalPayloadPort): void;
+}
+/**
+ * Root-only latch used to construct the durable Journal before the generation's
+ * private data-governance runtime is ready. It never exposes that runtime,
+ * repository or Vault and has no plaintext fallback.
+ */
+export declare function createGenerationOwnedWorkroomJournalPayloadPort(options: Readonly<{
+    generation: number;
+    signal: AbortSignal;
+}>): GenerationOwnedWorkroomJournalPayloadPort;
+//# sourceMappingURL=workroom-journal-payload-composition.d.ts.map

package/lib/plugin-runtime/workroom-journal-payload-composition.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"workroom-journal-payload-composition.d.ts","sourceRoot":"","sources":["../../src/plugin-runtime/workroom-journal-payload-composition.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,0BAA0B,EAChC,MAAM,wBAAwB,CAAC;AAEhC,MAAM,WAAW,yCAAyC;IACxD,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,QAAQ,EAAE,0BAA0B,CAAC;IAC9C,QAAQ,CAAC,SAAS,EAAE,0BAA0B,GAAG,IAAI,CAAC;CACvD;AAED;;;;GAIG;AACH,wBAAgB,+CAA+C,CAC7D,OAAO,EAAE,QAAQ,CAAC;IAAE,UAAU,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,WAAW,CAAA;CAAE,CAAC,GAC7D,yCAAyC,CAuD3C"}

package/lib/plugin-runtime/workroom-journal-payload-composition.js

@@ -0,0 +1,69 @@
+import { WorkroomJournalPayloadAuthorityUnavailableError, } from '../workroom/journal.js';
+/**
+ * Root-only latch used to construct the durable Journal before the generation's
+ * private data-governance runtime is ready. It never exposes that runtime,
+ * repository or Vault and has no plaintext fallback.
+ */
+export function createGenerationOwnedWorkroomJournalPayloadPort(options) {
+    if (!Number.isSafeInteger(options.generation) || options.generation <= 0) {
+        throw new Error('Workroom Journal payload generation must be a positive integer');
+    }
+    let delegate;
+    const requireAuthority = () => {
+        options.signal.throwIfAborted();
+        if (!delegate)
+            throw new WorkroomJournalPayloadAuthorityUnavailableError();
+        return delegate;
+    };
+    const payloads = Object.freeze({
+        write: async (input) => {
+            const result = await requireAuthority().write(input);
+            options.signal.throwIfAborted();
+            return result;
+        },
+        read: async (input) => {
+            const result = await requireAuthority().read(input);
+            options.signal.throwIfAborted();
+            return result;
+        },
+        publish: async (input) => {
+            const authority = requireAuthority();
+            if (!authority.publish)
+                throw new WorkroomJournalPayloadAuthorityUnavailableError();
+            await authority.publish(input);
+            options.signal.throwIfAborted();
+        },
+        prepare: async (input) => {
+            const authority = requireAuthority();
+            if (!authority.prepare)
+                throw new WorkroomJournalPayloadAuthorityUnavailableError();
+            await authority.prepare(input);
+            options.signal.throwIfAborted();
+        },
+        abandon: async (input) => {
+            const authority = requireAuthority();
+            if (!authority.abandon)
+                throw new WorkroomJournalPayloadAuthorityUnavailableError();
+            await authority.abandon(input);
+            options.signal.throwIfAborted();
+        },
+        reconcile: async (input) => {
+            const authority = requireAuthority();
+            if (!authority.reconcile)
+                throw new WorkroomJournalPayloadAuthorityUnavailableError();
+            await authority.reconcile(input);
+            options.signal.throwIfAborted();
+        },
+    });
+    return Object.freeze({
+        generation: options.generation,
+        payloads,
+        activate(authority) {
+            options.signal.throwIfAborted();
+            if (delegate)
+                throw new Error('Workroom Journal payload authority is already active');
+            delegate = authority;
+        },
+    });
+}
+//# sourceMappingURL=workroom-journal-payload-composition.js.map

package/lib/plugin-runtime/workroom-journal-payload-composition.js.map

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

package/lib/plugin-runtime/workroom-local-agent-core-adapter.d.ts

@@ -0,0 +1,17 @@
+import type { ResolvedAgentBinding } from '../config/types.js';
+import type { AgentCore } from '../core/agent-core.js';
+import type { TurnEvent } from '../event/turn-event.js';
+import type { ZhinAgentPrivate } from '../internal/agent-host.js';
+import type { PluginAILoopHookRegistry } from '../plugin-loop-hooks.js';
+import type { WorkroomLocalAgentTurnPort, WorkroomLocalTurnJournalAttribution } from './workroom-local-agent-loop.js';
+export interface AgentCoreWorkroomLocalTurnPortOptions {
+    readonly host: ZhinAgentPrivate;
+    readonly core: AgentCore;
+    readonly resolveBinding: (agentDefinitionId: string | undefined) => ResolvedAgentBinding | undefined;
+    readonly generation: number;
+    readonly loopHooks?: PluginAILoopHookRegistry;
+    readonly onTurnEvent?: (attribution: WorkroomLocalTurnJournalAttribution, event: TurnEvent) => void | Promise<void>;
+}
+/** Exact Deferred Capability Plan adapter over the production AgentCore/agentLoop. */
+export declare function createAgentCoreWorkroomLocalTurnPort(options: AgentCoreWorkroomLocalTurnPortOptions): WorkroomLocalAgentTurnPort;
+//# sourceMappingURL=workroom-local-agent-core-adapter.d.ts.map

package/lib/plugin-runtime/workroom-local-agent-core-adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"workroom-local-agent-core-adapter.d.ts","sourceRoot":"","sources":["../../src/plugin-runtime/workroom-local-agent-core-adapter.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AAC/D,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AAEvD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AACxD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,2BAA2B,CAAC;AAClE,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,yBAAyB,CAAC;AAIxE,OAAO,KAAK,EAEV,0BAA0B,EAC1B,mCAAmC,EACpC,MAAM,gCAAgC,CAAC;AAExC,MAAM,WAAW,qCAAqC;IACpD,QAAQ,CAAC,IAAI,EAAE,gBAAgB,CAAC;IAChC,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAC;IACzB,QAAQ,CAAC,cAAc,EAAE,CAAC,iBAAiB,EAAE,MAAM,GAAG,SAAS,KAAK,oBAAoB,GAAG,SAAS,CAAC;IACrG,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,SAAS,CAAC,EAAE,wBAAwB,CAAC;IAC9C,QAAQ,CAAC,WAAW,CAAC,EAAE,CACrB,WAAW,EAAE,mCAAmC,EAChD,KAAK,EAAE,SAAS,KACb,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAC3B;AAED,sFAAsF;AACtF,wBAAgB,oCAAoC,CAClD,OAAO,EAAE,qCAAqC,GAC7C,0BAA0B,CAK5B"}

package/lib/plugin-runtime/workroom-local-agent-core-adapter.js

@@ -0,0 +1,101 @@
+import { createUserMessage } from '@zhin.js/ai';
+import { collectAgentLoopTurnRun } from '../core/agent-core-run.js';
+import { TurnToolRuntime, turnToolExecutionAuthority } from '../tool/turn-tool-runtime.js';
+import { runWithAgentTurnConfiguration } from '../turn/agent-turn-context.js';
+import { createTurnIngress } from '../turn/turn-ingress.js';
+/** Exact Deferred Capability Plan adapter over the production AgentCore/agentLoop. */
+export function createAgentCoreWorkroomLocalTurnPort(options) {
+    return Object.freeze({
+        run: async (input, signal) => await runAgentCoreLocalTurn(options, input, signal),
+    });
+}
+async function runAgentCoreLocalTurn(options, input, signal) {
+    const binding = options.resolveBinding(input.agentDefinitionId);
+    if (!binding) {
+        throw new Error(`Local Assignment Agent binding is unavailable: ${input.agentDefinitionId ?? 'unbound'}`);
+    }
+    const publish = async (event) => {
+        await options.onTurnEvent?.(input.journalAttribution, event);
+    };
+    const plan = input.capabilityPlan;
+    const turn = createTurnIngress({
+        identity: Object.freeze({
+            rootId: 'workroom-local-assignment',
+            generation: options.generation,
+            traceId: input.turnId,
+            turnId: input.turnId,
+        }),
+        origin: Object.freeze({ kind: 'http', sessionId: input.sessionId }),
+        principal: Object.freeze({
+            subjectId: input.principalId,
+            roles: Object.freeze(['workroom_assignment']),
+        }),
+        intent: Object.freeze({ kind: 'new' }),
+        input: Object.freeze({
+            text: input.prompt,
+            metadata: Object.freeze({ ...input.journalAttribution }),
+        }),
+        session: Object.freeze({ key: input.sessionId }),
+        policy: Object.freeze({
+            permissions: Object.freeze([]),
+            unattended: true,
+            shell: Object.freeze({
+                security: 'allowlist',
+                execPreset: 'development',
+                approvalMode: 'deny',
+                isolation: 'required',
+            }),
+            filesystem: Object.freeze({
+                workspaceRoot: input.workspaceRoot,
+                workingDirectory: input.workspaceRoot,
+                access: 'workspace-write',
+            }),
+        }),
+        capabilities: Object.freeze({
+            tools: Object.freeze(plan.capabilities.map(capability => capability.name)),
+            skills: Object.freeze([]),
+        }),
+        signal,
+        ports: Object.freeze({ journal: Object.freeze({ append: publish }) }),
+    });
+    const runtime = new TurnToolRuntime(turn, plan.capabilities);
+    const activeSkillsContext = plan.controller.loadedSkillInstructions().join('\n\n');
+    const run = () => collectAgentLoopTurnRun(options.core.runText({
+        host: options.host,
+        sessionId: input.sessionId,
+        rawContent: input.prompt,
+        promptProfile: { kind: 'interactive' },
+        turnContext: turn,
+        allTools: [...plan.allTools],
+        resolvedTools: [...plan.resolvedTools],
+        toolExecution: turnToolExecutionAuthority(runtime),
+        toolEventSource: 'authority',
+        loopHooks: options.loopHooks,
+        promptRuntime: {
+            activeSkillsContext,
+            agentNickname: binding.nickname,
+            modelId: binding.model,
+            providerAlias: binding.providerAlias,
+        },
+        personaEnhanced: [
+            'You are executing one exact Workroom Assignment.',
+            'Use only the supplied Deferred Capability Plan and workspace authority.',
+            'Return the requested structured Task Report JSON; never mutate Workroom Task status.',
+            activeSkillsContext,
+        ].filter(Boolean).join('\n\n'),
+        modelId: binding.model,
+        modelCandidates: [binding.model],
+        initialMessages: [createUserMessage(input.prompt)],
+        signal,
+        deferredStats: plan.deferredStats,
+        deferredController: plan.controller,
+        toolCatalog: plan.catalog,
+        toolLoading: 'deferred',
+        conversationPersistence: 'none',
+        generation: options.generation,
+        onTurnEvent: event => { void publish(event); },
+    }));
+    const result = await runWithAgentTurnConfiguration({ activeBinding: binding }, run);
+    return Object.freeze({ output: result.reply });
+}
+//# sourceMappingURL=workroom-local-agent-core-adapter.js.map

package/lib/plugin-runtime/workroom-local-agent-core-adapter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"workroom-local-agent-core-adapter.js","sourceRoot":"","sources":["../../src/plugin-runtime/workroom-local-agent-core-adapter.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAGhD,OAAO,EAAE,uBAAuB,EAAE,MAAM,2BAA2B,CAAC;AAIpE,OAAO,EAAE,eAAe,EAAE,0BAA0B,EAAE,MAAM,8BAA8B,CAAC;AAC3F,OAAO,EAAE,6BAA6B,EAAE,MAAM,+BAA+B,CAAC;AAC9E,OAAO,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAmB5D,sFAAsF;AACtF,MAAM,UAAU,oCAAoC,CAClD,OAA8C;IAE9C,OAAO,MAAM,CAAC,MAAM,CAAC;QACnB,GAAG,EAAE,KAAK,EAAE,KAAkC,EAAE,MAAmB,EAAE,EAAE,CACrE,MAAM,qBAAqB,CAAC,OAAO,EAAE,KAAK,EAAE,MAAM,CAAC;KACtD,CAAC,CAAC;AACL,CAAC;AAED,KAAK,UAAU,qBAAqB,CAClC,OAA8C,EAC9C,KAAkC,EAClC,MAAmB;IAEnB,MAAM,OAAO,GAAG,OAAO,CAAC,cAAc,CAAC,KAAK,CAAC,iBAAiB,CAAC,CAAC;IAChE,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,MAAM,IAAI,KAAK,CAAC,kDAAkD,KAAK,CAAC,iBAAiB,IAAI,SAAS,EAAE,CAAC,CAAC;IAC5G,CAAC;IACD,MAAM,OAAO,GAAG,KAAK,EAAE,KAAgB,EAAiB,EAAE;QACxD,MAAM,OAAO,CAAC,WAAW,EAAE,CAAC,KAAK,CAAC,kBAAkB,EAAE,KAAK,CAAC,CAAC;IAC/D,CAAC,CAAC;IACF,MAAM,IAAI,GAAG,KAAK,CAAC,cAAc,CAAC;IAClC,MAAM,IAAI,GAAG,iBAAiB,CAAC;QAC7B,QAAQ,EAAE,MAAM,CAAC,MAAM,CAAC;YACtB,MAAM,EAAE,2BAA2B;YACnC,UAAU,EAAE,OAAO,CAAC,UAAU;YAC9B,OAAO,EAAE,KAAK,CAAC,MAAM;YACrB,MAAM,EAAE,KAAK,CAAC,MAAM;SACrB,CAAC;QACF,MAAM,EAAE,MAAM,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,SAAS,EAAE,KAAK,CAAC,SAAS,EAAE,CAAC;QAC5E,SAAS,EAAE,MAAM,CAAC,MAAM,CAAC;YACvB,SAAS,EAAE,KAAK,CAAC,WAAW;YAC5B,KAAK,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC,qBAAqB,CAAC,CAAC;SAC9C,CAAC;QACF,MAAM,EAAE,MAAM,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,KAAc,EAAE,CAAC;QAC/C,KAAK,EAAE,MAAM,CAAC,MAAM,CAAC;YACnB,IAAI,EAAE,KAAK,CAAC,MAAM;YAClB,QAAQ,EAAE,MAAM,CAAC,MAAM,CAAC,EAAE,GAAG,KAAK,CAAC,kBAAkB,EAAE,CAAC;SACzD,CAAC;QACF,OAAO,EAAE,MAAM,CAAC,MAAM,CAAC,EAAE,GAAG,EAAE,KAAK,CAAC,SAAS,EAAE,CAAC;QAChD,MAAM,EAAE,MAAM,CAAC,MAAM,CAAC;YACpB,WAAW,EAAE,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC;YAC9B,UAAU,EAAE,IAAI;YAChB,KAAK,EAAE,MAAM,CAAC,MAAM,CAAC;gBACnB,QAAQ,EAAE,WAAoB;gBAC9B,UAAU,EAAE,aAAsB;gBAClC,YAAY,EAAE,MAAe;gBAC7B,SAAS,EAAE,UAAmB;aAC/B,CAAC;YACF,UAAU,EAAE,MAAM,CAAC,MAAM,CAAC;gBACxB,aAAa,EAAE,KAAK,CAAC,aAAa;gBAClC,gBAAgB,EAAE,KAAK,CAAC,aAAa;gBACrC,MAAM,EAAE,iBAA0B;aACnC,CAAC;SACH,CAAC;QACF,YAAY,EAAE,MAAM,CAAC,MAAM,CAAC;YAC1B,KAAK,EAAE,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,UAAU,CAAC,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC;YAC1E,MAAM,EAAE,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC;SAC1B,CAAC;QACF,MAAM;QACN,KAAK,EAAE,MAAM,CAAC,MAAM,CAAC,EAAE,OAAO,EAAE,MAAM,CAAC,MAAM,CAAC,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,EAAE,CAAC;KACtE,CAAC,CAAC;IACH,MAAM,OAAO,GAAG,IAAI,eAAe,CAAC,IAAI,EAAE,IAAI,CAAC,YAAY,CAAC,CAAC;IAC7D,MAAM,mBAAmB,GAAG,IAAI,CAAC,UAAU,CAAC,uBAAuB,EAAE,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IACnF,MAAM,GAAG,GAAG,GAAG,EAAE,CAAC,uBAAuB,CAAC,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC;QAC7D,IAAI,EAAE,OAAO,CAAC,IAAI;QAClB,SAAS,EAAE,KAAK,CAAC,SAAS;QAC1B,UAAU,EAAE,KAAK,CAAC,MAAM;QACxB,aAAa,EAAE,EAAE,IAAI,EAAE,aAAa,EAAE;QACtC,WAAW,EAAE,IAAI;QACjB,QAAQ,EAAE,CAAC,GAAG,IAAI,CAAC,QAAQ,CAAC;QAC5B,aAAa,EAAE,CAAC,GAAG,IAAI,CAAC,aAAa,CAAC;QACtC,aAAa,EAAE,0BAA0B,CAAC,OAAO,CAAC;QAClD,eAAe,EAAE,WAAW;QAC5B,SAAS,EAAE,OAAO,CAAC,SAAS;QAC5B,aAAa,EAAE;YACb,mBAAmB;YACnB,aAAa,EAAE,OAAO,CAAC,QAAQ;YAC/B,OAAO,EAAE,OAAO,CAAC,KAAK;YACtB,aAAa,EAAE,OAAO,CAAC,aAAa;SACrC;QACD,eAAe,EAAE;YACf,kDAAkD;YAClD,yEAAyE;YACzE,sFAAsF;YACtF,mBAAmB;SACpB,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC;QAC9B,OAAO,EAAE,OAAO,CAAC,KAAK;QACtB,eAAe,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC;QAChC,eAAe,EAAE,CAAC,iBAAiB,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;QAClD,MAAM;QACN,aAAa,EAAE,IAAI,CAAC,aAAa;QACjC,kBAAkB,EAAE,IAAI,CAAC,UAAU;QACnC,WAAW,EAAE,IAAI,CAAC,OAAO;QACzB,WAAW,EAAE,UAAU;QACvB,uBAAuB,EAAE,MAAM;QAC/B,UAAU,EAAE,OAAO,CAAC,UAAU;QAC9B,WAAW,EAAE,KAAK,CAAC,EAAE,GAAG,KAAK,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;KAC/C,CAAC,CAAC,CAAC;IACJ,MAAM,MAAM,GAAG,MAAM,6BAA6B,CAChD,EAAE,aAAa,EAAE,OAAO,EAAE,EAC1B,GAAG,CACJ,CAAC;IACF,OAAO,MAAM,CAAC,MAAM,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,KAAK,EAAE,CAAC,CAAC;AACjD,CAAC"}

package/lib/plugin-runtime/workroom-local-agent-loop.d.ts

@@ -0,0 +1,90 @@
+import type { DeferredCapabilityPlan } from './deferred-capability-plan.js';
+import type { LocalModelExecutionPort, LocalModelExecutionRequest } from '../workroom/local-assignment-executor.js';
+import { type WorkroomGovernedPayloadPublicationPort, type WorkroomGovernedPayloadReceipt, type WorkroomTaskReportPayloadPort, type WorkroomTaskReportStore } from '../workroom/workroom-task-report-store.js';
+export interface WorkroomLocalTurnJournalAttribution {
+    readonly projectId: string;
+    readonly runId: string;
+    readonly taskKey: string;
+    readonly taskRevision: number;
+    readonly assignmentId: string;
+    readonly attempt: number;
+    readonly fence: number;
+}
+export interface WorkroomLocalAgentTurnInput {
+    readonly sessionId: string;
+    readonly turnId: string;
+    readonly principalId: string;
+    readonly agentDefinitionId?: string;
+    readonly workspaceRoot: string;
+    readonly journalAttribution: WorkroomLocalTurnJournalAttribution;
+    readonly prompt: string;
+    readonly capabilityPlan: DeferredCapabilityPlan;
+}
+export interface WorkroomLocalAgentTurnResult {
+    readonly output: string;
+}
+export interface WorkroomEvidencePayloadWriteInput {
+    readonly mediaType: string;
+    readonly content: string;
+    /** Untrusted model assertion. The writer must resolve/verify a canonical source independently. */
+    readonly claimedSource: WorkroomEvidenceClaimedSource;
+    readonly attribution: WorkroomLocalTurnJournalAttribution;
+    readonly publication: WorkroomGovernedPayloadPublicationPort;
+}
+/** Content-free receipt returned by the governed Payload Vault boundary. */
+export interface WorkroomEvidencePayloadReceipt extends WorkroomGovernedPayloadReceipt {
+}
+export interface WorkroomEvidenceClaimedSource {
+    readonly kind: 'command' | 'file' | 'url' | 'tool' | 'human';
+    readonly locator: string;
+}
+/** Stable narrow port; P12 storage implementations adapt to this boundary. */
+export interface WorkroomEvidencePayloadWriterPort {
+    write(input: WorkroomEvidencePayloadWriteInput, signal: AbortSignal): Promise<WorkroomEvidencePayloadReceipt>;
+}
+export declare const workroomEvidencePayloadWriterToken: import("@zhin.js/plugin-runtime").Token<WorkroomEvidencePayloadWriterPort>;
+export declare const workroomTaskReportPayloadToken: import("@zhin.js/plugin-runtime").Token<WorkroomTaskReportPayloadPort>;
+/** Narrow production seam adapted to ZhinAgent's AgentCore/agentLoop. */
+export interface WorkroomLocalAgentTurnPort {
+    run(input: WorkroomLocalAgentTurnInput, signal: AbortSignal): Promise<WorkroomLocalAgentTurnResult>;
+}
+export interface DurableReportLocalModelExecutionPortOptions {
+    readonly turn: WorkroomLocalAgentTurnPort;
+    readonly reports: WorkroomTaskReportStore;
+    readonly payloads: WorkroomEvidencePayloadWriterPort;
+    readonly readPrompt?: (request: LocalModelExecutionRequest) => string | Promise<string>;
+}
+/** Persists content-addressed evidence/report before completion can escape. */
+export declare class DurableReportLocalModelExecutionPort implements LocalModelExecutionPort {
+    #private;
+    readonly options: DurableReportLocalModelExecutionPortOptions;
+    constructor(options: DurableReportLocalModelExecutionPortOptions);
+    execute(request: LocalModelExecutionRequest, signal: AbortSignal): AsyncGenerator<Readonly<{
+        version: 1;
+        type: "heartbeat";
+        eventId: "turn-admitted";
+    }> | Readonly<{
+        version: 1;
+        type: "progress";
+        eventId: "model-turn-completed";
+        progress: Readonly<{
+            summary: "Local Agent loop produced a structured Task Report";
+        }>;
+    }> | Readonly<{
+        version: 1;
+        type: "execution_completed";
+        eventId: "durable-report-published";
+        completion: Readonly<{
+            report: Readonly<{
+                ref: string;
+                digest: string;
+            }>;
+            candidate: Readonly<{
+                ref: `workroom-candidate:${string}`;
+                hash: string;
+            }>;
+            completionReceiptDigest: string;
+        }>;
+    }>, void, unknown>;
+}
+//# sourceMappingURL=workroom-local-agent-loop.d.ts.map

package/lib/plugin-runtime/workroom-local-agent-loop.d.ts.map

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