@ariaflowagents/core 0.7.1 → 0.9.0

package/dist/foundation/ToolExecutor.d.ts

@@ -0,0 +1,44 @@
+import type { Session, ToolCallRecord } from '../types/index.js';
+/**
+ * Minimal tool shape required by the executor.
+ * Compatible with AI SDK `Tool`, VoiceToolDef, and plain `{ execute }` objects.
+ */
+export interface ExecutableTool {
+    execute: (args: any, options?: any) => Promise<unknown>;
+    description?: string;
+}
+/**
+ * Encapsulates tool execution with enforcement, idempotency, and context enrichment.
+ * Shared by Runtime (text path) and VoiceEngine (audio path).
+ */
+export interface ToolExecutor {
+    /**
+     * Execute a single tool call with enforcement checks and context enrichment.
+     * Returns the tool's result or throws if blocked/failed.
+     */
+    execute(args: {
+        session: Session;
+        userId?: string;
+        agentId: string;
+        toolName: string;
+        tool: ExecutableTool;
+        input: unknown;
+        toolCallId?: string;
+        abortSignal?: AbortSignal;
+        step?: number;
+        turn?: number;
+        /** Full tool call history for enforcement context. */
+        toolCallHistory?: ToolCallRecord[];
+    }): Promise<unknown>;
+    /**
+     * Build a deterministic idempotency key for external side-effect deduplication.
+     */
+    buildIdempotencyKey(args: {
+        sessionId: string;
+        agentId: string;
+        step: number;
+        toolName: string;
+        toolCallId: string;
+    }): string;
+}
+//# sourceMappingURL=ToolExecutor.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ToolExecutor.d.ts","sourceRoot":"","sources":["../../src/foundation/ToolExecutor.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAEjE;;;GAGG;AACH,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,CAAC,IAAI,EAAE,GAAG,EAAE,OAAO,CAAC,EAAE,GAAG,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;IACxD,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED;;;GAGG;AACH,MAAM,WAAW,YAAY;IAC3B;;;OAGG;IACH,OAAO,CAAC,IAAI,EAAE;QACZ,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,sDAAsD;QACtD,eAAe,CAAC,EAAE,cAAc,EAAE,CAAC;KACpC,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAErB;;OAEG;IACH,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,CAAC;CACZ"}

package/dist/foundation/ToolExecutor.js

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

package/dist/foundation/ToolExecutor.js.map

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

package/dist/foundation/createFoundation.d.ts

@@ -0,0 +1,33 @@
+import type { SessionStore } from '../session/SessionStore.js';
+import type { MemoryService } from '../memory/MemoryService.js';
+import type { EnforcementRule, HarnessHooks } from '../types/index.js';
+import type { ToolExecutor } from './ToolExecutor.js';
+import type { ConversationState } from './ConversationState.js';
+import type { ConversationEventLog } from './ConversationEventLog.js';
+import type { AgentStateController } from './AgentStateController.js';
+/**
+ * Configuration for creating a foundation service bundle.
+ */
+export interface FoundationConfig {
+    sessionStore?: SessionStore;
+    defaultAgentId?: string;
+    enforcementRules?: EnforcementRule[];
+    hooks?: HarnessHooks;
+    memoryService?: MemoryService;
+}
+/**
+ * Bundle of all foundation services. Both Runtime and VoiceEngine
+ * compose this to share operational logic.
+ */
+export interface Foundation {
+    toolExecutor: ToolExecutor;
+    conversationState: ConversationState;
+    eventLog: ConversationEventLog;
+    agentState: AgentStateController;
+}
+/**
+ * Create a foundation service bundle with default implementations.
+ * Services can be individually overridden if needed.
+ */
+export declare function createFoundation(config?: FoundationConfig): Foundation;
+//# sourceMappingURL=createFoundation.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"createFoundation.d.ts","sourceRoot":"","sources":["../../src/foundation/createFoundation.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAC;AAC/D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAChE,OAAO,KAAK,EAAE,eAAe,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACvE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACtD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAChE,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAC;AACtE,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAC;AAUtE;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,YAAY,CAAC,EAAE,YAAY,CAAC;IAC5B,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,gBAAgB,CAAC,EAAE,eAAe,EAAE,CAAC;IACrC,KAAK,CAAC,EAAE,YAAY,CAAC;IACrB,aAAa,CAAC,EAAE,aAAa,CAAC;CAC/B;AAED;;;GAGG;AACH,MAAM,WAAW,UAAU;IACzB,YAAY,EAAE,YAAY,CAAC;IAC3B,iBAAiB,EAAE,iBAAiB,CAAC;IACrC,QAAQ,EAAE,oBAAoB,CAAC;IAC/B,UAAU,EAAE,oBAAoB,CAAC;CAClC;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,GAAE,gBAAqB,GAAG,UAAU,CAqB1E"}

package/dist/foundation/createFoundation.js

@@ -0,0 +1,34 @@
+import { DefaultToolExecutor } from './DefaultToolExecutor.js';
+import { DefaultConversationState } from './DefaultConversationState.js';
+import { DefaultConversationEventLog } from './DefaultConversationEventLog.js';
+import { DefaultAgentStateController } from './DefaultAgentStateController.js';
+import { ToolEnforcer } from '../guards/ToolEnforcer.js';
+import { defaultEnforcementRules } from '../guards/rules.js';
+import { HookRunner } from '../hooks/HookRunner.js';
+import { MemoryStore } from '../session/stores/MemoryStore.js';
+/**
+ * Create a foundation service bundle with default implementations.
+ * Services can be individually overridden if needed.
+ */
+export function createFoundation(config = {}) {
+    const sessionStore = config.sessionStore ?? new MemoryStore();
+    const defaultAgentId = config.defaultAgentId ?? 'default';
+    const enforcer = new ToolEnforcer(config.enforcementRules ?? defaultEnforcementRules);
+    const hookRunner = new HookRunner(config.hooks);
+    return {
+        toolExecutor: new DefaultToolExecutor({
+            enforcer,
+            hookRunner,
+            memoryService: config.memoryService,
+        }),
+        conversationState: new DefaultConversationState({
+            sessionStore,
+            defaultAgentId,
+        }),
+        eventLog: new DefaultConversationEventLog({
+            sessionStore,
+        }),
+        agentState: new DefaultAgentStateController(),
+    };
+}
+//# sourceMappingURL=createFoundation.js.map

package/dist/foundation/createFoundation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"createFoundation.js","sourceRoot":"","sources":["../../src/foundation/createFoundation.ts"],"names":[],"mappings":"AAOA,OAAO,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAC/D,OAAO,EAAE,wBAAwB,EAAE,MAAM,+BAA+B,CAAC;AACzE,OAAO,EAAE,2BAA2B,EAAE,MAAM,kCAAkC,CAAC;AAC/E,OAAO,EAAE,2BAA2B,EAAE,MAAM,kCAAkC,CAAC;AAC/E,OAAO,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AACzD,OAAO,EAAE,uBAAuB,EAAE,MAAM,oBAAoB,CAAC;AAC7D,OAAO,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AACpD,OAAO,EAAE,WAAW,EAAE,MAAM,kCAAkC,CAAC;AAwB/D;;;GAGG;AACH,MAAM,UAAU,gBAAgB,CAAC,SAA2B,EAAE;IAC5D,MAAM,YAAY,GAAG,MAAM,CAAC,YAAY,IAAI,IAAI,WAAW,EAAE,CAAC;IAC9D,MAAM,cAAc,GAAG,MAAM,CAAC,cAAc,IAAI,SAAS,CAAC;IAC1D,MAAM,QAAQ,GAAG,IAAI,YAAY,CAAC,MAAM,CAAC,gBAAgB,IAAI,uBAAuB,CAAC,CAAC;IACtF,MAAM,UAAU,GAAG,IAAI,UAAU,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IAEhD,OAAO;QACL,YAAY,EAAE,IAAI,mBAAmB,CAAC;YACpC,QAAQ;YACR,UAAU;YACV,aAAa,EAAE,MAAM,CAAC,aAAa;SACpC,CAAC;QACF,iBAAiB,EAAE,IAAI,wBAAwB,CAAC;YAC9C,YAAY;YACZ,cAAc;SACf,CAAC;QACF,QAAQ,EAAE,IAAI,2BAA2B,CAAC;YACxC,YAAY;SACb,CAAC;QACF,UAAU,EAAE,IAAI,2BAA2B,EAAE;KAC9C,CAAC;AACJ,CAAC"}

package/dist/foundation/index.d.ts

@@ -0,0 +1,15 @@
+export type { AgentDefinition } from './AgentDefinition.js';
+export type { ToolExecutor, ExecutableTool } from './ToolExecutor.js';
+export type { ConversationState } from './ConversationState.js';
+export type { ConversationEventLog, ConversationEvent } from './ConversationEventLog.js';
+export type { AgentStateController } from './AgentStateController.js';
+export { DefaultToolExecutor, ToolTimeoutError } from './DefaultToolExecutor.js';
+export type { DefaultToolExecutorConfig } from './DefaultToolExecutor.js';
+export { DefaultConversationState } from './DefaultConversationState.js';
+export type { DefaultConversationStateConfig } from './DefaultConversationState.js';
+export { DefaultConversationEventLog } from './DefaultConversationEventLog.js';
+export type { DefaultConversationEventLogConfig } from './DefaultConversationEventLog.js';
+export { DefaultAgentStateController } from './DefaultAgentStateController.js';
+export { createFoundation } from './createFoundation.js';
+export type { Foundation, FoundationConfig } from './createFoundation.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/foundation/index.ts"],"names":[],"mappings":"AACA,YAAY,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAC5D,YAAY,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AACtE,YAAY,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAChE,YAAY,EAAE,oBAAoB,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAC;AACzF,YAAY,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAC;AAGtE,OAAO,EAAE,mBAAmB,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AACjF,YAAY,EAAE,yBAAyB,EAAE,MAAM,0BAA0B,CAAC;AAC1E,OAAO,EAAE,wBAAwB,EAAE,MAAM,+BAA+B,CAAC;AACzE,YAAY,EAAE,8BAA8B,EAAE,MAAM,+BAA+B,CAAC;AACpF,OAAO,EAAE,2BAA2B,EAAE,MAAM,kCAAkC,CAAC;AAC/E,YAAY,EAAE,iCAAiC,EAAE,MAAM,kCAAkC,CAAC;AAC1F,OAAO,EAAE,2BAA2B,EAAE,MAAM,kCAAkC,CAAC;AAG/E,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AACzD,YAAY,EAAE,UAAU,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC"}

package/dist/foundation/index.js

@@ -0,0 +1,8 @@
+// Default implementations
+export { DefaultToolExecutor, ToolTimeoutError } from './DefaultToolExecutor.js';
+export { DefaultConversationState } from './DefaultConversationState.js';
+export { DefaultConversationEventLog } from './DefaultConversationEventLog.js';
+export { DefaultAgentStateController } from './DefaultAgentStateController.js';
+// Factory
+export { createFoundation } from './createFoundation.js';
+//# sourceMappingURL=index.js.map

package/dist/foundation/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/foundation/index.ts"],"names":[],"mappings":"AAOA,0BAA0B;AAC1B,OAAO,EAAE,mBAAmB,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AAEjF,OAAO,EAAE,wBAAwB,EAAE,MAAM,+BAA+B,CAAC;AAEzE,OAAO,EAAE,2BAA2B,EAAE,MAAM,kCAAkC,CAAC;AAE/E,OAAO,EAAE,2BAA2B,EAAE,MAAM,kCAAkC,CAAC;AAE/E,UAAU;AACV,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC"}

package/dist/hooks/HookRunner.d.ts

@@ -1,10 +1,13 @@
-import type { HarnessHooks, RunContext, StepResult, ToolCallRecord, HarnessStreamPart } from '../types/index.js';
+import type { HarnessHooks, RunContext, StepResult, ToolCallRecord, HarnessStreamPart, Session } from '../types/index.js';
+import type { SessionEndMetadata } from '../types/telemetry.js';
 import type { ModelMessage } from 'ai';
 type HookErrorHandler = (hookName: string, error: Error) => void;
 export declare class HookRunner {
     private hooks;
     private errorHandler;
     constructor(hooks?: HarnessHooks, errorHandler?: HookErrorHandler);
+    /** Check if a specific hook is configured. */
+    has(hookName: string): boolean;
     run<K extends keyof HarnessHooks>(hookName: K, ...args: NonNullable<HarnessHooks[K]> extends (...args: infer P) => any ? P : never): Promise<void>;
     onStart(context: RunContext): Promise<void>;
     onEnd(context: RunContext, result: {
@@ -22,6 +25,7 @@ export declare class HookRunner {
     onError(context: RunContext, error: Error): Promise<void>;
     onMessage(context: RunContext, message: ModelMessage): Promise<void>;
     onStreamPart(context: RunContext, part: HarnessStreamPart): Promise<void>;
+    onSessionEnd(session: Session, metadata: SessionEndMetadata): Promise<void>;
     merge(additionalHooks: HarnessHooks): void;
     setHooks(hooks: HarnessHooks): void;
     getHooks(): HarnessHooks;

package/dist/hooks/HookRunner.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"HookRunner.d.ts","sourceRoot":"","sources":["../../src/hooks/HookRunner.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,UAAU,EAAE,UAAU,EAAE,cAAc,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AACjH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,IAAI,CAAC;AAEvC,KAAK,gBAAgB,GAAG,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC;AAOjE,qBAAa,UAAU;IACrB,OAAO,CAAC,KAAK,CAAe;IAC5B,OAAO,CAAC,YAAY,CAAmB;gBAE3B,KAAK,GAAE,YAAiB,EAAE,YAAY,CAAC,EAAE,gBAAgB;IAK/D,GAAG,CAAC,CAAC,SAAS,MAAM,YAAY,EACpC,QAAQ,EAAE,CAAC,EACX,GAAG,IAAI,EAAE,WAAW,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,GAAG,IAAI,EAAE,MAAM,CAAC,KAAK,GAAG,GAAG,CAAC,GAAG,KAAK,GAClF,OAAO,CAAC,IAAI,CAAC;IAWV,OAAO,CAAC,OAAO,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC;IAI3C,KAAK,CAAC,OAAO,EAAE,UAAU,EAAE,MAAM,EAAE;QAAE,OAAO,EAAE,OAAO,CAAC;QAAC,KAAK,CAAC,EAAE,KAAK,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAItF,WAAW,CAAC,OAAO,EAAE,UAAU,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAI7D,SAAS,CAAC,OAAO,EAAE,UAAU,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC;IAI/E,UAAU,CAAC,OAAO,EAAE,UAAU,EAAE,IAAI,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC;IAIpE,YAAY,CAAC,OAAO,EAAE,UAAU,EAAE,IAAI,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC;IAItE,WAAW,CAAC,OAAO,EAAE,UAAU,EAAE,IAAI,EAAE,cAAc,EAAE,KAAK,EAAE,KAAK,GAAG,OAAO,CAAC,IAAI,CAAC;IAInF,YAAY,CAAC,OAAO,EAAE,UAAU,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAIjE,UAAU,CAAC,OAAO,EAAE,UAAU,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAI/D,SAAS,CAAC,OAAO,EAAE,UAAU,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAIvF,OAAO,CAAC,OAAO,EAAE,UAAU,EAAE,KAAK,EAAE,KAAK,GAAG,OAAO,CAAC,IAAI,CAAC;IAIzD,SAAS,CAAC,OAAO,EAAE,UAAU,EAAE,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC;IAIpE,YAAY,CAAC,OAAO,EAAE,UAAU,EAAE,IAAI,EAAE,iBAAiB,GAAG,OAAO,CAAC,IAAI,CAAC;IAI/E,KAAK,CAAC,eAAe,EAAE,YAAY,GAAG,IAAI;IAiB1C,QAAQ,CAAC,KAAK,EAAE,YAAY,GAAG,IAAI;IAInC,QAAQ,IAAI,YAAY;CAGzB;AAED,wBAAgB,gBAAgB,CAC9B,KAAK,CAAC,EAAE,YAAY,EACpB,YAAY,CAAC,EAAE,gBAAgB,GAC9B,UAAU,CAEZ"}
+{"version":3,"file":"HookRunner.d.ts","sourceRoot":"","sources":["../../src/hooks/HookRunner.ts"],"names":[],"mappings":"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"}

package/dist/hooks/HookRunner.js

@@ -8,6 +8,10 @@ export class HookRunner {
         this.hooks = hooks;
         this.errorHandler = errorHandler ?? defaultErrorHandler;
     }
+    /** Check if a specific hook is configured. */
+    has(hookName) {
+        return Boolean(this.hooks[hookName]);
+    }
     async run(hookName, ...args) {
         const hook = this.hooks[hookName];
         if (!hook)
@@ -58,6 +62,9 @@ export class HookRunner {
     async onStreamPart(context, part) {
         await this.run('onStreamPart', context, part);
     }
+    async onSessionEnd(session, metadata) {
+        await this.run('onSessionEnd', session, metadata);
+    }
     merge(additionalHooks) {
         const hooks = this.hooks;
         for (const [key, hook] of Object.entries(additionalHooks)) {

package/dist/hooks/HookRunner.js.map

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

package/dist/hooks/builtin/metrics.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"metrics.d.ts","sourceRoot":"","sources":["../../../src/hooks/builtin/metrics.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AACzD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,sBAAsB,CAAC;AACpD,OAAO,EAAE,sBAAsB,EAAE,MAAM,kCAAkC,CAAC;AAE1E,OAAO,EAAE,OAAO,EAAE,CAAC;AAGnB,qBAAa,eAAgB,SAAQ,sBAAuB,YAAW,OAAO;CAAI;AAElF,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,OAAO,GAAG,YAAY,CAmDjE"}
+{"version":3,"file":"metrics.d.ts","sourceRoot":"","sources":["../../../src/hooks/builtin/metrics.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AACzD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,sBAAsB,CAAC;AACpD,OAAO,EAAE,sBAAsB,EAAE,MAAM,kCAAkC,CAAC;AAE1E,OAAO,EAAE,OAAO,EAAE,CAAC;AAGnB,qBAAa,eAAgB,SAAQ,sBAAuB,YAAW,OAAO;CAAI;AAElF,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,OAAO,GAAG,YAAY,CA+DjE"}

package/dist/hooks/builtin/metrics.js

@@ -44,6 +44,18 @@ export function createMetricsHooks(metrics) {
         onError: async () => {
             metrics.increment('agent.errors');
         },
+        onStreamPart: async (_context, part) => {
+            // Capture flow-level metrics emitted as custom stream events
+            if (part.type === 'custom' && typeof part.name === 'string' && part.name.startsWith('flow.')) {
+                const data = part.data;
+                if (data && typeof data.durationMs === 'number') {
+                    metrics.timing(part.name, data.durationMs);
+                }
+                else {
+                    metrics.increment(part.name);
+                }
+            }
+        },
     };
 }
 //# sourceMappingURL=metrics.js.map

package/dist/hooks/builtin/metrics.js.map

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

package/dist/hooks/builtin/observability.d.ts

@@ -0,0 +1,21 @@
+import type { HarnessHooks } from '../../types/index.js';
+import type { Metrics, SessionTrace, TraceStreamEvent } from '../../types/telemetry.js';
+export interface ObservabilityConfig {
+    /** Where to send the final SessionTrace. Default: console. */
+    exporter?: 'console' | 'json' | ((trace: SessionTrace) => Promise<void>);
+    /** Output file for `json` exporter. Default: `./.ariaflow-traces/session-<id>.json` */
+    outputPath?: string;
+    /** Include message text in span events (PII risk). Default: false. */
+    includeContent?: boolean;
+    /** Optional metrics service for timings alongside spans. */
+    metrics?: Metrics;
+    /** Service name stored on spans. */
+    serviceName?: string;
+    /**
+     * Optional live trace stream (e.g. AriaFlow Studio WebSocket). Fire-and-forget;
+     * keep handlers synchronous or schedule async work without blocking the harness.
+     */
+    traceStream?: (event: TraceStreamEvent) => void;
+}
+export declare function createObservabilityHooks(config?: ObservabilityConfig): HarnessHooks;
+//# sourceMappingURL=observability.d.ts.map

package/dist/hooks/builtin/observability.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"observability.d.ts","sourceRoot":"","sources":["../../../src/hooks/builtin/observability.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EACV,YAAY,EAMb,MAAM,sBAAsB,CAAC;AAC9B,OAAO,KAAK,EAAE,OAAO,EAAsB,YAAY,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AAE5G,MAAM,WAAW,mBAAmB;IAClC,8DAA8D;IAC9D,QAAQ,CAAC,EAAE,SAAS,GAAG,MAAM,GAAG,CAAC,CAAC,KAAK,EAAE,YAAY,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC;IACzE,uFAAuF;IACvF,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,sEAAsE;IACtE,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,4DAA4D;IAC5D,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,oCAAoC;IACpC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB;;;OAGG;IACH,WAAW,CAAC,EAAE,CAAC,KAAK,EAAE,gBAAgB,KAAK,IAAI,CAAC;CACjD;AAuJD,wBAAgB,wBAAwB,CAAC,MAAM,CAAC,EAAE,mBAAmB,GAAG,YAAY,CAmdnF"}