memeloop 0.0.1 → 0.1.0

package/dist/index.d.mts

@@ -1,3203 +0,0 @@
-import { PublicKey, PrivateKey } from '@libp2p/interface';
-import { z } from 'zod';
-
-interface PromptNode {
-    id: string;
-    text?: string;
-    /** TidGi IPrompt 兼容 */
-    caption?: string;
-    role?: 'system' | 'user' | 'assistant' | 'tool';
-    enabled?: boolean;
-    children?: PromptNode[];
-    /** UI 溯源，可选 */
-    source?: unknown;
-    /**
-     * 与插件 `dynamicPosition` 配合：用户轮次 ≥2 时将根级该节点移到列表末尾。
-     */
-    dynamicPosition?: 'deferToEnd';
-}
-/** 与 TidGi `IPrompt` 对齐的别名 */
-type IPrompt = PromptNode;
-interface PromptPluginConfig {
-    id: string;
-    toolId: string;
-    enabled?: boolean;
-    /** defineTool：`approval`（mode / allowPatterns / denyPatterns）等，类型见 `tools/types` */
-    [key: string]: unknown;
-}
-interface AgentFrameworkConfig {
-    prompts: PromptNode[];
-    response?: unknown[];
-    plugins: PromptPluginConfig[];
-}
-interface AgentPromptDescription {
-    agentFrameworkConfig?: AgentFrameworkConfig;
-}
-
-interface AgentDefinitionModelConfig {
-    provider?: string;
-    model?: string;
-    temperature?: number;
-    maxTokens?: number;
-}
-interface ModelSelection {
-    provider: string;
-    model: string;
-    [key: string]: unknown;
-}
-interface ModelParameters {
-    temperature?: number;
-    maxTokens?: number;
-    topP?: number;
-    [key: string]: unknown;
-}
-interface AiAPIConfig {
-    default?: ModelSelection;
-    embedding?: ModelSelection;
-    speech?: ModelSelection;
-    imageGeneration?: ModelSelection;
-    transcriptions?: ModelSelection;
-    free?: ModelSelection;
-    modelParameters: ModelParameters;
-    [key: string]: unknown;
-}
-interface AgentHeartbeatConfig {
-    enabled: boolean;
-    intervalSeconds: number;
-    message: string;
-    activeHoursStart?: string;
-    activeHoursEnd?: string;
-}
-interface AgentDefinitionToolConfig {
-    toolId: string;
-    enabled?: boolean;
-    parameters?: Record<string, unknown>;
-    tags?: string[];
-}
-type HostAgentToolConfig$1 = AgentDefinitionToolConfig;
-interface AgentDefinition {
-    id: string;
-    name: string;
-    description: string;
-    systemPrompt: string;
-    tools: string[];
-    modelConfig?: AgentDefinitionModelConfig;
-    promptSchema?: unknown;
-    /**
-     * TidGi-Desktop / memeloop：prompt 树、插件、maxIterations 等（结构见 memeloop prompt 类型）
-     * Typed as `AgentFrameworkConfig` so all hosts share a single canonical shape.
-     */
-    agentFrameworkConfig?: AgentFrameworkConfig;
-    /** Host-specific explicit tool configuration. Hosts map this to prompt plugins at runtime. */
-    agentTools?: AgentDefinitionToolConfig[];
-    /** Host-specific avatar or icon URL. */
-    avatarUrl?: string;
-    /** Host-specific agent handler / framework ID. */
-    agentFrameworkID?: string;
-    /** Periodic auto-wake configuration. */
-    heartbeat?: AgentHeartbeatConfig;
-    /** Host-specific AI API config override. */
-    aiApiConfig?: AiAPIConfig;
-    version: string;
-}
-interface AgentInstanceMeta {
-    instanceId: string;
-    definitionId: string;
-    nodeId: string;
-    conversationId: string;
-    createdAt: number;
-    updatedAt: number;
-    definitionDelta?: Partial<AgentDefinition>;
-}
-
-/**
- * Unified loop contract for all agent loop types.
- * Replaces the old TaskAgentInput / TaskAgentStep naming entirely.
- */
-
-/** Standard input for any agent loop. */
-interface AgentLoopInput {
-    conversationId: string;
-    message: string;
-    /** Host-prepared user message, used when the platform needs metadata/attachments on the turn root. */
-    userMessage?: Omit<Partial<ChatMessage>, 'conversationId' | 'role'> & {
-        content?: string;
-    };
-    /** If provided, these messages are loaded as conversation history on resume. */
-    resumeSession?: ChatMessage[];
-}
-/** Standard output step yielded by any agent loop. */
-interface AgentLoopStep {
-    type: 'thinking' | 'tool' | 'message' | 'permission_request';
-    data: unknown;
-}
-/** Async iterable signature shared by all loop runners. */
-type AgentLoopGenerator = AsyncIterable<AgentLoopStep>;
-/** Describes a registered loop type. */
-interface AgentLoopDefinition {
-    /** Unique id, e.g. "llm-io" or "sub-agent". */
-    id: string;
-    /** Human-readable display name. */
-    name: string;
-    /** Short description of this loop's behaviour. */
-    description: string;
-    /** Factory: create a loop runner function for the given context. */
-    createRunner: (context: {
-        [key: string]: unknown;
-    }) => (input: AgentLoopInput) => AgentLoopGenerator;
-}
-/** Capability extension point for a loop. */
-interface LoopPlugin {
-    /** Unique plugin id, e.g. "fullReplacement" or "wikiTools". */
-    id: string;
-    /** Which loop id this plugin targets, or "*" for all loops. */
-    targetLoopId?: string;
-    /** Optional schema to validate against profile config. */
-    schema?: Record<string, unknown>;
-    /** Install the plugin into the given context. Mutates the context in place. */
-    install?: (context: {
-        [key: string]: unknown;
-    }, config?: Record<string, unknown>) => void;
-}
-/** A complete agent profile that describes which loop, which .mjs script, prompts, plugins, and hooks to use. */
-interface LoopProfile {
-    /** Unique profile id, e.g. "memeloop:general-assistant". */
-    id: string;
-    /** Display name. */
-    name: string;
-    /** Description. */
-    description: string;
-    /** Which loop to run. Defaults to "llm-io" if omitted. */
-    loopId?: string;
-    /** Path (host-resolvable) to the .mjs loop script. */
-    script?: string;
-    /** System prompt (concise form; detailed prompts go to `prompts`). */
-    systemPrompt?: string;
-    /** Tool allowlist IDs. */
-    tools?: string[];
-    /** Agent-level tool configuration. */
-    agentTools?: Array<{
-        toolId: string;
-        enabled?: boolean;
-        parameters?: Record<string, unknown>;
-        tags?: string[];
-    }>;
-    /** Full agent framework configuration. */
-    agentFrameworkConfig?: AgentFrameworkConfig;
-    /** System prompt(s) for the agent. */
-    prompts?: LoopProfilePrompt[];
-    /** Tool / prompt / response plugin configs. */
-    plugins?: LoopProfilePluginEntry[];
-    /** Hook plugin configs. */
-    hookPlugins?: LoopProfilePluginEntry[];
-    /** Model configuration. */
-    modelConfig?: {
-        provider?: string;
-        model?: string;
-        temperature?: number;
-        maxTokens?: number;
-    };
-    /** Host-specific AI API config override. */
-    aiApiConfig?: AiAPIConfig;
-    /** Periodic auto-wake configuration. */
-    heartbeat?: {
-        enabled: boolean;
-        intervalSeconds: number;
-        message: string;
-        activeHoursStart?: string;
-        activeHoursEnd?: string;
-    };
-    /** Host-specific handler / framework ID. */
-    agentFrameworkID?: string;
-    /** Host-specific avatar or icon URL. */
-    avatarUrl?: string;
-    /** Tool permission configuration. */
-    permissions?: {
-        default?: 'allow' | 'ask' | 'deny';
-        rules?: Array<{
-            pattern: string;
-            action: 'allow' | 'ask' | 'deny';
-        }>;
-        perAgent?: Record<string, {
-            default?: string;
-            rules?: Array<{
-                pattern: string;
-                action: string;
-            }>;
-        }>;
-    };
-    /** Open schema for host-specific or loop-specific configuration. */
-    schema?: Record<string, unknown>;
-    /** Arbitrary metadata. */
-    metadata?: Record<string, unknown>;
-    /** Version string. */
-    version?: string;
-}
-interface LoopProfilePrompt {
-    id: string;
-    role: string;
-    text: string;
-    caption?: string;
-    children?: LoopProfilePrompt[];
-}
-interface LoopProfilePluginEntry {
-    /** Plugin id registered in the plugin registry. */
-    id: string;
-    /** Whether this plugin is enabled. */
-    enabled?: boolean;
-    /** Plugin-specific configuration. */
-    config?: Record<string, unknown>;
-}
-/** Minimal runtime context passed to a loop runner. */
-interface AgentLoopRuntime {
-    /** Resolve a profile by id. */
-    resolveProfile: (profileId: string) => Promise<LoopProfile | null>;
-    /** Run a child agent (or sub-loop) and return its result. */
-    runChildAgent: (input: {
-        profileId: string;
-        prompt: string;
-        conversationId: string;
-    }) => AgentLoopGenerator;
-    /** Log an event for observability. */
-    log: (event: string, data?: Record<string, unknown>) => void;
-    /** Read/write persistent state for this run. */
-    state: {
-        get: <T>(key: string) => Promise<T | undefined>;
-        set: (key: string, value: unknown) => Promise<void>;
-        update: (key: string, updater: (previous: unknown) => unknown) => Promise<void>;
-    };
-    /** Checkpoint a completed step so it can be skipped on resume. */
-    checkpoint: (key: string, result: unknown) => Promise<void>;
-    /** Emit a progress step upstream. */
-    emit: (step: AgentLoopStep) => void;
-    /** Signal whether the run has been cancelled. */
-    signal: {
-        cancelled: boolean;
-    };
-}
-
-type ToolCallingMatch = {
-    found: false;
-} | {
-    found: true;
-    toolId: string;
-    parameters: Record<string, unknown>;
-    originalText: string;
-};
-declare function matchToolCalling(responseText: string): ToolCallingMatch;
-declare function matchAllToolCallings(responseText: string): {
-    calls: Array<ToolCallingMatch & {
-        found: true;
-    }>;
-    parallel: boolean;
-};
-
-/**
- * TidGi-Desktop `agentInstance/tools/types.ts` 迁移并适配 memeloop（无 tapable，用 HookSlot.promise 串行执行）。
- */
-
-/** 供 defineTool / 审批使用：agent 视图包含完整 AgentInstance。 */
-type DefineToolAgentFrameworkContext = AgentFrameworkContext & {
-    agent: AgentInstanceModel;
-};
-type ToolApprovalMode = 'auto' | 'confirm';
-interface ToolApprovalConfig {
-    mode: ToolApprovalMode;
-    allowPatterns?: string[];
-    denyPatterns?: string[];
-    timeoutMs?: number;
-}
-type ApprovalDecision = 'allow' | 'deny' | 'pending';
-interface ToolApprovalRequest {
-    approvalId: string;
-    agentId: string;
-    toolName: string;
-    parameters: Record<string, unknown>;
-    originalText?: string;
-    created: Date;
-}
-type YieldNextRoundTarget = 'human' | 'self' | `agent:${string}`;
-interface ToolActions {
-    yieldNextRoundTo?: YieldNextRoundTarget;
-    newUserMessage?: string;
-    toolCalling?: ToolCallingMatch;
-}
-interface BaseToolContext {
-    agentFrameworkContext: DefineToolAgentFrameworkContext;
-    metadata?: Record<string, unknown>;
-    actions?: ToolActions;
-}
-/** 与 TidGi IPromptConcatTool 对齐的插件行 */
-interface FrameworkPluginToolConfig {
-    id: string;
-    toolId: string;
-    enabled?: boolean;
-    caption?: string;
-    content?: string;
-    forbidOverrides?: boolean;
-    approval?: ToolApprovalConfig;
-    timeoutMs?: number;
-    [key: string]: unknown;
-}
-interface PromptConcatHookContext extends BaseToolContext {
-    messages: ChatMessage[];
-    prompts: IPrompt[];
-    toolConfig: FrameworkPluginToolConfig;
-    pluginIndex?: number;
-}
-interface AgentResponse {
-    id: string;
-    text?: string;
-    enabled?: boolean;
-    children?: AgentResponse[];
-}
-interface PostProcessContext extends PromptConcatHookContext {
-    llmResponse: string;
-    responses?: AgentResponse[];
-}
-/** 流式响应子集（memeloop ILLMProvider 聚合为最终文本后注入） */
-interface AIStreamResponseSubset {
-    status: 'update' | 'done';
-    content: string;
-}
-interface AIResponseContext extends BaseToolContext {
-    toolConfig: FrameworkPluginToolConfig;
-    agentFrameworkConfig?: {
-        plugins?: FrameworkPluginToolConfig[];
-    };
-    response: AIStreamResponseSubset;
-    requestId?: string;
-    isFinal?: boolean;
-}
-interface UserMessageContext extends BaseToolContext {
-    content: {
-        text: string;
-        file?: unknown;
-        wikiTiddlers?: Array<{
-            workspaceName: string;
-            tiddlerTitle: string;
-        }>;
-    };
-    messageId: string;
-    timestamp: Date;
-}
-interface AgentStatusContext extends BaseToolContext {
-    status: {
-        state: 'working' | 'completed' | 'failed' | 'canceled';
-        modified: Date;
-    };
-}
-interface ToolExecutionContext extends BaseToolContext {
-    toolResult: {
-        success: boolean;
-        data?: string;
-        error?: string;
-        metadata?: Record<string, unknown>;
-    };
-    toolInfo: {
-        toolId: string;
-        parameters: Record<string, unknown>;
-        originalText?: string;
-    };
-    requestId?: string;
-}
-/**
- * Hook 槽：与 tapable AsyncSeriesHook 一致 — `tapAsync` 注册，`promise(ctx)` 串行触发。
- */
-interface HookSlot {
-    tapAsync(name: string, function_: (context: any, callback: () => void) => void): void;
-    promise(context: unknown): Promise<void>;
-}
-interface PromptConcatHooks {
-    processPrompts: HookSlot;
-    finalizePrompts: HookSlot;
-    postProcess: HookSlot;
-    userMessageReceived: HookSlot;
-    agentStatusChanged: HookSlot;
-    toolExecuted: HookSlot;
-    responseUpdate: HookSlot;
-    responseComplete: HookSlot;
-}
-type PromptConcatTool = (hooks: PromptConcatHooks) => void;
-
-type IMPlatformType = 'telegram' | 'discord' | 'lark' | 'wecom' | 'slack' | 'line' | 'qq';
-interface IMChannel {
-    channelId: string;
-    platform: IMPlatformType;
-    nodeId: string;
-    webhookMode: 'cloud-relay' | 'direct';
-    webhookUrl?: string;
-    defaultDefinitionId?: string;
-    status: 'active' | 'inactive' | 'error';
-}
-interface IMChannelBinding {
-    channelId: string;
-    imUserId: string;
-    activeConversationId: string;
-    createdAt: number;
-    defaultDefinitionId?: string;
-    /** When set, the user's next inbound message is treated as an askQuestion answer (plan §20.3). */
-    pendingQuestionId?: string;
-}
-/** @deprecated Use IMChannelBinding */
-type ImChannelBindingRecord = IMChannelBinding;
-
-type VersionVector = Record<string, number>;
-interface ConversationMeta {
-    conversationId: string;
-    title: string;
-    lastMessagePreview: string;
-    lastMessageTimestamp: number;
-    messageCount: number;
-    originNodeId: string;
-    definitionId: string;
-    instanceDelta?: Record<string, unknown>;
-    isUserInitiated: boolean;
-    sourceChannel?: {
-        channelId: string;
-        platform: string;
-        imUserId: string;
-    };
-}
-declare function isConversationMeta(value: unknown): value is ConversationMeta;
-
-interface CheckpointRecord {
-    conversationId: string;
-    messages: ChatMessage[];
-    savedAt: string;
-    messageCount: number;
-    lastMessagePreview: string;
-}
-interface CheckpointSummary {
-    conversationId: string;
-    savedAt: string;
-    messageCount: number;
-    lastMessagePreview: string;
-}
-interface CheckpointStore {
-    saveCheckpoint(conversationId: string, messages: ChatMessage[]): Promise<CheckpointRecord>;
-    loadCheckpoint(conversationId: string): Promise<CheckpointRecord | null>;
-    listCheckpoints(): Promise<CheckpointSummary[]>;
-    deleteCheckpoint(conversationId: string): Promise<boolean>;
-}
-interface SessionStorageOptions {
-    records?: CheckpointRecord[];
-}
-declare function createCheckpointRecord(conversationId: string, messages: ChatMessage[], savedAt?: string): CheckpointRecord;
-declare function parseCheckpointRecord(raw: string): CheckpointRecord | null;
-declare function serializeCheckpointRecord(record: CheckpointRecord): string;
-declare class InMemoryCheckpointStore implements CheckpointStore {
-    private readonly records;
-    constructor(options?: SessionStorageOptions);
-    saveCheckpoint(conversationId: string, messages: ChatMessage[]): Promise<CheckpointRecord>;
-    loadCheckpoint(conversationId: string): Promise<CheckpointRecord | null>;
-    listCheckpoints(): Promise<CheckpointSummary[]>;
-    deleteCheckpoint(conversationId: string): Promise<boolean>;
-}
-declare class SessionStorage extends InMemoryCheckpointStore {
-}
-
-type ConversationQueryMode = 'metadata-only' | 'full-content' | 'on-demand';
-interface ListConversationsOptions {
-    limit?: number;
-    offset?: number;
-}
-interface GetMessagesOptions {
-    mode?: ConversationQueryMode;
-}
-interface IAgentStorage$1 {
-    listConversations(options?: ListConversationsOptions): Promise<ConversationMeta[]>;
-    getMessages(conversationId: string, options?: GetMessagesOptions): Promise<ChatMessage[]>;
-    appendMessage(message: ChatMessage): Promise<void>;
-    /**
-     * Upsert conversation directory row (sync / Solid / peer metadata).
-     */
-    upsertConversationMetadata(meta: ConversationMeta): Promise<void>;
-    /**
-     * Insert messages if messageId not present (merge from remote / Pod); refreshes per-conversation messageCount.
-     */
-    insertMessagesIfAbsent(messages: ChatMessage[]): Promise<void>;
-    getAttachment(contentHash: string): Promise<AttachmentReference | null>;
-    saveAttachment(reference: AttachmentReference, data: Buffer | Uint8Array): Promise<void>;
-    /**
-     * 读取已落库的附件二进制（用于节点间 RPC `memeloop.storage.getAttachmentBlob`）。
-     * 未实现时远端同步应通过其它通道拉取附件。
-     */
-    readAttachmentData?(contentHash: string): Promise<Uint8Array | null>;
-    getAgentDefinition(id: string): Promise<AgentDefinition | null>;
-    /**
-     * 若实现，可用 `SELECT MAX(lamportClock)` 避免为时钟扫描全量消息。
-     */
-    getMaxLamportClockForConversation?(conversationId: string): Promise<number>;
-    saveAgentInstance(meta: AgentInstanceMeta): Promise<void>;
-    /**
-     * 读取会话目录行（用于 TaskAgent 解析 definitionId 等）。
-     */
-    getConversationMeta(conversationId: string): Promise<ConversationMeta | null>;
-    /** IM 用户与会话绑定（memeloop-cli + SQLite 持久化）。 */
-    getImBinding?(channelId: string, imUserId: string): Promise<IMChannelBinding | null>;
-    setImBinding?(record: IMChannelBinding): Promise<void>;
-}
-interface MemeLoopLogger {
-    debug?(message: string, ...arguments_: unknown[]): void;
-    info?(message: string, ...arguments_: unknown[]): void;
-    warn?(message: string, ...arguments_: unknown[]): void;
-    error?(message: string, ...arguments_: unknown[]): void;
-}
-interface ILLMProvider {
-    name: string;
-    model?: unknown;
-    chat(request: unknown): AsyncIterable<unknown> | Promise<unknown>;
-}
-/**
- * LLM Provider interface - now compatible with Vercel AI SDK's LanguageModelV1.
- * The `model` field holds the actual LanguageModelV1 instance from @ai-sdk/openai, @ai-sdk/anthropic, etc.
- */
-interface IToolRegistry {
-    registerTool(id: string, impl: unknown): void;
-    getTool(id: string): unknown | undefined;
-    listTools(): string[];
-    /**
-     * Prompt-concat 插件表（defineTool 注册的 `PromptConcatTool`），按运行时隔离。
-     * 未实现时回退到进程级默认注册表（见 pluginRegistry）。
-     */
-    getPromptPlugins?: () => Map<string, (hooks: PromptConcatHooks) => void>;
-}
-interface IChatSyncAdapter {
-    start(): Promise<void>;
-    stop(): Promise<void>;
-}
-interface INetworkService {
-    start(): Promise<void>;
-    stop(): Promise<void>;
-}
-interface LlmIoLoopOptions {
-    /** 最大 LLM↔工具往返次数，0 表示不限制（仍受内部安全上限约束） */
-    maxIterations?: number;
-    /** 是否解析 `<tool_use>` / `<function_call>` 并通过 IToolRegistry 执行（默认 true） */
-    enableToolLoop?: boolean;
-    /** 取消检查（例如用户点停止）；按会话维度 */
-    isCancelled?: (conversationId: string) => boolean;
-    /** promptConcat 附件注入（与 PromptConcatOptions 一致） */
-    readAttachmentFile?: (path: string) => Promise<Uint8Array | Buffer>;
-    /** 超过该时长的历史消息不送入 LLM（毫秒）；0 或未设置表示不裁剪 */
-    maxHistoryAgeMs?: number;
-    /**
-     * 在已配置 `defineTool` / plugins 时，对未被 `onResponseComplete` 处理的 tool 调用回退到 `IToolRegistry`（默认 true）。
-     */
-    fallbackRegistryTools?: boolean;
-    /**
-     * 工具权限规则（默认 allow）。
-     * 支持 wildcard，如 "terminal.*" / "file.read"。
-     */
-    toolPermissions?: {
-        default?: 'allow' | 'ask' | 'deny';
-        rules?: Array<{
-            pattern: string;
-            action: 'allow' | 'ask' | 'deny';
-        }>;
-        perAgent?: Record<string, {
-            default?: 'allow' | 'ask' | 'deny';
-            rules?: Array<{
-                pattern: string;
-                action: 'allow' | 'ask' | 'deny';
-            }>;
-        }>;
-    };
-    /** 相同 tool+input 连续触发阈值（默认 3） */
-    doomLoopThreshold?: number;
-    /** 历史压缩窗口：超过后只保留最近 N 条 + 最后一条用户消息 */
-    contextCompaction?: {
-        maxMessages?: number;
-        replayLastUserMessage?: boolean;
-    };
-    /**
-     * Auto-compaction: when message count exceeds threshold, summarizes old
-     * conversation turns via truncation or LLM summarization. Default: disabled.
-     */
-    autoCompact?: {
-        /** Trigger compaction when message count exceeds this (default: 50) */
-        threshold?: number;
-        /** Number of recent turns to preserve (default: 4) */
-        recentTurnsToKeep?: number;
-        /** Maximum token estimate before compaction; 0 disables token-based compaction */
-        maxTokens?: number;
-    };
-    /** Session checkpoint: save conversation history after each turn for resume. */
-    sessionCheckpoint?: {
-        /** Enable checkpoint saves. Default: false. */
-        enabled?: boolean;
-        /** Store provided by the runtime host. */
-        store?: CheckpointStore;
-        /** Custom checkpoint directory (default: ~/.memeloop/sessions/) */
-        directory?: string;
-    };
-    /**
-     * After a tool returns `__memeloopToolResult.awaitSessionId`, TaskAgent waits here before the next LLM round
-     * (terminal `mode: 'await'`).
-     */
-    waitForTerminalSession?: (sessionId: string) => Promise<{
-        exitCode: number | null;
-        truncatedOutput: string;
-    }>;
-}
-interface AgentFrameworkContext {
-    storage: IAgentStorage$1;
-    llmProvider: ILLMProvider;
-    tools: IToolRegistry;
-    syncAdapters: IChatSyncAdapter[];
-    network: INetworkService;
-    /** Let host runtimes preserve platform-specific message aliases/metadata while core owns the loop. */
-    normalizeMessage?: (message: ChatMessage) => ChatMessage;
-    /** TaskAgent ReAct 行为（从 TidGi-Desktop taskAgent 迁移） */
-    taskAgent?: LlmIoLoopOptions;
-    /**
-     * 由宿主注入（如 memeloop-cli）：存在时 `createMemeLoopRuntime` 在用户发消息后运行完整 TaskAgent 管线。
-     */
-    runTaskAgent?: (input: AgentLoopInput) => AgentLoopGenerator;
-    /** Run a child agent for orchestration loops such as SubAgent_Loop. */
-    runChildAgent?: AgentLoopRuntime['runChildAgent'];
-    /**
-     * Build the agent view supplied to defineTool hooks for a conversation.
-     */
-    resolveAgentRuntimeView?: (conversationId: string, messages: ChatMessage[]) => Promise<AgentInstanceModel>;
-    /**
-     * defineTool / TidGi 兼容：当前轮次的 agent 视图（`agent.messages` 与 `ChatMessage` 由 TaskAgent 同步）。
-     */
-    agent?: {
-        id: string;
-        messages: ChatMessage[];
-    };
-    /** 将 `ChatMessage` 持久化（可选，由 runtime 注入） */
-    persistAgentMessage?: (message: ChatMessage) => Promise<void>;
-    /**
-     * 由 `createMemeLoopRuntime` 写入取消标记，`taskAgent.isCancelled` 应与此集合一致（如 memeloop-cli）。
-     */
-    conversationCancellation?: Set<string>;
-    /**
-     * 解析 AgentDefinition（如节点合并 YAML + 内置 + SQLite）。未设置时仅用 `storage.getAgentDefinition`。
-     */
-    resolveAgentDefinition?: (definitionId: string) => Promise<AgentDefinition | null>;
-    /** 未注入时 TaskAgent 等对关键路径使用 console.warn/error。 */
-    logger?: MemeLoopLogger;
-    /** TidGi defineTool compatibility: legacy plugins call this without arguments. */
-    isCancelled?: () => boolean;
-}
-type AgentInstanceState = 'submitted' | 'working' | 'input-required' | 'completed' | 'canceled' | 'failed' | 'unknown';
-interface AgentInstanceLatestStatus {
-    state: AgentInstanceState;
-    message?: ChatMessage;
-    /** Human-readable sub-status for the header — shown while agent is working. */
-    progress?: string;
-    created?: Date;
-    modified?: Date;
-}
-interface AgentInstanceModel extends Omit<AgentDefinition, 'name'> {
-    agentDefId: string;
-    name?: string;
-    agentFrameworkConfig?: AgentFrameworkConfig;
-    messages: ChatMessage[];
-    status: AgentInstanceLatestStatus;
-    created: Date;
-    modified?: Date;
-    closed?: boolean;
-    volatile?: boolean;
-    isSubAgent?: boolean;
-    parentAgentId?: string;
-}
-
-declare function isUserInitiatedConversation(meta: ConversationMeta): boolean;
-declare function createInstanceDeltaFromDefinition(definition: AgentDefinition, overrides: Partial<AgentDefinition>): Partial<AgentDefinition>;
-
-interface AttachmentReference {
-    contentHash: string;
-    filename: string;
-    mimeType: string;
-    size: number;
-}
-type ChatRole = 'user' | 'assistant' | 'tool' | 'agent' | 'error';
-interface ToolCall {
-    id: string;
-    toolName: string;
-    arguments: unknown;
-}
-/** Points to large tool output stored elsewhere (sub-agent log, terminal session, file). */
-type DetailRefType = 'sub-agent' | 'terminal-session' | 'file';
-interface DetailReference {
-    type: DetailRefType;
-    /** Sub-agent / spawn / remote conversation id */
-    conversationId?: string;
-    /** Terminal session id (often paired with `terminal:<sessionId>` conversation) */
-    sessionId?: string;
-    /** Node that holds the detail payload */
-    nodeId?: string;
-    /** e.g. `memeloop://node/.../file/...` from `buildMemeloopFileUri` in `../network/uri.js` */
-    fileUri?: string;
-    exitCode?: number;
-}
-interface ChatMessage {
-    messageId: string;
-    conversationId: string;
-    originNodeId: string;
-    timestamp: number;
-    lamportClock: number;
-    role: ChatRole;
-    content: string;
-    toolCalls?: ToolCall[];
-    attachments?: AttachmentReference[];
-    /** Summary lives in `content`; full payload fetched via detail ref (plan §5.2.1). */
-    detailRef?: DetailReference;
-    /** Reasoning/thinking content */
-    reasoning_content?: string;
-    /** Content MIME type */
-    contentType?: string;
-    /** Whether message should be hidden in UI */
-    hidden?: boolean;
-    /** Message processing duration in ms */
-    duration?: number | null;
-    /** Additional metadata */
-    metadata?: Record<string, unknown>;
-}
-
-/**
- * Domain factories for creating canonical ChatMessage and AgentInstance objects.
- *
- * These factories ensure that every host (Desktop, Mobile, CLI, Cloud)
- * constructs messages and instances with the same required fields,
- * default values, and clock behavior.
- *
- * Hosts that need a different originNodeId, message ID scheme, or lamport
- * clock source should pass those values explicitly rather than creating
- * their own factory.
- */
-
-/**
- * Create a canonical ChatMessage with required defaults.
- *
- * @param input.messageId - Unique message identifier. Use nanoid or equivalent.
- * @param input.conversationId - The conversation/agent-instance this message belongs to.
- * @param input.role - Message role (user, assistant, tool, agent, error).
- * @param input.content - Message text content.
- * @param input.originNodeId - Node that originated this message. Core default is "unknown";
- *   hosts should pass their own identifier (e.g. "tidgi-desktop", "memeloop-cli").
- * @param input.contentType - MIME type override (default "text/plain").
- * @param input.metadata - Optional metadata map.
- * @param input.duration - Processing duration in ms.
- * @param input.lamportClock - Lamport clock value. Defaults to `Date.now()`.
- * @param input.toolCalls - Tool calls associated with assistant messages.
- * @param input.reasoning_content - Reasoning/thinking content.
- * @param input.hidden - Whether the message is hidden from the UI.
- * @param input.detailRef - Reference to large tool output stored elsewhere.
- */
-declare function createChatMessage(input: {
-    messageId: string;
-    conversationId: string;
-    role: ChatRole;
-    content: string;
-    originNodeId?: string;
-    contentType?: string;
-    metadata?: Record<string, unknown>;
-    duration?: number | null;
-    lamportClock?: number;
-    toolCalls?: ChatMessage['toolCalls'];
-    reasoning_content?: string;
-    hidden?: boolean;
-    attachments?: ChatMessage['attachments'];
-    detailRef?: ChatMessage['detailRef'];
-}): ChatMessage;
-/**
- * Create an AgentInstance from an AgentDefinition.
- *
- * The returned instance has an empty message list, a default "completed"
- * status, and copies all definition-level fields as instance defaults.
- *
- * @param definition - The AgentDefinition to base the instance on.
- * @param overrides - Optional overrides for instance-specific fields:
- *   - `id`: Instance ID (default: nanoid-equivalent, must be provided by host)
- *   - `name`: Display name (default: definition.name)
- *   - `status`: Initial status
- *   - `volatile`: Whether the instance is ephemeral
- *   - `closed`: Whether closed on creation
- *   - `isSubAgent`, `parentAgentId`: Sub-agent relationship
- *   - `agentFrameworkConfig`: Per-instance framework config override
- */
-declare function createAgentInstanceFromDefinition(definition: AgentDefinition, overrides: {
-    id: string;
-    name?: string;
-    status?: AgentInstanceLatestStatus;
-    volatile?: boolean;
-    closed?: boolean;
-    isSubAgent?: boolean;
-    parentAgentId?: string;
-    agentFrameworkConfig?: AgentFrameworkConfig;
-}): AgentInstanceModel;
-
-interface CompactionOptions {
-    /** Maximum token count to aim for after compaction (estimated by char count / 3.5). Default: 0 (no limit). */
-    maxTokens?: number;
-    /** Number of recent message turns (user+assistant pairs) to preserve. Default: 4. */
-    recentTurnsToKeep?: number;
-    /** Whether to attempt LLM summarization. Falls back to truncation if LLM unavailable or fails. Default: true. */
-    useLlmSummary?: boolean;
-    /** Optional LLM provider for summarization. */
-    llmProvider?: ILLMProvider;
-}
-interface CompactionResult {
-    /** Compacted messages (summary + recent turns). */
-    messages: ChatMessage[];
-    /** True if compaction reduced the message count. */
-    compacted: boolean;
-    /** Number of messages dropped. */
-    droppedCount: number;
-    /** Summary text generated or fallback notice. */
-    summaryText: string;
-}
-/**
- * Deterministic compaction: keeps recent N turns and replaces older messages
- * with a single summary message.
- */
-declare function compactMessages(messages: ChatMessage[], options?: Omit<CompactionOptions, 'llmProvider' | 'useLlmSummary'>): CompactionResult;
-/**
- * Checks whether compaction is needed based on message count threshold.
- * @returns true if message count exceeds threshold (default 50).
- */
-declare function shouldCompact(messages: ChatMessage[], threshold?: number): boolean;
-/**
- * Auto-compact: estimates token usage, and if it exceeds maxTokens,
- * performs compaction to keep the context within bounds.
- *
- * Uses the LLM provider for summarization if available, falling back to
- * simple truncation + turn counting.
- */
-declare function autoCompact(messages: ChatMessage[], options?: CompactionOptions): Promise<CompactionResult>;
-
-/**
- * TaskAgent：TidGi `basicPromptConcatHandler` 对齐版。
- *
- * - defineTool：`createHooksWithPlugins` + `responseComplete` + `responseConcat`（postProcess）
- * - 回退：`IToolRegistry` 执行未被插件处理的 tool 调用
- */
-declare function createTaskAgent(context: AgentFrameworkContext): (input: AgentLoopInput) => AgentLoopGenerator;
-
-/**
- * LLM_IO_Loop runner — convenience API for driving a full loop turn.
- */
-
-interface RunTaskAgentTurnCallbacks {
-    onStep?: (step: AgentLoopStep) => void | Promise<void>;
-    onProgress?: (status: string, data: Record<string, unknown>, step: AgentLoopStep) => void | Promise<void>;
-    taskAgent?: (input: AgentLoopInput) => AgentLoopGenerator;
-}
-interface RunTaskAgentTurnResult {
-    state: AgentInstanceState;
-    stepCount: number;
-}
-declare function resolveTaskAgentTerminalState(step: AgentLoopStep, current: AgentInstanceState): AgentInstanceState;
-declare function runTaskAgentTurn(context: AgentFrameworkContext, input: AgentLoopInput, callbacks?: RunTaskAgentTurnCallbacks): Promise<RunTaskAgentTurnResult>;
-
-/**
- * Built-in loop registrations — installed at startup so getLoopRegistry().createRunner('llm-io') works.
- *
- * This module allows hosts to skip manual registerLoop() for the built-in loop types.
- * Hosts can still override by calling registerLoop() with the same id after.
- */
-declare const LLM_IO_LOOP_ID = "llm-io";
-declare const SUB_AGENT_LOOP_ID: string;
-/**
- * Register the default built-in loops (llm-io and sub-agent) with the loop registry.
- * Safe to call multiple times — skips already-registered loops.
- */
-declare function registerBuiltinLoops(): void;
-
-/**
- * Builtin tool plugins — registers core tools as LoopPlugin entries.
- *
- * Each tool is a separate LoopPlugin that can be overridden by user/host plugins
- * with the same id. The plugin.install callback calls the tool registry to
- * register the tool implementation.
- *
- * These are registered in the loop registry at startup and loaded by
- * `registerBuiltinTools` via plugin discovery.
- */
-
-declare const PLUGIN_MCP_CLIENT = "builtin:mcp-client";
-declare const PLUGIN_MCP_FORWARD = "builtin:mcp-forward";
-declare const PLUGIN_SPAWN_AGENT = "builtin:spawn-agent";
-declare const PLUGIN_REMOTE_AGENT = "builtin:remote-agent";
-declare const PLUGIN_ASK_QUESTION = "builtin:ask-question";
-declare const PLUGIN_TODO_WRITE = "builtin:todo-write";
-declare const PLUGIN_ASK_USER_QUESTION = "builtin:ask-user-question";
-declare const PLUGIN_TASK = "builtin:task";
-declare const BUILTIN_TOOL_PLUGIN_IDS: readonly ["builtin:mcp-client", "builtin:mcp-forward", "builtin:spawn-agent", "builtin:remote-agent", "builtin:ask-question", "builtin:todo-write", "builtin:ask-user-question", "builtin:task"];
-declare function getBuiltinToolPlugins(): LoopPlugin[];
-/** Register all builtin tool plugins with the loop registry. */
-declare function registerBuiltinToolPlugins(): void;
-
-/**
- * Agent loop registry.
- *
- * Discovers, registers, and resolves loop types, loop profiles, and loop plugins.
- * Core does NOT hard-import any loop implementation; all are registered by host or plugin.
- */
-
-type LoopPluginSelection = string | LoopProfilePluginEntry;
-declare class LoopRegistryImpl {
-    private readonly loops;
-    private readonly profiles;
-    private readonly plugins;
-    registerLoop(definition: AgentLoopDefinition): void;
-    getLoop(id: string): AgentLoopDefinition | undefined;
-    listLoops(): AgentLoopDefinition[];
-    registerProfile(profile: LoopProfile): void;
-    getProfile(id: string): LoopProfile | undefined;
-    listProfiles(): LoopProfile[];
-    registerPlugin(plugin: LoopPlugin): void;
-    getPlugin(id: string): LoopPlugin | undefined;
-    listPlugins(): LoopPlugin[];
-    installPluginsForLoop(loopId: string, target: {
-        [key: string]: unknown;
-    }, selected?: LoopPluginSelection[]): void;
-    installPluginsForProfile(profile: LoopProfile, target: {
-        [key: string]: unknown;
-    }): void;
-    createRunnerForProfile(profile: LoopProfile, context?: {
-        [key: string]: unknown;
-    }): ((input: AgentLoopInput) => AgentLoopGenerator) | null;
-    createRunner(loopId: string, context?: {
-        [key: string]: unknown;
-    }): ((input: AgentLoopInput) => AgentLoopGenerator) | null;
-    reset(): void;
-}
-declare function getLoopRegistry(): LoopRegistryImpl;
-declare function resetLoopRegistry(): void;
-
-/**
- * SubAgent_Loop — a loop that orchestrates child agents.
- *
- * This loop does NOT call the LLM directly. Instead it coordinates child agents:
- * - running a child agent and feeding its result to another child agent (review / verify)
- * - splitting work across multiple parallel child agents
- * - looping back to a child agent with feedback when a reviewer rejects the output
- *
- * The loop script (.mjs) holds the orchestration logic. This file provides the
- * runtime that invokes the script and manages child agent runs.
- */
-
-interface SubAgentLoopScriptArguments {
-    input: AgentLoopInput;
-    context: SubAgentLoopContext;
-    profile?: LoopProfile;
-    runtime?: Partial<AgentLoopRuntime>;
-    runAgent: (input: SubAgentRunAgentInput) => Promise<SubAgentRunAgentResult>;
-    runAgents: (inputs: SubAgentRunAgentInput[]) => Promise<SubAgentRunAgentResult[]>;
-    emit: (step: AgentLoopStep) => void;
-    finish: (message: string | AgentLoopStep) => void;
-    isCancelled: () => boolean;
-    log: (event: string, data?: Record<string, unknown>) => void;
-    state: AgentLoopRuntime['state'];
-    checkpoint: AgentLoopRuntime['checkpoint'];
-}
-interface SubAgentRunAgentInput {
-    /** Child profile id. `profile` is accepted as an ergonomic alias for scripts. */
-    profileId?: string;
-    profile?: string;
-    prompt: string;
-    conversationId?: string;
-}
-interface SubAgentRunAgentResult {
-    profileId: string;
-    conversationId: string;
-    steps: AgentLoopStep[];
-    text: string;
-}
-type SubAgentLoopScriptResult = AgentLoopGenerator | AgentLoopStep | AgentLoopStep[] | string | undefined;
-type SubAgentLoopScript = (scriptArguments: SubAgentLoopScriptArguments) => SubAgentLoopScriptResult | Promise<SubAgentLoopScriptResult>;
-interface SubAgentLoopContext {
-    [key: string]: unknown;
-    profile?: LoopProfile;
-    runtime?: Partial<AgentLoopRuntime>;
-    childProfiles?: string[];
-    script?: SubAgentLoopScript;
-    loadScript?: (script: string, context: SubAgentLoopContext) => SubAgentLoopScript | Promise<SubAgentLoopScript>;
-}
-/**
- * Create the SubAgent_Loop definition and register it with the loop registry.
- */
-declare function createSubAgentLoopDefinition(): AgentLoopDefinition;
-/** Export loop id for consumers. */
-declare function getSubAgentLoopId(): string;
-
-interface LoadSubAgentLoopScriptOptions {
-    importModule?: (specifier: string) => Promise<unknown>;
-}
-declare function loadSubAgentLoopScript(scriptSpecifier: string, options?: LoadSubAgentLoopScriptOptions): Promise<SubAgentLoopScript>;
-
-interface TokenTrackerConfig {
-    /** Maximum context window in tokens (default: 200000) */
-    contextWindow?: number;
-    /** Trigger compaction when usage exceeds this fraction (default: 0.90) */
-    compactionThreshold?: number;
-    /** Buffer tokens reserved for output (default: 16000) */
-    outputBuffer?: number;
-}
-interface TokenUsage {
-    promptTokens: number;
-    completionTokens: number;
-    totalTokens: number;
-    contextWindow: number;
-    usagePercent: number;
-    shouldCompact: boolean;
-}
-/**
- * Tracks token usage and decides when to trigger auto-compaction.
- */
-declare class TokenTracker {
-    private promptTokens;
-    private completionTokens;
-    private readonly contextWindow;
-    private readonly compactionThreshold;
-    private readonly outputBuffer;
-    private compacting;
-    private consecutiveCompactionFailures;
-    private maxConsecutiveFailures;
-    constructor(config?: TokenTrackerConfig);
-    /** Record token usage from an LLM response */
-    recordUsage(promptTokens: number, completionTokens: number): void;
-    /** Manually set the prompt token count (e.g., from estimation) */
-    setPromptTokens(tokens: number): void;
-    /** Get current usage */
-    getUsage(): TokenUsage;
-    /** Check if auto-compaction should be triggered */
-    shouldTriggerCompaction(): boolean;
-    /** Mark that compaction is starting */
-    markCompactionStart(): void;
-    /** Mark that compaction succeeded — reset token counts */
-    markCompactionSuccess(estimatedPostTokens: number): void;
-    /** Mark that compaction failed */
-    markCompactionFailure(): void;
-    /** Reset all counters */
-    reset(): void;
-    /** Get a human-readable summary */
-    formatUsage(): string;
-}
-
-interface CreateAgentOptions {
-    definitionId: string;
-    initialMessage?: string;
-}
-interface SendMessageOptions {
-    conversationId: string;
-    message: string;
-}
-interface MemeLoopRuntime {
-    createAgent(options: CreateAgentOptions): Promise<{
-        conversationId: string;
-    }>;
-    sendMessage(options: SendMessageOptions): Promise<void>;
-    cancelAgent(conversationId: string): Promise<void>;
-    subscribeToUpdates(conversationId: string, listener: (update: unknown) => void): () => void;
-}
-declare function createMemeLoopRuntime(context: AgentFrameworkContext): MemeLoopRuntime;
-
-/**
- * 将节点 RPC `memeloop.storage.getAttachmentBlob` 的返回值解码为同步引擎可用的 BLOB。
- */
-declare function decodeAttachmentBlobRpc(result: unknown): {
-    data: Uint8Array;
-    filename: string;
-    mimeType: string;
-    size: number;
-} | null;
-
-interface ChatSyncPeer {
-    nodeId: string;
-    /**
-     * 取远端当前的 versionVector，并返回对方缺失的会话元数据。
-     */
-    exchangeVersionVector(localVersion: Record<string, number>): Promise<{
-        remoteVersion: Record<string, number>;
-        missingForRemote: ConversationMeta[];
-    }>;
-    /**
-     * 将本地缺失的 metadata 从该 peer 拉回来。
-     */
-    pullMissingMetadata(sinceVersion: Record<string, number>): Promise<ConversationMeta[]>;
-    /**
-     * 按需拉取消息正文（TidGi / 审查单 Phase 4：消息级同步）。
-     * 返回远端有而本地 unknownMessageIds 之外的新消息。
-     */
-    pullMissingMessages?(conversationId: string, knownMessageIds: string[]): Promise<ChatMessage[]>;
-    /**
-     * 按 contentHash 拉取附件二进制（与 `ChatMessage.attachments` / `AttachmentRef` 对齐）。
-     * 典型实现：对 peer 发 `memeloop.storage.getAttachmentBlob` RPC。
-     */
-    pullAttachmentBlob?(contentHash: string): Promise<{
-        data: Uint8Array;
-        filename: string;
-        mimeType: string;
-        size: number;
-    } | null>;
-}
-interface ChatSyncEngineOptions {
-    nodeId: string;
-    storage: IAgentStorage$1;
-    peers: () => ChatSyncPeer[];
-}
-declare class ChatSyncEngine {
-    private readonly nodeId;
-    private readonly storage;
-    private readonly getPeers;
-    private versionVector;
-    constructor(options: ChatSyncEngineOptions);
-    /**
-     * 在本节点新产生一条消息时调用，增加本节点的 lamportClock。
-     */
-    bumpLocalVersion(): void;
-    /**
-     * 执行一次与所有 peer 的增量同步（metadata 级别），并尽力拉取缺失消息。
-     */
-    syncOnce(): Promise<void>;
-    /**
-     * Anti-entropy：先 syncOnce，再对已知会话逐个向各 peer 拉取缺失消息（参考审查单「定期对账」）。
-     */
-    antiEntropyOnce(): Promise<void>;
-    private pullMessagesForConversationFromPeers;
-    /** 从消息元数据收集 `attachments[].contentHash`，对本地缺失 BLOB 的哈希向各 peer 拉取并 `saveAttachment`。 */
-    private ensureAttachmentsFromMessages;
-    getVersionVector(): Record<string, number>;
-    getStorage(): IAgentStorage$1;
-}
-
-interface PeerNodeTransport {
-    nodeId: string;
-    exchangeVersionVector(targetNodeId: string, localVersion: Record<string, number>): Promise<{
-        remoteVersion: Record<string, number>;
-        missingForRemote: ConversationMeta[];
-    }>;
-    pullMissingMetadata(targetNodeId: string, sinceVersion: Record<string, number>): Promise<ConversationMeta[]>;
-    pullMissingMessages?(targetNodeId: string, conversationId: string, knownMessageIds: string[]): Promise<ChatMessage[]>;
-    /** 从指定节点拉取附件 BLOB（如 `memeloop.storage.getAttachmentBlob`）。 */
-    pullAttachmentBlob?(targetNodeId: string, contentHash: string): Promise<{
-        data: Uint8Array;
-        filename: string;
-        mimeType: string;
-        size: number;
-    } | null>;
-}
-declare class PeerNodeSyncAdapter implements ChatSyncPeer {
-    readonly nodeId: string;
-    private readonly transport;
-    constructor(nodeId: string, transport: PeerNodeTransport);
-    exchangeVersionVector(localVersion: Record<string, number>): Promise<{
-        remoteVersion: Record<string, number>;
-        missingForRemote: ConversationMeta[];
-    }>;
-    pullMissingMetadata(sinceVersion: Record<string, number>): Promise<ConversationMeta[]>;
-    pullMissingMessages(conversationId: string, knownMessageIds: string[]): Promise<ChatMessage[]>;
-    pullAttachmentBlob(contentHash: string): Promise<{
-        data: Uint8Array;
-        filename: string;
-        mimeType: string;
-        size: number;
-    } | null>;
-}
-
-/**
- * Built-in Loop Profiles.
- *
- * Each profile defines which agent loop to run, which .mjs script to load,
- * which prompts, plugins, and hook plugins to enable.
- *
- * Replaces the old `src/prompt/loadBuiltins.ts`.
- */
-
-/** Get all built-in Loop Profiles. */
-declare function getBuiltinLoopProfiles(): LoopProfile[];
-/** Get a built-in Loop Profile by id. */
-declare function getBuiltinLoopProfile(id: string): LoopProfile | undefined;
-
-/**
- * Extended agent definition used by the agent profile registry.
- * Wraps the protocol-level AgentDefinition with additional runtime metadata.
- */
-interface AgentProfile {
-    /** Unique ID for this agent (matches protocol id convention like "memeloop:build") */
-    id: string;
-    /** Display name */
-    name: string;
-    /** Agent type / role */
-    type: AgentProfileType;
-    /** System prompt / instructions for the agent */
-    prompt: string;
-    /** Tool permission rules (mutually exclusive with permissive defaults) */
-    permissions: ToolPermissionRules;
-    /** Optional model override (provider/model string) */
-    model?: string;
-    /** Underlying protocol-compatible definition for framework integration */
-    protocolDef: AgentDefinition;
-}
-type AgentProfileType = 'build' | 'plan' | 'explore' | 'oracle' | 'librarian';
-interface ToolPermissionRules {
-    /** Default action for tools not matching any rule */
-    default: 'allow' | 'ask' | 'deny';
-    /** Per-tool or wildcard rules */
-    rules: Array<{
-        pattern: string;
-        action: 'allow' | 'ask' | 'deny';
-    }>;
-}
-/**
- * Build agent: full access, default model.
- * Primary agent for executing tasks, writing code, running commands.
- */
-declare const buildAgent: AgentProfile;
-/**
- * Plan agent: read-only, denies file edits and terminal execution.
- * Used for high-level planning and task decomposition.
- */
-declare const planAgent: AgentProfile;
-/**
- * Explore agent: read + search tools only.
- * Fast search and codebase exploration without modification.
- */
-declare const exploreAgent: AgentProfile;
-/**
- * Oracle agent: read-only, for architecture consultation and code review.
- */
-declare const oracleAgent: AgentProfile;
-/**
- * Librarian agent: read + web search tools only.
- * External documentation lookup and context gathering.
- */
-declare const librarianAgent: AgentProfile;
-/** Built-in agent profiles used by the task delegation tool. */
-declare const BUILTIN_AGENT_PROFILES: AgentProfile[];
-
-/**
- * Registry for agent profiles used by task delegation.
- * Pre-seeded with built-in profiles (build, plan, explore, oracle, librarian).
- */
-declare class AgentProfileRegistry {
-    private readonly profiles;
-    constructor();
-    /** Seed the registry with built-in agent profiles. */
-    private seedDefaults;
-    /**
-     * Register a new agent profile or override an existing one.
-     * Throws if the profile is invalid.
-     */
-    registerAgentProfile(profile: AgentProfile): void;
-    /**
-     * Get an agent profile by ID.
-     * Returns undefined if not found.
-     */
-    getAgentProfile(id: string): AgentProfile | undefined;
-    /**
-     * List all registered agent profiles.
-     */
-    listAgentProfiles(): AgentProfile[];
-    /**
-     * List agent profiles filtered by type.
-     */
-    listAgentProfilesByType(type: AgentProfileType): AgentProfile[];
-    /**
-     * Remove an agent profile by ID.
-     */
-    unregisterAgentProfile(id: string): boolean;
-    /**
-     * Reset the registry to only built-in defaults.
-     */
-    reset(): void;
-}
-declare function getAgentProfileRegistry(): AgentProfileRegistry;
-declare function resetAgentProfileRegistry(): void;
-
-/**
- * Task category system for routing tasks to appropriate agent configurations.
- * Each category maps to a model, temperature, and description for delegation decisions.
- */
-type TaskCategory = 'visual-engineering' | 'ultrabrain' | 'artistry' | 'quick' | 'unspecified-low' | 'unspecified-high' | 'writing';
-interface CategoryConfig {
-    /** Model identifier (e.g., "default", "gpt-4o", "claude-opus") */
-    model: string;
-    /** LLM temperature (0.0 = deterministic, 1.0 = creative) */
-    temperature: number;
-    /** Human-readable description of the category's purpose */
-    description: string;
-}
-/**
- * Get the configuration for a task category.
- * @throws {Error} if the category is unknown
- */
-declare function getCategoryConfig(category: TaskCategory): CategoryConfig;
-/**
- * Type guard: check if a string is a valid TaskCategory.
- */
-declare function isTaskCategory(value: string): value is TaskCategory;
-/** All registered category identifiers (read-only). */
-declare const ALL_CATEGORIES: TaskCategory[];
-/**
- * Resolve a category string (or fallback to "unspecified-low").
- * Never throws; always returns a valid config.
- */
-declare function resolveCategory(category: string): CategoryConfig;
-
-/**
- * Convert TiddlyWiki tiddler fields into memeloop AgentDefinition.
- *
- * Tiddlers tagged `$:/tags/AI/Template` carry agent configuration in their text field (JSON).
- * This pure function handles the parsing and field mapping.
- */
-
-/** Minimal tiddler fields shape consumed by the converter. */
-interface TiddlerFieldsForAgent {
-    title: string;
-    text?: string;
-    caption?: string;
-    description?: string;
-    avatar_url?: string;
-    handler_id?: string;
-    agentFrameworkID?: string;
-    ai_api_config?: string | Record<string, unknown>;
-    agent_tools?: string | unknown[];
-}
-/**
- * Validate and convert a wiki tiddler to an AgentDefinition.
- * Returns null if the tiddler cannot be parsed.
- */
-declare function tiddlerToAgentDefinition(tiddler: TiddlerFieldsForAgent, workspaceName?: string): AgentDefinition | null;
-
-/**
- * Headless agent management contracts.
- *
- * Environment-neutral interfaces for managing agent definitions, agent instances,
- * conversations, prompt previews, and scheduled tasks.
- *
- * Designed to be consumed by:
- * - Desktop (via Electron IPC adapters)
- * - Cloud (via REST API adapters)
- * - CLI (via Ink + local or remote adapters)
- */
-
-/** Attachment metadata for a wiki tiddler selected in the composer. */
-interface WikiTiddlerAttachment {
-    workspaceName: string;
-    tiddlerTitle: string;
-}
-/** Data passed when a wiki tiddler chip is clicked in a message. */
-interface WikiTiddlerClickData {
-    workspaceId: string;
-    workspaceName: string;
-    tiddlerTitle: string;
-    renderedContent?: string;
-}
-/** Storage contract for agent definition CRUD and template queries. */
-interface AgentDefinitionRepository {
-    createAgentDef(agent: AgentDefinition): Promise<AgentDefinition>;
-    updateAgentDef(agent: Partial<AgentDefinition> & {
-        id: string;
-    }): Promise<AgentDefinition>;
-    getAgentDefs(): Promise<AgentDefinition[]>;
-    getAgentDef(id?: string): Promise<AgentDefinition | undefined>;
-    getAgentTemplates(): Promise<AgentDefinition[]>;
-    deleteAgentDef(id: string): Promise<void>;
-}
-/** Observable agent runtime metadata exposed to the UI layer. */
-interface AgentRuntimeView {
-    id: string;
-    name: string;
-    agentDefId: string;
-    status: {
-        state: 'idle' | 'working' | 'completed' | 'failed' | 'canceled' | 'input-required';
-        progress?: string;
-    };
-    aiApiConfig?: AgentDefinition['aiApiConfig'];
-    /** If applicable, the agent definition merged with instance overrides. */
-    definition?: AgentDefinition;
-}
-/** Subscription callback for agent updates. */
-type AgentUpdateListener = (update: Partial<AgentRuntimeView>) => void;
-/** Client contract for creating, controlling, and subscribing to agent instances. */
-interface AgentInstanceClient {
-    /**
-     * Create a new agent instance from a definition.
-     * @param agentDefinitionId  The definition ID to instantiate from
-     * @param options             Optional creation flags (e.g. { preview: true })
-     */
-    createAgent(agentDefinitionId: string, options?: {
-        preview?: boolean;
-    }): Promise<{
-        id: string;
-    }>;
-    /**
-     * Fetch a full agent runtime view (messages excluded, available via conversation client).
-     */
-    fetchAgent(agentId: string): Promise<AgentRuntimeView>;
-    /**
-     * Update an agent instance with partial data.
-     */
-    updateAgent(agentId: string, data: Partial<AgentDefinition>): Promise<AgentRuntimeView>;
-    /**
-     * Cancel the current operation for an agent instance.
-     */
-    cancelAgent(agentId: string): Promise<void>;
-    /**
-     * Delete an agent instance and its associated conversation.
-     */
-    deleteAgent(agentId: string): Promise<void>;
-    /**
-     * Subscribe to live updates for an agent instance.
-     * Returns an unsubscribe function.
-     */
-    subscribeToUpdates(agentId: string, listener: AgentUpdateListener): () => void;
-    /**
-     * Get the framework (handler) ID for an agent instance.
-     */
-    getAgentFrameworkId(agentId: string): Promise<string>;
-    /**
-     * Get the JSON Schema for the framework configuration.
-     */
-    getFrameworkConfigSchema(frameworkId: string): Promise<Record<string, unknown>>;
-}
-/** Client contract for conversation operations on an agent instance. */
-interface AgentConversationClient {
-    /** Load all messages for an agent's conversation. */
-    getMessages(agentId: string): Promise<ChatMessage[]>;
-    /** Send a user message to the agent. Returns the list of message IDs that were appended. */
-    sendMessage(agentId: string, content: string, file?: File, wikiTiddlers?: WikiTiddlerAttachment[]): Promise<void>;
-    /** Subscribe to new message notifications. */
-    subscribeToMessages(agentId: string, listener: (message: ChatMessage) => void): () => void;
-    /** Delete an agent turn — removes the user message and all subsequent agent responses. */
-    deleteTurn(userMessageId: string): Promise<string | undefined>;
-    /** Retry an agent turn — delete agent responses and re-send the user message. */
-    retryTurn(userMessageId: string): Promise<void>;
-}
-/** Progress callback for prompt preview generation. */
-interface PromptPreviewProgress {
-    progress: number;
-    step: string;
-    currentPlugin?: string;
-}
-/** Result of a prompt preview generation. */
-interface PromptPreviewResult {
-    flatPrompts: unknown[];
-    processedPrompts: unknown[];
-}
-/** Client contract for generating prompt previews. */
-interface PromptPreviewClient {
-    /**
-     * Generate a preview of the prompt tree for the given agent state.
-     * @param agentFrameworkConfig  The agent's framework configuration
-     * @param messages              Current conversation messages
-     * @param inputText             Optional input text to include in the preview
-     * @param onProgress            Optional progress callback
-     */
-    generatePreview(agentFrameworkConfig: AgentFrameworkConfig, messages: ChatMessage[], inputText?: string, onProgress?: (progress: PromptPreviewProgress) => void): Promise<PromptPreviewResult | null>;
-}
-/** Scheduled task input. */
-interface CreateScheduledTaskInput {
-    agentInstanceId: string;
-    agentDefinitionId: string;
-    name: string;
-    scheduleKind: 'interval' | 'cron' | 'at';
-    schedule: {
-        kind: 'interval';
-        intervalSeconds: number;
-    } | {
-        kind: 'cron';
-        expression: string;
-        timezone?: string;
-    } | {
-        kind: 'at';
-        wakeAtISO: string;
-    };
-    payload?: {
-        message: string;
-    };
-    activeHoursStart?: string;
-    activeHoursEnd?: string;
-    createdBy?: string;
-    enabled?: boolean;
-}
-/** Scheduled task model. */
-interface ScheduledTask {
-    id: string;
-    agentInstanceId: string;
-    agentDefinitionId: string;
-    name: string;
-    schedule: CreateScheduledTaskInput['schedule'];
-    payload?: {
-        message?: string;
-    };
-    activeHoursStart?: string;
-    activeHoursEnd?: string;
-    enabled: boolean;
-    createdBy?: string;
-}
-/** Client contract for managing scheduled tasks. */
-interface ScheduledTaskClient {
-    listScheduledTasksForAgent(agentInstanceId: string): Promise<ScheduledTask[]>;
-    createScheduledTask(input: CreateScheduledTaskInput): Promise<ScheduledTask>;
-    updateScheduledTask(id: string, input: Partial<CreateScheduledTaskInput>): Promise<ScheduledTask>;
-    deleteScheduledTask(id: string): Promise<void>;
-    getCronPreviewDates(expression: string, timezone?: string, count?: number): Promise<string[]>;
-}
-/** State for the "Create New Agent" wizard. */
-interface AgentCreationState {
-    /** Current step index in the creation wizard. */
-    currentStep: number;
-    /** Agent name entered by the user. */
-    agentName: string;
-    /** Selected template definition, if any. */
-    selectedTemplate: AgentDefinition | null;
-    /** Temporary agent definition being built. */
-    temporaryAgentDefinition: AgentDefinition | null;
-    /** ID of the preview agent instance created for testing. */
-    previewAgentId: string | null;
-    /** Whether a loading operation is in progress. */
-    isLoading: boolean;
-    /** JSON Schema for the selected agent framework, if loaded. */
-    promptSchema: Record<string, unknown> | null;
-}
-/** State for the "Edit Agent Definition" view. */
-interface AgentDefinitionEditorState {
-    /** The agent definition being edited. */
-    agentDefinition: AgentDefinition | null;
-    /** Agent name. */
-    agentName: string;
-    /** ID of the preview agent instance. */
-    previewAgentId: string | null;
-    /** Whether a loading operation is in progress. */
-    isLoading: boolean;
-    /** Whether a save operation is in progress. */
-    isSaving: boolean;
-    /** JSON Schema for the selected agent framework, if loaded. */
-    promptSchema: Record<string, unknown> | null;
-}
-/** State for the prompt preview/edit dialog. */
-interface PromptPreviewDialogState {
-    open: boolean;
-    baseMode: 'preview' | 'edit';
-    activeTab: 'flat' | 'tree';
-    loading: boolean;
-    progress: number;
-    currentStep: string;
-    currentPlugin: string | null;
-    result: PromptPreviewResult | null;
-    lastUpdated: Date | null;
-    formFieldsToScrollTo: string[];
-}
-
-/**
- * AgentSessionController — headless controller for an active agent conversation session.
- *
- * Manages agent runtime state, message sending, streaming, delete/retry turns,
- * and subscription to live agent updates.
- *
- * No React, DOM, Electron, MUI, Zustand, or RxJS dependency.
- */
-
-/** Read-only snapshot of the session state. */
-interface AgentSessionSnapshot {
-    agent: AgentRuntimeView | null;
-    loading: boolean;
-    error: Error | null;
-    messages: ChatMessage[];
-    orderedMessageIds: string[];
-    streamingMessageIds: Set<string>;
-}
-/** Listener for snapshot changes. */
-type AgentSessionListener = (snapshot: AgentSessionSnapshot) => void;
-/** Options for creating an AgentSessionController. */
-interface AgentSessionControllerOptions {
-    agentInstanceClient: AgentInstanceClient;
-    conversationClient: AgentConversationClient;
-    /** Polling interval in ms for agent status updates. Default 500. */
-    pollInterval?: number;
-}
-/**
- * Headless controller for an agent conversation session.
- *
- * Call {@link start} to load an agent, then {@link subscribe} to receive snapshot
- * updates. Use {@link sendMessage}, {@link deleteTurn}, {@link retryTurn}, {@link cancel}
- * to drive the conversation.
- *
- * Host UI frameworks (React, Ink) subscribe via {@link subscribe} and render
- * the snapshot.
- */
-declare class AgentSessionController {
-    private readonly options;
-    private listener;
-    private snapshot;
-    private unsubAgentUpdates;
-    private unsubMessages;
-    private pollingTimer;
-    private agentId;
-    constructor(options: AgentSessionControllerOptions);
-    /**
-     * Start a session for the given agent ID.
-     * Fetches the agent, subscribes to live updates, and loads messages.
-     */
-    start(agentId: string): Promise<void>;
-    /** Stop the session and clean up subscriptions. */
-    stop(): void;
-    /** Send a user message. */
-    sendMessage(content: string, file?: File, wikiTiddlers?: WikiTiddlerAttachment[]): Promise<void>;
-    /** Cancel the current agent operation. */
-    cancel(): Promise<void>;
-    /** Delete a turn starting at the given user message ID. */
-    deleteTurn(userMessageId: string): Promise<string | undefined>;
-    /** Retry a turn starting at the given user message ID. */
-    retryTurn(userMessageId: string): Promise<void>;
-    /** Subscribe to snapshot changes. Returns unsubscribe function. */
-    subscribe(listener: AgentSessionListener): () => void;
-    /** Get current snapshot without subscribing. */
-    getSnapshot(): AgentSessionSnapshot;
-    private emitPartial;
-    private handleAgentUpdate;
-    private handleNewMessage;
-    private startPolling;
-    private stopPolling;
-}
-
-/**
- * AgentDefinitionEditorController — headless controller for editing an agent definition.
- *
- * Manages definition loading, autosave, schema loading, preview agent lifecycle,
- * and scheduled task CRUD.
- *
- * No React, DOM, Electron, MUI, Zustand, or RxJS dependency.
- */
-
-/** Partial state emitted to the listener. */
-type EditorStateChange = Partial<AgentDefinitionEditorState>;
-/** Listener for editor state changes. */
-type EditorStateListener = (change: EditorStateChange) => void;
-/** Schedule editor sub-state for the UI layer. */
-interface ScheduleEditorState {
-    mode: 'none' | 'interval' | 'daily' | 'cron';
-    intervalValue: number;
-    intervalUnit: 's' | 'min' | 'h';
-    dailyTime: string;
-    activeHoursStart: string;
-    activeHoursEnd: string;
-    cronExpression: string;
-    timezone: string;
-    message: string;
-    existingTaskId?: string;
-}
-/** Options for creating an AgentDefinitionEditorController. */
-interface AgentDefinitionEditorControllerOptions {
-    definitionRepository: AgentDefinitionRepository;
-    agentInstanceClient: AgentInstanceClient;
-    scheduledTaskClient: ScheduledTaskClient;
-    /** Debounce interval for autosave in ms. Default 1000. */
-    autosaveDebounceMs?: number;
-}
-/**
- * Headless controller for editing an agent definition.
- *
- * Call {@link loadDefinition} to start, then {@link subscribe} for state updates.
- */
-declare class AgentDefinitionEditorController {
-    private readonly options;
-    private listener;
-    private state;
-    private autosaveTimer;
-    constructor(options: AgentDefinitionEditorControllerOptions);
-    /** Load an agent definition and its prompt schema. */
-    loadDefinition(definitionId: string): Promise<void>;
-    /** Update the agent definition field. Triggers debounced autosave. */
-    updateDefinition(change: Partial<AgentDefinition> & {
-        id: string;
-    }): void;
-    /** Force an immediate save to the repository. */
-    saveNow(): Promise<void>;
-    /** Reload the prompt schema for a framework ID. */
-    reloadSchema(frameworkId: string): Promise<void>;
-    /** Get or create a preview agent instance tied to this definition. */
-    private findOrCreatePreviewAgent;
-    loadScheduledTasks(): Promise<ScheduledTask[]>;
-    saveScheduledTask(input: CreateScheduledTaskInput): Promise<ScheduledTask>;
-    deleteScheduledTask(taskId: string): Promise<void>;
-    subscribe(listener: EditorStateListener): () => void;
-    getState(): AgentDefinitionEditorState;
-    private emit;
-    private scheduleAutosave;
-}
-
-/**
- * AgentCreationController — headless controller for the "Create New Agent" wizard.
- *
- * Manages creation wizard state: current step, template selection, temporary
- * agent definition lifecycle, and preview agent setup.
- *
- * No React, DOM, Electron, MUI, Zustand, or RxJS dependency.
- */
-
-/** Listener for creation state changes. */
-type CreationStateListener = (state: AgentCreationState) => void;
-/** Options for creating an AgentCreationController. */
-interface AgentCreationControllerOptions {
-    definitionRepository: AgentDefinitionRepository;
-    agentInstanceClient: AgentInstanceClient;
-    /** Default framework ID for new agents. */
-    defaultFrameworkId?: string;
-}
-/**
- * Headless controller for the agent creation wizard.
- *
- * Call {@link start}, {@link selectTemplate}, {@link nextStep}, etc. to drive
- * the wizard. Subscribe via {@link subscribe} for state updates.
- */
-declare class AgentCreationController {
-    private readonly options;
-    private listener;
-    private state;
-    constructor(options: AgentCreationControllerOptions);
-    /** Initialize the creation wizard, optionally from a saved tab state. */
-    start(definitionId?: string, templateDefinitionId?: string): Promise<void>;
-    /** Select a template for the new agent. */
-    selectTemplate(template: AgentDefinition): void;
-    /** Update the agent name. */
-    setAgentName(name: string): void;
-    /** Advance to the next wizard step. */
-    nextStep(): void;
-    /** Go back to the previous wizard step. */
-    previousStep(): void;
-    /** Set the current wizard step directly. */
-    setStep(step: number): void;
-    /** Update the temporary agent definition. */
-    updateTemporaryDefinition(change: Partial<AgentDefinition>): void;
-    /** Set the prompt schema for the selected framework. */
-    setPromptSchema(schema: Record<string, unknown> | null): void;
-    /**
-     * Create a preview agent instance for the chat-preview step.
-     * Should be called when entering step 2 (or the chat preview step).
-     */
-    createPreviewAgent(definitionId: string): Promise<void>;
-    /**
-     * Finalize creation: persist the temporary definition and create the actual
-     * agent instance. Returns the final agent instance ID, or null on failure.
-     */
-    finalize(): Promise<string | null>;
-    /** Clean up temporary resources. */
-    cleanup(): Promise<void>;
-    subscribe(listener: CreationStateListener): () => void;
-    getState(): AgentCreationState;
-    private emit;
-}
-
-/**
- * PromptPreviewController — headless controller for generating prompt previews.
- *
- * Manages preview dialog state, progress tracking, and result accumulation.
- *
- * No React, DOM, Electron, MUI, Zustand, or RxJS dependency.
- */
-
-/** Listener for preview dialog state changes. */
-type PreviewDialogListener = (state: PromptPreviewDialogState) => void;
-/** Options for creating a PromptPreviewController. */
-interface PromptPreviewControllerOptions {
-    previewClient: PromptPreviewClient;
-}
-/**
- * Headless controller for the prompt preview/edit dialog.
- *
- * Call {@link open}, {@link close}, {@link generate} to drive the dialog.
- * Subscribe via {@link subscribe} for state updates.
- */
-declare class PromptPreviewController {
-    private readonly options;
-    private listener;
-    private state;
-    constructor(options: PromptPreviewControllerOptions);
-    /** Open the dialog with an optional base mode. */
-    open(baseMode?: 'preview' | 'edit'): void;
-    /** Close the dialog. */
-    close(): void;
-    /** Set the active tab in the dialog. */
-    setActiveTab(tab: 'flat' | 'tree'): void;
-    /** Set form fields to scroll to (for edit mode navigation). */
-    setFormFieldsToScrollTo(fieldPaths: string[]): void;
-    /**
-     * Generate a preview of the prompt tree.
-     * @param agentFrameworkConfig  The agent's framework configuration
-     * @param messages              Current conversation messages
-     * @param inputText             Optional input text to include in the preview
-     */
-    generate(agentFrameworkConfig: AgentFrameworkConfig, messages: ChatMessage[], inputText?: string): Promise<PromptPreviewResult | null>;
-    subscribe(listener: PreviewDialogListener): () => void;
-    getState(): PromptPreviewDialogState;
-    private emit;
-}
-
-interface ProviderConfig {
-    name: string;
-    baseUrl?: string;
-    apiKey?: string;
-}
-interface RegisteredProvider {
-    provider: ILLMProvider;
-    config: ProviderConfig;
-}
-declare class ProviderRegistry {
-    private providers;
-    register(provider: ILLMProvider, config?: Omit<ProviderConfig, 'name'>): void;
-    unregister(name: string): void;
-    get(name: string): ILLMProvider | undefined;
-    getConfig(name: string): ProviderConfig | undefined;
-    upsertConfig(config: ProviderConfig): void;
-    list(): string[];
-    listConfigs(): ProviderConfig[];
-    resolve(modelId: string): {
-        provider: ILLMProvider;
-        providerName: string;
-        modelName?: string;
-    };
-}
-
-/**
- * Git HTTP 反向代理目标校验：降低 SSRF 风险（内网/metadata 等）。
- * 仍依赖 getBackendUrl 返回可信基础 URL；此处拦截明显危险的解析结果。
- */
-/** 若目标 URL 不允许作为 Git 代理上游，返回简短原因；否则 null。 */
-declare function gitProxyTargetBlockReason(url: URL): string | null;
-
-declare const MEMELOOP_SERVICE_TYPE = "_memeloop._tcp";
-interface MemeloopServiceInfo {
-    name: string;
-    host: string;
-    port: number;
-    nodeId?: string;
-    wsPath?: string;
-    txt?: Record<string, string>;
-}
-interface LanDiscoveryRegisterOptions {
-    name: string;
-    port: number;
-    nodeId?: string;
-    wsPath?: string;
-    txt?: Record<string, string>;
-}
-interface LanDiscoveryBrowseOptions {
-    onServiceUp: (info: MemeloopServiceInfo) => void;
-    onServiceDown?: (name: string) => void;
-}
-
-type DevicePlatform = 'desktop' | 'mobile' | 'cli';
-type DeviceTrustMode = 'local-pairing' | 'cloud-account';
-type DeviceReachabilityState = 'nearby' | 'online' | 'offline' | 'connecting';
-type DeviceNetworkPath = 'lan' | 'direct' | 'relay';
-type MemeLoopProtocol = '/memeloop/rpc/1.0.0' | '/memeloop/sync/1.0.0' | '/memeloop/agent/1.0.0' | '/memeloop/pairing/1.0.0';
-interface DeviceCapabilities {
-    tools: string[];
-    mcpServers: string[];
-    hasWiki: boolean;
-    imChannels: string[];
-    wikis: Array<{
-        wikiId: string;
-        title?: string;
-        pathHint?: string;
-    }>;
-}
-interface LocalDeviceIdentity {
-    peerId: string;
-    publicKeyMultibase: string;
-    privateKeyRef: string;
-    privateKeyPkcs8Base64Url?: string;
-    privateKeyRawSeedBase64Url?: string;
-    createdAt: number;
-    deviceName: string;
-    platform: DevicePlatform;
-}
-interface DeviceNetworkListenOptions {
-    addresses: string[];
-    announce?: string[];
-}
-interface DeviceReachability {
-    state: DeviceReachabilityState;
-    paths: DeviceNetworkPath[];
-}
-interface Device {
-    peerId: string;
-    displayName: string;
-    platform: DevicePlatform;
-    trustMode: DeviceTrustMode;
-    reachability: DeviceReachability;
-    capabilities: DeviceCapabilities;
-    lastSeen?: number;
-}
-interface TrustedDeviceRecord {
-    peerId: string;
-    publicKeyMultibase: string;
-    deviceName: string;
-    platform: DevicePlatform;
-    trustMode: DeviceTrustMode;
-    accountId?: string;
-    createdAt: number;
-    lastSeen?: number;
-    revokedAt?: number;
-}
-interface DeviceAccountBindingRequest {
-    peerId: string;
-    publicKeyMultibase: string;
-    deviceName: string;
-    platform: DevicePlatform;
-    cloudNonce: string;
-    signature: string;
-}
-interface CloudDeviceRecord {
-    accountId: string;
-    peerId: string;
-    publicKeyMultibase: string;
-    deviceName: string;
-    platform: DevicePlatform;
-    capabilities: DeviceCapabilities;
-    multiaddrs: string[];
-    relayReservations: string[];
-    lastSeen: number;
-    revokedAt?: number;
-}
-interface DeviceConnectionGrant {
-    issuer: 'memeloop-cloud';
-    accountId: string;
-    subjectPeerId: string;
-    allowedPeerIds: string[];
-    issuedAt: number;
-    expiresAt: number;
-    signature: string;
-}
-interface PairingSession {
-    sessionId: string;
-    localPeerId: string;
-    remotePeerId: string;
-    confirmCode: string;
-    expiresAt: number;
-}
-interface SyncResult {
-    ok: boolean;
-    peerId: string;
-    syncedAt: number;
-}
-interface MemeLoopDuplexStream {
-    source: AsyncIterable<Uint8Array>;
-    sink(source: AsyncIterable<Uint8Array>): Promise<void>;
-    close(): Promise<void>;
-}
-interface DeviceAuthorizer {
-    canOpenProtocol(input: {
-        remotePeerId: string;
-        protocol: MemeLoopProtocol;
-        presentedGrant?: DeviceConnectionGrant;
-    }): Promise<boolean>;
-}
-interface DeviceNetworkService {
-    start(): Promise<void>;
-    stop(): Promise<void>;
-    getLocalDevice(): Promise<Device>;
-    listDevices(): Promise<Device[]>;
-    observeDevices(listener: (devices: Device[]) => void): () => void;
-    requestLocalPairing(peerId: string): Promise<PairingSession>;
-    acceptPairing(sessionId: string): Promise<void>;
-    rejectPairing(sessionId: string): Promise<void>;
-    removeTrustedDevice(peerId: string): Promise<void>;
-    openStream(peerId: string, protocol: MemeLoopProtocol): Promise<MemeLoopDuplexStream>;
-    sendRpc<T>(peerId: string, method: string, parameters: unknown): Promise<T>;
-    syncWithDevice(peerId: string): Promise<SyncResult>;
-}
-interface ExchangeVersionVectorResult {
-    remoteVersion: VersionVector;
-    missingForRemote: ConversationMeta[];
-}
-interface AttachmentBlob {
-    data: Uint8Array;
-    filename: string;
-    mimeType: string;
-    size: number;
-}
-interface DeviceSyncTransport {
-    listPeers(): Promise<Device[]>;
-    exchangeVersionVector(peerId: string, localVersion: VersionVector): Promise<ExchangeVersionVectorResult>;
-    pullMissingMetadata(peerId: string, sinceVersion: VersionVector): Promise<ConversationMeta[]>;
-    pullMissingMessages(peerId: string, conversationId: string, knownMessageIds: string[]): Promise<ChatMessage[]>;
-    pullAttachmentBlob(peerId: string, contentHash: string): Promise<AttachmentBlob | null>;
-}
-
-interface RawSeedDeviceIdentity extends LocalDeviceIdentity {
-    privateKeyRawSeedBase64Url: string;
-}
-declare function encodePublicKeyMultibase(publicKey: PublicKey): string;
-declare function decodePublicKeyMultibase(multibase: string): PublicKey;
-declare function createDeviceIdentity(platform: DevicePlatform, deviceName: string): Promise<RawSeedDeviceIdentity>;
-declare function privateKeyFromIdentity(identity: LocalDeviceIdentity): Promise<PrivateKey>;
-declare function buildDeviceBindingMessage(input: {
-    accountId: string;
-    peerId: string;
-    publicKeyMultibase: string;
-    nonce: string;
-}): Uint8Array;
-declare function signDeviceBinding(input: {
-    identity: LocalDeviceIdentity;
-    accountId: string;
-    nonce: string;
-}): Promise<string>;
-declare function verifyDeviceBinding(input: DeviceAccountBindingRequest & {
-    accountId: string;
-}): Promise<boolean>;
-
-interface Libp2pDeviceNetworkServiceOptions {
-    identity: LocalDeviceIdentity;
-    capabilities?: DeviceCapabilities;
-    trustedDevices?: TrustedDeviceRecord[];
-    listen?: DeviceNetworkListenOptions;
-    enableMdns?: boolean;
-    autoDialDiscoveredPeers?: boolean;
-}
-declare class Libp2pDeviceNetworkService implements DeviceNetworkService {
-    private readonly options;
-    private libp2p?;
-    private readonly capabilities;
-    private readonly discoveredDevices;
-    private readonly trustedDevices;
-    private readonly pairingSessions;
-    private readonly listeners;
-    constructor(options: Libp2pDeviceNetworkServiceOptions);
-    start(): Promise<void>;
-    stop(): Promise<void>;
-    getLocalDevice(): Promise<Device>;
-    listDevices(): Promise<Device[]>;
-    observeDevices(listener: (devices: Device[]) => void): () => void;
-    requestLocalPairing(peerId: string): Promise<PairingSession>;
-    acceptPairing(sessionId: string): Promise<void>;
-    rejectPairing(sessionId: string): Promise<void>;
-    removeTrustedDevice(peerId: string): Promise<void>;
-    openStream(peerId: string, protocol: MemeLoopProtocol): Promise<MemeLoopDuplexStream>;
-    sendRpc<T>(peerId: string, method: string, parameters: unknown): Promise<T>;
-    syncWithDevice(peerId: string): Promise<SyncResult>;
-    getMultiaddrs(): string[];
-    private createNode;
-    private registerDiscoveryListeners;
-    private registerProtocolHandlers;
-    private wrapStream;
-    private streamSource;
-    private markPeerOnline;
-    private markPeerOffline;
-    private updateDeviceTrust;
-    private confirmCode;
-    private emitDevices;
-    private requireNode;
-}
-
-interface MemoryDeviceNetworkServiceOptions {
-    identity: LocalDeviceIdentity;
-    capabilities?: DeviceCapabilities;
-    trustedDevices?: TrustedDeviceRecord[];
-}
-declare class MemoryDeviceNetworkService implements DeviceNetworkService {
-    private readonly options;
-    private started;
-    private readonly capabilities;
-    private readonly trustedDevices;
-    private readonly pairingSessions;
-    private readonly listeners;
-    constructor(options: MemoryDeviceNetworkServiceOptions);
-    start(): Promise<void>;
-    stop(): Promise<void>;
-    getLocalDevice(): Promise<Device>;
-    listDevices(): Promise<Device[]>;
-    observeDevices(listener: (devices: Device[]) => void): () => void;
-    requestLocalPairing(peerId: string): Promise<PairingSession>;
-    acceptPairing(sessionId: string): Promise<void>;
-    rejectPairing(sessionId: string): Promise<void>;
-    removeTrustedDevice(peerId: string): Promise<void>;
-    openStream(peerId: string, _protocol: MemeLoopProtocol): Promise<MemeLoopDuplexStream>;
-    sendRpc<T>(peerId: string, _method: string, _parameters: unknown): Promise<T>;
-    syncWithDevice(peerId: string): Promise<SyncResult>;
-    private confirmCode;
-    private emitDevices;
-}
-
-/**
- * IM 接入框架（平台无关）：适配器负责验签/解析；ChannelManager 负责会话路由。
- */
-
-/** 平台 Webhook 解析后的统一入站消息 */
-interface ImInboundMessage {
-    channelId: string;
-    platform: IMPlatformType;
-    imUserId: string;
-    text: string;
-    /** 平台原始结构，便于调试或扩展富媒体 */
-    raw: unknown;
-}
-interface ImWebhookContext {
-    headers: Record<string, string | string[] | undefined>;
-    body: Uint8Array;
-    /** GET/POST query（如企业微信密文回调的 msg_signature、timestamp、nonce） */
-    query?: Record<string, string>;
-}
-/**
- * 单平台适配器：verify 失败应返回 false；parse 失败返回 null。
- */
-interface IIMAdapter {
-    readonly platform: IMPlatformType;
-    verify(context: ImWebhookContext): boolean;
-    parse(channelId: string, context: ImWebhookContext): ImInboundMessage | null;
-}
-/** 将 Agent 输出格式化为 IM 可发送的纯文本 */
-interface IIMMessageRenderer {
-    renderPlainText(content: string): string;
-    /** 单行工具调用摘要（IM 默认不展示完整工具参数/结果） */
-    renderToolCallSummary(toolName: string, arguments_: unknown): string;
-    /**
-     * 工具结果摘要（返回 null 表示隐藏）。
-     * 规则摘要优先：避免把大结果刷到 IM。
-     */
-    renderToolResultSummary(toolName: string, result: unknown): string | null;
-    renderToolApproval(toolName: string, arguments_: unknown): string;
-    renderAskQuestion(question: string, options?: string[]): string;
-    /** IM 默认隐藏 thinking，若要显示由实现自行决定。 */
-    renderThinking(content: string): string | null;
-    renderError(error: string): string;
-    renderTodoList(todos: Array<{
-        id: string;
-        text: string;
-        done?: boolean;
-    }>): string;
-}
-/** 节点侧驱动 Agent 的最小能力（避免循环依赖 MemeLoopRuntime 类型） */
-interface ImAgentDriver {
-    createAgent(options: {
-        definitionId: string;
-        initialMessage?: string;
-    }): Promise<{
-        conversationId: string;
-    }>;
-    sendMessage(options: {
-        conversationId: string;
-        message: string;
-    }): Promise<void>;
-}
-
-/**
- * 管理 IM 用户与会话的绑定；可选 `storage` 使用 IAgentStorage 的 IM 绑定持久化。
- */
-declare class IMChannelManager {
-    private readonly storage?;
-    private readonly bindings;
-    constructor(storage?: {
-        getImBinding?(c: string, u: string): Promise<IMChannelBinding | null>;
-        setImBinding?(r: IMChannelBinding): Promise<void>;
-    } | undefined);
-    private key;
-    getBinding(channelId: string, imUserId: string): Promise<IMChannelBinding | undefined>;
-    setBinding(record: IMChannelBinding): Promise<void>;
-    /**
-     * 处理入站文本：无 binding 时创建会话并发送首条用户消息。
-     */
-    dispatchInbound(message: ImInboundMessage, driver: ImAgentDriver, options: {
-        defaultDefinitionId: string;
-    }): Promise<{
-        conversationId: string;
-    }>;
-    switchConversation(channelId: string, imUserId: string, conversationId: string): Promise<void>;
-}
-declare function pickAdapter(adapters: IIMAdapter[], platform: string): IIMAdapter | undefined;
-
-/** Plan §20.6.1 — chunk assistant text before sending to IM APIs. */
-declare function imPlatformMaxMessageChars(platform: string): number;
-
-interface IAgentStorage {
-    listConversations(options?: ListConversationsOptions): Promise<ConversationMeta[]>;
-    getMessages(conversationId: string, options?: GetMessagesOptions): Promise<ChatMessage[]>;
-    appendMessage(message: ChatMessage): Promise<void>;
-    upsertConversationMetadata(meta: ConversationMeta): Promise<void>;
-    insertMessagesIfAbsent(messages: ChatMessage[]): Promise<void>;
-    getAttachment(contentHash: string): Promise<AttachmentReference | null>;
-    saveAttachment(reference: AttachmentReference, data: Buffer | Uint8Array): Promise<void>;
-    readAttachmentData?(contentHash: string): Promise<Uint8Array | null>;
-    getAgentDefinition(id: string): Promise<AgentDefinition | null>;
-    getMaxLamportClockForConversation?(conversationId: string): Promise<number>;
-    saveAgentInstance(meta: AgentInstanceMeta): Promise<void>;
-    getConversationMeta(conversationId: string): Promise<ConversationMeta | null>;
-    getImBinding?(channelId: string, imUserId: string): Promise<IMChannelBinding | null>;
-    setImBinding?(record: IMChannelBinding): Promise<void>;
-}
-
-interface ImSlashCommandContext {
-    rawText: string;
-    channelId: string;
-    imUserId: string;
-    manager: IMChannelManager;
-    storage: IAgentStorage;
-    driver: ImAgentDriver;
-    runtime: MemeLoopRuntime;
-    defaultDefinitionId: string;
-}
-/**
- * Plan §20.6.4 — parse `/list`, `/switch`, `/new`, `/agent`, `/status`, `/cancel` locally (no LLM).
- */
-declare function tryHandleImSlashCommand(context: ImSlashCommandContext): Promise<{
-    handled: boolean;
-    messages: string[];
-}>;
-
-/** 通用文本/Markdown 友好输出（IM 端以纯文本展示） */
-declare class TextMessageRenderer implements IIMMessageRenderer {
-    renderPlainText(content: string): string;
-    renderToolCallSummary(toolName: string, arguments_: unknown): string;
-    renderToolResultSummary(toolName: string, result: unknown): string | null;
-    renderToolApproval(toolName: string, arguments_: unknown): string;
-    renderAskQuestion(question: string, options?: string[]): string;
-    renderThinking(_content: string): string | null;
-    renderError(error: string): string;
-    renderTodoList(todos: Array<{
-        id: string;
-        text: string;
-        done?: boolean;
-    }>): string;
-}
-
-type ImStreamFlush = (text: string) => Promise<void>;
-/**
- * Subscribe to `runtime` agent updates and forward assistant text + light tool summaries to IM,
- * flushing when the buffer reaches the platform limit (plan §20.6.1).
- */
-declare function streamRuntimeAgentReplyToIm(options: {
-    runtime: MemeLoopRuntime;
-    conversationId: string;
-    platform: string;
-    renderer: TextMessageRenderer;
-    flush: ImStreamFlush;
-}): Promise<void>;
-
-/**
- * IM 会话控制工具（计划 20.4）：在带 IM binding 的会话中注入。
- * 这里仅导出工具 schema 描述，实际注册由上层 ToolRegistry 完成。
- */
-declare const imToolDefinitions: readonly [{
-    readonly name: "im.listConversations";
-    readonly description: "列出可切换的会话（由 memeloop-cli registerImSessionTools 注册，仅 IM 来源会话可用）。";
-}, {
-    readonly name: "im.switchConversation";
-    readonly description: "切换当前 IM 用户绑定的活跃会话。参数：{ conversationId: string }";
-}, {
-    readonly name: "im.newConversation";
-    readonly description: "创建新会话并切换绑定。参数：{ definitionId?: string }";
-}, {
-    readonly name: "im.summarizeHistory";
-    readonly description: "返回当前会话最近消息的纯文本摘要（规则拼接，非 LLM）。参数：{ maxMessages?: number }";
-}];
-interface ImToolsRuntime {
-    channelId: string;
-    imUserId: string;
-    manager: IMChannelManager;
-    driver: ImAgentDriver;
-    defaultDefinitionId: string;
-}
-/** 供工具实现层调用的命令式 API（避免在 core 内耦合 defineTool） */
-declare function imSwitchConversation(rt: ImToolsRuntime, conversationId: string): Promise<void>;
-
-/**
- * Layered permission system types.
- *
- * Permissions are resolved by merging rule sets from multiple layers
- * (default → agent → user → session), where later layers override earlier ones.
- */
-/** Permission action for a tool invocation. */
-type PermissionAction = 'allow' | 'deny' | 'ask';
-/** A single permission rule: matches a tool name pattern to an action. */
-interface PermissionRule {
-    /** Wildcard-capable pattern, e.g. `"file.*"`, `"shell(rm)"`, `"*"`. */
-    toolPattern: string;
-    action: PermissionAction;
-}
-/** A set of permission rules belonging to a specific source/layer. */
-interface PermissionSet {
-    rules: PermissionRule[];
-    /** Human-readable source identifier for debugging (e.g. "default", "agent:cli-buddy", "user"). */
-    source: string;
-}
-/**
- * Result of merging multiple `PermissionSet` layers.
- * Each array contains flattened, deduplicated tool patterns for that action.
- */
-interface MergedPermissions {
-    allow: string[];
-    deny: string[];
-    ask: string[];
-}
-
-/**
- * Hook system types for memeloop.
- * Hooks are lifecycle callbacks that execute before/after key events in the agent loop.
- */
-
-/** Context passed to all hook handlers. */
-type HookContext = AgentFrameworkContext;
-/** Result returned by a hook handler. */
-interface HookResult {
-    /** Whether to allow the action to proceed (false = block/deny) */
-    allowed: boolean;
-    /** Optional message explaining why the action was blocked */
-    reason?: string;
-    /** Optional data modified by the hook (e.g., transformed tool args) */
-    modified?: Record<string, unknown>;
-    /** Optional tool permission action. Interpreted by PreToolUse callers. */
-    permissionAction?: PermissionAction;
-}
-/** Signature of a hook handler function. */
-type HookHandler = (context: HookContext, data: Record<string, unknown>) => Promise<HookResult>;
-/** Enum of supported hook event types. */
-type HookType = 'PreToolUse' | 'PostToolUse' | 'UserPromptSubmit' | 'ContextCompaction' | 'AgentStart' | 'AgentStop';
-/** Data passed to PreToolUse hooks. */
-interface PreToolUseData extends Record<string, unknown> {
-    toolId: string;
-    parameters: Record<string, unknown>;
-    conversationId: string;
-}
-/** Data passed to PostToolUse hooks. */
-interface PostToolUseData extends Record<string, unknown> {
-    toolId: string;
-    parameters: Record<string, unknown>;
-    result: string;
-    isError: boolean;
-    conversationId: string;
-}
-/** Data passed to UserPromptSubmit hooks. */
-interface UserPromptSubmitData extends Record<string, unknown> {
-    message: string;
-    conversationId: string;
-}
-/** Data passed to ContextCompaction hooks before built-in history compaction. */
-interface ContextCompactionData extends Record<string, unknown> {
-    conversationId: string;
-    iteration: number;
-    history: ChatMessage[];
-    autoCompact?: AgentFrameworkContext['taskAgent'] extends infer Options ? Options extends {
-        autoCompact?: infer AutoCompact;
-    } ? AutoCompact : never : never;
-    contextCompaction?: AgentFrameworkContext['taskAgent'] extends infer Options ? Options extends {
-        contextCompaction?: infer ContextCompaction;
-    } ? ContextCompaction : never : never;
-}
-/** Data passed to AgentStart hooks. */
-interface AgentStartData extends Record<string, unknown> {
-    conversationId: string;
-    definitionId?: string;
-}
-/** Data passed to AgentStop hooks. */
-interface AgentStopData extends Record<string, unknown> {
-    conversationId: string;
-    reason: 'completed' | 'cancelled' | 'max-iterations' | 'error';
-}
-
-/**
- * Hook registry for managing lifecycle hook handlers.
- * Hooks execute in registration order (first registered, first executed).
- *
- * Converted from module-level singletons to an instance class for test isolation
- * and multi-runtime support. Backward-compatible function exports delegate to a
- * default global instance.
- */
-
-/**
- * Instance-level hook registry. Each instance maintains its own handler state.
- */
-declare class HookRegistry {
-    private readonly hookRegistry;
-    private readonly hookOrder;
-    /**
-     * Register a hook handler for a specific lifecycle event.
-     */
-    registerHook(type: HookType, handler: HookHandler, name?: string): void;
-    /**
-     * Unregister a specific hook handler by name.
-     */
-    unregisterHook(type: HookType, name: string): boolean;
-    /**
-     * Execute all registered hooks for a given type in registration order.
-     */
-    executeHooks(type: HookType, context: HookContext, data: Record<string, unknown>): Promise<HookResult>;
-    /**
-     * Check if any hooks are registered for a given type.
-     */
-    hasHooks(type: HookType): boolean;
-    /**
-     * Remove all registered hooks of all types.
-     */
-    clearHooks(): void;
-    /**
-     * List all hook types that have at least one registered handler.
-     */
-    listRegisteredHookTypes(): HookType[];
-    /**
-     * Get the count of registered handlers for a hook type.
-     */
-    getHookCount(type: HookType): number;
-}
-declare function getDefaultHookRegistry(): HookRegistry;
-declare function registerHook(type: HookType, handler: HookHandler, name?: string): void;
-declare function unregisterHook(type: HookType, name: string): boolean;
-declare function executeHooks(type: HookType, context: HookContext, data: Record<string, unknown>): Promise<HookResult>;
-declare function hasHooks(type: HookType): boolean;
-declare function clearHooks(): void;
-declare function listRegisteredHookTypes(): HookType[];
-/**
- * Get the count of registered handlers for a hook type.
- */
-declare function getHookCount(type: HookType): number;
-
-/**
- * Test whether a tool name matches a wildcard pattern.
- *
- * Supported patterns:
- * - `*`       → matches everything
- * - `file.*`   → matches any tool starting with `file.`
- * - `shell(*)` → matches tools like `shell(rm)`, `shell(ls)` (literal parens)
- * - exact name → matches only that exact tool name
- *
- * Patterns are converted to anchored regexes internally.
- */
-declare function matchPattern(toolName: string, pattern: string): boolean;
-/**
- * Merge multiple permission sets from lowest to highest priority.
- *
- * Sets are processed in order; later rules override earlier ones for the same tool pattern.
- * Within a single set, rules are processed in order (last wins).
- *
- * @param sets - Ordered from lowest to highest priority (e.g. default → agent → user → session)
- * @returns Flattened `MergedPermissions` with all unique patterns per action.
- */
-declare function mergePermissionSets(sets: PermissionSet[]): MergedPermissions;
-/**
- * Check what action applies to a given tool name under merged permissions.
- *
- * Precedence: exact patterns always beat wildcards.
- * Within same specificity: deny > ask > allow.
- */
-declare function checkPermission(toolName: string, merged: MergedPermissions): PermissionAction;
-
-interface PermissionSqlStatement {
-    get(...arguments_: unknown[]): unknown;
-    run(...arguments_: unknown[]): unknown;
-}
-interface PermissionSqlDatabase {
-    prepare(sql: string): PermissionSqlStatement;
-}
-/**
- * Load user-level permission set from SQLite.
- *
- * The `permissions` table stores JSON blobs keyed by `source`.
- * Returns an empty set if no persisted rules exist.
- */
-declare function loadUserPermissions(database: PermissionSqlDatabase): PermissionSet;
-/**
- * Persist user-level permission set to SQLite.
- *
- * Uses INSERT OR REPLACE so first-time saves work without explicit table detection.
- */
-declare function saveUserPermissions(database: PermissionSqlDatabase, set: PermissionSet): void;
-/** SQL statement to create the permissions table during migration. */
-declare const PERMISSIONS_TABLE_DDL = "\n  CREATE TABLE IF NOT EXISTS permissions (\n    source TEXT PRIMARY KEY,\n    rulesJson TEXT NOT NULL,\n    updatedAt INTEGER NOT NULL\n  );\n";
-
-/**
- * Plugin marketplace architecture types.
- * Plugins can provide tools and hooks to extend memeloop.
- */
-
-/**
- * Plugin manifest schema.
- * Host adapters may read this from files or construct it programmatically.
- */
-interface PluginManifest {
-    /** Unique plugin identifier (e.g. "plugin-hello", "@scope/my-plugin") */
-    name: string;
-    /** Semantic version */
-    version: string;
-    /** Human-readable description */
-    description: string;
-    /** Declared exports: what the plugin provides */
-    exports?: PluginExports;
-    /** Plugin author */
-    author?: string;
-    /** Minimum memeloop version requirement (semver range) */
-    minMemeloopVersion?: string;
-}
-/** Declared capabilities a plugin may export. */
-interface PluginExports {
-    /** Tool IDs this plugin implements */
-    tools?: string[];
-    /** Hook types this plugin listens for */
-    hooks?: HookType[];
-}
-/**
- * Shape of a loaded plugin module's default export.
- * Plugins must export default an object conforming to this interface.
- */
-interface PluginModule {
-    /** Plugin identity (must match manifest name) */
-    name: string;
-    /**
-     * Called when the plugin is loaded. Receives the PluginAPI for registering
-     * tools and hooks. Return a cleanup function for teardown.
-     */
-    activate: (api: PluginAPI) => (() => void) | Promise<() => void> | undefined;
-}
-/**
- * API surface exposed to plugins. Plugins call these methods in their
- * `activate` function to register their capabilities.
- */
-interface PluginAPI {
-    /**
-     * Register a tool implementation.
-     * @param toolId - Unique tool ID (e.g. "plugin-hello.sayHi")
-     * @param impl - Tool implementation function
-     * @param schema - Optional parameter schema (Zod type)
-     */
-    registerTool(toolId: string, impl: (...arguments_: unknown[]) => unknown, schema?: unknown): void;
-    /**
-     * Register a lifecycle hook handler.
-     * @param type - Hook event type
-     * @param handler - Async handler function
-     * @param name - Optional handler name (enables dedup/unregistration)
-     */
-    registerHook(type: HookType, handler: HookHandler, name?: string): void;
-    /** Log to memeloop's logger (falls back to console). */
-    logger: {
-        debug: (message: string, ...arguments_: unknown[]) => void;
-        info: (message: string, ...arguments_: unknown[]) => void;
-        warn: (message: string, ...arguments_: unknown[]) => void;
-        error: (message: string, ...arguments_: unknown[]) => void;
-    };
-}
-/** Metadata about a loaded plugin instance. */
-interface LoadedPlugin {
-    /** Manifest data */
-    manifest: PluginManifest;
-    /** Optional host-provided source identifier, e.g. package name or file path. */
-    source: string;
-    /** The loaded plugin module */
-    module: PluginModule;
-    /** Cleanup function returned by activate(), if any */
-    cleanup: (() => void) | undefined;
-    /** When the plugin was loaded */
-    loadedAt: Date;
-}
-
-declare function validatePluginManifest(object: unknown): PluginManifest | null;
-interface LoadPluginModuleOptions {
-    manifest: PluginManifest;
-    module: PluginModule;
-    api?: unknown;
-    source?: string;
-}
-declare function loadPluginModule(options: LoadPluginModuleOptions): Promise<LoadedPlugin | null>;
-declare function loadPluginModules(plugins: LoadPluginModuleOptions[]): Promise<LoadedPlugin[]>;
-declare function unloadPlugin(name: string): boolean;
-declare function listPlugins(): LoadedPlugin[];
-declare function getLoadedPlugin(name: string): LoadedPlugin | undefined;
-declare function isPluginLoaded(name: string): boolean;
-declare function unloadAllPlugins(): void;
-
-/**
- * Plugin registry: bridges plugin exports to memeloop's tool and hook registries.
- *
- * Provides a `createPluginAPI()` factory that plugins call during `activate()`
- * to register their tools and hooks with the host runtime.
- *
- * Converted from module-level singletons to an instance class for test isolation
- * and multi-runtime support.
- */
-
-/** Plugin API factory options. */
-interface PluginAPIOptions {
-    toolRegistry?: {
-        registerTool(id: string, impl: unknown): void;
-    };
-    logger?: PluginAPI['logger'];
-}
-/**
- * Track which tools/plugins belong to each plugin so we can clean up on unload.
- */
-interface PluginRegistration {
-    pluginName: string;
-    tools: string[];
-    hooks: Array<{
-        type: HookType;
-        name: string;
-    }>;
-}
-declare function createPluginAPI(options?: PluginAPIOptions): PluginAPI;
-declare function registerPluginTools(pluginName: string, tools: Array<readonly [string, (...arguments_: unknown[]) => unknown, unknown?]>): void;
-declare function registerPluginHooks(pluginName: string, hooks: Array<readonly [HookType, HookHandler, string?]>): void;
-declare function getPluginRegistrations(pluginName: string): PluginRegistration | undefined;
-declare function clearPluginRegistrations(): void;
-
-/**
- * 注册内置 prompt 插件（fullReplacement、dynamicPosition）。
- * @param target 若传入（如节点 `ToolRegistry` 上的 Map），只写入该表；否则写入活动注册表（全局或 ALS）。
- */
-declare function registerBuiltinPromptPlugins(target?: Map<string, PromptConcatTool>): void;
-
-/** 扁平化后的 LLM 消息（不依赖 peer `ai` 包导出，避免 d.ts 与 SDK 主版本不一致） */
-type PromptFlatModelMessage = {
-    role: 'system' | 'user' | 'assistant' | 'tool';
-    content: unknown;
-};
-declare function findPromptById(prompts: PromptNode[], id: string): {
-    prompt: PromptNode;
-    parent: PromptNode[];
-    index: number;
-} | undefined;
-declare function flattenPrompts(prompts: PromptNode[]): PromptFlatModelMessage[];
-interface PromptConcatPluginPreview {
-    id: string;
-    toolId?: string;
-    caption?: string;
-}
-interface PromptConcatStreamState {
-    processedPrompts: PromptNode[];
-    flatPrompts: PromptFlatModelMessage[];
-    step: 'flatten' | 'complete' | 'plugin' | 'finalize';
-    isComplete: boolean;
-    /** prompt 节点 id → JSON 路径（如 agentFrameworkConfig.prompts.0） */
-    sourcePaths?: Record<string, string>;
-    /** Desktop UI: plugin currently being processed. */
-    currentPlugin?: PromptConcatPluginPreview;
-    /** Desktop UI: progress value between 0 and 1. */
-    progress?: number;
-}
-interface PromptConcatOptions {
-    readAttachmentFile?: (path: string) => Promise<Uint8Array | Buffer>;
-}
-declare function promptConcatStream(agentConfig: Pick<AgentPromptDescription, 'agentFrameworkConfig'>, messages: ChatMessage[], agentFrameworkContext: AgentFrameworkContext, options?: PromptConcatOptions): AsyncGenerator<PromptConcatStreamState, PromptConcatStreamState, unknown>;
-
-/**
- * TidGi `approval.ts` 逐行迁移（pending 队列 + UI 监听）。
- */
-
-declare function onApprovalRequest(listener: (request: ToolApprovalRequest) => void): () => void;
-declare function evaluateApproval(approval: ToolApprovalConfig | undefined, toolName: string, parameters: Record<string, unknown>): ApprovalDecision;
-declare function requestApproval(request: ToolApprovalRequest, timeoutMs?: number): Promise<'allow' | 'deny'>;
-declare function resolveApproval(approvalId: string, decision: 'allow' | 'deny'): void;
-declare function getPendingApprovals(): ToolApprovalRequest[];
-declare function cancelPendingApprovals(agentId: string): void;
-
-interface NodeIdentity {
-    nodeId: string;
-    userId: string;
-    name: string;
-    type: 'desktop' | 'node' | 'mobile';
-}
-/** 节点暴露的 Wiki / 知识库条目（与计划「能力发现」对齐）。 */
-interface WikiInfo {
-    wikiId: string;
-    title?: string;
-    /** 可选：相对节点配置的根路径说明，不含敏感绝对路径 */
-    pathHint?: string;
-}
-interface NodeCapabilities {
-    tools: string[];
-    mcpServers: string[];
-    hasWiki: boolean;
-    imChannels: string[];
-    /** 已挂载的 Wiki 列表（无 Wiki 能力时可为空数组） */
-    wikis: WikiInfo[];
-}
-interface NodeConnectivity {
-    publicIP?: string;
-    frpAddress?: string;
-    lanAddress?: string;
-}
-interface NodeStatus {
-    identity: NodeIdentity;
-    capabilities: NodeCapabilities;
-    connectivity: NodeConnectivity;
-    status: 'online' | 'offline' | 'unknown';
-    lastSeen: number;
-}
-
-/**
- * Context passed to builtin tool implementations.
- * Extends AgentFrameworkContext with optional capabilities for MCP proxy, spawn and remote agent.
- */
-interface BuiltinToolContext extends AgentFrameworkContext {
-    /**
-     * 当前工具执行时对应的 conversationId（由宿主/运行时注入）。
-     * IM 会话工具依赖该值定位会话来源；缺失时工具返回错误而不是抛异常。
-     */
-    activeToolConversationId?: string;
-    /**
-     * Run the local task agent (for spawnAgent). If not provided, spawnAgent tool will return an error.
-     */
-    runLocalAgent?(input: AgentLoopInput): AgentLoopGenerator;
-    /**
-     * List known peer nodes (for remoteAgent). If not provided, remoteAgent returns empty list / "not configured".
-     */
-    getPeers?(): Promise<NodeStatus[]>;
-    /**
-     * Send JSON-RPC to a peer node (for remoteAgent and MCP proxy). If not provided, remote calls fail.
-     */
-    sendRpcToNode?(nodeId: string, method: string, parameters: unknown): Promise<unknown>;
-    /**
-     * Call a tool on a remote MCP server on the given node (for mcpClient). If not provided, mcpClient returns error.
-     */
-    mcpCallRemote?(nodeId: string, serverName: string, toolName: string, arguments_: Record<string, unknown>): Promise<unknown>;
-    /**
-     * `remoteAgent` 等待远端流式输出的超时（毫秒）。默认 30000。
-     */
-    remoteAgentStreamTimeoutMs?: number;
-    /** 本节点 ID（用于 `spawnAgent` / `remoteAgent` 的 `detailRef.nodeId`）。未设时 spawn 使用 `"local"`。 */
-    localNodeId?: string;
-    /** `askQuestion` 阻塞前回调（可将 questionId 推送到 IM / UI，供 `resolveQuestion` RPC 回填）。 */
-    notifyAskQuestion?(payload: {
-        questionId: string;
-        question: string;
-        conversationId?: string;
-        inputType?: 'single-select' | 'multi-select' | 'text';
-        options?: Array<{
-            label: string;
-            description?: string;
-        }>;
-        allowFreeform?: boolean;
-    }): void;
-}
-/** Tool implementation: (args, context) => result. Context is bound at registration time. */
-type BuiltinToolImpl = (arguments_: Record<string, unknown>, context: BuiltinToolContext) => Promise<unknown> | AsyncIterable<unknown>;
-
-declare const askQuestionConfigSchema: z.ZodObject<{
-    question: z.ZodString;
-    conversationId: z.ZodOptional<z.ZodString>;
-    timeoutMs: z.ZodOptional<z.ZodNumber>;
-    inputType: z.ZodOptional<z.ZodEnum<{
-        text: "text";
-        "single-select": "single-select";
-        "multi-select": "multi-select";
-    }>>;
-    options: z.ZodOptional<z.ZodArray<z.ZodObject<{
-        label: z.ZodString;
-        description: z.ZodOptional<z.ZodString>;
-    }, z.core.$strip>>>;
-    allowFreeform: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
-}, z.core.$strip>;
-/**
- * Must match `tool_use name="ask-question"` extracted by responsePatternUtility.
- */
-declare const ASK_QUESTION_TOOL_ID = "ask-question";
-declare function askQuestionImpl(arguments_: Record<string, unknown>, context: BuiltinToolContext): Promise<{
-    result: string;
-} | {
-    error: string;
-}>;
-
-/**
- * AskUserQuestion Tool — Pause agent execution and ask user for input.
- *
- * Uses the existing askQuestion pattern (notifyAskQuestion + waitForQuestionAnswer)
- * but provides a dedicated tool ID for explicit user question prompting.
- */
-
-declare const askUserQuestionConfigSchema: z.ZodObject<{
-    question: z.ZodString;
-    inputType: z.ZodDefault<z.ZodOptional<z.ZodEnum<{
-        text: "text";
-        "single-select": "single-select";
-        "multi-select": "multi-select";
-    }>>>;
-    options: z.ZodOptional<z.ZodArray<z.ZodObject<{
-        label: z.ZodString;
-        description: z.ZodOptional<z.ZodString>;
-    }, z.core.$strip>>>;
-    allowFreeform: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
-    timeoutMs: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
-}, z.core.$strip>;
-declare const ASK_USER_QUESTION_TOOL_ID = "askUserQuestion";
-declare function askUserQuestionImpl(arguments_: Record<string, unknown>, context: BuiltinToolContext): Promise<{
-    result: string;
-} | {
-    error: string;
-}>;
-
-declare const IM_SESSION_TOOL_IDS: readonly ["im.listConversations", "im.switchConversation", "im.newConversation", "im.summarizeHistory"];
-interface ImSessionBuiltinRegistration {
-    imChannelManager: IMChannelManager;
-    getMemeLoopRuntime: () => MemeLoopRuntime;
-}
-/**
- * 注册 IM 会话专用工具（需节点传入 `imChannelManager` 与 `getMemeLoopRuntime`）。
- */
-declare function registerImSessionBuiltinTools(registry: IToolRegistry, context: BuiltinToolContext, reg: ImSessionBuiltinRegistration): void;
-
-declare const mcpClientConfigSchema: {
-    readonly type: "object";
-    readonly properties: {
-        readonly nodeId: {
-            readonly type: "string";
-            readonly description: "Target node ID";
-        };
-        readonly serverName: {
-            readonly type: "string";
-            readonly description: "MCP server name on that node";
-        };
-        readonly toolName: {
-            readonly type: "string";
-            readonly description: "Tool to invoke";
-        };
-        readonly args: {
-            readonly type: "object";
-            readonly description: "Tool arguments";
-        };
-    };
-    readonly required: readonly ["nodeId", "serverName", "toolName"];
-};
-declare const mcpClientImpl: BuiltinToolImpl;
-declare function getMcpClientToolId(): string;
-
-declare const mcpForwardConfigSchema: {
-    readonly type: "object";
-    readonly properties: {
-        readonly action: {
-            readonly type: "string";
-            readonly enum: readonly ["list", "listTools"];
-            readonly description: "Action: 'list' returns nodes with MCP servers, 'listTools' returns all available MCP tools across nodes";
-        };
-    };
-};
-/**
- * MCP forwarding tool: discover MCP servers and tools on connected nodes.
- * - action=list: returns nodes with their MCP servers
- * - action=listTools: returns all available MCP tools across all nodes
- */
-declare const mcpForwardImpl: BuiltinToolImpl;
-declare function getMcpForwardToolId(): string;
-
-declare function resolveQuestionAnswer(questionId: string, answer: string): boolean;
-
-declare const remoteAgentConfigSchema: {
-    readonly type: "object";
-    readonly properties: {
-        readonly nodeId: {
-            readonly type: "string";
-            readonly description: "Target node ID to run the sub-agent on";
-        };
-        readonly definitionId: {
-            readonly type: "string";
-            readonly description: "Agent definition ID on that node";
-        };
-        readonly message: {
-            readonly type: "string";
-            readonly description: "Task message for the remote agent";
-        };
-    };
-    readonly required: readonly ["nodeId", "definitionId", "message"];
-};
-/** List nodes and their definitions (for tool description / agent choice). No args. */
-declare const remoteAgentListImpl: BuiltinToolImpl;
-declare const remoteAgentImpl: BuiltinToolImpl;
-declare function getRemoteAgentToolId(): string;
-
-declare const spawnAgentConfigSchema: {
-    readonly type: "object";
-    readonly properties: {
-        readonly definitionId: {
-            readonly type: "string";
-            readonly description: "Agent definition ID to use for the sub-agent";
-        };
-        readonly message: {
-            readonly type: "string";
-            readonly description: "User message / task for the sub-agent";
-        };
-    };
-    readonly required: readonly ["definitionId", "message"];
-};
-declare const spawnAgentImpl: BuiltinToolImpl;
-declare function getSpawnAgentToolId(): string;
-
-declare const taskToolConfigSchema: {
-    readonly type: "object";
-    readonly properties: {
-        readonly agent: {
-            readonly type: "string";
-            readonly description: "Agent ID to delegate to (e.g. 'memeloop:build', 'memeloop:explore')";
-        };
-        readonly prompt: {
-            readonly type: "string";
-            readonly description: "Task prompt / instructions for the delegated agent";
-        };
-        readonly background: {
-            readonly type: "boolean";
-            readonly description: "If true, runs asynchronously and returns a task ID immediately";
-        };
-    };
-    readonly required: readonly ["agent", "prompt"];
-};
-declare const taskToolImpl: BuiltinToolImpl;
-declare function getTaskToolId(): string;
-
-/**
- * TodoWrite Tool — Manage structured todo lists stored in conversation context.
- *
- * Supports operations: create, update, complete, list, remove.
- * Todo state is stored in-memory per conversation, keyed by conversationId.
- */
-
-declare const todoWriteConfigSchema: z.ZodObject<{
-    action: z.ZodEnum<{
-        update: "update";
-        complete: "complete";
-        list: "list";
-        create: "create";
-        remove: "remove";
-    }>;
-    id: z.ZodOptional<z.ZodString>;
-    content: z.ZodOptional<z.ZodString>;
-    status: z.ZodOptional<z.ZodEnum<{
-        pending: "pending";
-        completed: "completed";
-        cancelled: "cancelled";
-        in_progress: "in_progress";
-    }>>;
-    priority: z.ZodDefault<z.ZodOptional<z.ZodEnum<{
-        high: "high";
-        medium: "medium";
-        low: "low";
-    }>>>;
-}, z.core.$strip>;
-declare const TODO_WRITE_TOOL_ID = "todoWrite";
-/** Exported for test cleanup. */
-declare function __clearTodoStore(): void;
-declare function todoWriteImpl(arguments_: Record<string, unknown>, context: BuiltinToolContext): Promise<{
-    result: string;
-} | {
-    error: string;
-}>;
-
-/**
- * Register framework-level builtin tools (agent orchestration, user interaction, MCP).
- *
- * Environment-specific tools (bash, file*, grep, glob, git, webFetch, webSearch, lsp)
- * must be registered by the host environment (e.g. memeloop-cli via registerNodeEnvironmentTools).
- */
-declare function registerBuiltinTools(registry: IToolRegistry, context: BuiltinToolContext): void;
-
-/**
- * TidGi `defineToolTypes.ts` 迁移（路径改为 memeloop）。
- */
-
-interface ToolDefinition<TConfigSchema extends z.ZodType = z.ZodType, TLLMToolSchemas extends Record<string, z.ZodType> = Record<string, z.ZodType>> {
-    toolId: string;
-    displayName: string;
-    description: string;
-    configSchema: TConfigSchema;
-    llmToolSchemas?: TLLMToolSchemas;
-    onProcessPrompts?: (context: ToolHandlerContext<TConfigSchema>) => Promise<void> | void;
-    onResponseComplete?: (context: ResponseHandlerContext<TConfigSchema, TLLMToolSchemas>) => Promise<void> | void;
-    onPostProcess?: (context: PostProcessHandlerContext<TConfigSchema>) => Promise<void> | void;
-}
-interface ToolHandlerContext<TConfigSchema extends z.ZodType> {
-    config: z.infer<TConfigSchema>;
-    toolConfig: PromptConcatHookContext['toolConfig'];
-    prompts: IPrompt[];
-    messages: PromptConcatHookContext['messages'];
-    agentFrameworkContext: DefineToolAgentFrameworkContext;
-    findPrompt: (id: string) => ReturnType<typeof findPromptById>;
-    injectToolList: (options: InjectToolListOptions) => void;
-    injectContent: (options: InjectContentOptions) => void;
-}
-interface ResponseHandlerContext<TConfigSchema extends z.ZodType, TLLMToolSchemas extends Record<string, z.ZodType>> extends Omit<ToolHandlerContext<TConfigSchema>, 'prompts' | 'config'> {
-    config: z.infer<TConfigSchema> | undefined;
-    response: AIResponseContext['response'];
-    toolCall: ToolCallingMatch | null;
-    allToolCalls: Array<ToolCallingMatch & {
-        found: true;
-    }>;
-    isParallel: boolean;
-    agentFrameworkConfig: AIResponseContext['agentFrameworkConfig'];
-    executeToolCall: <TToolName extends keyof TLLMToolSchemas>(toolName: TToolName, executor: (parameters: z.infer<TLLMToolSchemas[TToolName]>) => Promise<ToolExecutionResult>) => Promise<boolean>;
-    executeAllMatchingToolCalls: <TToolName extends keyof TLLMToolSchemas>(toolName: TToolName, executor: (parameters: z.infer<TLLMToolSchemas[TToolName]>) => Promise<ToolExecutionResult>, options?: {
-        timeoutMs?: number;
-    }) => Promise<number>;
-    addToolResult: (options: AddToolResultOptions) => void;
-    yieldToSelf: () => void;
-    yieldToHuman: () => void;
-    hooks: PromptConcatHooks;
-    requestId?: string;
-}
-interface PostProcessHandlerContext<TConfigSchema extends z.ZodType> extends Omit<ToolHandlerContext<TConfigSchema>, never> {
-    llmResponse: string;
-    responses: PostProcessContext['responses'];
-}
-interface InjectToolListOptions {
-    targetId: string;
-    position: 'before' | 'after' | 'child';
-    toolSchemas?: z.ZodType[];
-    caption?: string;
-}
-interface InjectContentOptions {
-    targetId: string;
-    position: 'before' | 'after' | 'child';
-    content: string;
-    caption?: string;
-    id?: string;
-}
-interface AddToolResultOptions {
-    toolName: string;
-    parameters: unknown;
-    result: string;
-    isError?: boolean;
-    duration?: number;
-}
-interface ToolExecutionResult {
-    success: boolean;
-    data?: string;
-    error?: string;
-    metadata?: Record<string, unknown>;
-}
-interface DefinedTool<TConfigSchema extends z.ZodType = z.ZodType, TLLMToolSchemas extends Record<string, z.ZodType> = Record<string, z.ZodType>> {
-    tool: PromptConcatTool;
-    toolId: string;
-    configSchema: TConfigSchema;
-    llmToolSchemas: TLLMToolSchemas | undefined;
-    displayName: string;
-    description: string;
-}
-
-/**
- * TidGi `defineTool.ts` 逐行迁移；持久化改为 `AgentFrameworkContext.persistAgentMessage`（memeloop）。
- */
-
-declare function defineTool<TConfigSchema extends z.ZodType, TLLMToolSchemas extends Record<string, z.ZodType> = Record<string, z.ZodType>>(definition: ToolDefinition<TConfigSchema, TLLMToolSchemas>): {
-    tool: PromptConcatTool;
-    toolId: string;
-    configSchema: TConfigSchema;
-    llmToolSchemas: TLLMToolSchemas | undefined;
-    displayName: string;
-    description: string;
-};
-
-/**
- * Host agent tool configuration → prompt plugin mapping.
- * Every host (Desktop, CLI, Cloud) that defines agent tools needs this merge logic.
- * Defined once in memeloop so each host doesn't reimplement it.
- */
-
-type HostAgentToolConfig = AgentDefinitionToolConfig;
-declare function mergeAgentToolsIntoFrameworkConfig(frameworkConfig: AgentFrameworkConfig | undefined, agentTools: HostAgentToolConfig[] | undefined): AgentFrameworkConfig;
-
-/**
- * TidGi `parallelExecution.ts` 迁移。
- */
-
-interface ToolCallEntry {
-    call: ToolCallingMatch & {
-        found: true;
-    };
-    executor: (parameters: Record<string, unknown>) => Promise<ToolExecutionResult>;
-    timeoutMs?: number;
-}
-interface ToolCallResult {
-    call: ToolCallingMatch & {
-        found: true;
-    };
-    status: 'fulfilled' | 'rejected' | 'timeout';
-    result?: ToolExecutionResult;
-    error?: string;
-}
-declare function executeToolCallsParallel(entries: ToolCallEntry[], batchTimeoutMs?: number): Promise<ToolCallResult[]>;
-declare function executeToolCallsSequential(entries: ToolCallEntry[]): Promise<ToolCallResult[]>;
-
-/**
- * 默认全局注册表。生产与常规定义工具共用此 Map。
- * 测试或沙箱可用 {@link runWithPluginRegistry} 替换为独立 Map，避免用例间泄漏。
- */
-declare const pluginRegistry: Map<string, PromptConcatTool>;
-declare function getActivePluginRegistry(): Map<string, PromptConcatTool>;
-declare function runWithPluginRegistry<T>(registry: Map<string, PromptConcatTool>, function_: () => T): T;
-declare function createAgentFrameworkHooks(): PromptConcatHooks;
-declare function runProcessPromptsHooks<TContext>(_hooks: PromptConcatHooks, context: TContext): Promise<TContext>;
-declare function runResponseCompleteHooks(hooks: PromptConcatHooks, context: unknown): Promise<void>;
-declare function runPostProcessHooks(hooks: PromptConcatHooks, context: unknown): Promise<void>;
-declare function runToolExecutedHooks(hooks: PromptConcatHooks, context: unknown): Promise<void>;
-/**
- * TidGi `createHooksWithPlugins`：按 agentFrameworkConfig.plugins 把插件注册表里的工具挂到 hooks。
- */
-/** 从 Agent 上下文解析插件表：优先 `tools.getPromptPlugins()`，否则 ALS / 全局默认。 */
-declare function resolvePromptPluginMap(context: {
-    tools?: {
-        getPromptPlugins?: () => Map<string, PromptConcatTool>;
-    };
-}): Map<string, PromptConcatTool>;
-declare function createHooksWithPlugins(agentFrameworkConfig: {
-    plugins?: Array<{
-        toolId: string;
-        [key: string]: unknown;
-    }>;
-}, options?: {
-    pluginRegistry?: Map<string, PromptConcatTool>;
-}): Promise<{
-    hooks: PromptConcatHooks;
-    pluginConfigs: Array<{
-        toolId: string;
-        [key: string]: unknown;
-    }>;
-}>;
-
-declare function registerToolParameterSchema(toolId: string, schema: unknown, metadata?: {
-    displayName: string;
-    description: string;
-}): void;
-declare function getToolParameterSchema(toolId: string): unknown;
-declare function getToolMetadata(toolId: string): {
-    displayName: string;
-    description: string;
-} | undefined;
-
-/**
- * Generate tool description for prompt injection from zod v4 schema definitions.
- */
-
-declare function schemaToToolContent(schema: z.ZodType): string;
-
-/**
- * Tools may attach this key to their return object so `taskAgent` persists
- * `summary` + optional `detailRef` instead of `JSON.stringify` of the whole payload (plan §5.2.1).
- */
-declare const MEMELOOP_STRUCTURED_TOOL_KEY: "__memeloopToolResult";
-/** Truncate tool summary for persisted `ChatMessage` / LLM context (plan §5.2.1). */
-declare function truncateToolSummary(s: string, max?: number): string;
-interface MemeloopStructuredToolPayload {
-    /** Short text for the tool message body (≤2000 chars recommended). */
-    summary: string;
-    detailRef?: DetailReference;
-    /**
-     * When set, `taskAgent` pauses after persisting this tool row until `waitForTerminalSession` resolves
-     * (terminal `await` mode, plan §16.4.1).
-     */
-    awaitSessionId?: string;
-}
-declare function extractMemeloopStructuredToolPayload(raw: unknown): MemeloopStructuredToolPayload | null;
-
-/**
- * Tool definition registry.
- * Converted from module-level singletons to an instance class for test isolation
- * and multi-runtime support.
- */
-
-/**
- * Instance-level tool definition registry.
- */
-declare class ToolDefinitionRegistry {
-    private readonly registry;
-    registerToolDefinition<TConfigSchema extends z.ZodType, TLLMToolSchemas extends Record<string, z.ZodType>>(definition: ToolDefinition<TConfigSchema, TLLMToolSchemas>): DefinedTool<TConfigSchema, TLLMToolSchemas>;
-    getAllToolDefinitions(): Map<string, DefinedTool>;
-    getToolDefinition(toolId: string): DefinedTool | undefined;
-}
-declare function getDefaultToolDefinitionRegistry(): ToolDefinitionRegistry;
-declare function registerToolDefinition<TConfigSchema extends z.ZodType, TLLMToolSchemas extends Record<string, z.ZodType>>(definition: ToolDefinition<TConfigSchema, TLLMToolSchemas>): DefinedTool<TConfigSchema, TLLMToolSchemas>;
-declare function getAllToolDefinitions(): Map<string, DefinedTool>;
-declare function getToolDefinition(toolId: string): DefinedTool | undefined;
-
-export { type AIResponseContext, type AIStreamResponseSubset, ALL_CATEGORIES, ASK_QUESTION_TOOL_ID, ASK_USER_QUESTION_TOOL_ID, type AddToolResultOptions, type AgentConversationClient, AgentCreationController, type AgentCreationControllerOptions, type AgentCreationState, type AgentDefinition, AgentDefinitionEditorController, type AgentDefinitionEditorControllerOptions, type AgentDefinitionEditorState, type AgentDefinitionModelConfig, type AgentDefinitionRepository, type AgentDefinitionToolConfig, type AgentFrameworkConfig, type AgentFrameworkContext, type AgentHeartbeatConfig, type AgentInstanceModel as AgentInstance, type AgentInstanceClient, type AgentInstanceLatestStatus, type AgentInstanceMeta, type AgentInstanceModel, type AgentInstanceState, type AgentLoopDefinition, type AgentLoopGenerator, type AgentLoopInput, type AgentLoopRuntime, type AgentLoopStep, type AgentProfile, AgentProfileRegistry, type AgentProfileType, type AgentPromptDescription, type AgentResponse, type AgentRuntimeView, AgentSessionController, type AgentSessionControllerOptions, type AgentSessionListener, type AgentSessionSnapshot, type AgentStartData, type AgentStatusContext, type AgentStopData, type AgentUpdateListener, type AiAPIConfig, type ApprovalDecision, type AttachmentBlob, type AttachmentReference, BUILTIN_AGENT_PROFILES, BUILTIN_TOOL_PLUGIN_IDS, type BaseToolContext, type BuiltinToolContext, type BuiltinToolImpl, type CategoryConfig, type ChatMessage, type ChatRole, ChatSyncEngine, type ChatSyncEngineOptions, type ChatSyncPeer, type CheckpointRecord, type CheckpointStore, type CloudDeviceRecord, type CompactionOptions, type CompactionResult, type ContextCompactionData, type ConversationMeta, type ConversationQueryMode, type CreateAgentOptions, type CreateScheduledTaskInput, type CreationStateListener, type DefineToolAgentFrameworkContext, type DefinedTool, type DetailRefType, type DetailReference, type Device, type DeviceAccountBindingRequest, type DeviceAuthorizer, type DeviceCapabilities, type DeviceConnectionGrant, type DeviceNetworkListenOptions, type DeviceNetworkPath, type DeviceNetworkService, type DevicePlatform, type DeviceReachability, type DeviceReachabilityState, type DeviceSyncTransport, type DeviceTrustMode, type EditorStateChange, type EditorStateListener, type ExchangeVersionVectorResult, type FrameworkPluginToolConfig, type GetMessagesOptions, type HookContext, type HookHandler, HookRegistry, type HookResult, type HookSlot, type HookType, type HostAgentToolConfig$1 as HostAgentToolConfig, type IAgentStorage$1 as IAgentStorage, type IChatSyncAdapter, type IIMAdapter, type IIMMessageRenderer, type ILLMProvider, type IMChannel, type IMChannelBinding, IMChannelManager, type IMPlatformType, IM_SESSION_TOOL_IDS, type INetworkService, type IPrompt, type IToolRegistry, type ImAgentDriver, type ImChannelBindingRecord, type ImInboundMessage, type ImSessionBuiltinRegistration, type ImSlashCommandContext, type ImStreamFlush, type ImToolsRuntime, type ImWebhookContext, type InjectContentOptions, type InjectToolListOptions, LLM_IO_LOOP_ID, type LanDiscoveryBrowseOptions, type LanDiscoveryRegisterOptions, Libp2pDeviceNetworkService, type Libp2pDeviceNetworkServiceOptions, type ListConversationsOptions, type LlmIoLoopOptions, type LoadPluginModuleOptions, type LoadSubAgentLoopScriptOptions, type LoadedPlugin, type LocalDeviceIdentity, type LoopPlugin, type LoopProfile, type LoopProfilePluginEntry, type LoopProfilePrompt, LoopRegistryImpl, MEMELOOP_SERVICE_TYPE, MEMELOOP_STRUCTURED_TOOL_KEY, type MemeLoopDuplexStream, type MemeLoopLogger, type MemeLoopProtocol, type MemeLoopRuntime, type MemeloopServiceInfo, type MemeloopStructuredToolPayload, MemoryDeviceNetworkService, type MemoryDeviceNetworkServiceOptions, type MergedPermissions, type ModelParameters, type ModelSelection, PERMISSIONS_TABLE_DDL, PLUGIN_ASK_QUESTION, PLUGIN_ASK_USER_QUESTION, PLUGIN_MCP_CLIENT, PLUGIN_MCP_FORWARD, PLUGIN_REMOTE_AGENT, PLUGIN_SPAWN_AGENT, PLUGIN_TASK, PLUGIN_TODO_WRITE, type PairingSession, PeerNodeSyncAdapter, type PeerNodeTransport, type PermissionAction, type PermissionRule, type PermissionSet, type PermissionSqlDatabase, type PermissionSqlStatement, type PluginAPI, type PluginAPIOptions, type PluginExports, type PluginManifest, type PluginModule, type PostProcessContext, type PostProcessHandlerContext, type PostToolUseData, type PreToolUseData, type PreviewDialogListener, type PromptConcatHookContext, type PromptConcatHooks, type PromptConcatPluginPreview, type PromptConcatStreamState, type PromptConcatTool, type PromptNode, type PromptPluginConfig, type PromptPreviewClient, PromptPreviewController, type PromptPreviewControllerOptions, type PromptPreviewDialogState, type PromptPreviewProgress, type PromptPreviewResult, type ProviderConfig, ProviderRegistry, type RawSeedDeviceIdentity, type RegisteredProvider, type ResponseHandlerContext, type RunTaskAgentTurnCallbacks, type RunTaskAgentTurnResult, SUB_AGENT_LOOP_ID, type ScheduleEditorState, type ScheduledTask, type ScheduledTaskClient, type SendMessageOptions, SessionStorage, type SubAgentLoopContext, type SubAgentLoopScript, type SubAgentLoopScriptArguments, type SyncResult, TODO_WRITE_TOOL_ID, type TaskCategory, TextMessageRenderer, type TiddlerFieldsForAgent, TokenTracker, type ToolActions, type ToolApprovalConfig, type ToolApprovalMode, type ToolApprovalRequest, type ToolCall, type ToolCallEntry, type ToolCallResult, type ToolCallingMatch, type ToolDefinition, ToolDefinitionRegistry, type ToolExecutionContext, type ToolExecutionResult, type ToolHandlerContext, type ToolPermissionRules, type TrustedDeviceRecord, type UserMessageContext, type UserPromptSubmitData, type VersionVector, type WikiTiddlerAttachment, type WikiTiddlerClickData, type YieldNextRoundTarget, __clearTodoStore, askQuestionConfigSchema, askQuestionImpl, askUserQuestionConfigSchema, askUserQuestionImpl, autoCompact, buildAgent, buildDeviceBindingMessage, cancelPendingApprovals, checkPermission, clearHooks, clearPluginRegistrations, compactMessages, createAgentFrameworkHooks, createAgentInstanceFromDefinition, createChatMessage, createCheckpointRecord, createDeviceIdentity, createHooksWithPlugins, createInstanceDeltaFromDefinition, createMemeLoopRuntime, createPluginAPI, createSubAgentLoopDefinition, createTaskAgent, decodeAttachmentBlobRpc, decodePublicKeyMultibase, defineTool, encodePublicKeyMultibase, evaluateApproval, executeHooks, executeToolCallsParallel, executeToolCallsSequential, exploreAgent, extractMemeloopStructuredToolPayload, findPromptById, flattenPrompts, getActivePluginRegistry, getAgentProfileRegistry, getAllToolDefinitions, getBuiltinLoopProfile, getBuiltinLoopProfiles, getBuiltinToolPlugins, getCategoryConfig, getDefaultHookRegistry, getDefaultToolDefinitionRegistry, getHookCount, getLoadedPlugin, getLoopRegistry, getMcpClientToolId, getMcpForwardToolId, getPendingApprovals, getPluginRegistrations, getRemoteAgentToolId, getSpawnAgentToolId, getSubAgentLoopId, getTaskToolId, getToolDefinition, getToolMetadata, getToolParameterSchema, gitProxyTargetBlockReason, hasHooks, imPlatformMaxMessageChars, imSwitchConversation, imToolDefinitions, isConversationMeta, isPluginLoaded, isTaskCategory, isUserInitiatedConversation, librarianAgent, listPlugins, listRegisteredHookTypes, loadPluginModule, loadPluginModules, loadSubAgentLoopScript, loadUserPermissions, matchAllToolCallings, matchPattern, matchToolCalling, mcpClientConfigSchema, mcpClientImpl, mcpForwardConfigSchema, mcpForwardImpl, mergeAgentToolsIntoFrameworkConfig, mergePermissionSets, onApprovalRequest, oracleAgent, parseCheckpointRecord, pickAdapter, planAgent, pluginRegistry, privateKeyFromIdentity, promptConcatStream, registerBuiltinLoops, registerBuiltinPromptPlugins, registerBuiltinToolPlugins, registerBuiltinTools, registerHook, registerImSessionBuiltinTools, registerPluginHooks, registerPluginTools, registerToolDefinition, registerToolParameterSchema, remoteAgentConfigSchema, remoteAgentImpl, remoteAgentListImpl, requestApproval, resetAgentProfileRegistry, resetLoopRegistry, resolveApproval, resolveCategory, resolvePromptPluginMap, resolveQuestionAnswer, resolveTaskAgentTerminalState, runPostProcessHooks, runProcessPromptsHooks, runResponseCompleteHooks, runTaskAgentTurn, runToolExecutedHooks, runWithPluginRegistry, saveUserPermissions, schemaToToolContent, serializeCheckpointRecord, shouldCompact, signDeviceBinding, spawnAgentConfigSchema, spawnAgentImpl, streamRuntimeAgentReplyToIm, taskToolConfigSchema, taskToolImpl, tiddlerToAgentDefinition, todoWriteConfigSchema, todoWriteImpl, truncateToolSummary, tryHandleImSlashCommand, unloadAllPlugins, unloadPlugin, unregisterHook, validatePluginManifest, verifyDeviceBinding };