@jeffreyjyz/opencode-command-code 0.3.19 → 0.5.0

package/dist/access.d.ts

@@ -1,4 +1,5 @@
-import { canonicalizeModelId, PLAN_RULES } from "./gating";
+import { PLAN_RULES } from "./constants/gating";
+import { canonicalizeModelId } from "./gating";
 export { canonicalizeModelId, PLAN_RULES };
 export type PlanLike = {
     planId: string;

package/dist/api.d.ts

@@ -1,4 +1,3 @@
-export declare const API_BASE = "https://api.commandcode.ai";
 export declare function authHeaders(key: string): Record<string, string>;
 export declare function getJson(path: string, key: string, timeoutMs?: number): Promise<unknown>;
 export type Whoami = {

package/dist/cli.d.ts

@@ -2,6 +2,10 @@
  * the homebrew prefix, so the bare name alone is not enough. `CMDUSE_BIN` wins
  * when set — the dev-build hook the sibling cmduse consumers (mpc) honour too. */
 export declare function cmduseCandidates(env?: Record<string, string | undefined>): string[];
+/** Same lookup for mpc, the per-model price comparison: `MPC_BIN`
+ * wins when set (the `bun link` dev hook oc-cmd-compare installs),
+ * then the bun/homebrew fallbacks. */
+export declare function mpcCandidates(env?: Record<string, string | undefined>): string[];
 /** Shell-words split: whitespace-separated, with single/double quoting and
  * backslash escapes ("--tz +05:30", arg='a b'). Unterminated quotes close at
  * end of input. */
@@ -10,6 +14,10 @@ export declare function splitCliArgs(input: string): string[];
  * pass-through flags, or a subcommand invocation ("plans",
  * "--tz +05:30 daily") passed through untouched. */
 export declare function buildCmduseArgs(arg: string): string[];
+/** argv for an mpc invocation: mpc has no subcommands, so the arg
+ * string is split and passed straight through; an empty arg means
+ * the fewest-columns view (see MPC_DEFAULT_ARGS). */
+export declare function buildMpcArgs(arg: string): string[];
 export type RunOptions = {
     signal?: AbortSignal;
     /** Extra env for the child (CMD_API_KEY when the plugin resolved one). */
@@ -21,3 +29,9 @@ export type RunOptions = {
  * homebrew locations; every candidate failing with ENOENT yields a single
  * install-hint error. */
 export declare function runCmduse(arg: string, opts?: RunOptions): Promise<string>;
+/** Run mpc and return its plain-text stdout (the per-model price
+ * comparison). Same contract as runCmduse: `MPC_BIN` wins, then the
+ * fallback paths; every candidate failing with ENOENT yields a
+ * single install-hint error, and any other failure (a non-zero exit
+ * included) surfaces immediately with mpc's last stderr lines. */
+export declare function runMpc(arg: string, opts?: RunOptions): Promise<string>;

package/dist/constants/binaries.d.ts

@@ -0,0 +1,6 @@
+/** Fallback lookup paths for the cmduse CLI (CMDUSE_BIN wins when set). */
+export declare const CMDUSE_BIN_CANDIDATES: readonly string[];
+/** Fallback lookup paths for mpc, the per-model catalog scraper. */
+export declare const MPC_BIN_CANDIDATES: readonly string[];
+/** Fallback lookup paths for ocuse (OCUSE_BIN wins when set). */
+export declare const OCUSE_BIN_CANDIDATES: readonly string[];

package/dist/constants/cli.d.ts

@@ -0,0 +1,17 @@
+import type { spawn } from "node:child_process";
+/** Default invocation: one-shot dashboard, no colors / no live redraw. */
+export declare const DEFAULT_ARGS: readonly string[];
+/** Default mpc invocation: the fewest-columns view. mpc has no
+ * subcommands to fall back on, so an empty arg must mean the
+ * narrowest table — a bare tool call cannot dump a wide comparison
+ * into the model's context. */
+export declare const MPC_DEFAULT_ARGS: readonly string[];
+/** cmduse subcommands — when the arg starts with one, pass it through
+ * untouched; otherwise it is extra flags for the one-shot dashboard. */
+export declare const SUBCOMMANDS: ReadonlySet<string>;
+/** `detached` is load-bearing, not tidiness: it starts the child in its own
+ * session, so it has no controlling terminal. cmduse's snapshot() paints a
+ * "fetching usage…" spinner straight to /dev/tty — piping stdout/stderr does
+ * not stop it — which would corrupt the opencode TUI this process inherits its
+ * tty from. Detaching makes that open fail; stdout/stderr stay piped. */
+export declare const SPAWN_OPTIONS: Parameters<typeof spawn>[2];

package/dist/constants/endpoints.d.ts

@@ -0,0 +1,6 @@
+/** Command Code account/billing API. */
+export declare const API_BASE = "https://api.commandcode.ai";
+/** Provider (inference) API root; the lanes append their wire path. */
+export declare const PROVIDER_BASE = "https://api.commandcode.ai/provider/v1";
+/** Default provider base URL used when the host passes none. */
+export declare const DEFAULT_BASE_URL = "https://api.commandcode.ai";

package/dist/constants/gating.d.ts

@@ -0,0 +1,22 @@
+import type { Category } from "../gating";
+/** model id -> category (models absent from this table have unknown category) */
+export declare const MODEL_CATEGORIES: Record<string, Category>;
+/** planId -> access rules; plan ids absent from this table get everything */
+export declare const PLAN_RULES: Record<string, {
+    allowedCategories: Category[];
+    blockedModels: string[];
+}>;
+/** Models the API hard-blocks (403 MODEL_NOT_IN_PLAN) per plan, beyond the
+ * category rules. Empirically probed — the CLI bundle misses these because it
+ * tracks category via serving lane, not per-model plan entitlements. */
+export declare const HARD_BLOCKED: Record<string, string[]>;
+/** canonical known model ids (lowercase compare) */
+export declare const KNOWN_MODELS: string[];
+/** deprecated/aliased model id -> canonical id */
+export declare const MODEL_ALIASES: Record<string, string>;
+/** ISO timestamp the snapshot was extracted (absent on pre-metadata files). */
+export declare const GATE_EXTRACTED_AT: string | undefined;
+/** Command Code CLI version the snapshot was scraped from. */
+export declare const GATE_CLI_VERSION: string | undefined;
+/** Warn once a process when gating.json is older than this many days. */
+export declare const GATE_STALE_DAYS = 30;

package/dist/constants/models.d.ts

@@ -0,0 +1,29 @@
+/** Every Command Code model shares these capabilities; hoisted so each record
+ * does not rebuild them. Vision (`attachment` + `input.image`) is applied per
+ * model from the generated catalog in the two model builders. */
+export declare const MODEL_CAPABILITIES: {
+    temperature: boolean;
+    reasoning: boolean;
+    attachment: boolean;
+    toolcall: boolean;
+    input: {
+        text: boolean;
+        audio: boolean;
+        image: boolean;
+        video: boolean;
+        pdf: boolean;
+    };
+    output: {
+        text: boolean;
+        audio: boolean;
+        image: boolean;
+        video: boolean;
+        pdf: boolean;
+    };
+};
+/** Context window advertised when the listing API gives no length. */
+export declare const DEFAULT_CONTEXT_LENGTH = 128000;
+/** Max output tokens advertised per model. */
+export declare const DEFAULT_OUTPUT_TOKENS = 32000;
+/** Provider wire ceiling for a request's max tokens. */
+export declare const DEFAULT_MAX_TOKENS = 64000;

package/dist/constants/paths.d.ts

@@ -0,0 +1,18 @@
+/** Dir segment under an XDG base that holds our caches/diagnostics. */
+export declare const CACHE_DIR = "command-code";
+/** Live model list disk cache file (under CACHE_DIR). */
+export declare const MODELS_CACHE_FILE = "models.json";
+/** Startup timing log file (under CACHE_DIR). */
+export declare const STARTUP_LOG_FILE = "startup.log";
+/**
+ * mpc per-model catalog disk cache file (under CACHE_DIR), one per OpenCode Go
+ * plan: mpc bakes the selected plan's per-model allowance into the rows, so a
+ * cached catalog is only valid for the plan it was fetched under.
+ */
+export declare function ccCatalogFile(plan: string): string;
+/** opencode's own config/data dir segment. */
+export declare const OPENCODE_DIR = "opencode";
+/** opencode's message store file (under OPENCODE_DIR in the data root). */
+export declare const OPENCODE_DB_FILE = "opencode.db";
+/** Sidebar prefs file (under OPENCODE_DIR in the config root). */
+export declare const PREFS_FILE = "command-code.json";

package/dist/constants/providers.d.ts

@@ -0,0 +1,32 @@
+/** Provider-id prefix shared by both Command Code lanes and the plugin id. */
+export declare const PROVIDER_ID_PREFIX = "command-code";
+/** Plugin id (stable contract; the v2 `setup` definition and the TUI share it). */
+export declare const PLUGIN_ID = "command-code";
+/** Integration id backing both lanes' credentials (/connect + env). */
+export declare const INTEGRATION_ID = "command-code";
+/** Display name for the integration and the no-key warning. */
+export declare const INTEGRATION_NAME = "Command Code";
+/** OpenCode Go provider id (ocuse reads its store). */
+export declare const GO_PROVIDER_ID = "opencode-go";
+/** OpenCode Zen provider id and its `opencode-zen` alias prefix. */
+export declare const ZEN_PROVIDER_ID = "opencode";
+export declare const ZEN_PROVIDER_PREFIX = "opencode-zen";
+/** TUI plugin id (stable contract; test/tui.test.ts pins it). */
+export declare const TUI_ID = "command-code.tui";
+/** The cmd_usage tool description, shared by the v1 and v2 halves. */
+export declare const TOOL_DESCRIPTION = "Fetch live Command Code plan/usage: plan name, monthly credits, 5-hour & weekly windows, billing-period summary. Pass arg='plans' for the plan comparison table only, or extra cmduse flags (e.g. '--tz +05:30 daily').";
+/** The mpc_prices tool description, shared by the v1 and v2 halves. */
+export declare const MPC_TOOL_DESCRIPTION = "Per-model price comparison: what a model costs per request ($/1M input, output and cache rates) and per month (request allowance) on each Command Code (cc) and OpenCode Go (oc) plan side, plus ability, Tok/s, the cheaper-side verdict and running deals. Pass '--model <regex>' to filter rows, '--minimal' | '--medium' | '--detail' for table width, '--json' for the full structured rows, '--cc-plan' / '--oc-plan' to pick a plan, or '--usage' to project real usage.";
+/** The mpc_prices `arg` description, shared by the v1 and v2 halves. */
+export declare const MPC_TOOL_ARG_DESCRIPTION = "Optional mpc flags: '--model <regex>' filters rows, '--minimal' | '--medium' | '--detail' set table width, '--json' for full structured rows, '--cc-plan'/'--oc-plan' pick a plan, '--usage' projects real usage";
+export type Lane = {
+    id: "command-code-anthropic" | "command-code-openai";
+    name: string;
+    /** v2 runtime package (first-party, distinct from the v1 `npm` value). */
+    pkg: string;
+    /** Wire field reasoning must round-trip through on the openai-compatible
+     * lane; v2 spells the old `interleaved: {field}` as `compatibility`. */
+    reasoningField?: string;
+};
+/** The Anthropic and OpenAI-compatible provider lanes this plugin owns. */
+export declare const LANES: [Lane, Lane];

package/dist/constants/sidebar.d.ts

@@ -0,0 +1,33 @@
+import type { Category } from "../gating";
+import type { Prefs } from "../sidebar/prefs";
+/**
+ * The sidebar is 42 columns wide with 2+2 padding, and our panel keeps one more
+ * column clear on the right, so a rendered row must stay within this. Rows that
+ * cannot fit are split across an indented continuation rather than wrapping in
+ * the host's renderer, which is what made the panel look broken.
+ */
+export declare const ROW_WIDTH = 37;
+/** Tier label per gating category. */
+export declare const TIER_DISPLAY: Readonly<Record<Category, string>>;
+/**
+ * OpenCode Go plans the panel can render: the same token rates, different
+ * per-model monthly limits. Which one a user is on is not discoverable (Go has
+ * no usage API and the store records no subscription), so it is a setting.
+ */
+export declare const OC_PLANS: readonly ["go", "go-plus"];
+export type OcPlan = (typeof OC_PLANS)[number];
+/** Plan used when the user has not set one: behaviour is unchanged for them. */
+export declare const OC_PLAN_DEFAULT: OcPlan;
+/** Go's documented per-model window shares of the monthly allowance. */
+export declare const GO_WINDOW_SHARE: {
+    readonly fiveHour: 0.2;
+    readonly weekly: 0.5;
+    readonly month: 1;
+};
+/** 5-hour window length in seconds. Mirrors cmduse_core::FIVE_HOUR_SECS. */
+export declare const FIVE_HOUR_SECS: number;
+/** Weekly window length in seconds. Mirrors cmduse_core::WEEKLY_SECS. */
+export declare const WEEKLY_SECS: number;
+/** Colour is OFF unless asked for; the OpenCode Go plan defaults to `go` (see
+ * sidebar/prefs.ts). */
+export declare const PREF_DEFAULTS: Prefs;

package/dist/constants/timing.d.ts

@@ -0,0 +1,13 @@
+/** Sidebar poll cadence: one cmduse/ocuse spawn plus the local store reads. */
+export declare const POLL_MS = 5000;
+/** How long one sidebar CLI spawn may run before it is killed. An outage can
+ * leave a fetch hanging through cmduse's retry ladder, and the poll interval
+ * would otherwise stack spawns on top of each other. */
+export declare const CHILD_TIMEOUT_MS = 30000;
+/** Process-lifetime cache for the live model list (src/models.ts). */
+export declare const MODELS_CACHE_TTL_MS: number;
+/** Disk cache for mpc's per-model catalog (src/sidebar/data.ts). An hour, not
+ * six: a running panel then picks up new models and promotions. */
+export declare const CATALOG_CACHE_TTL_MS: number;
+/** Re-read window for the sidebar colour prefs file (src/sidebar/prefs.ts). */
+export declare const PREFS_CACHE_MS = 5000;

package/dist/gating.d.ts

@@ -1,23 +1,5 @@
 export type Category = "opensource" | "premium";
-/** model id -> category (models absent from this table have unknown category) */
-export declare const MODEL_CATEGORIES: Record<string, Category>;
-/** planId -> access rules; plan ids absent from this table get everything */
-export declare const PLAN_RULES: Record<string, {
-    allowedCategories: Category[];
-    blockedModels: string[];
-}>;
-/** Models the API hard-blocks (403 MODEL_NOT_IN_PLAN) per plan, beyond the
- * category rules. Empirically probed — the CLI bundle misses these because it
- * tracks category via serving lane, not per-model plan entitlements. */
-export declare const HARD_BLOCKED: Record<string, string[]>;
-/** canonical known model ids (lowercase compare) */
-declare const KNOWN_MODELS: string[];
-export { KNOWN_MODELS };
-/** ISO timestamp the snapshot was extracted (absent on pre-metadata files). */
-export declare const GATE_EXTRACTED_AT: string | undefined;
-/** Command Code CLI version the snapshot was scraped from. */
-export declare const GATE_CLI_VERSION: string | undefined;
-/** Warn once per process when gating.json is older than 30 days. */
+/** Warn once per process when gating.json is older than GATE_STALE_DAYS. */
 export declare function warnIfGatingStale(): void;
 export declare function canonicalizeModelId(model: string): string;
 /** Bare model id with any provider qualifier stripped: everything after the

package/dist/index.d.ts

@@ -2,9 +2,9 @@ import type { Plugin as PluginV1 } from "@opencode-ai/plugin";
 export declare const CommandCodePlugin: PluginV1;
 export { createCommandCode } from "./provider";
 declare const _default: {
-    /** v1 entrypoint (opencode >=1.18.29 object entrypoints). */
-    server: PluginV1;
     id: string;
     setup: (context: import("@opencode/plugin/promise/plugin").Context) => Promise<import("@opencode/plugin/promise/plugin").Cleanup | void> | import("@opencode/plugin/promise/plugin").Cleanup | void;
+    /** v1 entrypoint (opencode >=1.18.29 object entrypoints). */
+    server: PluginV1;
 };
 export default _default;