avantgate 1.1.2 → 1.2.0

package/dist/agent/registry.d.ts

@@ -0,0 +1,71 @@
+import type { RegisteredTool, ToolDescriptor, VercelAiCoreTool } from "./types";
+export interface ToRecordOptions {
+    anonymize?: boolean;
+    domain?: string;
+}
+export interface ToolDescriptorFilter {
+    domain?: string;
+    role?: string;
+}
+/**
+ * Centralized catalog for managing and filtering tools with permissions, domains and metadata.
+ * Supports O(1) Key-Value lookup by technical ID and by public alias.
+ */
+export declare class ToolRegistry {
+    private readonly toolsById;
+    private readonly toolsByPublicName;
+    /**
+     * Registers a new tool in the registry.
+     */
+    register(toolDef: RegisteredTool | VercelAiCoreTool): this;
+    /**
+     * Registers multiple tools in batch.
+     */
+    registerMany(tools: (RegisteredTool | VercelAiCoreTool)[]): this;
+    /**
+     * Retrieves a tool by its ID or public name/alias.
+     */
+    get(idOrName: string): RegisteredTool | undefined;
+    /**
+     * Retrieves a tool strictly by its immutable technical ID (O(1)).
+     */
+    getById(id: string): RegisteredTool | undefined;
+    /**
+     * Retrieves a tool by its public alias seen by the LLM (O(1)).
+     */
+    getByPublicName(publicName: string): RegisteredTool | undefined;
+    /**
+     * Checks if a tool is registered by ID or public name.
+     */
+    has(idOrName: string): boolean;
+    /**
+     * Returns all registered tools without duplicates.
+     */
+    getAll(): RegisteredTool[];
+    /**
+     * Filters tools belonging to a specific business domain.
+     */
+    getByDomain(domain: string): RegisteredTool[];
+    /**
+     * Filters tools matching a specific workflow phase.
+     */
+    getByPhase(phase: string): RegisteredTool[];
+    /**
+     * Filters tools matching the user's roles (RBAC).
+     */
+    filterByRoles(userRoles: string[]): RegisteredTool[];
+    /**
+     * Exports headless technical descriptors without UI rendering coupling.
+     */
+    getDescriptors(filter?: ToolDescriptorFilter): ToolDescriptor[];
+    /**
+     * Converts instance registered tools to the record map format required by Vercel AI SDK.
+     */
+    toRecord(options?: ToRecordOptions): Record<string, VercelAiCoreTool>;
+    /**
+     * Converts a list of registered tools to the record map format required by Vercel AI SDK.
+     * If anonymize is true, uses alias (if defined) as dictionary key instead of technical name.
+     */
+    static toRecord(tools: RegisteredTool[], options?: ToRecordOptions): Record<string, VercelAiCoreTool>;
+}
+//# sourceMappingURL=registry.d.ts.map

package/dist/agent/registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../src/agent/registry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,cAAc,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAC;AAEhF,MAAM,WAAW,eAAe;IAC9B,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,oBAAoB;IACnC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAoED;;;GAGG;AACH,qBAAa,YAAY;IACvB,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAqC;IAC/D,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAAqC;IAEvE;;OAEG;IACI,QAAQ,CAAC,OAAO,EAAE,cAAc,GAAG,gBAAgB,GAAG,IAAI;IASjE;;OAEG;IACI,YAAY,CAAC,KAAK,EAAE,CAAC,cAAc,GAAG,gBAAgB,CAAC,EAAE,GAAG,IAAI;IAOvE;;OAEG;IACI,GAAG,CAAC,QAAQ,EAAE,MAAM,GAAG,cAAc,GAAG,SAAS;IAIxD;;OAEG;IACI,OAAO,CAAC,EAAE,EAAE,MAAM,GAAG,cAAc,GAAG,SAAS;IAItD;;OAEG;IACI,eAAe,CAAC,UAAU,EAAE,MAAM,GAAG,cAAc,GAAG,SAAS;IAItE;;OAEG;IACI,GAAG,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO;IAIrC;;OAEG;IACI,MAAM,IAAI,cAAc,EAAE;IAIjC;;OAEG;IACI,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,cAAc,EAAE;IAIpD;;OAEG;IACI,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,cAAc,EAAE;IASlD;;OAEG;IACI,aAAa,CAAC,SAAS,EAAE,MAAM,EAAE,GAAG,cAAc,EAAE;IAW3D;;OAEG;IACI,cAAc,CAAC,MAAM,CAAC,EAAE,oBAAoB,GAAG,cAAc,EAAE;IAWtE;;OAEG;IACI,QAAQ,CAAC,OAAO,GAAE,eAAoB,GAAG,MAAM,CAAC,MAAM,EAAE,gBAAgB,CAAC;IAIhF;;;OAGG;WACW,QAAQ,CACpB,KAAK,EAAE,cAAc,EAAE,EACvB,OAAO,GAAE,eAAoB,GAC5B,MAAM,CAAC,MAAM,EAAE,gBAAgB,CAAC;CAYpC"}

package/dist/agent/step-runner.d.ts

@@ -0,0 +1,12 @@
+import type { StepRunnerConfig, StepRunnerContext, StepStorageAdapter } from "./types";
+export interface StepRunnerInstance extends StepRunnerContext {
+    storage: StepStorageAdapter;
+    approveStep<T = unknown>(stepId: string, approvalData?: T): Promise<void>;
+    rejectStep(stepId: string, reason?: string): Promise<void>;
+}
+/**
+ * Creates a serverless durable step runner for stateful multi-step agent execution
+ * with automatic idempotence and Human-in-the-Loop approval capability.
+ */
+export declare function createStepRunner(config: StepRunnerConfig): StepRunnerInstance;
+//# sourceMappingURL=step-runner.d.ts.map

package/dist/agent/step-runner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"step-runner.d.ts","sourceRoot":"","sources":["../../src/agent/step-runner.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAGV,gBAAgB,EAChB,iBAAiB,EACjB,kBAAkB,EACnB,MAAM,SAAS,CAAC;AAEjB,MAAM,WAAW,kBAAmB,SAAQ,iBAAiB;IAC3D,OAAO,EAAE,kBAAkB,CAAC;IAC5B,WAAW,CAAC,CAAC,GAAG,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,YAAY,CAAC,EAAE,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC1E,UAAU,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAC5D;AAkGD;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,gBAAgB,GAAG,kBAAkB,CA0B7E"}

package/dist/agent/strategy.d.ts

@@ -0,0 +1,37 @@
+import type { RegisteredTool, ToolContext, ToolSelectionStrategy, VercelAiCoreTool } from "./types";
+/**
+ * Strategy selecting tools that match the current workflow phase.
+ */
+export declare class PhaseBasedToolStrategy implements ToolSelectionStrategy {
+    selectTools(tools: RegisteredTool[], context: ToolContext): RegisteredTool[];
+}
+/**
+ * Strategy selecting tools permitted for the user's role (RBAC).
+ */
+export declare class RoleBasedToolStrategy implements ToolSelectionStrategy {
+    selectTools(tools: RegisteredTool[], context: ToolContext): RegisteredTool[];
+}
+export interface AccessControlToolStrategyOptions {
+    allowedDomains?: string[];
+}
+/**
+ * Unified strategy evaluating role, permissions and allowed business domains in a single pass.
+ */
+export declare class AccessControlToolStrategy implements ToolSelectionStrategy {
+    private readonly allowedDomains?;
+    constructor(options?: AccessControlToolStrategyOptions);
+    selectTools(tools: RegisteredTool[], context: ToolContext): RegisteredTool[];
+}
+/**
+ * Composite strategy applying multiple selection strategies sequentially (intersection).
+ */
+export declare class CompositeToolStrategy implements ToolSelectionStrategy {
+    private readonly strategies;
+    constructor(strategies: ToolSelectionStrategy[]);
+    selectTools(tools: RegisteredTool[], context: ToolContext): Promise<RegisteredTool[]>;
+}
+/**
+ * Convenience helper to execute a strategy and convert selected tools to Vercel AI SDK format.
+ */
+export declare function applyToolStrategy(tools: RegisteredTool[], strategy: ToolSelectionStrategy, context: ToolContext): Promise<Record<string, VercelAiCoreTool>>;
+//# sourceMappingURL=strategy.d.ts.map

package/dist/agent/strategy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"strategy.d.ts","sourceRoot":"","sources":["../../src/agent/strategy.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,cAAc,EACd,WAAW,EACX,qBAAqB,EACrB,gBAAgB,EACjB,MAAM,SAAS,CAAC;AAEjB;;GAEG;AACH,qBAAa,sBAAuB,YAAW,qBAAqB;IAC3D,WAAW,CAChB,KAAK,EAAE,cAAc,EAAE,EACvB,OAAO,EAAE,WAAW,GACnB,cAAc,EAAE;CAYpB;AAED;;GAEG;AACH,qBAAa,qBAAsB,YAAW,qBAAqB;IAC1D,WAAW,CAChB,KAAK,EAAE,cAAc,EAAE,EACvB,OAAO,EAAE,WAAW,GACnB,cAAc,EAAE;CAgBpB;AAED,MAAM,WAAW,gCAAgC;IAC/C,cAAc,CAAC,EAAE,MAAM,EAAE,CAAC;CAC3B;AAmCD;;GAEG;AACH,qBAAa,yBAA0B,YAAW,qBAAqB;IACrE,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAC,CAAc;gBAElC,OAAO,CAAC,EAAE,gCAAgC;IAM/C,WAAW,CAChB,KAAK,EAAE,cAAc,EAAE,EACvB,OAAO,EAAE,WAAW,GACnB,cAAc,EAAE;CAQpB;AAED;;GAEG;AACH,qBAAa,qBAAsB,YAAW,qBAAqB;IACjE,OAAO,CAAC,QAAQ,CAAC,UAAU,CAA0B;gBAEzC,UAAU,EAAE,qBAAqB,EAAE;IAIlC,WAAW,CACtB,KAAK,EAAE,cAAc,EAAE,EACvB,OAAO,EAAE,WAAW,GACnB,OAAO,CAAC,cAAc,EAAE,CAAC;CAO7B;AAED;;GAEG;AACH,wBAAsB,iBAAiB,CACrC,KAAK,EAAE,cAAc,EAAE,EACvB,QAAQ,EAAE,qBAAqB,EAC/B,OAAO,EAAE,WAAW,GACnB,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,gBAAgB,CAAC,CAAC,CAG3C"}

package/dist/agent/telemetry/http-exporter.d.ts

@@ -0,0 +1,24 @@
+import type { HttpTelemetryExporterOptions, TelemetryEvent, TelemetryUsageSummary } from "./types";
+/**
+ * Asynchronous, zero-dependency HTTP Telemetry Exporter for the avantGate platform.
+ * Batches events in memory and sends them in background without blocking agent execution.
+ */
+export declare class HttpTelemetryExporter {
+    private readonly apiKey;
+    private readonly endpoint;
+    private readonly agentName?;
+    private readonly batchIntervalMs;
+    private readonly maxBatchSize;
+    private readonly maxQueueSize;
+    private readonly fetchFn;
+    private readonly onError?;
+    private queue;
+    private timer;
+    private isFlushing;
+    constructor(options: HttpTelemetryExporterOptions);
+    private startTimer;
+    enqueue(runId: string, event: TelemetryEvent, usage?: TelemetryUsageSummary): void;
+    flush(): Promise<void>;
+    shutdown(): Promise<void>;
+}
+//# sourceMappingURL=http-exporter.d.ts.map

package/dist/agent/telemetry/http-exporter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"http-exporter.d.ts","sourceRoot":"","sources":["../../../src/agent/telemetry/http-exporter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,4BAA4B,EAC5B,cAAc,EAEd,qBAAqB,EACtB,MAAM,SAAS,CAAC;AA6EjB;;;GAGG;AACH,qBAAa,qBAAqB;IAChC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAChC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAS;IAClC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAS;IACpC,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAS;IACzC,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAS;IACtC,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAS;IACtC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAe;IACvC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAyB;IAElD,OAAO,CAAC,KAAK,CAAoB;IACjC,OAAO,CAAC,KAAK,CAA+C;IAC5D,OAAO,CAAC,UAAU,CAAS;gBAEf,OAAO,EAAE,4BAA4B;IAajD,OAAO,CAAC,UAAU;IAWX,OAAO,CACZ,KAAK,EAAE,MAAM,EACb,KAAK,EAAE,cAAc,EACrB,KAAK,CAAC,EAAE,qBAAqB,GAC5B,IAAI;IAWM,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IA0BtB,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;CAOvC"}

package/dist/agent/telemetry/index.d.ts

@@ -0,0 +1,3 @@
+export * from "./types";
+export * from "./http-exporter";
+//# sourceMappingURL=index.d.ts.map

package/dist/agent/telemetry/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/agent/telemetry/index.ts"],"names":[],"mappings":"AAAA,cAAc,SAAS,CAAC;AACxB,cAAc,iBAAiB,CAAC"}

package/dist/agent/telemetry/types.d.ts

@@ -0,0 +1,92 @@
+/**
+ * Supported telemetry event types for the avantGate observability platform.
+ */
+export type TelemetryEventType = "STEP_START" | "STEP_COMPLETED" | "STEP_FAILED" | "STEP_APPROVAL_REQUEST" | "TOOL_EXECUTION";
+/**
+ * Base properties shared across all telemetry events.
+ */
+export interface BaseTelemetryEvent {
+    type: TelemetryEventType;
+    timestamp: string;
+}
+export interface StepStartEvent extends BaseTelemetryEvent {
+    type: "STEP_START";
+    stepName: string;
+    metadata?: Record<string, unknown>;
+}
+export interface StepCompletedEvent extends BaseTelemetryEvent {
+    type: "STEP_COMPLETED";
+    stepName: string;
+    durationMs?: number;
+    piiDetectedCount?: number;
+    resultSummary?: unknown;
+    metadata?: Record<string, unknown>;
+}
+export interface StepFailedEvent extends BaseTelemetryEvent {
+    type: "STEP_FAILED";
+    stepName: string;
+    durationMs?: number;
+    error: string;
+}
+export interface StepApprovalRequestEvent extends BaseTelemetryEvent {
+    type: "STEP_APPROVAL_REQUEST";
+    stepName: string;
+    actionType?: string;
+    payloadSummary?: unknown;
+}
+export interface ToolExecutionTelemetryEvent extends BaseTelemetryEvent {
+    type: "TOOL_EXECUTION";
+    toolId: string;
+    toolName: string;
+    aliasUsed?: string;
+    durationMs: number;
+    success: boolean;
+    parentToolId?: string;
+    depth?: number;
+    llmSummary?: unknown;
+    piiFilteredCount?: number;
+    tokenCount?: number;
+    tokens?: {
+        promptTokens?: number;
+        completionTokens?: number;
+        totalTokens?: number;
+    };
+    costUsd?: number;
+    cached?: boolean;
+    error?: string;
+}
+export type TelemetryEvent = StepStartEvent | StepCompletedEvent | StepFailedEvent | StepApprovalRequestEvent | ToolExecutionTelemetryEvent;
+/**
+ * Consolidates token usage and FinOps metrics for a batch or run.
+ */
+export interface TelemetryUsageSummary {
+    model?: string;
+    promptTokens?: number;
+    completionTokens?: number;
+    totalTokens?: number;
+    costUsd?: number;
+}
+/**
+ * Payload schema ingested by POST /api/v1/ingest/events according to DESIGN-005 §5.1.
+ */
+export interface TelemetryIngestPayload {
+    runId: string;
+    agentName?: string;
+    timestamp: string;
+    events: TelemetryEvent[];
+    usage?: TelemetryUsageSummary;
+}
+/**
+ * Configuration options for the HTTP Telemetry Exporter.
+ */
+export interface HttpTelemetryExporterOptions {
+    apiKey: string;
+    endpoint?: string;
+    agentName?: string;
+    batchIntervalMs?: number;
+    maxBatchSize?: number;
+    maxQueueSize?: number;
+    fetchFn?: typeof fetch;
+    onError?: (error: Error) => void;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/agent/telemetry/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/agent/telemetry/types.ts"],"names":[],"mappings":"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"}

package/dist/agent/tool-invoker.d.ts

@@ -0,0 +1,17 @@
+import { ToolRegistry } from "./registry";
+import type { StepStorageAdapter, ToolExecutionContext } from "./types";
+export interface ToolInvokerOptions {
+    maxDepth?: number;
+    maxTotalSubCalls?: number;
+    workflowId?: string;
+    stepId?: string;
+}
+export interface ToolInvoker {
+    invokeTool<TResult = unknown>(toolId: string, args: unknown, context?: ToolExecutionContext): Promise<TResult>;
+}
+/**
+ * Creates an intelligent, concurrency-safe tool invoker with cycle detection,
+ * depth guard, result caching, and database execution tracing.
+ */
+export declare function createToolInvoker(registry: ToolRegistry, storage?: StepStorageAdapter, options?: ToolInvokerOptions): ToolInvoker;
+//# sourceMappingURL=tool-invoker.d.ts.map

package/dist/agent/tool-invoker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-invoker.d.ts","sourceRoot":"","sources":["../../src/agent/tool-invoker.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAE1C,OAAO,KAAK,EACV,kBAAkB,EAClB,oBAAoB,EAErB,MAAM,SAAS,CAAC;AAEjB,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,WAAW;IAC1B,UAAU,CAAC,OAAO,GAAG,OAAO,EAC1B,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,OAAO,EACb,OAAO,CAAC,EAAE,oBAAoB,GAC7B,OAAO,CAAC,OAAO,CAAC,CAAC;CACrB;AA0CD;;;GAGG;AACH,wBAAgB,iBAAiB,CAC/B,QAAQ,EAAE,YAAY,EACtB,OAAO,CAAC,EAAE,kBAAkB,EAC5B,OAAO,GAAE,kBAAuB,GAC/B,WAAW,CAqHb"}

package/dist/agent/tool-state.d.ts

@@ -0,0 +1,7 @@
+import type { StepStorageAdapter, ToolSharedState } from "./types";
+/**
+ * Creates a shared blackboard state instance for inter-tool data sharing.
+ * Backed by the persistent storage adapter if available, otherwise runs in-memory.
+ */
+export declare function createToolSharedState(storage?: StepStorageAdapter): ToolSharedState;
+//# sourceMappingURL=tool-state.d.ts.map

package/dist/agent/tool-state.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-state.d.ts","sourceRoot":"","sources":["../../src/agent/tool-state.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AAOnE;;;GAGG;AACH,wBAAgB,qBAAqB,CACnC,OAAO,CAAC,EAAE,kBAAkB,GAC3B,eAAe,CAgDjB"}

package/dist/agent/types.d.ts

@@ -0,0 +1,243 @@
+import type { z } from "zod";
+/**
+ * Lifecycle status for durable agent workflow steps.
+ */
+export type StepStatus = "PENDING" | "RUNNING" | "COMPLETED" | "FAILED" | "WAITING_APPROVAL";
+/**
+ * Token usage metrics for LLM calls and tool executions.
+ */
+export interface TokenUsage {
+    promptTokens?: number;
+    completionTokens?: number;
+    totalTokens?: number;
+}
+/**
+ * Record representing a durable step stored in persistence.
+ */
+export interface StepRecord<TResult = unknown> {
+    workflowId: string;
+    stepId: string;
+    runId?: string;
+    status: StepStatus;
+    result?: TResult;
+    error?: string;
+    piiDetectedCount?: number;
+    tokens?: TokenUsage;
+    costUsd?: number;
+    metadata?: Record<string, unknown>;
+    createdAt: string;
+    updatedAt: string;
+}
+/**
+ * Record representing a durable tool execution stored in persistence for hierarchical tracing.
+ */
+export interface ToolExecutionRecord {
+    executionId: string;
+    workflowId?: string;
+    stepId?: string;
+    runId?: string;
+    toolId: string;
+    parentToolId?: string;
+    aliasUsed?: string;
+    depth: number;
+    inputArgs?: unknown;
+    outputSummary?: unknown;
+    durationMs: number;
+    status: "SUCCESS" | "FAILED";
+    error?: string;
+    cached?: boolean;
+    piiFilteredCount?: number;
+    tokens?: TokenUsage;
+    costUsd?: number;
+    createdAt: string;
+}
+/**
+ * Shared Blackboard state interface enabling inter-tool data exchange without context pollution.
+ */
+export interface ToolSharedState {
+    get<T = unknown>(key: string): Promise<T | null>;
+    set<T = unknown>(key: string, value: T, ttlSeconds?: number): Promise<void>;
+    delete(key: string): Promise<void>;
+    clear?(): Promise<void>;
+}
+/**
+ * Hexagonal Port Interface: Pure abstract storage contract.
+ * Any storage backend (Prisma, Drizzle, Kysely, SQLite, Mongo, Redis, Supabase)
+ * can plug into avantgate/agent by implementing this contract.
+ */
+export interface StepStorageAdapter {
+    getStep<T = unknown>(workflowId: string, stepId: string): Promise<StepRecord<T> | null>;
+    saveStep<T = unknown>(step: StepRecord<T>): Promise<void>;
+    updateStepStatus<T = unknown>(workflowId: string, stepId: string, status: StepStatus, patch?: Partial<StepRecord<T>>): Promise<void>;
+    listSteps(workflowId: string): Promise<StepRecord[]>;
+    saveToolExecution?(record: ToolExecutionRecord): Promise<void>;
+    listToolExecutions?(workflowId?: string, stepId?: string): Promise<ToolExecutionRecord[]>;
+    getCachedToolResult?<T = unknown>(cacheKey: string): Promise<T | null>;
+    setCachedToolResult?<T = unknown>(cacheKey: string, result: T, ttlSeconds: number): Promise<void>;
+    getStateValue?<T = unknown>(key: string): Promise<T | null>;
+    setStateValue?<T = unknown>(key: string, value: T, ttlSeconds?: number): Promise<void>;
+    deleteStateValue?(key: string): Promise<void>;
+    clearStateValues?(): Promise<void>;
+}
+/**
+ * Options for step approval in Human-in-the-Loop workflows.
+ */
+export interface StepApprovalOptions<T = unknown> {
+    prompt?: string;
+    metadata?: Record<string, unknown>;
+    defaultResult?: T;
+}
+/**
+ * Execution context passed to workflow handlers.
+ */
+export interface StepRunnerContext {
+    workflowId: string;
+    run<T>(stepId: string, executeFn: () => Promise<T>): Promise<T>;
+    waitForApproval<T = unknown>(stepId: string, options?: StepApprovalOptions<T>): Promise<T>;
+}
+/**
+ * Configuration options for creating a durable step runner.
+ */
+export interface StepRunnerConfig {
+    workflowId: string;
+    runId?: string;
+    storage?: StepStorageAdapter;
+}
+/**
+ * Context received by tool execution, supporting inter-tool chaining and shared state.
+ */
+export interface ToolExecutionContext {
+    toolCallId?: string;
+    messages?: unknown[];
+    abortSignal?: AbortSignal;
+    workflowId?: string;
+    runId?: string;
+    stepId?: string;
+    callChain?: readonly string[];
+    callTool?: <TResult = unknown>(toolId: string, args: unknown) => Promise<TResult>;
+    state?: ToolSharedState;
+    storage?: StepStorageAdapter;
+    tokens?: TokenUsage;
+    costUsd?: number;
+    onInvalidationTags?: (tags: string[]) => void | Promise<void>;
+    [key: string]: unknown;
+}
+/**
+ * User and environment context injected into tools.
+ */
+export interface ToolContext {
+    userId?: string;
+    tenantId?: string;
+    role?: string;
+    roles?: string[];
+    permissions?: string[];
+    phase?: string;
+    metadata?: Record<string, unknown>;
+    [key: string]: unknown;
+}
+/**
+ * Projection function converting raw tool result, input arguments and execution context
+ * into a safe, minimal LLM DTO.
+ */
+export type LLMDtoMapper<TArgs = any, TResult = any, TLLMDto = unknown> = (result: TResult, args: TArgs, context?: ToolExecutionContext) => TLLMDto | Promise<TLLMDto>;
+/**
+ * Out-of-band callback streaming raw or rich tool data directly to the client UI.
+ */
+export type ClientDtoCallback<TResult = unknown> = (data: TResult) => void | Promise<void>;
+/**
+ * Universal resource invalidation tags generator (string[] or function).
+ */
+export type InvalidationTagsResolver<TArgs = any, TResult = any> = string[] | ((args: TArgs, result?: TResult) => string[] | Promise<string[]>);
+/**
+ * Guardrail hook for data access control (anti-IDOR) executed prior to tool execution.
+ */
+export type DataAccessGuard<TArgs = any> = (args: TArgs, context?: ToolExecutionContext) => boolean | Promise<boolean>;
+/**
+ * Configuration for creating an isolated tool with PII protection, Dual-Channel DTO,
+ * access governance, stable ID, aliasing and caching.
+ */
+export interface IsolatedToolConfig<TArgs = any, TResult = any, TLLMDto = unknown, TClientDto = TResult> {
+    id?: string;
+    name: string;
+    alias?: string;
+    description: string;
+    domain?: string;
+    resource?: string;
+    roles?: string[];
+    permissions?: string[];
+    requireApproval?: boolean;
+    dataAccessGuard?: DataAccessGuard<TArgs>;
+    invalidationTags?: InvalidationTagsResolver<TArgs, TResult>;
+    parameters: z.ZodType<TArgs> | unknown;
+    cacheTTL?: number;
+    execute: (args: TArgs, context?: ToolExecutionContext) => Promise<TResult>;
+    llmDto?: LLMDtoMapper<TArgs, TResult, TLLMDto>;
+    clientDto?: ClientDtoCallback<TClientDto>;
+    llmDtoSchema?: z.ZodType<TLLMDto>;
+    sanitizePii?: boolean;
+    throwOnPii?: boolean;
+}
+/**
+ * Standard tool contract compatible with Vercel AI SDK (ai) tool definition.
+ */
+export interface VercelAiCoreTool<TArgs = any, TResult = any> {
+    description: string;
+    parameters: any;
+    execute: (args: TArgs, context?: ToolExecutionContext) => Promise<TResult>;
+    /**
+     * Internal identifiers and metadata.
+     */
+    readonly _toolId: string;
+    readonly _toolName: string;
+    readonly _toolAlias?: string;
+    readonly _isIsolated: boolean;
+    readonly _cacheTTL?: number;
+    readonly _domain?: string;
+    readonly _resource?: string;
+    readonly _roles?: readonly string[];
+    readonly _permissions?: readonly string[];
+    readonly _requireApproval?: boolean;
+    _lastPiiFilteredCount?: number;
+    _lastInvalidationTags?: string[];
+}
+/**
+ * Metadata and descriptor for registered tools in the registry.
+ */
+export interface RegisteredTool<TArgs = any, TResult = any> {
+    id: string;
+    name: string;
+    alias?: string;
+    description: string;
+    domain?: string;
+    resource?: string;
+    roles?: string[];
+    permissions?: string[];
+    phases?: string[];
+    requiredRoles?: string[];
+    tags?: string[];
+    requireApproval?: boolean;
+    tool: VercelAiCoreTool<TArgs, TResult>;
+}
+/**
+ * Pure technical descriptor exportable to client applications without UI coupling.
+ */
+export interface ToolDescriptor {
+    id: string;
+    name: string;
+    alias?: string;
+    description: string;
+    domain?: string;
+    resource?: string;
+    roles?: string[];
+    permissions?: string[];
+    requireApproval?: boolean;
+    cacheTTL?: number;
+    tags?: string[];
+}
+/**
+ * Strategy interface for dynamically selecting a subset of tools for LLM prompts.
+ */
+export interface ToolSelectionStrategy {
+    selectTools(tools: RegisteredTool[], context: ToolContext): RegisteredTool[] | Promise<RegisteredTool[]>;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/agent/types.d.ts.map

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

package/dist/control-layer.d.ts

@@ -0,0 +1,49 @@
+import { z } from "zod";
+import type { ControlLayerConfig, ExecutionResult, StructuredExecutionResult, GenerateStructuredOutputOptions, LLMProviderPort } from "./types";
+export declare class AvantGateControlLayer {
+    private config;
+    private cachedPricingAdapter?;
+    constructor(config: ControlLayerConfig);
+    private resolveProviderConfig;
+    private findProviderConfig;
+    private calculateCost;
+    private applySecurityGuards;
+    private checkPreflightBudget;
+    private checkPostExecutionBudget;
+    private buildMessages;
+    private resolveTokens;
+    private getProviderChain;
+    private executeSimulation;
+    private executeOverrideProvider;
+    private executeProviderPipeline;
+    private assembleResult;
+    private notifyAuditSink;
+    /**
+     * Exécute une requête avec garde d'entrée, masquage PII, garde pré-vol et calcul des coûts.
+     */
+    execute(options: {
+        userQuery: string;
+        systemPrompt?: string;
+        temperature?: number;
+        providerOverride?: LLMProviderPort;
+    }): Promise<ExecutionResult>;
+    /**
+     * Exécute une requête et valide/répare le résultat selon un schéma Zod.
+     */
+    executeStructured<T>(options: {
+        userQuery: string;
+        systemPrompt?: string;
+        schema: z.ZodType<T>;
+        temperature?: number;
+        providerOverride?: LLMProviderPort;
+    }): Promise<StructuredExecutionResult<T>>;
+    /**
+     * Méthode unifiée de premier niveau pour l'extraction structurée sans code boilerplate.
+     * Gère le failover multi-fournisseurs, les retries, la validation Zod et la normalisation financière.
+     */
+    generateStructuredOutput<T>(options: GenerateStructuredOutputOptions<T>): Promise<StructuredExecutionResult<T>>;
+}
+export declare function createLLMControlLayer(config: ControlLayerConfig): AvantGateControlLayer;
+export declare const createAvantGate: typeof createLLMControlLayer;
+export { AvantGateControlLayer as ZenLLMControlLayer };
+//# sourceMappingURL=control-layer.d.ts.map

package/dist/control-layer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"control-layer.d.ts","sourceRoot":"","sources":["../src/control-layer.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EACV,kBAAkB,EAClB,eAAe,EACf,yBAAyB,EACzB,+BAA+B,EAC/B,eAAe,EAIhB,MAAM,SAAS,CAAC;AAgBjB,qBAAa,qBAAqB;IAChC,OAAO,CAAC,MAAM,CAAqB;IACnC,OAAO,CAAC,oBAAoB,CAAC,CAAuB;gBAExC,MAAM,EAAE,kBAAkB;IAgBtC,OAAO,CAAC,qBAAqB;IAY7B,OAAO,CAAC,kBAAkB;IAe1B,OAAO,CAAC,aAAa;IAgBrB,OAAO,CAAC,mBAAmB;IAiB3B,OAAO,CAAC,oBAAoB;IAgC5B,OAAO,CAAC,wBAAwB;IAahC,OAAO,CAAC,aAAa;IASrB,OAAO,CAAC,aAAa;IAYrB,OAAO,CAAC,gBAAgB;IAQxB,OAAO,CAAC,iBAAiB;YAmBX,uBAAuB;YAqBvB,uBAAuB;IAiCrC,OAAO,CAAC,cAAc;YAsBR,eAAe;IAe7B;;OAEG;IACG,OAAO,CAAC,OAAO,EAAE;QACrB,SAAS,EAAE,MAAM,CAAC;QAClB,YAAY,CAAC,EAAE,MAAM,CAAC;QACtB,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,gBAAgB,CAAC,EAAE,eAAe,CAAC;KACpC,GAAG,OAAO,CAAC,eAAe,CAAC;IA6B5B;;OAEG;IACG,iBAAiB,CAAC,CAAC,EAAE,OAAO,EAAE;QAClC,SAAS,EAAE,MAAM,CAAC;QAClB,YAAY,CAAC,EAAE,MAAM,CAAC;QACtB,MAAM,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;QACrB,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,gBAAgB,CAAC,EAAE,eAAe,CAAC;KACpC,GAAG,OAAO,CAAC,yBAAyB,CAAC,CAAC,CAAC,CAAC;IA2BzC;;;OAGG;IACG,wBAAwB,CAAC,CAAC,EAC9B,OAAO,EAAE,+BAA+B,CAAC,CAAC,CAAC,GAC1C,OAAO,CAAC,yBAAyB,CAAC,CAAC,CAAC,CAAC;CAsHzC;AAED,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,kBAAkB,GAAG,qBAAqB,CAEvF;AAED,eAAO,MAAM,eAAe,8BAAwB,CAAC;AACrD,OAAO,EAAE,qBAAqB,IAAI,kBAAkB,EAAE,CAAC"}

package/dist/finance/factory.d.ts

@@ -0,0 +1,11 @@
+import type { IAccountingStrategy, FinancialJurisdictionCode } from "./strategy.interface";
+export declare class AccountingFactory {
+    private static strategies;
+    private static detectionOrder;
+    private static initDefaults;
+    static registerStrategy(strategy: IAccountingStrategy): void;
+    static getStrategy(code?: FinancialJurisdictionCode): IAccountingStrategy;
+    static detectStrategy(documentText: string): IAccountingStrategy;
+    static resetDefaults(): void;
+}
+//# sourceMappingURL=factory.d.ts.map

package/dist/finance/factory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"factory.d.ts","sourceRoot":"","sources":["../../src/finance/factory.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,mBAAmB,EACnB,yBAAyB,EAC1B,MAAM,sBAAsB,CAAC;AAO9B,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,MAAM,CAAC,UAAU,CAAkE;IAC3F,OAAO,CAAC,MAAM,CAAC,cAAc,CAA6B;IAM1D,OAAO,CAAC,MAAM,CAAC,YAAY;WAcb,gBAAgB,CAAC,QAAQ,EAAE,mBAAmB,GAAG,IAAI;WASrD,WAAW,CAAC,IAAI,CAAC,EAAE,yBAAyB,GAAG,mBAAmB;WAWlE,cAAc,CAAC,YAAY,EAAE,MAAM,GAAG,mBAAmB;WASzD,aAAa,IAAI,IAAI;CAKpC"}