@diegoaltoworks/talker 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2024 Diego Alto
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,299 @@
+# Talker
+
+<div align="center">
+
+**Telephony plugin for Chatter — voice call and SMS support via Twilio**
+
+[![NPM Version](https://img.shields.io/npm/v/@diegoaltoworks/talker)](https://www.npmjs.com/package/@diegoaltoworks/talker)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+
+[Features](#features) • [Quick Start](#quick-start) • [Examples](#examples) • [Configuration](#configuration) • [Customization](#customization)
+
+</div>
+
+## Features
+
+- **Voice Calls**: Twilio webhook handlers with speech-to-text, text-to-speech, and continuous conversation loops
+- **SMS**: Inbound/outbound messaging with channel-appropriate formatting
+- **Pre/Post-Processing**: OpenAI-powered language detection, STT artifact cleanup, phone-friendly response formatting, and automatic translation
+- **Structured Flows**: LLM intent detection + parameter extraction for guided multi-step conversations
+- **Human Handoff**: Automatic transfer to a real person on request or frustration signals
+- **Multi-Language**: English, French, German, Dutch, Spanish, Portuguese out of the box
+- **Two Modes**: Plugin for [Chatter](https://github.com/diegoaltoworks/chatter), or standalone with any chatbot backend
+- **TypeScript**: Fully typed for excellent developer experience
+
+## Quick Start
+
+```bash
+# With chatter (plugin mode)
+bun add @diegoaltoworks/talker
+
+# Standalone (no chatter required)
+bun add @diegoaltoworks/talker hono
+```
+
+**As a Chatter plugin** — one server, one port, web chat + phone + SMS:
+
+```typescript
+import { createServer } from '@diegoaltoworks/chatter';
+import { createTelephonyRoutes } from '@diegoaltoworks/talker';
+
+const app = await createServer({
+  bot: { name: 'MyBot', personName: 'Your Name' },
+  openai: { apiKey: process.env.OPENAI_API_KEY },
+  database: { url: process.env.TURSO_URL, authToken: process.env.TURSO_AUTH_TOKEN },
+  customRoutes: async (app, deps) => {
+    await createTelephonyRoutes(app, deps, {
+      twilio: {
+        accountSid: process.env.TWILIO_ACCOUNT_SID,
+        authToken: process.env.TWILIO_AUTH_TOKEN,
+        phoneNumber: process.env.TWILIO_PHONE_NUMBER,
+      },
+      transferNumber: '+441234567890',
+    });
+  },
+});
+
+Bun.serve({ port: 8181, fetch: app.fetch });
+```
+
+**As a standalone server** — point at a remote chatbot API:
+
+```typescript
+import { createStandaloneServer } from '@diegoaltoworks/talker';
+
+const app = await createStandaloneServer({
+  openaiApiKey: process.env.OPENAI_CHATGPT_KEY || '',
+  chatbot: {
+    url: process.env.CHATBOT_URL || 'http://localhost:8181/api/public/chat',
+    apiKey: process.env.CHATBOT_API_KEY,
+  },
+  transferNumber: '+441234567890',
+});
+
+Bun.serve({ port: 3000, fetch: app.fetch });
+```
+
+**Requirements:** OpenAI API key, Bun runtime. Twilio account for production use.
+
+## Examples
+
+**[Complete Examples](./examples/)** — Ready-to-run examples for all use cases:
+
+- **[Chatter Plugin](./examples/chatter-plugin.ts)** — Single server with web chat + phone + SMS
+- **[Standalone Server](./examples/standalone.ts)** — Phone/SMS with your own chatbot backend
+- **[Custom Flows](./examples/custom-flows.ts)** — Structured conversations with parameter collection
+
+## Configuration
+
+```typescript
+interface TalkerConfig {
+  // Remote chatbot API (standalone mode — not needed in plugin mode)
+  chatbot?: {
+    url: string;               // e.g., "https://bot.example.com/api/public/chat"
+    apiKey?: string;           // Sent as x-api-key header
+    systemMessage?: string;    // Override default system prompt
+  };
+
+  // Twilio credentials (optional — only needed for outbound SMS)
+  twilio?: {
+    accountSid?: string;
+    authToken?: string;
+    phoneNumber?: string;
+  };
+
+  // Phone number for human handoff
+  transferNumber?: string;
+
+  // Voice config per language (defaults: Polly voices for 6 languages)
+  voices?: Record<string, { voice: string; language: string }>;
+
+  // Structured flow definitions directory
+  flowsDir?: string;
+
+  // Custom language phrase files directory
+  languageDir?: string;
+
+  // Processing pipeline (pre/post-processing with OpenAI)
+  processing?: {
+    model?: string;              // Default: "gpt-4o-mini"
+    incomingPromptPath?: string; // Custom incoming message prompt
+    outgoingPromptPath?: string; // Custom outgoing response prompt
+  };
+
+  // Feature flags
+  features?: {
+    thinkingAcknowledgmentEnabled?: boolean; // "One moment please" pattern
+  };
+
+  // Override OpenAI key (falls back to chatter's key in plugin mode)
+  openaiApiKey?: string;
+
+  // Route prefix for all endpoints. Default: ""
+  routePrefix?: string;
+
+  // Conversation TTL. Default: 30 minutes
+  contextTtlMs?: number;
+
+  // Max silence retries before ending call. Default: 3
+  maxNoSpeechRetries?: number;
+
+  // Custom chat function (overrides chatbot config and chatter RAG)
+  chatFn?: (phoneNumber: string, message: string) => Promise<string>;
+}
+```
+
+## Twilio Setup
+
+1. Get a Twilio phone number
+2. Set webhook URLs in the Twilio console:
+
+| Webhook | URL | Method |
+|---|---|---|
+| Voice | `https://your-server.com/call` | HTTP POST |
+| SMS | `https://your-server.com/sms` | HTTP POST |
+| Status Callback | `https://your-server.com/call/status` | HTTP POST |
+
+## Customization
+
+### Custom Flows
+
+Flows are structured conversations with automatic parameter collection. Each flow is a directory with three files:
+
+```
+config/flows/addNumbers/
+  flow.json         — Definition (id, keywords, parameter schema)
+  handler.ts        — Exports an execute() function
+  instructions.md   — System prompt for parameter extraction
+```
+
+**flow.json:**
+```json
+{
+  "id": "addNumbers",
+  "name": "Add Two Numbers",
+  "description": "Adds two numbers together",
+  "triggerKeywords": ["add", "sum", "plus"],
+  "schema": {
+    "type": "object",
+    "properties": {
+      "firstNumber": { "type": "number", "description": "First number" },
+      "secondNumber": { "type": "number", "description": "Second number" }
+    },
+    "required": ["firstNumber", "secondNumber"]
+  }
+}
+```
+
+**handler.ts:**
+```typescript
+import type { FlowHandlerResult, FlowHandlerContext } from '@diegoaltoworks/talker';
+
+export async function execute(
+  params: Record<string, unknown>,
+  context: FlowHandlerContext,
+): Promise<FlowHandlerResult> {
+  const sum = Number(params.firstNumber) + Number(params.secondNumber);
+  return {
+    success: true,
+    result: sum,
+    say: `${params.firstNumber} plus ${params.secondNumber} equals ${sum}. Need anything else?`,
+    sms: `${params.firstNumber} + ${params.secondNumber} = ${sum}`,
+  };
+}
+```
+
+See [examples/custom-flows.ts](./examples/custom-flows.ts) for a complete walkthrough.
+
+### Custom Language Files
+
+Override built-in phrases by providing a `languageDir`. Place JSON files named by language code (`en.json`, `fr.json`, etc.):
+
+```typescript
+createTelephonyRoutes(app, deps, {
+  languageDir: './config/language',
+});
+```
+
+See [language/en.json](./language/en.json) for the expected structure.
+
+### Custom Prompts
+
+Override the pre/post-processing system prompts:
+
+```typescript
+createTelephonyRoutes(app, deps, {
+  processing: {
+    incomingPromptPath: './config/prompts/telephony-incoming.md',
+    outgoingPromptPath: './config/prompts/telephony-outgoing.md',
+  },
+});
+```
+
+See [prompts/incoming.md](./prompts/incoming.md) and [prompts/outgoing.md](./prompts/outgoing.md) for the default prompts.
+
+### Custom Voices
+
+Override the default Polly TTS voices per language:
+
+```typescript
+createTelephonyRoutes(app, deps, {
+  voices: {
+    en: { voice: 'Polly.Amy', language: 'en-US' },
+    fr: { voice: 'Polly.Lea', language: 'fr-FR' },
+  },
+});
+```
+
+## Architecture
+
+```
+Phone Call / SMS
+      |
+      v
+  Twilio (ASR / TTS / SMS gateway)
+      |
+      v  POST /call or /sms
+  Talker (Hono routes)
+      |-- processIncoming  (OpenAI: language detect, transfer intent, STT cleanup)
+      |-- Flow Engine      (LLM intent detect + parameter extraction)
+      |-- chatFn / Chatter RAG pipeline
+      |-- processOutgoing  (OpenAI: channel formatting, translation)
+      |
+      v  TwiML response
+  Twilio (speaks / sends to caller)
+```
+
+**Call lifecycle:** Twilio posts to `/call` on ring, `/call/respond` on speech, `/call/no-speech` on silence, `/call/answer` after async acknowledgment, and `/call/status` on hangup.
+
+## Project Structure
+
+| Directory | What lives there |
+|---|---|
+| `src/core/processing/` | OpenAI-powered incoming pre-processor and outgoing post-processor |
+| `src/core/chatbot/` | HTTP client for remote chatbot APIs (standalone mode) |
+| `src/core/` | Context store, TwiML generation, voice config, phrases, logger |
+| `src/flows/` | Flow engine — registry, intent detection, parameter extraction, lifecycle |
+| `src/routes/call/` | Individual Hono handlers for each Twilio voice webhook |
+| `src/routes/sms/` | Hono handlers for SMS webhooks |
+| `src/adapters/` | Twilio REST API client (outbound SMS) |
+| `examples/` | Ready-to-run examples for plugin, standalone, and custom flows |
+| `language/` | Built-in phrase files (en, fr, de, nl, es, pt) |
+| `prompts/` | Default system prompts for the processing pipeline |
+
+## Development
+
+```bash
+bun install
+bun test                # Run all tests (66 tests)
+bun run test:unit       # Unit tests only
+bun run test:integration # Integration tests (some require OPENAI_API_KEY)
+bun run typecheck       # Type checking
+bun run lint            # Biome linting
+bun run check           # All checks (typecheck + lint + test)
+bun run build           # Build for npm (dual ESM/CJS)
+```
+
+## License
+
+MIT

package/dist/adapters/twilio.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Twilio Adapter
+ *
+ * Handles outbound SMS sending via Twilio's REST API.
+ * TwiML generation is handled by src/core/twiml.ts.
+ */
+import type { TwilioConfig } from "../types";
+/**
+ * Send an SMS via Twilio REST API
+ */
+export declare function sendSMS(config: TwilioConfig, to: string, message: string): Promise<boolean>;
+//# sourceMappingURL=twilio.d.ts.map

package/dist/adapters/twilio.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"twilio.d.ts","sourceRoot":"","sources":["../../src/adapters/twilio.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AAE7C;;GAEG;AACH,wBAAsB,OAAO,CAAC,MAAM,EAAE,YAAY,EAAE,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAyCjG"}

package/dist/core/chat.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Chat Function
+ *
+ * Resolves a chat response using the first available method:
+ * 1. chatFn (custom function override)
+ * 2. chatbot config (remote HTTP API — standalone mode)
+ * 3. chatter RAG pipeline (plugin mode)
+ */
+import type { TalkerDependencies } from "../types";
+/**
+ * Get a chat response
+ */
+export declare function chat(deps: TalkerDependencies, phoneNumber: string, message: string): Promise<string>;
+//# sourceMappingURL=chat.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"chat.d.ts","sourceRoot":"","sources":["../../src/core/chat.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,UAAU,CAAC;AAKnD;;GAEG;AACH,wBAAsB,IAAI,CACxB,IAAI,EAAE,kBAAkB,EACxB,WAAW,EAAE,MAAM,EACnB,OAAO,EAAE,MAAM,GACd,OAAO,CAAC,MAAM,CAAC,CAmCjB"}

package/dist/core/chatbot/client.d.ts

@@ -0,0 +1,12 @@
+/**
+ * HTTP Chatbot Client
+ *
+ * Calls a remote chatbot API (e.g., chatter's /api/public/chat) over HTTP.
+ * Maintains multi-turn conversation history per phone number.
+ */
+import type { ChatbotConfig } from "../../types";
+/**
+ * Send a message to the remote chatbot API and get a response
+ */
+export declare function chatViaHTTP(config: ChatbotConfig, phoneNumber: string, message: string): Promise<string>;
+//# sourceMappingURL=client.d.ts.map

package/dist/core/chatbot/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../../src/core/chatbot/client.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AASjD;;GAEG;AACH,wBAAsB,WAAW,CAC/B,MAAM,EAAE,aAAa,EACrB,WAAW,EAAE,MAAM,EACnB,OAAO,EAAE,MAAM,GACd,OAAO,CAAC,MAAM,CAAC,CA8DjB"}

package/dist/core/chatbot/conversations.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Chatbot Conversation Store
+ *
+ * Tracks multi-turn conversation history per phone number for the HTTP chatbot client.
+ * Only used in standalone mode (plugin mode uses chatter's own conversation handling).
+ */
+import type { ChatConversation } from "./types";
+export declare function getOrCreateConversation(phoneNumber: string, systemMessage?: string): ChatConversation;
+export declare function addUserMessage(phoneNumber: string, content: string, systemMessage?: string): void;
+export declare function addBotMessage(phoneNumber: string, content: string, systemMessage?: string): void;
+export declare function getConversation(phoneNumber: string): ChatConversation | undefined;
+export declare function clearConversation(phoneNumber: string): void;
+export declare function clearAllConversations(): void;
+//# sourceMappingURL=conversations.d.ts.map

package/dist/core/chatbot/conversations.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"conversations.d.ts","sourceRoot":"","sources":["../../../src/core/chatbot/conversations.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,KAAK,EAAE,gBAAgB,EAAe,MAAM,SAAS,CAAC;AAI7D,wBAAgB,uBAAuB,CACrC,WAAW,EAAE,MAAM,EACnB,aAAa,CAAC,EAAE,MAAM,GACrB,gBAAgB,CAoBlB;AAED,wBAAgB,cAAc,CAAC,WAAW,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,aAAa,CAAC,EAAE,MAAM,GAAG,IAAI,CAIjG;AAED,wBAAgB,aAAa,CAAC,WAAW,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,aAAa,CAAC,EAAE,MAAM,GAAG,IAAI,CAIhG;AAED,wBAAgB,eAAe,CAAC,WAAW,EAAE,MAAM,GAAG,gBAAgB,GAAG,SAAS,CAEjF;AAED,wBAAgB,iBAAiB,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI,CAE3D;AAED,wBAAgB,qBAAqB,IAAI,IAAI,CAE5C"}

package/dist/core/chatbot/index.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Chatbot Client
+ *
+ * Re-exports for the HTTP chatbot client module.
+ */
+export { chatViaHTTP } from "./client";
+export { clearAllConversations, clearConversation, getConversation, getOrCreateConversation, } from "./conversations";
+export type { ChatConversation, ChatMessage, ChatbotRequest, ChatbotResponse } from "./types";
+//# sourceMappingURL=index.d.ts.map

package/dist/core/chatbot/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/core/chatbot/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AACvC,OAAO,EACL,qBAAqB,EACrB,iBAAiB,EACjB,eAAe,EACf,uBAAuB,GACxB,MAAM,iBAAiB,CAAC;AACzB,YAAY,EAAE,gBAAgB,EAAE,WAAW,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC"}

package/dist/core/chatbot/types.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Chatbot Client Types
+ *
+ * Matches chatter's /api/public/chat request/response format.
+ */
+export interface ChatMessage {
+    role: "user" | "assistant" | "system";
+    content: string;
+}
+export interface ChatbotRequest {
+    /** Single message (simple mode) */
+    message?: string;
+    /** Full conversation history (multi-turn mode) */
+    messages?: ChatMessage[];
+}
+export interface ChatbotResponse {
+    reply: string;
+}
+export interface ChatConversation {
+    conversationId: string;
+    chatHistory: ChatMessage[];
+    createdAt: number;
+    lastActivityAt: number;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/core/chatbot/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/core/chatbot/types.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,GAAG,WAAW,GAAG,QAAQ,CAAC;IACtC,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,cAAc;IAC7B,mCAAmC;IACnC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,kDAAkD;IAClD,QAAQ,CAAC,EAAE,WAAW,EAAE,CAAC;CAC1B;AAED,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,gBAAgB;IAC/B,cAAc,EAAE,MAAM,CAAC;IACvB,WAAW,EAAE,WAAW,EAAE,CAAC;IAC3B,SAAS,EAAE,MAAM,CAAC;IAClB,cAAc,EAAE,MAAM,CAAC;CACxB"}

package/dist/core/context.d.ts

@@ -0,0 +1,61 @@
+/**
+ * Conversation Context Store
+ *
+ * In-memory Map-based context management for telephony sessions.
+ * Stores per-phone-number state: language, message history, active flow, retry counts.
+ */
+import type { Channel, FlowState, TelephonyContext } from "../types";
+/**
+ * Start periodic cleanup of stale contexts
+ */
+export declare function startCleanup(ttlMs: number, intervalMs: number): void;
+/**
+ * Stop periodic cleanup (for testing / shutdown)
+ */
+export declare function stopCleanup(): void;
+/**
+ * Get or create a context for a phone number
+ */
+export declare function getOrCreateContext(phoneNumber: string, channel?: Channel): TelephonyContext;
+/**
+ * Get context without creating one
+ */
+export declare function getContext(phoneNumber: string): TelephonyContext | undefined;
+/**
+ * Set detected language (first detection wins)
+ */
+export declare function setDetectedLanguage(phoneNumber: string, language: string): void;
+/**
+ * Get detected language for a phone number
+ */
+export declare function getDetectedLanguage(phoneNumber: string): string | null;
+/**
+ * Add a message to conversation history
+ */
+export declare function addMessage(phoneNumber: string, role: "user" | "assistant", content: string, channel?: Channel): void;
+/**
+ * Get message history for a phone number
+ */
+export declare function getMessageHistory(phoneNumber: string): Array<{
+    role: "user" | "assistant";
+    content: string;
+    timestamp: number;
+}>;
+/**
+ * Clear all context for a phone number
+ */
+export declare function clearContext(phoneNumber: string): void;
+export declare function setActiveFlow(phoneNumber: string, flowName: string, params?: Record<string, unknown>): void;
+export declare function getActiveFlow(phoneNumber: string): FlowState | null;
+export declare function updateFlowParams(phoneNumber: string, params: Record<string, unknown>): void;
+export declare function clearActiveFlow(phoneNumber: string): void;
+export declare function incrementNoSpeechRetries(phoneNumber: string): number;
+export declare function getNoSpeechRetries(phoneNumber: string): number;
+export declare function resetNoSpeechRetries(phoneNumber: string): void;
+export declare function setLastPrompt(phoneNumber: string, prompt: string): void;
+export declare function getLastPrompt(phoneNumber: string): string | null;
+/**
+ * Clear all contexts (for testing)
+ */
+export declare function clearAllContexts(): void;
+//# sourceMappingURL=context.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../../src/core/context.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,SAAS,EAAE,gBAAgB,EAAE,MAAM,UAAU,CAAC;AAOrE;;GAEG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,IAAI,CAWpE;AAED;;GAEG;AACH,wBAAgB,WAAW,IAAI,IAAI,CAKlC;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAChC,WAAW,EAAE,MAAM,EACnB,OAAO,GAAE,OAAgB,GACxB,gBAAgB,CAqBlB;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,WAAW,EAAE,MAAM,GAAG,gBAAgB,GAAG,SAAS,CAE5E;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,WAAW,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,IAAI,CAM/E;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAEtE;AAED;;GAEG;AACH,wBAAgB,UAAU,CACxB,WAAW,EAAE,MAAM,EACnB,IAAI,EAAE,MAAM,GAAG,WAAW,EAC1B,OAAO,EAAE,MAAM,EACf,OAAO,GAAE,OAAgB,GACxB,IAAI,CAON;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAC/B,WAAW,EAAE,MAAM,GAClB,KAAK,CAAC;IAAE,IAAI,EAAE,MAAM,GAAG,WAAW,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,CAAC,CAE3E;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI,CAGtD;AAID,wBAAgB,aAAa,CAC3B,WAAW,EAAE,MAAM,EACnB,QAAQ,EAAE,MAAM,EAChB,MAAM,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM,GACnC,IAAI,CAWN;AAED,wBAAgB,aAAa,CAAC,WAAW,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,CAEnE;AAED,wBAAgB,gBAAgB,CAAC,WAAW,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAM3F;AAED,wBAAgB,eAAe,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI,CAMzD;AAID,wBAAgB,wBAAwB,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CAMpE;AAED,wBAAgB,kBAAkB,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CAE9D;AAED,wBAAgB,oBAAoB,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI,CAK9D;AAED,wBAAgB,aAAa,CAAC,WAAW,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI,CAGvE;AAED,wBAAgB,aAAa,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAEhE;AAED;;GAEG;AACH,wBAAgB,gBAAgB,IAAI,IAAI,CAEvC"}

package/dist/core/context.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=context.test.d.ts.map

package/dist/core/context.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.test.d.ts","sourceRoot":"","sources":["../../src/core/context.test.ts"],"names":[],"mappings":""}

package/dist/core/errors.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Error handling utilities
+ */
+/**
+ * Extract error message from unknown error type
+ */
+export declare function getErrorMessage(error: unknown): string;
+//# sourceMappingURL=errors.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/core/errors.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;GAEG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAQtD"}

package/dist/core/errors.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=errors.test.d.ts.map

package/dist/core/errors.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.test.d.ts","sourceRoot":"","sources":["../../src/core/errors.test.ts"],"names":[],"mappings":""}

package/dist/core/logger.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Structured JSON logger
+ *
+ * Silent during tests unless DEBUG=true.
+ */
+export declare const logger: {
+    info: (message: string, data?: Record<string, unknown>) => void;
+    warn: (message: string, data?: Record<string, unknown>) => void;
+    error: (message: string, data?: Record<string, unknown>) => void;
+};
+//# sourceMappingURL=logger.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../../src/core/logger.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAuBH,eAAO,MAAM,MAAM;oBACD,MAAM,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;oBACtC,MAAM,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;qBACrC,MAAM,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;CACxD,CAAC"}

package/dist/core/phrases.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Multi-language phrase system
+ *
+ * Loads phrase files from a configurable directory.
+ * Falls back to built-in English phrases if language files are not found.
+ */
+import type { Phrases } from "../types";
+/**
+ * Load phrases for a language from a directory
+ */
+export declare function loadPhrases(language: string, languageDir?: string): Phrases;
+type SimplePhraseKey = "greeting" | "didNotCatch" | "didNotHear" | "didNotHearRetry" | "didNotHearFinal" | "transfer" | "acknowledgment" | "error" | "timeout" | "lostQuestion";
+/**
+ * Get a simple phrase by key
+ */
+export declare function getPhrase(language: string, key: SimplePhraseKey, languageDir?: string): string;
+/**
+ * Get a time-of-day farewell phrase
+ */
+export declare function getFarewellPhrase(language: string, languageDir?: string): string;
+/**
+ * Get a flow-related phrase
+ */
+export declare function getFlowPhrase(language: string, key: keyof Phrases["flow"], languageDir?: string): string;
+/**
+ * Get an SMS-specific phrase
+ */
+export declare function getSmsPhrase(language: string, key: keyof Phrases["sms"], languageDir?: string): string;
+export {};
+//# sourceMappingURL=phrases.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"phrases.d.ts","sourceRoot":"","sources":["../../src/core/phrases.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,UAAU,CAAC;AAIxC;;GAEG;AACH,wBAAgB,WAAW,CAAC,QAAQ,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,MAAM,GAAG,OAAO,CA4B3E;AAED,KAAK,eAAe,GAChB,UAAU,GACV,aAAa,GACb,YAAY,GACZ,iBAAiB,GACjB,iBAAiB,GACjB,UAAU,GACV,gBAAgB,GAChB,OAAO,GACP,SAAS,GACT,cAAc,CAAC;AAEnB;;GAEG;AACH,wBAAgB,SAAS,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,EAAE,eAAe,EAAE,WAAW,CAAC,EAAE,MAAM,GAAG,MAAM,CAG9F;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,MAAM,GAAG,MAAM,CAWhF;AAED;;GAEG;AACH,wBAAgB,aAAa,CAC3B,QAAQ,EAAE,MAAM,EAChB,GAAG,EAAE,MAAM,OAAO,CAAC,MAAM,CAAC,EAC1B,WAAW,CAAC,EAAE,MAAM,GACnB,MAAM,CAGR;AAED;;GAEG;AACH,wBAAgB,YAAY,CAC1B,QAAQ,EAAE,MAAM,EAChB,GAAG,EAAE,MAAM,OAAO,CAAC,KAAK,CAAC,EACzB,WAAW,CAAC,EAAE,MAAM,GACnB,MAAM,CAGR"}

package/dist/core/phrases.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=phrases.test.d.ts.map

package/dist/core/phrases.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"phrases.test.d.ts","sourceRoot":"","sources":["../../src/core/phrases.test.ts"],"names":[],"mappings":""}

package/dist/core/processing/incoming.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Incoming Message Processor
+ *
+ * Pre-processes incoming messages: language detection, transfer intent,
+ * end-call detection, and STT artifact cleanup.
+ */
+import type { Channel, IncomingResult, TalkerDependencies } from "../../types";
+/**
+ * Pre-process an incoming message
+ */
+export declare function processIncoming(deps: TalkerDependencies, phoneNumber: string, userMessage: string, channel?: Channel): Promise<IncomingResult>;
+//# sourceMappingURL=incoming.d.ts.map

package/dist/core/processing/incoming.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"incoming.d.ts","sourceRoot":"","sources":["../../../src/core/processing/incoming.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,cAAc,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AAa/E;;GAEG;AACH,wBAAsB,eAAe,CACnC,IAAI,EAAE,kBAAkB,EACxB,WAAW,EAAE,MAAM,EACnB,WAAW,EAAE,MAAM,EACnB,OAAO,GAAE,OAAgB,GACxB,OAAO,CAAC,cAAc,CAAC,CAqEzB"}

package/dist/core/processing/index.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Processing Pipeline
+ *
+ * Re-exports the incoming and outgoing processors.
+ */
+export { processIncoming } from "./incoming";
+export { processOutgoing } from "./outgoing";
+export { callOpenAI } from "./openai";
+export { resetPromptCache } from "./prompts";
+//# sourceMappingURL=index.d.ts.map

package/dist/core/processing/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/core/processing/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAC7C,OAAO,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAC7C,OAAO,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AACtC,OAAO,EAAE,gBAAgB,EAAE,MAAM,WAAW,CAAC"}

package/dist/core/processing/openai.d.ts

@@ -0,0 +1,15 @@
+/**
+ * OpenAI API Client
+ *
+ * Low-level fetch wrapper for the talker processing pipeline.
+ * Uses fetch directly (no SDK) to keep dependencies minimal.
+ */
+import type { TalkerDependencies } from "../../types";
+/**
+ * Call OpenAI chat completions API
+ */
+export declare function callOpenAI(deps: TalkerDependencies, systemPrompt: string, userMessage: string, context: {
+    phoneNumber: string;
+    stage: "incoming" | "outgoing";
+}): Promise<string>;
+//# sourceMappingURL=openai.d.ts.map

package/dist/core/processing/openai.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"openai.d.ts","sourceRoot":"","sources":["../../../src/core/processing/openai.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AAKtD;;GAEG;AACH,wBAAsB,UAAU,CAC9B,IAAI,EAAE,kBAAkB,EACxB,YAAY,EAAE,MAAM,EACpB,WAAW,EAAE,MAAM,EACnB,OAAO,EAAE;IAAE,WAAW,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,UAAU,GAAG,UAAU,CAAA;CAAE,GAC/D,OAAO,CAAC,MAAM,CAAC,CAoDjB"}