@getforgeai/protocol 0.1.0-beta.4 → 0.1.0-beta.5

package/dist/constants/known-models.d.ts

@@ -0,0 +1,25 @@
+import type { AgentType } from "./agent-type.js";
+export type KnownModelSuggestion = {
+    /** The id to declare (what the engine's model flag/config accepts). */
+    id: string;
+    /** Short human label for UI chips. */
+    label: string;
+    /** Optional availability caveat shown as a hint. */
+    note?: string;
+};
+/**
+ * Curated model suggestions for engines with NO headless listing command
+ * (Claude Code and Codex). OpenCode and Kilo have live catalogs
+ * (`opencode models` / `kilo models`) fetched from the device instead —
+ * see the models:catalog:request socket event.
+ *
+ * Claude Code ids are ALIASES on purpose: they resolve server-side to the
+ * current best version, so declared lists do not go stale, and demand/supply
+ * string-matching stays coherent when everyone uses the same spelling.
+ *
+ * Curated as of 2026-07; revisit when vendors ship new lineups.
+ */
+export declare const KNOWN_MODEL_SUGGESTIONS: Partial<Record<AgentType, KnownModelSuggestion[]>>;
+/** Engines whose catalog can be listed live from the device. */
+export declare const LIVE_CATALOG_ENGINES: readonly AgentType[];
+//# sourceMappingURL=known-models.d.ts.map

package/dist/constants/known-models.js

@@ -0,0 +1,42 @@
+/**
+ * Curated model suggestions for engines with NO headless listing command
+ * (Claude Code and Codex). OpenCode and Kilo have live catalogs
+ * (`opencode models` / `kilo models`) fetched from the device instead —
+ * see the models:catalog:request socket event.
+ *
+ * Claude Code ids are ALIASES on purpose: they resolve server-side to the
+ * current best version, so declared lists do not go stale, and demand/supply
+ * string-matching stays coherent when everyone uses the same spelling.
+ *
+ * Curated as of 2026-07; revisit when vendors ship new lineups.
+ */
+export const KNOWN_MODEL_SUGGESTIONS = {
+    CLAUDE_CODE: [
+        { id: "sonnet", label: "Sonnet" },
+        { id: "opus", label: "Opus", note: "Not available on the Pro plan" },
+        { id: "haiku", label: "Haiku" },
+        {
+            id: "fable",
+            label: "Fable",
+            note: "Requires organization access (server-gated)",
+        },
+        {
+            id: "sonnet[1m]",
+            label: "Sonnet 1M",
+            note: "1M context; usage credits on Pro",
+        },
+    ],
+    CODEX: [
+        { id: "gpt-5.5", label: "GPT-5.5", note: "Recommended default" },
+        { id: "gpt-5.4", label: "GPT-5.4" },
+        { id: "gpt-5.4-mini", label: "GPT-5.4 mini" },
+        { id: "gpt-5.6-sol", label: "GPT-5.6 Sol", note: "Entitlement-gated" },
+        { id: "gpt-5.6-terra", label: "GPT-5.6 Terra" },
+    ],
+};
+/** Engines whose catalog can be listed live from the device. */
+export const LIVE_CATALOG_ENGINES = [
+    "OPENCODE",
+    "KILO",
+];
+//# sourceMappingURL=known-models.js.map

package/dist/events/socket-events.d.ts

@@ -475,6 +475,18 @@ export type ServerToClientEvents = {
     "workflow:tool-activity": (payload: WorkflowToolActivityPayload) => void;
     "workflow:token-usage": (payload: WorkflowTokenUsagePayload) => void;
     "cli:config:updated": (payload: CliConfigUpdatedPayload) => void;
+    /**
+     * Cockpit → CLI: list the models the device can actually run for an engine
+     * (OpenCode/Kilo run their own catalog command in the agent image; other
+     * engines answer from the curated KNOWN_MODEL_SUGGESTIONS). Ack-based with
+     * a server-side timeout — the container run can take tens of seconds.
+     */
+    "models:catalog:request": (payload: {
+        engine: string;
+    }, callback: (data: {
+        models: string[];
+        error?: string;
+    } | null) => void) => void;
     error: (payload: SocketErrorPayload) => void;
 };
 export type ClientToServerEvents = {

package/dist/index.d.ts

@@ -5,6 +5,8 @@ export { AGENT_TYPE, AGENT_TYPE_LABELS, DEFAULT_AGENT_TYPE, isAgentType, } from
 export type { AgentType } from "./constants/agent-type.js";
 export { EFFORT_LEVELS, EFFORT_LEVEL_LABELS, } from "./constants/effort-level.js";
 export type { EffortLevel } from "./constants/effort-level.js";
+export { KNOWN_MODEL_SUGGESTIONS, LIVE_CATALOG_ENGINES, } from "./constants/known-models.js";
+export type { KnownModelSuggestion } from "./constants/known-models.js";
 export { CLI_STATUS } from "./constants/cli-status.js";
 export { WORKFLOW_TYPE } from "./constants/workflow-type.js";
 export type { WorkflowType } from "./constants/workflow-type.js";

package/dist/index.js

@@ -3,6 +3,7 @@ export { KANBAN_SUB_STATUS, DEFAULT_KANBAN_COLUMNS, KANBAN_COLUMN_COLORS, DEFAUL
 export { AGENT_STATUS } from "./constants/agent-status.js";
 export { AGENT_TYPE, AGENT_TYPE_LABELS, DEFAULT_AGENT_TYPE, isAgentType, } from "./constants/agent-type.js";
 export { EFFORT_LEVELS, EFFORT_LEVEL_LABELS, } from "./constants/effort-level.js";
+export { KNOWN_MODEL_SUGGESTIONS, LIVE_CATALOG_ENGINES, } from "./constants/known-models.js";
 export { CLI_STATUS } from "./constants/cli-status.js";
 export { WORKFLOW_TYPE } from "./constants/workflow-type.js";
 export { WORKFLOW_SCOPE } from "./constants/workflow-scope.js";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@getforgeai/protocol",
-  "version": "0.1.0-beta.4",
+  "version": "0.1.0-beta.5",
   "description": "Shared types, constants, Socket.io event definitions and Zod schemas for the ForgeAI CLI/Cloud contract.",
   "license": "Apache-2.0",
   "type": "module",