@otto-assistant/otto 0.1.1 → 0.7.15

package/package.json

@@ -1,51 +1,103 @@
 {
   "name": "@otto-assistant/otto",
-  "version": "0.1.1",
-  "description": "Otto — terminal UI distribution wrapper for opencode + kimaki + mempalace",
+  "repository": "https://github.com/otto-assistant/bridge",
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org"
+  },
+  "module": "index.ts",
   "type": "module",
-  "bin": {
-    "otto": "./dist/cli.js"
+  "version": "0.7.15",
+  "scripts": {
+    "dev": "tsx src/bin.ts",
+    "prepublishOnly": "pnpm build",
+    "build": "pnpm prepare-skills && pnpm generate && pnpm tsc",
+    "dev:bun": "DEBUG=1 bun --env-file .env src/bin.ts",
+    "watch": "tsx scripts/watch-session.ts",
+    "generate": "prisma generate && pnpm generate:sql",
+    "generate:sql": "rm -f dev.db && prisma db push --url 'file:dev.db' --accept-data-loss && echo '-- This file is generated by pnpm generate:sql. Do not edit manually.' > src/schema.sql && sqlite3 dev.db '.schema' >> src/schema.sql",
+    "pcm-to-mp3": "bun scripts/pcm-to-mp3",
+    "test": "vitest",
+    "validate-typing-indicator": "doppler run -- tsx scripts/validate-typing-indicator.ts",
+    "test:send": "tsx send-test-message.ts",
+    "register-commands": "tsx scripts/register-commands.ts",
+    "lint": "lintcn lint",
+    "format": "oxfmt src",
+    "prepare-skills": "rm -rf skills && mkdir -p skills && cp -R ../skills/. skills",
+    "sync-skills": "tsx scripts/sync-skills.ts"
   },
-  "main": "./dist/index.js",
-  "types": "./dist/index.d.ts",
-  "exports": {
-    "./package.json": "./package.json",
-    ".": {
-      "types": "./dist/index.d.ts",
-      "default": "./dist/index.js"
-    }
+  "bin": {
+    "otto": "bin.js"
   },
   "files": [
+    "dist",
     "src",
-    "dist"
-  ],
-  "keywords": [
-    "otto",
-    "opencode",
-    "kimaki",
-    "ai-agent",
-    "distribution"
+    "skills",
+    "schema.prisma",
+    "bin.js"
   ],
-  "license": "MIT",
-  "repository": {
-    "type": "git",
-    "url": "git+https://github.com/otto-assistant/otto.git"
-  },
-  "scripts": {
-    "build": "rm -rf dist *.tsbuildinfo && tsc && chmod +x dist/cli.js",
-    "dev": "tsc --watch",
-    "build:artifacts": "./scripts/build-local-artifacts.sh",
-    "prepublishOnly": "pnpm build",
-    "test": "vitest run",
-    "test:watch": "vitest"
+  "devDependencies": {
+    "@types/bun": "latest",
+    "@types/heic-convert": "^2.1.0",
+    "@types/json-schema": "^7.0.15",
+    "@types/ms": "^2.1.0",
+    "@types/node": "^24.3.0",
+    "@types/proper-lockfile": "^4.1.4",
+    "@types/ws": "^8.18.1",
+    "db": "workspace:^",
+    "discord-digital-twin": "workspace:^",
+    "discord-telegram-bridge": "workspace:^",
+    "eventsource-parser": "^3.0.6",
+    "lintcn": "^0.7.1",
+    "opencode-cached-provider": "workspace:^",
+    "opencode-deterministic-provider": "workspace:^",
+    "prisma": "7.4.2",
+    "tsx": "^4.20.5",
+    "undici": "^8.0.2"
   },
   "dependencies": {
-    "@clack/prompts": "^0.9.1",
-    "picocolors": "^1.1.1"
+    "@ai-sdk/google": "^3.0.53",
+    "@ai-sdk/openai": "^3.0.31",
+    "@ai-sdk/provider": "^3.0.8",
+    "@clack/prompts": "^1.0.0",
+    "@discordjs/voice": "^0.19.0",
+    "@google/genai": "^1.46.0",
+    "@libsql/client": "^0.17.2",
+    "@opencode-ai/plugin": "^1.4.6",
+    "@opencode-ai/sdk": "^1.4.6",
+    "@parcel/watcher": "^2.5.6",
+    "@prisma/adapter-libsql": "7.4.2",
+    "@prisma/client": "7.4.2",
+    "@purinton/resampler": "^1.0.4",
+    "cron-parser": "^5.5.0",
+    "diff": "^8.0.4",
+    "discord.js": "^14.25.1",
+    "domhandler": "^6.0.1",
+    "errore": "^0.14.1",
+    "goke": "^6.8.0",
+    "htmlparser2": "^12.0.0",
+    "kitty-graphics-agent": "^0.0.5",
+    "libsql": "^0.5.22",
+    "libsqlproxy": "^0.1.0",
+    "marked": "^17.0.5",
+    "mime": "^4.1.0",
+    "opencode-injection-guard": "^0.2.1",
+    "opusscript": "^0.0.8",
+    "picocolors": "^1.1.1",
+    "pretty-ms": "^9.3.0",
+    "proper-lockfile": "^4.1.2",
+    "string-dedent": "^3.0.2",
+    "traforo": "^0.4.0",
+    "ws": "^8.19.0",
+    "xdg-basedir": "^5.1.0",
+    "yaml": "^2.8.3",
+    "zod": "^4.3.6",
+    "zustand": "^5.0.11"
   },
-  "devDependencies": {
-    "@types/node": "^22.19.17",
-    "typescript": "^5.7.3",
-    "vitest": "^3.2.0"
+  "optionalDependencies": {
+    "@snazzah/davey": "^0.1.10",
+    "heic-convert": "^2.1.0",
+    "prism-media": "^1.3.5",
+    "sharp": "^0.34.5"
   }
 }

package/schema.prisma

@@ -0,0 +1,303 @@
+// schema.prisma for the otto local db
+// prefer using enum for strings with few known options so it is type safe in typescript code. sqlite does not have enum. this is a prisma only concept
+// these enums will be also exported as types by prisma and we can reuse them in our code
+
+generator client {
+  provider = "prisma-client"
+  output   = "./src/generated"
+}
+
+datasource db {
+  provider = "sqlite"
+}
+
+model thread_sessions {
+  thread_id  String    @id
+  session_id String
+  source     ThreadSessionSource @default(otto)
+  created_at DateTime? @default(now())
+
+  part_messages   part_messages[]
+  session_events  session_events[]
+  scheduled_tasks scheduled_tasks[]
+  thread_worktree thread_worktrees?
+  ipc_requests    ipc_requests[]
+}
+
+enum ThreadSessionSource {
+  otto
+  kimaki
+  external_poll
+}
+
+model session_events {
+  id               Int       @id @default(autoincrement())
+  session_id       String
+  thread_id        String
+  timestamp        BigInt    // milliseconds since Unix epoch
+  event_index      Int       // stable in-memory insertion order within a session
+  event_json       String
+
+  thread thread_sessions @relation(fields: [thread_id], references: [thread_id], onDelete: Cascade, onUpdate: Cascade)
+
+  @@index([session_id, timestamp, event_index, id])
+  @@index([thread_id, timestamp, event_index, id])
+}
+
+model part_messages {
+  part_id    String    @id
+  message_id String
+  thread_id  String
+  created_at DateTime? @default(now())
+
+  thread thread_sessions @relation(fields: [thread_id], references: [thread_id])
+}
+
+model bot_tokens {
+  app_id        String    @id
+  token         String
+  bot_mode      BotMode   @default(self_hosted)
+  thread_deletion_sync_mode ThreadDeletionSyncMode?
+  client_id     String?
+  client_secret String?
+  proxy_url     String?
+  created_at    DateTime? @default(now())
+  last_used_at  DateTime?
+
+  api_keys           bot_api_keys?
+  forum_sync_configs forum_sync_configs[]
+  global_model       global_models?
+}
+
+enum BotMode {
+  self_hosted
+  gateway
+}
+
+enum ThreadDeletionSyncMode {
+  soft
+  hard
+}
+
+model channel_directories {
+  channel_id   String      @id
+  directory    String
+  channel_type ChannelType
+  // app_id String? // no longer used: channel ownership is no longer scoped per bot app
+  created_at   DateTime?   @default(now())
+
+  channel_model        channel_models?
+  channel_agent        channel_agents?
+  channel_worktree     channel_worktrees?
+  channel_verbosity    channel_verbosity?
+  channel_mention_mode channel_mention_mode?
+  scheduled_tasks      scheduled_tasks[]
+}
+
+enum ChannelType {
+  text
+  voice
+}
+
+model bot_api_keys {
+  app_id         String    @id
+  gemini_api_key String?
+  openai_api_key String?
+  xai_api_key    String?
+  created_at     DateTime? @default(now())
+
+  bot bot_tokens @relation(fields: [app_id], references: [app_id])
+}
+
+model thread_worktrees {
+  thread_id          String          @id
+  worktree_name      String
+  worktree_directory String?
+  project_directory  String
+  status             WorktreeStatus  @default(pending)
+  error_message      String?
+  created_at         DateTime?       @default(now())
+
+  thread thread_sessions @relation(fields: [thread_id], references: [thread_id])
+}
+
+enum WorktreeStatus {
+  pending
+  ready
+  error
+}
+
+model channel_models {
+  channel_id String    @id
+  model_id   String
+  variant    String?
+  created_at DateTime? @default(now())
+  updated_at DateTime? @default(now()) @updatedAt
+
+  channel channel_directories @relation(fields: [channel_id], references: [channel_id])
+}
+
+model session_models {
+  session_id String    @id
+  model_id   String
+  variant    String?
+  created_at DateTime? @default(now())
+}
+
+model channel_agents {
+  channel_id String    @id
+  agent_name String
+  created_at DateTime? @default(now())
+  updated_at DateTime? @default(now()) @updatedAt
+
+  channel channel_directories @relation(fields: [channel_id], references: [channel_id])
+}
+
+model session_agents {
+  session_id String    @id
+  agent_name String
+  created_at DateTime? @default(now())
+}
+
+model channel_worktrees {
+  channel_id String    @id
+  enabled    Int       @default(0)
+  created_at DateTime? @default(now())
+  updated_at DateTime? @default(now()) @updatedAt
+
+  channel channel_directories @relation(fields: [channel_id], references: [channel_id])
+}
+
+model channel_verbosity {
+  channel_id String         @id
+  verbosity  VerbosityLevel @default(tools_and_text)
+  updated_at DateTime?      @default(now()) @updatedAt
+
+  channel channel_directories @relation(fields: [channel_id], references: [channel_id])
+}
+
+enum VerbosityLevel {
+  tools_and_text
+  text_and_essential_tools
+  text_only
+}
+
+model channel_mention_mode {
+  channel_id String    @id
+  enabled    Int       @default(0)
+  created_at DateTime? @default(now())
+  updated_at DateTime? @default(now()) @updatedAt
+
+  channel channel_directories @relation(fields: [channel_id], references: [channel_id])
+}
+
+model global_models {
+  app_id     String    @id
+  model_id   String
+  variant    String?
+  created_at DateTime? @default(now())
+  updated_at DateTime? @default(now()) @updatedAt
+
+  bot bot_tokens @relation(fields: [app_id], references: [app_id])
+}
+
+enum task_status {
+  planned
+  running
+  completed
+  cancelled
+  failed
+}
+
+enum task_schedule_kind {
+  at
+  cron
+}
+
+model scheduled_tasks {
+  id                 Int                @id @default(autoincrement())
+  status             task_status        @default(planned)
+  schedule_kind      task_schedule_kind
+  run_at             DateTime?
+  cron_expr          String?
+  timezone           String?
+  next_run_at        DateTime
+  running_started_at DateTime?
+  last_run_at        DateTime?
+  last_error         String?
+  attempts           Int                @default(0)
+  payload_json       String
+  prompt_preview     String
+  channel_id         String?
+  thread_id          String?
+  session_id         String?
+  project_directory  String?
+  created_at         DateTime?          @default(now())
+  updated_at         DateTime?          @default(now()) @updatedAt
+
+  channel               channel_directories?    @relation(fields: [channel_id], references: [channel_id], onDelete: SetNull, onUpdate: Cascade)
+  thread                thread_sessions?        @relation(fields: [thread_id], references: [thread_id], onDelete: SetNull, onUpdate: Cascade)
+  session_start_sources session_start_sources[]
+
+  @@index([status, next_run_at])
+  @@index([channel_id, status])
+  @@index([thread_id, status])
+}
+
+model session_start_sources {
+  session_id         String             @id
+  schedule_kind      task_schedule_kind
+  scheduled_task_id  Int?
+  created_at         DateTime?          @default(now())
+  updated_at         DateTime?          @default(now()) @updatedAt
+
+  scheduled_task scheduled_tasks? @relation(fields: [scheduled_task_id], references: [id], onDelete: SetNull, onUpdate: Cascade)
+
+  @@index([scheduled_task_id])
+}
+
+model forum_sync_configs {
+  id               Int       @id @default(autoincrement())
+  app_id           String
+  forum_channel_id String
+  output_dir       String
+  direction        String    @default("bidirectional")
+  created_at       DateTime? @default(now())
+  updated_at       DateTime? @default(now()) @updatedAt
+
+  bot bot_tokens @relation(fields: [app_id], references: [app_id], onDelete: Cascade, onUpdate: Cascade)
+
+  @@unique([app_id, forum_channel_id])
+}
+
+enum ipc_request_type {
+  file_upload
+  action_buttons
+  start_thread_listener
+}
+
+enum ipc_request_status {
+  pending
+  processing
+  completed
+  cancelled
+}
+
+// IPC bridge between the opencode plugin process and the Discord bot process.
+// Replaces the old HTTP lock server for file-upload and action-buttons requests.
+// Plugin inserts a pending row, bot polls and dispatches, then writes the response.
+model ipc_requests {
+  id         String             @id @default(uuid())
+  type       ipc_request_type
+  session_id String
+  thread_id  String
+  payload    String             // JSON-encoded request data
+  response   String?            // JSON-encoded response, null while pending
+  status     ipc_request_status @default(pending)
+  created_at DateTime           @default(now())
+  updated_at DateTime           @default(now()) @updatedAt
+
+  thread thread_sessions @relation(fields: [thread_id], references: [thread_id])
+
+  @@index([status, created_at])
+}

package/skills/batch/SKILL.md

@@ -0,0 +1,87 @@
+---
+name: batch
+description: >
+  Research and plan a large-scale change, then execute it in parallel across
+  5-30 isolated worktree agents that each open a PR. Use when the user wants
+  to make a sweeping, mechanical change across many files (migrations,
+  refactors, bulk renames) that can be decomposed into independent parallel
+  units.
+argument-hint: "<instruction>"
+source-path: cli.js (line 7359, function mGz)
+source-package: "@anthropic-ai/claude-code@2.1.63"
+source-date: 2026-02-28
+---
+
+# Batch: Parallel Work Orchestration
+
+You are orchestrating a large, parallelizable change across this codebase.
+
+## User Instruction
+
+$instruction
+
+## Phase 1: Research and Plan (Plan Mode)
+
+Enter plan mode, then:
+
+1. **Understand the scope.** Launch one or more Explore agents (in the foreground — you need their results) to deeply research what this instruction touches. Find all the files, patterns, and call sites that need to change. Understand the existing conventions so the migration is consistent.
+
+2. **Decompose into independent units.** Break the work into 5–30 self-contained units. Each unit must:
+   - Be independently implementable in an isolated git worktree (no shared state with sibling units)
+   - Be mergeable on its own without depending on another unit's PR landing first
+   - Be roughly uniform in size (split large units, merge trivial ones)
+
+   Scale the count to the actual work: few files → closer to 5; hundreds of files → closer to 30. Prefer per-directory or per-module slicing over arbitrary file lists.
+
+3. **Determine the e2e test recipe.** Figure out how a worker can verify its change actually works end-to-end — not just that unit tests pass. Look for:
+   - A browser-automation tool (for UI changes: click through the affected flow, screenshot the result)
+   - A tuistory or CLI-verifier skill (for CLI changes: launch the app interactively, exercise the changed behavior)
+   - A dev-server + curl pattern (for API changes: start the server, hit the affected endpoints)
+   - An existing e2e/integration test suite the worker can run
+
+   If you cannot find a concrete e2e path, ask the user how to verify this change end-to-end. Offer 2–3 specific options based on what you found (e.g., "Screenshot via chrome extension", "Run `bun run dev` and curl the endpoint", "No e2e — unit tests are sufficient"). Do not skip this — the workers cannot ask the user themselves.
+
+   Write the recipe as a short, concrete set of steps that a worker can execute autonomously. Include any setup (start a dev server, build first) and the exact command/interaction to verify.
+
+4. **Write the plan.** In your plan file, include:
+   - A summary of what you found during research
+   - A numbered list of work units — for each: a short title, the list of files/directories it covers, and a one-line description of the change
+   - The e2e test recipe (or "skip e2e because …" if the user chose that)
+   - The exact worker instructions you will give each agent (the shared template)
+
+5. Present the plan for approval.
+
+## Phase 2: Spawn Workers (After Plan Approval)
+
+Once the plan is approved, spawn one background agent per work unit using the Task tool. **All agents must use `isolation: "worktree"` and `run_in_background: true`.** Launch them all in a single message block so they run in parallel.
+
+For each agent, the prompt must be fully self-contained. Include:
+- The overall goal (the user's instruction)
+- This unit's specific task (title, file list, change description — copied verbatim from your plan)
+- Any codebase conventions you discovered that the worker needs to follow
+- The e2e test recipe from your plan (or "skip e2e because …")
+- The worker instructions below, copied verbatim:
+
+```
+After you finish implementing the change:
+1. **Simplify** — Invoke the simplify skill to review and clean up your changes.
+2. **Run unit tests** — Run the project's test suite (check for package.json scripts, Makefile targets, or common commands like `npm test`, `bun test`, `pytest`, `go test`). If tests fail, fix them.
+3. **Test end-to-end** — Follow the e2e test recipe from the coordinator's prompt (below). If the recipe says to skip e2e for this unit, skip it.
+4. **Commit and push** — Commit all changes with a clear message, push the branch, and create a PR with `gh pr create`. Use a descriptive title. If `gh` is not available or the push fails, note it in your final message.
+5. **Report** — End with a single line: `PR: <url>` so the coordinator can track it. If no PR was created, end with `PR: none — <reason>`.
+```
+
+Use `subagent_type: "general-purpose"` unless a more specific agent type fits.
+
+## Phase 3: Track Progress
+
+After launching all workers, render an initial status table:
+
+| # | Unit | Status | PR |
+|---|------|--------|----|
+| 1 | <title> | running | — |
+| 2 | <title> | running | — |
+
+As background-agent completion notifications arrive, parse the `PR: <url>` line from each agent's result and re-render the table with updated status (`done` / `failed`) and PR links. Keep a brief failure note for any agent that did not produce a PR.
+
+When all agents have reported, render the final table and a one-line summary (e.g., "22/24 units landed as PRs").

package/skills/critique/SKILL.md

@@ -0,0 +1,112 @@
+---
+name: critique
+description: >
+  Git diff viewer. Renders diffs as web pages, images, and PDFs
+  with syntax highlighting. Use this skill when working with critique for showing
+  diffs, generating diff URLs, or selective hunk staging.
+---
+
+# critique
+
+Git diff viewer that renders diffs as **web pages**, **images**, and **PDFs** with syntax highlighting.
+
+Agents running in headless environments (otto on Discord, openclaw on Slack/Telegram) have no terminal to show diffs. critique uploads diffs to critique.work and returns a shareable URL you can paste into chat. Users click the link and see a syntax-highlighted split-view diff with mobile support and dark/light mode — no install needed.
+
+**Always run `critique --help` first** to see the latest flags and commands. The help output is the source of truth.
+
+## Web — shareable diff URLs
+
+Always pass a title to describe what the diff contains.
+
+```bash
+# Working tree changes
+critique --web "Add retry logic to database connections"
+
+# Staged changes
+critique --staged --web "Refactor auth middleware"
+
+# Branch diff (three-dot: changes since diverging from base)
+critique main...HEAD --web "Feature branch changes"
+critique main...feature-branch --web "Compare branches"
+
+# Last N commits
+critique HEAD~3 --web "Recent changes"
+
+# Specific commit
+critique --commit HEAD --web "Latest commit"
+critique --commit abc1234 --web "Fix race condition"
+
+# Filter to specific files
+critique --web "API changes" --filter "src/api.ts" --filter "src/utils.ts"
+
+# JSON output for programmatic use (returns {url, id, files})
+critique --web "Deploy changes" --json
+```
+
+Share the returned URL with the user so they can see the diff.
+
+## PDF
+
+```bash
+critique --pdf                              # working tree to PDF
+critique --staged --pdf                     # staged changes
+critique main...HEAD --pdf                   # branch diff
+critique --commit HEAD --pdf                # single commit
+critique --pdf output.pdf                   # custom filename
+critique --pdf --pdf-page-size a4-portrait  # page size options
+critique main...HEAD --pdf --open            # open in viewer
+```
+
+## Image
+
+```bash
+critique --image              # renders to /tmp as WebP
+critique main...HEAD --image  # branch diff as images
+```
+
+## Selective hunk staging
+
+When multiple agents work on the same repo, each agent should only commit its own changes. `critique hunks` lets you stage individual hunks instead of whole files — like a scriptable `git add -p`.
+
+```bash
+# List hunks with stable IDs
+critique hunks list
+critique hunks list --filter "src/**/*.ts"
+
+# Stage specific hunks by ID
+critique hunks add 'src/main.ts:@-10,6+10,7'
+critique hunks add 'src/main.ts:@-10,6+10,7' 'src/utils.ts:@-5,3+5,4'
+```
+
+Hunk ID format: `file:@-oldStart,oldLines+newStart,newLines` — derived from the `@@` diff header, stable across runs.
+
+**Typical workflow:**
+
+```bash
+critique hunks list                          # see all unstaged hunks
+critique hunks add 'file:@-10,6+10,7'       # stage only your hunks
+git commit -m "your changes"                 # commit separately
+```
+
+## Raw patch access
+
+Every `--web` upload also stores the raw unified diff. Append `.patch` to any critique URL to get it:
+
+```bash
+# View the raw patch
+curl https://critique.work/v/<id>.patch
+
+# Apply the patch to current repo
+curl -s https://critique.work/v/<id>.patch | git apply
+
+# Reverse the patch (undo the changes)
+curl -s https://critique.work/v/<id>.patch | git apply --reverse
+```
+
+Useful when an agent shares a critique URL and you want to programmatically apply or revert those changes.
+
+## Notes
+
+- Requires **Bun** — use `bunx critique` or global `critique`
+- Lock files and diffs >6000 lines are auto-hidden
+- `--web` URLs expire after 7 days (content-hashed, same diff = same URL)