@otto-code/protocol 0.7.5 → 0.8.0

package/dist/default-personalities.js

@@ -1,6 +1,6 @@
 // The starter "team" of Agent Personalities shipped with Otto. These seed a
 // fresh host so a new user sees a working, role-complete roster instead of an
-// empty editor — and can be re-added on demand from the settings "Restore
+// empty editor - and can be re-added on demand from the settings "Restore
 // starter team" button. Both the daemon (first-run seeding) and the app (the
 // restore button) import this one list so the shipped set stays identical on
 // both sides.
@@ -12,17 +12,17 @@
 //  - Every one of the 11 roles is covered; some personalities are multi-role to
 //    show that a single template can serve several lanes. Sage is the team's
 //    read-only thinker (advisor + researcher + planner); Pixel both an artificer
-//    and a designer. Dash is the Writer (fast, cheap small-text generation —
+//    and a designer. Dash is the Writer (fast, cheap small-text generation -
 //    commit messages, summaries, branch names) and Sprocket is the Coder
 //    (methodical sub-agent building work); the two together are the heirs of the
 //    retired "worker" role. Atlas is the sole conductor (orchestrator).
-//  - Models are Anthropic (Claude Code) — the assumption for launch. On a host
+//  - Models are Anthropic (Claude Code) - the assumption for launch. On a host
 //    without Claude these simply show as "out of commission" until a matching
 //    provider exists; nothing breaks.
 //  - Model choice follows cost/fit: Opus for low-volume, high-stakes reasoning
 //    (orchestration, advice); Sonnet for everyday building and review; Haiku for
 //    fast, cheap, high-volume / recurring unattended work.
-//  - Voices are Kokoro v1.0 (kokoro-multi-lang-v1_0) names — a SOFT binding. On a
+//  - Voices are Kokoro v1.0 (kokoro-multi-lang-v1_0) names - a SOFT binding. On a
 //    host running OpenAI TTS or the older Kokoro v0.19 they degrade to the host
 //    default at playback time; the user never has to fix them.
 //  - Spinner colors are two-hex glow pairs chosen to match each personality's
@@ -58,11 +58,11 @@ export const DEFAULT_AGENT_PERSONALITIES = [
         respectGlobalAppendPrompt: true,
         roles: ["advisor", "researcher", "planner"],
         personalityPrompt: "You are Sage, the team's read-only thinker: you research, you plan, and you advise, but " +
-            "you never change code. Asked to survey, map what actually exists — the files, types, " +
-            "patterns, and gotchas — and report facts, not solutions. Asked to plan, turn the goal " +
+            "you never change code. Asked to survey, map what actually exists - the files, types, " +
+            "patterns, and gotchas - and report facts, not solutions. Asked to plan, turn the goal " +
             "into a clear, sequenced set of steps a team could execute. Asked to advise, weigh the " +
             "real trade-offs, surface the risk others miss, and give the one option you would take and " +
-            "why — a recommendation, not a menu.",
+            "why - a recommendation, not a menu.",
         spinner: { glowA: "#14B8A6", glowB: "#8B5CF6" },
         voice: kokoroVoice("af_heart"),
     },
@@ -92,7 +92,7 @@ export const DEFAULT_AGENT_PERSONALITIES = [
         respectGlobalAppendPrompt: true,
         roles: ["artificer", "designer"],
         personalityPrompt: "You are Pixel, a maker of polished things. You build artifacts and interfaces that " +
-            "feel intentional — real hierarchy, deliberate spacing, no templated defaults. Sweat " +
+            "feel intentional - real hierarchy, deliberate spacing, no templated defaults. Sweat " +
             "the small stuff, prefer a clean version that ships over a clever one that doesn't, and " +
             "show your work rather than describe it.",
         spinner: { glowA: "#EC4899", glowB: "#06B6D4" },
@@ -108,7 +108,7 @@ export const DEFAULT_AGENT_PERSONALITIES = [
         respectGlobalAppendPrompt: true,
         roles: ["writer", "scheduler"],
         personalityPrompt: "You are Dash, the workhorse scribe. You turn diffs, context, and recurring jobs into " +
-            "crisp short text — commit messages, summaries, branch names, titles — fast and cheaply, " +
+            "crisp short text - commit messages, summaries, branch names, titles - fast and cheaply, " +
             "without ceremony. Say exactly what changed in as few words as it takes, match the house " +
             "style you're given, never pad, and never editorialize beyond the facts in front of you.",
         spinner: { glowA: "#22C55E", glowB: "#A3E635" },
@@ -123,7 +123,7 @@ export const DEFAULT_AGENT_PERSONALITIES = [
         modeId: "default",
         respectGlobalAppendPrompt: true,
         roles: ["chatter", "coder"],
-        personalityPrompt: "You are Sprocket, a friendly machine. You are precise, literal, and methodical — you " +
+        personalityPrompt: "You are Sprocket, a friendly machine. You are precise, literal, and methodical - you " +
             "like checklists, exact steps, and confirming inputs before acting. Keep a light, dry " +
             "wit, explain what you're doing in plain terms, and when a request is ambiguous ask one " +
             "sharp clarifying question rather than guessing. Beep.",
@@ -134,7 +134,7 @@ export const DEFAULT_AGENT_PERSONALITIES = [
 // The starter Agent Team shipped with Otto: every starter personality grouped
 // under one operating template. Seeded the same first-run/absent-section way
 // as the personalities (see seedDefaultTeamsIfAbsent), and re-addable from the
-// Agent teams card. Deliberately NOT active on first run — activating a
+// Agent teams card. Deliberately NOT active on first run - activating a
 // prompt-bearing team silently on install would change spawn behavior out
 // from under existing users; the user opts in via the Active Team switcher.
 // The stable `team_builtin_*` id makes restore idempotent, exactly like the

package/dist/effort.d.ts

@@ -20,7 +20,7 @@ export interface ResolvedEffortOption {
     matched: "exact-id" | "level" | "nearest";
 }
 /**
- * Resolve a requested effort — an exact option id or a canonical level —
+ * Resolve a requested effort - an exact option id or a canonical level -
  * against a model's advertised `thinkingOptions`. Exact ids always win, so
  * provider-special options (e.g. Claude's "ultracode") stay reachable even
  * though they have no place on the canonical scale.

package/dist/effort.js

@@ -52,7 +52,7 @@ export class EffortResolutionError extends Error {
     }
 }
 /**
- * Resolve a requested effort — an exact option id or a canonical level —
+ * Resolve a requested effort - an exact option id or a canonical level -
  * against a model's advertised `thinkingOptions`. Exact ids always win, so
  * provider-special options (e.g. Claude's "ultracode") stay reachable even
  * though they have no place on the canonical scale.
@@ -88,7 +88,7 @@ export function resolveEffortOption(input) {
     }
     if (best === null) {
         // None of the model's options map onto the canonical scale (fully custom
-        // option ids) — only exact ids can address them.
+        // option ids) - only exact ids can address them.
         throw new EffortResolutionError(requested, availableIds);
     }
     return {

package/dist/forge-manifest.d.ts

@@ -0,0 +1,66 @@
+/**
+ * Declarative manifest of the git forges Otto knows how to present, mirroring
+ * provider-manifest.ts. Pure build-time data shared by BOTH the client (icon,
+ * brand label, PR↔MR relabel) and the server (registry host-matching, prompt
+ * branding). It is NEVER serialized over the wire, so adding a forge here is not
+ * a protocol change.
+ *
+ * Keep this a pure leaf: no imports, no zod, no functions with runtime deps.
+ * Behavioural concerns (CLI invocation, host probing, REST adapters) live in the
+ * server adapter keyed by {@link ForgeDefinition.id}; this file is only the
+ * declarative half.
+ */
+/**
+ * Declarative sign-in recipe for a forge. The client renders install/sign-in
+ * hints from this data alone - no per-CLI switch - so a new forge wires its auth
+ * UX entirely from the manifest. Behavioural auth (the actual host probe) stays
+ * in the server adapter; this is only what the user is told to run.
+ */
+export interface ForgeSignInCommand {
+    /** Binary the user installs, e.g. "gh" - shown in the install-CLI hint. */
+    cli: string;
+    /** Full sign-in command, e.g. "gh auth login". */
+    command: string;
+    /**
+     * Flag that targets a self-hosted host, e.g. "--hostname". When present and a
+     * host is known, the client appends `${command} ${hostnameFlag} ${host}`.
+     * Omit when the command already targets the right host on its own.
+     */
+    hostnameFlag?: string;
+}
+export interface ForgeDefinition {
+    /** Registry id, matches the server adapter and the wire `forge` value. */
+    id: string;
+    /** Human brand name, e.g. for "Open on GitLab". */
+    displayName: string;
+    /** Short change-request noun: "PR" for GitHub, "MR" for GitLab. */
+    changeRequestAbbrev: string;
+    /** Full change-request noun: "pull request" vs "merge request". */
+    changeRequestNoun: string;
+    /** Prefix before a change-request number: "#" vs "!". */
+    changeRequestNumberPrefix: string;
+    /** Prefix before an issue number ("#" on every forge so far). */
+    issueNumberPrefix: string;
+    /** Icon key; the client falls back to a generic git icon for unknown values. */
+    iconKind: string;
+    /** Sign-in recipe, or null when the forge has no Otto-driven sign-in. */
+    signIn: ForgeSignInCommand | null;
+    /**
+     * Public cloud hosts this forge owns exactly. A BOUNDED list, never an
+     * allowlist for self-hosted detection - self-hosted/Enterprise instances are
+     * recognized at runtime by the adapter's host probe, not by this field.
+     */
+    cloudHosts?: string[];
+}
+export declare const FORGE_DEFINITIONS: ForgeDefinition[];
+/** Forge definitions only present in dev builds (none today; mirrors providers). */
+export declare const DEV_FORGE_DEFINITIONS: ForgeDefinition[];
+export declare const FORGE_IDS: string[];
+export declare function getForgeDefinition(id: string, definitions?: ForgeDefinition[]): ForgeDefinition | null;
+/**
+ * Resolve a forge definition, synthesizing a neutral one for a forge id the
+ * client has never heard of (e.g. a self-hosted forge a newer daemon reports to
+ * an older client). The neutral shape renders generic, never GitHub-branded.
+ */
+export declare function getForgeDefinitionOrNeutral(id: string): ForgeDefinition;
+//# sourceMappingURL=forge-manifest.d.ts.map

package/dist/forge-manifest.js

@@ -0,0 +1,92 @@
+/**
+ * Declarative manifest of the git forges Otto knows how to present, mirroring
+ * provider-manifest.ts. Pure build-time data shared by BOTH the client (icon,
+ * brand label, PR↔MR relabel) and the server (registry host-matching, prompt
+ * branding). It is NEVER serialized over the wire, so adding a forge here is not
+ * a protocol change.
+ *
+ * Keep this a pure leaf: no imports, no zod, no functions with runtime deps.
+ * Behavioural concerns (CLI invocation, host probing, REST adapters) live in the
+ * server adapter keyed by {@link ForgeDefinition.id}; this file is only the
+ * declarative half.
+ */
+export const FORGE_DEFINITIONS = [
+    {
+        id: "github",
+        displayName: "GitHub",
+        changeRequestAbbrev: "PR",
+        changeRequestNoun: "pull request",
+        changeRequestNumberPrefix: "#",
+        issueNumberPrefix: "#",
+        iconKind: "github",
+        signIn: { cli: "gh", command: "gh auth login" },
+        cloudHosts: ["github.com", "ssh.github.com"],
+    },
+    {
+        id: "gitlab",
+        displayName: "GitLab",
+        changeRequestAbbrev: "MR",
+        changeRequestNoun: "merge request",
+        changeRequestNumberPrefix: "!",
+        issueNumberPrefix: "#",
+        iconKind: "gitlab",
+        signIn: { cli: "glab", command: "glab auth login", hostnameFlag: "--hostname" },
+        cloudHosts: ["gitlab.com"],
+    },
+    {
+        id: "gitea",
+        displayName: "Gitea",
+        changeRequestAbbrev: "PR",
+        changeRequestNoun: "pull request",
+        changeRequestNumberPrefix: "#",
+        issueNumberPrefix: "#",
+        iconKind: "gitea",
+        signIn: { cli: "tea", command: "tea login add" },
+        cloudHosts: ["gitea.com"],
+    },
+    {
+        id: "forgejo",
+        displayName: "Forgejo",
+        changeRequestAbbrev: "PR",
+        changeRequestNoun: "pull request",
+        changeRequestNumberPrefix: "#",
+        issueNumberPrefix: "#",
+        iconKind: "forgejo",
+        signIn: { cli: "tea", command: "tea login add" },
+    },
+    {
+        id: "codeberg",
+        displayName: "Codeberg",
+        changeRequestAbbrev: "PR",
+        changeRequestNoun: "pull request",
+        changeRequestNumberPrefix: "#",
+        issueNumberPrefix: "#",
+        iconKind: "codeberg",
+        signIn: { cli: "tea", command: "tea login add" },
+        cloudHosts: ["codeberg.org"],
+    },
+];
+/** Forge definitions only present in dev builds (none today; mirrors providers). */
+export const DEV_FORGE_DEFINITIONS = [];
+export const FORGE_IDS = FORGE_DEFINITIONS.map((definition) => definition.id);
+export function getForgeDefinition(id, definitions = [...FORGE_DEFINITIONS, ...DEV_FORGE_DEFINITIONS]) {
+    return definitions.find((definition) => definition.id === id) ?? null;
+}
+/**
+ * Resolve a forge definition, synthesizing a neutral one for a forge id the
+ * client has never heard of (e.g. a self-hosted forge a newer daemon reports to
+ * an older client). The neutral shape renders generic, never GitHub-branded.
+ */
+export function getForgeDefinitionOrNeutral(id) {
+    return (getForgeDefinition(id) ?? {
+        id,
+        displayName: id,
+        changeRequestAbbrev: "PR",
+        changeRequestNoun: "pull request",
+        changeRequestNumberPrefix: "#",
+        issueNumberPrefix: "#",
+        iconKind: "git",
+        signIn: null,
+    });
+}
+//# sourceMappingURL=forge-manifest.js.map