qlogicagent 2.12.7 → 2.12.9

package/dist/types/orchestration/workflow/workflow-controller.d.ts

@@ -23,6 +23,7 @@ import type { WorkflowDef } from "./node-schema.js";
 import { type PatchEnvelope, type WorkflowPatch } from "./workflow-patch.js";
 import { type RenderOptions } from "./workflow-render.js";
 import { WorkflowStore, type ConcurrencyPolicy, type WorkflowRecord } from "./workflow-store.js";
+import { type WorkflowRunHistoryStore } from "./run-history-store.js";
 export interface TriggerEvent {
     type: WorkflowTriggerKind;
     payload?: Record<string, unknown>;
@@ -46,6 +47,8 @@ export interface RunOutcome {
     status: "completed" | "failed" | "paused" | "skipped";
     /** Absent when status === "skipped" (a busy run under the "skip" policy). */
     result?: RunResult;
+    /** Durable run-history id (present when a run-history store is wired). */
+    runId?: string;
 }
 export interface CreateInput {
     id: string;
@@ -68,11 +71,24 @@ export type PatchOutcome = {
 export declare class WorkflowController {
     private readonly store;
     private readonly runtimeFactory;
+    /** Optional durable run-history recorder. Wired here (not the handler) so every
+     *  trigger path — manual RPC, cron scheduler, IM, webhook — is captured alike. */
+    private readonly runHistory?;
     private readonly slots;
-    constructor(store: WorkflowStore, runtimeFactory: RuntimeFactory);
+    constructor(store: WorkflowStore, runtimeFactory: RuntimeFactory, 
+    /** Optional durable run-history recorder. Wired here (not the handler) so every
+     *  trigger path — manual RPC, cron scheduler, IM, webhook — is captured alike. */
+    runHistory?: WorkflowRunHistoryStore | undefined);
     create(input: CreateInput): Promise<WorkflowRecord>;
     update(id: string, patch: Partial<Pick<WorkflowRecord, "name" | "def" | "concurrency" | "active">>): Promise<WorkflowRecord>;
     setActive(id: string, active: boolean): Promise<WorkflowRecord>;
+    /**
+     * Revert a workflow to a stored revision snapshot (undo 基座). Git-revert semantics:
+     * the snapshot's def/name/trigger are re-applied as a NEW revision (rev bumps), so
+     * history stays forward-only and optimistic-concurrency baseRev checks keep working.
+     * fail-loud: unknown id or pruned/absent revision throws.
+     */
+    revertTo(id: string, rev: number): Promise<WorkflowRecord>;
     /**
      * Import an n8n workflow JSON (read-format only, plan M5 §2.1) into the single store. Converts
      * via the deterministic translator then routes through `create`, so the graph passes the same
@@ -102,6 +118,12 @@ export declare class WorkflowController {
     patch(id: string, env: PatchEnvelope): Promise<PatchOutcome>;
     /** Trigger a run, honoring the workflow's concurrency policy (spec §B5). */
     run(id: string, trigger?: TriggerEvent): Promise<RunOutcome>;
+    /**
+     * Wrap a run with durable history recording (when wired). Lives at this choke point —
+     * not in the RPC handler — so cron/IM/webhook runs are recorded identically to manual
+     * ones. History writes are best-effort: a recording failure never blocks the run.
+     */
+    private recordRun;
     /** Cooperatively pause the in-flight run; it suspends before the next node (cache retained). */
     pause(id: string): void;
     /** Resume a paused workflow: re-run the same runtime so cached nodes hit and only the

package/dist/types/orchestration/workflow/workflow-store.d.ts

@@ -26,10 +26,34 @@ export interface WorkflowRecord {
     createdAt: string;
     updatedAt: string;
 }
+/** Root dir of all workflow records for a project (shared with the run-history store). */
+export declare function workflowsDir(cwd: string): string;
+/** Bounded def-revision history depth — enough for undo, small enough to never matter on disk. */
+export declare const MAX_REVISIONS = 20;
+/** Summary row for revision lists (full snapshot stays behind loadRevision). */
+export interface RevisionSummary {
+    rev: number;
+    updatedAt: string;
+    name: string;
+    nodeCount: number;
+}
 export declare class WorkflowStore {
     private readonly cwd;
     constructor(cwd: string);
     save(record: WorkflowRecord): Promise<void>;
+    /**
+     * Persist a per-rev snapshot alongside the live record (undo/revert 基座).
+     * Keyed by rev: a meta-only update (same rev, e.g. setActive) overwrites its own
+     * snapshot; a patch (rev bump) appends a new one. Bounded to MAX_REVISIONS.
+     * fail-soft: snapshot/prune errors must never block the primary save.
+     */
+    private snapshotRevision;
+    /** Revision numbers, newest first. */
+    private revisionNumbers;
+    /** Newest-first revision summaries for the undo/history UI. */
+    listRevisions(id: string): Promise<RevisionSummary[]>;
+    /** Full record snapshot at a given rev (undefined when pruned/absent). */
+    loadRevision(id: string, rev: number): Promise<WorkflowRecord | undefined>;
     load(id: string): Promise<WorkflowRecord | undefined>;
     /** Load a record or throw (fail-loud lookup for callers that require existence). */
     require(id: string): Promise<WorkflowRecord>;

package/dist/types/protocol/wire/acp-protocol.d.ts

@@ -106,7 +106,6 @@ export interface AcpSessionMeta {
     sessionType?: string;
     groupKey?: string;
     groupName?: string;
-    assistantId?: string;
     permissions?: Record<string, unknown>;
     reasoning?: {
         effort?: string;
@@ -158,7 +157,7 @@ export interface AcpSessionPromptParams {
     sessionId: string;
     /** User prompt content blocks (standard ACP field). */
     prompt: AcpContentBlock[];
-    /** Per-turn context overrides (assistantId/permissions/reasoning/mcpServers/...), merged over session _meta. */
+    /** Per-turn context overrides (permissions/reasoning/mcpServers/...), merged over session _meta. */
     _meta?: AcpSessionMeta;
 }
 export interface AcpSessionPromptResult {

package/dist/types/protocol/wire/gateway-rpc.d.ts

@@ -74,54 +74,6 @@ export interface MemoryConsolidationResult {
     claimIds?: string[];
     conflictIds?: string[];
 }
-export interface AssistantPromptTemplateWire {
-    id: string;
-    title: string;
-    titleI18n?: Record<string, string>;
-    description?: string;
-    descriptionI18n?: Record<string, string>;
-    prompt: string;
-    promptI18n?: Record<string, string>;
-    icon?: string;
-}
-export interface AssistantPresetWire {
-    kind: "assistant-preset";
-    id: string;
-    source: "builtin" | "user" | "plugin";
-    name: string;
-    nameI18n?: Record<string, string>;
-    description?: string;
-    descriptionI18n?: Record<string, string>;
-    avatar?: string;
-    enabled: boolean;
-    sortOrder: number;
-    enabledSkills: string[];
-    disabledBuiltinSkills: string[];
-    context?: string;
-    prompts: AssistantPromptTemplateWire[];
-    modelHints: string[];
-    pluginId?: string;
-    readonly?: boolean;
-}
-export interface PluginAssistantDiagnosticWire {
-    pluginId: string;
-    manifestPath?: string;
-    severity: "error" | "warning";
-    message: string;
-    assistantId?: string;
-}
-export interface AssistantRuntimeContextWire {
-    assistantId: string;
-    context?: string;
-    enabledSkillNames: string[];
-    disabledBuiltinSkillNames: string[];
-    modelHints: string[];
-    prompts: AssistantPromptTemplateWire[];
-}
-export type AssistantPresetInputWire = Partial<AssistantPresetWire> & {
-    name: string;
-    prompts: AssistantPromptTemplateWire[];
-};
 export interface GatewayRpcMethodMap {
     "agent.health": {
         params: {};
@@ -504,70 +456,6 @@ export interface GatewayRpcMethodMap {
             }>;
         };
     };
-    "assistants.list": {
-        params: {};
-        result: {
-            assistants: AssistantPresetWire[];
-            diagnostics?: PluginAssistantDiagnosticWire[];
-        };
-    };
-    "assistants.resolve": {
-        params: {
-            assistantId: string;
-        };
-        result: AssistantRuntimeContextWire;
-    };
-    "assistants.cloneBuiltin": {
-        params: {
-            assistantId: string;
-        };
-        result: {
-            assistant: AssistantPresetWire;
-        };
-    };
-    "assistants.upsert": {
-        params: {
-            assistant: AssistantPresetInputWire;
-        };
-        result: {
-            assistant: AssistantPresetWire;
-        };
-    };
-    "assistants.create": {
-        params: {
-            assistant: AssistantPresetInputWire;
-        };
-        result: {
-            assistant: AssistantPresetWire;
-        };
-    };
-    "assistants.update": {
-        params: {
-            assistant: AssistantPresetInputWire;
-        };
-        result: {
-            assistant: AssistantPresetWire;
-        };
-    };
-    "assistants.delete": {
-        params: {
-            assistantId: string;
-        };
-        result: {
-            ok: boolean;
-        };
-    };
-    "assistants.setState": {
-        params: {
-            assistantId: string;
-            enabled?: boolean;
-            sortOrder?: number;
-            modelHints?: string[];
-        };
-        result: {
-            assistant: AssistantPresetWire;
-        };
-    };
     "memory.list-files": {
         params: {
             projectId?: string;

package/dist/types/runtime/config/tunable-defaults.d.ts

@@ -241,6 +241,12 @@ export interface TunableDefaults {
     dreamCooldownMs: number;
     dreamMaxDurationMs: number;
     teamBudgetTokens: number;
+    braveApiKey: string;
+    exaApiKey: string;
+    serperApiKey: string;
+    searxngBaseUrl: string;
+    crawl4aiBaseUrl: string;
+    searchSvcBaseUrl: string;
 }
 /**
  * Snapshot of all current tunable values.

package/dist/types/runtime/infra/agent-paths.d.ts

@@ -37,8 +37,6 @@ export declare function getUserPluginCacheDir(): string;
 export declare function getUserMcpConfigPath(): string;
 /** `~/.qlogicagent/profiles/<owner>/marketplace.json` */
 export declare function getUserMarketplaceConfigPath(): string;
-/** `~/.qlogicagent/profiles/<owner>/assistant-presets.json` */
-export declare function getUserAssistantPresetsPath(): string;
 /** `~/.qlogicagent/profiles/<owner>/workflows/` */
 export declare function getUserWorkflowsDir(): string;
 /** `~/.qlogicagent/profiles/<owner>/INSTRUCTIONS.md` */

package/dist/types/runtime/infra/agent-process.d.ts

@@ -29,11 +29,20 @@ export interface AgentProcessConfig {
     env?: Record<string, string>;
     /** Agent type hint for the child (sets system prompt behavior). */
     agentType?: string;
-    /** Model override for the child. */
+    /**
+     * Standing LLM config for an internal child. Pushed via session/set_config_option
+     * right after session/new so every turn (initial task, team send replies)
+     * resolves provider/model/apiKey explicitly. A standalone child has no llmrouter
+     * directory to hydrate a model catalog from — without this push its first turn
+     * dies with NO_PROVIDER. provider+apiKey are what the child's turn resolution
+     * requires (resolveTextGenerationConfig); model rides along for determinism.
+     */
+    provider?: string;
+    /** Model for the child's turns (see provider). */
     model?: string;
-    /** API key (forwarded via env). */
+    /** API key for the child's turns (see provider). */
     apiKey?: string;
-    /** Base URL for LLM API. */
+    /** Base URL for the child's LLM API (see provider). */
     baseUrl?: string;
     /** Enable verbose logging in child. */
     verbose?: boolean;
@@ -159,9 +168,6 @@ export declare class AgentProcessManager {
      * Returns the JSON-RPC result (content/usage carried on the response).
      */
     sendTask(memberId: string, prompt: string, options?: {
-        model?: string;
-        apiKey?: string;
-        baseUrl?: string;
         sessionId?: string;
         timeout?: number;
     }): Promise<unknown>;
@@ -181,9 +187,6 @@ export declare class AgentProcessManager {
      * `pingTimeout`, the task is considered failed.
      */
     sendTaskAsync(memberId: string, prompt: string, options?: {
-        model?: string;
-        apiKey?: string;
-        baseUrl?: string;
         sessionId?: string;
         /** Total timeout for the task (default: unlimited, 0 = no timeout) */
         timeout?: number;

package/dist/types/runtime/infra/default-path-service.d.ts

@@ -23,7 +23,6 @@ export declare class DefaultPathService implements PathService {
     getUserMcpConfigPath(): string;
     getUserPluginCacheDir(): string;
     getUserMarketplaceConfigPath(): string;
-    getUserAssistantPresetsPath(): string;
     getProjectAgentDir(projectRoot?: string): string;
     getProjectSettingsPath(projectRoot?: string): string;
     getProjectInstructionsPath(projectRoot?: string): string;

package/dist/types/runtime/infra/index.d.ts

@@ -1,4 +1,4 @@
-export { AGENT_DOT_DIR, getUserAgentHome, getUserCredentialsPath, getUserPluginsDir, getUserSkillsDir, getUserSettingsPath, getUserCacheDir, getUserDebugLogsDir, getUserPluginCacheDir, getUserMcpConfigPath, getUserMarketplaceConfigPath, getUserAssistantPresetsPath, getUserWorkflowsDir, getProjectAgentDir, getProjectWorkflowsDir, getProjectPluginsDir, getProjectSkillManifestPath, getProjectSettingsPath, getProjectInstructionsPath, getProjectRulesDir, getGitRootHooksDir, } from "./agent-paths.js";
+export { AGENT_DOT_DIR, getUserAgentHome, getUserCredentialsPath, getUserPluginsDir, getUserSkillsDir, getUserSettingsPath, getUserCacheDir, getUserDebugLogsDir, getUserPluginCacheDir, getUserMcpConfigPath, getUserMarketplaceConfigPath, getUserWorkflowsDir, getProjectAgentDir, getProjectWorkflowsDir, getProjectPluginsDir, getProjectSkillManifestPath, getProjectSettingsPath, getProjectInstructionsPath, getProjectRulesDir, getGitRootHooksDir, } from "./agent-paths.js";
 export { getBudgetContinuationMessage } from "./token-budget.js";
 export { type SecureStorage, saveApiKey, loadApiKey } from "./secure-storage.js";
 export { ProjectInstructionsStore, type InstructionFile } from "./project-instructions-store.js";

package/dist/types/runtime/infra/key-pool.d.ts

@@ -117,5 +117,6 @@ export declare class KeyPool {
     private weightedRandom;
     private leastBusy;
     private pruneWindow;
+    private pruneTokenWindow;
     private buildPoolStatus;
 }

package/dist/types/runtime/infra/llmrouter-catalog.d.ts

@@ -71,6 +71,14 @@ export declare function refreshRegistryFromLlmrouterApiKey(registry: ModelRegist
     forceCatalog?: boolean;
 }): Promise<ModelEntry[]>;
 export declare function resetLlmrouterCatalogClientCache(): void;
+/**
+ * 零配置默认模型:全新安装(无 textGeneration binding)且网关注入了设备账号推理 key 时,
+ * 自动把默认文本模型设为一个 DeepSeek(经 llmrouter)。调用方需先刷新过目录(this.models 里要有
+ * `llmrouter:deepseek-*` 条目)。已有 binding 则尊重用户配置、不覆盖。返回是否设置了默认。
+ *
+ * key 不在此注册 —— ModelRegistry 取 llmrouter key 时会回退到 QLOGIC_LLMROUTER_INFERENCE_KEY env。
+ */
+export declare function ensureLlmrouterDefaultBinding(registry: ModelRegistry, configPort?: ConfigPort): boolean;
 export declare function toModelEntry(model: LlmrouterCatalogModel): ModelEntry | null;
 export declare function toModelEntries(model: LlmrouterCatalogModel): ModelEntry[];
 export {};

package/dist/types/runtime/ports/path-service.d.ts

@@ -22,7 +22,6 @@ export interface PathService {
     getUserMcpConfigPath(): string;
     getUserPluginCacheDir(): string;
     getUserMarketplaceConfigPath(): string;
-    getUserAssistantPresetsPath(): string;
     getProjectAgentDir(projectRoot?: string): string;
     getProjectSettingsPath(projectRoot?: string): string;
     getProjectInstructionsPath(projectRoot?: string): string;

package/dist/types/runtime/ports/tool-contracts.d.ts

@@ -78,7 +78,7 @@ export interface ToolBootstrapProvider {
     kind?: ToolRegistrationModuleKind;
     register(tools: RuntimeToolContract[], context: ToolBootstrapProviderContext): void;
 }
-export type ToolRegistrationModuleKind = "core" | "dev" | "mcp" | "plugin" | "skill" | "local" | "media" | "compat";
+export type ToolRegistrationModuleKind = "core" | "dev" | "web" | "mcp" | "plugin" | "skill" | "local" | "media" | "workflow" | "compat";
 export interface ToolRegistrationModule<TContext extends object = Record<string, unknown>> {
     id: string;
     kind: ToolRegistrationModuleKind;

package/dist/types/runtime/prompt/environment-context.d.ts

@@ -35,6 +35,19 @@ export declare function createTaskGuidanceSection(domain?: TaskDomain): SystemPr
  * Tells the LLM when to use specialized tools vs. primitives.
  */
 export declare function createToolGuidanceSection(): SystemPromptSection;
+/**
+ * Index of deferred tools so the model KNOWS these capabilities exist even
+ * though their schemas are not loaded. Without this the model sees only the
+ * non-deferred tool list and will wrongly claim it lacks e.g. video generation.
+ *
+ * Volatile (recomputed each turn) because the deferred set can change when
+ * dynamic registrations (MCP, session bootstrap) land; the rendered text is
+ * stable across turns otherwise, so prompt cache is preserved in practice.
+ */
+export declare function createDeferredToolIndexSection(listDeferredTools: () => Array<{
+    name: string;
+    description: string;
+}>): SystemPromptSection;
 /**
  * Create a system prompt section that instructs the model on response language.
  * CC parity: only injected when language is explicitly set; when absent,

package/dist/types/runtime/prompt/index.d.ts

@@ -1,4 +1,5 @@
 export { assembleSystemPrompt, clearSystemPromptSections, systemPromptSection, type SystemPromptSection, } from "./system-prompt-sections.js";
+export { PROMPT_POLICY_VERSION, createPromptPolicyHeader } from "./prompt-policy.js";
 export { getInstructions, buildInstructionsPrompt, resetInstructionCache, } from "./instruction-loader.js";
 export { createEnvironmentContextSection, createTaskGuidanceSection, createToolGuidanceSection, createLanguageSection } from "./environment-context.js";
 export { detectTaskDomain, resolveTaskDomain, loadProjectTaskDomain, persistTaskDomain, shouldPersistDomain, type TaskDomain, type DomainResolutionContext } from "./task-domain.js";

package/dist/types/runtime/prompt/prompt-policy.d.ts

@@ -0,0 +1,2 @@
+export declare const PROMPT_POLICY_VERSION = 1;
+export declare function createPromptPolicyHeader(version?: number): string;

package/dist/types/runtime/prompt/system-prompt-sections.d.ts

@@ -39,6 +39,8 @@ export declare function resolveSystemPromptSections(sections: SystemPromptSectio
  */
 export declare function clearSystemPromptSections(): void;
 export interface SystemPromptAssemblyOptions {
+    /** Include the current prompt policy version header. Defaults to true. */
+    includePromptPolicy?: boolean;
     /** Base system prompt (from Gateway config) */
     basePrompt?: string;
     /** Prepended instruction block (from INSTRUCTIONS.md files) */

package/dist/types/runtime/session/session-catalog.d.ts

@@ -0,0 +1,4 @@
+import type { SessionListEntry } from "./session-types.js";
+export declare function listSessions(limit: number | undefined, projectRoot: string): Promise<SessionListEntry[]>;
+export declare function deleteSession(sessionId: string, projectRoot: string): Promise<void>;
+export declare function pruneOldSessions(projectRoot: string): Promise<number>;

package/dist/types/runtime/session/session-metadata-store.d.ts

@@ -0,0 +1,8 @@
+import type { SessionMetadata, SessionMetadataPatch, SessionStateSaveMetadata, SessionUsageSnapshot } from "./session-types.js";
+export declare function getSessionMetadata(sessionId: string, projectRoot: string): SessionMetadata | null;
+export declare function readSessionMetadata(sessionId: string, projectRoot: string, defaults?: {
+    messageCount?: number;
+}): Promise<SessionMetadata>;
+export declare function saveSessionState(sessionId: string, usageSnapshot: SessionUsageSnapshot, metadata: SessionStateSaveMetadata, projectRoot: string): Promise<void>;
+export declare function updateSessionMetadata(sessionId: string, patch: SessionMetadataPatch, projectRoot: string): Promise<SessionMetadata | null>;
+export declare function persistTaskSummary(sessionId: string, projectRoot: string, summary: string, generatedAtTurn: number): Promise<void>;

package/dist/types/runtime/session/session-paths.d.ts

@@ -0,0 +1,9 @@
+export declare const TRANSCRIPT_FILE = "transcript.jsonl";
+export declare const METADATA_FILE = "metadata.json";
+export declare const LEGACY_STATE_FILE = "state.json";
+export declare function sanitizeSessionId(sessionId: string): string;
+export declare function getSessionsRoot(projectRoot: string): string;
+export declare function getSessionDir(sessionId: string, projectRoot: string): string;
+export declare function getMetadataPath(sessionId: string, projectRoot: string): string;
+export declare function getTranscriptPath(sessionId: string, projectRoot: string): string;
+export declare function findExistingSessionDir(sessionId: string, projectRoot: string): string | undefined;

package/dist/types/runtime/session/session-persistence.d.ts

@@ -1,161 +1,16 @@
 /**
- * Session Persistence — CC sessionRestore.ts + conversationRecovery.ts parity.
+ * Compatibility facade for session persistence.
  *
- * Enables conversation resume by persisting:
- *   1. Message transcript (JSONL-based, append-only)
- *   2. Session metadata (flat JSON, atomic write)
- *
- * Storage layout (ALL data lives under project workspace, NEVER global):
- *   <project>/.qlogicagent/sessions/<session-id>/
- *     transcript.jsonl   — append-only message log
- *     metadata.json      — flat session metadata + usage stats
- *
- * Resume flow (CC processResumedConversation parity):
- *   1. loadSessionForResume(sessionId) → messages + metadata
- *   2. Restore usage state into SessionState
- *   3. Feed messages as initial context to agent
- */
-import type { ChatMessage } from "../../protocol/wire/index.js";
-import type { TokenUsage } from "../../agent/types.js";
-import type { SessionUsageSnapshot } from "./session-state.js";
-export interface SessionMetadata {
-    sessionId: string;
-    projectId: string;
-    createdAt: string;
-    lastActiveAt: string;
-    model?: string;
-    /** Agent that owns this session (e.g. "qlogicagent", "codex"). Locked on the first message so
-     * re-entering the session always resumes with the same agent, never falling back to default. */
-    agentId?: string;
-    cwd?: string;
-    turnCount: number;
-    messageCount: number;
-    title?: string;
-    taskSummary?: string;
-    taskSummaryGeneratedAt?: number;
-    pinnedAt?: string;
-    archivedAt?: string;
-    sealedAt?: string;
-    previousSessionId?: string;
-    carryoverSummary?: string;
-    type?: "personal" | "group";
-    ownerPlatform?: string;
-    ownerId?: string;
-    groupKey?: string;
-    groupName?: string;
-    groupPlatform?: string;
-    assistant?: {
-        id: string;
-        name: string;
-        source: "builtin" | "user" | "plugin";
-        contextHash: string;
-        enabledSkills: string[];
-        disabledBuiltinSkills: string[];
-    };
-    totalInputTokens?: number;
-    totalOutputTokens?: number;
-}
-export interface PersistedSession {
-    metadata: SessionMetadata;
-    messages: PersistedChatMessage[];
-}
-export interface MessageDisplayMetadata {
-    messageId?: string;
-    platform?: string;
-    sourceChannel?: string;
-    source?: string;
-    chatId?: string;
-    userId?: string;
-    userName?: string;
-}
-export interface PersistedChatMessage extends ChatMessage {
-    timestamp?: string;
-    turnId?: string;
-    usage?: TokenUsage;
-    displayMetadata?: MessageDisplayMetadata;
-}
-export interface SessionListEntry {
-    sessionId: string;
-    title?: string;
-    lastActiveAt: string;
-    messageCount: number;
-    model?: string;
-    agentId?: string;
-    pinnedAt?: string;
-    archivedAt?: string;
-    sealedAt?: string;
-    projectId: string;
-    type?: "personal" | "group";
-    createdAt: string;
-    groupKey?: string;
-    previousSessionId?: string;
-    carryoverSummary?: string | null;
-}
-/**
- * Load session metadata only (lightweight — no transcript loading).
- * Returns null if session doesn't exist or metadata is unreadable.
- */
-export declare function getSessionMetadata(sessionId: string, projectRoot: string): SessionMetadata | null;
-/**
- * Append a message to the session transcript.
- * Creates the session directory if it doesn't exist.
- * When turnId is provided, it acts as a per-turn boundary marker enabling
- * reconciliation with Gateway's token_usage records.
- *
- * Robustness: catches disk-full and I/O errors without crashing the agent.
- * Returns false if the write fails.
- */
-export declare function appendMessage(sessionId: string, message: ChatMessage, projectRoot: string, turnId?: string, metadata?: {
-    usage?: TokenUsage;
-    displayMetadata?: MessageDisplayMetadata;
-}): Promise<boolean>;
-/**
- * Save session metadata + usage stats atomically (flat structure).
- */
-export declare function saveSessionState(sessionId: string, usageSnapshot: SessionUsageSnapshot, metadata: Partial<SessionMetadata>, projectRoot: string): Promise<void>;
-/**
- * Update specific metadata fields of a session without touching cost data.
- * Used by session CRUD RPC (rename, pin, archive, move-to-project).
- *
- * Concurrency-bounded via withSessionWriteLimit (see above) so a burst of parallel
- * updates cannot exhaust the fs thread pool and wedge the RPC channel.
- */
-export declare function updateSessionMetadata(sessionId: string, patch: Partial<Record<keyof SessionMetadata, SessionMetadata[keyof SessionMetadata] | null>>, projectRoot: string): Promise<SessionMetadata | null>;
-/**
- * Load a persisted session for resume — CC loadConversationForResume parity.
- *
- * Returns null if the session doesn't exist or is corrupted.
- */
-export declare function loadSessionForResume(sessionId: string, projectRoot: string, options?: {
-    includeDisplayMetadata?: boolean;
-}): Promise<PersistedSession | null>;
-/**
- * List available sessions for resume CC ResumeConversation picker.
- * Returns most-recent-first, up to `limit` entries.
- */
-export declare function listSessions(limit: number | undefined, projectRoot: string): Promise<SessionListEntry[]>;
-/**
- * Delete a session (cleanup).
- */
-export declare function deleteSession(sessionId: string, projectRoot: string): Promise<void>;
-/**
- * Prune old sessions beyond MAX_SESSIONS limit.
- * Deletes oldest sessions first.
- */
-export declare function pruneOldSessions(projectRoot: string): Promise<number>;
-export interface TaskSummaryDeps {
-    transport: import("../ports/index.js").LLMTransport;
-    apiKey: string;
-    model: string;
-}
-/**
- * Check if a task summary should be generated for this session.
- * Triggers after TASK_SUMMARY_TURN_THRESHOLD turns, then every REGEN_INTERVAL turns.
- */
-export declare function shouldGenerateTaskSummary(metadata: SessionMetadata): boolean;
-/**
- * Generate a concise session title from the user's first message.
- * Lightweight LLM call — one-shot, no tool loop.
- */
-export declare function generateSessionTitle(userMessage: string, deps: TaskSummaryDeps): Promise<string | null>;
-export declare function maybeGenerateTaskSummary(sessionId: string, metadata: SessionMetadata, recentMessages: ChatMessage[], deps: TaskSummaryDeps, projectRoot: string): Promise<string | null>;
+ * The implementation lives in focused modules:
+ * - session-transcript-store.ts: append-only transcript JSONL
+ * - session-metadata-store.ts: metadata schema, migration, atomic writes
+ * - session-resume.ts: resume assembly
+ * - session-catalog.ts: list/delete/prune
+ * - session-summary.ts: title and task-summary generation
+ */
+export { appendMessage } from "./session-transcript-store.js";
+export { getSessionMetadata, readSessionMetadata, saveSessionState, updateSessionMetadata, } from "./session-metadata-store.js";
+export { loadSessionForResume } from "./session-resume.js";
+export { deleteSession, listSessions, pruneOldSessions } from "./session-catalog.js";
+export { generateSessionTitle, maybeGenerateTaskSummary, shouldGenerateTaskSummary, } from "./session-summary.js";
+export { SESSION_SCHEMA_VERSION, type MessageDisplayMetadata, type PersistedChatMessage, type PersistedSession, type SessionListEntry, type SessionMetadata, type TaskSummaryDeps, } from "./session-types.js";

package/dist/types/runtime/session/session-resume.d.ts

@@ -0,0 +1,4 @@
+import type { PersistedSession } from "./session-types.js";
+export declare function loadSessionForResume(sessionId: string, projectRoot: string, options?: {
+    includeDisplayMetadata?: boolean;
+}): Promise<PersistedSession | null>;

package/dist/types/runtime/session/session-schema.d.ts

@@ -0,0 +1,10 @@
+import type { SessionMetadata } from "./session-types.js";
+export interface SessionMetadataDefaults {
+    projectId?: string;
+    createdAt?: string;
+    lastActiveAt?: string;
+    turnCount?: number;
+    messageCount?: number;
+}
+export declare function normalizeSessionMetadata(sessionId: string, input: Partial<SessionMetadata> | null | undefined, defaults?: SessionMetadataDefaults): SessionMetadata;
+export declare function metadataNeedsMigration(input: Partial<SessionMetadata> | null | undefined): boolean;

package/dist/types/runtime/session/session-summary.d.ts

@@ -0,0 +1,5 @@
+import type { ChatMessage } from "../../protocol/wire/index.js";
+import type { SessionMetadata, TaskSummaryDeps } from "./session-types.js";
+export declare function shouldGenerateTaskSummary(metadata: SessionMetadata): boolean;
+export declare function generateSessionTitle(userMessage: string, deps: TaskSummaryDeps): Promise<string | null>;
+export declare function maybeGenerateTaskSummary(sessionId: string, metadata: SessionMetadata, recentMessages: ChatMessage[], deps: TaskSummaryDeps, projectRoot: string): Promise<string | null>;

package/dist/types/runtime/session/session-transcript-store.d.ts

@@ -0,0 +1,13 @@
+import type { ChatMessage } from "../../protocol/wire/index.js";
+import type { MessageDisplayMetadata, PersistedChatMessage, TokenUsage } from "./session-types.js";
+export interface TranscriptLoadResult {
+    messages: PersistedChatMessage[];
+    corruptLines: number;
+}
+export declare function appendMessage(sessionId: string, message: ChatMessage, projectRoot: string, turnId?: string, metadata?: {
+    usage?: TokenUsage;
+    displayMetadata?: MessageDisplayMetadata;
+}): Promise<boolean>;
+export declare function loadTranscript(sessionId: string, projectRoot: string, options?: {
+    includeDisplayMetadata?: boolean;
+}): Promise<TranscriptLoadResult | null>;