@jterrats/open-orchestra 1.0.16 → 1.0.18

package/dist/chat-api-message-persistence.js

@@ -0,0 +1,125 @@
+import { assertMatchingScope, ChatStorageError, CHAT_SCHEMA_VERSION, } from "./chat-storage.js";
+import { ChatApiError } from "./chat-api-errors.js";
+import { evaluateChatGuardrail } from "./security/chat-guardrails.js";
+import { actorId, exportPolicy, hashBody, idempotentMessageId, notFound, provenance, referencesFor, requestIdFor, requireText, retention, } from "./chat-api-records.js";
+export async function persistChatMessage(input) {
+    const requestId = requestIdFor(input.message.requestId);
+    const idempotencyKey = requireText(input.message.idempotencyKey, "idempotencyKey", requestId);
+    const thread = await input.storage.getThread(input.message.scope, input.message.threadId);
+    if (!thread)
+        throw notFound("thread_not_found", requestId);
+    assertMatchingScope(input.message.scope, thread.scope, "thread.scope");
+    const text = requireText(input.message.text, "text", requestId);
+    const bodyHash = hashBody(text);
+    const messageId = idempotentMessageId(input.message.scope, input.message.threadId, input.action, idempotencyKey);
+    const guardrail = evaluateChatGuardrail({
+        requestId,
+        tenantId: input.message.scope.tenantId,
+        workspaceId: input.message.scope.workspaceId,
+        taskId: input.message.scope.taskId,
+        runId: input.message.scope.runId,
+        threadId: input.message.threadId,
+        messageId,
+        actor: {
+            id: actorId(input.message.actor),
+            actorType: input.message.actor.kind === "human" ? "human" : "runtime",
+            tenantId: input.message.scope.tenantId,
+            workspaceId: input.message.scope.workspaceId,
+        },
+        action: input.action,
+        sink: { kind: "json" },
+        resource: {
+            resourceType: "message",
+            summary: "chat message",
+            tenantId: input.message.scope.tenantId,
+            workspaceId: input.message.scope.workspaceId,
+        },
+        segments: [
+            {
+                id: `${requestId}:message`,
+                kind: "instruction",
+                provenance: input.message.actor.kind,
+                text,
+                sink: "json",
+            },
+        ],
+    });
+    if (!guardrail.canProceed) {
+        throw new ChatApiError("policy_blocked", guardrail.sanitizedReasons[0] ?? "chat message blocked by policy", 403, requestId);
+    }
+    const existing = await findMessage(input.storage, input.message.scope, input.message.threadId, messageId);
+    if (existing) {
+        if (existing.provenance.sourceId !== bodyHash) {
+            throw new ChatApiError("idempotency_conflict", "idempotency key was already used with a different payload", 409, requestId);
+        }
+        return replay(existing, requestId, idempotencyKey, guardrail.requestId);
+    }
+    const message = await buildMessage(input, messageId, bodyHash, guardrail);
+    try {
+        return {
+            message: await input.storage.appendMessage(input.message.scope, message),
+            meta: {
+                requestId,
+                idempotencyKey,
+                policyDecisionId: guardrail.requestId,
+            },
+        };
+    }
+    catch (error) {
+        if (error instanceof ChatStorageError &&
+            error.code === "duplicate_record") {
+            const duplicate = await findMessage(input.storage, input.message.scope, input.message.threadId, messageId);
+            if (duplicate && duplicate.provenance.sourceId === bodyHash) {
+                return replay(duplicate, requestId, idempotencyKey, guardrail.requestId);
+            }
+        }
+        throw error;
+    }
+}
+async function buildMessage(input, messageId, bodyHash, guardrail) {
+    const allMessages = await input.storage.listMessages(input.message.scope, input.message.threadId);
+    const now = input.now();
+    return {
+        schemaVersion: CHAT_SCHEMA_VERSION,
+        id: messageId,
+        threadId: input.message.threadId,
+        scope: input.message.scope,
+        actor: input.message.actor,
+        provenance: provenance("user_input", bodyHash, now, guardrail.requestId),
+        createdAt: now,
+        sequence: allMessages.messages.length + 1,
+        content: {
+            format: input.message.format ?? "plain_text",
+            text: guardrail.redactedSegments[0]?.text ?? input.message.text,
+        },
+        contentState: "redacted",
+        retention: retention(now),
+        redaction: {
+            policyId: "chat-api-redaction",
+            status: "applied",
+            redactedAt: now,
+            redactedByActorId: "chat-api",
+            markerCount: Math.max(0, guardrail.redactedSegments.length),
+            summary: "Chat guardrail redaction applied before persistence.",
+        },
+        export: exportPolicy(now),
+        delete: { status: "active", policyId: "chat-delete-logical" },
+        references: referencesFor(input.message.scope),
+    };
+}
+async function findMessage(storage, scope, threadId, messageId) {
+    const messages = await storage.listMessages(scope, threadId);
+    return messages.messages.find((message) => message.id === messageId);
+}
+function replay(message, requestId, idempotencyKey, policyDecisionId) {
+    return {
+        message,
+        meta: {
+            requestId,
+            idempotencyKey,
+            idempotentReplay: true,
+            policyDecisionId,
+        },
+    };
+}
+//# sourceMappingURL=chat-api-message-persistence.js.map

package/dist/chat-api-message-persistence.js.map

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

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

@@ -0,0 +1,35 @@
+import { ChatApiError } from "./chat-api-errors.js";
+import type { ChatApiMeta } from "./chat-api-types.js";
+import type { ChatActor, ChatThread, ChatProvenance, ChatReference, ChatScope } from "./types/chat.js";
+export declare function requestIdFor(requestId: string | undefined): string;
+export declare function requireText(value: string | undefined, field: string, requestId: string): string;
+export declare function notFound(code: string, requestId: string): ChatApiError;
+export declare function hashBody(text: string): string;
+export declare function idempotentMessageId(scope: ChatScope, threadId: string, action: string, idempotencyKey: string): string;
+export declare function provenance(sourceKind: "user_input", sourceId: string, createdAt: string, policyDecisionId?: string): ChatProvenance;
+export declare function retention(decidedAt: string): {
+    policyId: string;
+    status: "redacted_only";
+    rawPersistence: "forbidden";
+    decidedAt: string;
+};
+export declare function exportPolicy(decidedAt: string): {
+    status: "redacted_only";
+    rawContentExportable: boolean;
+    policyId: string;
+    decidedAt: string;
+};
+export declare function referencesFor(scope: ChatScope): ChatReference[];
+export declare function actorId(actor: ChatActor): string;
+export declare function listOptions(limit?: number, cursor?: string): {
+    cursor?: string;
+    limit?: number;
+};
+export declare function apiMeta(requestId: string, options?: Omit<ChatApiMeta, "requestId">): ChatApiMeta;
+export declare function buildChatThread(input: {
+    scope: ChatScope;
+    title: string;
+    actor: ChatActor;
+    requestId: string;
+    now: string;
+}): ChatThread;

package/dist/chat-api-records.js

@@ -0,0 +1,94 @@
+import { createHash, randomUUID } from "node:crypto";
+import { ChatApiError } from "./chat-api-errors.js";
+import { CHAT_SCHEMA_VERSION } from "./chat-storage.js";
+export function requestIdFor(requestId) {
+    return requestId?.trim() || `chat-${randomUUID()}`;
+}
+export function requireText(value, field, requestId) {
+    if (!value?.trim()) {
+        throw new ChatApiError("invalid_request", `${field} is required`, 400, requestId);
+    }
+    return value.trim();
+}
+export function notFound(code, requestId) {
+    return new ChatApiError(code, "chat resource was not found", 404, requestId);
+}
+export function hashBody(text) {
+    return createHash("sha256").update(text).digest("base64url");
+}
+export function idempotentMessageId(scope, threadId, action, idempotencyKey) {
+    return `message-${createHash("sha256")
+        .update([
+        scope.tenantId,
+        scope.workspaceId,
+        scope.taskId,
+        scope.runId,
+        scope.phase,
+        scope.sessionId,
+        threadId,
+        action,
+        idempotencyKey,
+    ].join("\u001f"))
+        .digest("base64url")
+        .slice(0, 24)}`;
+}
+export function provenance(sourceKind, sourceId, createdAt, policyDecisionId) {
+    return {
+        sourceKind,
+        sourceId,
+        createdAt,
+        observedAt: createdAt,
+        ...(policyDecisionId ? { policyDecisionId } : {}),
+    };
+}
+export function retention(decidedAt) {
+    return {
+        policyId: "chat-api-retain-redacted",
+        status: "redacted_only",
+        rawPersistence: "forbidden",
+        decidedAt,
+    };
+}
+export function exportPolicy(decidedAt) {
+    return {
+        status: "redacted_only",
+        rawContentExportable: false,
+        policyId: "chat-api-export-redacted",
+        decidedAt,
+    };
+}
+export function referencesFor(scope) {
+    return [
+        { kind: "task", id: scope.taskId },
+        { kind: "workflow_run", id: scope.runId },
+    ];
+}
+export function actorId(actor) {
+    return actor.actorId;
+}
+export function listOptions(limit, cursor) {
+    return {
+        ...(limit !== undefined ? { limit } : {}),
+        ...(cursor !== undefined ? { cursor } : {}),
+    };
+}
+export function apiMeta(requestId, options = {}) {
+    return { requestId, ...options };
+}
+export function buildChatThread(input) {
+    return {
+        schemaVersion: CHAT_SCHEMA_VERSION,
+        id: `thread-${randomUUID()}`,
+        scope: input.scope,
+        title: requireText(input.title, "title", input.requestId),
+        createdAt: input.now,
+        updatedAt: input.now,
+        actor: input.actor,
+        provenance: provenance("user_input", input.requestId, input.now),
+        retention: retention(input.now),
+        export: exportPolicy(input.now),
+        delete: { status: "active", policyId: "chat-delete-logical" },
+        contentState: "redacted",
+    };
+}
+//# sourceMappingURL=chat-api-records.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"chat-api-records.js","sourceRoot":"","sources":["../src/chat-api-records.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACrD,OAAO,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AASpD,OAAO,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AAExD,MAAM,UAAU,YAAY,CAAC,SAA6B;IACxD,OAAO,SAAS,EAAE,IAAI,EAAE,IAAI,QAAQ,UAAU,EAAE,EAAE,CAAC;AACrD,CAAC;AAED,MAAM,UAAU,WAAW,CACzB,KAAyB,EACzB,KAAa,EACb,SAAiB;IAEjB,IAAI,CAAC,KAAK,EAAE,IAAI,EAAE,EAAE,CAAC;QACnB,MAAM,IAAI,YAAY,CACpB,iBAAiB,EACjB,GAAG,KAAK,cAAc,EACtB,GAAG,EACH,SAAS,CACV,CAAC;IACJ,CAAC;IACD,OAAO,KAAK,CAAC,IAAI,EAAE,CAAC;AACtB,CAAC;AAED,MAAM,UAAU,QAAQ,CAAC,IAAY,EAAE,SAAiB;IACtD,OAAO,IAAI,YAAY,CAAC,IAAI,EAAE,6BAA6B,EAAE,GAAG,EAAE,SAAS,CAAC,CAAC;AAC/E,CAAC;AAED,MAAM,UAAU,QAAQ,CAAC,IAAY;IACnC,OAAO,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC;AAC/D,CAAC;AAED,MAAM,UAAU,mBAAmB,CACjC,KAAgB,EAChB,QAAgB,EAChB,MAAc,EACd,cAAsB;IAEtB,OAAO,WAAW,UAAU,CAAC,QAAQ,CAAC;SACnC,MAAM,CACL;QACE,KAAK,CAAC,QAAQ;QACd,KAAK,CAAC,WAAW;QACjB,KAAK,CAAC,MAAM;QACZ,KAAK,CAAC,KAAK;QACX,KAAK,CAAC,KAAK;QACX,KAAK,CAAC,SAAS;QACf,QAAQ;QACR,MAAM;QACN,cAAc;KACf,CAAC,IAAI,CAAC,QAAQ,CAAC,CACjB;SACA,MAAM,CAAC,WAAW,CAAC;SACnB,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,EAAE,CAAC;AACpB,CAAC;AAED,MAAM,UAAU,UAAU,CACxB,UAAwB,EACxB,QAAgB,EAChB,SAAiB,EACjB,gBAAyB;IAEzB,OAAO;QACL,UAAU;QACV,QAAQ;QACR,SAAS;QACT,UAAU,EAAE,SAAS;QACrB,GAAG,CAAC,gBAAgB,CAAC,CAAC,CAAC,EAAE,gBAAgB,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KAClD,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,SAAS,CAAC,SAAiB;IACzC,OAAO;QACL,QAAQ,EAAE,0BAA0B;QACpC,MAAM,EAAE,eAAwB;QAChC,cAAc,EAAE,WAAoB;QACpC,SAAS;KACV,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,SAAiB;IAC5C,OAAO;QACL,MAAM,EAAE,eAAwB;QAChC,oBAAoB,EAAE,KAAK;QAC3B,QAAQ,EAAE,0BAA0B;QACpC,SAAS;KACV,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,KAAgB;IAC5C,OAAO;QACL,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,KAAK,CAAC,MAAM,EAAE;QAClC,EAAE,IAAI,EAAE,cAAc,EAAE,EAAE,EAAE,KAAK,CAAC,KAAK,EAAE;KAC1C,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,OAAO,CAAC,KAAgB;IACtC,OAAO,KAAK,CAAC,OAAO,CAAC;AACvB,CAAC;AAED,MAAM,UAAU,WAAW,CAAC,KAAc,EAAE,MAAe;IACzD,OAAO;QACL,GAAG,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACzC,GAAG,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KAC5C,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,OAAO,CACrB,SAAiB,EACjB,UAA0C,EAAE;IAE5C,OAAO,EAAE,SAAS,EAAE,GAAG,OAAO,EAAE,CAAC;AACnC,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,KAM/B;IACC,OAAO;QACL,aAAa,EAAE,mBAAmB;QAClC,EAAE,EAAE,UAAU,UAAU,EAAE,EAAE;QAC5B,KAAK,EAAE,KAAK,CAAC,KAAK;QAClB,KAAK,EAAE,WAAW,CAAC,KAAK,CAAC,KAAK,EAAE,OAAO,EAAE,KAAK,CAAC,SAAS,CAAC;QACzD,SAAS,EAAE,KAAK,CAAC,GAAG;QACpB,SAAS,EAAE,KAAK,CAAC,GAAG;QACpB,KAAK,EAAE,KAAK,CAAC,KAAK;QAClB,UAAU,EAAE,UAAU,CAAC,YAAY,EAAE,KAAK,CAAC,SAAS,EAAE,KAAK,CAAC,GAAG,CAAC;QAChE,SAAS,EAAE,SAAS,CAAC,KAAK,CAAC,GAAG,CAAC;QAC/B,MAAM,EAAE,YAAY,CAAC,KAAK,CAAC,GAAG,CAAC;QAC/B,MAAM,EAAE,EAAE,MAAM,EAAE,QAAQ,EAAE,QAAQ,EAAE,qBAAqB,EAAE;QAC7D,YAAY,EAAE,UAAU;KACzB,CAAC;AACJ,CAAC"}

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

@@ -0,0 +1,32 @@
+import type { ChatStorage } from "./chat-storage.js";
+export { ChatApiError } from "./chat-api-errors.js";
+import type { ChatStreamEvent, ChatApiSuccess, ChatMessageInput, ChatMessagesInput, ChatSendInput, ChatSendResult, ChatThreadInput, CreateChatThreadInput, ListChatInput } from "./chat-api-types.js";
+import type { ChatMessage, ChatThread } from "./types/chat.js";
+export interface ChatApiServiceOptions {
+    storage: ChatStorage;
+    root?: string;
+    now?: () => string;
+}
+export declare class ChatApiService {
+    private readonly storage;
+    private readonly root;
+    private readonly now;
+    constructor(options: ChatApiServiceOptions);
+    createThread(input: CreateChatThreadInput): Promise<ChatApiSuccess<ChatThread>>;
+    listThreads(input: ListChatInput): Promise<ChatApiSuccess<{
+        threads: ChatThread[];
+    }>>;
+    getThread(input: ChatThreadInput): Promise<ChatApiSuccess<{
+        thread: ChatThread;
+    }>>;
+    listMessages(input: ChatMessagesInput): Promise<ChatApiSuccess<{
+        messages: ChatMessage[];
+    }>>;
+    createMessage(input: ChatMessageInput): Promise<ChatApiSuccess<ChatMessage>>;
+    send(input: ChatSendInput): Promise<ChatApiSuccess<ChatSendResult>>;
+    stream(input: ChatMessagesInput): Promise<ChatApiSuccess<{
+        events: ChatStreamEvent[];
+    }>>;
+    private persistMessage;
+    private listAllStoredMessages;
+}

package/dist/chat-api-service.js

@@ -0,0 +1,120 @@
+export { ChatApiError } from "./chat-api-errors.js";
+import { eventsForStoredMessage } from "./chat-event-stream.js";
+import { listWorkflowTimelineMessages, mergeTimelineMessages, } from "./chat-workflow-timeline.js";
+import { apiMeta, buildChatThread, listOptions, notFound, requestIdFor, } from "./chat-api-records.js";
+import { safeCursorList } from "./chat-api-storage.js";
+import { persistChatMessage } from "./chat-api-message-persistence.js";
+export class ChatApiService {
+    storage;
+    root;
+    now;
+    constructor(options) {
+        this.storage = options.storage;
+        this.root = options.root ?? process.cwd();
+        this.now = options.now ?? (() => new Date().toISOString());
+    }
+    async createThread(input) {
+        const requestId = requestIdFor(input.requestId);
+        const now = this.now();
+        const thread = buildChatThread({
+            scope: input.scope,
+            title: input.title,
+            actor: input.actor,
+            requestId,
+            now,
+        });
+        return {
+            data: await this.storage.createThread(input.scope, thread),
+            meta: { requestId },
+        };
+    }
+    async listThreads(input) {
+        const requestId = requestIdFor(input.requestId);
+        const result = await safeCursorList(() => this.storage.listThreads(input.scope, {
+            ...listOptions(input.limit, input.cursor),
+        }), requestId);
+        return {
+            data: { threads: result.threads },
+            meta: apiMeta(requestId, {
+                ...(result.nextCursor ? { nextCursor: result.nextCursor } : {}),
+            }),
+        };
+    }
+    async getThread(input) {
+        const requestId = requestIdFor(input.requestId);
+        const thread = await this.storage.getThread(input.scope, input.threadId);
+        if (!thread)
+            throw notFound("thread_not_found", requestId);
+        return { data: { thread }, meta: { requestId } };
+    }
+    async listMessages(input) {
+        const requestId = requestIdFor(input.requestId);
+        const result = await safeCursorList(async () => {
+            const storedMessages = await this.listAllStoredMessages(input.scope, input.threadId);
+            const workflowMessages = await listWorkflowTimelineMessages({
+                root: this.root,
+                scope: input.scope,
+                threadId: input.threadId,
+            });
+            return mergeTimelineMessages({
+                storedMessages,
+                workflowMessages,
+                scope: input.scope,
+                threadId: input.threadId,
+                ...listOptions(input.limit, input.cursor),
+            });
+        }, requestId);
+        return {
+            data: { messages: result.messages },
+            meta: apiMeta(requestId, {
+                ...(result.nextCursor ? { nextCursor: result.nextCursor } : {}),
+            }),
+        };
+    }
+    async createMessage(input) {
+        const result = await this.persistMessage(input, "messagePersist");
+        return {
+            data: result.message,
+            meta: result.meta,
+        };
+    }
+    async send(input) {
+        const persisted = await this.persistMessage(input, "providerMessage");
+        return {
+            data: {
+                message: persisted.message,
+                events: eventsForStoredMessage(persisted.message),
+            },
+            meta: persisted.meta,
+        };
+    }
+    async stream(input) {
+        const messages = await this.listMessages(input);
+        return {
+            data: { events: messages.data.messages.flatMap(eventsForStoredMessage) },
+            meta: messages.meta,
+        };
+    }
+    async persistMessage(input, action) {
+        return persistChatMessage({
+            storage: this.storage,
+            now: this.now,
+            message: input,
+            action,
+        });
+    }
+    async listAllStoredMessages(scope, threadId) {
+        const messages = [];
+        let cursor;
+        do {
+            const page = await this.storage.listMessages(scope, threadId, {
+                ...(cursor ? { cursor } : {}),
+                limit: 100,
+            });
+            messages.push(...page.messages);
+            cursor = page.nextCursor;
+        } while (cursor);
+        return messages;
+    }
+}
+//# sourceMappingURL=chat-api-service.js.map

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

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

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

@@ -0,0 +1 @@
+export declare function safeCursorList<T>(operation: () => Promise<T>, requestId: string): Promise<T>;

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;