@jterrats/open-orchestra 1.0.16 → 1.0.18

package/dist/chat-compliance-service.js

@@ -0,0 +1,241 @@
+import { randomUUID } from "node:crypto";
+import { ChatStorageError, safeStorageIssue } from "./chat-storage.js";
+import { createLocalChatStorage } from "./chat-storage-local.js";
+import { LocalChatStorageFiles } from "./chat-storage-local-files.js";
+import { appendEvent } from "./workspace.js";
+import { classifyRestrictedData, restrictedAuditEventForClassification, } from "./security/restricted-data-classifier.js";
+const workspaceScopeDefaults = {
+    taskId: "workspace",
+    runId: "workspace",
+    phase: "workspace",
+    sessionId: "workspace",
+};
+export class ChatComplianceService {
+    workspaceRoot;
+    storage;
+    files;
+    now;
+    constructor(options) {
+        this.workspaceRoot = options.workspaceRoot;
+        this.storage =
+            options.storage ??
+                createLocalChatStorage({ workspaceRoot: options.workspaceRoot });
+        this.files = new LocalChatStorageFiles(options.workspaceRoot);
+        this.now = options.now ?? (() => new Date().toISOString());
+    }
+    async exportEvidence(input) {
+        const now = this.now();
+        const selection = input.selection;
+        const matched = await this.resolveSelection(selection);
+        const records = matched.threads.map((thread) => exportRecordForThread({
+            thread,
+            messages: matched.messages.filter((message) => message.threadId === thread.id),
+            scope: thread.scope,
+            exportedAt: now,
+            includeTombstoned: input.includeTombstoned ?? false,
+        }));
+        const restrictedEvents = restrictedAuditEventsForRecords(records);
+        const taskId = selection.kind === "thread"
+            ? matched.threads[0]?.scope.taskId
+            : selection.taskId;
+        const audit = await appendEvent(this.workspaceRoot, {
+            type: "CHAT_EXPORT_RECORDED",
+            actor: input.actor.actorId,
+            summary: `Chat export recorded for ${selection.kind}`,
+            ...(taskId ? { taskId } : {}),
+            metadata: {
+                actorRole: input.actor.role,
+                tenantId: selection.tenantId,
+                workspaceId: selection.workspaceId,
+                selection,
+                exportedAt: now,
+                threadCount: records.length,
+                messageCount: records.reduce((total, record) => total + record.messages.length, 0),
+                restrictedEventCount: restrictedEvents.length,
+                restrictedEvents,
+            },
+        });
+        return {
+            selection,
+            exportedAt: now,
+            records,
+            markdown: renderExportMarkdown(selection, records),
+            auditEventId: audit.id,
+        };
+    }
+    async deleteScope(input) {
+        const now = this.now();
+        const matched = await this.resolveSelection(input.selection);
+        const deletion = deletionMetadata({
+            actorId: input.actor.actorId,
+            reasonCode: input.reasonCode,
+            now,
+        });
+        const deletedMessages = [];
+        for (const message of matched.messages.filter((entry) => entry.delete.status !== "tombstoned")) {
+            await this.storage.tombstoneMessage(message.scope, message.id, deletion);
+            deletedMessages.push(message.id);
+        }
+        const deletedThreads = [];
+        for (const thread of matched.threads.filter((entry) => entry.delete.status !== "tombstoned")) {
+            await this.storage.tombstoneThread(thread.scope, thread.id, deletion);
+            deletedThreads.push(thread.id);
+        }
+        const taskId = input.selection.kind === "thread"
+            ? matched.threads[0]?.scope.taskId
+            : input.selection.taskId;
+        const audit = await appendEvent(this.workspaceRoot, {
+            type: "CHAT_DELETE_RECORDED",
+            actor: input.actor.actorId,
+            summary: `Chat delete recorded for ${input.selection.kind}`,
+            ...(taskId ? { taskId } : {}),
+            metadata: {
+                actorRole: input.actor.role,
+                tenantId: input.selection.tenantId,
+                workspaceId: input.selection.workspaceId,
+                selection: input.selection,
+                deletedAt: now,
+                deletedThreads,
+                deletedMessages,
+            },
+        });
+        return {
+            selection: input.selection,
+            deletedThreads,
+            deletedMessages,
+            auditEventId: audit.id,
+        };
+    }
+    async resolveSelection(selection) {
+        const scope = workspaceProjectionScope(selection);
+        await this.files.ensureScope(scope);
+        const threads = (await this.files.projectThreads(scope)).filter((thread) => matchesSelection(thread.scope, selection));
+        const messages = (await this.files.projectMessages(scope)).filter((message) => matchesSelection(message.scope, selection));
+        if (selection.kind === "thread") {
+            const selectedThreads = threads.filter((thread) => thread.id === selection.threadId);
+            const selectedMessages = messages.filter((message) => message.threadId === selection.threadId);
+            assertSelectionNotEmpty(selection, selectedThreads, selectedMessages);
+            return {
+                threads: selectedThreads,
+                messages: selectedMessages,
+            };
+        }
+        assertSelectionNotEmpty(selection, threads, messages);
+        return { threads, messages };
+    }
+}
+function workspaceProjectionScope(selection) {
+    return {
+        tenantId: selection.tenantId,
+        workspaceId: selection.workspaceId,
+        ...workspaceScopeDefaults,
+    };
+}
+function matchesSelection(scope, selection) {
+    if (scope.tenantId !== selection.tenantId ||
+        scope.workspaceId !== selection.workspaceId) {
+        return false;
+    }
+    if (selection.kind === "thread") {
+        return true;
+    }
+    if (selection.kind === "task") {
+        return scope.taskId === selection.taskId;
+    }
+    return scope.taskId === selection.taskId && scope.runId === selection.runId;
+}
+function exportRecordForThread(input) {
+    const thread = exportThreadRecord(input.thread);
+    const messages = input.messages
+        .filter((message) => input.includeTombstoned || message.contentState !== "tombstoned")
+        .map(exportMessageRecord);
+    return {
+        schemaVersion: thread.schemaVersion,
+        scope: input.scope,
+        thread,
+        messages,
+        exportedAt: input.exportedAt,
+        content: "redacted_only",
+    };
+}
+function exportThreadRecord(thread) {
+    return {
+        ...thread,
+        export: exportRedactedMetadata(thread.export),
+    };
+}
+function exportMessageRecord(message) {
+    const text = message.contentState === "tombstoned" ? "" : message.content.text;
+    const classification = classifyRestrictedData(text);
+    const restricted = classification.hasRestrictedData
+        ? restrictedAuditEventForClassification({
+            eventType: "restricted_redacted_exported",
+            sourceId: message.id,
+            classification,
+        })
+        : undefined;
+    return {
+        ...message,
+        content: message.contentState === "tombstoned"
+            ? { ...message.content, text: "" }
+            : { ...message.content, text: classification.redactedText },
+        export: exportRedactedMetadata(message.export),
+        ...(restricted ? { restricted } : {}),
+    };
+}
+function exportRedactedMetadata(exportMetadata) {
+    return {
+        ...exportMetadata,
+        status: "redacted_only",
+        rawContentExportable: false,
+    };
+}
+function deletionMetadata(input) {
+    return {
+        status: "tombstoned",
+        policyId: "chat-delete-audit-tombstone",
+        tombstonedAt: input.now,
+        tombstonedByActorId: input.actorId,
+        reasonCode: input.reasonCode,
+    };
+}
+function renderExportMarkdown(selection, records) {
+    const lines = [
+        "# Chat Evidence Export",
+        "",
+        `- Scope: ${selection.kind}`,
+        `- Tenant: ${selection.tenantId}`,
+        `- Workspace: ${selection.workspaceId}`,
+        `- Threads: ${records.length}`,
+        "",
+    ];
+    for (const record of records) {
+        lines.push(`## ${record.thread.title}`);
+        lines.push("");
+        lines.push(`- Task: ${record.scope.taskId}`);
+        lines.push(`- Run: ${record.scope.runId}`);
+        lines.push(`- Phase: ${record.scope.phase}`);
+        lines.push(`- Exported At: ${record.exportedAt}`);
+        lines.push("");
+        for (const message of record.messages) {
+            lines.push(`- [${message.actor.kind}] ${message.createdAt}: ${message.content.text || "[deleted]"}`);
+            if (message.restricted) {
+                lines.push(`  - restricted: categories=${message.restricted.categories.join(",")} redactions=${message.restricted.redactionCount} markers=${message.restricted.redactionMarkers.join(",")}`);
+            }
+        }
+        lines.push("");
+    }
+    return lines.join("\n");
+}
+function restrictedAuditEventsForRecords(records) {
+    return records.flatMap((record) => record.messages.flatMap((message) => message.restricted ? [message.restricted] : []));
+}
+export function auditArtifactFileName(prefix) {
+    return `${prefix}-${randomUUID()}.json`;
+}
+function assertSelectionNotEmpty(selection, threads, messages) {
+    if (threads.length > 0 || messages.length > 0)
+        return;
+    throw new ChatStorageError(safeStorageIssue("not_found", "selection", `Chat compliance selection did not match any ${selection.kind} records.`));
+}
+//# sourceMappingURL=chat-compliance-service.js.map

package/dist/chat-compliance-service.js.map

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

package/dist/chat-event-stream.d.ts

@@ -0,0 +1,13 @@
+import type { ChatMessage } from "./types/chat.js";
+import type { ChatStreamEvent } from "./chat-api-types.js";
+import type { ChatScope } from "./types/chat.js";
+export declare function eventsForStoredMessage(message: ChatMessage): ChatStreamEvent[];
+export declare function renderServerSentEvents(events: ChatStreamEvent[]): string;
+export declare function errorStreamEvents(input: {
+    requestId: string;
+    threadId: string;
+    scope: ChatScope;
+    code: string;
+    message: string;
+    retryable: boolean;
+}): ChatStreamEvent[];

package/dist/chat-event-stream.js

@@ -0,0 +1,124 @@
+export function eventsForStoredMessage(message) {
+    if (message.timelineEvent) {
+        return [
+            {
+                eventId: `${message.id}:timeline`,
+                threadId: message.threadId,
+                scope: message.scope,
+                createdAt: message.createdAt,
+                sequence: message.sequence,
+                type: isRuntimeTimelineEvent(message.timelineEvent.eventType)
+                    ? "runtime.lifecycle"
+                    : "workflow.event",
+                data: isRuntimeTimelineEvent(message.timelineEvent.eventType)
+                    ? {
+                        lifecycleStatus: message.timelineEvent.eventType,
+                        runtimeEvent: message.timelineEvent,
+                    }
+                    : { workflowEvent: message.timelineEvent },
+            },
+        ];
+    }
+    return [
+        {
+            eventId: `${message.id}:created`,
+            threadId: message.threadId,
+            scope: message.scope,
+            createdAt: message.createdAt,
+            sequence: message.sequence,
+            type: "message.created",
+            data: { message },
+        },
+        {
+            eventId: `${message.id}:delta`,
+            threadId: message.threadId,
+            scope: message.scope,
+            createdAt: message.createdAt,
+            sequence: message.sequence,
+            type: "message.delta",
+            data: { text: message.content.text },
+        },
+        {
+            eventId: `${message.id}:workflow`,
+            threadId: message.threadId,
+            scope: message.scope,
+            createdAt: message.createdAt,
+            sequence: message.sequence,
+            type: "workflow.event",
+            data: {
+                workflowEvent: {
+                    sourceEventId: `${message.id}:workflow`,
+                    eventType: "chat.message.persisted",
+                    actor: message.actor.actorId,
+                    summary: "chat message persisted",
+                    taskId: message.scope.taskId,
+                    runId: message.scope.runId,
+                    phase: message.scope.phase,
+                    artifacts: [],
+                },
+            },
+        },
+        {
+            eventId: `${message.id}:runtime`,
+            threadId: message.threadId,
+            scope: message.scope,
+            createdAt: message.createdAt,
+            sequence: message.sequence,
+            type: "runtime.lifecycle",
+            data: { lifecycleStatus: "ready" },
+        },
+        {
+            eventId: `${message.id}:complete`,
+            threadId: message.threadId,
+            scope: message.scope,
+            createdAt: message.createdAt,
+            sequence: message.sequence,
+            type: "complete",
+            data: { text: "message persisted" },
+        },
+    ];
+}
+function isRuntimeTimelineEvent(eventType) {
+    return eventType.startsWith("RUNTIME_");
+}
+export function renderServerSentEvents(events) {
+    return `${events.map(renderEvent).join("")}`;
+}
+export function errorStreamEvents(input) {
+    const createdAt = new Date().toISOString();
+    return [
+        {
+            eventId: `${input.requestId}:error`,
+            threadId: input.threadId,
+            scope: input.scope,
+            createdAt,
+            sequence: 0,
+            type: "error",
+            data: {
+                code: input.code,
+                message: input.message,
+            },
+        },
+        {
+            eventId: `${input.requestId}:complete`,
+            threadId: input.threadId,
+            scope: input.scope,
+            createdAt,
+            sequence: 0,
+            type: "complete",
+            data: {
+                text: input.retryable ? "stream retry available" : "stream closed",
+            },
+        },
+    ];
+}
+function renderEvent(event) {
+    return [
+        `id: ${event.eventId}`,
+        `event: ${event.type}`,
+        `data: ${JSON.stringify(event)}`,
+        "",
+        "",
+    ].join("\n");
+}
+//# sourceMappingURL=chat-event-stream.js.map

package/dist/chat-event-stream.js.map

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

package/dist/chat-pagination.d.ts

@@ -0,0 +1,6 @@
+import type { ChatListOptions, ChatScope } from "./types/chat.js";
+export interface ChatPaginationResult<T> {
+    items: T[];
+    nextCursor?: string;
+}
+export declare function paginateChatRecords<T>(items: T[], options: ChatListOptions, scope: ChatScope, threadId?: string): ChatPaginationResult<T>;

package/dist/chat-pagination.js

@@ -0,0 +1,64 @@
+import { createHash } from "node:crypto";
+export function paginateChatRecords(items, options, scope, threadId) {
+    const limit = normalizeLimit(options.limit);
+    const offset = options.cursor
+        ? decodeCursor(options.cursor, scope, threadId).offset
+        : 0;
+    const page = items.slice(offset, offset + limit);
+    const nextOffset = offset + page.length;
+    return {
+        items: page,
+        ...(nextOffset < items.length
+            ? {
+                nextCursor: encodeCursor({
+                    scopeHash: hashScope(scope),
+                    ...(threadId ? { threadId } : {}),
+                    offset: nextOffset,
+                }),
+            }
+            : {}),
+    };
+}
+function normalizeLimit(limit) {
+    if (limit === undefined)
+        return 50;
+    if (!Number.isSafeInteger(limit) || limit < 1 || limit > 100)
+        return 50;
+    return limit;
+}
+function encodeCursor(payload) {
+    return Buffer.from(JSON.stringify(payload), "utf8").toString("base64url");
+}
+function decodeCursor(cursor, scope, threadId) {
+    try {
+        const payload = JSON.parse(Buffer.from(cursor, "base64url").toString("utf8"));
+        if (payload.scopeHash !== hashScope(scope) ||
+            payload.threadId !== threadId ||
+            !Number.isSafeInteger(payload.offset) ||
+            payload.offset === undefined ||
+            payload.offset < 0) {
+            throw new Error("cursor scope mismatch");
+        }
+        return {
+            scopeHash: payload.scopeHash,
+            ...(payload.threadId ? { threadId: payload.threadId } : {}),
+            offset: payload.offset,
+        };
+    }
+    catch {
+        throw new Error("chat cursor is invalid for this scope");
+    }
+}
+function hashScope(scope) {
+    return createHash("sha256")
+        .update([
+        scope.tenantId,
+        scope.workspaceId,
+        scope.taskId,
+        scope.runId,
+        scope.phase,
+        scope.sessionId,
+    ].join("\u001f"))
+        .digest("base64url");
+}
+//# sourceMappingURL=chat-pagination.js.map

package/dist/chat-pagination.js.map

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

package/dist/chat-storage-actor-validation.d.ts

@@ -0,0 +1,4 @@
+import { type ChatValidationIssue } from "./chat-storage-errors.js";
+import type { ChatActor, ChatActorKind } from "./types/chat.js";
+export declare function isKnownChatActorKind(kind: string): kind is ChatActorKind;
+export declare function validateActor(actor: ChatActor, field: string): ChatValidationIssue[];

package/dist/chat-storage-actor-validation.js

@@ -0,0 +1,65 @@
+import { CHAT_ACTOR_KINDS } from "./types/chat.js";
+import { safeStorageIssue, } from "./chat-storage-errors.js";
+export function isKnownChatActorKind(kind) {
+    return CHAT_ACTOR_KINDS.includes(kind);
+}
+export function validateActor(actor, field) {
+    if (!actor || !isKnownChatActorKind(actor.kind)) {
+        return [
+            safeStorageIssue("invalid_actor", `${field}.kind`, "Chat actor kind is not supported."),
+        ];
+    }
+    switch (actor.kind) {
+        case "human":
+            return requiredStringIssues(field, [
+                ["actorId", actor.actorId],
+                ["displayName", actor.displayName],
+                ["source", actor.source],
+                ["sessionId", actor.sessionId],
+            ]);
+        case "parent_agent":
+            return requiredStringIssues(field, [
+                ["actorId", actor.actorId],
+                ["runtime", actor.runtime],
+                ["sessionId", actor.sessionId],
+            ]);
+        case "subagent":
+            return requiredStringIssues(field, [
+                ["actorId", actor.actorId],
+                ["runtime", actor.runtime],
+                ["role", actor.role],
+                ["sessionId", actor.sessionId],
+                ["parentSessionId", actor.parentSessionId],
+            ]);
+        case "provider_agent":
+            return requiredStringIssues(field, [
+                ["actorId", actor.actorId],
+                ["provider", actor.provider],
+                ["model", actor.model],
+                ["requestId", actor.requestId],
+            ]);
+        case "system":
+            return requiredStringIssues(field, [
+                ["actorId", actor.actorId],
+                ["source", actor.source],
+            ]);
+        case "reviewer":
+            return requiredStringIssues(field, [
+                ["actorId", actor.actorId],
+                ["role", actor.role],
+                ["reviewId", actor.reviewId],
+            ]);
+        case "workflow_event":
+            return requiredStringIssues(field, [
+                ["actorId", actor.actorId],
+                ["sourceEventId", actor.sourceEventId],
+                ["eventType", actor.eventType],
+            ]);
+    }
+}
+function requiredStringIssues(field, values) {
+    return values
+        .filter(([, value]) => !value)
+        .map(([key]) => safeStorageIssue("invalid_actor", `${field}.${key}`, "Chat actor field is required."));
+}
+//# sourceMappingURL=chat-storage-actor-validation.js.map

package/dist/chat-storage-actor-validation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"chat-storage-actor-validation.js","sourceRoot":"","sources":["../src/chat-storage-actor-validation.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AACnD,OAAO,EACL,gBAAgB,GAEjB,MAAM,0BAA0B,CAAC;AAGlC,MAAM,UAAU,oBAAoB,CAAC,IAAY;IAC/C,OAAO,gBAAgB,CAAC,QAAQ,CAAC,IAAqB,CAAC,CAAC;AAC1D,CAAC;AAED,MAAM,UAAU,aAAa,CAC3B,KAAgB,EAChB,KAAa;IAEb,IAAI,CAAC,KAAK,IAAI,CAAC,oBAAoB,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC;QAChD,OAAO;YACL,gBAAgB,CACd,eAAe,EACf,GAAG,KAAK,OAAO,EACf,mCAAmC,CACpC;SACF,CAAC;IACJ,CAAC;IACD,QAAQ,KAAK,CAAC,IAAI,EAAE,CAAC;QACnB,KAAK,OAAO;YACV,OAAO,oBAAoB,CAAC,KAAK,EAAE;gBACjC,CAAC,SAAS,EAAE,KAAK,CAAC,OAAO,CAAC;gBAC1B,CAAC,aAAa,EAAE,KAAK,CAAC,WAAW,CAAC;gBAClC,CAAC,QAAQ,EAAE,KAAK,CAAC,MAAM,CAAC;gBACxB,CAAC,WAAW,EAAE,KAAK,CAAC,SAAS,CAAC;aAC/B,CAAC,CAAC;QACL,KAAK,cAAc;YACjB,OAAO,oBAAoB,CAAC,KAAK,EAAE;gBACjC,CAAC,SAAS,EAAE,KAAK,CAAC,OAAO,CAAC;gBAC1B,CAAC,SAAS,EAAE,KAAK,CAAC,OAAO,CAAC;gBAC1B,CAAC,WAAW,EAAE,KAAK,CAAC,SAAS,CAAC;aAC/B,CAAC,CAAC;QACL,KAAK,UAAU;YACb,OAAO,oBAAoB,CAAC,KAAK,EAAE;gBACjC,CAAC,SAAS,EAAE,KAAK,CAAC,OAAO,CAAC;gBAC1B,CAAC,SAAS,EAAE,KAAK,CAAC,OAAO,CAAC;gBAC1B,CAAC,MAAM,EAAE,KAAK,CAAC,IAAI,CAAC;gBACpB,CAAC,WAAW,EAAE,KAAK,CAAC,SAAS,CAAC;gBAC9B,CAAC,iBAAiB,EAAE,KAAK,CAAC,eAAe,CAAC;aAC3C,CAAC,CAAC;QACL,KAAK,gBAAgB;YACnB,OAAO,oBAAoB,CAAC,KAAK,EAAE;gBACjC,CAAC,SAAS,EAAE,KAAK,CAAC,OAAO,CAAC;gBAC1B,CAAC,UAAU,EAAE,KAAK,CAAC,QAAQ,CAAC;gBAC5B,CAAC,OAAO,EAAE,KAAK,CAAC,KAAK,CAAC;gBACtB,CAAC,WAAW,EAAE,KAAK,CAAC,SAAS,CAAC;aAC/B,CAAC,CAAC;QACL,KAAK,QAAQ;YACX,OAAO,oBAAoB,CAAC,KAAK,EAAE;gBACjC,CAAC,SAAS,EAAE,KAAK,CAAC,OAAO,CAAC;gBAC1B,CAAC,QAAQ,EAAE,KAAK,CAAC,MAAM,CAAC;aACzB,CAAC,CAAC;QACL,KAAK,UAAU;YACb,OAAO,oBAAoB,CAAC,KAAK,EAAE;gBACjC,CAAC,SAAS,EAAE,KAAK,CAAC,OAAO,CAAC;gBAC1B,CAAC,MAAM,EAAE,KAAK,CAAC,IAAI,CAAC;gBACpB,CAAC,UAAU,EAAE,KAAK,CAAC,QAAQ,CAAC;aAC7B,CAAC,CAAC;QACL,KAAK,gBAAgB;YACnB,OAAO,oBAAoB,CAAC,KAAK,EAAE;gBACjC,CAAC,SAAS,EAAE,KAAK,CAAC,OAAO,CAAC;gBAC1B,CAAC,eAAe,EAAE,KAAK,CAAC,aAAa,CAAC;gBACtC,CAAC,WAAW,EAAE,KAAK,CAAC,SAAS,CAAC;aAC/B,CAAC,CAAC;IACP,CAAC;AACH,CAAC;AAED,SAAS,oBAAoB,CAC3B,KAAa,EACb,MAAwC;IAExC,OAAO,MAAM;SACV,MAAM,CAAC,CAAC,CAAC,EAAE,KAAK,CAAC,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC;SAC7B,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE,EAAE,CACb,gBAAgB,CACd,eAAe,EACf,GAAG,KAAK,IAAI,GAAG,EAAE,EACjB,+BAA+B,CAChC,CACF,CAAC;AACN,CAAC"}

package/dist/chat-storage-content-policy.d.ts

@@ -0,0 +1,6 @@
+import { type ChatValidationIssue } from "./chat-storage-errors.js";
+import type { ChatDeleteMetadata, ChatExportMetadata, ChatMessage, ChatRetentionMetadata, ChatThread } from "./types/chat.js";
+export declare function validateContentPolicy(recordName: "thread" | "message", record: ChatThread | ChatMessage): ChatValidationIssue[];
+export declare function validateRetention(retention: ChatRetentionMetadata, field: string): ChatValidationIssue[];
+export declare function validateExport(exportMetadata: ChatExportMetadata, field: string): ChatValidationIssue[];
+export declare function validateDeletion(deletion: ChatDeleteMetadata, field: string): ChatValidationIssue[];

package/dist/chat-storage-content-policy.js

@@ -0,0 +1,84 @@
+import { safeStorageIssue, } from "./chat-storage-errors.js";
+export function validateContentPolicy(recordName, record) {
+    const issues = [];
+    if (record.contentState === "raw") {
+        issues.push(...rawContentIssues(recordName, record));
+    }
+    if (record.contentState === "redacted" && recordName === "message") {
+        issues.push(...redactedContentIssues(recordName, record));
+    }
+    if (record.contentState === "tombstoned") {
+        issues.push(...tombstoneContentIssues(recordName, record));
+    }
+    return issues;
+}
+function rawContentIssues(recordName, record) {
+    if (record.retention.status === "raw_allowed" &&
+        record.retention.rawPersistence === "allowed") {
+        return [];
+    }
+    return [
+        safeStorageIssue("invalid_content_policy", `${recordName}.retention`, "Raw chat content requires an explicit raw retention policy."),
+    ];
+}
+function redactedContentIssues(recordName, record) {
+    if (!("redaction" in record) || !record.redaction) {
+        return [
+            safeStorageIssue("invalid_content_policy", `${recordName}.redaction`, "Redacted chat content requires redaction provenance."),
+        ];
+    }
+    return validateRedaction(record.redaction, `${recordName}.redaction`);
+}
+function tombstoneContentIssues(recordName, record) {
+    const issues = [];
+    if (record.delete.status !== "tombstoned") {
+        issues.push(safeStorageIssue("invalid_content_policy", `${recordName}.delete.status`, "Tombstoned chat content requires tombstone metadata."));
+    }
+    if (record.export.rawContentExportable ||
+        record.export.status === "exportable") {
+        issues.push(safeStorageIssue("invalid_content_policy", `${recordName}.export`, "Tombstoned chat content must not be raw exportable."));
+    }
+    return issues;
+}
+export function validateRetention(retention, field) {
+    if (!retention) {
+        return [
+            safeStorageIssue("invalid_content_policy", field, "Retention metadata is required."),
+        ];
+    }
+    return missingMetadataIssues(retention, field, ["policyId", "status", "rawPersistence", "decidedAt"], "Retention");
+}
+export function validateExport(exportMetadata, field) {
+    if (!exportMetadata) {
+        return [
+            safeStorageIssue("invalid_content_policy", field, "Export metadata is required."),
+        ];
+    }
+    const issues = missingMetadataIssues(exportMetadata, field, ["status", "policyId", "decidedAt"], "Export");
+    if (typeof exportMetadata.rawContentExportable !== "boolean") {
+        issues.push(safeStorageIssue("invalid_content_policy", `${field}.rawContentExportable`, "Raw exportability must be explicit."));
+    }
+    return issues;
+}
+export function validateDeletion(deletion, field) {
+    if (!deletion) {
+        return [
+            safeStorageIssue("invalid_content_policy", field, "Delete metadata is required."),
+        ];
+    }
+    return missingMetadataIssues(deletion, field, ["status", "policyId"], "Delete");
+}
+function validateRedaction(redaction, field) {
+    const issues = missingMetadataIssues(redaction, field, ["policyId", "status", "redactedAt", "redactedByActorId", "summary"], "Redaction");
+    if (!Number.isSafeInteger(redaction.markerCount) ||
+        redaction.markerCount < 0) {
+        issues.push(safeStorageIssue("invalid_content_policy", `${field}.markerCount`, "Redaction marker count must be a non-negative safe integer."));
+    }
+    return issues;
+}
+function missingMetadataIssues(value, field, keys, label) {
+    return keys
+        .filter((key) => !value[key])
+        .map((key) => safeStorageIssue("invalid_content_policy", `${field}.${key}`, `${label} field is required.`));
+}
+//# sourceMappingURL=chat-storage-content-policy.js.map