memeloop 0.0.1

package/dist/types-B0Jm2l38.d.cts

@@ -0,0 +1,767 @@
+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 = 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>;
+}
+
+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 {
+    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>;
+    /** Read persisted attachment bytes for cross-node RPC `memeloop.storage.getAttachmentBlob`. */
+    readAttachmentData?(contentHash: string): Promise<Uint8Array | null>;
+    getAgentDefinition(id: string): Promise<AgentDefinition | null>;
+    /** Optional optimization: use `SELECT MAX(lamportClock)` instead of scanning all messages for clock state. */
+    getMaxLamportClockForConversation?(conversationId: string): Promise<number>;
+    saveAgentInstance(meta: AgentInstanceMeta): Promise<void>;
+    /** Read the conversation metadata row used by AgentToolLoop to resolve `definitionId`. */
+    getConversationMeta(conversationId: string): Promise<ConversationMeta | null>;
+    /** IM user-to-conversation binding (persisted by 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 plugin registry, isolated per runtime. Falls back to the process-level default registry. */
+    getPromptPlugins?: () => Map<string, (hooks: PromptConcatHooks) => void>;
+}
+interface IChatSyncAdapter {
+    start(): Promise<void>;
+    stop(): Promise<void>;
+}
+interface INetworkService {
+    start(): Promise<void>;
+    stop(): Promise<void>;
+}
+interface AgentToolLoopOptions {
+    /** Maximum LLM-to-tool round-trips. `0` means unlimited, still capped internally. */
+    maxIterations?: number;
+    /** Whether to parse `<tool_use>` / `<function_call>` and execute through `IToolRegistry` (default true). */
+    enableToolLoop?: boolean;
+    /** Cancellation check, e.g. when the user stops a run. */
+    isCancelled?: (conversationId: string) => boolean;
+    /** Attachment injection for promptConcat, aligned with `PromptConcatOptions`. */
+    readAttachmentFile?: (path: string) => Promise<Uint8Array | Buffer>;
+    /** Omit history older than this many milliseconds when building LLM input. `0` disables trimming. */
+    maxHistoryAgeMs?: number;
+    /**
+     * When `defineTool` / plugins are configured, fall back to `IToolRegistry` for tool calls not handled by `onResponseComplete`.
+     */
+    fallbackRegistryTools?: boolean;
+    /**
+     * Tool permission rules (default allow).
+     * Supports wildcards such as "terminal.*" and "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';
+            }>;
+        }>;
+    };
+    /** Threshold for repeated identical tool+input calls (default 3). */
+    doomLoopThreshold?: number;
+    /** History compaction window: keep the most recent N turns plus the last user message. */
+    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`, AgentToolLoop waits here before the next LLM round.
+     */
+    waitForTerminalSession?: (sessionId: string) => Promise<{
+        exitCode: number | null;
+        truncatedOutput: string;
+    }>;
+}
+interface AgentFrameworkContext {
+    storage: IAgentStorage;
+    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;
+    /** AgentToolLoop ReAct behavior, migrated from the TidGi-Desktop agentToolLoop integration. */
+    agentToolLoop?: AgentToolLoopOptions;
+    /**
+     * Host-injected runner used by `createMemeLoopRuntime` after a user sends a message.
+     */
+    runAgentToolLoop?: (input: AgentLoopInput) => AgentLoopGenerator;
+    /** Run a child agent for orchestration loops such as AgentAgentLoop. */
+    runChildAgent?: AgentLoopRuntime['runChildAgent'];
+    /** Policy for loading script-backed loops. Defaults to bundled scripts + import specifiers only. */
+    loopScriptPolicy?: AgentLoopScriptPolicy;
+    /**
+     * Build the agent view supplied to defineTool hooks for a conversation.
+     */
+    resolveAgentRuntimeView?: (conversationId: string, messages: ChatMessage[]) => Promise<AgentInstanceModel>;
+    /** Current agent view for defineTool / TidGi compatibility. */
+    agent?: {
+        id: string;
+        messages: ChatMessage[];
+    };
+    /** Persist a `ChatMessage` if the runtime host supplies this hook. */
+    persistAgentMessage?: (message: ChatMessage) => Promise<void>;
+    /** Cancellation markers written by `createMemeLoopRuntime`. */
+    conversationCancellation?: Set<string>;
+    /** Resolve an AgentDefinition from host-specific sources. */
+    resolveAgentDefinition?: (definitionId: string) => Promise<AgentDefinition | null>;
+    /** Fallback logger used when the host does not inject one. */
+    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;
+    isDelegatedAgentRun?: boolean;
+    parentAgentRunId?: 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 (agent-run log, terminal session, file). */
+type DetailRefType = 'agent-run' | 'terminal-session' | 'file';
+interface DetailReference {
+    type: DetailRefType;
+    /** Delegated 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>;
+}
+
+/**
+ * Unified loop contract for all agent loop types.
+ * Replaces the old AgentToolLoopInput / AgentToolLoopStep 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. "agent-tool-loop" or "agent-agent-loop". */
+    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;
+}
+type LoopProfileScriptReference = {
+    kind: 'builtin';
+    id: string;
+} | {
+    kind: 'specifier';
+    specifier: string;
+} | {
+    kind: 'source';
+    source: string;
+    name?: string;
+};
+interface AgentLoopScriptPolicy {
+    allowBuiltin?: boolean;
+    allowFile?: boolean;
+    allowNetwork?: boolean;
+    allowSource?: boolean;
+    allowSpecifier?: boolean;
+    importModule?: (specifier: string) => Promise<unknown>;
+}
+/** 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 "agent-tool-loop" if omitted. */
+    loopId?: string;
+    /** Structured reference to the loop script. Prefer this over `script` for new profiles. */
+    scriptReference?: LoopProfileScriptReference;
+    /** Legacy alias for `scriptReference`. */
+    scriptRef?: LoopProfileScriptReference;
+    /** Legacy path/specifier 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;
+    };
+}
+
+export { type IChatSyncAdapter as $, type AgentDefinition as A, type AgentLoopDefinition as B, type ConversationMeta as C, type DefineToolAgentFrameworkContext as D, type AgentLoopRuntime as E, type AgentLoopScriptPolicy as F, type GetMessagesOptions as G, type AgentLoopStep as H, type IAgentStorage as I, type AgentPromptDescription as J, type AgentResponse as K, type ListConversationsOptions as L, type AgentStatusContext as M, type AgentToolLoopOptions as N, type AiAPIConfig as O, type PromptConcatTool as P, type BaseToolContext as Q, type ChatRole as R, type CheckpointRecord as S, type ToolApprovalConfig as T, type CheckpointStore as U, type VersionVector as V, type ConversationQueryMode as W, type DetailRefType as X, type FrameworkPluginToolConfig as Y, type HookSlot as Z, type HostAgentToolConfig as _, type ChatMessage as a, type ILLMProvider as a0, type IMChannel as a1, type INetworkService as a2, type ImChannelBindingRecord as a3, type LoopPlugin as a4, type LoopProfile as a5, type LoopProfilePluginEntry as a6, type LoopProfilePrompt as a7, type LoopProfileScriptReference as a8, type MemeLoopLogger as a9, type ModelParameters as aa, type ModelSelection as ab, type PromptNode as ac, type PromptPluginConfig as ad, SessionStorage as ae, type ToolActions as af, type ToolApprovalMode as ag, type ToolCall as ah, type ToolExecutionContext as ai, type UserMessageContext as aj, type YieldNextRoundTarget as ak, createCheckpointRecord as al, createInstanceDeltaFromDefinition as am, isConversationMeta as an, isUserInitiatedConversation as ao, matchAllToolCallings as ap, matchToolCalling as aq, parseCheckpointRecord as ar, serializeCheckpointRecord as as, type AgentFrameworkConfig as b, type IMPlatformType as c, type IMChannelBinding as d, type AttachmentReference as e, type AgentInstanceMeta as f, type ApprovalDecision as g, type ToolApprovalRequest as h, type AgentFrameworkContext as i, type AgentLoopInput as j, type AgentLoopGenerator as k, type IToolRegistry as l, type PromptConcatHookContext as m, type IPrompt as n, type PostProcessContext as o, type AIResponseContext as p, type ToolCallingMatch as q, type PromptConcatHooks as r, type AgentDefinitionToolConfig as s, type DetailReference as t, type AIStreamResponseSubset as u, type AgentDefinitionModelConfig as v, type AgentHeartbeatConfig as w, type AgentInstanceModel as x, type AgentInstanceLatestStatus as y, type AgentInstanceState as z };