@jterrats/open-orchestra 1.0.17 → 1.1.0

package/dist/chat-api-storage.js

@@ -0,0 +1,14 @@
+import { ChatApiError } from "./chat-api-errors.js";
+export async function safeCursorList(operation, requestId) {
+    try {
+        return await operation();
+    }
+    catch (error) {
+        if (error instanceof Error &&
+            error.message === "chat cursor is invalid for this scope") {
+            throw new ChatApiError("invalid_cursor", "chat cursor is invalid", 400, requestId);
+        }
+        throw error;
+    }
+}
+//# sourceMappingURL=chat-api-storage.js.map

package/dist/chat-api-storage.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"chat-api-storage.js","sourceRoot":"","sources":["../src/chat-api-storage.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AAEpD,MAAM,CAAC,KAAK,UAAU,cAAc,CAClC,SAA2B,EAC3B,SAAiB;IAEjB,IAAI,CAAC;QACH,OAAO,MAAM,SAAS,EAAE,CAAC;IAC3B,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IACE,KAAK,YAAY,KAAK;YACtB,KAAK,CAAC,OAAO,KAAK,uCAAuC,EACzD,CAAC;YACD,MAAM,IAAI,YAAY,CACpB,gBAAgB,EAChB,wBAAwB,EACxB,GAAG,EACH,SAAS,CACV,CAAC;QACJ,CAAC;QACD,MAAM,KAAK,CAAC;IACd,CAAC;AACH,CAAC"}

package/dist/chat-api-types.d.ts

@@ -0,0 +1,81 @@
+import type { ChatActor, ChatMessage, ChatScope, ChatThread, ChatWorkflowTimelineEvent } from "./types/chat.js";
+export interface ChatApiMeta {
+    requestId: string;
+    idempotencyKey?: string;
+    idempotentReplay?: boolean;
+    nextCursor?: string;
+    policyDecisionId?: string;
+}
+export interface ChatApiSuccess<T> {
+    data: T;
+    meta: ChatApiMeta;
+}
+export interface ChatApiErrorBody {
+    error: {
+        code: string;
+        message: string;
+        requestId: string;
+        retryable: boolean;
+    };
+}
+export interface CreateChatThreadInput {
+    requestId?: string;
+    scope: ChatScope;
+    title: string;
+    actor: ChatActor;
+}
+export interface ListChatInput {
+    requestId?: string;
+    scope: ChatScope;
+    limit?: number;
+    cursor?: string;
+}
+export interface ChatThreadInput {
+    requestId?: string;
+    scope: ChatScope;
+    threadId: string;
+}
+export interface ChatMessagesInput extends ChatThreadInput {
+    limit?: number;
+    cursor?: string;
+}
+export interface ChatMessageInput extends ChatThreadInput {
+    idempotencyKey?: string;
+    actor: ChatActor;
+    text: string;
+    format?: "plain_text" | "markdown";
+}
+export interface ChatSendInput extends ChatMessageInput {
+    stream?: boolean;
+}
+export type ChatStreamEventType = "message.created" | "message.delta" | "workflow.event" | "runtime.lifecycle" | "policy.blocked" | "error" | "complete";
+export interface ChatStreamEvent {
+    eventId: string;
+    threadId: string;
+    scope: ChatScope;
+    createdAt: string;
+    sequence: number;
+    type: ChatStreamEventType;
+    data: ChatStreamEventData;
+}
+export type ChatStreamEventData = {
+    message: ChatMessage;
+} | {
+    text: string;
+} | {
+    workflowEvent: ChatWorkflowTimelineEvent;
+} | {
+    lifecycleStatus: string;
+    runtimeEvent?: ChatWorkflowTimelineEvent;
+} | {
+    reasons: string[];
+} | {
+    code: string;
+    message: string;
+} | {
+    thread: ChatThread;
+};
+export interface ChatSendResult {
+    message?: ChatMessage;
+    events: ChatStreamEvent[];
+}

package/dist/chat-api-types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=chat-api-types.js.map

package/dist/chat-api-types.js.map

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

package/dist/chat-compliance-service.d.ts

@@ -0,0 +1,60 @@
+import type { ChatStorage } from "./chat-storage.js";
+import type { ChatExportRecord } from "./types/chat.js";
+export type ChatComplianceSelection = {
+    kind: "thread";
+    tenantId: string;
+    workspaceId: string;
+    threadId: string;
+} | {
+    kind: "task";
+    tenantId: string;
+    workspaceId: string;
+    taskId: string;
+} | {
+    kind: "run";
+    tenantId: string;
+    workspaceId: string;
+    taskId: string;
+    runId: string;
+};
+export interface ChatComplianceActor {
+    actorId: string;
+    role: string;
+}
+export interface ChatComplianceExportResult {
+    selection: ChatComplianceSelection;
+    exportedAt: string;
+    records: ChatExportRecord[];
+    markdown: string;
+    auditEventId: string;
+}
+export interface ChatComplianceDeleteResult {
+    selection: ChatComplianceSelection;
+    deletedThreads: string[];
+    deletedMessages: string[];
+    auditEventId: string;
+}
+export interface ChatComplianceServiceOptions {
+    workspaceRoot: string;
+    storage?: ChatStorage;
+    now?: () => string;
+}
+export declare class ChatComplianceService {
+    private readonly workspaceRoot;
+    private readonly storage;
+    private readonly files;
+    private readonly now;
+    constructor(options: ChatComplianceServiceOptions);
+    exportEvidence(input: {
+        selection: ChatComplianceSelection;
+        actor: ChatComplianceActor;
+        includeTombstoned?: boolean;
+    }): Promise<ChatComplianceExportResult>;
+    deleteScope(input: {
+        selection: ChatComplianceSelection;
+        actor: ChatComplianceActor;
+        reasonCode: string;
+    }): Promise<ChatComplianceDeleteResult>;
+    private resolveSelection;
+}
+export declare function auditArtifactFileName(prefix: "export" | "delete"): string;

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[];