@zhin.js/agent 1.1.13 → 1.1.14

package/lib/workroom/interaction-space-binding-service.js

@@ -0,0 +1,197 @@
+import { canonicalWorkroomJson as stableJson, deepFreezeWorkroomValue as deepFreeze, } from './canonical-value.js';
+import { createInteractionSpaceBinding, } from './interaction-space-router.js';
+import { conversationRefKey, } from '@zhin.js/im-contract';
+/**
+ * Issues one explicit Interaction Space binding from trusted conversation and
+ * Project-authority facts. Callers provide neither revisions nor sequence anchors.
+ */
+export class InteractionSpaceBindingService {
+    repository;
+    barrier;
+    authority;
+    constructor(repository, barrier, authority) {
+        this.repository = repository;
+        this.barrier = barrier;
+        this.authority = authority;
+    }
+    async bind(input) {
+        const normalized = normalizeBindInput(input);
+        const authority = this.authority;
+        if (!authority)
+            throw new Error('Interaction Space Binding Authority Port is not installed');
+        const conversationKey = conversationRefKey(normalized.conversation);
+        const history = normalizeHistory(normalized.conversation, await this.repository.read(conversationKey));
+        const replay = findReplay(history, normalized);
+        if (replay)
+            return replay;
+        const currentBarrier = normalizeBarrier(await this.barrier.readBarrier(normalized.conversation), conversationKey);
+        const previous = history.at(-1);
+        if (previous
+            && currentBarrier.currentSequence < previous.effectiveAfterConversationSequence) {
+            throw new Error('Interaction Space binding barrier must not move behind the previous anchor');
+        }
+        const request = deepFreeze({
+            version: 1,
+            conversation: normalized.conversation,
+            conversationKey,
+            expectedRevision: history.length,
+            bindingRevision: history.length + 1,
+            effectiveAfterConversationSequence: currentBarrier.currentSequence,
+            barrierSourceRef: currentBarrier.sourceRef,
+            barrierSourceDigest: currentBarrier.sourceDigest,
+            space: normalized.space,
+            ...(normalized.projectId === undefined ? {} : { projectId: normalized.projectId }),
+            sourceRef: normalized.sourceRef,
+            sourceDigest: normalized.sourceDigest,
+        });
+        const decision = normalizeDecision(await authority.authorize(request), request);
+        if (!decision.authorized) {
+            throw new Error(`Interaction Space binding authority denied: ${decision.reason}`);
+        }
+        const binding = createInteractionSpaceBinding({
+            conversation: normalized.conversation,
+            bindingRevision: decision.bindingRevision,
+            effectiveAfterConversationSequence: decision.effectiveAfterConversationSequence,
+            space: decision.space,
+            ...(decision.projectId === undefined ? {} : { projectId: decision.projectId }),
+            sourceRef: decision.sourceRef,
+            sourceDigest: decision.sourceDigest,
+        });
+        const appended = await this.repository.append(conversationKey, decision.expectedRevision, [binding]);
+        if (appended.length !== 1 || stableJson(appended[0]) !== stableJson(binding)) {
+            throw new Error('Interaction Space binding repository append result drift');
+        }
+        return appended[0];
+    }
+}
+function normalizeBindInput(input) {
+    const snapshot = structuredClone(input);
+    assertObject(snapshot, 'binding input');
+    assertExactKeys(snapshot, ['conversation', 'space', 'projectId', 'sourceRef', 'sourceDigest'], 'binding input');
+    const conversation = deepFreeze(structuredClone(snapshot.conversation));
+    const probe = createInteractionSpaceBinding({
+        conversation,
+        bindingRevision: 1,
+        effectiveAfterConversationSequence: 0,
+        space: snapshot.space,
+        ...(snapshot.projectId === undefined ? {} : { projectId: snapshot.projectId }),
+        sourceRef: snapshot.sourceRef,
+        sourceDigest: snapshot.sourceDigest,
+    });
+    return deepFreeze({
+        conversation,
+        space: probe.space,
+        ...(probe.projectId === undefined ? {} : { projectId: probe.projectId }),
+        sourceRef: probe.sourceRef,
+        sourceDigest: probe.sourceDigest,
+    });
+}
+function normalizeHistory(conversation, value) {
+    if (!Array.isArray(value))
+        throw new Error('Interaction Space binding history must be an array');
+    let previous;
+    const history = value.map((binding, index) => {
+        const canonical = createInteractionSpaceBinding({
+            conversation,
+            bindingRevision: binding.bindingRevision,
+            effectiveAfterConversationSequence: binding.effectiveAfterConversationSequence,
+            space: binding.space,
+            ...(binding.projectId === undefined ? {} : { projectId: binding.projectId }),
+            sourceRef: binding.sourceRef,
+            sourceDigest: binding.sourceDigest,
+        });
+        if (stableJson(binding) !== stableJson(canonical)) {
+            throw new Error('Interaction Space binding history contains a non-canonical fact');
+        }
+        if (canonical.bindingRevision !== index + 1) {
+            throw new Error('Interaction Space binding history revision is not contiguous');
+        }
+        if (previous
+            && canonical.effectiveAfterConversationSequence
+                < previous.effectiveAfterConversationSequence) {
+            throw new Error('Interaction Space binding history anchor moved backwards');
+        }
+        previous = canonical;
+        return canonical;
+    });
+    return deepFreeze(history);
+}
+function findReplay(history, input) {
+    const prior = history.find(binding => binding.sourceRef === input.sourceRef);
+    if (!prior)
+        return undefined;
+    const exact = prior.space === input.space
+        && prior.projectId === input.projectId
+        && prior.sourceDigest === input.sourceDigest;
+    if (!exact)
+        throw new Error('Interaction Space binding source replay payload drift');
+    return prior;
+}
+function normalizeBarrier(value, conversationKey) {
+    const snapshot = structuredClone(value);
+    assertObject(snapshot, 'conversation barrier');
+    assertExactKeys(snapshot, [
+        'version', 'conversationKey', 'currentSequence', 'sourceRef', 'sourceDigest',
+    ], 'conversation barrier');
+    if (snapshot.version !== 1 || snapshot.conversationKey !== conversationKey) {
+        throw new Error('Interaction Space conversation barrier does not match the conversation');
+    }
+    nonNegativeInteger(snapshot.currentSequence, 'conversation barrier currentSequence');
+    canonicalText(snapshot.sourceRef, 'conversation barrier sourceRef');
+    sha256(snapshot.sourceDigest, 'conversation barrier sourceDigest');
+    return deepFreeze({
+        version: 1,
+        conversationKey,
+        currentSequence: snapshot.currentSequence,
+        sourceRef: snapshot.sourceRef,
+        sourceDigest: snapshot.sourceDigest,
+    });
+}
+function normalizeDecision(value, request) {
+    const snapshot = structuredClone(value);
+    assertObject(snapshot, 'authority decision');
+    if (snapshot.authorized !== true && snapshot.authorized !== false) {
+        throw new Error('Interaction Space binding authority decision is invalid');
+    }
+    const outcomeKey = snapshot.authorized ? 'authorizedBy' : 'reason';
+    assertExactKeys(snapshot, [...Object.keys(request), 'authorized', outcomeKey], 'authority decision');
+    for (const key of Object.keys(request)) {
+        if (stableJson(snapshot[key]) !== stableJson(request[key])) {
+            throw new Error(`Interaction Space binding authority decision is stale for ${key}`);
+        }
+    }
+    if (snapshot.authorized) {
+        canonicalText(snapshot.authorizedBy, 'authority decision authorizedBy');
+    }
+    else {
+        canonicalText(snapshot.reason, 'authority decision reason');
+    }
+    return deepFreeze(snapshot);
+}
+function assertObject(value, field) {
+    if (!value || typeof value !== 'object' || Array.isArray(value)) {
+        throw new Error(`Interaction Space ${field} must be an object`);
+    }
+}
+function assertExactKeys(value, allowed, field) {
+    const allow = new Set(allowed);
+    const unexpected = Object.keys(value).find(key => !allow.has(key));
+    if (unexpected)
+        throw new Error(`Interaction Space ${field} contains forbidden field ${unexpected}`);
+}
+function canonicalText(value, field) {
+    if (typeof value !== 'string' || !value.trim() || value !== value.trim()) {
+        throw new Error(`Interaction Space ${field} must be canonical text`);
+    }
+}
+function sha256(value, field) {
+    if (typeof value !== 'string' || !/^sha256:[a-f0-9]{64}$/u.test(value)) {
+        throw new Error(`Interaction Space ${field} must be a canonical SHA-256 digest`);
+    }
+}
+function nonNegativeInteger(value, field) {
+    if (!Number.isSafeInteger(value) || value < 0) {
+        throw new Error(`Interaction Space ${field} must be a non-negative integer`);
+    }
+}
+//# sourceMappingURL=interaction-space-binding-service.js.map

package/lib/workroom/interaction-space-binding-service.js.map

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

package/lib/workroom/interaction-space-router.d.ts

@@ -0,0 +1,75 @@
+import { type ConversationRef } from '@zhin.js/im-contract';
+export type InteractionSpace = 'chat' | 'workroom' | 'sponsor_room';
+export interface InteractionSpaceBindingInput {
+    readonly conversation: ConversationRef;
+    readonly bindingRevision: number;
+    readonly effectiveAfterConversationSequence: number;
+    readonly space: InteractionSpace;
+    readonly projectId?: string;
+    readonly sourceRef: string;
+    readonly sourceDigest: string;
+}
+export interface InteractionSpaceBinding {
+    readonly version: 1;
+    readonly conversationKey: string;
+    readonly bindingRevision: number;
+    readonly effectiveAfterConversationSequence: number;
+    readonly space: InteractionSpace;
+    readonly projectId?: string;
+    readonly sourceRef: string;
+    readonly sourceDigest: string;
+    readonly digest: string;
+}
+export interface InteractionSpaceBindingRepository {
+    read(conversationKey: string): Promise<readonly InteractionSpaceBinding[]>;
+    append(conversationKey: string, expectedRevision: number, bindings: readonly InteractionSpaceBinding[]): Promise<readonly InteractionSpaceBinding[]>;
+}
+export type InteractionSpaceDecision = Readonly<{
+    status: 'resolved';
+    conversationKey: string;
+    conversationSequence?: number;
+    source: 'default';
+    space: 'chat';
+}> | Readonly<{
+    status: 'resolved';
+    conversationKey: string;
+    conversationSequence: number;
+    source: 'binding';
+    space: InteractionSpace;
+    bindingRevision: number;
+    bindingDigest: string;
+    projectId?: string;
+}> | Readonly<{
+    status: 'rejected';
+    conversationKey: string;
+    reason: 'conversation_sequence_required';
+}> | Readonly<{
+    status: 'ignored';
+    conversationKey: string;
+    conversationSequence: number;
+    bindingRevision: number;
+    bindingDigest: string;
+    reason: 'not_after_current_binding_anchor';
+}>;
+export interface ResolveInteractionSpaceInput {
+    readonly conversation: ConversationRef;
+    readonly conversationSequence?: number;
+}
+/**
+ * Resolves product-owned Interaction Space before chat commands or Agent
+ * triggering. It uses only durable binding history and the conversation event
+ * sequence; transport scope and message text never influence the decision.
+ */
+export declare class InteractionSpaceRouter {
+    readonly repository: InteractionSpaceBindingRepository;
+    constructor(repository: InteractionSpaceBindingRepository);
+    resolve(input: ResolveInteractionSpaceInput): Promise<InteractionSpaceDecision>;
+}
+/** In-memory contract adapter; production storage may implement the same CAS seam. */
+export declare class MemoryInteractionSpaceBindingRepository implements InteractionSpaceBindingRepository {
+    #private;
+    read(conversationKey: string): Promise<readonly InteractionSpaceBinding[]>;
+    append(conversationKey: string, expectedRevision: number, bindings: readonly InteractionSpaceBinding[]): Promise<readonly InteractionSpaceBinding[]>;
+}
+export declare function createInteractionSpaceBinding(input: InteractionSpaceBindingInput): InteractionSpaceBinding;
+//# sourceMappingURL=interaction-space-router.d.ts.map

package/lib/workroom/interaction-space-router.d.ts.map

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

package/lib/workroom/interaction-space-router.js

@@ -0,0 +1,243 @@
+import { deepFreezeWorkroomValue as deepFreeze, digestCanonicalWorkroomValue as digest, } from './canonical-value.js';
+import { conversationRefKey, } from '@zhin.js/im-contract';
+/**
+ * Resolves product-owned Interaction Space before chat commands or Agent
+ * triggering. It uses only durable binding history and the conversation event
+ * sequence; transport scope and message text never influence the decision.
+ */
+export class InteractionSpaceRouter {
+    repository;
+    constructor(repository) {
+        this.repository = repository;
+    }
+    async resolve(input) {
+        assertConversationRef(input.conversation);
+        const key = conversationRefKey(input.conversation);
+        if (input.conversationSequence !== undefined) {
+            positiveInteger(input.conversationSequence, 'conversationSequence');
+        }
+        const history = await this.repository.read(key);
+        validateHistory(key, history);
+        if (history.length === 0) {
+            return deepFreeze({
+                status: 'resolved',
+                conversationKey: key,
+                ...(input.conversationSequence !== undefined
+                    ? { conversationSequence: input.conversationSequence }
+                    : {}),
+                source: 'default',
+                space: 'chat',
+            });
+        }
+        if (input.conversationSequence === undefined) {
+            return deepFreeze({
+                status: 'rejected',
+                conversationKey: key,
+                reason: 'conversation_sequence_required',
+            });
+        }
+        const active = history.at(-1);
+        if (input.conversationSequence <= active.effectiveAfterConversationSequence) {
+            return deepFreeze({
+                status: 'ignored',
+                conversationKey: key,
+                conversationSequence: input.conversationSequence,
+                bindingRevision: active.bindingRevision,
+                bindingDigest: active.digest,
+                reason: 'not_after_current_binding_anchor',
+            });
+        }
+        return deepFreeze({
+            status: 'resolved',
+            conversationKey: key,
+            conversationSequence: input.conversationSequence,
+            source: 'binding',
+            space: active.space,
+            bindingRevision: active.bindingRevision,
+            bindingDigest: active.digest,
+            ...(active.projectId ? { projectId: active.projectId } : {}),
+        });
+    }
+}
+/** In-memory contract adapter; production storage may implement the same CAS seam. */
+export class MemoryInteractionSpaceBindingRepository {
+    #bindings = new Map();
+    async read(conversationKey) {
+        text(conversationKey, 'conversationKey');
+        return Object.freeze([...(this.#bindings.get(conversationKey) ?? [])]);
+    }
+    async append(conversationKey, expectedRevision, bindings) {
+        text(conversationKey, 'conversationKey');
+        nonNegativeInteger(expectedRevision, 'expectedRevision');
+        if (bindings.length === 0)
+            throw new Error('Interaction Space binding append requires facts');
+        const current = this.#bindings.get(conversationKey) ?? Object.freeze([]);
+        validateHistory(conversationKey, current);
+        const normalized = bindings.map(binding => normalizeBinding(binding, conversationKey));
+        if (expectedRevision < current.length) {
+            const replay = current.slice(expectedRevision, expectedRevision + normalized.length);
+            if (replay.length === normalized.length
+                && replay.every((binding, index) => binding.digest === normalized[index]?.digest)) {
+                return Object.freeze([...replay]);
+            }
+            throw new Error('Interaction Space binding replay conflict');
+        }
+        if (expectedRevision !== current.length) {
+            throw new Error(`Interaction Space binding revision conflict: expected ${expectedRevision}, actual ${current.length}`);
+        }
+        const next = [...current];
+        for (const binding of normalized) {
+            const previous = next.at(-1);
+            const expectedBindingRevision = (previous?.bindingRevision ?? 0) + 1;
+            if (binding.bindingRevision !== expectedBindingRevision) {
+                throw new Error('Interaction Space binding revisions must be contiguous');
+            }
+            if (previous
+                && binding.effectiveAfterConversationSequence
+                    < previous.effectiveAfterConversationSequence) {
+                throw new Error('Interaction Space binding anchor must not move backwards');
+            }
+            next.push(binding);
+        }
+        const stored = Object.freeze(next);
+        this.#bindings.set(conversationKey, stored);
+        return Object.freeze(normalized);
+    }
+}
+export function createInteractionSpaceBinding(input) {
+    assertConversationRef(input.conversation);
+    positiveInteger(input.bindingRevision, 'bindingRevision');
+    nonNegativeInteger(input.effectiveAfterConversationSequence, 'effectiveAfterConversationSequence');
+    const space = interactionSpace(input.space);
+    const projectId = input.projectId === undefined ? undefined : text(input.projectId, 'projectId');
+    if (space !== 'chat' && !projectId) {
+        throw new Error(`Interaction Space ${space} requires projectId`);
+    }
+    if (space === 'chat' && projectId !== undefined) {
+        throw new Error('Interaction Space chat must not carry projectId');
+    }
+    const projection = {
+        version: 1,
+        conversationKey: conversationRefKey(input.conversation),
+        bindingRevision: input.bindingRevision,
+        effectiveAfterConversationSequence: input.effectiveAfterConversationSequence,
+        space,
+        ...(projectId ? { projectId } : {}),
+        sourceRef: text(input.sourceRef, 'sourceRef'),
+        sourceDigest: sha256(input.sourceDigest, 'sourceDigest'),
+    };
+    return deepFreeze({ ...projection, digest: digest(projection) });
+}
+function normalizeBinding(value, conversationKey) {
+    if (!value || typeof value !== 'object')
+        throw new Error('Interaction Space binding is required');
+    exactKeys(value, [
+        'version', 'conversationKey', 'bindingRevision', 'effectiveAfterConversationSequence',
+        'space', 'projectId', 'sourceRef', 'sourceDigest', 'digest',
+    ], 'Interaction Space binding');
+    if (value.conversationKey !== conversationKey) {
+        throw new Error('Interaction Space binding conversation does not match repository scope');
+    }
+    const space = interactionSpace(value.space);
+    const projectId = value.projectId === undefined
+        ? undefined
+        : canonicalText(value.projectId, 'projectId');
+    const sourceRef = canonicalText(value.sourceRef, 'sourceRef');
+    const sourceDigest = sha256(value.sourceDigest, 'sourceDigest');
+    const projection = {
+        version: 1,
+        conversationKey,
+        bindingRevision: value.bindingRevision,
+        effectiveAfterConversationSequence: value.effectiveAfterConversationSequence,
+        space,
+        ...(projectId !== undefined ? { projectId } : {}),
+        sourceRef,
+        sourceDigest,
+    };
+    positiveInteger(projection.bindingRevision, 'bindingRevision');
+    nonNegativeInteger(projection.effectiveAfterConversationSequence, 'effectiveAfterConversationSequence');
+    if (space !== 'chat' && !projectId)
+        throw new Error(`${space} binding requires projectId`);
+    if (space === 'chat' && projectId !== undefined)
+        throw new Error('chat binding must not carry projectId');
+    if (value.version !== 1 || value.digest !== digest(projection)) {
+        throw new Error('Interaction Space binding digest is invalid');
+    }
+    return deepFreeze({ ...projection, digest: value.digest });
+}
+function validateHistory(conversationKey, history) {
+    let previous;
+    history.forEach((value, index) => {
+        const binding = normalizeBinding(value, conversationKey);
+        if (binding.bindingRevision !== index + 1) {
+            throw new Error('Interaction Space binding history revision is not contiguous');
+        }
+        if (previous
+            && binding.effectiveAfterConversationSequence
+                < previous.effectiveAfterConversationSequence) {
+            throw new Error('Interaction Space binding history anchor moved backwards');
+        }
+        previous = binding;
+    });
+}
+function interactionSpace(value) {
+    if (value !== 'chat' && value !== 'workroom' && value !== 'sponsor_room') {
+        throw new Error('Interaction Space is invalid');
+    }
+    return value;
+}
+function text(value, field) {
+    if (typeof value !== 'string' || !value.trim())
+        throw new Error(`${field} is required`);
+    return value.trim();
+}
+function assertConversationRef(value) {
+    if (!value || typeof value !== 'object')
+        throw new Error('ConversationRef is required');
+    exactKeys(value, [
+        'endpoint', 'kind', 'id', 'parent', 'threadId',
+    ], 'ConversationRef');
+    exactKeys(value.endpoint, ['adapter', 'id'], 'EndpointRef');
+    canonicalText(value.endpoint.adapter, 'conversation.endpoint.adapter');
+    canonicalText(value.endpoint.id, 'conversation.endpoint.id');
+    if (value.kind !== 'private' && value.kind !== 'group' && value.kind !== 'channel') {
+        throw new Error('conversation.kind is invalid');
+    }
+    canonicalText(value.id, 'conversation.id');
+    if (value.parent) {
+        exactKeys(value.parent, ['kind', 'id'], 'Conversation parent');
+        if (value.parent.kind !== 'private' && value.parent.kind !== 'group' && value.parent.kind !== 'channel') {
+            throw new Error('conversation.parent.kind is invalid');
+        }
+        canonicalText(value.parent.id, 'conversation.parent.id');
+    }
+    if (value.threadId !== undefined)
+        canonicalText(value.threadId, 'conversation.threadId');
+}
+function canonicalText(value, field) {
+    const normalized = text(value, field);
+    if (value !== normalized)
+        throw new Error(`${field} must be canonical text`);
+    return normalized;
+}
+function sha256(value, field) {
+    if (typeof value !== 'string' || !/^sha256:[a-f0-9]{64}$/u.test(value)) {
+        throw new Error(`${field} must be a canonical SHA-256 digest`);
+    }
+    return value;
+}
+function positiveInteger(value, field) {
+    if (!Number.isSafeInteger(value) || value <= 0)
+        throw new Error(`${field} must be a positive integer`);
+}
+function nonNegativeInteger(value, field) {
+    if (!Number.isSafeInteger(value) || value < 0)
+        throw new Error(`${field} must be a non-negative integer`);
+}
+function exactKeys(value, allowed, field) {
+    const allow = new Set(allowed);
+    const unknown = Object.keys(value).filter(key => !allow.has(key));
+    if (unknown.length > 0)
+        throw new Error(`${field} has unknown fields: ${unknown.join(', ')}`);
+}
+//# sourceMappingURL=interaction-space-router.js.map

package/lib/workroom/interaction-space-router.js.map

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

package/lib/workroom/journal-model.d.ts

@@ -0,0 +1,40 @@
+export declare const WORKROOM_EVENT_MODEL: {
+    id: {
+        type: "text";
+        primary: boolean;
+        nullable: boolean;
+    };
+    run_id: {
+        type: "text";
+        nullable: boolean;
+    };
+    sequence: {
+        type: "integer";
+        nullable: boolean;
+    };
+    version: {
+        type: "integer";
+        nullable: boolean;
+    };
+    type: {
+        type: "text";
+        nullable: boolean;
+    };
+    payload_json: {
+        type: "text";
+        nullable: boolean;
+    };
+    occurred_at: {
+        type: "integer";
+        nullable: boolean;
+    };
+    stored_event_digest: {
+        type: "text";
+        nullable: boolean;
+    };
+    row_binding_digest: {
+        type: "text";
+        nullable: boolean;
+    };
+};
+//# sourceMappingURL=journal-model.d.ts.map

package/lib/workroom/journal-model.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"journal-model.d.ts","sourceRoot":"","sources":["../../src/workroom/journal-model.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAUhC,CAAC"}

package/lib/workroom/journal-model.js

@@ -0,0 +1,12 @@
+export const WORKROOM_EVENT_MODEL = {
+    id: { type: 'text', primary: true, nullable: false },
+    run_id: { type: 'text', nullable: false },
+    sequence: { type: 'integer', nullable: false },
+    version: { type: 'integer', nullable: false },
+    type: { type: 'text', nullable: false },
+    payload_json: { type: 'text', nullable: false },
+    occurred_at: { type: 'integer', nullable: false },
+    stored_event_digest: { type: 'text', nullable: false },
+    row_binding_digest: { type: 'text', nullable: false },
+};
+//# sourceMappingURL=journal-model.js.map

package/lib/workroom/journal-model.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"journal-model.js","sourceRoot":"","sources":["../../src/workroom/journal-model.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,oBAAoB,GAAG;IAClC,EAAE,EAAE,EAAE,IAAI,EAAE,MAAe,EAAE,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE;IAC7D,MAAM,EAAE,EAAE,IAAI,EAAE,MAAe,EAAE,QAAQ,EAAE,KAAK,EAAE;IAClD,QAAQ,EAAE,EAAE,IAAI,EAAE,SAAkB,EAAE,QAAQ,EAAE,KAAK,EAAE;IACvD,OAAO,EAAE,EAAE,IAAI,EAAE,SAAkB,EAAE,QAAQ,EAAE,KAAK,EAAE;IACtD,IAAI,EAAE,EAAE,IAAI,EAAE,MAAe,EAAE,QAAQ,EAAE,KAAK,EAAE;IAChD,YAAY,EAAE,EAAE,IAAI,EAAE,MAAe,EAAE,QAAQ,EAAE,KAAK,EAAE;IACxD,WAAW,EAAE,EAAE,IAAI,EAAE,SAAkB,EAAE,QAAQ,EAAE,KAAK,EAAE;IAC1D,mBAAmB,EAAE,EAAE,IAAI,EAAE,MAAe,EAAE,QAAQ,EAAE,KAAK,EAAE;IAC/D,kBAAkB,EAAE,EAAE,IAAI,EAAE,MAAe,EAAE,QAAQ,EAAE,KAAK,EAAE;CAC/D,CAAC"}