@anvia/core 1.0.0-rc.2 → 1.0.0-rc.4

package/dist/text-C_6eKrbC.d.ts

@@ -0,0 +1,32 @@
+import { l as GuardrailActionBase, n as GuardrailAllow, o as GuardrailBlock, e as GuardrailPolicyOptions, c as GuardrailPolicy, I as InputGuardrail, O as OutputGuardrail, d as GuardrailPolicyInput } from './types-CIPaIbZo.js';
+
+declare function allow(options?: GuardrailActionBase): GuardrailAllow;
+declare function block(options: Omit<GuardrailBlock, "action">): GuardrailBlock;
+
+declare function defineGuardrailPolicy(options: GuardrailPolicyOptions): GuardrailPolicy;
+declare function defineInputGuardrail(guardrail: InputGuardrail): InputGuardrail;
+declare function defineOutputGuardrail(guardrail: OutputGuardrail): OutputGuardrail;
+declare function normalizeGuardrailPolicies(policies: GuardrailPolicyInput | undefined): GuardrailPolicy[];
+declare function appendGuardrailPolicies(current: GuardrailPolicy[], next: GuardrailPolicyInput): GuardrailPolicy[];
+declare function hasEnforcedOutputGuardrails(policies: GuardrailPolicy[]): boolean;
+
+declare const guardrails: {
+    blockText: typeof blockText;
+    redactText: typeof redactText;
+};
+type TextPatternBoundary = "input" | "output";
+type TextPatternGuardrailFor<Boundary extends TextPatternBoundary> = Boundary extends "input" ? InputGuardrail : OutputGuardrail;
+type TextPatternGuardrailOptions<Boundary extends TextPatternBoundary = TextPatternBoundary> = {
+    id: string;
+    boundary: Boundary;
+    patterns: Array<string | RegExp>;
+    reason: string;
+    message?: string | undefined;
+};
+type TextPatternRedactOptions<Boundary extends TextPatternBoundary = TextPatternBoundary> = TextPatternGuardrailOptions<Boundary> & {
+    replacement?: string | undefined;
+};
+declare function blockText<Boundary extends TextPatternBoundary>(options: TextPatternGuardrailOptions<Boundary>): TextPatternGuardrailFor<Boundary>;
+declare function redactText<Boundary extends TextPatternBoundary>(options: TextPatternRedactOptions<Boundary>): TextPatternGuardrailFor<Boundary>;
+
+export { allow as a, block as b, defineInputGuardrail as c, defineGuardrailPolicy as d, defineOutputGuardrail as e, appendGuardrailPolicies as f, guardrails as g, hasEnforcedOutputGuardrails as h, normalizeGuardrailPolicies as n };

package/dist/{think-tool-6H2QNQzQ.d.ts → think-tool-D8frXxwV.d.ts}

@@ -1,6 +1,7 @@
 import { z } from 'zod';
 import { Z as ZodSchema } from './zod-schema-C7F4clpm.js';
-import { e as ToolRequiresApproval, c as ToolCallContext, T as Tool } from './tool--Mz4v1eL.js';
+import { e as ToolRequiresApproval, c as ToolCallContext, T as Tool } from './tool-r62gf3QY.js';
+import { f as AgentQuestionPrompt, d as AgentQuestionAnswer } from './interactions-csssHYcN.js';
 
 type CreateToolOptions<InputSchema extends ZodSchema, OutputSchema extends ZodSchema | undefined = undefined, Output = unknown> = {
     name: string;
@@ -15,6 +16,19 @@ declare function createTool<InputSchema extends ZodSchema, Output = unknown>(opt
 }): Tool<z.output<InputSchema>, Output>;
 declare function createTool<InputSchema extends ZodSchema, OutputSchema extends ZodSchema>(options: CreateToolOptions<InputSchema, OutputSchema>): Tool<z.output<InputSchema>, z.output<OutputSchema>>;
 
+type QuestionToolInput = {
+    questions: readonly AgentQuestionPrompt[];
+};
+type QuestionToolOutput = {
+    answers: readonly AgentQuestionAnswer[];
+};
+type CreateQuestionToolOptions = {
+    name: string;
+    description: string;
+};
+declare function createQuestionTool(options: CreateQuestionToolOptions): Tool<QuestionToolInput, QuestionToolOutput>;
+declare function isQuestionTool(tool: unknown): tool is Tool<QuestionToolInput, QuestionToolOutput>;
+
 type CreateThinkToolOptions = {
     name?: string;
     description?: string;
@@ -23,4 +37,4 @@ declare function createThinkTool(options?: CreateThinkToolOptions): Tool<{
     thought: string;
 }, string>;
 
-export { type CreateToolOptions as C, createTool as a, type CreateThinkToolOptions as b, createThinkTool as c };
+export { type CreateToolOptions as C, type QuestionToolInput as Q, createThinkTool as a, createTool as b, createQuestionTool as c, type CreateQuestionToolOptions as d, type CreateThinkToolOptions as e, type QuestionToolOutput as f, isQuestionTool as i };

package/dist/tool/index.d.ts

@@ -1,14 +1,14 @@
-export { b as CreateThinkToolOptions, C as CreateToolOptions, c as createThinkTool, a as createTool } from '../think-tool-6H2QNQzQ.js';
-export { C as CreateToolIndexOptions, E as EmbedToolsOptions, T as ToolIndex, a as ToolSearchDocument, c as createToolIndex, e as embedTools, i as isToolIndex } from '../dynamic-tools-KwEGRbHp.js';
-export { A as AgentMiddleware, C as CompletionRequestMiddlewareArgs, a as CompletionRequestMiddlewareResult, b as CompletionResponseMiddlewareArgs, c as CompletionResponseMiddlewareResult, T as ToolInputMiddlewareArgs, d as ToolInputMiddlewareResult, e as ToolOutputMiddlewareArgs, f as ToolOutputMiddlewareResult, g as ToolResultMiddlewareArgs, h as createMiddleware } from '../middleware-C7PdmKF7.js';
-export { A as AnyTool, N as NormalizedToolOutput, R as RichToolOutput, T as Tool, a as ToolApprovalContext, b as ToolApprovalRequirement, f as ToolApprovalRunContext, c as ToolCallContext, d as ToolCallStreamEvent, g as ToolOutput, e as ToolRequiresApproval, h as ToolResultSerializationError, n as normalizeToolResultOutput, p as parseToolArgs, t as toolResultContentToText } from '../tool--Mz4v1eL.js';
+export { d as CreateQuestionToolOptions, e as CreateThinkToolOptions, C as CreateToolOptions, Q as QuestionToolInput, f as QuestionToolOutput, c as createQuestionTool, a as createThinkTool, b as createTool, i as isQuestionTool } from '../think-tool-D8frXxwV.js';
+export { C as CreateToolIndexOptions, E as EmbedToolsOptions, T as ToolIndex, a as ToolSearchDocument, c as createToolIndex, e as embedTools, i as isToolIndex } from '../dynamic-tools-AEBOTgu1.js';
+export { c as AgentMiddleware, C as CompletionRequestMiddlewareArgs, i as CompletionRequestMiddlewareResult, j as CompletionResponseMiddlewareArgs, k as CompletionResponseMiddlewareResult, T as ToolInputMiddlewareArgs, l as ToolInputMiddlewareResult, m as ToolOutputMiddlewareArgs, n as ToolOutputMiddlewareResult, o as ToolResultMiddlewareArgs, s as createMiddleware } from '../interactions-csssHYcN.js';
+export { A as AnyTool, N as NormalizedToolOutput, R as RichToolOutput, T as Tool, a as ToolApprovalContext, b as ToolApprovalRequirement, f as ToolApprovalRunContext, c as ToolCallContext, d as ToolCallStreamEvent, g as ToolOutput, e as ToolRequiresApproval, h as ToolResultSerializationError, n as normalizeToolResultOutput, p as parseToolArgs, t as toolResultContentToText } from '../tool-r62gf3QY.js';
 import 'zod';
 import '../zod-schema-C7F4clpm.js';
 import '../retry-CjvSlKGW.js';
-import '../types-CQ_ioXWK.js';
+import '../types-D9rKQ_as.js';
 import '../model-call-options-CZkSw_xN.js';
 import '../types-Cr4uiYo5.js';
-import '../types-Dld1TpWj.js';
+import '../types-C3gv9EX6.js';
 import '../type-utils-CtHVDRn_.js';
 
 declare class ToolCallError extends Error {

package/dist/tool/index.js

@@ -1,10 +1,12 @@
 import {
   createMiddleware,
+  createQuestionTool,
   createThinkTool,
   createToolIndex,
   embedTools,
+  isQuestionTool,
   isToolIndex
-} from "../chunk-D37WMSP6.js";
+} from "../chunk-J2W63PJI.js";
 import {
   ToolCallError,
   ToolJsonError,
@@ -15,9 +17,10 @@ import {
   normalizeToolResultOutput,
   parseToolArgs,
   toolResultContentToText
-} from "../chunk-77AIYARB.js";
-import "../chunk-FMHLROPQ.js";
-import "../chunk-TIZYTPJO.js";
+} from "../chunk-XYTPYUGB.js";
+import "../chunk-GQL5KRAH.js";
+import "../chunk-3RM57ZT2.js";
+import "../chunk-PK5LKOFL.js";
 import "../chunk-FN7HLLAZ.js";
 export {
   ToolCallError,
@@ -26,10 +29,12 @@ export {
   ToolOutput,
   ToolResultSerializationError,
   createMiddleware,
+  createQuestionTool,
   createThinkTool,
   createTool,
   createToolIndex,
   embedTools,
+  isQuestionTool,
   isToolIndex,
   normalizeToolResultOutput,
   parseToolArgs,

package/dist/{tool--Mz4v1eL.d.ts → tool-r62gf3QY.d.ts}

@@ -1,4 +1,4 @@
-import { J as JsonObject, v as ToolDefinition, o as JsonValue, y as ToolResultOutput, x as ToolResultContentPart } from './types-CQ_ioXWK.js';
+import { J as JsonObject, v as ToolDefinition, o as JsonValue, y as ToolResultOutput, x as ToolResultContentPart } from './types-D9rKQ_as.js';
 
 type ToolApprovalRunContext = {
     agentId: string;
@@ -10,7 +10,8 @@ type ToolApprovalContext<Args = unknown> = {
     toolName: string;
     args: Args;
     rawArgs: string;
-    toolCallId?: string;
+    toolCallId: string;
+    callId?: string;
     internalCallId: string;
     run: ToolApprovalRunContext;
 };

package/dist/transcription/index.d.ts

@@ -1,7 +1,7 @@
 import { M as ModelCallOptions } from '../model-call-options-CZkSw_xN.js';
 import { b as RetrySetting } from '../retry-CjvSlKGW.js';
 export { R as RetryContext, a as RetryOptions } from '../retry-CjvSlKGW.js';
-import { J as JsonObject } from '../types-CQ_ioXWK.js';
+import { J as JsonObject } from '../types-D9rKQ_as.js';
 
 type TranscriptionRequest = {
     data: Uint8Array;

package/dist/{types-Dld1TpWj.d.ts → types-C3gv9EX6.d.ts}

@@ -1,5 +1,5 @@
 import { b as RetrySetting } from './retry-CjvSlKGW.js';
-import { J as JsonObject } from './types-CQ_ioXWK.js';
+import { J as JsonObject } from './types-D9rKQ_as.js';
 import { b as VectorMetadataValue, V as VectorMetadata, a as EmbeddedDocument, S as SparseVector, E as EmbeddingModel, c as SparseEmbeddingModel } from './types-Cr4uiYo5.js';
 
 type VectorFilter = {

package/dist/{types-3x3mOLHU.d.ts → types-CElwurHZ.d.ts}

@@ -1,10 +1,10 @@
+import { a as AgentInteractionRequest, A as AgentContinuation, b as AgentInteractionResponse, c as AgentMiddleware } from './interactions-csssHYcN.js';
 import { b as RetrySetting } from './retry-CjvSlKGW.js';
-import { M as Message, f as CompletionResponse, U as Usage, R as ReasoningContentType, t as ToolCallPart, h as CompletionSource, q as ProviderToolCall, E as UserMessage, k as ContextUsage, e as CompletionRequest, y as ToolResultOutput, x as ToolResultContentPart, X as ToolCallArgumentsMode, J as JsonObject, Q as CompletionModelCapabilities, v as ToolDefinition } from './types-CQ_ioXWK.js';
-import { GuardrailPolicyInput, GuardrailDecisionRecord } from './guardrails/index.js';
-import { e as MemoryCompactionInfo, z as MemoryScope } from './types-BVzM4RsC.js';
+import { M as Message, f as CompletionResponse, U as Usage, R as ReasoningContentType, t as ToolCallPart, h as CompletionSource, q as ProviderToolCall, E as UserMessage, k as ContextUsage, e as CompletionRequest, y as ToolResultOutput, x as ToolResultContentPart, Z as ToolInteractionResponsePart, Y as ToolCallArgumentsMode, J as JsonObject, Q as CompletionModelCapabilities, v as ToolDefinition } from './types-D9rKQ_as.js';
+import { d as GuardrailPolicyInput, a as GuardrailDecisionRecord } from './types-CIPaIbZo.js';
+import { e as MemoryCompactionInfo, z as MemoryScope } from './types-DbolvLtZ.js';
 import { D as DeepReadonly, M as MaybePromise } from './type-utils-CtHVDRn_.js';
-import { d as ToolCallStreamEvent } from './tool--Mz4v1eL.js';
-import { A as AgentMiddleware } from './middleware-C7PdmKF7.js';
+import { d as ToolCallStreamEvent } from './tool-r62gf3QY.js';
 
 type AgentLifecycleRunEvent = {
     runId: string;
@@ -47,6 +47,9 @@ type AgentFinishEvent<Output = string> = (AgentFinishEventBase & {
 }) | (AgentFinishEventBase & {
     status: "blocked";
     stage: "input" | "output";
+}) | (AgentFinishEventBase & {
+    status: "suspended";
+    interaction: DeepReadonly<AgentInteractionRequest>;
 });
 type AgentErrorEvent = AgentLifecycleRunEvent & {
     error: unknown;
@@ -67,10 +70,20 @@ type AgentInput = {
     prompt: AgentPrompt;
     messages?: never;
     session?: MemoryScope | undefined;
+    continuation?: never;
+    response?: never;
 } | {
     messages: readonly Message[];
     prompt?: never;
     session?: never;
+    continuation?: never;
+    response?: never;
+} | {
+    continuation: AgentContinuation;
+    response: AgentInteractionResponse;
+    prompt?: never;
+    messages?: never;
+    session?: never;
 };
 type AgentSteerInput = {
     prompt: AgentPrompt;
@@ -90,6 +103,10 @@ type AgentRunSettings<Output = string, RawResponse = unknown> = {
     trace?: AgentTraceOptions | undefined;
 };
 type AgentRunOptions<Output = string, RawResponse = unknown> = AgentInput & AgentRunSettings<Output, RawResponse>;
+type AgentRunLink = Readonly<{
+    runId: string;
+    interactionId: string;
+}>;
 type AgentResultBase = {
     runId: string;
     text: string;
@@ -101,6 +118,7 @@ type AgentResultBase = {
     sources?: CompletionSource[] | undefined;
     providerToolCalls?: ProviderToolCall[] | undefined;
     memoryCompaction?: MemoryCompactionInfo | undefined;
+    resumedFrom?: AgentRunLink | undefined;
 };
 type AgentResponse<Output = string> = AgentResultBase & {
     status: "completed";
@@ -110,32 +128,12 @@ type AgentBlockedResult = AgentResultBase & {
     status: "blocked";
     stage: "input" | "output";
 };
-type AgentApprovalRequiredResult = {
-    status: "approval_required";
-    runId: string;
-    approval: AgentToolApprovalRequest;
-    usage: Usage;
-    messages: Message[];
-    memoryCompaction?: MemoryCompactionInfo | undefined;
-};
-type AgentResult<Output = string> = AgentResponse<Output> | AgentBlockedResult | AgentApprovalRequiredResult;
-type AgentToolApprovalRequest = {
-    id: string;
-    toolName: string;
-    toolCallId?: string | undefined;
-    reason?: string | undefined;
-    input: unknown;
-};
-type AgentApprovalRequiredEvent = Omit<AgentApprovalRequiredResult, "status"> & {
-    type: "approval_required";
-};
-type AgentApprovalDecision = {
-    approved: true;
-    reason?: string;
-} | {
-    approved: false;
-    reason?: string;
+type AgentSuspendedResult = AgentResultBase & {
+    status: "suspended";
+    interaction: AgentInteractionRequest;
+    continuation: AgentContinuation;
 };
+type AgentResult<Output = string> = AgentResponse<Output> | AgentBlockedResult | AgentSuspendedResult;
 type AgentDeltaEvent = {
     type: "text_delta";
     delta: string;
@@ -173,6 +171,20 @@ type AgentToolCallDeltaEvent = {
 type AgentMemoryCompactionEvent = MemoryCompactionInfo & {
     type: "memory_compaction";
 };
+type AgentInteractionResponseEvent = {
+    type: "interaction_response";
+    response: ToolInteractionResponsePart;
+    sourceRunId: string;
+};
+type AgentSteerReceipt = Readonly<{
+    id: string;
+    status: "queued";
+}>;
+type AgentSteeringAppliedEvent = {
+    type: "steering_applied";
+    id: string;
+    turn: number;
+};
 type AgentChildStreamEventBase<Output = string, RawResponse = unknown> = {
     type: "turn_start";
     turn: number;
@@ -226,10 +238,10 @@ type AgentChildStreamEventBase<Output = string, RawResponse = unknown> = {
     type: "guardrail_decision";
     turn?: number | undefined;
     decision: GuardrailDecisionRecord;
-} | AgentMemoryCompactionEvent | {
+} | AgentMemoryCompactionEvent | AgentInteractionResponseEvent | AgentSteeringAppliedEvent | {
     type: "final";
-    result: AgentResponse<Output> | AgentBlockedResult;
-} | AgentApprovalRequiredEvent | AgentErrorStreamEvent;
+    result: AgentResult<Output>;
+} | AgentErrorStreamEvent;
 type AgentChildStreamEvent<Output = string, RawResponse = unknown> = AgentChildStreamEventBase<Output, RawResponse> | AgentToolCallDeltaEvent;
 type AgentToolStreamEvent = {
     type: "agent_tool_event";
@@ -243,7 +255,7 @@ type AgentToolStreamEvent = {
 };
 type AgentStreamEvent<Output = string, RawResponse = unknown> = AgentChildStreamEvent<Output, RawResponse> | AgentToolStreamEvent;
 interface AgentStream<Event = AgentStreamEvent> extends AsyncIterable<Event> {
-    steer(input: AgentSteerInput): boolean;
+    steer(input: AgentSteerInput): AgentSteerReceipt;
 }
 
 type AgentTraceInfo = {
@@ -278,11 +290,13 @@ type AgentRunStartArgs = {
     readonly maxTurns: number;
 };
 type AgentRunEndArgsBase = {
+    readonly runId: string;
     readonly text: string;
     readonly usage: DeepReadonly<Usage>;
     readonly messages: readonly DeepReadonly<Message>[];
     readonly sources?: readonly DeepReadonly<CompletionSource>[] | undefined;
     readonly providerToolCalls?: readonly DeepReadonly<ProviderToolCall>[] | undefined;
+    readonly resumedFrom?: DeepReadonly<AgentRunLink> | undefined;
 };
 type AgentRunEndArgs = (AgentRunEndArgsBase & {
     readonly status: "completed";
@@ -290,6 +304,9 @@ type AgentRunEndArgs = (AgentRunEndArgsBase & {
 }) | (AgentRunEndArgsBase & {
     readonly status: "blocked";
     readonly stage: "input" | "output";
+}) | (AgentRunEndArgsBase & {
+    readonly status: "suspended";
+    readonly interaction: DeepReadonly<AgentInteractionRequest>;
 });
 type AgentRunErrorArgs = {
     readonly error: unknown;
@@ -344,6 +361,9 @@ type AgentToolEndArgs = AgentToolStartArgs & {
 type AgentToolErrorArgs = AgentToolStartArgs & {
     readonly error: unknown;
 };
+type AgentToolSuspendedArgs = AgentToolStartArgs & {
+    readonly interaction: DeepReadonly<AgentInteractionRequest>;
+};
 type AgentToolStreamEventArgs = AgentToolStartArgs & {
     readonly event: DeepReadonly<ToolCallStreamEvent>;
 };
@@ -355,6 +375,7 @@ interface AgentGenerationObserver {
 interface AgentToolObserver {
     streamEvent?(args: AgentToolStreamEventArgs): void | Promise<void>;
     end(args: AgentToolEndArgs): void | Promise<void>;
+    suspend?(args: AgentToolSuspendedArgs): void | Promise<void>;
     error?(args: AgentToolErrorArgs): void | Promise<void>;
 }
 interface AgentRunObserver {
@@ -376,4 +397,4 @@ type AgentObservabilityOptions<Observers extends AgentObserverMap = AgentObserve
     readonly errorPolicy?: AgentObserverErrorPolicy | undefined;
 };
 
-export type { AgentApprovalDecision as A, AgentGenerationErrorArgs as B, AgentGenerationModelInfo as C, AgentGenerationObserver as D, AgentGenerationStartArgs as E, AgentGenerationUpdateArgs as F, AgentObservabilityOptions as G, AgentObserver as H, AgentObserverErrorPolicy as I, AgentObserverMap as J, AgentObserverTraceInfo as K, AgentRunEndArgs as L, AgentRunErrorArgs as M, AgentRunEventArgs as N, AgentRunObserver as O, AgentRunPromptRef as P, AgentRunStartArgs as Q, AgentToolEndArgs as R, AgentToolErrorArgs as S, AgentToolObserver as T, AgentToolStartArgs as U, AgentToolStreamEventArgs as V, AgentTraceInfo as W, AgentTraceOptions as X, AgentApprovalRequiredEvent as a, AgentApprovalRequiredResult as b, AgentBlockedResult as c, AgentChildStreamEvent as d, AgentDeltaEvent as e, AgentErrorEvent as f, AgentErrorStreamEvent as g, AgentFinishEvent as h, AgentInput as i, AgentLifecycle as j, AgentMemoryCompactionEvent as k, AgentPrompt as l, AgentResponse as m, AgentResult as n, AgentRunOptions as o, AgentRunSettings as p, AgentStartEvent as q, AgentSteerInput as r, AgentStepFinishEvent as s, AgentStream as t, AgentStreamEvent as u, AgentToolApprovalRequest as v, AgentToolCallDeltaEvent as w, AgentToolFinishEvent as x, AgentToolStartEvent as y, AgentGenerationEndArgs as z };
+export type { AgentBlockedResult as A, AgentGenerationObserver as B, AgentGenerationStartArgs as C, AgentGenerationUpdateArgs as D, AgentObservabilityOptions as E, AgentObserver as F, AgentObserverErrorPolicy as G, AgentObserverMap as H, AgentObserverTraceInfo as I, AgentRunEndArgs as J, AgentRunErrorArgs as K, AgentRunEventArgs as L, AgentRunObserver as M, AgentRunPromptRef as N, AgentRunStartArgs as O, AgentToolEndArgs as P, AgentToolErrorArgs as Q, AgentToolObserver as R, AgentToolStartArgs as S, AgentToolStreamEventArgs as T, AgentToolSuspendedArgs as U, AgentTraceInfo as V, AgentTraceOptions as W, AgentChildStreamEvent as a, AgentDeltaEvent as b, AgentErrorEvent as c, AgentErrorStreamEvent as d, AgentFinishEvent as e, AgentInput as f, AgentLifecycle as g, AgentMemoryCompactionEvent as h, AgentPrompt as i, AgentResponse as j, AgentResult as k, AgentRunOptions as l, AgentRunSettings as m, AgentStartEvent as n, AgentSteerInput as o, AgentSteerReceipt as p, AgentStepFinishEvent as q, AgentStream as r, AgentStreamEvent as s, AgentSuspendedResult as t, AgentToolCallDeltaEvent as u, AgentToolFinishEvent as v, AgentToolStartEvent as w, AgentGenerationEndArgs as x, AgentGenerationErrorArgs as y, AgentGenerationModelInfo as z };

package/dist/types-CIPaIbZo.d.ts

@@ -0,0 +1,105 @@
+import { M as Message, J as JsonObject, U as Usage } from './types-D9rKQ_as.js';
+import { M as MaybePromise } from './type-utils-CtHVDRn_.js';
+
+type GuardrailMode = "enforce" | "observe";
+type GuardrailBoundary = "input" | "output";
+type GuardrailRunContext = {
+    agentId: string;
+    runId: string;
+    sessionId?: string | undefined;
+    metadata?: JsonObject | undefined;
+};
+type GuardrailDecisionRecord = {
+    policyId: string;
+    guardrailId: string;
+    boundary: GuardrailBoundary;
+    mode: GuardrailMode;
+    action: GuardrailActionName;
+    applied: boolean;
+    reason?: string | undefined;
+    message?: string | undefined;
+    metadata?: JsonObject | undefined;
+    latencyMs: number;
+};
+type GuardrailActionName = "allow" | "block" | "rewrite" | "error";
+type GuardrailActionBase = {
+    reason?: string | undefined;
+    metadata?: JsonObject | undefined;
+};
+type GuardrailAllow = GuardrailActionBase & {
+    action: "allow";
+};
+type GuardrailBlock = GuardrailActionBase & {
+    action: "block";
+    reason: string;
+    message?: string | undefined;
+};
+type InputGuardrailRewrite = GuardrailActionBase & {
+    action: "rewrite";
+    prompt?: Message | undefined;
+    inputText?: string | undefined;
+};
+type OutputGuardrailRewrite = GuardrailActionBase & {
+    action: "rewrite";
+    outputText: string;
+};
+type InputGuardrailResult = GuardrailAllow | GuardrailBlock | InputGuardrailRewrite;
+type OutputGuardrailResult = GuardrailAllow | GuardrailBlock | OutputGuardrailRewrite;
+type GuardrailCommonActions = {
+    allow(options?: GuardrailActionBase): GuardrailAllow;
+    block(options: Omit<GuardrailBlock, "action">): GuardrailBlock;
+};
+type InputGuardrailActions = GuardrailCommonActions & {
+    rewrite(options: Omit<InputGuardrailRewrite, "action">): InputGuardrailRewrite;
+};
+type OutputGuardrailActions = GuardrailCommonActions & {
+    rewrite(options: Omit<OutputGuardrailRewrite, "action">): OutputGuardrailRewrite;
+};
+type InputGuardrailContext = {
+    prompt: Message;
+    history: Message[];
+    inputText: string;
+    run: GuardrailRunContext;
+};
+type OutputGuardrailContext = {
+    outputText: string;
+    messages: Message[];
+    usage: Usage;
+    run: GuardrailRunContext;
+};
+type InputGuardrail = {
+    id: string;
+    check(context: InputGuardrailContext, actions: InputGuardrailActions): MaybePromise<InputGuardrailResult | undefined>;
+};
+type OutputGuardrail = {
+    id: string;
+    check(context: OutputGuardrailContext, actions: OutputGuardrailActions): MaybePromise<OutputGuardrailResult | undefined>;
+};
+type GuardrailPolicy = {
+    id: string;
+    mode: GuardrailMode;
+    input: InputGuardrail[];
+    output: OutputGuardrail[];
+};
+type GuardrailPolicyOptions = {
+    id: string;
+    mode?: GuardrailMode | undefined;
+    input?: InputGuardrail[] | undefined;
+    output?: OutputGuardrail[] | undefined;
+};
+type GuardrailPolicyInput = GuardrailPolicy | GuardrailPolicy[];
+type InputGuardrailRunResult = {
+    prompt: Message;
+    inputText: string;
+    blocked: boolean;
+    message?: string | undefined;
+    decisions: GuardrailDecisionRecord[];
+};
+type OutputGuardrailRunResult = {
+    outputText: string;
+    blocked: boolean;
+    message?: string | undefined;
+    decisions: GuardrailDecisionRecord[];
+};
+
+export type { GuardrailBoundary as G, InputGuardrail as I, OutputGuardrail as O, GuardrailDecisionRecord as a, GuardrailMode as b, GuardrailPolicy as c, GuardrailPolicyInput as d, GuardrailPolicyOptions as e, InputGuardrailActions as f, InputGuardrailContext as g, OutputGuardrailActions as h, OutputGuardrailContext as i, InputGuardrailRunResult as j, OutputGuardrailRunResult as k, GuardrailActionBase as l, GuardrailActionName as m, GuardrailAllow as n, GuardrailBlock as o, GuardrailCommonActions as p, GuardrailRunContext as q, InputGuardrailResult as r, InputGuardrailRewrite as s, OutputGuardrailResult as t, OutputGuardrailRewrite as u };

package/dist/{types-CQ_ioXWK.d.ts → types-D9rKQ_as.d.ts}

@@ -97,6 +97,28 @@ type ToolResultPart = Readonly<{
     toolName: string;
     output: ToolResultOutput;
 }>;
+type ToolApprovalResponsePart = Readonly<{
+    type: "tool-approval-response";
+    interactionId: string;
+    toolCallId: string;
+    callId?: string;
+    toolName: string;
+    approved: boolean;
+    reason?: string;
+}>;
+type ToolQuestionAnswer = Readonly<{
+    questionId: string;
+    value: string;
+}>;
+type ToolQuestionResponsePart = Readonly<{
+    type: "tool-question-response";
+    interactionId: string;
+    toolCallId: string;
+    callId?: string;
+    toolName: string;
+    answers: readonly ToolQuestionAnswer[];
+}>;
+type ToolInteractionResponsePart = ToolApprovalResponsePart | ToolQuestionResponsePart;
 type UserContentPart = TextPart | ImagePart | FilePart;
 type AssistantContentPart = TextPart | ImagePart | FilePart | ReasoningPart | ToolCallPart;
 type SystemMessage<Metadata extends JsonObject = JsonObject> = Readonly<{
@@ -117,7 +139,7 @@ type AssistantMessage<Metadata extends JsonObject = JsonObject> = Readonly<{
 }>;
 type ToolMessage<Metadata extends JsonObject = JsonObject> = Readonly<{
     role: "tool";
-    content: readonly ToolResultPart[];
+    content: readonly (ToolResultPart | ToolInteractionResponsePart)[];
     metadata?: Metadata;
 }>;
 type Message<Metadata extends JsonObject = JsonObject> = SystemMessage<Metadata> | UserMessage<Metadata> | AssistantMessage<Metadata> | ToolMessage<Metadata>;
@@ -316,4 +338,4 @@ declare function assertCompletionRequestSupported(model: CompletionModel, reques
 }): void;
 declare function textFromAssistantContent(content: readonly AssistantContentPart[]): string;
 
-export { textFromAssistantContent as $, type AssistantContentPart as A, type UserContentPart as B, type CompletionModel as C, type Document as D, type UserMessage as E, type FileData as F, calculateContextUsage as G, getAssistantGenerationMetadata as H, type ImageDetail as I, type JsonObject as J, isProviderTool as K, resolveModelContextLimits as L, type Message as M, withContextUsage as N, CompletionCapabilityError as O, type ProviderTool as P, type CompletionModelCapabilities as Q, type ReasoningContentType as R, type SystemMessage as S, type TextPart as T, Usage as U, type CompletionStreamPart as V, type StreamingCompletionModel as W, type ToolCallArgumentsMode as X, type UsageDetails as Y, assertCompletionRequestSupported as Z, reasoningDisplayText as _, type AssistantGenerationMetadata as a, type AssistantMessage as b, type CompletionModelInfo as c, type CompletionModelStreamEvent as d, type CompletionRequest as e, type CompletionResponse as f, type CompletionResult as g, type CompletionSource as h, type CompletionStreamEvent as i, type CompletionTool as j, type ContextUsage as k, type FilePart as l, type ImagePart as m, type JsonPrimitive as n, type JsonValue as o, type ModelContextLimits as p, type ProviderToolCall as q, type ReasoningDetail as r, type ReasoningPart as s, type ToolCallPart as t, type ToolChoice as u, type ToolDefinition as v, type ToolMessage as w, type ToolResultContentPart as x, type ToolResultOutput as y, type ToolResultPart as z };
+export { type ToolQuestionResponsePart as $, type AssistantContentPart as A, type UserContentPart as B, type CompletionModel as C, type Document as D, type UserMessage as E, type FileData as F, calculateContextUsage as G, getAssistantGenerationMetadata as H, type ImageDetail as I, type JsonObject as J, isProviderTool as K, resolveModelContextLimits as L, type Message as M, withContextUsage as N, CompletionCapabilityError as O, type ProviderTool as P, type CompletionModelCapabilities as Q, type ReasoningContentType as R, type SystemMessage as S, type TextPart as T, Usage as U, type CompletionStreamPart as V, type StreamingCompletionModel as W, type ToolApprovalResponsePart as X, type ToolCallArgumentsMode as Y, type ToolInteractionResponsePart as Z, type ToolQuestionAnswer as _, type AssistantGenerationMetadata as a, type UsageDetails as a0, assertCompletionRequestSupported as a1, reasoningDisplayText as a2, textFromAssistantContent as a3, type AssistantMessage as b, type CompletionModelInfo as c, type CompletionModelStreamEvent as d, type CompletionRequest as e, type CompletionResponse as f, type CompletionResult as g, type CompletionSource as h, type CompletionStreamEvent as i, type CompletionTool as j, type ContextUsage as k, type FilePart as l, type ImagePart as m, type JsonPrimitive as n, type JsonValue as o, type ModelContextLimits as p, type ProviderToolCall as q, type ReasoningDetail as r, type ReasoningPart as s, type ToolCallPart as t, type ToolChoice as u, type ToolDefinition as v, type ToolMessage as w, type ToolResultContentPart as x, type ToolResultOutput as y, type ToolResultPart as z };

package/dist/{types-BVzM4RsC.d.ts → types-DbolvLtZ.d.ts}

@@ -1,4 +1,4 @@
-import { U as Usage, J as JsonObject, M as Message, S as SystemMessage, C as CompletionModel } from './types-CQ_ioXWK.js';
+import { U as Usage, J as JsonObject, M as Message, S as SystemMessage, C as CompletionModel } from './types-D9rKQ_as.js';
 import { b as RetrySetting } from './retry-CjvSlKGW.js';
 
 type MemorySavePolicy = "message" | "turn" | "run";

package/dist/{types-DiJqJejp.d.ts → types-RT3cuyRk.d.ts}

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

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

@@ -1,10 +1,10 @@
-import { b as VectorMetadataValue, V as VectorMetadata, a as EmbeddedDocument } from '../types-Cr4uiYo5.js';
-import { T as Tool } from '../tool--Mz4v1eL.js';
-import { V as VectorFilter, R as RetrieveDocumentsOptions, a as VectorSearchResult, f as RetrieveHybridDocumentsOptions, d as VectorStore, I as IndexStrategy, g as VectorStoreUpsertOptions, h as VectorSearchRequest, b as VectorInspectRequest, c as VectorInspectPage, i as VectorSearchToolOptions } from '../types-Dld1TpWj.js';
-export { D as DenseVectorSearchToolOptions, j as HybridVectorSearchRequest, k as HybridVectorSearchToolOptions, H as HybridVectorStore, L as LshOptions, l as RetrieveDocumentsBaseOptions, e as VectorFusion, m as VectorInspectItem, n as VectorMetric, o as VectorSearchToolBaseOptions } from '../types-Dld1TpWj.js';
+import { V as VectorMetadata, b as VectorMetadataValue, a as EmbeddedDocument } from '../types-Cr4uiYo5.js';
+import { T as Tool } from '../tool-r62gf3QY.js';
+import { V as VectorFilter, R as RetrieveDocumentsOptions, a as VectorSearchResult, f as RetrieveHybridDocumentsOptions, d as VectorStore, I as IndexStrategy, g as VectorStoreUpsertOptions, h as VectorSearchRequest, b as VectorInspectRequest, c as VectorInspectPage, i as VectorSearchToolOptions } from '../types-C3gv9EX6.js';
+export { D as DenseVectorSearchToolOptions, j as HybridVectorSearchRequest, k as HybridVectorSearchToolOptions, H as HybridVectorStore, L as LshOptions, l as RetrieveDocumentsBaseOptions, e as VectorFusion, m as VectorInspectItem, n as VectorMetric, o as VectorSearchToolBaseOptions } from '../types-C3gv9EX6.js';
 import '../model-call-options-CZkSw_xN.js';
 import '../retry-CjvSlKGW.js';
-import '../types-CQ_ioXWK.js';
+import '../types-D9rKQ_as.js';
 
 declare const vectorFilter: {
     eq(key: string, value: VectorMetadataValue): VectorFilter;
@@ -13,6 +13,7 @@ declare const vectorFilter: {
     and(left: VectorFilter, right: VectorFilter): VectorFilter;
     or(left: VectorFilter, right: VectorFilter): VectorFilter;
 };
+declare function matchesVectorFilter(metadata: VectorMetadata | undefined, filter: VectorFilter | undefined): boolean;
 
 declare function retrieveDocuments<T, Metadata extends VectorMetadata = VectorMetadata>(options: RetrieveDocumentsOptions<T, Metadata>): Promise<Array<VectorSearchResult<T, Metadata>>>;
 declare function retrieveDocuments<T, Metadata extends VectorMetadata = VectorMetadata>(options: RetrieveHybridDocumentsOptions<T, Metadata>): Promise<Array<VectorSearchResult<T, Metadata>>>;
@@ -54,4 +55,4 @@ declare function createVectorSearchTool<T, Metadata extends VectorMetadata>(opti
     topK?: number;
 }, Array<VectorSearchResult<T, Metadata>>>;
 
-export { InMemoryVectorStore, type InMemoryVectorStoreFromDocumentsOptions, type InMemoryVectorStoreOptions, IndexStrategy, RetrieveDocumentsOptions, RetrieveHybridDocumentsOptions, VectorFilter, VectorInspectPage, VectorInspectRequest, VectorSearchRequest, VectorSearchResult, VectorSearchToolOptions, VectorStore, VectorStoreUpsertOptions, createVectorSearchTool, retrieveDocuments, vectorFilter };
+export { InMemoryVectorStore, type InMemoryVectorStoreFromDocumentsOptions, type InMemoryVectorStoreOptions, IndexStrategy, RetrieveDocumentsOptions, RetrieveHybridDocumentsOptions, VectorFilter, VectorInspectPage, VectorInspectRequest, VectorSearchRequest, VectorSearchResult, VectorSearchToolOptions, VectorStore, VectorStoreUpsertOptions, createVectorSearchTool, matchesVectorFilter, retrieveDocuments, vectorFilter };

package/dist/vector-store/index.js

@@ -1,15 +1,18 @@
 import {
   InMemoryVectorStore,
   createVectorSearchTool,
+  matchesVectorFilter,
   retrieveDocuments,
   vectorFilter
-} from "../chunk-77AIYARB.js";
-import "../chunk-FMHLROPQ.js";
-import "../chunk-TIZYTPJO.js";
+} from "../chunk-XYTPYUGB.js";
+import "../chunk-GQL5KRAH.js";
+import "../chunk-3RM57ZT2.js";
+import "../chunk-PK5LKOFL.js";
 import "../chunk-FN7HLLAZ.js";
 export {
   InMemoryVectorStore,
   createVectorSearchTool,
+  matchesVectorFilter,
   retrieveDocuments,
   vectorFilter
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@anvia/core",
-  "version": "1.0.0-rc.2",
+  "version": "1.0.0-rc.4",
   "description": "Core runtime primitives for context-aware Anvia agents.",
   "author": "anvia",
   "maintainer": "Indra Zulfi",
@@ -17,6 +17,7 @@
     "access": "public"
   },
   "type": "module",
+  "sideEffects": false,
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",
   "exports": {
@@ -48,9 +49,9 @@
       "types": "./dist/evals/index.d.ts",
       "import": "./dist/evals/index.js"
     },
-    "./loaders": {
-      "types": "./dist/loaders/index.d.ts",
-      "import": "./dist/loaders/index.js"
+    "./documents": {
+      "types": "./dist/documents/index.d.ts",
+      "import": "./dist/documents/index.js"
     },
     "./extractor": {
       "types": "./dist/extractor/index.d.ts",
@@ -108,7 +109,6 @@
   "dependencies": {
     "@modelcontextprotocol/sdk": "^1.30.0",
     "pdfjs-dist": "^6.2.108",
-    "tinyglobby": "^0.2.17",
     "undici": "^8.10.0",
     "yaml": "^2.9.0",
     "zod": "^4.4.3"
@@ -120,7 +120,7 @@
     "vitest": "^4.0.8"
   },
   "scripts": {
-    "build": "tsup src/index.ts src/agent/index.ts src/internal/agent.ts src/speech-generation/index.ts src/completion/index.ts src/embeddings/index.ts src/evals/index.ts src/image-generation/index.ts src/loaders/index.ts src/extractor/index.ts src/guardrails/index.ts src/mcp/index.ts src/memory/index.ts src/model-listing/index.ts src/observability/index.ts src/pipeline/index.ts src/skills/index.ts src/streaming/index.ts src/tool/index.ts src/transcription/index.ts src/vector-store/index.ts --format esm --dts --sourcemap --clean",
+    "build": "tsup src/index.ts src/agent/index.ts src/internal/agent.ts src/speech-generation/index.ts src/completion/index.ts src/embeddings/index.ts src/evals/index.ts src/image-generation/index.ts src/documents/index.ts src/extractor/index.ts src/guardrails/index.ts src/mcp/index.ts src/memory/index.ts src/model-listing/index.ts src/observability/index.ts src/pipeline/index.ts src/skills/index.ts src/streaming/index.ts src/tool/index.ts src/transcription/index.ts src/vector-store/index.ts --format esm --dts --sourcemap --clean",
     "test": "vitest run",
     "typecheck": "tsc --noEmit"
   }