@ariaflowagents/core 0.7.1 → 0.9.0

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,mBAAmB,CAAC;AAC1C,YAAY,EACV,sBAAsB,EACtB,eAAe,EACf,cAAc,EACd,YAAY,GACb,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AAClD,OAAO,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AACtD,OAAO,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AAC5D,YAAY,EAAE,oBAAoB,EAAE,MAAM,4BAA4B,CAAC;AAEvE,OAAO,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AACrD,OAAO,EAAE,SAAS,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AACnE,OAAO,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAC/C,OAAO,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AACpD,OAAO,EACL,uBAAuB,EACvB,mBAAmB,EACnB,oBAAoB,EACpB,yBAAyB,EACzB,gBAAgB,GACjB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EACL,oBAAoB,EACpB,4BAA4B,EAC5B,gBAAgB,EAChB,gBAAgB,EAChB,YAAY,GACb,MAAM,wBAAwB,CAAC;AAEhC,OAAO,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAC;AAC7D,YAAY,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AAC9D,OAAO,EAAE,WAAW,EAAE,MAAM,iCAAiC,CAAC;AAE9D,OAAO,EAAE,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAE9D,OAAO,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAClD,OAAO,EAAE,SAAS,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAC/D,YAAY,EAAE,YAAY,EAAE,QAAQ,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AACxF,OAAO,EACL,cAAc,EACd,oBAAoB,EACpB,gBAAgB,EAChB,cAAc,EACd,0BAA0B,GAC3B,MAAM,6BAA6B,CAAC;AACrC,OAAO,EAAE,oBAAoB,EAAE,MAAM,4BAA4B,CAAC;AAClE,OAAO,EACL,oBAAoB,EACpB,+BAA+B,EAC/B,KAAK,cAAc,EACnB,KAAK,qBAAqB,EAC1B,KAAK,qBAAqB,GAC3B,MAAM,6BAA6B,CAAC;AAErC,YAAY,EACV,IAAI,EACJ,OAAO,EACP,cAAc,EACd,cAAc,EACd,oBAAoB,EACpB,oBAAoB,GACrB,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAAE,UAAU,EAAE,oBAAoB,EAAE,MAAM,iBAAiB,CAAC;AACnE,OAAO,EAAE,iBAAiB,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AACxE,YAAY,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACxD,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACjD,YAAY,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AACpD,OAAO,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AACjD,OAAO,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAC;AACzD,YAAY,EACV,cAAc,EACd,cAAc,EACd,SAAS,EACT,SAAS,EACT,UAAU,EACV,UAAU,GACX,MAAM,uBAAuB,CAAC;AAE/B,OAAO,EACL,qBAAqB,EACrB,aAAa,EACb,oBAAoB,EACpB,sBAAsB,EACtB,oBAAoB,EACpB,qBAAqB,EACrB,0BAA0B,EAC1B,2BAA2B,GAC5B,MAAM,oBAAoB,CAAC;AAC5B,YAAY,EAAE,aAAa,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAEvF,OAAO,EAAE,UAAU,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AACrE,OAAO,EAAE,YAAY,EAAE,kBAAkB,EAAE,MAAM,4BAA4B,CAAC;AAC9E,OAAO,EAAE,kBAAkB,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAC;AACjF,YAAY,EAAE,OAAO,EAAE,MAAM,4BAA4B,CAAC;AAC1D,OAAO,EAAE,wBAAwB,EAAE,MAAM,kCAAkC,CAAC;AAC5E,YAAY,EAAE,mBAAmB,EAAE,MAAM,kCAAkC,CAAC;AAC5E,YAAY,EAAE,YAAY,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAE3E,OAAO,EAAE,kBAAkB,EAAE,oBAAoB,EAAE,MAAM,6BAA6B,CAAC;AACvF,YAAY,EAAE,kBAAkB,EAAE,mBAAmB,EAAE,MAAM,6BAA6B,CAAC;AAC3F,OAAO,EACL,2BAA2B,EAC3B,uBAAuB,EACvB,oBAAoB,EACpB,oBAAoB,EACpB,wBAAwB,GACzB,MAAM,+BAA+B,CAAC;AAEvC,OAAO,EAAE,YAAY,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AAC5E,OAAO,KAAK,cAAc,MAAM,4BAA4B,CAAC;AAC7D,cAAc,mBAAmB,CAAC;AAClC,OAAO,KAAK,gBAAgB,MAAM,mBAAmB,CAAC;AAGtD,OAAO,EACL,gBAAgB,EAChB,SAAS,EACT,cAAc,EACd,mBAAmB,EACnB,mBAAmB,EACnB,UAAU,EACV,qBAAqB,GACtB,MAAM,kBAAkB,CAAC;AAC1B,YAAY,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AAG5E,OAAO,EAAE,WAAW,EAAE,gBAAgB,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AACnG,YAAY,EAAE,YAAY,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAGzE,YAAY,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AACvD,YAAY,EACV,WAAW,EACX,mBAAmB,EACnB,oBAAoB,EACpB,sBAAsB,GACvB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EAAE,qBAAqB,EAAE,MAAM,mBAAmB,CAAC;AAC1D,OAAO,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAC;AAGzD,OAAO,EACL,sBAAsB,EACtB,2BAA2B,EAC3B,qBAAqB,EACrB,sBAAsB,EACtB,kBAAkB,GACnB,MAAM,4BAA4B,CAAC;AACpC,YAAY,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AAGtE,OAAO,EACL,cAAc,EACd,iBAAiB,EACjB,kBAAkB,EAClB,UAAU,EACV,cAAc,GACf,MAAM,6BAA6B,CAAC;AACrC,YAAY,EACV,kBAAkB,EAClB,gBAAgB,EAChB,kBAAkB,GACnB,MAAM,6BAA6B,CAAC;AAGrC,OAAO,EACL,mBAAmB,EACnB,wBAAwB,EACxB,2BAA2B,EAC3B,2BAA2B,EAC3B,gBAAgB,GACjB,MAAM,uBAAuB,CAAC;AAC/B,YAAY,EACV,YAAY,EACZ,iBAAiB,EACjB,oBAAoB,EACpB,iBAAiB,EACjB,oBAAoB,EACpB,UAAU,EACV,gBAAgB,GACjB,MAAM,uBAAuB,CAAC;AAE/B,mBAAmB,kBAAkB,CAAC;AAItC,OAAO,EACL,cAAc,EACd,cAAc,EACd,gBAAgB,EAChB,oBAAoB,EACpB,iBAAiB,EACjB,mBAAmB,EACnB,sBAAsB,EACtB,oBAAoB,EACpB,YAAY,GACb,MAAM,yBAAyB,CAAC;AACjC,YAAY,EACV,UAAU,EACV,gBAAgB,EAChB,8BAA8B,EAC9B,yBAAyB,EACzB,eAAe,EACf,aAAa,IAAI,uBAAuB,EACxC,oBAAoB,EACpB,mBAAmB,EACnB,SAAS,EACT,yBAAyB,EACzB,0BAA0B,EAC1B,aAAa,EACb,gBAAgB,EAChB,4BAA4B,GAC7B,MAAM,yBAAyB,CAAC;AAIjC,YAAY,EACV,mBAAmB,EACnB,qBAAqB,EACrB,mBAAmB,EACnB,oBAAoB,EACpB,gBAAgB,GACjB,MAAM,qBAAqB,CAAC"}

package/dist/index.js

@@ -1,16 +1,18 @@
 export { Agent } from './agents/Agent.js';
-export { LLMAgent } from './agents/LLMAgent.js';
 export { FlowAgent } from './agents/FlowAgent.js';
 export { TriageAgent } from './agents/TriageAgent.js';
 export { CompositeAgent } from './agents/CompositeAgent.js';
 export { FlowManager } from './flows/FlowManager.js';
 export { FlowGraph, FlowGraphBuilder } from './flows/FlowGraph.js';
 export { FlowNode } from './flows/FlowNode.js';
-export { extractStructuredFields, mergeExtractionData, computeMissingFields, buildMissingFieldsMessage, } from './flows/extraction.js';
+export { isExtractionNode } from './types/index.js';
+export { extractStructuredFields, mergeExtractionData, computeMissingFields, buildMissingFieldsMessage, toNullableSchema, } from './flows/extraction.js';
 export { createFlowTransition, createFlowTransitionWithNode, isFlowTransition, createFlowUpdate, isFlowUpdate, } from './flows/transitions.js';
 export { SessionManager } from './session/SessionManager.js';
 export { MemoryStore } from './session/stores/MemoryStore.js';
 export { Runtime, createRuntime } from './runtime/Runtime.js';
+export { EvalRunner } from './eval/EvalRunner.js';
+export { scoreTurn, aggregateScores } from './eval/scoring.js';
 export { InjectionQueue, createInjectionQueue, commonInjections, policyProfiles, getPolicyProfileInjections, } from './runtime/InjectionQueue.js';
 export { SessionWorkingMemory } from './runtime/WorkingMemory.js';
 export { createContextManager, createSummarizingContextManager, } from './runtime/ContextManager.js';
@@ -18,10 +20,12 @@ export { createTool, createToolWithFiller } from './tools/Tool.js';
 export { createHandoffTool, isHandoffResult } from './tools/handoff.js';
 export { isFinalResult } from './tools/final.js';
 export { createHttpTool } from './tools/http.js';
+export { createLoadMemoryTool } from './tools/memory.js';
 export { PromptTemplateBuilder, PromptBuilder, createPromptTemplate, SUPPORT_AGENT_TEMPLATE, SALES_AGENT_TEMPLATE, TRIAGE_AGENT_TEMPLATE, createSupportAgentTemplate, DEFAULT_HANDOFF_INSTRUCTION, } from './prompts/index.js';
 export { HookRunner, createHookRunner } from './hooks/HookRunner.js';
 export { loggingHooks, createLoggingHooks } from './hooks/builtin/logging.js';
 export { createMetricsHooks, InMemoryMetrics } from './hooks/builtin/metrics.js';
+export { createObservabilityHooks } from './hooks/builtin/observability.js';
 export { createHttpCallback, clearTextAccumulator } from './callbacks/httpCallback.js';
 export { createStreamCallbackAdapter, createConsoleStreamSink, createFileStreamSink, createHttpStreamSink, createFunctionStreamSink, } from './callbacks/streamCallback.js';
 export { ToolEnforcer, createToolEnforcer } from './guards/ToolEnforcer.js';
@@ -32,4 +36,14 @@ export * as EnforcementRules from './guards/rules.js';
 export { createDateParser, parseDate, parseDateRange, formatDateForSpeech, formatTimeForSpeech, dateParser, commonDateExpressions, } from './utils/index.js';
 // Prompt templates and registry
 export { getTemplate, registerTemplate, listTemplates, getAllTemplates } from './prompts/index.js';
+export { InMemoryMemoryService } from './memory/index.js';
+export { preloadMemoryContext } from './memory/index.js';
+// Context Budget
+export { DEFAULT_CONTEXT_BUDGET, computeMessageHistoryBudget, truncateToTokenBudget, formatMemoryWithBudget, estimateTokenCount, } from './runtime/ContextBudget.js';
+// Handoff Filters
+export { handoffFilters, removeToolHistory, keepRecentMessages, removeKeys, composeFilters, } from './runtime/handoffFilters.js';
+// Foundation (shared primitives for Runtime + VoiceEngine)
+export { DefaultToolExecutor, DefaultConversationState, DefaultConversationEventLog, DefaultAgentStateController, createFoundation, } from './foundation/index.js';
+// ─── Capabilities ────────────────────────────────────────────────────────────
+export { CapabilityHost, FlowCapability, TriageCapability, ExtractionCapability, HandoffCapability, GuardrailCapability, AutoRetrieveCapability, toGeminiDeclarations, toAISDKTools, } from './capabilities/index.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,OAAO,EAAE,KAAK,EAAE,MAAM,mBAAmB,CAAC;AAC1C,OAAO,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAChD,OAAO,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AAClD,OAAO,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AACtD,OAAO,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AAG5D,OAAO,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AACrD,OAAO,EAAE,SAAS,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AACnE,OAAO,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAC/C,OAAO,EACL,uBAAuB,EACvB,mBAAmB,EACnB,oBAAoB,EACpB,yBAAyB,GAC1B,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EACL,oBAAoB,EACpB,4BAA4B,EAC5B,gBAAgB,EAChB,gBAAgB,EAChB,YAAY,GACb,MAAM,wBAAwB,CAAC;AAEhC,OAAO,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAC;AAE7D,OAAO,EAAE,WAAW,EAAE,MAAM,iCAAiC,CAAC;AAE9D,OAAO,EAAE,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAC9D,OAAO,EACL,cAAc,EACd,oBAAoB,EACpB,gBAAgB,EAChB,cAAc,EACd,0BAA0B,GAC3B,MAAM,6BAA6B,CAAC;AACrC,OAAO,EAAE,oBAAoB,EAAE,MAAM,4BAA4B,CAAC;AAClE,OAAO,EACL,oBAAoB,EACpB,+BAA+B,GAGhC,MAAM,6BAA6B,CAAC;AAUrC,OAAO,EAAE,UAAU,EAAE,oBAAoB,EAAE,MAAM,iBAAiB,CAAC;AACnE,OAAO,EAAE,iBAAiB,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAExE,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAEjD,OAAO,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAUjD,OAAO,EACL,qBAAqB,EACrB,aAAa,EACb,oBAAoB,EACpB,sBAAsB,EACtB,oBAAoB,EACpB,qBAAqB,EACrB,0BAA0B,EAC1B,2BAA2B,GAC5B,MAAM,oBAAoB,CAAC;AAG5B,OAAO,EAAE,UAAU,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AACrE,OAAO,EAAE,YAAY,EAAE,kBAAkB,EAAE,MAAM,4BAA4B,CAAC;AAC9E,OAAO,EAAE,kBAAkB,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAC;AAGjF,OAAO,EAAE,kBAAkB,EAAE,oBAAoB,EAAE,MAAM,6BAA6B,CAAC;AAEvF,OAAO,EACL,2BAA2B,EAC3B,uBAAuB,EACvB,oBAAoB,EACpB,oBAAoB,EACpB,wBAAwB,GACzB,MAAM,+BAA+B,CAAC;AAEvC,OAAO,EAAE,YAAY,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AAC5E,OAAO,KAAK,cAAc,MAAM,4BAA4B,CAAC;AAC7D,cAAc,mBAAmB,CAAC;AAClC,OAAO,KAAK,gBAAgB,MAAM,mBAAmB,CAAC;AAEtD,YAAY;AACZ,OAAO,EACL,gBAAgB,EAChB,SAAS,EACT,cAAc,EACd,mBAAmB,EACnB,mBAAmB,EACnB,UAAU,EACV,qBAAqB,GACtB,MAAM,kBAAkB,CAAC;AAG1B,gCAAgC;AAChC,OAAO,EAAE,WAAW,EAAE,gBAAgB,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/dist/memory/MemoryService.d.ts

@@ -0,0 +1,40 @@
+import type { Session } from '../types/index.js';
+import type { MemoryIngestionOptions, SearchMemoryRequest, SearchMemoryResponse } from './types.js';
+/**
+ * Interface for cross-session long-term memory.
+ *
+ * MemoryService is the counterpart to SessionStore:
+ * - SessionStore manages per-session state (messages, workingMemory, agentStates)
+ * - MemoryService manages cross-session knowledge (facts, summaries, preferences)
+ *
+ * The service has two responsibilities:
+ * 1. Ingestion — converting session data into searchable memories
+ * 2. Retrieval — finding relevant memories for a given query
+ */
+export interface MemoryService {
+    /**
+     * Ingest a session into long-term memory.
+     *
+     * Typically called when a session ends or reaches a meaningful checkpoint.
+     * Implementations may store raw events, extract facts via LLM, or summarize.
+     * A session may be ingested multiple times (implementations must handle idempotency).
+     *
+     * @param session - The session to ingest
+     * @param options - Optional ingestion configuration
+     */
+    addSessionToMemory(session: Session, options?: MemoryIngestionOptions): Promise<void>;
+    /**
+     * Search long-term memory for relevant context.
+     *
+     * Returns memories scoped to a specific user within an application context.
+     * Implementations may use keyword matching, semantic search, or hybrid approaches.
+     *
+     * @param request - Search parameters (userId, query, optional filters)
+     */
+    searchMemory(request: SearchMemoryRequest): Promise<SearchMemoryResponse>;
+    /**
+     * Delete all memories for a user. Used for GDPR compliance / data cleanup.
+     */
+    deleteMemories?(userId: string): Promise<void>;
+}
+//# sourceMappingURL=MemoryService.d.ts.map

package/dist/memory/MemoryService.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"MemoryService.d.ts","sourceRoot":"","sources":["../../src/memory/MemoryService.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAC;AACjD,OAAO,KAAK,EAAE,sBAAsB,EAAE,mBAAmB,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AAEpG;;;;;;;;;;GAUG;AACH,MAAM,WAAW,aAAa;IAC5B;;;;;;;;;OASG;IACH,kBAAkB,CAChB,OAAO,EAAE,OAAO,EAChB,OAAO,CAAC,EAAE,sBAAsB,GAC/B,OAAO,CAAC,IAAI,CAAC,CAAC;IAEjB;;;;;;;OAOG;IACH,YAAY,CAAC,OAAO,EAAE,mBAAmB,GAAG,OAAO,CAAC,oBAAoB,CAAC,CAAC;IAE1E;;OAEG;IACH,cAAc,CAAC,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAChD"}

package/dist/memory/MemoryService.js

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

package/dist/memory/MemoryService.js.map

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

package/dist/memory/index.d.ts

@@ -0,0 +1,5 @@
+export type { MemoryService } from './MemoryService.js';
+export type { MemoryEntry, SearchMemoryRequest, SearchMemoryResponse, MemoryIngestionOptions, } from './types.js';
+export { InMemoryMemoryService } from './stores/InMemoryMemoryService.js';
+export { preloadMemoryContext } from './preloadMemory.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/memory/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/memory/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACxD,YAAY,EACV,WAAW,EACX,mBAAmB,EACnB,oBAAoB,EACpB,sBAAsB,GACvB,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,qBAAqB,EAAE,MAAM,mCAAmC,CAAC;AAC1E,OAAO,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC"}

package/dist/memory/index.js

@@ -0,0 +1,3 @@
+export { InMemoryMemoryService } from './stores/InMemoryMemoryService.js';
+export { preloadMemoryContext } from './preloadMemory.js';
+//# sourceMappingURL=index.js.map

package/dist/memory/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/memory/index.ts"],"names":[],"mappings":"AAOA,OAAO,EAAE,qBAAqB,EAAE,MAAM,mCAAmC,CAAC;AAC1E,OAAO,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC"}

package/dist/memory/preloadMemory.d.ts

@@ -0,0 +1,17 @@
+import type { Session } from '../types/index.js';
+import type { MemoryService } from './MemoryService.js';
+/**
+ * Preloads relevant memories into the system prompt before each LLM call.
+ *
+ * This is NOT a tool the LLM calls. It is a Runtime-level middleware that:
+ * 1. Takes the user's latest message as a search query
+ * 2. Searches long-term memory for relevant context
+ * 3. Formats matching memories as a markdown section
+ * 4. Truncates the output to fit within the allocated token budget
+ *
+ * The maxTokens parameter is mandatory. If the formatted output exceeds
+ * maxTokens, memories are dropped in lowest-relevance-first order until
+ * the output fits.
+ */
+export declare function preloadMemoryContext(memoryService: MemoryService, session: Session, userInput: string, maxTokens: number): Promise<string | null>;
+//# sourceMappingURL=preloadMemory.d.ts.map

package/dist/memory/preloadMemory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"preloadMemory.d.ts","sourceRoot":"","sources":["../../src/memory/preloadMemory.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAC;AACjD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAWxD;;;;;;;;;;;;GAYG;AACH,wBAAsB,oBAAoB,CACxC,aAAa,EAAE,aAAa,EAC5B,OAAO,EAAE,OAAO,EAChB,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CA2CxB"}

package/dist/memory/preloadMemory.js

@@ -0,0 +1,62 @@
+/**
+ * Token estimation function. Matches the estimator used in ContextManager.ts:
+ * Math.ceil(text.length / 4).
+ */
+function estimateTokenCount(text) {
+    if (!text)
+        return 0;
+    return Math.ceil(text.length / 4);
+}
+/**
+ * Preloads relevant memories into the system prompt before each LLM call.
+ *
+ * This is NOT a tool the LLM calls. It is a Runtime-level middleware that:
+ * 1. Takes the user's latest message as a search query
+ * 2. Searches long-term memory for relevant context
+ * 3. Formats matching memories as a markdown section
+ * 4. Truncates the output to fit within the allocated token budget
+ *
+ * The maxTokens parameter is mandatory. If the formatted output exceeds
+ * maxTokens, memories are dropped in lowest-relevance-first order until
+ * the output fits.
+ */
+export async function preloadMemoryContext(memoryService, session, userInput, maxTokens) {
+    if (!session.userId)
+        return null;
+    if (maxTokens <= 0)
+        return null;
+    const result = await memoryService.searchMemory({
+        userId: session.userId,
+        query: userInput,
+        limit: 10,
+    });
+    if (result.memories.length === 0)
+        return null;
+    const headerLines = [
+        '## Context from Past Conversations',
+        '',
+        'The following is from previous conversations with this user.',
+        'Use this context to provide continuity and avoid asking for information the user has already provided.',
+        '',
+    ];
+    const header = headerLines.join('\n');
+    let estimatedTokens = estimateTokenCount(header);
+    const includedLines = [];
+    for (const m of result.memories) {
+        const author = m.author ? `${m.author}: ` : '';
+        const date = m.createdAt
+            ? `[${m.createdAt.toISOString().split('T')[0]}] `
+            : '';
+        const line = `${date}${author}${m.content}`;
+        const lineTokens = estimateTokenCount(line);
+        if (estimatedTokens + lineTokens > maxTokens) {
+            break;
+        }
+        includedLines.push(line);
+        estimatedTokens += lineTokens;
+    }
+    if (includedLines.length === 0)
+        return null;
+    return header + includedLines.join('\n');
+}
+//# sourceMappingURL=preloadMemory.js.map

package/dist/memory/preloadMemory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"preloadMemory.js","sourceRoot":"","sources":["../../src/memory/preloadMemory.ts"],"names":[],"mappings":"AAGA;;;GAGG;AACH,SAAS,kBAAkB,CAAC,IAAY;IACtC,IAAI,CAAC,IAAI;QAAE,OAAO,CAAC,CAAC;IACpB,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;AACpC,CAAC;AAED;;;;;;;;;;;;GAYG;AACH,MAAM,CAAC,KAAK,UAAU,oBAAoB,CACxC,aAA4B,EAC5B,OAAgB,EAChB,SAAiB,EACjB,SAAiB;IAEjB,IAAI,CAAC,OAAO,CAAC,MAAM;QAAE,OAAO,IAAI,CAAC;IACjC,IAAI,SAAS,IAAI,CAAC;QAAE,OAAO,IAAI,CAAC;IAEhC,MAAM,MAAM,GAAG,MAAM,aAAa,CAAC,YAAY,CAAC;QAC9C,MAAM,EAAE,OAAO,CAAC,MAAM;QACtB,KAAK,EAAE,SAAS;QAChB,KAAK,EAAE,EAAE;KACV,CAAC,CAAC;IAEH,IAAI,MAAM,CAAC,QAAQ,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,IAAI,CAAC;IAE9C,MAAM,WAAW,GAAG;QAClB,oCAAoC;QACpC,EAAE;QACF,8DAA8D;QAC9D,wGAAwG;QACxG,EAAE;KACH,CAAC;IACF,MAAM,MAAM,GAAG,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACtC,IAAI,eAAe,GAAG,kBAAkB,CAAC,MAAM,CAAC,CAAC;IAEjD,MAAM,aAAa,GAAa,EAAE,CAAC;IAEnC,KAAK,MAAM,CAAC,IAAI,MAAM,CAAC,QAAQ,EAAE,CAAC;QAChC,MAAM,MAAM,GAAG,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,MAAM,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC;QAC/C,MAAM,IAAI,GAAG,CAAC,CAAC,SAAS;YACtB,CAAC,CAAC,IAAI,CAAC,CAAC,SAAS,CAAC,WAAW,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI;YACjD,CAAC,CAAC,EAAE,CAAC;QACP,MAAM,IAAI,GAAG,GAAG,IAAI,GAAG,MAAM,GAAG,CAAC,CAAC,OAAO,EAAE,CAAC;QAC5C,MAAM,UAAU,GAAG,kBAAkB,CAAC,IAAI,CAAC,CAAC;QAE5C,IAAI,eAAe,GAAG,UAAU,GAAG,SAAS,EAAE,CAAC;YAC7C,MAAM;QACR,CAAC;QAED,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACzB,eAAe,IAAI,UAAU,CAAC;IAChC,CAAC;IAED,IAAI,aAAa,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,IAAI,CAAC;IAE5C,OAAO,MAAM,GAAG,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC3C,CAAC"}

package/dist/memory/stores/InMemoryMemoryService.d.ts

@@ -0,0 +1,20 @@
+import type { Session } from '../../types/index.js';
+import type { MemoryService } from '../MemoryService.js';
+import type { MemoryIngestionOptions, SearchMemoryRequest, SearchMemoryResponse } from '../types.js';
+/**
+ * In-memory implementation of MemoryService for development and testing.
+ *
+ * Uses keyword-based search with term overlap scoring.
+ * All data is stored in-process and lost on restart.
+ */
+export declare class InMemoryMemoryService implements MemoryService {
+    /**
+     * In-memory storage indexed by userId.
+     * Each user has a map of sessionId → MemoryEntry[].
+     */
+    private memories;
+    addSessionToMemory(session: Session, options?: MemoryIngestionOptions): Promise<void>;
+    searchMemory(request: SearchMemoryRequest): Promise<SearchMemoryResponse>;
+    deleteMemories(userId: string): Promise<void>;
+}
+//# sourceMappingURL=InMemoryMemoryService.d.ts.map

package/dist/memory/stores/InMemoryMemoryService.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"InMemoryMemoryService.d.ts","sourceRoot":"","sources":["../../../src/memory/stores/InMemoryMemoryService.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,sBAAsB,CAAC;AACpD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACzD,OAAO,KAAK,EAEV,sBAAsB,EACtB,mBAAmB,EACnB,oBAAoB,EACrB,MAAM,aAAa,CAAC;AA6BrB;;;;;GAKG;AACH,qBAAa,qBAAsB,YAAW,aAAa;IACzD;;;OAGG;IACH,OAAO,CAAC,QAAQ,CAAsD;IAEhE,kBAAkB,CACtB,OAAO,EAAE,OAAO,EAChB,OAAO,CAAC,EAAE,sBAAsB,GAC/B,OAAO,CAAC,IAAI,CAAC;IA2BV,YAAY,CAAC,OAAO,EAAE,mBAAmB,GAAG,OAAO,CAAC,oBAAoB,CAAC;IA2BzE,cAAc,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CAGpD"}

package/dist/memory/stores/InMemoryMemoryService.js

@@ -0,0 +1,92 @@
+import { randomUUID } from 'node:crypto';
+/**
+ * Extracts plain text from a message content field.
+ * Handles both string content and array content parts.
+ */
+function extractTextFromMessage(message) {
+    if (typeof message.content === 'string')
+        return message.content;
+    if (Array.isArray(message.content)) {
+        return message.content
+            .filter((part) => part.type === 'text')
+            .map((part) => part.text)
+            .join('\n');
+    }
+    return '';
+}
+/**
+ * Extracts lowercase words from text as a Set for fast lookup.
+ */
+function extractWordsLower(text) {
+    return new Set(text
+        .toLowerCase()
+        .split(/\s+/)
+        .filter(Boolean));
+}
+/**
+ * In-memory implementation of MemoryService for development and testing.
+ *
+ * Uses keyword-based search with term overlap scoring.
+ * All data is stored in-process and lost on restart.
+ */
+export class InMemoryMemoryService {
+    /**
+     * In-memory storage indexed by userId.
+     * Each user has a map of sessionId → MemoryEntry[].
+     */
+    memories = new Map();
+    async addSessionToMemory(session, options) {
+        if (!session.userId)
+            return;
+        const entries = [];
+        for (const message of session.messages) {
+            if (message.role !== 'user' && message.role !== 'assistant')
+                continue;
+            const text = extractTextFromMessage(message);
+            if (!text.trim())
+                continue;
+            entries.push({
+                id: randomUUID(),
+                sessionId: session.id,
+                userId: session.userId,
+                content: text,
+                author: message.role === 'user' ? 'user' : 'assistant',
+                metadata: options?.metadata,
+                createdAt: new Date(),
+            });
+        }
+        // Idempotency: delete existing entries for this session before re-ingesting
+        const userMemories = this.memories.get(session.userId) ?? new Map();
+        userMemories.set(session.id, entries);
+        this.memories.set(session.userId, userMemories);
+    }
+    async searchMemory(request) {
+        const userMemories = this.memories.get(request.userId);
+        if (!userMemories)
+            return { memories: [] };
+        const queryWords = extractWordsLower(request.query);
+        if (queryWords.size === 0)
+            return { memories: [] };
+        const matches = [];
+        for (const entries of userMemories.values()) {
+            for (const entry of entries) {
+                const entryWords = extractWordsLower(entry.content);
+                let matchCount = 0;
+                for (const w of queryWords) {
+                    if (entryWords.has(w))
+                        matchCount++;
+                }
+                if (matchCount > 0) {
+                    matches.push({ ...entry, score: matchCount / queryWords.size });
+                }
+            }
+        }
+        // Sort by relevance score descending
+        matches.sort((a, b) => (b.score ?? 0) - (a.score ?? 0));
+        return { memories: matches.slice(0, request.limit ?? 10) };
+    }
+    async deleteMemories(userId) {
+        this.memories.delete(userId);
+    }
+}
+//# sourceMappingURL=InMemoryMemoryService.js.map

package/dist/memory/stores/InMemoryMemoryService.js.map

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

package/dist/memory/types.d.ts

@@ -0,0 +1,49 @@
+/**
+ * Types for the cross-session long-term memory system.
+ *
+ * These types define the data structures used by MemoryService implementations
+ * for storing, searching, and managing cross-session knowledge.
+ */
+export interface MemoryEntry {
+    /** Unique identifier for this memory */
+    id: string;
+    /** The session this memory was derived from */
+    sessionId: string;
+    /** The user this memory belongs to */
+    userId: string;
+    /** The memory content (extracted fact, summary, or raw text) */
+    content: string;
+    /** Who authored the original content: 'user' | 'assistant' | agent name */
+    author?: string;
+    /** Structured metadata for filtering */
+    metadata?: Record<string, unknown>;
+    /** When the memory was created */
+    createdAt: Date;
+    /** Relevance score (populated by search, not storage) */
+    score?: number;
+}
+export interface SearchMemoryRequest {
+    /** Required: whose memories to search */
+    userId: string;
+    /** The search query */
+    query: string;
+    /** Max results to return (default: 10) */
+    limit?: number;
+    /** Optional metadata filters */
+    filter?: Record<string, unknown>;
+}
+export interface SearchMemoryResponse {
+    memories: MemoryEntry[];
+}
+export interface MemoryIngestionOptions {
+    /** Custom metadata to attach to all memories from this session */
+    metadata?: Record<string, unknown>;
+    /**
+     * Ingestion strategy:
+     * - 'raw': Store message content as-is (default for InMemoryMemoryService)
+     * - 'summarize': Use LLM to summarize the session before storing
+     * - 'extract': Use LLM to extract individual facts/entities
+     */
+    strategy?: 'raw' | 'summarize' | 'extract';
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/memory/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/memory/types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,MAAM,WAAW,WAAW;IAC1B,wCAAwC;IACxC,EAAE,EAAE,MAAM,CAAC;IAEX,+CAA+C;IAC/C,SAAS,EAAE,MAAM,CAAC;IAElB,sCAAsC;IACtC,MAAM,EAAE,MAAM,CAAC;IAEf,gEAAgE;IAChE,OAAO,EAAE,MAAM,CAAC;IAEhB,2EAA2E;IAC3E,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB,wCAAwC;IACxC,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAEnC,kCAAkC;IAClC,SAAS,EAAE,IAAI,CAAC;IAEhB,yDAAyD;IACzD,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,mBAAmB;IAClC,yCAAyC;IACzC,MAAM,EAAE,MAAM,CAAC;IAEf,uBAAuB;IACvB,KAAK,EAAE,MAAM,CAAC;IAEd,0CAA0C;IAC1C,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf,gCAAgC;IAChC,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAClC;AAED,MAAM,WAAW,oBAAoB;IACnC,QAAQ,EAAE,WAAW,EAAE,CAAC;CACzB;AAED,MAAM,WAAW,sBAAsB;IACrC,kEAAkE;IAClE,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAEnC;;;;;OAKG;IACH,QAAQ,CAAC,EAAE,KAAK,GAAG,WAAW,GAAG,SAAS,CAAC;CAC5C"}

package/dist/memory/types.js

@@ -0,0 +1,8 @@
+/**
+ * Types for the cross-session long-term memory system.
+ *
+ * These types define the data structures used by MemoryService implementations
+ * for storing, searching, and managing cross-session knowledge.
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/memory/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/memory/types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG"}

package/dist/orchestration/DefaultOrchestrationAuthority.d.ts

@@ -0,0 +1,91 @@
+import type { OrchestrationAuthority } from './OrchestrationAuthority.js';
+import type { AuthoritySessionHandle, ToolExecutionOutcome, OpenSessionParams, OrchestrationAuthorityConfig } from './types.js';
+import type { RealtimeSessionConfig } from '../realtime/RealtimeAudioClient.js';
+import type { ToolExecutor } from '../foundation/ToolExecutor.js';
+import type { ConversationState } from '../foundation/ConversationState.js';
+import type { ConversationEventLog } from '../foundation/ConversationEventLog.js';
+import type { AgentStateController } from '../foundation/AgentStateController.js';
+import { HookRunner } from '../hooks/HookRunner.js';
+/**
+ * Default implementation of the OrchestrationAuthority port.
+ *
+ * Composes Foundation services, HookRunner, CapabilityHost, LivePromptAssembler,
+ * ExtractionEngine, and MemoryService into the transport-agnostic orchestration
+ * sequence defined in RFC-REALTIME-RUNTIME-AUTHORITY.md.
+ *
+ * This is the "single brain" that both text Runtime and RealtimeRuntime
+ * delegate to for conversational semantics.
+ */
+export declare class DefaultOrchestrationAuthority implements OrchestrationAuthority {
+    private readonly agents;
+    private readonly defaultAgentId;
+    private readonly hookRunner;
+    private readonly toolExecutor;
+    private readonly conversationState;
+    private readonly eventLog;
+    private readonly agentState;
+    private readonly extractionEngine;
+    private readonly promptAssembler;
+    private readonly memoryService;
+    private readonly memoryIngestion;
+    private readonly maxPersistRetries;
+    private readonly realtimeExtractionRunner?;
+    private readonly autoRetrieveProvider;
+    constructor(config: OrchestrationAuthorityConfig);
+    openSession(params: OpenSessionParams): Promise<AuthoritySessionHandle>;
+    recordUserInput(handle: AuthoritySessionHandle, text: string): Promise<void>;
+    recordAssistantOutput(handle: AuthoritySessionHandle, text: string): Promise<void>;
+    prepareRealtimeConfig(handle: AuthoritySessionHandle): Promise<RealtimeSessionConfig>;
+    executeToolCall(handle: AuthoritySessionHandle, call: {
+        id: string;
+        name: string;
+        args: unknown;
+    }): Promise<ToolExecutionOutcome>;
+    completeTurn(handle: AuthoritySessionHandle): Promise<void>;
+    closeSession(handle: AuthoritySessionHandle, result?: {
+        success: boolean;
+        error?: Error;
+    }): Promise<void>;
+    failSession(handle: AuthoritySessionHandle, error: Error): Promise<void>;
+    /** Expose foundation services for facades that need direct access. */
+    get foundation(): {
+        toolExecutor: ToolExecutor;
+        conversationState: ConversationState;
+        eventLog: ConversationEventLog;
+        agentState: AgentStateController;
+    };
+    /** Expose hook runner for facades that need to fire transport-specific hooks. */
+    get hooks(): HookRunner;
+    /**
+     * Build a CapabilityHost from agent config.
+     * Mirrors the logic in CapabilityCallWorker.buildHost() and
+     * AgentExecuteStage's host construction, unified into one place.
+     */
+    private buildCapabilityHost;
+    private buildOutcome;
+    private runExtraction;
+    private runRealtimeKnowledgeRefresh;
+    private runRealtimeExtractionRefinement;
+    private runMemoryIngestion;
+    private persistWithRetry;
+    private buildSessionEndMetadata;
+    private getInternals;
+    private readPersistedFlowState;
+    private syncFlowStateToSession;
+    private resolveToolArgs;
+    private verifyExtractionSubmission;
+    private buildExtractionTranscript;
+    private getMessageText;
+    private toRecord;
+    private getRequiredExtractionFields;
+    private filterExtractionArgsAgainstTranscript;
+    private buildToolCallRecord;
+    /**
+     * Determine whether a tool is a capability tool (flow transition, extraction)
+     * or a regular agent tool. Capability tools have self-contained execute()
+     * and bypass ToolExecutor enforcement.
+     */
+    private isCapabilityTool;
+    private getLastUserInput;
+}
+//# sourceMappingURL=DefaultOrchestrationAuthority.d.ts.map

package/dist/orchestration/DefaultOrchestrationAuthority.d.ts.map

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