@toolpack-sdk/agents 2.0.0-alpha.1 → 2.1.0

package/dist/index.d.cts

@@ -1,15 +1,17 @@
-import { A as AgentInput, a as AgentResult, b as IAgentRegistry, d as AgentOutput, e as AgentInstance, C as ChannelInterface, P as PendingAsk, B as BaseAgentOptions } from './types-BWoRx1ZE.cjs';
-export { c as AgentRunOptions, I as Interceptor, f as InterceptorChainConfig, g as InterceptorContext, h as InterceptorResult, N as NextFunction, S as SKIP_SENTINEL, W as WorkflowStep, i as isSkipSentinel, s as skip } from './types-BWoRx1ZE.cjs';
-import { B as BaseAgent } from './base-agent-CjrUlo6Y.cjs';
-export { A as AgentEvents } from './base-agent-CjrUlo6Y.cjs';
-import { ModeConfig, ConversationStore, AssemblerOptions, AssembledPrompt } from 'toolpack-sdk';
+import { A as AgentInput, a as AgentResult, c as IAgentRegistry, e as AgentOutput, f as AgentInstance, C as ChannelInterface, P as PendingAsk, B as BaseAgentOptions } from './types-TB6yypig.cjs';
+export { b as AgentDelegationConfig, d as AgentRunOptions, I as Interceptor, g as InterceptorChainConfig, h as InterceptorContext, i as InterceptorResult, N as NextFunction, S as SKIP_SENTINEL, W as WorkflowStep, j as isSkipSentinel, s as skip } from './types-TB6yypig.cjs';
+import { B as BaseAgent, A as AgentMindConfig } from './base-agent-DPdK4Pnl.cjs';
+export { a as AgentEvents, C as ConfidenceLevel, G as GoalPriority, b as GoalStatus, M as MindBelief, c as MindEntry, d as MindEntryType, e as MindGoal, f as MindRecallResult, g as MindReflection, h as MindTtlDefaults } from './base-agent-DPdK4Pnl.cjs';
+import { ModeConfig, ConversationStore, AssemblerOptions, AssembledPrompt, RequestToolDefinition, ToolProject } from 'toolpack-sdk';
 export { AssembledPrompt, AssemblerOptions, ConversationScope, ConversationStore, GetOptions, InMemoryConversationStore, InMemoryConversationStoreConfig, Participant, PromptMessage, ConversationSearchOptions as SearchOptions, StoredMessage } from 'toolpack-sdk';
-export { BaseChannel, DiscordChannel, DiscordChannelConfig, EmailChannel, EmailChannelConfig, SMSChannel, SMSChannelConfig, ScheduledChannel, ScheduledChannelConfig, SlackChannel, SlackChannelConfig, TelegramChannel, TelegramChannelConfig, WebhookChannel, WebhookChannelConfig } from './channels/index.cjs';
-export { I as IntentClassification, a as IntentClassifierAgent, b as IntentClassifierInput } from './intent-classifier-agent-BLXXcbNJ.cjs';
+import { S as SchedulerStore } from './index-Du6S0eG7.cjs';
+export { B as BaseChannel, C as CreateJobOptions, a as CreateJobResult, D as DiscordChannel, b as DiscordChannelConfig, E as EmailChannel, c as EmailChannelConfig, J as JobStatus, d as SMSChannel, e as SMSChannelConfig, f as ScheduledChannel, g as ScheduledChannelConfig, h as ScheduledJob, i as SlackChannel, j as SlackChannelConfig, T as TelegramChannel, k as TelegramChannelConfig, W as WebhookChannel, l as WebhookChannelConfig } from './index-Du6S0eG7.cjs';
+export { I as IntentClassification, a as IntentClassifierAgent, b as IntentClassifierInput } from './intent-classifier-agent-DxyfJWcm.cjs';
 import { SummarizerAgent } from './capabilities/index.cjs';
 export { HistoryTurn, SummarizerInput, SummarizerOutput } from './capabilities/index.cjs';
 export { AddressCheckConfig, AddressCheckResult, CaptureHistoryConfig, ComposedChain, DepthExceededError, DepthGuardConfig, EventDedupConfig, IntentClassifierInterceptorConfig, InvocationDepthExceededError, NoiseFilterConfig, ParticipantResolverConfig, RateLimitConfig, SelfFilterConfig, TracerConfig, composeChain, createAddressCheckInterceptor, createCaptureInterceptor, createDepthGuardInterceptor, createEventDedupInterceptor, createIntentClassifierInterceptor, createNoiseFilterInterceptor, createParticipantResolverInterceptor, createRateLimitInterceptor, createSelfFilterInterceptor, createTracerInterceptor, executeChain } from './interceptors/index.cjs';
 import 'events';
+import '@toolpack-sdk/knowledge';
 
 /**
  * Transport interface for agent-to-agent communication.
@@ -331,4 +333,65 @@ interface ConversationSearchTool {
  */
 declare function createConversationSearchTool(store: ConversationStore, conversationId: string, config?: ConversationSearchToolConfig): ConversationSearchTool;
 
-export { AgentError, AgentInput, AgentInstance, AgentJsonRpcServer, AgentOutput, AgentRegistry, type AgentRegistryTransportOptions, AgentResult, type AgentTransport, BaseAgent, BaseAgentOptions, BrowserAgent, ChannelInterface, CodingAgent, type ConversationSearchTool, type ConversationSearchToolConfig, DataAgent, IAgentRegistry, JsonRpcTransport, LocalTransport, PendingAsk, ResearchAgent, SummarizerAgent, assemblePrompt, createConversationSearchTool };
+interface RunContext {
+    /** The assembled header string to prepend to the system prompt (empty string if no content). */
+    mindHeader: string;
+    /** The 7 mind tool definitions to add to requestTools. */
+    tools: RequestToolDefinition[];
+    /** Call this at run completion. Pass isError=true on crash. */
+    flush: (isError: boolean) => Promise<void>;
+}
+/**
+ * AgentMind is the cognitive layer coordinator.
+ * One instance lives for the lifetime of the agent (lazily created in BaseAgent).
+ * A fresh DraftBuffer is created per run() call via createRunContext().
+ */
+declare class AgentMind {
+    private readonly store;
+    private readonly config;
+    private constructor();
+    /**
+     * Create and initialise an AgentMind instance.
+     * Lazily creates the PersistentKnowledgeProvider when no custom provider is given.
+     */
+    static create(agentName: string, options: AgentMindConfig): Promise<AgentMind>;
+    /**
+     * Called once at the start of each run() to:
+     * 1. Assemble the current header from committed store state.
+     * 2. Create a fresh per-run DraftBuffer.
+     * 3. Build the 7 mind tool definitions bound to that buffer.
+     * 4. Return a flush closure for the run's lifecycle hooks.
+     *
+     * Throws if the store read fails — callers must not proceed with an empty header
+     * because pinned safety rules may be missing.
+     */
+    createRunContext(): Promise<RunContext>;
+    close(): Promise<void>;
+}
+
+/**
+ * Creates a `ToolProject` that exposes four scheduler tools to the LLM.
+ *
+ * Register the returned project as `customTools` when initialising Toolpack so
+ * the agent can manage its own schedule autonomously.
+ *
+ * @example
+ * ```ts
+ * const store = new SchedulerStore({ dbPath: './scheduler.db' });
+ *
+ * const toolpack = await Toolpack.init({
+ *   provider: 'openai',
+ *   tools: true,
+ *   customTools: [createSchedulerTools(store)],
+ * });
+ * ```
+ *
+ * Tools exposed:
+ * - `scheduler.create`  — schedule a new recurring or one-shot invocation
+ * - `scheduler.list`    — list pending/all jobs
+ * - `scheduler.cancel`  — cancel a pending job
+ * - `scheduler.update`  — modify an existing pending job
+ */
+declare function createSchedulerTools(store: SchedulerStore): ToolProject;
+
+export { AgentError, AgentInput, AgentInstance, AgentJsonRpcServer, AgentMind, AgentMindConfig, AgentOutput, AgentRegistry, type AgentRegistryTransportOptions, AgentResult, type AgentTransport, BaseAgent, BaseAgentOptions, BrowserAgent, ChannelInterface, CodingAgent, type ConversationSearchTool, type ConversationSearchToolConfig, DataAgent, IAgentRegistry, JsonRpcTransport, LocalTransport, type RunContext as MindRunContext, PendingAsk, ResearchAgent, SchedulerStore, SummarizerAgent, assemblePrompt, createConversationSearchTool, createSchedulerTools };

package/dist/index.d.ts

@@ -1,15 +1,17 @@
-import { A as AgentInput, a as AgentResult, b as IAgentRegistry, d as AgentOutput, e as AgentInstance, C as ChannelInterface, P as PendingAsk, B as BaseAgentOptions } from './types-BWoRx1ZE.js';
-export { c as AgentRunOptions, I as Interceptor, f as InterceptorChainConfig, g as InterceptorContext, h as InterceptorResult, N as NextFunction, S as SKIP_SENTINEL, W as WorkflowStep, i as isSkipSentinel, s as skip } from './types-BWoRx1ZE.js';
-import { B as BaseAgent } from './base-agent-Cx2kWzLF.js';
-export { A as AgentEvents } from './base-agent-Cx2kWzLF.js';
-import { ModeConfig, ConversationStore, AssemblerOptions, AssembledPrompt } from 'toolpack-sdk';
+import { A as AgentInput, a as AgentResult, c as IAgentRegistry, e as AgentOutput, f as AgentInstance, C as ChannelInterface, P as PendingAsk, B as BaseAgentOptions } from './types-TB6yypig.js';
+export { b as AgentDelegationConfig, d as AgentRunOptions, I as Interceptor, g as InterceptorChainConfig, h as InterceptorContext, i as InterceptorResult, N as NextFunction, S as SKIP_SENTINEL, W as WorkflowStep, j as isSkipSentinel, s as skip } from './types-TB6yypig.js';
+import { B as BaseAgent, A as AgentMindConfig } from './base-agent-nU8pr4nu.js';
+export { a as AgentEvents, C as ConfidenceLevel, G as GoalPriority, b as GoalStatus, M as MindBelief, c as MindEntry, d as MindEntryType, e as MindGoal, f as MindRecallResult, g as MindReflection, h as MindTtlDefaults } from './base-agent-nU8pr4nu.js';
+import { ModeConfig, ConversationStore, AssemblerOptions, AssembledPrompt, RequestToolDefinition, ToolProject } from 'toolpack-sdk';
 export { AssembledPrompt, AssemblerOptions, ConversationScope, ConversationStore, GetOptions, InMemoryConversationStore, InMemoryConversationStoreConfig, Participant, PromptMessage, ConversationSearchOptions as SearchOptions, StoredMessage } from 'toolpack-sdk';
-export { BaseChannel, DiscordChannel, DiscordChannelConfig, EmailChannel, EmailChannelConfig, SMSChannel, SMSChannelConfig, ScheduledChannel, ScheduledChannelConfig, SlackChannel, SlackChannelConfig, TelegramChannel, TelegramChannelConfig, WebhookChannel, WebhookChannelConfig } from './channels/index.js';
-export { I as IntentClassification, a as IntentClassifierAgent, b as IntentClassifierInput } from './intent-classifier-agent-BLpDwKVf.js';
+import { S as SchedulerStore } from './index-o8Lbzv5N.js';
+export { B as BaseChannel, C as CreateJobOptions, a as CreateJobResult, D as DiscordChannel, b as DiscordChannelConfig, E as EmailChannel, c as EmailChannelConfig, J as JobStatus, d as SMSChannel, e as SMSChannelConfig, f as ScheduledChannel, g as ScheduledChannelConfig, h as ScheduledJob, i as SlackChannel, j as SlackChannelConfig, T as TelegramChannel, k as TelegramChannelConfig, W as WebhookChannel, l as WebhookChannelConfig } from './index-o8Lbzv5N.js';
+export { I as IntentClassification, a as IntentClassifierAgent, b as IntentClassifierInput } from './intent-classifier-agent-0JZDlhpk.js';
 import { SummarizerAgent } from './capabilities/index.js';
 export { HistoryTurn, SummarizerInput, SummarizerOutput } from './capabilities/index.js';
 export { AddressCheckConfig, AddressCheckResult, CaptureHistoryConfig, ComposedChain, DepthExceededError, DepthGuardConfig, EventDedupConfig, IntentClassifierInterceptorConfig, InvocationDepthExceededError, NoiseFilterConfig, ParticipantResolverConfig, RateLimitConfig, SelfFilterConfig, TracerConfig, composeChain, createAddressCheckInterceptor, createCaptureInterceptor, createDepthGuardInterceptor, createEventDedupInterceptor, createIntentClassifierInterceptor, createNoiseFilterInterceptor, createParticipantResolverInterceptor, createRateLimitInterceptor, createSelfFilterInterceptor, createTracerInterceptor, executeChain } from './interceptors/index.js';
 import 'events';
+import '@toolpack-sdk/knowledge';
 
 /**
  * Transport interface for agent-to-agent communication.
@@ -331,4 +333,65 @@ interface ConversationSearchTool {
  */
 declare function createConversationSearchTool(store: ConversationStore, conversationId: string, config?: ConversationSearchToolConfig): ConversationSearchTool;
 
-export { AgentError, AgentInput, AgentInstance, AgentJsonRpcServer, AgentOutput, AgentRegistry, type AgentRegistryTransportOptions, AgentResult, type AgentTransport, BaseAgent, BaseAgentOptions, BrowserAgent, ChannelInterface, CodingAgent, type ConversationSearchTool, type ConversationSearchToolConfig, DataAgent, IAgentRegistry, JsonRpcTransport, LocalTransport, PendingAsk, ResearchAgent, SummarizerAgent, assemblePrompt, createConversationSearchTool };
+interface RunContext {
+    /** The assembled header string to prepend to the system prompt (empty string if no content). */
+    mindHeader: string;
+    /** The 7 mind tool definitions to add to requestTools. */
+    tools: RequestToolDefinition[];
+    /** Call this at run completion. Pass isError=true on crash. */
+    flush: (isError: boolean) => Promise<void>;
+}
+/**
+ * AgentMind is the cognitive layer coordinator.
+ * One instance lives for the lifetime of the agent (lazily created in BaseAgent).
+ * A fresh DraftBuffer is created per run() call via createRunContext().
+ */
+declare class AgentMind {
+    private readonly store;
+    private readonly config;
+    private constructor();
+    /**
+     * Create and initialise an AgentMind instance.
+     * Lazily creates the PersistentKnowledgeProvider when no custom provider is given.
+     */
+    static create(agentName: string, options: AgentMindConfig): Promise<AgentMind>;
+    /**
+     * Called once at the start of each run() to:
+     * 1. Assemble the current header from committed store state.
+     * 2. Create a fresh per-run DraftBuffer.
+     * 3. Build the 7 mind tool definitions bound to that buffer.
+     * 4. Return a flush closure for the run's lifecycle hooks.
+     *
+     * Throws if the store read fails — callers must not proceed with an empty header
+     * because pinned safety rules may be missing.
+     */
+    createRunContext(): Promise<RunContext>;
+    close(): Promise<void>;
+}
+
+/**
+ * Creates a `ToolProject` that exposes four scheduler tools to the LLM.
+ *
+ * Register the returned project as `customTools` when initialising Toolpack so
+ * the agent can manage its own schedule autonomously.
+ *
+ * @example
+ * ```ts
+ * const store = new SchedulerStore({ dbPath: './scheduler.db' });
+ *
+ * const toolpack = await Toolpack.init({
+ *   provider: 'openai',
+ *   tools: true,
+ *   customTools: [createSchedulerTools(store)],
+ * });
+ * ```
+ *
+ * Tools exposed:
+ * - `scheduler.create`  — schedule a new recurring or one-shot invocation
+ * - `scheduler.list`    — list pending/all jobs
+ * - `scheduler.cancel`  — cancel a pending job
+ * - `scheduler.update`  — modify an existing pending job
+ */
+declare function createSchedulerTools(store: SchedulerStore): ToolProject;
+
+export { AgentError, AgentInput, AgentInstance, AgentJsonRpcServer, AgentMind, AgentMindConfig, AgentOutput, AgentRegistry, type AgentRegistryTransportOptions, AgentResult, type AgentTransport, BaseAgent, BaseAgentOptions, BrowserAgent, ChannelInterface, CodingAgent, type ConversationSearchTool, type ConversationSearchToolConfig, DataAgent, IAgentRegistry, JsonRpcTransport, LocalTransport, type RunContext as MindRunContext, PendingAsk, ResearchAgent, SchedulerStore, SummarizerAgent, assemblePrompt, createConversationSearchTool, createSchedulerTools };