@zhin.js/workroom 0.0.0 → 0.0.2

package/lib/workroom/human-ingress-orchestrator.d.ts

@@ -0,0 +1,99 @@
+import type { HumanIngressApplicationDecision, HumanIngressApplicationRequest, HumanIngressOrchestratorProposalPort } from './human-ingress-application.js';
+import type { CanonicalHumanIngressSource, HumanIngressSourceReaderPort } from './human-ingress-source-reader.js';
+import type { HumanIngressProjectionReplyProof, HumanIngressProposal } from './human-ingress.js';
+import type { WorkroomKernel, WorkroomPlanAdmissionReceipt } from './workroom-kernel.js';
+import { type WorkflowPlanProposal } from './workflow-plan-builder.js';
+export interface HumanIngressProjectAuthoritySnapshot {
+    readonly orchestratorAgentDefinitionId: string;
+    readonly projectRevision: string;
+    readonly projectDigest: string;
+    readonly orchestratorAuthorityDigest: string;
+}
+export interface HumanIngressPlanningInput {
+    readonly version: 1;
+    readonly operationId: string;
+    readonly projectId: string;
+    readonly projectRevision: string;
+    readonly projectDigest: string;
+    readonly orchestratorAgentDefinitionId: string;
+    readonly orchestratorAuthorityDigest: string;
+    readonly principalId: string;
+    readonly source: CanonicalHumanIngressSource;
+    readonly projectionReply?: HumanIngressProjectionReplyProof;
+}
+export interface HumanIngressPlanningPort {
+    propose(input: HumanIngressPlanningInput): WorkflowPlanProposal | Promise<WorkflowPlanProposal>;
+}
+/** Typed fail-closed planning outcome persisted by HumanIngressApplication. */
+export declare class WorkroomPlanningClarificationError extends Error {
+    readonly reason: Extract<HumanIngressApplicationDecision, {
+        status: 'clarification_required';
+    }>['reason'] & ('planning_unavailable' | 'planning_disclosure_unavailable');
+    constructor(reason: Extract<HumanIngressApplicationDecision, {
+        status: 'clarification_required';
+    }>['reason'] & ('planning_unavailable' | 'planning_disclosure_unavailable'));
+}
+export interface HumanIngressDiscussionProposalInput extends HumanIngressPlanningInput {
+    readonly authority: 'non_authoritative';
+    readonly text: string;
+}
+export interface HumanIngressDiscussionProposalPort {
+    propose(input: HumanIngressDiscussionProposalInput): Promise<Readonly<{
+        receiptRef: string;
+        receiptDigest: string;
+    }>> | Readonly<{
+        receiptRef: string;
+        receiptDigest: string;
+    }>;
+}
+export interface HumanIngressTypedControlInput extends HumanIngressPlanningInput {
+    readonly authorityRequirement: 'workroom_control' | 'typed_sponsor_control';
+    readonly text: string;
+}
+export type HumanIngressTypedControlDecision = Readonly<{
+    status: 'authorized';
+    receiptRef: string;
+    receiptDigest: string;
+}> | Readonly<{
+    status: 'clarification_required';
+    reason: 'missing_control_target' | 'unauthorized_control' | 'stale_target';
+    candidateRefs: readonly string[];
+}>;
+export interface HumanIngressTypedControlPort {
+    apply(input: HumanIngressTypedControlInput): HumanIngressTypedControlDecision | Promise<HumanIngressTypedControlDecision>;
+}
+export interface ProductionHumanIngressOrchestratorPortOptions {
+    readonly sources: HumanIngressSourceReaderPort;
+    readonly kernel: WorkroomKernel;
+    readonly resolveProject: (projectId: string) => HumanIngressProjectAuthoritySnapshot | null | Promise<HumanIngressProjectAuthoritySnapshot | null>;
+    readonly authorizeProjectSource: (input: Readonly<{
+        projectId: string;
+        proposal: HumanIngressProposal;
+        source: CanonicalHumanIngressSource;
+    }>) => boolean | Promise<boolean>;
+    readonly planning?: HumanIngressPlanningPort;
+    readonly discussions?: HumanIngressDiscussionProposalPort;
+    readonly controls?: HumanIngressTypedControlPort;
+    /** Kernel-owned post-admission writer; never exposed to the planner/model. */
+    readonly afterPlanAdmission?: (input: Readonly<{
+        operationId: string;
+        projectId: string;
+        plan: WorkflowPlanProposal;
+        receipt: WorkroomPlanAdmissionReceipt;
+    }>) => void | Promise<void>;
+}
+/**
+ * Production proposal boundary: resolve immutable source + current Catalog
+ * authority, then route to a typed proposal/authority port. It never exposes a
+ * generic Kernel command to a model.
+ */
+export declare class ProductionHumanIngressOrchestratorPort implements HumanIngressOrchestratorProposalPort {
+    readonly options: ProductionHumanIngressOrchestratorPortOptions;
+    constructor(options: ProductionHumanIngressOrchestratorPortOptions);
+    apply(request: HumanIngressApplicationRequest): Promise<HumanIngressApplicationDecision>;
+}
+/** Content-free receipt; durable application journal owns exact replay state. */
+export declare function createContentFreeDiscussionProposalPort(): HumanIngressDiscussionProposalPort;
+/** Strict human control grammar; all mutable scope is re-read from Kernel facts. */
+export declare function createPlanGateHumanIngressControlPort(kernel: WorkroomKernel): HumanIngressTypedControlPort;
+//# sourceMappingURL=human-ingress-orchestrator.d.ts.map

package/lib/workroom/human-ingress-orchestrator.d.ts.map

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

package/lib/workroom/human-ingress-orchestrator.js

@@ -0,0 +1,262 @@
+import { deepFreezeWorkroomValue as deepFreeze, digestCanonicalWorkroomValue, } from './canonical-value.js';
+import { assertWorkflowPlanProposal } from './workflow-plan-builder.js';
+import { WorkroomPlanGateUnauthorizedError, } from './plan-approval-control.js';
+/** Typed fail-closed planning outcome persisted by HumanIngressApplication. */
+export class WorkroomPlanningClarificationError extends Error {
+    reason;
+    constructor(reason) {
+        super(`Workroom planning requires clarification: ${reason}`);
+        this.reason = reason;
+        this.name = 'WorkroomPlanningClarificationError';
+    }
+}
+/**
+ * Production proposal boundary: resolve immutable source + current Catalog
+ * authority, then route to a typed proposal/authority port. It never exposes a
+ * generic Kernel command to a model.
+ */
+export class ProductionHumanIngressOrchestratorPort {
+    options;
+    constructor(options) {
+        this.options = options;
+    }
+    async apply(request) {
+        if (request.operationId !== request.identity.operationId
+            || request.proposal.projectId !== request.identity.projectId
+            || request.proposal.digest !== request.identity.proposalDigest
+            || request.proposal.intent !== request.kind) {
+            throw new Error('Human ingress Orchestrator request identity is inconsistent');
+        }
+        const authority = await this.options.resolveProject(request.identity.projectId);
+        if (!authority)
+            throw new Error('Human ingress Project is absent from the active Workroom Catalog');
+        const proposedAgent = request.proposal.kind === 'project_inbox'
+            ? request.proposal.target.agentDefinitionId
+            : undefined;
+        if (request.proposal.kind === 'project_inbox'
+            && (!proposedAgent || proposedAgent !== authority.orchestratorAgentDefinitionId)) {
+            throw new Error('Human ingress Orchestrator binding does not match the active Workroom Catalog');
+        }
+        const source = await this.options.sources.read(request.proposal.sourceEvent);
+        if (source.conversationKey !== request.proposal.sourceEvent.conversationKey
+            || source.event.type !== 'message.created'
+            || source.event.message.actor?.id !== request.proposal.principal.subjectId) {
+            throw new Error('Human ingress source does not match the proposed Project principal scope');
+        }
+        if (!await this.options.authorizeProjectSource(deepFreeze({
+            projectId: request.identity.projectId,
+            proposal: request.proposal,
+            source,
+        }))) {
+            throw new Error('Human ingress source is not authorized by the exact Project binding');
+        }
+        const common = deepFreeze({
+            version: 1,
+            operationId: request.operationId,
+            projectId: request.identity.projectId,
+            projectRevision: authority.projectRevision,
+            projectDigest: authority.projectDigest,
+            orchestratorAgentDefinitionId: authority.orchestratorAgentDefinitionId,
+            orchestratorAuthorityDigest: authority.orchestratorAuthorityDigest,
+            principalId: request.proposal.principal.principalId,
+            source,
+            ...(request.proposal.projectionReply
+                ? { projectionReply: request.proposal.projectionReply }
+                : {}),
+        });
+        if (request.kind === 'discussion') {
+            const receipt = await (this.options.discussions ?? createContentFreeDiscussionProposalPort()).propose(deepFreeze({
+                ...common,
+                authority: 'non_authoritative',
+                text: source.text,
+            }));
+            validateReceipt(receipt);
+            return applied(request, 'discussion_recorded', receipt);
+        }
+        if (request.kind === 'control') {
+            if (!this.options.controls)
+                return clarification(request, 'unauthorized_control');
+            if (request.proposal.authorityRequirement === 'none') {
+                throw new Error('Human ingress control lacks a typed authority requirement');
+            }
+            const decision = await this.options.controls.apply(deepFreeze({
+                ...common,
+                authorityRequirement: request.proposal.authorityRequirement,
+                text: source.text,
+            }));
+            if (decision.status === 'clarification_required') {
+                return clarification(request, decision.reason, decision.candidateRefs);
+            }
+            validateReceipt(decision);
+            return applied(request, 'control_proposal_submitted', decision);
+        }
+        if (!/^\/(?:work|task)(?:\s|$)/iu.test(source.text)) {
+            return clarification(request, 'missing_work_scope');
+        }
+        const title = source.text.replace(/^\/(?:work|task)(?:\s+|$)/iu, '').trim();
+        if (!title)
+            return clarification(request, 'missing_work_scope');
+        const replay = await this.options.kernel.readWorkflowPlanAdmission(request.operationId);
+        if (replay) {
+            const { plan, receipt } = replay;
+            if (replay.operationId !== request.operationId
+                || replay.sourceEventRef !== source.ref
+                || replay.sourceEventDigest !== source.digest
+                || replay.orchestratorAgentDefinitionId !== authority.orchestratorAgentDefinitionId
+                || plan.projectId !== request.identity.projectId
+                || plan.proposalId !== request.operationId
+                || plan.parameterDigest !== source.digest
+                || receipt.state.projectId !== request.identity.projectId
+                || receipt.state.title !== title) {
+                throw new Error('Human ingress persisted Plan admission is outside the exact operation/source scope');
+            }
+            await this.options.afterPlanAdmission?.({
+                operationId: request.operationId,
+                projectId: request.identity.projectId,
+                plan,
+                receipt,
+            });
+            return applied(request, 'plan_proposal_submitted', receipt);
+        }
+        if (!this.options.planning)
+            return clarification(request, 'planning_unavailable');
+        let plan;
+        try {
+            plan = await this.options.planning.propose(common);
+        }
+        catch (error) {
+            if (error instanceof WorkroomPlanningClarificationError) {
+                return clarification(request, error.reason);
+            }
+            throw error;
+        }
+        assertWorkflowPlanProposal(plan);
+        if (plan.projectId !== request.identity.projectId
+            || plan.proposalId !== request.operationId
+            || plan.parameterDigest !== source.digest
+            || plan.authority.projectRevision !== authority.projectRevision
+            || plan.authority.projectDigest !== authority.projectDigest
+            || plan.authority.orchestratorAgentDefinitionId !== authority.orchestratorAgentDefinitionId
+            || plan.authority.orchestratorAuthorityDigest !== authority.orchestratorAuthorityDigest) {
+            throw new Error('Human ingress planner returned a Plan outside the exact operation/source scope');
+        }
+        const receipt = await this.options.kernel.admitWorkflowPlan({
+            operationId: request.operationId,
+            projectId: request.identity.projectId,
+            title,
+            sourceEventRef: source.ref,
+            sourceEventDigest: source.digest,
+            orchestratorAgentDefinitionId: authority.orchestratorAgentDefinitionId,
+            plan,
+        });
+        await this.options.afterPlanAdmission?.({
+            operationId: request.operationId,
+            projectId: request.identity.projectId,
+            plan,
+            receipt,
+        });
+        return applied(request, 'plan_proposal_submitted', receipt);
+    }
+}
+/** Content-free receipt; durable application journal owns exact replay state. */
+export function createContentFreeDiscussionProposalPort() {
+    return Object.freeze({
+        propose(input) {
+            const receiptRef = `workroom-discussion:${encodeURIComponent(input.operationId)}`;
+            return Object.freeze({
+                receiptRef,
+                receiptDigest: digestCanonicalWorkroomValue({
+                    version: 1,
+                    kind: 'non_authoritative_discussion_proposal',
+                    operationId: input.operationId,
+                    projectId: input.projectId,
+                    sourceDigest: input.source.digest,
+                }),
+            });
+        },
+    });
+}
+/** Strict human control grammar; all mutable scope is re-read from Kernel facts. */
+export function createPlanGateHumanIngressControlPort(kernel) {
+    return Object.freeze({
+        async apply(input) {
+            const match = /^\/control\s+plan-gate\s+(approve|reject|request-changes|cancel)\s+(\S+)\s+(\S+)\s+(\S+)(?:\s+(.+))?$/iu
+                .exec(input.text.trim());
+            if (!match) {
+                return Object.freeze({
+                    status: 'clarification_required',
+                    reason: 'missing_control_target',
+                    candidateRefs: Object.freeze([]),
+                });
+            }
+            const [, rawDecision, runId, taskKey, gateId, reason] = match;
+            const state = await kernel.read(input.projectId, runId);
+            const task = state.tasks[taskKey];
+            if (!task || !task.blockers.some(blocker => blocker.id === gateId && blocker.kind === 'approval')) {
+                return Object.freeze({
+                    status: 'clarification_required',
+                    reason: 'stale_target',
+                    candidateRefs: Object.freeze([]),
+                });
+            }
+            const decision = rawDecision === 'request-changes'
+                ? 'request_changes'
+                : rawDecision;
+            let receipt;
+            try {
+                receipt = await kernel.decidePlanApprovalGate({
+                    operationId: input.operationId,
+                    projectId: input.projectId,
+                    runId: runId,
+                    taskKey: taskKey,
+                    taskRevision: task.revision,
+                    gateId: gateId,
+                    expectedSequence: state.sequence,
+                    decision,
+                    reason: reason?.trim() || `Sponsor Plan Gate ${decision}`,
+                    sponsorPrincipalId: input.principalId,
+                    sponsorAuthorityRef: `human-ingress:${input.source.digest}`,
+                });
+            }
+            catch (error) {
+                if (error instanceof WorkroomPlanGateUnauthorizedError) {
+                    return Object.freeze({
+                        status: 'clarification_required',
+                        reason: 'unauthorized_control',
+                        candidateRefs: Object.freeze([]),
+                    });
+                }
+                throw error;
+            }
+            return Object.freeze({
+                status: 'authorized',
+                receiptRef: receipt.receiptRef,
+                receiptDigest: receipt.receiptDigest,
+            });
+        },
+    });
+}
+function applied(request, kind, receipt) {
+    return deepFreeze({
+        ...request.identity,
+        status: 'applied',
+        kind,
+        receiptRef: receipt.receiptRef,
+        receiptDigest: receipt.receiptDigest,
+    });
+}
+function clarification(request, reason, candidateRefs = []) {
+    return deepFreeze({
+        ...request.identity,
+        status: 'clarification_required',
+        reason,
+        candidateRefs: [...new Set(candidateRefs)].sort(),
+    });
+}
+function validateReceipt(value) {
+    if (!value || typeof value.receiptRef !== 'string' || !value.receiptRef.trim()
+        || !/^sha256:[a-f0-9]{64}$/u.test(value.receiptDigest)) {
+        throw new Error('Human ingress typed proposal receipt is invalid');
+    }
+}
+//# sourceMappingURL=human-ingress-orchestrator.js.map

package/lib/workroom/human-ingress-orchestrator.js.map

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

package/lib/workroom/human-ingress-source-reader.d.ts

@@ -0,0 +1,29 @@
+import { type ConversationEvent, type ConversationEventReader } from '@zhin.js/im-contract';
+import type { HumanIngressSourceAnchor } from './human-ingress.js';
+export interface CanonicalHumanIngressSource {
+    readonly version: 1;
+    readonly ref: string;
+    readonly digest: string;
+    readonly sequence: number;
+    readonly conversationKey: string;
+    readonly eventId: string;
+    readonly text: string;
+    readonly event: ConversationEvent;
+}
+export interface HumanIngressSourceReaderPort {
+    read(source: HumanIngressSourceAnchor): Promise<CanonicalHumanIngressSource>;
+}
+/** Digest binds the database sequence and complete canonical event payload. */
+export declare function digestHumanIngressConversationEvent(sequence: number, event: ConversationEvent): string;
+export declare function humanIngressConversationEventRef(event: ConversationEvent): string;
+/**
+ * Reads only the canonical ConversationEventStore. The caller-provided anchor
+ * is evidence, never content: sequence, ref, conversation and full-event digest
+ * all have to name the same durable message.created event.
+ */
+export declare class ConversationEventHumanIngressSourceReader implements HumanIngressSourceReaderPort {
+    readonly store: ConversationEventReader | (() => ConversationEventReader);
+    constructor(store: ConversationEventReader | (() => ConversationEventReader));
+    read(source: HumanIngressSourceAnchor): Promise<CanonicalHumanIngressSource>;
+}
+//# sourceMappingURL=human-ingress-source-reader.d.ts.map

package/lib/workroom/human-ingress-source-reader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"human-ingress-source-reader.d.ts","sourceRoot":"","sources":["../../src/workroom/human-ingress-source-reader.ts"],"names":[],"mappings":"AAAA,OAAO,EAGL,KAAK,iBAAiB,EACtB,KAAK,uBAAuB,EAC7B,MAAM,sBAAsB,CAAC;AAK9B,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,oBAAoB,CAAC;AAEnE,MAAM,WAAW,2BAA2B;IAC1C,QAAQ,CAAC,OAAO,EAAE,CAAC,CAAC;IACpB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,KAAK,EAAE,iBAAiB,CAAC;CACnC;AAED,MAAM,WAAW,4BAA4B;IAC3C,IAAI,CAAC,MAAM,EAAE,wBAAwB,GAAG,OAAO,CAAC,2BAA2B,CAAC,CAAC;CAC9E;AAED,+EAA+E;AAC/E,wBAAgB,mCAAmC,CACjD,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,iBAAiB,GACvB,MAAM,CAKR;AAED,wBAAgB,gCAAgC,CAAC,KAAK,EAAE,iBAAiB,GAAG,MAAM,CAGjF;AAED;;;;GAIG;AACH,qBAAa,yCACb,YAAW,4BAA4B;IACzB,QAAQ,CAAC,KAAK,EAAE,uBAAuB,GAAG,CAAC,MAAM,uBAAuB,CAAC;gBAAhE,KAAK,EAAE,uBAAuB,GAAG,CAAC,MAAM,uBAAuB,CAAC;IAE/E,IAAI,CAAC,MAAM,EAAE,wBAAwB,GAAG,OAAO,CAAC,2BAA2B,CAAC;CAqCnF"}

package/lib/workroom/human-ingress-source-reader.js

@@ -0,0 +1,126 @@
+import { conversationRefKey, messageRefKey, } from '@zhin.js/im-contract';
+import { deepFreezeWorkroomValue as deepFreeze, digestCanonicalWorkroomValue, } from './canonical-value.js';
+/** Digest binds the database sequence and complete canonical event payload. */
+export function digestHumanIngressConversationEvent(sequence, event) {
+    if (!Number.isSafeInteger(sequence) || sequence < 1) {
+        throw new Error('Human ingress source sequence must be a positive safe integer');
+    }
+    return digestCanonicalWorkroomValue({ version: 1, sequence, event });
+}
+export function humanIngressConversationEventRef(event) {
+    requireText(event.eventId, 'eventId');
+    return `conversation-event:${event.eventId}`;
+}
+/**
+ * Reads only the canonical ConversationEventStore. The caller-provided anchor
+ * is evidence, never content: sequence, ref, conversation and full-event digest
+ * all have to name the same durable message.created event.
+ */
+export class ConversationEventHumanIngressSourceReader {
+    store;
+    constructor(store) {
+        this.store = store;
+    }
+    async read(source) {
+        const anchor = normalizeAnchor(source);
+        const eventId = anchor.ref.slice('conversation-event:'.length);
+        const store = typeof this.store === 'function' ? this.store() : this.store;
+        const events = await store.listBetween(parseConversationKey(anchor.conversationKey), anchor.sequence - 1, anchor.sequence, 1);
+        const selected = events[0];
+        if (!selected || selected.sequence !== anchor.sequence) {
+            throw new Error('Canonical human ingress source event was not found at the anchored sequence');
+        }
+        const event = selected.event;
+        if (event.type !== 'message.created') {
+            throw new Error('Canonical human ingress source must be message.created');
+        }
+        if (event.eventId !== eventId
+            || humanIngressConversationEventRef(event) !== anchor.ref
+            || conversationRefKey(event.conversation) !== anchor.conversationKey
+            || conversationRefKey(event.message.ref.conversation) !== anchor.conversationKey
+            || event.eventId !== `message:${messageRefKey(event.message.ref)}`) {
+            throw new Error('Canonical human ingress source ref or conversation does not match the durable event');
+        }
+        const digest = digestHumanIngressConversationEvent(selected.sequence, event);
+        if (digest !== anchor.digest) {
+            throw new Error('Canonical human ingress source digest does not match the durable event');
+        }
+        return deepFreeze({
+            version: 1,
+            ...anchor,
+            eventId,
+            text: plainText(event),
+            event,
+        });
+    }
+}
+/*
+ * listBetween requires a structured ConversationRef. The anchor intentionally
+ * stores only the canonical key, so use getMessage to recover that structure
+ * is impossible without parsing. Conversation keys are canonical JSON in the
+ * IM contract; keep parsing private and verify round-trip before use.
+ */
+function parseConversationKey(key) {
+    const parts = key.split('\0');
+    const adapter = parts.shift();
+    const threadId = parts.pop();
+    const parentId = parts.pop();
+    const parentKind = parts.pop();
+    const id = parts.pop();
+    const kind = parts.pop();
+    const endpointId = parts.join('\0');
+    if (!adapter || !endpointId || !id
+        || (kind !== 'private' && kind !== 'group' && kind !== 'channel')
+        || (Boolean(parentKind) !== Boolean(parentId))
+        || (parentKind && parentKind !== 'private' && parentKind !== 'group' && parentKind !== 'channel')) {
+        throw new Error('Human ingress source conversation key is not canonical');
+    }
+    const parsed = Object.freeze({
+        endpoint: Object.freeze({ adapter, id: endpointId }),
+        kind,
+        id,
+        ...(parentKind && parentId
+            ? { parent: Object.freeze({
+                    kind: parentKind,
+                    id: parentId,
+                }) }
+            : {}),
+        ...(threadId ? { threadId } : {}),
+    });
+    if (conversationRefKey(parsed) !== key) {
+        throw new Error('Human ingress source conversation key is not canonical');
+    }
+    return parsed;
+}
+function normalizeAnchor(source) {
+    const snapshot = structuredClone(source);
+    if (!snapshot || typeof snapshot !== 'object'
+        || Object.keys(snapshot).sort().join(',') !== 'conversationKey,digest,ref,sequence') {
+        throw new Error('Human ingress source anchor shape is invalid');
+    }
+    requireText(snapshot.ref, 'ref');
+    if (!snapshot.ref.startsWith('conversation-event:')) {
+        throw new Error('Human ingress source ref must identify a conversation event');
+    }
+    if (!/^sha256:[a-f0-9]{64}$/u.test(snapshot.digest)) {
+        throw new Error('Human ingress source digest must be canonical SHA-256');
+    }
+    if (!Number.isSafeInteger(snapshot.sequence) || snapshot.sequence < 1) {
+        throw new Error('Human ingress source sequence must be a positive safe integer');
+    }
+    requireText(snapshot.conversationKey, 'conversationKey');
+    return deepFreeze(snapshot);
+}
+function plainText(event) {
+    return event.message.segments
+        .filter(segment => segment.type === 'text')
+        .map(segment => String(segment.data.text ?? ''))
+        .join('')
+        .trim();
+}
+function requireText(value, label) {
+    if (typeof value !== 'string' || !value.trim() || value !== value.trim()) {
+        throw new Error(`Human ingress source ${label} must be canonical text`);
+    }
+}
+//# sourceMappingURL=human-ingress-source-reader.js.map

package/lib/workroom/human-ingress-source-reader.js.map

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