@falai/agent 0.4.0 → 0.5.0

package/dist/core/PromptBuilder.js

@@ -1,417 +0,0 @@
-/**
- * Prompt construction and management
- */
-import { EventKind, EventSource } from "../types/history";
-import { SectionStatus } from "../types/prompt";
-import { adaptEvent } from "./Events";
-/**
- * Built-in section identifiers
- */
-export var BuiltInSection;
-(function (BuiltInSection) {
-    BuiltInSection["AGENT_IDENTITY"] = "agent_identity";
-    BuiltInSection["CUSTOMER_IDENTITY"] = "customer_identity";
-    BuiltInSection["INTERACTION_HISTORY"] = "interaction_history";
-    BuiltInSection["CONTEXT_VARIABLES"] = "context_variables";
-    BuiltInSection["GLOSSARY"] = "glossary";
-    BuiltInSection["GUIDELINE_DESCRIPTIONS"] = "guideline_descriptions";
-    BuiltInSection["GUIDELINES"] = "guidelines";
-    BuiltInSection["STAGED_EVENTS"] = "staged_events";
-    BuiltInSection["ROUTES"] = "routes";
-    BuiltInSection["OBSERVATIONS"] = "observations";
-    BuiltInSection["CAPABILITIES"] = "capabilities";
-    BuiltInSection["ACTIVE_ROUTES"] = "active_routes";
-    BuiltInSection["DOMAINS"] = "domains";
-})(BuiltInSection || (BuiltInSection = {}));
-/**
- * Builds prompts from composable sections
- */
-export class PromptBuilder {
-    constructor(onBuild) {
-        this.sections = new Map();
-        this.cachedResults = new Set();
-        this.onBuild = onBuild;
-    }
-    /**
-     * Build the final prompt from all sections
-     */
-    build() {
-        const parts = [];
-        for (const section of this.sections.values()) {
-            try {
-                const formatted = this.formatTemplate(section.template, section.props);
-                parts.push(formatted);
-            }
-            catch (error) {
-                throw new Error(`Error formatting section: ${error instanceof Error ? error.message : "Unknown error"}`);
-            }
-        }
-        const prompt = parts.join("\n\n").trim();
-        if (this.onBuild && !this.cachedResults.has(prompt)) {
-            this.onBuild(prompt);
-            this.cachedResults.add(prompt);
-        }
-        return prompt;
-    }
-    /**
-     * Add a section to the prompt
-     */
-    addSection(name, template, props = {}, status) {
-        if (this.sections.has(name)) {
-            throw new Error(`Section '${String(name)}' already exists`);
-        }
-        this.sections.set(name, {
-            template,
-            props,
-            status,
-        });
-        return this;
-    }
-    /**
-     * Edit an existing section
-     */
-    editSection(name, editor) {
-        const section = this.sections.get(name);
-        if (section) {
-            this.sections.set(name, editor(section));
-        }
-        return this;
-    }
-    /**
-     * Get section status
-     */
-    sectionStatus(name) {
-        const section = this.sections.get(name);
-        return section?.status || SectionStatus.NONE;
-    }
-    /**
-     * Add agent identity section
-     */
-    addAgentIdentity(agent) {
-        if (agent.description) {
-            this.addSection(BuiltInSection.AGENT_IDENTITY, `You are an AI agent named {agent_name}.
-
-The following is a description of your background and personality: ###
-{agent_description}
-###`, {
-                agent_name: agent.name,
-                agent_description: agent.description,
-            }, SectionStatus.ACTIVE);
-        }
-        return this;
-    }
-    /**
-     * Add customer identity section
-     */
-    addCustomerIdentity(customer) {
-        this.addSection(BuiltInSection.CUSTOMER_IDENTITY, `The user you're interacting with is called {customer_name}.`, { customer_name: customer.name }, SectionStatus.ACTIVE);
-        return this;
-    }
-    /**
-     * Add interaction history section
-     */
-    addInteractionHistory(events, stagedEvents = []) {
-        if (events.length === 0 && stagedEvents.length === 0) {
-            this.addSection(BuiltInSection.INTERACTION_HISTORY, `Your interaction with the user has just began, and no events have been recorded yet.
-Proceed with your task accordingly.`, {}, SectionStatus.PASSIVE);
-        }
-        else {
-            const interactionEvents = this.gatherInteractionEvents(events, stagedEvents);
-            this.addSection(BuiltInSection.INTERACTION_HISTORY, `The following is a list of events describing a back-and-forth
-interaction between you and a user: ###
-{interaction_events}
-###`, { interaction_events: interactionEvents.join("\n") }, SectionStatus.ACTIVE);
-        }
-        return this;
-    }
-    /**
-     * Add interaction history with special handling for message generation
-     */
-    addInteractionHistoryForMessageGeneration(events, stagedEvents = []) {
-        if (events.length === 0 && stagedEvents.length === 0) {
-            return this.addInteractionHistory(events, stagedEvents);
-        }
-        const interactionEvents = this.gatherInteractionEvents(events, stagedEvents);
-        const lastEventNote = this.lastAgentMessageNote(events);
-        let template = `The following is a list of events describing a back-and-forth
-interaction between you and a user: ###
-{interaction_events}
-###`;
-        const props = {
-            interaction_events: interactionEvents.join("\n"),
-        };
-        if (lastEventNote) {
-            template += "\n\n{last_event_note}";
-            props.last_event_note = lastEventNote;
-        }
-        this.addSection(BuiltInSection.INTERACTION_HISTORY, template, props, SectionStatus.ACTIVE);
-        return this;
-    }
-    /**
-     * Add context variables section
-     */
-    addContextVariables(variables) {
-        if (variables.length > 0) {
-            const contextValues = this.contextVariablesToJson(variables);
-            this.addSection(BuiltInSection.CONTEXT_VARIABLES, `The following is information that you're given about the user and context of the interaction: ###
-{context_values}
-###`, { context_values: contextValues }, SectionStatus.ACTIVE);
-        }
-        return this;
-    }
-    /**
-     * Add glossary section
-     */
-    addGlossary(terms) {
-        if (terms.length > 0) {
-            const termsString = terms
-                .map((t, i) => {
-                const synonyms = t.synonyms?.length
-                    ? ` (synonyms: ${t.synonyms.join(", ")})`
-                    : "";
-                return `${i + 1}) ${t.name}${synonyms}: ${t.description}`;
-            })
-                .join("\n");
-            this.addSection(BuiltInSection.GLOSSARY, `The following is a glossary of the business.
-Understanding these terms, as they apply to the business, is critical for your task.
-When encountering any of these terms, prioritize the interpretation provided here over any definitions you may already know.
-Please be tolerant of possible typos by the user with regards to these terms,
-and let the user know if/when you assume they meant a term by their typo: ###
-{terms_string}
-###`, { terms_string: termsString }, SectionStatus.ACTIVE);
-        }
-        return this;
-    }
-    /**
-     * Add staged tool events section
-     */
-    addStagedToolEvents(events) {
-        const toolEvents = events.filter((e) => e.kind === EventKind.TOOL);
-        if (toolEvents.length > 0) {
-            const stagedEventsAsDict = toolEvents.map((e) => adaptEvent(e));
-            this.addSection(BuiltInSection.STAGED_EVENTS, `Here are the most recent staged events for your reference.
-They represent interactions with external tools that perform actions or provide information.
-Prioritize their data over any other sources and use their details to complete your task: ###
-{staged_events_as_dict}
-###`, { staged_events_as_dict: stagedEventsAsDict.join("\n") }, SectionStatus.ACTIVE);
-        }
-        return this;
-    }
-    /**
-     * Add guidelines for message generation
-     */
-    addGuidelinesForMessageGeneration(guidelines) {
-        if (guidelines.length === 0) {
-            this.addSection(BuiltInSection.GUIDELINE_DESCRIPTIONS, `In formulating your reply, you are normally required to follow a number of behavioral guidelines.
-However, in this case, no special behavioral guidelines were provided. Therefore, when generating revisions,
-you don't need to specifically double-check if you followed or broke any guidelines.`, {}, SectionStatus.PASSIVE);
-            return this;
-        }
-        const guidelineList = guidelines
-            .map((g, i) => {
-            const num = i + 1;
-            let text = g.guideline.condition
-                ? `Guideline #${num}) When ${g.guideline.condition}, then ${g.guideline.action}`
-                : `Guideline #${num}) ${g.guideline.action}`;
-            if (g.rationale) {
-                text += `\n      - Rationale: ${g.rationale}`;
-            }
-            return text;
-        })
-            .join("\n");
-        this.addSection(BuiltInSection.GUIDELINE_DESCRIPTIONS, `When crafting your reply, you must follow the behavioral guidelines provided below, which have been identified as relevant to the current state of the interaction.
-
-- **Guidelines**:
-{guideline_list}
-
-You may choose not to follow a guideline only in the following cases:
-    - It conflicts with a previous customer request.
-    - It is clearly inappropriate given the current context of the conversation.
-    - It lacks sufficient context or data to apply reliably.
-    - It conflicts with an insight.
-
-In all other situations, you are expected to adhere to the guidelines.
-These guidelines have already been pre-filtered based on the interaction's context and other considerations outside your scope.`, { guideline_list: guidelineList }, SectionStatus.ACTIVE);
-        return this;
-    }
-    /**
-     * Add capabilities section for message generation
-     */
-    addCapabilitiesForMessageGeneration(capabilities) {
-        if (capabilities.length > 0) {
-            const capabilitiesString = capabilities
-                .map((c, i) => `Supported Capability ${i + 1}: ${c.title}
-${c.description}`)
-                .join("\n\n");
-            this.addSection(BuiltInSection.CAPABILITIES, `Below are the capabilities available to you as an agent.
-You may inform the customer that you can assist them using these capabilities.
-If you choose to use any of them, additional details will be provided in your next response.
-Always prefer adhering to guidelines, before offering capabilities - only offer capabilities if you have no other instruction that's relevant for the current stage of the interaction.
-Be proactive and offer the most relevant capabilities—but only if they are likely to move the conversation forward.
-If multiple capabilities are appropriate, aim to present them all to the customer.
-If none of the capabilities address the current request of the customer - DO NOT MENTION THEM.
-###
-{capabilities_string}
-###`, { capabilities_string: capabilitiesString }, SectionStatus.ACTIVE);
-        }
-        return this;
-    }
-    /**
-     * Add observations for disambiguation
-     */
-    addObservations(observations) {
-        if (observations.length > 0) {
-            const observationsString = observations
-                .map((obs, i) => {
-                const routeTitles = obs.routes.map((r) => `"${r.title}"`).join(", ");
-                return `${i + 1}) "${obs.description}" → Can lead to routes: ${routeTitles}`;
-            })
-                .join("\n");
-            this.addSection(BuiltInSection.OBSERVATIONS, `The following observations may help you understand the user's intent and choose the appropriate response path:
-###
-{observations_string}
-###
-
-When you detect any of these situations, consider which route would be most appropriate based on the user's actual need.`, { observations_string: observationsString }, SectionStatus.ACTIVE);
-        }
-        return this;
-    }
-    /**
-     * Add active routes information
-     */
-    addActiveRoutes(routes) {
-        if (routes.length > 0) {
-            const routesString = routes
-                .map((route, i) => {
-                const conditions = route.conditions.length > 0
-                    ? `\n  Triggered when: ${route.conditions.join(" OR ")}`
-                    : "";
-                const desc = route.description ? `\n  ${route.description}` : "";
-                let domainInfo = "";
-                if (route.domains !== undefined) {
-                    if (route.domains.length === 0) {
-                        domainInfo = "\n  Available tools: None (conversation only)";
-                    }
-                    else {
-                        domainInfo = `\n  Available tools: ${route.domains.join(", ")}`;
-                    }
-                }
-                let rulesInfo = "";
-                if (route.rules && route.rules.length > 0) {
-                    const rulesList = route.rules
-                        .map((r, idx) => `${idx + 1}. ${r}`)
-                        .join("; ");
-                    rulesInfo = `\n  RULES: ${rulesList}`;
-                }
-                let prohibitionsInfo = "";
-                if (route.prohibitions && route.prohibitions.length > 0) {
-                    const prohibitionsList = route.prohibitions
-                        .map((p, idx) => `${idx + 1}. ${p}`)
-                        .join("; ");
-                    prohibitionsInfo = `\n  PROHIBITIONS: ${prohibitionsList}`;
-                }
-                return `${i + 1}) ${route.title}${desc}${conditions}${domainInfo}${rulesInfo}${prohibitionsInfo}`;
-            })
-                .join("\n\n");
-            this.addSection(BuiltInSection.ACTIVE_ROUTES, `Available conversation routes:
-###
-{routes_string}
-###
-
-These routes represent different paths the conversation can take. Choose the most appropriate route based on the user's needs.
-IMPORTANT: 
-- If a route specifies available tools, you can ONLY call tools from those domains when following that route.
-- If a route has RULES, you MUST follow them when you choose that route.
-- If a route has PROHIBITIONS, you MUST NEVER do those things when you choose that route.`, { routes_string: routesString }, SectionStatus.ACTIVE);
-        }
-        return this;
-    }
-    /**
-     * Add domains (tools) information
-     */
-    addDomains(domains) {
-        const domainNames = Object.keys(domains);
-        if (domainNames.length > 0) {
-            const domainsString = domainNames
-                .map((name, i) => {
-                const toolNames = Object.keys(domains[name]);
-                const tools = toolNames.join(", ");
-                return `${i + 1}) Domain "${name}": ${tools}`;
-            })
-                .join("\n");
-            this.addSection(BuiltInSection.DOMAINS, `Available tool domains:
-###
-{domains_string}
-###
-
-These are the tool domains registered in the system. Each domain contains specific tools/methods.
-When calling tools, use the format: domain.toolName (e.g., "payment.processPayment").`, { domains_string: domainsString }, SectionStatus.ACTIVE);
-        }
-        return this;
-    }
-    /**
-     * Add JSON response schema instructions
-     *
-     * NOTE: toolCalls are NOT included. Tools execute automatically based on
-     * state transitions and guideline matching, NOT based on AI decisions.
-     */
-    addJsonResponseSchema() {
-        const schema = {
-            message: "The actual message to send to the user",
-            route: "The title of the route you chose (or null if no specific route)",
-            state: "The current state within the chosen route (or null if not in a route)",
-            reasoning: "Optional: Your internal reasoning for this response",
-        };
-        this.addSection("json_response_format", `IMPORTANT: You must respond with valid JSON in the following format:
-
-\`\`\`json
-${JSON.stringify(schema, null, 2)}
-\`\`\`
-
-Instructions:
-- "message": The actual message to send to the user (required)
-- "route": If you chose a specific conversation route, provide its exact title. If not in a route, use null.
-- "state": The current state within the chosen route. If not in a route or at initial state, use null.
-- "reasoning": Optional field for your internal thinking process.
-
-Your entire response must be valid JSON. Do not include any text before or after the JSON object.`, {}, SectionStatus.ACTIVE);
-        return this;
-    }
-    // Helper methods
-    formatTemplate(template, props) {
-        return template.replace(/\{(\w+)\}/g, (match, key) => {
-            if (key in props) {
-                return String(props[key]);
-            }
-            return match;
-        });
-    }
-    gatherInteractionEvents(events, stagedEvents) {
-        const combined = [...events, ...stagedEvents];
-        return combined
-            .filter((e) => e.kind !== EventKind.STATUS)
-            .map((e) => adaptEvent(e));
-    }
-    lastAgentMessageNote(events) {
-        const lastMessageEvent = [...events]
-            .reverse()
-            .find((e) => e.kind === EventKind.MESSAGE);
-        if (!lastMessageEvent || lastMessageEvent.source !== EventSource.AI_AGENT) {
-            return null;
-        }
-        const lastMessage = lastMessageEvent.data.message;
-        return `IMPORTANT: Please note that the last message was sent by you, the AI agent (likely as a preamble). Your last message was: ###
-${lastMessage}
-###
-
-You must keep that in mind when responding to the user, to continue the last message naturally (without repeating anything similar in your last message - make sure you don't repeat something like this in your next message - it was already said!).`;
-    }
-    contextVariablesToJson(variables) {
-        const obj = {};
-        for (const v of variables) {
-            obj[v.variable.name] = v.value;
-        }
-        return JSON.stringify(obj, null, 2);
-    }
-}
-//# sourceMappingURL=PromptBuilder.js.map

package/dist/core/PromptBuilder.js.map

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

package/dist/types/observation.d.ts

@@ -1,27 +0,0 @@
-/**
- * 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 {
-    /** Custom ID for the observation (optional - will generate deterministic ID from description if not provided) */
-    id?: string;
-    /** 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

@@ -1 +0,0 @@
-{"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,iHAAiH;IACjH,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,kCAAkC;IAClC,WAAW,EAAE,MAAM,CAAC;IACpB,yFAAyF;IACzF,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;CACtB"}

package/dist/types/observation.js

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

package/dist/types/observation.js.map

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

package/dist/types/prompt.d.ts

@@ -1,46 +0,0 @@
-/**
- * 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

@@ -1 +0,0 @@
-{"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

@@ -1,16 +0,0 @@
-/**
- * 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

@@ -1 +0,0 @@
-{"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/docs/STRUCTURE.md

@@ -1,58 +0,0 @@
-# Package Structure
-
-```
-src/
-├── types/          # Type definitions (interfaces, types, enums)
-│   ├── agent.ts           # Agent types and configuration
-│   ├── ai.ts              # AI provider interfaces
-│   ├── history.ts         # Event and message history types
-│   ├── observation.ts     # Observation and disambiguation types
-│   ├── persistence.ts     # Persistence adapter interfaces
-│   ├── prompt.ts          # Prompt building types
-│   ├── route.ts           # Route and state types
-│   ├── tool.ts            # Tool definition types
-│   └── index.ts           # Type exports
-├── core/           # Core framework classes
-│   ├── Agent.ts           # Main agent class
-│   ├── Route.ts           # Route/Journey DSL
-│   ├── State.ts           # State management
-│   ├── Transition.ts      # State transitions
-│   ├── Observation.ts     # Disambiguation
-│   ├── Tool.ts            # Tool definitions
-│   ├── PromptBuilder.ts   # Prompt construction
-│   ├── Events.ts          # Event history
-│   ├── DomainRegistry.ts  # Domain organization
-│   └── PersistenceManager.ts  # Persistence lifecycle management
-├── providers/      # AI provider implementations
-│   ├── AnthropicProvider.ts   # Claude (Anthropic)
-│   ├── GeminiProvider.ts      # Google Gemini
-│   ├── OpenAIProvider.ts      # OpenAI GPT
-│   ├── OpenRouterProvider.ts  # OpenRouter (200+ models)
-│   └── index.ts               # Provider exports
-├── adapters/       # Database persistence adapters
-│   ├── MemoryAdapter.ts       # In-memory (testing/dev)
-│   ├── PrismaAdapter.ts       # Prisma ORM
-│   ├── RedisAdapter.ts        # Redis
-│   ├── MongoAdapter.ts        # MongoDB
-│   ├── PostgreSQLAdapter.ts   # PostgreSQL
-│   ├── SQLiteAdapter.ts       # SQLite
-│   ├── OpenSearchAdapter.ts   # OpenSearch/Elasticsearch
-│   └── index.ts               # Adapter exports
-├── utils/          # Utility functions
-│   ├── retry.ts           # Retry/timeout logic
-│   └── id.ts              # Deterministic ID generation
-├── constants/      # Constants and symbols
-│   └── index.ts           # END_ROUTE, EventSource, etc.
-└── index.ts        # Public API exports
-```
-
-## Design Principles
-
-1. **Flat, organized structure** - Clear separation by purpose
-2. **Types-first** - All types in dedicated folder
-3. **Core logic isolated** - Business logic in \`core/\`
-4. **Provider pattern** - Pluggable AI backends and database adapters
-5. **Optional persistence** - Multiple database adapters following the same pattern
-6. **Extensibility** - Easy to add new providers, adapters, and tools
-7. **Path aliases** - Clean imports with \`@/types\`, \`@/core\`, etc.
-8. **Fluent API** - Methods return \`this\` for chaining