dsh-opencode-go 0.1.6 → 0.1.8

package/lib/index.js

@@ -308,9 +308,13 @@ function flattenText(message) {
 function toolResultText(blocks) {
   return blocks.map((block) => block.type === "text" ? block.text : block.type === "tool-result" ? toolResultText(block.content) : "").join("");
 }
+function toolMessage(message) {
+  if (message.role !== "tool") return void 0;
+  return message;
+}
 function assertSupportedImageRoles(messages) {
   for (const message of messages) {
-    if (message.role !== "user" && contentHasImage(message.content)) {
+    if (message.role !== "user" && !toolMessage(message) && contentHasImage(message.content)) {
       throw new LlmError3(
         `pi-ai cannot represent an image in an in-history ${message.role} message`,
         "UNSUPPORTED_CONTENT"
@@ -417,6 +421,18 @@ function textOnlyContext(options, onReplayDegrade) {
     if (contentHasImage(message.content)) {
       throw new LlmError3("pi-ai image conversion requires the durable attachment service", "UNSUPPORTED_CONTENT");
     }
+    const tool = toolMessage(message);
+    if (tool) {
+      messages.push({
+        role: "toolResult",
+        toolCallId: tool.toolCallId,
+        toolName: toolNames.get(tool.toolCallId) ?? "unknown",
+        content: [{ type: "text", text: toolResultText(tool.content) || "(no output)" }],
+        isError: tool.isError ?? false,
+        timestamp: 0
+      });
+      continue;
+    }
     if (message.role === "system") {
       messages.push({ role: "user", content: flattenText(message), timestamp: 0 });
       continue;
@@ -480,6 +496,19 @@ async function toPiContextWithImages(options, images, onReplayDegrade) {
   const toolNames = /* @__PURE__ */ new Map();
   const messages = [];
   for (const message of exactMessages) {
+    const tool = toolMessage(message);
+    if (tool) {
+      const content2 = await userContent(tool.content, requestImages, resolveImageAccess);
+      messages.push({
+        role: "toolResult",
+        toolCallId: tool.toolCallId,
+        toolName: toolNames.get(tool.toolCallId) ?? "unknown",
+        content: typeof content2 === "string" ? [{ type: "text", text: content2 || "(no output)" }] : content2,
+        isError: tool.isError ?? false,
+        timestamp: 0
+      });
+      continue;
+    }
     if (message.role === "system") {
       messages.push({ role: "user", content: flattenText(message), timestamp: 0 });
       continue;
@@ -676,6 +705,54 @@ import { openAICompletionsApi } from "@earendil-works/pi-ai/api/openai-completio
 import { openAIResponsesApi } from "@earendil-works/pi-ai/api/openai-responses.lazy";
 import { attributionHeaders, LlmError as LlmError5 } from "@deepseek-ai/dsh-llm";
 
+// src/models-contract.ts
+function validReleaseDate(value) {
+  return typeof value === "string" && /^\d{4}-\d{2}-\d{2}$/.test(value) && Number.isFinite(Date.parse(value)) && new Date(value).toISOString().slice(0, 10) === value;
+}
+function isNewModel(model, now = Date.now()) {
+  if (model.deprecated || !validReleaseDate(model.releaseDate)) return false;
+  const days = Math.floor(now / 864e5) - Date.parse(model.releaseDate) / 864e5;
+  return days >= 0 && days < 7;
+}
+function sortModels(models, now = Date.now()) {
+  const rank = (model) => model.deprecated ? 2 : isNewModel(model, now) ? 0 : 1;
+  return [...models].sort((a, b) => rank(a) - rank(b) || (isNewModel(a, now) && isNewModel(b, now) ? b.releaseDate.localeCompare(a.releaseDate) : 0));
+}
+function parseGoModels(value) {
+  if (!Array.isArray(value)) throw new Error("Invalid OpenCode Go model list");
+  return value.map((entry) => {
+    if (!entry || typeof entry !== "object") throw new Error("Invalid OpenCode Go model");
+    const row = entry;
+    if (typeof row.id !== "string" || !row.id) throw new Error("Missing OpenCode Go model id");
+    const model = { id: row.id };
+    if (typeof row.name === "string") model.name = row.name;
+    for (const key of ["contextWindow", "maxTokens"]) {
+      if (typeof row[key] === "number" && Number.isSafeInteger(row[key]) && row[key] > 0) model[key] = row[key];
+    }
+    if (typeof row.deprecated === "boolean") model.deprecated = row.deprecated;
+    if (validReleaseDate(row.releaseDate)) model.releaseDate = row.releaseDate;
+    return model;
+  });
+}
+var codec = {
+  mode: "strict",
+  typeSymbol: "dsh-opencode-go#GoModels",
+  schema: { parse: parseGoModels },
+  create: () => ({ parse: parseGoModels })
+};
+var modelsRemote = {
+  package: "dsh-opencode-go",
+  descriptors: [{
+    id: "dsh-opencode-go#opencodeGoModels/read",
+    service: "opencodeGoModels",
+    namespace: "opencodeGoModels",
+    method: "read",
+    invocation: { kind: "direct" },
+    parameters: [],
+    result: codec
+  }]
+};
+
 // src/model-metadata.ts
 var MODEL_METADATA_URL = "https://models.dev/api.json";
 function record(value) {
@@ -726,7 +803,13 @@ function readModelMetadata(body, baseURL, builtin) {
   const entries = record(provider.models);
   const models = /* @__PURE__ */ new Map();
   const errors = /* @__PURE__ */ new Map();
+  const details = /* @__PURE__ */ new Map();
   for (const [id, value] of Object.entries(entries)) {
+    const data = record(value);
+    details.set(id, {
+      deprecated: data.status === "deprecated",
+      ...validReleaseDate(data.release_date) ? { releaseDate: data.release_date } : {}
+    });
     try {
       const metadata = record(value);
       const npm = record(metadata.provider).npm ?? provider.npm;
@@ -772,7 +855,7 @@ function readModelMetadata(body, baseURL, builtin) {
       errors.set(id, error instanceof Error ? error.message : String(error));
     }
   }
-  return { models, errors };
+  return { models, errors, details };
 }
 
 // src/catalog.ts
@@ -887,9 +970,10 @@ var OpencodeGoCatalog = class {
       this.onFallback({ url: MODEL_METADATA_URL, error: metadataResult.reason, kept: known.size });
     }
     if (listing.status === "rejected") {
-      const models2 = this.served?.models ?? known;
+      const models2 = this.served?.models ?? /* @__PURE__ */ new Map();
       this.onFallback({ url: `${this.baseURL.replace(/\/+$/, "")}/models`, error: listing.reason, kept: models2.size });
       return {
+        details: this.served?.details ?? /* @__PURE__ */ new Map(),
         models: models2,
         unavailable: this.served?.unavailable ?? /* @__PURE__ */ new Map(),
         provider: buildProvider(this.baseURL, [...models2.values()]),
@@ -910,6 +994,7 @@ var OpencodeGoCatalog = class {
     }
     if (unavailable.size > 0) this.onOmitted([...unavailable.keys()]);
     return {
+      details: new Map(listing.value.map((id) => [id, metadata?.details.get(id) ?? {}])),
       models,
       unavailable,
       provider: buildProvider(this.baseURL, [...models.values()]),
@@ -936,6 +1021,9 @@ async function discoverCatalogModels(catalog) {
   if (!snapshot.live) {
     throw new LlmError5("llm-opencode-go: the live model listing is unreachable; try again later", "DISCOVERY_FAILED");
   }
+  return describeCatalog(snapshot);
+}
+function describeCatalog(snapshot) {
   return [
     ...[...snapshot.models.values()].map((model) => ({
       id: model.id,
@@ -946,6 +1034,11 @@ async function discoverCatalogModels(catalog) {
     ...[...snapshot.unavailable].map(([id, reason]) => ({ id, name: `${id} (metadata unavailable: ${reason})` }))
   ];
 }
+async function discoverSettingsModels(catalog) {
+  const snapshot = await catalog.snapshot(true);
+  if (!snapshot.live) throw new LlmError5("llm-opencode-go: the live model listing is unreachable; try again later", "DISCOVERY_FAILED");
+  return sortModels(describeCatalog(snapshot).map((model) => ({ ...model, ...snapshot.details.get(model.id) })));
+}
 
 // src/config.ts
 import { MAX_TIMER_DELAY_MS } from "@deepseek-ai/dsh-timeout";
@@ -953,8 +1046,9 @@ import z from "@deepseek-ai/schemastery";
 var DEFAULT_API_KEY_ENV = "OPENCODE_API_KEY";
 var DEFAULT_REFRESH_MINUTES = 60;
 var DEFAULT_STREAM_IDLE_TIMEOUT_MS = 3e5;
-var Config = z.object({
+var fields = {
   enabled: z.boolean().default(true),
+  showDeprecatedModels: z.boolean().default(false),
   apiKeyEnv: z.string().role("credential-ref").default(DEFAULT_API_KEY_ENV),
   baseURL: z.string().default(DEFAULT_BASE_URL),
   refreshMinutes: z.number().step(1).min(1).max(7 * 24 * 60).default(DEFAULT_REFRESH_MINUTES),
@@ -963,8 +1057,20 @@ var Config = z.object({
   // request image fits the budget, and fifteen of them fit the payload cap.
   maxRequestImageBytes: z.number().step(1).min(1).default(DEFAULT_MAX_REQUEST_IMAGE_BYTES),
   requestImagePixelBudget: z.number().step(1).min(1).default(DEFAULT_REQUEST_IMAGE_PIXEL_BUDGET),
-  requestImageMaxBytes: z.number().step(1).min(1).default(DEFAULT_REQUEST_IMAGE_MAX_BYTES)
-});
+  requestImageMaxBytes: z.number().step(1).min(1).default(DEFAULT_REQUEST_IMAGE_MAX_BYTES),
+  // null explicitly selects catalog values, overriding even inherited profile limits.
+  modelLimits: z.dict(z.union([z.const(null), z.object({
+    contextWindow: z.union([z.const(null), z.number().step(1).min(1).max(Number.MAX_SAFE_INTEGER)]),
+    maxTokens: z.union([z.const(null), z.number().step(1).min(1).max(Number.MAX_SAFE_INTEGER)])
+  })])).default({})
+};
+var PlainConfig = z.object(fields);
+var Config = z.object(Object.fromEntries(
+  Object.entries(fields).map(([key, schema]) => [key, schema.volatile()])
+));
+function readConfig(config) {
+  return Object.fromEntries(Object.entries(config).map(([key, value]) => [key, value.get()]));
+}
 function assertBaseURL(raw) {
   let url;
   try {
@@ -982,6 +1088,15 @@ function assertBaseURL(raw) {
 }
 
 // src/adapter.ts
+function withModelLimit(model, limits) {
+  const limit = limits[model.id];
+  if (limit == null) return model;
+  return {
+    ...model,
+    contextWindow: limit.contextWindow ?? model.contextWindow,
+    maxTokens: limit.maxTokens ?? model.maxTokens
+  };
+}
 function opencodeSessionValue(sessionId) {
   return sessionId !== void 0 && sessionId.length > 0 ? sessionId : randomUUID();
 }
@@ -1001,9 +1116,8 @@ var OpencodeGoAdapter = class extends LlmAdapter {
    * The catalog resolver for one configuration, rebuilding on the facts it
    * owns. Public for the plugin's discovery registration, which resolves the
    * current configuration the same way the adapter does.
-   * @param config - the configuration whose endpoint and refresh interval the
-   *   resolver serves; a change to either yields a fresh resolver.
-   * @returns the resolver caching one snapshot per endpoint/refresh pair.
+   * @param config - the endpoint and refresh interval for the raw catalog.
+   * @returns the resolver caching catalog values, independent of deployment limits.
    */
   catalogOf(config) {
     const key = `${config.baseURL}|${String(config.refreshMinutes)}`;
@@ -1028,8 +1142,9 @@ var OpencodeGoAdapter = class extends LlmAdapter {
     return { id: provider, name: DISPLAY_NAME };
   }
   async listModels(_provider) {
-    const snapshot = await this.catalogOf(this.options.config()).snapshot(true);
-    return [...snapshot.models.values()].map((model) => ({
+    const config = this.options.config();
+    const snapshot = await this.catalogOf(config).snapshot(true);
+    return [...snapshot.models.values()].filter((model) => config.showDeprecatedModels || !snapshot.details.get(model.id)?.deprecated).map((model) => ({
       provider: PROVIDER_ID,
       id: model.id,
       name: model.name,
@@ -1037,12 +1152,13 @@ var OpencodeGoAdapter = class extends LlmAdapter {
     }));
   }
   async resolveModel(_provider, model, _signal) {
-    const snapshot = await this.catalogOf(this.options.config()).forModel(model);
+    const config = this.options.config();
+    const snapshot = await this.catalogOf(config).forModel(model);
     const resolved = snapshot.models.get(model);
     if (resolved === void 0) {
       throw new LlmError6(`opencode-go has no model "${model}"`, "UNKNOWN_MODEL");
     }
-    return this.modelInfo(resolved);
+    return this.modelInfo(withModelLimit(resolved, config.modelLimits));
   }
   /** Describe one model: capacities plus the reasoning levels it actually offers. */
   modelInfo(model) {
@@ -1083,10 +1199,13 @@ var OpencodeGoAdapter = class extends LlmAdapter {
       }
       const config = this.options.config();
       const snapshot = await this.catalogOf(config).forModel(options.model);
-      const model = snapshot.models.get(options.model);
-      if (model === void 0) {
+      const advertised = snapshot.models.get(options.model);
+      if (advertised === void 0) {
         throw new LlmError6(`opencode-go has no model "${options.model}"`, "UNKNOWN_MODEL");
       }
+      const model = withModelLimit(advertised, config.modelLimits);
+      const outputLimit = config.modelLimits[model.id]?.maxTokens;
+      const maxTokens = outputLimit == null ? options.maxTokens : Math.min(options.maxTokens ?? outputLimit, outputLimit);
       const apiKey = await this.options.resolveApiKey();
       if (apiKey === void 0 || apiKey.length === 0) {
         throw new LlmError6("llm-opencode-go: no credential resolved for the route", "MISSING_CREDENTIAL");
@@ -1122,7 +1241,7 @@ var OpencodeGoAdapter = class extends LlmAdapter {
           apiKey,
           ...reasoning === void 0 || reasoning === "off" ? {} : { reasoning },
           ...options.temperature === void 0 ? {} : { temperature: options.temperature },
-          ...options.maxTokens === void 0 ? {} : { maxTokens: options.maxTokens },
+          ...maxTokens === void 0 ? {} : { maxTokens },
           ...options.sessionId === void 0 ? {} : { sessionId: String(options.sessionId) },
           signal: watchdog.signal,
           // Harness-owned request identity: the gateway refuses requests without
@@ -1218,15 +1337,6 @@ var GoUsageService = class extends TypertRemoteService {
   constructor(ctx, options) {
     super(ctx, "opencodeGoUsage");
     this.options = options;
-    ctx.inject(["typert"], (scope) => {
-      scope.effect(() => scope.typert.register({
-        package: usageRemote.package,
-        face: "host",
-        schemas: [],
-        model: { services: [], events: [], objects: [] },
-        invocations: usageRemote.descriptors
-      }));
-    });
   }
   async read() {
     const baseURL = assertBaseURL(this.options.baseURL()).replace(/\/$/, "");
@@ -1243,14 +1353,46 @@ var GoUsageService = class extends TypertRemoteService {
   }
 };
 
+// src/models.ts
+import { TypertRemoteService as TypertRemoteService2 } from "@deepseek-ai/dsh-typert-protocol";
+var GoModelsService = class extends TypertRemoteService2 {
+  constructor(ctx, options) {
+    super(ctx, "opencodeGoModels");
+    this.options = options;
+  }
+  read() {
+    return discoverSettingsModels(this.options.catalog());
+  }
+};
+
+// src/remote-contract.ts
+var goRemote = {
+  package: "dsh-opencode-go",
+  descriptors: [...usageRemote.descriptors, ...modelsRemote.descriptors]
+};
+
+// src/remotes.ts
+function registerGoRemotes(ctx) {
+  ctx.inject(["typert"], (scope) => {
+    scope.effect(() => scope.typert.register({
+      package: goRemote.package,
+      face: "host",
+      schemas: [],
+      model: { services: [], events: [], objects: [] },
+      invocations: goRemote.descriptors
+    }));
+  });
+}
+
 // src/index.ts
 var name = "llm-opencode-go";
 var inject = ["llm"];
 var NS = "llm-opencode-go";
 function apply(ctx, raw) {
-  const entry = Config(raw);
+  const config = raw && typeof raw.enabled === "object" ? raw : Config(raw);
+  const entry = readConfig(config);
   assertBaseURL(entry.baseURL);
-  let current = () => entry;
+  let current = () => readConfig(config);
   const resolveApiKey = async () => {
     const ref = current().apiKeyEnv;
     const credentials = ctx.get("credentials");
@@ -1261,6 +1403,7 @@ function apply(ctx, raw) {
       "MISSING_CREDENTIAL"
     );
   };
+  registerGoRemotes(ctx);
   ctx.plugin(GoUsageService, { baseURL: () => current().baseURL, resolveApiKey });
   const logger = {
     fallback: ({ url, error }) => {
@@ -1287,6 +1430,8 @@ function apply(ctx, raw) {
       ctx.logger.warn(`llm-opencode-go: unusable replay state on assistant history; sending provider-neutral content (${reason})`);
     }
   });
+  ctx.plugin(GoModelsService, { catalog: () => adapter.catalogOf(current()) });
+  let pickerVisibility = current().showDeprecatedModels;
   let registration;
   const applyRoute = (configured) => {
     if (configured && current().enabled && registration === void 0) {
@@ -1304,6 +1449,10 @@ function apply(ctx, raw) {
     }
   };
   const syncRoute = () => {
+    if (pickerVisibility !== current().showDeprecatedModels) {
+      pickerVisibility = current().showDeprecatedModels;
+      registration?.replace([PROVIDER_ID]);
+    }
     const credentials = ctx.get("credentials");
     if (credentials === void 0) {
       applyRoute(launchEnvironmentOf(ctx).get(current().apiKeyEnv)?.value !== void 0);
@@ -1330,7 +1479,12 @@ function apply(ctx, raw) {
     undiscover();
   });
   ctx.inject(["settings"], (settingsCtx) => {
-    settingsCtx.settings.installSection(ctx, NS, Config, entry, {
+    if ("configure" in settingsCtx.settings) {
+      const settings = settingsCtx.settings;
+      settingsCtx.effect(() => settings.configure({ auto: false }, ctx.fiber));
+      return;
+    }
+    settingsCtx.settings.installSection(ctx, NS, PlainConfig, entry, {
       validate: (value) => {
         assertBaseURL(value.baseURL);
       },
@@ -1342,6 +1496,12 @@ function apply(ctx, raw) {
       }
     });
   });
+  ctx.on("internal/config", function(_raw, next) {
+    const value = next();
+    if (this === ctx.fiber) assertBaseURL(PlainConfig(value).baseURL);
+    return value;
+  });
+  ctx.on("loader/volatile-update", syncRoute);
   ctx.inject(["credentials"], (credentialsCtx) => {
     credentialsCtx.on("credentials/reference-updated", (ref) => {
       if (ref === current().apiKeyEnv) syncRoute();
@@ -1358,6 +1518,7 @@ export {
   OpencodeGoAdapter,
   OpencodeGoCatalog,
   PROVIDER_ID,
+  PlainConfig,
   apply,
   assertBaseURL,
   discoverCatalogModels,

package/lib/types/adapter.d.ts

@@ -82,9 +82,8 @@ export declare class OpencodeGoAdapter extends LlmAdapter {
      * The catalog resolver for one configuration, rebuilding on the facts it
      * owns. Public for the plugin's discovery registration, which resolves the
      * current configuration the same way the adapter does.
-     * @param config - the configuration whose endpoint and refresh interval the
-     *   resolver serves; a change to either yields a fresh resolver.
-     * @returns the resolver caching one snapshot per endpoint/refresh pair.
+     * @param config - the endpoint and refresh interval for the raw catalog.
+     * @returns the resolver caching catalog values, independent of deployment limits.
      */
     catalogOf(config: OpencodeGoConfig): OpencodeGoCatalog;
     providerInfo(provider: string): {

package/lib/types/catalog.d.ts

@@ -1,9 +1,12 @@
 import type { Api, Model, Provider } from '@earendil-works/pi-ai';
 import type { LlmDiscoveredModel } from '@deepseek-ai/dsh-llm';
+import { type GoModel } from './models-contract.ts';
+import type { ModelMetadata } from './model-metadata.ts';
 export declare const PROVIDER_ID = "opencode-go";
 export declare const DISPLAY_NAME = "OpenCode Go";
 export declare const DEFAULT_BASE_URL = "https://opencode.ai/zen/go/v1";
 export interface CatalogSnapshot {
+    readonly details: ModelMetadata['details'];
     readonly models: ReadonlyMap<string, Model<Api>>;
     /** Advertised ids with missing/unsupported metadata stay visible with a diagnostic. */
     readonly unavailable: ReadonlyMap<string, string>;
@@ -41,3 +44,5 @@ export declare class OpencodeGoCatalog {
 }
 /** Explicit discovery always revalidates both sources, including during the runtime TTL. */
 export declare function discoverCatalogModels(catalog: OpencodeGoCatalog): Promise<readonly LlmDiscoveredModel[]>;
+/** Settings retain deprecated gateway entries regardless of picker visibility. */
+export declare function discoverSettingsModels(catalog: OpencodeGoCatalog): Promise<readonly GoModel[]>;

package/lib/types/client/ModelEditor.d.ts

@@ -0,0 +1,13 @@
+import type { OpencodeGoModelLimit, OpencodeGoModelLimits, OpencodeGoModels } from './section-controller.ts';
+import type { en } from './locales.ts';
+type Translate = (key: keyof typeof en, params?: Record<string, unknown>) => string;
+export declare function hasCapacityOverride(limit: OpencodeGoModelLimit | null | undefined): boolean;
+/** One gateway-backed list and its selected model's staged capacity settings. */
+export declare function ModelEditor({ models, draft, t, disabled, onEdit }: {
+    models: OpencodeGoModels;
+    draft: OpencodeGoModelLimits;
+    t: Translate;
+    disabled: boolean;
+    onEdit: (next: OpencodeGoModelLimits) => void;
+}): import("react").JSX.Element;
+export {};

package/lib/types/client/locales.d.ts

@@ -28,6 +28,36 @@ export declare const en: {
     modelsFailed: string;
     modelsEmpty: string;
     modelsCount: string;
+    limitsLabel: string;
+    limitsHint: string;
+    limitsFilterLabel: string;
+    limitsFilterPlaceholder: string;
+    limitsSummary: string;
+    limitsModel: string;
+    limitsContext: string;
+    limitsOutput: string;
+    capacityDefault: string;
+    capacityMissing: string;
+    showDeprecatedLabel: string;
+    showDeprecatedHint: string;
+    pickerFailed: string;
+    deprecatedBadge: string;
+    deprecatedHint: string;
+    newHint: string;
+    releasedOn: string;
+    releaseSource: string;
+    modelDetails: string;
+    filterLabel: string;
+    filterAll: string;
+    filterNew: string;
+    filterCustom: string;
+    filterDeprecated: string;
+    limitsResetModel: string;
+    limitsResetAll: string;
+    limitsNoMatches: string;
+    limitsEmpty: string;
+    limitsContextLabel: string;
+    limitsOutputLabel: string;
     advancedLabel: string;
     advancedHint: string;
     apiKeyEnvLabel: string;

package/lib/types/client/section-controller.d.ts

@@ -9,8 +9,10 @@
  * covers everything the page shows.
  */
 import type { Context as ClientContext } from '@deepseek-ai/cordis';
+import type { RemoteResult } from '@deepseek-ai/dsh-typert-protocol';
+import type { GoModel } from '../models-contract.ts';
 import type { SnapshotStore } from '@deepseek-ai/dsh-client-store';
-import type { SettingsScope } from '@deepseek-ai/dsh-client-ui-settings/client';
+import type { SettingsScope } from './settings.ts';
 import { type FieldState, type FormActions, type FormShell } from './staged-form.ts';
 /** Namespace of the OpenCode Go adapter. Spelled here rather than imported: a client package must not depend on a Host package. */
 export declare const OPENCODE_GO_NS = "llm-opencode-go";
@@ -18,6 +20,8 @@ export declare const OPENCODE_GO_NS = "llm-opencode-go";
 export interface OpencodeGoSettings {
     /** Whether the adapter serves its route; false withdraws it from every picker. */
     enabled?: boolean;
+    /** Include gateway-served deprecated models in conversation pickers. */
+    showDeprecatedModels?: boolean;
     /** Credential reference naming the environment key. */
     apiKeyEnv?: string;
     /** The gateway endpoint; also the live listing base. */
@@ -32,7 +36,15 @@ export interface OpencodeGoSettings {
     requestImagePixelBudget?: number;
     /** Raw encoded-byte target for one request image. */
     requestImageMaxBytes?: number;
+    /** Per-model capacity overrides, keyed by the gateway model id. */
+    modelLimits?: OpencodeGoModelLimits;
 }
+/** The two capacity values the settings table can override. */
+export interface OpencodeGoModelLimit {
+    contextWindow?: number | null;
+    maxTokens?: number | null;
+}
+export type OpencodeGoModelLimits = Record<string, OpencodeGoModelLimit | null>;
 /** The gateway's model listing as the page reports it. */
 export type OpencodeGoModels = 
 /** Not asked for yet; the page asks once it mounts. */
@@ -43,11 +55,15 @@ export type OpencodeGoModels =
  | {
     readonly status: 'loading';
 }
-/** The gateway answered: how many models it serves, and a preview of their names. */
+/**
+ * The gateway answered: a count/preview for the compact summary plus every
+ * discovered entry used by the capacity editor.
+ */
  | {
     readonly status: 'ready';
     readonly count: number;
     readonly preview: readonly string[];
+    readonly entries: readonly GoModel[];
 }
 /** The listing could not be read; `message` is the Host's own diagnostic. */
  | {
@@ -62,6 +78,9 @@ export interface OpencodeGoSectionState extends FormShell {
      * a withdrawn route is what the user is trying to observe.
      */
     enabled: boolean;
+    showDeprecatedModels: boolean;
+    pickerSaving: boolean;
+    pickerFailed: boolean;
     /** Credential reference naming the environment key. */
     apiKeyEnv: FieldState;
     /** The gateway endpoint. */
@@ -84,6 +103,10 @@ export interface OpencodeGoSectionState extends FormShell {
     apiKeyWritable: boolean;
     /** The gateway's current model listing. */
     models: OpencodeGoModels;
+    /** The staged JSON field backing the capacity table. */
+    modelLimits: FieldState;
+    /** The parsed overrides currently shown by the capacity table. */
+    modelLimitDraft: OpencodeGoModelLimits;
 }
 /** The registration-side face the page's slot entry injects. */
 export interface OpencodeGoSectionFace extends FormActions {
@@ -98,24 +121,37 @@ export interface OpencodeGoSectionFace extends FormActions {
      * @param next - the state the switch asks for.
      */
     setEnabled: (next: boolean) => void;
+    setShowDeprecatedModels: (next: boolean) => void;
 }
 /** Bridges the `llm-opencode-go` scope and the credentials domain onto the page. */
 export declare class OpencodeGoSectionController {
     private readonly scope;
     private readonly ctx;
+    private readonly readModels;
     private readonly form;
     private readonly store;
     private credential;
     private models;
     private modelsRequest;
+    private pickerSaving;
+    private pickerFailed;
     private face;
+    private readonly unsubscribe;
     /**
      * @param scope - the bound settings scope for the `llm-opencode-go` namespace.
      * @param ctx - the page plugin's context, whose `remote.credentials` namespace
      *   answers for the credential the section references.
      */
-    constructor(scope: SettingsScope<OpencodeGoSettings>, ctx: ClientContext);
+    constructor(scope: SettingsScope<OpencodeGoSettings>, ctx: ClientContext, readModels?: () => Promise<RemoteResult<readonly GoModel[]>>);
+    /** Release subscriptions without disposing the host's shared form. */
+    dispose(): void;
     private projection;
+    /**
+     * Read the overrides as the page currently shows them. A staged JSON draft
+     * wins while it is valid; malformed text falls back to the last accepted
+     * settings value so the table never renders phantom rows.
+     */
+    private limitDraft;
     /**
      * The adapter's effective switch state: the resolved section's value, over
      * the Host's own default when the section carries none.
@@ -134,6 +170,8 @@ export declare class OpencodeGoSectionController {
      * @param next - the state the switch asks for.
      */
     setEnabled(next: boolean): void;
+    /** Visibility is immediate; failed writes leave the committed switch state visible. */
+    setShowDeprecatedModels(next: boolean): Promise<void>;
     /**
      * Read the gateway's model listing through the Host's discovery for this
      * adapter. Called when the page mounts and again from its refresh control.

package/lib/types/client/settings.d.ts

@@ -0,0 +1,18 @@
+import type { SettingsPathOpView } from '@deepseek-ai/dsh-api-remotes/client';
+/** Common read/write contract of legacy SettingsScope and 0.1.7 ConfigForm. */
+export interface SettingsScopeSnapshot<T> {
+    status: 'loading' | 'ready' | 'unavailable';
+    value: T | undefined;
+    base: unknown;
+    user: unknown;
+    revision: number | undefined;
+    writable: boolean;
+    mode: 'host' | 'memory';
+}
+export interface SettingsScope<T> {
+    getSnapshot(): SettingsScopeSnapshot<T>;
+    subscribe(listener: () => void): () => void;
+    mutate(ops: readonly SettingsPathOpView[], expectedRevision?: number): Promise<void | boolean>;
+    set(field: string, value: unknown): Promise<void | boolean>;
+    unset(field: string): Promise<void | boolean>;
+}

package/lib/types/client/staged-form.d.ts

@@ -17,7 +17,7 @@
  * forms evolve independently anyway.
  */
 import { type SnapshotStore } from '@deepseek-ai/dsh-client-store';
-import type { SettingsScope } from '@deepseek-ai/dsh-client-ui-settings/client';
+import type { SettingsScope } from './settings.ts';
 /** The write one field's staged text performs when the page is saved. */
 export type FieldWrite = {
     kind: 'set';
@@ -111,6 +111,13 @@ export declare function booleanField(field: string): FieldSpec;
  * @returns the field's conversion spec.
  */
 export declare function textField(field: string): FieldSpec;
+/**
+ * A structured field edited as JSON text. Empty text clears the field and
+ * malformed JSON blocks the save instead of reaching the Host as a string.
+ * @param field - field name inside the namespace section.
+ * @returns the field's conversion spec.
+ */
+export declare function jsonField(field: string): FieldSpec;
 /**
  * Stages the page's edits over the `llm-opencode-go` namespace and writes them
  * on save.
@@ -125,6 +132,7 @@ export declare class StagedForm {
     private readonly secretSpecs;
     private readonly staged;
     private readonly listeners;
+    private readonly unsubscribe;
     private saving;
     private failed;
     /**
@@ -133,6 +141,8 @@ export declare class StagedForm {
      * @param secrets - the page's write-only controls, written outside the section.
      */
     constructor(scope: SettingsScope<Record<string, unknown>>, specs: FieldSpec[], secrets?: SecretSpec[]);
+    /** Shared 0.1.7 forms outlive individual settings pages. */
+    dispose(): void;
     /**
      * Publish a projection of this form, rebuilt whenever the scope or a draft changes.
      * @param project - build the page state from the form's current reads.