titan-agent 6.1.0 → 6.2.0

package/README.md

@@ -26,7 +26,7 @@
 </p>
 
 <p align="center">
-  <a href="#-the-numbers"><img src="https://img.shields.io/badge/version-6.1.0-blueviolet" alt="v6.1.0"/></a>
+  <a href="#-the-numbers"><img src="https://img.shields.io/badge/version-6.2.0-blueviolet" alt="v6.2.0"/></a>
   <a href="#-36-llm-providers"><img src="https://img.shields.io/badge/providers-36-purple" alt="36 Providers"/></a>
   <a href="#-the-numbers"><img src="https://img.shields.io/badge/tools-248%2B-orange" alt="248+ Tools"/></a>
   <a href="#-build-anything-on-demand"><img src="https://img.shields.io/badge/widgets-109-pink" alt="109 Widgets"/></a>
@@ -46,11 +46,31 @@
 
 ## 🪵 NEW in v6.1 — Mission Chat + Desk view
 
-> Status: `v6.1.0` — stable npm `@latest` release. The previous public `@latest` was `6.1.0-beta.7`; beta hardening continued through `6.1.0-beta.30` before this stable promotion.
+> Status: `v6.2.0` — stable npm `@latest` release with TITAN Phone Desk: optional Dograh sidecar integration for Twilio/Telnyx voice workflows, approval-gated outbound calls, inbound admin/receptionist webhooks, opt-out enforcement, receipts, and a dashboard panel.
 > Install with `npm i -g titan-agent` (or `npm update -g titan-agent`).
 > The v6.0 "Presence" feature set below still applies — v6.1.0 layers
 > a beautiful new surface on top of it.
 
+## 📞 NEW in v6.2 — TITAN Phone Desk with Dograh
+
+TITAN can now connect to a self-hosted or hosted Dograh sidecar for Twilio/Telnyx-powered phone workflows without storing carrier credentials directly in TITAN. The integration is optional and disabled by default.
+
+What is verified in v6.2.0:
+
+- `GET /api/telephony/dograh/status` checks Dograh reachability and redacts the API key.
+- `GET /api/telephony/dograh/workflows` lists active Dograh workflows.
+- `POST /api/telephony/dograh/call` creates an approval request first, then starts an outbound Dograh call only when a matching approval action is supplied.
+- The `phone_call` tool is approval-request-only; it never dials directly from an LLM tool call.
+- `POST /api/telephony/dograh/inbound` handles inbound Dograh webhooks for admin-control and receptionist lines.
+- Admin control is restricted to configured E.164 `telephony.adminNumbers`.
+- Public/receptionist numbers do not receive admin privileges.
+- Campaign/cold-call mode is locked unless `allowCampaigns`, recording disclosure, opt-out keywords, and hourly rate limits are configured.
+- Inbound opt-out phrases are recorded and block future campaign calls to that number.
+- Phone numbers and Dograh API keys are redacted from responses, receipts, and UI lists.
+- `/tools/phone-desk` provides status, workflow, call-receipt, opt-out, and approval-request UI.
+
+Dograh is BSD-2-Clause. TITAN integrates with it as an external sidecar/API so the npm package stays lightweight and Dograh can own the Twilio/Telnyx credentials.
+
 Every TITAN canvas page now carries a **🪵 Mission Chat** launcher in
 the header (with a small **NEW** badge). Click it and you walk into a
 chat-style team-control surface — plus a literal **wood desk** view
@@ -349,7 +369,7 @@ curl -fsSL https://raw.githubusercontent.com/Djtony707/TITAN/main/install.sh | b
 **Or npm:**
 
 ```bash
-npm install -g titan-agent@next     # v6.0 beta channel
+npm install -g titan-agent          # stable latest release
 titan onboard                       # Interactive setup wizard
 titan gateway                       # Launches Mission Control at http://localhost:48420
 ```
@@ -367,7 +387,7 @@ Requirements: **Node ≥ 22** (pure ESM, no CJS). For GPU features (LoRA fine-tu
 
 ### Upgrading from v5.x
 
-Just run `npm install -g titan-agent@next`. The migration runner kicks in on first boot, takes an automatic backup first (`~/.titan/backups/`), then applies the schema migrations. If anything goes sideways, `titan backup restore <id>` puts you back.
+Just run `npm install -g titan-agent`. The migration runner kicks in on first boot, takes an automatic backup first (`~/.titan/backups/`), then applies the schema migrations. If anything goes sideways, `titan backup restore <id>` puts you back.
 
 ---
 
@@ -425,7 +445,7 @@ Start in supervised mode. Review what it does. Don't give it access to systems y
 
 | Thing                              | Count                            | Where to verify                                |
 | ---------------------------------- | -------------------------------- | ---------------------------------------------- |
-| **Version**                        | 6.1.0                            | `package.json` + `src/utils/constants.ts`      |
+| **Version**                        | 6.2.0                            | `package.json` + `src/utils/constants.ts`      |
 | **LLM providers**                  | 36 (4 native + 32 OpenAI-compat) | `src/providers/openai_compat.ts`               |
 | **Channel adapters**               | 19                               | `src/channels/*.ts` (minus base)               |
 | **Built-in skill modules**         | 91 files                         | `src/skills/builtin/`                          |

package/dist/config/schema.js

@@ -524,6 +524,27 @@ const SelfModConfigSchema = z.object({
   maxPRsPerDrivePer48h: z.number().min(1).max(20).default(1).describe("Rate limit \u2014 how many self-proposal PRs a single drive can generate in a rolling 48h window."),
   pollIntervalMs: z.number().min(6e4).max(36e5).default(3e5).describe("How often to poll GitHub for merge/close status on open PRs. 5 min default.")
 });
+const TelephonyConfigSchema = z.object({
+  /** Optional production telephony sidecar. Dograh owns Twilio/Telnyx credentials; TITAN stores only Dograh connection policy. */
+  enabled: z.boolean().default(false),
+  provider: z.enum(["dograh"]).default("dograh"),
+  dograh: z.object({
+    baseUrl: z.string().default("http://localhost:8000"),
+    apiKey: z.string().optional(),
+    defaultOutboundWorkflowId: z.string().optional(),
+    defaultInboundWorkflowId: z.string().optional()
+  }).default({}),
+  /** E.164 numbers allowed to control TITAN over the admin line. */
+  adminNumbers: z.array(z.string()).default([]),
+  /** Public/receptionist numbers mapped in Dograh. These never receive admin privileges. */
+  publicNumbers: z.array(z.string()).default([]),
+  /** Outbound calls are approval-gated by default; campaign/cold-call mode is separately disabled. */
+  requireApprovalForOutbound: z.boolean().default(true),
+  allowCampaigns: z.boolean().default(false),
+  maxCallsPerHour: z.number().int().min(0).max(1e4).default(10),
+  recordingDisclosure: z.string().default(""),
+  optOutKeywords: z.array(z.string()).default(["STOP", "UNSUBSCRIBE", "REMOVE"])
+}).default({});
 const TitanConfigSchema = z.object({
   /** Whether the user has completed the web onboarding wizard */
   onboarded: z.boolean().default(false),
@@ -543,6 +564,7 @@ const TitanConfigSchema = z.object({
   organism: OrganismConfigSchema.default({}),
   selfMod: SelfModConfigSchema.default({}),
   homelab: HomelabConfigSchema.default({}),
+  telephony: TelephonyConfigSchema,
   providers: z.object({
     /** v5.4.1: Per-model output-token caps override. Keys are provider/model IDs.
      *  Values override the built-in static table + family heuristics. */
@@ -1521,6 +1543,7 @@ export {
   SelfModConfigSchema,
   TeachingConfigSchema,
   TeamConfigSchema,
+  TelephonyConfigSchema,
   TitanConfigSchema,
   ToolSearchConfigSchema,
   TunnelConfigSchema,