octoflow-core 1.0.0

package/dist/capabilities/skills/symlink-handoff-sentinel.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Sentinel + lock bookkeeping for `symlink-handoff.ts`.
+ *
+ * Extracted so the main file stays below the 400-line soft cap; keep this
+ * file focused on filesystem-level bookkeeping — no skill semantics.
+ */
+export declare const SENTINEL_NAME = ".managed-by-octoflow";
+export interface SentinelEntry {
+    target: string;
+    createdAt: string;
+}
+export interface SentinelFile {
+    version: 1;
+    bridge: string;
+    entries: Record<string, SentinelEntry>;
+}
+export declare function readSentinel(parent: string, bridgeVersion: string): Promise<SentinelFile>;
+export declare function writeSentinel(parent: string, sentinel: SentinelFile): Promise<void>;
+export declare function acquireLock(parent: string): Promise<() => Promise<void>>;
+export declare function removeOwnedEntries(parent: string, names: Set<string>, bridgeVersion: string): Promise<void>;
+export declare function errMsg(err: unknown): string;
+//# sourceMappingURL=symlink-handoff-sentinel.d.ts.map

package/dist/capabilities/skills/symlink-handoff-sentinel.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"symlink-handoff-sentinel.d.ts","sourceRoot":"","sources":["../../../src/capabilities/skills/symlink-handoff-sentinel.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAKH,eAAO,MAAM,aAAa,yBAAyB,CAAC;AAIpD,MAAM,WAAW,aAAa;IAC5B,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,CAAC,CAAC;IACX,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC;CACxC;AAED,wBAAsB,YAAY,CAChC,MAAM,EAAE,MAAM,EACd,aAAa,EAAE,MAAM,GACpB,OAAO,CAAC,YAAY,CAAC,CAqBvB;AAED,wBAAsB,aAAa,CACjC,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,YAAY,GACrB,OAAO,CAAC,IAAI,CAAC,CAQf;AAED,wBAAsB,WAAW,CAC/B,MAAM,EAAE,MAAM,GACb,OAAO,CAAC,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC,CAiC9B;AAED,wBAAsB,kBAAkB,CACtC,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,GAAG,CAAC,MAAM,CAAC,EAClB,aAAa,EAAE,MAAM,GACpB,OAAO,CAAC,IAAI,CAAC,CAiCf;AAED,wBAAgB,MAAM,CAAC,GAAG,EAAE,OAAO,GAAG,MAAM,CAE3C"}

package/dist/capabilities/skills/symlink-handoff-sentinel.js

@@ -0,0 +1,110 @@
+import { promises as fs } from "node:fs";
+import path from "node:path";
+const SENTINEL_NAME = ".managed-by-octoflow";
+const LOCK_NAME = ".managed-by-octoflow.lock";
+const STALE_LOCK_MS = 5e3;
+async function readSentinel(parent, bridgeVersion) {
+  const file = path.join(parent, SENTINEL_NAME);
+  try {
+    const raw = await fs.readFile(file, "utf8");
+    const parsed = JSON.parse(raw);
+    if (parsed && parsed.version === 1 && parsed.entries && typeof parsed.entries === "object") {
+      return {
+        version: 1,
+        bridge: parsed.bridge ?? bridgeVersion,
+        entries: parsed.entries
+      };
+    }
+  } catch {
+  }
+  return { version: 1, bridge: bridgeVersion, entries: {} };
+}
+async function writeSentinel(parent, sentinel) {
+  const file = path.join(parent, SENTINEL_NAME);
+  if (Object.keys(sentinel.entries).length === 0) {
+    await fs.rm(file, { force: true });
+    return;
+  }
+  const body = JSON.stringify(sentinel, null, 2);
+  await fs.writeFile(file, body, "utf8");
+}
+async function acquireLock(parent) {
+  const lock = path.join(parent, LOCK_NAME);
+  const start = Date.now();
+  for (; ; ) {
+    try {
+      const handle = await fs.open(lock, "wx");
+      await handle.close();
+      return async () => {
+        try {
+          await fs.rm(lock, { force: true });
+        } catch {
+        }
+      };
+    } catch (err) {
+      if (err.code !== "EEXIST") {
+        return async () => {
+        };
+      }
+      try {
+        const s = await fs.stat(lock);
+        if (Date.now() - s.mtimeMs > STALE_LOCK_MS) {
+          await fs.rm(lock, { force: true });
+          continue;
+        }
+      } catch {
+        continue;
+      }
+      if (Date.now() - start > STALE_LOCK_MS * 2) {
+        return async () => {
+        };
+      }
+      await new Promise((r) => setTimeout(r, 50));
+    }
+  }
+}
+async function removeOwnedEntries(parent, names, bridgeVersion) {
+  const release = await acquireLock(parent);
+  try {
+    const sentinel = await readSentinel(parent, bridgeVersion);
+    for (const name of names) {
+      const entry = sentinel.entries[name];
+      if (!entry) continue;
+      const linkPath = path.join(parent, name);
+      try {
+        const stat = await fs.lstat(linkPath);
+        if (stat.isSymbolicLink()) {
+          await fs.unlink(linkPath);
+        }
+      } catch {
+      }
+      delete sentinel.entries[name];
+    }
+    await writeSentinel(parent, sentinel);
+    if (Object.keys(sentinel.entries).length === 0) {
+      try {
+        await fs.readdir(parent).then(async (entries) => {
+          if (entries.length === 0) {
+            await fs.rmdir(parent).catch(() => {
+            });
+          }
+        });
+      } catch {
+      }
+    }
+  } finally {
+    await release();
+  }
+}
+function errMsg(err) {
+  return err instanceof Error ? err.message : String(err);
+}
+export {
+  SENTINEL_NAME,
+  acquireLock,
+  errMsg,
+  readSentinel,
+  removeOwnedEntries,
+  writeSentinel
+};
+//# sourceMappingURL=symlink-handoff-sentinel.js.map

package/dist/capabilities/skills/symlink-handoff-sentinel.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/capabilities/skills/symlink-handoff-sentinel.ts"],
+  "sourcesContent": ["/**\n * Sentinel + lock bookkeeping for `symlink-handoff.ts`.\n *\n * Extracted so the main file stays below the 400-line soft cap; keep this\n * file focused on filesystem-level bookkeeping \u2014 no skill semantics.\n */\n\nimport { promises as fs } from 'node:fs';\nimport path from 'node:path';\n\nexport const SENTINEL_NAME = '.managed-by-octoflow';\nconst LOCK_NAME = '.managed-by-octoflow.lock';\nconst STALE_LOCK_MS = 5_000;\n\nexport interface SentinelEntry {\n  target: string;\n  createdAt: string;\n}\n\nexport interface SentinelFile {\n  version: 1;\n  bridge: string;\n  entries: Record<string, SentinelEntry>;\n}\n\nexport async function readSentinel(\n  parent: string,\n  bridgeVersion: string\n): Promise<SentinelFile> {\n  const file = path.join(parent, SENTINEL_NAME);\n  try {\n    const raw = await fs.readFile(file, 'utf8');\n    const parsed = JSON.parse(raw) as Partial<SentinelFile>;\n    if (\n      parsed &&\n      parsed.version === 1 &&\n      parsed.entries &&\n      typeof parsed.entries === 'object'\n    ) {\n      return {\n        version: 1,\n        bridge: parsed.bridge ?? bridgeVersion,\n        entries: parsed.entries,\n      };\n    }\n  } catch {\n    // Missing or corrupt \u2014 start fresh.\n  }\n  return { version: 1, bridge: bridgeVersion, entries: {} };\n}\n\nexport async function writeSentinel(\n  parent: string,\n  sentinel: SentinelFile\n): Promise<void> {\n  const file = path.join(parent, SENTINEL_NAME);\n  if (Object.keys(sentinel.entries).length === 0) {\n    await fs.rm(file, { force: true });\n    return;\n  }\n  const body = JSON.stringify(sentinel, null, 2);\n  await fs.writeFile(file, body, 'utf8');\n}\n\nexport async function acquireLock(\n  parent: string\n): Promise<() => Promise<void>> {\n  const lock = path.join(parent, LOCK_NAME);\n  const start = Date.now();\n  for (;;) {\n    try {\n      const handle = await fs.open(lock, 'wx');\n      await handle.close();\n      return async () => {\n        try {\n          await fs.rm(lock, { force: true });\n        } catch {\n          // lock already removed \u2014 release is idempotent\n        }\n      };\n    } catch (err) {\n      if ((err as NodeJS.ErrnoException).code !== 'EEXIST') {\n        return async () => {};\n      }\n      try {\n        const s = await fs.stat(lock);\n        if (Date.now() - s.mtimeMs > STALE_LOCK_MS) {\n          await fs.rm(lock, { force: true });\n          continue;\n        }\n      } catch {\n        continue;\n      }\n      if (Date.now() - start > STALE_LOCK_MS * 2) {\n        return async () => {};\n      }\n      await new Promise((r) => setTimeout(r, 50));\n    }\n  }\n}\n\nexport async function removeOwnedEntries(\n  parent: string,\n  names: Set<string>,\n  bridgeVersion: string\n): Promise<void> {\n  const release = await acquireLock(parent);\n  try {\n    const sentinel = await readSentinel(parent, bridgeVersion);\n    for (const name of names) {\n      const entry = sentinel.entries[name];\n      if (!entry) continue;\n      const linkPath = path.join(parent, name);\n      try {\n        const stat = await fs.lstat(linkPath);\n        if (stat.isSymbolicLink()) {\n          await fs.unlink(linkPath);\n        }\n      } catch {\n        // missing \u2192 already gone\n      }\n      delete sentinel.entries[name];\n    }\n    await writeSentinel(parent, sentinel);\n    if (Object.keys(sentinel.entries).length === 0) {\n      try {\n        await fs.readdir(parent).then(async (entries) => {\n          if (entries.length === 0) {\n            await fs.rmdir(parent).catch(() => {});\n          }\n        });\n      } catch {\n        // parent dir cleanup is best-effort \u2014 leaving an empty dir is harmless\n      }\n    }\n  } finally {\n    await release();\n  }\n}\n\nexport function errMsg(err: unknown): string {\n  return err instanceof Error ? err.message : String(err);\n}\n"],
+  "mappings": "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",
+  "names": []
+}

package/dist/capabilities/skills/symlink-handoff.d.ts

@@ -0,0 +1,72 @@
+import type { BridgePlugin } from '../../runtime/bridge/plugins.js';
+import type { AgentSkillMetadata } from './types.js';
+/**
+ * — opt-in symlink handoff for CLIs.
+ *
+ * When `agentSkills.symlinkIntoCliPaths === true`, explicitly-registered
+ * skills (those carrying `_source.vendor === null`) are symlinked into each
+ * CLI's natively-scanned directory so the CLI sees them too.
+ *
+ * A sentinel file `.managed-by-octoflow` in the symlink parent directory
+ * records which entries belong to the bridge; `bridge.close()` (via this
+ * plugin's teardown) unlinks only sentinel-listed entries and removes the
+ * sentinel when it becomes empty.
+ *
+ * Non-symlink pre-existing entries are NEVER overwritten. User-placed
+ * symlinks (symlink exists, not sentinel-listed) are left alone; the skill
+ * falls back to prompt-injection via
+ */
+interface SkillSymlinkTarget {
+    /** Relative path under the workspace (e.g. `.claude/skills`). */
+    relDir: string;
+    /** Vendor tag — used to skip skills whose `_source.vendor` would duplicate. */
+    vendor: string;
+}
+/** Default CLI handoff targets per RFC §4.7. */
+export declare const DEFAULT_SYMLINK_TARGETS: readonly SkillSymlinkTarget[];
+export { SENTINEL_NAME } from './symlink-handoff-sentinel.js';
+interface SymlinkHandoffOptions {
+    skills: AgentSkillMetadata[];
+    workspace: string;
+    targets?: readonly SkillSymlinkTarget[];
+    /** Bridge version string stamped into the sentinel. Default: `octoflow@unknown`. */
+    bridgeVersion?: string;
+}
+interface SymlinkHandoffResult {
+    /** Map of parentDir → skill names this process owns. */
+    owned: Map<string, Set<string>>;
+    events: SymlinkEvent[];
+    /** Skills whose handoff failed and now carry `fellBackFromSymlink: true`. */
+    fellBack: Set<string>;
+}
+type SymlinkEvent = {
+    kind: 'created';
+    skill: string;
+    targetPath: string;
+} | {
+    kind: 'refreshed';
+    skill: string;
+    targetPath: string;
+} | {
+    kind: 'skipped';
+    skill: string;
+    targetPath: string;
+    reason: 'user-owned-symlink' | 'non-symlink-target';
+} | {
+    kind: 'failed';
+    skill: string;
+    targetPath: string;
+    error: string;
+};
+/**
+ * Execute the symlink handoff. Pure(ish) — only touches the filesystem
+ * under `workspace`. Returns the per-dir ownership map so cleanup knows
+ * exactly which entries to remove.
+ */
+export declare function runSymlinkHandoff(opts: SymlinkHandoffOptions): Promise<SymlinkHandoffResult>;
+/**
+ * Plugin wrapper: creates symlinks during `setup`, emits events, and tears
+ * them down during `teardown` (fired by `bridge.close()`).
+ */
+export declare function createSkillSymlinkPlugin(opts: SymlinkHandoffOptions): BridgePlugin;
+//# sourceMappingURL=symlink-handoff.d.ts.map

package/dist/capabilities/skills/symlink-handoff.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"symlink-handoff.d.ts","sourceRoot":"","sources":["../../../src/capabilities/skills/symlink-handoff.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,iCAAiC,CAAC;AAUpE,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAErD;;;;;;;;;;;;;;;GAeG;AAEH,UAAU,kBAAkB;IAC1B,iEAAiE;IACjE,MAAM,EAAE,MAAM,CAAC;IACf,+EAA+E;IAC/E,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,gDAAgD;AAChD,eAAO,MAAM,uBAAuB,EAAE,SAAS,kBAAkB,EAKvD,CAAC;AAGX,OAAO,EAAE,aAAa,EAAE,MAAM,+BAA+B,CAAC;AAE9D,UAAU,qBAAqB;IAC7B,MAAM,EAAE,kBAAkB,EAAE,CAAC;IAC7B,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,SAAS,kBAAkB,EAAE,CAAC;IACxC,oFAAoF;IACpF,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,UAAU,oBAAoB;IAC5B,wDAAwD;IACxD,KAAK,EAAE,GAAG,CAAC,MAAM,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC;IAChC,MAAM,EAAE,YAAY,EAAE,CAAC;IACvB,6EAA6E;IAC7E,QAAQ,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;CACvB;AAED,KAAK,YAAY,GACb;IAAE,IAAI,EAAE,SAAS,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,CAAA;CAAE,GACtD;IAAE,IAAI,EAAE,WAAW,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,CAAA;CAAE,GACxD;IACE,IAAI,EAAE,SAAS,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,oBAAoB,GAAG,oBAAoB,CAAC;CACrD,GACD;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC;AAEzE;;;;GAIG;AACH,wBAAsB,iBAAiB,CACrC,IAAI,EAAE,qBAAqB,GAC1B,OAAO,CAAC,oBAAoB,CAAC,CAiE/B;AAqJD;;;GAGG;AACH,wBAAgB,wBAAwB,CACtC,IAAI,EAAE,qBAAqB,GAC1B,YAAY,CAkDd"}

package/dist/capabilities/skills/symlink-handoff.js

@@ -0,0 +1,255 @@
+import { promises as fs } from "node:fs";
+import path from "node:path";
+import { assertNever } from "../../utils/assert-never.js";
+import {
+  acquireLock,
+  errMsg,
+  readSentinel,
+  removeOwnedEntries,
+  writeSentinel
+} from "./symlink-handoff-sentinel.js";
+const DEFAULT_SYMLINK_TARGETS = [
+  { relDir: ".claude/skills", vendor: "claude-code" },
+  { relDir: ".cursor/skills", vendor: "cursor" },
+  { relDir: ".agents/skills", vendor: "codex" },
+  // `.agents/skills` is the cross-vendor location Codex reads
+  { relDir: ".gemini/skills", vendor: "gemini" }
+];
+import { SENTINEL_NAME } from "./symlink-handoff-sentinel.js";
+async function runSymlinkHandoff(opts) {
+  const targets = opts.targets ?? DEFAULT_SYMLINK_TARGETS;
+  const bridgeVersion = opts.bridgeVersion ?? "octoflow@unknown";
+  const owned = /* @__PURE__ */ new Map();
+  const events = [];
+  const fellBack = /* @__PURE__ */ new Set();
+  const eligible = opts.skills.filter((s) => s._source?.vendor == null);
+  if (eligible.length === 0) return { owned, events, fellBack };
+  for (const target of targets) {
+    const parent = path.resolve(opts.workspace, target.relDir);
+    try {
+      await fs.mkdir(parent, { recursive: true });
+    } catch (err) {
+      for (const s of eligible) {
+        fellBack.add(s.name);
+        s.fellBackFromSymlink = true;
+        events.push({
+          kind: "failed",
+          skill: s.name,
+          targetPath: path.join(parent, s.name),
+          error: `mkdir ${parent} failed: ${errMsg(err)}`
+        });
+      }
+      continue;
+    }
+    const release = await acquireLock(parent);
+    try {
+      const sentinel = await readSentinel(parent, bridgeVersion);
+      const ownedHere = /* @__PURE__ */ new Set();
+      let sentinelDirty = false;
+      for (const skill of eligible) {
+        const linkPath = path.join(parent, skill.name);
+        const result = await reconcileSymlink({
+          linkPath,
+          skill,
+          sentinel,
+          bridgeVersion
+        });
+        events.push(result.event);
+        if (result.ownedChange) {
+          ownedHere.add(skill.name);
+          sentinelDirty = true;
+        }
+        if (result.event.kind === "failed" || result.event.kind === "skipped") {
+          if (!result.ownedByThisProcess) {
+            fellBack.add(skill.name);
+            skill.fellBackFromSymlink = true;
+          }
+        }
+      }
+      if (ownedHere.size > 0) owned.set(parent, ownedHere);
+      if (sentinelDirty) {
+        await writeSentinel(parent, sentinel);
+      }
+    } finally {
+      await release();
+    }
+  }
+  return { owned, events, fellBack };
+}
+async function reconcileSymlink(input) {
+  const { linkPath, skill, sentinel, bridgeVersion: _bv } = input;
+  const sentinelEntry = sentinel.entries[skill.name];
+  const targetAbs = skill.baseDir;
+  let stat;
+  try {
+    stat = await fs.lstat(linkPath);
+  } catch (err) {
+    if (err.code === "ENOENT") {
+      try {
+        await fs.symlink(targetAbs, linkPath);
+        sentinel.entries[skill.name] = {
+          target: targetAbs,
+          createdAt: (/* @__PURE__ */ new Date()).toISOString()
+        };
+        return {
+          event: { kind: "created", skill: skill.name, targetPath: linkPath },
+          ownedChange: true,
+          ownedByThisProcess: true
+        };
+      } catch (symlinkErr) {
+        return {
+          event: {
+            kind: "failed",
+            skill: skill.name,
+            targetPath: linkPath,
+            error: errMsg(symlinkErr)
+          },
+          ownedChange: false,
+          ownedByThisProcess: false
+        };
+      }
+    }
+    return {
+      event: {
+        kind: "failed",
+        skill: skill.name,
+        targetPath: linkPath,
+        error: errMsg(err)
+      },
+      ownedChange: false,
+      ownedByThisProcess: false
+    };
+  }
+  if (stat.isSymbolicLink()) {
+    if (sentinelEntry) {
+      let current;
+      try {
+        current = await fs.readlink(linkPath);
+      } catch (err) {
+        return {
+          event: {
+            kind: "failed",
+            skill: skill.name,
+            targetPath: linkPath,
+            error: `readlink failed: ${errMsg(err)}`
+          },
+          ownedChange: false,
+          ownedByThisProcess: false
+        };
+      }
+      if (path.resolve(path.dirname(linkPath), current) === path.resolve(targetAbs)) {
+        sentinel.entries[skill.name] = {
+          target: targetAbs,
+          createdAt: sentinelEntry.createdAt
+        };
+        return {
+          event: { kind: "refreshed", skill: skill.name, targetPath: linkPath },
+          ownedChange: true,
+          ownedByThisProcess: true
+        };
+      }
+      try {
+        await fs.unlink(linkPath);
+        await fs.symlink(targetAbs, linkPath);
+        sentinel.entries[skill.name] = {
+          target: targetAbs,
+          createdAt: (/* @__PURE__ */ new Date()).toISOString()
+        };
+        return {
+          event: { kind: "refreshed", skill: skill.name, targetPath: linkPath },
+          ownedChange: true,
+          ownedByThisProcess: true
+        };
+      } catch (err) {
+        return {
+          event: {
+            kind: "failed",
+            skill: skill.name,
+            targetPath: linkPath,
+            error: errMsg(err)
+          },
+          ownedChange: false,
+          ownedByThisProcess: false
+        };
+      }
+    }
+    return {
+      event: {
+        kind: "skipped",
+        skill: skill.name,
+        targetPath: linkPath,
+        reason: "user-owned-symlink"
+      },
+      ownedChange: false,
+      ownedByThisProcess: false
+    };
+  }
+  return {
+    event: {
+      kind: "skipped",
+      skill: skill.name,
+      targetPath: linkPath,
+      reason: "non-symlink-target"
+    },
+    ownedChange: false,
+    ownedByThisProcess: false
+  };
+}
+function createSkillSymlinkPlugin(opts) {
+  let owned;
+  const bridgeVersion = opts.bridgeVersion ?? "octoflow@unknown";
+  return {
+    name: "bridge-skill-symlink-handoff",
+    version: "0.1.0",
+    setup: async (ctx) => {
+      const result = await runSymlinkHandoff(opts);
+      owned = result.owned;
+      for (const ev of result.events) {
+        switch (ev.kind) {
+          case "created":
+            void ctx.bridge.events.emit("skill:symlink:created", {
+              skill: ev.skill,
+              targetPath: ev.targetPath
+            });
+            break;
+          case "refreshed":
+            void ctx.bridge.events.emit("skill:symlink:refreshed", {
+              skill: ev.skill,
+              targetPath: ev.targetPath
+            });
+            break;
+          case "skipped":
+            void ctx.bridge.events.emit("skill:symlink:skipped", {
+              skill: ev.skill,
+              targetPath: ev.targetPath,
+              reason: ev.reason
+            });
+            break;
+          case "failed":
+            void ctx.bridge.events.emit("skill:symlink:failed", {
+              skill: ev.skill,
+              targetPath: ev.targetPath,
+              error: ev.error
+            });
+            break;
+          default:
+            assertNever(ev, "createSkillSymlinkPlugin event");
+        }
+      }
+    },
+    teardown: async () => {
+      if (!owned) return;
+      for (const [parent, names] of owned.entries()) {
+        await removeOwnedEntries(parent, names, bridgeVersion);
+      }
+      owned = void 0;
+    }
+  };
+}
+export {
+  DEFAULT_SYMLINK_TARGETS,
+  SENTINEL_NAME,
+  createSkillSymlinkPlugin,
+  runSymlinkHandoff
+};
+//# sourceMappingURL=symlink-handoff.js.map

package/dist/capabilities/skills/symlink-handoff.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/capabilities/skills/symlink-handoff.ts"],
+  "sourcesContent": ["import { promises as fs } from 'node:fs';\nimport path from 'node:path';\n\nimport type { Bridge } from '../../runtime/bridge/bridge.js';\nimport type { BridgePlugin } from '../../runtime/bridge/plugins.js';\nimport { assertNever } from '../../utils/assert-never.js';\nimport {\n  acquireLock,\n  errMsg,\n  readSentinel,\n  removeOwnedEntries,\n  type SentinelFile,\n  writeSentinel,\n} from './symlink-handoff-sentinel.js';\nimport type { AgentSkillMetadata } from './types.js';\n\n/**\n * \u2014 opt-in symlink handoff for CLIs.\n *\n * When `agentSkills.symlinkIntoCliPaths === true`, explicitly-registered\n * skills (those carrying `_source.vendor === null`) are symlinked into each\n * CLI's natively-scanned directory so the CLI sees them too.\n *\n * A sentinel file `.managed-by-octoflow` in the symlink parent directory\n * records which entries belong to the bridge; `bridge.close()` (via this\n * plugin's teardown) unlinks only sentinel-listed entries and removes the\n * sentinel when it becomes empty.\n *\n * Non-symlink pre-existing entries are NEVER overwritten. User-placed\n * symlinks (symlink exists, not sentinel-listed) are left alone; the skill\n * falls back to prompt-injection via\n */\n\ninterface SkillSymlinkTarget {\n  /** Relative path under the workspace (e.g. `.claude/skills`). */\n  relDir: string;\n  /** Vendor tag \u2014 used to skip skills whose `_source.vendor` would duplicate. */\n  vendor: string;\n}\n\n/** Default CLI handoff targets per RFC \u00A74.7. */\nexport const DEFAULT_SYMLINK_TARGETS: readonly SkillSymlinkTarget[] = [\n  { relDir: '.claude/skills', vendor: 'claude-code' },\n  { relDir: '.cursor/skills', vendor: 'cursor' },\n  { relDir: '.agents/skills', vendor: 'codex' }, // `.agents/skills` is the cross-vendor location Codex reads\n  { relDir: '.gemini/skills', vendor: 'gemini' },\n] as const;\n\n// Re-export so downstream imports of `SENTINEL_NAME` from this module keep working.\nexport { SENTINEL_NAME } from './symlink-handoff-sentinel.js';\n\ninterface SymlinkHandoffOptions {\n  skills: AgentSkillMetadata[];\n  workspace: string;\n  targets?: readonly SkillSymlinkTarget[];\n  /** Bridge version string stamped into the sentinel. Default: `octoflow@unknown`. */\n  bridgeVersion?: string;\n}\n\ninterface SymlinkHandoffResult {\n  /** Map of parentDir \u2192 skill names this process owns. */\n  owned: Map<string, Set<string>>;\n  events: SymlinkEvent[];\n  /** Skills whose handoff failed and now carry `fellBackFromSymlink: true`. */\n  fellBack: Set<string>;\n}\n\ntype SymlinkEvent =\n  | { kind: 'created'; skill: string; targetPath: string }\n  | { kind: 'refreshed'; skill: string; targetPath: string }\n  | {\n      kind: 'skipped';\n      skill: string;\n      targetPath: string;\n      reason: 'user-owned-symlink' | 'non-symlink-target';\n    }\n  | { kind: 'failed'; skill: string; targetPath: string; error: string };\n\n/**\n * Execute the symlink handoff. Pure(ish) \u2014 only touches the filesystem\n * under `workspace`. Returns the per-dir ownership map so cleanup knows\n * exactly which entries to remove.\n */\nexport async function runSymlinkHandoff(\n  opts: SymlinkHandoffOptions\n): Promise<SymlinkHandoffResult> {\n  const targets = opts.targets ?? DEFAULT_SYMLINK_TARGETS;\n  const bridgeVersion = opts.bridgeVersion ?? 'octoflow@unknown';\n  const owned = new Map<string, Set<string>>();\n  const events: SymlinkEvent[] = [];\n  const fellBack = new Set<string>();\n\n  const eligible = opts.skills.filter((s) => s._source?.vendor == null);\n  if (eligible.length === 0) return { owned, events, fellBack };\n\n  for (const target of targets) {\n    const parent = path.resolve(opts.workspace, target.relDir);\n    try {\n      await fs.mkdir(parent, { recursive: true });\n    } catch (err) {\n      for (const s of eligible) {\n        fellBack.add(s.name);\n        s.fellBackFromSymlink = true;\n        events.push({\n          kind: 'failed',\n          skill: s.name,\n          targetPath: path.join(parent, s.name),\n          error: `mkdir ${parent} failed: ${errMsg(err)}`,\n        });\n      }\n      continue;\n    }\n\n    const release = await acquireLock(parent);\n    try {\n      const sentinel = await readSentinel(parent, bridgeVersion);\n      const ownedHere = new Set<string>();\n      let sentinelDirty = false;\n\n      for (const skill of eligible) {\n        const linkPath = path.join(parent, skill.name);\n        const result = await reconcileSymlink({\n          linkPath,\n          skill,\n          sentinel,\n          bridgeVersion,\n        });\n        events.push(result.event);\n        if (result.ownedChange) {\n          ownedHere.add(skill.name);\n          sentinelDirty = true;\n        }\n        if (result.event.kind === 'failed' || result.event.kind === 'skipped') {\n          if (!result.ownedByThisProcess) {\n            fellBack.add(skill.name);\n            skill.fellBackFromSymlink = true;\n          }\n        }\n      }\n\n      if (ownedHere.size > 0) owned.set(parent, ownedHere);\n      if (sentinelDirty) {\n        await writeSentinel(parent, sentinel);\n      }\n    } finally {\n      await release();\n    }\n  }\n\n  return { owned, events, fellBack };\n}\n\ninterface ReconcileInput {\n  linkPath: string;\n  skill: AgentSkillMetadata;\n  sentinel: SentinelFile;\n  bridgeVersion: string;\n}\n\ninterface ReconcileResult {\n  event: SymlinkEvent;\n  /** True when this call newly owns the entry in the sentinel. */\n  ownedChange: boolean;\n  /** True when this entry is owned by the current process (create/refresh hit). */\n  ownedByThisProcess: boolean;\n}\n\nasync function reconcileSymlink(\n  input: ReconcileInput\n): Promise<ReconcileResult> {\n  const { linkPath, skill, sentinel, bridgeVersion: _bv } = input;\n  const sentinelEntry = sentinel.entries[skill.name];\n  const targetAbs = skill.baseDir;\n\n  let stat;\n  try {\n    stat = await fs.lstat(linkPath);\n  } catch (err) {\n    if ((err as NodeJS.ErrnoException).code === 'ENOENT') {\n      try {\n        await fs.symlink(targetAbs, linkPath);\n        sentinel.entries[skill.name] = {\n          target: targetAbs,\n          createdAt: new Date().toISOString(),\n        };\n        return {\n          event: { kind: 'created', skill: skill.name, targetPath: linkPath },\n          ownedChange: true,\n          ownedByThisProcess: true,\n        };\n      } catch (symlinkErr) {\n        return {\n          event: {\n            kind: 'failed',\n            skill: skill.name,\n            targetPath: linkPath,\n            error: errMsg(symlinkErr),\n          },\n          ownedChange: false,\n          ownedByThisProcess: false,\n        };\n      }\n    }\n    return {\n      event: {\n        kind: 'failed',\n        skill: skill.name,\n        targetPath: linkPath,\n        error: errMsg(err),\n      },\n      ownedChange: false,\n      ownedByThisProcess: false,\n    };\n  }\n\n  if (stat.isSymbolicLink()) {\n    if (sentinelEntry) {\n      // States 2a / 2b \u2014 sentinel-listed symlink. Resolve and refresh if\n      // the current target drifted from baseDir.\n      let current: string;\n      try {\n        current = await fs.readlink(linkPath);\n      } catch (err) {\n        return {\n          event: {\n            kind: 'failed',\n            skill: skill.name,\n            targetPath: linkPath,\n            error: `readlink failed: ${errMsg(err)}`,\n          },\n          ownedChange: false,\n          ownedByThisProcess: false,\n        };\n      }\n      if (\n        path.resolve(path.dirname(linkPath), current) ===\n        path.resolve(targetAbs)\n      ) {\n        sentinel.entries[skill.name] = {\n          target: targetAbs,\n          createdAt: sentinelEntry.createdAt,\n        };\n        return {\n          event: { kind: 'refreshed', skill: skill.name, targetPath: linkPath },\n          ownedChange: true,\n          ownedByThisProcess: true,\n        };\n      }\n      try {\n        await fs.unlink(linkPath);\n        await fs.symlink(targetAbs, linkPath);\n        sentinel.entries[skill.name] = {\n          target: targetAbs,\n          createdAt: new Date().toISOString(),\n        };\n        return {\n          event: { kind: 'refreshed', skill: skill.name, targetPath: linkPath },\n          ownedChange: true,\n          ownedByThisProcess: true,\n        };\n      } catch (err) {\n        return {\n          event: {\n            kind: 'failed',\n            skill: skill.name,\n            targetPath: linkPath,\n            error: errMsg(err),\n          },\n          ownedChange: false,\n          ownedByThisProcess: false,\n        };\n      }\n    }\n    // State 3 \u2014 user-owned symlink; do not touch.\n    return {\n      event: {\n        kind: 'skipped',\n        skill: skill.name,\n        targetPath: linkPath,\n        reason: 'user-owned-symlink',\n      },\n      ownedChange: false,\n      ownedByThisProcess: false,\n    };\n  }\n\n  // State 4 \u2014 regular file or directory; never overwrite.\n  return {\n    event: {\n      kind: 'skipped',\n      skill: skill.name,\n      targetPath: linkPath,\n      reason: 'non-symlink-target',\n    },\n    ownedChange: false,\n    ownedByThisProcess: false,\n  };\n}\n\n/**\n * Plugin wrapper: creates symlinks during `setup`, emits events, and tears\n * them down during `teardown` (fired by `bridge.close()`).\n */\nexport function createSkillSymlinkPlugin(\n  opts: SymlinkHandoffOptions\n): BridgePlugin {\n  let owned: Map<string, Set<string>> | undefined;\n  const bridgeVersion = opts.bridgeVersion ?? 'octoflow@unknown';\n  return {\n    name: 'bridge-skill-symlink-handoff',\n    version: '0.1.0',\n    setup: async (ctx: { bridge: Bridge }) => {\n      const result = await runSymlinkHandoff(opts);\n      owned = result.owned;\n      for (const ev of result.events) {\n        switch (ev.kind) {\n          case 'created':\n            void ctx.bridge.events.emit('skill:symlink:created', {\n              skill: ev.skill,\n              targetPath: ev.targetPath,\n            });\n            break;\n          case 'refreshed':\n            void ctx.bridge.events.emit('skill:symlink:refreshed', {\n              skill: ev.skill,\n              targetPath: ev.targetPath,\n            });\n            break;\n          case 'skipped':\n            void ctx.bridge.events.emit('skill:symlink:skipped', {\n              skill: ev.skill,\n              targetPath: ev.targetPath,\n              reason: ev.reason,\n            });\n            break;\n          case 'failed':\n            void ctx.bridge.events.emit('skill:symlink:failed', {\n              skill: ev.skill,\n              targetPath: ev.targetPath,\n              error: ev.error,\n            });\n            break;\n          default:\n            assertNever(ev, 'createSkillSymlinkPlugin event');\n        }\n      }\n    },\n    teardown: async () => {\n      if (!owned) return;\n      for (const [parent, names] of owned.entries()) {\n        await removeOwnedEntries(parent, names, bridgeVersion);\n      }\n      owned = undefined;\n    },\n  };\n}\n"],
+  "mappings": "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",
+  "names": []
+}

package/dist/capabilities/skills/types.d.ts

@@ -0,0 +1,2 @@
+export type { AgentSkillMetadata, AgentSkillRecord, FrontmatterParser, FrontmatterParseResult, FrontmatterValue, SkillMetadata, SkillRecord, SkillScope, SkillSourceTag, SkillToolDefinition, } from 'octoflow-skill-runner';
+//# sourceMappingURL=types.d.ts.map

package/dist/capabilities/skills/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/capabilities/skills/types.ts"],"names":[],"mappings":"AAAA,YAAY,EACV,kBAAkB,EAClB,gBAAgB,EAChB,iBAAiB,EACjB,sBAAsB,EACtB,gBAAgB,EAChB,aAAa,EACb,WAAW,EACX,UAAU,EACV,cAAc,EACd,mBAAmB,GACpB,MAAM,uBAAuB,CAAC"}

package/dist/capabilities/skills/types.js

@@ -0,0 +1 @@
+//# sourceMappingURL=types.js.map

package/dist/capabilities/skills/types.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": [],
+  "sourcesContent": [],
+  "mappings": "",
+  "names": []
+}

package/dist/capabilities/skills/validator.d.ts

@@ -0,0 +1,2 @@
+export { classifyFrontmatterField, partitionIssues, type SkillValidationIssue, validateSkillBody, validateSkillDir, validateSkillMeta, } from 'octoflow-skill-runner';
+//# sourceMappingURL=validator.d.ts.map

package/dist/capabilities/skills/validator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validator.d.ts","sourceRoot":"","sources":["../../../src/capabilities/skills/validator.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,wBAAwB,EACxB,eAAe,EACf,KAAK,oBAAoB,EACzB,iBAAiB,EACjB,gBAAgB,EAChB,iBAAiB,GAClB,MAAM,uBAAuB,CAAC"}

package/dist/capabilities/skills/validator.js

@@ -0,0 +1,15 @@
+import {
+  classifyFrontmatterField,
+  partitionIssues,
+  validateSkillBody,
+  validateSkillDir,
+  validateSkillMeta
+} from "octoflow-skill-runner";
+export {
+  classifyFrontmatterField,
+  partitionIssues,
+  validateSkillBody,
+  validateSkillDir,
+  validateSkillMeta
+};
+//# sourceMappingURL=validator.js.map

package/dist/capabilities/skills/validator.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/capabilities/skills/validator.ts"],
+  "sourcesContent": ["export {\n  classifyFrontmatterField,\n  partitionIssues,\n  type SkillValidationIssue,\n  validateSkillBody,\n  validateSkillDir,\n  validateSkillMeta,\n} from 'octoflow-skill-runner';\n"],
+  "mappings": "AAAA;AAAA,EACE;AAAA,EACA;AAAA,EAEA;AAAA,EACA;AAAA,EACA;AAAA,OACK;",
+  "names": []
+}

package/dist/capabilities/skills/vendor-backend.d.ts

@@ -0,0 +1,9 @@
+import type { BackendName } from '../../domain/core-client.js';
+type SkillVendor = 'claude-code' | 'cursor' | 'codex' | 'gemini' | null;
+/**
+ * When non-null, the skill catalog and local-context scanner suppress
+ * entries whose `_source.vendor` equals this vendor to avoid double-injection.
+ */
+export declare function vendorForBackend(backend: BackendName | undefined): SkillVendor;
+export {};
+//# sourceMappingURL=vendor-backend.d.ts.map

package/dist/capabilities/skills/vendor-backend.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"vendor-backend.d.ts","sourceRoot":"","sources":["../../../src/capabilities/skills/vendor-backend.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,6BAA6B,CAAC;AAE/D,KAAK,WAAW,GAAG,aAAa,GAAG,QAAQ,GAAG,OAAO,GAAG,QAAQ,GAAG,IAAI,CAAC;AAExE;;;GAGG;AACH,wBAAgB,gBAAgB,CAC9B,OAAO,EAAE,WAAW,GAAG,SAAS,GAC/B,WAAW,CAKb"}

package/dist/capabilities/skills/vendor-backend.js

@@ -0,0 +1,10 @@
+function vendorForBackend(backend) {
+  if (backend === "claude-code-cli") return "claude-code";
+  if (backend === "cursor-cli") return "cursor";
+  if (backend === "codex-cli") return "codex";
+  return null;
+}
+export {
+  vendorForBackend
+};
+//# sourceMappingURL=vendor-backend.js.map

package/dist/capabilities/skills/vendor-backend.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/capabilities/skills/vendor-backend.ts"],
+  "sourcesContent": ["import type { BackendName } from '../../domain/core-client.js';\n\ntype SkillVendor = 'claude-code' | 'cursor' | 'codex' | 'gemini' | null;\n\n/**\n * When non-null, the skill catalog and local-context scanner suppress\n * entries whose `_source.vendor` equals this vendor to avoid double-injection.\n */\nexport function vendorForBackend(\n  backend: BackendName | undefined\n): SkillVendor {\n  if (backend === 'claude-code-cli') return 'claude-code';\n  if (backend === 'cursor-cli') return 'cursor';\n  if (backend === 'codex-cli') return 'codex';\n  return null;\n}\n"],
+  "mappings": "AAQO,SAAS,iBACd,SACa;AACb,MAAI,YAAY,kBAAmB,QAAO;AAC1C,MAAI,YAAY,aAAc,QAAO;AACrC,MAAI,YAAY,YAAa,QAAO;AACpC,SAAO;AACT;",
+  "names": []
+}

package/dist/capabilities/tool-call-parser.d.ts

@@ -0,0 +1,8 @@
+interface ParsedToolCall {
+    id: string;
+    name: string;
+    args: Record<string, unknown>;
+}
+export declare function parseToolCallsFromText(text: string): ParsedToolCall[] | null;
+export {};
+//# sourceMappingURL=tool-call-parser.d.ts.map

package/dist/capabilities/tool-call-parser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-call-parser.d.ts","sourceRoot":"","sources":["../../src/capabilities/tool-call-parser.ts"],"names":[],"mappings":"AAAA,UAAU,cAAc;IACtB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAC/B;AA4ED,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,MAAM,GAAG,cAAc,EAAE,GAAG,IAAI,CAoC5E"}