cursor-opencode-provider 0.7.6 → 0.8.1

package/dist/context/paths.d.ts

@@ -9,7 +9,31 @@ export type OpenCodePathBridge = {
     /** Optional host-owned cache root; absent means native OpenCode defaults. */
     globalCacheDir?: () => string;
     configFileNames?: string[];
+    /**
+     * Optional host plan file for a session (the host's own plan location, which
+     * its `plan_exit` review reads). Absent on an installed bridge means the host
+     * defines none; without a bridge OpenCode's own location applies.
+     */
+    planFile?: (input: {
+        worktree: string;
+        vcs: boolean;
+        created: number;
+        slug: string;
+    }) => string | undefined;
 };
+/**
+ * The plan file of a session: OpenCode's own `Session.plan` location
+ * (`<worktree>/.opencode/plans` in a VCS project, else `<data>/plans`, named
+ * `<created>-<slug>.md`), which its plan agent and `plan_exit` use. An injected
+ * host path bridge owns host paths, so with one installed only its `planFile`
+ * defines the location.
+ */
+export declare function hostPlanFilePath(input: {
+    worktree: string;
+    vcs: boolean;
+    created: number;
+    slug: string;
+}, env?: HostPathEnv): string | undefined;
 export declare function opencodeProjectConfigDirs(workspaceRoot: string): string[];
 export declare function opencodeGlobalConfigDirs(): string[];
 export declare function opencodeConfigFileNames(): string[];
@@ -21,8 +45,12 @@ export declare function setHostCacheDirOverride(dir: string | undefined): void;
 export declare function getHostCacheDirOverride(): string | undefined;
 /** Resolve the native OpenCode cache root when no host bridge is installed. */
 export declare function resolveHostCacheDir(env?: HostPathEnv): string;
-/** Native OpenCode global config dir. */
-export declare function opencodeGlobalConfigDir(): string;
+/**
+ * Native OpenCode global config dir: `$XDG_CONFIG_HOME/opencode`, otherwise
+ * `~/.config/opencode` — OpenCode's `Global.Path.config` (`xdg-basedir`
+ * `xdgConfig`, `packages/core/src/global.ts`), the same in 1.x and 2.0.
+ */
+export declare function opencodeGlobalConfigDir(env?: HostPathEnv): string;
 /**
  * Host global cache dir for Cursor project metadata + model/version caches.
  *
@@ -37,27 +65,30 @@ export declare function opencodeGlobalDataDir(env?: HostPathEnv): string;
 /** Host-portable durable data root; falls back to native OpenCode. */
 export declare function hostGlobalDataDir(env?: HostPathEnv): string;
 /**
- * Directory for host plan files — always `<hostGlobalDataDir()>/plans`, and
- * never inside the user's repository.
- *
- * OpenCode's own `Session.plan` branches on VCS and puts plans in the worktree
- * (`<worktree>/.opencode/plans`) for a git project. The provider deliberately
- * does *not* mirror that branch. Writing there means a throwaway plan lands in
- * the user's tree untracked-but-unignored, and — because OpenCode installs
- * `@opencode-ai/plugin` into every `.opencode` directory it discovers walking up
- * from the cwd — creating that directory also bootstraps a project-local
- * `node_modules`. The provider must add nothing to a repository it did not
- * already contain.
+ * Select the entrypoint's native OpenCode plan directory. OpenCode 2.0 sets its
+ * Plan directory ({@link opencode2PlanDir}); OpenCode 1.x keeps the default.
+ * The returned disposer removes only this selection, so an older plugin setup
+ * disposed after a newer one leaves the newer selection in place. `undefined`
+ * removes all.
+ */
+export declare function setNativePlansDir(dir: string | undefined): () => void;
+/**
+ * OpenCode 2.0's Plan directory: `<home>/.opencode/plan`, where its Plan agent
+ * may write plan files (home is `OPENCODE_TEST_HOME`, else the OS home).
+ */
+export declare function opencode2PlanDir(env?: HostPathEnv): string;
+/**
+ * Directory for a new plan file when the session's own plan file
+ * ({@link hostPlanFilePath}) is not known.
  *
- * The global-data location is not a degraded fallback: it is the branch OpenCode
- * itself uses when there is no VCS, and its plan agent allow-lists that path for
- * `edit` / `external_directory` alongside the in-worktree one. {@link
- * hostGlobalDataDir} carries an optional injected host translation; without a
- * bridge it is the native OpenCode data root.
+ * An injected host path bridge owns host paths: `<globalDataDir()>/plans`.
+ * Otherwise the native OpenCode location of the running entrypoint: OpenCode
+ * 2.0's Plan directory, or OpenCode 1.x's no-VCS `Session.plan` base
+ * (`<data>/plans`).
  */
-export declare function hostPlansDir(_workspaceRoot?: string): string;
+export declare function hostPlansDir(_workspaceRoot?: string, env?: HostPathEnv): string;
 /**
- * Cursor-compatible path slug (`/Users/a/b` → `Users-a-b`).
+ * Cursor-compatible path slug (`/workspace/a/b` → `workspace-a-b`).
  * Used for per-workspace metadata under the host cache.
  */
 export declare function slugifyWorkspacePath(workspaceRoot: string): string;
@@ -72,4 +103,3 @@ export declare function slugifyWorkspacePath(workspaceRoot: string): string;
 export declare function opencodeProjectDir(workspaceRoot: string): string;
 /** Ensure {@link opencodeProjectDir} exists (mode 0o700) and return it. */
 export declare function ensureOpencodeProjectDir(workspaceRoot: string): string;
-export declare function resolveHomeRelative(p: string): string;

package/dist/context/paths.js

@@ -27,6 +27,31 @@ function bridgeGlobalDataDir() {
     const value = pathBridge()?.globalDataDir?.();
     return typeof value === "string" && value.length > 0 ? path.resolve(value) : undefined;
 }
+/**
+ * The plan file of a session: OpenCode's own `Session.plan` location
+ * (`<worktree>/.opencode/plans` in a VCS project, else `<data>/plans`, named
+ * `<created>-<slug>.md`), which its plan agent and `plan_exit` use. An injected
+ * host path bridge owns host paths, so with one installed only its `planFile`
+ * defines the location.
+ */
+export function hostPlanFilePath(input, env = process.env) {
+    const bridge = pathBridge();
+    if (bridge) {
+        if (typeof bridge.planFile !== "function")
+            return undefined;
+        const value = bridge.planFile(input);
+        return typeof value === "string" && value.length > 0 ? path.resolve(value) : undefined;
+    }
+    const slug = input.slug.trim();
+    if (!slug || slug.includes("/") || slug.includes("\\") || slug.startsWith("."))
+        return undefined;
+    if (!Number.isSafeInteger(input.created) || input.created <= 0)
+        return undefined;
+    const base = input.vcs
+        ? path.join(path.resolve(input.worktree), ".opencode", "plans")
+        : path.join(openCodeGlobalDataDir(env), "plans");
+    return path.join(base, `${input.created}-${slug}.md`);
+}
 function bridgeGlobalCacheDir() {
     const value = pathBridge()?.globalCacheDir?.();
     return typeof value === "string" && value.length > 0 ? path.resolve(value) : undefined;
@@ -68,9 +93,18 @@ export function getHostCacheDirOverride() {
 export function resolveHostCacheDir(env = process.env) {
     return bridgeGlobalCacheDir() ?? openCodeGlobalCacheDir(env);
 }
-/** Native OpenCode global config dir. */
-export function opencodeGlobalConfigDir() {
-    return path.join(resolveHome(), ".config", "opencode");
+function xdgConfigHome(env = process.env) {
+    if (env.XDG_CONFIG_HOME && env.XDG_CONFIG_HOME.length > 0)
+        return env.XDG_CONFIG_HOME;
+    return path.join(resolveHome(env), ".config");
+}
+/**
+ * Native OpenCode global config dir: `$XDG_CONFIG_HOME/opencode`, otherwise
+ * `~/.config/opencode` — OpenCode's `Global.Path.config` (`xdg-basedir`
+ * `xdgConfig`, `packages/core/src/global.ts`), the same in 1.x and 2.0.
+ */
+export function opencodeGlobalConfigDir(env = process.env) {
+    return path.join(xdgConfigHome(env), "opencode");
 }
 /**
  * Host global cache dir for Cursor project metadata + model/version caches.
@@ -93,30 +127,52 @@ export function opencodeGlobalDataDir(env = process.env) {
 export function hostGlobalDataDir(env = process.env) {
     return bridgeGlobalDataDir() ?? openCodeGlobalDataDir(env);
 }
+/** Entrypoint plan directories, newest last (see {@link setNativePlansDir}). */
+const nativePlansDirs = [];
 /**
- * Directory for host plan files — always `<hostGlobalDataDir()>/plans`, and
- * never inside the user's repository.
- *
- * OpenCode's own `Session.plan` branches on VCS and puts plans in the worktree
- * (`<worktree>/.opencode/plans`) for a git project. The provider deliberately
- * does *not* mirror that branch. Writing there means a throwaway plan lands in
- * the user's tree untracked-but-unignored, and — because OpenCode installs
- * `@opencode-ai/plugin` into every `.opencode` directory it discovers walking up
- * from the cwd — creating that directory also bootstraps a project-local
- * `node_modules`. The provider must add nothing to a repository it did not
- * already contain.
+ * Select the entrypoint's native OpenCode plan directory. OpenCode 2.0 sets its
+ * Plan directory ({@link opencode2PlanDir}); OpenCode 1.x keeps the default.
+ * The returned disposer removes only this selection, so an older plugin setup
+ * disposed after a newer one leaves the newer selection in place. `undefined`
+ * removes all.
+ */
+export function setNativePlansDir(dir) {
+    if (!dir) {
+        nativePlansDirs.length = 0;
+        return () => { };
+    }
+    const entry = { dir: path.resolve(dir) };
+    nativePlansDirs.push(entry);
+    return () => {
+        const index = nativePlansDirs.lastIndexOf(entry);
+        if (index >= 0)
+            nativePlansDirs.splice(index, 1);
+    };
+}
+/**
+ * OpenCode 2.0's Plan directory: `<home>/.opencode/plan`, where its Plan agent
+ * may write plan files (home is `OPENCODE_TEST_HOME`, else the OS home).
+ */
+export function opencode2PlanDir(env = process.env) {
+    return path.join(env.OPENCODE_TEST_HOME ?? homedir(), ".opencode", "plan");
+}
+/**
+ * Directory for a new plan file when the session's own plan file
+ * ({@link hostPlanFilePath}) is not known.
  *
- * The global-data location is not a degraded fallback: it is the branch OpenCode
- * itself uses when there is no VCS, and its plan agent allow-lists that path for
- * `edit` / `external_directory` alongside the in-worktree one. {@link
- * hostGlobalDataDir} carries an optional injected host translation; without a
- * bridge it is the native OpenCode data root.
+ * An injected host path bridge owns host paths: `<globalDataDir()>/plans`.
+ * Otherwise the native OpenCode location of the running entrypoint: OpenCode
+ * 2.0's Plan directory, or OpenCode 1.x's no-VCS `Session.plan` base
+ * (`<data>/plans`).
  */
-export function hostPlansDir(_workspaceRoot) {
-    return path.join(hostGlobalDataDir(), "plans");
+export function hostPlansDir(_workspaceRoot, env = process.env) {
+    const bridged = bridgeGlobalDataDir();
+    if (bridged)
+        return path.join(bridged, "plans");
+    return nativePlansDirs[nativePlansDirs.length - 1]?.dir ?? path.join(openCodeGlobalDataDir(env), "plans");
 }
 /**
- * Cursor-compatible path slug (`/Users/a/b` → `Users-a-b`).
+ * Cursor-compatible path slug (`/workspace/a/b` → `workspace-a-b`).
  * Used for per-workspace metadata under the host cache.
  */
 export function slugifyWorkspacePath(workspaceRoot) {
@@ -157,8 +213,3 @@ export function ensureOpencodeProjectDir(workspaceRoot) {
         `xdg_cache_home=${process.env.XDG_CACHE_HOME ?? "(unset)"}`);
     return dir;
 }
-export function resolveHomeRelative(p) {
-    if (p.startsWith("~/"))
-        return path.join(homedir(), p.slice(2));
-    return p;
-}

package/dist/context/rules.d.ts

@@ -1,7 +1,3 @@
-export type CollectedRule = {
-    fullPath: string;
-    content: string;
-};
 export type OpencodeJson = {
     instructions?: string[];
     permission?: unknown;
@@ -9,18 +5,10 @@ export type OpencodeJson = {
     plugins?: string[];
     mcp?: Record<string, unknown>;
 };
-export declare function findGitWorktree(start: string): Promise<string>;
 /** Same truthy rule as OpenCode's Flag.OPENCODE_DISABLE_PROJECT_CONFIG. */
 export declare function isProjectConfigDisabled(): boolean;
-/** Fetch a remote instruction with one deadline covering headers and body. */
-export declare function fetchRemoteInstruction(url: string, timeoutMs?: number): Promise<string | undefined>;
-export declare function loadMergedConfig(workspaceRoot: string): Promise<OpencodeJson>;
 /**
- * Collect OpenCode instruction files.
- * `preloadedConfig` reuses a merged config already loaded on this Run.
+ * Merged `opencode.json` / `opencode.jsonc` for MCP server ids, plugin lists,
+ * and interaction guidance. Instruction file bodies are not collected here.
  */
-export declare function collectRules(workspaceRoot: string, preloadedConfig?: OpencodeJson): Promise<{
-    rules: CollectedRule[];
-    config: OpencodeJson;
-    worktree: string;
-}>;
+export declare function loadMergedConfig(workspaceRoot: string): Promise<OpencodeJson>;

package/dist/context/rules.js

@@ -1,7 +1,6 @@
-import { readFile, readdir, stat } from "node:fs/promises";
-import { homedir } from "node:os";
+import { readFile, stat } from "node:fs/promises";
 import path from "node:path";
-import { opencodeConfigFileNames, opencodeGlobalConfigDirs, opencodeProjectConfigDirs, resolveHomeRelative } from "./paths.js";
+import { opencodeConfigFileNames, opencodeGlobalConfigDirs, opencodeProjectConfigDirs } from "./paths.js";
 async function exists(file) {
     try {
         await stat(file);
@@ -18,7 +17,10 @@ async function readJsonConfig(dir) {
             continue;
         try {
             const raw = await readFile(file, "utf-8");
-            const stripped = raw.replace(/\/\*[\s\S]*?\*\//g, "").replace(/^\s*\/\/.*$/gm, "");
+            // Match strings first so comment markers inside URLs/plugin specifiers
+            // survive. Remove comments before trailing commas (which may precede one).
+            const uncommented = raw.replace(/"(?:\\.|[^"\\])*"|\/\*[\s\S]*?\*\/|\/\/[^\r\n]*/g, token => token.startsWith('"') ? token : " ");
+            const stripped = uncommented.replace(/"(?:\\.|[^"\\])*"|,\s*(?=[}\]])/g, token => token.startsWith('"') ? token : "");
             return JSON.parse(stripped);
         }
         catch {
@@ -27,131 +29,11 @@ async function readJsonConfig(dir) {
     }
     return {};
 }
-export async function findGitWorktree(start) {
-    let dir = path.resolve(start);
-    for (;;) {
-        if (await exists(path.join(dir, ".git")))
-            return dir;
-        const parent = path.dirname(dir);
-        if (parent === dir)
-            return path.resolve(start);
-        dir = parent;
-    }
-}
-async function findUp(name, start, stop) {
-    let dir = path.resolve(start);
-    const root = path.resolve(stop);
-    for (;;) {
-        const candidate = path.join(dir, name);
-        if (await exists(candidate))
-            return candidate;
-        if (dir === root)
-            return undefined;
-        const parent = path.dirname(dir);
-        if (parent === dir)
-            return undefined;
-        dir = parent;
-    }
-}
-async function readRule(file) {
-    if (!(await exists(file)))
-        return undefined;
-    try {
-        const content = await readFile(file, "utf-8");
-        if (!content.trim())
-            return undefined;
-        return { fullPath: path.resolve(file), content };
-    }
-    catch {
-        return undefined;
-    }
-}
-function globToRegExp(glob) {
-    const norm = glob.replace(/\\/g, "/");
-    let re = "^";
-    for (let i = 0; i < norm.length; i++) {
-        const c = norm[i];
-        if (c === "*") {
-            if (norm[i + 1] === "*") {
-                re += ".*";
-                i++;
-                if (norm[i + 1] === "/")
-                    i++;
-            }
-            else {
-                re += "[^/]*";
-            }
-        }
-        else if (".$^+?()[]{}|".includes(c) || c === "\\") {
-            re += "\\" + c;
-        }
-        else {
-            re += c;
-        }
-    }
-    return new RegExp(re + "$");
-}
-async function expandGlob(pattern, workspaceRoot) {
-    const abs = path.isAbsolute(pattern) ? pattern : path.join(workspaceRoot, pattern);
-    if (!abs.includes("*"))
-        return (await exists(abs)) ? [abs] : [];
-    const out = [];
-    const base = abs.split("*")[0] || workspaceRoot;
-    const startDir = path.dirname(base.endsWith("/") ? base : base);
-    const regex = globToRegExp(abs);
-    async function walk(dir, depth) {
-        if (depth > 8)
-            return;
-        let entries;
-        try {
-            entries = await readdir(dir);
-        }
-        catch {
-            return;
-        }
-        entries.sort();
-        for (const name of entries) {
-            if (name === "node_modules" || name === ".git")
-                continue;
-            const full = path.join(dir, name);
-            let st;
-            try {
-                st = await stat(full);
-            }
-            catch {
-                continue;
-            }
-            if (st.isDirectory())
-                await walk(full, depth + 1);
-            else if (regex.test(full.replace(/\\/g, "/")))
-                out.push(full);
-        }
-    }
-    await walk(startDir, 0);
-    return out;
-}
 /** Same truthy rule as OpenCode's Flag.OPENCODE_DISABLE_PROJECT_CONFIG. */
 export function isProjectConfigDisabled() {
     const value = process.env.OPENCODE_DISABLE_PROJECT_CONFIG?.toLowerCase();
     return value === "true" || value === "1";
 }
-/** Fetch a remote instruction with one deadline covering headers and body. */
-export async function fetchRemoteInstruction(url, timeoutMs = 5000) {
-    const ctrl = new AbortController();
-    const timer = setTimeout(() => ctrl.abort(), Math.max(1, timeoutMs));
-    try {
-        const res = await fetch(url, { signal: ctrl.signal });
-        if (!res.ok)
-            return undefined;
-        return await res.text();
-    }
-    catch {
-        return undefined;
-    }
-    finally {
-        clearTimeout(timer);
-    }
-}
 function mergeConfig(base, overlay) {
     return {
         ...base,
@@ -163,6 +45,10 @@ function mergeConfig(base, overlay) {
         permission: overlay.permission ?? base.permission,
     };
 }
+/**
+ * Merged `opencode.json` / `opencode.jsonc` for MCP server ids, plugin lists,
+ * and interaction guidance. Instruction file bodies are not collected here.
+ */
 export async function loadMergedConfig(workspaceRoot) {
     const globalConfig = await readJsonConfig(opencodeGlobalConfigDirs()[0] ?? "");
     if (isProjectConfigDisabled())
@@ -176,65 +62,3 @@ export async function loadMergedConfig(workspaceRoot) {
     }
     return mergeConfig(globalConfig, projectConfig);
 }
-/**
- * Collect OpenCode instruction files.
- * `preloadedConfig` reuses a merged config already loaded on this Run.
- */
-export async function collectRules(workspaceRoot, preloadedConfig) {
-    const worktree = await findGitWorktree(workspaceRoot);
-    const rules = [];
-    const seen = new Set();
-    const config = preloadedConfig ?? await loadMergedConfig(workspaceRoot);
-    const add = async (file) => {
-        if (!file)
-            return;
-        const resolved = path.resolve(file);
-        if (seen.has(resolved))
-            return;
-        const rule = await readRule(resolved);
-        if (!rule)
-            return;
-        seen.add(resolved);
-        rules.push(rule);
-    };
-    // Match OpenCode: OPENCODE_DISABLE_PROJECT_CONFIG skips project AGENTS/CLAUDE/CONTEXT
-    // discovery and project opencode.json (see loadMergedConfig).
-    if (!isProjectConfigDisabled()) {
-        for (const name of ["AGENTS.md", "CLAUDE.md", "CONTEXT.md"]) {
-            const hit = await findUp(name, workspaceRoot, worktree);
-            if (hit) {
-                await add(hit);
-                break;
-            }
-        }
-    }
-    for (const globalDir of opencodeGlobalConfigDirs()) {
-        await add(path.join(globalDir, "AGENTS.md"));
-    }
-    await add(path.join(homedir(), ".claude", "CLAUDE.md"));
-    for (const raw of config.instructions ?? []) {
-        if (raw.startsWith("http://") || raw.startsWith("https://")) {
-            // HTTPS-only. Redirects (incl. to a local proxy) are intentional — do not
-            // disable follow-redirects or reject localhost/private/metadata hosts.
-            let remoteUrl;
-            try {
-                remoteUrl = new URL(raw);
-            }
-            catch {
-                continue;
-            }
-            if (remoteUrl.protocol !== "https:")
-                continue;
-            const content = await fetchRemoteInstruction(remoteUrl.href);
-            if (!content?.trim() || seen.has(raw))
-                continue;
-            seen.add(raw);
-            rules.push({ fullPath: raw, content });
-            continue;
-        }
-        const expanded = resolveHomeRelative(raw);
-        for (const m of await expandGlob(expanded, workspaceRoot))
-            await add(m);
-    }
-    return { rules, config, worktree };
-}

package/dist/context/skills-bridge.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Structural host-skills capability installed before an unchanged provider loads.
+ * Same install timing as `opencode.host.path-bridge`.
+ */
+export declare const HOST_SKILLS_BRIDGE: unique symbol;
+/** One host catalog skill the provider may advertise to Cursor. */
+export type HostSkill = {
+    name: string;
+    id?: string;
+    description: string;
+    /** Absolute path, `file:` URL, or host URI (`skill://…`). Omit built-ins / markers. */
+    location?: string;
+};
+export type OpenCodeSkillsBridge = {
+    list(input: {
+        directory: string;
+        sessionID?: string;
+    }): Promise<HostSkill[]>;
+};
+export declare function skillsBridge(): OpenCodeSkillsBridge | undefined;
+/** Test helper: install or clear the structural skills bridge. */
+export declare function setHostSkillsBridgeForTests(bridge: OpenCodeSkillsBridge | undefined): void;

package/dist/context/skills-bridge.js

@@ -0,0 +1,20 @@
+/**
+ * Structural host-skills capability installed before an unchanged provider loads.
+ * Same install timing as `opencode.host.path-bridge`.
+ */
+export const HOST_SKILLS_BRIDGE = Symbol.for("opencode.host.skills");
+export function skillsBridge() {
+    const value = globalThis[HOST_SKILLS_BRIDGE];
+    if (!value || typeof value !== "object")
+        return undefined;
+    const bridge = value;
+    return typeof bridge.list === "function" ? bridge : undefined;
+}
+/** Test helper: install or clear the structural skills bridge. */
+export function setHostSkillsBridgeForTests(bridge) {
+    const globals = globalThis;
+    if (bridge)
+        globals[HOST_SKILLS_BRIDGE] = bridge;
+    else
+        delete globals[HOST_SKILLS_BRIDGE];
+}

package/dist/context/skills.d.ts

@@ -1,11 +1,34 @@
-export type CollectedSkill = {
-    fullPath: string;
-    name: string;
-    description: string;
-    content: string;
+import type { OpencodeToolDef } from "../protocol/tools.js";
+import { type HostSkill } from "./skills-bridge.js";
+export type HostSkillFileEntry = {
+    readonly id: string;
+    readonly path: string;
 };
+export type AgentSkillWire = {
+    readonly full_path: string;
+    readonly description: string;
+};
+/** Locations Cursor can advertise; markers / builtins are omitted. */
+export declare function isUsableSkillLocation(location: string | undefined): boolean;
+export declare function normalizeSkillLocation(location: string): string;
+export declare function skillToolAdvertised(tools: readonly OpencodeToolDef[] | undefined): boolean;
+/** Record skill files a Location's host currently registers (OpenCode 2 plugin). */
+export declare function rememberHostSkillFiles(directory: string, skills: readonly HostSkillFileEntry[]): void;
+export declare function hostSkillFiles(directory: string | undefined): ReadonlyMap<string, string> | undefined;
+/** Test helper. */
+export declare function resetHostSkillFilesForTests(): void;
 /**
- * Discover skills the way OpenCode does: `.opencode/skills`, global opencode,
- * plus `.claude/skills` and `.agents/skills` (project + home).
+ * path-desc `agent_skills` for cataloged skills that have a usable location,
+ * in catalog order. Descriptions come from the catalog (epoch-stable).
  */
-export declare function collectSkills(workspaceRoot: string, worktree: string): Promise<CollectedSkill[]>;
+export declare function agentSkillsForCursor(systemText: string | undefined, options: {
+    skillToolAdvertised: boolean;
+    skillFiles?: ReadonlyMap<string, string>;
+    bridgeSkills?: readonly HostSkill[];
+}): AgentSkillWire[];
+/** Fetch locations from the structural bridge when installed. */
+export declare function loadBridgeSkills(input: {
+    workspaceRoot: string;
+    sessionID?: string;
+}): Promise<HostSkill[] | undefined>;
+export declare function applyAgentSkillsToContext(context: Record<string, unknown>, skills: readonly AgentSkillWire[]): void;