@aitne/daemon 0.1.7 → 0.1.9

package/dist/core/backends/idle-watchdog.d.ts

@@ -74,4 +74,3 @@ export declare class IdleWatchdog {
     hasFired(): boolean;
     private poll;
 }
-//# sourceMappingURL=idle-watchdog.d.ts.map

package/dist/core/backends/idle-watchdog.js

@@ -91,4 +91,3 @@ export class IdleWatchdog {
         this.onTimeout(idleMs);
     }
 }
-//# sourceMappingURL=idle-watchdog.js.map

package/dist/core/backends/install-methods.d.ts

@@ -90,4 +90,3 @@ export declare function resolveInstallCommand(backendId: BackendId, methodId: st
     executable: string;
     args: string[];
 } | null;
-//# sourceMappingURL=install-methods.d.ts.map

package/dist/core/backends/install-methods.js

@@ -6,11 +6,13 @@ const CLI_COMMANDS = {
     claude: "claude",
     codex: "codex",
     gemini: "gemini",
+    opencode: "opencode",
 };
 const DOCS_URLS = {
     claude: "https://docs.anthropic.com/en/docs/claude-code/setup",
     codex: "https://github.com/openai/codex",
     gemini: "https://github.com/google-gemini/gemini-cli",
+    opencode: "https://opencode.ai/docs/",
 };
 /**
  * Install methods are ordered by recommendation priority — the first
@@ -113,6 +115,26 @@ const METHOD_DEFS = {
             manualOnly: false,
         },
     ],
+    opencode: [
+        {
+            id: "npm",
+            label: "npm (global)",
+            command: "npm install -g opencode-ai",
+            executable: "npm",
+            platforms: ["darwin", "linux", "win32"],
+            recommended: true,
+            manualOnly: false,
+        },
+        {
+            id: "brew",
+            label: "Homebrew",
+            command: "brew install sst/tap/opencode",
+            executable: "brew",
+            platforms: ["darwin", "linux"],
+            recommended: false,
+            manualOnly: false,
+        },
+    ],
 };
 /**
  * Additional directories to scan when looking for CLI binaries that
@@ -264,4 +286,3 @@ export function resolveInstallCommand(backendId, methodId) {
         args: parts.slice(1),
     };
 }
-//# sourceMappingURL=install-methods.js.map

package/dist/core/backends/model-registry.d.ts

@@ -16,13 +16,16 @@ import type { BackendId, BackendModel, BackendModelTier, BackendUsage } from "@a
  */
 export declare const DEFAULT_CLAUDE_LITE_MODEL = "claude-haiku-4-5-20251001";
 export declare const DEFAULT_CLAUDE_MEDIUM_MODEL = "claude-sonnet-4-6";
-export declare const DEFAULT_CLAUDE_HIGH_MODEL = "claude-opus-4-7";
+export declare const DEFAULT_CLAUDE_HIGH_MODEL = "claude-opus-4-8";
 export declare const DEFAULT_CODEX_LITE_MODEL = "gpt-5.4-mini";
-export declare const DEFAULT_CODEX_MEDIUM_MODEL = "gpt-5.4-mini";
-export declare const DEFAULT_CODEX_HIGH_MODEL = "gpt-5.5";
+export declare const DEFAULT_CODEX_MEDIUM_MODEL = "gpt-5.4";
+export declare const DEFAULT_CODEX_HIGH_MODEL = "gpt-5.4";
 export declare const DEFAULT_GEMINI_LITE_MODEL = "gemini-3.1-flash-lite-preview";
-export declare const DEFAULT_GEMINI_MEDIUM_MODEL = "gemini-3.1-flash-lite-preview";
+export declare const DEFAULT_GEMINI_MEDIUM_MODEL = "gemini-3.1-pro-preview";
 export declare const DEFAULT_GEMINI_HIGH_MODEL = "gemini-3.1-pro-preview";
+export declare const DEFAULT_OPENCODE_LITE_MODEL = "anthropic/claude-haiku-4-5";
+export declare const DEFAULT_OPENCODE_MEDIUM_MODEL = "anthropic/claude-sonnet-4-6";
+export declare const DEFAULT_OPENCODE_HIGH_MODEL = "anthropic/claude-opus-4-8";
 export declare function getModelsForBackend(backendId: BackendId): ReadonlyArray<BackendModel>;
 export declare function findRegisteredModel(backendId: BackendId, modelId: string): BackendModel | undefined;
 /**
@@ -48,11 +51,12 @@ export declare function cheapestLiteFor(backendId: BackendId): string | null;
  * Resolve the canonical default model id for a `(backendId, tier)` pair.
  * Falls back across tiers if the registry has no match (e.g. Codex has no
  * distinct medium model — `latestMediumFor("codex")` returns null and we
- * fall through to lite).
+ * fall through to lite). For the `high` tier, `SEED_HIGH_TIER_OVERRIDE`
+ * takes precedence — used to keep Codex's Opus-priced gpt-5.5 from
+ * silently becoming the default on every high-tier process key.
  */
 export declare function defaultModelForTier(backendId: BackendId, tier: BackendModelTier): string;
 export declare function estimateCostForUsage(model: BackendModel | undefined, usage: BackendUsage): number;
 export declare function estimateTextInputTokens(text: string): number;
 /** Get the human-readable label for a model, falling back to the raw modelId. */
 export declare function getModelLabel(backendId: BackendId, modelId: string): string;
-//# sourceMappingURL=model-registry.d.ts.map

package/dist/core/backends/model-registry.js

@@ -16,22 +16,39 @@
 // Claude
 export const DEFAULT_CLAUDE_LITE_MODEL = "claude-haiku-4-5-20251001";
 export const DEFAULT_CLAUDE_MEDIUM_MODEL = "claude-sonnet-4-6";
-export const DEFAULT_CLAUDE_HIGH_MODEL = "claude-opus-4-7";
-// Codex (gpt-5.4-mini doubles as both lite and medium until OpenAI ships a
-// distinct mid-tier; gpt-5.5 is the flagship reasoning model. The
-// non-thinking gpt-5.5-chat-latest — marketed as "GPT-5.5 Instant" —
-// is registered as a selectable high-tier alternative but is not the
-// canonical default; operators pin it manually when low latency
-// matters more than deeper reasoning.)
+export const DEFAULT_CLAUDE_HIGH_MODEL = "claude-opus-4-8";
+// Codex (gpt-5.4-mini is the lite-tier pick; gpt-5.4 is the medium-tier
+// default — morning_routine / hourly_check / evening_review run on this.
+// gpt-5.5 and gpt-5.5-chat-latest are the flagship reasoning models and
+// stay registered at high tier as selectable opt-ins, but the seeded
+// default for Codex's high tier is also gpt-5.4: gpt-5.5 carries Opus-
+// class pricing (~$5 in / $30 out per MTok), and we don't want to spend
+// that by default on surfaces that the user merely lets fall through to
+// tier defaults. Operators who want gpt-5.5 pin it per row from
+// /settings/models. See `SEED_HIGH_TIER_OVERRIDE` below.)
 export const DEFAULT_CODEX_LITE_MODEL = "gpt-5.4-mini";
-export const DEFAULT_CODEX_MEDIUM_MODEL = "gpt-5.4-mini";
-export const DEFAULT_CODEX_HIGH_MODEL = "gpt-5.5";
-// Gemini (Google retired the dedicated "flash" mid-tier in the 3.1 series,
-// so flash-lite preview covers both the lite and medium picks; 3.1 pro
-// preview is the top tier).
+export const DEFAULT_CODEX_MEDIUM_MODEL = "gpt-5.4";
+export const DEFAULT_CODEX_HIGH_MODEL = "gpt-5.4";
+// Gemini (Google retired the dedicated "flash" mid-tier in the 3.1 series
+// and `gemini-2.5-flash` is deprecated, so the registry has no real
+// medium-tier flash equivalent left. `gemini-3.1-pro-preview` is priced in
+// the Sonnet band — $0.002/$0.012 per 1k in/out under 200k context, ~2/3
+// the cost of Sonnet 4.6 — so it serves as the "main agent work" pick for
+// every medium-tier surface (morning_routine, message.dm, hourly_check,
+// evening / weekly / monthly review). High tier collapses onto the same
+// model via `SEED_HIGH_TIER_OVERRIDE` below: there's no Opus-priced Google
+// flagship worth defaulting to, and operators who genuinely want
+// `gemini-2.5-pro` can pin it per-row from /settings/models. Lite stays
+// pinned to flash-lite for delegated proxy + fetch_window/triage surfaces.
 export const DEFAULT_GEMINI_LITE_MODEL = "gemini-3.1-flash-lite-preview";
-export const DEFAULT_GEMINI_MEDIUM_MODEL = "gemini-3.1-flash-lite-preview";
+export const DEFAULT_GEMINI_MEDIUM_MODEL = "gemini-3.1-pro-preview";
 export const DEFAULT_GEMINI_HIGH_MODEL = "gemini-3.1-pro-preview";
+// OpenCode static fallback defaults use provider/model composite IDs. The
+// live OpenCode server may report different providers; runtime probing lands
+// in a later phase, so Phase 1 seeds Anthropic-compatible safe defaults.
+export const DEFAULT_OPENCODE_LITE_MODEL = "anthropic/claude-haiku-4-5";
+export const DEFAULT_OPENCODE_MEDIUM_MODEL = "anthropic/claude-sonnet-4-6";
+export const DEFAULT_OPENCODE_HIGH_MODEL = "anthropic/claude-opus-4-8";
 const MODEL_REGISTRY = [
     {
         backendId: "claude",
@@ -50,20 +67,43 @@ const MODEL_REGISTRY = [
         maxInputTokens: 1_000_000,
         maxOutputTokens: 64_000,
     },
+    {
+        backendId: "claude",
+        modelId: "claude-opus-4-8",
+        label: "Claude Opus 4.8",
+        displayName: "Claude Opus 4.8",
+        tier: "high",
+        available: true,
+        supportsToolUse: true,
+        supportsStreaming: true,
+        supportsPromptCaching: true,
+        // Anthropic Opus 4 tier: $15/$75/$1.50/$18.75 per MTok in/out/cache-read/cache-create
+        // — same band as 4.7. The SDK's `total_cost_usd` is the trusted source; pin
+        // `pricingTrusted` so the community price-fetcher can't clobber it with the
+        // stale 4.6-tier rate LiteLLM lists for the newest Opus generation.
+        usdPer1kIn: 0.015,
+        usdPer1kOut: 0.075,
+        usdPer1kCacheRead: 0.0015,
+        usdPer1kCacheCreate: 0.01875,
+        pricingTrusted: true,
+        maxInputTokens: 1_000_000,
+        maxOutputTokens: 128_000,
+    },
     {
         backendId: "claude",
         modelId: "claude-opus-4-7",
-        label: "Claude Opus 4.7",
-        displayName: "Claude Opus 4.7",
+        label: "Claude Opus 4.7 (legacy)",
+        displayName: "Claude Opus 4.7 (legacy)",
         tier: "high",
         available: true,
+        deprecated: true,
         supportsToolUse: true,
         supportsStreaming: true,
         supportsPromptCaching: true,
         // Anthropic Opus 4 tier: $15/$75/$1.50/$18.75 per MTok in/out/cache-read/cache-create.
-        // LiteLLM's community data lists 4-7 at 1/3 of this (4.6-tier rate); pin trust
-        // to the registry until upstream catches up. SDK's `total_cost_usd` confirms
-        // 4-7 is billed at the full Opus 4 rate.
+        // Demoted to legacy when 4.8 shipped; kept available so existing pins keep
+        // resolving with correct pricing. SDK's `total_cost_usd` confirms 4-7 is
+        // billed at the full Opus 4 rate.
         usdPer1kIn: 0.015,
         usdPer1kOut: 0.075,
         usdPer1kCacheRead: 0.0015,
@@ -107,6 +147,77 @@ const MODEL_REGISTRY = [
         maxInputTokens: 200_000,
         maxOutputTokens: 64_000,
     },
+    {
+        backendId: "opencode",
+        modelId: "anthropic/claude-haiku-4-5",
+        label: "OpenCode Claude Haiku 4.5",
+        displayName: "Claude Haiku 4.5",
+        tier: "lite",
+        available: true,
+        supportsToolUse: true,
+        supportsStreaming: true,
+        supportsPromptCaching: true,
+        usdPer1kIn: 0.001,
+        usdPer1kOut: 0.005,
+        usdPer1kCacheRead: 0.0001,
+        usdPer1kCacheCreate: 0.00125,
+        maxInputTokens: 200_000,
+        maxOutputTokens: 64_000,
+    },
+    {
+        backendId: "opencode",
+        modelId: "anthropic/claude-sonnet-4-6",
+        label: "OpenCode Claude Sonnet 4.6",
+        displayName: "Claude Sonnet 4.6",
+        tier: "medium",
+        available: true,
+        supportsToolUse: true,
+        supportsStreaming: true,
+        supportsPromptCaching: true,
+        usdPer1kIn: 0.003,
+        usdPer1kOut: 0.015,
+        usdPer1kCacheRead: 0.0003,
+        usdPer1kCacheCreate: 0.00375,
+        maxInputTokens: 1_000_000,
+        maxOutputTokens: 64_000,
+    },
+    {
+        backendId: "opencode",
+        modelId: "anthropic/claude-opus-4-8",
+        label: "OpenCode Claude Opus 4.8",
+        displayName: "Claude Opus 4.8",
+        tier: "high",
+        available: true,
+        supportsToolUse: true,
+        supportsStreaming: true,
+        supportsPromptCaching: true,
+        usdPer1kIn: 0.015,
+        usdPer1kOut: 0.075,
+        usdPer1kCacheRead: 0.0015,
+        usdPer1kCacheCreate: 0.01875,
+        pricingTrusted: true,
+        maxInputTokens: 1_000_000,
+        maxOutputTokens: 128_000,
+    },
+    {
+        backendId: "opencode",
+        modelId: "anthropic/claude-opus-4-7",
+        label: "OpenCode Claude Opus 4.7 (legacy)",
+        displayName: "Claude Opus 4.7 (legacy)",
+        tier: "high",
+        available: true,
+        deprecated: true,
+        supportsToolUse: true,
+        supportsStreaming: true,
+        supportsPromptCaching: true,
+        usdPer1kIn: 0.015,
+        usdPer1kOut: 0.075,
+        usdPer1kCacheRead: 0.0015,
+        usdPer1kCacheCreate: 0.01875,
+        pricingTrusted: true,
+        maxInputTokens: 1_000_000,
+        maxOutputTokens: 128_000,
+    },
     {
         backendId: "codex",
         modelId: "gpt-5.5",
@@ -133,10 +244,9 @@ const MODEL_REGISTRY = [
         modelId: "gpt-5.5-chat-latest",
         label: "GPT-5.5 Instant",
         displayName: "GPT-5.5 Instant",
-        // Non-thinking sibling of gpt-5.5 — released 2026-05-05 as the new
-        // ChatGPT default (replacing GPT-5.3 Instant). Same model family /
-        // pricing as thinking gpt-5.5 but with no reasoning step, so it
-        // returns a token immediately. Registered under `high` to keep the
+        // Non-thinking sibling of gpt-5.5 — ChatGPT's default. Same model
+        // family / pricing as thinking gpt-5.5 but with no reasoning step,
+        // so it returns a token immediately. Registered under `high` to keep the
         // canonical pricing tier honest (latestHighFor still resolves to
         // thinking gpt-5.5 because that entry comes first in this array);
         // operators can pin it from /settings/models when low latency is
@@ -160,11 +270,19 @@ const MODEL_REGISTRY = [
     {
         backendId: "codex",
         modelId: "gpt-5.4",
-        label: "GPT-5.4 (legacy)",
-        displayName: "GPT-5.4 (legacy)",
-        tier: "high",
+        label: "GPT-5.4",
+        displayName: "GPT-5.4",
+        // Promoted from `high` to `medium` after gpt-5.5 shipped: gpt-5.4 is
+        // priced ~half of gpt-5.5 for the same context shapes, and the
+        // medium-tier routines (morning_routine / hourly_check /
+        // evening_review / message.dm) do not benefit from gpt-5.5's
+        // deeper reasoning enough to justify the cost. gpt-5.4 is ALSO the
+        // seeded default for codex's high tier via `SEED_HIGH_TIER_OVERRIDE`
+        // — gpt-5.5 stays registered as a high-tier opt-in for surfaces that
+        // pin it explicitly from /settings/models, but is not the silent
+        // fall-through (Opus-class pricing makes that the wrong default).
+        tier: "medium",
         available: true,
-        deprecated: true,
         supportsToolUse: true,
         supportsStreaming: true,
         supportsPromptCaching: true,
@@ -184,11 +302,10 @@ const MODEL_REGISTRY = [
         modelId: "gpt-5.4-mini",
         label: "GPT-5.4 Mini",
         displayName: "GPT-5.4 Mini",
-        // OpenAI's smallest GPT-5-class chat model. Doubles as the canonical
-        // pick for both `lite` and `medium` tiers on Codex until a true
-        // mid-tier (gpt-5.5-mini) ships — the registry uses `lite` here so
-        // delegated proxy calls get routed to the cheapest option, while
-        // `latestMediumFor("codex")` falls through to the same model.
+        // OpenAI's smallest GPT-5-class chat model. Canonical Codex lite-tier
+        // pick — delegated proxy calls and observer-fired surfaces route
+        // here. Medium-tier surfaces now resolve to `gpt-5.4` directly via
+        // `latestMediumFor("codex")` instead of falling through to mini.
         tier: "lite",
         available: true,
         supportsToolUse: true,
@@ -253,7 +370,16 @@ const MODEL_REGISTRY = [
         modelId: "gemini-3.1-pro-preview",
         label: "Gemini 3.1 Pro (preview)",
         displayName: "Gemini 3.1 Pro (preview)",
-        tier: "high",
+        // Classified as `medium` so `latestMediumFor("gemini")` resolves here
+        // instead of returning null (the deprecated `gemini-2.5-flash` is the
+        // only other medium candidate and is excluded by `!deprecated`). This
+        // is the "main agent work" pick on Gemini — pricing ~$0.002 / $0.012
+        // per 1k in/out is in the Sonnet band, and the latest-gen 3.1 Pro
+        // model reliably follows multi-step task flows that flash-lite
+        // (lite tier) silently skips. High tier collapses onto this same
+        // model via `SEED_HIGH_TIER_OVERRIDE.gemini` below; operators who
+        // want `gemini-2.5-pro` for high-tier surfaces pin it explicitly.
+        tier: "medium",
         // Official Gemini API pricing: https://ai.google.dev/pricing
         available: true,
         supportsToolUse: true,
@@ -438,11 +564,47 @@ export function cheapestLiteFor(backendId) {
         : cheapest).modelId;
     /* c8 ignore stop */
 }
+/**
+ * Per-backend override for the high-tier *seeded default*. Keeps the
+ * "what high-tier models exist on this backend" question (answered by
+ * `latestHighFor`) separate from the "what model do we seed when a
+ * process key's default tier resolves to high" question (answered by
+ * `defaultModelForTier`).
+ *
+ * Codex's flagship reasoning model (gpt-5.5) is priced in the same band
+ * as Anthropic Opus — too expensive to be the silent fall-through for
+ * process keys that *happen* to be tagged high tier (delegated_task_heavy,
+ * advisor — note `morning_routine_initial` was retired by
+ * morning-routine-optimization.md Phase 7 in 2026-05-16, and both
+ * `setup` and `knowledge.import` were demoted to medium tier on
+ * 2026-05-16 as part of the "no Opus by default" pass). Operators
+ * who explicitly want gpt-5.5 pin it per row from
+ * /settings/models; the medium-tier model is the safe default. The
+ * referenced model must be present + non-deprecated in `MODEL_REGISTRY`
+ * — the lookup `findRegisteredModel` confirms before honoring the
+ * override; otherwise we fall through to the normal `latestHighFor`
+ * resolution.
+ */
+const SEED_HIGH_TIER_OVERRIDE = {
+    codex: "gpt-5.4",
+    // `latestHighFor("gemini")` legitimately resolves to `gemini-2.5-pro`
+    // (the only non-deprecated registry entry tagged `tier: "high"` now that
+    // `gemini-3.1-pro-preview` carries `tier: "medium"`). 2.5-pro is fine for
+    // explicit opt-in, but for the silent fall-through on Aitne's seeded
+    // high-tier surfaces we want continuity with the medium tier — same
+    // 3.1-preview generation, no surprise version swap between
+    // `routine.morning_routine` and `knowledge.import`. The override flips
+    // the seed to 3.1-pro; `findRegisteredModel` confirms it's present and
+    // non-deprecated before honoring (same guard the Codex override uses).
+    gemini: "gemini-3.1-pro-preview",
+};
 /**
  * Resolve the canonical default model id for a `(backendId, tier)` pair.
  * Falls back across tiers if the registry has no match (e.g. Codex has no
  * distinct medium model — `latestMediumFor("codex")` returns null and we
- * fall through to lite).
+ * fall through to lite). For the `high` tier, `SEED_HIGH_TIER_OVERRIDE`
+ * takes precedence — used to keep Codex's Opus-priced gpt-5.5 from
+ * silently becoming the default on every high-tier process key.
  */
 export function defaultModelForTier(backendId, tier) {
     if (tier === "lite") {
@@ -465,6 +627,15 @@ export function defaultModelForTier(backendId, tier) {
             ?? DEFAULT_CLAUDE_MEDIUM_MODEL;
         /* c8 ignore stop */
     }
+    const override = SEED_HIGH_TIER_OVERRIDE[backendId];
+    if (override) {
+        const found = MODEL_REGISTRY.find((model) => model.backendId === backendId
+            && model.modelId === override
+            && model.available
+            && !model.deprecated);
+        if (found)
+            return found.modelId;
+    }
     /* c8 ignore start — every backend has a high model; the fallbacks
        here only fire if a high tier is removed entirely. */
     return latestHighFor(backendId)
@@ -536,4 +707,3 @@ export function getModelLabel(backendId, modelId) {
 function roundUsd(value) {
     return Math.round(value * 1_000_000) / 1_000_000;
 }
-//# sourceMappingURL=model-registry.js.map

package/dist/core/backends/native-skill-discovery-probe.d.ts

@@ -0,0 +1,77 @@
+/**
+ * docs/design/appendices/skills-unification.md Phase 1 item 13 — forward-compat probe.
+ *
+ * Codex and Gemini did not ship native skill auto-discovery when Phase 1
+ * landed (which is why the instruction file carries a `<skill-index>`
+ * block + on-demand `Read` protocol). When their CLIs grow a built-in
+ * `skill` / `Skill` surface — analogous to the Claude Agent SDK's
+ * loader — we want a loud one-line signal so a follow-up PR can drop
+ * the `<skill-index>` block for that backend.
+ *
+ * Two detection strategies are wired here. They are complementary
+ * because the surface a future CLI exposes is not knowable in advance.
+ *
+ *  1. {@link noteNativeSkillToolIfPresent} — pure name-pattern scan
+ *     against a tool-name list. Cheap defense-in-depth. The caller
+ *     supplies whatever inventory it already has. Today's wiring (Codex
+ *     `mcp__`-filtered probe, Gemini synthetic capability list) means
+ *     this path will not actually fire on a future native surface
+ *     because that surface won't be MCP-namespaced — but the function
+ *     stays in case a richer inventory source lands later.
+ *
+ *  2. {@link probeCliNativeSkillSubcommand} — runs `<cli> --help` once
+ *     and scans the output for a top-level `skill` / `skills`
+ *     subcommand. This is the ground-truth signal. Verified:
+ *       - `gemini --help` already lists `gemini skills <command>`
+ *         (aliased `skill`). When this probe is wired, Gemini will be
+ *         the first backend to trip the alarm.
+ *       - `codex --help` does NOT yet ship a skill subcommand. Its
+ *         `codex features list` carries `skill_mcp_dependency_install`
+ *         (stable, true) and `skill_env_var_dependency_prompt` (under
+ *         development) — both gate MCP dependency wiring, not skill
+ *         discovery, so they are NOT load-bearing signals.
+ *
+ * Both probes are idempotent per process (`reportedKeys` /
+ * `subcommandReportedKeys`). Re-fires across daemon restarts, which is
+ * fine — the signal is meant to be noticed in logs during the rollout
+ * window, not deduplicated across boots.
+ *
+ * No-op for Claude (`materializeClaudeSession` already trusts the SDK
+ * loader) and for OpenCode (cwd auto-discovery is the source of truth;
+ * Phase 1 §R3 pins zero `<skill-index>` for that backend).
+ */
+import type { BackendId } from "@aitne/shared";
+export declare function noteNativeSkillToolIfPresent(backendId: Exclude<BackendId, "claude">, toolNames: readonly string[]): void;
+/**
+ * Top-level command-line detector. Two anchors:
+ *   - `<cli> skill[s]` literal — every CLI we care about renders its
+ *     usage lines that way (e.g. `gemini skills <command>`; codex's
+ *     hypothetical future form would be `codex skill <command>`).
+ *   - Indented command-list entry `<indent>skill[s]<space>` — the
+ *     "Commands:" block shape both yargs (Gemini) and clap (Codex)
+ *     render.
+ *
+ * Case-insensitive so a `Skill` or `Skills` heading is not missed.
+ * Word-boundary terminator `\b` prevents false hits on `skill_search`
+ * or `skill_install`-style sub-tokens that are not load-bearing
+ * subcommand names.
+ */
+declare function helpTextLooksLikeSkillSubcommand(helpText: string, backendId: string): boolean;
+/**
+ * Probe the backend CLI's `--help` output for a top-level skill
+ * subcommand. Idempotent per process — once a backend has been
+ * reported, subsequent calls short-circuit.
+ *
+ * Designed to be called from `probeTools()` (which runs at integration
+ * mode-flip probe time). Failure modes are silent (missing CLI,
+ * non-zero exit, parse-fail, timeout) so the daemon's main flow is not
+ * blocked on a forward-compat heuristic.
+ */
+export declare function probeCliNativeSkillSubcommand(cliPath: string | null, backendId: Exclude<BackendId, "claude" | "opencode">): Promise<void>;
+/** Test-only: reset both dedupe sets so multiple probe invocations exercise
+ *  the log path independently. */
+export declare function __resetNativeSkillDiscoveryProbe(): void;
+/** Test-only — extracted for direct coverage of the help-text matcher
+ *  without paying for a subprocess. */
+export declare const __test_helpTextLooksLikeSkillSubcommand: typeof helpTextLooksLikeSkillSubcommand;
+export {};