hermes-action-bridge 0.2.0

package/dist/install/file-edit.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-edit.js","sourceRoot":"","sources":["../../src/install/file-edit.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AASlE;;;;GAIG;AACH,MAAM,UAAU,aAAa,CAAC,IAAY,EAAE,IAA6C,EAAE,MAAe;IACxG,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,YAAY,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;QAC1E,IAAI,MAAM,CAAC,MAAM,KAAK,WAAW,IAAI,MAAM,CAAC,MAAM,KAAK,SAAS,IAAI,CAAC,MAAM;YAAE,aAAa,CAAC,IAAI,EAAE,MAAM,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;QACzH,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC;IACtE,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC;IAC3G,CAAC;AACH,CAAC"}

package/dist/install/install-service.d.ts

@@ -0,0 +1,26 @@
+import type { FileChange, InstallOptions, InstallScope, ManagedState, PathContext, SkillAgent } from "./types.js";
+export type SkillTarget = SkillAgent | "all";
+export interface ServiceOptions extends InstallOptions {
+    scope: InstallScope;
+}
+export interface TargetResult {
+    agent: SkillAgent;
+    ok: boolean;
+    changes: FileChange[];
+}
+export interface SkillPreview {
+    agent: SkillAgent;
+    files: {
+        path: string;
+        content: string;
+    }[];
+}
+export declare function installSkills(target: SkillTarget, ctx: PathContext, options: ServiceOptions): TargetResult[];
+export declare function uninstallSkills(target: SkillTarget, ctx: PathContext, options: ServiceOptions): TargetResult[];
+export declare function installHint(target: SkillTarget, ctx: PathContext, options: ServiceOptions): TargetResult[];
+export declare function uninstallHint(target: SkillTarget, ctx: PathContext, options: ServiceOptions): TargetResult[];
+export declare function previewSkills(target: SkillTarget, ctx: PathContext, scope: InstallScope): SkillPreview[];
+export declare function skillStates(ctx: PathContext, scope: InstallScope): {
+    agent: SkillAgent;
+    state: ManagedState;
+}[];

package/dist/install/install-service.js

@@ -0,0 +1,59 @@
+import { join } from "node:path";
+import { instructionFile, skillDir } from "./paths.js";
+import { projectHint, skillMarkdown } from "./templates.js";
+import { classifyBundle, removeBundle, writeBundle } from "./managed-file.js";
+import { removeBlock, upsertBlock } from "./marker-block.js";
+import { applyFileEdit } from "./file-edit.js";
+const allAgents = ["claude-code", "codex"];
+function agentsFor(target) {
+    return target === "all" ? allAgents : [target];
+}
+function bundleAt(dir) {
+    return { dir, files: { "SKILL.md": skillMarkdown() } };
+}
+function bundleFor(agent, ctx, scope) {
+    return bundleAt(skillDir(agent, ctx, scope));
+}
+/**
+ * Run one filesystem operation per agent, isolating failures so one agent cannot abort the others.
+ * The per-agent target path is resolved once and passed to `op`, and reused to report a thrown error.
+ */
+function perAgent(target, pathOf, op) {
+    return agentsFor(target).map((agent) => {
+        const path = pathOf(agent);
+        try {
+            const changes = op(path);
+            return { agent, ok: !changes.some((change) => change.action === "refused"), changes };
+        }
+        catch (error) {
+            const reason = error instanceof Error ? error.message : String(error);
+            return { agent, ok: false, changes: [{ path, action: "refused", reason }] };
+        }
+    });
+}
+export function installSkills(target, ctx, options) {
+    return perAgent(target, (agent) => skillDir(agent, ctx, options.scope), (dir) => writeBundle(bundleAt(dir), options));
+}
+export function uninstallSkills(target, ctx, options) {
+    return perAgent(target, (agent) => skillDir(agent, ctx, options.scope), (dir) => removeBundle(dir, options));
+}
+export function installHint(target, ctx, options) {
+    return perAgent(target, (agent) => instructionFile(agent, ctx), (file) => [
+        applyFileEdit(file, (existing) => upsertBlock(existing, projectHint()), options.dryRun),
+    ]);
+}
+export function uninstallHint(target, ctx, options) {
+    return perAgent(target, (agent) => instructionFile(agent, ctx), (file) => [
+        applyFileEdit(file, (existing) => (existing === null ? { content: "", action: "unchanged" } : removeBlock(existing)), options.dryRun),
+    ]);
+}
+export function previewSkills(target, ctx, scope) {
+    return agentsFor(target).map((agent) => {
+        const bundle = bundleFor(agent, ctx, scope);
+        return { agent, files: Object.entries(bundle.files).map(([name, content]) => ({ path: join(bundle.dir, name), content })) };
+    });
+}
+export function skillStates(ctx, scope) {
+    return allAgents.map((agent) => ({ agent, state: classifyBundle(bundleFor(agent, ctx, scope)) }));
+}
+//# sourceMappingURL=install-service.js.map

package/dist/install/install-service.js.map

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

package/dist/install/managed-file.d.ts

@@ -0,0 +1,9 @@
+import type { FileChange, InstallOptions, ManagedState } from "./types.js";
+export interface ManagedBundle {
+    dir: string;
+    /** Filename (relative to `dir`) -> file content. */
+    files: Record<string, string>;
+}
+export declare function classifyBundle(bundle: ManagedBundle): ManagedState;
+export declare function writeBundle(bundle: ManagedBundle, options: InstallOptions): FileChange[];
+export declare function removeBundle(dir: string, options: InstallOptions): FileChange[];

package/dist/install/managed-file.js

@@ -0,0 +1,157 @@
+import { existsSync, mkdirSync, readFileSync, readdirSync, renameSync, rmdirSync, unlinkSync, writeFileSync } from "node:fs";
+import { dirname, join } from "node:path";
+import { contentVersion } from "./templates.js";
+/**
+ * Provenance lockfile written alongside the managed content. Its presence marks the directory as
+ * ours; the recorded per-file hashes detect later hand-edits, and `version` detects template drift.
+ */
+const lockName = ".hermes-action-managed.json";
+function hashFiles(files) {
+    return Object.fromEntries(Object.entries(files).map(([name, content]) => [name, contentVersion(content)]));
+}
+function versionFromHashes(hashes) {
+    const canonical = Object.entries(hashes).sort(([a], [b]) => (a < b ? -1 : a > b ? 1 : 0));
+    return contentVersion(JSON.stringify(canonical));
+}
+function bundleVersion(files) {
+    return versionFromHashes(hashFiles(files));
+}
+function readLock(dir) {
+    const lockPath = join(dir, lockName);
+    if (!existsSync(lockPath))
+        return null;
+    try {
+        const parsed = JSON.parse(readFileSync(lockPath, "utf8"));
+        if (parsed === null || typeof parsed !== "object")
+            return null;
+        const lock = parsed;
+        if (typeof lock.version !== "string" || typeof lock.files !== "object" || lock.files === null)
+            return null;
+        const files = lock.files;
+        if (!Object.values(files).every((value) => typeof value === "string"))
+            return null;
+        return { version: lock.version, files: files };
+    }
+    catch {
+        return null;
+    }
+}
+/** Inspection helpers never throw: an unreadable file is reported as "not matching" rather than crashing. */
+function diskHash(path) {
+    try {
+        return contentVersion(readFileSync(path, "utf8"));
+    }
+    catch {
+        return null;
+    }
+}
+function dirHasEntries(dir) {
+    try {
+        return readdirSync(dir).length > 0;
+    }
+    catch {
+        return false;
+    }
+}
+/** True when every file recorded in the lock is still on disk with its recorded content. */
+function lockIntact(dir, lock) {
+    return Object.entries(lock.files).every(([name, hash]) => diskHash(join(dir, name)) === hash);
+}
+export function classifyBundle(bundle) {
+    const lock = readLock(bundle.dir);
+    if (lock) {
+        if (!lockIntact(bundle.dir, lock))
+            return "user-modified";
+        return lock.version === bundleVersion(bundle.files) ? "current" : "stale";
+    }
+    // No readable lock: a present-but-unparseable lockfile, or any of our content files, means
+    // something we did not write is here -> refuse (foreign). An empty directory means absent.
+    const lockFilePresent = existsSync(join(bundle.dir, lockName));
+    const anyContentPresent = Object.keys(bundle.files).some((name) => existsSync(join(bundle.dir, name)));
+    return lockFilePresent || anyContentPresent ? "foreign" : "absent";
+}
+// Write-path failures (permission denied, disk full) intentionally propagate to the caller, which
+// reports them per target; only best-effort directory cleanup is swallowed.
+function atomicWrite(filePath, content) {
+    mkdirSync(dirname(filePath), { recursive: true });
+    const tmp = `${filePath}.hab-tmp`;
+    writeFileSync(tmp, content, "utf8");
+    renameSync(tmp, filePath);
+}
+function writeBundleFiles(bundle) {
+    const previous = readLock(bundle.dir);
+    const hashes = hashFiles(bundle.files);
+    for (const [name, content] of Object.entries(bundle.files)) {
+        atomicWrite(join(bundle.dir, name), content);
+    }
+    const lock = { version: versionFromHashes(hashes), files: hashes };
+    atomicWrite(join(bundle.dir, lockName), `${JSON.stringify(lock, null, 2)}\n`);
+    removeDroppedFiles(bundle.dir, previous, bundle.files);
+}
+/** Delete files recorded by a previous version that the current bundle no longer ships. */
+function removeDroppedFiles(dir, previous, current) {
+    if (!previous)
+        return;
+    for (const name of Object.keys(previous.files)) {
+        if (name in current)
+            continue;
+        const path = join(dir, name);
+        if (existsSync(path))
+            unlinkSync(path);
+    }
+}
+function changes(bundle, action) {
+    return Object.keys(bundle.files).map((name) => ({ path: join(bundle.dir, name), action }));
+}
+function refusal(dir, reason) {
+    return [{ path: dir, action: "refused", reason }];
+}
+export function writeBundle(bundle, options) {
+    const state = classifyBundle(bundle);
+    if (state === "current")
+        return changes(bundle, "unchanged");
+    if (state === "foreign") {
+        return refusal(bundle.dir, `a non-managed file already exists in ${bundle.dir}; refusing to overwrite`);
+    }
+    if ((state === "stale" || state === "user-modified") && !options.force) {
+        const why = state === "stale" ? "is out of date" : "was modified locally";
+        return refusal(bundle.dir, `the installed skill ${why}; re-run with --force to overwrite`);
+    }
+    const action = state === "absent" ? "created" : "updated";
+    if (!options.dryRun)
+        writeBundleFiles(bundle);
+    return changes(bundle, action);
+}
+export function removeBundle(dir, options) {
+    const lock = readLock(dir);
+    if (!lock) {
+        if (dirHasEntries(dir))
+            return refusal(dir, `${dir} is not a managed skill; refusing to remove`);
+        return [];
+    }
+    if (!lockIntact(dir, lock) && !options.force) {
+        return refusal(dir, `the installed skill was modified locally; re-run with --force to remove`);
+    }
+    if (!options.dryRun)
+        removeBundleFiles(dir, lock);
+    return [{ path: dir, action: "removed" }];
+}
+function removeBundleFiles(dir, lock) {
+    for (const name of Object.keys(lock.files)) {
+        const path = join(dir, name);
+        if (existsSync(path))
+            unlinkSync(path);
+    }
+    const lockPath = join(dir, lockName);
+    if (existsSync(lockPath))
+        unlinkSync(lockPath);
+    if (!dirHasEntries(dir)) {
+        try {
+            rmdirSync(dir);
+        }
+        catch {
+            // Best effort: leaving an empty directory behind is harmless.
+        }
+    }
+}
+//# sourceMappingURL=managed-file.js.map

package/dist/install/managed-file.js.map

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

package/dist/install/marker-block.d.ts

@@ -0,0 +1,10 @@
+import type { FileAction } from "./types.js";
+export interface MarkerResult {
+    content: string;
+    action: FileAction;
+    reason?: string | undefined;
+}
+/** Insert or update the single managed block, preserving all content outside it. */
+export declare function upsertBlock(existing: string | null, innerText: string): MarkerResult;
+/** Remove the managed block, tidying only the seam and leaving all other content byte-for-byte. */
+export declare function removeBlock(existing: string): MarkerResult;

package/dist/install/marker-block.js

@@ -0,0 +1,61 @@
+const startMarker = "<!-- hermes-action-bridge:start -->";
+const endMarker = "<!-- hermes-action-bridge:end -->";
+function block(innerText) {
+    return `${startMarker}\n${innerText}\n${endMarker}`;
+}
+function countOccurrences(haystack, needle) {
+    return haystack.split(needle).length - 1;
+}
+/** Reject ambiguous marker states rather than guessing block boundaries (data-loss guard). */
+function markersMalformed(content) {
+    const starts = countOccurrences(content, startMarker);
+    const ends = countOccurrences(content, endMarker);
+    if (starts !== ends || starts > 1)
+        return true;
+    return starts === 1 && content.indexOf(startMarker) > content.indexOf(endMarker);
+}
+/** Insert or update the single managed block, preserving all content outside it. */
+export function upsertBlock(existing, innerText) {
+    const desired = block(innerText);
+    if (existing === null)
+        return { content: `${desired}\n`, action: "created" };
+    if (markersMalformed(existing)) {
+        return { content: existing, action: "refused", reason: "existing hermes-action-bridge markers are malformed" };
+    }
+    if (existing.includes(startMarker)) {
+        const before = existing.slice(0, existing.indexOf(startMarker));
+        const after = existing.slice(existing.indexOf(endMarker) + endMarker.length);
+        const content = before + desired + after;
+        return { content, action: content === existing ? "unchanged" : "updated" };
+    }
+    if (existing.trim() === "")
+        return { content: `${desired}\n`, action: "updated" };
+    // Append after the existing content, preserving its bytes, with exactly one blank line before the block.
+    const blankLineGap = "\n".repeat(Math.max(0, 2 - trailingNewlines(existing)));
+    return { content: `${existing}${blankLineGap}${desired}\n`, action: "updated" };
+}
+/** Remove the managed block, tidying only the seam and leaving all other content byte-for-byte. */
+export function removeBlock(existing) {
+    if (markersMalformed(existing)) {
+        return { content: existing, action: "refused", reason: "existing hermes-action-bridge markers are malformed" };
+    }
+    if (!existing.includes(startMarker))
+        return { content: existing, action: "unchanged" };
+    const before = existing.slice(0, existing.indexOf(startMarker)).replace(/(\r?\n)+$/, "");
+    const after = existing.slice(existing.indexOf(endMarker) + endMarker.length).replace(/^(\r?\n)+/, "");
+    return { content: joinSeam(before, after), action: "removed" };
+}
+/** Re-join content around a removed block: one blank line if it sat between sections, else a clean edge. */
+function joinSeam(before, after) {
+    if (before === "")
+        return after;
+    if (after === "")
+        return `${before}\n`;
+    return `${before}\n\n${after}`;
+}
+/** Count trailing line breaks, tolerating both LF and CRLF endings. */
+function trailingNewlines(text) {
+    const tail = text.slice(text.replace(/(\r?\n)+$/, "").length);
+    return tail === "" ? 0 : tail.split(/\r?\n/).length - 1;
+}
+//# sourceMappingURL=marker-block.js.map

package/dist/install/marker-block.js.map

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

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

@@ -0,0 +1,15 @@
+import { type EditResult } from "./file-edit.js";
+import type { FileChange } from "./types.js";
+export interface McpClientSnippet {
+    client: string;
+    location: string;
+    content: string;
+}
+/** Copy-paste MCP config per client. Printing is the default; only the Claude Code writer mutates a file. */
+export declare function mcpSnippets(): McpClientSnippet[];
+/** Add the hermes-action server to a Claude Code `.mcp.json`, preserving every other key. */
+export declare function mergeMcpJson(existing: string | null): EditResult;
+/** Remove the hermes-action server from a Claude Code `.mcp.json`, leaving other servers in place. */
+export declare function unmergeMcpJson(existing: string | null): EditResult;
+export declare function writeMcpJson(file: string, dryRun: boolean): FileChange;
+export declare function removeMcpJson(file: string, dryRun: boolean): FileChange;

package/dist/install/mcp-config.js

@@ -0,0 +1,65 @@
+import { mcpServerEntry, mcpServerName, mcpSnippetCodexToml, mcpSnippetJson } from "./templates.js";
+import { applyFileEdit } from "./file-edit.js";
+/** Copy-paste MCP config per client. Printing is the default; only the Claude Code writer mutates a file. */
+export function mcpSnippets() {
+    return [
+        { client: "Claude Code / Cursor / VS Code", location: "project .mcp.json (or ~/.cursor/mcp.json)", content: mcpSnippetJson() },
+        { client: "Codex", location: "~/.codex/config.toml", content: mcpSnippetCodexToml() },
+    ];
+}
+function isObject(value) {
+    return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function render(value) {
+    return `${JSON.stringify(value, null, 2)}\n`;
+}
+/** Stable serialization (object keys sorted) so the idempotency check ignores key order. */
+function canonical(value) {
+    return JSON.stringify(value, (_key, val) => isObject(val) ? Object.fromEntries(Object.entries(val).sort(([a], [b]) => (a < b ? -1 : a > b ? 1 : 0))) : val);
+}
+/** Add the hermes-action server to a Claude Code `.mcp.json`, preserving every other key. */
+export function mergeMcpJson(existing) {
+    if (existing === null)
+        return { content: render({ mcpServers: { [mcpServerName]: mcpServerEntry } }), action: "created" };
+    let parsed;
+    try {
+        parsed = JSON.parse(existing);
+    }
+    catch {
+        return { content: existing, action: "refused", reason: "existing .mcp.json is not valid JSON" };
+    }
+    if (!isObject(parsed))
+        return { content: existing, action: "refused", reason: "existing .mcp.json is not a JSON object" };
+    if ("mcpServers" in parsed && !isObject(parsed.mcpServers)) {
+        return { content: existing, action: "refused", reason: "existing .mcp.json has a non-object mcpServers; refusing to overwrite" };
+    }
+    const servers = isObject(parsed.mcpServers) ? parsed.mcpServers : {};
+    if (canonical(servers[mcpServerName]) === canonical(mcpServerEntry))
+        return { content: existing, action: "unchanged" };
+    return { content: render({ ...parsed, mcpServers: { ...servers, [mcpServerName]: mcpServerEntry } }), action: "updated" };
+}
+/** Remove the hermes-action server from a Claude Code `.mcp.json`, leaving other servers in place. */
+export function unmergeMcpJson(existing) {
+    if (existing === null)
+        return { content: "", action: "unchanged" };
+    let parsed;
+    try {
+        parsed = JSON.parse(existing);
+    }
+    catch {
+        return { content: existing, action: "refused", reason: "existing .mcp.json is not valid JSON" };
+    }
+    if (!isObject(parsed) || !isObject(parsed.mcpServers) || !(mcpServerName in parsed.mcpServers)) {
+        return { content: existing, action: "unchanged" };
+    }
+    const servers = { ...parsed.mcpServers };
+    delete servers[mcpServerName];
+    return { content: render({ ...parsed, mcpServers: servers }), action: "removed" };
+}
+export function writeMcpJson(file, dryRun) {
+    return applyFileEdit(file, mergeMcpJson, dryRun);
+}
+export function removeMcpJson(file, dryRun) {
+    return applyFileEdit(file, unmergeMcpJson, dryRun);
+}
+//# sourceMappingURL=mcp-config.js.map

package/dist/install/mcp-config.js.map

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

package/dist/install/paths.d.ts

@@ -0,0 +1,6 @@
+import type { InstallScope, PathContext, SkillAgent } from "./types.js";
+export declare const skillName = "hermes-action-bridge";
+/** Directory that holds the bridge skill for an agent, e.g. `~/.claude/skills/hermes-action-bridge`. */
+export declare function skillDir(agent: SkillAgent, ctx: PathContext, scope: InstallScope): string;
+/** Project instruction file for an agent (`CLAUDE.md` or `AGENTS.md`), always resolved against the project cwd. */
+export declare function instructionFile(agent: SkillAgent, ctx: PathContext): string;

package/dist/install/paths.js

@@ -0,0 +1,22 @@
+import { join } from "node:path";
+export const skillName = "hermes-action-bridge";
+const agentConfigDir = {
+    "claude-code": ".claude",
+    codex: ".codex",
+};
+const agentInstructionFile = {
+    "claude-code": "CLAUDE.md",
+    codex: "AGENTS.md",
+};
+function scopeRoot(ctx, scope) {
+    return scope === "global" ? ctx.homeDir : ctx.cwd;
+}
+/** Directory that holds the bridge skill for an agent, e.g. `~/.claude/skills/hermes-action-bridge`. */
+export function skillDir(agent, ctx, scope) {
+    return join(scopeRoot(ctx, scope), agentConfigDir[agent], "skills", skillName);
+}
+/** Project instruction file for an agent (`CLAUDE.md` or `AGENTS.md`), always resolved against the project cwd. */
+export function instructionFile(agent, ctx) {
+    return join(ctx.cwd, agentInstructionFile[agent]);
+}
+//# sourceMappingURL=paths.js.map

package/dist/install/paths.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"paths.js","sourceRoot":"","sources":["../../src/install/paths.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAGjC,MAAM,CAAC,MAAM,SAAS,GAAG,sBAAsB,CAAC;AAEhD,MAAM,cAAc,GAA+B;IACjD,aAAa,EAAE,SAAS;IACxB,KAAK,EAAE,QAAQ;CAChB,CAAC;AAEF,MAAM,oBAAoB,GAA+B;IACvD,aAAa,EAAE,WAAW;IAC1B,KAAK,EAAE,WAAW;CACnB,CAAC;AAEF,SAAS,SAAS,CAAC,GAAgB,EAAE,KAAmB;IACtD,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC;AACpD,CAAC;AAED,wGAAwG;AACxG,MAAM,UAAU,QAAQ,CAAC,KAAiB,EAAE,GAAgB,EAAE,KAAmB;IAC/E,OAAO,IAAI,CAAC,SAAS,CAAC,GAAG,EAAE,KAAK,CAAC,EAAE,cAAc,CAAC,KAAK,CAAC,EAAE,QAAQ,EAAE,SAAS,CAAC,CAAC;AACjF,CAAC;AAED,mHAAmH;AACnH,MAAM,UAAU,eAAe,CAAC,KAAiB,EAAE,GAAgB;IACjE,OAAO,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,oBAAoB,CAAC,KAAK,CAAC,CAAC,CAAC;AACpD,CAAC"}

package/dist/install/templates.d.ts

@@ -0,0 +1,16 @@
+/** Short, stable content hash used to detect drift between an installed file and the current template. */
+export declare function contentVersion(content: string): string;
+/** Shared `SKILL.md` body. Identical for Claude Code and Codex (SKILL.md is an open standard). */
+export declare function skillMarkdown(): string;
+/** Inner text of the marker-managed hint added to CLAUDE.md / AGENTS.md (opt-in only). */
+export declare function projectHint(): string;
+/** Canonical MCP server entry for hermes-action, shared by the printed snippets and the .mcp.json writer. */
+export declare const mcpServerName = "hermes-action";
+export declare const mcpServerEntry: {
+    readonly command: "hermes-action";
+    readonly args: readonly ["mcp"];
+};
+/** MCP config snippet for JSON clients (Claude Code, Cursor, VS Code). */
+export declare function mcpSnippetJson(): string;
+/** MCP config snippet for Codex (`~/.codex/config.toml`, TOML format). */
+export declare function mcpSnippetCodexToml(): string;

package/dist/install/templates.js

@@ -0,0 +1,86 @@
+import { createHash } from "node:crypto";
+/** Short, stable content hash used to detect drift between an installed file and the current template. */
+export function contentVersion(content) {
+    return createHash("sha256").update(content).digest("hex").slice(0, 16);
+}
+/** Shared `SKILL.md` body. Identical for Claude Code and Codex (SKILL.md is an open standard). */
+export function skillMarkdown() {
+    return `---
+name: hermes-action-bridge
+description: Delegate external actions, Hermes skills, browser automation, messaging, cron jobs, and integrations to Hermes Agent through hermes-action. Use when a task needs capabilities outside the local coding session.
+---
+
+# Hermes Action Bridge
+
+Use this skill when a task needs capabilities outside the local coding session:
+Hermes skills or memory, messaging platforms, browser automation, scheduled or
+cron automation, external research, or any platform integration already
+configured in Hermes Agent.
+
+Do not reimplement those integrations here. Delegate them to Hermes through the
+\`hermes-action\` CLI.
+
+## When to use
+
+- The task requires a Hermes skill, tool, profile, or connected service.
+- The task needs a real-world action that is not local code editing.
+- The task needs research, messaging, browser, or scheduled automation Hermes owns.
+
+## Safe default
+
+Ask Hermes for a plan first; it has no side effects:
+
+\`\`\`bash
+hermes-action run --mode plan "<describe what Hermes should do>"
+\`\`\`
+
+## With context
+
+Write a concise handoff to a file and pass it explicitly:
+
+\`\`\`bash
+hermes-action run --preset coding --context ./handoff.md "<request>"
+\`\`\`
+
+## External side effects
+
+For public posts, outbound email or messages, deletes, payments, credential
+changes, or git pushes, require human approval:
+
+\`\`\`bash
+hermes-action run --mode request-approval "<request requiring side effects>"
+\`\`\`
+
+Never use \`--yolo\` unless the human explicitly asked for trusted local
+execution. It bypasses only the bridge policy, not Hermes' own safety rules.
+
+## Verify setup
+
+\`\`\`bash
+hermes-action status
+hermes-action run --dry-run --json "Return BRIDGE_OK only."
+\`\`\`
+`;
+}
+/** Inner text of the marker-managed hint added to CLAUDE.md / AGENTS.md (opt-in only). */
+export function projectHint() {
+    return [
+        "When a task requires Hermes Agent capabilities (skills, memory, messaging,",
+        "browser automation, cron, research, or platform integrations), use the",
+        "`hermes-action-bridge` skill and delegate through `hermes-action`. Prefer",
+        "`--mode plan` or `--mode request-approval`; never use `--yolo` unless the",
+        "human explicitly requested trusted local execution.",
+    ].join("\n");
+}
+/** Canonical MCP server entry for hermes-action, shared by the printed snippets and the .mcp.json writer. */
+export const mcpServerName = "hermes-action";
+export const mcpServerEntry = { command: "hermes-action", args: ["mcp"] };
+/** MCP config snippet for JSON clients (Claude Code, Cursor, VS Code). */
+export function mcpSnippetJson() {
+    return `${JSON.stringify({ mcpServers: { [mcpServerName]: mcpServerEntry } }, null, 2)}\n`;
+}
+/** MCP config snippet for Codex (`~/.codex/config.toml`, TOML format). */
+export function mcpSnippetCodexToml() {
+    return ['[mcp_servers.hermes-action]', 'command = "hermes-action"', 'args = ["mcp"]', ""].join("\n");
+}
+//# sourceMappingURL=templates.js.map

package/dist/install/templates.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"templates.js","sourceRoot":"","sources":["../../src/install/templates.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAEzC,0GAA0G;AAC1G,MAAM,UAAU,cAAc,CAAC,OAAe;IAC5C,OAAO,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;AACzE,CAAC;AAED,kGAAkG;AAClG,MAAM,UAAU,aAAa;IAC3B,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAuDR,CAAC;AACF,CAAC;AAED,0FAA0F;AAC1F,MAAM,UAAU,WAAW;IACzB,OAAO;QACL,4EAA4E;QAC5E,wEAAwE;QACxE,2EAA2E;QAC3E,2EAA2E;QAC3E,qDAAqD;KACtD,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACf,CAAC;AAED,6GAA6G;AAC7G,MAAM,CAAC,MAAM,aAAa,GAAG,eAAe,CAAC;AAC7C,MAAM,CAAC,MAAM,cAAc,GAAG,EAAE,OAAO,EAAE,eAAe,EAAE,IAAI,EAAE,CAAC,KAAK,CAAC,EAAW,CAAC;AAEnF,0EAA0E;AAC1E,MAAM,UAAU,cAAc;IAC5B,OAAO,GAAG,IAAI,CAAC,SAAS,CAAC,EAAE,UAAU,EAAE,EAAE,CAAC,aAAa,CAAC,EAAE,cAAc,EAAE,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC;AAC7F,CAAC;AAED,0EAA0E;AAC1E,MAAM,UAAU,mBAAmB;IACjC,OAAO,CAAC,6BAA6B,EAAE,2BAA2B,EAAE,gBAAgB,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACvG,CAAC"}

package/dist/install/types.d.ts

@@ -0,0 +1,18 @@
+export type SkillAgent = "claude-code" | "codex";
+export type InstallTarget = SkillAgent | "all" | "mcp";
+export type InstallScope = "global" | "project";
+export type ManagedState = "absent" | "current" | "stale" | "user-modified" | "foreign";
+export type FileAction = "created" | "updated" | "unchanged" | "removed" | "refused";
+export interface FileChange {
+    path: string;
+    action: FileAction;
+    reason?: string | undefined;
+}
+export interface PathContext {
+    homeDir: string;
+    cwd: string;
+}
+export interface InstallOptions {
+    force: boolean;
+    dryRun: boolean;
+}

package/dist/install/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/install/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/install/types.ts"],"names":[],"mappings":""}

package/dist/mcp-server.d.ts

@@ -0,0 +1 @@
+export declare function startMcpServer(configPath?: string): Promise<void>;