@kuralle-agents/core 0.2.1 → 0.3.1

package/dist/tools/effect/errors.js

@@ -0,0 +1,15 @@
+/**
+ * Thrown by `ctx.tool(...)` when a tool declared `needsApproval: true` is denied
+ * by a human (the `__approval` signal resolves with `approved: false`). Catch it
+ * inside the calling flow `action` node to route gracefully (e.g. escalate or end).
+ */
+export class ToolApprovalDeniedError extends Error {
+    toolName;
+    by;
+    constructor(toolName, by) {
+        super(`Tool "${toolName}" was denied approval${by ? ` by ${by}` : ''}`);
+        this.name = 'ToolApprovalDeniedError';
+        this.toolName = toolName;
+        this.by = by;
+    }
+}

package/dist/tools/effect/index.d.ts

@@ -4,3 +4,4 @@ export type { CoreToolExecutorConfig, CoreExecuteArgs } from './ToolExecutor.js'
 export { PairingTracker, cancelledPlaceholder, inProgressPlaceholder, } from './pairing.js';
 export type { ToolCallPair, ToolPairStatus, ToolRequestRecord, ToolResponseRecord, CancelledToolResult, InProgressToolResult, } from './pairing.js';
 export { validateAndSanitize, validateOutput, ToolValidationError } from './schema.js';
+export { ToolApprovalDeniedError } from './errors.js';

package/dist/tools/effect/index.js

@@ -2,3 +2,4 @@ export { defineTool, toolToAiSdk, buildToolSet } from './defineTool.js';
 export { CoreToolExecutor } from './ToolExecutor.js';
 export { PairingTracker, cancelledPlaceholder, inProgressPlaceholder, } from './pairing.js';
 export { validateAndSanitize, validateOutput, ToolValidationError } from './schema.js';
+export { ToolApprovalDeniedError } from './errors.js';

package/dist/tools/errorHandling.d.ts

@@ -20,7 +20,6 @@ export declare function executeWithRetry<T>(fn: () => Promise<T>, config?: {
     maxDelayMs?: number;
     onRetry?: (error: Error, attempt: number) => void;
 }): Promise<T>;
-export type CircuitState = 'CLOSED' | 'OPEN' | 'HALF_OPEN';
 export declare function createCircuitBreaker<T, Args extends unknown[]>(fn: (...args: Args) => Promise<T>, config?: {
     failureThreshold?: number;
     resetTimeoutMs?: number;

package/dist/types/channel.d.ts

@@ -27,7 +27,7 @@ export type UserSignal = {
     type: 'message';
     input: string;
 };
-export interface ToolResultRecord {
+interface ToolResultRecord {
     name: string;
     args: unknown;
     result: unknown;
@@ -41,3 +41,4 @@ export type TurnControl = {
     type: 'end';
     reason: string;
 };
+export {};

package/dist/types/flow.d.ts

@@ -5,6 +5,7 @@ import type { ContextStrategy } from './context.js';
 import type { TurnResult } from './channel.js';
 import type { ActionContext } from './run-context.js';
 import type { NodeVerify } from '../flow/verify.js';
+import type { ChoiceOption } from './selection.js';
 export type FlowState = Record<string, unknown>;
 export interface Flow {
     name: string;
@@ -42,6 +43,7 @@ export interface CollectNode {
     schema: StandardSchemaV1;
     required?: string[];
     instructions?: (missing: string[], state: FlowState) => Instructions;
+    choices?: ChoiceOption[];
     maxTurns?: number;
     onComplete: (data: unknown, state: FlowState) => Transition | Promise<Transition>;
 }
@@ -57,6 +59,7 @@ export interface DecideNode {
     id: string;
     instructions: Instructions;
     schema: StandardSchemaV1;
+    choices?: ChoiceOption[];
     decide: (data: unknown, state: FlowState) => Transition | Promise<Transition>;
 }
 export declare function reply(node: Omit<ReplyNode, 'kind'>): ReplyNode;

package/dist/types/index.d.ts

@@ -1,3 +1,4 @@
+export * from './selection.js';
 export * from './telemetry.js';
 export * from './processors.js';
 export * from './agentConfig.js';

package/dist/types/index.js

@@ -1,3 +1,4 @@
+export * from './selection.js';
 export * from './telemetry.js';
 export * from './processors.js';
 export * from './agentConfig.js';

package/dist/types/run-context.d.ts

@@ -7,6 +7,7 @@ import type { HarnessStreamPart } from './stream.js';
 import type { RefinementCapability } from '../capabilities/RefinementCapability.js';
 import type { ValidationCapability } from '../capabilities/ValidationCapability.js';
 import type { Limits } from './guardrails.js';
+import type { AnyTool } from './effectTool.js';
 export interface EffectToolExecutor {
     execute(args: {
         name: string;
@@ -14,7 +15,11 @@ export interface EffectToolExecutor {
         session: Session;
         toolCallId?: string;
         abortSignal?: AbortSignal;
+        toolCtx?: ToolContext;
+        def?: AnyTool;
     }): Promise<unknown>;
+    /** Resolve a registered tool definition by name (used to read flags like `needsApproval`). */
+    getTool?(name: string): AnyTool | undefined;
 }
 export interface AutoRetrieveProvider {
     retrieve(ctx: RunContext): Promise<string | undefined>;
@@ -46,6 +51,8 @@ export interface RunContext {
     telemetry?: TelemetrySettings;
     tool(name: string, args: unknown, options?: {
         toolCallId?: string;
+        def?: AnyTool;
+        toolCtx?: ToolContext;
     }): Promise<unknown>;
     approve(req: {
         title: string;

package/dist/types/selection.d.ts

@@ -0,0 +1,18 @@
+/** Author-facing choice option (RFC §4.5). Stable shape. */
+export interface ChoiceOption {
+    id: string;
+    label: string;
+    description?: string;
+    url?: string;
+    flow?: {
+        flowId: string;
+        cta: string;
+    };
+}
+/** A structured inbound selection propagated into a run (RFC §4.8 / REQ-20). */
+export interface ResolvedSelection {
+    /** Stable id (button/list id, template button payload) — exposed as the routing `input`. */
+    id?: string;
+    /** Flow-form submission data (e.g. WhatsApp Flow nfm_reply) merged into flow state at turn start. */
+    formData?: Record<string, unknown>;
+}

package/dist/types/selection.js

@@ -0,0 +1 @@
+export {};

package/dist/types/stream.d.ts

@@ -1,4 +1,10 @@
 import type { ConversationOutcome } from '../outcomes/types.js';
+import type { ChoiceOption } from './selection.js';
+/**
+ * Authoritative runtime stream union (`runFlow` / `Runtime` emit).
+ * `types/voice.ts` defines a separate voice/realtime union that intentionally
+ * does not include `{ type: 'interactive' }`.
+ */
 export type HarnessStreamPart = {
     type: 'text-delta';
     text: string;
@@ -43,6 +49,11 @@ export type HarnessStreamPart = {
 } | {
     type: 'conversation-outcome';
     outcome: ConversationOutcome;
+} | {
+    type: 'interactive';
+    nodeId: string;
+    options: ChoiceOption[];
+    prompt: string;
 } | {
     type: 'turn-end';
 } | {

package/package.json

@@ -1,6 +1,12 @@
 {
   "name": "@kuralle-agents/core",
-  "version": "0.2.1",
+  "license": "Apache-2.0",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/kuralle/kuralle-agents.git",
+    "directory": "packages/kuralle-core"
+  },
+  "version": "0.3.1",
   "description": "A framework for structured conversational AI agents",
   "publishConfig": {
     "access": "public"
@@ -84,22 +90,24 @@
     "zod": "^3.0.0"
   },
   "devDependencies": {
-    "@kuralle-agents/realtime-audio": "workspace:*",
     "@ai-sdk/openai": "^3.0.0",
     "@types/node": "^20.11.0",
     "ai": "^6.0.0",
     "bun-types": "^1.3.0",
     "dotenv": "^16.4.0",
-    "tsx": "^4.7.0",
     "typescript": "^5.3.0",
-    "zod": "^3.23.0"
+    "zod": "^3.23.0",
+    "@kuralle-agents/realtime-audio": "0.3.1"
+  },
+  "dependencies": {
+    "chrono-node": "^2.6.0",
+    "zod-to-json-schema": "^3.24.0"
   },
   "scripts": {
     "prebuild": "rm -rf dist",
     "build": "tsc -p tsconfig.json",
     "typecheck:examples": "tsc --noEmit -p tsconfig.examples.json",
     "clean": "rm -rf dist",
-    "prepublishOnly": "npm run clean && npm run build",
     "test": "bun test test",
     "smoke:textdriver": "bun test ./test/core-channel/textdriver.smoke.ts",
     "smoke:flow": "bun test ./test/core-flow/flow.smoke.ts",
@@ -107,9 +115,5 @@
     "smoke:approval": "bun test ./test/core-policy/approval.smoke.ts",
     "smoke:knowledge": "bun test ./test/core-grounding/knowledge.smoke.ts",
     "smoke:realtime": "bun test ./test/core-voice/realtime.smoke.ts"
-  },
-  "dependencies": {
-    "chrono-node": "^2.6.0",
-    "zod-to-json-schema": "^3.24.0"
   }
-}
+}

package/dist/events/index.d.ts

@@ -1,2 +0,0 @@
-export { createEventBus, createTurnHandle } from './TurnHandle.js';
-export type { EventBus, TurnHandleOptions } from './TurnHandle.js';

package/dist/events/index.js

@@ -1 +0,0 @@
-export { createEventBus, createTurnHandle } from './TurnHandle.js';

package/dist/flow/index.d.ts

@@ -1,10 +0,0 @@
-export { classifyControl } from './classifyControl.js';
-export { buildNodePrompt, buildNodeTools, resolveReplyNode, resolveCollectExtractionNode, resolveInstructions, } from './nodeBuilders.js';
-export { isReplyNode, isCollectNode, isActionNode, isDecideNode } from './nodeKinds.js';
-export { normalizeTransition, resolveNodeRef, isFlowNode, type NormalizedTransition, } from './normalizeTransition.js';
-export { reduceTransition, type ReduceTransitionInput } from './reduceTransition.js';
-export { applyContextStrategy, resolveContextStrategy } from './contextStrategy.js';
-export { runNodeVerify, VerifyBlockedError, type NodeVerify, type VerifyInput } from './verify.js';
-export { collectUntilComplete } from './collectUntilComplete.js';
-export { collectDataKey, collectTurnsKey, computeMissingFields, createExtractionSubmitTool, getCollectData, mergeExtractionData, mergeTurnExtraction, projectCollectData, schemaSatisfied, submitToolName, } from './extraction.js';
-export { runFlow, buildNodeRegistry, resolveStartNode, FlowOscillationError, type FlowResult, } from './runFlow.js';

package/dist/flow/index.js

@@ -1,10 +0,0 @@
-export { classifyControl } from './classifyControl.js';
-export { buildNodePrompt, buildNodeTools, resolveReplyNode, resolveCollectExtractionNode, resolveInstructions, } from './nodeBuilders.js';
-export { isReplyNode, isCollectNode, isActionNode, isDecideNode } from './nodeKinds.js';
-export { normalizeTransition, resolveNodeRef, isFlowNode, } from './normalizeTransition.js';
-export { reduceTransition } from './reduceTransition.js';
-export { applyContextStrategy, resolveContextStrategy } from './contextStrategy.js';
-export { runNodeVerify, VerifyBlockedError } from './verify.js';
-export { collectUntilComplete } from './collectUntilComplete.js';
-export { collectDataKey, collectTurnsKey, computeMissingFields, createExtractionSubmitTool, getCollectData, mergeExtractionData, mergeTurnExtraction, projectCollectData, schemaSatisfied, submitToolName, } from './extraction.js';
-export { runFlow, buildNodeRegistry, resolveStartNode, FlowOscillationError, } from './runFlow.js';

package/dist/runtime/SessionEventManager.d.ts

@@ -1,16 +0,0 @@
-import { HarnessStreamPart, RunContext, Session } from '../types/index.js';
-export declare class SessionEventManager {
-    private helpers;
-    private assistantTextKey;
-    private readonly runtimeEventLogKey;
-    private readonly runtimeEventLogMaxEntries;
-    constructor(helpers: {
-        touchSession: (session: Session) => void;
-        getSessionTurn: (session: Session) => number;
-    });
-    private appendRuntimeEvent;
-    private toEventLogValue;
-    private flushAssistantFinalEvent;
-    recordRuntimeEvent(context: RunContext, part: HarnessStreamPart): void;
-    cleanupSession(session: Session): void;
-}

package/dist/runtime/SessionEventManager.js

@@ -1,148 +0,0 @@
-import crypto from 'node:crypto';
-import { isRecord } from '../utils/isRecord.js';
-export class SessionEventManager {
-    helpers;
-    assistantTextKey = '__ariaAssistantText';
-    runtimeEventLogKey = 'runtimeEventLog';
-    runtimeEventLogMaxEntries = 2000;
-    constructor(helpers) {
-        this.helpers = helpers;
-    }
-    appendRuntimeEvent(context, entry) {
-        const key = this.runtimeEventLogKey;
-        const current = context.session.workingMemory[key];
-        const events = Array.isArray(current) ? [...current] : [];
-        events.push(entry);
-        const overflow = events.length - this.runtimeEventLogMaxEntries;
-        if (overflow > 0) {
-            events.splice(0, overflow);
-        }
-        context.session.workingMemory[key] = events;
-        this.helpers.touchSession(context.session);
-    }
-    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;
-    }
-    flushAssistantFinalEvent(context, trigger) {
-        const textRaw = context.session.workingMemory[this.assistantTextKey];
-        const text = (typeof textRaw === 'string' ? textRaw : '').trim();
-        if (text.length > 0) {
-            this.appendRuntimeEvent(context, {
-                id: crypto.randomUUID(),
-                sessionId: context.session.id,
-                agentId: context.agentId,
-                turn: this.helpers.getSessionTurn(context.session),
-                type: 'assistant_final',
-                trigger,
-                text,
-                timestamp: new Date().toISOString(),
-            });
-        }
-        delete context.session.workingMemory[this.assistantTextKey];
-    }
-    recordRuntimeEvent(context, part) {
-        const base = {
-            id: crypto.randomUUID(),
-            sessionId: context.session.id,
-            agentId: context.agentId,
-            turn: this.helpers.getSessionTurn(context.session),
-            timestamp: new Date().toISOString(),
-        };
-        switch (part.type) {
-            case 'text-delta': {
-                const prevRaw = context.session.workingMemory[this.assistantTextKey];
-                const prev = typeof prevRaw === 'string' ? prevRaw : '';
-                context.session.workingMemory[this.assistantTextKey] = prev + part.text;
-                return;
-            }
-            case 'input':
-                this.appendRuntimeEvent(context, { ...base, type: 'user', text: part.text, userId: part.userId });
-                return;
-            case 'tool-call':
-                this.appendRuntimeEvent(context, {
-                    ...base,
-                    type: 'tool_call',
-                    toolCallId: part.toolCallId,
-                    toolName: part.toolName,
-                    args: this.toEventLogValue(part.args),
-                });
-                return;
-            case 'tool-result':
-                this.appendRuntimeEvent(context, {
-                    ...base,
-                    type: 'tool_result',
-                    toolCallId: part.toolCallId,
-                    toolName: part.toolName,
-                    result: this.toEventLogValue(part.result),
-                });
-                return;
-            case 'tool-error':
-                this.appendRuntimeEvent(context, {
-                    ...base,
-                    type: 'tool_error',
-                    toolCallId: part.toolCallId,
-                    toolName: part.toolName,
-                    error: part.error,
-                });
-                return;
-            case 'flow-transition':
-                this.appendRuntimeEvent(context, {
-                    ...base,
-                    type: 'transition',
-                    kind: 'flow',
-                    from: part.from,
-                    to: part.to,
-                });
-                return;
-            case 'handoff':
-                this.appendRuntimeEvent(context, {
-                    ...base,
-                    type: 'transition',
-                    kind: 'handoff',
-                    from: part.from,
-                    to: part.to,
-                    reason: part.reason,
-                });
-                return;
-            case 'turn-end':
-                this.flushAssistantFinalEvent(context, 'turn-end');
-                return;
-            case 'done':
-                this.flushAssistantFinalEvent(context, 'done');
-                return;
-            case 'error':
-                this.flushAssistantFinalEvent(context, 'error');
-                return;
-            default:
-                return;
-        }
-    }
-    cleanupSession(session) {
-        delete session.workingMemory[this.assistantTextKey];
-    }
-}

package/dist/runtime/durable/index.d.ts

@@ -1,5 +0,0 @@
-export * from './types.js';
-export * from './RunStore.js';
-export * from './SessionRunStore.js';
-export * from './idempotency.js';
-export * from './replay.js';

package/dist/runtime/durable/index.js

@@ -1,5 +0,0 @@
-export * from './types.js';
-export * from './RunStore.js';
-export * from './SessionRunStore.js';
-export * from './idempotency.js';
-export * from './replay.js';

package/dist/runtime/policies/index.d.ts

@@ -1,3 +0,0 @@
-export { applyPreTurnPolicies, applyPostTurnPolicies, buildRefinementPolicies, buildValidationPolicies, } from './agentTurn.js';
-export { assertWithinTurnLimit, incrementTurnCount, LimitsExceededError, readTurnCount, resolveMaxSteps, } from './limits.js';
-export { resolveAgentPolicies, withEnforcementRules, withValidationPolicies, type ResolvedAgentPolicies, } from './resolvePolicies.js';

package/dist/runtime/policies/index.js

@@ -1,3 +0,0 @@
-export { applyPreTurnPolicies, applyPostTurnPolicies, buildRefinementPolicies, buildValidationPolicies, } from './agentTurn.js';
-export { assertWithinTurnLimit, incrementTurnCount, LimitsExceededError, readTurnCount, resolveMaxSteps, } from './limits.js';
-export { resolveAgentPolicies, withEnforcementRules, withValidationPolicies, } from './resolvePolicies.js';

package/dist/runtime/tokenSessionUtils.d.ts

@@ -1,5 +0,0 @@
-import type { Session } from '../types/index.js';
-import { ContextBudget, type ContextBudgetConfig } from './ContextBudget.js';
-import { TokenAccumulator } from './TokenAccumulator.js';
-export declare function getOrCreateTokenAccumulator(session: Session, modelContextWindow?: number): TokenAccumulator;
-export declare function getOrCreateContextBudgetValidator(session: Session, partial?: Partial<ContextBudgetConfig>): ContextBudget;

package/dist/runtime/tokenSessionUtils.js

@@ -1,24 +0,0 @@
-import { ContextBudget, DEFAULT_CONTEXT_BUDGET } from './ContextBudget.js';
-import { TokenAccumulator } from './TokenAccumulator.js';
-const ACC_KEY = '__ariaTokenAccumulator';
-const BUDGET_KEY = '__ariaContextBudgetValidator';
-export function getOrCreateTokenAccumulator(session, modelContextWindow) {
-    const existing = session.workingMemory[ACC_KEY];
-    if (existing instanceof TokenAccumulator) {
-        return existing;
-    }
-    const w = modelContextWindow ?? DEFAULT_CONTEXT_BUDGET.modelContextWindow;
-    const acc = new TokenAccumulator(w);
-    session.workingMemory[ACC_KEY] = acc;
-    return acc;
-}
-export function getOrCreateContextBudgetValidator(session, partial) {
-    const existing = session.workingMemory[BUDGET_KEY];
-    if (existing instanceof ContextBudget) {
-        return existing;
-    }
-    const cfg = { ...DEFAULT_CONTEXT_BUDGET, ...partial };
-    const inst = new ContextBudget(cfg);
-    session.workingMemory[BUDGET_KEY] = inst;
-    return inst;
-}

package/dist/tools/transferToTriage.d.ts

@@ -1,15 +0,0 @@
-import type { ToolSet } from 'ai';
-import type { ToolDeclaration } from '../capabilities/index.js';
-export declare function createTransferToTriageAISDKTool(triageAgentId: string, specialistScope?: string): ToolSet[string];
-type TransferToTriageArgs = {
-    reason: string;
-};
-type TransferToTriageResult = {
-    __handoff: true;
-    targetAgentId: string;
-    targetAgent: string;
-    reason: string;
-};
-export declare function createTransferToTriageDeclaration(triageAgentId: string, specialistScope?: string): ToolDeclaration<TransferToTriageArgs, TransferToTriageResult>;
-export declare function shouldInjectTransferToTriage(triageAgentId: string | undefined, retriagePolicy: 'never' | 'on-handoff-tool' | undefined, specialistAgentId: string, triageAgentExists: boolean, isTriageSpecialist: boolean): boolean;
-export {};

package/dist/tools/transferToTriage.js

@@ -1,48 +0,0 @@
-import { tool } from 'ai';
-import { z } from 'zod';
-const BASE_DESCRIPTION = "Call this tool when the user's request is outside your area of expertise or when they explicitly ask to be transferred.";
-function buildTransferDescription(specialistScope) {
-    if (!specialistScope?.trim()) {
-        return BASE_DESCRIPTION;
-    }
-    const scope = specialistScope.trim();
-    return `Call this tool ONLY when the user's request does NOT match any of these topics: ${scope}. If the request IS about one of these topics, handle it yourself. If the user explicitly asks to be transferred, you may still call this tool.`;
-}
-export function createTransferToTriageAISDKTool(triageAgentId, specialistScope) {
-    return tool({
-        description: buildTransferDescription(specialistScope),
-        inputSchema: z.object({
-            reason: z.string().describe('Why you are escalating to the routing agent'),
-        }),
-        execute: async ({ reason }) => ({
-            __handoff: true,
-            targetAgentId: triageAgentId,
-            targetAgent: triageAgentId,
-            reason,
-        }),
-    });
-}
-export function createTransferToTriageDeclaration(triageAgentId, specialistScope) {
-    return {
-        name: 'transfer_to_triage',
-        description: buildTransferDescription(specialistScope),
-        parameters: z.object({
-            reason: z.string().describe('Why you are escalating to the routing agent'),
-        }),
-        execute: async (args) => ({
-            __handoff: true,
-            targetAgentId: triageAgentId,
-            targetAgent: triageAgentId,
-            reason: args.reason,
-        }),
-    };
-}
-export function shouldInjectTransferToTriage(triageAgentId, retriagePolicy, specialistAgentId, triageAgentExists, isTriageSpecialist) {
-    if (retriagePolicy !== 'on-handoff-tool' || !triageAgentId) {
-        return false;
-    }
-    if (!triageAgentExists || specialistAgentId === triageAgentId || isTriageSpecialist) {
-        return false;
-    }
-    return true;
-}

package/dist/utils/aiStream.d.ts

@@ -1,6 +0,0 @@
-import type { AgentStreamPart } from '../types/index.js';
-/**
- * Processes a stream from the AI SDK and yields canonical AgentStreamParts.
- * Shared stream-iteration helper for model calls.
- */
-export declare function processAIStream(stream: AsyncIterable<unknown>): AsyncGenerator<AgentStreamPart>;

package/dist/utils/aiStream.js

@@ -1,48 +0,0 @@
-import { getChunkArgs, getChunkResult, getChunkToolCallId, getChunkErrorMessage } from './streamChunk.js';
-import { isHandoffResult } from '../tools/handoff.js';
-function asAIStreamChunk(value) {
-    if (typeof value !== 'object' || value === null)
-        return null;
-    return value;
-}
-/**
- * Processes a stream from the AI SDK and yields canonical AgentStreamParts.
- * Shared stream-iteration helper for model calls.
- */
-export async function* processAIStream(stream) {
-    for await (const raw of stream) {
-        const chunk = asAIStreamChunk(raw);
-        if (!chunk)
-            continue;
-        if (chunk.type === 'text-delta' && typeof chunk.text === 'string') {
-            yield { type: 'text-delta', text: chunk.text };
-        }
-        if (chunk.type === 'tool-call' && chunk.toolName) {
-            const args = getChunkArgs(chunk);
-            const toolCallId = getChunkToolCallId(chunk);
-            yield { type: 'tool-call', toolName: chunk.toolName, args, toolCallId };
-        }
-        if (chunk.type === 'tool-result' && chunk.toolName) {
-            const toolResult = getChunkResult(chunk);
-            const toolCallId = getChunkToolCallId(chunk);
-            yield { type: 'tool-result', toolName: chunk.toolName, result: toolResult, toolCallId };
-            if (isHandoffResult(toolResult)) {
-                const targetAgent = toolResult.targetAgent ?? toolResult.targetAgentId;
-                yield {
-                    type: 'handoff',
-                    targetAgent,
-                    reason: toolResult.reason,
-                };
-            }
-        }
-        if (chunk.type === 'tool-error' && chunk.toolName) {
-            const toolCallId = getChunkToolCallId(chunk);
-            const error = getChunkErrorMessage(chunk);
-            yield { type: 'tool-error', toolName: chunk.toolName, error, toolCallId };
-        }
-        if (chunk.type === 'error') {
-            const error = getChunkErrorMessage(chunk);
-            yield { type: 'error', error };
-        }
-    }
-}

package/dist/utils/streamChunk.d.ts

@@ -1,4 +0,0 @@
-export declare function getChunkArgs(chunk: unknown): unknown;
-export declare function getChunkResult(chunk: unknown): unknown;
-export declare function getChunkToolCallId(chunk: unknown): string | undefined;
-export declare function getChunkErrorMessage(chunk: unknown): string;

package/dist/utils/streamChunk.js

@@ -1,49 +0,0 @@
-export function getChunkArgs(chunk) {
-    if (!chunk || typeof chunk !== 'object') {
-        return undefined;
-    }
-    const record = chunk;
-    if ('args' in record) {
-        return record.args;
-    }
-    if ('input' in record) {
-        return record.input;
-    }
-    return undefined;
-}
-export function getChunkResult(chunk) {
-    if (!chunk || typeof chunk !== 'object') {
-        return undefined;
-    }
-    const record = chunk;
-    if ('result' in record) {
-        return record.result;
-    }
-    if ('output' in record) {
-        return record.output;
-    }
-    return undefined;
-}
-export function getChunkToolCallId(chunk) {
-    if (!chunk || typeof chunk !== 'object') {
-        return undefined;
-    }
-    const value = chunk.toolCallId;
-    return typeof value === 'string' ? value : undefined;
-}
-export function getChunkErrorMessage(chunk) {
-    if (!chunk || typeof chunk !== 'object') {
-        return 'Tool execution error';
-    }
-    const value = chunk.error;
-    if (typeof value === 'string') {
-        return value;
-    }
-    if (value && typeof value === 'object' && 'message' in value) {
-        const msg = value.message;
-        if (typeof msg === 'string') {
-            return msg;
-        }
-    }
-    return 'Tool execution error';
-}