@diegoaltoworks/talker 0.1.0

package/language/nl.json

@@ -0,0 +1,27 @@
+{
+  "greeting": "Hallo! Ik ben uw spraakassistent. Hoe kan ik u helpen vandaag?",
+  "didNotCatch": "Ik heb dat niet verstaan. Kunt u het herhalen?",
+  "didNotHear": "Ik heb niets gehoord. Tot ziens.",
+  "didNotHearRetry": "Sorry, ik heb dat niet verstaan. Kunt u het nog een keer proberen?",
+  "didNotHearFinal": "Het spijt me echt maar ik kan niet horen wat u zegt. Bel alstublieft opnieuw. Tot snel.",
+  "transfer": "Geen probleem, ik verbind u door.",
+  "acknowledgment": "Een moment alstublieft.",
+  "farewell": {
+    "morning": "Graag gedaan! Fijne dag nog. Tot ziens!",
+    "afternoon": "Graag gedaan! Fijne middag nog. Tot ziens!",
+    "evening": "Graag gedaan! Fijne avond nog. Tot ziens!"
+  },
+  "error": "Sorry, er is een fout opgetreden. Probeer het later opnieuw. Tot ziens.",
+  "timeout": "Sorry, ik deed er te lang over om te antwoorden. Probeer het opnieuw. Tot ziens.",
+  "lostQuestion": "Sorry, ik ben uw vraag kwijt. Kunt u het herhalen?",
+  "flow": {
+    "cancelled": "Geen probleem! Ik heb dat geannuleerd. Waarmee kan ik je helpen?"
+  },
+  "sms": {
+    "greeting": "Hallo! Ik ben uw spraakassistent. Hoe kan ik u helpen?",
+    "greetingShort": "Hallo! Stuur me uw vraag!",
+    "callForHelp": "Voor complexe vragen, bel ons direct.",
+    "processingError": "Ik heb moeite om dat te verwerken. Probeer het opnieuw of bel ons.",
+    "genericError": "Sorry, er ging iets mis. Probeer het opnieuw."
+  }
+}

package/language/pt.json

@@ -0,0 +1,27 @@
+{
+  "greeting": "Ola! Sou seu assistente de voz. Como posso ajuda-lo hoje?",
+  "didNotCatch": "Nao entendi isso. Voce poderia repetir, por favor?",
+  "didNotHear": "Nao ouvi nada. Tchau!",
+  "didNotHearRetry": "Desculpe, nao entendi isso. Voce poderia tentar novamente?",
+  "didNotHearFinal": "Sinto muito mas nao consigo ouvir o que voce esta dizendo. Por favor, ligue novamente. Ate logo.",
+  "transfer": "Sem problema, vou transferi-lo agora.",
+  "acknowledgment": "Um momento, por favor.",
+  "farewell": {
+    "morning": "De nada! Tenha um otimo dia. Tchau!",
+    "afternoon": "De nada! Tenha uma otima tarde. Tchau!",
+    "evening": "De nada! Tenha uma otima noite. Tchau!"
+  },
+  "error": "Desculpe, encontrei um erro. Por favor, tente novamente mais tarde. Tchau!",
+  "timeout": "Desculpe, demorei muito para responder. Por favor, tente novamente. Tchau!",
+  "lostQuestion": "Desculpe, perdi o fio da sua pergunta. Voce poderia repetir?",
+  "flow": {
+    "cancelled": "Sem problema! Cancelei isso. Como posso ajudar?"
+  },
+  "sms": {
+    "greeting": "Ola! Sou seu assistente de voz. Como posso ajuda-lo?",
+    "greetingShort": "Ola! Envie-me sua pergunta!",
+    "callForHelp": "Para questoes complexas, ligue diretamente.",
+    "processingError": "Estou tendo dificuldades para processar isso. Por favor, tente novamente ou nos ligue.",
+    "genericError": "Desculpe, algo deu errado. Por favor, tente novamente."
+  }
+}

package/package.json

@@ -0,0 +1,103 @@
+{
+  "name": "@diegoaltoworks/talker",
+  "version": "0.1.0",
+  "description": "Telephony plugin for Chatter — adds voice call and SMS support via Twilio",
+  "main": "./dist/index.js",
+  "module": "./dist/index.mjs",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.mjs",
+      "require": "./dist/index.js"
+    },
+    "./twilio": {
+      "types": "./dist/adapters/twilio.d.ts",
+      "import": "./dist/adapters/twilio.mjs",
+      "require": "./dist/adapters/twilio.js"
+    }
+  },
+  "files": ["dist", "prompts", "language", "README.md", "LICENSE"],
+  "scripts": {
+    "dev": "bun --watch src/index.ts",
+    "build": "bun run build:clean && bun run build:types && bun run build:esm && bun run build:cjs",
+    "build:clean": "rm -rf dist",
+    "build:types": "tsc --emitDeclarationOnly --outDir dist",
+    "build:esm": "esbuild src/index.ts --bundle --format=esm --outfile=dist/index.mjs --external:hono --external:openai --external:@diegoaltoworks/chatter --external:@libsql/client --platform=node --target=node18",
+    "build:cjs": "esbuild src/index.ts --bundle --format=cjs --outfile=dist/index.js --external:hono --external:openai --external:@diegoaltoworks/chatter --external:@libsql/client --platform=node --target=node18",
+    "test": "bun test",
+    "test:unit": "bun test src/**/*.test.ts",
+    "test:integration": "bun test test/integration/**/*.test.ts",
+    "test:watch": "bun test --watch",
+    "test:coverage": "bun test --coverage",
+    "typecheck": "tsc --noEmit",
+    "lint": "biome check .",
+    "lint:fix": "biome check --write .",
+    "format": "biome format --write .",
+    "security:audit": "bun audit",
+    "security:audit:fix": "bun update",
+    "security:check": "bun audit --audit-level=moderate",
+    "check": "bun run typecheck && bun run lint && bun run test && bun run security:check",
+    "prepublishOnly": "bun run lint && bun run typecheck && bun run test && bun run security:check && bun run build",
+    "prepare": "husky || true"
+  },
+  "keywords": [
+    "telephony",
+    "twilio",
+    "voice",
+    "sms",
+    "chatbot",
+    "chatter",
+    "twiml",
+    "conversational-ai",
+    "ivr",
+    "phone"
+  ],
+  "author": "Diego Alto <diego@diegoalto.works>",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/diegoaltoworks/talker.git"
+  },
+  "bugs": {
+    "url": "https://github.com/diegoaltoworks/talker/issues"
+  },
+  "homepage": "https://github.com/diegoaltoworks/talker#readme",
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "peerDependencies": {
+    "@diegoaltoworks/chatter": "^0.1.0",
+    "@libsql/client": "^0.6.0 || ^0.7.0 || ^0.8.0 || ^0.9.0 || ^0.10.0",
+    "hono": "^4.0.0 || ^5.0.0",
+    "openai": "^4.0.0"
+  },
+  "peerDependenciesMeta": {
+    "@diegoaltoworks/chatter": {
+      "optional": true
+    },
+    "@libsql/client": {
+      "optional": true
+    },
+    "openai": {
+      "optional": true
+    }
+  },
+  "devDependencies": {
+    "@biomejs/biome": "^1.9.4",
+    "@diegoaltoworks/chatter": "^0.1.8",
+    "@libsql/client": "^0.14.0",
+    "@types/bun": "^1.1.12",
+    "@types/node": "^22.9.1",
+    "esbuild": "^0.27.4",
+    "hono": "^4.6.14",
+    "husky": "^9.1.7",
+    "lint-staged": "^16.2.6",
+    "openai": "^4.77.0",
+    "typescript": "^5.6.3"
+  },
+  "lint-staged": {
+    "*.{ts,js,json,md}": ["biome check --write --no-errors-on-unmatched"],
+    "*.ts": ["bash -c 'tsc --noEmit --skipLibCheck'"]
+  }
+}

package/prompts/incoming.md

@@ -0,0 +1,88 @@
+# Incoming Message Processor
+
+You are a pre-processor for a voice assistant. Your job is to analyze incoming caller speech and determine three things:
+
+1. Should the caller be transferred to a human directly?
+2. What language is the caller speaking?
+3. What is the cleaned-up version of their message to send to the knowledge base?
+
+## IMPORTANT: Conversation Context
+
+You may receive conversation history along with the current message. **You MUST consider the context** when making decisions.
+
+For example:
+- If the assistant asked "Does that help?" and the caller says "yes" -> Do NOT transfer (just confirming)
+- If the assistant asked a question and the caller says "no" -> Do NOT transfer and do NOT end call (they might have more questions)
+- If the caller wants to speak to a person directly -> Transfer
+
+## Language Detection
+
+**CRITICAL**: Detect the language the caller is speaking. Once a language is detected, all future responses should be in that language.
+
+Supported languages:
+- "en" - English (default)
+- "fr" - French
+- "nl" - Dutch
+- "de" - German
+- "es" - Spanish
+- "pt" - Brazilian Portuguese
+
+If the caller speaks in French, Dutch, German, Spanish, or Portuguese, detect this and return the appropriate language code. If unsure or if English, return "en".
+
+## Transfer Detection
+
+The caller should be transferred if they express ANY of the following (in any language):
+
+**Direct requests:**
+- "speak to someone", "talk to a person", "connect me", "real person", "human"
+
+**Frustration signals:**
+- "this isn't working", "this is useless", "I give up"
+
+**Complex or personal matters:**
+- Private or sensitive topics
+- Questions the assistant clearly cannot answer
+- Requests for personal interaction
+
+## End Call Detection
+
+The caller wants to end the call if they say things like (in any language):
+- "no thanks", "that's all", "goodbye", "bye", "I'm done", "nothing else", "that's everything"
+
+**IMPORTANT:** Only set `shouldEndCall: true` if the caller is clearly ending the conversation. If they say "no" in response to a specific question but might have more questions, do NOT end the call.
+
+## Response Format
+
+You MUST respond with valid JSON in exactly this format:
+```json
+{
+  "shouldTransfer": true or false,
+  "shouldEndCall": true or false,
+  "detectedLanguage": "en" or "fr" or "nl" or "de" or "es" or "pt",
+  "processedMessage": "the cleaned up message"
+}
+```
+
+## Message Cleaning Rules
+
+When cleaning the message:
+- Fix obvious speech-to-text errors
+- Remove filler words like "um", "uh", "like", "you know"
+- Keep the core intent intact
+- Keep the message in its ORIGINAL language (do not translate)
+- Do not add information that wasn't there
+- If the message is unclear, keep it as-is
+
+## Examples
+
+Input: "um can I uh speak to a real person please"
+Output: {"shouldTransfer": true, "shouldEndCall": false, "detectedLanguage": "en", "processedMessage": "speak to a real person"}
+
+Input: "what projects have you worked on"
+Output: {"shouldTransfer": false, "shouldEndCall": false, "detectedLanguage": "en", "processedMessage": "what projects have you worked on"}
+
+Input: "Bonjour, quels sont vos projets?"
+Output: {"shouldTransfer": false, "shouldEndCall": false, "detectedLanguage": "fr", "processedMessage": "quels sont vos projets"}
+
+Input: "No thanks, that's all I needed"
+Output: {"shouldTransfer": false, "shouldEndCall": true, "detectedLanguage": "en", "processedMessage": "that's all I needed"}

package/prompts/outgoing.md

@@ -0,0 +1,58 @@
+# Outgoing Response Processor
+
+You are a post-processor for a voice assistant. Your job is to transform knowledge base responses into **channel-appropriate messages**.
+
+## Channel Type
+
+You will be told the channel: either "call" (phone) or "sms" (text message).
+
+**For CALL (phone):**
+- Response will be SPOKEN aloud by text-to-speech
+- Convert numbers/times to spoken words
+- Remove URLs entirely (say "on our website")
+- Maximum 2 sentences
+
+**For SMS (text message):**
+- Response will be READ on a phone screen
+- Keep numbers as digits
+- Can include SHORT URLs if helpful
+- Maximum 160 characters ideal (1 SMS segment)
+- No markdown formatting
+
+## Language Requirement
+
+**CRITICAL**: You will be told which language to respond in. You MUST translate and respond in that language.
+
+- If told "Respond in: fr" -> respond entirely in French
+- If told "Respond in: nl" -> respond entirely in Dutch
+- If told "Respond in: de" -> respond entirely in German
+- If told "Respond in: es" -> respond entirely in Spanish
+- If told "Respond in: pt" -> respond entirely in Brazilian Portuguese
+- If told "Respond in: en" -> respond in English (default)
+
+## CRITICAL: Keep It Brief
+
+1. **Be concise** - Answer the question directly without elaboration
+2. **End with a follow-up** - "Anything else you'd like to know?"
+3. **Preserve existing follow-ups** - If the message already ends with a question, keep it!
+4. **CRITICAL: Always use third person** - Say "they", "the company", etc. as appropriate
+
+## What to REMOVE (both channels)
+
+- **Markdown** -> Remove all **, *, [], (), #, etc.
+- **Lists** -> Summarize into one key point
+- **Technical jargon** -> Keep it simple
+
+## Channel-Specific Conversions
+
+### For CALL (spoken):
+- Numbers -> spoken words (e.g., "78 pounds", "ten thirty")
+- URLs -> "on our website"
+
+### For SMS (written):
+- Numbers -> keep as digits
+- URLs -> keep short URLs
+
+## Response Format
+
+Return ONLY the transformed text. No JSON, no explanations.