@triangllabs/otis 0.1.7

package/README.md

@@ -0,0 +1,80 @@
+# Otis
+
+Otis is an interactive terminal AI agent. The MVP runs locally as an OpenTUI CLI, uses a local TypeScript agent runtime, and calls an Otis-hosted Go gateway for inference and hosted web tools.
+
+## MVP Architecture
+
+```txt
+OpenTUI CLI
+  -> local TypeScript agent runtime on Node 22+
+    -> Otis Go gateway on GCP Cloud Run
+      -> hosted model and web providers
+```
+
+The local runtime owns the agent loop, local tool execution, session files, permissions, and UI events. The cloud gateway owns authentication, provider keys, system prompts, model routing, provider calls, hosted web tools, and future quota enforcement.
+
+## Current Decisions
+
+- Interactive CLI only for MVP.
+- OpenTUI frontend.
+- TypeScript local runtime on Node 22+.
+- Go cloud gateway.
+- GCP infrastructure managed with Terraform.
+- GitHub Actions for CI/CD.
+- Provider access behind Otis's backend keys.
+- One configured primary model with fallback handling. No user-visible model picker.
+- Local JSONL session files.
+- Single-use invite code exchanged for a bearer token.
+- Quota hooks implemented but disabled initially.
+- Provider-native structured tool calls streamed through the gateway.
+- Shell tool included.
+
+## Initial User Flow
+
+```txt
+1. Invited user installs Otis.
+2. User runs `otis`.
+3. User selects Log in and enters a single-use invite code.
+4. CLI stores a bearer token locally.
+5. User starts chatting.
+6. Otis streams responses through the Otis gateway.
+7. Otis can read/search files, edit files, and run shell commands.
+8. Session history is saved locally as JSONL.
+```
+
+## Login
+
+Run `otis` and press Enter on Log in, or run `otis login`, then enter a single-use invite code. Otis stores the issued bearer token locally under the user's Otis config directory.
+
+The CLI defaults to the Otis dev gateway: `https://otis-gateway-dev-774436916534.us-central1.run.app`. Use `--gateway-url <gateway-url>` or `OTIS_GATEWAY_URL` to override it.
+
+For development, a full `OTIS_GATEWAY_URL` and `OTIS_AUTH_TOKEN` pair still overrides saved auth.
+
+## Repository Layout
+
+```txt
+apps/cli/              OpenTUI CLI app
+packages/core/         Agent loop, events, context assembly
+packages/gateway/      Gateway API client and protocol types
+packages/tools/        Local tool implementations
+packages/storage/      JSONL session storage
+.github/workflows/     GitHub Actions workflows
+docs/                  Architecture and implementation notes
+```
+
+## Non-Goals For MVP
+
+- Electron desktop app.
+- Local inference.
+- Print, JSON, or RPC modes.
+- User-visible model selection.
+- BYOK.
+- OAuth.
+- Cloud session sync.
+- Extension marketplace.
+- MCP.
+- Subagents.
+
+## Status
+
+Interactive CLI runtime is in progress. Hosted gateway and GCP infrastructure live in separate private repos.

package/bin/otis

@@ -0,0 +1,81 @@
+#!/usr/bin/env node
+
+const childProcess = require("child_process")
+const fs = require("fs")
+const path = require("path")
+const os = require("os")
+
+const forwardedSignals = ["SIGINT", "SIGTERM", "SIGHUP"]
+
+const platformMap = {
+  darwin: "darwin",
+  linux: "linux",
+  win32: "windows",
+}
+
+const archMap = {
+  x64: "x64",
+  arm64: "arm64",
+}
+
+const platform = platformMap[os.platform()] ?? os.platform()
+const arch = archMap[os.arch()] ?? os.arch()
+const binary = platform === "windows" ? "otis.exe" : "otis"
+const packageName = `@triangllabs/otis-${platform}-${arch}`
+
+function findBinary(startDir) {
+  let current = startDir
+  for (;;) {
+    const modules = path.join(current, "node_modules")
+    if (fs.existsSync(modules)) {
+      const candidate = path.join(modules, packageName, "bin", binary)
+      if (fs.existsSync(candidate)) return candidate
+    }
+    const parent = path.dirname(current)
+    if (parent === current) return
+    current = parent
+  }
+}
+
+const scriptDir = path.dirname(fs.realpathSync(__filename))
+const args = process.argv.slice(2)
+
+if (args[0] === "update") {
+  console.log("Updating Otis...")
+  childProcess.execSync("npm install -g @triangllabs/otis@latest", { stdio: "inherit" })
+  console.log("Otis updated successfully.")
+  process.exit(0)
+}
+
+const resolved = process.env.OTIS_BIN_PATH || findBinary(scriptDir)
+
+if (!resolved) {
+  console.error(
+    `Could not find the Otis binary for ${platform}-${arch}. ` +
+      `Try installing "${packageName}" manually, or set OTIS_BIN_PATH to the binary location.`,
+  )
+  process.exit(1)
+}
+
+const child = childProcess.spawn(resolved, process.argv.slice(2), { stdio: "inherit" })
+
+child.on("error", (error) => {
+  console.error(error.message)
+  process.exit(1)
+})
+
+for (const signal of forwardedSignals) {
+  process.on(signal, () => {
+    try {
+      child.kill(signal)
+    } catch {}
+  })
+}
+
+child.on("exit", (code, signal) => {
+  if (signal) {
+    process.kill(process.pid, signal)
+    return
+  }
+  process.exit(typeof code === "number" ? code : 0)
+})

package/package.json

@@ -0,0 +1,61 @@
+{
+  "name": "@triangllabs/otis",
+  "version": "0.1.7",
+  "description": "Interactive terminal AI agent by Triangl Labs",
+  "license": "UNLICENSED",
+  "type": "module",
+  "bin": {
+    "otis": "bin/otis"
+  },
+  "scripts": {
+    "dev": "bun run apps/cli/src/index.ts",
+    "build": "bun run scripts/build.ts",
+    "format": "biome format --write .",
+    "lint": "biome lint .",
+    "check": "biome check .",
+    "test": "vitest run",
+    "test:coverage": "vitest run --coverage",
+    "typecheck": "tsc --noEmit",
+    "prepublishOnly": "bun run typecheck && bun run check && bun run test"
+  },
+  "files": [
+    "bin/"
+  ],
+  "keywords": [
+    "ai",
+    "agent",
+    "cli",
+    "terminal",
+    "coding",
+    "assistant"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/triangllabs/otis.git"
+  },
+  "homepage": "https://github.com/triangllabs/otis",
+  "bugs": {
+    "url": "https://github.com/triangllabs/otis/issues"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "optionalDependencies": {
+    "@triangllabs/otis-darwin-arm64": "0.1.7",
+    "@triangllabs/otis-darwin-x64": "0.1.7",
+    "@triangllabs/otis-linux-arm64": "0.1.7",
+    "@triangllabs/otis-linux-x64": "0.1.7"
+  },
+  "devDependencies": {
+    "@biomejs/biome": "^2.5.0",
+    "@opentui/core": "^0.4.1",
+    "@types/node": "^24.0.0",
+    "@vitest/coverage-v8": "^4.1.9",
+    "diff": "^9.0.0",
+    "typescript": "^5.8.0",
+    "vitest": "^4.1.9"
+  }
+}