@falai/agent 0.1.0

package/dist/types/history.d.ts

@@ -0,0 +1,112 @@
+/**
+ * Event history and interaction types
+ */
+/**
+ * Types of events in the interaction history
+ */
+export declare enum EventKind {
+    /** A text message event */
+    MESSAGE = "message",
+    /** A tool execution event */
+    TOOL = "tool",
+    /** A status update event */
+    STATUS = "status"
+}
+/**
+ * Source of an event
+ */
+export declare enum EventSource {
+    /** Event originated from the customer/user */
+    CUSTOMER = "customer",
+    /** Event from customer UI application */
+    CUSTOMER_UI = "customer_ui",
+    /** Event from human service agent */
+    HUMAN_AGENT = "human_agent",
+    /** Human agent acting on behalf of AI agent */
+    HUMAN_AGENT_ON_BEHALF_OF_AI_AGENT = "human_agent_on_behalf_of_ai_agent",
+    /** Event generated by AI agent */
+    AI_AGENT = "ai_agent",
+    /** System-generated event */
+    SYSTEM = "system"
+}
+/**
+ * Participant in a conversation
+ */
+export interface Participant {
+    /** Display name */
+    display_name: string;
+    /** Unique identifier */
+    id?: string;
+}
+/**
+ * Data for a message event
+ */
+export interface MessageEventData {
+    /** The participant who sent the message */
+    participant: Participant;
+    /** The message content */
+    message: string;
+    /** Whether the message was flagged/censored */
+    flagged?: boolean;
+    /** Tags/reasons if flagged */
+    tags?: string[];
+}
+/**
+ * Result of a tool execution
+ */
+export interface ToolResult<TData = unknown> {
+    /** The result data */
+    data: TData;
+    /** Optional metadata */
+    meta?: Record<string, unknown>;
+}
+/**
+ * A single tool call within a tool event
+ */
+export interface ToolCall<TArgs = unknown, TResult = unknown> {
+    /** Tool identifier */
+    tool_id: string;
+    /** Arguments passed to the tool */
+    arguments: TArgs;
+    /** Result returned by the tool */
+    result: ToolResult<TResult>;
+}
+/**
+ * Data for a tool event
+ */
+export interface ToolEventData {
+    /** Array of tool calls executed */
+    tool_calls: ToolCall[];
+}
+/**
+ * Data for a status event
+ */
+export interface StatusEventData {
+    /** Status message */
+    status: string;
+    /** Additional details */
+    details?: Record<string, unknown>;
+}
+/**
+ * Base event structure
+ */
+export interface Event<TData = MessageEventData | ToolEventData | StatusEventData> {
+    /** Type of event */
+    kind: EventKind;
+    /** Source of the event */
+    source: EventSource;
+    /** Event-specific data */
+    data: TData;
+    /** Timestamp (ISO string) */
+    timestamp?: string;
+    /** Unique event identifier */
+    id?: string;
+}
+/**
+ * An emitted event (staged for inclusion)
+ */
+export interface EmittedEvent<TData = MessageEventData | ToolEventData | StatusEventData> extends Event<TData> {
+    /** Whether this event has been committed */
+    committed?: boolean;
+}
+//# sourceMappingURL=history.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"history.d.ts","sourceRoot":"","sources":["../../src/types/history.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;GAEG;AACH,oBAAY,SAAS;IACnB,2BAA2B;IAC3B,OAAO,YAAY;IACnB,6BAA6B;IAC7B,IAAI,SAAS;IACb,4BAA4B;IAC5B,MAAM,WAAW;CAClB;AAED;;GAEG;AACH,oBAAY,WAAW;IACrB,8CAA8C;IAC9C,QAAQ,aAAa;IACrB,yCAAyC;IACzC,WAAW,gBAAgB;IAC3B,qCAAqC;IACrC,WAAW,gBAAgB;IAC3B,+CAA+C;IAC/C,iCAAiC,sCAAsC;IACvE,kCAAkC;IAClC,QAAQ,aAAa;IACrB,6BAA6B;IAC7B,MAAM,WAAW;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,mBAAmB;IACnB,YAAY,EAAE,MAAM,CAAC;IACrB,wBAAwB;IACxB,EAAE,CAAC,EAAE,MAAM,CAAC;CACb;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,2CAA2C;IAC3C,WAAW,EAAE,WAAW,CAAC;IACzB,0BAA0B;IAC1B,OAAO,EAAE,MAAM,CAAC;IAChB,+CAA+C;IAC/C,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,8BAA8B;IAC9B,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,UAAU,CAAC,KAAK,GAAG,OAAO;IACzC,sBAAsB;IACtB,IAAI,EAAE,KAAK,CAAC;IACZ,wBAAwB;IACxB,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAChC;AAED;;GAEG;AACH,MAAM,WAAW,QAAQ,CAAC,KAAK,GAAG,OAAO,EAAE,OAAO,GAAG,OAAO;IAC1D,sBAAsB;IACtB,OAAO,EAAE,MAAM,CAAC;IAChB,mCAAmC;IACnC,SAAS,EAAE,KAAK,CAAC;IACjB,kCAAkC;IAClC,MAAM,EAAE,UAAU,CAAC,OAAO,CAAC,CAAC;CAC7B;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,mCAAmC;IACnC,UAAU,EAAE,QAAQ,EAAE,CAAC;CACxB;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,qBAAqB;IACrB,MAAM,EAAE,MAAM,CAAC;IACf,yBAAyB;IACzB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACnC;AAED;;GAEG;AACH,MAAM,WAAW,KAAK,CACpB,KAAK,GAAG,gBAAgB,GAAG,aAAa,GAAG,eAAe;IAE1D,oBAAoB;IACpB,IAAI,EAAE,SAAS,CAAC;IAChB,0BAA0B;IAC1B,MAAM,EAAE,WAAW,CAAC;IACpB,0BAA0B;IAC1B,IAAI,EAAE,KAAK,CAAC;IACZ,6BAA6B;IAC7B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,8BAA8B;IAC9B,EAAE,CAAC,EAAE,MAAM,CAAC;CACb;AAED;;GAEG;AACH,MAAM,WAAW,YAAY,CAC3B,KAAK,GAAG,gBAAgB,GAAG,aAAa,GAAG,eAAe,CAC1D,SAAQ,KAAK,CAAC,KAAK,CAAC;IACpB,4CAA4C;IAC5C,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB"}

package/dist/types/history.js

@@ -0,0 +1,34 @@
+/**
+ * Event history and interaction types
+ */
+/**
+ * Types of events in the interaction history
+ */
+export var EventKind;
+(function (EventKind) {
+    /** A text message event */
+    EventKind["MESSAGE"] = "message";
+    /** A tool execution event */
+    EventKind["TOOL"] = "tool";
+    /** A status update event */
+    EventKind["STATUS"] = "status";
+})(EventKind || (EventKind = {}));
+/**
+ * Source of an event
+ */
+export var EventSource;
+(function (EventSource) {
+    /** Event originated from the customer/user */
+    EventSource["CUSTOMER"] = "customer";
+    /** Event from customer UI application */
+    EventSource["CUSTOMER_UI"] = "customer_ui";
+    /** Event from human service agent */
+    EventSource["HUMAN_AGENT"] = "human_agent";
+    /** Human agent acting on behalf of AI agent */
+    EventSource["HUMAN_AGENT_ON_BEHALF_OF_AI_AGENT"] = "human_agent_on_behalf_of_ai_agent";
+    /** Event generated by AI agent */
+    EventSource["AI_AGENT"] = "ai_agent";
+    /** System-generated event */
+    EventSource["SYSTEM"] = "system";
+})(EventSource || (EventSource = {}));
+//# sourceMappingURL=history.js.map

package/dist/types/history.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"history.js","sourceRoot":"","sources":["../../src/types/history.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;GAEG;AACH,MAAM,CAAN,IAAY,SAOX;AAPD,WAAY,SAAS;IACnB,2BAA2B;IAC3B,gCAAmB,CAAA;IACnB,6BAA6B;IAC7B,0BAAa,CAAA;IACb,4BAA4B;IAC5B,8BAAiB,CAAA;AACnB,CAAC,EAPW,SAAS,KAAT,SAAS,QAOpB;AAED;;GAEG;AACH,MAAM,CAAN,IAAY,WAaX;AAbD,WAAY,WAAW;IACrB,8CAA8C;IAC9C,oCAAqB,CAAA;IACrB,yCAAyC;IACzC,0CAA2B,CAAA;IAC3B,qCAAqC;IACrC,0CAA2B,CAAA;IAC3B,+CAA+C;IAC/C,sFAAuE,CAAA;IACvE,kCAAkC;IAClC,oCAAqB,CAAA;IACrB,6BAA6B;IAC7B,gCAAiB,CAAA;AACnB,CAAC,EAbW,WAAW,KAAX,WAAW,QAatB"}

package/dist/types/index.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Central type definitions export
+ */
+export type { AgentOptions, Term, Guideline, Capability, GuidelineMatch, } from "./agent";
+export { CompositionMode } from "./agent";
+export type { Event, EmittedEvent, MessageEventData, ToolEventData, StatusEventData, Participant, ToolResult as EventToolResult, ToolCall, } from "./history";
+export { EventKind, EventSource } from "./history";
+export type { RouteRef, StateRef, RouteOptions, TransitionSpec, TransitionResult, } from "./route";
+export type { ToolContext, ToolResult, ToolHandler, ToolRef } from "./tool";
+export type { AiProvider, GenerateMessageInput, GenerateMessageOutput, } from "./ai";
+export type { PromptSection, ContextVariable, ContextVariableValue, } from "./prompt";
+export { SectionStatus } from "./prompt";
+export type { Observation, ObservationOptions } from "./observation";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,YAAY,EACV,YAAY,EACZ,IAAI,EACJ,SAAS,EACT,UAAU,EACV,cAAc,GACf,MAAM,SAAS,CAAC;AACjB,OAAO,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AAG1C,YAAY,EACV,KAAK,EACL,YAAY,EACZ,gBAAgB,EAChB,aAAa,EACb,eAAe,EACf,WAAW,EACX,UAAU,IAAI,eAAe,EAC7B,QAAQ,GACT,MAAM,WAAW,CAAC;AACnB,OAAO,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AAGnD,YAAY,EACV,QAAQ,EACR,QAAQ,EACR,YAAY,EACZ,cAAc,EACd,gBAAgB,GACjB,MAAM,SAAS,CAAC;AAGjB,YAAY,EAAE,WAAW,EAAE,UAAU,EAAE,WAAW,EAAE,OAAO,EAAE,MAAM,QAAQ,CAAC;AAG5E,YAAY,EACV,UAAU,EACV,oBAAoB,EACpB,qBAAqB,GACtB,MAAM,MAAM,CAAC;AAGd,YAAY,EACV,aAAa,EACb,eAAe,EACf,oBAAoB,GACrB,MAAM,UAAU,CAAC;AAClB,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAGzC,YAAY,EAAE,WAAW,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC"}

package/dist/types/index.js

@@ -0,0 +1,7 @@
+/**
+ * Central type definitions export
+ */
+export { CompositionMode } from "./agent";
+export { EventKind, EventSource } from "./history";
+export { SectionStatus } from "./prompt";
+//# sourceMappingURL=index.js.map

package/dist/types/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAUH,OAAO,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AAa1C,OAAO,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AA2BnD,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC"}

package/dist/types/observation.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Observation types for disambiguation
+ */
+import type { RouteRef } from "./route";
+/**
+ * An observation that can disambiguate between multiple routes
+ */
+export interface Observation {
+    /** Unique identifier */
+    id: string;
+    /** The observation description */
+    description: string;
+    /** Routes this observation can disambiguate between */
+    routes?: RouteRef[];
+}
+/**
+ * Options for creating an observation
+ */
+export interface ObservationOptions {
+    /** The observation description */
+    description: string;
+    /** Route IDs or titles to disambiguate between (can be set later with disambiguate()) */
+    routeRefs?: string[];
+}
+//# sourceMappingURL=observation.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"observation.d.ts","sourceRoot":"","sources":["../../src/types/observation.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAExC;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,wBAAwB;IACxB,EAAE,EAAE,MAAM,CAAC;IACX,kCAAkC;IAClC,WAAW,EAAE,MAAM,CAAC;IACpB,uDAAuD;IACvD,MAAM,CAAC,EAAE,QAAQ,EAAE,CAAC;CACrB;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,kCAAkC;IAClC,WAAW,EAAE,MAAM,CAAC;IACpB,yFAAyF;IACzF,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;CACtB"}

package/dist/types/observation.js

@@ -0,0 +1,5 @@
+/**
+ * Observation types for disambiguation
+ */
+export {};
+//# sourceMappingURL=observation.js.map

package/dist/types/observation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"observation.js","sourceRoot":"","sources":["../../src/types/observation.ts"],"names":[],"mappings":"AAAA;;GAEG"}

package/dist/types/prompt.d.ts

@@ -0,0 +1,46 @@
+/**
+ * Prompt building types
+ */
+/**
+ * Status of a prompt section
+ */
+export declare enum SectionStatus {
+    /** Section has active information */
+    ACTIVE = "active",
+    /** Section is inactive but may have empty-state text */
+    PASSIVE = "passive",
+    /** Section is not included */
+    NONE = "none"
+}
+/**
+ * A section within a prompt
+ */
+export interface PromptSection {
+    /** Template string (may contain placeholders) */
+    template: string;
+    /** Properties to fill template placeholders */
+    props: Record<string, unknown>;
+    /** Status of this section */
+    status?: SectionStatus;
+}
+/**
+ * Context variable with value
+ */
+export interface ContextVariable {
+    /** Variable name */
+    name: string;
+    /** Variable description */
+    description?: string;
+    /** Variable type */
+    type?: string;
+}
+/**
+ * Value for a context variable
+ */
+export interface ContextVariableValue {
+    /** The variable definition */
+    variable: ContextVariable;
+    /** The current value */
+    value: unknown;
+}
+//# sourceMappingURL=prompt.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"prompt.d.ts","sourceRoot":"","sources":["../../src/types/prompt.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;GAEG;AACH,oBAAY,aAAa;IACvB,qCAAqC;IACrC,MAAM,WAAW;IACjB,wDAAwD;IACxD,OAAO,YAAY;IACnB,8BAA8B;IAC9B,IAAI,SAAS;CACd;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,iDAAiD;IACjD,QAAQ,EAAE,MAAM,CAAC;IACjB,+CAA+C;IAC/C,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC/B,6BAA6B;IAC7B,MAAM,CAAC,EAAE,aAAa,CAAC;CACxB;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,oBAAoB;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,2BAA2B;IAC3B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,oBAAoB;IACpB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,8BAA8B;IAC9B,QAAQ,EAAE,eAAe,CAAC;IAC1B,wBAAwB;IACxB,KAAK,EAAE,OAAO,CAAC;CAChB"}

package/dist/types/prompt.js

@@ -0,0 +1,16 @@
+/**
+ * Prompt building types
+ */
+/**
+ * Status of a prompt section
+ */
+export var SectionStatus;
+(function (SectionStatus) {
+    /** Section has active information */
+    SectionStatus["ACTIVE"] = "active";
+    /** Section is inactive but may have empty-state text */
+    SectionStatus["PASSIVE"] = "passive";
+    /** Section is not included */
+    SectionStatus["NONE"] = "none";
+})(SectionStatus || (SectionStatus = {}));
+//# sourceMappingURL=prompt.js.map

package/dist/types/prompt.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompt.js","sourceRoot":"","sources":["../../src/types/prompt.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;GAEG;AACH,MAAM,CAAN,IAAY,aAOX;AAPD,WAAY,aAAa;IACvB,qCAAqC;IACrC,kCAAiB,CAAA;IACjB,wDAAwD;IACxD,oCAAmB,CAAA;IACnB,8BAA8B;IAC9B,8BAAa,CAAA;AACf,CAAC,EAPW,aAAa,KAAb,aAAa,QAOxB"}

package/dist/types/route.d.ts

@@ -0,0 +1,59 @@
+/**
+ * Route/Journey DSL type definitions
+ */
+import type { ToolRef } from "./tool";
+/**
+ * Reference to a route
+ */
+export interface RouteRef {
+    /** Route identifier */
+    id: string;
+}
+/**
+ * Reference to a state within a route
+ */
+export interface StateRef {
+    /** State identifier */
+    id: string;
+    /** Route this state belongs to */
+    routeId: string;
+}
+/**
+ * Forward declare Guideline for circular dependency
+ */
+import type { Guideline } from "./agent";
+/**
+ * Options for creating a route
+ */
+export interface RouteOptions {
+    /** Title of the route */
+    title: string;
+    /** Description of what this route accomplishes */
+    description?: string;
+    /** Conditions that activate this route */
+    conditions?: string[];
+    /** Initial guidelines for this route */
+    guidelines?: Guideline[];
+}
+/**
+ * Specification for a state transition
+ */
+export interface TransitionSpec {
+    /** Transition to a chat state with this description */
+    chatState?: string;
+    /** Transition to execute a tool */
+    toolState?: ToolRef<unknown, unknown[], unknown>;
+    /** Transition to a specific state or end marker */
+    state?: StateRef | symbol;
+}
+/**
+ * Result of a transition operation
+ */
+export interface TransitionResult {
+    /** The target state after transition */
+    target: StateRef & {
+        /** Allow chaining transitions */
+        transitionTo: (spec: TransitionSpec, condition?: string) => TransitionResult;
+    };
+}
+//# sourceMappingURL=route.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"route.d.ts","sourceRoot":"","sources":["../../src/types/route.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,QAAQ,CAAC;AAEtC;;GAEG;AACH,MAAM,WAAW,QAAQ;IACvB,uBAAuB;IACvB,EAAE,EAAE,MAAM,CAAC;CACZ;AAED;;GAEG;AACH,MAAM,WAAW,QAAQ;IACvB,uBAAuB;IACvB,EAAE,EAAE,MAAM,CAAC;IACX,kCAAkC;IAClC,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;GAEG;AACH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AAEzC;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,yBAAyB;IACzB,KAAK,EAAE,MAAM,CAAC;IACd,kDAAkD;IAClD,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,0CAA0C;IAC1C,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;IACtB,wCAAwC;IACxC,UAAU,CAAC,EAAE,SAAS,EAAE,CAAC;CAC1B;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,uDAAuD;IACvD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,mCAAmC;IACnC,SAAS,CAAC,EAAE,OAAO,CAAC,OAAO,EAAE,OAAO,EAAE,EAAE,OAAO,CAAC,CAAC;IACjD,mDAAmD;IACnD,KAAK,CAAC,EAAE,QAAQ,GAAG,MAAM,CAAC;CAC3B;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,wCAAwC;IACxC,MAAM,EAAE,QAAQ,GAAG;QACjB,iCAAiC;QACjC,YAAY,EAAE,CACZ,IAAI,EAAE,cAAc,EACpB,SAAS,CAAC,EAAE,MAAM,KACf,gBAAgB,CAAC;KACvB,CAAC;CACH"}

package/dist/types/route.js

@@ -0,0 +1,5 @@
+/**
+ * Route/Journey DSL type definitions
+ */
+export {};
+//# sourceMappingURL=route.js.map

package/dist/types/route.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"route.js","sourceRoot":"","sources":["../../src/types/route.ts"],"names":[],"mappings":"AAAA;;GAEG"}

package/dist/types/tool.d.ts

@@ -0,0 +1,46 @@
+/**
+ * Tool system type definitions
+ */
+import type { Event, StateRef } from "./index";
+/**
+ * Context provided to tool handlers
+ */
+export interface ToolContext<TContext = unknown> {
+    /** The agent's context data */
+    context: TContext;
+    /** Current state reference (if in a route) */
+    state?: StateRef;
+    /** Interaction history */
+    history: Event[];
+    /** Additional metadata */
+    metadata?: Record<string, unknown>;
+}
+/**
+ * Result returned by a tool
+ */
+export interface ToolResult<TData = unknown> {
+    /** The result data */
+    data: TData;
+    /** Optional metadata about the execution */
+    meta?: Record<string, unknown>;
+}
+/**
+ * Handler function for a tool
+ */
+export type ToolHandler<TContext, TArgs extends unknown[], TResult> = (context: ToolContext<TContext>, ...args: TArgs) => Promise<ToolResult<TResult>> | ToolResult<TResult>;
+/**
+ * Reference to a defined tool
+ */
+export interface ToolRef<TContext, TArgs extends unknown[], TResult> {
+    /** Tool identifier */
+    id: string;
+    /** Tool name */
+    name: string;
+    /** Tool handler function */
+    handler: ToolHandler<TContext, TArgs, TResult>;
+    /** Description of what the tool does */
+    description?: string;
+    /** Parameter schema or description */
+    parameters?: unknown;
+}
+//# sourceMappingURL=tool.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"tool.d.ts","sourceRoot":"","sources":["../../src/types/tool.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,KAAK,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAE/C;;GAEG;AACH,MAAM,WAAW,WAAW,CAAC,QAAQ,GAAG,OAAO;IAC7C,+BAA+B;IAC/B,OAAO,EAAE,QAAQ,CAAC;IAClB,8CAA8C;IAC9C,KAAK,CAAC,EAAE,QAAQ,CAAC;IACjB,0BAA0B;IAC1B,OAAO,EAAE,KAAK,EAAE,CAAC;IACjB,0BAA0B;IAC1B,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC;AAED;;GAEG;AACH,MAAM,WAAW,UAAU,CAAC,KAAK,GAAG,OAAO;IACzC,sBAAsB;IACtB,IAAI,EAAE,KAAK,CAAC;IACZ,4CAA4C;IAC5C,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAChC;AAED;;GAEG;AACH,MAAM,MAAM,WAAW,CAAC,QAAQ,EAAE,KAAK,SAAS,OAAO,EAAE,EAAE,OAAO,IAAI,CACpE,OAAO,EAAE,WAAW,CAAC,QAAQ,CAAC,EAC9B,GAAG,IAAI,EAAE,KAAK,KACX,OAAO,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC,GAAG,UAAU,CAAC,OAAO,CAAC,CAAC;AAExD;;GAEG;AACH,MAAM,WAAW,OAAO,CAAC,QAAQ,EAAE,KAAK,SAAS,OAAO,EAAE,EAAE,OAAO;IACjE,sBAAsB;IACtB,EAAE,EAAE,MAAM,CAAC;IACX,gBAAgB;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,4BAA4B;IAC5B,OAAO,EAAE,WAAW,CAAC,QAAQ,EAAE,KAAK,EAAE,OAAO,CAAC,CAAC;IAC/C,wCAAwC;IACxC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,sCAAsC;IACtC,UAAU,CAAC,EAAE,OAAO,CAAC;CACtB"}

package/dist/types/tool.js

@@ -0,0 +1,5 @@
+/**
+ * Tool system type definitions
+ */
+export {};
+//# sourceMappingURL=tool.js.map

package/dist/types/tool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool.js","sourceRoot":"","sources":["../../src/types/tool.ts"],"names":[],"mappings":"AAAA;;GAEG"}

package/dist/utils/retry.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Retry utility with exponential backoff
+ */
+export interface RetryOptions<T> {
+    operation: () => Promise<T>;
+    maxRetries: number;
+    delay: (attempt: number) => number;
+    onRetry?: (attempt: number, error: unknown) => void;
+    onFailure?: (error: unknown) => boolean;
+}
+export declare function retry<T>(options: RetryOptions<T>): Promise<T>;
+export declare const withTimeoutAndRetry: <T>(operation: () => Promise<T>, timeoutMs?: number, maxRetries?: number, operationName?: string) => Promise<T>;
+//# sourceMappingURL=retry.d.ts.map

package/dist/utils/retry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"retry.d.ts","sourceRoot":"","sources":["../../src/utils/retry.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,MAAM,WAAW,YAAY,CAAC,CAAC;IAC7B,SAAS,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,CAAC;IAC5B,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,MAAM,CAAC;IACnC,OAAO,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,KAAK,IAAI,CAAC;IACpD,SAAS,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,OAAO,CAAC;CACzC;AAED,wBAAsB,KAAK,CAAC,CAAC,EAAE,OAAO,EAAE,YAAY,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CA8BnE;AAED,eAAO,MAAM,mBAAmB,GAAU,CAAC,EACzC,WAAW,MAAM,OAAO,CAAC,CAAC,CAAC,EAC3B,YAAW,MAAc,EACzB,aAAY,MAAU,EACtB,gBAAe,MAAuB,KACrC,OAAO,CAAC,CAAC,CA8CX,CAAC"}

package/dist/utils/retry.js

@@ -0,0 +1,70 @@
+/**
+ * Retry utility with exponential backoff
+ */
+export async function retry(options) {
+    const { operation, maxRetries, delay, onRetry, onFailure } = options;
+    let lastError;
+    for (let attempt = 0; attempt <= maxRetries; attempt++) {
+        try {
+            return await operation();
+        }
+        catch (error) {
+            lastError = error;
+            if (attempt === maxRetries) {
+                const shouldRethrow = onFailure ? onFailure(lastError) : true;
+                if (shouldRethrow) {
+                    throw lastError;
+                }
+                break;
+            }
+            if (onRetry) {
+                onRetry(attempt, lastError);
+            }
+            const delayMs = delay(attempt);
+            await new Promise((resolve) => setTimeout(resolve, delayMs));
+        }
+    }
+    // eslint-disable-next-line @typescript-eslint/only-throw-error
+    throw lastError ?? new Error("Operation failed");
+}
+export const withTimeoutAndRetry = async (operation, timeoutMs = 60000, maxRetries = 3, operationName = "AI operation") => {
+    const createTimeoutOperation = () => async () => {
+        const controller = new AbortController();
+        const timeoutId = setTimeout(() => {
+            controller.abort();
+        }, timeoutMs);
+        try {
+            const result = await Promise.race([
+                operation(),
+                new Promise((_, reject) => {
+                    controller.signal.addEventListener("abort", () => {
+                        reject(new Error(`Operation timed out after ${timeoutMs}ms`));
+                    });
+                }),
+            ]);
+            clearTimeout(timeoutId);
+            return result;
+        }
+        catch (error) {
+            clearTimeout(timeoutId);
+            throw error;
+        }
+    };
+    return retry({
+        operation: createTimeoutOperation(),
+        maxRetries,
+        delay: (attempt) => Math.min(1000 * Math.pow(2, attempt), 5000),
+        onRetry: (attempt, error) => {
+            const message = error instanceof Error ? error.message : String(error);
+            console.error(`[${operationName}] Failed attempt ${attempt + 1}:`, message);
+            const delay = Math.min(1000 * Math.pow(2, attempt), 5000);
+            console.log(`[${operationName}] Retrying in ${delay}ms...`);
+            console.log(`[${operationName}] Attempt ${attempt + 2}/${maxRetries + 1}`);
+        },
+        onFailure: (_error) => {
+            console.error(`[${operationName}] All ${maxRetries + 1} attempts failed`);
+            return true;
+        },
+    });
+};
+//# sourceMappingURL=retry.js.map

package/dist/utils/retry.js.map

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