@diegoaltoworks/talker 0.1.0

package/dist/plugin.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Talker Plugin
+ *
+ * Main entry point for integrating talker with chatter via the customRoutes hook.
+ * Creates telephony routes and mounts them on the Hono app.
+ *
+ * @example
+ * ```typescript
+ * import { createServer } from "@diegoaltoworks/chatter";
+ * import { createTelephonyRoutes } from "@diegoaltoworks/talker";
+ *
+ * const app = await createServer({
+ *   ...chatterConfig,
+ *   customRoutes: (app, deps) => {
+ *     createTelephonyRoutes(app, deps, {
+ *       twilio: { accountSid, authToken, phoneNumber },
+ *       transferNumber: "+44...",
+ *       flowsDir: "./config/flows",
+ *     });
+ *   },
+ * });
+ * ```
+ */
+import type { ServerDependencies } from "@diegoaltoworks/chatter";
+import type { Hono } from "hono";
+import type { TalkerConfig } from "./types";
+/**
+ * Create and mount telephony routes on a Hono app (chatter plugin mode)
+ */
+export declare function createTelephonyRoutes(app: Hono, chatterDeps: ServerDependencies, config: TalkerConfig): Promise<void>;
+//# sourceMappingURL=plugin.d.ts.map

package/dist/plugin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin.d.ts","sourceRoot":"","sources":["../src/plugin.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAEH,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAClE,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAQjC,OAAO,KAAK,EAAE,YAAY,EAAsB,MAAM,SAAS,CAAC;AAMhE;;GAEG;AACH,wBAAsB,qBAAqB,CACzC,GAAG,EAAE,IAAI,EACT,WAAW,EAAE,kBAAkB,EAC/B,MAAM,EAAE,YAAY,GACnB,OAAO,CAAC,IAAI,CAAC,CA2Cf"}

package/dist/routes/call/handle-answer.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Answer Handler
+ *
+ * Handles POST /call/answer — called after the acknowledgment redirect.
+ * Waits for the background processing to complete and returns the result.
+ */
+import type { Context } from "hono";
+import type { TalkerConfig } from "../../types";
+export declare function handleAnswer(c: Context, config: TalkerConfig): Promise<Response>;
+//# sourceMappingURL=handle-answer.d.ts.map

package/dist/routes/call/handle-answer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"handle-answer.d.ts","sourceRoot":"","sources":["../../../src/routes/call/handle-answer.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,MAAM,CAAC;AAKpC,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAGhD,wBAAsB,YAAY,CAAC,CAAC,EAAE,OAAO,EAAE,MAAM,EAAE,YAAY,GAAG,OAAO,CAAC,QAAQ,CAAC,CA+BtF"}

package/dist/routes/call/handle-initial.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Initial Call Handler
+ *
+ * Handles POST /call — the first webhook when a call arrives.
+ * Clears previous state, greets the caller, and starts listening for speech.
+ */
+import type { Context } from "hono";
+import type { TalkerConfig } from "../../types";
+export declare function handleInitialCall(c: Context, config: TalkerConfig): Promise<Response>;
+//# sourceMappingURL=handle-initial.d.ts.map

package/dist/routes/call/handle-initial.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"handle-initial.d.ts","sourceRoot":"","sources":["../../../src/routes/call/handle-initial.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,MAAM,CAAC;AAKpC,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAEhD,wBAAsB,iBAAiB,CAAC,CAAC,EAAE,OAAO,EAAE,MAAM,EAAE,YAAY,GAAG,OAAO,CAAC,QAAQ,CAAC,CAqB3F"}

package/dist/routes/call/handle-nospeech.d.ts

@@ -0,0 +1,10 @@
+/**
+ * No-Speech Handler
+ *
+ * Handles POST /call/no-speech — called when Twilio detects silence.
+ * Implements retry logic with configurable max retries.
+ */
+import type { Context } from "hono";
+import type { TalkerConfig } from "../../types";
+export declare function handleNoSpeech(c: Context, config: TalkerConfig): Promise<Response>;
+//# sourceMappingURL=handle-nospeech.d.ts.map

package/dist/routes/call/handle-nospeech.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"handle-nospeech.d.ts","sourceRoot":"","sources":["../../../src/routes/call/handle-nospeech.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,MAAM,CAAC;AAKpC,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAEhD,wBAAsB,cAAc,CAAC,CAAC,EAAE,OAAO,EAAE,MAAM,EAAE,YAAY,GAAG,OAAO,CAAC,QAAQ,CAAC,CA4BxF"}

package/dist/routes/call/handle-respond.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Speech Response Handler
+ *
+ * Handles POST /call/respond — called by Twilio when speech is detected.
+ * Supports both synchronous and async acknowledgment patterns.
+ */
+import type { Context } from "hono";
+import type { FlowRegistry } from "../../flows/registry";
+import type { TalkerDependencies } from "../../types";
+export declare function handleRespond(c: Context, deps: TalkerDependencies, registry: FlowRegistry): Promise<Response>;
+//# sourceMappingURL=handle-respond.d.ts.map

package/dist/routes/call/handle-respond.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"handle-respond.d.ts","sourceRoot":"","sources":["../../../src/routes/call/handle-respond.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,MAAM,CAAC;AAOpC,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AACzD,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AAItD,wBAAsB,aAAa,CACjC,CAAC,EAAE,OAAO,EACV,IAAI,EAAE,kBAAkB,EACxB,QAAQ,EAAE,YAAY,GACrB,OAAO,CAAC,QAAQ,CAAC,CAqEnB"}

package/dist/routes/call/handle-status.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Call Status Handler
+ *
+ * Handles POST /call/status — called by Twilio when call state changes.
+ * Persists the final session state, then cleans up conversation context.
+ */
+import type { Context } from "hono";
+export declare function handleStatus(c: Context): Promise<Response>;
+//# sourceMappingURL=handle-status.d.ts.map

package/dist/routes/call/handle-status.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"handle-status.d.ts","sourceRoot":"","sources":["../../../src/routes/call/handle-status.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,MAAM,CAAC;AAKpC,wBAAsB,YAAY,CAAC,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC,QAAQ,CAAC,CAehE"}

package/dist/routes/call/index.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Call Routes
+ *
+ * Hono route factory for voice call webhooks.
+ * Mounts individual handlers for each call lifecycle event.
+ */
+import { Hono } from "hono";
+import type { FlowRegistry } from "../../flows/registry";
+import type { TalkerDependencies } from "../../types";
+/**
+ * Create call routes
+ */
+export declare function callRoutes(deps: TalkerDependencies, registry: FlowRegistry): Hono<import("hono/types").BlankEnv, import("hono/types").BlankSchema, "/">;
+//# sourceMappingURL=index.d.ts.map

package/dist/routes/call/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/routes/call/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAC5B,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AACzD,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AAOtD;;GAEG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,kBAAkB,EAAE,QAAQ,EAAE,YAAY,8EAU1E"}

package/dist/routes/call/pending.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Pending Queries
+ *
+ * Manages async query state for the "one moment please" acknowledgment pattern.
+ * When a query is processing in the background, the pending promise is stored
+ * here and resolved when processing completes.
+ */
+export interface PendingQuery {
+    speechResult: string;
+    promise: Promise<{
+        twiml: string;
+    }>;
+    resolve: (value: {
+        twiml: string;
+    }) => void;
+}
+export declare function setPending(phoneNumber: string, query: PendingQuery): void;
+export declare function getPending(phoneNumber: string): PendingQuery | undefined;
+export declare function deletePending(phoneNumber: string): void;
+//# sourceMappingURL=pending.d.ts.map

package/dist/routes/call/pending.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pending.d.ts","sourceRoot":"","sources":["../../../src/routes/call/pending.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,MAAM,WAAW,YAAY;IAC3B,YAAY,EAAE,MAAM,CAAC;IACrB,OAAO,EAAE,OAAO,CAAC;QAAE,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACpC,OAAO,EAAE,CAAC,KAAK,EAAE;QAAE,KAAK,EAAE,MAAM,CAAA;KAAE,KAAK,IAAI,CAAC;CAC7C;AAID,wBAAgB,UAAU,CAAC,WAAW,EAAE,MAAM,EAAE,KAAK,EAAE,YAAY,GAAG,IAAI,CAEzE;AAED,wBAAgB,UAAU,CAAC,WAAW,EAAE,MAAM,GAAG,YAAY,GAAG,SAAS,CAExE;AAED,wBAAgB,aAAa,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI,CAEvD"}

package/dist/routes/call/processor.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Call Processor
+ *
+ * End-to-end processing pipeline for a single voice call interaction:
+ * incoming pre-processing -> flow check -> chatbot -> outgoing post-processing -> TwiML
+ */
+import type { FlowRegistry } from "../../flows/registry";
+import type { TalkerDependencies } from "../../types";
+/**
+ * Process a call interaction and generate TwiML response
+ */
+export declare function processCall(deps: TalkerDependencies, registry: FlowRegistry, phoneNumber: string, speechResult: string): Promise<string>;
+//# sourceMappingURL=processor.d.ts.map

package/dist/routes/call/processor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"processor.d.ts","sourceRoot":"","sources":["../../../src/routes/call/processor.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAWH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AACzD,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AAEtD;;GAEG;AACH,wBAAsB,WAAW,CAC/B,IAAI,EAAE,kBAAkB,EACxB,QAAQ,EAAE,YAAY,EACtB,WAAW,EAAE,MAAM,EACnB,YAAY,EAAE,MAAM,GACnB,OAAO,CAAC,MAAM,CAAC,CA6DjB"}

package/dist/routes/sms/handle-incoming.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Incoming SMS Handler
+ *
+ * Handles POST /sms — called by Twilio when an SMS arrives.
+ */
+import type { Context } from "hono";
+import type { FlowRegistry } from "../../flows/registry";
+import type { TalkerDependencies } from "../../types";
+export declare function handleIncomingSMS(c: Context, deps: TalkerDependencies, registry: FlowRegistry): Promise<Response>;
+//# sourceMappingURL=handle-incoming.d.ts.map

package/dist/routes/sms/handle-incoming.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"handle-incoming.d.ts","sourceRoot":"","sources":["../../../src/routes/sms/handle-incoming.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,MAAM,CAAC;AAMpC,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AACzD,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AAGtD,wBAAsB,iBAAiB,CACrC,CAAC,EAAE,OAAO,EACV,IAAI,EAAE,kBAAkB,EACxB,QAAQ,EAAE,YAAY,GACrB,OAAO,CAAC,QAAQ,CAAC,CA0BnB"}

package/dist/routes/sms/index.d.ts

@@ -0,0 +1,13 @@
+/**
+ * SMS Routes
+ *
+ * Hono route factory for SMS webhooks.
+ */
+import { Hono } from "hono";
+import type { FlowRegistry } from "../../flows/registry";
+import type { TalkerDependencies } from "../../types";
+/**
+ * Create SMS routes
+ */
+export declare function smsRoutes(deps: TalkerDependencies, registry: FlowRegistry): Hono<import("hono/types").BlankEnv, import("hono/types").BlankSchema, "/">;
+//# sourceMappingURL=index.d.ts.map

package/dist/routes/sms/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/routes/sms/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAC5B,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AACzD,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AAGtD;;GAEG;AACH,wBAAgB,SAAS,CAAC,IAAI,EAAE,kBAAkB,EAAE,QAAQ,EAAE,YAAY,8EAOzE"}

package/dist/routes/sms/processor.d.ts

@@ -0,0 +1,12 @@
+/**
+ * SMS Processor
+ *
+ * End-to-end processing pipeline for a single SMS interaction.
+ */
+import type { FlowRegistry } from "../../flows/registry";
+import type { TalkerDependencies } from "../../types";
+/**
+ * Process an SMS interaction and generate TwiML response
+ */
+export declare function processSms(deps: TalkerDependencies, registry: FlowRegistry, phoneNumber: string, messageBody: string): Promise<string>;
+//# sourceMappingURL=processor.d.ts.map

package/dist/routes/sms/processor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"processor.d.ts","sourceRoot":"","sources":["../../../src/routes/sms/processor.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAOH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AACzD,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AAEtD;;GAEG;AACH,wBAAsB,UAAU,CAC9B,IAAI,EAAE,kBAAkB,EACxB,QAAQ,EAAE,YAAY,EACtB,WAAW,EAAE,MAAM,EACnB,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC,MAAM,CAAC,CAmCjB"}

package/dist/standalone.d.ts

@@ -0,0 +1,44 @@
+/**
+ * Standalone Server
+ *
+ * Creates a self-contained Hono server with telephony routes.
+ * Use this when running talker WITHOUT chatter — you provide your own
+ * chatFn to handle the actual chatbot logic.
+ *
+ * @example
+ * ```typescript
+ * import { createStandaloneServer } from "@diegoaltoworks/talker";
+ *
+ * const app = await createStandaloneServer({
+ *   openaiApiKey: process.env.OPENAI_API_KEY!,
+ *   twilio: {
+ *     accountSid: process.env.TWILIO_ACCOUNT_SID,
+ *     authToken: process.env.TWILIO_AUTH_TOKEN,
+ *     phoneNumber: process.env.TWILIO_PHONE_NUMBER,
+ *   },
+ *   transferNumber: "+441234567890",
+ *   chatFn: async (phoneNumber, message) => {
+ *     // Your chatbot logic here
+ *     return "I received your message: " + message;
+ *   },
+ * });
+ *
+ * Bun.serve({ port: 3000, fetch: app.fetch });
+ * ```
+ */
+import { Hono } from "hono";
+import type { TalkerConfig } from "./types";
+export interface StandaloneConfig extends TalkerConfig {
+    /** OpenAI API key (required in standalone mode) */
+    openaiApiKey: string;
+    /** Enable CORS. Default: true */
+    cors?: boolean;
+}
+/**
+ * Create a standalone Hono server with telephony routes.
+ *
+ * This does NOT require chatter. Provide a `chatFn` to handle chatbot logic,
+ * or leave it undefined for a telephony-only server (flows + transfer only).
+ */
+export declare function createStandaloneServer(config: StandaloneConfig): Promise<Hono<import("hono/types").BlankEnv, import("hono/types").BlankSchema, "/">>;
+//# sourceMappingURL=standalone.d.ts.map

package/dist/standalone.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"standalone.d.ts","sourceRoot":"","sources":["../src/standalone.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AAGH,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAQ5B,OAAO,KAAK,EAAE,YAAY,EAAsB,MAAM,SAAS,CAAC;AAMhE,MAAM,WAAW,gBAAiB,SAAQ,YAAY;IACpD,mDAAmD;IACnD,YAAY,EAAE,MAAM,CAAC;IACrB,iCAAiC;IACjC,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AAED;;;;;GAKG;AACH,wBAAsB,sBAAsB,CAAC,MAAM,EAAE,gBAAgB,uFA0DpE"}

package/dist/types.d.ts

@@ -0,0 +1,240 @@
+/**
+ * Talker Type Definitions
+ *
+ * Core types for the Talker telephony plugin.
+ * These types define the public API and configuration interface.
+ */
+import type { ServerDependencies } from "@diegoaltoworks/chatter";
+/**
+ * Channel type for telephony interactions
+ */
+export type Channel = "call" | "sms";
+/**
+ * Voice configuration for text-to-speech
+ */
+export interface VoiceConfig {
+    /** TTS voice identifier (e.g., "Polly.Brian") */
+    voice: string;
+    /** BCP-47 language tag (e.g., "en-GB") */
+    language: string;
+}
+/**
+ * Twilio adapter configuration
+ */
+export interface TwilioConfig {
+    /** Twilio account SID */
+    accountSid?: string;
+    /** Twilio auth token */
+    authToken?: string;
+    /** Twilio phone number for outbound SMS */
+    phoneNumber?: string;
+}
+/**
+ * Remote chatbot API configuration (standalone mode)
+ *
+ * When running without chatter, talker calls a remote chatbot API over HTTP.
+ * This matches chatter's /api/public/chat endpoint format.
+ */
+export interface ChatbotConfig {
+    /** Chatbot API URL (e.g., "https://bot.example.com/api/public/chat") */
+    url: string;
+    /** API key for the chatbot (sent as x-api-key header) */
+    apiKey?: string;
+    /** System message prepended to conversation. Overrides the default */
+    systemMessage?: string;
+}
+/**
+ * Processing pipeline configuration
+ */
+export interface ProcessingConfig {
+    /** OpenAI model for pre/post-processing. Default: gpt-4o-mini */
+    model?: string;
+    /** Path to incoming message system prompt */
+    incomingPromptPath?: string;
+    /** Path to outgoing message system prompt */
+    outgoingPromptPath?: string;
+}
+/**
+ * Feature flags for telephony behavior
+ */
+export interface TelephonyFeatureFlags {
+    /** Enable "one moment please" async acknowledgment pattern. Default: false */
+    thinkingAcknowledgmentEnabled?: boolean;
+}
+/**
+ * Main configuration for Talker telephony plugin
+ */
+export interface TalkerConfig {
+    /** Twilio credentials and phone number */
+    twilio?: TwilioConfig;
+    /** Phone number to transfer calls to when human handoff is requested */
+    transferNumber?: string;
+    /** Voice configuration per language code. Keys are ISO 639-1 codes (e.g., "en", "fr") */
+    voices?: Record<string, VoiceConfig>;
+    /** Directory containing flow definitions. Each flow is a subdirectory with flow.json, handler.ts, instructions.md */
+    flowsDir?: string;
+    /** Directory containing language phrase files (en.json, fr.json, etc.) */
+    languageDir?: string;
+    /** Processing pipeline configuration */
+    processing?: ProcessingConfig;
+    /** Feature flags */
+    features?: TelephonyFeatureFlags;
+    /** Remote chatbot API (standalone mode). Not needed in plugin mode — chatter's RAG is used directly */
+    chatbot?: ChatbotConfig;
+    /** Database config for session persistence. In plugin mode, falls back to chatter's database config */
+    database?: {
+        /** Turso/libSQL database URL */
+        url: string;
+        /** Turso auth token */
+        authToken: string;
+    };
+    /** OpenAI API key for the pre/post-processing pipeline. Falls back to chatter's OpenAI client */
+    openaiApiKey?: string;
+    /** Route prefix for telephony endpoints. Default: "" (mounts at /call and /sms) */
+    routePrefix?: string;
+    /** Conversation context TTL in milliseconds. Default: 1800000 (30 minutes) */
+    contextTtlMs?: number;
+    /** Context cleanup interval in milliseconds. Default: 300000 (5 minutes) */
+    cleanupIntervalMs?: number;
+    /** Maximum no-speech retries before ending call. Default: 3 */
+    maxNoSpeechRetries?: number;
+    /** Chat function override. By default, talker queries chatter's RAG pipeline directly */
+    chatFn?: (phoneNumber: string, message: string) => Promise<string>;
+}
+/**
+ * Dependencies available to talker routes and handlers
+ */
+export interface TalkerDependencies {
+    /** Chatter server dependencies (OpenAI client, VectorStore, PromptLoader, config) */
+    chatter: ServerDependencies;
+    /** Talker-specific configuration */
+    config: TalkerConfig;
+    /** Resolved OpenAI API key for the processing pipeline */
+    openaiApiKey: string;
+    /** Resolved OpenAI model for the processing pipeline */
+    openaiModel: string;
+}
+/**
+ * Result from the incoming message pre-processor
+ */
+export interface IncomingResult {
+    /** Whether the caller should be transferred to a human */
+    shouldTransfer: boolean;
+    /** Whether the caller wants to end the conversation */
+    shouldEndCall: boolean;
+    /** Detected language code (ISO 639-1) */
+    detectedLanguage: string;
+    /** Cleaned and processed message */
+    processedMessage: string;
+}
+/**
+ * Flow-related types
+ */
+export interface FlowSchemaProperty {
+    type: "string" | "number" | "boolean";
+    description?: string;
+}
+export interface FlowSchema {
+    type: "object";
+    properties: Record<string, FlowSchemaProperty>;
+    required: string[];
+}
+export interface FlowDefinition {
+    id: string;
+    name: string;
+    description: string;
+    triggerKeywords: string[];
+    schema: FlowSchema;
+}
+export interface FlowState {
+    flowName: string;
+    params: Record<string, unknown>;
+    attempts: number;
+    startedAt: number;
+}
+export interface FlowHandlerResult {
+    success: boolean;
+    result?: unknown;
+    /** What to say via voice/call */
+    say: string;
+    /** Optional: different content for SMS */
+    sms?: string;
+}
+export interface FlowHandlerContext {
+    phoneNumber: string;
+    channel: Channel;
+}
+export type FlowHandler = (params: Record<string, unknown>, context: FlowHandlerContext) => Promise<FlowHandlerResult>;
+export type FlowPrefill = (phoneNumber: string, context: Record<string, unknown>) => Record<string, unknown>;
+export interface FlowExtractionResult {
+    extractedParams: Record<string, unknown>;
+    allParamsFilled: boolean;
+    nextPrompt?: string;
+}
+export interface IntentDetection {
+    intent: string;
+    confidence: number;
+    reasoning?: string;
+}
+export interface LoadedFlow {
+    definition: FlowDefinition;
+    handler: FlowHandler;
+    instructionsPath: string;
+    prefill?: FlowPrefill;
+}
+export interface FlowResult {
+    isFlowActive: boolean;
+    response: string;
+    flowCompleted: boolean;
+    smsContent?: string;
+    flowSuccess?: boolean;
+}
+/**
+ * Conversation context stored per phone number
+ */
+export interface TelephonyContext {
+    phoneNumber: string;
+    channel: Channel;
+    detectedLanguage: string | null;
+    messageHistory: Array<{
+        role: "user" | "assistant";
+        content: string;
+        timestamp: number;
+    }>;
+    activeFlow: FlowState | null;
+    noSpeechRetries: number;
+    lastPrompt: string | null;
+    createdAt: number;
+    lastActivity: number;
+}
+/**
+ * Phrase file structure for each language
+ */
+export interface Phrases {
+    greeting: string;
+    didNotCatch: string;
+    didNotHear: string;
+    didNotHearRetry: string;
+    didNotHearFinal: string;
+    transfer: string;
+    acknowledgment: string;
+    farewell: {
+        morning: string;
+        afternoon: string;
+        evening: string;
+    };
+    error: string;
+    timeout: string;
+    lostQuestion: string;
+    flow: {
+        cancelled: string;
+    };
+    sms: {
+        greeting: string;
+        greetingShort: string;
+        callForHelp: string;
+        processingError: string;
+        genericError: string;
+    };
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

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

package/language/de.json

@@ -0,0 +1,27 @@
+{
+  "greeting": "Hallo! Ich bin Ihr Sprachassistent. Wie kann ich Ihnen heute helfen?",
+  "didNotCatch": "Das habe ich nicht verstanden. Koennten Sie das bitte wiederholen?",
+  "didNotHear": "Ich habe nichts gehoert. Auf Wiedersehen.",
+  "didNotHearRetry": "Entschuldigung, ich habe das nicht verstanden. Koennten Sie es noch einmal versuchen?",
+  "didNotHearFinal": "Es tut mir wirklich leid, aber ich kann nicht hoeren, was Sie sagen. Bitte rufen Sie erneut an. Bis bald.",
+  "transfer": "Kein Problem, ich verbinde Sie jetzt.",
+  "acknowledgment": "Einen Moment bitte.",
+  "farewell": {
+    "morning": "Gern geschehen! Einen schoenen Tag noch. Auf Wiedersehen!",
+    "afternoon": "Gern geschehen! Einen schoenen Nachmittag noch. Auf Wiedersehen!",
+    "evening": "Gern geschehen! Einen schoenen Abend noch. Auf Wiedersehen!"
+  },
+  "error": "Entschuldigung, es ist ein Fehler aufgetreten. Bitte versuchen Sie es spaeter erneut. Auf Wiedersehen.",
+  "timeout": "Entschuldigung, ich habe zu lange gebraucht. Bitte versuchen Sie es erneut. Auf Wiedersehen.",
+  "lostQuestion": "Es tut mir leid, ich habe Ihre Frage verloren. Koennten Sie das wiederholen?",
+  "flow": {
+    "cancelled": "Kein Problem! Ich habe das abgebrochen. Wie kann ich helfen?"
+  },
+  "sms": {
+    "greeting": "Hallo! Ich bin Ihr Sprachassistent. Wie kann ich Ihnen helfen?",
+    "greetingShort": "Hallo! Senden Sie mir Ihre Frage!",
+    "callForHelp": "Fuer komplexe Fragen rufen Sie uns direkt an.",
+    "processingError": "Ich habe Schwierigkeiten, das zu verarbeiten. Bitte versuchen Sie es erneut oder rufen Sie uns an.",
+    "genericError": "Entschuldigung, etwas ist schief gelaufen. Bitte versuchen Sie es erneut."
+  }
+}

package/language/en.json

@@ -0,0 +1,27 @@
+{
+  "greeting": "Hello! I'm your voice assistant. How can I help you today?",
+  "didNotCatch": "I didn't catch that. Could you please repeat?",
+  "didNotHear": "I didn't hear anything. Goodbye.",
+  "didNotHearRetry": "Sorry, I didn't catch that. Could you try again?",
+  "didNotHearFinal": "I'm really sorry but I cannot hear what you're saying. Please call again. Bye for now.",
+  "transfer": "Let me connect you with someone directly.",
+  "acknowledgment": "One moment please...",
+  "farewell": {
+    "morning": "You're welcome! Have a wonderful day. Goodbye!",
+    "afternoon": "You're welcome! Have a lovely afternoon. Goodbye!",
+    "evening": "You're welcome! Have a good evening. Goodbye!"
+  },
+  "error": "Sorry, I encountered an error. Please try again later. Goodbye.",
+  "timeout": "Sorry, I took too long to respond. Please try again. Goodbye.",
+  "lostQuestion": "I'm sorry, I lost track of your question. Could you please repeat?",
+  "flow": {
+    "cancelled": "No problem! I've cancelled that. What else would you like to know?"
+  },
+  "sms": {
+    "greeting": "Hi! I'm your voice assistant. Ask me anything!",
+    "greetingShort": "Hi! Ask me anything!",
+    "callForHelp": "For more complex questions, feel free to call back or reach us directly.",
+    "processingError": "I'm having trouble processing that. Please try texting again or call back.",
+    "genericError": "Sorry, something went wrong. Please try again."
+  }
+}

package/language/es.json

@@ -0,0 +1,27 @@
+{
+  "greeting": "Hola! Soy su asistente de voz. Como puedo ayudarle hoy?",
+  "didNotCatch": "No entendi eso. Podria repetirlo, por favor?",
+  "didNotHear": "No escuche nada. Adios!",
+  "didNotHearRetry": "Lo siento, no entendi eso. Podria intentarlo de nuevo?",
+  "didNotHearFinal": "Lo siento mucho pero no puedo escuchar lo que dice. Por favor, llame de nuevo. Hasta pronto.",
+  "transfer": "No hay problema, le transfiero ahora.",
+  "acknowledgment": "Un momento, por favor.",
+  "farewell": {
+    "morning": "De nada! Que tenga un buen dia. Adios!",
+    "afternoon": "De nada! Que tenga una buena tarde. Adios!",
+    "evening": "De nada! Que tenga una buena noche. Adios!"
+  },
+  "error": "Lo siento, encontre un error. Por favor, intentelo mas tarde. Adios!",
+  "timeout": "Lo siento, tarde demasiado en responder. Por favor, intentelo de nuevo. Adios!",
+  "lostQuestion": "Lo siento, perdi el hilo de su pregunta. Podria repetir?",
+  "flow": {
+    "cancelled": "No hay problema! He cancelado eso. En que mas puedo ayudar?"
+  },
+  "sms": {
+    "greeting": "Hola! Soy su asistente de voz. Como puedo ayudarle?",
+    "greetingShort": "Hola! Enviame su pregunta!",
+    "callForHelp": "Para consultas complejas, llamenos directamente.",
+    "processingError": "Tengo problemas para procesar eso. Por favor intentelo de nuevo o llamenos.",
+    "genericError": "Lo siento, algo salio mal. Por favor intente de nuevo."
+  }
+}

package/language/fr.json

@@ -0,0 +1,27 @@
+{
+  "greeting": "Bonjour! Je suis votre assistant vocal. Comment puis-je vous aider aujourd'hui?",
+  "didNotCatch": "Je n'ai pas compris. Pourriez-vous repeter, s'il vous plait?",
+  "didNotHear": "Je n'ai rien entendu. Au revoir.",
+  "didNotHearRetry": "Desolee, je n'ai pas compris. Pourriez-vous reessayer?",
+  "didNotHearFinal": "Je suis vraiment desolee mais je n'arrive pas a entendre ce que vous dites. Veuillez rappeler. A bientot.",
+  "transfer": "Pas de probleme, je vous transfiere.",
+  "acknowledgment": "Un instant, s'il vous plait.",
+  "farewell": {
+    "morning": "Je vous en prie! Passez une excellente journee. Au revoir!",
+    "afternoon": "Je vous en prie! Passez un bon apres-midi. Au revoir!",
+    "evening": "Je vous en prie! Passez une bonne soiree. Au revoir!"
+  },
+  "error": "Desole, j'ai rencontre une erreur. Veuillez reessayer plus tard. Au revoir.",
+  "timeout": "Desole, j'ai mis trop de temps a repondre. Veuillez reessayer. Au revoir.",
+  "lostQuestion": "Je suis desole, j'ai perdu le fil de votre question. Pourriez-vous repeter?",
+  "flow": {
+    "cancelled": "Pas de probleme! J'ai annule ca. Comment puis-je vous aider?"
+  },
+  "sms": {
+    "greeting": "Bonjour! Je suis votre assistant vocal. Comment puis-je vous aider?",
+    "greetingShort": "Bonjour! Envoyez-moi votre question!",
+    "callForHelp": "Pour des questions complexes, appelez-nous directement.",
+    "processingError": "J'ai du mal a traiter cela. Veuillez reessayer ou nous appeler.",
+    "genericError": "Desole, quelque chose s'est mal passe. Veuillez reessayer."
+  }
+}