otter-axi 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Jarvus Innovations
+
+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,86 @@
+# otter-axi
+
+An agent-facing CLI ([AXI](https://github.com/JarvusInnovations/axi) tool) that wraps
+Otter.ai's hosted **MCP server** to **find and pull meeting transcripts** from any shell —
+headlessly, after a one-time browser login. Token-efficient [TOON](https://toonformat.dev)
+output, built for agents.
+
+It does find-and-pull only; analysis is left to whatever consumes the output.
+
+## Why
+
+Otter's hosted MCP connector re-prompts for auth and can't be scripted, and its Public REST
+API is gated to Enterprise workspaces. otter-axi turns the same sanctioned MCP server into a
+scriptable CLI: approve once in the browser, then `search`/`fetch` run non-interactively from
+any agent session or shell, with refresh handled silently.
+
+## Install & authenticate
+
+```sh
+npx -y otter-axi auth login    # one-time browser approval
+otter-axi doctor               # config → credentials → MCP reachable
+```
+
+Tokens are stored in `~/.config/otter-axi/config.json` (mode `0600`) and refreshed
+automatically; they are never printed. Read-only scopes: `profile:read`, `conversations:read`.
+
+## Usage
+
+**Find or browse meetings** (returns metadata: title, date, duration, summary, action-item
+count, id). Empty query + a date range is browse mode:
+
+```sh
+otter-axi search "pricing discussion" --after 30d
+otter-axi search --after 2026/05/01 --before 2026/05/07
+otter-axi search --in-transcript "roadmap,milestones" --attended-by "Jane Doe" --mine
+```
+
+Flags: `-q/--query`, `--after`/`--before` (ISO or relative `7d`/`2w`/`3m`/`1y`),
+`--title-contains`, `--in-transcript`, `--attended-by`, `--channel`, `--folder`, `--mine`,
+`--limit`, `--full`.
+
+**Pull a transcript** by id (from search) or `otter.ai/u/<id>` URL:
+
+```sh
+otter-axi fetch <id>                 # metadata + preview
+otter-axi fetch <id> --full          # verbatim transcript to stdout (for piping)
+otter-axi fetch <id> --text-out t.txt   # verbatim transcript to a file
+otter-axi fetch <id> --json-out t.json  # parsed segments [{start,speaker,text}]
+otter-axi fetch <id> --csv-out t.csv    # parsed segments as CSV  (--tsv-out for TSV)
+```
+
+The segment formats (`--json-out`/`--csv-out`/`--tsv-out`) parse the `[H:MM:SS] Speaker N: …`
+transcript into `{start, speaker, text}` rows — otter-axi owns one tested, lossless parser so
+agents don't re-derive it. Verbatim text stays the default; the parse never drops content.
+
+## Commands
+
+| Command | Purpose |
+|---|---|
+| `otter-axi` | Content-first home / session status |
+| `auth login [--no-wait\|--wait]` | One-time OAuth; `--no-wait`/`--wait` for agent relay |
+| `auth status [--offline]` | Show the connected account |
+| `auth logout` | Revoke + clear stored tokens |
+| `search [query…] [flags]` | Find/browse meetings (metadata only) |
+| `fetch <id\|url> [--full\|--text-out\|--json-out\|--csv-out\|--tsv-out]` | Pull a transcript (verbatim or parsed segments) |
+| `doctor` | Tiered connectivity diagnostics |
+| `setup hooks` | Install the SessionStart hook (Claude Code / Codex / OpenCode) |
+
+## Development
+
+Built on `axi-sdk-js` + `@toon-format/toon` + `@modelcontextprotocol/sdk`, TypeScript/ESM,
+bun for dev, `tsc`→node to ship.
+
+```sh
+bun install
+bun run dev <command>   # run from source
+bun run test            # vitest
+bun run build           # tsc → dist/
+```
+
+Spec-driven: `specs/` is the source of truth, `plans/` tracks the work that built it. See
+[`specs/README.md`](specs/README.md).
+
+## License
+
+MIT

package/dist/bin/otter-axi.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/dist/bin/otter-axi.js

@@ -0,0 +1,4 @@
+#!/usr/bin/env node
+import { main } from "../src/cli.js";
+main();
+//# sourceMappingURL=otter-axi.js.map

package/dist/bin/otter-axi.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"otter-axi.js","sourceRoot":"","sources":["../../bin/otter-axi.ts"],"names":[],"mappings":";AACA,OAAO,EAAE,IAAI,EAAE,MAAM,eAAe,CAAC;AAErC,IAAI,EAAE,CAAC"}

package/dist/src/cli.d.ts

@@ -0,0 +1,5 @@
+import { type AxiCliOptions } from "axi-sdk-js";
+export declare const TOP_HELP = "usage: otter-axi [command] [args] [flags]\ncommands[6]:\n  (none)=home, auth, doctor, setup, search, fetch\nflags:\n  --help, -v/--version\nexamples:\n  otter-axi auth login\n  otter-axi search \"roadmap review\" --after 30d\n  otter-axi search --after 2026/05/01 --before 2026/05/07\n  otter-axi fetch aBcDeFgHiJkLmNoPqRsTuVwXyZ0\n  otter-axi --help\n  otter-axi search --help\n";
+/** Build the CLI options. Overrides (e.g. `argv`, `stdout`) let tests drive dispatch. */
+export declare function cliOptions(overrides?: Partial<AxiCliOptions>): AxiCliOptions;
+export declare function main(): Promise<void>;

package/dist/src/cli.js

@@ -0,0 +1,50 @@
+import { runAxiCli } from "axi-sdk-js";
+import { DESCRIPTION, readVersion } from "./meta.js";
+import { homeCommand } from "./commands/home.js";
+import { authCommand, AUTH_HELP } from "./commands/auth.js";
+import { doctorCommand, DOCTOR_HELP } from "./commands/doctor.js";
+import { setupCommand, SETUP_HELP } from "./commands/setup.js";
+import { searchCommand, SEARCH_HELP } from "./commands/search.js";
+import { fetchCommand, FETCH_HELP } from "./commands/fetch.js";
+export const TOP_HELP = `usage: otter-axi [command] [args] [flags]
+commands[6]:
+  (none)=home, auth, doctor, setup, search, fetch
+flags:
+  --help, -v/--version
+examples:
+  otter-axi auth login
+  otter-axi search "roadmap review" --after 30d
+  otter-axi search --after 2026/05/01 --before 2026/05/07
+  otter-axi fetch aBcDeFgHiJkLmNoPqRsTuVwXyZ0
+  otter-axi --help
+  otter-axi search --help
+`;
+const COMMAND_HELP = {
+    auth: AUTH_HELP,
+    doctor: DOCTOR_HELP,
+    setup: SETUP_HELP,
+    search: SEARCH_HELP,
+    fetch: FETCH_HELP,
+};
+/** Build the CLI options. Overrides (e.g. `argv`, `stdout`) let tests drive dispatch. */
+export function cliOptions(overrides = {}) {
+    return {
+        description: DESCRIPTION,
+        version: readVersion(),
+        topLevelHelp: TOP_HELP,
+        home: () => homeCommand(),
+        commands: {
+            auth: (args) => authCommand(args),
+            doctor: (args) => doctorCommand(args),
+            setup: (args) => setupCommand(args),
+            search: (args) => searchCommand(args),
+            fetch: (args) => fetchCommand(args),
+        },
+        getCommandHelp: (command) => COMMAND_HELP[command],
+        ...overrides,
+    };
+}
+export async function main() {
+    await runAxiCli(cliOptions());
+}
+//# sourceMappingURL=cli.js.map

package/dist/src/cli.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../../src/cli.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAsB,MAAM,YAAY,CAAC;AAC3D,OAAO,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AACrD,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACjD,OAAO,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAC5D,OAAO,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAClE,OAAO,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAC/D,OAAO,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAClE,OAAO,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAE/D,MAAM,CAAC,MAAM,QAAQ,GAAG;;;;;;;;;;;;CAYvB,CAAC;AAEF,MAAM,YAAY,GAA2B;IAC3C,IAAI,EAAE,SAAS;IACf,MAAM,EAAE,WAAW;IACnB,KAAK,EAAE,UAAU;IACjB,MAAM,EAAE,WAAW;IACnB,KAAK,EAAE,UAAU;CAClB,CAAC;AAEF,yFAAyF;AACzF,MAAM,UAAU,UAAU,CACxB,YAAoC,EAAE;IAEtC,OAAO;QACL,WAAW,EAAE,WAAW;QACxB,OAAO,EAAE,WAAW,EAAE;QACtB,YAAY,EAAE,QAAQ;QACtB,IAAI,EAAE,GAAG,EAAE,CAAC,WAAW,EAAE;QACzB,QAAQ,EAAE;YACR,IAAI,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,WAAW,CAAC,IAAI,CAAC;YACjC,MAAM,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,aAAa,CAAC,IAAI,CAAC;YACrC,KAAK,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,YAAY,CAAC,IAAI,CAAC;YACnC,MAAM,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,aAAa,CAAC,IAAI,CAAC;YACrC,KAAK,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,YAAY,CAAC,IAAI,CAAC;SACpC;QACD,cAAc,EAAE,CAAC,OAAO,EAAE,EAAE,CAAC,YAAY,CAAC,OAAO,CAAC;QAClD,GAAG,SAAS;KACb,CAAC;AACJ,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,IAAI;IACxB,MAAM,SAAS,CAAC,UAAU,EAAE,CAAC,CAAC;AAChC,CAAC"}

package/dist/src/commands/auth.d.ts

@@ -0,0 +1,3 @@
+import type { StructuredOutput } from "../output.js";
+export declare const AUTH_HELP = "usage: otter-axi auth <login|status|logout> [flags]\nsubcommands:\n  login            one-time browser approval; stores refreshable OAuth tokens\n    --no-wait      prepare only: print the authorize URL and return immediately\n    --wait         bind the loopback and block for the callback (pairs with --no-wait)\n  status           show the connected account (--offline to skip the live probe)\n  logout           revoke and clear stored tokens\nnotes:\n  Default `login` opens your browser and blocks (~5 min) until you approve.\n  Agents: run `auth login --no-wait` to get the URL, relay it, then `auth login\n  --wait` in a separate turn. Authorization codes are short-lived \u2014 approve promptly.";
+export declare function authCommand(args: string[]): Promise<StructuredOutput>;

package/dist/src/commands/auth.js

@@ -0,0 +1,144 @@
+import { spawn } from "node:child_process";
+import { AxiError } from "axi-sdk-js";
+import { parseArgs, hasFlag } from "../flags.js";
+import { clearPending, clearTokens, isLoggedIn, readConfig, readPending, writeConfig, } from "../config.js";
+import { getUser } from "../otter/client.js";
+import { completeLogin, LOOPBACK_PORTS, prepareLogin, revokeToken, } from "../otter/oauth.js";
+import { pickPort, startLoopback } from "../otter/loopback.js";
+export const AUTH_HELP = `usage: otter-axi auth <login|status|logout> [flags]
+subcommands:
+  login            one-time browser approval; stores refreshable OAuth tokens
+    --no-wait      prepare only: print the authorize URL and return immediately
+    --wait         bind the loopback and block for the callback (pairs with --no-wait)
+  status           show the connected account (--offline to skip the live probe)
+  logout           revoke and clear stored tokens
+notes:
+  Default \`login\` opens your browser and blocks (~5 min) until you approve.
+  Agents: run \`auth login --no-wait\` to get the URL, relay it, then \`auth login
+  --wait\` in a separate turn. Authorization codes are short-lived — approve promptly.`;
+const SUBCOMMANDS = new Set(["login", "status", "logout"]);
+function openBrowser(url) {
+    const cmd = process.platform === "darwin"
+        ? "open"
+        : process.platform === "win32"
+            ? "start"
+            : "xdg-open";
+    try {
+        spawn(cmd, [url], { stdio: "ignore", detached: true }).unref();
+    }
+    catch {
+        // best-effort; the URL is also printed to stderr
+    }
+}
+async function cacheProfile() {
+    const u = await getUser();
+    writeConfig({
+        ...readConfig(),
+        user: { name: u.name, email: u.email, cached_at: new Date().toISOString() },
+    });
+    return u;
+}
+async function bindWaitComplete(port) {
+    const lb = await startLoopback(port);
+    try {
+        const code = await lb.waitForCode(300_000);
+        await completeLogin(code);
+        const u = await cacheProfile();
+        return {
+            status: "logged in",
+            account: u.email ?? u.name ?? "connected",
+            help: [
+                'Run `otter-axi search "<query>" --after 30d` to find meetings',
+                "Run `otter-axi fetch <id>` to pull a transcript",
+            ],
+        };
+    }
+    finally {
+        lb.close();
+    }
+}
+async function login(args) {
+    const parsed = parseArgs(args);
+    const noWait = hasFlag(parsed, "no-wait");
+    const waitOnly = hasFlag(parsed, "wait");
+    if (waitOnly) {
+        const pending = readPending();
+        if (!pending) {
+            throw new AxiError("No pending login to wait on", "AUTH", [
+                "Run `otter-axi auth login --no-wait` first",
+            ]);
+        }
+        return await bindWaitComplete(pending.port);
+    }
+    const port = await pickPort(LOOPBACK_PORTS);
+    const { url } = await prepareLogin(port);
+    if (noWait) {
+        return {
+            action: "authorize",
+            url,
+            help: [
+                "Open the URL above, sign in to Otter, and click Authorize access",
+                "Then run `otter-axi auth login --wait` (within ~5 min) to capture the redirect",
+            ],
+        };
+    }
+    process.stderr.write(`\nAuthorize otter-axi in your browser:\n${url}\n\n`);
+    openBrowser(url);
+    return await bindWaitComplete(port);
+}
+async function status(args) {
+    const parsed = parseArgs(args);
+    const offline = hasFlag(parsed, "offline");
+    const cfg = readConfig();
+    if (!isLoggedIn(cfg)) {
+        process.exitCode = 1;
+        return {
+            status: "not logged in",
+            help: ["Run `otter-axi auth login` to connect your Otter account"],
+        };
+    }
+    const account = cfg.user?.email ?? cfg.user?.name ?? "unknown";
+    if (offline)
+        return { status: "logged in", account, token: "not probed (--offline)" };
+    try {
+        const u = await getUser();
+        writeConfig({
+            ...readConfig(),
+            user: { name: u.name, email: u.email, cached_at: new Date().toISOString() },
+        });
+        return { status: "logged in", account: u.email ?? u.name ?? account, token: "valid" };
+    }
+    catch {
+        process.exitCode = 1;
+        return {
+            status: "logged in",
+            account,
+            token: "invalid",
+            help: ["Run `otter-axi auth login` to re-authenticate"],
+        };
+    }
+}
+async function logout() {
+    const cfg = readConfig();
+    clearPending();
+    if (!isLoggedIn(cfg))
+        return { status: "already logged out" };
+    await revokeToken();
+    // Keep the registered client_id so re-login skips DCR; drop tokens + cached profile.
+    const { user: _user, ...rest } = clearTokens(cfg);
+    writeConfig(rest);
+    return { status: "logged out" };
+}
+export async function authCommand(args) {
+    const sub = args[0];
+    if (sub === undefined || !SUBCOMMANDS.has(sub)) {
+        throw new AxiError(sub ? `Unknown auth subcommand: ${sub}` : "Missing auth subcommand", "VALIDATION_ERROR", ["Run `otter-axi auth login`", "Run `otter-axi auth --help`"]);
+    }
+    const rest = args.slice(1);
+    if (sub === "login")
+        return await login(rest);
+    if (sub === "status")
+        return await status(rest);
+    return await logout();
+}
+//# sourceMappingURL=auth.js.map

package/dist/src/commands/auth.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"auth.js","sourceRoot":"","sources":["../../../src/commands/auth.ts"],"names":[],"mappings":"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"}

package/dist/src/commands/doctor.d.ts

@@ -0,0 +1,3 @@
+import type { StructuredOutput } from "../output.js";
+export declare const DOCTOR_HELP = "usage: otter-axi doctor\nchecks (tiered):\n  config present \u2192 credentials stored \u2192 token valid / Otter MCP reachable\nexit:\n  0 when authenticated and reachable; 1 on a hard failure";
+export declare function doctorCommand(_args: string[]): Promise<StructuredOutput>;

package/dist/src/commands/doctor.js

@@ -0,0 +1,47 @@
+import { configPath, isLoggedIn, readConfig } from "../config.js";
+import { getUser } from "../otter/client.js";
+export const DOCTOR_HELP = `usage: otter-axi doctor
+checks (tiered):
+  config present → credentials stored → token valid / Otter MCP reachable
+exit:
+  0 when authenticated and reachable; 1 on a hard failure`;
+export async function doctorCommand(_args) {
+    const cfg = readConfig();
+    const checks = [{ name: "config", status: "ok", detail: configPath() }];
+    if (!isLoggedIn(cfg)) {
+        process.exitCode = 1;
+        checks.push({ name: "credentials", status: "fail", detail: "no credentials stored" });
+        return { checks, help: ["Run `otter-axi auth login` to connect your Otter account"] };
+    }
+    checks.push({
+        name: "credentials",
+        status: "ok",
+        detail: `stored for ${cfg.user?.email ?? cfg.user?.name ?? "account"}`,
+    });
+    try {
+        const u = await getUser();
+        checks.push({
+            name: "mcp",
+            status: "ok",
+            detail: `reachable; authenticated as ${u.email ?? u.name ?? "user"}`,
+        });
+        return { checks };
+    }
+    catch (e) {
+        process.exitCode = 1;
+        const err = e;
+        const authProblem = err.code === "AUTH";
+        checks.push({
+            name: authProblem ? "token" : "mcp",
+            status: "fail",
+            detail: err.message,
+        });
+        return {
+            checks,
+            help: authProblem
+                ? ["Run `otter-axi auth login` to re-authenticate"]
+                : ["Check connectivity to https://mcp.otter.ai and retry"],
+        };
+    }
+}
+//# sourceMappingURL=doctor.js.map

package/dist/src/commands/doctor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"doctor.js","sourceRoot":"","sources":["../../../src/commands/doctor.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAClE,OAAO,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAG7C,MAAM,CAAC,MAAM,WAAW,GAAG;;;;0DAI+B,CAAC;AAQ3D,MAAM,CAAC,KAAK,UAAU,aAAa,CAAC,KAAe;IACjD,MAAM,GAAG,GAAG,UAAU,EAAE,CAAC;IACzB,MAAM,MAAM,GAAY,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,UAAU,EAAE,EAAE,CAAC,CAAC;IAEjF,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;QACrB,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAC;QACrB,MAAM,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,aAAa,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,uBAAuB,EAAE,CAAC,CAAC;QACtF,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,0DAA0D,CAAC,EAAE,CAAC;IACxF,CAAC;IACD,MAAM,CAAC,IAAI,CAAC;QACV,IAAI,EAAE,aAAa;QACnB,MAAM,EAAE,IAAI;QACZ,MAAM,EAAE,cAAc,GAAG,CAAC,IAAI,EAAE,KAAK,IAAI,GAAG,CAAC,IAAI,EAAE,IAAI,IAAI,SAAS,EAAE;KACvE,CAAC,CAAC;IAEH,IAAI,CAAC;QACH,MAAM,CAAC,GAAG,MAAM,OAAO,EAAE,CAAC;QAC1B,MAAM,CAAC,IAAI,CAAC;YACV,IAAI,EAAE,KAAK;YACX,MAAM,EAAE,IAAI;YACZ,MAAM,EAAE,+BAA+B,CAAC,CAAC,KAAK,IAAI,CAAC,CAAC,IAAI,IAAI,MAAM,EAAE;SACrE,CAAC,CAAC;QACH,OAAO,EAAE,MAAM,EAAE,CAAC;IACpB,CAAC;IAAC,OAAO,CAAC,EAAE,CAAC;QACX,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAC;QACrB,MAAM,GAAG,GAAG,CAAa,CAAC;QAC1B,MAAM,WAAW,GAAG,GAAG,CAAC,IAAI,KAAK,MAAM,CAAC;QACxC,MAAM,CAAC,IAAI,CAAC;YACV,IAAI,EAAE,WAAW,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,KAAK;YACnC,MAAM,EAAE,MAAM;YACd,MAAM,EAAE,GAAG,CAAC,OAAO;SACpB,CAAC,CAAC;QACH,OAAO;YACL,MAAM;YACN,IAAI,EAAE,WAAW;gBACf,CAAC,CAAC,CAAC,+CAA+C,CAAC;gBACnD,CAAC,CAAC,CAAC,sDAAsD,CAAC;SAC7D,CAAC;IACJ,CAAC;AACH,CAAC"}

package/dist/src/commands/fetch.d.ts

@@ -0,0 +1,5 @@
+import type { StructuredOutput } from "../output.js";
+export declare const FETCH_HELP = "usage: otter-axi fetch <id|url> [output-mode]\nargs:\n  <id|url>          conversation slug or an https://otter.ai/u/<id> URL\noutput modes (at most one; default is a preview):\n  --full            print the entire verbatim transcript to stdout (for piping)\n  --text-out <path> write the verbatim transcript text to a file (alias: --out)\n  --json-out <path> write parsed segments [{start,speaker,text}] as JSON\n  --csv-out <path>  write parsed segments as CSV (start,speaker,text)\n  --tsv-out <path>  write parsed segments as TSV\nnotes:\n  otter-axi owns the transcript parse; segment formats are lossless on content.";
+/** Normalize a conversation slug or otter.ai URL to a bare id. */
+export declare function normalizeConversationId(input: string): string;
+export declare function fetchCommand(args: string[]): Promise<StructuredOutput | string>;

package/dist/src/commands/fetch.js

@@ -0,0 +1,132 @@
+import { writeFileSync } from "node:fs";
+import { Buffer } from "node:buffer";
+import { AxiError } from "axi-sdk-js";
+import { hasFlag, parseArgs, strFlag } from "../flags.js";
+import { fetchTranscript } from "../otter/client.js";
+import { truncateCell } from "../output.js";
+import { parseTranscript, segmentsToCsv, segmentsToTsv, } from "../transcript.js";
+export const FETCH_HELP = `usage: otter-axi fetch <id|url> [output-mode]
+args:
+  <id|url>          conversation slug or an https://otter.ai/u/<id> URL
+output modes (at most one; default is a preview):
+  --full            print the entire verbatim transcript to stdout (for piping)
+  --text-out <path> write the verbatim transcript text to a file (alias: --out)
+  --json-out <path> write parsed segments [{start,speaker,text}] as JSON
+  --csv-out <path>  write parsed segments as CSV (start,speaker,text)
+  --tsv-out <path>  write parsed segments as TSV
+notes:
+  otter-axi owns the transcript parse; segment formats are lossless on content.`;
+const VALUED = ["out", "text-out", "json-out", "csv-out", "tsv-out"];
+const PREVIEW_CHARS = 1200;
+/** Normalize a conversation slug or otter.ai URL to a bare id. */
+export function normalizeConversationId(input) {
+    const trimmed = input.trim();
+    const match = trimmed.match(/otter\.ai\/u\/([^/?#]+)/i);
+    return match ? match[1] : trimmed;
+}
+function outPath(parsed, flag) {
+    if (!hasFlag(parsed, flag))
+        return undefined;
+    const p = strFlag(parsed, flag);
+    if (!p) {
+        throw new AxiError(`--${flag} needs a file path`, "VALIDATION_ERROR", [
+            `Run \`otter-axi fetch <id> --${flag} <path>\``,
+        ]);
+    }
+    return p;
+}
+export async function fetchCommand(args) {
+    const parsed = parseArgs(args, { valued: VALUED });
+    const raw = parsed.positionals[0];
+    if (!raw) {
+        throw new AxiError("Missing conversation id or URL", "VALIDATION_ERROR", [
+            "Run `otter-axi fetch <id|url>`",
+            "Run `otter-axi search …` to find an id",
+        ]);
+    }
+    const id = normalizeConversationId(raw);
+    const textPath = outPath(parsed, "text-out") ?? outPath(parsed, "out");
+    const jsonPath = outPath(parsed, "json-out");
+    const csvPath = outPath(parsed, "csv-out");
+    const tsvPath = outPath(parsed, "tsv-out");
+    const full = hasFlag(parsed, "full");
+    const modeCount = [textPath, jsonPath, csvPath, tsvPath].filter((p) => p !== undefined).length +
+        (full ? 1 : 0);
+    if (modeCount > 1) {
+        throw new AxiError("Choose a single output mode", "VALIDATION_ERROR", [
+            "Use one of --full | --text-out | --json-out | --csv-out | --tsv-out",
+        ]);
+    }
+    let t;
+    try {
+        t = await fetchTranscript(id);
+    }
+    catch (e) {
+        const err = e;
+        throw new AxiError(err.message, err.code ?? "UPSTREAM", [
+            ...(err.suggestions ?? []),
+            `Run \`otter-axi search …\` to find a valid id (checked: ${id})`,
+        ]);
+    }
+    const text = t.text ?? "";
+    const meta = {
+        id: t.id ?? id,
+        title: t.title ?? "",
+        url: t.url ?? `https://otter.ai/u/${t.id ?? id}`,
+        start: (t.metadata?.start_time ?? "").slice(0, 10),
+        dur: t.metadata?.duration ?? "—",
+        summary: t.metadata?.short_summary ?? "",
+        action_items: Array.isArray(t.metadata?.action_items)
+            ? t.metadata.action_items.length
+            : 0,
+    };
+    // Verbatim text → file (byte-exact, no parsing).
+    if (textPath) {
+        writeFileSync(textPath, text);
+        return { ...meta, format: "text", saved: textPath, bytes: Buffer.byteLength(text) };
+    }
+    // Parsed segment formats → file.
+    if (jsonPath || csvPath || tsvPath) {
+        const segments = parseTranscript(text);
+        const speakers = [...new Set(segments.map((s) => s.speaker).filter(Boolean))];
+        let body;
+        let path;
+        let format;
+        if (jsonPath) {
+            body = `${JSON.stringify(segments, null, 2)}\n`;
+            path = jsonPath;
+            format = "json";
+        }
+        else if (csvPath) {
+            body = segmentsToCsv(segments);
+            path = csvPath;
+            format = "csv";
+        }
+        else {
+            body = segmentsToTsv(segments);
+            path = tsvPath;
+            format = "tsv";
+        }
+        writeFileSync(path, body);
+        return {
+            ...meta,
+            format,
+            saved: path,
+            bytes: Buffer.byteLength(body),
+            segments: segments.length,
+            speakers,
+        };
+    }
+    // Raw transcript to stdout for piping — return a string so the SDK passes it through as-is.
+    if (full)
+        return text;
+    return {
+        ...meta,
+        chars: text.length,
+        preview: truncateCell(text, PREVIEW_CHARS),
+        help: [
+            "Pass --text-out/--json-out/--csv-out/--tsv-out <path> to export, or --full to print all",
+        ],
+    };
+}
+//# sourceMappingURL=fetch.js.map

package/dist/src/commands/fetch.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fetch.js","sourceRoot":"","sources":["../../../src/commands/fetch.ts"],"names":[],"mappings":"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"}

package/dist/src/commands/home.d.ts

@@ -0,0 +1,7 @@
+import type { StructuredOutput } from "../output.js";
+/**
+ * Content-first home view; doubles as the SessionStart payload. Must never throw and must
+ * not block on the network (live state lands in plan 04). Degrades to onboarding when no
+ * credentials are stored.
+ */
+export declare function homeCommand(): Promise<StructuredOutput>;

package/dist/src/commands/home.js

@@ -0,0 +1,28 @@
+import { isLoggedIn, readConfig } from "../config.js";
+/**
+ * Content-first home view; doubles as the SessionStart payload. Must never throw and must
+ * not block on the network (live state lands in plan 04). Degrades to onboarding when no
+ * credentials are stored.
+ */
+export async function homeCommand() {
+    const cfg = readConfig();
+    if (!isLoggedIn(cfg)) {
+        return {
+            status: "not logged in",
+            help: [
+                "Run `otter-axi auth login` to connect your Otter account (one-time browser approval)",
+            ],
+        };
+    }
+    const account = cfg.user?.email ?? cfg.user?.name ?? "connected";
+    return {
+        status: "logged in",
+        account,
+        help: [
+            'Run `otter-axi search "<query>" --after 30d` to find meetings',
+            "Run `otter-axi search --after 2026/05/01 --before 2026/05/07` to browse a date range",
+            "Run `otter-axi fetch <id>` to pull a transcript",
+        ],
+    };
+}
+//# sourceMappingURL=home.js.map

package/dist/src/commands/home.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"home.js","sourceRoot":"","sources":["../../../src/commands/home.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAGtD;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,WAAW;IAC/B,MAAM,GAAG,GAAG,UAAU,EAAE,CAAC;IAEzB,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;QACrB,OAAO;YACL,MAAM,EAAE,eAAe;YACvB,IAAI,EAAE;gBACJ,sFAAsF;aACvF;SACF,CAAC;IACJ,CAAC;IAED,MAAM,OAAO,GAAG,GAAG,CAAC,IAAI,EAAE,KAAK,IAAI,GAAG,CAAC,IAAI,EAAE,IAAI,IAAI,WAAW,CAAC;IACjE,OAAO;QACL,MAAM,EAAE,WAAW;QACnB,OAAO;QACP,IAAI,EAAE;YACJ,+DAA+D;YAC/D,sFAAsF;YACtF,iDAAiD;SAClD;KACF,CAAC;AACJ,CAAC"}

package/dist/src/commands/search.d.ts

@@ -0,0 +1,3 @@
+import type { StructuredOutput } from "../output.js";
+export declare const SEARCH_HELP = "usage: otter-axi search [query...] [flags]\nflags:\n  -q, --query <str>        keyword/semantic query (or pass positionally; may be empty)\n  --after <date>           created on/after \u2014 ISO (2026-05-01) or relative (7d, 30d)\n  --before <date>          created on/before \u2014 same formats\n  --title-contains <str>   space-separated keywords matched against the title\n  --in-transcript <str>    comma-separated keywords searched within transcripts\n  --attended-by <name>     comma-separated attendee names (not emails)\n  --channel <name>         comma-separated channel name(s) to search within\n  --folder <name>          comma-separated folder name(s) to search within\n  --mine                   restrict to your own meetings (exclude shared)\n  --limit <n>              cap rows shown (default 20)\n  --full                   show all rows, untruncated\nnotes:\n  empty query + a date range is browse mode \u2014 list meetings in a window";
+export declare function searchCommand(args: string[]): Promise<StructuredOutput>;