paean 0.10.3 → 0.10.5

package/dist/index.d.ts

@@ -13,5 +13,5 @@ export { getMcpTools, executeMcpTool } from './mcp/tools.js';
 export { McpClient } from './mcp/client.js';
 export { AgentService, agentService, startChat, sendMessage, renderMarkdown, type AgentStreamEvent, type AgentStreamCallbacks, type McpState, type McpToolResult, } from './agent/index.js';
 export { getSystemTools, executeSystemTool, isCommandWhitelisted, getCommandWhitelist, } from './mcp/system.js';
-export { getCronToolDefinitions, executeCronTool, CRON_TOOL_NAMES, getActiveCronCount, clearAllCronJobs, onCronPrompt, setAgentBusyChecker, type CronJob, type CronPromptEvent, } from './mcp/cron.js';
+export { getLoopToolDefinitions, executeLoopTool, LOOP_TOOL_NAMES, getActiveLoopCount, clearAllLoopJobs, onLoopPrompt, setAgentBusyChecker, type LoopJob, type LoopPromptEvent, getCronToolDefinitions, executeCronTool, CRON_TOOL_NAMES, getActiveCronCount, clearAllCronJobs, onCronPrompt, type CronJob, type CronPromptEvent, } from './mcp/loop.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,EAAE,eAAe,EAAE,YAAY,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AAGpF,OAAO,EACL,OAAO,EACP,YAAY,EACZ,cAAc,EACd,aAAa,EACb,MAAM,EACN,KAAK,aAAa,EAClB,KAAK,QAAQ,GACd,MAAM,eAAe,CAAC;AAGvB,OAAO,EACL,WAAW,EACX,WAAW,EACX,cAAc,EACd,cAAc,EACd,gBAAgB,EAChB,cAAc,EACd,cAAc,EACd,iBAAiB,EACjB,mBAAmB,EACnB,mBAAmB,EACnB,kBAAkB,EAClB,qBAAqB,EACrB,YAAY,EACZ,KAAK,QAAQ,EACb,KAAK,gBAAgB,EACrB,KAAK,aAAa,EAClB,KAAK,eAAe,GACrB,MAAM,eAAe,CAAC;AAGvB,OAAO,EACL,SAAS,EACT,cAAc,EACd,cAAc,EACd,SAAS,EACT,eAAe,EACf,QAAQ,EACR,SAAS,EACT,SAAS,EACT,SAAS,EACT,SAAS,EACT,aAAa,EACb,KAAK,WAAW,GACjB,MAAM,mBAAmB,CAAC;AAG3B,OAAO,EACL,aAAa,EACb,YAAY,EACZ,WAAW,EACX,KAAK,cAAc,GACpB,MAAM,oBAAoB,CAAC;AAG5B,OAAO,EAAE,cAAc,EAAE,KAAK,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AACxE,OAAO,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AACtE,OAAO,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAG7D,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAG5C,OAAO,EACL,YAAY,EACZ,YAAY,EACZ,SAAS,EACT,WAAW,EACX,cAAc,EACd,KAAK,gBAAgB,EACrB,KAAK,oBAAoB,EACzB,KAAK,QAAQ,EACb,KAAK,aAAa,GACnB,MAAM,kBAAkB,CAAC;AAG1B,OAAO,EACL,cAAc,EACd,iBAAiB,EACjB,oBAAoB,EACpB,mBAAmB,GACpB,MAAM,iBAAiB,CAAC;AAGzB,OAAO,EACL,sBAAsB,EACtB,eAAe,EACf,eAAe,EACf,kBAAkB,EAClB,gBAAgB,EAChB,YAAY,EACZ,mBAAmB,EACnB,KAAK,OAAO,EACZ,KAAK,eAAe,GACrB,MAAM,eAAe,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,EAAE,eAAe,EAAE,YAAY,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AAGpF,OAAO,EACL,OAAO,EACP,YAAY,EACZ,cAAc,EACd,aAAa,EACb,MAAM,EACN,KAAK,aAAa,EAClB,KAAK,QAAQ,GACd,MAAM,eAAe,CAAC;AAGvB,OAAO,EACL,WAAW,EACX,WAAW,EACX,cAAc,EACd,cAAc,EACd,gBAAgB,EAChB,cAAc,EACd,cAAc,EACd,iBAAiB,EACjB,mBAAmB,EACnB,mBAAmB,EACnB,kBAAkB,EAClB,qBAAqB,EACrB,YAAY,EACZ,KAAK,QAAQ,EACb,KAAK,gBAAgB,EACrB,KAAK,aAAa,EAClB,KAAK,eAAe,GACrB,MAAM,eAAe,CAAC;AAGvB,OAAO,EACL,SAAS,EACT,cAAc,EACd,cAAc,EACd,SAAS,EACT,eAAe,EACf,QAAQ,EACR,SAAS,EACT,SAAS,EACT,SAAS,EACT,SAAS,EACT,aAAa,EACb,KAAK,WAAW,GACjB,MAAM,mBAAmB,CAAC;AAG3B,OAAO,EACL,aAAa,EACb,YAAY,EACZ,WAAW,EACX,KAAK,cAAc,GACpB,MAAM,oBAAoB,CAAC;AAG5B,OAAO,EAAE,cAAc,EAAE,KAAK,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AACxE,OAAO,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AACtE,OAAO,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAG7D,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAG5C,OAAO,EACL,YAAY,EACZ,YAAY,EACZ,SAAS,EACT,WAAW,EACX,cAAc,EACd,KAAK,gBAAgB,EACrB,KAAK,oBAAoB,EACzB,KAAK,QAAQ,EACb,KAAK,aAAa,GACnB,MAAM,kBAAkB,CAAC;AAG1B,OAAO,EACL,cAAc,EACd,iBAAiB,EACjB,oBAAoB,EACpB,mBAAmB,GACpB,MAAM,iBAAiB,CAAC;AAGzB,OAAO,EACL,sBAAsB,EACtB,eAAe,EACf,eAAe,EACf,kBAAkB,EAClB,gBAAgB,EAChB,YAAY,EACZ,mBAAmB,EACnB,KAAK,OAAO,EACZ,KAAK,eAAe,EAEpB,sBAAsB,EACtB,eAAe,EACf,eAAe,EACf,kBAAkB,EAClB,gBAAgB,EAChB,YAAY,EACZ,KAAK,OAAO,EACZ,KAAK,eAAe,GACrB,MAAM,eAAe,CAAC"}

package/dist/index.js

@@ -22,6 +22,8 @@ export { McpClient } from './mcp/client.js';
 export { AgentService, agentService, startChat, sendMessage, renderMarkdown, } from './agent/index.js';
 // System/Shell Tools
 export { getSystemTools, executeSystemTool, isCommandWhitelisted, getCommandWhitelist, } from './mcp/system.js';
-// Cron/Scheduler Tools (session-scoped, prompt-injection based)
-export { getCronToolDefinitions, executeCronTool, CRON_TOOL_NAMES, getActiveCronCount, clearAllCronJobs, onCronPrompt, setAgentBusyChecker, } from './mcp/cron.js';
+// Loop Tools (session-scoped, prompt-injection based recurring tasks)
+export { getLoopToolDefinitions, executeLoopTool, LOOP_TOOL_NAMES, getActiveLoopCount, clearAllLoopJobs, onLoopPrompt, setAgentBusyChecker, 
+// Legacy aliases
+getCronToolDefinitions, executeCronTool, CRON_TOOL_NAMES, getActiveCronCount, clearAllCronJobs, onCronPrompt, } from './mcp/loop.js';
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,aAAa;AACb,OAAO,EAAE,eAAe,EAAE,YAAY,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AAEpF,iBAAiB;AACjB,OAAO,EACL,OAAO,EACP,YAAY,EACZ,cAAc,EACd,aAAa,EACb,MAAM,GAGP,MAAM,eAAe,CAAC;AAEvB,WAAW;AACX,OAAO,EACL,WAAW,EACX,WAAW,EACX,cAAc,EACd,cAAc,EACd,gBAAgB,EAChB,cAAc,EACd,cAAc,EACd,iBAAiB,EACjB,mBAAmB,EACnB,mBAAmB,EACnB,kBAAkB,EAClB,qBAAqB,EACrB,YAAY,GAKb,MAAM,eAAe,CAAC;AAEvB,gBAAgB;AAChB,OAAO,EACL,SAAS,EACT,cAAc,EACd,cAAc,EACd,SAAS,EACT,eAAe,EACf,QAAQ,EACR,SAAS,EACT,SAAS,EACT,SAAS,EACT,SAAS,EACT,aAAa,GAEd,MAAM,mBAAmB,CAAC;AAE3B,oBAAoB;AACpB,OAAO,EACL,aAAa,EACb,YAAY,EACZ,WAAW,GAEZ,MAAM,oBAAoB,CAAC;AAE5B,aAAa;AACb,OAAO,EAAE,cAAc,EAAyB,MAAM,iBAAiB,CAAC;AACxE,OAAO,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AACtE,OAAO,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAE7D,gDAAgD;AAChD,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAE5C,aAAa;AACb,OAAO,EACL,YAAY,EACZ,YAAY,EACZ,SAAS,EACT,WAAW,EACX,cAAc,GAKf,MAAM,kBAAkB,CAAC;AAE1B,qBAAqB;AACrB,OAAO,EACL,cAAc,EACd,iBAAiB,EACjB,oBAAoB,EACpB,mBAAmB,GACpB,MAAM,iBAAiB,CAAC;AAEzB,gEAAgE;AAChE,OAAO,EACL,sBAAsB,EACtB,eAAe,EACf,eAAe,EACf,kBAAkB,EAClB,gBAAgB,EAChB,YAAY,EACZ,mBAAmB,GAGpB,MAAM,eAAe,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,aAAa;AACb,OAAO,EAAE,eAAe,EAAE,YAAY,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AAEpF,iBAAiB;AACjB,OAAO,EACL,OAAO,EACP,YAAY,EACZ,cAAc,EACd,aAAa,EACb,MAAM,GAGP,MAAM,eAAe,CAAC;AAEvB,WAAW;AACX,OAAO,EACL,WAAW,EACX,WAAW,EACX,cAAc,EACd,cAAc,EACd,gBAAgB,EAChB,cAAc,EACd,cAAc,EACd,iBAAiB,EACjB,mBAAmB,EACnB,mBAAmB,EACnB,kBAAkB,EAClB,qBAAqB,EACrB,YAAY,GAKb,MAAM,eAAe,CAAC;AAEvB,gBAAgB;AAChB,OAAO,EACL,SAAS,EACT,cAAc,EACd,cAAc,EACd,SAAS,EACT,eAAe,EACf,QAAQ,EACR,SAAS,EACT,SAAS,EACT,SAAS,EACT,SAAS,EACT,aAAa,GAEd,MAAM,mBAAmB,CAAC;AAE3B,oBAAoB;AACpB,OAAO,EACL,aAAa,EACb,YAAY,EACZ,WAAW,GAEZ,MAAM,oBAAoB,CAAC;AAE5B,aAAa;AACb,OAAO,EAAE,cAAc,EAAyB,MAAM,iBAAiB,CAAC;AACxE,OAAO,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AACtE,OAAO,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAE7D,gDAAgD;AAChD,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAE5C,aAAa;AACb,OAAO,EACL,YAAY,EACZ,YAAY,EACZ,SAAS,EACT,WAAW,EACX,cAAc,GAKf,MAAM,kBAAkB,CAAC;AAE1B,qBAAqB;AACrB,OAAO,EACL,cAAc,EACd,iBAAiB,EACjB,oBAAoB,EACpB,mBAAmB,GACpB,MAAM,iBAAiB,CAAC;AAEzB,sEAAsE;AACtE,OAAO,EACL,sBAAsB,EACtB,eAAe,EACf,eAAe,EACf,kBAAkB,EAClB,gBAAgB,EAChB,YAAY,EACZ,mBAAmB;AAGnB,iBAAiB;AACjB,sBAAsB,EACtB,eAAe,EACf,eAAe,EACf,kBAAkB,EAClB,gBAAgB,EAChB,YAAY,GAGb,MAAM,eAAe,CAAC"}

package/dist/mcp/context-tools.d.ts

@@ -0,0 +1,32 @@
+/**
+ * Context Management MCP Tools
+ *
+ * Provides tools that let the agent programmatically manage its own
+ * conversation context — clearing or compacting it. This is essential for
+ * loop/scheduled tasks that need a clean context between iterations.
+ *
+ * Uses an EventEmitter pattern (same as loop.ts) so the tool execution
+ * can signal the React hook (useAgentStream) to reset conversationId.
+ */
+import { type Tool } from '@modelcontextprotocol/sdk/types.js';
+export interface ContextActionEvent {
+    action: 'clear' | 'compact';
+    /** Agent-provided summary of what was accomplished (used by compact) */
+    summary?: string;
+    /** Reason the agent is performing this action */
+    reason?: string;
+}
+/**
+ * Register a callback that fires when the agent requests a context action.
+ * Returns an unsubscribe function.
+ */
+export declare function onContextAction(callback: (event: ContextActionEvent) => void): () => void;
+/**
+ * Consume the pending compact summary (if any). Returns the summary string
+ * and clears it so it's only used once.
+ */
+export declare function consumeCompactSummary(): string | null;
+export declare function getContextToolDefinitions(): Tool[];
+export declare const CONTEXT_TOOL_NAMES: Set<string>;
+export declare function executeContextTool(toolName: string, args: Record<string, unknown>): Promise<unknown>;
+//# sourceMappingURL=context-tools.d.ts.map

package/dist/mcp/context-tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context-tools.d.ts","sourceRoot":"","sources":["../../src/mcp/context-tools.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,KAAK,IAAI,EAAE,MAAM,oCAAoC,CAAC;AAO/D,MAAM,WAAW,kBAAkB;IACjC,MAAM,EAAE,OAAO,GAAG,SAAS,CAAC;IAC5B,wEAAwE;IACxE,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,iDAAiD;IACjD,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAQD;;;GAGG;AACH,wBAAgB,eAAe,CAC7B,QAAQ,EAAE,CAAC,KAAK,EAAE,kBAAkB,KAAK,IAAI,GAC5C,MAAM,IAAI,CAKZ;AAQD;;;GAGG;AACH,wBAAgB,qBAAqB,IAAI,MAAM,GAAG,IAAI,CAIrD;AAMD,wBAAgB,yBAAyB,IAAI,IAAI,EAAE,CAiDlD;AAED,eAAO,MAAM,kBAAkB,aAG7B,CAAC;AAMH,wBAAsB,kBAAkB,CACtC,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC5B,OAAO,CAAC,OAAO,CAAC,CAmDlB"}

package/dist/mcp/context-tools.js

@@ -0,0 +1,136 @@
+/**
+ * Context Management MCP Tools
+ *
+ * Provides tools that let the agent programmatically manage its own
+ * conversation context — clearing or compacting it. This is essential for
+ * loop/scheduled tasks that need a clean context between iterations.
+ *
+ * Uses an EventEmitter pattern (same as loop.ts) so the tool execution
+ * can signal the React hook (useAgentStream) to reset conversationId.
+ */
+import { EventEmitter } from 'events';
+// ============================================
+// Event Bus
+// ============================================
+const contextEmitter = new EventEmitter();
+/**
+ * Register a callback that fires when the agent requests a context action.
+ * Returns an unsubscribe function.
+ */
+export function onContextAction(callback) {
+    contextEmitter.on('context-action', callback);
+    return () => {
+        contextEmitter.off('context-action', callback);
+    };
+}
+// ============================================
+// Stored compact summary (carry-forward)
+// ============================================
+let pendingCompactSummary = null;
+/**
+ * Consume the pending compact summary (if any). Returns the summary string
+ * and clears it so it's only used once.
+ */
+export function consumeCompactSummary() {
+    const summary = pendingCompactSummary;
+    pendingCompactSummary = null;
+    return summary;
+}
+// ============================================
+// MCP Tool Definitions
+// ============================================
+export function getContextToolDefinitions() {
+    return [
+        {
+            name: 'paean_context_clear',
+            description: 'Clear the current conversation context entirely. ' +
+                'The next message will start a brand-new conversation with no history. ' +
+                'Use this after completing a loop task iteration to ensure clean context ' +
+                'for the next run, or when the conversation has become too large/noisy. ' +
+                'This is equivalent to the user typing /clear.',
+            inputSchema: {
+                type: 'object',
+                properties: {
+                    reason: {
+                        type: 'string',
+                        description: 'Brief reason for clearing context (e.g. "loop iteration complete", "context too large")',
+                    },
+                },
+            },
+        },
+        {
+            name: 'paean_context_compact',
+            description: 'Compact the current conversation by summarizing it. ' +
+                'Provide a concise summary of key facts, decisions, and outcomes from the conversation so far. ' +
+                'The current conversation will be replaced with a fresh one that starts with your summary as context. ' +
+                'Use this instead of paean_context_clear when you need to preserve important context ' +
+                'while reducing token usage. Good for long-running sessions or between loop iterations ' +
+                'where some state must carry forward.',
+            inputSchema: {
+                type: 'object',
+                properties: {
+                    summary: {
+                        type: 'string',
+                        description: 'Concise summary of the conversation so far — key facts, decisions, outcomes, ' +
+                            'and any state that should carry forward into the next conversation turn.',
+                    },
+                    reason: {
+                        type: 'string',
+                        description: 'Brief reason for compacting (e.g. "preserve state between loop iterations")',
+                    },
+                },
+                required: ['summary'],
+            },
+        },
+    ];
+}
+export const CONTEXT_TOOL_NAMES = new Set([
+    'paean_context_clear',
+    'paean_context_compact',
+]);
+// ============================================
+// MCP Tool Execution
+// ============================================
+export async function executeContextTool(toolName, args) {
+    switch (toolName) {
+        case 'paean_context_clear': {
+            const reason = args.reason || 'Agent requested context clear';
+            contextEmitter.emit('context-action', {
+                action: 'clear',
+                reason,
+            });
+            return {
+                success: true,
+                message: 'Context will be cleared after this turn completes. ' +
+                    'The next message will start a fresh conversation.',
+                reason,
+            };
+        }
+        case 'paean_context_compact': {
+            const summary = args.summary;
+            const reason = args.reason || 'Agent requested context compaction';
+            if (!summary) {
+                return {
+                    success: false,
+                    error: 'summary is required for context compaction',
+                };
+            }
+            pendingCompactSummary = summary;
+            contextEmitter.emit('context-action', {
+                action: 'compact',
+                summary,
+                reason,
+            });
+            return {
+                success: true,
+                message: 'Context will be compacted after this turn completes. ' +
+                    'The next conversation will start with your summary as initial context.',
+                summaryLength: summary.length,
+                reason,
+            };
+        }
+        default:
+            return { success: false, error: `Unknown context tool: ${toolName}` };
+    }
+}
+//# sourceMappingURL=context-tools.js.map

package/dist/mcp/context-tools.js.map

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

package/dist/mcp/{cron.d.ts → loop.d.ts}

@@ -1,8 +1,8 @@
 /**
- * Session-Scoped Cron Scheduler
+ * Session-Scoped Loop Scheduler
  *
  * Pushes natural-language prompts into the main agent interaction on a
- * schedule, as if the user had typed them.  This gives cron jobs full
+ * schedule, as if the user had typed them.  This gives loop jobs full
  * agent capabilities (tool use, reasoning, multi-step tasks) instead of
  * being limited to simple shell commands.
  *
@@ -19,7 +19,7 @@
  * - Cron expressions (minute hour day month weekday)
  */
 import { type Tool } from '@modelcontextprotocol/sdk/types.js';
-export interface CronJob {
+export interface LoopJob {
     id: string;
     schedule: string;
     /** Natural-language prompt injected into the agent conversation */
@@ -36,32 +36,48 @@ export interface CronJob {
     } | null;
     status: 'active' | 'paused';
 }
-export interface CronPromptEvent {
+export interface LoopPromptEvent {
     jobId: string;
     prompt: string;
     cwd?: string;
     schedule: string;
 }
 /**
- * Register a callback that fires whenever a cron job wants to inject a
+ * Register a callback that fires whenever a loop job wants to inject a
  * prompt into the main agent conversation.
  * Returns an unsubscribe function.
  */
-export declare function onCronPrompt(callback: (event: CronPromptEvent) => void): () => void;
+export declare function onLoopPrompt(callback: (event: LoopPromptEvent) => void): () => void;
 /**
  * Register a function that the scheduler calls before injecting a prompt.
  * If it returns `true`, the prompt is skipped for that tick.
  */
 export declare function setAgentBusyChecker(checker: () => boolean): void;
-export declare function getCronToolDefinitions(): Tool[];
-export declare const CRON_TOOL_NAMES: Set<string>;
-export declare function executeCronTool(toolName: string, args: Record<string, unknown>): Promise<unknown>;
+export declare function getLoopToolDefinitions(): Tool[];
+export declare const LOOP_TOOL_NAMES: Set<string>;
+export declare function executeLoopTool(toolName: string, args: Record<string, unknown>): Promise<unknown>;
 /**
- * Get all active cron jobs count (for status display)
+ * Get all active loop jobs count (for status display)
  */
-export declare function getActiveCronCount(): number;
+export declare function getActiveLoopCount(): number;
 /**
- * Remove all cron jobs (for testing or session cleanup)
+ * Remove all loop jobs (for testing or session cleanup)
  */
-export declare function clearAllCronJobs(): void;
-//# sourceMappingURL=cron.d.ts.map
+export declare function clearAllLoopJobs(): void;
+/** @deprecated Use LoopJob instead */
+export type CronJob = LoopJob;
+/** @deprecated Use LoopPromptEvent instead */
+export type CronPromptEvent = LoopPromptEvent;
+/** @deprecated Use getLoopToolDefinitions instead */
+export declare const getCronToolDefinitions: typeof getLoopToolDefinitions;
+/** @deprecated Use executeLoopTool instead */
+export declare const executeCronTool: typeof executeLoopTool;
+/** @deprecated Use LOOP_TOOL_NAMES instead */
+export declare const CRON_TOOL_NAMES: Set<string>;
+/** @deprecated Use onLoopPrompt instead */
+export declare const onCronPrompt: typeof onLoopPrompt;
+/** @deprecated Use getActiveLoopCount instead */
+export declare const getActiveCronCount: typeof getActiveLoopCount;
+/** @deprecated Use clearAllLoopJobs instead */
+export declare const clearAllCronJobs: typeof clearAllLoopJobs;
+//# sourceMappingURL=loop.d.ts.map

package/dist/mcp/{cron.d.ts.map → loop.d.ts.map}

@@ -1 +1 @@
-{"version":3,"file":"cron.d.ts","sourceRoot":"","sources":["../../src/mcp/cron.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,OAAO,EAAE,KAAK,IAAI,EAAE,MAAM,oCAAoC,CAAC;AAQ/D,MAAM,WAAW,OAAO;IACtB,EAAE,EAAE,MAAM,CAAC;IACX,QAAQ,EAAE,MAAM,CAAC;IACjB,mEAAmE;IACnE,MAAM,EAAE,MAAM,CAAC;IACf,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE;QAAE,OAAO,EAAE,OAAO,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC;IACzD,MAAM,EAAE,QAAQ,GAAG,QAAQ,CAAC;CAC7B;AAoBD,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;CAClB;AAID;;;;GAIG;AACH,wBAAgB,YAAY,CAC1B,QAAQ,EAAE,CAAC,KAAK,EAAE,eAAe,KAAK,IAAI,GACzC,MAAM,IAAI,CAKZ;AAQD;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,MAAM,OAAO,GAAG,IAAI,CAEhE;AAiPD,wBAAgB,sBAAsB,IAAI,IAAI,EAAE,CA8G/C;AAED,eAAO,MAAM,eAAe,aAO1B,CAAC;AAMH,wBAAsB,eAAe,CACnC,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC5B,OAAO,CAAC,OAAO,CAAC,CAmKlB;AAED;;GAEG;AACH,wBAAgB,kBAAkB,IAAI,MAAM,CAE3C;AAED;;GAEG;AACH,wBAAgB,gBAAgB,IAAI,IAAI,CAKvC"}
+{"version":3,"file":"loop.d.ts","sourceRoot":"","sources":["../../src/mcp/loop.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,OAAO,EAAE,KAAK,IAAI,EAAE,MAAM,oCAAoC,CAAC;AAQ/D,MAAM,WAAW,OAAO;IACtB,EAAE,EAAE,MAAM,CAAC;IACX,QAAQ,EAAE,MAAM,CAAC;IACjB,mEAAmE;IACnE,MAAM,EAAE,MAAM,CAAC;IACf,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE;QAAE,OAAO,EAAE,OAAO,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC;IACzD,MAAM,EAAE,QAAQ,GAAG,QAAQ,CAAC;CAC7B;AAoBD,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;CAClB;AAID;;;;GAIG;AACH,wBAAgB,YAAY,CAC1B,QAAQ,EAAE,CAAC,KAAK,EAAE,eAAe,KAAK,IAAI,GACzC,MAAM,IAAI,CAKZ;AAQD;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,MAAM,OAAO,GAAG,IAAI,CAEhE;AAiPD,wBAAgB,sBAAsB,IAAI,IAAI,EAAE,CA8G/C;AAED,eAAO,MAAM,eAAe,aAO1B,CAAC;AAMH,wBAAsB,eAAe,CACnC,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC5B,OAAO,CAAC,OAAO,CAAC,CAmKlB;AAED;;GAEG;AACH,wBAAgB,kBAAkB,IAAI,MAAM,CAE3C;AAED;;GAEG;AACH,wBAAgB,gBAAgB,IAAI,IAAI,CAKvC;AAGD,sCAAsC;AACtC,MAAM,MAAM,OAAO,GAAG,OAAO,CAAC;AAC9B,8CAA8C;AAC9C,MAAM,MAAM,eAAe,GAAG,eAAe,CAAC;AAC9C,qDAAqD;AACrD,eAAO,MAAM,sBAAsB,+BAAyB,CAAC;AAC7D,8CAA8C;AAC9C,eAAO,MAAM,eAAe,wBAAkB,CAAC;AAC/C,8CAA8C;AAC9C,eAAO,MAAM,eAAe,aAAkB,CAAC;AAC/C,2CAA2C;AAC3C,eAAO,MAAM,YAAY,qBAAe,CAAC;AACzC,iDAAiD;AACjD,eAAO,MAAM,kBAAkB,2BAAqB,CAAC;AACrD,+CAA+C;AAC/C,eAAO,MAAM,gBAAgB,yBAAmB,CAAC"}