akm-cli 0.10.261013-beta → 0.10.261014-beta

package/dist/integrations/harnesses/opencode/config-import.js

@@ -1,149 +0,0 @@
-// This Source Code Form is subject to the terms of the Mozilla Public
-// License, v. 2.0. If a copy of the MPL was not distributed with this
-// file, You can obtain one at https://mozilla.org/MPL/2.0/.
-/**
- * OpenCode LLM-config importer (migrated from `setup/harness-config-import.ts`,
- * #564).
- *
- * Detects an OpenCode installation (filesystem only, no network) and reads its
- * config to extract the connection details of the user's SELECTED model. It is
- * a pure reader, so one implementation serves OpenCode 1 and 2 configs and
- * writes nothing into either. API key VALUES are never stored: only the name
- * of the environment variable a `{env:NAME}` / `$NAME` reference points at.
- * A literal key or a `{file:path}` reference yields no credential (a literal
- * must not be copied, and akm's setup has no file-reference slot to carry it).
- *
- * Config shapes (checked against OpenCode 1.18.34 and 2.0.26):
- *   - files: `opencode.json` / `opencode.jsonc` in the global config dir and
- *     the project (cwd, `.opencode/`); V1 also reads a legacy `config.json`.
- *   - `model`: `"provider/model"` string (V1, and accepted by V2) or
- *     `{providerID, model}` (V2).
- *   - V1 providers: `provider.<id>.options.{baseURL,apiKey}`, `models.<k>.id`.
- *   - V2 providers: `providers.<id>.settings.{baseURL,apiKey}`, `env: [NAME]`,
- *     `models.<k>.modelID`. V2 also accepts the V1 `provider` key, so both are
- *     read per file and merged by provider id.
- * The provider is the one `model` names. When no model is selected, or it
- * names a provider the config does not define, nothing else is substituted.
- */
-import fs from "node:fs";
-import path from "node:path";
-import { asNonEmptyString, asRecord, parseJsonc, toErrorMessage } from "../../../core/common.js";
-import { warnOnce } from "../../../core/warn.js";
-import { homeDir } from "../shared.js";
-const asObject = asRecord;
-const str = asNonEmptyString;
-function configDir() {
-    const xdg = process.env.XDG_CONFIG_HOME;
-    return path.join(xdg && xdg.length > 0 ? xdg : path.join(homeDir(), ".config"), "opencode");
-}
-/** Config files in increasing precedence: global, explicit env overrides, then the project. */
-function candidateFiles() {
-    const dirs = [configDir(), process.env.OPENCODE_CONFIG_DIR].filter((d) => !!d);
-    const files = [path.join(configDir(), "config.json"), path.join(homeDir(), ".opencode", "config.json")];
-    for (const dir of dirs)
-        files.push(path.join(dir, "opencode.json"), path.join(dir, "opencode.jsonc"));
-    if (process.env.OPENCODE_CONFIG)
-        files.push(process.env.OPENCODE_CONFIG);
-    const cwd = process.cwd();
-    files.push(path.join(cwd, "opencode.json"), path.join(cwd, "opencode.jsonc"), path.join(cwd, ".opencode", "config.json"), path.join(cwd, ".opencode", "opencode.json"), path.join(cwd, ".opencode", "opencode.jsonc"));
-    return [...new Set(files)];
-}
-/** `provider/model` or `{providerID, model}` -> the selection, or undefined when none is made. */
-function selectedModel(model) {
-    const obj = asObject(model);
-    if (obj) {
-        const providerId = str(obj.providerID);
-        const modelKey = str(obj.model);
-        return providerId && modelKey ? { providerId, modelKey } : undefined;
-    }
-    const text = str(model);
-    const slash = text?.indexOf("/") ?? -1;
-    if (!text || slash < 1 || slash === text.length - 1)
-        return undefined;
-    return { providerId: text.slice(0, slash), modelKey: text.slice(slash + 1) };
-}
-/**
- * Add one file's providers, from both the V2 (`providers`/`settings`) and V1
- * (`provider`/`options`) keys, into `out`: a later file's values win per field.
- */
-function readProviders(raw, out) {
-    for (const [key, settingsKey] of [
-        ["provider", "options"],
-        ["providers", "settings"],
-    ]) {
-        const map = asObject(raw[key]);
-        if (!map)
-            continue;
-        for (const [id, value] of Object.entries(map)) {
-            const p = asObject(value);
-            if (!p)
-                continue;
-            const settings = asObject(p[settingsKey]);
-            const entry = out.get(id) ?? { models: new Map() };
-            entry.baseUrl = str(settings?.baseURL) ?? str(settings?.baseUrl) ?? entry.baseUrl;
-            entry.apiKey = str(settings?.apiKey) ?? entry.apiKey;
-            if (Array.isArray(p.env))
-                entry.env = p.env.filter((e) => typeof e === "string");
-            for (const [modelKey, m] of Object.entries(asObject(p.models) ?? {})) {
-                const mo = asObject(m);
-                entry.models.set(modelKey, str(mo?.modelID) ?? str(mo?.id) ?? entry.models.get(modelKey));
-            }
-            out.set(id, entry);
-        }
-    }
-}
-/** The env var an apiKey reference names: `{env:NAME}`, `$NAME` or `${NAME}`. Literals and `{file:}` give undefined. */
-function envVarOf(apiKey) {
-    if (!apiKey)
-        return undefined;
-    const m = /^(?:\{env:([A-Za-z_][A-Za-z0-9_]*)\}|\$\{([A-Za-z_][A-Za-z0-9_]*)\}|\$([A-Za-z_][A-Za-z0-9_]*))$/.exec(apiKey);
-    return m?.[1] ?? m?.[2] ?? m?.[3];
-}
-/** Imports the selected model's LLM connection from an OpenCode 1 or 2 config. */
-export const openCodeImporter = {
-    harnessName: "OpenCode",
-    detect() {
-        return fs.existsSync(configDir()) || fs.existsSync(path.join(homeDir(), ".opencode"));
-    },
-    importConfig() {
-        let model;
-        let read = false;
-        const providers = new Map();
-        for (const filePath of candidateFiles()) {
-            let raw;
-            try {
-                if (!fs.existsSync(filePath))
-                    continue;
-                raw = asObject(parseJsonc(fs.readFileSync(filePath, "utf8")));
-            }
-            catch (error) {
-                warnOnce(`opencode-config-import:${filePath}`, `OpenCode config ${filePath} could not be read (${toErrorMessage(error)}); skipped.`);
-                continue;
-            }
-            if (!raw)
-                continue;
-            read = true;
-            if (raw.model !== undefined)
-                model = raw.model;
-            readProviders(raw, providers);
-        }
-        if (!read)
-            return null;
-        const result = { harnessName: "OpenCode" };
-        const selection = selectedModel(model);
-        if (!selection)
-            return result;
-        const entry = providers.get(selection.providerId);
-        result.provider = selection.providerId;
-        result.model = entry?.models.get(selection.modelKey) ?? selection.modelKey;
-        if (entry?.baseUrl)
-            result.baseUrl = entry.baseUrl;
-        const envVar = envVarOf(entry?.apiKey) ?? (!entry?.apiKey && entry?.env?.length === 1 ? entry.env[0] : undefined);
-        if (envVar)
-            result.apiKeyEnvVar = envVar;
-        else if (entry?.apiKey) {
-            warnOnce(`opencode-config-import:credential:${selection.providerId}`, `OpenCode provider "${selection.providerId}" has an API key that is not an environment-variable reference; it was not imported. Export the key as an environment variable and reference it there.`);
-        }
-        return result;
-    },
-};

package/dist/integrations/harnesses/opencode/model-config.js

@@ -1,33 +0,0 @@
-// This Source Code Form is subject to the terms of the Mozilla Public
-// License, v. 2.0. If a copy of the MPL was not distributed with this
-// file, You can obtain one at https://mozilla.org/MPL/2.0/.
-/** The inference keys model work's agent carries as options. */
-export const MODEL_WORK_AGENT_INFERENCE = ["temperature", "reasoningEffort", "enableThinking"];
-const isPositiveInteger = (value) => typeof value === "number" && Number.isInteger(value) && value > 0;
-/**
- * Split `inference` into opencode config: `entry` for a model (its options, and
- * its limit), and for model work `agentOptions` for the confined agent in place
- * of the entry's options. A value of the wrong type is left out.
- */
-export function opencodeInferenceConfig(inference, modelWork) {
-    const { temperature, reasoningEffort, enableThinking, maxTokens, contextLength } = inference ?? {};
-    const options = {};
-    if (typeof temperature === "number" && Number.isFinite(temperature))
-        options.temperature = temperature;
-    if (typeof reasoningEffort === "string" && reasoningEffort.length > 0)
-        options.reasoningEffort = reasoningEffort;
-    if (typeof enableThinking === "boolean") {
-        options.chat_template_kwargs = { enable_thinking: enableThinking };
-        options.enable_thinking = enableThinking;
-    }
-    const hasOptions = Object.keys(options).length > 0;
-    return {
-        entry: {
-            ...(hasOptions && !modelWork ? { options } : {}),
-            ...(isPositiveInteger(maxTokens) && isPositiveInteger(contextLength)
-                ? { limit: { context: contextLength, output: maxTokens } }
-                : {}),
-        },
-        ...(hasOptions && modelWork ? { agentOptions: options } : {}),
-    };
-}

package/dist/integrations/harnesses/opencode/model-work-agent.js

@@ -1,115 +0,0 @@
-// This Source Code Form is subject to the terms of the Mozilla Public
-// License, v. 2.0. If a copy of the MPL was not distributed with this
-// file, You can obtain one at https://mozilla.org/MPL/2.0/.
-/**
- * The opencode agent that runs unattended model work under the model-work
- * tool policy (`MODEL_WORK_POLICY_ID`). The CLI builder injects it through
- * `OPENCODE_CONFIG_CONTENT` and selects it with `--agent`; the SDK runner adds
- * it to its server config and names it in the prompt body.
- *
- * What opencode 1.18.25 confines, checked against a local stub:
- *   - read, grep and glob work in the session directory and akm's primary
- *     stash, and nowhere else. edit works in the session directory only: the
- *     stash is denied, by its path without the leading slash, because opencode
- *     matches edit patterns root-relative (to the git root, when the session
- *     directory is in a repository). Write is part of the edit permission.
- *   - `akm_search` and `akm_show` are the akm-opencode plugin's read tools; its
- *     other three are denied. bash is denied: opencode matches a bash rule
- *     against the command's words only, so `akm show x > ~/stash/asset.md`
- *     would pass an `akm show *` rule and write anywhere.
- *   - every other tool is denied, `doom_loop` included (its default, `ask`,
- *     would hang a headless server). Each permission opencode knows is named,
- *     so a same-named agent in the user's config cannot re-allow one through
- *     opencode's config merge, and `*` covers the rest.
- * The same rules also go in the top-level `permission`, so an opencode that
- * falls back to its default agent is confined too.
- *
- * The agent also keeps opencode's coding-assistant defaults out of model work:
- *   - its own short `prompt` replaces the provider's coding prompt, which
- *     tells the model to search extensively; opencode appends a request's
- *     system text after it and never substitutes it;
- *   - it sets no `steps`. At its step limit opencode sends a "maximum steps"
- *     text as a trailing assistant message, which a qwen chat template (LM
- *     Studio, llama-server) renders as the start of the model's reply: LM
- *     Studio then returns nothing and llama-server returns that text as the
- *     answer. The dispatch timeout bounds a run instead;
- *   - automatic compaction is off, so a long run cannot summarize the task
- *     away.
- */
-import path from "node:path";
-import { resolveStashDir } from "../../../core/common.js";
-import { getStateDir } from "../../../core/paths.js";
-export const MODEL_WORK_OPENCODE_AGENT = "akm-model-work";
-const MODEL_WORK_PROMPT = "You do one bounded task for akm. Use tools only to check what the task needs, never repeat a tool call, and reply with exactly what the task asks for.";
-function modelWorkPermission(stash) {
-    return {
-        "*": "deny",
-        read: "allow",
-        grep: "allow",
-        glob: "allow",
-        edit: { "*": "allow", ...(stash ? { [`${stash.slice(1)}/*`]: "deny" } : {}) },
-        external_directory: {
-            ...(stash ? { [`${stash}/*`]: "allow" } : {}),
-            "~/.local/share/opencode/tool-output/*": "deny",
-        },
-        akm_search: "allow",
-        akm_show: "allow",
-        akm_feedback: "deny",
-        akm_remember: "deny",
-        akm_curate: "deny",
-        bash: "deny",
-        doom_loop: "deny",
-        list: "deny",
-        lsp: "deny",
-        question: "deny",
-        skill: "deny",
-        task: "deny",
-        todowrite: "deny",
-        webfetch: "deny",
-        websearch: "deny",
-    };
-}
-/**
- * What an opencode model-work dispatch gives the akm-opencode plugin (it comes from the user's opencode config and gives
- * the model `akm_search` and `akm_show`): its own switches off, and its state in akm's state directory, the same for every
- * dispatch because an SDK server outlives its dispatch. win32 has no /bin/true, so the plugin keeps its CLI there.
- */
-export function modelWorkPluginEnv() {
-    return {
-        AKM_AUTO_CURATE: "0",
-        AKM_AUTO_LEARNING: "0",
-        AKM_AUTO_SKILL_PROPOSALS: "0",
-        AKM_WRITE_GATE: "off",
-        XDG_STATE_HOME: path.join(getStateDir(), "opencode-model-work"),
-        ...(process.platform === "win32" ? {} : { AKM_OPENCODE_CLI: "/bin/true" }),
-    };
-}
-/**
- * The opencode config fragment that defines and confines the model-work agent.
- * The agent carries the request's inference options (`model-config.ts`), which
- * apply to its calls only: opencode's own calls on the same model, a title for
- * the session, keep the model's defaults.
- */
-export function modelWorkOpencodeConfig(options) {
-    let stash;
-    try {
-        stash = resolveStashDir();
-    }
-    catch {
-        // akm has no stash here, so the agent is given no path into one.
-    }
-    const permission = modelWorkPermission(stash);
-    return {
-        permission: { ...permission },
-        compaction: { auto: false },
-        agent: {
-            [MODEL_WORK_OPENCODE_AGENT]: {
-                mode: "primary",
-                description: "akm unattended model work: read and edit inside its working directory only.",
-                prompt: MODEL_WORK_PROMPT,
-                ...(options ? { options } : {}),
-                permission: { ...permission },
-            },
-        },
-    };
-}

package/dist/integrations/harnesses/opencode/session-log-types.js

@@ -1,12 +0,0 @@
-// This Source Code Form is subject to the terms of the Mozilla Public
-// License, v. 2.0. If a copy of the MPL was not distributed with this
-// file, You can obtain one at https://mozilla.org/MPL/2.0/.
-export function toMeta(r, sessionId) {
-    return {
-        sessionId,
-        startedAt: typeof r.time_created === "number" ? r.time_created : undefined,
-        endedAt: typeof r.time_updated === "number" ? r.time_updated : undefined,
-        projectHint: typeof r.directory === "string" && r.directory.length > 0 ? r.directory : undefined,
-        title: typeof r.title === "string" && r.title.length > 0 ? r.title : undefined,
-    };
-}

package/dist/integrations/harnesses/opencode-sdk/index.js

@@ -1,44 +0,0 @@
-// This Source Code Form is subject to the terms of the Mozilla Public
-// License, v. 2.0. If a copy of the MPL was not distributed with this
-// file, You can obtain one at https://mozilla.org/MPL/2.0/.
-/**
- * OpenCode SDK harness descriptor (#564).
- *
- * Descriptor only. The runner (`./sdk-runner`) imports `core/config`, so the
- * registry must never load it; `agent/runner-dispatch.ts` imports it directly.
- */
-import { createAgentRequestLowerer } from "../../agent/request-lowering.js";
-import { MODEL_WORK_AGENT_INFERENCE } from "../opencode/model-config.js";
-import { caps } from "../shared.js";
-import { BaseHarness } from "../types.js";
-/**
- * OpenCode SDK (embedded-SDK dispatch path).
- *
- * Dispatch-only: no native session logs, but detected at setup.
- */
-export class OpencodeSdkHarness extends BaseHarness {
-    id = "opencode-sdk";
-    displayName = "OpenCode SDK";
-    // ── Workflow-engine descriptor (plan §"Capability matrix", P2) ────────────
-    executionLowerer = {
-        platform: "opencode-sdk",
-        personaChannel: "native",
-        lower: createAgentRequestLowerer({
-            adapter: "opencode-sdk",
-            personaChannel: "native",
-            tools: "sdk",
-            inference: MODEL_WORK_AGENT_INFERENCE,
-        }),
-    };
-    // No flag-shaped resume: session reuse is programmatic — the SDK session id is
-    // stored opportunistically on the unit row and passed back to
-    // `session.prompt`, not replayed via a CLI flag.
-    // No `identityEnv`: the SDK runs in-process; it does not mark a child
-    // process environment with a session id of its own.
-    capabilities = caps({
-        agentDispatch: true,
-        detection: true,
-        modelWork: true,
-        nativeAgent: true,
-    });
-}