@ariaflowagents/core 0.7.1 → 0.9.0

package/dist/foundation/DefaultAgentStateController.js

@@ -0,0 +1,49 @@
+/**
+ * Default agent state controller extracted from Runtime.
+ *
+ * Handles:
+ * - Active agent resolution with fallback
+ * - Handoff recording in session.handoffHistory + session.metadata.handoffHistory
+ * - Per-agent state updates in session.agentStates
+ * - Circular handoff detection
+ */
+export class DefaultAgentStateController {
+    getActiveAgent(session, fallbackAgentId) {
+        return session.activeAgentId ?? session.currentAgent ?? fallbackAgentId;
+    }
+    setActiveAgent(session, agentId) {
+        session.activeAgentId = agentId;
+        session.currentAgent = agentId;
+    }
+    recordHandoff(args) {
+        const record = {
+            from: args.fromAgentId,
+            to: args.toAgentId,
+            reason: args.reason,
+            timestamp: new Date(),
+        };
+        args.session.handoffHistory.push(record);
+        if (args.session.metadata) {
+            args.session.metadata.handoffHistory.push(record);
+        }
+    }
+    updateAgentState(session, agentId, state) {
+        const existing = session.agentStates[agentId];
+        if (existing) {
+            existing.state = { ...existing.state, ...state };
+            existing.lastActive = new Date();
+        }
+        else {
+            session.agentStates[agentId] = {
+                agentId,
+                state,
+                lastActive: new Date(),
+            };
+        }
+    }
+    isCircularHandoff(handoffStack, agentId, maxVisits = 2) {
+        const priorVisits = handoffStack.filter(id => id === agentId).length;
+        return priorVisits >= maxVisits;
+    }
+}
+//# sourceMappingURL=DefaultAgentStateController.js.map

package/dist/foundation/DefaultAgentStateController.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"DefaultAgentStateController.js","sourceRoot":"","sources":["../../src/foundation/DefaultAgentStateController.ts"],"names":[],"mappings":"AAGA;;;;;;;;GAQG;AACH,MAAM,OAAO,2BAA2B;IACtC,cAAc,CAAC,OAAgB,EAAE,eAAuB;QACtD,OAAO,OAAO,CAAC,aAAa,IAAI,OAAO,CAAC,YAAY,IAAI,eAAe,CAAC;IAC1E,CAAC;IAED,cAAc,CAAC,OAAgB,EAAE,OAAe;QAC9C,OAAO,CAAC,aAAa,GAAG,OAAO,CAAC;QAChC,OAAO,CAAC,YAAY,GAAG,OAAO,CAAC;IACjC,CAAC;IAED,aAAa,CAAC,IAKb;QACC,MAAM,MAAM,GAAkB;YAC5B,IAAI,EAAE,IAAI,CAAC,WAAW;YACtB,EAAE,EAAE,IAAI,CAAC,SAAS;YAClB,MAAM,EAAE,IAAI,CAAC,MAAM;YACnB,SAAS,EAAE,IAAI,IAAI,EAAE;SACtB,CAAC;QAEF,IAAI,CAAC,OAAO,CAAC,cAAc,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QAEzC,IAAI,IAAI,CAAC,OAAO,CAAC,QAAQ,EAAE,CAAC;YAC1B,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QACpD,CAAC;IACH,CAAC;IAED,gBAAgB,CAAC,OAAgB,EAAE,OAAe,EAAE,KAA8B;QAChF,MAAM,QAAQ,GAAG,OAAO,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC;QAC9C,IAAI,QAAQ,EAAE,CAAC;YACb,QAAQ,CAAC,KAAK,GAAG,EAAE,GAAG,QAAQ,CAAC,KAAK,EAAE,GAAG,KAAK,EAAE,CAAC;YACjD,QAAQ,CAAC,UAAU,GAAG,IAAI,IAAI,EAAE,CAAC;QACnC,CAAC;aAAM,CAAC;YACN,OAAO,CAAC,WAAW,CAAC,OAAO,CAAC,GAAG;gBAC7B,OAAO;gBACP,KAAK;gBACL,UAAU,EAAE,IAAI,IAAI,EAAE;aACvB,CAAC;QACJ,CAAC;IACH,CAAC;IAED,iBAAiB,CAAC,YAAsB,EAAE,OAAe,EAAE,YAAoB,CAAC;QAC9E,MAAM,WAAW,GAAG,YAAY,CAAC,MAAM,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,KAAK,OAAO,CAAC,CAAC,MAAM,CAAC;QACrE,OAAO,WAAW,IAAI,SAAS,CAAC;IAClC,CAAC;CACF"}

package/dist/foundation/DefaultConversationEventLog.d.ts

@@ -0,0 +1,28 @@
+import type { HarnessStreamPart, RunContext, Session } from '../types/index.js';
+import type { SessionStore } from '../session/SessionStore.js';
+import type { ConversationEventLog } from './ConversationEventLog.js';
+export interface DefaultConversationEventLogConfig {
+    sessionStore: SessionStore;
+}
+/**
+ * Default conversation event log extracted from SessionEventManager + Runtime checkpoint logic.
+ *
+ * Handles:
+ * - Recording stream parts into session working memory
+ * - Text-delta accumulation and flush on terminal events
+ * - Value truncation at depth 5 for safe serialization
+ * - Checkpoint determination and persistence
+ */
+export declare class DefaultConversationEventLog implements ConversationEventLog {
+    private sessionStore;
+    constructor(config: DefaultConversationEventLogConfig);
+    record(context: RunContext, part: HarnessStreamPart): void;
+    checkpoint(session: Session): Promise<void>;
+    shouldCheckpoint(part: HarnessStreamPart): boolean;
+    cleanup(session: Session): void;
+    private getSessionTurn;
+    private appendEvent;
+    private flushAssistantText;
+    private toEventLogValue;
+}
+//# sourceMappingURL=DefaultConversationEventLog.d.ts.map

package/dist/foundation/DefaultConversationEventLog.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"DefaultConversationEventLog.d.ts","sourceRoot":"","sources":["../../src/foundation/DefaultConversationEventLog.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,iBAAiB,EAAE,UAAU,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAC;AAChF,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAC;AAC/D,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAC;AAmBtE,MAAM,WAAW,iCAAiC;IAChD,YAAY,EAAE,YAAY,CAAC;CAC5B;AAED;;;;;;;;GAQG;AACH,qBAAa,2BAA4B,YAAW,oBAAoB;IACtE,OAAO,CAAC,YAAY,CAAe;gBAEvB,MAAM,EAAE,iCAAiC;IAIrD,MAAM,CAAC,OAAO,EAAE,UAAU,EAAE,IAAI,EAAE,iBAAiB,GAAG,IAAI;IAiFpD,UAAU,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC;IASjD,gBAAgB,CAAC,IAAI,EAAE,iBAAiB,GAAG,OAAO;IAIlD,OAAO,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI;IAM/B,OAAO,CAAC,cAAc;IAKtB,OAAO,CAAC,WAAW;IAqBnB,OAAO,CAAC,kBAAkB;IAkB1B,OAAO,CAAC,eAAe;CA4BxB"}

package/dist/foundation/DefaultConversationEventLog.js

@@ -0,0 +1,195 @@
+import crypto from 'node:crypto';
+import { isRecord } from '../utils/isRecord.js';
+/** Working memory key for the runtime event log array. */
+const EVENT_LOG_KEY = 'runtimeEventLog';
+/** Working memory key for accumulated assistant text between flushes. */
+const ASSISTANT_TEXT_KEY = '__ariaAssistantText';
+/** Working memory key for turn tracking. */
+const SESSION_TURN_KEY = '__ariaSessionTurn';
+/** Max event entries before oldest are evicted. */
+const MAX_ENTRIES = 2000;
+/** Stream part types that trigger a checkpoint save. */
+const CHECKPOINT_TYPES = new Set([
+    'tool-result',
+    'tool-error',
+    'flow-transition',
+]);
+/**
+ * Default conversation event log extracted from SessionEventManager + Runtime checkpoint logic.
+ *
+ * Handles:
+ * - Recording stream parts into session working memory
+ * - Text-delta accumulation and flush on terminal events
+ * - Value truncation at depth 5 for safe serialization
+ * - Checkpoint determination and persistence
+ */
+export class DefaultConversationEventLog {
+    sessionStore;
+    constructor(config) {
+        this.sessionStore = config.sessionStore;
+    }
+    record(context, part) {
+        // Fast path: text-delta only accumulates text — no UUID, no base object
+        if (part.type === 'text-delta') {
+            const prevRaw = context.session.workingMemory[ASSISTANT_TEXT_KEY];
+            const prev = typeof prevRaw === 'string' ? prevRaw : '';
+            context.session.workingMemory[ASSISTANT_TEXT_KEY] = prev + part.text;
+            return;
+        }
+        const base = {
+            id: crypto.randomUUID(),
+            sessionId: context.session.id,
+            agentId: context.agentId,
+            turn: this.getSessionTurn(context.session),
+            timestamp: new Date().toISOString(),
+        };
+        switch (part.type) {
+            case 'input':
+                this.appendEvent(context, { ...base, type: 'user', text: part.text, userId: part.userId });
+                return;
+            case 'tool-call':
+                this.appendEvent(context, {
+                    ...base,
+                    type: 'tool_call',
+                    toolCallId: part.toolCallId,
+                    toolName: part.toolName,
+                    args: this.toEventLogValue(part.args),
+                });
+                return;
+            case 'tool-result':
+                this.appendEvent(context, {
+                    ...base,
+                    type: 'tool_result',
+                    toolCallId: part.toolCallId,
+                    toolName: part.toolName,
+                    result: this.toEventLogValue(part.result),
+                });
+                return;
+            case 'tool-error':
+                this.appendEvent(context, {
+                    ...base,
+                    type: 'tool_error',
+                    toolCallId: part.toolCallId,
+                    toolName: part.toolName,
+                    error: part.error,
+                });
+                return;
+            case 'flow-transition':
+                this.appendEvent(context, {
+                    ...base,
+                    type: 'transition',
+                    kind: 'flow',
+                    from: part.from,
+                    to: part.to,
+                });
+                return;
+            case 'handoff':
+                this.appendEvent(context, {
+                    ...base,
+                    type: 'transition',
+                    kind: 'handoff',
+                    from: part.from,
+                    to: part.to,
+                    reason: part.reason,
+                });
+                return;
+            case 'turn-end':
+                this.flushAssistantText(context, 'turn-end');
+                return;
+            case 'done':
+                this.flushAssistantText(context, 'done');
+                return;
+            case 'error':
+                this.flushAssistantText(context, 'error');
+                return;
+            default:
+                return;
+        }
+    }
+    async checkpoint(session) {
+        const now = new Date();
+        session.updatedAt = now;
+        if (session.metadata) {
+            session.metadata.lastActiveAt = now;
+        }
+        await this.sessionStore.save(session);
+    }
+    shouldCheckpoint(part) {
+        return CHECKPOINT_TYPES.has(part.type);
+    }
+    cleanup(session) {
+        delete session.workingMemory[ASSISTANT_TEXT_KEY];
+    }
+    // --- Private helpers (extracted from SessionEventManager) ---
+    getSessionTurn(session) {
+        const value = session.workingMemory[SESSION_TURN_KEY];
+        return typeof value === 'number' && Number.isFinite(value) ? value : 0;
+    }
+    appendEvent(context, entry) {
+        const current = context.session.workingMemory[EVENT_LOG_KEY];
+        let events;
+        if (Array.isArray(current)) {
+            events = current;
+        }
+        else {
+            events = [];
+            context.session.workingMemory[EVENT_LOG_KEY] = events;
+        }
+        events.push(entry);
+        if (events.length > MAX_ENTRIES) {
+            events.splice(0, events.length - MAX_ENTRIES);
+        }
+        // Touch session
+        const now = new Date();
+        context.session.updatedAt = now;
+        if (context.session.metadata) {
+            context.session.metadata.lastActiveAt = now;
+        }
+    }
+    flushAssistantText(context, trigger) {
+        const textRaw = context.session.workingMemory[ASSISTANT_TEXT_KEY];
+        const text = (typeof textRaw === 'string' ? textRaw : '').trim();
+        if (text.length > 0) {
+            this.appendEvent(context, {
+                id: crypto.randomUUID(),
+                sessionId: context.session.id,
+                agentId: context.agentId,
+                turn: this.getSessionTurn(context.session),
+                type: 'assistant_final',
+                trigger,
+                text,
+                timestamp: new Date().toISOString(),
+            });
+        }
+        delete context.session.workingMemory[ASSISTANT_TEXT_KEY];
+    }
+    toEventLogValue(value, depth = 0) {
+        if (value === null || value === undefined) {
+            return value;
+        }
+        if (depth >= 5) {
+            return '[truncated]';
+        }
+        if (value instanceof Date) {
+            return value.toISOString();
+        }
+        if (value instanceof Error) {
+            return { name: value.name, message: value.message };
+        }
+        if (Array.isArray(value)) {
+            return value.slice(0, 50).map(item => this.toEventLogValue(item, depth + 1));
+        }
+        if (typeof value === 'function') {
+            return '[function]';
+        }
+        if (isRecord(value)) {
+            const out = {};
+            for (const [k, v] of Object.entries(value).slice(0, 50)) {
+                out[k] = this.toEventLogValue(v, depth + 1);
+            }
+            return out;
+        }
+        return value;
+    }
+}
+//# sourceMappingURL=DefaultConversationEventLog.js.map

package/dist/foundation/DefaultConversationEventLog.js.map

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

package/dist/foundation/DefaultConversationState.d.ts

@@ -0,0 +1,34 @@
+import type { ModelMessage } from 'ai';
+import type { Session, WorkingMemory } from '../types/index.js';
+import type { SessionStore } from '../session/SessionStore.js';
+import type { ConversationState } from './ConversationState.js';
+export interface DefaultConversationStateConfig {
+    sessionStore: SessionStore;
+    defaultAgentId: string;
+}
+/**
+ * Default conversation state implementation extracted from Runtime.
+ *
+ * Handles:
+ * - Session load/create/save/delete via SessionStore
+ * - Message appending with normalization
+ * - Turn counting
+ * - Working memory access
+ */
+export declare class DefaultConversationState implements ConversationState {
+    private sessionStore;
+    private defaultAgentId;
+    constructor(config: DefaultConversationStateConfig);
+    load(sessionId: string, userId?: string): Promise<Session>;
+    save(session: Session): Promise<void>;
+    delete(sessionId: string): Promise<void>;
+    workingMemory(session: Session): WorkingMemory;
+    appendUserMessage(session: Session, text: string): void;
+    appendAssistantMessage(session: Session, text: string): void;
+    appendMessage(session: Session, message: ModelMessage): void;
+    getSessionTurn(session: Session): number;
+    bumpSessionTurn(session: Session): number;
+    touchSession(session: Session): void;
+    createSession(id: string, defaultAgentId: string, userId?: string): Session;
+}
+//# sourceMappingURL=DefaultConversationState.d.ts.map

package/dist/foundation/DefaultConversationState.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"DefaultConversationState.d.ts","sourceRoot":"","sources":["../../src/foundation/DefaultConversationState.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,IAAI,CAAC;AACvC,OAAO,KAAK,EAAE,OAAO,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAChE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAC;AAC/D,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAOhE,MAAM,WAAW,8BAA8B;IAC7C,YAAY,EAAE,YAAY,CAAC;IAC3B,cAAc,EAAE,MAAM,CAAC;CACxB;AAED;;;;;;;;GAQG;AACH,qBAAa,wBAAyB,YAAW,iBAAiB;IAChE,OAAO,CAAC,YAAY,CAAe;IACnC,OAAO,CAAC,cAAc,CAAS;gBAEnB,MAAM,EAAE,8BAA8B;IAK5C,IAAI,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAQ1D,IAAI,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC;IAKrC,MAAM,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAI9C,aAAa,CAAC,OAAO,EAAE,OAAO,GAAG,aAAa;IAI9C,iBAAiB,CAAC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI;IAQvD,sBAAsB,CAAC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI;IAQ5D,aAAa,CAAC,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,YAAY,GAAG,IAAI;IAQ5D,cAAc,CAAC,OAAO,EAAE,OAAO,GAAG,MAAM;IAKxC,eAAe,CAAC,OAAO,EAAE,OAAO,GAAG,MAAM;IAOzC,YAAY,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI;IAQpC,aAAa,CAAC,EAAE,EAAE,MAAM,EAAE,cAAc,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO;CAuB5E"}

package/dist/foundation/DefaultConversationState.js

@@ -0,0 +1,100 @@
+import { SessionWorkingMemory } from '../runtime/WorkingMemory.js';
+import { normalizeModelMessage } from '../utils/messageNormalization.js';
+/** Internal working memory key for turn tracking. */
+const SESSION_TURN_KEY = '__ariaSessionTurn';
+/**
+ * Default conversation state implementation extracted from Runtime.
+ *
+ * Handles:
+ * - Session load/create/save/delete via SessionStore
+ * - Message appending with normalization
+ * - Turn counting
+ * - Working memory access
+ */
+export class DefaultConversationState {
+    sessionStore;
+    defaultAgentId;
+    constructor(config) {
+        this.sessionStore = config.sessionStore;
+        this.defaultAgentId = config.defaultAgentId;
+    }
+    async load(sessionId, userId) {
+        const existing = await this.sessionStore.get(sessionId);
+        if (existing) {
+            return existing;
+        }
+        return this.createSession(sessionId, this.defaultAgentId, userId);
+    }
+    async save(session) {
+        this.touchSession(session);
+        await this.sessionStore.save(session);
+    }
+    async delete(sessionId) {
+        await this.sessionStore.delete(sessionId);
+    }
+    workingMemory(session) {
+        return new SessionWorkingMemory(session);
+    }
+    appendUserMessage(session, text) {
+        const message = {
+            role: 'user',
+            content: [{ type: 'text', text }],
+        };
+        this.appendMessage(session, message);
+    }
+    appendAssistantMessage(session, text) {
+        const message = {
+            role: 'assistant',
+            content: [{ type: 'text', text }],
+        };
+        this.appendMessage(session, message);
+    }
+    appendMessage(session, message) {
+        const normalized = normalizeModelMessage(message);
+        if (normalized) {
+            session.messages.push(normalized);
+            this.touchSession(session);
+        }
+    }
+    getSessionTurn(session) {
+        const value = session.workingMemory[SESSION_TURN_KEY];
+        return typeof value === 'number' && Number.isFinite(value) ? value : 0;
+    }
+    bumpSessionTurn(session) {
+        const next = this.getSessionTurn(session) + 1;
+        session.workingMemory[SESSION_TURN_KEY] = next;
+        this.touchSession(session);
+        return next;
+    }
+    touchSession(session) {
+        const now = new Date();
+        session.updatedAt = now;
+        if (session.metadata) {
+            session.metadata.lastActiveAt = now;
+        }
+    }
+    createSession(id, defaultAgentId, userId) {
+        const now = new Date();
+        return {
+            id,
+            userId,
+            messages: [],
+            createdAt: now,
+            updatedAt: now,
+            workingMemory: {},
+            currentAgent: defaultAgentId,
+            activeAgentId: defaultAgentId,
+            state: {},
+            metadata: {
+                createdAt: now,
+                lastActiveAt: now,
+                totalTokens: 0,
+                totalSteps: 0,
+                handoffHistory: [],
+            },
+            agentStates: {},
+            handoffHistory: [],
+        };
+    }
+}
+//# sourceMappingURL=DefaultConversationState.js.map

package/dist/foundation/DefaultConversationState.js.map

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

package/dist/foundation/DefaultToolExecutor.d.ts

@@ -0,0 +1,58 @@
+import type { Session, ToolCallRecord } from '../types/index.js';
+import type { ToolExecutor, ExecutableTool } from './ToolExecutor.js';
+import type { ToolEnforcer } from '../guards/ToolEnforcer.js';
+import type { HookRunner } from '../hooks/HookRunner.js';
+import type { MemoryService } from '../memory/MemoryService.js';
+export interface DefaultToolExecutorConfig {
+    enforcer: ToolEnforcer;
+    hookRunner: HookRunner;
+    memoryService?: MemoryService;
+    /** Default timeout in milliseconds for tool execution. Defaults to 30000 (30s). */
+    defaultToolTimeoutMs?: number;
+}
+/**
+ * Error thrown when a tool execution exceeds the configured timeout.
+ */
+export declare class ToolTimeoutError extends Error {
+    readonly toolName: string;
+    readonly timeoutMs: number;
+    constructor(toolName: string, timeoutMs: number);
+}
+/**
+ * Default tool executor extracted from Runtime.wrapToolsWithEnforcement().
+ *
+ * Handles:
+ * - Enforcement checks via ToolEnforcer
+ * - Idempotency key generation
+ * - Context enrichment (experimental_context)
+ * - Error propagation via HookRunner
+ */
+export declare class DefaultToolExecutor implements ToolExecutor {
+    private enforcer;
+    private hookRunner;
+    private memoryService?;
+    private defaultToolTimeoutMs?;
+    constructor(config: DefaultToolExecutorConfig);
+    execute(args: {
+        session: Session;
+        userId?: string;
+        agentId: string;
+        toolName: string;
+        tool: ExecutableTool;
+        input: unknown;
+        toolCallId?: string;
+        abortSignal?: AbortSignal;
+        step?: number;
+        turn?: number;
+        toolCallHistory?: ToolCallRecord[];
+    }): Promise<unknown>;
+    buildIdempotencyKey(args: {
+        sessionId: string;
+        agentId: string;
+        step: number;
+        toolName: string;
+        toolCallId: string;
+    }): string;
+    private withToolExecutionMetadata;
+}
+//# sourceMappingURL=DefaultToolExecutor.d.ts.map

package/dist/foundation/DefaultToolExecutor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"DefaultToolExecutor.d.ts","sourceRoot":"","sources":["../../src/foundation/DefaultToolExecutor.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,OAAO,EAAE,cAAc,EAAsB,MAAM,mBAAmB,CAAC;AACrF,OAAO,KAAK,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AACtE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AAC9D,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AACzD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAGhE,MAAM,WAAW,yBAAyB;IACxC,QAAQ,EAAE,YAAY,CAAC;IACvB,UAAU,EAAE,UAAU,CAAC;IACvB,aAAa,CAAC,EAAE,aAAa,CAAC;IAC9B,mFAAmF;IACnF,oBAAoB,CAAC,EAAE,MAAM,CAAC;CAC/B;AAED;;GAEG;AACH,qBAAa,gBAAiB,SAAQ,KAAK;IACzC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;gBAEf,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM;CAMhD;AAED;;;;;;;;GAQG;AACH,qBAAa,mBAAoB,YAAW,YAAY;IACtD,OAAO,CAAC,QAAQ,CAAe;IAC/B,OAAO,CAAC,UAAU,CAAa;IAC/B,OAAO,CAAC,aAAa,CAAC,CAAgB;IACtC,OAAO,CAAC,oBAAoB,CAAC,CAAS;gBAE1B,MAAM,EAAE,yBAAyB;IAOvC,OAAO,CAAC,IAAI,EAAE;QAClB,OAAO,EAAE,OAAO,CAAC;QACjB,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,OAAO,EAAE,MAAM,CAAC;QAChB,QAAQ,EAAE,MAAM,CAAC;QACjB,IAAI,EAAE,cAAc,CAAC;QACrB,KAAK,EAAE,OAAO,CAAC;QACf,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,WAAW,CAAC,EAAE,WAAW,CAAC;QAC1B,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,eAAe,CAAC,EAAE,cAAc,EAAE,CAAC;KACpC,GAAG,OAAO,CAAC,OAAO,CAAC;IAuFpB,mBAAmB,CAAC,IAAI,EAAE;QACxB,SAAS,EAAE,MAAM,CAAC;QAClB,OAAO,EAAE,MAAM,CAAC;QAChB,IAAI,EAAE,MAAM,CAAC;QACb,QAAQ,EAAE,MAAM,CAAC;QACjB,UAAU,EAAE,MAAM,CAAC;KACpB,GAAG,MAAM;IAIV,OAAO,CAAC,yBAAyB;CAmClC"}

package/dist/foundation/DefaultToolExecutor.js

@@ -0,0 +1,128 @@
+import crypto from 'node:crypto';
+import { isRecord } from '../utils/isRecord.js';
+/**
+ * Error thrown when a tool execution exceeds the configured timeout.
+ */
+export class ToolTimeoutError extends Error {
+    toolName;
+    timeoutMs;
+    constructor(toolName, timeoutMs) {
+        super(`Tool "${toolName}" timeout after ${timeoutMs}ms`);
+        this.name = 'ToolTimeoutError';
+        this.toolName = toolName;
+        this.timeoutMs = timeoutMs;
+    }
+}
+/**
+ * Default tool executor extracted from Runtime.wrapToolsWithEnforcement().
+ *
+ * Handles:
+ * - Enforcement checks via ToolEnforcer
+ * - Idempotency key generation
+ * - Context enrichment (experimental_context)
+ * - Error propagation via HookRunner
+ */
+export class DefaultToolExecutor {
+    enforcer;
+    hookRunner;
+    memoryService;
+    defaultToolTimeoutMs;
+    constructor(config) {
+        this.enforcer = config.enforcer;
+        this.hookRunner = config.hookRunner;
+        this.memoryService = config.memoryService;
+        this.defaultToolTimeoutMs = config.defaultToolTimeoutMs;
+    }
+    async execute(args) {
+        const { session, agentId, toolName, tool, input, step = 0, turn = 0, toolCallHistory = [], } = args;
+        const toolCallId = args.toolCallId ?? crypto.randomUUID();
+        const idempotencyKey = this.buildIdempotencyKey({
+            sessionId: session.id,
+            agentId,
+            step,
+            toolName,
+            toolCallId,
+        });
+        const callRecord = {
+            toolCallId,
+            toolName,
+            args: input,
+            idempotencyKey,
+            success: true,
+            timestamp: Date.now(),
+        };
+        // Enforcement check
+        const enforcement = await this.enforcer.check(callRecord, {
+            previousCalls: toolCallHistory,
+            currentStep: step,
+            sessionState: session.state ?? {},
+        });
+        if (!enforcement.allowed) {
+            const reason = enforcement.reason ?? 'Tool call blocked by enforcement';
+            callRecord.success = false;
+            callRecord.error = new Error(reason);
+            toolCallHistory.push(callRecord);
+            const runContext = {
+                session,
+                agentId,
+                stepCount: step,
+                totalTokens: 0,
+                handoffStack: [],
+                startTime: Date.now(),
+                consecutiveErrors: 0,
+                toolCallHistory,
+            };
+            await this.hookRunner.onToolError(runContext, callRecord, callRecord.error);
+            throw callRecord.error;
+        }
+        // Build enriched options for the tool's execute function
+        if (!('execute' in tool) || typeof tool.execute !== 'function') {
+            throw new Error(`Tool "${toolName}" does not have an execute function`);
+        }
+        const enrichedOptions = this.withToolExecutionMetadata(undefined, { session, agentId, step, turn, toolName, toolCallId, idempotencyKey });
+        try {
+            const timeoutMs = tool.timeout ?? this.defaultToolTimeoutMs ?? 30_000;
+            const exec = tool.execute.bind(tool);
+            const result = await Promise.race([
+                exec(input, enrichedOptions),
+                new Promise((_, reject) => {
+                    const timer = setTimeout(() => reject(new ToolTimeoutError(toolName, timeoutMs)), timeoutMs);
+                    if (typeof timer === 'object' && 'unref' in timer)
+                        timer.unref();
+                }),
+            ]);
+            return result;
+        }
+        catch (error) {
+            console.error(`[ToolExecutor] Tool execution failed for ${toolName}:`, error);
+            throw error;
+        }
+    }
+    buildIdempotencyKey(args) {
+        return `${args.sessionId}:${args.agentId}:${args.step}:${args.toolName}:${args.toolCallId}`;
+    }
+    withToolExecutionMetadata(options, ctx) {
+        const baseOptions = options ?? {};
+        const baseAsAny = baseOptions;
+        const existingContext = isRecord(baseAsAny.experimental_context)
+            ? baseAsAny.experimental_context
+            : {};
+        return {
+            ...baseOptions,
+            toolCallId: ctx.toolCallId,
+            experimental_context: {
+                ...existingContext,
+                session: ctx.session,
+                sessionId: ctx.session.id,
+                agentId: ctx.agentId,
+                step: ctx.step,
+                turn: ctx.turn,
+                toolName: ctx.toolName,
+                toolCallId: ctx.toolCallId,
+                idempotencyKey: ctx.idempotencyKey,
+                memoryService: this.memoryService,
+            },
+        };
+    }
+}
+//# sourceMappingURL=DefaultToolExecutor.js.map

package/dist/foundation/DefaultToolExecutor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"DefaultToolExecutor.js","sourceRoot":"","sources":["../../src/foundation/DefaultToolExecutor.ts"],"names":[],"mappings":"AAAA,OAAO,MAAM,MAAM,aAAa,CAAC;AAOjC,OAAO,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAUhD;;GAEG;AACH,MAAM,OAAO,gBAAiB,SAAQ,KAAK;IAChC,QAAQ,CAAS;IACjB,SAAS,CAAS;IAE3B,YAAY,QAAgB,EAAE,SAAiB;QAC7C,KAAK,CAAC,SAAS,QAAQ,mBAAmB,SAAS,IAAI,CAAC,CAAC;QACzD,IAAI,CAAC,IAAI,GAAG,kBAAkB,CAAC;QAC/B,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;QACzB,IAAI,CAAC,SAAS,GAAG,SAAS,CAAC;IAC7B,CAAC;CACF;AAED;;;;;;;;GAQG;AACH,MAAM,OAAO,mBAAmB;IACtB,QAAQ,CAAe;IACvB,UAAU,CAAa;IACvB,aAAa,CAAiB;IAC9B,oBAAoB,CAAU;IAEtC,YAAY,MAAiC;QAC3C,IAAI,CAAC,QAAQ,GAAG,MAAM,CAAC,QAAQ,CAAC;QAChC,IAAI,CAAC,UAAU,GAAG,MAAM,CAAC,UAAU,CAAC;QACpC,IAAI,CAAC,aAAa,GAAG,MAAM,CAAC,aAAa,CAAC;QAC1C,IAAI,CAAC,oBAAoB,GAAG,MAAM,CAAC,oBAAoB,CAAC;IAC1D,CAAC;IAED,KAAK,CAAC,OAAO,CAAC,IAYb;QACC,MAAM,EACJ,OAAO,EACP,OAAO,EACP,QAAQ,EACR,IAAI,EACJ,KAAK,EACL,IAAI,GAAG,CAAC,EACR,IAAI,GAAG,CAAC,EACR,eAAe,GAAG,EAAE,GACrB,GAAG,IAAI,CAAC;QAET,MAAM,UAAU,GAAG,IAAI,CAAC,UAAU,IAAI,MAAM,CAAC,UAAU,EAAE,CAAC;QAC1D,MAAM,cAAc,GAAG,IAAI,CAAC,mBAAmB,CAAC;YAC9C,SAAS,EAAE,OAAO,CAAC,EAAE;YACrB,OAAO;YACP,IAAI;YACJ,QAAQ;YACR,UAAU;SACX,CAAC,CAAC;QAEH,MAAM,UAAU,GAAmB;YACjC,UAAU;YACV,QAAQ;YACR,IAAI,EAAE,KAAK;YACX,cAAc;YACd,OAAO,EAAE,IAAI;YACb,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE;SACtB,CAAC;QAEF,oBAAoB;QACpB,MAAM,WAAW,GAAG,MAAM,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,UAAU,EAAE;YACxD,aAAa,EAAE,eAAe;YAC9B,WAAW,EAAE,IAAI;YACjB,YAAY,EAAE,OAAO,CAAC,KAAK,IAAI,EAAE;SAClC,CAAC,CAAC;QAEH,IAAI,CAAC,WAAW,CAAC,OAAO,EAAE,CAAC;YACzB,MAAM,MAAM,GAAG,WAAW,CAAC,MAAM,IAAI,kCAAkC,CAAC;YACxE,UAAU,CAAC,OAAO,GAAG,KAAK,CAAC;YAC3B,UAAU,CAAC,KAAK,GAAG,IAAI,KAAK,CAAC,MAAM,CAAC,CAAC;YACrC,eAAe,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;YAEjC,MAAM,UAAU,GAAG;gBACjB,OAAO;gBACP,OAAO;gBACP,SAAS,EAAE,IAAI;gBACf,WAAW,EAAE,CAAC;gBACd,YAAY,EAAE,EAAE;gBAChB,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE;gBACrB,iBAAiB,EAAE,CAAC;gBACpB,eAAe;aAChB,CAAC;YACF,MAAM,IAAI,CAAC,UAAU,CAAC,WAAW,CAAC,UAAU,EAAE,UAAU,EAAE,UAAU,CAAC,KAAK,CAAC,CAAC;YAC5E,MAAM,UAAU,CAAC,KAAK,CAAC;QACzB,CAAC;QAED,yDAAyD;QACzD,IAAI,CAAC,CAAC,SAAS,IAAI,IAAI,CAAC,IAAI,OAAO,IAAI,CAAC,OAAO,KAAK,UAAU,EAAE,CAAC;YAC/D,MAAM,IAAI,KAAK,CAAC,SAAS,QAAQ,qCAAqC,CAAC,CAAC;QAC1E,CAAC;QAED,MAAM,eAAe,GAAG,IAAI,CAAC,yBAAyB,CACpD,SAAS,EACT,EAAE,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,QAAQ,EAAE,UAAU,EAAE,cAAc,EAAE,CACvE,CAAC;QAEF,IAAI,CAAC;YACH,MAAM,SAAS,GAAI,IAAY,CAAC,OAAO,IAAI,IAAI,CAAC,oBAAoB,IAAI,MAAM,CAAC;YAC/E,MAAM,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YACrC,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,IAAI,CAAC;gBAChC,IAAI,CAAC,KAAK,EAAE,eAAe,CAAC;gBAC5B,IAAI,OAAO,CAAQ,CAAC,CAAC,EAAE,MAAM,EAAE,EAAE;oBAC/B,MAAM,KAAK,GAAG,UAAU,CACtB,GAAG,EAAE,CAAC,MAAM,CAAC,IAAI,gBAAgB,CAAC,QAAQ,EAAE,SAAS,CAAC,CAAC,EACvD,SAAS,CACV,CAAC;oBACF,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,OAAO,IAAI,KAAK;wBAAG,KAAa,CAAC,KAAK,EAAE,CAAC;gBAC5E,CAAC,CAAC;aACH,CAAC,CAAC;YACH,OAAO,MAAM,CAAC;QAChB,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,CAAC,KAAK,CAAC,4CAA4C,QAAQ,GAAG,EAAE,KAAK,CAAC,CAAC;YAC9E,MAAM,KAAK,CAAC;QACd,CAAC;IACH,CAAC;IAED,mBAAmB,CAAC,IAMnB;QACC,OAAO,GAAG,IAAI,CAAC,SAAS,IAAI,IAAI,CAAC,OAAO,IAAI,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,QAAQ,IAAI,IAAI,CAAC,UAAU,EAAE,CAAC;IAC9F,CAAC;IAEO,yBAAyB,CAC/B,OAA2C,EAC3C,GAQC;QAED,MAAM,WAAW,GAAG,OAAO,IAAI,EAA4B,CAAC;QAC5D,MAAM,SAAS,GAAG,WAAiD,CAAC;QACpE,MAAM,eAAe,GAAG,QAAQ,CAAC,SAAS,CAAC,oBAAoB,CAAC;YAC9D,CAAC,CAAC,SAAS,CAAC,oBAA+C;YAC3D,CAAC,CAAC,EAAE,CAAC;QAEP,OAAO;YACL,GAAG,WAAW;YACd,UAAU,EAAE,GAAG,CAAC,UAAU;YAC1B,oBAAoB,EAAE;gBACpB,GAAG,eAAe;gBAClB,OAAO,EAAE,GAAG,CAAC,OAAO;gBACpB,SAAS,EAAE,GAAG,CAAC,OAAO,CAAC,EAAE;gBACzB,OAAO,EAAE,GAAG,CAAC,OAAO;gBACpB,IAAI,EAAE,GAAG,CAAC,IAAI;gBACd,IAAI,EAAE,GAAG,CAAC,IAAI;gBACd,QAAQ,EAAE,GAAG,CAAC,QAAQ;gBACtB,UAAU,EAAE,GAAG,CAAC,UAAU;gBAC1B,cAAc,EAAE,GAAG,CAAC,cAAc;gBAClC,aAAa,EAAE,IAAI,CAAC,aAAa;aAClC;SACwB,CAAC;IAC9B,CAAC;CACF"}