@lore-co/cli 0.2.23 → 0.2.24

package/dist/lore-agent.d.ts

@@ -0,0 +1,50 @@
+/**
+ * Lore as a defined agent inside a coding harness: a fresh context, a
+ * Lore-only prompt, and only the Lore tools plus read-only file access, so a
+ * person can delegate recall, proposal review, or a recap without the main
+ * agent's task influencing the result. One prompt source
+ * (integrations/agents/lore/AGENT.md) is rendered per harness here: markdown
+ * with frontmatter for most hosts, a TOML custom agent for Codex.
+ */
+export type LoreAgentHarness = "claude" | "codex" | "copilot" | "cursor" | "opencode";
+interface AgentPaths {
+    home: string;
+    loreDirectory: string;
+}
+interface Installation {
+    agent: string;
+    configPath: string;
+}
+/** Lore MCP tools the agent may use, in the order the harness lists them. */
+export declare const LORE_AGENT_TOOLS: readonly ["ask_lore", "search_learnings", "get_learning", "list_learnings", "list_sessions", "list_proposals", "get_proposal", "decide_proposal", "remember_learning", "correct_learning", "share_lore", "list_skills", "read_skill"];
+/** Skills the agent builds on; preloaded where the harness supports it. */
+export declare const LORE_AGENT_SKILLS: readonly ["lore", "recap"];
+interface AgentSource {
+    name: string;
+    description: string;
+    body: string;
+}
+export declare function parseLoreAgentSource(asset?: string): AgentSource;
+/**
+ * The agent body as a TOML multi-line basic string. Only a backslash and a
+ * run of three quotes have meaning inside `"""`: the backslash starts an
+ * escape or a line-ending continuation, and three quotes end the string. One
+ * escaped quote breaks each such run, and the final newline keeps the closing
+ * delimiter away from a trailing quote, which TOML limits to two.
+ */
+export declare function tomlMultilineString(value: string): string;
+/** The complete agent file for one harness. */
+export declare function renderLoreAgent(harness: LoreAgentHarness, asset?: string): string;
+export interface LoreAgentFile {
+    harness: LoreAgentHarness;
+    file: string;
+}
+/** Where each connected agent loads a user-level agent definition from. */
+export declare function loreAgentFiles(installations: readonly Installation[]): LoreAgentFile[];
+export declare function installLoreAgent(paths: AgentPaths, installations: readonly Installation[]): Promise<{
+    files: string[];
+    warnings: string[];
+}>;
+export declare function removeLoreAgent(paths: AgentPaths, installations: readonly Installation[]): Promise<void>;
+export {};
+//# sourceMappingURL=lore-agent.d.ts.map

package/dist/lore-agent.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lore-agent.d.ts","sourceRoot":"","sources":["../src/lore-agent.ts"],"names":[],"mappings":"AAKA;;;;;;;GAOG;AACH,MAAM,MAAM,gBAAgB,GAAG,QAAQ,GAAG,OAAO,GAAG,SAAS,GAAG,QAAQ,GAAG,UAAU,CAAC;AAEtF,UAAU,UAAU;IAAG,IAAI,EAAE,MAAM,CAAC;IAAC,aAAa,EAAE,MAAM,CAAA;CAAE;AAC5D,UAAU,YAAY;IAAG,KAAK,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,CAAA;CAAE;AAE5D,6EAA6E;AAC7E,eAAO,MAAM,gBAAgB,uOAcnB,CAAC;AAEX,2EAA2E;AAC3E,eAAO,MAAM,iBAAiB,4BAA6B,CAAC;AAE5D,UAAU,WAAW;IAAG,IAAI,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE;AAEzE,wBAAgB,oBAAoB,CAAC,KAAK,GAAE,MAAyB,GAAG,WAAW,CASlF;AAMD;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAGzD;AAuFD,+CAA+C;AAC/C,wBAAgB,eAAe,CAAC,OAAO,EAAE,gBAAgB,EAAE,KAAK,GAAE,MAAyB,GAAG,MAAM,CAmFnG;AAED,MAAM,WAAW,aAAa;IAAG,OAAO,EAAE,gBAAgB,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE;AAE1E,2EAA2E;AAC3E,wBAAgB,cAAc,CAAC,aAAa,EAAE,SAAS,YAAY,EAAE,GAAG,aAAa,EAAE,CAmBtF;AAKD,wBAAsB,gBAAgB,CAAC,KAAK,EAAE,UAAU,EAAE,aAAa,EAAE,SAAS,YAAY,EAAE,GAAG,OAAO,CAAC;IAAE,KAAK,EAAE,MAAM,EAAE,CAAC;IAAC,QAAQ,EAAE,MAAM,EAAE,CAAA;CAAE,CAAC,CAgClJ;AAED,wBAAsB,eAAe,CAAC,KAAK,EAAE,UAAU,EAAE,aAAa,EAAE,SAAS,YAAY,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAQ9G"}

package/dist/lore-agent.js

@@ -0,0 +1,299 @@
+import { rm } from "node:fs/promises";
+import { dirname, resolve } from "node:path";
+import { LORE_AGENT_ASSET } from "./generated-assets.js";
+import { atomicWrite, digest, ownedFileHint, readIfPresent, readOwnedManifest, regularPath, removeOwnedFile } from "./owned-files.js";
+/** Lore MCP tools the agent may use, in the order the harness lists them. */
+export const LORE_AGENT_TOOLS = [
+    "ask_lore",
+    "search_learnings",
+    "get_learning",
+    "list_learnings",
+    "list_sessions",
+    "list_proposals",
+    "get_proposal",
+    "decide_proposal",
+    "remember_learning",
+    "correct_learning",
+    "share_lore",
+    "list_skills",
+    "read_skill",
+];
+/** Skills the agent builds on; preloaded where the harness supports it. */
+export const LORE_AGENT_SKILLS = ["lore", "recap"];
+export function parseLoreAgentSource(asset = LORE_AGENT_ASSET) {
+    const match = /^---\n([\s\S]*?)\n---\n([\s\S]*)$/u.exec(asset);
+    if (match === null)
+        throw new Error("The Lore agent source has no frontmatter");
+    const fields = Object.fromEntries(match[1].split("\n").map(line => {
+        const separator = line.indexOf(":");
+        return [line.slice(0, separator).trim(), line.slice(separator + 1).trim()];
+    }));
+    if (!fields.name || !fields.description)
+        throw new Error("The Lore agent source needs a name and a description");
+    return { name: fields.name, description: fields.description, body: match[2].trim() };
+}
+const yamlString = (value) => JSON.stringify(value);
+// JSON escapes are a subset of TOML basic-string escapes, so one quoted line serves both.
+const tomlString = yamlString;
+/**
+ * The agent body as a TOML multi-line basic string. Only a backslash and a
+ * run of three quotes have meaning inside `"""`: the backslash starts an
+ * escape or a line-ending continuation, and three quotes end the string. One
+ * escaped quote breaks each such run, and the final newline keeps the closing
+ * delimiter away from a trailing quote, which TOML limits to two.
+ */
+export function tomlMultilineString(value) {
+    const escaped = value.replace(/\\/gu, "\\\\").replace(/"""/gu, '""\\"');
+    return `"""\n${escaped.endsWith("\n") ? escaped : `${escaped}\n`}"""`;
+}
+const HOST_NOTES = {
+    claude: `## Host notes: Claude Code
+
+Delegate with "use the lore agent to …" or an @lore mention; Claude Code also
+delegates on its own when a request matches this agent's description. The
+main agent passes the session to recap when it knows it. Claude Code stores
+this project's transcripts as JSONL under
+\`~/.claude/projects/<project-slug>/<session-id>.jsonl\`, where the slug is the
+working directory path with each \`/\` replaced by \`-\`. Without a session ID,
+take the most recently modified transcript in that folder and confirm with the
+person that its first user message is the session they mean. Read only
+\`user\` and \`assistant\` entries. The \`lore\` and \`recap\` skills are preloaded
+when they are installed; their rules apply unchanged.
+
+This definition grants Read, Glob, and Grep for evidence and the Lore tools
+listed above by name. A listed tool that your Lore connection does not offer
+yet is simply absent; say so rather than substituting another route.`,
+    codex: `## Host notes: Codex
+
+Ask Codex to delegate to you: "use the lore agent to …" or "have the lore
+agent review my pending learnings". Codex also delegates when AGENTS.md or a
+skill asks it to. In the CLI, \`/subagents\` switches between running agent
+threads and shows this one; it does not start an agent by itself. This file
+turns off the shell tool, apps, plugins, memories, and the permission-request
+tool. It cannot restrict MCP servers, which Codex inherits from the parent
+session, and it cannot create a read-only sandbox: you run under the parent's
+sandbox and approval policy. So the rule in this prompt is the only limit: use
+the Lore tools named above from the \`lore\` MCP server and nothing from any
+other server, and make no file edits even when the sandbox would allow them.
+Codex does not list MCP tools as plain functions: they are reachable through
+the \`exec\` code-mode tool as \`await tools.mcp__lore__<tool>({ … })\` (list
+them with \`ALL_TOOLS\`), and \`tool_search\` can answer "unsupported call".
+Use \`exec\` only to call the Lore tools named above, never to run shell
+commands or change files; \`apply_patch\` and \`web.run\` stay exposed and are
+not yours to use.
+Codex keeps sessions in its own store rather than transcript files; recap from
+the conversation the person shares, from what Lore recorded (\`list_sessions\`),
+and from the repository's files. Skills inherit from the parent session; the
+\`lore\` and \`recap\` skills, when installed under \`~/.agents/skills\`,
+describe the flows you follow.`,
+    copilot: `## Host notes: GitHub Copilot
+
+Select this agent with \`/agent\` in Copilot CLI, start a session with
+\`copilot --agent lore\`, pick it in VS Code's agent picker, or say "use the
+lore agent to …". The \`tools\` list limits you to read, search, and the Lore
+tools named above; Copilot ignores names its MCP configuration does not
+provide, so when a Lore tool is missing, say so rather than substituting
+another route. Copilot keeps session logs in its own format rather than a
+transcript you should read; recap from what the person shares, from what Lore
+recorded (\`list_sessions\`), and from the repository's files. The \`lore\` and
+\`recap\` skills, when installed, describe the flows you follow.`,
+    opencode: `## Host notes: OpenCode
+
+Mention \`@lore\` in a message in the TUI to run this agent in a child session,
+switch to it as the primary agent with Tab, or run
+\`opencode run --agent lore "…"\` from a shell; \`opencode run\` treats an
+\`@lore\` mention as plain text, so the main agent answers itself there. The
+permission map denies edit, bash, web, task, and the to-do tools and allows
+the Lore tools above by name; OpenCode cannot deny
+tools from MCP servers this definition does not know about, so do not use
+another server's tools even when they are listed. OpenCode keeps sessions in
+its own store rather than transcript files; recap from the conversation the
+person shares, from what Lore recorded (\`list_sessions\`), and from the
+repository's files. The \`lore\` and \`recap\` skills, when installed, describe
+the flows you follow.`,
+    cursor: `## Host notes: Cursor
+
+Run this subagent with \`/lore …\` or "use the lore subagent to …"; Cursor also
+delegates on its own when a request matches this subagent's description. This
+file sets no \`readonly\` flag on purpose: Cursor runs a read-only subagent in
+Ask mode, which rejects every MCP call, including the read-only Lore tools, so
+a read-only Lore subagent cannot answer at all. Cursor has no per-subagent tool
+list and subagents inherit every tool of the parent, including every MCP
+server, so the rule in this prompt is the only limit: use the Lore tools named
+above from the \`lore\` MCP server and nothing from any other server, edit no
+file, and run no shell command even when a read-only one would be allowed. The
+parent's permission allowlist (\`Mcp(lore:<tool>)\` entries in \`.cursor/cli.json\`
+or \`~/.cursor/cli-config.json\`) still decides which Lore tools run without a
+prompt. The \`lore-native\` server is Cursor's capture bridge for the main
+agent, not a tool for you. Cursor keeps conversations in its own store rather
+than transcript files; recap from the conversation the person shares, from
+what Lore recorded (\`list_sessions\`), and from the repository's files. The
+\`lore\` and \`recap\` skills, when installed, describe the flows you follow.`,
+};
+/** The complete agent file for one harness. */
+export function renderLoreAgent(harness, asset = LORE_AGENT_ASSET) {
+    const source = parseLoreAgentSource(asset);
+    const body = `${source.body}\n\n${HOST_NOTES[harness]}\n`;
+    switch (harness) {
+        case "claude":
+            return [
+                "---",
+                `name: ${source.name}`,
+                `description: ${yamlString(source.description)}`,
+                `tools: Read, Glob, Grep, ${LORE_AGENT_TOOLS.map(tool => `mcp__lore__${tool}`).join(", ")}`,
+                "skills:",
+                ...LORE_AGENT_SKILLS.map(skill => `  - ${skill}`),
+                "---",
+                "",
+                body,
+            ].join("\n");
+        case "codex":
+            // Codex: a standalone TOML custom agent; `model` is left out so it inherits the parent's.
+            // sandbox_mode, approval_policy, and mcp_servers cannot be set here, so the prompt limits the tools.
+            return [
+                `name = ${tomlString(source.name)}`,
+                `description = ${tomlString(source.description)}`,
+                `developer_instructions = ${tomlMultilineString(body)}`,
+                "",
+                "[features]",
+                "shell_tool = false",
+                "apps = false",
+                "plugins = false",
+                "memories = false",
+                "request_permissions_tool = false",
+                "",
+            ].join("\n");
+        case "copilot":
+            return [
+                "---",
+                `name: ${source.name}`,
+                `description: ${yamlString(source.description)}`,
+                `tools: [${["read", "search", ...LORE_AGENT_TOOLS.map(tool => `lore/${tool}`)].map(yamlString).join(", ")}]`,
+                "---",
+                "",
+                body,
+            ].join("\n");
+        case "cursor":
+            // Cursor documents name, description, model, readonly, and is_background; no tool or MCP allowlist.
+            // `readonly: true` is left out: it runs the subagent in Ask mode, which rejects every MCP call,
+            // so the Lore tools would be unreachable (verified against cursor-agent 2026.09.02).
+            return [
+                "---",
+                `name: ${source.name}`,
+                `description: ${yamlString(source.description)}`,
+                "model: inherit",
+                "---",
+                "",
+                body,
+            ].join("\n");
+        case "opencode":
+            return [
+                "---",
+                `description: ${yamlString(source.description)}`,
+                "mode: all",
+                "permission:",
+                "  read: allow",
+                "  glob: allow",
+                "  grep: allow",
+                "  list: allow",
+                "  skill: allow",
+                "  external_directory: ask",
+                "  edit: deny",
+                "  bash: deny",
+                "  webfetch: deny",
+                "  websearch: deny",
+                "  task: deny",
+                // OpenCode's to-do list tools are offered unless denied; the agent has no plan to track.
+                "  todowrite: deny",
+                "  todoread: deny",
+                // Last matching rule wins: deny the server, then allow the listed tools.
+                '  "lore_*": deny',
+                ...LORE_AGENT_TOOLS.map(tool => `  lore_${tool}: allow`),
+                "---",
+                "",
+                body,
+            ].join("\n");
+    }
+}
+/** Where each connected agent loads a user-level agent definition from. */
+export function loreAgentFiles(installations) {
+    const seen = new Set();
+    const files = [];
+    for (const installation of installations) {
+        const configDirectory = dirname(resolve(installation.configPath));
+        let entry = null;
+        // Claude Code: `agents/` beside the settings file, so a custom CLAUDE_CONFIG_DIR is honored.
+        if (installation.agent === "claude")
+            entry = { harness: "claude", file: resolve(configDirectory, "agents/lore.md") };
+        // Codex: `~/.codex/agents/<name>.toml` beside hooks.json; the `name` field, not the filename, identifies the agent.
+        else if (installation.agent === "codex")
+            entry = { harness: "codex", file: resolve(configDirectory, "agents/lore.toml") };
+        // Copilot: `hooks/lore.json` lives under the Copilot home (CLI) or `.github` (VS Code); agents sit beside hooks.
+        else if (installation.agent === "copilot-cli" || installation.agent === "copilot-vscode")
+            entry = { harness: "copilot", file: resolve(dirname(configDirectory), "agents/lore.agent.md") };
+        // Cursor: `~/.cursor/agents/` beside hooks.json; it wins over `~/.claude/agents/lore.md`, which Cursor also reads.
+        else if (installation.agent === "cursor")
+            entry = { harness: "cursor", file: resolve(configDirectory, "agents/lore.md") };
+        // OpenCode: `agents/` beside opencode.json.
+        else if (installation.agent === "opencode")
+            entry = { harness: "opencode", file: resolve(configDirectory, "agents/lore.md") };
+        if (entry !== null && !seen.has(entry.file)) {
+            seen.add(entry.file);
+            files.push(entry);
+        }
+    }
+    return files;
+}
+const manifestFile = (paths) => resolve(paths.loreDirectory, "agents.json");
+const hint = (subject, file, error) => ownedFileHint(subject, file, error, "Lore still works through the skill and hooks without the agent.");
+export async function installLoreAgent(paths, installations) {
+    const files = [], warnings = [];
+    let manifest;
+    try {
+        manifest = await readOwnedManifest(manifestFile(paths), "Agent");
+    }
+    catch (error) {
+        warnings.push(hint("Lore agent not installed: cannot read", manifestFile(paths), error));
+        return { files, warnings };
+    }
+    // Best-effort per file, like skills: an unwritable agent directory must not fail the connection.
+    for (const { harness, file } of loreAgentFiles(installations)) {
+        const text = renderLoreAgent(harness);
+        try {
+            if (!await regularPath(file)) {
+                warnings.push(`Lore agent left unchanged because its path is symlinked: ${file}`);
+                continue;
+            }
+            const existing = await readIfPresent(file);
+            if (existing !== null && existing !== text && digest(existing) !== manifest[file]) {
+                warnings.push(`Lore agent left unchanged to preserve your edits: ${file}`);
+                continue;
+            }
+            if (existing !== text)
+                await atomicWrite(file, text);
+            manifest[file] = digest(text);
+            files.push(file);
+        }
+        catch (error) {
+            warnings.push(hint("Lore agent not installed at", file, error));
+        }
+    }
+    try {
+        await atomicWrite(manifestFile(paths), `${JSON.stringify(manifest, null, 2)}\n`);
+    }
+    catch (error) {
+        warnings.push(hint("Lore agent ownership not recorded in", manifestFile(paths), error));
+    }
+    return { files, warnings };
+}
+export async function removeLoreAgent(paths, installations) {
+    const manifest = await readOwnedManifest(manifestFile(paths), "Agent").catch(() => ({}));
+    // Manifest entries never select deletion targets; only known agent locations do.
+    for (const { file } of loreAgentFiles(installations)) {
+        // The agents directory is shared with the customer's own agents; keep it.
+        await removeOwnedFile(file, manifest, false);
+    }
+    if (await regularPath(manifestFile(paths)))
+        await rm(manifestFile(paths), { force: true });
+}
+//# sourceMappingURL=lore-agent.js.map

package/dist/lore-agent.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"lore-agent.js","sourceRoot":"","sources":["../src/lore-agent.ts"],"names":[],"mappings":"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"}

package/dist/mcp-config.d.ts

@@ -5,19 +5,36 @@
  * decide", "share this", and "make this repeatable".
  */
 export declare const LORE_MCP_SERVER_NAME = "lore";
-/** Agents whose hooks are paired with the Lore MCP server. */
-export declare const MCP_HOST_AGENTS: readonly ["claude", "codex", "cursor"];
+/** Agents whose hooks or plugin are paired with the Lore MCP server. */
+export declare const MCP_HOST_AGENTS: readonly ["claude", "codex", "cursor", "copilot-cli", "copilot-vscode"];
 export type McpHostAgent = (typeof MCP_HOST_AGENTS)[number];
+/** Every host that runs the Lore MCP server; OpenCode registers it beside its plugin. */
+export type LoreMcpAgent = McpHostAgent | "opencode";
 /**
  * Build the server entry. `invocation` is the executable plus any script path
  * the CLI needs (empty for the standalone binary); the stored home keeps the
- * server on the same credentials and folder rules as the hooks.
+ * server on the same credentials and folder rules as the hooks, and the host
+ * name attributes saves whose caller passes no `agent`.
  */
-export declare function loreMcpServerEntry(invocation: readonly string[], home: string): Record<string, unknown>;
+export declare function loreMcpServerEntry(invocation: readonly string[], home: string, agent: LoreMcpAgent): Record<string, unknown>;
 export declare function isLoreMcpServer(value: unknown): boolean;
 /** Merge the entry into a JSON host config that lists servers under `mcpServers`. */
 export declare function mergeLoreMcpServers(config: Record<string, unknown>, entry: Record<string, unknown>, agent: string): Record<string, unknown>;
 export declare function removeLoreMcpServers(config: Record<string, unknown>): Record<string, unknown>;
+/**
+ * VS Code reads `.vscode/mcp.json` in the repository, with servers under
+ * `servers` in the same stdio shape (type, command, args, env) the shared
+ * entry already has, so the entry is stored as built.
+ */
+export declare function mergeLoreVsCodeMcp(config: Record<string, unknown>, entry: Record<string, unknown>): Record<string, unknown>;
+export declare function removeLoreVsCodeMcp(config: Record<string, unknown>): Record<string, unknown>;
+/** The Lore entry in a VS Code `servers` map, or undefined when the map holds none. */
+export declare function loreVsCodeMcpServer(config: unknown): unknown;
+/** OpenCode lists servers under `mcp`, with the executable and arguments as one array. */
+export declare function openCodeMcpEntry(entry: Record<string, unknown>): Record<string, unknown>;
+export declare function isLoreOpenCodeMcp(value: unknown): boolean;
+export declare function mergeLoreOpenCodeMcp(config: Record<string, unknown>, entry: Record<string, unknown>): Record<string, unknown>;
+export declare function removeLoreOpenCodeMcp(config: Record<string, unknown>): Record<string, unknown>;
 /** Add or refresh the Lore block without rewriting the rest of the user's file. */
 export declare function mergeLoreCodexMcp(text: string, entry: Record<string, unknown>): string;
 export declare function removeLoreCodexMcp(text: string): string;

package/dist/mcp-config.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"mcp-config.d.ts","sourceRoot":"","sources":["../src/mcp-config.ts"],"names":[],"mappings":"AAEA;;;;;GAKG;AACH,eAAO,MAAM,oBAAoB,SAAS,CAAC;AAE3C,8DAA8D;AAC9D,eAAO,MAAM,eAAe,wCAAyC,CAAC;AACtE,MAAM,MAAM,YAAY,GAAG,CAAC,OAAO,eAAe,CAAC,CAAC,MAAM,CAAC,CAAC;AAiB5D;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,UAAU,EAAE,SAAS,MAAM,EAAE,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAWvG;AAED,wBAAgB,eAAe,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAGvD;AAED,qFAAqF;AACrF,wBAAgB,mBAAmB,CACjC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC/B,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC9B,KAAK,EAAE,MAAM,GACZ,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAUzB;AAED,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAI7F;AAqDD,mFAAmF;AACnF,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAOtF;AAED,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAKvD;AAED,gFAAgF;AAChF,wBAAgB,eAAe,CAC7B,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC7B;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,OAAO,CAAA;CAAE,CAKnC"}
+{"version":3,"file":"mcp-config.d.ts","sourceRoot":"","sources":["../src/mcp-config.ts"],"names":[],"mappings":"AAEA;;;;;GAKG;AACH,eAAO,MAAM,oBAAoB,SAAS,CAAC;AAE3C,wEAAwE;AACxE,eAAO,MAAM,eAAe,yEAA0E,CAAC;AACvG,MAAM,MAAM,YAAY,GAAG,CAAC,OAAO,eAAe,CAAC,CAAC,MAAM,CAAC,CAAC;AAC5D,yFAAyF;AACzF,MAAM,MAAM,YAAY,GAAG,YAAY,GAAG,UAAU,CAAC;AAiBrD;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,UAAU,EAAE,SAAS,MAAM,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,YAAY,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAc5H;AAED,wBAAgB,eAAe,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAGvD;AAED,qFAAqF;AACrF,wBAAgB,mBAAmB,CACjC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC/B,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC9B,KAAK,EAAE,MAAM,GACZ,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAUzB;AAED,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAI7F;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAU3H;AAED,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAI5F;AAED,uFAAuF;AACvF,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,OAAO,GAAG,OAAO,CAE5D;AAED,0FAA0F;AAC1F,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAOxF;AAED,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAGzD;AAED,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAQ7H;AAED,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAI9F;AAqDD,mFAAmF;AACnF,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAOtF;AAED,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAKvD;AAED,gFAAgF;AAChF,wBAAgB,eAAe,CAC7B,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC7B;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,OAAO,CAAA;CAAE,CAKnC"}

package/dist/mcp-config.js

@@ -6,8 +6,8 @@ import { parse as parseToml, stringify as stringifyToml } from "smol-toml";
  * decide", "share this", and "make this repeatable".
  */
 export const LORE_MCP_SERVER_NAME = "lore";
-/** Agents whose hooks are paired with the Lore MCP server. */
-export const MCP_HOST_AGENTS = ["claude", "codex", "cursor"];
+/** Agents whose hooks or plugin are paired with the Lore MCP server. */
+export const MCP_HOST_AGENTS = ["claude", "codex", "cursor", "copilot-cli", "copilot-vscode"];
 const CODEX_MCP_START = "# >>> Lore MCP server >>>";
 const CODEX_MCP_END = "# <<< Lore MCP server <<<";
 function isObject(value) {
@@ -24,20 +24,25 @@ function stableJson(value) {
 /**
  * Build the server entry. `invocation` is the executable plus any script path
  * the CLI needs (empty for the standalone binary); the stored home keeps the
- * server on the same credentials and folder rules as the hooks.
+ * server on the same credentials and folder rules as the hooks, and the host
+ * name attributes saves whose caller passes no `agent`.
  */
-export function loreMcpServerEntry(invocation, home) {
+export function loreMcpServerEntry(invocation, home, agent) {
     const [command, ...prefix] = invocation;
     if (command === undefined)
         throw new Error("The Lore MCP server needs an executable");
-    return {
+    const entry = {
         type: "stdio",
         command,
         args: [...prefix, "mcp", "--owner", "lore"],
         // Writes stay proposals that owners and admins approve; hooks already
         // deliver context per prompt, so the server skips its own delivery tool.
-        env: { LORE_HOME: home, LORE_MCP_WRITE_TOOLS: "true", LORE_MCP_HOST_CONTEXT: "hooks" },
+        env: { LORE_HOME: home, LORE_MCP_WRITE_TOOLS: "true", LORE_MCP_HOST_CONTEXT: "hooks", LORE_MCP_AGENT: agent },
     };
+    // Copilot CLI calls stdio servers "local" and enables tools by name.
+    if (agent === "copilot-cli")
+        return { ...entry, type: "local", tools: ["*"] };
+    return entry;
 }
 export function isLoreMcpServer(value) {
     return isObject(value) && Array.isArray(value.args) && value.args.includes("mcp")
@@ -61,6 +66,61 @@ export function removeLoreMcpServers(config) {
     const { [LORE_MCP_SERVER_NAME]: _lore, ...rest } = config.mcpServers;
     return { ...config, mcpServers: rest };
 }
+/**
+ * VS Code reads `.vscode/mcp.json` in the repository, with servers under
+ * `servers` in the same stdio shape (type, command, args, env) the shared
+ * entry already has, so the entry is stored as built.
+ */
+export function mergeLoreVsCodeMcp(config, entry) {
+    if (config.servers !== undefined && !isObject(config.servers)) {
+        throw new Error('VS Code configuration field "servers" must be a JSON object');
+    }
+    const servers = isObject(config.servers) ? config.servers : {};
+    const existing = servers[LORE_MCP_SERVER_NAME];
+    if (existing !== undefined && !isLoreMcpServer(existing)) {
+        throw new Error(`VS Code MCP name "${LORE_MCP_SERVER_NAME}" is already owned by another server; rename it before connecting.`);
+    }
+    return { ...config, servers: { ...servers, [LORE_MCP_SERVER_NAME]: entry } };
+}
+export function removeLoreVsCodeMcp(config) {
+    if (!isObject(config.servers) || !isLoreMcpServer(config.servers[LORE_MCP_SERVER_NAME]))
+        return config;
+    const { [LORE_MCP_SERVER_NAME]: _lore, ...rest } = config.servers;
+    return { ...config, servers: rest };
+}
+/** The Lore entry in a VS Code `servers` map, or undefined when the map holds none. */
+export function loreVsCodeMcpServer(config) {
+    return isObject(config) && isObject(config.servers) ? config.servers[LORE_MCP_SERVER_NAME] : undefined;
+}
+/** OpenCode lists servers under `mcp`, with the executable and arguments as one array. */
+export function openCodeMcpEntry(entry) {
+    return {
+        type: "local",
+        command: [entry.command, ...(Array.isArray(entry.args) ? entry.args : [])],
+        environment: entry.env,
+        enabled: true,
+    };
+}
+export function isLoreOpenCodeMcp(value) {
+    return isObject(value) && Array.isArray(value.command) && value.command.includes("mcp")
+        && value.command.includes("--owner") && value.command.includes("lore");
+}
+export function mergeLoreOpenCodeMcp(config, entry) {
+    if (config.mcp !== undefined && !isObject(config.mcp))
+        throw new Error('OpenCode configuration field "mcp" must be a JSON object');
+    const servers = isObject(config.mcp) ? config.mcp : {};
+    const existing = servers[LORE_MCP_SERVER_NAME];
+    if (existing !== undefined && !isLoreOpenCodeMcp(existing)) {
+        throw new Error(`OpenCode MCP name "${LORE_MCP_SERVER_NAME}" is already owned by another server; rename it before connecting.`);
+    }
+    return { ...config, mcp: { ...servers, [LORE_MCP_SERVER_NAME]: openCodeMcpEntry(entry) } };
+}
+export function removeLoreOpenCodeMcp(config) {
+    if (!isObject(config.mcp) || !isLoreOpenCodeMcp(config.mcp[LORE_MCP_SERVER_NAME]))
+        return config;
+    const { [LORE_MCP_SERVER_NAME]: _lore, ...rest } = config.mcp;
+    return Object.keys(rest).length === 0 ? Object.fromEntries(Object.entries(config).filter(([key]) => key !== "mcp")) : { ...config, mcp: rest };
+}
 /** Codex lists servers in TOML; it has no `type` field. */
 function codexMcpTable(entry) {
     const { type: _type, ...table } = entry;

package/dist/mcp-config.js.map

@@ -1 +1 @@
-{"version":3,"file":"mcp-config.js","sourceRoot":"","sources":["../src/mcp-config.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"mcp-config.js","sourceRoot":"","sources":["../src/mcp-config.ts"],"names":[],"mappings":"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"}

package/dist/owned-files.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Files Lore writes into an agent's own directories (skills, agent
+ * definitions) and must later remove without touching the customer's edits.
+ * Ownership is a manifest of file path to content digest; a file is only
+ * rewritten or deleted while its content still matches the recorded digest.
+ */
+export declare const digest: (text: string) => string;
+export type OwnedManifest = Record<string, string>;
+/** True when no component of the path is a symlink. Lore never follows links into other files. */
+export declare function regularPath(path: string): Promise<boolean>;
+export declare function readOwnedManifest(file: string, subject: string): Promise<OwnedManifest>;
+export declare function atomicWrite(file: string, text: string): Promise<void>;
+export declare function readIfPresent(file: string): Promise<string | null>;
+/**
+ * Delete the file when the manifest owns it and its content is unchanged;
+ * then drop an empty parent directory and the manifest entry. Returns false
+ * when the file was left alone.
+ */
+export declare function removeOwnedFile(file: string, manifest: OwnedManifest, removeEmptyDirectory?: boolean): Promise<boolean>;
+export declare function ownedFileHint(subject: string, file: string, error: unknown, consequence: string): string;
+//# sourceMappingURL=owned-files.d.ts.map

package/dist/owned-files.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"owned-files.d.ts","sourceRoot":"","sources":["../src/owned-files.ts"],"names":[],"mappings":"AAIA;;;;;GAKG;AACH,eAAO,MAAM,MAAM,GAAI,MAAM,MAAM,KAAG,MAAyD,CAAC;AAEhG,MAAM,MAAM,aAAa,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;AAEnD,kGAAkG;AAClG,wBAAsB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAWhE;AAED,wBAAsB,iBAAiB,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC,CAU7F;AAED,wBAAsB,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAK3E;AAED,wBAAsB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAKxE;AAED;;;;GAIG;AACH,wBAAsB,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,aAAa,EAAE,oBAAoB,UAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAe1H;AAED,wBAAgB,aAAa,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,WAAW,EAAE,MAAM,GAAG,MAAM,CAIxG"}