@shuyhere/takotako 0.0.1

package/dist/core/message-queue.js

@@ -0,0 +1,182 @@
+/**
+ * Message queue — collect, debounce, and cap inbound messages.
+ *
+ * When messages arrive faster than the model can process them:
+ * - collect: batch messages within a time window
+ * - debounce: wait for a pause in typing before processing
+ * - cap: limit max queued messages to prevent context overflow
+ * - drop: configurable strategy when cap is hit (oldest, summarize)
+ */
+const DEFAULT_QUEUE_CONFIG = {
+    mode: 'collect',
+    debounceMs: 2000,
+    cap: 25,
+    dropStrategy: 'oldest',
+    maxWaitMs: 10_000,
+};
+export class MessageQueue {
+    config;
+    queues;
+    timers;
+    maxTimers;
+    processor;
+    constructor(config, processor) {
+        this.config = { ...DEFAULT_QUEUE_CONFIG, ...config };
+        this.queues = new Map();
+        this.timers = new Map();
+        this.maxTimers = new Map();
+        this.processor = processor;
+    }
+    /** Enqueue a message. Returns true if message was queued (not processed immediately). */
+    enqueue(sessionId, message) {
+        if (this.config.mode === 'off') {
+            // Process immediately — don't queue
+            this.processor(sessionId, [message]).catch((err) => {
+                console.error(`[message-queue] Processor error for session ${sessionId}:`, err instanceof Error ? err.message : err);
+            });
+            return false;
+        }
+        let queue = this.queues.get(sessionId);
+        if (!queue) {
+            queue = [];
+            this.queues.set(sessionId, queue);
+        }
+        queue.push(message);
+        // Enforce cap
+        if (queue.length > this.config.cap) {
+            if (this.config.dropStrategy === 'oldest') {
+                queue.shift();
+            }
+            // 'summarize' strategy keeps all messages — mergeMessages handles it
+        }
+        // Force-process when cap is hit exactly
+        if (queue.length >= this.config.cap) {
+            this.processQueue(sessionId).catch((err) => {
+                console.error(`[message-queue] Cap-triggered flush error for session ${sessionId}:`, err instanceof Error ? err.message : err);
+            });
+            return true;
+        }
+        if (this.config.mode === 'debounce') {
+            this.startDebounceTimer(sessionId);
+        }
+        else {
+            // 'collect' mode: start debounce timer on first message, maxWait governs force-flush
+            this.startDebounceTimer(sessionId);
+        }
+        // Start max wait timer if not already running
+        this.startMaxWaitTimer(sessionId);
+        return true;
+    }
+    /** Force-flush a session's queue immediately. */
+    async flush(sessionId) {
+        await this.processQueue(sessionId);
+    }
+    /** Get current queue depth for a session. */
+    depth(sessionId) {
+        return this.queues.get(sessionId)?.length ?? 0;
+    }
+    /** Clear all queues and timers. */
+    clear() {
+        for (const timer of this.timers.values())
+            clearTimeout(timer);
+        for (const timer of this.maxTimers.values())
+            clearTimeout(timer);
+        this.timers.clear();
+        this.maxTimers.clear();
+        this.queues.clear();
+    }
+    /** Get queue status for all sessions. */
+    status() {
+        const now = Date.now();
+        const result = [];
+        for (const [sessionId, queue] of this.queues) {
+            if (queue.length === 0)
+                continue;
+            result.push({
+                sessionId,
+                depth: queue.length,
+                oldestMs: now - queue[0].timestamp,
+            });
+        }
+        return result;
+    }
+    /** Update the queue mode at runtime. */
+    setMode(mode) {
+        this.config.mode = mode;
+    }
+    /** Get current config. */
+    getConfig() {
+        return { ...this.config };
+    }
+    startDebounceTimer(sessionId) {
+        // Clear existing debounce timer
+        const existing = this.timers.get(sessionId);
+        if (existing)
+            clearTimeout(existing);
+        const timer = setTimeout(() => {
+            this.timers.delete(sessionId);
+            this.processQueue(sessionId).catch((err) => {
+                console.error(`[message-queue] Debounce-triggered flush error for session ${sessionId}:`, err instanceof Error ? err.message : err);
+            });
+        }, this.config.debounceMs);
+        this.timers.set(sessionId, timer);
+    }
+    startMaxWaitTimer(sessionId) {
+        // Only start if not already running
+        if (this.maxTimers.has(sessionId))
+            return;
+        const timer = setTimeout(() => {
+            this.maxTimers.delete(sessionId);
+            this.processQueue(sessionId).catch((err) => {
+                console.error(`[message-queue] MaxWait-triggered flush error for session ${sessionId}:`, err instanceof Error ? err.message : err);
+            });
+        }, this.config.maxWaitMs);
+        this.maxTimers.set(sessionId, timer);
+    }
+    async processQueue(sessionId) {
+        // Clear timers
+        const debounceTimer = this.timers.get(sessionId);
+        if (debounceTimer) {
+            clearTimeout(debounceTimer);
+            this.timers.delete(sessionId);
+        }
+        const maxTimer = this.maxTimers.get(sessionId);
+        if (maxTimer) {
+            clearTimeout(maxTimer);
+            this.maxTimers.delete(sessionId);
+        }
+        // Grab and clear the queue atomically
+        const queue = this.queues.get(sessionId);
+        if (!queue || queue.length === 0)
+            return;
+        const messages = [...queue];
+        queue.length = 0;
+        await this.processor(sessionId, messages);
+    }
+    /** Merge queued messages into a single string for the model. */
+    static mergeMessages(messages) {
+        if (messages.length === 0)
+            return '';
+        if (messages.length === 1)
+            return messages[0].content;
+        // Detect group chat (multiple authors)
+        const authors = new Set(messages.map((m) => m.authorId));
+        const isGroup = authors.size > 1;
+        // Calculate time span
+        const oldest = messages[0].timestamp;
+        const newest = messages[messages.length - 1].timestamp;
+        const spanSeconds = Math.round((newest - oldest) / 1000);
+        const lines = [];
+        for (const msg of messages) {
+            if (isGroup) {
+                lines.push(`[${msg.authorId}]: ${msg.content}`);
+            }
+            else {
+                lines.push(msg.content);
+            }
+        }
+        const header = `[queued: ${messages.length} messages over ${spanSeconds}s]`;
+        return `${header}\n${lines.join('\n')}`;
+    }
+}
+//# sourceMappingURL=message-queue.js.map

package/dist/core/message-queue.js.map

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

package/dist/core/network-policy.d.ts

@@ -0,0 +1,39 @@
+/**
+ * Network Policy — controls which URLs/domains tools can access.
+ *
+ * Modes:
+ * - 'blocklist': block listed domains (default — blocks private IPs + localhost)
+ * - 'allowlist': only allow listed domains
+ */
+export interface NetworkPolicyConfig {
+    /** Policy mode. */
+    mode: 'allowlist' | 'blocklist';
+    /** Allowed domains (only used in 'allowlist' mode). */
+    allowlist?: string[];
+    /** Blocked domains (only used in 'blocklist' mode). */
+    blocklist?: string[];
+}
+export interface NetworkCheckResult {
+    /** Whether the request is allowed. */
+    allowed: boolean;
+    /** Reason for blocking. */
+    reason?: string;
+}
+export declare class NetworkPolicy {
+    private config;
+    private blocklist;
+    private allowlist;
+    constructor(config: NetworkPolicyConfig);
+    /**
+     * Check if a URL is allowed by the network policy.
+     */
+    check(urlStr: string): NetworkCheckResult;
+    /**
+     * Check a hostname directly (without full URL parsing).
+     */
+    checkHost(hostname: string): NetworkCheckResult;
+    private checkAllowlist;
+    private checkBlocklist;
+    private matchesList;
+}
+//# sourceMappingURL=network-policy.d.ts.map

package/dist/core/network-policy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"network-policy.d.ts","sourceRoot":"","sources":["../../src/core/network-policy.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAIH,MAAM,WAAW,mBAAmB;IAClC,mBAAmB;IACnB,IAAI,EAAE,WAAW,GAAG,WAAW,CAAC;IAChC,uDAAuD;IACvD,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;IACrB,uDAAuD;IACvD,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;CACtB;AAED,MAAM,WAAW,kBAAkB;IACjC,sCAAsC;IACtC,OAAO,EAAE,OAAO,CAAC;IACjB,2BAA2B;IAC3B,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAoCD,qBAAa,aAAa;IACxB,OAAO,CAAC,MAAM,CAAsB;IACpC,OAAO,CAAC,SAAS,CAAc;IAC/B,OAAO,CAAC,SAAS,CAAc;gBAEnB,MAAM,EAAE,mBAAmB;IASvC;;OAEG;IACH,KAAK,CAAC,MAAM,EAAE,MAAM,GAAG,kBAAkB;IAgBzC;;OAEG;IACH,SAAS,CAAC,QAAQ,EAAE,MAAM,GAAG,kBAAkB;IAU/C,OAAO,CAAC,cAAc;IAQtB,OAAO,CAAC,cAAc;IActB,OAAO,CAAC,WAAW;CAcpB"}

package/dist/core/network-policy.js

@@ -0,0 +1,121 @@
+/**
+ * Network Policy — controls which URLs/domains tools can access.
+ *
+ * Modes:
+ * - 'blocklist': block listed domains (default — blocks private IPs + localhost)
+ * - 'allowlist': only allow listed domains
+ */
+// ─── Default blocklist ──────────────────────────────────────────────
+const DEFAULT_BLOCKLIST = [
+    'localhost',
+    '127.0.0.1',
+    '0.0.0.0',
+    '::1',
+    'host.docker.internal',
+    'metadata.google.internal',
+    '169.254.169.254',
+];
+// ─── Private IP check ───────────────────────────────────────────────
+function isPrivateIp(hostname) {
+    // IPv4 private ranges
+    if (/^127\.\d+\.\d+\.\d+$/.test(hostname))
+        return true;
+    if (/^10\.\d+\.\d+\.\d+$/.test(hostname))
+        return true;
+    if (/^172\.(1[6-9]|2\d|3[01])\.\d+\.\d+$/.test(hostname))
+        return true;
+    if (/^192\.168\.\d+\.\d+$/.test(hostname))
+        return true;
+    if (/^169\.254\.\d+\.\d+$/.test(hostname))
+        return true;
+    if (hostname === '0.0.0.0')
+        return true;
+    // IPv6 private ranges
+    if (hostname === '::1')
+        return true;
+    if (/^fc00:/i.test(hostname))
+        return true;
+    if (/^fd[0-9a-f]{2}:/i.test(hostname))
+        return true;
+    if (/^fe80:/i.test(hostname))
+        return true;
+    return false;
+}
+// ─── Network Policy ─────────────────────────────────────────────────
+export class NetworkPolicy {
+    config;
+    blocklist;
+    allowlist;
+    constructor(config) {
+        this.config = config;
+        this.blocklist = new Set([
+            ...DEFAULT_BLOCKLIST,
+            ...(config.blocklist ?? []),
+        ]);
+        this.allowlist = new Set(config.allowlist ?? []);
+    }
+    /**
+     * Check if a URL is allowed by the network policy.
+     */
+    check(urlStr) {
+        let hostname;
+        try {
+            const url = new URL(urlStr);
+            hostname = url.hostname;
+        }
+        catch {
+            return { allowed: false, reason: `Invalid URL: ${urlStr}` };
+        }
+        if (this.config.mode === 'allowlist') {
+            return this.checkAllowlist(hostname);
+        }
+        else {
+            return this.checkBlocklist(hostname);
+        }
+    }
+    /**
+     * Check a hostname directly (without full URL parsing).
+     */
+    checkHost(hostname) {
+        if (this.config.mode === 'allowlist') {
+            return this.checkAllowlist(hostname);
+        }
+        else {
+            return this.checkBlocklist(hostname);
+        }
+    }
+    // ─── Private ────────────────────────────────────────────────────
+    checkAllowlist(hostname) {
+        // In allowlist mode, everything is blocked unless explicitly allowed
+        if (this.matchesList(hostname, this.allowlist)) {
+            return { allowed: true };
+        }
+        return { allowed: false, reason: `Domain not in allowlist: ${hostname}` };
+    }
+    checkBlocklist(hostname) {
+        // Always block private IPs regardless of blocklist
+        if (isPrivateIp(hostname)) {
+            return { allowed: false, reason: `Private/internal IP blocked: ${hostname}` };
+        }
+        // Check explicit blocklist
+        if (this.matchesList(hostname, this.blocklist)) {
+            return { allowed: false, reason: `Domain blocked: ${hostname}` };
+        }
+        return { allowed: true };
+    }
+    matchesList(hostname, list) {
+        // Exact match
+        if (list.has(hostname))
+            return true;
+        // Wildcard match (e.g. *.internal)
+        for (const entry of list) {
+            if (entry.startsWith('*.')) {
+                const suffix = entry.slice(1); // .internal
+                if (hostname.endsWith(suffix))
+                    return true;
+            }
+        }
+        return false;
+    }
+}
+//# sourceMappingURL=network-policy.js.map

package/dist/core/network-policy.js.map

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

package/dist/core/progress.d.ts

@@ -0,0 +1,48 @@
+/**
+ * Progress tracker — structured JSON log of what each session accomplished.
+ *
+ * Inspired by Anthropic's claude-progress.txt but using JSON (models are
+ * less likely to corrupt JSON vs Markdown).
+ *
+ * The progress file lives in the agent workspace at `tako-progress.json`.
+ * Each session appends an entry at the end. The agent reads it at session
+ * start to understand what happened before.
+ */
+export interface ProgressEntry {
+    /** Session ID that created this entry */
+    sessionId: string;
+    /** ISO timestamp */
+    timestamp: string;
+    /** What features/tasks were worked on */
+    featuresWorkedOn: string[];
+    /** Files that were changed */
+    filesChanged: string[];
+    /** Key decisions made */
+    decisionsMade: string[];
+    /** Issues encountered or unresolved */
+    blockers: string[];
+    /** Recommended next steps */
+    nextSteps: string[];
+    /** Git commit hashes created during this session */
+    commits: string[];
+    /** Compaction count at time of writing (tracks how many compactions happened) */
+    compactionCount: number;
+}
+export interface ProgressFile {
+    version: 1;
+    projectName: string;
+    entries: ProgressEntry[];
+}
+export declare class ProgressTracker {
+    private filePath;
+    constructor(workspaceDir: string);
+    /** Read the progress file. Returns null if it doesn't exist. */
+    read(): Promise<ProgressFile | null>;
+    /** Append a new progress entry. Creates the file if it doesn't exist. */
+    append(entry: ProgressEntry, projectName?: string): Promise<void>;
+    /** Get the most recent N entries. */
+    getRecent(count?: number): Promise<ProgressEntry[]>;
+    /** Get a summary string suitable for injecting into context. */
+    getSummaryForContext(maxEntries?: number): Promise<string | null>;
+}
+//# sourceMappingURL=progress.d.ts.map

package/dist/core/progress.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"progress.d.ts","sourceRoot":"","sources":["../../src/core/progress.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAMH,MAAM,WAAW,aAAa;IAC5B,yCAAyC;IACzC,SAAS,EAAE,MAAM,CAAC;IAClB,oBAAoB;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,yCAAyC;IACzC,gBAAgB,EAAE,MAAM,EAAE,CAAC;IAC3B,8BAA8B;IAC9B,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,yBAAyB;IACzB,aAAa,EAAE,MAAM,EAAE,CAAC;IACxB,uCAAuC;IACvC,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,6BAA6B;IAC7B,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,oDAAoD;IACpD,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,iFAAiF;IACjF,eAAe,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,CAAC,CAAC;IACX,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,aAAa,EAAE,CAAC;CAC1B;AAED,qBAAa,eAAe;IAC1B,OAAO,CAAC,QAAQ,CAAS;gBAEb,YAAY,EAAE,MAAM;IAIhC,gEAAgE;IAC1D,IAAI,IAAI,OAAO,CAAC,YAAY,GAAG,IAAI,CAAC;IAU1C,yEAAyE;IACnE,MAAM,CAAC,KAAK,EAAE,aAAa,EAAE,WAAW,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAevE,qCAAqC;IAC/B,SAAS,CAAC,KAAK,GAAE,MAAU,GAAG,OAAO,CAAC,aAAa,EAAE,CAAC;IAM5D,gEAAgE;IAC1D,oBAAoB,CAAC,UAAU,GAAE,MAAU,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;CA6B3E"}

package/dist/core/progress.js

@@ -0,0 +1,81 @@
+/**
+ * Progress tracker — structured JSON log of what each session accomplished.
+ *
+ * Inspired by Anthropic's claude-progress.txt but using JSON (models are
+ * less likely to corrupt JSON vs Markdown).
+ *
+ * The progress file lives in the agent workspace at `tako-progress.json`.
+ * Each session appends an entry at the end. The agent reads it at session
+ * start to understand what happened before.
+ */
+import { readFile, writeFile } from 'node:fs/promises';
+import { existsSync } from 'node:fs';
+import { join } from 'node:path';
+export class ProgressTracker {
+    filePath;
+    constructor(workspaceDir) {
+        this.filePath = join(workspaceDir, 'tako-progress.json');
+    }
+    /** Read the progress file. Returns null if it doesn't exist. */
+    async read() {
+        if (!existsSync(this.filePath))
+            return null;
+        try {
+            const raw = await readFile(this.filePath, 'utf-8');
+            return JSON.parse(raw);
+        }
+        catch {
+            return null;
+        }
+    }
+    /** Append a new progress entry. Creates the file if it doesn't exist. */
+    async append(entry, projectName) {
+        let file = await this.read();
+        if (!file) {
+            file = { version: 1, projectName: projectName ?? 'tako', entries: [] };
+        }
+        // Keep last 20 entries to prevent unbounded growth
+        if (file.entries.length >= 20) {
+            file.entries = file.entries.slice(-19);
+        }
+        file.entries.push(entry);
+        await writeFile(this.filePath, JSON.stringify(file, null, 2), 'utf-8');
+    }
+    /** Get the most recent N entries. */
+    async getRecent(count = 5) {
+        const file = await this.read();
+        if (!file)
+            return [];
+        return file.entries.slice(-count);
+    }
+    /** Get a summary string suitable for injecting into context. */
+    async getSummaryForContext(maxEntries = 3) {
+        const entries = await this.getRecent(maxEntries);
+        if (entries.length === 0)
+            return null;
+        const lines = ['## Recent Progress'];
+        for (const entry of entries) {
+            lines.push(`\n### Session ${entry.sessionId.slice(0, 8)} (${entry.timestamp})`);
+            if (entry.featuresWorkedOn.length > 0) {
+                lines.push(`**Worked on:** ${entry.featuresWorkedOn.join(', ')}`);
+            }
+            if (entry.filesChanged.length > 0) {
+                lines.push(`**Files changed:** ${entry.filesChanged.join(', ')}`);
+            }
+            if (entry.decisionsMade.length > 0) {
+                lines.push(`**Decisions:** ${entry.decisionsMade.join('; ')}`);
+            }
+            if (entry.blockers.length > 0) {
+                lines.push(`**Blockers:** ${entry.blockers.join('; ')}`);
+            }
+            if (entry.nextSteps.length > 0) {
+                lines.push(`**Next steps:** ${entry.nextSteps.join('; ')}`);
+            }
+            if (entry.commits.length > 0) {
+                lines.push(`**Commits:** ${entry.commits.join(', ')}`);
+            }
+        }
+        return lines.join('\n');
+    }
+}
+//# sourceMappingURL=progress.js.map

package/dist/core/progress.js.map

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

package/dist/core/prompt.d.ts

@@ -0,0 +1,105 @@
+/**
+ * Prompt builder — assembles the system prompt from workspace files.
+ *
+ * Follows the reference runtime/reference architecture prompt assembly pattern:
+ * 1. Core identity (SOUL.md, IDENTITY.md, AGENTS.md)
+ * 2. Tool/user context (TOOLS.md, USER.md)
+ * 3. Bootstrap (HEARTBEAT.md, BOOTSTRAP.md)
+ * 4. Curated memory (MEMORY.md — always injected)
+ * 5. Tool inventory (registered tools with schemas)
+ * 6. Skill listings (XML format)
+ * 7. Runtime context (host, OS, Node, model, shell, time)
+ * 8. Repo structure (if in a git repo)
+ *
+ * Daily logs (memory/YYYY-MM-DD.md) are NOT pre-injected.
+ * They are accessed on-demand via memory_search/memory_get tools.
+ * Sub-agents only get AGENTS.md + TOOLS.md to keep context small.
+ */
+import type { Tool } from '../tools/tool.js';
+import type { LoadedSkill } from '../skills/types.js';
+export interface PromptMode {
+    /** 'full' for main session, 'minimal' for sub-agents, 'none' to skip */
+    mode: 'full' | 'minimal' | 'none';
+}
+export interface PromptParts {
+    /** Workspace bootstrap file contents, keyed by filename */
+    files: Map<string, string>;
+    /** Curated memory content */
+    memory?: string;
+    /** Skill instruction blocks */
+    skills?: string[];
+    /** Tool inventory section */
+    toolInventory?: string;
+    /** Skill listings in XML format */
+    skillListings?: string;
+    /** Runtime context section */
+    runtime?: string;
+    /** Repo structure map */
+    repoMap?: string;
+    /** Safety guidelines section */
+    safety?: string;
+    /** Sandbox context info */
+    sandboxInfo?: string;
+}
+export declare class PromptBuilder {
+    private workspacePath;
+    private skillInstructions;
+    private registeredTools;
+    private loadedSkills;
+    private modelId;
+    private workingDir;
+    private sandboxMode;
+    private sandboxWorkspaceAccess;
+    private timezoneContext;
+    constructor(workspacePath: string);
+    /** Switch workspace (for agent switching). */
+    setWorkspace(workspacePath: string): void;
+    /** Get current workspace path. */
+    getWorkspace(): string;
+    /** Set timezone context string for injection into the runtime section. */
+    setTimezoneContext(context: string): void;
+    /** Set sandbox context for the safety section. */
+    setSandboxInfo(mode: string, workspaceAccess: string): void;
+    /** Register skill instructions to include in the prompt. */
+    addSkillInstructions(instructions: string): void;
+    /** Set the tool inventory for the tools section. */
+    setTools(tools: Tool[]): void;
+    /** Set loaded skills for the skills section. */
+    setSkills(skills: LoadedSkill[]): void;
+    /** Set the model ID for runtime context. */
+    setModel(modelId: string): void;
+    /** Set the working directory for runtime context. */
+    setWorkingDir(dir: string): void;
+    /**
+     * Load a workspace file. Returns content with truncation marker if too long.
+     * Returns a "[MISSING]" marker if the file doesn't exist.
+     */
+    private loadFile;
+    /** Build the full system prompt from workspace files. */
+    build(mode?: PromptMode): Promise<string>;
+    /**
+     * Build the tool inventory section.
+     * Lists all registered tools with name, description, and parameter schema.
+     */
+    private buildToolInventory;
+    /**
+     * Build skill listings in XML format (like reference runtime/reference architecture).
+     */
+    private buildSkillListings;
+    /** Build the safety guidelines section. */
+    private buildSafetySection;
+    /** Build runtime context section. */
+    private buildRuntimeContext;
+    /**
+     * Assemble parts into the final system prompt string.
+     * Non-empty sections are separated by markdown dividers.
+     */
+    private assemble;
+    /** Core behavioral rules — ensures the agent always responds properly. */
+    private buildBehavioralRules;
+    /** @deprecated — old verbose rules, replaced by compact version above */
+    private _oldBehavioralRules;
+    /** Push a file section if it exists in parts. */
+    private pushFileSection;
+}
+//# sourceMappingURL=prompt.d.ts.map

package/dist/core/prompt.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompt.d.ts","sourceRoot":"","sources":["../../src/core/prompt.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAMH,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,kBAAkB,CAAC;AAC7C,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAsBtD,MAAM,WAAW,UAAU;IACzB,wEAAwE;IACxE,IAAI,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,CAAC;CACnC;AAED,MAAM,WAAW,WAAW;IAC1B,2DAA2D;IAC3D,KAAK,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC3B,6BAA6B;IAC7B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,+BAA+B;IAC/B,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;IAClB,6BAA6B;IAC7B,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,mCAAmC;IACnC,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,8BAA8B;IAC9B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,yBAAyB;IACzB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,gCAAgC;IAChC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,2BAA2B;IAC3B,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,qBAAa,aAAa;IACxB,OAAO,CAAC,aAAa,CAAS;IAC9B,OAAO,CAAC,iBAAiB,CAAgB;IACzC,OAAO,CAAC,eAAe,CAAc;IACrC,OAAO,CAAC,YAAY,CAAqB;IACzC,OAAO,CAAC,OAAO,CAAqB;IACpC,OAAO,CAAC,UAAU,CAAyB;IAC3C,OAAO,CAAC,WAAW,CAAiB;IACpC,OAAO,CAAC,sBAAsB,CAAgB;IAC9C,OAAO,CAAC,eAAe,CAAuB;gBAElC,aAAa,EAAE,MAAM;IAIjC,8CAA8C;IAC9C,YAAY,CAAC,aAAa,EAAE,MAAM,GAAG,IAAI;IAIzC,kCAAkC;IAClC,YAAY,IAAI,MAAM;IAItB,0EAA0E;IAC1E,kBAAkB,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAIzC,kDAAkD;IAClD,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,eAAe,EAAE,MAAM,GAAG,IAAI;IAK3D,4DAA4D;IAC5D,oBAAoB,CAAC,YAAY,EAAE,MAAM,GAAG,IAAI;IAIhD,oDAAoD;IACpD,QAAQ,CAAC,KAAK,EAAE,IAAI,EAAE,GAAG,IAAI;IAI7B,gDAAgD;IAChD,SAAS,CAAC,MAAM,EAAE,WAAW,EAAE,GAAG,IAAI;IAItC,4CAA4C;IAC5C,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAI/B,qDAAqD;IACrD,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI;IAIhC;;;OAGG;YACW,QAAQ;IAmBtB,yDAAyD;IACnD,KAAK,CAAC,IAAI,GAAE,UAA6B,GAAG,OAAO,CAAC,MAAM,CAAC;IAsDjE;;;OAGG;IACH,OAAO,CAAC,kBAAkB;IAgC1B;;OAEG;IACH,OAAO,CAAC,kBAAkB;IA8B1B,2CAA2C;IAC3C,OAAO,CAAC,kBAAkB;IA2C1B,qCAAqC;IACrC,OAAO,CAAC,mBAAmB;IAkC3B;;;OAGG;IACH,OAAO,CAAC,QAAQ;IAmEhB,0EAA0E;IAC1E,OAAO,CAAC,oBAAoB;IAW5B,yEAAyE;IACzE,OAAO,CAAC,mBAAmB;IAuD3B,iDAAiD;IACjD,OAAO,CAAC,eAAe;CAIxB"}