@shuyhere/takotako 0.0.1

package/dist/core/agent-loop.d.ts

@@ -0,0 +1,137 @@
+/**
+ * Agent loop — the CPU cycle.
+ *
+ * 1. Message arrives (from any Channel)
+ * 2. Session resolved (or created)
+ * 3. Context assembled (system prompt + dynamic skill injection + history + memory)
+ * 4. Provider.chat() called (streaming)
+ * 5. Tool calls executed (if any)
+ * 6. Response streamed back through Channel
+ * 7. Session persisted
+ * 8. Memory updated (if needed)
+ */
+import type { Provider } from '../providers/provider.js';
+import type { ToolRegistry } from '../tools/registry.js';
+import type { PromptBuilder } from './prompt.js';
+import type { ContextManager } from './context.js';
+import type { Session } from '../gateway/session.js';
+import type { HookSystem } from '../hooks/types.js';
+import type { SkillLoader } from '../skills/loader.js';
+import type { SessionCompactor } from '../gateway/compaction.js';
+import type { RetryQueue } from './retry-queue.js';
+import type { ProgressTracker } from './progress.js';
+import type { SessionInitConfig, StreamingConfig } from '../config/schema.js';
+import type { Channel } from '../channels/channel.js';
+import type { SkillCommandSpec } from '../commands/skill-commands.js';
+import type { CommandRegistry } from '../commands/registry.js';
+import { TypingManager } from './typing.js';
+import { ToolLoopDetector } from './tool-loop-detector.js';
+import type { UsageTracker } from './usage-tracker.js';
+import type { ThinkingManager } from './thinking.js';
+import type { ReactionManager } from './reactions.js';
+import type { TimezoneManager } from './timezone.js';
+/** Sentinel yielded after each intermediate turn so callers can flush text. */
+/** Configuration for the agent loop. */
+export interface AgentLoopConfig {
+    /** Max seconds before timeout */
+    timeout: number;
+    /** Max tool calls per turn */
+    maxToolCalls: number;
+    /** Max turns (inference + tool loop iterations) */
+    maxTurns: number;
+    /** Max output characters before truncation (default 50000) */
+    maxOutputChars: number;
+    /** Max output tokens per API call (passed to provider as max_tokens) */
+    maxTokens?: number;
+}
+/** Dependencies injected into the agent loop. */
+export interface AgentLoopDeps {
+    /** LLM provider for inference */
+    provider: Provider;
+    /** Registry of available tools */
+    toolRegistry: ToolRegistry;
+    /** System prompt builder */
+    promptBuilder: PromptBuilder;
+    /** Context window manager */
+    contextManager: ContextManager;
+    /** Lifecycle hook system */
+    hooks?: HookSystem;
+    /** Skill loader for dynamic injection based on message triggers */
+    skillLoader?: SkillLoader;
+    /** Model ID to use (e.g. 'anthropic/claude-sonnet-4-6') */
+    model?: string;
+    /** Agent workspace root path */
+    workspaceRoot?: string;
+    /** Session compactor for auto-compaction */
+    compactor?: SessionCompactor;
+    /** Retry queue for failed messages after failover exhaustion */
+    retryQueue?: RetryQueue;
+    /** Permission role name for the active agent (default: 'admin') */
+    agentRole?: string;
+    /** Active agent ID */
+    agentId?: string;
+    /** Command registry for built-in slash commands */
+    commandRegistry?: CommandRegistry;
+    /** Skill command specs for dispatch routing */
+    skillCommandSpecs?: SkillCommandSpec[];
+    /** Progress tracker for structured session progress */
+    progressTracker?: ProgressTracker;
+    /** Session init protocol configuration */
+    sessionInitConfig?: SessionInitConfig;
+    /** Response streaming configuration */
+    streamingConfig?: StreamingConfig;
+    /** Typing indicator manager */
+    typingManager?: TypingManager;
+    /** Tool loop detector */
+    toolLoopDetector?: ToolLoopDetector;
+    /** Channel reference for typing indicators */
+    channel?: Channel;
+    /** Usage tracker for token and cost monitoring */
+    usageTracker?: UsageTracker;
+    /** Thinking/reasoning control manager */
+    thinkingManager?: ThinkingManager;
+    /** Reaction feedback manager */
+    reactionManager?: ReactionManager;
+    /** Timezone manager for context injection */
+    timezoneManager?: TimezoneManager;
+}
+export declare class AgentLoop {
+    private config;
+    private deps;
+    constructor(deps: AgentLoopDeps, config?: Partial<AgentLoopConfig>);
+    /** Switch the active model at runtime. */
+    setModel(modelRef: string): void;
+    /** Get the current active model. */
+    getModel(): string;
+    /**
+     * Sanitize messages for API compatibility:
+     * - Merge consecutive user messages (some APIs reject this)
+     * - Ensure conversation doesn't end with assistant (prefill rejection)
+     * - Strip empty messages
+     * - Repair tool_use/tool_result pairing (Anthropic requires each tool_result
+     *   to have a matching tool_use in the previous assistant message)
+     */
+    private sanitizeMessages;
+    /**
+     * Repair tool_use/tool_result pairing in message history.
+     * Anthropic requires every tool_result to have a matching tool_use
+     * in the preceding assistant message, and vice versa.
+     *
+     * Based on reference runtime's repairToolUseResultPairing pattern.
+     */
+    private repairToolPairing;
+    /**
+     * Run the agent loop for a single turn.
+     * Yields text chunks as they stream from the provider.
+     * Dynamically injects matching skill instructions based on the user message.
+     */
+    /** Set the active channel for typing/reactions (call before run). */
+    setChannel(channel: Channel): void;
+    run(session: Session, userMessage: string, attachments?: Array<{
+        type: string;
+        url?: string;
+        filename?: string;
+        mimeType?: string;
+    }>): AsyncIterable<string>;
+}
+//# sourceMappingURL=agent-loop.d.ts.map

package/dist/core/agent-loop.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-loop.d.ts","sourceRoot":"","sources":["../../src/core/agent-loop.ts"],"names":[],"mappings":"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"}