avantgate 1.1.1 → 1.2.0

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"}