@ariaflowagents/core 0.7.1 → 0.8.1

package/dist/foundation/ConversationEventLog.d.ts

@@ -0,0 +1,72 @@
+import type { HarnessStreamPart, RunContext, Session } from '../types/index.js';
+/**
+ * Discriminated union of conversation-level events for the runtime event log.
+ * Stored in session workingMemory for observability.
+ */
+export type ConversationEvent = {
+    type: 'user';
+    text: string;
+    userId?: string;
+    timestamp: Date;
+} | {
+    type: 'assistant';
+    text: string;
+    timestamp: Date;
+} | {
+    type: 'tool-call';
+    toolCallId: string;
+    toolName: string;
+    args: unknown;
+    timestamp: Date;
+} | {
+    type: 'tool-result';
+    toolCallId: string;
+    toolName: string;
+    result: unknown;
+    timestamp: Date;
+} | {
+    type: 'tool-error';
+    toolCallId: string;
+    toolName: string;
+    error: string;
+    timestamp: Date;
+} | {
+    type: 'handoff';
+    from: string;
+    to: string;
+    reason?: string;
+    timestamp: Date;
+} | {
+    type: 'flow-transition';
+    from: string;
+    to: string;
+    timestamp: Date;
+} | {
+    type: 'error';
+    error: string;
+    timestamp: Date;
+};
+/**
+ * Records conversation events into session working memory and manages checkpointing.
+ * Shared by Runtime and VoiceEngine.
+ */
+export interface ConversationEventLog {
+    /**
+     * Record a stream part into the session's runtime event log.
+     * Text-deltas are accumulated; terminal events flush the assistant text.
+     */
+    record(context: RunContext, part: HarnessStreamPart): void;
+    /**
+     * Persist the session as a checkpoint (called after significant events).
+     */
+    checkpoint(session: Session): Promise<void>;
+    /**
+     * Whether a given stream part type should trigger a checkpoint save.
+     */
+    shouldCheckpoint(part: HarnessStreamPart): boolean;
+    /**
+     * Clean up transient state (e.g., accumulated assistant text) from the session.
+     */
+    cleanup(session: Session): void;
+}
+//# sourceMappingURL=ConversationEventLog.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ConversationEventLog.d.ts","sourceRoot":"","sources":["../../src/foundation/ConversationEventLog.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,UAAU,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAC;AAEhF;;;GAGG;AACH,MAAM,MAAM,iBAAiB,GACzB;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,IAAI,CAAA;CAAE,GAChE;IAAE,IAAI,EAAE,WAAW,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,IAAI,CAAA;CAAE,GACpD;IAAE,IAAI,EAAE,WAAW,CAAC;IAAC,UAAU,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,OAAO,CAAC;IAAC,SAAS,EAAE,IAAI,CAAA;CAAE,GAC3F;IAAE,IAAI,EAAE,aAAa,CAAC;IAAC,UAAU,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,OAAO,CAAC;IAAC,SAAS,EAAE,IAAI,CAAA;CAAE,GAC/F;IAAE,IAAI,EAAE,YAAY,CAAC;IAAC,UAAU,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,IAAI,CAAA;CAAE,GAC5F;IAAE,IAAI,EAAE,SAAS,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,EAAE,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,IAAI,CAAA;CAAE,GAC/E;IAAE,IAAI,EAAE,iBAAiB,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,EAAE,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,IAAI,CAAA;CAAE,GACtE;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,IAAI,CAAA;CAAE,CAAC;AAEtD;;;GAGG;AACH,MAAM,WAAW,oBAAoB;IACnC;;;OAGG;IACH,MAAM,CAAC,OAAO,EAAE,UAAU,EAAE,IAAI,EAAE,iBAAiB,GAAG,IAAI,CAAC;IAE3D;;OAEG;IACH,UAAU,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAE5C;;OAEG;IACH,gBAAgB,CAAC,IAAI,EAAE,iBAAiB,GAAG,OAAO,CAAC;IAEnD;;OAEG;IACH,OAAO,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAAC;CACjC"}

package/dist/foundation/ConversationEventLog.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=ConversationEventLog.js.map

package/dist/foundation/ConversationEventLog.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ConversationEventLog.js","sourceRoot":"","sources":["../../src/foundation/ConversationEventLog.ts"],"names":[],"mappings":""}

package/dist/foundation/ConversationState.d.ts

@@ -0,0 +1,31 @@
+import type { Session, WorkingMemory } from '../types/index.js';
+import type { ModelMessage } from 'ai';
+/**
+ * Manages session lifecycle: load, save, delete, message append, turn counting.
+ * Shared by Runtime and VoiceEngine.
+ */
+export interface ConversationState {
+    /** Load an existing session or create a new one. */
+    load(sessionId: string, userId?: string): Promise<Session>;
+    /** Persist session to the backing store. */
+    save(session: Session): Promise<void>;
+    /** Delete a session from the backing store. */
+    delete(sessionId: string): Promise<void>;
+    /** Get a WorkingMemory wrapper for the session. */
+    workingMemory(session: Session): WorkingMemory;
+    /** Append a user message to the session history. */
+    appendUserMessage(session: Session, text: string): void;
+    /** Append an assistant message to the session history. */
+    appendAssistantMessage(session: Session, text: string): void;
+    /** Append a raw ModelMessage to the session history. */
+    appendMessage(session: Session, message: ModelMessage): void;
+    /** Get the current turn number for the session. */
+    getSessionTurn(session: Session): number;
+    /** Increment and return the new turn number. */
+    bumpSessionTurn(session: Session): number;
+    /** Update the session's updatedAt timestamp. */
+    touchSession(session: Session): void;
+    /** Create a fresh session with defaults. */
+    createSession(id: string, defaultAgentId: string, userId?: string): Session;
+}
+//# sourceMappingURL=ConversationState.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ConversationState.d.ts","sourceRoot":"","sources":["../../src/foundation/ConversationState.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAChE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,IAAI,CAAC;AAEvC;;;GAGG;AACH,MAAM,WAAW,iBAAiB;IAChC,oDAAoD;IACpD,IAAI,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAE3D,4CAA4C;IAC5C,IAAI,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAEtC,+CAA+C;IAC/C,MAAM,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAEzC,mDAAmD;IACnD,aAAa,CAAC,OAAO,EAAE,OAAO,GAAG,aAAa,CAAC;IAE/C,oDAAoD;IACpD,iBAAiB,CAAC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IAExD,0DAA0D;IAC1D,sBAAsB,CAAC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IAE7D,wDAAwD;IACxD,aAAa,CAAC,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,YAAY,GAAG,IAAI,CAAC;IAE7D,mDAAmD;IACnD,cAAc,CAAC,OAAO,EAAE,OAAO,GAAG,MAAM,CAAC;IAEzC,gDAAgD;IAChD,eAAe,CAAC,OAAO,EAAE,OAAO,GAAG,MAAM,CAAC;IAE1C,gDAAgD;IAChD,YAAY,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAAC;IAErC,4CAA4C;IAC5C,aAAa,CAAC,EAAE,EAAE,MAAM,EAAE,cAAc,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;CAC7E"}

package/dist/foundation/ConversationState.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=ConversationState.js.map

package/dist/foundation/ConversationState.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ConversationState.js","sourceRoot":"","sources":["../../src/foundation/ConversationState.ts"],"names":[],"mappings":""}

package/dist/foundation/DefaultAgentStateController.d.ts

@@ -0,0 +1,24 @@
+import type { Session } from '../types/index.js';
+import type { AgentStateController } from './AgentStateController.js';
+/**
+ * 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 declare class DefaultAgentStateController implements AgentStateController {
+    getActiveAgent(session: Session, fallbackAgentId: string): string;
+    setActiveAgent(session: Session, agentId: string): void;
+    recordHandoff(args: {
+        session: Session;
+        fromAgentId: string;
+        toAgentId: string;
+        reason: string;
+    }): void;
+    updateAgentState(session: Session, agentId: string, state: Record<string, unknown>): void;
+    isCircularHandoff(handoffStack: string[], agentId: string, maxVisits?: number): boolean;
+}
+//# sourceMappingURL=DefaultAgentStateController.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"DefaultAgentStateController.d.ts","sourceRoot":"","sources":["../../src/foundation/DefaultAgentStateController.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAiB,MAAM,mBAAmB,CAAC;AAChE,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAC;AAEtE;;;;;;;;GAQG;AACH,qBAAa,2BAA4B,YAAW,oBAAoB;IACtE,cAAc,CAAC,OAAO,EAAE,OAAO,EAAE,eAAe,EAAE,MAAM,GAAG,MAAM;IAIjE,cAAc,CAAC,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI;IAKvD,aAAa,CAAC,IAAI,EAAE;QAClB,OAAO,EAAE,OAAO,CAAC;QACjB,WAAW,EAAE,MAAM,CAAC;QACpB,SAAS,EAAE,MAAM,CAAC;QAClB,MAAM,EAAE,MAAM,CAAC;KAChB,GAAG,IAAI;IAeR,gBAAgB,CAAC,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAczF,iBAAiB,CAAC,YAAY,EAAE,MAAM,EAAE,EAAE,OAAO,EAAE,MAAM,EAAE,SAAS,GAAE,MAAU,GAAG,OAAO;CAI3F"}

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