@falai/agent 0.1.0-alpha2

package/dist/cjs/src/types/agent.js

@@ -0,0 +1,21 @@
+"use strict";
+/**
+ * Agent-related type definitions
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CompositionMode = void 0;
+/**
+ * Composition mode determines how the agent processes and structures responses
+ */
+var CompositionMode;
+(function (CompositionMode) {
+    /** Fluid, natural conversation without strict structure */
+    CompositionMode["FLUID"] = "fluid";
+    /** Canned responses with fluid fallback */
+    CompositionMode["CANNED_FLUID"] = "canned_fluid";
+    /** Composited canned responses */
+    CompositionMode["CANNED_COMPOSITED"] = "composited_canned";
+    /** Strict canned responses only */
+    CompositionMode["CANNED_STRICT"] = "strict_canned";
+})(CompositionMode || (exports.CompositionMode = CompositionMode = {}));
+//# sourceMappingURL=agent.js.map

package/dist/cjs/src/types/agent.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent.js","sourceRoot":"","sources":["../../../../src/types/agent.ts"],"names":[],"mappings":";AAAA;;GAEG;;;AAUH;;GAEG;AACH,IAAY,eASX;AATD,WAAY,eAAe;IACzB,2DAA2D;IAC3D,kCAAe,CAAA;IACf,2CAA2C;IAC3C,gDAA6B,CAAA;IAC7B,kCAAkC;IAClC,0DAAuC,CAAA;IACvC,mCAAmC;IACnC,kDAA+B,CAAA;AACjC,CAAC,EATW,eAAe,+BAAf,eAAe,QAS1B"}

package/dist/cjs/src/types/ai.d.ts

@@ -0,0 +1,143 @@
+/**
+ * AI provider strategy types
+ */
+import type { Event } from "./history";
+/**
+ * Reasoning/thinking configuration for AI models
+ */
+export interface ReasoningConfig {
+    /**
+     * Effort level for reasoning models (OpenAI: gpt-5, o-series)
+     * - minimal: Fastest, least reasoning
+     * - low: Basic reasoning
+     * - medium: Balanced reasoning
+     * - high: Maximum reasoning effort
+     */
+    effort?: "minimal" | "low" | "medium" | "high";
+    /**
+     * Summary detail level of reasoning process
+     * - auto: Model decides
+     * - concise: Brief summary
+     * - detailed: Full reasoning details
+     */
+    summary?: "auto" | "concise" | "detailed";
+    /**
+     * Whether to include thinking/reasoning in response (Gemini)
+     */
+    includeThoughts?: boolean;
+}
+/**
+ * Input for AI message generation
+ */
+export interface GenerateMessageInput<TContext = unknown> {
+    /** The constructed prompt */
+    prompt: string;
+    /** Interaction history */
+    history: Event[];
+    /** Context data */
+    context: TContext;
+    /** Tools available for AI to call during this interaction */
+    tools?: Array<{
+        id: string;
+        name?: string;
+        description?: string;
+        parameters?: unknown;
+    }>;
+    /** Additional generation parameters */
+    parameters?: {
+        /** Maximum output tokens to generate */
+        maxOutputTokens?: number;
+        /** Reasoning/thinking configuration */
+        reasoning?: ReasoningConfig;
+        /**
+         * Required: Structured JSON schema the provider must enforce for output
+         */
+        jsonSchema: {
+            [key: string]: unknown;
+        };
+        /** Optional schema name (used by providers that require one) */
+        schemaName?: string;
+    };
+    /** Abort signal for cancellation */
+    signal?: AbortSignal;
+}
+/**
+ * Structured response from AI containing message and metadata
+ */
+export interface AgentStructuredResponse extends Record<string, unknown> {
+    /** The actual message to send to the user */
+    message: string;
+    /** Route chosen by the agent (route title or null if no route) */
+    route?: string | null;
+    /** Current step within the route (step description or null) */
+    step?: string | null;
+    /** Tool calls the agent wants to execute */
+    toolCalls?: Array<{
+        /** Name of the tool to call */
+        toolName: string;
+        /** Arguments to pass to the tool */
+        arguments: Record<string, unknown>;
+    }>;
+    /** Additional reasoning or internal thoughts (optional) */
+    reasoning?: string;
+}
+/**
+ * Output from AI message generation
+ */
+export interface GenerateMessageOutput<TStructured = AgentStructuredResponse> {
+    /** The generated message */
+    message: string;
+    /** Optional metadata about generation */
+    metadata?: {
+        /** Model used */
+        model?: string;
+        /** Tokens consumed */
+        tokensUsed?: number;
+        /** Finish reason */
+        finishReason?: string;
+        /** Additional provider-specific data */
+        [key: string]: unknown;
+    };
+    /** Structured response data (when JSON mode is enabled) */
+    structured?: TStructured;
+}
+/**
+ * Stream chunk from AI message generation
+ */
+export interface GenerateMessageStreamChunk<TStructured = AgentStructuredResponse> {
+    /** The delta/chunk of the message */
+    delta: string;
+    /** Accumulated message so far */
+    accumulated: string;
+    /** Whether this is the final chunk */
+    done: boolean;
+    /** Optional metadata about generation */
+    metadata?: {
+        /** Model used */
+        model?: string;
+        /** Tokens consumed */
+        tokensUsed?: number;
+        /** Finish reason */
+        finishReason?: string;
+        /** Additional provider-specific data */
+        [key: string]: unknown;
+    };
+    /** Structured response data (only available when done=true and JSON mode is enabled) */
+    structured?: TStructured;
+}
+/**
+ * AI provider interface (strategy pattern)
+ */
+export interface AiProvider {
+    /** Provider name/identifier */
+    readonly name: string;
+    /**
+     * Generate a message based on prompt and context
+     */
+    generateMessage<TContext = unknown, TStructured = AgentStructuredResponse>(input: GenerateMessageInput<TContext>): Promise<GenerateMessageOutput<TStructured>>;
+    /**
+     * Generate a message as a stream based on prompt and context
+     */
+    generateMessageStream<TContext = unknown, TStructured = AgentStructuredResponse>(input: GenerateMessageInput<TContext>): AsyncGenerator<GenerateMessageStreamChunk<TStructured>>;
+}
+//# sourceMappingURL=ai.d.ts.map

package/dist/cjs/src/types/ai.d.ts.map

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

package/dist/cjs/src/types/ai.js

@@ -0,0 +1,6 @@
+"use strict";
+/**
+ * AI provider strategy types
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=ai.js.map

package/dist/cjs/src/types/ai.js.map

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

package/dist/cjs/src/types/history.d.ts

@@ -0,0 +1,178 @@
+/**
+ * Event history and interaction types
+ */
+/**
+ * Message source enum - defines valid sources for messages and events
+ */
+export declare enum MessageRole {
+    /** Message/event from user/customer */
+    USER = "user",
+    /** Conversational message from AI assistant */
+    ASSISTANT = "assistant",
+    /** Tool execution/action by AI agent */
+    AGENT = "agent",
+    /** System message/event */
+    SYSTEM = "system"
+}
+export type MessageRoleType = MessageRole;
+import type { SessionState } from "./session";
+/**
+ * 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"
+}
+export type EventKindType = EventKind;
+/**
+ * Participant in a conversation
+ */
+export interface Participant {
+    /** Display name */
+    display_name: string;
+    /** Unique identifier */
+    id?: string;
+}
+/**
+ * Role types for simplified history format
+ */
+export type Role = "user" | "assistant" | "tool" | "system";
+export type UserHistoryItem = {
+    role: "user";
+    content: string;
+    name?: string;
+};
+export type AssistantHistoryItem = {
+    role: "assistant";
+    content: string | null;
+    tool_calls?: Array<{
+        id: string;
+        name: string;
+        arguments: Record<string, unknown>;
+    }>;
+};
+export type ToolHistoryItem = {
+    role: "tool";
+    tool_call_id: string;
+    name: string;
+    content: any;
+};
+export type SystemHistoryItem = {
+    role: "system";
+    content: string;
+};
+/**
+ * Simplified history item for developer-friendly API
+ */
+export type HistoryItem = UserHistoryItem | AssistantHistoryItem | ToolHistoryItem | SystemHistoryItem;
+/**
+ * Simplified history array type
+ */
+export type History = HistoryItem[];
+/**
+ * Simple JSON format for history messages (developer-friendly)
+ */
+export interface HistoryMessage<TData = unknown> {
+    /** Role of the message sender */
+    role: MessageRole;
+    /** Message content */
+    content: string;
+    /** Optional participant name */
+    name?: string;
+    /** Optional timestamp (ISO string) */
+    timestamp?: string;
+    /** Optional session state */
+    session?: SessionState<TData>;
+    /** Optional additional metadata */
+    metadata?: Record<string, unknown>;
+}
+/**
+ * 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[];
+    /** Tool calls made by the assistant */
+    toolCalls?: Array<{
+        id: string;
+        name: string;
+        arguments: Record<string, unknown>;
+    }>;
+    /** Session metadata attached to this message */
+    session?: {
+        routeId?: string;
+        routeTitle?: string;
+        stepId?: string;
+        stepDescription?: string;
+        data?: Record<string, unknown>;
+    };
+}
+/**
+ * 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: MessageRole;
+    /** 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/cjs/src/types/history.d.ts.map

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

package/dist/cjs/src/types/history.js

@@ -0,0 +1,33 @@
+"use strict";
+/**
+ * Event history and interaction types
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.EventKind = exports.MessageRole = void 0;
+/**
+ * Message source enum - defines valid sources for messages and events
+ */
+var MessageRole;
+(function (MessageRole) {
+    /** Message/event from user/customer */
+    MessageRole["USER"] = "user";
+    /** Conversational message from AI assistant */
+    MessageRole["ASSISTANT"] = "assistant";
+    /** Tool execution/action by AI agent */
+    MessageRole["AGENT"] = "agent";
+    /** System message/event */
+    MessageRole["SYSTEM"] = "system";
+})(MessageRole || (exports.MessageRole = MessageRole = {}));
+/**
+ * Types of events in the interaction history
+ */
+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 || (exports.EventKind = EventKind = {}));
+//# sourceMappingURL=history.js.map

package/dist/cjs/src/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,IAAY,WASX;AATD,WAAY,WAAW;IACrB,uCAAuC;IACvC,4BAAa,CAAA;IACb,+CAA+C;IAC/C,sCAAuB,CAAA;IACvB,wCAAwC;IACxC,8BAAe,CAAA;IACf,2BAA2B;IAC3B,gCAAiB,CAAA;AACnB,CAAC,EATW,WAAW,2BAAX,WAAW,QAStB;AAMD;;GAEG;AACH,IAAY,SAOX;AAPD,WAAY,SAAS;IACnB,2BAA2B;IAC3B,gCAAmB,CAAA;IACnB,6BAA6B;IAC7B,0BAAa,CAAA;IACb,4BAA4B;IAC5B,8BAAiB,CAAA;AACnB,CAAC,EAPW,SAAS,yBAAT,SAAS,QAOpB"}

package/dist/cjs/src/types/index.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Central type definitions export
+ */
+export type { AgentOptions, Term, Guideline, GuidelineMatch, AgentResponseStreamChunk, AgentResponse, ContextLifecycleHooks, ContextProvider, ValidationError, ValidationResult, } from "./agent";
+export { CompositionMode } from "./agent";
+export type { Event, EmittedEvent, MessageEventData, ToolEventData, StatusEventData, Participant, ToolResult as EventToolResult, ToolCall, HistoryMessage, Role, HistoryItem, History, UserHistoryItem, AssistantHistoryItem, SystemHistoryItem, ToolHistoryItem, } from "./history";
+export { EventKind, MessageRole } from "./history";
+export * from "./history";
+export type { RouteOptions, RouteRef, StepRef, StepOptions, BranchSpec, StepResult, BranchResult, RouteCompletionHandler, RouteTransitionConfig, RouteLifecycleHooks, } from "./route";
+export * from "./route";
+export type { SessionState, PendingTransition } from "./session";
+export type { Tool, ToolContext, ToolResult, ToolHandler, ToolExecutionResult, DataEnrichmentConfig, ValidationConfig, ApiCallConfig, ComputationConfig } from "./tool";
+export { ToolScope } from "./tool";
+export type { AiProvider, GenerateMessageInput, GenerateMessageOutput, AgentStructuredResponse, ReasoningConfig, GenerateMessageStreamChunk, } from "./ai";
+export type { StructuredSchema } from "./schema";
+export type { RoutingDecision } from "./routing";
+export * from "./routing";
+export type { SessionData, MessageData, SessionStatus, SessionRepository, MessageRepository, PersistenceAdapter, PersistenceConfig, CreateSessionOptions, CreateSessionData, SaveMessageOptions, CollectedStateData, } from "./persistence";
+export * from "./persistence";
+export type { Template, TemplateContext, ConditionTemplate, ConditionEvaluationResult } from "./template";
+export { ConditionEvaluator, createConditionEvaluator, extractAIContextStrings, hasProgrammaticConditions } from "../utils/condition";
+//# sourceMappingURL=index.d.ts.map

package/dist/cjs/src/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,cAAc,EACd,wBAAwB,EACxB,aAAa,EACb,qBAAqB,EACrB,eAAe,EACf,eAAe,EACf,gBAAgB,GACjB,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,EACR,cAAc,EACd,IAAI,EACJ,WAAW,EACX,OAAO,EACP,eAAe,EACf,oBAAoB,EACpB,iBAAiB,EACjB,eAAe,GAChB,MAAM,WAAW,CAAC;AACnB,OAAO,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AACnD,cAAc,WAAW,CAAC;AAG1B,YAAY,EACV,YAAY,EACZ,QAAQ,EACR,OAAO,EACP,WAAW,EACX,UAAU,EACV,UAAU,EACV,YAAY,EACZ,sBAAsB,EACtB,qBAAqB,EACrB,mBAAmB,GACpB,MAAM,SAAS,CAAC;AACjB,cAAc,SAAS,CAAC;AAGxB,YAAY,EAAE,YAAY,EAAE,iBAAiB,EAAE,MAAM,WAAW,CAAC;AAGjE,YAAY,EACV,IAAI,EACJ,WAAW,EACX,UAAU,EACV,WAAW,EACX,mBAAmB,EACnB,oBAAoB,EACpB,gBAAgB,EAChB,aAAa,EACb,iBAAiB,EAClB,MAAM,QAAQ,CAAC;AAChB,OAAO,EAAE,SAAS,EAAE,MAAM,QAAQ,CAAC;AAGnC,YAAY,EACV,UAAU,EACV,oBAAoB,EACpB,qBAAqB,EACrB,uBAAuB,EACvB,eAAe,EACf,0BAA0B,GAC3B,MAAM,MAAM,CAAC;AAGd,YAAY,EAAE,gBAAgB,EAAE,MAAM,UAAU,CAAC;AAGjD,YAAY,EAAE,eAAe,EAAE,MAAM,WAAW,CAAC;AACjD,cAAc,WAAW,CAAC;AAG1B,YAAY,EACV,WAAW,EACX,WAAW,EACX,aAAa,EACb,iBAAiB,EACjB,iBAAiB,EACjB,kBAAkB,EAClB,iBAAiB,EACjB,oBAAoB,EACpB,iBAAiB,EACjB,kBAAkB,EAClB,kBAAkB,GACnB,MAAM,eAAe,CAAC;AACvB,cAAc,eAAe,CAAC;AAG9B,YAAY,EACV,QAAQ,EACR,eAAe,EACf,iBAAiB,EACjB,yBAAyB,EAC1B,MAAM,YAAY,CAAC;AACpB,OAAO,EACL,kBAAkB,EAClB,wBAAwB,EACxB,uBAAuB,EACvB,yBAAyB,EAC1B,MAAM,oBAAoB,CAAC"}

package/dist/cjs/src/types/index.js

@@ -0,0 +1,37 @@
+"use strict";
+/**
+ * Central type definitions export
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.hasProgrammaticConditions = exports.extractAIContextStrings = exports.createConditionEvaluator = exports.ConditionEvaluator = exports.ToolScope = exports.MessageRole = exports.EventKind = exports.CompositionMode = void 0;
+var agent_1 = require("./agent");
+Object.defineProperty(exports, "CompositionMode", { enumerable: true, get: function () { return agent_1.CompositionMode; } });
+var history_1 = require("./history");
+Object.defineProperty(exports, "EventKind", { enumerable: true, get: function () { return history_1.EventKind; } });
+Object.defineProperty(exports, "MessageRole", { enumerable: true, get: function () { return history_1.MessageRole; } });
+__exportStar(require("./history"), exports);
+__exportStar(require("./route"), exports);
+var tool_1 = require("./tool");
+Object.defineProperty(exports, "ToolScope", { enumerable: true, get: function () { return tool_1.ToolScope; } });
+__exportStar(require("./routing"), exports);
+__exportStar(require("./persistence"), exports);
+var condition_1 = require("../utils/condition");
+Object.defineProperty(exports, "ConditionEvaluator", { enumerable: true, get: function () { return condition_1.ConditionEvaluator; } });
+Object.defineProperty(exports, "createConditionEvaluator", { enumerable: true, get: function () { return condition_1.createConditionEvaluator; } });
+Object.defineProperty(exports, "extractAIContextStrings", { enumerable: true, get: function () { return condition_1.extractAIContextStrings; } });
+Object.defineProperty(exports, "hasProgrammaticConditions", { enumerable: true, get: function () { return condition_1.hasProgrammaticConditions; } });
+//# sourceMappingURL=index.js.map

package/dist/cjs/src/types/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/types/index.ts"],"names":[],"mappings":";AAAA;;GAEG;;;;;;;;;;;;;;;;;AAeH,iCAA0C;AAAjC,wGAAA,eAAe,OAAA;AAqBxB,qCAAmD;AAA1C,oGAAA,SAAS,OAAA;AAAE,sGAAA,WAAW,OAAA;AAC/B,4CAA0B;AAe1B,0CAAwB;AAiBxB,+BAAmC;AAA1B,iGAAA,SAAS,OAAA;AAiBlB,4CAA0B;AAgB1B,gDAA8B;AAS9B,gDAK4B;AAJ1B,+GAAA,kBAAkB,OAAA;AAClB,qHAAA,wBAAwB,OAAA;AACxB,oHAAA,uBAAuB,OAAA;AACvB,sHAAA,yBAAyB,OAAA"}