@roackb2/heddle 1.2.0 → 1.4.0

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

@@ -0,0 +1,262 @@
+/**
+ * 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';
+const ReasoningEffortSchema = z.enum(['low', 'medium', 'high', 'ultrahigh']);
+const ChatSessionRetentionSchema = z.enum(['reusable', 'one_off']);
+const ChatSessionLeaseOwnerSchema = z.enum(['tui', 'daemon', 'ask']);
+const CompactionStatusSchema = z.enum(['idle', 'running', 'failed']);
+const ToolCallSchema = z.object({
+    id: z.string().describe('Provider-assigned tool call identifier used to pair tool results with assistant requests.'),
+    tool: z.string().describe('Registered Heddle tool name requested by the assistant.'),
+    input: z.unknown().describe('Raw structured input passed to the requested tool.'),
+});
+const ChatMessageSchema = z.union([
+    z.object({
+        role: z.literal('system').describe('Transcript role for host-provided system instructions.'),
+        content: z.string().describe('System message text sent to the model.'),
+    }),
+    z.object({
+        role: z.literal('user').describe('Transcript role for user prompts.'),
+        content: z.string().describe('User prompt text sent to the model.'),
+    }),
+    z.object({
+        role: z.literal('assistant').describe('Transcript role for assistant responses.'),
+        content: z.string().describe('Assistant text content returned by the model.'),
+        toolCalls: z.array(ToolCallSchema)
+            .describe('Tool calls requested by this assistant message.')
+            .optional(),
+    }),
+    z.object({
+        role: z.literal('tool').describe('Transcript role for tool execution results.'),
+        content: z.string().describe('Serialized tool result content returned to the model.'),
+        toolCallId: z.string().describe('Identifier of the assistant tool call this result answers.'),
+    }),
+]);
+const ChatMessagesSchema = z.array(z.unknown())
+    .transform((messages) => messages.flatMap((message) => {
+    const parsed = ChatMessageSchema.safeParse(message);
+    return parsed.success ? [parsed.data] : [];
+}));
+export const ConversationLineSchema = z.object({
+    id: z.string().describe('Stable visible message identifier used by chat surfaces.'),
+    role: z.enum(['user', 'assistant']).describe('Visible chat role rendered in host interfaces.'),
+    text: z.string().describe('Human-facing message text shown in chat history.'),
+    isStreaming: z.boolean()
+        .describe('Whether this visible line was still streaming when captured.')
+        .optional(),
+    isPending: z.boolean()
+        .describe('Whether this visible line represented pending local UI state.')
+        .optional(),
+});
+const ConversationLinesSchema = z.array(z.unknown())
+    .transform((messages) => messages.flatMap((message) => {
+    const parsed = ConversationLineSchema.safeParse(message);
+    return parsed.success ? [parsed.data] : [];
+}));
+const TurnSummarySchema = z.object({
+    id: z.string().describe('Stable identifier for this completed turn summary.'),
+    prompt: z.string().describe('User prompt that started the turn.'),
+    outcome: z.string().describe('Final stop reason or outcome reported by the agent loop.'),
+    summary: z.string().describe('Short human-readable turn summary.'),
+    steps: z.number().describe('Number of assistant loop steps executed in the turn.'),
+    traceFile: z.string().describe('Path to the persisted trace file for this turn.'),
+    events: z.array(z.string()).describe('Compact event summaries extracted from the turn trace.'),
+});
+const TurnSummariesSchema = z.array(z.unknown())
+    .transform((turns) => turns.flatMap((turn) => {
+    const parsed = TurnSummarySchema.safeParse(turn);
+    return parsed.success ? [parsed.data] : [];
+}));
+const LlmUsageSchema = z.object({
+    inputTokens: z.number().describe('Prompt tokens charged or reported for the model request.'),
+    outputTokens: z.number().describe('Completion tokens charged or reported for the model request.'),
+    totalTokens: z.number().describe('Total tokens reported for the model request.'),
+    cachedInputTokens: z.number()
+        .describe('Input tokens served from provider-side prompt cache, when reported.')
+        .optional(),
+    reasoningTokens: z.number()
+        .describe('Reasoning tokens reported by reasoning-capable model providers.')
+        .optional(),
+    requests: z.number()
+        .describe('Number of provider requests represented by this usage aggregate.')
+        .optional(),
+});
+const ChatContextStatsSchema = z.object({
+    estimatedHistoryTokens: z.number().describe('Estimated token count for the session history currently retained in context.'),
+    request: z.object({
+        estimatedTokens: z.number()
+            .describe('Estimated token count for the most recent turn request.')
+            .optional(),
+        toolNames: z.array(z.string())
+            .describe('Tool names available to the most recent turn request.')
+            .optional(),
+        goal: z.string()
+            .describe('Most recent user goal or prompt associated with these context stats.')
+            .optional(),
+        usage: LlmUsageSchema
+            .describe('Provider usage reported by the most recent turn request.')
+            .optional(),
+    }).describe('Most recent request-level context and usage metadata.').optional(),
+    compaction: z.object({
+        compactedMessages: z.number()
+            .describe('Number of transcript messages replaced by the latest compaction summary.')
+            .optional(),
+        compactedAt: z.string()
+            .describe('Timestamp when the latest compaction completed.')
+            .optional(),
+        status: CompactionStatusSchema
+            .describe('Current or latest compaction lifecycle status.')
+            .optional(),
+        error: z.string()
+            .describe('Last compaction error message, when compaction failed.')
+            .optional(),
+    }).describe('Session compaction lifecycle metadata.').optional(),
+    archive: z.object({
+        count: z.number()
+            .describe('Number of archive records currently associated with the session.')
+            .optional(),
+        currentSummaryPath: z.string()
+            .describe('Path to the active compacted summary used for context reconstruction.')
+            .optional(),
+        lastArchivePath: z.string()
+            .describe('Path to the most recently written conversation archive.')
+            .optional(),
+    }).describe('Archive metadata used to reconnect compacted history with persisted files.').optional(),
+});
+const ChatArchiveRecordSchema = z.object({
+    id: z.string().describe('Stable identifier for this conversation archive.'),
+    path: z.string().describe('Path to the archived raw conversation history.'),
+    summaryPath: z.string().describe('Path to the compacted summary generated for this archive.'),
+    shortDescription: z.string()
+        .describe('Short human-readable description of the archived conversation slice.')
+        .optional(),
+    messageCount: z.number().describe('Number of messages stored in this archive.'),
+    createdAt: z.string().describe('Timestamp when this archive was created.'),
+    summaryModel: z.string()
+        .describe('Model used to generate the archive summary, when available.')
+        .optional(),
+});
+const ChatArchiveRecordsSchema = z.array(z.unknown())
+    .transform((archives) => archives.flatMap((archive) => {
+    const parsed = ChatArchiveRecordSchema.safeParse(archive);
+    return parsed.success ? [parsed.data] : [];
+}));
+const ChatSessionLeaseSchema = z.object({
+    ownerKind: ChatSessionLeaseOwnerSchema.describe('Kind of host currently holding the session lease.'),
+    ownerId: z.string().describe('Unique owner identifier for the current lease holder.'),
+    acquiredAt: z.string().describe('Timestamp when the current lease was acquired.'),
+    lastSeenAt: z.string().describe('Timestamp when the lease holder last refreshed ownership.'),
+    clientLabel: z.string()
+        .describe('Optional human-facing label for the lease holder.')
+        .optional(),
+});
+export const CatalogEntryReadSchema = z.object({
+    id: z.string().describe('Stable session identifier used by all host surfaces.'),
+    name: z.string().describe('Human-facing session title shown in session lists.'),
+    retention: ChatSessionRetentionSchema
+        .describe('Whether the session is reusable or intended as a one-off ask session.')
+        .optional()
+        .catch(undefined),
+    workspaceId: z.string()
+        .describe('Workspace identifier this session belongs to, when known.')
+        .optional(),
+    createdAt: z.string()
+        .describe('Timestamp when the session was created.')
+        .optional(),
+    updatedAt: z.string()
+        .describe('Timestamp when the session was last changed.')
+        .optional(),
+    model: z.string()
+        .describe('Default model selected for future turns in this session.')
+        .optional(),
+    reasoningEffort: ReasoningEffortSchema
+        .describe('Default reasoning effort selected for future turns in this session.')
+        .optional()
+        .catch(undefined),
+    driftEnabled: z.boolean()
+        .describe('Whether semantic drift awareness is enabled for this session.')
+        .optional()
+        .catch(false),
+    lastContinuePrompt: z.string()
+        .describe('Most recent continue prompt recorded for follow-up turn ergonomics.')
+        .optional(),
+    context: ChatContextStatsSchema
+        .describe('Current context, compaction, and archive metadata for this session.')
+        .optional()
+        .catch(undefined),
+    archives: ChatArchiveRecordsSchema
+        .describe('Conversation archives associated with this session.')
+        .optional()
+        .catch(undefined),
+    lease: ChatSessionLeaseSchema
+        .describe('Current session lease held by a TUI, daemon, or ask host.')
+        .optional()
+        .catch(undefined),
+});
+export const CatalogEntryWriteSchema = CatalogEntryReadSchema.required({
+    createdAt: true,
+    updatedAt: true,
+});
+export const CatalogReadSchema = z.object({
+    version: z.literal(1).describe('Persisted catalog schema version.'),
+    sessions: z.array(z.unknown()).describe('Session metadata entries; invalid entries are skipped during reads.'),
+});
+export const CatalogWriteSchema = z.object({
+    version: z.literal(1).describe('Persisted catalog schema version.'),
+    sessions: z.array(CatalogEntryWriteSchema).describe('Session metadata entries written to the catalog file.'),
+});
+export const SessionBodyReadSchema = z.object({
+    id: z.string()
+        .describe('Session identifier duplicated in the body for human inspection.')
+        .optional(),
+    retention: ChatSessionRetentionSchema
+        .describe('Whether the session is reusable or intended as a one-off ask session.')
+        .optional()
+        .catch(undefined),
+    workspaceId: z.string()
+        .describe('Workspace identifier duplicated in the body for human inspection.')
+        .optional(),
+    history: ChatMessagesSchema
+        .describe('Model-facing transcript retained for future turns.')
+        .optional()
+        .catch([]),
+    messages: ConversationLinesSchema
+        .describe('Host-facing visible conversation lines.')
+        .optional()
+        .catch([]),
+    turns: TurnSummariesSchema
+        .describe('Recent completed turn summaries shown in session detail surfaces.')
+        .optional()
+        .catch([]),
+    archives: ChatArchiveRecordsSchema
+        .describe('Conversation archives duplicated in the body for session reconstruction.')
+        .optional()
+        .catch(undefined),
+    lease: ChatSessionLeaseSchema
+        .describe('Current session lease duplicated in the body for session reconstruction.')
+        .optional()
+        .catch(undefined),
+});
+export const SessionBodyWriteSchema = z.object({
+    id: z.string().describe('Session identifier duplicated in the body for human inspection.'),
+    retention: ChatSessionRetentionSchema
+        .describe('Whether the session is reusable or intended as a one-off ask session.')
+        .optional(),
+    workspaceId: z.string()
+        .describe('Workspace identifier duplicated in the body for human inspection.')
+        .optional(),
+    history: z.array(ChatMessageSchema).describe('Model-facing transcript retained for future turns.'),
+    messages: z.array(ConversationLineSchema).describe('Host-facing visible conversation lines.'),
+    turns: z.array(TurnSummarySchema).describe('Recent completed turn summaries shown in session detail surfaces.'),
+    archives: z.array(ChatArchiveRecordSchema)
+        .describe('Conversation archives duplicated in the body for session reconstruction.')
+        .optional(),
+    lease: ChatSessionLeaseSchema
+        .describe('Current session lease duplicated in the body for session reconstruction.')
+        .optional(),
+});
+//# sourceMappingURL=chat-session-schemas.js.map

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

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

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

@@ -1,38 +1,27 @@
-import type { ReasoningEffort } from '../../../../llm/types.js';
-import type { ChatArchiveRecord, ChatContextStats, ChatSession, ChatSessionLease } from '../../../types.js';
-export type ChatSessionCatalogEntry = {
-    id: string;
-    name: string;
-    workspaceId?: string;
-    createdAt: string;
-    updatedAt: string;
-    model?: string;
-    reasoningEffort?: ReasoningEffort;
-    driftEnabled?: boolean;
-    lastContinuePrompt?: string;
-    context?: ChatContextStats;
-    archives?: ChatArchiveRecord[];
-    lease?: ChatSessionLease;
-};
-export type ChatSessionRepository = {
+import type { ChatSession } from '../../../../../core/chat/types.js';
+import type { ChatSessionCatalogEntry, ChatSessionRepository, SessionStoragePaths } from './types.js';
+export declare class FileChatSessionRepository implements ChatSessionRepository {
+    private readonly sessionStoragePath;
+    private readonly storagePaths;
+    constructor(args: {
+        sessionStoragePath: string;
+    });
     list(apiKeyPresent: boolean): ChatSession[];
     readCatalog(): ChatSessionCatalogEntry[];
     read(sessionId: string, apiKeyPresent: boolean): ChatSession | undefined;
-    migrateLegacy(apiKeyPresent: boolean): ChatSession[];
     save(sessions: ChatSession[]): void;
-    deriveStoragePaths(): ReturnType<typeof deriveSessionStoragePaths>;
-};
-export declare function createFileChatSessionRepository(args: {
-    sessionStoragePath: string;
-}): ChatSessionRepository;
-export declare function loadChatSessions(sessionsPath: string, apiKeyPresent: boolean): ChatSession[];
-export declare function readChatSessionCatalog(sessionsPath: string): ChatSessionCatalogEntry[];
-export declare function readChatSession(sessionsPath: string, sessionId: string, apiKeyPresent: boolean): ChatSession | undefined;
-export declare function migrateLegacyChatSessions(sessionsPath: string, apiKeyPresent: boolean): ChatSession[];
-export declare function saveChatSessions(sessionsPath: string, sessions: ChatSession[]): void;
-export declare function deriveSessionStoragePaths(storagePath: string): {
-    catalogPath: string;
-    legacyPath: string;
-    sessionsDir: string;
-};
+    deriveStoragePaths(): SessionStoragePaths;
+    static deriveStoragePaths(storagePath: string): SessionStoragePaths;
+    private loadFromCurrentStorage;
+    private loadSessionsFromCatalog;
+    private static readSessionFile;
+    private static writeSessionFileIfChanged;
+    private static writeCatalogIfChanged;
+    private static readSessionFileContents;
+    private static readCatalogFile;
+    private static dedupeSessionsById;
+    private static sessionFilePath;
+    private static removeOrphanedSessionFiles;
+    private static safeReadDirFiles;
+}
 //# sourceMappingURL=file-chat-session-repository.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"file-chat-session-repository.d.ts","sourceRoot":"","sources":["../../../../../../../src/core/chat/engine/sessions/repository/file-chat-session-repository.ts"],"names":[],"mappings":"AAaA,OAAO,KAAK,EAAe,eAAe,EAAE,MAAM,0BAA0B,CAAC;AAC7E,OAAO,KAAK,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,WAAW,EAAE,gBAAgB,EAAiC,MAAM,mBAAmB,CAAC;AAG3I,MAAM,MAAM,uBAAuB,GAAG;IACpC,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,eAAe,CAAC,EAAE,eAAe,CAAC;IAClC,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,OAAO,CAAC,EAAE,gBAAgB,CAAC;IAC3B,QAAQ,CAAC,EAAE,iBAAiB,EAAE,CAAC;IAC/B,KAAK,CAAC,EAAE,gBAAgB,CAAC;CAC1B,CAAC;AAOF,MAAM,MAAM,qBAAqB,GAAG;IAClC,IAAI,CAAC,aAAa,EAAE,OAAO,GAAG,WAAW,EAAE,CAAC;IAC5C,WAAW,IAAI,uBAAuB,EAAE,CAAC;IACzC,IAAI,CAAC,SAAS,EAAE,MAAM,EAAE,aAAa,EAAE,OAAO,GAAG,WAAW,GAAG,SAAS,CAAC;IACzE,aAAa,CAAC,aAAa,EAAE,OAAO,GAAG,WAAW,EAAE,CAAC;IACrD,IAAI,CAAC,QAAQ,EAAE,WAAW,EAAE,GAAG,IAAI,CAAC;IACpC,kBAAkB,IAAI,UAAU,CAAC,OAAO,yBAAyB,CAAC,CAAC;CACpE,CAAC;AAEF,wBAAgB,+BAA+B,CAAC,IAAI,EAAE;IACpD,kBAAkB,EAAE,MAAM,CAAC;CAC5B,GAAG,qBAAqB,CAsBxB;AAED,wBAAgB,gBAAgB,CAAC,YAAY,EAAE,MAAM,EAAE,aAAa,EAAE,OAAO,GAAG,WAAW,EAAE,CAkB5F;AAED,wBAAgB,sBAAsB,CAAC,YAAY,EAAE,MAAM,GAAG,uBAAuB,EAAE,CAItF;AAED,wBAAgB,eAAe,CAAC,YAAY,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,aAAa,EAAE,OAAO,GAAG,WAAW,GAAG,SAAS,CASxH;AAED,wBAAgB,yBAAyB,CAAC,YAAY,EAAE,MAAM,EAAE,aAAa,EAAE,OAAO,GAAG,WAAW,EAAE,CAQrG;AAED,wBAAgB,gBAAgB,CAAC,YAAY,EAAE,MAAM,EAAE,QAAQ,EAAE,WAAW,EAAE,QA0B7E;AAED,wBAAgB,yBAAyB,CAAC,WAAW,EAAE,MAAM;;;;EAmC5D"}
+{"version":3,"file":"file-chat-session-repository.d.ts","sourceRoot":"","sources":["../../../../../../../src/core/chat/engine/sessions/repository/file-chat-session-repository.ts"],"names":[],"mappings":"AAaA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAGxD,OAAO,KAAK,EAAsB,uBAAuB,EAAE,qBAAqB,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AAE1H,qBAAa,yBAA0B,YAAW,qBAAqB;IACrE,OAAO,CAAC,QAAQ,CAAC,kBAAkB,CAAS;IAC5C,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAsB;gBAEvC,IAAI,EAAE;QAAE,kBAAkB,EAAE,MAAM,CAAA;KAAE;IAKhD,IAAI,CAAC,aAAa,EAAE,OAAO,GAAG,WAAW,EAAE;IAe3C,WAAW,IAAI,uBAAuB,EAAE;IAKxC,IAAI,CAAC,SAAS,EAAE,MAAM,EAAE,aAAa,EAAE,OAAO,GAAG,WAAW,GAAG,SAAS;IAWxE,IAAI,CAAC,QAAQ,EAAE,WAAW,EAAE,GAAG,IAAI;IAoCnC,kBAAkB,IAAI,mBAAmB;IAIzC,MAAM,CAAC,kBAAkB,CAAC,WAAW,EAAE,MAAM,GAAG,mBAAmB;IAsBnE,OAAO,CAAC,sBAAsB;IAI9B,OAAO,CAAC,uBAAuB;IAwB/B,OAAO,CAAC,MAAM,CAAC,eAAe;IAqB9B,OAAO,CAAC,MAAM,CAAC,yBAAyB;IAUxC,OAAO,CAAC,MAAM,CAAC,qBAAqB;IAcpC,OAAO,CAAC,MAAM,CAAC,uBAAuB;IAatC,OAAO,CAAC,MAAM,CAAC,eAAe;IAY9B,OAAO,CAAC,MAAM,CAAC,kBAAkB;IAejC,OAAO,CAAC,MAAM,CAAC,eAAe;IAI9B,OAAO,CAAC,MAAM,CAAC,0BAA0B;IAezC,OAAO,CAAC,MAAM,CAAC,gBAAgB;CAQhC"}