@link-assistant/agent 0.26.5 → 0.26.7

package/README.md

@@ -347,6 +347,8 @@ Commands:
 
 See [docs/stdin-mode.md](../docs/stdin-mode.md) for comprehensive stdin mode documentation.
 
+Hosts that embed the CLI supply configuration through `LINK_ASSISTANT_AGENT_CONFIG_DIR`, `LINK_ASSISTANT_AGENT_CONFIG` or `LINK_ASSISTANT_AGENT_CONFIG_CONTENT` — never by relocating `XDG_CONFIG_HOME`, which would also hide `gh`/`git` credentials from the agent's tool calls. See [docs/host-integration.md](../docs/host-integration.md).
+
 ### JSON Output Standards
 
 The agent supports two JSON output format standards via the `--json-standard` option:
@@ -773,6 +775,7 @@ For full documentation, see the [main README](../README.md) in the repository ro
 - [Tools Reference](../TOOLS.md)
 - [Usage Examples](../EXAMPLES.md)
 - [Testing Guide](../TESTING.md)
+- [Host Integration](../docs/host-integration.md) — supplying config via `LINK_ASSISTANT_AGENT_CONFIG_DIR`, `LINK_ASSISTANT_AGENT_CONFIG` and `LINK_ASSISTANT_AGENT_CONFIG_CONTENT`
 
 ## License
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@link-assistant/agent",
-  "version": "0.26.5",
+  "version": "0.26.7",
   "description": "A minimal, public domain AI CLI agent compatible with OpenCode's JSON interface. Bun-only runtime.",
   "main": "src/index.js",
   "type": "module",
@@ -50,76 +50,77 @@
     "LICENSE"
   ],
   "dependencies": {
-    "@agentclientprotocol/sdk": "^0.5.1",
-    "@ai-sdk/amazon-bedrock": "^3.0.74",
-    "@ai-sdk/anthropic": "^2.0.58",
-    "@ai-sdk/azure": "^2.0.91",
-    "@ai-sdk/google": "^2.0.52",
-    "@ai-sdk/google-vertex": "^3.0.98",
-    "@ai-sdk/groq": "^2.0.34",
-    "@ai-sdk/mcp": "^0.0.8",
-    "@ai-sdk/mistral": "^2.0.27",
-    "@ai-sdk/openai": "^2.0.89",
-    "@ai-sdk/openai-compatible": "^2.0.62",
-    "@ai-sdk/xai": "^2.0.33",
-    "@clack/prompts": "^0.11.0",
-    "@hono/standard-validator": "^0.2.0",
-    "@hono/zod-validator": "^0.7.5",
-    "@modelcontextprotocol/sdk": "^1.22.0",
-    "@octokit/graphql": "^9.0.3",
+    "@agentclientprotocol/sdk": "^1.5.1",
+    "@ai-sdk/amazon-bedrock": "^5.0.101",
+    "@ai-sdk/anthropic": "^4.0.68",
+    "@ai-sdk/azure": "^4.0.85",
+    "@ai-sdk/google": "^4.0.85",
+    "@ai-sdk/google-vertex": "^5.0.98",
+    "@ai-sdk/groq": "^4.0.52",
+    "@ai-sdk/mcp": "^2.0.62",
+    "@ai-sdk/mistral": "^4.0.54",
+    "@ai-sdk/openai": "^4.0.81",
+    "@ai-sdk/openai-compatible": "^3.0.59",
+    "@ai-sdk/provider": "^4.0.19",
+    "@ai-sdk/xai": "^5.0.12",
+    "@clack/prompts": "^1.8.1",
+    "@hono/standard-validator": "^0.4.0",
+    "@hono/zod-validator": "^0.9.1",
+    "@modelcontextprotocol/sdk": "^1.31.0",
+    "@octokit/graphql": "^9.0.5",
     "@octokit/rest": "^22.0.1",
     "@openauthjs/openauth": "^0.4.3",
-    "@opencode-ai/sdk": "^1.0.78",
-    "@openrouter/ai-sdk-provider": "^2.2.3",
-    "@opentui/core": "0.1.107",
-    "@opentui/solid": "0.1.107",
-    "@parcel/watcher": "^2.5.1",
-    "@solid-primitives/event-bus": "^1.1.2",
-    "@standard-community/standard-json": "^0.3.5",
-    "@standard-community/standard-openapi": "^0.2.9",
-    "@zip.js/zip.js": "^2.8.10",
-    "ai": "^6.0.235",
-    "chokidar": "^4.0.3",
-    "clipboardy": "^5.0.0",
-    "command-stream": "^0.7.1",
+    "@opencode-ai/sdk": "^1.18.33",
+    "@openrouter/ai-sdk-provider": "^3.1.0",
+    "@opentui/core": "0.5.12",
+    "@opentui/solid": "0.5.12",
+    "@parcel/watcher": "^2.6.0",
+    "@solid-primitives/event-bus": "^1.1.4",
+    "@standard-community/standard-json": "^0.3.6",
+    "@standard-community/standard-openapi": "^0.2.10",
+    "@zip.js/zip.js": "^2.18.2",
+    "ai": "^7.0.122",
+    "chokidar": "^5.0.0",
+    "clipboardy": "^5.3.2",
+    "command-stream": "^1.3.0",
     "decimal.js": "^10.6.0",
-    "diff": "^8.0.2",
-    "fuzzysort": "^3.1.0",
-    "glob": "^10.0.0",
-    "gpt-tokenizer": "^3.4.0",
+    "diff": "^9.0.0",
+    "fuzzysort": "^4.0.2",
+    "glob": "^13.0.6",
+    "gpt-tokenizer": "^4.0.0",
     "gray-matter": "^4.0.3",
-    "hono": "^4.10.6",
-    "hono-openapi": "^1.1.1",
-    "ignore": "^7.0.5",
+    "hono": "^4.13.11",
+    "hono-openapi": "^1.3.3",
+    "ignore": "^7.0.10",
     "jsonc-parser": "^3.3.1",
-    "lino-arguments": "^0.2.5",
-    "lino-objects-codec": "^0.1.1",
+    "lino-arguments": "^0.3.0",
+    "lino-objects-codec": "^0.8.0",
     "log-lazy": "^1.0.4",
-    "minimatch": "^10.1.1",
-    "remeda": "^2.32.0",
+    "minimatch": "^10.2.6",
+    "remeda": "^2.50.0",
     "solid-js": "1.9.12",
-    "strip-ansi": "^7.1.2",
-    "test-anywhere": "^0.7.0",
-    "tree-sitter-bash": "^0.25.0",
-    "turndown": "^7.2.2",
-    "ulid": "^3.0.1",
-    "vscode-jsonrpc": "^8.2.1",
-    "vscode-languageserver-types": "^3.17.5",
-    "web-tree-sitter": "^0.25.10",
+    "strip-ansi": "^7.2.0",
+    "test-anywhere": "^0.9.1",
+    "tree-sitter-bash": "^0.25.1",
+    "turndown": "^7.2.4",
+    "ulid": "^3.0.2",
+    "vscode-jsonrpc": "^9.0.3",
+    "vscode-languageserver-types": "^3.18.4",
+    "web-tree-sitter": "0.25.10",
     "xdg-basedir": "^5.1.0",
-    "yargs": "^18.0.0",
-    "zod": "^4.1.12"
+    "yargs": "^18.2.0",
+    "zod": "^4.6.5"
   },
   "devDependencies": {
-    "@changesets/cli": "^2.29.7",
-    "@eslint/js": "^9.18.0",
-    "eslint": "^9.38.0",
+    "@changesets/cli": "^3.0.3",
+    "@eslint/js": "^10.0.1",
+    "eslint": "^10.11.0",
     "eslint-config-prettier": "^10.1.8",
-    "eslint-plugin-prettier": "^5.5.4",
-    "eslint-plugin-promise": "^7.2.1",
+    "eslint-plugin-prettier": "^5.5.6",
+    "eslint-plugin-promise": "^7.3.0",
     "husky": "^9.1.7",
-    "lint-staged": "^16.2.6",
-    "prettier": "^3.6.2"
+    "lint-staged": "^17.6.0",
+    "prettier": "^3.9.9"
   },
   "lint-staged": {
     "*.{js,mjs,cjs}": [
@@ -134,10 +135,15 @@
   },
   "license": "Unlicense",
   "allowScripts": {
-    "@parcel/watcher@2.5.1": true,
-    "tree-sitter-bash@0.25.1": true
+    "@parcel/watcher@2.6.0": true,
+    "tree-sitter-bash@0.25.1": true,
+    "node-pty@1.2.0-beta.15": true
   },
   "overrides": {
     "undici": "^7.16.0"
+  },
+  "dependencyPins": {
+    "solid-js": "https://github.com/anomalyco/opentui/issues/689",
+    "web-tree-sitter": "https://github.com/link-assistant/agent/issues/322"
   }
 }

package/src/agent/agent.ts

@@ -138,10 +138,10 @@ export namespace Agent {
     const existing = await list();
     const result = await generateObject({
       temperature: 0.3,
-      // The system prompt belongs in `system`, not in `prompt`: the AI SDK
+      // The system prompt belongs in `instructions`, not in `prompt`: the AI SDK
       // warns that a system message inside the prompt enables prompt
       // injection, and providers are free to treat it as ordinary content.
-      system: system.map((content) => ({
+      instructions: system.map((content) => ({
         role: 'system' as const,
         content,
       })),

package/src/cli/input-queue.js

@@ -275,7 +275,8 @@ export function parseStreamJsonInput(input) {
     throw new Error(
       `Invalid stream-json input frame: ${
         error instanceof Error ? error.message : String(error)
-      }`
+      }`,
+      { cause: error }
     );
   }
 

package/src/cli/model-config.js

@@ -100,6 +100,10 @@ export async function parseModelConfig(
     }
   }
 
+  if (argv['dry-run'] && !cliModelArg && modelArg === defaultModel) {
+    modelArg = 'link-assistant/echo';
+  }
+
   // Attestation inputs (#295): record what was requested, and where it came
   // from, before resolution can rewrite the effective model. `argv.model` is
   // only treated as a request when it differs from the default, because yargs
@@ -358,6 +362,52 @@ async function resolveCompactionModelEntry(
   };
 }
 
+/**
+ * Resolve a built-in cascade entry against the run's own provider only.
+ *
+ * The built-in cascade is narrowed to the configured provider anyway (#307),
+ * so resolving its short names across the whole provider registry only to
+ * drop the result afterwards was wasted work — and it logged records such as
+ * `{"providerID":"opencode","message":"resolved short model name"}` that a
+ * host reads as the run using OpenCode (#313). Only the base provider's own
+ * catalog is consulted here; any other provider is never looked up.
+ *
+ * @returns {Promise<{providerID: string, modelID: string, useSameModel: boolean} | null>}
+ *   the entry, or `null` when the base provider does not serve it
+ * @see https://github.com/link-assistant/agent/issues/313
+ */
+async function resolveEntryWithinProvider(
+  modelArg,
+  baseProviderID,
+  baseModelID
+) {
+  if (modelArg.toLowerCase() === 'same') {
+    return {
+      providerID: baseProviderID,
+      modelID: baseModelID,
+      useSameModel: true,
+    };
+  }
+
+  if (modelArg.includes('/')) {
+    const parts = modelArg.split('/');
+    if (parts[0] !== baseProviderID) {
+      return null;
+    }
+    return {
+      providerID: parts[0],
+      modelID: parts.slice(1).join('/'),
+      useSameModel: false,
+    };
+  }
+
+  const { Provider } = await import('../provider/provider.ts');
+  if (!(await Provider.hasModel(baseProviderID, modelArg))) {
+    return null;
+  }
+  return { providerID: baseProviderID, modelID: modelArg, useSameModel: false };
+}
+
 /**
  * Narrow a built-in compaction default to the provider the run was pointed at.
  *
@@ -376,19 +426,17 @@ async function resolveCompactionModelEntry(
  * provider keeps the shipped cascade, whose extra entries are the rate-limit
  * fallbacks it was written for.
  *
- * @param {{providerID: string, modelID: string, useSameModel: boolean}[]} entries
+ * @param {{providerID: string, modelID: string, useSameModel: boolean}[]} kept
+ *   Entries served by the base provider
+ * @param {string[]} dropped Default entries, as written, that were left out
  * @param {string} baseProviderID Provider of the model that runs the turns
  * @param {string} baseModelID Model that runs the turns
  * @returns {{providerID: string, modelID: string, useSameModel: boolean}[]}
  * @see https://github.com/link-assistant/agent/issues/307
  */
-function inheritBaseProvider(entries, baseProviderID, baseModelID) {
-  const kept = entries.filter(
-    (entry) => entry.useSameModel || entry.providerID === baseProviderID
-  );
-  const dropped = entries.filter((entry) => !kept.includes(entry));
+function inheritBaseProvider(kept, dropped, baseProviderID, baseModelID) {
   if (dropped.length === 0) {
-    return entries;
+    return kept;
   }
 
   const inherited =
@@ -407,7 +455,9 @@ function inheritBaseProvider(entries, baseProviderID, baseModelID) {
     hint: 'Secondary calls (compaction, session summary) inherit --model unless a compaction model is named explicitly',
     baseProviderID,
     baseModelID,
-    dropped: dropped.map((entry) => `${entry.providerID}/${entry.modelID}`),
+    // The names as written in the default: they were never resolved, so they
+    // say nothing about which provider would have served them (#313).
+    dropped,
     kept: inherited.map((entry) =>
       entry.useSameModel ? 'same' : `${entry.providerID}/${entry.modelID}`
     ),
@@ -459,9 +509,30 @@ async function parseCompactionModelConfig(
   const modelNames = parseLinksNotationSequence(compactionModelsArg);
 
   if (modelNames.length > 0) {
-    // Resolve each model in the cascade
+    // A cascade nobody asked for must not reach across providers (#307), and
+    // is not even resolved against other providers (#313).
+    const builtInCascade =
+      compactionModelsSource === 'default' &&
+      getDefaultCompactionModelsSource(defaultOptions) === 'default';
+    const usingBuiltInCascade =
+      builtInCascade && baseProviderID !== DEFAULT_PROVIDER_ID;
+
     const compactionModels = [];
+    const unavailable = [];
     for (const name of modelNames) {
+      if (usingBuiltInCascade) {
+        const entry = await resolveEntryWithinProvider(
+          name,
+          baseProviderID,
+          baseModelID
+        );
+        if (entry) {
+          compactionModels.push(entry);
+        } else {
+          unavailable.push(name);
+        }
+        continue;
+      }
       try {
         const resolved = await resolveCompactionModelEntry(
           name,
@@ -474,6 +545,12 @@ async function parseCompactionModelConfig(
           useSameModel: resolved.useSameModel,
         });
       } catch (err) {
+        // A model nobody asked for is not an error worth a record of its
+        // own (#313); the summary below lists it.
+        if (builtInCascade) {
+          unavailable.push(name);
+          continue;
+        }
         const logSkip =
           compactionModelsSource === 'default'
             ? Log.Default.debug
@@ -486,13 +563,13 @@ async function parseCompactionModelConfig(
       }
     }
 
-    // A cascade nobody asked for must not reach across providers (#307).
-    const usingBuiltInCascade =
-      compactionModelsSource === 'default' &&
-      getDefaultCompactionModelsSource(defaultOptions) === 'default' &&
-      baseProviderID !== DEFAULT_PROVIDER_ID;
     const cascade = usingBuiltInCascade
-      ? inheritBaseProvider(compactionModels, baseProviderID, baseModelID)
+      ? inheritBaseProvider(
+          compactionModels,
+          unavailable,
+          baseProviderID,
+          baseModelID
+        )
       : compactionModels;
 
     Log.Default.info(() => ({
@@ -501,6 +578,9 @@ async function parseCompactionModelConfig(
         m.useSameModel ? 'same' : `${m.providerID}/${m.modelID}`
       ),
       source: compactionModelsSource,
+      ...(unavailable.length > 0 && !usingBuiltInCascade
+        ? { unavailable }
+        : {}),
     }));
 
     // Use the first model as the primary compaction model (for backward compatibility)
@@ -543,9 +623,17 @@ async function parseCompactionModelConfig(
     compactionModelSource === 'default' &&
     getDefaultCompactionModelSource(defaultOptions) === 'default' &&
     baseProviderID !== DEFAULT_PROVIDER_ID;
-  const [entry] = usingBuiltInCompactionModel
-    ? inheritBaseProvider([resolved], baseProviderID, baseModelID)
-    : [resolved];
+  const [entry] =
+    usingBuiltInCompactionModel &&
+    !resolved.useSameModel &&
+    resolved.providerID !== baseProviderID
+      ? inheritBaseProvider(
+          [],
+          [compactionModelArg],
+          baseProviderID,
+          baseModelID
+        )
+      : [resolved];
 
   Log.Default.info(() => ({
     message: 'using single compaction model',

package/src/config/host-config-hint.ts

@@ -0,0 +1,62 @@
+import os from 'os';
+import path from 'path';
+
+/**
+ * Host integration contract: how an embedding host hands the CLI its config.
+ *
+ * A host supplies configuration through the CLI's own variables:
+ *
+ *   LINK_ASSISTANT_AGENT_CONFIG_DIR      a directory holding opencode.json(c)
+ *   LINK_ASSISTANT_AGENT_CONFIG          a single config file
+ *   LINK_ASSISTANT_AGENT_CONFIG_CONTENT  the config itself, as JSON
+ *
+ * Relocating `XDG_CONFIG_HOME` to feed the CLI a generated config also moves
+ * the config home of every tool the agent runs — `gh` then finds no
+ * `hosts.yml` and the session loses GitHub authentication (#314). This module
+ * spots that setup so the CLI can point the host at the variables above.
+ *
+ * @see https://github.com/link-assistant/agent/issues/314
+ * @see ../../../docs/host-integration.md
+ */
+export namespace HostConfigHint {
+  export const CONFIG_ENV_VARS = [
+    'LINK_ASSISTANT_AGENT_CONFIG_DIR',
+    'LINK_ASSISTANT_AGENT_CONFIG',
+    'LINK_ASSISTANT_AGENT_CONFIG_CONTENT',
+  ] as const;
+
+  export interface Hint {
+    message: string;
+    xdgConfigHome: string;
+    realConfigHome: string;
+    hint: string;
+  }
+
+  /**
+   * Return a hint when `XDG_CONFIG_HOME` points away from the user's real
+   * config home and none of the CLI's own config variables is set — the
+   * signature of a host relocating XDG to deliver config. Pure, so it can be
+   * tested with any environment.
+   */
+  export function detect(
+    env: Record<string, string | undefined> = process.env,
+    homedir: string = os.homedir()
+  ): Hint | undefined {
+    const xdgConfigHome = env.XDG_CONFIG_HOME?.trim();
+    if (!xdgConfigHome) return undefined;
+
+    const realConfigHome = path.join(homedir, '.config');
+    if (path.resolve(xdgConfigHome) === path.resolve(realConfigHome)) {
+      return undefined;
+    }
+
+    if (CONFIG_ENV_VARS.some((name) => env[name]?.trim())) return undefined;
+
+    return {
+      message: 'XDG_CONFIG_HOME is relocated',
+      xdgConfigHome,
+      realConfigHome,
+      hint: `To supply agent config, set ${CONFIG_ENV_VARS.join(', ')} instead of XDG_CONFIG_HOME: tools the agent runs (gh, git) read their config and credentials from XDG_CONFIG_HOME too`,
+    };
+  }
+}

package/src/index.js

@@ -7,6 +7,7 @@ import {
   getConfigSnapshot,
 } from './config/config.ts';
 import { setProcessName } from './cli/process-name.ts';
+import { HostConfigHint } from './config/host-config-hint.ts';
 setProcessName('agent');
 import { Server } from './server/server.ts';
 import { Instance } from './project/instance.ts';
@@ -909,6 +910,13 @@ async function main() {
           config: getConfigSnapshot(),
         }));
 
+        // A host that relocates XDG_CONFIG_HOME to deliver agent config also
+        // hides gh/git credentials from the agent's tool calls (#314).
+        const hostConfigHint = HostConfigHint.detect();
+        if (hostConfigHint) {
+          Log.Default.warn(() => hostConfigHint);
+        }
+
         // Global fetch monkey-patch for verbose HTTP logging (#221).
         if (!globalThis.__agentVerboseFetchInstalled) {
           globalThis.fetch = createVerboseFetch(globalThis.fetch, {

package/src/provider/cache.ts

@@ -15,7 +15,11 @@
  * @see https://github.com/link-foundation/lino-objects-codec
  */
 
-import type { LanguageModelV2, LanguageModelV2CallOptions } from 'ai';
+import type {
+  LanguageModelV4,
+  LanguageModelV4CallOptions,
+  LanguageModelV4GenerateResult,
+} from '@ai-sdk/provider';
 import { Log } from '../util/log';
 import { createEchoModel } from './echo';
 import { readFileSync, writeFileSync, existsSync, mkdirSync } from 'fs';
@@ -33,7 +37,7 @@ const CACHE_ROOT = join(__dirname, '../../data/api-cache');
  * Generate a cache key from the prompt
  */
 function generateCacheKey(
-  prompt: LanguageModelV2CallOptions['prompt']
+  prompt: LanguageModelV4CallOptions['prompt']
 ): string {
   // Simple hash of the prompt content
   const content = JSON.stringify(prompt);
@@ -64,14 +68,43 @@ function generatePartId(): string {
 /**
  * Load cached response from file using Links Notation format
  */
-function loadCachedResponse(filePath: string): any | null {
+function loadCachedResponse(
+  filePath: string
+): LanguageModelV4GenerateResult | null {
   try {
     if (!existsSync(filePath)) {
       return null;
     }
     const content = readFileSync(filePath, 'utf8');
     // Decode from Links Notation format
-    return decode({ notation: content });
+    const cached = decode({ notation: content });
+    // Existing .lino files may contain AI SDK 6 responses. Normalize their
+    // finish reason and usage so they remain usable by AI SDK 7.
+    if (typeof cached?.finishReason === 'string') {
+      const promptTokens = cached.usage?.promptTokens ?? 0;
+      const completionTokens = cached.usage?.completionTokens ?? 0;
+      return {
+        ...cached,
+        finishReason: {
+          unified: cached.finishReason,
+          raw: cached.finishReason,
+        },
+        usage: {
+          inputTokens: {
+            total: promptTokens,
+            noCache: promptTokens,
+            cacheRead: 0,
+            cacheWrite: 0,
+          },
+          outputTokens: {
+            total: completionTokens,
+            text: completionTokens,
+            reasoning: 0,
+          },
+        },
+      };
+    }
+    return cached;
   } catch (error: any) {
     log.warn('Failed to load cached response', {
       filePath,
@@ -104,21 +137,21 @@ function saveCachedResponse(filePath: string, response: any): void {
 
 /**
  * Creates a cache language model that stores/retrieves responses
- * Implements LanguageModelV2 interface for AI SDK 6.x compatibility
+ * Implements the AI SDK 7 language model interface.
  */
 export function createCacheModel(
   providerId: string,
   modelId: string
-): LanguageModelV2 {
-  const model: LanguageModelV2 = {
-    specificationVersion: 'v2',
+): LanguageModelV4 {
+  const model: LanguageModelV4 = {
+    specificationVersion: 'v4',
     provider: 'link-assistant',
     modelId: `${providerId}/${modelId}`,
 
     // No external URLs are supported by this synthetic provider
     supportedUrls: {},
 
-    async doGenerate(options: LanguageModelV2CallOptions) {
+    async doGenerate(options: LanguageModelV4CallOptions) {
       const cacheKey = generateCacheKey(options.prompt);
       const cachePath = getCachePath(providerId, modelId, cacheKey);
 
@@ -144,7 +177,7 @@ export function createCacheModel(
       return response;
     },
 
-    async doStream(options: LanguageModelV2CallOptions) {
+    async doStream(options: LanguageModelV4CallOptions) {
       const cacheKey = generateCacheKey(options.prompt);
       const cachePath = getCachePath(providerId, modelId, cacheKey);
 
@@ -163,7 +196,7 @@ export function createCacheModel(
           cached.content?.[0]?.text || cached.text || 'Cached response';
         const textPartId = generatePartId();
 
-        // Create a ReadableStream with LanguageModelV2StreamPart format
+        // Create a ReadableStream with LanguageModelV4StreamPart format.
         const stream = new ReadableStream({
           async start(controller) {
             // Emit text-start
@@ -195,10 +228,19 @@ export function createCacheModel(
             // Emit finish event
             controller.enqueue({
               type: 'finish',
-              finishReason: 'stop',
+              finishReason: { unified: 'stop', raw: 'stop' },
               usage: cached.usage || {
-                promptTokens: Math.ceil(echoText.length / 4),
-                completionTokens: Math.ceil(echoText.length / 4),
+                inputTokens: {
+                  total: Math.ceil(echoText.length / 4),
+                  noCache: Math.ceil(echoText.length / 4),
+                  cacheRead: 0,
+                  cacheWrite: 0,
+                },
+                outputTokens: {
+                  total: Math.ceil(echoText.length / 4),
+                  text: Math.ceil(echoText.length / 4),
+                  reasoning: 0,
+                },
               },
               providerMetadata: undefined,
             });
@@ -211,7 +253,6 @@ export function createCacheModel(
           stream,
           request: undefined,
           response: undefined,
-          warnings: [],
         };
       }
 
@@ -237,7 +278,7 @@ export function createCacheModel(
  */
 export function createCacheProvider(options?: { name?: string }) {
   return {
-    languageModel(modelId: string): LanguageModelV2 {
+    languageModel(modelId: string): LanguageModelV4 {
       // Parse provider/model from modelId like "opencode/grok-code"
       const parts = modelId.split('/');
       if (parts.length < 2) {

package/src/provider/echo.ts

@@ -14,7 +14,10 @@
  *   Input: "How are you?" -> Output: "How are you?"
  */
 
-import type { LanguageModelV2, LanguageModelV2CallOptions } from 'ai';
+import type {
+  LanguageModelV4,
+  LanguageModelV4CallOptions,
+} from '@ai-sdk/provider';
 import { Log } from '../util/log';
 
 const log = Log.create({ service: 'provider.echo' });
@@ -23,7 +26,7 @@ const log = Log.create({ service: 'provider.echo' });
  * Extract text content from the prompt messages
  */
 function extractTextFromPrompt(
-  prompt: LanguageModelV2CallOptions['prompt']
+  prompt: LanguageModelV4CallOptions['prompt']
 ): string {
   const textParts: string[] = [];
 
@@ -52,18 +55,18 @@ function generatePartId(): string {
 
 /**
  * Creates an echo language model that echoes back the user's input
- * Implements LanguageModelV2 interface for AI SDK 6.x compatibility
+ * Implements the AI SDK 7 language model interface.
  */
-export function createEchoModel(modelId: string = 'echo'): LanguageModelV2 {
-  const model: LanguageModelV2 = {
-    specificationVersion: 'v2',
+export function createEchoModel(modelId: string = 'echo'): LanguageModelV4 {
+  const model: LanguageModelV4 = {
+    specificationVersion: 'v4',
     provider: 'link-assistant',
     modelId,
 
     // No external URLs are supported by this synthetic provider
     supportedUrls: {},
 
-    async doGenerate(options: LanguageModelV2CallOptions) {
+    async doGenerate(options: LanguageModelV4CallOptions) {
       const echoText = extractTextFromPrompt(options.prompt);
       log.info('echo generate', { modelId, echoText });
 
@@ -78,10 +81,19 @@ export function createEchoModel(modelId: string = 'echo'): LanguageModelV2 {
             text: echoText,
           },
         ],
-        finishReason: 'stop' as const,
+        finishReason: { unified: 'stop' as const, raw: 'stop' },
         usage: {
-          promptTokens,
-          completionTokens,
+          inputTokens: {
+            total: promptTokens,
+            noCache: promptTokens,
+            cacheRead: 0,
+            cacheWrite: 0,
+          },
+          outputTokens: {
+            total: completionTokens,
+            text: completionTokens,
+            reasoning: 0,
+          },
         },
         warnings: [],
         providerMetadata: undefined,
@@ -90,7 +102,7 @@ export function createEchoModel(modelId: string = 'echo'): LanguageModelV2 {
       };
     },
 
-    async doStream(options: LanguageModelV2CallOptions) {
+    async doStream(options: LanguageModelV4CallOptions) {
       const echoText = extractTextFromPrompt(options.prompt);
       log.info('echo stream', { modelId, echoText });
 
@@ -100,8 +112,7 @@ export function createEchoModel(modelId: string = 'echo'): LanguageModelV2 {
 
       const textPartId = generatePartId();
 
-      // Create a ReadableStream with LanguageModelV2StreamPart format
-      // V2 format uses: text-start -> text-delta (with delta) -> text-end -> finish
+      // Stream text-start -> text-delta -> text-end -> finish.
       const stream = new ReadableStream({
         async start(controller) {
           // Emit text-start
@@ -133,10 +144,19 @@ export function createEchoModel(modelId: string = 'echo'): LanguageModelV2 {
           // Emit finish event with usage information
           controller.enqueue({
             type: 'finish',
-            finishReason: 'stop',
+            finishReason: { unified: 'stop', raw: 'stop' },
             usage: {
-              promptTokens,
-              completionTokens,
+              inputTokens: {
+                total: promptTokens,
+                noCache: promptTokens,
+                cacheRead: 0,
+                cacheWrite: 0,
+              },
+              outputTokens: {
+                total: completionTokens,
+                text: completionTokens,
+                reasoning: 0,
+              },
             },
             providerMetadata: undefined,
           });
@@ -149,7 +169,6 @@ export function createEchoModel(modelId: string = 'echo'): LanguageModelV2 {
         stream,
         request: undefined,
         response: undefined,
-        warnings: [],
       };
     },
   };
@@ -162,7 +181,7 @@ export function createEchoModel(modelId: string = 'echo'): LanguageModelV2 {
  */
 export function createEchoProvider(options?: { name?: string }) {
   return {
-    languageModel(modelId: string): LanguageModelV2 {
+    languageModel(modelId: string): LanguageModelV4 {
       return createEchoModel(modelId);
     },
     textEmbeddingModel() {

package/src/provider/opencode-zen.ts

@@ -90,8 +90,7 @@ export namespace OpenCodeZen {
     }
 
     const body = (await response.json().catch(() => undefined)) as
-      | { data?: Array<{ id?: unknown }> }
-      | undefined;
+      { data?: Array<{ id?: unknown }> } | undefined;
     const rows = Array.isArray(body?.data) ? body.data : [];
     return new Set(
       rows

package/src/provider/provider.ts

@@ -38,6 +38,14 @@ import { createGroq } from '@ai-sdk/groq';
 
 export namespace Provider {
   const log = Log.create({ service: 'provider' });
+  /**
+   * Catalog lookups — which providers are installed, which provider a short
+   * model name would map to — describe candidates, not the model a run uses.
+   * They are logged under their own service and never carry `providerID` /
+   * `modelID` fields, which stream consumers read as the run's model identity
+   * (#313). The active model is attested by the `model_resolved` event.
+   */
+  const registryLog = Log.create({ service: 'provider-registry' });
 
   /**
    * Bundled providers - these are pre-installed and imported statically
@@ -722,9 +730,9 @@ export namespace Provider {
     'link-assistant': async () => {
       // Echo provider is always available - no external dependencies needed
       return {
-        autoload: config.dryRun, // Auto-load only in dry-run mode
+        autoload: true, // Also available through --model link-assistant/echo
         async getModel(_sdk: any, modelID: string) {
-          // Return our custom echo model that implements LanguageModelV1
+          // Return our custom AI SDK language model.
           return createEchoModel(modelID);
         },
         options: {},
@@ -754,7 +762,7 @@ export namespace Provider {
           const [providerId, ...modelParts] = parts;
           const actualModelId = modelParts.join('/');
 
-          // Return our custom cache model that implements LanguageModelV1
+          // Return our custom AI SDK language model.
           return createCacheModel(providerId, actualModelId);
         },
         options: {},
@@ -1235,8 +1243,11 @@ export namespace Provider {
         delete providers[providerID];
         continue;
       }
-      log.info(() => ({ message: 'found', providerID }));
     }
+    registryLog.info(() => ({
+      message: 'providers available',
+      available: Object.keys(providers),
+    }));
 
     return {
       models,
@@ -1696,6 +1707,15 @@ export namespace Provider {
     return state().then((s) => s.providers[providerID]);
   }
 
+  /**
+   * Whether a provider's catalog lists a model. Looks at that one provider
+   * only and logs nothing (#313).
+   */
+  export async function hasModel(providerID: string, modelID: string) {
+    const provider = await getProvider(providerID);
+    return Boolean(provider?.info.models[modelID]);
+  }
+
   async function getLiveModelInfo(providerID: string, modelID: string) {
     if (providerID !== 'opencode') return undefined;
     return OpenCodeZen.getLiveFreeModelInfo(modelID);
@@ -1752,8 +1772,16 @@ export namespace Provider {
     const isSyntheticProvider =
       providerID === 'link-assistant' || providerID === 'link-assistant/cache';
 
-    // For synthetic providers, we don't need model info from the database
-    let info = isSyntheticProvider ? null : provider.info.models[modelID];
+    // Synthetic models still need metadata for context limits and accounting.
+    let info =
+      provider.info.models[modelID] ??
+      (isSyntheticProvider
+        ? {
+            ...s.providers['link-assistant'].info.models.echo,
+            id: modelID,
+            name: modelID,
+          }
+        : undefined);
     if (!isSyntheticProvider && !info) {
       // Model not in provider's known list - try refreshing the cache first (#200)
       // This handles stale bundled data or expired cache (1-hour TTL)
@@ -2084,9 +2112,10 @@ export namespace Provider {
     if (kiloUniqueModels.includes(modelID)) {
       const kiloProvider = s.providers['kilo'];
       if (kiloProvider && kiloProvider.info.models[modelID]) {
-        log.info(() => ({
+        registryLog.info(() => ({
           message: 'resolved short model name to kilo (unique)',
-          modelID,
+          name: modelID,
+          candidate: `kilo/${modelID}`,
         }));
         return { providerID: 'kilo', modelID };
       }
@@ -2095,9 +2124,10 @@ export namespace Provider {
     if (modelID === 'formal-ai') {
       const formalAiProvider = s.providers['formal-ai'];
       if (formalAiProvider && formalAiProvider.info.models[modelID]) {
-        log.info(() => ({
+        registryLog.info(() => ({
           message: 'resolved short model name to formal-ai (canonical)',
-          modelID,
+          name: modelID,
+          candidate: `formal-ai/${modelID}`,
         }));
         return { providerID: 'formal-ai', modelID };
       }
@@ -2117,10 +2147,10 @@ export namespace Provider {
 
     if (matchingProviders.length === 1) {
       const providerID = matchingProviders[0];
-      log.info(() => ({
+      registryLog.info(() => ({
         message: 'resolved short model name (single match)',
-        modelID,
-        providerID,
+        name: modelID,
+        candidate: `${providerID}/${modelID}`,
       }));
       return { providerID, modelID };
     }
@@ -2128,9 +2158,10 @@ export namespace Provider {
     // Multiple providers have this model - prefer OpenCode for shared free models
     // This follows the convention that opencode is the primary free provider
     if (matchingProviders.includes('opencode')) {
-      log.info(() => ({
+      registryLog.info(() => ({
         message: 'resolved short model name to opencode (multiple providers)',
-        modelID,
+        name: modelID,
+        candidate: `opencode/${modelID}`,
         availableProviders: matchingProviders,
       }));
       return { providerID: 'opencode', modelID };
@@ -2138,10 +2169,10 @@ export namespace Provider {
 
     // Fallback to first matching provider
     const providerID = matchingProviders[0];
-    log.info(() => ({
+    registryLog.info(() => ({
       message: 'resolved short model name (fallback)',
-      modelID,
-      providerID,
+      name: modelID,
+      candidate: `${providerID}/${modelID}`,
       availableProviders: matchingProviders,
     }));
     return { providerID, modelID };

package/src/session/compaction.ts

@@ -387,7 +387,7 @@ export namespace SessionCompaction {
         headers: model.info.headers,
         abortSignal: input.abort,
         tools: model.info.tool_call ? {} : undefined,
-        system: system.map((content) => ({ role: 'system', content })),
+        instructions: system.map((content) => ({ role: 'system', content })),
         messages: [
           ...safeModelMessages,
           {

package/src/session/processor.ts

@@ -116,7 +116,7 @@ export namespace SessionProcessor {
             let reasoningMap: Record<string, MessageV2.ReasoningPart> = {};
             const stream = fn();
 
-            for await (const value of stream.fullStream) {
+            for await (const value of stream.stream) {
               input.abort.throwIfAborted();
               switch (value.type) {
                 case 'start':

package/src/session/prompt.ts

@@ -15,7 +15,7 @@ import {
   type Tool as AITool,
   tool,
   wrapLanguageModel,
-  stepCountIs,
+  isStepCount,
   jsonSchema,
 } from 'ai';
 import { SessionCompaction } from './compaction';
@@ -1011,10 +1011,10 @@ export namespace SessionPrompt {
             model.providerID,
             params.options
           ),
-          stopWhen: stepCountIs(1),
+          stopWhen: isStepCount(1),
           temperature: params.temperature,
           topP: params.topP,
-          system: system.map((content) => ({ role: 'system', content })),
+          instructions: system.map((content) => ({ role: 'system', content })),
           messages: safeModelMessages,
           tools: model.info?.tool_call === false ? undefined : tools,
           model: wrapLanguageModel({
@@ -1059,6 +1059,9 @@ export namespace SessionPrompt {
     if (input.model) {
       return input.model;
     }
+    if (config.dryRun) {
+      return Provider.defaultModel();
+    }
     if (input.agent.model) {
       return input.agent.model;
     }
@@ -1942,7 +1945,7 @@ export namespace SessionPrompt {
         small.providerID,
         options
       ),
-      system: safeTitleSystemMessages.map((content) => ({
+      instructions: safeTitleSystemMessages.map((content) => ({
         role: 'system',
         content,
       })),

package/src/session/summary.ts

@@ -222,10 +222,10 @@ export namespace SessionSummary {
           model.providerID,
           {}
         ),
-        // The system prompt belongs in `system`, not in `messages`: the AI SDK
+        // The system prompt belongs in `instructions`, not in `messages`: the AI SDK
         // warns that a system message inside `messages` enables prompt
         // injection, and providers are free to treat it as ordinary content.
-        system: systemPrompts.map((content) => ({
+        instructions: systemPrompts.map((content) => ({
           role: 'system' as const,
           content,
         })),