@falai/agent 0.1.0

package/dist/core/Agent.js

@@ -0,0 +1,248 @@
+/**
+ * Core Agent implementation
+ */
+import { Route } from "@/core/Route";
+import { DomainRegistry } from "@/core/DomainRegistry";
+import { PromptBuilder } from "@/core/PromptBuilder";
+import { Observation } from "@/core/Observation";
+/**
+ * Main Agent class with generic context support
+ */
+export class Agent {
+    options;
+    terms = [];
+    guidelines = [];
+    capabilities = [];
+    routes = [];
+    observations = [];
+    domainRegistry = new DomainRegistry();
+    /**
+     * Dynamic domain property - populated via addDomain
+     */
+    domain = {};
+    constructor(options) {
+        this.options = options;
+        // Initialize with default values
+        if (!this.options.maxEngineIterations) {
+            this.options.maxEngineIterations = 1;
+        }
+        // Initialize from options
+        if (options.terms) {
+            this.terms = [...options.terms];
+        }
+        if (options.guidelines) {
+            options.guidelines.forEach((guideline) => {
+                this.createGuideline(guideline);
+            });
+        }
+        if (options.capabilities) {
+            options.capabilities.forEach((capability) => {
+                this.createCapability(capability);
+            });
+        }
+        if (options.routes) {
+            options.routes.forEach((routeOptions) => {
+                this.createRoute(routeOptions);
+            });
+        }
+        if (options.observations) {
+            options.observations.forEach((obsOptions) => {
+                const obs = this.createObservation(obsOptions.description);
+                // If route refs were provided, resolve and disambiguate
+                if (obsOptions.routeRefs && obsOptions.routeRefs.length > 0) {
+                    const resolvedRoutes = obsOptions.routeRefs
+                        .map((ref) => {
+                        // Try to find route by ID or title
+                        return this.routes.find((r) => r.id === ref || r.title === ref);
+                    })
+                        .filter((r) => r !== undefined);
+                    if (resolvedRoutes.length > 0) {
+                        obs.disambiguate(resolvedRoutes);
+                    }
+                }
+            });
+        }
+    }
+    /**
+     * Get agent name
+     */
+    get name() {
+        return this.options.name;
+    }
+    /**
+     * Get agent description
+     */
+    get description() {
+        return this.options.description;
+    }
+    /**
+     * Get agent goal
+     */
+    get goal() {
+        return this.options.goal;
+    }
+    /**
+     * Create a new route (journey)
+     */
+    createRoute(options) {
+        const route = new Route(options);
+        this.routes.push(route);
+        return route;
+    }
+    /**
+     * Create a domain term for the glossary
+     */
+    createTerm(term) {
+        this.terms.push(term);
+        return this;
+    }
+    /**
+     * Create a behavioral guideline
+     */
+    createGuideline(guideline) {
+        const guidelineWithId = {
+            ...guideline,
+            id: guideline.id || `guideline_${this.guidelines.length}`,
+            enabled: guideline.enabled !== false, // Default to true
+        };
+        this.guidelines.push(guidelineWithId);
+        return this;
+    }
+    /**
+     * Add a capability
+     */
+    createCapability(capability) {
+        const capabilityWithId = {
+            ...capability,
+            id: capability.id || `capability_${this.capabilities.length}`,
+        };
+        this.capabilities.push(capabilityWithId);
+        return this;
+    }
+    /**
+     * Create an observation for disambiguation
+     */
+    createObservation(description) {
+        const observation = new Observation({ description });
+        this.observations.push(observation);
+        return observation;
+    }
+    /**
+     * Add a domain with its tools/methods
+     */
+    addDomain(name, domainObject) {
+        this.domainRegistry.register(name, domainObject);
+        // Attach to the domain property for easy access
+        this.domain[name] = domainObject;
+    }
+    /**
+     * Generate a response based on history and context
+     */
+    async respond(params) {
+        const { history, contextOverride, signal } = params;
+        // Merge context
+        const effectiveContext = {
+            ...this.options.context,
+            ...contextOverride,
+        };
+        // Build prompt
+        const promptBuilder = new PromptBuilder();
+        // Add agent identity
+        if (this.options.description) {
+            promptBuilder.addAgentIdentity({
+                name: this.options.name,
+                description: this.options.description,
+            });
+        }
+        // Add interaction history
+        promptBuilder.addInteractionHistoryForMessageGeneration(history);
+        // Add glossary
+        if (this.terms.length > 0) {
+            promptBuilder.addGlossary(this.terms);
+        }
+        // Add guidelines (convert to GuidelineMatch format, filter enabled only)
+        const enabledGuidelines = this.guidelines.filter((g) => g.enabled !== false);
+        if (enabledGuidelines.length > 0) {
+            const guidelineMatches = enabledGuidelines.map((g) => ({
+                guideline: g,
+            }));
+            promptBuilder.addGuidelinesForMessageGeneration(guidelineMatches);
+        }
+        // Add capabilities
+        if (this.capabilities.length > 0) {
+            promptBuilder.addCapabilitiesForMessageGeneration(this.capabilities);
+        }
+        // Add observations
+        if (this.observations.length > 0) {
+            const observationsWithRoutes = this.observations
+                .map((obs) => ({
+                description: obs.description,
+                routes: obs.getRoutes().map((routeRef) => {
+                    const route = this.routes.find((r) => r.id === routeRef.id);
+                    return { title: route?.title || routeRef.id };
+                }),
+            }))
+                .filter((obs) => obs.routes.length > 0);
+            if (observationsWithRoutes.length > 0) {
+                promptBuilder.addObservations(observationsWithRoutes);
+            }
+        }
+        // Add active routes
+        if (this.routes.length > 0) {
+            promptBuilder.addActiveRoutes(this.routes.map((r) => ({
+                title: r.title,
+                description: r.description,
+                conditions: r.conditions,
+            })));
+        }
+        // Build final prompt
+        const prompt = promptBuilder.build();
+        // Generate message using AI provider
+        const result = await this.options.ai.generateMessage({
+            prompt,
+            history,
+            context: effectiveContext,
+            signal,
+        });
+        return {
+            message: result.message,
+        };
+    }
+    /**
+     * Get all routes
+     */
+    getRoutes() {
+        return [...this.routes];
+    }
+    /**
+     * Get all terms
+     */
+    getTerms() {
+        return [...this.terms];
+    }
+    /**
+     * Get all guidelines
+     */
+    getGuidelines() {
+        return [...this.guidelines];
+    }
+    /**
+     * Get all capabilities
+     */
+    getCapabilities() {
+        return [...this.capabilities];
+    }
+    /**
+     * Get all observations
+     */
+    getObservations() {
+        return [...this.observations];
+    }
+    /**
+     * Get the domain registry
+     */
+    getDomainRegistry() {
+        return this.domainRegistry;
+    }
+}
+//# sourceMappingURL=Agent.js.map

package/dist/core/Agent.js.map

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

package/dist/core/DomainRegistry.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Domain registry for organizing agent capabilities by domain
+ */
+/**
+ * Registry that holds domain-specific tools and methods
+ */
+export declare class DomainRegistry {
+    private domains;
+    /**
+     * Register a new domain with its methods/tools
+     */
+    register<TDomain extends Record<string, unknown>>(name: string, domain: TDomain): void;
+    /**
+     * Get a registered domain
+     */
+    get<TDomain extends Record<string, unknown>>(name: string): TDomain | undefined;
+    /**
+     * Check if a domain is registered
+     */
+    has(name: string): boolean;
+    /**
+     * Get all registered domains as a single object
+     */
+    all(): Record<string, Record<string, unknown>>;
+}
+//# sourceMappingURL=DomainRegistry.d.ts.map

package/dist/core/DomainRegistry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"DomainRegistry.d.ts","sourceRoot":"","sources":["../../src/core/DomainRegistry.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;GAEG;AACH,qBAAa,cAAc;IACzB,OAAO,CAAC,OAAO,CAAmD;IAElE;;OAEG;IACH,QAAQ,CAAC,OAAO,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC9C,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,OAAO,GACd,IAAI;IAOP;;OAEG;IACH,GAAG,CAAC,OAAO,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACzC,IAAI,EAAE,MAAM,GACX,OAAO,GAAG,SAAS;IAItB;;OAEG;IACH,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAI1B;;OAEG;IACH,GAAG,IAAI,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAO/C"}

package/dist/core/DomainRegistry.js

@@ -0,0 +1,41 @@
+/**
+ * Domain registry for organizing agent capabilities by domain
+ */
+/**
+ * Registry that holds domain-specific tools and methods
+ */
+export class DomainRegistry {
+    domains = new Map();
+    /**
+     * Register a new domain with its methods/tools
+     */
+    register(name, domain) {
+        if (this.domains.has(name)) {
+            throw new Error(`Domain "${name}" is already registered`);
+        }
+        this.domains.set(name, domain);
+    }
+    /**
+     * Get a registered domain
+     */
+    get(name) {
+        return this.domains.get(name);
+    }
+    /**
+     * Check if a domain is registered
+     */
+    has(name) {
+        return this.domains.has(name);
+    }
+    /**
+     * Get all registered domains as a single object
+     */
+    all() {
+        const result = {};
+        for (const [name, domain] of this.domains) {
+            result[name] = domain;
+        }
+        return result;
+    }
+}
+//# sourceMappingURL=DomainRegistry.js.map

package/dist/core/DomainRegistry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"DomainRegistry.js","sourceRoot":"","sources":["../../src/core/DomainRegistry.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;GAEG;AACH,MAAM,OAAO,cAAc;IACjB,OAAO,GAAyC,IAAI,GAAG,EAAE,CAAC;IAElE;;OAEG;IACH,QAAQ,CACN,IAAY,EACZ,MAAe;QAEf,IAAI,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;YAC3B,MAAM,IAAI,KAAK,CAAC,WAAW,IAAI,yBAAyB,CAAC,CAAC;QAC5D,CAAC;QACD,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;IACjC,CAAC;IAED;;OAEG;IACH,GAAG,CACD,IAAY;QAEZ,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAwB,CAAC;IACvD,CAAC;IAED;;OAEG;IACH,GAAG,CAAC,IAAY;QACd,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IAChC,CAAC;IAED;;OAEG;IACH,GAAG;QACD,MAAM,MAAM,GAA4C,EAAE,CAAC;QAC3D,KAAK,MAAM,CAAC,IAAI,EAAE,MAAM,CAAC,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;YAC1C,MAAM,CAAC,IAAI,CAAC,GAAG,MAAM,CAAC;QACxB,CAAC;QACD,OAAO,MAAM,CAAC;IAChB,CAAC;CACF"}

package/dist/core/Events.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Event utilities and helpers
+ */
+import type { Event, EmittedEvent, MessageEventData, ToolEventData, ToolCall } from "@/types/history";
+import { EventSource } from "@/types/history";
+/**
+ * Adapt an event for inclusion in prompts
+ * Transforms event data into a serializable format
+ */
+export declare function adaptEvent(e: Event | EmittedEvent): string;
+/**
+ * Create a message event
+ */
+export declare function createMessageEvent(source: EventSource, participantName: string, message: string): Event<MessageEventData>;
+/**
+ * Create a tool event
+ */
+export declare function createToolEvent(source: EventSource, toolCalls: ToolCall[]): Event<ToolEventData>;
+//# sourceMappingURL=Events.d.ts.map

package/dist/core/Events.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Events.d.ts","sourceRoot":"","sources":["../../src/core/Events.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EACV,KAAK,EACL,YAAY,EACZ,gBAAgB,EAChB,aAAa,EACb,QAAQ,EACT,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAAa,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAEzD;;;GAGG;AACH,wBAAgB,UAAU,CAAC,CAAC,EAAE,KAAK,GAAG,YAAY,GAAG,MAAM,CA+C1D;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAChC,MAAM,EAAE,WAAW,EACnB,eAAe,EAAE,MAAM,EACvB,OAAO,EAAE,MAAM,GACd,KAAK,CAAC,gBAAgB,CAAC,CAUzB;AAED;;GAEG;AACH,wBAAgB,eAAe,CAC7B,MAAM,EAAE,WAAW,EACnB,SAAS,EAAE,QAAQ,EAAE,GACpB,KAAK,CAAC,aAAa,CAAC,CAStB"}

package/dist/core/Events.js

@@ -0,0 +1,79 @@
+/**
+ * Event utilities and helpers
+ */
+import { EventKind, EventSource } from "@/types/history";
+/**
+ * Adapt an event for inclusion in prompts
+ * Transforms event data into a serializable format
+ */
+export function adaptEvent(e) {
+    let data = e.data;
+    if (e.kind === EventKind.MESSAGE) {
+        const messageData = e.data;
+        if (messageData.flagged) {
+            data = {
+                participant: messageData.participant.display_name,
+                message: "<N/A>",
+                censored: true,
+                reasons: messageData.tags,
+            };
+        }
+        else {
+            data = {
+                participant: messageData.participant.display_name,
+                message: messageData.message,
+            };
+        }
+    }
+    if (e.kind === EventKind.TOOL) {
+        const toolData = e.data;
+        data = {
+            tool_calls: toolData.tool_calls.map((tc) => ({
+                tool_id: tc.tool_id,
+                arguments: tc.arguments,
+                result: tc.result.data,
+            })),
+        };
+    }
+    const sourceMap = {
+        [EventSource.CUSTOMER]: "user",
+        [EventSource.CUSTOMER_UI]: "frontend_application",
+        [EventSource.HUMAN_AGENT]: "human_service_agent",
+        [EventSource.HUMAN_AGENT_ON_BEHALF_OF_AI_AGENT]: "ai_agent",
+        [EventSource.AI_AGENT]: "ai_agent",
+        [EventSource.SYSTEM]: "system-provided",
+    };
+    return JSON.stringify({
+        event_kind: e.kind,
+        event_source: sourceMap[e.source],
+        data,
+    });
+}
+/**
+ * Create a message event
+ */
+export function createMessageEvent(source, participantName, message) {
+    return {
+        kind: EventKind.MESSAGE,
+        source,
+        data: {
+            participant: { display_name: participantName },
+            message,
+        },
+        timestamp: new Date().toISOString(),
+    };
+}
+/**
+ * Create a tool event
+ */
+export function createToolEvent(source, toolCalls) {
+    return {
+        kind: EventKind.TOOL,
+        source,
+        data: {
+            tool_calls: toolCalls,
+        },
+        timestamp: new Date().toISOString(),
+    };
+}
+//# sourceMappingURL=Events.js.map

package/dist/core/Events.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Events.js","sourceRoot":"","sources":["../../src/core/Events.ts"],"names":[],"mappings":"AAAA;;GAEG;AASH,OAAO,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAEzD;;;GAGG;AACH,MAAM,UAAU,UAAU,CAAC,CAAuB;IAChD,IAAI,IAAI,GAAY,CAAC,CAAC,IAAI,CAAC;IAE3B,IAAI,CAAC,CAAC,IAAI,KAAK,SAAS,CAAC,OAAO,EAAE,CAAC;QACjC,MAAM,WAAW,GAAG,CAAC,CAAC,IAAwB,CAAC;QAE/C,IAAI,WAAW,CAAC,OAAO,EAAE,CAAC;YACxB,IAAI,GAAG;gBACL,WAAW,EAAE,WAAW,CAAC,WAAW,CAAC,YAAY;gBACjD,OAAO,EAAE,OAAO;gBAChB,QAAQ,EAAE,IAAI;gBACd,OAAO,EAAE,WAAW,CAAC,IAAI;aAC1B,CAAC;QACJ,CAAC;aAAM,CAAC;YACN,IAAI,GAAG;gBACL,WAAW,EAAE,WAAW,CAAC,WAAW,CAAC,YAAY;gBACjD,OAAO,EAAE,WAAW,CAAC,OAAO;aAC7B,CAAC;QACJ,CAAC;IACH,CAAC;IAED,IAAI,CAAC,CAAC,IAAI,KAAK,SAAS,CAAC,IAAI,EAAE,CAAC;QAC9B,MAAM,QAAQ,GAAG,CAAC,CAAC,IAAqB,CAAC;QAEzC,IAAI,GAAG;YACL,UAAU,EAAE,QAAQ,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC;gBAC3C,OAAO,EAAE,EAAE,CAAC,OAAO;gBACnB,SAAS,EAAE,EAAE,CAAC,SAAS;gBACvB,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,IAAI;aACvB,CAAC,CAAC;SACJ,CAAC;IACJ,CAAC;IAED,MAAM,SAAS,GAAgC;QAC7C,CAAC,WAAW,CAAC,QAAQ,CAAC,EAAE,MAAM;QAC9B,CAAC,WAAW,CAAC,WAAW,CAAC,EAAE,sBAAsB;QACjD,CAAC,WAAW,CAAC,WAAW,CAAC,EAAE,qBAAqB;QAChD,CAAC,WAAW,CAAC,iCAAiC,CAAC,EAAE,UAAU;QAC3D,CAAC,WAAW,CAAC,QAAQ,CAAC,EAAE,UAAU;QAClC,CAAC,WAAW,CAAC,MAAM,CAAC,EAAE,iBAAiB;KACxC,CAAC;IAEF,OAAO,IAAI,CAAC,SAAS,CAAC;QACpB,UAAU,EAAE,CAAC,CAAC,IAAI;QAClB,YAAY,EAAE,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC;QACjC,IAAI;KACL,CAAC,CAAC;AACL,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,kBAAkB,CAChC,MAAmB,EACnB,eAAuB,EACvB,OAAe;IAEf,OAAO;QACL,IAAI,EAAE,SAAS,CAAC,OAAO;QACvB,MAAM;QACN,IAAI,EAAE;YACJ,WAAW,EAAE,EAAE,YAAY,EAAE,eAAe,EAAE;YAC9C,OAAO;SACR;QACD,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;KACpC,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,eAAe,CAC7B,MAAmB,EACnB,SAAqB;IAErB,OAAO;QACL,IAAI,EAAE,SAAS,CAAC,IAAI;QACpB,MAAM;QACN,IAAI,EAAE;YACJ,UAAU,EAAE,SAAS;SACtB;QACD,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;KACpC,CAAC;AACJ,CAAC"}

package/dist/core/Observation.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Observation for route disambiguation
+ */
+import type { Observation as IObservation, ObservationOptions } from "@/types/observation";
+import type { RouteRef } from "@/types/route";
+import type { Route } from "@/core/Route";
+/**
+ * An observation that can trigger disambiguation between routes
+ */
+export declare class Observation implements IObservation {
+    readonly id: string;
+    readonly description: string;
+    routes: RouteRef[];
+    constructor(options: ObservationOptions);
+    /**
+     * Set routes that this observation can disambiguate between
+     */
+    disambiguate(routes: (Route | RouteRef)[]): this;
+    /**
+     * Get the routes this observation disambiguates
+     */
+    getRoutes(): RouteRef[];
+}
+//# sourceMappingURL=Observation.d.ts.map

package/dist/core/Observation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Observation.d.ts","sourceRoot":"","sources":["../../src/core/Observation.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EACV,WAAW,IAAI,YAAY,EAC3B,kBAAkB,EACnB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAC9C,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,cAAc,CAAC;AAI1C;;GAEG;AACH,qBAAa,WAAY,YAAW,YAAY;IAC9C,SAAgB,EAAE,EAAE,MAAM,CAAC;IAC3B,SAAgB,WAAW,EAAE,MAAM,CAAC;IAC7B,MAAM,EAAE,QAAQ,EAAE,CAAM;gBAEnB,OAAO,EAAE,kBAAkB;IAKvC;;OAEG;IACH,YAAY,CAAC,MAAM,EAAE,CAAC,KAAK,GAAG,QAAQ,CAAC,EAAE,GAAG,IAAI;IAUhD;;OAEG;IACH,SAAS,IAAI,QAAQ,EAAE;CAGxB"}

package/dist/core/Observation.js

@@ -0,0 +1,35 @@
+/**
+ * Observation for route disambiguation
+ */
+let observationIdCounter = 0;
+/**
+ * An observation that can trigger disambiguation between routes
+ */
+export class Observation {
+    id;
+    description;
+    routes = [];
+    constructor(options) {
+        this.id = `observation_${++observationIdCounter}`;
+        this.description = options.description;
+    }
+    /**
+     * Set routes that this observation can disambiguate between
+     */
+    disambiguate(routes) {
+        this.routes = routes.map((r) => {
+            if ("getRef" in r) {
+                return r.getRef();
+            }
+            return r;
+        });
+        return this;
+    }
+    /**
+     * Get the routes this observation disambiguates
+     */
+    getRoutes() {
+        return [...this.routes];
+    }
+}
+//# sourceMappingURL=Observation.js.map

package/dist/core/Observation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Observation.js","sourceRoot":"","sources":["../../src/core/Observation.ts"],"names":[],"mappings":"AAAA;;GAEG;AASH,IAAI,oBAAoB,GAAG,CAAC,CAAC;AAE7B;;GAEG;AACH,MAAM,OAAO,WAAW;IACN,EAAE,CAAS;IACX,WAAW,CAAS;IAC7B,MAAM,GAAe,EAAE,CAAC;IAE/B,YAAY,OAA2B;QACrC,IAAI,CAAC,EAAE,GAAG,eAAe,EAAE,oBAAoB,EAAE,CAAC;QAClD,IAAI,CAAC,WAAW,GAAG,OAAO,CAAC,WAAW,CAAC;IACzC,CAAC;IAED;;OAEG;IACH,YAAY,CAAC,MAA4B;QACvC,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE;YAC7B,IAAI,QAAQ,IAAI,CAAC,EAAE,CAAC;gBAClB,OAAO,CAAC,CAAC,MAAM,EAAE,CAAC;YACpB,CAAC;YACD,OAAO,CAAC,CAAC;QACX,CAAC,CAAC,CAAC;QACH,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;OAEG;IACH,SAAS;QACP,OAAO,CAAC,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC;IAC1B,CAAC;CACF"}

package/dist/core/PromptBuilder.d.ts

@@ -0,0 +1,121 @@
+/**
+ * Prompt construction and management
+ */
+import type { Event, EmittedEvent } from "@/types/history";
+import type { Term, Capability, GuidelineMatch } from "@/types/agent";
+import type { PromptSection, ContextVariableValue } from "@/types/prompt";
+import { SectionStatus } from "@/types/prompt";
+/**
+ * Built-in section identifiers
+ */
+export declare enum BuiltInSection {
+    AGENT_IDENTITY = "agent_identity",
+    CUSTOMER_IDENTITY = "customer_identity",
+    INTERACTION_HISTORY = "interaction_history",
+    CONTEXT_VARIABLES = "context_variables",
+    GLOSSARY = "glossary",
+    GUIDELINE_DESCRIPTIONS = "guideline_descriptions",
+    GUIDELINES = "guidelines",
+    STAGED_EVENTS = "staged_events",
+    ROUTES = "routes",
+    OBSERVATIONS = "observations",
+    CAPABILITIES = "capabilities",
+    ACTIVE_ROUTES = "active_routes"
+}
+/**
+ * Customer/user information
+ */
+export interface Customer {
+    name: string;
+    id?: string;
+}
+/**
+ * Agent information for prompt building
+ */
+export interface AgentInfo {
+    name: string;
+    description?: string;
+}
+/**
+ * Builds prompts from composable sections
+ */
+export declare class PromptBuilder {
+    private sections;
+    private onBuild?;
+    private cachedResults;
+    constructor(onBuild?: (prompt: string) => void);
+    /**
+     * Build the final prompt from all sections
+     */
+    build(): string;
+    /**
+     * Add a section to the prompt
+     */
+    addSection(name: string | BuiltInSection, template: string, props?: Record<string, unknown>, status?: SectionStatus): this;
+    /**
+     * Edit an existing section
+     */
+    editSection(name: string | BuiltInSection, editor: (section: PromptSection) => PromptSection): this;
+    /**
+     * Get section status
+     */
+    sectionStatus(name: string | BuiltInSection): SectionStatus;
+    /**
+     * Add agent identity section
+     */
+    addAgentIdentity(agent: AgentInfo): this;
+    /**
+     * Add customer identity section
+     */
+    addCustomerIdentity(customer: Customer): this;
+    /**
+     * Add interaction history section
+     */
+    addInteractionHistory(events: Event[], stagedEvents?: EmittedEvent[]): this;
+    /**
+     * Add interaction history with special handling for message generation
+     */
+    addInteractionHistoryForMessageGeneration(events: Event[], stagedEvents?: EmittedEvent[]): this;
+    /**
+     * Add context variables section
+     */
+    addContextVariables(variables: ContextVariableValue[]): this;
+    /**
+     * Add glossary section
+     */
+    addGlossary(terms: Term[]): this;
+    /**
+     * Add staged tool events section
+     */
+    addStagedToolEvents(events: EmittedEvent[]): this;
+    /**
+     * Add guidelines for message generation
+     */
+    addGuidelinesForMessageGeneration(guidelines: GuidelineMatch[]): this;
+    /**
+     * Add capabilities section for message generation
+     */
+    addCapabilitiesForMessageGeneration(capabilities: Capability[]): this;
+    /**
+     * Add observations for disambiguation
+     */
+    addObservations(observations: Array<{
+        description: string;
+        routes: Array<{
+            title: string;
+        }>;
+    }>): this;
+    /**
+     * Add active routes information
+     */
+    addActiveRoutes(routes: Array<{
+        title: string;
+        description?: string;
+        conditions: string[];
+    }>): this;
+    private formatTemplate;
+    private gatherInteractionEvents;
+    private lastAgentMessageNote;
+    private contextVariablesToJson;
+}
+//# sourceMappingURL=PromptBuilder.d.ts.map

package/dist/core/PromptBuilder.d.ts.map

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