avantgate 1.1.2 → 1.2.0

package/dist/agent/adapters/custom-adapter.d.ts

@@ -0,0 +1,50 @@
+import type { StepRecord, StepStatus, StepStorageAdapter, ToolExecutionRecord } from "../types";
+export interface CustomStorageHandlers {
+    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>;
+}
+export interface KeyValueStoreClient {
+    get(key: string): Promise<string | null> | string | null;
+    set(key: string, value: string, ttlSeconds?: number): Promise<void | unknown> | void | unknown;
+    del?(key: string): Promise<void | unknown> | void | unknown;
+    keys?(pattern?: string): Promise<string[]> | string[];
+}
+export interface KeyValueAdapterOptions {
+    prefix?: string;
+    ttlSeconds?: number;
+}
+/**
+ * Universal functional builder for plugging any external storage library
+ * (Drizzle, Kysely, Supabase, TypeORM, Mongo, custom REST API...)
+ */
+export declare function createCustomStorageAdapter(handlers: CustomStorageHandlers): StepStorageAdapter;
+/**
+ * Universal Key-Value adapter enabling any KV client (Redis, Upstash, Cloudflare KV,
+ * Keyv, Memcached) to be plugged in with simple get/set operations.
+ */
+export declare class KeyValueStorageAdapter implements StepStorageAdapter {
+    private readonly client;
+    private readonly prefix;
+    private readonly ttlSeconds?;
+    constructor(client: KeyValueStoreClient, options?: KeyValueAdapterOptions);
+    private buildKey;
+    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[]>;
+    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>;
+}
+//# sourceMappingURL=custom-adapter.d.ts.map

package/dist/agent/adapters/custom-adapter.d.ts.map

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

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

@@ -0,0 +1,6 @@
+export * from "./memory-adapter";
+export * from "./custom-adapter";
+export * from "./prisma-adapter";
+export * from "./sqlite-adapter";
+export * from "./platform-adapter";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/agent/adapters/index.ts"],"names":[],"mappings":"AAAA,cAAc,kBAAkB,CAAC;AACjC,cAAc,kBAAkB,CAAC;AACjC,cAAc,kBAAkB,CAAC;AACjC,cAAc,kBAAkB,CAAC;AACjC,cAAc,oBAAoB,CAAC"}

package/dist/agent/adapters/memory-adapter.d.ts

@@ -0,0 +1,34 @@
+import type { StepRecord, StepStatus, StepStorageAdapter, ToolExecutionRecord } from "../types";
+export interface MemoryAdapterOptions {
+    ttlMs?: number;
+}
+/**
+ * In-memory storage adapter for development, prototyping, and tests.
+ * Zero-infrastructure and ultra-fast with complete tool trace and cache support.
+ */
+export declare class MemoryStorageAdapter implements StepStorageAdapter {
+    private readonly storage;
+    private readonly toolExecutions;
+    private readonly cacheStorage;
+    private readonly stateStorage;
+    private readonly ttlMs?;
+    constructor(options?: MemoryAdapterOptions);
+    private buildKey;
+    private isExpired;
+    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>;
+    /**
+     * Resets all internal in-memory maps (useful for test isolation).
+     */
+    clear(): void;
+}
+//# sourceMappingURL=memory-adapter.d.ts.map

package/dist/agent/adapters/memory-adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory-adapter.d.ts","sourceRoot":"","sources":["../../../src/agent/adapters/memory-adapter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,UAAU,EACV,UAAU,EACV,kBAAkB,EAClB,mBAAmB,EACpB,MAAM,UAAU,CAAC;AAElB,MAAM,WAAW,oBAAoB;IACnC,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAiBD;;;GAGG;AACH,qBAAa,oBAAqB,YAAW,kBAAkB;IAC7D,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAkC;IAC1D,OAAO,CAAC,QAAQ,CAAC,cAAc,CAA6B;IAC5D,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAiC;IAC9D,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAiC;IAC9D,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAS;gBAEpB,OAAO,GAAE,oBAAyB;IAI9C,OAAO,CAAC,QAAQ;IAIhB,OAAO,CAAC,SAAS;IAOJ,OAAO,CAAC,CAAC,GAAG,OAAO,EAC9B,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE,MAAM,GACb,OAAO,CAAC,UAAU,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC;IAanB,QAAQ,CAAC,CAAC,GAAG,OAAO,EAAE,IAAI,EAAE,UAAU,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IASzD,gBAAgB,CAAC,CAAC,GAAG,OAAO,EACvC,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,UAAU,EAClB,KAAK,CAAC,EAAE,OAAO,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,GAC7B,OAAO,CAAC,IAAI,CAAC;IAgBH,SAAS,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,EAAE,CAAC;IAcpD,iBAAiB,CAAC,MAAM,EAAE,mBAAmB,GAAG,OAAO,CAAC,IAAI,CAAC;IAI7D,kBAAkB,CAC7B,UAAU,CAAC,EAAE,MAAM,EACnB,MAAM,CAAC,EAAE,MAAM,GACd,OAAO,CAAC,mBAAmB,EAAE,CAAC;IAQpB,mBAAmB,CAAC,CAAC,GAAG,OAAO,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,GAAG,IAAI,CAAC;IAYrE,mBAAmB,CAAC,CAAC,GAAG,OAAO,EAC1C,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,CAAC,EACT,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC,IAAI,CAAC;IAKH,aAAa,CAAC,CAAC,GAAG,OAAO,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,GAAG,IAAI,CAAC;IAY1D,aAAa,CAAC,CAAC,GAAG,OAAO,EACpC,GAAG,EAAE,MAAM,EACX,KAAK,EAAE,CAAC,EACR,UAAU,CAAC,EAAE,MAAM,GAClB,OAAO,CAAC,IAAI,CAAC;IAKH,gBAAgB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAIzD;;OAEG;IACI,KAAK,IAAI,IAAI;CAMrB"}

package/dist/agent/adapters/platform-adapter.d.ts

@@ -0,0 +1,32 @@
+import type { StepRecord, StepStatus, StepStorageAdapter, ToolExecutionRecord } from "../types";
+import type { HttpTelemetryExporter } from "../telemetry/http-exporter";
+export interface PlatformStorageAdapterConfig {
+    exporter: HttpTelemetryExporter;
+    primaryStorage?: StepStorageAdapter;
+}
+/**
+ * Hexagonal Hybrid Storage Adapter: persists steps and tool executions locally
+ * while mirroring telemetry events asynchronously to avantGate Cloud.
+ */
+export declare class PlatformStorageAdapter implements StepStorageAdapter {
+    private readonly exporter;
+    private readonly primary;
+    constructor(config: PlatformStorageAdapterConfig);
+    getStep<T = unknown>(workflowId: string, stepId: string): Promise<StepRecord<T> | null>;
+    saveStep<T = unknown>(record: StepRecord<T>): Promise<void>;
+    updateStepStatus(workflowId: string, stepId: string, status: StepStatus, updates?: {
+        result?: unknown;
+        error?: string;
+        metadata?: Record<string, unknown>;
+    }): 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>;
+}
+//# sourceMappingURL=platform-adapter.d.ts.map

package/dist/agent/adapters/platform-adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"platform-adapter.d.ts","sourceRoot":"","sources":["../../../src/agent/adapters/platform-adapter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,UAAU,EACV,UAAU,EACV,kBAAkB,EAClB,mBAAmB,EACpB,MAAM,UAAU,CAAC;AAElB,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,4BAA4B,CAAC;AAUxE,MAAM,WAAW,4BAA4B;IAC3C,QAAQ,EAAE,qBAAqB,CAAC;IAChC,cAAc,CAAC,EAAE,kBAAkB,CAAC;CACrC;AAyED;;;GAGG;AACH,qBAAa,sBAAuB,YAAW,kBAAkB;IAC/D,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAwB;IACjD,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAqB;gBAEjC,MAAM,EAAE,4BAA4B;IAKnC,OAAO,CAAC,CAAC,GAAG,OAAO,EAC9B,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE,MAAM,GACb,OAAO,CAAC,UAAU,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC;IAInB,QAAQ,CAAC,CAAC,GAAG,OAAO,EAAE,MAAM,EAAE,UAAU,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IAU3D,gBAAgB,CAC3B,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,UAAU,EAClB,OAAO,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,OAAO,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;KAAE,GACjF,OAAO,CAAC,IAAI,CAAC;IAYH,SAAS,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,EAAE,CAAC;IAIpD,iBAAiB,CAAC,MAAM,EAAE,mBAAmB,GAAG,OAAO,CAAC,IAAI,CAAC;IAU7D,kBAAkB,CAC7B,UAAU,CAAC,EAAE,MAAM,EACnB,MAAM,CAAC,EAAE,MAAM,GACd,OAAO,CAAC,mBAAmB,EAAE,CAAC;IAOpB,mBAAmB,CAAC,CAAC,GAAG,OAAO,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,GAAG,IAAI,CAAC;IAOrE,mBAAmB,CAAC,CAAC,GAAG,OAAO,EAC1C,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,CAAC,EACT,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC,IAAI,CAAC;IAMH,aAAa,CAAC,CAAC,GAAG,OAAO,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,GAAG,IAAI,CAAC;IAO1D,aAAa,CAAC,CAAC,GAAG,OAAO,EACpC,GAAG,EAAE,MAAM,EACX,KAAK,EAAE,CAAC,EACR,UAAU,CAAC,EAAE,MAAM,GAClB,OAAO,CAAC,IAAI,CAAC;IAMH,gBAAgB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAM5C,gBAAgB,IAAI,OAAO,CAAC,IAAI,CAAC;CAK/C"}

package/dist/agent/adapters/prisma-adapter.d.ts

@@ -0,0 +1,55 @@
+import type { StepRecord, StepStatus, StepStorageAdapter, ToolExecutionRecord } from "../types";
+export interface PrismaStepModelDelegate {
+    findUnique(args: {
+        where: {
+            workflowId_stepId: {
+                workflowId: string;
+                stepId: string;
+            };
+        };
+    }): Promise<any>;
+    upsert(args: {
+        where: {
+            workflowId_stepId: {
+                workflowId: string;
+                stepId: string;
+            };
+        };
+        create: any;
+        update: any;
+    }): Promise<any>;
+    findMany(args: {
+        where: {
+            workflowId: string;
+        };
+        orderBy?: any;
+    }): Promise<any[]>;
+}
+export interface PrismaToolDelegates {
+    toolExecution?: any;
+    toolCache?: any;
+    sharedState?: any;
+}
+/**
+ * Storage adapter integrating with Prisma ORM without imposing a direct dependency.
+ */
+export declare class PrismaStorageAdapter implements StepStorageAdapter {
+    private readonly model;
+    private readonly toolDelegates?;
+    private readonly volatileCache;
+    private readonly volatileState;
+    private readonly volatileExecutions;
+    constructor(model: PrismaStepModelDelegate, toolDelegates?: PrismaToolDelegates);
+    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>;
+}
+//# sourceMappingURL=prisma-adapter.d.ts.map

package/dist/agent/adapters/prisma-adapter.d.ts.map

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

package/dist/agent/adapters/sqlite-adapter.d.ts

@@ -0,0 +1,31 @@
+import type { StepRecord, StepStatus, StepStorageAdapter, ToolExecutionRecord } from "../types";
+export interface SQLiteStatementLike {
+    get(...params: any[]): any;
+    all(...params: any[]): any[];
+    run(...params: any[]): any;
+}
+export interface SQLiteDatabaseLike {
+    exec(sql: string): void;
+    prepare(sql: string): SQLiteStatementLike;
+}
+/**
+ * SQLite storage adapter for local edge execution and serverless durable workflows.
+ * Automatically initializes tables for steps, tool executions, cache and blackboard state.
+ */
+export declare class SQLiteStorageAdapter implements StepStorageAdapter {
+    private readonly db;
+    constructor(db: SQLiteDatabaseLike);
+    private initTables;
+    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>;
+}
+//# sourceMappingURL=sqlite-adapter.d.ts.map

package/dist/agent/adapters/sqlite-adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sqlite-adapter.d.ts","sourceRoot":"","sources":["../../../src/agent/adapters/sqlite-adapter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,UAAU,EACV,UAAU,EACV,kBAAkB,EAClB,mBAAmB,EACpB,MAAM,UAAU,CAAC;AAElB,MAAM,WAAW,mBAAmB;IAClC,GAAG,CAAC,GAAG,MAAM,EAAE,GAAG,EAAE,GAAG,GAAG,CAAC;IAC3B,GAAG,CAAC,GAAG,MAAM,EAAE,GAAG,EAAE,GAAG,GAAG,EAAE,CAAC;IAC7B,GAAG,CAAC,GAAG,MAAM,EAAE,GAAG,EAAE,GAAG,GAAG,CAAC;CAC5B;AAED,MAAM,WAAW,kBAAkB;IACjC,IAAI,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,OAAO,CAAC,GAAG,EAAE,MAAM,GAAG,mBAAmB,CAAC;CAC3C;AAsED;;;GAGG;AACH,qBAAa,oBAAqB,YAAW,kBAAkB;IAC7D,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAqB;gBAE5B,EAAE,EAAE,kBAAkB;IAKlC,OAAO,CAAC,UAAU;IA8CL,OAAO,CAAC,CAAC,GAAG,OAAO,EAC9B,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE,MAAM,GACb,OAAO,CAAC,UAAU,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC;IAWnB,QAAQ,CAAC,CAAC,GAAG,OAAO,EAAE,IAAI,EAAE,UAAU,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IAoCzD,gBAAgB,CAAC,CAAC,GAAG,OAAO,EACvC,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,UAAU,EAClB,KAAK,CAAC,EAAE,OAAO,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,GAC7B,OAAO,CAAC,IAAI,CAAC;IAkBH,SAAS,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,EAAE,CAAC;IAQpD,iBAAiB,CAAC,MAAM,EAAE,mBAAmB,GAAG,OAAO,CAAC,IAAI,CAAC;IA4B7D,kBAAkB,CAC7B,UAAU,CAAC,EAAE,MAAM,EACnB,MAAM,CAAC,EAAE,MAAM,GACd,OAAO,CAAC,mBAAmB,EAAE,CAAC;IAkBpB,mBAAmB,CAAC,CAAC,GAAG,OAAO,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,GAAG,IAAI,CAAC;IAmBrE,mBAAmB,CAAC,CAAC,GAAG,OAAO,EAC1C,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,CAAC,EACT,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC,IAAI,CAAC;IAYH,aAAa,CAAC,CAAC,GAAG,OAAO,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,GAAG,IAAI,CAAC;IAmB1D,aAAa,CAAC,CAAC,GAAG,OAAO,EACpC,GAAG,EAAE,MAAM,EACX,KAAK,EAAE,CAAC,EACR,UAAU,CAAC,EAAE,MAAM,GAClB,OAAO,CAAC,IAAI,CAAC;IAYH,gBAAgB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CAG1D"}

package/dist/agent/dto.d.ts

@@ -0,0 +1,32 @@
+/**
+ * Declarative DTO Projection Helpers for avantgate/agent.
+ * Standardizes common tool output projections (booleans, count, field pick)
+ * to minimize LLM token consumption and prevent PII leakage.
+ */
+export interface DtoBooleanResult {
+    success: boolean;
+}
+export interface DtoCountResult {
+    success: true;
+    count: number;
+}
+export declare const dto: {
+    /**
+     * Generates a boolean acknowledgment for mutations ({ success: true | false }).
+     * If rawResult contains a boolean `success` property, it is preserved; otherwise defaults to true.
+     */
+    boolean: () => (data: any) => DtoBooleanResult;
+    /**
+     * Generates a boolean acknowledgment preserving an opaque technical identifier for tool chaining.
+     */
+    booleanWithId: <K extends string = "id">(idKey?: K) => (data: any) => DtoBooleanResult & Record<K, unknown>;
+    /**
+     * Extracts a numeric count from a list or nested array property without exposing items to the LLM.
+     */
+    count: (arrayKey?: string) => (data: any) => DtoCountResult;
+    /**
+     * Filters raw output by extracting only a strict whitelist of allowed fields.
+     */
+    pick: <T extends string>(keys: readonly T[] | T[]) => (data: any) => Record<T, unknown>;
+};
+//# sourceMappingURL=dto.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"dto.d.ts","sourceRoot":"","sources":["../../src/agent/dto.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,OAAO,CAAC;CAClB;AAED,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,IAAI,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;CACf;AAED,eAAO,MAAM,GAAG;IACd;;;OAGG;oBACa,MAAM,GAAG,KAAG,gBAAgB;IAI5C;;OAEG;oBACa,CAAC,SAAS,MAAM,iBAAgB,CAAC,MAC9C,MAAM,GAAG,KAAG,gBAAgB,GAAG,MAAM,CAAC,CAAC,EAAE,OAAO,CAAC;IAMpD;;OAEG;uBAEW,MAAM,MACjB,MAAM,GAAG,KAAG,cAAc;IAQ7B;;OAEG;WAEA,CAAC,SAAS,MAAM,QAAQ,SAAS,CAAC,EAAE,GAAG,CAAC,EAAE,MAC1C,MAAM,GAAG,KAAG,MAAM,CAAC,CAAC,EAAE,OAAO,CAAC;CAYlC,CAAC"}

package/dist/agent/errors.d.ts

@@ -0,0 +1,50 @@
+/**
+ * Domain and operational errors for avantgate/agent.
+ */
+export declare class StepSuspendedError extends Error {
+    readonly stepId: string;
+    readonly workflowId: string;
+    readonly metadata?: Record<string, unknown>;
+    constructor(stepId: string, workflowId: string, metadata?: Record<string, unknown>);
+}
+export declare class PiiLeakError extends Error {
+    readonly toolName: string;
+    readonly maskedCount: number;
+    constructor(toolName: string, maskedCount: number);
+}
+export declare class StepExecutionError extends Error {
+    readonly stepId: string;
+    readonly workflowId: string;
+    readonly originalError?: unknown;
+    constructor(stepId: string, workflowId: string, message: string, originalError?: unknown);
+}
+export declare class ToolAccessDeniedError extends Error {
+    readonly toolName: string;
+    readonly requiredRole?: string;
+    readonly reason?: string;
+    constructor(toolName: string, reasonOrRole?: string);
+}
+export declare class CircularToolCallError extends Error {
+    readonly cycle: string[];
+    constructor(cycle: string[]);
+}
+export declare class ToolCallDepthExceededError extends Error {
+    readonly depth: number;
+    readonly maxDepth: number;
+    constructor(depth: number, maxDepth: number);
+}
+export declare class ToolSubCallQuotaError extends Error {
+    readonly totalCalls: number;
+    readonly maxCalls: number;
+    constructor(totalCalls: number, maxCalls: number);
+}
+export declare class ToolNotFoundError extends Error {
+    readonly toolId: string;
+    constructor(toolId: string);
+}
+export declare class DtoValidationError extends Error {
+    readonly toolName: string;
+    readonly issues: unknown[];
+    constructor(toolName: string, message: string, issues?: unknown[]);
+}
+//# sourceMappingURL=errors.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/agent/errors.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,qBAAa,kBAAmB,SAAQ,KAAK;IAC3C,SAAgB,MAAM,EAAE,MAAM,CAAC;IAC/B,SAAgB,UAAU,EAAE,MAAM,CAAC;IACnC,SAAgB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;gBAEvC,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;CAOnF;AAED,qBAAa,YAAa,SAAQ,KAAK;IACrC,SAAgB,QAAQ,EAAE,MAAM,CAAC;IACjC,SAAgB,WAAW,EAAE,MAAM,CAAC;gBAExB,QAAQ,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM;CAMlD;AAED,qBAAa,kBAAmB,SAAQ,KAAK;IAC3C,SAAgB,MAAM,EAAE,MAAM,CAAC;IAC/B,SAAgB,UAAU,EAAE,MAAM,CAAC;IACnC,SAAgB,aAAa,CAAC,EAAE,OAAO,CAAC;gBAE5B,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,aAAa,CAAC,EAAE,OAAO;CAOzF;AAED,qBAAa,qBAAsB,SAAQ,KAAK;IAC9C,SAAgB,QAAQ,EAAE,MAAM,CAAC;IACjC,SAAgB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtC,SAAgB,MAAM,CAAC,EAAE,MAAM,CAAC;gBAEpB,QAAQ,EAAE,MAAM,EAAE,YAAY,CAAC,EAAE,MAAM;CAapD;AAED,qBAAa,qBAAsB,SAAQ,KAAK;IAC9C,SAAgB,KAAK,EAAE,MAAM,EAAE,CAAC;gBAEpB,KAAK,EAAE,MAAM,EAAE;CAK5B;AAED,qBAAa,0BAA2B,SAAQ,KAAK;IACnD,SAAgB,KAAK,EAAE,MAAM,CAAC;IAC9B,SAAgB,QAAQ,EAAE,MAAM,CAAC;gBAErB,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM;CAM5C;AAED,qBAAa,qBAAsB,SAAQ,KAAK;IAC9C,SAAgB,UAAU,EAAE,MAAM,CAAC;IACnC,SAAgB,QAAQ,EAAE,MAAM,CAAC;gBAErB,UAAU,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM;CAMjD;AAED,qBAAa,iBAAkB,SAAQ,KAAK;IAC1C,SAAgB,MAAM,EAAE,MAAM,CAAC;gBAEnB,MAAM,EAAE,MAAM;CAK3B;AAED,qBAAa,kBAAmB,SAAQ,KAAK;IAC3C,SAAgB,QAAQ,EAAE,MAAM,CAAC;IACjC,SAAgB,MAAM,EAAE,OAAO,EAAE,CAAC;gBAEtB,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,GAAE,OAAO,EAAO;CAMtE"}

package/dist/agent/factory.d.ts

@@ -0,0 +1,21 @@
+import type { IsolatedToolConfig, ToolContext, VercelAiCoreTool } from "./types";
+/**
+ * Factory for creating isolated tools with injected context and dependencies.
+ */
+export declare class AgentToolFactory {
+    private readonly context;
+    constructor(defaultContext?: ToolContext);
+    /**
+     * Returns a new factory instance with merged context.
+     */
+    withContext(extraContext: ToolContext): AgentToolFactory;
+    /**
+     * Returns current factory context.
+     */
+    getContext(): ToolContext;
+    /**
+     * Instantiates an isolated tool by injecting factory context into the builder function.
+     */
+    createTool<TArgs = any, TResult = any>(builder: (context: ToolContext) => IsolatedToolConfig<TArgs, TResult>): VercelAiCoreTool<TArgs, TResult>;
+}
+//# sourceMappingURL=factory.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"factory.d.ts","sourceRoot":"","sources":["../../src/agent/factory.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,kBAAkB,EAClB,WAAW,EACX,gBAAgB,EACjB,MAAM,SAAS,CAAC;AAEjB;;GAEG;AACH,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAc;gBAE1B,cAAc,GAAE,WAAgB;IAI5C;;OAEG;IACI,WAAW,CAAC,YAAY,EAAE,WAAW,GAAG,gBAAgB;IAO/D;;OAEG;IACI,UAAU,IAAI,WAAW;IAIhC;;OAEG;IACI,UAAU,CAAC,KAAK,GAAG,GAAG,EAAE,OAAO,GAAG,GAAG,EAC1C,OAAO,EAAE,CAAC,OAAO,EAAE,WAAW,KAAK,kBAAkB,CAAC,KAAK,EAAE,OAAO,CAAC,GACpE,gBAAgB,CAAC,KAAK,EAAE,OAAO,CAAC;CAIpC"}

package/dist/agent/guardrails.d.ts

@@ -0,0 +1,14 @@
+export interface AuditToolResultOutput {
+    sanitizedData: unknown;
+    maskedCount: number;
+}
+export interface AuditToolResultOptions {
+    toolName: string;
+    throwOnPii?: boolean;
+}
+/**
+ * Audits and sanitizes data returned by tools before sending it to the LLM.
+ * Throws PiiLeakError if throwOnPii is enabled and PII is detected.
+ */
+export declare function auditToolResult(data: unknown, options: AuditToolResultOptions): AuditToolResultOutput;
+//# sourceMappingURL=guardrails.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"guardrails.d.ts","sourceRoot":"","sources":["../../src/agent/guardrails.ts"],"names":[],"mappings":"AAGA,MAAM,WAAW,qBAAqB;IACpC,aAAa,EAAE,OAAO,CAAC;IACvB,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,sBAAsB;IACrC,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,OAAO,CAAC;CACtB;AA8DD;;;GAGG;AACH,wBAAgB,eAAe,CAC7B,IAAI,EAAE,OAAO,EACb,OAAO,EAAE,sBAAsB,GAC9B,qBAAqB,CAWvB"}