@zhin.js/agent 1.1.13 → 1.1.14

package/lib/workroom/assignment-executor.js

@@ -0,0 +1,371 @@
+import { deepFreezeWorkroomValue as deepFreeze, digestCanonicalWorkroomValue as digest, } from './canonical-value.js';
+/**
+ * Materializes the exact role-scoped authority a trusted Workroom issuer gives
+ * one Assignment attempt. Executors may consume this value, but never widen it.
+ */
+export function createAssignmentExecutionEnvelope(input) {
+    validateEnvelopeInput(input);
+    const projection = {
+        version: 1,
+        ...input,
+        agentDefinition: { ...input.agentDefinition },
+        plan: { ...input.plan },
+        contextPolicy: { ...input.contextPolicy },
+        factAnchor: { ...input.factAnchor },
+        capabilitySnapshot: { ...input.capabilitySnapshot },
+        policySnapshot: { ...input.policySnapshot },
+        workspace: { ...input.workspace },
+    };
+    return deepFreeze({
+        ...projection,
+        digest: digest(projection),
+    });
+}
+/**
+ * Caller-owned execution boundary. Cancellation is checked before transport
+ * dispatch and before any observation escapes toward a trusted Kernel adapter.
+ */
+export async function* executeAssignment(port, envelope, signal) {
+    assertAssignmentExecutionEnvelope(envelope);
+    signal.throwIfAborted();
+    const iterator = port.execute(envelope, signal)[Symbol.asyncIterator]();
+    let completed = false;
+    try {
+        while (true) {
+            const next = await nextWithAbort(iterator, signal);
+            if (next.done) {
+                completed = true;
+                return;
+            }
+            signal.throwIfAborted();
+            yield validateAssignmentExecutionObservation(envelope, next.value);
+        }
+    }
+    finally {
+        if (!completed)
+            stopIteratorWithoutWaiting(iterator);
+    }
+}
+/**
+ * Validates an Executor observation before any trusted adapter may translate
+ * it into a Kernel proposal. The observation itself carries no target scope;
+ * its exact Project/Run/Task/Assignment authority is the Envelope digest.
+ */
+export function validateAssignmentExecutionObservation(envelope, value) {
+    assertAssignmentExecutionEnvelope(envelope);
+    const observation = requireRecord(value, 'observation');
+    if (observation.version !== 1) {
+        throw new Error('Assignment Executor emitted an unsupported observation type');
+    }
+    requireText(observation.observationId, 'observationId');
+    if (observation.envelopeDigest !== envelope.digest) {
+        throw new Error('Assignment Execution observation is not bound to the current Envelope');
+    }
+    if (observation.type === 'heartbeat') {
+        assertExactKeys(observation, [
+            'version', 'type', 'observationId', 'envelopeDigest',
+        ], 'heartbeat observation');
+        return deepFreeze({
+            version: 1,
+            type: 'heartbeat',
+            observationId: observation.observationId,
+            envelopeDigest: observation.envelopeDigest,
+        });
+    }
+    if (observation.type === 'checkpoint') {
+        assertExactKeys(observation, [
+            'version', 'type', 'observationId', 'envelopeDigest', 'checkpoint',
+        ], 'checkpoint observation');
+        const checkpoint = requireRecord(observation.checkpoint, 'checkpoint');
+        assertExactKeys(checkpoint, ['ref', 'digest'], 'checkpoint payload');
+        requireText(checkpoint.ref, 'checkpoint.ref');
+        requireDigest(checkpoint.digest, 'checkpoint.digest');
+        return deepFreeze({
+            version: 1,
+            type: 'checkpoint',
+            observationId: observation.observationId,
+            envelopeDigest: observation.envelopeDigest,
+            checkpoint: {
+                ref: checkpoint.ref,
+                digest: checkpoint.digest,
+            },
+        });
+    }
+    if (observation.type === 'execution_completed') {
+        assertExactKeys(observation, [
+            'version', 'type', 'observationId', 'envelopeDigest', 'completion',
+        ], 'execution_completed observation');
+        const completion = requireRecord(observation.completion, 'completion');
+        assertExactKeys(completion, [
+            'report', 'candidate', 'completionReceiptDigest',
+        ], 'completion payload');
+        const report = requireRecord(completion.report, 'completion.report');
+        const candidate = requireRecord(completion.candidate, 'completion.candidate');
+        assertExactKeys(report, ['ref', 'digest'], 'completion report');
+        assertExactKeys(candidate, ['ref', 'hash'], 'completion candidate');
+        requireText(report.ref, 'completion.report.ref');
+        requireDigest(report.digest, 'completion.report.digest');
+        requireText(candidate.ref, 'completion.candidate.ref');
+        requireDigest(candidate.hash, 'completion.candidate.hash');
+        if (completion.completionReceiptDigest !== undefined) {
+            requireDigest(completion.completionReceiptDigest, 'completion.completionReceiptDigest');
+        }
+        return deepFreeze({
+            version: 1,
+            type: 'execution_completed',
+            observationId: observation.observationId,
+            envelopeDigest: observation.envelopeDigest,
+            completion: {
+                report: { ref: report.ref, digest: report.digest },
+                candidate: { ref: candidate.ref, hash: candidate.hash },
+                ...(completion.completionReceiptDigest === undefined
+                    ? {}
+                    : { completionReceiptDigest: completion.completionReceiptDigest }),
+            },
+        });
+    }
+    if (observation.type !== 'progress') {
+        throw new Error('Assignment Executor emitted an unsupported observation type');
+    }
+    assertExactKeys(observation, [
+        'version', 'type', 'observationId', 'envelopeDigest', 'progress',
+    ], 'progress observation');
+    const progress = requireRecord(observation.progress, 'progress');
+    assertExactKeys(progress, ['summary', 'completedUnits', 'totalUnits'], 'progress payload');
+    requireText(progress.summary, 'progress.summary');
+    const completedUnits = optionalNonNegativeInteger(progress.completedUnits, 'progress.completedUnits');
+    const totalUnits = optionalPositiveInteger(progress.totalUnits, 'progress.totalUnits');
+    if (completedUnits !== undefined && totalUnits !== undefined && completedUnits > totalUnits) {
+        throw new Error('Assignment Execution progress completedUnits cannot exceed totalUnits');
+    }
+    return deepFreeze({
+        version: 1,
+        type: 'progress',
+        observationId: observation.observationId,
+        envelopeDigest: observation.envelopeDigest,
+        progress: {
+            summary: progress.summary,
+            ...(completedUnits === undefined ? {} : { completedUnits }),
+            ...(totalUnits === undefined ? {} : { totalUnits }),
+        },
+    });
+}
+/** Guards the trusted local boundary against corrupted or mutable Envelopes. */
+export function assertAssignmentExecutionEnvelope(value) {
+    const envelope = requireRecord(value, 'Envelope');
+    assertExactKeys(envelope, [
+        'version', 'digest', 'projectId', 'runId', 'taskKey', 'taskRevision',
+        'assignmentId', 'assignmentRevision', 'attempt', 'fence', 'principalId',
+        'role', 'agentDefinition', 'plan', 'contextPolicy', 'factAnchor',
+        'capabilitySnapshot', 'policySnapshot', 'workspace',
+    ], 'Envelope');
+    if (envelope.version !== 1) {
+        throw new Error('Assignment Execution Envelope version is unsupported');
+    }
+    requireDigest(envelope.digest, 'Envelope.digest');
+    const agentDefinition = requireRecord(envelope.agentDefinition, 'Agent Definition reference');
+    const plan = requireRecord(envelope.plan, 'Plan reference');
+    const contextPolicy = requireRecord(envelope.contextPolicy, 'Context Policy reference');
+    const factAnchor = requireRecord(envelope.factAnchor, 'fact anchor');
+    const capabilitySnapshot = requireRecord(envelope.capabilitySnapshot, 'Capability Snapshot reference');
+    const policySnapshot = requireRecord(envelope.policySnapshot, 'Policy Snapshot reference');
+    const workspace = requireRecord(envelope.workspace, 'Workspace reference');
+    const input = {
+        projectId: envelope.projectId,
+        runId: envelope.runId,
+        taskKey: envelope.taskKey,
+        taskRevision: envelope.taskRevision,
+        assignmentId: envelope.assignmentId,
+        assignmentRevision: envelope.assignmentRevision,
+        attempt: envelope.attempt,
+        fence: envelope.fence,
+        principalId: envelope.principalId,
+        role: envelope.role,
+        agentDefinition,
+        plan,
+        contextPolicy,
+        factAnchor,
+        capabilitySnapshot,
+        policySnapshot,
+        workspace,
+    };
+    validateEnvelopeInput(input);
+    const projection = {
+        version: 1,
+        ...input,
+        agentDefinition: { ...input.agentDefinition },
+        plan: { ...input.plan },
+        contextPolicy: { ...input.contextPolicy },
+        factAnchor: { ...input.factAnchor },
+        capabilitySnapshot: { ...input.capabilitySnapshot },
+        policySnapshot: { ...input.policySnapshot },
+        workspace: { ...input.workspace },
+    };
+    if (digest(projection) !== envelope.digest) {
+        throw new Error('Assignment Execution Envelope digest does not match its authority scope');
+    }
+    if (!Object.isFrozen(value)
+        || !Object.isFrozen(envelope.agentDefinition)
+        || !Object.isFrozen(envelope.plan)
+        || !Object.isFrozen(envelope.contextPolicy)
+        || !Object.isFrozen(envelope.factAnchor)
+        || !Object.isFrozen(envelope.capabilitySnapshot)
+        || !Object.isFrozen(envelope.policySnapshot)
+        || !Object.isFrozen(envelope.workspace)) {
+        throw new Error('Assignment Execution Envelope must be deeply immutable');
+    }
+}
+function validateEnvelopeInput(input) {
+    assertExactKeys(input, [
+        'projectId', 'runId', 'taskKey', 'taskRevision', 'assignmentId',
+        'assignmentRevision', 'attempt', 'fence', 'principalId', 'role',
+        'agentDefinition', 'plan', 'contextPolicy', 'factAnchor',
+        'capabilitySnapshot', 'policySnapshot', 'workspace',
+    ], 'Envelope input');
+    for (const [label, reference] of [
+        ['Agent Definition', requireRecord(input.agentDefinition, 'Agent Definition reference')],
+        ['Plan', requireRecord(input.plan, 'Plan reference')],
+        ['Context Policy', requireRecord(input.contextPolicy, 'Context Policy reference')],
+        ['Capability Snapshot', requireRecord(input.capabilitySnapshot, 'Capability Snapshot reference')],
+        ['Policy Snapshot', requireRecord(input.policySnapshot, 'Policy Snapshot reference')],
+    ]) {
+        assertExactKeys(reference, [
+            'ref', 'revision', 'digest',
+        ], `${label} reference`);
+    }
+    assertExactKeys(requireRecord(input.factAnchor, 'fact anchor'), [
+        'ref', 'sequence', 'digest',
+    ], 'fact anchor');
+    assertExactKeys(requireRecord(input.workspace, 'Workspace reference'), [
+        'leaseRef', 'mountRef', 'baseRevision', 'fence',
+    ], 'Workspace reference');
+    for (const [label, value] of Object.entries({
+        projectId: input.projectId,
+        runId: input.runId,
+        taskKey: input.taskKey,
+        assignmentId: input.assignmentId,
+        principalId: input.principalId,
+        agentDefinitionRef: input.agentDefinition.ref,
+        planRef: input.plan.ref,
+        contextPolicyRef: input.contextPolicy.ref,
+        factAnchorRef: input.factAnchor.ref,
+        capabilitySnapshotRef: input.capabilitySnapshot.ref,
+        policySnapshotRef: input.policySnapshot.ref,
+        workspaceLeaseRef: input.workspace.leaseRef,
+        workspaceMountRef: input.workspace.mountRef,
+        workspaceBaseRevision: input.workspace.baseRevision,
+    })) {
+        requireText(value, label);
+    }
+    if (input.role !== 'executor' && input.role !== 'integration') {
+        throw new Error('Assignment Execution role must be executor or integration');
+    }
+    for (const [label, value] of Object.entries({
+        taskRevision: input.taskRevision,
+        assignmentRevision: input.assignmentRevision,
+        attempt: input.attempt,
+        fence: input.fence,
+        agentDefinitionRevision: input.agentDefinition.revision,
+        planRevision: input.plan.revision,
+        contextPolicyRevision: input.contextPolicy.revision,
+        capabilitySnapshotRevision: input.capabilitySnapshot.revision,
+        policySnapshotRevision: input.policySnapshot.revision,
+    })) {
+        requirePositiveInteger(value, label);
+    }
+    requireNonNegativeInteger(input.factAnchor.sequence, 'factAnchor.sequence');
+    requireDigest(input.agentDefinition.digest, 'agentDefinition.digest');
+    requireDigest(input.plan.digest, 'plan.digest');
+    requireDigest(input.contextPolicy.digest, 'contextPolicy.digest');
+    requireDigest(input.factAnchor.digest, 'factAnchor.digest');
+    requireDigest(input.capabilitySnapshot.digest, 'capabilitySnapshot.digest');
+    requireDigest(input.policySnapshot.digest, 'policySnapshot.digest');
+    if (input.workspace.fence !== input.fence) {
+        throw new Error('Assignment Execution Workspace fence does not match the Envelope fence');
+    }
+}
+function requireText(value, label) {
+    if (typeof value !== 'string' || !value.trim()) {
+        throw new Error(`Assignment Execution ${label} requires non-empty text`);
+    }
+}
+function requirePositiveInteger(value, label) {
+    if (!Number.isSafeInteger(value) || Number(value) < 1) {
+        throw new Error(`Assignment Execution ${label} must be a positive integer`);
+    }
+}
+function optionalPositiveInteger(value, label) {
+    if (value === undefined)
+        return undefined;
+    requirePositiveInteger(value, label);
+    return value;
+}
+function optionalNonNegativeInteger(value, label) {
+    if (value === undefined)
+        return undefined;
+    requireNonNegativeInteger(value, label);
+    return value;
+}
+function requireNonNegativeInteger(value, label) {
+    if (!Number.isSafeInteger(value) || Number(value) < 0) {
+        throw new Error(`Assignment Execution ${label} must be a non-negative integer`);
+    }
+}
+function requireDigest(value, label) {
+    if (typeof value !== 'string' || !/^sha256:[a-f0-9]{64}$/u.test(value)) {
+        throw new Error(`Assignment Execution ${label} must be a SHA-256 digest`);
+    }
+}
+function requireRecord(value, label) {
+    if (!value || typeof value !== 'object' || Array.isArray(value)) {
+        throw new Error(`Assignment Execution ${label} must be an object`);
+    }
+    return value;
+}
+function assertExactKeys(value, allowed, label) {
+    const unexpected = Object.keys(value).find((key) => !allowed.includes(key));
+    if (unexpected) {
+        throw new Error(`Assignment Execution ${label} contains forbidden field ${unexpected}`);
+    }
+}
+function nextWithAbort(iterator, signal) {
+    signal.throwIfAborted();
+    return new Promise((resolve, reject) => {
+        let settled = false;
+        const finish = (operation) => {
+            if (settled)
+                return;
+            settled = true;
+            signal.removeEventListener('abort', onAbort);
+            operation();
+        };
+        const onAbort = () => {
+            finish(() => reject(signal.reason ?? new DOMException('Assignment cancelled', 'AbortError')));
+        };
+        signal.addEventListener('abort', onAbort, { once: true });
+        if (signal.aborted) {
+            onAbort();
+            return;
+        }
+        let pending;
+        try {
+            pending = iterator.next();
+        }
+        catch (error) {
+            finish(() => reject(error));
+            return;
+        }
+        Promise.resolve(pending).then((result) => finish(() => resolve(result)), (error) => finish(() => reject(error)));
+    });
+}
+function stopIteratorWithoutWaiting(iterator) {
+    try {
+        const pending = iterator.return?.();
+        if (pending)
+            void Promise.resolve(pending).catch(() => undefined);
+    }
+    catch {
+        // Cancellation already owns the public outcome; cleanup remains best-effort.
+    }
+}
+//# sourceMappingURL=assignment-executor.js.map

package/lib/workroom/assignment-executor.js.map

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

package/lib/workroom/assignment-observation-ingress.d.ts

@@ -0,0 +1,21 @@
+import { type AssignmentExecutionEnvelope, type AssignmentExecutionObservation } from './assignment-executor.js';
+import type { WorkroomRunState } from './kernel-contracts.js';
+import type { WorkroomKernel } from './workroom-kernel.js';
+export interface AssignmentObservationIngressOptions {
+    readonly kernel: WorkroomKernel;
+}
+export interface AssignmentObservationCommandPort {
+    apply(value: AssignmentExecutionObservation, expectedSequence: number): Promise<WorkroomRunState>;
+}
+/** Trusted bridge from transport observations into the Kernel's Journal CAS. */
+export declare class AssignmentObservationIngress {
+    #private;
+    constructor(options: AssignmentObservationIngressOptions);
+    /**
+     * Fixes Project/Run/Task/Assignment identity to one trusted Envelope. The
+     * caller can submit observations, but cannot select another authority scope.
+     */
+    bind(envelope: AssignmentExecutionEnvelope): AssignmentObservationCommandPort;
+    apply(envelope: AssignmentExecutionEnvelope, value: AssignmentExecutionObservation, expectedSequence: number): Promise<WorkroomRunState>;
+}
+//# sourceMappingURL=assignment-observation-ingress.d.ts.map

package/lib/workroom/assignment-observation-ingress.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"assignment-observation-ingress.d.ts","sourceRoot":"","sources":["../../src/workroom/assignment-observation-ingress.ts"],"names":[],"mappings":"AAAA,OAAO,EAGL,KAAK,2BAA2B,EAChC,KAAK,8BAA8B,EACpC,MAAM,0BAA0B,CAAC;AAClC,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAC9D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAE3D,MAAM,WAAW,mCAAmC;IAClD,QAAQ,CAAC,MAAM,EAAE,cAAc,CAAC;CACjC;AAED,MAAM,WAAW,gCAAgC;IAC/C,KAAK,CACH,KAAK,EAAE,8BAA8B,EACrC,gBAAgB,EAAE,MAAM,GACvB,OAAO,CAAC,gBAAgB,CAAC,CAAC;CAC9B;AAED,gFAAgF;AAChF,qBAAa,4BAA4B;;gBAG3B,OAAO,EAAE,mCAAmC;IAIxD;;;OAGG;IACH,IAAI,CAAC,QAAQ,EAAE,2BAA2B,GAAG,gCAAgC;IAUvE,KAAK,CACT,QAAQ,EAAE,2BAA2B,EACrC,KAAK,EAAE,8BAA8B,EACrC,gBAAgB,EAAE,MAAM,GACvB,OAAO,CAAC,gBAAgB,CAAC;CAS7B"}

package/lib/workroom/assignment-observation-ingress.js

@@ -0,0 +1,24 @@
+import { assertAssignmentExecutionEnvelope, validateAssignmentExecutionObservation, } from './assignment-executor.js';
+/** Trusted bridge from transport observations into the Kernel's Journal CAS. */
+export class AssignmentObservationIngress {
+    #kernel;
+    constructor(options) {
+        this.#kernel = options.kernel;
+    }
+    /**
+     * Fixes Project/Run/Task/Assignment identity to one trusted Envelope. The
+     * caller can submit observations, but cannot select another authority scope.
+     */
+    bind(envelope) {
+        assertAssignmentExecutionEnvelope(envelope);
+        return Object.freeze({
+            apply: async (value, expectedSequence) => await this.apply(envelope, value, expectedSequence),
+        });
+    }
+    async apply(envelope, value, expectedSequence) {
+        assertAssignmentExecutionEnvelope(envelope);
+        const observation = validateAssignmentExecutionObservation(envelope, value);
+        return this.#kernel.applyAssignmentObservation(envelope, observation, expectedSequence);
+    }
+}
+//# sourceMappingURL=assignment-observation-ingress.js.map

package/lib/workroom/assignment-observation-ingress.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"assignment-observation-ingress.js","sourceRoot":"","sources":["../../src/workroom/assignment-observation-ingress.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,iCAAiC,EACjC,sCAAsC,GAGvC,MAAM,0BAA0B,CAAC;AAelC,gFAAgF;AAChF,MAAM,OAAO,4BAA4B;IAC9B,OAAO,CAAiB;IAEjC,YAAY,OAA4C;QACtD,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC,MAAM,CAAC;IAChC,CAAC;IAED;;;OAGG;IACH,IAAI,CAAC,QAAqC;QACxC,iCAAiC,CAAC,QAAQ,CAAC,CAAC;QAC5C,OAAO,MAAM,CAAC,MAAM,CAAC;YACnB,KAAK,EAAE,KAAK,EACV,KAAqC,EACrC,gBAAwB,EACG,EAAE,CAAC,MAAM,IAAI,CAAC,KAAK,CAAC,QAAQ,EAAE,KAAK,EAAE,gBAAgB,CAAC;SACpF,CAAC,CAAC;IACL,CAAC;IAED,KAAK,CAAC,KAAK,CACT,QAAqC,EACrC,KAAqC,EACrC,gBAAwB;QAExB,iCAAiC,CAAC,QAAQ,CAAC,CAAC;QAC5C,MAAM,WAAW,GAAG,sCAAsC,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC;QAC5E,OAAO,IAAI,CAAC,OAAO,CAAC,0BAA0B,CAC5C,QAAQ,EACR,WAAW,EACX,gBAAgB,CACjB,CAAC;IACJ,CAAC;CACF"}

package/lib/workroom/canonical-value.d.ts

@@ -0,0 +1,7 @@
+/** Locale-independent UTF-16 code-unit order for authoritative identities. */
+export declare function compareCanonicalWorkroomText(left: string, right: string): number;
+/** Canonical representation used by immutable Workroom domain records. */
+export declare function canonicalWorkroomJson(value: unknown): string;
+export declare function digestCanonicalWorkroomValue(value: unknown): string;
+export declare function deepFreezeWorkroomValue<T>(value: T): T;
+//# sourceMappingURL=canonical-value.d.ts.map

package/lib/workroom/canonical-value.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"canonical-value.d.ts","sourceRoot":"","sources":["../../src/workroom/canonical-value.ts"],"names":[],"mappings":"AAEA,8EAA8E;AAC9E,wBAAgB,4BAA4B,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAGhF;AAED,0EAA0E;AAC1E,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAU5D;AAED,wBAAgB,4BAA4B,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAEnE;AAED,wBAAgB,uBAAuB,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,GAAG,CAAC,CAMtD"}

package/lib/workroom/canonical-value.js

@@ -0,0 +1,32 @@
+import { createHash } from 'node:crypto';
+/** Locale-independent UTF-16 code-unit order for authoritative identities. */
+export function compareCanonicalWorkroomText(left, right) {
+    if (left === right)
+        return 0;
+    return left < right ? -1 : 1;
+}
+/** Canonical representation used by immutable Workroom domain records. */
+export function canonicalWorkroomJson(value) {
+    if (Array.isArray(value))
+        return `[${value.map(canonicalWorkroomJson).join(',')}]`;
+    if (value && typeof value === 'object') {
+        const record = value;
+        return `{${Object.keys(record)
+            .sort(compareCanonicalWorkroomText)
+            .map((key) => `${JSON.stringify(key)}:${canonicalWorkroomJson(record[key])}`)
+            .join(',')}}`;
+    }
+    return JSON.stringify(value) ?? 'undefined';
+}
+export function digestCanonicalWorkroomValue(value) {
+    return `sha256:${createHash('sha256').update(canonicalWorkroomJson(value)).digest('hex')}`;
+}
+export function deepFreezeWorkroomValue(value) {
+    if (!value || typeof value !== 'object' || Object.isFrozen(value))
+        return value;
+    for (const item of Object.values(value)) {
+        deepFreezeWorkroomValue(item);
+    }
+    return Object.freeze(value);
+}
+//# sourceMappingURL=canonical-value.js.map

package/lib/workroom/canonical-value.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"canonical-value.js","sourceRoot":"","sources":["../../src/workroom/canonical-value.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAEzC,8EAA8E;AAC9E,MAAM,UAAU,4BAA4B,CAAC,IAAY,EAAE,KAAa;IACtE,IAAI,IAAI,KAAK,KAAK;QAAE,OAAO,CAAC,CAAC;IAC7B,OAAO,IAAI,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;AAC/B,CAAC;AAED,0EAA0E;AAC1E,MAAM,UAAU,qBAAqB,CAAC,KAAc;IAClD,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;QAAE,OAAO,IAAI,KAAK,CAAC,GAAG,CAAC,qBAAqB,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC;IACnF,IAAI,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QACvC,MAAM,MAAM,GAAG,KAAgC,CAAC;QAChD,OAAO,IAAI,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC;aAC3B,IAAI,CAAC,4BAA4B,CAAC;aAClC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,IAAI,qBAAqB,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC;aAC5E,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC;IAClB,CAAC;IACD,OAAO,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,IAAI,WAAW,CAAC;AAC9C,CAAC;AAED,MAAM,UAAU,4BAA4B,CAAC,KAAc;IACzD,OAAO,UAAU,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,qBAAqB,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC;AAC7F,CAAC;AAED,MAAM,UAAU,uBAAuB,CAAI,KAAQ;IACjD,IAAI,CAAC,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC;IAChF,KAAK,MAAM,IAAI,IAAI,MAAM,CAAC,MAAM,CAAC,KAAgC,CAAC,EAAE,CAAC;QACnE,uBAAuB,CAAC,IAAI,CAAC,CAAC;IAChC,CAAC;IACD,OAAO,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;AAC9B,CAAC"}

package/lib/workroom/catalog-definition.d.ts

@@ -0,0 +1,49 @@
+export type WorkroomMemberRole = 'orchestrator' | 'executor' | 'reviewer' | 'integration';
+/**
+ * Persisted Assignment locality authority. An omitted route is the legacy
+ * canonical local route; remote execution always requires an exact endpoint.
+ */
+export type WorkroomAssignmentRouteDefinition = {
+    readonly kind: 'local';
+} | {
+    readonly kind: 'remote';
+    readonly endpointId: string;
+};
+/** One named Agent participating in a Project-scoped Workroom. */
+export interface WorkroomAgentMemberDefinition {
+    /** References ai.agents.<name>. */
+    agent: string;
+    role: WorkroomMemberRole;
+    assignmentRoute?: WorkroomAssignmentRouteDefinition;
+}
+export type WorkroomSpaceKind = 'group' | 'channel' | 'repository';
+/** Binds one collaboration space, reached through a Bot/App Endpoint, to a Workroom. */
+export interface WorkroomConversationBindingDefinition {
+    adapter: string;
+    endpoint: string;
+    kind: WorkroomSpaceKind;
+    /** Platform-native scene id, or canonical owner/repo for repository bindings. */
+    id: string;
+    /** Must reference an Agent present in members and holding the orchestrator role. */
+    agent: string;
+}
+/** Console/API-authored entry in the persistent Workroom Catalog. */
+export interface WorkroomDefinition {
+    name: string;
+    description?: string;
+    enabled?: boolean;
+    members: WorkroomAgentMemberDefinition[];
+    /** Authenticated human principal ids allowed to decide typed Project Sponsor controls. */
+    sponsors?: string[];
+    /** One Workroom owns one collaboration space; an Endpoint may serve many Workrooms. */
+    conversation?: WorkroomConversationBindingDefinition;
+    /** Optional distinct collaboration space for authenticated Sponsor controls and projections. */
+    sponsorConversation?: WorkroomConversationBindingDefinition;
+}
+/** @deprecated Use WorkroomAgentMemberDefinition. */
+export type WorkroomAgentMemberConfig = WorkroomAgentMemberDefinition;
+/** @deprecated Use WorkroomConversationBindingDefinition. */
+export type WorkroomConversationBindingConfig = WorkroomConversationBindingDefinition;
+/** @deprecated Use WorkroomDefinition. */
+export type WorkroomDefinitionConfig = WorkroomDefinition;
+//# sourceMappingURL=catalog-definition.d.ts.map

package/lib/workroom/catalog-definition.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"catalog-definition.d.ts","sourceRoot":"","sources":["../../src/workroom/catalog-definition.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,kBAAkB,GAAG,cAAc,GAAG,UAAU,GAAG,UAAU,GAAG,aAAa,CAAC;AAE1F;;;GAGG;AACH,MAAM,MAAM,iCAAiC,GACzC;IAAE,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAA;CAAE,GAC1B;IAAE,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC;IAAC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAA;CAAE,CAAC;AAE7D,kEAAkE;AAClE,MAAM,WAAW,6BAA6B;IAC5C,mCAAmC;IACnC,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,kBAAkB,CAAC;IACzB,eAAe,CAAC,EAAE,iCAAiC,CAAC;CACrD;AAED,MAAM,MAAM,iBAAiB,GAAG,OAAO,GAAG,SAAS,GAAG,YAAY,CAAC;AAEnE,wFAAwF;AACxF,MAAM,WAAW,qCAAqC;IACpD,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,iBAAiB,CAAC;IACxB,iFAAiF;IACjF,EAAE,EAAE,MAAM,CAAC;IACX,oFAAoF;IACpF,KAAK,EAAE,MAAM,CAAC;CACf;AAED,qEAAqE;AACrE,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,OAAO,EAAE,6BAA6B,EAAE,CAAC;IACzC,0FAA0F;IAC1F,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,uFAAuF;IACvF,YAAY,CAAC,EAAE,qCAAqC,CAAC;IACrD,gGAAgG;IAChG,mBAAmB,CAAC,EAAE,qCAAqC,CAAC;CAC7D;AAED,qDAAqD;AACrD,MAAM,MAAM,yBAAyB,GAAG,6BAA6B,CAAC;AACtE,6DAA6D;AAC7D,MAAM,MAAM,iCAAiC,GAAG,qCAAqC,CAAC;AACtF,0CAA0C;AAC1C,MAAM,MAAM,wBAAwB,GAAG,kBAAkB,CAAC"}

package/lib/workroom/catalog-definition.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=catalog-definition.js.map

package/lib/workroom/catalog-definition.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"catalog-definition.js","sourceRoot":"","sources":["../../src/workroom/catalog-definition.ts"],"names":[],"mappings":""}

package/lib/workroom/catalog.d.ts

@@ -0,0 +1,80 @@
+import type { WorkroomDefinition } from './catalog-definition.js';
+export interface WorkroomCatalogSnapshot {
+    readonly definitions: Readonly<Record<string, WorkroomDefinition>>;
+    readonly revision: string;
+}
+export interface WorkroomCatalog {
+    read(): Promise<WorkroomCatalogSnapshot>;
+    replace(definitions: Readonly<Record<string, WorkroomDefinition>>, expectedRevision: string): Promise<WorkroomCatalogSnapshot>;
+}
+export declare class WorkroomCatalogRevisionConflictError extends Error {
+    readonly expectedRevision: string;
+    readonly actualRevision: string;
+    constructor(expectedRevision: string, actualRevision: string);
+}
+export declare class ActivatableWorkroomCatalog implements WorkroomCatalog {
+    #private;
+    activate(delegate: WorkroomCatalog): void;
+    read(): Promise<WorkroomCatalogSnapshot>;
+    replace(definitions: Readonly<Record<string, WorkroomDefinition>>, expectedRevision: string): Promise<WorkroomCatalogSnapshot>;
+}
+/** Restart-durable fallback used when ai.sessions.useDatabase=false. */
+export declare class FileWorkroomCatalog implements WorkroomCatalog {
+    #private;
+    readonly file: string;
+    constructor(file: string);
+    read(): Promise<WorkroomCatalogSnapshot>;
+    replace(definitions: Readonly<Record<string, WorkroomDefinition>>, expectedRevision: string): Promise<WorkroomCatalogSnapshot>;
+}
+export interface WorkroomCatalogModel {
+    select(...fields: string[]): {
+        where(query: Record<string, unknown>): Promise<Record<string, unknown>[]>;
+    };
+}
+interface WorkroomCatalogTransaction {
+    select(table: string): {
+        where(query: Record<string, unknown>): Promise<Record<string, unknown>[]>;
+    };
+    insertMany(table: string, rows: Record<string, unknown>[]): Promise<unknown>;
+    update(table: string, values: Record<string, unknown>): {
+        where(query: Record<string, unknown>): Promise<unknown>;
+    };
+}
+interface WorkroomCatalogDatabase {
+    transaction<T>(operation: (transaction: WorkroomCatalogTransaction) => Promise<T>, options: {
+        isolationLevel: 'SERIALIZABLE';
+    }): Promise<T>;
+}
+export declare class DatabaseWorkroomCatalog implements WorkroomCatalog {
+    readonly database: WorkroomCatalogDatabase;
+    readonly model: WorkroomCatalogModel;
+    constructor(database: WorkroomCatalogDatabase, model: WorkroomCatalogModel);
+    read(): Promise<WorkroomCatalogSnapshot>;
+    replace(definitions: Readonly<Record<string, WorkroomDefinition>>, expectedRevision: string): Promise<WorkroomCatalogSnapshot>;
+}
+export declare const WORKROOM_CATALOG_MODEL: {
+    id: {
+        type: "text";
+        primary: boolean;
+        nullable: boolean;
+    };
+    sequence: {
+        type: "integer";
+        nullable: boolean;
+    };
+    revision: {
+        type: "text";
+        nullable: boolean;
+    };
+    definitions_json: {
+        type: "text";
+        nullable: boolean;
+    };
+    updated_at: {
+        type: "integer";
+        nullable: boolean;
+    };
+};
+export declare function emptyWorkroomCatalogRevision(): string;
+export {};
+//# sourceMappingURL=catalog.d.ts.map