qlogicagent 2.24.1 → 2.24.2

package/dist/types/runtime/ports/memory-recall-source.d.ts

@@ -1,14 +0,0 @@
-export interface MemoryRecallSource {
-    getRootPath(): string;
-    searchLocal(query: string): Promise<Array<{
-        file: string;
-        snippet: string;
-        score: number;
-        mtimeMs: number;
-    }>>;
-    readFile(name: string): Promise<{
-        ok: boolean;
-        content?: string;
-        message: string;
-    }>;
-}

package/dist/types/runtime/ports/memory-writer.d.ts

@@ -1,70 +0,0 @@
-import type { HostMemoryExtractionTurnInput, HostPendingMemoryExtractionTurn, MemoryClaimRelation } from "../../host-contract/index.js";
-export interface MemoryWriteMetadata {
-    source?: string;
-    category?: string;
-    importance?: number;
-    eventDate?: string;
-    sessionId?: string;
-    [key: string]: unknown;
-}
-export interface StructuredMemoryClaim {
-    scope: "global" | "project" | "session";
-    entity: string;
-    predicate: string;
-    relation: MemoryClaimRelation;
-    value: Record<string, unknown>;
-}
-export interface MemoryWriterExtractionItem {
-    text: string;
-    category?: string;
-    importance?: number;
-    confidence?: number;
-    event_date?: string;
-    tags?: string[];
-    claim?: StructuredMemoryClaim;
-    evidence?: {
-        kind: string;
-        refs: string[];
-        idempotencyKey: string;
-        quote?: string;
-    };
-    /** The source turn explicitly retracts or replaces an earlier decision. */
-    correction?: boolean;
-}
-export interface MemoryWriter {
-    ingestExtracted?(items: MemoryWriterExtractionItem[], userId: string, metadata?: MemoryWriteMetadata): Promise<{
-        memoriesAdded?: number;
-        items?: Array<{
-            outcome: "created" | "merged" | "conflicted" | "pending" | "rejected";
-        }>;
-    }>;
-    proposeExtracted?(items: MemoryWriterExtractionItem[], userId: string, metadata?: MemoryWriteMetadata): Promise<{
-        proposalsAdded?: number;
-    }>;
-    findRelatedEvents?(text: string, userId: string): Promise<Array<{
-        id: string;
-    }>>;
-    feedback?(ids: string[], signal: "useful" | "irrelevant" | "outdated" | "wrong", context?: {
-        sessionId?: string;
-        silent?: boolean;
-    }): Promise<unknown>;
-}
-export interface MemoryExtractionQueue {
-    enqueueExtractionTurn(input: HostMemoryExtractionTurnInput, userId: string): Promise<{
-        jobId: string;
-        created: boolean;
-    }>;
-    claimPendingExtractionTurns(userId: string, workerId: string, options?: {
-        limit?: number;
-        leaseMs?: number;
-    }): Promise<HostPendingMemoryExtractionTurn[]>;
-    completeExtractionTurn(jobId: string, userId: string, workerId: string): Promise<{
-        deleted: boolean;
-    }>;
-    releaseExtractionTurn(jobId: string, userId: string, workerId: string): Promise<{
-        released: boolean;
-    }>;
-    recordExtractionTurnFailure(jobId: string, userId: string, workerId: string, error: string): Promise<{
-        updated: boolean;
-    }>;
-}

package/dist/types/runtime/ports/project-memory-store.d.ts

@@ -1,49 +0,0 @@
-export interface ProjectMemoryFileInfo {
-    name: string;
-    size: number;
-    modifiedAt: string;
-    preview?: string;
-}
-export interface ProjectMemoryResult {
-    ok: boolean;
-    message: string;
-    file?: string;
-    indexUsage?: string;
-}
-export interface ProjectMemoryStore {
-    getRootPath(): string;
-    ensureInitialized(): void | Promise<void>;
-    /** Re-read the Host-owned INDEX snapshot before a later turn assembles its prompt. */
-    refreshIndex(): Promise<void>;
-    getIndexForPrompt(): string;
-    getIndexRaw(): string;
-    getIndexUsage(): {
-        chars: number;
-        lines: number;
-        percent: number;
-    };
-    addToIndex(content: string): Promise<ProjectMemoryResult>;
-    replaceInIndex(oldText: string, newText: string): Promise<ProjectMemoryResult>;
-    removeFromIndex(oldText: string): Promise<ProjectMemoryResult>;
-    createFile(name: string, content: string): Promise<ProjectMemoryResult>;
-    writeFile(name: string, content: string): Promise<ProjectMemoryResult>;
-    readFile(name: string): Promise<{
-        ok: boolean;
-        content?: string;
-        message: string;
-    }>;
-    deleteFile(name: string): Promise<ProjectMemoryResult>;
-    listFiles(): Promise<ProjectMemoryFileInfo[]>;
-    searchLocal(query: string): Promise<Array<{
-        file: string;
-        snippet: string;
-        score: number;
-        mtimeMs: number;
-    }>>;
-}
-export interface ProjectMemoryStoreFactory {
-    getRootPath(projectRoot: string): string;
-    create(projectRoot: string): ProjectMemoryStore;
-    /** Read the user-level global memory INDEX for prompt injection (null when absent/empty). */
-    readUserIndexForPrompt(): string | null;
-}

package/dist/types/runtime/prompt/host-skill-directory.d.ts

@@ -1,16 +0,0 @@
-import type { ToolDefinition } from "../../agent/types.js";
-export type HostSkillDirectoryProjection = {
-    tools: ToolDefinition[];
-    prompt?: undefined;
-    revision?: undefined;
-} | {
-    tools: ToolDefinition[];
-    prompt: string;
-    revision: string;
-};
-/**
- * Promote the Host's standard MCP Skill directory metadata into first-class model context.
- * The Host remains the catalog authority and the model remains the selector; this adapter
- * only prevents a large directory from being buried inside one generic tool description.
- */
-export declare function projectHostSkillDirectory(tools: readonly ToolDefinition[]): HostSkillDirectoryProjection;

package/dist/types/runtime/session/group-session-split.d.ts

@@ -1,38 +0,0 @@
-/**
- * Group Session Auto-Split — detects idle group sessions and creates successor sessions.
- *
- * When a group chat message arrives and the last session activity was > N hours ago,
- * the old session is sealed and a new session is created with:
- *   - previousSessionId linking to the predecessor
- *   - carryoverSummary (from predecessor's taskSummary or last messages)
- *   - Same groupKey, groupName, groupPlatform, projectId
- *
- * This prevents unbounded context growth in long-lived group chats.
- */
-import { type SessionMetadata } from "./session-persistence.js";
-export interface GroupSplitResult {
-    /** Whether a split occurred */
-    split: boolean;
-    /** The session ID to use for the current turn (new or existing) */
-    activeSessionId: string;
-    /** If split, the sealed predecessor session ID */
-    sealedSessionId?: string;
-}
-/**
- * Check whether a group session should be auto-split due to idle timeout.
- * If yes, seal the old session and create a new successor.
- *
- * @param currentSession - The existing group session metadata
- * @param projectRoot - The project workspace directory
- * @returns Split result with the session ID to use
- */
-export declare function maybeAutoSplitGroupSession(currentSession: SessionMetadata, projectRoot: string): Promise<GroupSplitResult>;
-/**
- * Check whether a group session has exceeded MAX_TURNS hard limit.
- * Called AFTER turn.end — soft-splits without interrupting the current turn.
- *
- * @param currentSession - The session that just finished a turn
- * @param projectRoot - The project workspace directory
- * @returns Split result (new session ready for next message, or no-op)
- */
-export declare function maybeHardLimitSplit(currentSession: SessionMetadata, projectRoot: string): Promise<GroupSplitResult>;

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

@@ -1,47 +0,0 @@
-/**
- * Inbound Upload Persistence (decision A) — the agent owns its companion data, so user-uploaded
- * attachments are persisted by the AGENT (not the gateway) into the session's projectData uploads
- * dir, where they become part of the session record and are cleaned up on session/project delete.
- *
- * The gateway puts an inbound attachment in its short-lived transport cache and hands the agent a
- * `http://127.0.0.1:<port>/media/<id>` URL. We fetch those bytes once, write them under
- * projectData/<projectId>/uploads/<sessionId>/, and rewrite the reference to a gateway local-media
- * proxy URL pointing at the persisted file (same `/api/media/local?src=file://…` shape the gateway
- * used before — provider-core still sees a 127.0.0.1 local URL for cloud upload, and the frontend
- * still GETs it). Any failure degrades gracefully to the original URL (the turn still works off the
- * transport cache; only long-term persistence is skipped).
- */
-import type { ChatMessage } from "../../protocol/wire/index.js";
-export interface PersistedUpload {
-    url: string;
-    localPath?: string;
-    /**
-     * Whether the bytes were actually written to durable storage. `true` on success, `false` when a
-     * transport upload was found but persisting it FAILED (fetch error / non-ok / write error) — the
-     * returned `url` is then the short-lived transport URL that dies with the turn. `undefined` means
-     * the input was not a transport upload to begin with (already-persisted / remote / file://), which
-     * is not a failure. Honesty over silence: callers use `false` to warn instead of pretending it saved.
-     */
-    persisted?: boolean;
-}
-/** 同 persistInboundUploadUrl，但返回持久化后的本地绝对路径（供模型直接 read/exec）。 */
-export declare function persistInboundUploadUrlDetailed(url: string, projectId: string, sessionId: string): Promise<PersistedUpload>;
-/**
- * Persist a single inbound upload URL to projectData uploads and return the rewritten proxy URL.
- * Non-transport URLs (already-persisted, remote, file://) and any failure return the input unchanged.
- */
-export declare function persistInboundUploadUrl(url: string, projectId: string, sessionId: string): Promise<string>;
-/**
- * Persist + rewrite the inbound uploads on the LAST user message of a turn (the new message;
- * resumed history already carries persisted local URLs). Mutates and returns the message array.
- *
- * Failure parity with the document path (appendLocalDocumentNotesToText): when a media upload
- * could NOT be persisted, the message gets a model-visible note instead of silently keeping a
- * transport URL that expires with the turn — the model must know the reference is short-lived.
- */
-export declare function persistInboundUploadsForTurn(messages: ChatMessage[], projectId: string | undefined, sessionId: string | undefined): Promise<ChatMessage[]>;
-/**
- * 在任意模型可见文本中查找文档类传输 URL，落盘并追加本地路径注记。
- * 供 turn-handler 的 attachmentModelContext 使用；持久会话正文不包含该清单。
- */
-export declare function appendLocalDocumentNotesToText(text: string, projectId: string | undefined, sessionId: string | undefined): Promise<string>;

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

@@ -1,12 +0,0 @@
-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>;
-/**
- * ⚠️ Destructive cascade with NO user-visible confirmation: every pruned session goes through
- * deleteSession, which permanently removes its transcript + metadata + checkpoints + uploads.
- * Currently has NO caller. If you wire this up, the deletions must be surfaced to the user
- * (count + which sessions) — silently reaping MAX_SESSIONS-overflow would be exactly the kind of
- * invisible data loss docs/judgment-over-mechanism.md forbids. Also note listSessions skips
- * unreadable-metadata sessions, so a prune pass under fs errors could mis-rank what "oldest" is.
- */
-export declare function pruneOldSessions(projectRoot: string): Promise<number>;

package/dist/types/runtime/session/session-deletion-guard.d.ts

@@ -1,4 +0,0 @@
-export declare function markSessionDeleted(sessionId: string, projectRoot: string): Promise<void>;
-export declare function isSessionDeleted(sessionId: string, projectRoot: string): Promise<boolean>;
-export declare function isSessionDeletedSync(sessionId: string, projectRoot: string): boolean;
-export declare function listDeletedSessionIds(projectRoot: string): Promise<string[]>;

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

@@ -1,26 +0,0 @@
-/**
- * SessionLocator — resolves session storage paths from projectId.
- *
- * Every session operation uses this locator to determine the correct
- * filesystem path based on the session's owning projectId.
- * When projectId is missing, falls back to scanning all projects.
- */
-export declare class SessionLocator {
-    /** Get sessions root directory for a given projectId. */
-    getSessionsRoot(projectId: string): string;
-    /** Get the workspace dir for a project. */
-    getProjectWorkspaceDir(projectId: string): string;
-    /** Get the session directory path for a given projectId + sessionId. */
-    getSessionDir(projectId: string, sessionId: string): string;
-    /**
-     * Resolve the workspaceDir for a session given its projectId.
-     * If projectId is not provided, scans all projects for the session directory.
-     */
-    resolveWorkspaceDir(sessionId: string, projectId?: string): string;
-    /** Get the active project's workspace dir (for new session creation when no projectId specified). */
-    getActiveProjectWorkspaceDir(): string;
-    /** Get the active project's ID. */
-    getActiveProjectId(): string;
-    /** Get the default project's ID for external personal channel sessions. */
-    getDefaultProjectId(): string;
-}

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

@@ -1,8 +0,0 @@
-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

@@ -1,8 +0,0 @@
-export declare const TRANSCRIPT_FILE = "transcript.jsonl";
-export declare const METADATA_FILE = "metadata.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-permission-store.d.ts

@@ -1,6 +0,0 @@
-export interface SessionPermissionStorePathOptions {
-    /** Test-only path override; production always uses the centralized session directory. */
-    sessionDir?: string;
-}
-export declare function loadSessionAllowedDirectories(sessionId: string, projectRoot: string, options?: SessionPermissionStorePathOptions): string[];
-export declare function appendSessionAllowedDirectory(sessionId: string, projectRoot: string, pathPrefix: string, options?: SessionPermissionStorePathOptions): Promise<void>;

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

@@ -1,37 +0,0 @@
-/**
- * Session persistence authority facade.
- *
- * Every durable read/write goes through HostSessionClient. Standalone/local persistence is not a
- * supported runtime mode after the S3 state-inversion cut.
- */
-import type { ChatMessage } from "../../protocol/wire/index.js";
-import type { HostSessionClient } from "../../transport/host-session-client.js";
-import type { AppendMessageOutcome } from "./session-transcript-store.js";
-import { getSessionMetadata, readSessionMetadata } from "./session-metadata-store.js";
-import type { MessageDisplayMetadata, PersistedSession, SessionMetadataPatch, SessionStateSaveMetadata, SessionUsageSnapshot, TokenUsage } from "./session-types.js";
-export declare class SessionAppendDrainTimeoutError extends Error {
-    constructor(sessionId: string, timeoutMs: number);
-}
-export declare function configureHostSessionPersistence(resolver: () => HostSessionClient | undefined): void;
-export declare function isHostSessionPersistenceActive(): boolean;
-export declare function requestHostGroupSplit(sessionId: string, operationId: string, reason: "idle" | "turn-limit", cas?: {
-    expectedLastActiveAt?: string;
-    expectedTurnCount?: number;
-}): Promise<{
-    status: "updated" | "duplicate" | "session-deleted";
-    nextSessionId?: string;
-} | undefined>;
-export declare function appendMessage(sessionId: string, message: ChatMessage, projectRoot: string, turnId?: string, metadata?: {
-    usage?: TokenUsage;
-    displayMetadata?: MessageDisplayMetadata;
-}): Promise<AppendMessageOutcome>;
-export declare function waitForSessionPersistenceAppends(sessionId: string, projectRoot: string, timeoutMs?: number): Promise<void>;
-export declare function loadSessionForResume(sessionId: string, projectRoot: string, options?: {
-    includeDisplayMetadata?: boolean;
-}): Promise<PersistedSession | null>;
-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<import("./session-types.js").SessionMetadata | null>;
-export { getSessionMetadata, readSessionMetadata };
-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-recovery.d.ts

@@ -1,62 +0,0 @@
-export declare function isSideEffectTool(name: string): boolean;
-/** 取最后一条 user 消息的纯文本前若干字，供崩溃恢复 UI 提示（多模态/空则无预览）。 */
-export declare function extractLastUserPreview(messages: ReadonlyArray<{
-    role: string;
-    content: unknown;
-}>): string | undefined;
-/**
- * turn 开始：写 in-flight 标记。fire-and-forget 语义 —— 绝不阻塞或抛错打断 turn。
- * projectRoot 未解析（无项目上下文）时静默跳过。
- */
-export declare function markTurnInflight(sessionId: string, projectRoot: string | undefined, turnId: string, messages: ReadonlyArray<{
-    role: string;
-    content: unknown;
-}>): Promise<void>;
-/**
- * 首个副作用工具执行时置位 hadSideEffectTool（仅首次，避免每次工具调用写盘）。
- * 安全档不据此自动续，仅用于 L4 的"继续可能重复"提示 + 为智能档铺路。
- */
-export declare function markInflightSideEffect(sessionId: string, projectRoot: string | undefined): Promise<void>;
-/**
- * turn 结束（finally 到达 = 有始有终，哪怕失败/用户中断）：清标记 + 中断计数归零。
- * finally 未到达（进程被硬杀/崩溃）→ 标记残留，由 L3 启动扫描接住。
- */
-export declare function clearTurnInflight(sessionId: string, projectRoot: string | undefined): Promise<void>;
-interface SessionMetaLocation {
-    sessionId: string;
-    metadataPath: string;
-}
-/**
- * 遍历当前 owner profile 下所有 project 的所有 session 的 metadata.json 绝对路径。
- * 直接扫 projectData/<projectId>/sessions/<sessionId>/ —— 用绝对路径，绕开 projectRoot↔projectId
- * 解析歧义（未注册 project 的残留 session 也覆盖到）。L2 清标记 + L3 启动扫描共用。
- */
-export declare function enumerateSessionMetadataFiles(): Promise<SessionMetaLocation[]>;
-/**
- * L2 优雅关闭：清所有 session 残留的 in-flight 标记 + 中断计数归零。
- * 优雅关闭 == 主动清标记 == hermes 的 .clean_shutdown 语义（更简、单一事实源）。
- * 直接原子改写 metadata.json（不经 updateSessionMetadata 的 projectRoot 解析）。返回清理数。
- */
-export declare function clearAllInflightMarkers(): Promise<number>;
-/** 读同目录 transcript.jsonl 最后一条 assistant 消息的 ts（毫秒）。无则 null。 */
-declare function readLastAssistantTs(metadataPath: string): Promise<number | null>;
-export interface CrashedTurnInfo {
-    sessionId: string;
-    turnId: string;
-    startedAt: string;
-    lastUserPreview?: string;
-    hadSideEffectTool: boolean;
-}
-/**
- * L3 启动扫描：找崩溃残留的 in-flight 标记，处理双校验/熔断，返回待恢复列表。
- * agent 每次 initialize 调用 —— gateway 重启 or agent respawn 都覆盖（标记本身是事实源）。
- *
- * - 双校验（借鉴 codex #12382，spec §7）：transcript 最后一条 assistant ts ≥ marker.startedAt →
- *   该轮其实已完成、只是清标记那步没落盘 → 静默清、不误报。
- * - 熔断：连续崩溃中断达 MAX_INTERRUPTED_RECOVERY → 放弃（清标记 + recoveryAbandonedAt + fail-loud）。
- * - 否则：保留标记 + 递增中断计数，收进待恢复列表（交给 UI 让用户手动续）。
- */
-export declare function scanForCrashedTurns(): Promise<CrashedTurnInfo[]>;
-/** Test-only escape hatch: readLastAssistantTs is otherwise module-private (Cut 5.2). */
-export declare const __test_readLastAssistantTs: typeof readLastAssistantTs;
-export {};

package/dist/types/runtime/session/session-resource-key.d.ts

@@ -1,28 +0,0 @@
-/**
- * Single source of truth for session resource keys (canonical identity) and the derived
- * resident-pool / delegation keys. Forbids scattered ad-hoc string concatenation of session keys
- * (invariant I2, docs/session-identity-alignment-spec.md). Leaf module — imports nothing.
- */
-/** Canonical session identity: our-minted, stable-from-creation id + its owning agent + project. */
-export interface SessionResource {
-    /** Owning agent kind: own ("qlogicagent") / codex / claude / … (= SessionMetadata.agentId). */
-    agentId: string;
-    /** Owning project id (path-derived / opaque; not minted here). */
-    projectId: string;
-    /** Our-minted session id, stable from creation; native identity is held by Gateway Host state. */
-    canonicalSessionId: string;
-}
-/** Serialize the canonical session resource to its single opaque key string. */
-export declare function buildSessionResourceKey(r: SessionResource): string;
-/** Parse a key produced by {@link buildSessionResourceKey}; throws on a malformed key. */
-export declare function parseSessionResourceKey(key: string): SessionResource;
-/**
- * Resident external-agent pool key: same agent + workspace + session ⇒ same resident process.
- * `sessionId` may be a canonical id, the WARM_SESSION token, or undefined (defaults to "default").
- * Byte-identical to the historical inline pool key it replaces.
- */
-export declare function buildAgentPoolKey(agentId: string, cwd: string, sessionId?: string): string;
-/** Prefix matching every pool key for `agentId` (agent-scoped eviction, exact id-boundary). */
-export declare function agentPoolKeyPrefix(agentId: string): string;
-/** @mention delegation serialization key for one (agent × conversation) pair. */
-export declare function buildConvKey(agentId: string, canonicalSessionId: string): string;

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

@@ -1,9 +0,0 @@
-import type { PersistedSession } from "./session-types.js";
-/** Coded error: the session's project root cannot be read at all (deleted dir, unplugged drive,
- *  permissions). Distinguishable from the `null` return, which strictly means "this session has no
- *  persisted transcript" — conflating the two made every caller silently start a NEW empty session
- *  on a read failure (docs/judgment-over-mechanism.md: "read failed" ≠ "does not exist"). */
-export declare const PROJECT_ROOT_UNAVAILABLE = "PROJECT_ROOT_UNAVAILABLE";
-export declare function loadSessionForResume(sessionId: string, projectRoot: string, options?: {
-    includeDisplayMetadata?: boolean;
-}): Promise<PersistedSession | null>;

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

@@ -1,10 +0,0 @@
-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

@@ -1,7 +0,0 @@
-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, persist?: (summary: string, generatedAtTurn: number) => Promise<void>): Promise<string | null>;
-declare function buildDigestContext(recentMessages: ChatMessage[]): string;
-export { buildDigestContext as __test_buildDigestContext };

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

@@ -1,9 +0,0 @@
-export declare function hasLikelyMojibake(text: string): boolean;
-export declare function cleanSessionTitleCandidate(title: string | undefined | null, options?: {
-    maxLength?: number;
-}): string | undefined;
-export declare function titleFromPromptFallback(prompt: string, fallback: string, options?: {
-    maxLength?: number;
-    ellipsis?: string;
-}): string;
-export declare function deterministicSessionTitleForPrompt(prompt: string): string | null;

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

@@ -1,30 +0,0 @@
-import type { ChatMessage } from "../../protocol/wire/index.js";
-import type { MessageDisplayMetadata, PersistedChatMessage, TokenUsage } from "./session-types.js";
-export interface TranscriptLoadResult {
-    messages: PersistedChatMessage[];
-    corruptLines: number;
-    /** 1-based line numbers that failed to parse (bounded to the first MAX_REPORTED_CORRUPT_LINES). */
-    corruptLineNumbers: number[];
-}
-/**
- * Outcome of an appendMessage call. "skipped-deleted" (the session was deleted — a LEGAL late-write
- * no-op) is deliberately distinguishable from "failed" (the write itself failed — the message is
- * LOST and callers must leave a trace / surface it), per docs/judgment-over-mechanism.md:
- * "does not exist" and "write failed" must never be conflated into one silent boolean.
- */
-export type AppendMessageOutcome = "appended" | "skipped-deleted" | "failed";
-export declare function appendMessage(sessionId: string, message: ChatMessage, projectRoot: string, turnId?: string, metadata?: {
-    usage?: TokenUsage;
-    displayMetadata?: MessageDisplayMetadata;
-}): Promise<AppendMessageOutcome>;
-/**
- * Public drain: await all queued transcript appends for one session to hit disk. Wraps the
- * composite-key `waitForTranscriptAppends` (the queue is keyed by projectRoot+sessionId, not
- * sessionId alone). Call before a process kill / cold-restart test — reading the file does NOT
- * flush a same-process fire-and-forget tail (Cut 8).
- */
-export declare function waitForSessionTranscriptAppends(sessionId: string, projectRoot: string): Promise<void>;
-export declare function countTranscriptMessages(sessionId: string, projectRoot: string): Promise<number | null>;
-export declare function loadTranscript(sessionId: string, projectRoot: string, options?: {
-    includeDisplayMetadata?: boolean;
-}): Promise<TranscriptLoadResult | null>;

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

@@ -1,113 +0,0 @@
-import type { ChatMessage } from "../../protocol/wire/index.js";
-import type { TokenUsage } from "../../agent/types.js";
-import type { SessionUsageSnapshot } from "./session-state.js";
-export declare const SESSION_SCHEMA_VERSION = 1;
-/** 熔断阈值：连续崩溃中断达此次数后放弃自动恢复（对齐 hermes stuck-loop 的 3）。 */
-export declare const MAX_INTERRUPTED_RECOVERY = 3;
-/**
- * 在飞轮次标记。turn 开始写入 SessionMetadata.inflightTurn，正常完成/用户主动中断时清除。
- * 崩溃/非优雅退出时它残留在磁盘上 —— 这就是"上次这轮没跑完"的显式信号
- * （对照 codex CLI 靠时间戳隐式推断、坏了要手动裁 JSONL，见 docs/session-lifecycle-recovery-spec.md §7）。
- */
-export interface InflightTurnMarker {
-    turnId: string;
-    /** turn 开始时间（ISO）。启动扫描用它与 transcript 最后一条 assistant 消息的 ts 做双校验。 */
-    startedAt: string;
-    /** 最后一条 user 消息前若干字（UI 提示用，不含敏感全文）。 */
-    lastUserPreview?: string;
-    /** 该轮是否已执行过有副作用的工具（写文件/发消息/外部 API）。安全档不据此自动续，仅用于 UI"可能重复"提示 + 为智能档铺路。 */
-    hadSideEffectTool?: boolean;
-}
-export interface SessionMetadata {
-    schemaVersion?: number;
-    sessionId: string;
-    projectId: string;
-    createdAt: string;
-    lastActiveAt: string;
-    model?: string;
-    /** Agent that owns this session (e.g. "qlogicagent", "codex"). */
-    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;
-    totalInputTokens?: number;
-    totalOutputTokens?: number;
-    /** 在飞轮次标记：存在即"上次这轮没跑完"（崩溃残留）。turn 开始写、正常完成/中断清。 */
-    inflightTurn?: InflightTurnMarker;
-    /** 连续崩溃中断计数；turn 正常完成清零；达 MAX_INTERRUPTED_RECOVERY 熔断放弃恢复。 */
-    interruptedTurnCount?: number;
-    /** 达熔断阈值放弃恢复的时间戳（UI 显示"多次中断已停止自动恢复"）。 */
-    recoveryAbandonedAt?: string;
-}
-export interface PersistedSession {
-    metadata: SessionMetadata;
-    messages: PersistedChatMessage[];
-    /**
-     * Count of transcript lines that failed to parse and were skipped on load. Surfaced so the UI can
-     * tell the user "N 条消息无法读取" instead of silently resuming a conversation with holes in it.
-     * Omitted/0 for a clean transcript.
-     */
-    corruptLines?: number;
-}
-export interface MessageDisplayMetadata {
-    messageId?: string;
-    platform?: string;
-    sourceChannel?: string;
-    source?: string;
-    chatId?: string;
-    userId?: string;
-    userName?: string;
-    /**
-     * Presentation kind for a persisted message whose ROLE alone doesn't capture how
-     * the UI should render it. Currently: "mid_turn_guidance" — a user-authored message
-     * injected into a running turn (运行中引导). It stays role:"user" (the model must see
-     * it as the user's words), but the desktop renders it as an agent-side "收到引导"
-     * receipt line rather than a standalone user bubble.
-     */
-    kind?: 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;
-}
-export interface TaskSummaryDeps {
-    transport: import("../ports/index.js").LLMTransport;
-    apiKey: string;
-    model: string;
-}
-export type SessionMetadataPatch = Partial<Record<keyof SessionMetadata, SessionMetadata[keyof SessionMetadata] | null>>;
-export type SessionStateSaveMetadata = Partial<SessionMetadata>;
-export type { ChatMessage, SessionUsageSnapshot, TokenUsage };

package/dist/types/runtime/session/session-write-queue.d.ts

@@ -1,3 +0,0 @@
-export declare function withSessionWriteLimit<T>(fn: () => Promise<T>): Promise<T>;
-export declare function withTranscriptAppendOrder<T>(sessionKey: string, fn: () => Promise<T>): Promise<T>;
-export declare function waitForTranscriptAppends(sessionKey: string): Promise<void>;