@jterrats/open-orchestra 1.0.17 → 1.0.18

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":"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"}

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

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

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

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

@@ -0,0 +1,20 @@
+export type ChatStorageErrorCode = "invalid_scope" | "invalid_actor" | "invalid_provenance" | "invalid_content_policy" | "scope_mismatch" | "duplicate_record" | "not_found" | "storage_path_rejected" | "storage_corrupted" | "unsupported_schema_version";
+export interface ChatValidationIssue {
+    code: ChatStorageErrorCode;
+    field: string;
+    message: string;
+}
+export type ChatValidationResult<T> = {
+    ok: true;
+    value: T;
+} | {
+    ok: false;
+    issues: ChatValidationIssue[];
+};
+export declare class ChatStorageError extends Error {
+    readonly code: ChatStorageErrorCode;
+    readonly field: string;
+    constructor(issue: ChatValidationIssue);
+}
+export declare function safeStorageIssue(code: ChatStorageErrorCode, field: string, message: string): ChatValidationIssue;
+export declare function genericInvalidIssue(): ChatValidationIssue;

package/dist/chat-storage-errors.js

@@ -0,0 +1,17 @@
+export class ChatStorageError extends Error {
+    code;
+    field;
+    constructor(issue) {
+        super(issue.message);
+        this.name = "ChatStorageError";
+        this.code = issue.code;
+        this.field = issue.field;
+    }
+}
+export function safeStorageIssue(code, field, message) {
+    return { code, field, message };
+}
+export function genericInvalidIssue() {
+    return safeStorageIssue("invalid_scope", "chat", "Chat record is invalid.");
+}
+//# sourceMappingURL=chat-storage-errors.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"chat-storage-errors.js","sourceRoot":"","sources":["../src/chat-storage-errors.ts"],"names":[],"mappings":"AAsBA,MAAM,OAAO,gBAAiB,SAAQ,KAAK;IAChC,IAAI,CAAuB;IAC3B,KAAK,CAAS;IAEvB,YAAY,KAA0B;QACpC,KAAK,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;QACrB,IAAI,CAAC,IAAI,GAAG,kBAAkB,CAAC;QAC/B,IAAI,CAAC,IAAI,GAAG,KAAK,CAAC,IAAI,CAAC;QACvB,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC;IAC3B,CAAC;CACF;AAED,MAAM,UAAU,gBAAgB,CAC9B,IAA0B,EAC1B,KAAa,EACb,OAAe;IAEf,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC;AAClC,CAAC;AAED,MAAM,UAAU,mBAAmB;IACjC,OAAO,gBAAgB,CAAC,eAAe,EAAE,MAAM,EAAE,yBAAyB,CAAC,CAAC;AAC9E,CAAC"}

package/dist/chat-storage-local-files.d.ts

@@ -0,0 +1,17 @@
+import type { ChatMessage, ChatScope, ChatThread } from "./types/chat.js";
+export declare class LocalChatStorageFiles {
+    private readonly workspaceRoot;
+    constructor(workspaceRoot: string);
+    ensureScope(scope: ChatScope): Promise<void>;
+    readManifest(scope: ChatScope): Promise<void>;
+    projectThreads(scope: ChatScope): Promise<ChatThread[]>;
+    projectMessages(scope: ChatScope): Promise<ChatMessage[]>;
+    findMessage(scope: ChatScope, messageId: string): Promise<ChatMessage>;
+    appendThread(scope: ChatScope, thread: ChatThread): Promise<void>;
+    appendMessage(scope: ChatScope, message: ChatMessage): Promise<void>;
+    private readThreads;
+    private readMessages;
+    private appendJsonl;
+    private writeManifestIfMissing;
+    private scopePath;
+}

package/dist/chat-storage-local-files.js

@@ -0,0 +1,78 @@
+import { readFile, writeFile } from "node:fs/promises";
+import { appendJsonLine, exists } from "./fs-utils.js";
+import { assertValidChatMessage, assertValidChatThread, CHAT_SCHEMA_VERSION, ChatStorageError, safeStorageIssue, } from "./chat-storage.js";
+import { assertSafeExistingPath, ensureSafeScopeDirectory, scopePath, } from "./chat-storage-local-paths.js";
+import { isExactScope, latestById, notFound, readChatMessages, readChatThreads, } from "./chat-storage-local-records.js";
+const THREADS_FILE = "threads.jsonl";
+const MESSAGES_FILE = "messages.jsonl";
+const MANIFEST_FILE = "manifest.json";
+export class LocalChatStorageFiles {
+    workspaceRoot;
+    constructor(workspaceRoot) {
+        this.workspaceRoot = workspaceRoot;
+    }
+    async ensureScope(scope) {
+        await ensureSafeScopeDirectory(this.workspaceRoot, scope);
+        await this.writeManifestIfMissing(scope);
+    }
+    async readManifest(scope) {
+        const manifestPath = await this.scopePath(scope, MANIFEST_FILE);
+        if (!(await exists(manifestPath)))
+            return;
+        try {
+            const content = await readFile(manifestPath, "utf8");
+            const parsed = JSON.parse(content);
+            if (parsed.schemaVersion !== CHAT_SCHEMA_VERSION) {
+                throw new ChatStorageError(safeStorageIssue("unsupported_schema_version", "manifest.schemaVersion", "Chat storage schema version is not supported."));
+            }
+        }
+        catch (error) {
+            if (error instanceof ChatStorageError)
+                throw error;
+            throw new ChatStorageError(safeStorageIssue("storage_corrupted", "manifest", "Chat storage manifest is not readable."));
+        }
+    }
+    async projectThreads(scope) {
+        return latestById(await this.readThreads(scope));
+    }
+    async projectMessages(scope) {
+        return latestById(await this.readMessages(scope)).sort((left, right) => left.sequence - right.sequence);
+    }
+    async findMessage(scope, messageId) {
+        const message = (await this.projectMessages(scope)).find((entry) => entry.id === messageId && isExactScope(scope, entry.scope)) ?? null;
+        if (!message) {
+            throw notFound("message.id", "Chat message was not found.");
+        }
+        return message;
+    }
+    async appendThread(scope, thread) {
+        assertValidChatThread(thread);
+        await this.appendJsonl(scope, THREADS_FILE, thread);
+    }
+    async appendMessage(scope, message) {
+        assertValidChatMessage(message);
+        await this.appendJsonl(scope, MESSAGES_FILE, message);
+    }
+    async readThreads(scope) {
+        return readChatThreads(this.workspaceRoot, await this.scopePath(scope, THREADS_FILE));
+    }
+    async readMessages(scope) {
+        return readChatMessages(this.workspaceRoot, await this.scopePath(scope, MESSAGES_FILE));
+    }
+    async appendJsonl(scope, fileName, value) {
+        const filePath = await this.scopePath(scope, fileName);
+        await assertSafeExistingPath(this.workspaceRoot, filePath);
+        await appendJsonLine(filePath, value);
+    }
+    async writeManifestIfMissing(scope) {
+        const manifestPath = await this.scopePath(scope, MANIFEST_FILE);
+        if (await exists(manifestPath))
+            return;
+        await assertSafeExistingPath(this.workspaceRoot, manifestPath);
+        await writeFile(manifestPath, `${JSON.stringify({ schemaVersion: CHAT_SCHEMA_VERSION }, null, 2)}\n`, "utf8");
+    }
+    async scopePath(scope, fileName) {
+        return scopePath(this.workspaceRoot, scope, fileName);
+    }
+}
+//# sourceMappingURL=chat-storage-local-files.js.map

package/dist/chat-storage-local-files.js.map

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

package/dist/chat-storage-local-paths.d.ts

@@ -0,0 +1,6 @@
+import type { ChatScope } from "./types/chat.js";
+export declare const CHAT_STORAGE_RELATIVE_ROOT = ".agent-workflow/chat/v1";
+export declare function ensureSafeScopeDirectory(workspaceRoot: string, scope: ChatScope): Promise<string>;
+export declare function scopePath(workspaceRoot: string, scope: ChatScope, fileName: string): Promise<string>;
+export declare function encodeStorageIdentifier(value: string, field: string): string;
+export declare function assertSafeExistingPath(workspaceRoot: string, targetPath: string): Promise<void>;

package/dist/chat-storage-local-paths.js

@@ -0,0 +1,124 @@
+import { constants as fsConstants } from "node:fs";
+import { access, lstat, mkdir, realpath } from "node:fs/promises";
+import path from "node:path";
+import { ChatStorageError, safeStorageIssue } from "./chat-storage.js";
+export const CHAT_STORAGE_RELATIVE_ROOT = ".agent-workflow/chat/v1";
+export async function ensureSafeScopeDirectory(workspaceRoot, scope) {
+    const directory = scopeDirectory(workspaceRoot, scope);
+    await ensureSafeDirectory(workspaceRoot, directory);
+    return directory;
+}
+export async function scopePath(workspaceRoot, scope, fileName) {
+    return path.join(scopeDirectory(workspaceRoot, scope), fileName);
+}
+export function encodeStorageIdentifier(value, field) {
+    if (!isSafeIdentifier(value)) {
+        throw new ChatStorageError(safeStorageIssue("storage_path_rejected", field, "Chat storage identifier is not safe for local persistence."));
+    }
+    return `b64_${Buffer.from(value, "utf8").toString("base64url")}`;
+}
+export async function assertSafeExistingPath(workspaceRoot, targetPath) {
+    const realWorkspaceRoot = await realpath(workspaceRoot);
+    const resolvedPath = path.resolve(targetPath);
+    assertInsideChatRoot(workspaceRoot, resolvedPath);
+    let current = resolvedPath;
+    while (!(await pathExists(current))) {
+        current = path.dirname(current);
+    }
+    const currentStat = await lstat(current);
+    if (currentStat.isSymbolicLink())
+        throw pathRejected();
+    assertInsideChatRoot(realWorkspaceRoot, await realpath(current));
+}
+function scopeDirectory(workspaceRoot, scope) {
+    const tenantSegment = encodeStorageIdentifier(scope.tenantId, "scope.tenantId");
+    const workspaceSegment = encodeStorageIdentifier(scope.workspaceId, "scope.workspaceId");
+    const directory = path.resolve(workspaceRoot, CHAT_STORAGE_RELATIVE_ROOT, "tenants", tenantSegment, "workspaces", workspaceSegment);
+    assertInsideChatRoot(workspaceRoot, directory);
+    return directory;
+}
+async function ensureSafeDirectory(workspaceRoot, targetDirectory) {
+    assertInsideChatRoot(workspaceRoot, targetDirectory);
+    await ensureSafeWorkspaceSubtree(workspaceRoot, CHAT_STORAGE_RELATIVE_ROOT);
+    const relativeToChatRoot = path.relative(chatStorageRoot(workspaceRoot), targetDirectory);
+    await ensureSafeWorkspaceSubtree(workspaceRoot, path.join(CHAT_STORAGE_RELATIVE_ROOT, relativeToChatRoot));
+    await assertSafeExistingPath(workspaceRoot, targetDirectory);
+}
+async function ensureSafeWorkspaceSubtree(workspaceRoot, relativePath) {
+    const segments = relativePath.split(path.sep).filter(Boolean);
+    let current = path.resolve(workspaceRoot);
+    for (const segment of segments) {
+        if (!isSafePathSegment(segment))
+            throw pathRejected();
+        await assertPathInsideWorkspace(workspaceRoot, current);
+        const next = path.join(current, segment);
+        if (await pathExists(next)) {
+            await rejectSymlink(next);
+        }
+        else {
+            await mkdir(next);
+        }
+        await assertPathInsideWorkspace(workspaceRoot, next);
+        current = next;
+    }
+}
+async function assertPathInsideWorkspace(workspaceRoot, targetPath) {
+    await rejectSymlink(targetPath);
+    const realWorkspaceRoot = await realpath(workspaceRoot);
+    const realTarget = await realpath(targetPath);
+    const relative = path.relative(realWorkspaceRoot, realTarget);
+    if (relative.startsWith("..") || path.isAbsolute(relative)) {
+        throw pathRejected();
+    }
+}
+async function rejectSymlink(targetPath) {
+    const stats = await lstat(targetPath);
+    if (stats.isSymbolicLink())
+        throw pathRejected();
+}
+function assertInsideChatRoot(workspaceRoot, targetPath) {
+    const relative = path.relative(chatStorageRoot(workspaceRoot), path.resolve(targetPath));
+    if (relative.startsWith("..") || path.isAbsolute(relative)) {
+        throw pathRejected();
+    }
+}
+function chatStorageRoot(workspaceRoot) {
+    return path.resolve(workspaceRoot, CHAT_STORAGE_RELATIVE_ROOT);
+}
+function isSafeIdentifier(value) {
+    const trimmed = value.trim();
+    return (trimmed.length > 0 &&
+        trimmed === value &&
+        !path.isAbsolute(value) &&
+        !value.includes("/") &&
+        !value.includes("\\") &&
+        !value.split(/[\\/]/u).includes("..") &&
+        !hasControlCharacter(value));
+}
+function isSafePathSegment(value) {
+    return (value.length > 0 &&
+        value !== "." &&
+        value !== ".." &&
+        !value.includes("/") &&
+        !value.includes("\\") &&
+        !hasControlCharacter(value));
+}
+function hasControlCharacter(value) {
+    return [...value].some((char) => {
+        const code = char.charCodeAt(0);
+        return code <= 0x1f || code === 0x7f;
+    });
+}
+async function pathExists(filePath) {
+    try {
+        await access(filePath, fsConstants.F_OK);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+function pathRejected() {
+    return new ChatStorageError(safeStorageIssue("storage_path_rejected", "storage.path", "Chat storage path must stay inside the workspace chat directory."));
+}
+//# sourceMappingURL=chat-storage-local-paths.js.map

package/dist/chat-storage-local-paths.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"chat-storage-local-paths.js","sourceRoot":"","sources":["../src/chat-storage-local-paths.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,IAAI,WAAW,EAAE,MAAM,SAAS,CAAC;AACnD,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAClE,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAGvE,MAAM,CAAC,MAAM,0BAA0B,GAAG,yBAAyB,CAAC;AAEpE,MAAM,CAAC,KAAK,UAAU,wBAAwB,CAC5C,aAAqB,EACrB,KAAgB;IAEhB,MAAM,SAAS,GAAG,cAAc,CAAC,aAAa,EAAE,KAAK,CAAC,CAAC;IACvD,MAAM,mBAAmB,CAAC,aAAa,EAAE,SAAS,CAAC,CAAC;IACpD,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,SAAS,CAC7B,aAAqB,EACrB,KAAgB,EAChB,QAAgB;IAEhB,OAAO,IAAI,CAAC,IAAI,CAAC,cAAc,CAAC,aAAa,EAAE,KAAK,CAAC,EAAE,QAAQ,CAAC,CAAC;AACnE,CAAC;AAED,MAAM,UAAU,uBAAuB,CAAC,KAAa,EAAE,KAAa;IAClE,IAAI,CAAC,gBAAgB,CAAC,KAAK,CAAC,EAAE,CAAC;QAC7B,MAAM,IAAI,gBAAgB,CACxB,gBAAgB,CACd,uBAAuB,EACvB,KAAK,EACL,4DAA4D,CAC7D,CACF,CAAC;IACJ,CAAC;IACD,OAAO,OAAO,MAAM,CAAC,IAAI,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC,QAAQ,CAAC,WAAW,CAAC,EAAE,CAAC;AACnE,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,sBAAsB,CAC1C,aAAqB,EACrB,UAAkB;IAElB,MAAM,iBAAiB,GAAG,MAAM,QAAQ,CAAC,aAAa,CAAC,CAAC;IACxD,MAAM,YAAY,GAAG,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;IAC9C,oBAAoB,CAAC,aAAa,EAAE,YAAY,CAAC,CAAC;IAClD,IAAI,OAAO,GAAG,YAAY,CAAC;IAC3B,OAAO,CAAC,CAAC,MAAM,UAAU,CAAC,OAAO,CAAC,CAAC,EAAE,CAAC;QACpC,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;IAClC,CAAC;IACD,MAAM,WAAW,GAAG,MAAM,KAAK,CAAC,OAAO,CAAC,CAAC;IACzC,IAAI,WAAW,CAAC,cAAc,EAAE;QAAE,MAAM,YAAY,EAAE,CAAC;IACvD,oBAAoB,CAAC,iBAAiB,EAAE,MAAM,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC;AACnE,CAAC;AAED,SAAS,cAAc,CAAC,aAAqB,EAAE,KAAgB;IAC7D,MAAM,aAAa,GAAG,uBAAuB,CAC3C,KAAK,CAAC,QAAQ,EACd,gBAAgB,CACjB,CAAC;IACF,MAAM,gBAAgB,GAAG,uBAAuB,CAC9C,KAAK,CAAC,WAAW,EACjB,mBAAmB,CACpB,CAAC;IACF,MAAM,SAAS,GAAG,IAAI,CAAC,OAAO,CAC5B,aAAa,EACb,0BAA0B,EAC1B,SAAS,EACT,aAAa,EACb,YAAY,EACZ,gBAAgB,CACjB,CAAC;IACF,oBAAoB,CAAC,aAAa,EAAE,SAAS,CAAC,CAAC;IAC/C,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,KAAK,UAAU,mBAAmB,CAChC,aAAqB,EACrB,eAAuB;IAEvB,oBAAoB,CAAC,aAAa,EAAE,eAAe,CAAC,CAAC;IACrD,MAAM,0BAA0B,CAAC,aAAa,EAAE,0BAA0B,CAAC,CAAC;IAC5E,MAAM,kBAAkB,GAAG,IAAI,CAAC,QAAQ,CACtC,eAAe,CAAC,aAAa,CAAC,EAC9B,eAAe,CAChB,CAAC;IACF,MAAM,0BAA0B,CAC9B,aAAa,EACb,IAAI,CAAC,IAAI,CAAC,0BAA0B,EAAE,kBAAkB,CAAC,CAC1D,CAAC;IACF,MAAM,sBAAsB,CAAC,aAAa,EAAE,eAAe,CAAC,CAAC;AAC/D,CAAC;AAED,KAAK,UAAU,0BAA0B,CACvC,aAAqB,EACrB,YAAoB;IAEpB,MAAM,QAAQ,GAAG,YAAY,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;IAC9D,IAAI,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC,aAAa,CAAC,CAAC;IAC1C,KAAK,MAAM,OAAO,IAAI,QAAQ,EAAE,CAAC;QAC/B,IAAI,CAAC,iBAAiB,CAAC,OAAO,CAAC;YAAE,MAAM,YAAY,EAAE,CAAC;QACtD,MAAM,yBAAyB,CAAC,aAAa,EAAE,OAAO,CAAC,CAAC;QACxD,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;QACzC,IAAI,MAAM,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;YAC3B,MAAM,aAAa,CAAC,IAAI,CAAC,CAAC;QAC5B,CAAC;aAAM,CAAC;YACN,MAAM,KAAK,CAAC,IAAI,CAAC,CAAC;QACpB,CAAC;QACD,MAAM,yBAAyB,CAAC,aAAa,EAAE,IAAI,CAAC,CAAC;QACrD,OAAO,GAAG,IAAI,CAAC;IACjB,CAAC;AACH,CAAC;AAED,KAAK,UAAU,yBAAyB,CACtC,aAAqB,EACrB,UAAkB;IAElB,MAAM,aAAa,CAAC,UAAU,CAAC,CAAC;IAChC,MAAM,iBAAiB,GAAG,MAAM,QAAQ,CAAC,aAAa,CAAC,CAAC;IACxD,MAAM,UAAU,GAAG,MAAM,QAAQ,CAAC,UAAU,CAAC,CAAC;IAC9C,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC,iBAAiB,EAAE,UAAU,CAAC,CAAC;IAC9D,IAAI,QAAQ,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;QAC3D,MAAM,YAAY,EAAE,CAAC;IACvB,CAAC;AACH,CAAC;AAED,KAAK,UAAU,aAAa,CAAC,UAAkB;IAC7C,MAAM,KAAK,GAAG,MAAM,KAAK,CAAC,UAAU,CAAC,CAAC;IACtC,IAAI,KAAK,CAAC,cAAc,EAAE;QAAE,MAAM,YAAY,EAAE,CAAC;AACnD,CAAC;AAED,SAAS,oBAAoB,CAAC,aAAqB,EAAE,UAAkB;IACrE,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAC5B,eAAe,CAAC,aAAa,CAAC,EAC9B,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,CACzB,CAAC;IACF,IAAI,QAAQ,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;QAC3D,MAAM,YAAY,EAAE,CAAC;IACvB,CAAC;AACH,CAAC;AAED,SAAS,eAAe,CAAC,aAAqB;IAC5C,OAAO,IAAI,CAAC,OAAO,CAAC,aAAa,EAAE,0BAA0B,CAAC,CAAC;AACjE,CAAC;AAED,SAAS,gBAAgB,CAAC,KAAa;IACrC,MAAM,OAAO,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC;IAC7B,OAAO,CACL,OAAO,CAAC,MAAM,GAAG,CAAC;QAClB,OAAO,KAAK,KAAK;QACjB,CAAC,IAAI,CAAC,UAAU,CAAC,KAAK,CAAC;QACvB,CAAC,KAAK,CAAC,QAAQ,CAAC,GAAG,CAAC;QACpB,CAAC,KAAK,CAAC,QAAQ,CAAC,IAAI,CAAC;QACrB,CAAC,KAAK,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC;QACrC,CAAC,mBAAmB,CAAC,KAAK,CAAC,CAC5B,CAAC;AACJ,CAAC;AAED,SAAS,iBAAiB,CAAC,KAAa;IACtC,OAAO,CACL,KAAK,CAAC,MAAM,GAAG,CAAC;QAChB,KAAK,KAAK,GAAG;QACb,KAAK,KAAK,IAAI;QACd,CAAC,KAAK,CAAC,QAAQ,CAAC,GAAG,CAAC;QACpB,CAAC,KAAK,CAAC,QAAQ,CAAC,IAAI,CAAC;QACrB,CAAC,mBAAmB,CAAC,KAAK,CAAC,CAC5B,CAAC;AACJ,CAAC;AAED,SAAS,mBAAmB,CAAC,KAAa;IACxC,OAAO,CAAC,GAAG,KAAK,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE;QAC9B,MAAM,IAAI,GAAG,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC;QAChC,OAAO,IAAI,IAAI,IAAI,IAAI,IAAI,KAAK,IAAI,CAAC;IACvC,CAAC,CAAC,CAAC;AACL,CAAC;AAED,KAAK,UAAU,UAAU,CAAC,QAAgB;IACxC,IAAI,CAAC;QACH,MAAM,MAAM,CAAC,QAAQ,EAAE,WAAW,CAAC,IAAI,CAAC,CAAC;QACzC,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC;AAED,SAAS,YAAY;IACnB,OAAO,IAAI,gBAAgB,CACzB,gBAAgB,CACd,uBAAuB,EACvB,cAAc,EACd,kEAAkE,CACnE,CACF,CAAC;AACJ,CAAC"}

package/dist/chat-storage-local-projection.d.ts

@@ -0,0 +1,10 @@
+import type { ChatDeleteMetadata, ChatExportOptions, ChatExportRecord, ChatMessage, ChatRedactionMetadata, ChatScope, ChatThread } from "./types/chat.js";
+export declare function redactedMessage(message: ChatMessage, redaction: ChatRedactionMetadata): ChatMessage;
+export declare function tombstonedThread(thread: ChatThread, deletion: ChatDeleteMetadata): ChatThread;
+export declare function tombstonedMessage(message: ChatMessage, deletion: ChatDeleteMetadata): ChatMessage;
+export declare function threadExportRecord({ scope, thread, messages, options, }: {
+    scope: ChatScope;
+    thread: ChatThread;
+    messages: ChatMessage[];
+    options: ChatExportOptions;
+}): ChatExportRecord;

package/dist/chat-storage-local-projection.js

@@ -0,0 +1,55 @@
+import { CHAT_SCHEMA_VERSION } from "./chat-storage.js";
+export function redactedMessage(message, redaction) {
+    return {
+        ...message,
+        content: { ...message.content, text: "" },
+        contentState: "redacted",
+        redaction,
+        export: {
+            ...message.export,
+            status: "redacted_only",
+            rawContentExportable: false,
+        },
+        retention: {
+            ...message.retention,
+            status: "redacted_only",
+            rawPersistence: "forbidden",
+        },
+    };
+}
+export function tombstonedThread(thread, deletion) {
+    return {
+        ...thread,
+        contentState: "tombstoned",
+        delete: deletion,
+        export: {
+            ...thread.export,
+            status: "not_exportable",
+            rawContentExportable: false,
+        },
+    };
+}
+export function tombstonedMessage(message, deletion) {
+    return {
+        ...message,
+        content: { ...message.content, text: "" },
+        contentState: "tombstoned",
+        delete: deletion,
+        export: {
+            ...message.export,
+            status: "not_exportable",
+            rawContentExportable: false,
+        },
+    };
+}
+export function threadExportRecord({ scope, thread, messages, options, }) {
+    return {
+        schemaVersion: CHAT_SCHEMA_VERSION,
+        scope,
+        thread,
+        messages,
+        exportedAt: new Date().toISOString(),
+        content: options.content,
+    };
+}
+//# sourceMappingURL=chat-storage-local-projection.js.map

package/dist/chat-storage-local-projection.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"chat-storage-local-projection.js","sourceRoot":"","sources":["../src/chat-storage-local-projection.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AAWxD,MAAM,UAAU,eAAe,CAC7B,OAAoB,EACpB,SAAgC;IAEhC,OAAO;QACL,GAAG,OAAO;QACV,OAAO,EAAE,EAAE,GAAG,OAAO,CAAC,OAAO,EAAE,IAAI,EAAE,EAAE,EAAE;QACzC,YAAY,EAAE,UAAU;QACxB,SAAS;QACT,MAAM,EAAE;YACN,GAAG,OAAO,CAAC,MAAM;YACjB,MAAM,EAAE,eAAe;YACvB,oBAAoB,EAAE,KAAK;SAC5B;QACD,SAAS,EAAE;YACT,GAAG,OAAO,CAAC,SAAS;YACpB,MAAM,EAAE,eAAe;YACvB,cAAc,EAAE,WAAW;SAC5B;KACF,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,gBAAgB,CAC9B,MAAkB,EAClB,QAA4B;IAE5B,OAAO;QACL,GAAG,MAAM;QACT,YAAY,EAAE,YAAY;QAC1B,MAAM,EAAE,QAAQ;QAChB,MAAM,EAAE;YACN,GAAG,MAAM,CAAC,MAAM;YAChB,MAAM,EAAE,gBAAgB;YACxB,oBAAoB,EAAE,KAAK;SAC5B;KACF,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,iBAAiB,CAC/B,OAAoB,EACpB,QAA4B;IAE5B,OAAO;QACL,GAAG,OAAO;QACV,OAAO,EAAE,EAAE,GAAG,OAAO,CAAC,OAAO,EAAE,IAAI,EAAE,EAAE,EAAE;QACzC,YAAY,EAAE,YAAY;QAC1B,MAAM,EAAE,QAAQ;QAChB,MAAM,EAAE;YACN,GAAG,OAAO,CAAC,MAAM;YACjB,MAAM,EAAE,gBAAgB;YACxB,oBAAoB,EAAE,KAAK;SAC5B;KACF,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,kBAAkB,CAAC,EACjC,KAAK,EACL,MAAM,EACN,QAAQ,EACR,OAAO,GAMR;IACC,OAAO;QACL,aAAa,EAAE,mBAAmB;QAClC,KAAK;QACL,MAAM;QACN,QAAQ;QACR,UAAU,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;QACpC,OAAO,EAAE,OAAO,CAAC,OAAO;KACzB,CAAC;AACJ,CAAC"}

package/dist/chat-storage-local-records.d.ts

@@ -0,0 +1,13 @@
+import { ChatStorageError } from "./chat-storage.js";
+import type { ChatListOptions, ChatMessage, ChatScope, ChatThread } from "./types/chat.js";
+export declare function readChatThreads(workspaceRoot: string, filePath: string): Promise<ChatThread[]>;
+export declare function readChatMessages(workspaceRoot: string, filePath: string): Promise<ChatMessage[]>;
+export declare function isExactScope(expected: ChatScope, actual: ChatScope): boolean;
+export declare function latestById<T extends {
+    id: string;
+}>(records: T[]): T[];
+export declare function applyLimit<T>(items: T[], options: ChatListOptions, scope: ChatScope, threadId?: string): {
+    items: T[];
+    nextCursor?: string;
+};
+export declare function notFound(field: string, message: string): ChatStorageError;

package/dist/chat-storage-local-records.js

@@ -0,0 +1,56 @@
+import { readFile } from "node:fs/promises";
+import { assertValidChatMessage, assertValidChatThread, ChatStorageError, safeStorageIssue, } from "./chat-storage.js";
+import { assertSafeExistingPath } from "./chat-storage-local-paths.js";
+import { paginateChatRecords } from "./chat-pagination.js";
+import { exists } from "./fs-utils.js";
+export async function readChatThreads(workspaceRoot, filePath) {
+    const threads = (await readJsonLines(workspaceRoot, filePath, "threads")).map((record) => record);
+    for (const thread of threads)
+        assertValidChatThread(thread);
+    return threads;
+}
+export async function readChatMessages(workspaceRoot, filePath) {
+    const messages = (await readJsonLines(workspaceRoot, filePath, "messages")).map((record) => record);
+    for (const message of messages)
+        assertValidChatMessage(message);
+    return messages;
+}
+export function isExactScope(expected, actual) {
+    return (expected.tenantId === actual.tenantId &&
+        expected.workspaceId === actual.workspaceId &&
+        expected.taskId === actual.taskId &&
+        expected.runId === actual.runId &&
+        expected.phase === actual.phase &&
+        expected.sessionId === actual.sessionId);
+}
+export function latestById(records) {
+    return [
+        ...records
+            .reduce((latest, record) => latest.set(record.id, record), new Map())
+            .values(),
+    ];
+}
+export function applyLimit(items, options, scope, threadId) {
+    return paginateChatRecords(items, options, scope, threadId);
+}
+export function notFound(field, message) {
+    return new ChatStorageError(safeStorageIssue("not_found", field, message));
+}
+async function readJsonLines(workspaceRoot, filePath, field) {
+    if (!(await exists(filePath)))
+        return [];
+    await assertSafeExistingPath(workspaceRoot, filePath);
+    try {
+        const content = await readFile(filePath, "utf8");
+        if (!content.trim())
+            return [];
+        return content
+            .split(/\n/u)
+            .filter((line) => line.trim())
+            .map((line) => JSON.parse(line));
+    }
+    catch {
+        throw new ChatStorageError(safeStorageIssue("storage_corrupted", field, "Chat storage log is not readable."));
+    }
+}
+//# sourceMappingURL=chat-storage-local-records.js.map

package/dist/chat-storage-local-records.js.map

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

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

@@ -0,0 +1,6 @@
+import type { ChatStorage } from "./chat-storage.js";
+export { encodeStorageIdentifier } from "./chat-storage-local-paths.js";
+export interface LocalChatStorageOptions {
+    workspaceRoot: string;
+}
+export declare function createLocalChatStorage(options: LocalChatStorageOptions): ChatStorage;