@juspay/neurolink 9.54.3 → 9.54.5

package/dist/server/streaming/dataStream.d.ts

@@ -3,106 +3,11 @@
  * Implements a protocol for streaming structured data between server and client
  * Compatible with AI SDK's data stream format
  */
-import type { DataStreamWriter } from "../types.js";
-import type { CloseHandler } from "../../types/index.js";
-/**
- * Data stream event types
- */
-export type DataStreamEventType = "text-start" | "text-delta" | "text-end" | "tool-call" | "tool-result" | "data" | "error" | "finish";
-/**
- * Base data stream event
- */
-export type DataStreamEvent = {
-    type: DataStreamEventType;
-    id?: string;
-    timestamp: number;
-    data: unknown;
-};
-/**
- * Text start event
- */
-export type TextStartEvent = DataStreamEvent & {
-    type: "text-start";
-    data: {
-        id: string;
-    };
-};
-/**
- * Text delta event
- */
-export type TextDeltaEvent = DataStreamEvent & {
-    type: "text-delta";
-    data: {
-        id: string;
-        delta: string;
-    };
-};
-/**
- * Text end event
- */
-export type TextEndEvent = DataStreamEvent & {
-    type: "text-end";
-    data: {
-        id: string;
-    };
-};
-/**
- * Tool call event
- */
-export type ToolCallEvent = DataStreamEvent & {
-    type: "tool-call";
-    data: {
-        id: string;
-        name: string;
-        arguments: Record<string, unknown>;
-    };
-};
-/**
- * Tool result event
- */
-export type ToolResultEvent = DataStreamEvent & {
-    type: "tool-result";
-    data: {
-        id: string;
-        name: string;
-        result: unknown;
-    };
-};
-/**
- * Data event (arbitrary data)
- */
-export type DataEvent = DataStreamEvent & {
-    type: "data";
-    data: unknown;
-};
-/**
- * Error event
- */
-export type ErrorEvent = DataStreamEvent & {
-    type: "error";
-    data: {
-        message: string;
-        code?: string;
-    };
-};
-/**
- * Finish event
- */
-export type FinishEvent = DataStreamEvent & {
-    type: "finish";
-    data: {
-        reason?: string;
-        usage?: {
-            input: number;
-            output: number;
-            total: number;
-        };
-    };
-};
+import type { DataStreamWriter, CloseHandler } from "../../types/index.js";
 /**
  * Configuration for DataStreamWriter
  */
-export type DataStreamWriterConfig = {
+type DataStreamWriterConfig = {
     /** Writer function to send data */
     write: (chunk: string) => void | Promise<void>;
     /** Function to close the stream */
@@ -119,7 +24,7 @@ export declare function createDataStreamWriter(config: DataStreamWriterConfig):
 /**
  * Configuration for DataStreamResponse
  */
-export type DataStreamResponseConfig = {
+type DataStreamResponseConfig = {
     /** Content type header */
     contentType?: "text/event-stream" | "application/x-ndjson";
     /** Initial headers */
@@ -231,7 +136,7 @@ export declare function createNDJSONHeaders(additionalHeaders?: Record<string, s
 /**
  * SSE Event options for formatSSEEvent
  */
-export type SSEEventOptions = {
+type SSEEventOptions = {
     /** Event type (optional) */
     event?: string;
     /** Event data (required) */
@@ -338,3 +243,4 @@ export declare class WebStreamWriter extends BaseDataStreamWriter {
     writeEvent(eventType: string, data: unknown): void;
     protected doClose(): void;
 }
+export {};

package/dist/server/streaming/index.d.ts

@@ -2,4 +2,4 @@
  * Streaming Module
  * Exports for data stream protocol and streaming utilities
  */
-export { type DataStreamEventType, type DataStreamEvent, type TextStartEvent, type TextDeltaEvent, type TextEndEvent, type ToolCallEvent, type ToolResultEvent, type DataEvent, type ErrorEvent, type FinishEvent, type SSEEventOptions, type DataStreamWriterConfig, createDataStreamWriter, type DataStreamResponseConfig, DataStreamResponse, createDataStreamResponse, pipeAsyncIterableToDataStream, createSSEHeaders, createNDJSONHeaders, formatSSEEvent, BaseDataStreamWriter, WebStreamWriter, } from "./dataStream.js";
+export { createDataStreamWriter, DataStreamResponse, createDataStreamResponse, pipeAsyncIterableToDataStream, createSSEHeaders, createNDJSONHeaders, formatSSEEvent, BaseDataStreamWriter, WebStreamWriter, } from "./dataStream.js";

package/dist/server/streaming/index.js

@@ -2,7 +2,12 @@
  * Streaming Module
  * Exports for data stream protocol and streaming utilities
  */
-export { createDataStreamWriter, DataStreamResponse, createDataStreamResponse, 
+export { 
+// Types
+// Writer
+createDataStreamWriter, 
+// Response
+DataStreamResponse, createDataStreamResponse, 
 // Helpers
 pipeAsyncIterableToDataStream, createSSEHeaders, createNDJSONHeaders, 
 // SSE Event Formatting

package/dist/server/utils/redaction.d.ts

@@ -1,11 +1,4 @@
-/**
- * Stream Chunk Redaction Utilities
- * Sanitizes sensitive data from stream chunks before client delivery
- *
- * NOTE: Redaction is DISABLED by default. Enable via config.enabled = true
- */
-import type { DataStreamEvent } from "../streaming/dataStream.js";
-import type { RedactionConfig } from "../types.js";
+import type { RedactionConfig, DataStreamEvent } from "../../types/index.js";
 /**
  * Redact sensitive data from a stream chunk.
  *

package/dist/server/utils/redaction.js

@@ -1,9 +1,3 @@
-/**
- * Stream Chunk Redaction Utilities
- * Sanitizes sensitive data from stream chunks before client delivery
- *
- * NOTE: Redaction is DISABLED by default. Enable via config.enabled = true
- */
 /**
  * Default fields to redact from stream chunks
  */

package/dist/server/utils/validation.d.ts

@@ -3,6 +3,7 @@
  * Provides Zod schemas and validation helpers for server routes
  */
 import { z } from "zod";
+import type { ErrorResponse, ServerValidationResult } from "../../types/index.js";
 /**
  * Agent execute request schema
  */
@@ -98,21 +99,6 @@ export declare const EmbedManyRequestSchema: z.ZodObject<{
     provider: z.ZodOptional<z.ZodString>;
     model: z.ZodOptional<z.ZodString>;
 }, z.core.$strip>;
-/**
- * Standardized error response format
- */
-export type ErrorResponse = {
-    error: {
-        code: string;
-        message: string;
-        details?: unknown;
-    };
-    metadata?: {
-        timestamp: string;
-        requestId?: string;
-    };
-    httpStatus?: number;
-};
 /**
  * Type guard to check if a value is an ErrorResponse
  */
@@ -121,27 +107,15 @@ export declare function isErrorResponse(value: unknown): value is ErrorResponse;
  * Create a standardized error response
  */
 export declare function createErrorResponse(code: string, message: string, details?: unknown, requestId?: string, httpStatus?: number): ErrorResponse;
-/**
- * Validation result type
- */
-export type ValidationResult<T> = {
-    success: true;
-    data: T;
-    error?: undefined;
-} | {
-    success: false;
-    error: ErrorResponse;
-    data?: undefined;
-};
 /**
  * Validate request body against a Zod schema
  */
-export declare function validateRequest<T>(schema: z.ZodSchema<T>, data: unknown, requestId?: string): ValidationResult<T>;
+export declare function validateRequest<T>(schema: z.ZodSchema<T>, data: unknown, requestId?: string): ServerValidationResult<T>;
 /**
  * Validate query parameters against a Zod schema
  */
-export declare function validateQuery<T>(schema: z.ZodSchema<T>, query: Record<string, string>, requestId?: string): ValidationResult<T>;
+export declare function validateQuery<T>(schema: z.ZodSchema<T>, query: Record<string, string>, requestId?: string): ServerValidationResult<T>;
 /**
  * Validate path parameters against a Zod schema
  */
-export declare function validateParams<T>(schema: z.ZodSchema<T>, params: Record<string, string>, requestId?: string): ValidationResult<T>;
+export declare function validateParams<T>(schema: z.ZodSchema<T>, params: Record<string, string>, requestId?: string): ServerValidationResult<T>;

package/dist/server/utils/validation.js

@@ -127,6 +127,9 @@ export const EmbedManyRequestSchema = z.object({
     provider: z.string().optional(),
     model: z.string().optional(),
 });
+// ============================================
+// Error Response Type Guards / Helpers
+// ============================================
 /**
  * Type guard to check if a value is an ErrorResponse
  */

package/dist/server/voice/frameBus.d.ts

@@ -1,4 +1,4 @@
-import type { Frame } from "./types.js";
+import type { Frame } from "../../types/index.js";
 export declare class FrameBus {
     private handlers;
     subscribe<T extends Frame["type"]>(type: T, fn: (frame: Extract<Frame, {

package/dist/server/voice/voiceWebSocketHandler.d.ts

@@ -4,8 +4,4 @@ import type { Server as HttpServer } from "http";
  * so the env change is scoped to voice mode only.
  */
 export declare function configureVoiceServerEnvironment(): void;
-export type Message = {
-    role: "system" | "user" | "assistant";
-    content: string;
-};
 export declare function setupWebSocket(server: HttpServer): void;

package/dist/server/websocket/WebSocketHandler.d.ts

@@ -4,7 +4,7 @@
  * Provides cross-framework WebSocket handling for real-time AI interactions.
  * Supports connection management, message routing, and graceful shutdown.
  */
-import type { WebSocketConfig, WebSocketHandler as IWebSocketHandler, WebSocketConnection, WebSocketMessage, AuthenticatedUser } from "../types.js";
+import type { WebSocketConfig, WebSocketHandler as IWebSocketHandler, WebSocketConnection, WebSocketMessage, AuthenticatedUser } from "../../types/index.js";
 /**
  * WebSocket connection manager
  */

package/dist/services/server/ai/observability/instrumentation.d.ts

@@ -11,69 +11,7 @@ import { trace } from "@opentelemetry/api";
 import { LoggerProvider } from "@opentelemetry/sdk-logs";
 import { type SpanProcessor } from "@opentelemetry/sdk-trace-base";
 import { NodeTracerProvider } from "@opentelemetry/sdk-trace-node";
-import type { LangfuseConfig } from "../../../../types/observability.js";
-/**
- * Extended context for Langfuse spans
- * Supports all Langfuse trace attributes for rich observability
- */
-export type LangfuseContext = {
-    userId?: string | null;
-    sessionId?: string | null;
-    /** Conversation/thread identifier for grouping related traces */
-    conversationId?: string | null;
-    /** Request identifier for correlating with application logs */
-    requestId?: string | null;
-    /** Custom trace name for better organization in Langfuse UI */
-    traceName?: string | null;
-    /** Custom metadata to attach to spans */
-    metadata?: Record<string, unknown> | null;
-    /**
-     * Explicit operation name (e.g., "ai.streamText", "chat", "embeddings")
-     *
-     * If set, this overrides auto-detection from the span name.
-     * Use this when you want a custom operation name that doesn't match
-     * the auto-detected Vercel AI SDK operation.
-     *
-     * @example
-     * await setLangfuseContext({
-     *   userId: "user@email.com",
-     *   operationName: "customer-support-chat"
-     * }, async () => {
-     *   // Trace name: "user@email.com:customer-support-chat"
-     * });
-     */
-    operationName?: string | null;
-    /**
-     * Override global autoDetectOperationName setting for this context.
-     *
-     * When undefined, uses the global setting from LangfuseConfig.
-     * Set to false to disable auto-detection for this specific context.
-     *
-     * @default undefined (uses global setting, which defaults to true)
-     */
-    autoDetectOperationName?: boolean;
-    /**
-     * Custom attributes to set on all spans within this context.
-     *
-     * These attributes are propagated to every span created within the
-     * AsyncLocalStorage context, enabling application-level context
-     * (e.g., Slack channel name, feature flag, tenant ID) to appear
-     * on all SDK-internal spans.
-     *
-     * @example
-     * await setLangfuseContext({
-     *   userId: "user@email.com",
-     *   customAttributes: {
-     *     "app.slack.channel": "engineering",
-     *     "app.tenant.id": "tenant-123",
-     *     "app.feature.flag": true,
-     *   }
-     * }, async () => {
-     *   // All spans created here will have these attributes
-     * });
-     */
-    customAttributes?: Record<string, string | number | boolean>;
-};
+import type { LangfuseConfig, LangfuseContext } from "../../../../types/index.js";
 /**
  * Initialize OpenTelemetry with Langfuse span processor
  *

package/dist/session/globalSessionState.d.ts

@@ -1,5 +1,5 @@
 import { NeuroLink } from "../neurolink.js";
-import type { ConversationMemoryConfig } from "../types/conversation.js";
+import type { ConversationMemoryConfig } from "../types/index.js";
 type SessionVariableValue = string | number | boolean;
 type LoopSessionState = {
     neurolinkInstance: NeuroLink;

package/dist/tasks/autoresearchTaskExecutor.d.ts

@@ -12,8 +12,7 @@
  * Workers are cached by tag to avoid re-initialization on each tick.
  * Forwards the NeuroLink emitter to each worker for lifecycle events.
  */
-import type { AutoresearchEmitter } from "../types/autoresearchTypes.js";
-import type { NeuroLinkExecutable, Task, TaskRunResult } from "../types/taskTypes.js";
+import type { AutoresearchEmitter, NeuroLinkExecutable, Task, TaskRunResult } from "../types/index.js";
 /**
  * Clear all cached workers. Called by TaskManager.shutdown().
  */

package/dist/tasks/backends/bullmqBackend.d.ts

@@ -6,7 +6,7 @@
  * - One-shot tasks → BullMQ delayed jobs
  * - Survives process restarts (Redis-persisted)
  */
-import { type Task, type TaskBackend, type TaskExecutorFn, type TaskManagerConfig } from "../../types/taskTypes.js";
+import { type Task, type TaskBackend, type TaskExecutorFn, type TaskManagerConfig } from "../../types/index.js";
 export declare class BullMQBackend implements TaskBackend {
     readonly name = "bullmq";
     private queue;

package/dist/tasks/backends/bullmqBackend.js

@@ -9,7 +9,7 @@
 import { Queue, Worker } from "bullmq";
 import { logger } from "../../utils/logger.js";
 import { TaskError } from "../errors.js";
-import { TASK_DEFAULTS, } from "../../types/taskTypes.js";
+import { TASK_DEFAULTS, } from "../../types/index.js";
 const QUEUE_NAME = "neurolink-tasks";
 export class BullMQBackend {
     name = "bullmq";

package/dist/tasks/backends/nodeTimeoutBackend.d.ts

@@ -6,7 +6,7 @@
  * - One-shot tasks → setTimeout
  * - All timers are in-process — lost on restart
  */
-import { type Task, type TaskBackend, type TaskExecutorFn, type TaskManagerConfig } from "../../types/taskTypes.js";
+import { type Task, type TaskBackend, type TaskExecutorFn, type TaskManagerConfig } from "../../types/index.js";
 export declare class NodeTimeoutBackend implements TaskBackend {
     readonly name = "node-timeout";
     private scheduled;

package/dist/tasks/backends/nodeTimeoutBackend.js

@@ -8,7 +8,7 @@
  */
 import { Cron } from "croner";
 import { logger } from "../../utils/logger.js";
-import { TASK_DEFAULTS, } from "../../types/taskTypes.js";
+import { TASK_DEFAULTS, } from "../../types/index.js";
 export class NodeTimeoutBackend {
     name = "node-timeout";
     scheduled = new Map();

package/dist/tasks/backends/taskBackendRegistry.d.ts

@@ -2,7 +2,7 @@
  * TaskBackendRegistry — registration point for all task backend implementations.
  * Follows the same pattern as ProviderRegistry: dynamic imports, lazy registration.
  */
-import type { TaskBackendName, TaskBackendFactoryFn, TaskManagerConfig, TaskBackend } from "../../types/taskTypes.js";
+import type { TaskBackendName, TaskBackendFactoryFn, TaskManagerConfig, TaskBackend } from "../../types/index.js";
 export declare class TaskBackendRegistry {
     private static factories;
     private static registered;

package/dist/tasks/store/fileTaskStore.d.ts

@@ -7,7 +7,7 @@
  *   {logsPath}/{taskId}.jsonl       — run log per task (append-only)
  *   Continuation history is in-memory only (lost on restart).
  */
-import { type Task, type TaskStatus, type TaskRunResult, type TaskStore, type TaskManagerConfig, type ConversationEntry } from "../../types/taskTypes.js";
+import { type Task, type TaskStatus, type TaskRunResult, type TaskStore, type TaskManagerConfig, type ConversationEntry } from "../../types/index.js";
 export declare class FileTaskStore implements TaskStore {
     readonly type: "file";
     private storePath;

package/dist/tasks/store/fileTaskStore.js

@@ -12,7 +12,7 @@ import { appendFile, readFile, rename, unlink, writeFile, } from "node:fs/promis
 import { dirname, join } from "node:path";
 import { logger } from "../../utils/logger.js";
 import { TaskError } from "../errors.js";
-import { TASK_DEFAULTS, } from "../../types/taskTypes.js";
+import { TASK_DEFAULTS, } from "../../types/index.js";
 export class FileTaskStore {
     type = "file";
     storePath;

package/dist/tasks/store/redisTaskStore.d.ts

@@ -7,7 +7,7 @@
  *   neurolink:task:{id}:runs     (List)  — run log entries (newest first)
  *   neurolink:task:{id}:history  (List)  — continuation mode conversation history
  */
-import { type Task, type TaskStatus, type TaskRunResult, type TaskStore, type TaskManagerConfig, type ConversationEntry } from "../../types/taskTypes.js";
+import { type Task, type TaskStatus, type TaskRunResult, type TaskStore, type TaskManagerConfig, type ConversationEntry } from "../../types/index.js";
 export declare class RedisTaskStore implements TaskStore {
     private config;
     readonly type: "redis";

package/dist/tasks/store/redisTaskStore.js

@@ -10,7 +10,7 @@
 import { createClient } from "redis";
 import { logger } from "../../utils/logger.js";
 import { TaskError } from "../errors.js";
-import { TASK_DEFAULTS, } from "../../types/taskTypes.js";
+import { TASK_DEFAULTS, } from "../../types/index.js";
 const KEY_PREFIX = "neurolink:";
 const TASKS_HASH = `${KEY_PREFIX}tasks`;
 function taskRunsKey(taskId) {

package/dist/tasks/taskExecutor.d.ts

@@ -7,8 +7,7 @@
  * - Retry with exponential backoff for transient errors
  * - Run result construction and logging
  */
-import type { AutoresearchEmitter } from "../types/autoresearchTypes.js";
-import type { NeuroLinkExecutable, Task, TaskRunResult, TaskStore } from "../types/taskTypes.js";
+import type { AutoresearchEmitter, NeuroLinkExecutable, Task, TaskRunResult, TaskStore } from "../types/index.js";
 export declare class TaskExecutor {
     private neurolink;
     private store;

package/dist/tasks/taskManager.d.ts

@@ -8,7 +8,7 @@
  *   const neurolink = new NeuroLink({ tasks: { backend: "bullmq" } });
  *   await neurolink.tasks.create({ name: "monitor", prompt: "...", schedule: { type: "interval", every: 60000 } });
  */
-import { type NeuroLinkExecutable, type Task, type TaskDefinition, type TaskManagerConfig, type TaskRunResult, type TaskStatus } from "../types/taskTypes.js";
+import { type NeuroLinkExecutable, type Task, type TaskDefinition, type TaskManagerConfig, type TaskRunResult, type TaskStatus } from "../types/index.js";
 export declare class TaskManager {
     private neurolink;
     private config;

package/dist/tasks/taskManager.js

@@ -9,7 +9,7 @@
  *   await neurolink.tasks.create({ name: "monitor", prompt: "...", schedule: { type: "interval", every: 60000 } });
  */
 import { nanoid } from "nanoid";
-import { TASK_DEFAULTS, } from "../types/taskTypes.js";
+import { TASK_DEFAULTS, } from "../types/index.js";
 import { logger } from "../utils/logger.js";
 import { clearWorkerCache } from "./autoresearchTaskExecutor.js";
 import { TaskBackendRegistry } from "./backends/taskBackendRegistry.js";

package/dist/tasks/tools/taskTools.d.ts

@@ -8,7 +8,7 @@
  * @module tasks/tools/taskTools
  */
 import type { TaskManager } from "../taskManager.js";
-import type { TaskSchedule } from "../../types/taskTypes.js";
+import type { TaskSchedule } from "../../types/index.js";
 /**
  * Create task management tools bound to a TaskManager instance.
  *
@@ -31,7 +31,7 @@ export declare function createTaskTools(manager: TaskManager): {
         name: string;
         prompt: string;
         schedule: {
-            type: "once" | "cron" | "interval";
+            type: "cron" | "interval" | "once";
             expression?: string | undefined;
             timezone?: string | undefined;
             every?: number | undefined;
@@ -58,7 +58,7 @@ export declare function createTaskTools(manager: TaskManager): {
         schedule?: undefined;
     }>;
     listTasks: import("ai").Tool<{
-        status?: "failed" | "pending" | "completed" | "cancelled" | "active" | "paused" | undefined;
+        status?: "failed" | "pending" | "active" | "paused" | "completed" | "cancelled" | undefined;
     }, {
         success: boolean;
         count: number;

package/dist/telemetry/index.d.ts

@@ -1,6 +1,6 @@
-export { TelemetryService, type HealthMetrics } from "./telemetryService.js";
+export { TelemetryService } from "./telemetryService.js";
 export { tracers } from "./tracers.js";
-export { withSpan, withClientSpan, type SpanOptions } from "./withSpan.js";
+export { withSpan, withClientSpan } from "./withSpan.js";
 export { ATTR } from "./attributes.js";
 /**
  * Initialize telemetry for NeuroLink

package/dist/telemetry/telemetryService.d.ts

@@ -1,11 +1,4 @@
-export type HealthMetrics = {
-    timestamp: number;
-    memoryUsage: NodeJS.MemoryUsage;
-    uptime: number;
-    activeConnections: number;
-    errorRate: number;
-    averageResponseTime: number;
-};
+import type { HealthMetrics } from "../types/index.js";
 export declare class TelemetryService {
     private static instance;
     private tracerProvider?;

package/dist/telemetry/withSpan.d.ts

@@ -1,9 +1,4 @@
-import { type Span, type Tracer, SpanKind } from "@opentelemetry/api";
-export type SpanOptions = {
-    name: string;
-    tracer: Tracer;
-    kind?: SpanKind;
-    attributes?: Record<string, string | number | boolean | undefined>;
-};
+import { type Span } from "@opentelemetry/api";
+import type { SpanOptions } from "../types/index.js";
 export declare function withSpan<T>(options: SpanOptions, fn: (span: Span) => Promise<T>): Promise<T>;
 export declare function withClientSpan<T>(options: Omit<SpanOptions, "kind">, fn: (span: Span) => Promise<T>): Promise<T>;

package/dist/telemetry/withSpan.js

@@ -1,4 +1,4 @@
-import { SpanKind, SpanStatusCode, } from "@opentelemetry/api";
+import { SpanKind, SpanStatusCode } from "@opentelemetry/api";
 export async function withSpan(options, fn) {
     const { name, tracer, kind = SpanKind.INTERNAL, attributes } = options;
     return tracer.startActiveSpan(name, { kind }, async (span) => {

package/dist/types/{typeAliases.d.ts → aliases.d.ts}

@@ -113,18 +113,6 @@ export type NumberArray = number[];
  */
 export type OptionalStringArray = StringArray | undefined;
 export type OptionalRecordArray = RecordArray | undefined;
-/**
- * Provider configuration type
- * Common structure for AI provider settings
- */
-export type ProviderConfig = {
-    apiKey?: string;
-    baseUrl?: string;
-    model?: string;
-    timeout?: number;
-    retries?: number;
-    metadata?: StandardRecord;
-};
 /**
  * API response structure
  * Standard response format across providers
@@ -169,15 +157,6 @@ export type EnhancedContext = BasicContext & {
     metadata?: StandardRecord;
     timeout?: number;
 };
-/**
- * Tool execution context with capabilities
- * Full context for complex tool operations
- */
-export type ToolContext = EnhancedContext & {
-    capabilities?: StringArray;
-    permissions?: StringArray;
-    environment?: string;
-};
 /**
  * Standard error structure
  * Consistent error format across the codebase
@@ -259,16 +238,6 @@ export type ServiceConfig = {
     apiKey?: string;
     metadata?: StandardRecord;
 };
-/**
- * Rate limiting configuration
- * Common rate limiting parameters
- */
-export type RateLimitConfig = {
-    enabled?: boolean;
-    requestsPerMinute?: number;
-    requestsPerHour?: number;
-    burstLimit?: number;
-};
 /**
  * Simple success/error result (different from generic OperationResult)
  * Used for basic operation feedback without data payload
@@ -306,7 +275,7 @@ export type ProviderPairResult<T = unknown> = {
  * Tool execution result with enhanced prompt
  * Common pattern in tool orchestration scenarios
  */
-export type ToolExecutionResult = {
+export type OrchestrationResult = {
     toolResults: unknown[];
     enhancedPrompt: string;
 };

package/dist/{lib/types/artifactTypes.d.ts → types/artifact.d.ts}

@@ -39,7 +39,7 @@ export type ArtifactRef = {
  * Default backend: LocalTempArtifactStore (filesystem, single-process).
  * Future backends can implement this interface for S3, Redis blobs, etc.
  */
-export interface ArtifactStore {
+export type ArtifactStore = {
     /**
      * Persist a payload and return a lightweight reference.
      * @param payload  Serialized tool output (JSON string or plain text).
@@ -60,4 +60,4 @@ export interface ArtifactStore {
     cleanup(olderThanMs: number): Promise<number>;
     /** Generate a short preview string from a serialized payload. */
     generatePreview(payload: string): string;
-}
+};