@roackb2/heddle 1.2.0 → 1.4.0

package/dist/src/core/chat/engine/sessions/records/records.js

@@ -0,0 +1,91 @@
+/**
+ * Pure chat-session record domain behavior.
+ *
+ * This class has no storage or host dependencies. Keep reusable record
+ * creation, timestamp, naming, and summary semantics here so the stateful
+ * session service can compose them without growing scattered helper functions.
+ */
+import { truncate } from '../../../../../core/utils/text.js';
+import { countAssistantSteps, summarizeTrace } from '../../../../../core/observability/trace-summarizers.js';
+import { ConversationLines } from './conversation-lines.js';
+export class ChatSessionRecords {
+    static createInitialMessages(apiKeyPresent) {
+        return [
+            {
+                id: 'intro',
+                role: 'assistant',
+                text: 'Heddle conversational mode.\n\nAsk a question about this workspace.\nEach turn runs the current agent loop and carries the transcript into the next turn.\nUse !<command> to run a shell command directly in chat.',
+            },
+            ...(!apiKeyPresent ?
+                [{
+                        id: 'missing-key',
+                        role: 'assistant',
+                        text: 'No provider credential detected. For OpenAI, run `heddle auth login openai` or set OPENAI_API_KEY. For Anthropic, set ANTHROPIC_API_KEY. Dev fallback conventions also work: PERSONAL_OPENAI_API_KEY and PERSONAL_ANTHROPIC_API_KEY.',
+                    }]
+                : []),
+        ];
+    }
+    static create(options) {
+        const now = new Date().toISOString();
+        return {
+            id: options.id,
+            name: options.name,
+            retention: options.retention ?? 'reusable',
+            workspaceId: options.workspaceId,
+            history: [],
+            messages: ChatSessionRecords.createInitialMessages(options.apiKeyPresent),
+            turns: [],
+            createdAt: now,
+            updatedAt: now,
+            model: options.model,
+            reasoningEffort: options.reasoningEffort,
+            driftEnabled: false,
+            lastContinuePrompt: undefined,
+            context: undefined,
+            archives: [],
+            lease: undefined,
+        };
+    }
+    static touch(session) {
+        return { ...session, updatedAt: new Date().toISOString() };
+    }
+    static summarize(session) {
+        const latestTurn = session.turns[session.turns.length - 1];
+        const latestPrompt = latestTurn ? truncate(latestTurn.prompt, 44) : 'no turns yet';
+        return `${session.turns.length} turns • ${latestPrompt}`;
+    }
+    static buildTurnSummary(input) {
+        return {
+            id: input.id,
+            prompt: input.prompt,
+            outcome: input.result.outcome,
+            summary: input.result.summary,
+            steps: countAssistantSteps(input.result.trace),
+            traceFile: input.traceFile,
+            events: typeof input.traceSummarizerRegistry?.summarizeTrace === 'function'
+                ? input.traceSummarizerRegistry.summarizeTrace(input.result.trace)
+                : summarizeTrace(input.result.trace),
+        };
+    }
+    static applyCompactedHistory(input) {
+        return {
+            ...input.session,
+            history: input.compacted.history,
+            context: input.compacted.context,
+            archives: input.compacted.archive.archives,
+            messages: ConversationLines.fromHistory(input.compacted.history),
+        };
+    }
+    static applyCompletedTurn(input) {
+        return ChatSessionRecords.touch({
+            ...ChatSessionRecords.applyCompactedHistory(input),
+            lastContinuePrompt: input.prompt,
+            lease: undefined,
+            turns: [...input.session.turns, input.turn].slice(-8),
+        });
+    }
+    static isGenericName(name) {
+        return /^Session \d+$/.test(name.trim());
+    }
+}
+//# sourceMappingURL=records.js.map

package/dist/src/core/chat/engine/sessions/records/records.js.map

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

package/dist/src/core/chat/engine/sessions/records/titles.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Pure session-title generation behavior.
+ *
+ * Owns the prompt and LLM call used to suggest a short chat session title.
+ * Storage and host auto-rename policy stay outside this class.
+ */
+import type { ChatMessage, LlmAdapter } from '../../../../../core/llm/types.js';
+import type { GenerateChatSessionTitleInput } from './types.js';
+export declare class ChatSessionTitles {
+    static buildPrompt(prompt: string, responseText: string): ChatMessage[];
+    static generate(args: GenerateChatSessionTitleInput & {
+        llm: LlmAdapter;
+    }): Promise<string | undefined>;
+}
+//# sourceMappingURL=titles.d.ts.map

package/dist/src/core/chat/engine/sessions/records/titles.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"titles.d.ts","sourceRoot":"","sources":["../../../../../../../src/core/chat/engine/sessions/records/titles.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,KAAK,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AACnE,OAAO,KAAK,EAAE,6BAA6B,EAAE,MAAM,YAAY,CAAC;AAEhE,qBAAa,iBAAiB;IAC5B,MAAM,CAAC,WAAW,CAAC,MAAM,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG,WAAW,EAAE;WAc1D,QAAQ,CAAC,IAAI,EAAE,6BAA6B,GAAG;QAAE,GAAG,EAAE,UAAU,CAAA;KAAE,GAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC;CAI9G"}

package/dist/src/core/chat/engine/sessions/records/titles.js

@@ -0,0 +1,19 @@
+export class ChatSessionTitles {
+    static buildPrompt(prompt, responseText) {
+        return [
+            {
+                role: 'system',
+                content: 'You name terminal chat sessions. Return only a short 3 to 6 word title in plain text. No quotes, no punctuation, no prefix.',
+            },
+            {
+                role: 'user',
+                content: `User prompt:\n${prompt}\n\nAssistant or tool summary:\n${responseText}\n\nCreate a concise session title.`,
+            },
+        ];
+    }
+    static async generate(args) {
+        const result = await args.llm.chat(ChatSessionTitles.buildPrompt(args.prompt, args.responseText), []);
+        return args.normalize(result.content);
+    }
+}
+//# sourceMappingURL=titles.js.map

package/dist/src/core/chat/engine/sessions/records/titles.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"titles.js","sourceRoot":"","sources":["../../../../../../../src/core/chat/engine/sessions/records/titles.ts"],"names":[],"mappings":"AASA,MAAM,OAAO,iBAAiB;IAC5B,MAAM,CAAC,WAAW,CAAC,MAAc,EAAE,YAAoB;QACrD,OAAO;YACL;gBACE,IAAI,EAAE,QAAQ;gBACd,OAAO,EACL,6HAA6H;aAChI;YACD;gBACE,IAAI,EAAE,MAAM;gBACZ,OAAO,EAAE,iBAAiB,MAAM,mCAAmC,YAAY,qCAAqC;aACrH;SACF,CAAC;IACJ,CAAC;IAED,MAAM,CAAC,KAAK,CAAC,QAAQ,CAAC,IAAyD;QAC7E,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,iBAAiB,CAAC,WAAW,CAAC,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,YAAY,CAAC,EAAE,EAAE,CAAC,CAAC;QACtG,OAAO,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;IACxC,CAAC;CACF"}

package/dist/src/core/chat/engine/sessions/records/types.d.ts

@@ -0,0 +1,35 @@
+import type { ReasoningEffort } from '../../../../../core/llm/types.js';
+import type { TraceSummarizerRegistry } from '../../../../../core/observability/trace-summarizers.js';
+import type { ConversationCompactionResult } from '../../../../../core/chat/engine/compaction/index.js';
+import type { RunResult } from '../../../../../core/types.js';
+import type { ChatSession, ChatSessionRetention, TurnSummary } from '../../../../../core/chat/types.js';
+export type CreateChatSessionRecordOptions = {
+    id: string;
+    name: string;
+    apiKeyPresent: boolean;
+    model?: string;
+    reasoningEffort?: ReasoningEffort;
+    workspaceId?: string;
+    retention?: ChatSessionRetention;
+};
+export type GenerateChatSessionTitleInput = {
+    prompt: string;
+    responseText: string;
+    normalize: (value: string | undefined) => string | undefined;
+};
+export type BuildChatTurnSummaryInput = {
+    id: string;
+    prompt: string;
+    result: RunResult;
+    traceFile: string;
+    traceSummarizerRegistry?: TraceSummarizerRegistry;
+};
+export type ApplyCompactedChatSessionHistoryInput = {
+    session: ChatSession;
+    compacted: ConversationCompactionResult;
+};
+export type ApplyCompletedChatSessionTurnInput = ApplyCompactedChatSessionHistoryInput & {
+    prompt: string;
+    turn: TurnSummary;
+};
+//# sourceMappingURL=types.d.ts.map

package/dist/src/core/chat/engine/sessions/records/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../../../../src/core/chat/engine/sessions/records/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAC3D,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,2CAA2C,CAAC;AACzF,OAAO,KAAK,EAAE,4BAA4B,EAAE,MAAM,wCAAwC,CAAC;AAC3F,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AACjD,OAAO,KAAK,EAAE,WAAW,EAAE,oBAAoB,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAE3F,MAAM,MAAM,8BAA8B,GAAG;IAC3C,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,aAAa,EAAE,OAAO,CAAC;IACvB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,eAAe,CAAC,EAAE,eAAe,CAAC;IAClC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,SAAS,CAAC,EAAE,oBAAoB,CAAC;CAClC,CAAC;AAEF,MAAM,MAAM,6BAA6B,GAAG;IAC1C,MAAM,EAAE,MAAM,CAAC;IACf,YAAY,EAAE,MAAM,CAAC;IACrB,SAAS,EAAE,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,KAAK,MAAM,GAAG,SAAS,CAAC;CAC9D,CAAC;AAEF,MAAM,MAAM,yBAAyB,GAAG;IACtC,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,SAAS,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,uBAAuB,CAAC,EAAE,uBAAuB,CAAC;CACnD,CAAC;AAEF,MAAM,MAAM,qCAAqC,GAAG;IAClD,OAAO,EAAE,WAAW,CAAC;IACrB,SAAS,EAAE,4BAA4B,CAAC;CACzC,CAAC;AAEF,MAAM,MAAM,kCAAkC,GAAG,qCAAqC,GAAG;IACvF,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,WAAW,CAAC;CACnB,CAAC"}

package/dist/src/core/chat/engine/sessions/records/types.js

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

package/dist/src/core/chat/engine/sessions/records/types.js.map

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

package/dist/src/core/chat/engine/sessions/repository/chat-session-codec.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Codec service for current chat session persistence.
+ *
+ * The schema file owns the JSON contract. This class owns the read/write
+ * behavior around that contract: graceful read degradation, strict write
+ * validation, catalog projection, and fallback visible messages.
+ */
+import type { ChatSession } from '../../../../../core/chat/types.js';
+import type { ChatSessionCatalog, ChatSessionCatalogEntry } from './types.js';
+export declare class ChatSessionCodec {
+    static parseCatalog(value: unknown): ChatSessionCatalog | undefined;
+    static parseSessionBody(value: unknown, args: {
+        entry: ChatSessionCatalogEntry;
+        apiKeyPresent: boolean;
+    }): ChatSession[];
+    static projectCatalogEntry(session: ChatSession): ChatSessionCatalogEntry;
+    static serializeCatalog(catalog: ChatSessionCatalog): string;
+    static serializeSessionBody(session: ChatSession): string;
+    private static parseCatalogEntry;
+    private static normalizeCatalogEntry;
+    private static resolveMessages;
+}
+//# sourceMappingURL=chat-session-codec.d.ts.map

package/dist/src/core/chat/engine/sessions/repository/chat-session-codec.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"chat-session-codec.d.ts","sourceRoot":"","sources":["../../../../../../../src/core/chat/engine/sessions/repository/chat-session-codec.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAYxD,OAAO,KAAK,EAAE,kBAAkB,EAAE,uBAAuB,EAAE,MAAM,YAAY,CAAC;AAE9E,qBAAa,gBAAgB;IAC3B,MAAM,CAAC,YAAY,CAAC,KAAK,EAAE,OAAO,GAAG,kBAAkB,GAAG,SAAS;IAYnE,MAAM,CAAC,gBAAgB,CACrB,KAAK,EAAE,OAAO,EACd,IAAI,EAAE;QAAE,KAAK,EAAE,uBAAuB,CAAC;QAAC,aAAa,EAAE,OAAO,CAAA;KAAE,GAC/D,WAAW,EAAE;IAehB,MAAM,CAAC,mBAAmB,CAAC,OAAO,EAAE,WAAW,GAAG,uBAAuB;IAIzE,MAAM,CAAC,gBAAgB,CAAC,OAAO,EAAE,kBAAkB,GAAG,MAAM;IAI5D,MAAM,CAAC,oBAAoB,CAAC,OAAO,EAAE,WAAW,GAAG,MAAM;IAIzD,OAAO,CAAC,MAAM,CAAC,iBAAiB;IAKhC,OAAO,CAAC,MAAM,CAAC,qBAAqB;IAkBpC,OAAO,CAAC,MAAM,CAAC,eAAe;CAM/B"}

package/dist/src/core/chat/engine/sessions/repository/chat-session-codec.js

@@ -0,0 +1,61 @@
+import { ChatSessionRecords } from '../records/index.js';
+import { CatalogEntryReadSchema, CatalogEntryWriteSchema, CatalogReadSchema, CatalogWriteSchema, SessionBodyReadSchema, SessionBodyWriteSchema, } from './chat-session-schemas.js';
+export class ChatSessionCodec {
+    static parseCatalog(value) {
+        const parsed = CatalogReadSchema.safeParse(value);
+        if (!parsed.success) {
+            return undefined;
+        }
+        return {
+            version: 1,
+            sessions: parsed.data.sessions.flatMap((entry) => ChatSessionCodec.parseCatalogEntry(entry)),
+        };
+    }
+    static parseSessionBody(value, args) {
+        const parsed = SessionBodyReadSchema.safeParse(value);
+        if (!parsed.success) {
+            return [];
+        }
+        return [{
+                ...parsed.data,
+                ...args.entry,
+                history: parsed.data.history ?? [],
+                messages: ChatSessionCodec.resolveMessages(parsed.data.messages, args.apiKeyPresent),
+                turns: parsed.data.turns ?? [],
+            }];
+    }
+    static projectCatalogEntry(session) {
+        return CatalogEntryWriteSchema.parse(session);
+    }
+    static serializeCatalog(catalog) {
+        return `${JSON.stringify(CatalogWriteSchema.parse(catalog), null, 2)}\n`;
+    }
+    static serializeSessionBody(session) {
+        return `${JSON.stringify(SessionBodyWriteSchema.parse(session), null, 2)}\n`;
+    }
+    static parseCatalogEntry(value) {
+        const parsed = CatalogEntryReadSchema.safeParse(value);
+        return parsed.success ? [ChatSessionCodec.normalizeCatalogEntry(parsed.data)] : [];
+    }
+    static normalizeCatalogEntry(value) {
+        const createdAt = value.createdAt ?? new Date().toISOString();
+        return {
+            retention: undefined,
+            workspaceId: undefined,
+            model: undefined,
+            reasoningEffort: undefined,
+            lastContinuePrompt: undefined,
+            context: undefined,
+            archives: undefined,
+            lease: undefined,
+            ...value,
+            createdAt,
+            updatedAt: value.updatedAt ?? createdAt,
+            driftEnabled: value.driftEnabled ?? false,
+        };
+    }
+    static resolveMessages(messages, apiKeyPresent) {
+        return messages && messages.length > 0 ? messages : ChatSessionRecords.createInitialMessages(apiKeyPresent);
+    }
+}
+//# sourceMappingURL=chat-session-codec.js.map

package/dist/src/core/chat/engine/sessions/repository/chat-session-codec.js.map

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

package/dist/src/core/chat/engine/sessions/repository/chat-session-schemas.d.ts

@@ -0,0 +1,369 @@
+/**
+ * Zod schemas for the current chat session persistence format.
+ *
+ * Keep field descriptions human-friendly because this file is the canonical
+ * contract for catalog and per-session JSON on disk.
+ */
+import { z } from 'zod';
+export declare const ConversationLineSchema: z.ZodObject<{
+    id: z.ZodString;
+    role: z.ZodEnum<{
+        user: "user";
+        assistant: "assistant";
+    }>;
+    text: z.ZodString;
+    isStreaming: z.ZodOptional<z.ZodBoolean>;
+    isPending: z.ZodOptional<z.ZodBoolean>;
+}, z.core.$strip>;
+export declare const CatalogEntryReadSchema: z.ZodObject<{
+    id: z.ZodString;
+    name: z.ZodString;
+    retention: z.ZodCatch<z.ZodOptional<z.ZodEnum<{
+        reusable: "reusable";
+        one_off: "one_off";
+    }>>>;
+    workspaceId: z.ZodOptional<z.ZodString>;
+    createdAt: z.ZodOptional<z.ZodString>;
+    updatedAt: z.ZodOptional<z.ZodString>;
+    model: z.ZodOptional<z.ZodString>;
+    reasoningEffort: z.ZodCatch<z.ZodOptional<z.ZodEnum<{
+        low: "low";
+        medium: "medium";
+        high: "high";
+        ultrahigh: "ultrahigh";
+    }>>>;
+    driftEnabled: z.ZodCatch<z.ZodOptional<z.ZodBoolean>>;
+    lastContinuePrompt: z.ZodOptional<z.ZodString>;
+    context: z.ZodCatch<z.ZodOptional<z.ZodObject<{
+        estimatedHistoryTokens: z.ZodNumber;
+        request: z.ZodOptional<z.ZodObject<{
+            estimatedTokens: z.ZodOptional<z.ZodNumber>;
+            toolNames: z.ZodOptional<z.ZodArray<z.ZodString>>;
+            goal: z.ZodOptional<z.ZodString>;
+            usage: z.ZodOptional<z.ZodObject<{
+                inputTokens: z.ZodNumber;
+                outputTokens: z.ZodNumber;
+                totalTokens: z.ZodNumber;
+                cachedInputTokens: z.ZodOptional<z.ZodNumber>;
+                reasoningTokens: z.ZodOptional<z.ZodNumber>;
+                requests: z.ZodOptional<z.ZodNumber>;
+            }, z.core.$strip>>;
+        }, z.core.$strip>>;
+        compaction: z.ZodOptional<z.ZodObject<{
+            compactedMessages: z.ZodOptional<z.ZodNumber>;
+            compactedAt: z.ZodOptional<z.ZodString>;
+            status: z.ZodOptional<z.ZodEnum<{
+                failed: "failed";
+                idle: "idle";
+                running: "running";
+            }>>;
+            error: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>>;
+        archive: z.ZodOptional<z.ZodObject<{
+            count: z.ZodOptional<z.ZodNumber>;
+            currentSummaryPath: z.ZodOptional<z.ZodString>;
+            lastArchivePath: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>>;
+    }, z.core.$strip>>>;
+    archives: z.ZodCatch<z.ZodOptional<z.ZodPipe<z.ZodArray<z.ZodUnknown>, z.ZodTransform<{
+        id: string;
+        path: string;
+        summaryPath: string;
+        messageCount: number;
+        createdAt: string;
+        shortDescription?: string | undefined;
+        summaryModel?: string | undefined;
+    }[], unknown[]>>>>;
+    lease: z.ZodCatch<z.ZodOptional<z.ZodObject<{
+        ownerKind: z.ZodEnum<{
+            tui: "tui";
+            daemon: "daemon";
+            ask: "ask";
+        }>;
+        ownerId: z.ZodString;
+        acquiredAt: z.ZodString;
+        lastSeenAt: z.ZodString;
+        clientLabel: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>>;
+}, z.core.$strip>;
+export declare const CatalogEntryWriteSchema: z.ZodObject<{
+    id: z.ZodString;
+    name: z.ZodString;
+    retention: z.ZodCatch<z.ZodOptional<z.ZodEnum<{
+        reusable: "reusable";
+        one_off: "one_off";
+    }>>>;
+    workspaceId: z.ZodOptional<z.ZodString>;
+    createdAt: z.ZodNonOptional<z.ZodOptional<z.ZodString>>;
+    updatedAt: z.ZodNonOptional<z.ZodOptional<z.ZodString>>;
+    model: z.ZodOptional<z.ZodString>;
+    reasoningEffort: z.ZodCatch<z.ZodOptional<z.ZodEnum<{
+        low: "low";
+        medium: "medium";
+        high: "high";
+        ultrahigh: "ultrahigh";
+    }>>>;
+    driftEnabled: z.ZodCatch<z.ZodOptional<z.ZodBoolean>>;
+    lastContinuePrompt: z.ZodOptional<z.ZodString>;
+    context: z.ZodCatch<z.ZodOptional<z.ZodObject<{
+        estimatedHistoryTokens: z.ZodNumber;
+        request: z.ZodOptional<z.ZodObject<{
+            estimatedTokens: z.ZodOptional<z.ZodNumber>;
+            toolNames: z.ZodOptional<z.ZodArray<z.ZodString>>;
+            goal: z.ZodOptional<z.ZodString>;
+            usage: z.ZodOptional<z.ZodObject<{
+                inputTokens: z.ZodNumber;
+                outputTokens: z.ZodNumber;
+                totalTokens: z.ZodNumber;
+                cachedInputTokens: z.ZodOptional<z.ZodNumber>;
+                reasoningTokens: z.ZodOptional<z.ZodNumber>;
+                requests: z.ZodOptional<z.ZodNumber>;
+            }, z.core.$strip>>;
+        }, z.core.$strip>>;
+        compaction: z.ZodOptional<z.ZodObject<{
+            compactedMessages: z.ZodOptional<z.ZodNumber>;
+            compactedAt: z.ZodOptional<z.ZodString>;
+            status: z.ZodOptional<z.ZodEnum<{
+                failed: "failed";
+                idle: "idle";
+                running: "running";
+            }>>;
+            error: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>>;
+        archive: z.ZodOptional<z.ZodObject<{
+            count: z.ZodOptional<z.ZodNumber>;
+            currentSummaryPath: z.ZodOptional<z.ZodString>;
+            lastArchivePath: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>>;
+    }, z.core.$strip>>>;
+    archives: z.ZodCatch<z.ZodOptional<z.ZodPipe<z.ZodArray<z.ZodUnknown>, z.ZodTransform<{
+        id: string;
+        path: string;
+        summaryPath: string;
+        messageCount: number;
+        createdAt: string;
+        shortDescription?: string | undefined;
+        summaryModel?: string | undefined;
+    }[], unknown[]>>>>;
+    lease: z.ZodCatch<z.ZodOptional<z.ZodObject<{
+        ownerKind: z.ZodEnum<{
+            tui: "tui";
+            daemon: "daemon";
+            ask: "ask";
+        }>;
+        ownerId: z.ZodString;
+        acquiredAt: z.ZodString;
+        lastSeenAt: z.ZodString;
+        clientLabel: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>>;
+}, z.core.$strip>;
+export declare const CatalogReadSchema: z.ZodObject<{
+    version: z.ZodLiteral<1>;
+    sessions: z.ZodArray<z.ZodUnknown>;
+}, z.core.$strip>;
+export declare const CatalogWriteSchema: z.ZodObject<{
+    version: z.ZodLiteral<1>;
+    sessions: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        name: z.ZodString;
+        retention: z.ZodCatch<z.ZodOptional<z.ZodEnum<{
+            reusable: "reusable";
+            one_off: "one_off";
+        }>>>;
+        workspaceId: z.ZodOptional<z.ZodString>;
+        createdAt: z.ZodNonOptional<z.ZodOptional<z.ZodString>>;
+        updatedAt: z.ZodNonOptional<z.ZodOptional<z.ZodString>>;
+        model: z.ZodOptional<z.ZodString>;
+        reasoningEffort: z.ZodCatch<z.ZodOptional<z.ZodEnum<{
+            low: "low";
+            medium: "medium";
+            high: "high";
+            ultrahigh: "ultrahigh";
+        }>>>;
+        driftEnabled: z.ZodCatch<z.ZodOptional<z.ZodBoolean>>;
+        lastContinuePrompt: z.ZodOptional<z.ZodString>;
+        context: z.ZodCatch<z.ZodOptional<z.ZodObject<{
+            estimatedHistoryTokens: z.ZodNumber;
+            request: z.ZodOptional<z.ZodObject<{
+                estimatedTokens: z.ZodOptional<z.ZodNumber>;
+                toolNames: z.ZodOptional<z.ZodArray<z.ZodString>>;
+                goal: z.ZodOptional<z.ZodString>;
+                usage: z.ZodOptional<z.ZodObject<{
+                    inputTokens: z.ZodNumber;
+                    outputTokens: z.ZodNumber;
+                    totalTokens: z.ZodNumber;
+                    cachedInputTokens: z.ZodOptional<z.ZodNumber>;
+                    reasoningTokens: z.ZodOptional<z.ZodNumber>;
+                    requests: z.ZodOptional<z.ZodNumber>;
+                }, z.core.$strip>>;
+            }, z.core.$strip>>;
+            compaction: z.ZodOptional<z.ZodObject<{
+                compactedMessages: z.ZodOptional<z.ZodNumber>;
+                compactedAt: z.ZodOptional<z.ZodString>;
+                status: z.ZodOptional<z.ZodEnum<{
+                    failed: "failed";
+                    idle: "idle";
+                    running: "running";
+                }>>;
+                error: z.ZodOptional<z.ZodString>;
+            }, z.core.$strip>>;
+            archive: z.ZodOptional<z.ZodObject<{
+                count: z.ZodOptional<z.ZodNumber>;
+                currentSummaryPath: z.ZodOptional<z.ZodString>;
+                lastArchivePath: z.ZodOptional<z.ZodString>;
+            }, z.core.$strip>>;
+        }, z.core.$strip>>>;
+        archives: z.ZodCatch<z.ZodOptional<z.ZodPipe<z.ZodArray<z.ZodUnknown>, z.ZodTransform<{
+            id: string;
+            path: string;
+            summaryPath: string;
+            messageCount: number;
+            createdAt: string;
+            shortDescription?: string | undefined;
+            summaryModel?: string | undefined;
+        }[], unknown[]>>>>;
+        lease: z.ZodCatch<z.ZodOptional<z.ZodObject<{
+            ownerKind: z.ZodEnum<{
+                tui: "tui";
+                daemon: "daemon";
+                ask: "ask";
+            }>;
+            ownerId: z.ZodString;
+            acquiredAt: z.ZodString;
+            lastSeenAt: z.ZodString;
+            clientLabel: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>>>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export declare const SessionBodyReadSchema: z.ZodObject<{
+    id: z.ZodOptional<z.ZodString>;
+    retention: z.ZodCatch<z.ZodOptional<z.ZodEnum<{
+        reusable: "reusable";
+        one_off: "one_off";
+    }>>>;
+    workspaceId: z.ZodOptional<z.ZodString>;
+    history: z.ZodCatch<z.ZodOptional<z.ZodPipe<z.ZodArray<z.ZodUnknown>, z.ZodTransform<({
+        role: "system";
+        content: string;
+    } | {
+        role: "user";
+        content: string;
+    } | {
+        role: "assistant";
+        content: string;
+        toolCalls?: {
+            id: string;
+            tool: string;
+            input: unknown;
+        }[] | undefined;
+    } | {
+        role: "tool";
+        content: string;
+        toolCallId: string;
+    })[], unknown[]>>>>;
+    messages: z.ZodCatch<z.ZodOptional<z.ZodPipe<z.ZodArray<z.ZodUnknown>, z.ZodTransform<{
+        id: string;
+        role: "user" | "assistant";
+        text: string;
+        isStreaming?: boolean | undefined;
+        isPending?: boolean | undefined;
+    }[], unknown[]>>>>;
+    turns: z.ZodCatch<z.ZodOptional<z.ZodPipe<z.ZodArray<z.ZodUnknown>, z.ZodTransform<{
+        id: string;
+        prompt: string;
+        outcome: string;
+        summary: string;
+        steps: number;
+        traceFile: string;
+        events: string[];
+    }[], unknown[]>>>>;
+    archives: z.ZodCatch<z.ZodOptional<z.ZodPipe<z.ZodArray<z.ZodUnknown>, z.ZodTransform<{
+        id: string;
+        path: string;
+        summaryPath: string;
+        messageCount: number;
+        createdAt: string;
+        shortDescription?: string | undefined;
+        summaryModel?: string | undefined;
+    }[], unknown[]>>>>;
+    lease: z.ZodCatch<z.ZodOptional<z.ZodObject<{
+        ownerKind: z.ZodEnum<{
+            tui: "tui";
+            daemon: "daemon";
+            ask: "ask";
+        }>;
+        ownerId: z.ZodString;
+        acquiredAt: z.ZodString;
+        lastSeenAt: z.ZodString;
+        clientLabel: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>>;
+}, z.core.$strip>;
+export declare const SessionBodyWriteSchema: z.ZodObject<{
+    id: z.ZodString;
+    retention: z.ZodOptional<z.ZodEnum<{
+        reusable: "reusable";
+        one_off: "one_off";
+    }>>;
+    workspaceId: z.ZodOptional<z.ZodString>;
+    history: z.ZodArray<z.ZodUnion<readonly [z.ZodObject<{
+        role: z.ZodLiteral<"system">;
+        content: z.ZodString;
+    }, z.core.$strip>, z.ZodObject<{
+        role: z.ZodLiteral<"user">;
+        content: z.ZodString;
+    }, z.core.$strip>, z.ZodObject<{
+        role: z.ZodLiteral<"assistant">;
+        content: z.ZodString;
+        toolCalls: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            id: z.ZodString;
+            tool: z.ZodString;
+            input: z.ZodUnknown;
+        }, z.core.$strip>>>;
+    }, z.core.$strip>, z.ZodObject<{
+        role: z.ZodLiteral<"tool">;
+        content: z.ZodString;
+        toolCallId: z.ZodString;
+    }, z.core.$strip>]>>;
+    messages: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        role: z.ZodEnum<{
+            user: "user";
+            assistant: "assistant";
+        }>;
+        text: z.ZodString;
+        isStreaming: z.ZodOptional<z.ZodBoolean>;
+        isPending: z.ZodOptional<z.ZodBoolean>;
+    }, z.core.$strip>>;
+    turns: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        prompt: z.ZodString;
+        outcome: z.ZodString;
+        summary: z.ZodString;
+        steps: z.ZodNumber;
+        traceFile: z.ZodString;
+        events: z.ZodArray<z.ZodString>;
+    }, z.core.$strip>>;
+    archives: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        path: z.ZodString;
+        summaryPath: z.ZodString;
+        shortDescription: z.ZodOptional<z.ZodString>;
+        messageCount: z.ZodNumber;
+        createdAt: z.ZodString;
+        summaryModel: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>>;
+    lease: z.ZodOptional<z.ZodObject<{
+        ownerKind: z.ZodEnum<{
+            tui: "tui";
+            daemon: "daemon";
+            ask: "ask";
+        }>;
+        ownerId: z.ZodString;
+        acquiredAt: z.ZodString;
+        lastSeenAt: z.ZodString;
+        clientLabel: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export type CatalogEntryRead = z.infer<typeof CatalogEntryReadSchema>;
+export type ConversationLineValue = z.infer<typeof ConversationLineSchema>;
+//# sourceMappingURL=chat-session-schemas.d.ts.map

package/dist/src/core/chat/engine/sessions/repository/chat-session-schemas.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"chat-session-schemas.d.ts","sourceRoot":"","sources":["../../../../../../../src/core/chat/engine/sessions/repository/chat-session-schemas.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AA0CxB,eAAO,MAAM,sBAAsB;;;;;;;;;iBAUjC,CAAC;AAgHH,eAAO,MAAM,sBAAsB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBA0CjC,CAAC;AAEH,eAAO,MAAM,uBAAuB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAGlC,CAAC;AAEH,eAAO,MAAM,iBAAiB;;;iBAG5B,CAAC;AAEH,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAG7B,CAAC;AAEH,eAAO,MAAM,qBAAqB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBA+BhC,CAAC;AAEH,eAAO,MAAM,sBAAsB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAiBjC,CAAC;AAEH,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAC;AACtE,MAAM,MAAM,qBAAqB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAC"}