@anvia/core 0.1.5 → 0.2.1

package/dist/index.js

@@ -5,17 +5,17 @@ import {
 import {
   connectMcp,
   mcp
-} from "./chunk-WZTPK5HV.js";
+} from "./chunk-RLA7SST2.js";
 import {
   ModelListingError
 } from "./chunk-WJT22R3T.js";
 import {
   createObserver
-} from "./chunk-BT3I6O56.js";
+} from "./chunk-OD6TY44B.js";
 import {
   Pipeline,
   PipelineBuilder
-} from "./chunk-FI2BTRT5.js";
+} from "./chunk-RTOGIJH2.js";
 import {
   SkillValidationError,
   loadSkills,
@@ -34,25 +34,25 @@ import {
   llmScore,
   runEvalSuite,
   semanticSimilarity
-} from "./chunk-Q234327P.js";
+} from "./chunk-QAPEP4ON.js";
 import {
   ExtractionError,
   Extractor,
   ExtractorBuilder
-} from "./chunk-FHSSO753.js";
+} from "./chunk-QSIIO4YN.js";
 import {
   createThinkTool,
   createToolIndex,
   createToolMiddleware,
   embedTools,
   isDynamicToolIndex
-} from "./chunk-X2LR54ZO.js";
+} from "./chunk-V5EETE3U.js";
 import {
   InMemoryVectorIndex,
   InMemoryVectorStore,
   createVectorSearchTool,
   vectorFilter
-} from "./chunk-MQVFDXPC.js";
+} from "./chunk-4F7RVGFR.js";
 import {
   Agent,
   AgentBuilder,
@@ -63,10 +63,11 @@ import {
   PromptRequest,
   cancelPrompt,
   createHook,
+  requestToolApproval,
   runControl,
   skipTool,
   toolCallControl
-} from "./chunk-5OVEPVTH.js";
+} from "./chunk-DO4XW2ZB.js";
 import {
   resolveMemoryOptions
 } from "./chunk-XXT2UCAR.js";
@@ -85,6 +86,20 @@ import {
 import {
   toReadableStream
 } from "./chunk-XUUY2L2D.js";
+import {
+  AssistantContent,
+  CompletionCapabilityError,
+  CompletionRequestBuilder,
+  Message,
+  ToolContent,
+  Usage,
+  UserContent,
+  assertCompletionRequestSupported,
+  formatDocument,
+  normalizeDocuments,
+  reasoningDisplayText,
+  textFromAssistantContent
+} from "./chunk-6GJDBBDC.js";
 import {
   angularDistance,
   chebyshevDistance,
@@ -100,20 +115,6 @@ import {
   ImageGenerationRequestBuilder,
   imageGenerationRequest
 } from "./chunk-B24Q2ZYM.js";
-import {
-  AssistantContent,
-  CompletionCapabilityError,
-  CompletionRequestBuilder,
-  Message,
-  ToolContent,
-  Usage,
-  UserContent,
-  assertCompletionRequestSupported,
-  formatDocument,
-  normalizeDocuments,
-  reasoningDisplayText,
-  textFromAssistantContent
-} from "./chunk-CP47FBJV.js";
 export {
   Agent,
   AgentBuilder,
@@ -180,6 +181,7 @@ export {
   normalizeDocuments,
   parseToolArgs,
   reasoningDisplayText,
+  requestToolApproval,
   resolveMemoryOptions,
   runControl,
   runEvalSuite,

package/dist/loaders/index.d.ts

@@ -1,4 +1,4 @@
-import { D as Document } from '../types-BrxLd7ay.js';
+import { D as Document } from '../types-BM8-Y8Hy.js';
 
 type LoaderResult<T> = {
     ok: true;

package/dist/mcp/index.d.ts

@@ -1,9 +1,9 @@
-import { a as McpConnection, c as McpServer, d as McpStdioOptions, b as McpHttpOptions } from '../types-ChJoZ0OH.js';
-export { M as McpClient, e as McpToolCallContent, f as McpToolCallResult, g as McpToolDefinition } from '../types-ChJoZ0OH.js';
+import { a as McpConnection, c as McpServer, d as McpStdioOptions, b as McpHttpOptions } from '../types-DNHlpDG_.js';
+export { M as McpClient, e as McpToolCallContent, f as McpToolCallResult, g as McpToolDefinition } from '../types-DNHlpDG_.js';
 import '@modelcontextprotocol/sdk/client/stdio.js';
 import '@modelcontextprotocol/sdk/client/streamableHttp.js';
-import '../types-BrxLd7ay.js';
-import '../tool-DiWtAf_Q.js';
+import '../types-BM8-Y8Hy.js';
+import '../tool-FEHplpd9.js';
 
 declare function connectMcp(connection: McpConnection): Promise<McpServer>;
 

package/dist/mcp/index.js

@@ -1,7 +1,7 @@
 import {
   connectMcp,
   mcp
-} from "../chunk-WZTPK5HV.js";
+} from "../chunk-RLA7SST2.js";
 export {
   connectMcp,
   mcp

package/dist/memory/index.d.ts

@@ -1,4 +1,4 @@
-import { J as JsonObject, M as Message } from '../types-BrxLd7ay.js';
+import { J as JsonObject, M as Message } from '../types-BM8-Y8Hy.js';
 
 type MemorySavePolicy = "message" | "turn" | "run";
 type MemoryContext = {

package/dist/{middleware-2iCGCsB6.d.ts → middleware-CKsY_zZE.d.ts}

@@ -1,8 +1,8 @@
 import { z } from 'zod';
-import { q as ToolDefinition } from './types-BrxLd7ay.js';
+import { q as ToolDefinition } from './types-BM8-Y8Hy.js';
 import { VectorMetadata, EmbeddingModel, EmbeddedDocument } from './embeddings/index.js';
 import { VectorSearchIndex } from './vector-store/index.js';
-import { A as AnyTool, d as ToolCallContext } from './tool-DiWtAf_Q.js';
+import { A as AnyTool, d as ToolCallContext } from './tool-FEHplpd9.js';
 
 type ZodSchema<T = unknown> = z.ZodType<T>;
 

package/dist/observability/index.d.ts

@@ -1,5 +1,5 @@
-import { M as Message, d as CompletionRequest, e as CompletionResponse, n as ToolCall, U as Usage } from '../types-BrxLd7ay.js';
-import { e as ToolCallStreamEvent } from '../tool-DiWtAf_Q.js';
+import { M as Message, d as CompletionRequest, J as JsonObject, c as CompletionModelCapabilities, e as CompletionResponse, n as ToolCall, q as ToolDefinition, U as Usage } from '../types-BM8-Y8Hy.js';
+import { e as ToolCallStreamEvent } from '../tool-FEHplpd9.js';
 
 type AgentTraceInfo = {
     traceId?: string | undefined;
@@ -37,6 +37,12 @@ type AgentRunErrorArgs = {
 type AgentGenerationStartArgs = {
     turn: number;
     request: CompletionRequest;
+    providerRequest?: JsonObject | undefined;
+    modelInfo?: {
+        provider: string;
+        defaultModel: string;
+        capabilities?: CompletionModelCapabilities | undefined;
+    };
 };
 type AgentGenerationEndArgs<RawResponse = unknown> = {
     turn: number;
@@ -54,6 +60,8 @@ type AgentToolStartArgs = {
     args: string;
     internalCallId: string;
     toolCallId?: string | undefined;
+    toolDefinition?: ToolDefinition | undefined;
+    toolMetadata?: JsonObject | undefined;
 };
 type AgentToolEndArgs = AgentToolStartArgs & {
     result: string;

package/dist/observability/index.js

@@ -1,6 +1,6 @@
 import {
   createObserver
-} from "../chunk-BT3I6O56.js";
+} from "../chunk-OD6TY44B.js";
 export {
   createObserver
 };

package/dist/pipeline/index.d.ts

@@ -1,10 +1,10 @@
-import { b as CompletionModel } from '../types-BrxLd7ay.js';
-import { A as Agent } from '../agent-wBc0uM9_.js';
+import { J as JsonObject, b as CompletionModel } from '../types-BM8-Y8Hy.js';
+import { A as Agent } from '../agent-ufaeGoaz.js';
 import { Extractor } from '../extractor/index.js';
 import '../memory/index.js';
 import '../observability/index.js';
-import '../tool-DiWtAf_Q.js';
-import '../middleware-2iCGCsB6.js';
+import '../tool-FEHplpd9.js';
+import '../middleware-CKsY_zZE.js';
 import 'zod';
 import '../embeddings/index.js';
 import '../vector-store/index.js';
@@ -21,32 +21,107 @@ type AwaitedOutput<Op> = Op extends PipelineOp<unknown, infer Output> ? Awaited<
 type ParallelOutput<Branches extends Record<string, PipelineOp<unknown, unknown>>> = {
     [Key in keyof Branches]: AwaitedOutput<Branches[Key]>;
 };
+type PipelineMetadata = {
+    id?: string | undefined;
+    name?: string | undefined;
+    description?: string | undefined;
+    metadata?: JsonObject | undefined;
+};
+type PipelineStageMetadata = {
+    id?: string | undefined;
+    name?: string | undefined;
+    description?: string | undefined;
+    metadata?: JsonObject | undefined;
+};
+type PipelineStageKind = "input" | "step" | "pipeline" | "parallel" | "branch" | "agent" | "extractor" | "output";
+type PipelineGraphNode = {
+    id: string;
+    kind: PipelineStageKind;
+    label: string;
+    description?: string | undefined;
+    metadata?: JsonObject | undefined;
+    agentId?: string | undefined;
+    agentName?: string | undefined;
+    pipelineId?: string | undefined;
+    branchKey?: string | undefined;
+};
+type PipelineGraphEdge = {
+    id: string;
+    source: string;
+    target: string;
+    label?: string | undefined;
+};
+type PipelineGraph = PipelineMetadata & {
+    id: string;
+    nodes: PipelineGraphNode[];
+    edges: PipelineGraphEdge[];
+};
+type PipelineRunEvent = {
+    type: "stage_started";
+    node: PipelineGraphNode;
+} | {
+    type: "stage_completed";
+    node: PipelineGraphNode;
+    durationMs: number;
+} | {
+    type: "stage_failed";
+    node: PipelineGraphNode;
+    durationMs: number;
+    error: unknown;
+};
+type PipelineRunObserver = {
+    onEvent(event: PipelineRunEvent): void | Promise<void>;
+};
+type PipelineRunOptions = {
+    observer?: PipelineRunObserver | undefined;
+};
+type PipelineRunContext = {
+    observer?: PipelineRunObserver | undefined;
+};
+type PipelineExecutor<Input, Output> = (input: Input, context: PipelineRunContext) => Output | Promise<Output>;
+type PipelineBuilderState = {
+    graph: PipelineGraph;
+    terminalNodeId: string;
+    terminalNodeIds: string[];
+    nextNodeIndex: number;
+    nextEdgeIndex: number;
+};
 /** Runnable pipeline returned by `PipelineBuilder.build()`. */
 declare class Pipeline<Input, Output> implements PipelineOp<Input, Awaited<Output>> {
     private readonly executor;
-    constructor(executor: (input: Input) => Output | Promise<Output>);
+    private readonly pipelineGraph;
+    readonly id: string;
+    readonly name: string | undefined;
+    readonly description: string | undefined;
+    readonly metadata: JsonObject | undefined;
+    constructor(executor: PipelineExecutor<Input, Output>, pipelineGraph?: PipelineGraph);
     /** Run one input through the built pipeline and return the final stage output. */
-    run(input: Input): Promise<Awaited<Output>>;
+    run(input: Input, options?: PipelineRunOptions): Promise<Awaited<Output>>;
     /** Run many inputs through the same pipeline with bounded concurrency. */
     batch<I extends Iterable<Input>>(inputs: I, options: PipelineBatchOptions): Promise<Array<Awaited<Output>>>;
+    graph(): PipelineGraph;
 }
 /** Builds a typed pipeline from an original input type to an inferred output type. */
 declare class PipelineBuilder<Input, Output = Input> {
     private readonly executor;
-    constructor(executor?: (input: Input) => Output | Promise<Output>);
+    private readonly state;
+    constructor();
+    constructor(metadata: PipelineMetadata);
+    constructor(executor: (input: Input) => Output | Promise<Output>);
+    constructor(executor: PipelineExecutor<Input, Output>, state: PipelineBuilderState);
     /** Add a synchronous or asynchronous transform stage. */
-    step<Next>(fn: (input: Awaited<Output>) => Next | Promise<Next>): PipelineBuilder<Input, Awaited<Next>>;
+    step<Next>(fn: (input: Awaited<Output>) => Next | Promise<Next>, metadata?: PipelineStageMetadata): PipelineBuilder<Input, Awaited<Next>>;
     /** Compose another pipeline operation after the current stage. */
-    use<Next>(op: PipelineOp<Awaited<Output>, Next>): PipelineBuilder<Input, Awaited<Next>>;
+    use<Next>(op: PipelineOp<Awaited<Output>, Next>, metadata?: PipelineStageMetadata): PipelineBuilder<Input, Awaited<Next>>;
     /** Run named branch operations concurrently from the current value. */
-    parallel<Branches extends Record<string, PipelineOp<Awaited<Output>, unknown>>>(branches: Branches): PipelineBuilder<Input, ParallelOutput<Branches>>;
+    parallel<Branches extends Record<string, PipelineOp<Awaited<Output>, unknown>>>(branches: Branches, metadata?: PipelineStageMetadata): PipelineBuilder<Input, ParallelOutput<Branches>>;
     /** Send the current value to an agent as text and continue with the agent output. */
-    prompt(agent: Agent<CompletionModel>): PipelineBuilder<Input, string>;
+    prompt(agent: Agent<CompletionModel>, metadata?: PipelineStageMetadata): PipelineBuilder<Input, string>;
     /** Send the current value to an extractor as text and continue with typed schema data. */
-    extract<T>(extractor: Extractor<T, CompletionModel>): PipelineBuilder<Input, T>;
+    extract<T>(extractor: Extractor<T, CompletionModel>, metadata?: PipelineStageMetadata): PipelineBuilder<Input, T>;
     /** Finish the builder and return a runnable pipeline. */
     build(): Pipeline<Input, Awaited<Output>>;
     private runStep;
 }
 
-export { Pipeline, type PipelineBatchOptions, PipelineBuilder, type PipelineOp };
+export { Pipeline, type PipelineBatchOptions, PipelineBuilder, type PipelineGraph, type PipelineGraphEdge, type PipelineGraphNode, type PipelineMetadata, type PipelineOp, type PipelineRunEvent, type PipelineRunObserver, type PipelineRunOptions, type PipelineStageKind, type PipelineStageMetadata };

package/dist/pipeline/index.js

@@ -1,7 +1,7 @@
 import {
   Pipeline,
   PipelineBuilder
-} from "../chunk-FI2BTRT5.js";
+} from "../chunk-RTOGIJH2.js";
 export {
   Pipeline,
   PipelineBuilder

package/dist/skills/index.d.ts

@@ -1,7 +1,7 @@
-import { a as SkillLoader, b as SkillSet } from '../types-21n32ltl.js';
-export { S as Skill, c as SkillValidationError, d as SkillValidationIssue } from '../types-21n32ltl.js';
-import '../tool-DiWtAf_Q.js';
-import '../types-BrxLd7ay.js';
+import { a as SkillLoader, b as SkillSet } from '../types-CW3K1MJm.js';
+export { S as Skill, c as SkillValidationError, d as SkillValidationIssue } from '../types-CW3K1MJm.js';
+import '../tool-FEHplpd9.js';
+import '../types-BM8-Y8Hy.js';
 
 declare function loadSkills(loaders: SkillLoader | SkillLoader[]): Promise<SkillSet>;
 

package/dist/skills/index.js

@@ -3,8 +3,8 @@ import {
   loadSkills,
   skill
 } from "../chunk-2VCWYCPV.js";
-import "../chunk-X2LR54ZO.js";
-import "../chunk-MQVFDXPC.js";
+import "../chunk-V5EETE3U.js";
+import "../chunk-4F7RVGFR.js";
 import "../chunk-YK4WAAS4.js";
 import "../chunk-3H7FVGHU.js";
 import "../chunk-445TT5Q5.js";

package/dist/tool/index.d.ts

@@ -1,9 +1,9 @@
 import { z } from 'zod';
-import { Z as ZodSchema } from '../middleware-2iCGCsB6.js';
-export { D as DynamicToolIndex, E as EmbedToolsOptions, T as ToolMiddleware, a as ToolResultMiddlewareArgs, b as ToolSearchDocument, c as ToolSet, d as createToolIndex, e as createToolMiddleware, f as embedTools, i as isDynamicToolIndex } from '../middleware-2iCGCsB6.js';
-import { b as ToolApprovalPolicy, d as ToolCallContext, T as Tool } from '../tool-DiWtAf_Q.js';
-export { A as AnyTool, a as ToolApprovalContext, c as ToolApprovalRunContext, e as ToolCallStreamEvent, p as parseToolArgs, s as serializeToolOutput } from '../tool-DiWtAf_Q.js';
-import '../types-BrxLd7ay.js';
+import { Z as ZodSchema } from '../middleware-CKsY_zZE.js';
+export { D as DynamicToolIndex, E as EmbedToolsOptions, T as ToolMiddleware, a as ToolResultMiddlewareArgs, b as ToolSearchDocument, c as ToolSet, d as createToolIndex, e as createToolMiddleware, f as embedTools, i as isDynamicToolIndex } from '../middleware-CKsY_zZE.js';
+import { b as ToolApprovalPolicy, d as ToolCallContext, T as Tool } from '../tool-FEHplpd9.js';
+export { A as AnyTool, a as ToolApprovalContext, c as ToolApprovalRunContext, e as ToolCallStreamEvent, p as parseToolArgs, s as serializeToolOutput } from '../tool-FEHplpd9.js';
+import '../types-BM8-Y8Hy.js';
 import '../embeddings/index.js';
 import '../vector-store/index.js';
 

package/dist/tool/index.js

@@ -4,8 +4,8 @@ import {
   createToolMiddleware,
   embedTools,
   isDynamicToolIndex
-} from "../chunk-X2LR54ZO.js";
-import "../chunk-MQVFDXPC.js";
+} from "../chunk-V5EETE3U.js";
+import "../chunk-4F7RVGFR.js";
 import {
   ToolCallError,
   ToolJsonError,

package/dist/{tool-DiWtAf_Q.d.ts → tool-FEHplpd9.d.ts}

@@ -1,4 +1,4 @@
-import { J as JsonObject, q as ToolDefinition, j as JsonValue } from './types-BrxLd7ay.js';
+import { J as JsonObject, q as ToolDefinition, j as JsonValue } from './types-BM8-Y8Hy.js';
 
 type ToolApprovalRunContext = {
     agentId: string;

package/dist/transcription/index.d.ts

@@ -1,4 +1,4 @@
-import { j as JsonValue } from '../types-BrxLd7ay.js';
+import { j as JsonValue } from '../types-BM8-Y8Hy.js';
 
 type TranscriptionRequest = {
     data: Uint8Array;

package/dist/{types-BrxLd7ay.d.ts → types-BM8-Y8Hy.d.ts}

@@ -205,6 +205,9 @@ interface CompletionModel<RawResponse = unknown> {
     readonly provider: string;
     readonly defaultModel: string;
     readonly capabilities: CompletionModelCapabilities;
+    traceRequest?(request: CompletionRequest, options?: {
+        stream?: boolean | undefined;
+    }): JsonObject | undefined;
     completion(request: CompletionRequest): Promise<CompletionResponse<RawResponse>>;
 }
 type CompletionStreamEvent<RawResponse = unknown> = {

package/dist/{types-21n32ltl.d.ts → types-CW3K1MJm.d.ts}

@@ -1,4 +1,4 @@
-import { A as AnyTool } from './tool-DiWtAf_Q.js';
+import { A as AnyTool } from './tool-FEHplpd9.js';
 
 type Skill = {
     readonly name: string;

package/dist/{types-ChJoZ0OH.d.ts → types-DNHlpDG_.d.ts}

@@ -1,7 +1,7 @@
 import { StdioServerParameters } from '@modelcontextprotocol/sdk/client/stdio.js';
 import { StreamableHTTPClientTransportOptions } from '@modelcontextprotocol/sdk/client/streamableHttp.js';
-import { J as JsonObject } from './types-BrxLd7ay.js';
-import { A as AnyTool } from './tool-DiWtAf_Q.js';
+import { J as JsonObject } from './types-BM8-Y8Hy.js';
+import { A as AnyTool } from './tool-FEHplpd9.js';
 
 type McpToolDefinition = {
     name: string;

package/dist/vector-store/index.d.ts

@@ -1,6 +1,6 @@
 import { VectorMetadataValue, VectorMetadata, EmbeddingModel, EmbeddedDocument, Embedding } from '../embeddings/index.js';
-import { T as Tool } from '../tool-DiWtAf_Q.js';
-import '../types-BrxLd7ay.js';
+import { T as Tool } from '../tool-FEHplpd9.js';
+import '../types-BM8-Y8Hy.js';
 
 type VectorFilter = {
     type: "eq";
@@ -51,6 +51,21 @@ type VectorSearchResult<T = unknown, Metadata extends VectorMetadata = VectorMet
     document: T;
     metadata?: Metadata | undefined;
 };
+type VectorInspectRequest = {
+    limit: number;
+    cursor?: string | undefined;
+    filter?: VectorFilter | undefined;
+};
+type VectorInspectItem<T = unknown, Metadata extends VectorMetadata = VectorMetadata> = {
+    id: string;
+    document: T;
+    metadata?: Metadata | undefined;
+};
+type VectorInspectPage<T = unknown, Metadata extends VectorMetadata = VectorMetadata> = {
+    items: Array<VectorInspectItem<T, Metadata>>;
+    nextCursor?: string | undefined;
+    totalCount?: number | undefined;
+};
 interface VectorSearchIndex<T = unknown, Metadata extends VectorMetadata = VectorMetadata> {
     search(request: VectorSearchRequest): Promise<Array<VectorSearchResult<T, Metadata>>>;
     searchIds(request: VectorSearchRequest): Promise<Array<{
@@ -61,6 +76,7 @@ interface VectorSearchIndex<T = unknown, Metadata extends VectorMetadata = Vecto
         query: string;
         topK?: number;
     }, unknown>;
+    inspect?(request: VectorInspectRequest): Promise<VectorInspectPage<T, Metadata>>;
 }
 type VectorSearchToolOptions = {
     name: string;
@@ -98,6 +114,7 @@ declare class InMemoryVectorIndex<T, Metadata extends VectorMetadata = VectorMet
         score: number;
         id: string;
     }>>;
+    inspect(request: VectorInspectRequest): Promise<VectorInspectPage<T, Metadata>>;
     asTool(options: VectorSearchToolOptions): Tool<{
         query: string;
         topK?: number;
@@ -108,4 +125,4 @@ declare function createVectorSearchTool<T, Metadata extends VectorMetadata>(inde
     topK?: number;
 }, Array<VectorSearchResult<T, Metadata>>>;
 
-export { InMemoryVectorIndex, InMemoryVectorStore, type IndexStrategy, type VectorFilter, type VectorSearchIndex, type VectorSearchRequest, type VectorSearchResult, type VectorSearchToolOptions, createVectorSearchTool, vectorFilter };
+export { InMemoryVectorIndex, InMemoryVectorStore, type IndexStrategy, type VectorFilter, type VectorInspectItem, type VectorInspectPage, type VectorInspectRequest, type VectorSearchIndex, type VectorSearchRequest, type VectorSearchResult, type VectorSearchToolOptions, createVectorSearchTool, vectorFilter };

package/dist/vector-store/index.js

@@ -3,7 +3,7 @@ import {
   InMemoryVectorStore,
   createVectorSearchTool,
   vectorFilter
-} from "../chunk-MQVFDXPC.js";
+} from "../chunk-4F7RVGFR.js";
 import "../chunk-445TT5Q5.js";
 import "../chunk-A7VDIZQN.js";
 export {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@anvia/core",
-  "version": "0.1.5",
+  "version": "0.2.1",
   "description": "Core runtime primitives for context-aware Anvia agents.",
   "author": "anvia",
   "maintainer": "Indra Zulfi",