qlogicagent 2.24.1 → 2.24.2

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

@@ -1,6 +1,27 @@
-/** Thread/Turn containers and RPC shapes. The Item envelope itself is owned by Host contract. */
-import type { ThreadItem } from "../../host-contract/index.js";
-export type { ThreadItem, ThreadItemDomain, ThreadItemEvent, ThreadItemRole, ThreadItemState, ThreadItemType, } from "../../host-contract/index.js";
+/** Agent-local normalized turn items emitted through standard ACP session updates. */
+export declare const THREAD_ITEM_PROTOCOL_VERSION: 1;
+export type ThreadItemDomain = "chat" | "solo" | "product" | "goal" | "workflow" | "system";
+export type ThreadItemType = "message" | "state" | "plan" | "task" | "checklist" | "budget" | "input_request" | "summary" | "tool_call" | "tool_result" | "artifact" | "receipt";
+export type ThreadItemRole = "user" | "assistant" | "system" | "tool";
+export type ThreadItemState = "pending" | "in_progress" | "completed" | "failed" | "blocked" | "cancelled";
+export interface ThreadItem {
+    id: string;
+    type: ThreadItemType;
+    kind: string;
+    domain: ThreadItemDomain;
+    role: ThreadItemRole;
+    state: ThreadItemState;
+    text?: string;
+    data: Record<string, unknown>;
+}
+export interface ThreadItemEvent {
+    schemaVersion: typeof THREAD_ITEM_PROTOCOL_VERSION;
+    at: string;
+    sequence?: number;
+    threadId: string;
+    turnId: string;
+    item: ThreadItem;
+}
 export type TurnStatus = "pending" | "in_progress" | "completed" | "failed" | "aborted";
 /** Represents one user request → agent response cycle. */
 export interface ThreadTurn {

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

@@ -4,25 +4,15 @@
  * ALL configurable constants that external apps (Electron UI, CLI config)
  * may want to read or override are defined here. This enables:
  *
- * 1. Private X7 host profile tooling and local runtime consumers
+ * 1. Local runtime consumers
  * 2. Serialization to JSON for persistence (settings.json)
  * 3. Environment variable overrides via QLOGICAGENT_* prefix
  *
  * Consumers import individual constants from this module.
- * The full shape is exported as `TunableDefaults` for the private host profile contract.
+ * The full shape is exported as `TunableDefaults` for public introspection.
  *
  * Grouping follows subsystem boundaries.
  */
-/**
- * @deprecated Compatibility value exposed through the legacy tunables profile.
- * Turn execution is unbounded unless the caller explicitly supplies maxRounds.
- */
-export declare const MAX_ROUNDS_LIMIT = 100;
-/**
- * @deprecated Compatibility value exposed through the legacy tunables profile.
- * It is not applied as an implicit top-level turn limit.
- */
-export declare const DEFAULT_MAX_ROUNDS = 25;
 /** Default temperature for LLM calls (0 = deterministic). */
 export declare const DEFAULT_TEMPERATURE = 0;
 /** Hard cap on tool calls per round (prevents runaway). */
@@ -84,36 +74,10 @@ export declare const REACTIVE_COMPACT_MAX_FAILURES = 3;
 export declare const REACTIVE_COMPACT_MIN_MESSAGES = 4;
 /** Target usage percentage for reactive compaction. */
 export declare const REACTIVE_COMPACT_TARGET_PERCENT = 50;
-/** Min tool calls to consider a turn "complex enough" for skill creation. */
-export declare const MIN_TOOL_CALLS_FOR_SKILL = 3;
-/** Min distinct tools to suggest a new skill. */
-export declare const MIN_DISTINCT_TOOLS_FOR_SKILL = 2;
-/**
- * Project-level pattern repetition threshold.
- * The same workflow signature must appear this many times across turns/sessions
- * before a skill creation is triggered. Prevents one-off complex turns from
- * immediately producing skills.
- */
-export declare const SKILL_PATTERN_REPETITION_THRESHOLD = 3;
-/**
- * Max age (ms) for pattern entries. Patterns older than this are pruned.
- * Default: 30 days.
- */
-export declare const SKILL_PATTERN_MAX_AGE_MS: number;
 /** Max nested fork depth for sub-agents. */
 export declare const MAX_FORK_DEPTH = 4;
 /** Team aggregate budget (total tokens across all forked sub-agents). 0 = unlimited. */
 export declare const TEAM_BUDGET_TOKENS = 0;
-/** Max historical sessions retained on disk. */
-export declare const MAX_SESSIONS = 50;
-/** Turn count threshold for triggering task summary. */
-export declare const TASK_SUMMARY_TURN_THRESHOLD = 50;
-/** Interval (turns) between summary regeneration. */
-export declare const TASK_SUMMARY_REGEN_INTERVAL = 30;
-/** Idle duration (ms) before a group session is auto-split into a new session. Default: 1 hour. */
-export declare const GROUP_SESSION_IDLE_THRESHOLD_MS: number;
-/** Hard limit: max turns in a single group session before soft-split. Default: 200 turns. */
-export declare const GROUP_SESSION_MAX_TURNS = 200;
 /** Max include nesting depth in instruction files. */
 export declare const MAX_INCLUDE_DEPTH = 5;
 /** Max total chars loaded from instruction files. */
@@ -143,33 +107,11 @@ export declare const TASK_POLL_INTERVAL_MS = 1000;
 export declare const TASK_STOPPED_DISPLAY_MS = 3000;
 /** Terminal task cleanup grace period (ms). */
 export declare const TASK_PANEL_GRACE_MS = 30000;
-/** Max bytes injected for session memory prefetch. */
-export declare const MEMORY_PREFETCH_MAX_SESSION_BYTES: number;
-/** Max results per memory recall query. */
-export declare const MEMORY_PREFETCH_LIMIT_PER_RECALL = 10;
-/** LRU dedup set size for surfaced memory entries. */
-export declare const MEMORY_MAX_SURFACED_ENTRIES = 100;
-/** Min hours between dream consolidation runs. */
-export declare const DREAM_MIN_INTERVAL_HOURS = 24;
-/** Min sessions before dream triggers. */
-export declare const DREAM_MIN_SESSIONS = 5;
-/** Dream scan throttle interval (ms). */
-export declare const DREAM_SCAN_INTERVAL_MS = 600000;
-/** Idle dream timer (minutes). */
-export declare const IDLE_DREAM_MINUTES = 30;
-/** Dream cooldown between runs (ms, 4 hours). */
-export declare const DREAM_COOLDOWN_MS = 14400000;
-/** Max dream run duration (ms). */
-export declare const DREAM_MAX_DURATION_MS = 300000;
 /**
  * Full typed shape of all tunable defaults.
- * Used by private X7 host profile tooling and local runtime consumers.
+ * Used by local runtime consumers.
  */
 export interface TunableDefaults {
-    /** @deprecated Compatibility-only; not an implicit execution limit. */
-    maxRoundsLimit: number;
-    /** @deprecated Compatibility-only; callers must explicitly set maxRounds. */
-    defaultMaxRounds: number;
     defaultTemperature: number;
     maxToolBudgetCap: number;
     defaultToolBudget: number;
@@ -198,12 +140,7 @@ export interface TunableDefaults {
     reactiveCompactMaxFailures: number;
     reactiveCompactMinMessages: number;
     reactiveCompactTargetPercent: number;
-    minToolCallsForSkill: number;
-    minDistinctToolsForSkill: number;
     maxForkDepth: number;
-    maxSessions: number;
-    taskSummaryTurnThreshold: number;
-    taskSummaryRegenInterval: number;
     maxIncludeDepth: number;
     maxInstructionChars: number;
     instructionsMaxFileSize: number;
@@ -218,15 +155,6 @@ export interface TunableDefaults {
     taskPollIntervalMs: number;
     taskStoppedDisplayMs: number;
     taskPanelGraceMs: number;
-    memoryPrefetchMaxSessionBytes: number;
-    memoryPrefetchLimitPerRecall: number;
-    memoryMaxSurfacedEntries: number;
-    dreamMinIntervalHours: number;
-    dreamMinSessions: number;
-    dreamScanIntervalMs: number;
-    idleDreamMinutes: number;
-    dreamCooldownMs: number;
-    dreamMaxDurationMs: number;
     teamBudgetTokens: number;
 }
 /**

package/dist/types/runtime/execution/forked-agent.d.ts

@@ -10,9 +10,7 @@
  *   - Optional transcript recording
  *
  * This is the execution engine for all sub-agent types:
- *   - Dream consolidation
- *   - Background memory extraction
- *   - Skill/command forking
+    *   - Skill/command forking
  *   - AgentTool async agents
  *
  * Reference: claude-code src/utils/forkedAgent.ts
@@ -24,8 +22,7 @@ import type { AgentProgress } from "./progress-tracker.js";
  * Tool permission check function — CC canUseTool parity.
  *
  * Returns allow/deny for each tool invocation.
- * Used by dream agent (read-only bash + memory writes only),
- * session memory (full read, no write), etc.
+ * Used by restricted sub-agent forks.
  */
 export type CanUseToolFn = (toolName: string, input: Record<string, unknown>) => {
     allowed: true;

package/dist/types/runtime/execution/streaming-tool-executor.d.ts

@@ -28,8 +28,6 @@ export interface StreamingToolExecutorConfig {
     toolInvoker: ToolInvoker;
     hooks?: HookRegistry;
     sessionId: string;
-    /** Turn workspace/cwd - routes oversized tool-result spillover to the session data dir. */
-    projectRoot?: string;
     /** Per-turn typed context budget and required skill-resource state. */
     contextState?: unknown;
     turnId: string;

package/dist/types/runtime/execution/tool-result-storage.d.ts

@@ -77,12 +77,21 @@ export declare function restoreRequiredContextMessages(messagesBefore: MessageLi
     messages: MessageLike[];
     recoveredCount: number;
 };
+/**
+ * Where oversized tool output is spilled to disk.
+ *
+ * Overflow is adapter-private, process-bounded evidence. It lives under the OS temp
+ * directory and is removed when the native ACP session closes. The Host never reads
+ * this directory and qlogicagent never writes the Host's canonical session tree.
+ */
+export declare function getToolResultsDir(sessionId: string): string;
+export declare function disposeToolResultStorage(sessionId: string): Promise<void>;
 export declare function generatePreview(content: string, maxBytes: number): {
     preview: string;
     hasMore: boolean;
 };
-export declare function persistToolResult(content: string, toolCallId: string, sessionId: string, projectRoot: string | undefined): Promise<PersistedToolResult | null>;
-export declare function persistCompleteToolResultEvidence(content: string, toolCallId: string, sessionId: string, projectRoot: string | undefined): Promise<CompleteToolResultEvidence | undefined>;
+export declare function persistToolResult(content: string, toolCallId: string, sessionId: string): Promise<PersistedToolResult | null>;
+export declare function persistCompleteToolResultEvidence(content: string, toolCallId: string, sessionId: string): Promise<CompleteToolResultEvidence | undefined>;
 /**
  * Build a reference message for large tool results (CC buildLargeToolResultMessage parity).
  */
@@ -92,7 +101,7 @@ export declare function buildLargeToolResultMessage(result: PersistedToolResult)
  * Falls back to hard truncation if persistence fails.
  * Called at tool execution time in streaming-tool-executor.ts.
  */
-export declare function maybePersistLargeToolResult(content: string, toolCallId: string, sessionId: string, projectRoot: string | undefined, threshold?: number): Promise<string>;
+export declare function maybePersistLargeToolResult(content: string, toolCallId: string, sessionId: string, threshold?: number): Promise<string>;
 interface MessageLike {
     role: string;
     content?: string | unknown;
@@ -115,7 +124,7 @@ interface MessageLike {
  * @returns messages with replacements applied + count of new replacements +
  *          total original bytes spilled this pass (so the caller can surface it)
  */
-export declare function enforceToolResultBudget(messages: MessageLike[], state: ContentReplacementState, sessionId: string, projectRoot: string | undefined, limit?: number): Promise<{
+export declare function enforceToolResultBudget(messages: MessageLike[], state: ContentReplacementState, sessionId: string, limit?: number): Promise<{
     messages: MessageLike[];
     newlyReplacedCount: number;
     newlyPersistedBytes: number;

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

@@ -1,72 +1,22 @@
-/**
- * Agent Paths — Centralized dot-directory name and path helpers.
- *
- * All filesystem paths under `~/.qlogicagent/` (user-level) or
- * `<project>/.qlogicagent/` (project-level) must go through these
- * helpers so the dot-dir name is defined in exactly one place.
- */
-export { deriveProjectId } from "../../host-contract/project-id.js";
-/** Dot-directory name used for both user-level and project-level storage. */
+export { deriveProjectId } from "./project-id.js";
+/** Adapter-owned configuration directory name. */
 export declare const AGENT_DOT_DIR = ".qlogicagent";
-/**
- * Derive a project's stable id from its workspaceDir — the mainstream path-derived model
- * (VS Code / Claude Code / cc-haha): same folder → same id, deterministic, recomputable, no random
- * UUID and no central-registry dependency. A short SHA-256 prefix of the resolved, lowercased path
- * keeps the id length-safe on Windows (260-char path limit) while staying collision-free in
- * practice. NOTE: deliberately NO ctime salt (VS Code salts single-folder ids so recreating a folder
- * yields fresh state — a footgun for us; we want a recreated/rebound folder to map back to its data).
- * The implementation is owned by host-contract/project-id.ts so the shared contract remains a leaf;
- * this module re-exports the same function for existing path-helper consumers.
- */
-/** `~/.qlogicagent/` (or QLOGICAGENT_HOME override) */
+/** Adapter-owned device configuration root. */
 export declare function getUserAgentHome(): string;
 export declare function resolveActiveOwnerUserId(): string;
 export declare function encodeOwnerProfileSegment(ownerUserId: string): string;
 export declare function getOwnerProfileDir(ownerUserId?: string): string;
-export declare function getProfileMemoryDir(ownerUserId?: string): string;
-/** Dir name for our per-project companion data (sessions/checkpoints/uploads). */
-export declare const PROJECT_DATA_DIRNAME = "projectData";
-/** Root of the projectData tree on this device (`~/.qlogicagent/projectData/`). */
-export declare function getProjectDataRoot(): string;
-/** `~/.qlogicagent/projectData/<projectId>/` (projectId is the path-derived key). */
-export declare function getProjectDataDirById(projectId: string): string;
-/**
- * Ensure the user agent home directory exists and is writable.
- * Returns the path if accessible, throws with a friendly message otherwise.
- * Call this once at startup rather than on every path resolution.
- */
+/** Ensure the adapter configuration root exists and is writable. */
 export declare function ensureUserAgentHome(): string;
-/** `~/.qlogicagent/profiles/<owner>/.credentials.json` */
 export declare function getUserCredentialsPath(): string;
-/** `~/.qlogicagent/plugins/` — device-scoped. */
-export declare function getUserPluginsDir(): string;
-/** `~/.qlogicagent/profiles/<owner>/settings.json` */
 export declare function getUserSettingsPath(): string;
-/** `~/.qlogicagent/cache/` */
 export declare function getUserCacheDir(): string;
-/** `~/.qlogicagent/debug-logs/` */
 export declare function getUserDebugLogsDir(): string;
-/** `~/.qlogicagent/plugin-cache/` — device-scoped (download cache for installs). */
-export declare function getUserPluginCacheDir(): string;
-/** `~/.qlogicagent/marketplace.json` — device-scoped marketplace sources. */
-export declare function getUserMarketplaceConfigPath(): string;
-/** `~/.qlogicagent/profiles/<owner>/workflows/` */
 export declare function getUserWorkflowsDir(): string;
-/** `~/.qlogicagent/profiles/<owner>/INSTRUCTIONS.md` */
 export declare function getUserInstructionsPath(): string;
-/** `~/.qlogicagent/profiles/<owner>/rules/` */
 export declare function getUserRulesDir(): string;
-/** `<cwd>/.qlogicagent/` */
 export declare function getProjectAgentDir(cwd: string): string;
-/** `<cwd>/.qlogicagent/workflows/` */
 export declare function getProjectWorkflowsDir(cwd: string): string;
-/** `<cwd>/.qlogicagent/plugins/` */
-export declare function getProjectPluginsDir(cwd: string): string;
-/** `<cwd>/.qlogicagent/settings.json` */
-export declare function getProjectSettingsPath(cwd: string): string;
-/** `<cwd>/.qlogicagent/INSTRUCTIONS.md` */
 export declare function getProjectInstructionsPath(cwd: string): string;
-/** `<cwd>/.qlogicagent/rules/` — unified rules + instructions directory */
 export declare function getProjectRulesDir(cwd: string): string;
-/** `<gitRoot>/.qlogicagent/hooks/` */
 export declare function getGitRootHooksDir(gitRoot: string): string;

package/dist/types/runtime/infra/agent-project-projection.d.ts

@@ -0,0 +1,20 @@
+/** In-memory project identity projected by standard ACP session inputs. */
+export type AgentProjectType = "default" | "personal" | "group" | "automation";
+export interface AgentProjectInfo {
+    id: string;
+    name: string;
+    workspaceDir: string;
+    type: AgentProjectType;
+    status: "active" | "archived";
+    groupId?: string;
+    createdAt: string;
+    updatedAt: string;
+}
+export type AgentProjectSnapshot = {
+    activeProjectId: string | null;
+    projects: AgentProjectInfo[];
+};
+export declare function materializeAgentProjectProjection(projectId: string, workspaceDir: string): void;
+export declare function readAgentProjectProjection(): AgentProjectSnapshot;
+export declare function resetAgentProjectProjection(): void;
+export declare function setAgentProjectProjectionForTests(next: AgentProjectSnapshot): void;

package/dist/types/runtime/infra/background-tasks.d.ts

@@ -1,9 +1,9 @@
 /**
  * BackgroundTaskManager — the single registry for all background execution.
  *
- * Every background unit of work (forked agent, backgrounded shell command,
- * dream consolidation) registers here so that:
- *   1. The TaskStore holds its lifecycle state (task.updated notifications fire)
+ * Every background unit of work (forked agent or backgrounded shell command)
+ * registers here so that:
+ *   1. The TaskStore holds its adapter-local lifecycle state
  *   2. The LLM can query status/output via the task tool ("output" action)
  *   3. Completion is queued as a <task_notification> for the next turn
  *   4. Cancellation actually kills the underlying process / aborts the agent

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

@@ -16,16 +16,9 @@ export declare class DefaultPathService implements PathService {
     resolveActiveOwnerUserId(): string;
     getUserAgentHome(): string;
     getOwnerProfileDir(ownerUserId?: string): string;
-    getProfileMemoryDir(ownerUserId?: string): string;
     getUserSettingsPath(): string;
-    getUserPluginsDir(): string;
-    getUserPluginCacheDir(): string;
-    getUserMarketplaceConfigPath(): string;
     getProjectAgentDir(projectRoot?: string): string;
-    getProjectSettingsPath(projectRoot?: string): string;
     getProjectInstructionsPath(projectRoot?: string): string;
-    getProjectPluginsDir(projectRoot?: string): string;
     getProjectRulesDir(projectRoot?: string): string;
-    getProjectSessionDataRoot(projectIdOrWorkspaceDir?: string): string;
 }
 export declare function getDefaultPathService(): PathService;

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

@@ -1,6 +1,6 @@
 import type { ModelCapabilityProfile, ModelEntry, ModelPurpose, ModelRegistry, ReasoningMode } from "./model-registry.js";
 import type { ConfigPort } from "../ports/index.js";
-import { type ProviderCatalogDef } from "../../host-contract/provider-profile.js";
+import { type ProviderCatalogDef } from "./provider-profile.js";
 export declare const LLMROUTER_CATALOG_UNAVAILABLE_MESSAGE = "\u65E0\u6CD5\u8FDE\u63A5 llmrouter \u6A21\u578B\u76EE\u5F55";
 export declare const LLMROUTER_PROVIDER_ID = "llmrouter";
 export declare const LLMROUTER_PROVIDER_NAME = "LLMRouter";

package/dist/types/runtime/infra/model-registry.d.ts

@@ -1,4 +1,4 @@
-import { MODEL_PURPOSES, type ModelPurpose } from "../../host-contract/index.js";
+import { MODEL_PURPOSES, type ModelPurpose } from "@xiaozhiclaw/module-sdk/model-access";
 import { type KeyConfig, type KeyHandle, type LoadBalanceStrategy, type PoolStatus, type ProviderPoolConfig } from "./key-pool.js";
 export type RegistryChangeCallback = () => void;
 export type ReasoningMode = "none" | "adaptive" | "collapsed" | "effort";
@@ -98,8 +98,6 @@ export interface ResolvedModel {
     baseUrl?: string;
     keyHandle: KeyHandle;
 }
-/** @deprecated Use MODEL_PURPOSES; retained as a compatibility alias. */
-export declare const ALL_PURPOSES: ModelPurpose[];
 export declare class ModelRegistry {
     private keyPool;
     private catalogProviders;
@@ -120,11 +118,11 @@ export declare class ModelRegistry {
     peekActiveModel(purpose: ModelPurpose): ModelEntry | null;
     /**
      * Whether the model bound to `purpose` (default "chat") accepts the given input modality
-     * (e.g. "image"). Blocks ONLY when the catalog EXPLICITLY lists modalities without this one;
-     * absent/empty metadata → true (don't strip), so vision models with sparse profiles (and the
-     * imageUnderstanding route) are never wrongly stripped. The well-formedness of multimodal content
-     * is handled in provider-core's transport; this is just a guard against feeding media to a model
-     * the catalog says is text-only.
+     * (e.g. "image"). Non-text input is forwarded natively only when the catalog explicitly declares
+     * that modality. Sparse metadata is not evidence that an arbitrary binary payload is accepted:
+     * treating it as multimodal can expand a small audio attachment into hundreds of thousands of
+     * prompt tokens before the Agent gets a chance to choose a file-processing Skill. Text remains the
+     * universal baseline; unknown media is handed to the projected media/file tools by the turn layer.
      */
     acceptsInputModality(modality: string, purpose?: ModelPurpose): boolean;
     isAvailable(purpose: ModelPurpose): boolean;
@@ -189,7 +187,6 @@ export declare class ModelRegistry {
     getAllBindings(): Record<string, ModelEntry | null>;
     getProviderStatus(providerId: string): PoolStatus | null;
     getAllProviderStatus(): PoolStatus[];
-    save(): void;
     load(): boolean;
     exportConfig(): ModelRegistryConfig;
     getTunable<T = unknown>(key: string): T | undefined;

package/dist/types/runtime/infra/project-store.d.ts

@@ -1,10 +1,10 @@
 /**
- * Read-only ExtHost-style Project projection.
+ * Read-only ACP session Project projection.
  *
  * Gateway owns the durable registry and every lifecycle mutation. qlogicagent
- * may only read the snapshot hydrated through x/host.request.
+ * reads only the in-memory project identity projected by standard ACP inputs.
  */
-import type { ProjectInfo } from "../../protocol/methods.js";
+import { type AgentProjectInfo as ProjectInfo } from "./agent-project-projection.js";
 export declare function listProjects(): ProjectInfo[];
 export declare function getActiveProject(): ProjectInfo | null;
 export declare function getDefaultProject(): ProjectInfo | null;

package/dist/types/runtime/infra/subagent-turn-snapshot.d.ts

@@ -1,4 +1,51 @@
-import type { TurnSubagentActivityNotification, TurnSubagentCompletedNotification, TurnSubagentDecisionNotification, TurnSubagentStartedNotification } from "../../protocol/wire/notification-payloads.js";
+export interface SubagentStartedSnapshotInput {
+    parentTurnId: string;
+    subagentId: string;
+    agentType: string;
+    displayName?: string;
+    delegatedTask?: string;
+    mode?: "foreground" | "background";
+    startedAt?: string;
+}
+export interface SubagentActivitySnapshotInput {
+    parentTurnId: string;
+    subagentId: string;
+    agentType: string;
+    displayName?: string;
+    activityId?: string;
+    toolName?: string;
+    conciseStatus: string;
+    status: "running" | "completed" | "failed" | "blocked";
+    observedAt: string;
+}
+export interface SubagentCompletedSnapshotInput {
+    parentTurnId: string;
+    subagentId: string;
+    agentType: string;
+    displayName?: string;
+    status: "completed" | "failed" | "cancelled";
+    toolsUsed?: string[];
+    resultSummary?: string;
+    evidence?: Array<{
+        source: "tool" | "artifact" | "verification";
+        label: string;
+        status: "passed" | "failed" | "observed";
+    }>;
+    durationMs?: number;
+    tokenUsage?: {
+        inputTokens: number;
+        outputTokens: number;
+        totalTokens: number;
+    };
+    error?: string;
+    finishedAt?: string;
+}
+export interface SubagentDecisionSnapshotInput {
+    parentTurnId: string;
+    subagentId: string;
+    decision: "adopted" | "partially_adopted" | "rejected";
+    summary?: string;
+}
 export interface PersistedSubagentSnapshot {
     subagentId: string;
     agentType: string;
@@ -15,18 +62,18 @@ export interface PersistedSubagentSnapshot {
     }>;
     toolsUsed?: string[];
     resultSummary?: string;
-    evidence?: TurnSubagentCompletedNotification["evidence"];
+    evidence?: SubagentCompletedSnapshotInput["evidence"];
     durationMs?: number;
-    tokenUsage?: TurnSubagentCompletedNotification["tokenUsage"];
+    tokenUsage?: SubagentCompletedSnapshotInput["tokenUsage"];
     decision?: "pending" | "adopted" | "partially_adopted" | "rejected";
     decisionSummary?: string;
     error?: string;
     startedAt?: string;
     finishedAt?: string;
 }
-export declare function recordSubagentStarted(payload: TurnSubagentStartedNotification): PersistedSubagentSnapshot;
-export declare function recordSubagentActivity(payload: TurnSubagentActivityNotification): PersistedSubagentSnapshot;
-export declare function recordSubagentCompleted(payload: TurnSubagentCompletedNotification): PersistedSubagentSnapshot;
-export declare function recordSubagentDecision(payload: TurnSubagentDecisionNotification): PersistedSubagentSnapshot | undefined;
+export declare function recordSubagentStarted(payload: SubagentStartedSnapshotInput): PersistedSubagentSnapshot;
+export declare function recordSubagentActivity(payload: SubagentActivitySnapshotInput): PersistedSubagentSnapshot;
+export declare function recordSubagentCompleted(payload: SubagentCompletedSnapshotInput): PersistedSubagentSnapshot;
+export declare function recordSubagentDecision(payload: SubagentDecisionSnapshotInput): PersistedSubagentSnapshot | undefined;
 export declare function subagentActivityBlock(snapshot: PersistedSubagentSnapshot): Record<string, unknown>;
 export declare function clearSubagentTurnSnapshotsForTests(): void;

package/dist/types/runtime/infra/task-runtime.d.ts

@@ -2,7 +2,7 @@
  * Task Runtime — CC framework.ts parity.
  *
  * Manages task lifecycle: creation, state updates, completion, cleanup.
- * All task types (local_bash, local_agent, dream, etc.) use this framework.
+ * All background task types use this framework.
  *
  * CC equivalent: src/utils/task/framework.ts + src/Task.ts
  *

package/dist/types/runtime/ports/agent-runtime-ports.d.ts

@@ -36,8 +36,6 @@ export interface StreamingToolExecutorPortConfig {
     maxConcurrentTools?: number;
     maxExecutionMs?: number;
     executionTimeoutMsByTool?: ReadonlyMap<string, number>;
-    /** Turn workspace/cwd — routes oversized tool-result spillover to the session's reachable data dir. */
-    projectRoot?: string;
     /** Opaque per-turn tool-result context budget state. */
     contextState?: unknown;
 }
@@ -53,7 +51,7 @@ export interface ToolLoopRuntimePorts {
         role: string;
         content?: string | unknown;
         tool_call_id?: string;
-    }>, state: unknown, sessionId: string, projectRoot: string | undefined): Promise<{
+    }>, state: unknown, sessionId: string): Promise<{
         messages: unknown[];
         newlyReplacedCount: number;
         newlyPersistedBytes?: number;

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

@@ -1,12 +1,8 @@
-export type { MemoryExtractionQueue, MemoryWriter, MemoryWriteMetadata, } from "./memory-writer.js";
-export type { MemoryRecallSource } from "./memory-recall-source.js";
-export type { MemoryProvider, MemorySearchOptions, MemorySearchResult, MemoryIngestOptions, MemoryExtractionItem, MemoryConsolidationWriteResult, MemoryLearningSink, MemoryActivitySummary, MemoryAtlasRecord, MemoryAtlasResult, MemoryUpdatePatch, MemoryHandlerProvider, MemoryDreamProvider, MemoryDecayProvider, MemoryRuntimeHookProvider, MemoryDreamRuntimeProvider, } from "./memory-provider.js";
 export type { PathService } from "./path-service.js";
 export type { ConfigPort } from "./config-port.js";
 export { createRecordConfigPort } from "./config-port.js";
 export { PERMISSION_MODES, } from "./permission-contracts.js";
 export type { ApprovalRequest, ApprovalResponse, PermissionApprovalResolver, PermissionBehavior, PermissionConfig, PermissionDecisionReason, PermissionEngineConfig, PermissionMetadataResolver, PermissionMode, PermissionRiskLevel, PermissionResult, PermissionRuleEnginePort, PermissionRuleEntry, ToolPermissionCheckInput, } from "./permission-contracts.js";
-export type { ProjectMemoryFileInfo, ProjectMemoryResult, ProjectMemoryStore, ProjectMemoryStoreFactory, } from "./project-memory-store.js";
 export type { RuntimeToolContract, ToolBootstrap, ToolBootstrapConfig, ToolBootstrapProvider, ToolBootstrapProviderContext, ToolBootstrapProgress, ToolCatalog, ToolRegistrationModule, ToolRegistrationModuleKind, } from "./tool-contracts.js";
 export { defineToolRegistrationModule } from "./tool-contracts.js";
 export { buildToolResultMessage, type OpenAiToolCall, type ToolResultMessageInput } from "./tool-call-contracts.js";

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

@@ -6,8 +6,7 @@ export interface PathService {
      * paths resolve and the shell session's cwd lives). This is the value last set
      * via setActiveWorkdir — it is the authoritative "active workdir" used by the
      * permission pipeline to classify cross-workspace operations. It can differ
-     * from getActiveProjectRoot() (which feeds memory/sessions/project-agent-dir):
-     * getActiveProjectRoot may be a captured snapshot, while this always tracks the
+     * from getActiveProjectRoot(), which may be a captured project snapshot while this tracks the
      * live tool workdir. Falls back to getActiveProjectRoot() if never set.
      */
     getActiveWorkdir(): string;
@@ -15,15 +14,8 @@ export interface PathService {
     resolveActiveOwnerUserId(): string;
     getUserAgentHome(): string;
     getOwnerProfileDir(ownerUserId?: string): string;
-    getProfileMemoryDir(ownerUserId?: string): string;
     getUserSettingsPath(): string;
-    getUserPluginsDir(): string;
-    getUserPluginCacheDir(): string;
-    getUserMarketplaceConfigPath(): string;
     getProjectAgentDir(projectRoot?: string): string;
-    getProjectSettingsPath(projectRoot?: string): string;
     getProjectInstructionsPath(projectRoot?: string): string;
-    getProjectPluginsDir(projectRoot?: string): string;
     getProjectRulesDir(projectRoot?: string): string;
-    getProjectSessionDataRoot(projectIdOrWorkspaceDir?: string): string;
 }

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

@@ -71,7 +71,6 @@ export interface ToolBootstrapConfig {
     getTaskScopeKey?(): string | undefined;
     getCurrentTurnId?(): string | undefined;
     isGroupSecurityMode?(): boolean;
-    sendNotification?(method: string, params: Record<string, unknown>): void;
     onExecProgress?(progress: ToolBootstrapProgress): void;
     /** Lazy host-owned tunable overrides; web registration must not call it until first invoke. */
     loadTunableOverrides?(): Promise<Record<string, unknown>>;

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

@@ -0,0 +1,37 @@
+/**
+ * Bounded Agent-local view of Host-owned session input.
+ *
+ * The Host owns canonical session identity, history and durable state. The
+ * adapter keys this ephemeral view by its own native ACP session ID so a Host
+ * restart/resume can project canonical history without creating a second
+ * session authority.
+ */
+import type { AgentHostTurnContextV1 } from "@xiaozhiclaw/module-sdk";
+import type { ChatMessage } from "../../protocol/wire/index.js";
+import type { SessionUsageSnapshot } from "./session-state.js";
+export interface AgentSessionProjectionMetadata {
+    nativeSessionId: string;
+    projectId: string;
+    createdAt: string;
+    lastActiveAt: string;
+    turnCount: number;
+    messageCount: number;
+    model?: string;
+    cwd?: string;
+    totalInputTokens?: number;
+    totalOutputTokens?: number;
+}
+export interface AgentSessionProjection {
+    metadata: AgentSessionProjectionMetadata;
+    messages: ChatMessage[];
+}
+/** Replace one native session view with the exact Host-owned turn context. */
+export declare function materializeAgentSessionProjection(context: AgentHostTurnContextV1, nativeSessionId: string): void;
+export declare function disposeAgentSessionProjection(nativeSessionId: string): void;
+/** Test/process teardown only. */
+export declare function resetAgentSessionProjections(): void;
+export declare function readAgentSessionProjection(nativeSessionId: string): AgentSessionProjection | null;
+/** Merge Host-owned prior history with the current ACP prompt without creating another store. */
+export declare function mergeAgentSessionHistory(history: readonly ChatMessage[], current: readonly ChatMessage[]): ChatMessage[];
+/** Update usage and routing metadata in the bounded in-memory projection. */
+export declare function recordAgentSessionSnapshot(nativeSessionId: string, usageSnapshot: SessionUsageSnapshot, metadata: Pick<AgentSessionProjectionMetadata, "model" | "cwd" | "projectId" | "messageCount">): void;