@ken-jo/agent-connector 0.3.1 → 0.4.1

package/dist/{amp-YGV66GJT.js → amp-4U33CU7E.js}

@@ -4,13 +4,15 @@ import {
 } from "./chunk-DBQMX75U.js";
 import {
   BaseAdapter
-} from "./chunk-PD4VFEBY.js";
-import "./chunk-7L6ITC4T.js";
+} from "./chunk-CPLK7GTE.js";
+import {
+  renderSkillMd
+} from "./chunk-7L6ITC4T.js";
 import {
   buildServeWrapperCommand,
   isHomeBinHookCommand,
   shouldWrapForTelemetry
-} from "./chunk-MEH7GC7R.js";
+} from "./chunk-I5MLE6S7.js";
 import "./chunk-N6HH7K6P.js";
 import "./chunk-TRQKHP7D.js";
 
@@ -41,7 +43,11 @@ var AmpAdapter = class extends BaseAdapter {
     canModifyOutput: false,
     canInjectSessionContext: false,
     // Amp registers stdio and Streamable HTTP MCP servers.
-    transports: ["stdio", "http"]
+    transports: ["stdio", "http"],
+    // Skills: Amp reads SKILL.md from ~/.config/agents/skills/<name>/SKILL.md
+    // (user) and <projectDir>/.agents/skills/<name>/SKILL.md (project) — a root
+    // OUTSIDE the config dir, so the skillDir() helper resolves it explicitly.
+    supportsSkills: true
   };
   // ── Detection ────────────────────────────────────────────────────────────
   detectInstalled(projectDir) {
@@ -150,6 +156,76 @@ var AmpAdapter = class extends BaseAdapter {
   rewrite(value) {
     return rewriteEnvRefs(value, ampEnvToken);
   }
+  // ── Skills surface ───────────────────────────────────────────────────────
+  // CONTENT-ONLY: pure native-file writers under the skill root. No runtime
+  // dispatch, no home-bin pointer, no telemetry wrap. Idempotent (byte-identical
+  // → skip) via writeContentFile and reversible via removeContentFile. Honors
+  // platforms["amp"].skills === false to skip.
+  //
+  // QUIRK: the skill root is NOT under getConfigDir (~/.config/amp). Amp reads
+  // SKILL.md from the sibling cross-agent `agents` tree:
+  //   user scope    → ~/.config/agents/skills/<name>/SKILL.md
+  //   project scope → <projectDir>/.agents/skills/<name>/SKILL.md
+  // so skillDir() resolves it explicitly rather than reusing getConfigDir.
+  /** Skill root: user `~/.config/agents/skills`, project `<projectDir>/.agents/skills`. */
+  skillsDir(ctx) {
+    return ctx.scope === "project" ? join(ctx.projectDir, ".agents", "skills") : join(homedir(), ".config", "agents", "skills");
+  }
+  /** Native skill dir: <skillRoot>/<name>. */
+  skillDir(ctx, name) {
+    return join(this.skillsDir(ctx), name);
+  }
+  installSkills(ctx) {
+    const { connector } = ctx;
+    if (connector.platforms[HOST]?.skills === false) {
+      return [{ platform: this.id, action: "skip", detail: "skills disabled for amp" }];
+    }
+    if (connector.skills.length === 0) {
+      return [{ platform: this.id, action: "skip", detail: "connector declares no skills" }];
+    }
+    const changes = [];
+    for (const skill of connector.skills) {
+      const dir = this.skillDir(ctx, skill.name);
+      changes.push(
+        this.writeContentFile(join(dir, "SKILL.md"), this.renderSkill(skill), ctx.dryRun)
+      );
+      for (const [rel, contents] of Object.entries(skill.resources ?? {})) {
+        const target = this.resolveWithin(dir, rel);
+        if (target === null) {
+          changes.push({
+            platform: this.id,
+            action: "warn",
+            detail: `skill resource "${rel}" escapes the skill dir; skipped`
+          });
+          continue;
+        }
+        changes.push(this.writeContentFile(target, contents, ctx.dryRun));
+      }
+    }
+    return changes;
+  }
+  uninstallSkills(ctx) {
+    const { connector } = ctx;
+    if (connector.skills.length === 0) {
+      return [{ platform: this.id, action: "skip", detail: "connector declares no skills" }];
+    }
+    const changes = [];
+    for (const skill of connector.skills) {
+      const dir = this.skillDir(ctx, skill.name);
+      changes.push(this.removeContentFile(join(dir, "SKILL.md"), ctx.dryRun));
+      for (const rel of Object.keys(skill.resources ?? {})) {
+        const target = this.resolveWithin(dir, rel);
+        if (target === null) continue;
+        changes.push(this.removeContentFile(target, ctx.dryRun));
+      }
+      changes.push(this.removeDirIfEmpty(dir, ctx.dryRun));
+    }
+    return changes;
+  }
+  /** Render a skill's SKILL.md (delegates to the shared renderer). */
+  renderSkill(skill) {
+    return renderSkillMd(skill);
+  }
   // ── Hooks (unavailable — Amp is mcp-only) ────────────────────────────────
   installHooks(_ctx) {
     return [
@@ -221,4 +297,4 @@ export {
   adapter,
   amp_default as default
 };
-//# sourceMappingURL=amp-YGV66GJT.js.map
+//# sourceMappingURL=amp-4U33CU7E.js.map

package/dist/amp-4U33CU7E.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/adapters/amp/index.ts"],"sourcesContent":["/**\n * adapters/amp — Amp (Sourcegraph / AmpCode) platform adapter for agent-connector.\n *\n * Amp is an **mcp-only** host: it exposes no lifecycle hook system, so MCP is the\n * only extensibility surface. This adapter installs the MCP server entry and\n * reports hooks as unavailable — the same shape validated by the Warp adapter.\n *\n * MCP config (report §2 / §5.3):\n *   - user scope    → ~/.config/amp/settings.json\n *   - project scope → <projectDir>/.amp/settings.json\n *   Both are JSONC (we write plain JSON, which is valid JSONC). The settings file\n *   is SHARED with the rest of Amp's configuration, so we MERGE our entry into\n *   the existing object and never clobber unrelated keys.\n *\n * QUIRK 1 — dotted top-level key: Amp does NOT use a nested `mcpServers` object.\n * The MCP registry is a single FLAT settings key literally named\n * `\"amp.mcpServers\"`, whose value is an object of `{ id: { command, args, env } }`.\n * We therefore set `settings[\"amp.mcpServers\"][connectorId] = entry`. Because the\n * base JSON helpers index `config[rootKey][serverId]`, passing the dotted string\n * as the root key writes exactly that flat key while preserving every sibling\n * setting (true merge).\n *\n * QUIRK 2 — native interpolation: Amp expands `${VAR_NAME}` in stdio entries at\n * runtime, so we KEEP env/header/url refs native by rewriting the portable\n * `${env:VAR}` syntax to Amp's `${VAR}` token rather than resolving to literals\n * (secrets stay out of the settings file).\n *\n * Skills surface: Amp reads SKILL.md files (dir-per-skill, same shape as\n * claude-code) from a skill root that is NOT under the config dir\n * (`~/.config/amp`):\n *   - user scope    → ~/.config/agents/skills/<name>/SKILL.md  (the sibling\n *     cross-agent `agents` dir — `~/.config/amp/skills/` is also documented-native,\n *     but the `agents` root is the cross-agent standard we standardize on)\n *   - project scope → <projectDir>/.agents/skills/<name>/SKILL.md\n * Because that root differs from getConfigDir, skills use a dedicated skillDir()\n * helper rather than reusing getConfigDir.\n */\n\nimport { existsSync } from \"node:fs\";\nimport { homedir } from \"node:os\";\nimport { join } from \"node:path\";\n\nimport { BaseAdapter } from \"../base.js\";\nimport type { Adapter, InstallContext } from \"../spi.js\";\nimport type {\n  ChangeRecord,\n  DetectedPlatform,\n  HealthCheck,\n  HookParadigm,\n  PlatformCapabilities,\n  PlatformId,\n  ServerDef,\n  SkillDef,\n  Transport,\n} from \"../../core/types.js\";\nimport { rewriteEnvRefs } from \"../../core/interpolate.js\";\nimport {\n  buildServeWrapperCommand,\n  isHomeBinHookCommand,\n  shouldWrapForTelemetry,\n} from \"../../core/spawn.js\";\nimport { renderSkillMd } from \"../claude-code/render.js\";\n\nconst HOST: PlatformId = \"amp\";\n/**\n * QUIRK: a single FLAT, dotted settings key — NOT a nested object. The base\n * JSON helpers treat this as `config[\"amp.mcpServers\"][serverId]`.\n */\nconst MCP_ROOT_KEY = \"amp.mcpServers\";\n\n/** Native MCP server entry shapes Amp accepts under `amp.mcpServers`. */\ninterface AmpStdioServer {\n  command: string;\n  args?: string[];\n  env?: Record<string, string>;\n}\ninterface AmpHttpServer {\n  url: string;\n  headers?: Record<string, string>;\n}\n\nexport class AmpAdapter extends BaseAdapter implements Adapter {\n  readonly id: PlatformId = HOST;\n  readonly name = \"Amp\";\n  readonly paradigm: HookParadigm = \"mcp-only\";\n\n  readonly capabilities: PlatformCapabilities = {\n    // Memory surface: AGENTS.md-first managed block via the BaseAdapter default\n    // (memoryTargets: project <projectDir>/AGENTS.md; user scope where documented).\n    supportsMemory: true,\n    // Amp has no lifecycle hook system — every hook capability is false.\n    preToolUse: false,\n    postToolUse: false,\n    preCompact: false,\n    sessionStart: false,\n    sessionEnd: false,\n    userPromptSubmit: false,\n    stop: false,\n    notification: false,\n    canModifyArgs: false,\n    canModifyOutput: false,\n    canInjectSessionContext: false,\n    // Amp registers stdio and Streamable HTTP MCP servers.\n    transports: [\"stdio\", \"http\"],\n    // Skills: Amp reads SKILL.md from ~/.config/agents/skills/<name>/SKILL.md\n    // (user) and <projectDir>/.agents/skills/<name>/SKILL.md (project) — a root\n    // OUTSIDE the config dir, so the skillDir() helper resolves it explicitly.\n    supportsSkills: true,\n  };\n\n  // ── Detection ────────────────────────────────────────────────────────────\n\n  detectInstalled(projectDir: string): DetectedPlatform {\n    const userDir = join(homedir(), \".config\", \"amp\");\n    const userSettings = join(userDir, \"settings.json\");\n    const projectDirAmp = join(projectDir, \".amp\");\n    const projectSettings = join(projectDirAmp, \"settings.json\");\n\n    const userInstalled = existsSync(userDir) || existsSync(userSettings);\n    const projectInstalled = existsSync(projectDirAmp) || existsSync(projectSettings);\n    const installed = userInstalled || projectInstalled;\n    const scope = projectInstalled && !userInstalled ? \"project\" : \"user\";\n    const configPath = scope === \"project\" ? projectSettings : userSettings;\n\n    return {\n      id: this.id,\n      name: this.name,\n      installed,\n      paradigm: this.paradigm,\n      capabilities: this.capabilities,\n      configPath,\n      scope,\n      reason: installed\n        ? `found Amp config (${scope}) at ${configPath}`\n        : `no Amp config at ${userSettings} or ${projectSettings}`,\n      confidence: installed ? \"high\" : \"low\",\n    };\n  }\n\n  // ── Native paths ─────────────────────────────────────────────────────────\n\n  getConfigDir(ctx: InstallContext): string {\n    return ctx.scope === \"project\"\n      ? join(ctx.projectDir, \".amp\")\n      : join(homedir(), \".config\", \"amp\");\n  }\n\n  getServerConfigPath(ctx: InstallContext): string {\n    return join(this.getConfigDir(ctx), \"settings.json\");\n  }\n\n  /**\n   * Amp has no hook file — hooks are not a thing here. The hook \"config path\" is\n   * the same settings.json so the generic doctor/backup behave sensibly.\n   */\n  getHookConfigPath(ctx: InstallContext): string {\n    return this.getServerConfigPath(ctx);\n  }\n\n  // ── MCP server install / uninstall ───────────────────────────────────────\n\n  installServer(ctx: InstallContext): ChangeRecord[] {\n    const { connector } = ctx;\n    const override = connector.platforms[HOST]?.server;\n    if (!connector.server || override === false) {\n      return [\n        {\n          platform: this.id,\n          action: \"skip\",\n          detail: connector.server\n            ? \"server registration disabled for amp\"\n            : \"connector declares no MCP server\",\n        },\n      ];\n    }\n\n    // Shallow-merge any per-platform server override into the base ServerDef.\n    const server: ServerDef =\n      override && typeof override === \"object\"\n        ? { ...connector.server, ...override }\n        : connector.server;\n\n    const serverPath = this.getServerConfigPath(ctx);\n    const entry = this.renderServerEntry(ctx, server);\n\n    // Upsert into the flat \"amp.mcpServers\" key, merging into existing settings.\n    return [\n      this.upsertServerInJson(serverPath, MCP_ROOT_KEY, connector.id, entry, ctx.dryRun),\n    ];\n  }\n\n  uninstallServer(ctx: InstallContext): ChangeRecord[] {\n    const serverPath = this.getServerConfigPath(ctx);\n    return [\n      this.removeServerFromJson(serverPath, MCP_ROOT_KEY, ctx.connector.id, ctx.dryRun),\n    ];\n  }\n\n  /** Render a normalized ServerDef into Amp's native `amp.mcpServers` entry. */\n  private renderServerEntry(\n    ctx: InstallContext,\n    server: ServerDef,\n  ): AmpStdioServer | AmpHttpServer {\n    const transport: Transport = server.transport;\n\n    if (transport === \"stdio\") {\n      let command = server.command ?? \"\";\n      let args = [...(server.args ?? [])];\n\n      // Transparent telemetry wrapping: route the real command through\n      // `<homeBin> serve --connector <id> -- <command> <args...>`.\n      if (shouldWrapForTelemetry(server, ctx.connector.telemetry)) {\n        const wrapped = buildServeWrapperCommand(\n          ctx.homeBinPath,\n          ctx.connector.id,\n          command,\n          args,\n          ctx.scope,\n          this.id,\n        );\n        command = wrapped.command;\n        args = wrapped.args;\n      }\n\n      // Amp expands ${VAR_NAME} natively, so keep refs native (no literals).\n      const entry: AmpStdioServer = { command: this.rewrite(command) };\n      if (args.length > 0) entry.args = args.map((a) => this.rewrite(a));\n      const env = this.renderEnv(server.env);\n      if (env) entry.env = env;\n      return entry;\n    }\n\n    // http (and any other remote transport we surface) — Amp registers a URL.\n    const entry: AmpHttpServer = { url: this.rewrite(server.url ?? \"\") };\n    const headers = this.renderEnv(server.headers);\n    if (headers) entry.headers = headers;\n    return entry;\n  }\n\n  /**\n   * Render env/header values. Amp supports native `${VAR_NAME}` interpolation,\n   * so translate `${env:VAR}` refs to that native token rather than baking\n   * secrets into the file. Literals pass through unchanged.\n   */\n  private renderEnv(\n    env: Record<string, string> | undefined,\n  ): Record<string, string> | undefined {\n    if (!env || Object.keys(env).length === 0) return undefined;\n    const out: Record<string, string> = {};\n    for (const [k, v] of Object.entries(env)) out[k] = this.rewrite(v);\n    return out;\n  }\n\n  /** Translate `${env:VAR(:-default)}` to Amp's native `${VAR}` token. */\n  private rewrite(value: string): string {\n    return rewriteEnvRefs(value, ampEnvToken);\n  }\n\n  // ── Skills surface ───────────────────────────────────────────────────────\n  // CONTENT-ONLY: pure native-file writers under the skill root. No runtime\n  // dispatch, no home-bin pointer, no telemetry wrap. Idempotent (byte-identical\n  // → skip) via writeContentFile and reversible via removeContentFile. Honors\n  // platforms[\"amp\"].skills === false to skip.\n  //\n  // QUIRK: the skill root is NOT under getConfigDir (~/.config/amp). Amp reads\n  // SKILL.md from the sibling cross-agent `agents` tree:\n  //   user scope    → ~/.config/agents/skills/<name>/SKILL.md\n  //   project scope → <projectDir>/.agents/skills/<name>/SKILL.md\n  // so skillDir() resolves it explicitly rather than reusing getConfigDir.\n\n  /** Skill root: user `~/.config/agents/skills`, project `<projectDir>/.agents/skills`. */\n  private skillsDir(ctx: InstallContext): string {\n    return ctx.scope === \"project\"\n      ? join(ctx.projectDir, \".agents\", \"skills\")\n      : join(homedir(), \".config\", \"agents\", \"skills\");\n  }\n\n  /** Native skill dir: <skillRoot>/<name>. */\n  private skillDir(ctx: InstallContext, name: string): string {\n    return join(this.skillsDir(ctx), name);\n  }\n\n  override installSkills(ctx: InstallContext): ChangeRecord[] {\n    const { connector } = ctx;\n    if (connector.platforms[HOST]?.skills === false) {\n      return [{ platform: this.id, action: \"skip\", detail: \"skills disabled for amp\" }];\n    }\n    if (connector.skills.length === 0) {\n      return [{ platform: this.id, action: \"skip\", detail: \"connector declares no skills\" }];\n    }\n    const changes: ChangeRecord[] = [];\n    for (const skill of connector.skills) {\n      const dir = this.skillDir(ctx, skill.name);\n      changes.push(\n        this.writeContentFile(join(dir, \"SKILL.md\"), this.renderSkill(skill), ctx.dryRun),\n      );\n      // Bundle any resource files beside SKILL.md (relative path → contents).\n      // Defense-in-depth: skip+warn on any key that escapes the skill dir\n      // (config-time validation already rejects these, but never trust input).\n      for (const [rel, contents] of Object.entries(skill.resources ?? {})) {\n        const target = this.resolveWithin(dir, rel);\n        if (target === null) {\n          changes.push({\n            platform: this.id,\n            action: \"warn\",\n            detail: `skill resource \"${rel}\" escapes the skill dir; skipped`,\n          });\n          continue;\n        }\n        changes.push(this.writeContentFile(target, contents, ctx.dryRun));\n      }\n    }\n    return changes;\n  }\n\n  override uninstallSkills(ctx: InstallContext): ChangeRecord[] {\n    const { connector } = ctx;\n    if (connector.skills.length === 0) {\n      return [{ platform: this.id, action: \"skip\", detail: \"connector declares no skills\" }];\n    }\n    const changes: ChangeRecord[] = [];\n    for (const skill of connector.skills) {\n      const dir = this.skillDir(ctx, skill.name);\n      // Remove only the files we wrote (SKILL.md + declared resources), then the\n      // skill dir itself when we own its full contents.\n      changes.push(this.removeContentFile(join(dir, \"SKILL.md\"), ctx.dryRun));\n      for (const rel of Object.keys(skill.resources ?? {})) {\n        const target = this.resolveWithin(dir, rel);\n        if (target === null) continue; // never delete outside the skill dir\n        changes.push(this.removeContentFile(target, ctx.dryRun));\n      }\n      // Only remove the skill dir when WE own its full contents — never rm -rf a\n      // dir that still holds user-added / sibling-tool / shared files.\n      changes.push(this.removeDirIfEmpty(dir, ctx.dryRun));\n    }\n    return changes;\n  }\n\n  /** Render a skill's SKILL.md (delegates to the shared renderer). */\n  private renderSkill(skill: SkillDef): string {\n    return renderSkillMd(skill);\n  }\n\n  // ── Hooks (unavailable — Amp is mcp-only) ────────────────────────────────\n\n  installHooks(_ctx: InstallContext): ChangeRecord[] {\n    return [\n      {\n        platform: this.id,\n        action: \"skip\",\n        detail: \"hooks unavailable (Amp is mcp-only)\",\n      },\n    ];\n  }\n\n  uninstallHooks(_ctx: InstallContext): ChangeRecord[] {\n    return [\n      {\n        platform: this.id,\n        action: \"skip\",\n        detail: \"hooks unavailable (Amp is mcp-only)\",\n      },\n    ];\n  }\n\n  /**\n   * True when a hook command references our home binary AND this connector id\n   * (anchored so a shared-prefix id can't collide — see isHomeBinHookCommand).\n   * Amp installs no hooks, but this guard keeps any future shared-file edit from\n   * removing another connector's entries.\n   */\n  private isOurCommand(command: string | undefined, ctx: InstallContext): boolean {\n    return isHomeBinHookCommand(command, ctx.homeBinPath, ctx.connector.id);\n  }\n\n  // ── Diagnostics ──────────────────────────────────────────────────────────\n\n  override getHealthChecks(ctx: InstallContext): readonly HealthCheck[] {\n    const settingsPath = this.getServerConfigPath(ctx);\n    const connectorId = ctx.connector.id;\n    return [\n      {\n        name: `${this.name}: settings.json present`,\n        check: () =>\n          existsSync(settingsPath)\n            ? { status: \"OK\", detail: settingsPath }\n            : { status: \"FAIL\", detail: `not found: ${settingsPath}` },\n      },\n      {\n        name: `${this.name}: server entry registered`,\n        check: () => {\n          // Only assert what the connector declares: a server-less connector\n          // never writes a server entry, so its absence is healthy.\n          if (!ctx.connector.server) {\n            return { status: \"OK\", detail: \"no MCP server declared\" };\n          }\n          const cfg = this.readJson<{ [k: string]: Record<string, unknown> }>(settingsPath);\n          const bucket = cfg?.[MCP_ROOT_KEY];\n          if (!cfg || !bucket) {\n            return { status: \"FAIL\", detail: `no \"${MCP_ROOT_KEY}\" in ${settingsPath}` };\n          }\n          return connectorId in bucket\n            ? { status: \"OK\", detail: `\"${MCP_ROOT_KEY}\".${connectorId} present` }\n            : {\n                status: \"FAIL\",\n                detail: `no \"${MCP_ROOT_KEY}\".${connectorId} in ${settingsPath}`,\n              };\n        },\n      },\n    ];\n  }\n}\n\n/**\n * Amp native interpolation token: `${env:VAR}` → `${VAR}`.\n *\n * When the portable ref carried a default (`${env:VAR:-fallback}`), Amp's native\n * `${VAR}` token has no way to express it — so a bare native token would silently\n * DROP the default. Instead, resolve the default at install time: emit the live\n * value when VAR is set and non-empty, else the literal fallback. The native\n * token is only emitted when there is no default to preserve.\n */\nfunction ampEnvToken(name: string, def?: string): string {\n  if (def !== undefined) {\n    const v = process.env[name];\n    return v != null && v !== \"\" ? v : def;\n  }\n  return `\\${${name}}`;\n}\n\nexport const adapter = new AmpAdapter();\nexport default adapter;\n"],"mappings":"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","names":["entry"]}

package/dist/{antigravity-7IBYFO6P.js → antigravity-AMKKKHS4.js}

@@ -3,11 +3,11 @@ import {
   AntigravityAdapter,
   adapter,
   antigravity_default
-} from "./chunk-KQSNDFBN.js";
+} from "./chunk-LQRAPXS4.js";
 import "./chunk-DBQMX75U.js";
-import "./chunk-PD4VFEBY.js";
+import "./chunk-CPLK7GTE.js";
 import "./chunk-7L6ITC4T.js";
-import "./chunk-MEH7GC7R.js";
+import "./chunk-I5MLE6S7.js";
 import "./chunk-N6HH7K6P.js";
 import "./chunk-TRQKHP7D.js";
 export {
@@ -15,4 +15,4 @@ export {
   adapter,
   antigravity_default as default
 };
-//# sourceMappingURL=antigravity-7IBYFO6P.js.map
+//# sourceMappingURL=antigravity-AMKKKHS4.js.map

package/dist/{antigravity-cli-JEOUP2VN.js → antigravity-cli-XERXEH5W.js}

@@ -1,11 +1,11 @@
 #!/usr/bin/env node
 import {
   AntigravityAdapter
-} from "./chunk-KQSNDFBN.js";
+} from "./chunk-LQRAPXS4.js";
 import "./chunk-DBQMX75U.js";
-import "./chunk-PD4VFEBY.js";
+import "./chunk-CPLK7GTE.js";
 import "./chunk-7L6ITC4T.js";
-import "./chunk-MEH7GC7R.js";
+import "./chunk-I5MLE6S7.js";
 import "./chunk-N6HH7K6P.js";
 import "./chunk-TRQKHP7D.js";
 
@@ -84,4 +84,4 @@ export {
   adapter,
   antigravity_cli_default as default
 };
-//# sourceMappingURL=antigravity-cli-JEOUP2VN.js.map
+//# sourceMappingURL=antigravity-cli-XERXEH5W.js.map

package/dist/{chunk-3JCRUROU.js → chunk-24IDL5RW.js}

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 import {
   defineConnector
-} from "./chunk-GSGDG2BV.js";
+} from "./chunk-4ENJK5S2.js";
 import {
   connectorDir,
   connectorsDir,
@@ -73,7 +73,7 @@ function serializablePlatforms(platforms) {
   }
   return out;
 }
-function registerConnector(connector, modulePath) {
+function registerConnector(connector, modulePath, scope) {
   const meta = {
     id: connector.id,
     displayName: connector.displayName,
@@ -88,7 +88,11 @@ function registerConnector(connector, modulePath) {
     subagents: connector.subagents,
     memory: connector.memory,
     targets: connector.targets,
-    platforms: serializablePlatforms(connector.platforms)
+    platforms: serializablePlatforms(connector.platforms),
+    // Persist the install scope when the caller supplied one (the installer
+    // passes its install scope). Omitted from the record when undefined so an
+    // ad-hoc register stays minimal and round-trips as "no scope known".
+    ...scope !== void 0 ? { scope } : {}
   };
   const dir = connectorDir(connector.id);
   ensureDir(dir);
@@ -140,6 +144,11 @@ function connectorFromMeta(meta) {
     skills: meta.skills ?? [],
     subagents: meta.subagents ?? [],
     memory: meta.memory ?? [],
+    // Actions carry live `run` handlers, so they are NOT serialized into the
+    // record (like the statusline render). A handler-less meta-derived connector
+    // gets [] — inspection/uninstall never dispatch action handlers, and the
+    // BaseAdapter action default already tolerates an empty list.
+    actions: [],
     platforms: meta.platforms ?? {},
     targets: meta.targets
   };
@@ -165,4 +174,4 @@ export {
   connectorFromMeta,
   listRegisteredConnectors
 };
-//# sourceMappingURL=chunk-3JCRUROU.js.map
+//# sourceMappingURL=chunk-24IDL5RW.js.map

package/dist/chunk-24IDL5RW.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/core/load-connector.ts"],"sourcesContent":["/**\n * core/load-connector — discover, load, and register connector definitions.\n *\n * Responsibilities:\n *   1. Locate the developer's `agent-connector.config.{mjs,js,json}` by walking\n *      upward from a start directory (the project root convention).\n *   2. Load a config from a path into a LIVE ResolvedConnector (with handlers).\n *   3. Register a connector by persisting SERIALIZABLE metadata (no functions)\n *      to `connectorDir(id)/connector.json`, pointing at the source module so\n *      live handlers can be re-imported at runtime from a stable record.\n *\n * Why split live vs. serialized? Hook handlers are functions and cannot survive\n * JSON. The registry stores only what JSON can hold plus an absolute\n * `modulePath`; the runtime re-imports that module to recover the live handlers.\n */\n\nimport { existsSync, readdirSync, readFileSync, realpathSync, rmSync, writeFileSync } from \"node:fs\";\nimport { dirname, isAbsolute, join, resolve } from \"node:path\";\nimport { pathToFileURL } from \"node:url\";\n\nimport type {\n  CommandDef,\n  HookEventName,\n  InstallScope,\n  MemoryDef,\n  PlatformId,\n  PlatformOverride,\n  ResolvedConnector,\n  ServerDef,\n  SkillDef,\n  SubagentDef,\n} from \"./types.js\";\nimport { defineConnector } from \"./define-connector.js\";\nimport { connectorDir, connectorsDir, ensureDir } from \"./paths.js\";\n\n/** Candidate config filenames, in resolution-precedence order. */\nconst CONFIG_FILENAMES = [\n  \"agent-connector.config.mjs\",\n  \"agent-connector.config.js\",\n  \"agent-connector.config.json\",\n] as const;\n\n/**\n * The serializable subset of a connector persisted to `connector.json`.\n * Hook handler functions are intentionally absent — only the absolute\n * `modulePath` is stored so the live ResolvedConnector can be re-imported.\n */\nexport interface RegisteredMeta {\n  id: string;\n  displayName: string;\n  version: string;\n  /** Absolute path to the source module that produced this connector. */\n  modulePath: string;\n  telemetry: ResolvedConnector[\"telemetry\"];\n  /** Canonical event names the connector handles (handlers themselves stripped). */\n  hookEvents: HookEventName[];\n  hasServer: boolean;\n  server: ServerDef | null;\n  /**\n   * Content surfaces (commands/skills/subagents). These are JSON-serializable\n   * (no functions) so they persist cleanly and let uninstall locate the files\n   * to remove even when the source module is gone.\n   */\n  commands: CommandDef[];\n  skills: SkillDef[];\n  subagents: SubagentDef[];\n  /**\n   * Memory entries (managed-block content surface). Plain content, persisted\n   * whole so uninstall normally has the full entry list even when the source\n   * module is gone (the marker prefix-scan is the fallback beyond that).\n   */\n  memory: MemoryDef[];\n  targets: ResolvedConnector[\"targets\"];\n  /** Per-platform overrides with any hook handler functions stripped. */\n  platforms: Partial<Record<PlatformId, PlatformOverride>>;\n  /**\n   * The install scope this connector was registered under, persisted so the\n   * runtime entrypoints (hook/statusline/action) can recover it cheaply (sync)\n   * and stamp it onto the HostCtx/event — scope is an install-time property the\n   * runtime otherwise has no access to. OPTIONAL: absent for an ad-hoc register\n   * that passed no scope, or a record written before this field existed.\n   * This is the install's RUN-WIDE DEFAULT scope; it can differ from the\n   * effective per-host scope when a `platforms[host].scope` override is set (the\n   * record is keyed by connector id only and holds no per-host scope map).\n   */\n  scope?: InstallScope;\n}\n\n/**\n * Search `startDir` and each ancestor for a connector config file. Returns the\n * absolute path to the first match (filesystem-root-stopping), or null.\n */\nexport function findConnectorConfig(startDir: string): string | null {\n  let dir = resolve(startDir);\n  // Walk upward until `dirname(dir) === dir` (filesystem root).\n  for (;;) {\n    for (const name of CONFIG_FILENAMES) {\n      const candidate = join(dir, name);\n      if (existsSync(candidate)) return candidate;\n    }\n    const parent = dirname(dir);\n    if (parent === dir) break;\n    dir = parent;\n  }\n  return null;\n}\n\n/** True if a value already looks like a ResolvedConnector (vs. a raw config). */\nfunction isResolvedConnector(value: unknown): value is ResolvedConnector {\n  return (\n    typeof value === \"object\" &&\n    value !== null &&\n    Array.isArray((value as { hookEvents?: unknown }).hookEvents)\n  );\n}\n\n/**\n * Load a connector from an absolute or relative path.\n *   - `.json`           → JSON.parse, then defineConnector().\n *   - `.mjs` / `.js`    → dynamic import (via pathToFileURL, Windows-safe),\n *                         take the default export. If it already looks like a\n *                         ResolvedConnector use it as-is; otherwise treat it as\n *                         a ConnectorConfig and run it through defineConnector().\n * Returns the live connector plus the absolute module path it came from.\n */\nexport async function loadConnectorFromPath(\n  path: string,\n): Promise<{ connector: ResolvedConnector; modulePath: string }> {\n  let modulePath = isAbsolute(path) ? path : resolve(path);\n  // Canonicalize before building the file:// URL for dynamic import. On Windows a\n  // short (8.3) temp path like C:\\Users\\RUNNER~1\\...\\x.mjs round-trips the \"~\" as\n  // %7E and fails to load; realpathSync.native expands it to the real long path.\n  // It also resolves symlinked temp roots (e.g. macOS /var -> /private/var).\n  // If the file does not exist yet, fall through with the resolve()'d path so the\n  // subsequent read/import throws the real not-found error.\n  try {\n    modulePath = realpathSync.native(modulePath);\n  } catch {\n    /* keep the resolve()'d path */\n  }\n\n  if (modulePath.endsWith(\".json\")) {\n    const text = readFileSync(modulePath, \"utf8\");\n    const config = JSON.parse(text) as unknown;\n    const connector = defineConnector(config as Parameters<typeof defineConnector>[0]);\n    return { connector, modulePath };\n  }\n\n  // .mjs / .js — dynamic ESM import. pathToFileURL keeps Windows paths valid.\n  const mod = (await import(pathToFileURL(modulePath).href)) as {\n    default?: unknown;\n  };\n  const exported = mod.default;\n  if (exported == null) {\n    throw new Error(\n      `Connector module has no default export: ${modulePath}`,\n    );\n  }\n  const connector = isResolvedConnector(exported)\n    ? exported\n    : defineConnector(exported as Parameters<typeof defineConnector>[0]);\n  return { connector, modulePath };\n}\n\n/**\n * Strip any function-valued `hooks` from per-platform overrides so the result\n * is JSON-serializable. A boolean `hooks` override is preserved; an object\n * override is dropped (it can only carry handler functions, which are not\n * serializable). `nativeHooks` declarations are persisted HANDLER-LESS (event\n * name + matcher only) so meta-based inspection (doctor / health checks / the\n * hook CLI) can still see WHICH native events were declared — the live handlers\n * are re-imported from `modulePath` at runtime, exactly like normalized hooks.\n * Everything else on the override is kept verbatim — notably `configPatch`\n * declarations, which are pure JSON (key/value/reason/docsUrl, no functions)\n * and persist WHOLE so uninstall/doctor can reason about them even when the\n * source module is gone.\n */\nfunction serializablePlatforms(\n  platforms: Partial<Record<PlatformId, PlatformOverride>>,\n): Partial<Record<PlatformId, PlatformOverride>> {\n  const out: Partial<Record<PlatformId, PlatformOverride>> = {};\n  for (const [id, override] of Object.entries(platforms) as [\n    PlatformId,\n    PlatformOverride | undefined,\n  ][]) {\n    if (!override) continue;\n    const { hooks, nativeHooks, ...rest } = override;\n    const clean: PlatformOverride = { ...rest };\n    // Keep only a boolean hooks flag; object hooks carry handler functions.\n    if (typeof hooks === \"boolean\") clean.hooks = hooks;\n    if (nativeHooks && typeof nativeHooks === \"object\") {\n      const stripped: Record<string, { matcher?: string }> = {};\n      for (const [event, def] of Object.entries(nativeHooks)) {\n        stripped[event] =\n          typeof def?.matcher === \"string\" ? { matcher: def.matcher } : {};\n      }\n      // Cast: the persisted record deliberately omits the (non-serializable)\n      // handler; consumers of meta-derived connectors never dispatch handlers.\n      clean.nativeHooks = stripped as PlatformOverride[\"nativeHooks\"];\n    }\n    out[id] = clean;\n  }\n  return out;\n}\n\n/**\n * Persist a connector's serializable metadata to `connectorDir(id)/connector.json`.\n * Handlers are NOT serialized — they are re-imported from `modulePath` at runtime.\n * The optional `scope` (the install scope the caller deployed under) is persisted\n * so the runtime entrypoints can recover it and stamp it onto the HostCtx/event.\n * Returns the absolute path of the written record.\n */\nexport function registerConnector(\n  connector: ResolvedConnector,\n  modulePath: string,\n  scope?: InstallScope,\n): string {\n  const meta: RegisteredMeta = {\n    id: connector.id,\n    displayName: connector.displayName,\n    version: connector.version,\n    modulePath: resolve(modulePath),\n    telemetry: connector.telemetry,\n    hookEvents: connector.hookEvents,\n    hasServer: !!connector.server,\n    server: connector.server ?? null,\n    commands: connector.commands,\n    skills: connector.skills,\n    subagents: connector.subagents,\n    memory: connector.memory,\n    targets: connector.targets,\n    platforms: serializablePlatforms(connector.platforms),\n    // Persist the install scope when the caller supplied one (the installer\n    // passes its install scope). Omitted from the record when undefined so an\n    // ad-hoc register stays minimal and round-trips as \"no scope known\".\n    ...(scope !== undefined ? { scope } : {}),\n  };\n\n  const dir = connectorDir(connector.id);\n  ensureDir(dir);\n  const outPath = join(dir, \"connector.json\");\n  writeFileSync(outPath, `${JSON.stringify(meta, null, 2)}\\n`, \"utf8\");\n  return outPath;\n}\n\n/**\n * Deregister a connector by removing its DATA-dir record directory\n * (`connectorDir(id)`) recursively. This is the inverse of {@link registerConnector}:\n * registerConnector writes `connectorDir(id)/connector.json`, but per-target\n * uninstall only strips host-native registrations — it never removes this record,\n * leaving an orphan behind. Best-effort + guarded: returns the directory path and\n * whether it existed before removal.\n */\nexport function deregisterConnector(id: string): {\n  removed: boolean;\n  path: string;\n} {\n  const dir = connectorDir(id);\n  const existed = existsSync(dir);\n  if (existed) rmSync(dir, { recursive: true, force: true });\n  return { removed: existed, path: dir };\n}\n\n/**\n * Read the registered metadata record for `id`, or null if not registered or\n * the record is unreadable/corrupt.\n */\nexport function readRegisteredMeta(id: string): RegisteredMeta | null {\n  const recordPath = join(connectorDir(id), \"connector.json\");\n  if (!existsSync(recordPath)) return null;\n  try {\n    return JSON.parse(readFileSync(recordPath, \"utf8\")) as RegisteredMeta;\n  } catch {\n    return null;\n  }\n}\n\n/**\n * Load the LIVE ResolvedConnector (with hook handlers) for a registered id by\n * re-importing its source module. Throws a clear error when the connector is\n * not registered or its source module no longer resolves to it.\n */\nexport async function loadRegisteredConnector(\n  id: string,\n): Promise<ResolvedConnector> {\n  const meta = readRegisteredMeta(id);\n  if (!meta) {\n    throw new Error(\n      `Connector \"${id}\" is not registered (no record at ${join(connectorDir(id), \"connector.json\")}). ` +\n        `Run an install/register step first.`,\n    );\n  }\n  if (!meta.modulePath || !existsSync(meta.modulePath)) {\n    throw new Error(\n      `Connector \"${id}\" record points at a missing module: ${meta.modulePath}`,\n    );\n  }\n  const { connector } = await loadConnectorFromPath(meta.modulePath);\n  return connector;\n}\n\n/**\n * Build a handler-less ResolvedConnector from stored metadata. Suitable for\n * inspection/doctor where live hook handlers are not needed (and where the\n * source module may even be gone). `hooks` is empty; `hookEvents` is preserved.\n */\nexport function connectorFromMeta(meta: RegisteredMeta): ResolvedConnector {\n  return {\n    id: meta.id,\n    displayName: meta.displayName,\n    version: meta.version,\n    ...(meta.server ? { server: meta.server } : {}),\n    hooks: {},\n    hookEvents: meta.hookEvents ?? [],\n    telemetry: meta.telemetry,\n    commands: meta.commands ?? [],\n    skills: meta.skills ?? [],\n    subagents: meta.subagents ?? [],\n    memory: meta.memory ?? [],\n    // Actions carry live `run` handlers, so they are NOT serialized into the\n    // record (like the statusline render). A handler-less meta-derived connector\n    // gets [] — inspection/uninstall never dispatch action handlers, and the\n    // BaseAdapter action default already tolerates an empty list.\n    actions: [],\n    platforms: meta.platforms ?? {},\n    targets: meta.targets,\n  };\n}\n\n/**\n * List every registered connector as a handler-less ResolvedConnector (read\n * from `connectorsDir()`). Used by doctor to health-check what is actually\n * installed, rather than guessing from the local working directory.\n */\nexport function listRegisteredConnectors(): ResolvedConnector[] {\n  const dir = connectorsDir();\n  if (!existsSync(dir)) return [];\n  const out: ResolvedConnector[] = [];\n  for (const entry of readdirSync(dir)) {\n    const meta = readRegisteredMeta(entry);\n    if (meta) out.push(connectorFromMeta(meta));\n  }\n  return out;\n}\n"],"mappings":"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","names":["connector"]}

package/dist/chunk-2AVLX7GH.js

@@ -0,0 +1,351 @@
+#!/usr/bin/env node
+import {
+  getTokenizer,
+  inferModelFamily,
+  newRecordId,
+  openStore,
+  worstConfidence
+} from "./chunk-BCHWFTV4.js";
+import {
+  log
+} from "./chunk-KHO5WNTP.js";
+import {
+  loadRegisteredConnector,
+  readRegisteredMeta
+} from "./chunk-24IDL5RW.js";
+import {
+  REGISTERED_PLATFORM_IDS,
+  loadAdapter
+} from "./chunk-DCKFYWGM.js";
+import {
+  projectIdentity
+} from "./chunk-TRQKHP7D.js";
+
+// src/runtime/telemetry-accessor.ts
+var ZERO = {
+  inputTokens: 0,
+  outputTokens: 0,
+  totalTokens: 0,
+  calls: 0
+};
+function buildTelemetryAccessor(connectorId) {
+  return async () => {
+    if (process.env.AGENT_CONNECTOR_TELEMETRY === "0") return { ...ZERO };
+    try {
+      const store = openStore({});
+      try {
+        let inputTokens = 0;
+        let outputTokens = 0;
+        let calls = 0;
+        for (const row of store.query({ connectorId })) {
+          inputTokens += Number.isFinite(row.inputTokens) ? row.inputTokens : 0;
+          outputTokens += Number.isFinite(row.outputTokens) ? row.outputTokens : 0;
+          calls += 1;
+        }
+        return {
+          inputTokens,
+          outputTokens,
+          totalTokens: inputTokens + outputTokens,
+          calls
+        };
+      } finally {
+        store.close();
+      }
+    } catch {
+      return { ...ZERO };
+    }
+  };
+}
+
+// src/telemetry/measure.ts
+var MODALITY_ESTIMATE = {
+  image: 85,
+  audio: 85,
+  resource: 85
+};
+var UNKNOWN_BLOCK_ESTIMATE = 85;
+function combineSources(sources) {
+  let worst = "host-native";
+  for (const s of sources) worst = worstConfidence(worst, s);
+  return worst;
+}
+function isObject(v) {
+  return typeof v === "object" && v !== null;
+}
+function isTextBlock(block) {
+  return block.type === "text";
+}
+function measureToolCall(args, result, family, tok = getTokenizer()) {
+  const input = tok.countValue(args, family);
+  const output = measureResult(result, family, tok);
+  return {
+    inputTokens: input.tokens,
+    outputTokens: output.tokens,
+    source: worstConfidence(input.source, output.source)
+  };
+}
+function measureResult(result, family, tok) {
+  if (!isObject(result)) {
+    return tok.countValue(result, family);
+  }
+  const res = result;
+  const sources = [];
+  let tokens = 0;
+  if (Array.isArray(res.content)) {
+    for (const raw of res.content) {
+      if (!isObject(raw)) continue;
+      const block = raw;
+      if (isTextBlock(block)) {
+        const text = typeof block.text === "string" ? block.text : "";
+        const c = tok.count(text, family);
+        tokens += c.tokens;
+        sources.push(c.source);
+      } else {
+        const key = typeof block.type === "string" ? block.type : "";
+        tokens += MODALITY_ESTIMATE[key] ?? UNKNOWN_BLOCK_ESTIMATE;
+        sources.push("tokenizer-approx");
+      }
+    }
+  } else if (res.content !== void 0) {
+    const c = tok.countValue(res.content, family);
+    tokens += c.tokens;
+    sources.push(c.source);
+  }
+  if (res.structuredContent !== void 0) {
+    const c = tok.countValue(res.structuredContent, family);
+    tokens += c.tokens;
+    sources.push(c.source);
+  }
+  if (sources.length === 0) {
+    return tok.countValue(result, family);
+  }
+  return { tokens, source: combineSources(sources) };
+}
+function measureToolDefs(tools, family, tok = getTokenizer()) {
+  return tok.countValue(tools, family);
+}
+function measureHook(eventPayload, handlerReturn, family, tok = getTokenizer()) {
+  const input = tok.countValue(eventPayload, family);
+  const output = tok.countValue(handlerReturn, family);
+  return {
+    inputTokens: input.tokens,
+    outputTokens: output.tokens,
+    source: worstConfidence(input.source, output.source)
+  };
+}
+
+// src/runtime/hook-entrypoint.ts
+var ALLOW = { exitCode: 0 };
+function eventMatcherSubject(evt) {
+  const name = evt.toolName;
+  if (typeof name === "string") return name;
+  const agentType = evt.agentType;
+  if (typeof agentType === "string") return agentType;
+  return void 0;
+}
+function parseStdin(stdin) {
+  const trimmed = stdin.trim();
+  if (trimmed === "") return {};
+  try {
+    return JSON.parse(trimmed);
+  } catch {
+    return {};
+  }
+}
+function compileMatcher(matcher) {
+  if (!matcher || matcher === "") return null;
+  try {
+    return new RegExp(matcher);
+  } catch {
+    return null;
+  }
+}
+function normalizeResponse(value) {
+  if (value == null || typeof value !== "object") return {};
+  return value;
+}
+function resolveHookHostPlatform(platformId, evt) {
+  const override = process.env.AGENT_CONNECTOR_HOST;
+  if (override !== void 0 && REGISTERED_PLATFORM_IDS.has(override)) {
+    return override;
+  }
+  if (REGISTERED_PLATFORM_IDS.has(platformId)) {
+    return platformId;
+  }
+  const fromEvent = evt.hostPlatform;
+  if (typeof fromEvent === "string" && REGISTERED_PLATFORM_IDS.has(fromEvent)) {
+    return fromEvent;
+  }
+  return "unknown";
+}
+function recordHookTelemetry(opts, connector, evt, response) {
+  if (process.env.AGENT_CONNECTOR_TELEMETRY === "0") return;
+  try {
+    const family = inferModelFamily("", connector.telemetry.modelFamilyHint);
+    const measurement = measureHook(evt, response, family, getTokenizer());
+    const sessionId = typeof evt.sessionId === "string" ? evt.sessionId : "";
+    const evtProjectDir = evt.projectDir;
+    const projectDir = typeof evtProjectDir === "string" && evtProjectDir !== "" ? evtProjectDir : process.cwd();
+    const id = projectIdentity(projectDir);
+    const store = openStore({});
+    try {
+      store.append({
+        id: newRecordId(0),
+        ts: Date.now(),
+        connectorId: opts.connectorId,
+        toolName: opts.event,
+        // for a hook row the per-item name IS the event
+        scope: "hook",
+        surfaceKind: "hook",
+        hostPlatform: resolveHookHostPlatform(opts.platformId, evt),
+        sessionId,
+        projectKey: id.key,
+        projectDir: id.dir,
+        inputTokens: measurement.inputTokens,
+        outputTokens: measurement.outputTokens,
+        confidenceSource: measurement.source,
+        isError: false
+      });
+    } finally {
+      store.close();
+    }
+  } catch {
+  }
+}
+async function runHook(opts) {
+  const { platformId, event, connectorId, stdin } = opts;
+  try {
+    const connector = await loadRegisteredConnector(connectorId);
+    const adapter = await loadAdapter(platformId);
+    if (!adapter || !adapter.parseEvent || !adapter.formatReply) {
+      return ALLOW;
+    }
+    const raw = parseStdin(stdin);
+    const evt = adapter.parseEvent(event, raw);
+    evt.connectorId = connectorId;
+    evt.capabilities = adapter.capabilities;
+    evt.scope = readRegisteredMeta(connectorId)?.scope;
+    evt.telemetry = buildTelemetryAccessor(connectorId);
+    const definition = connector.hooks[event];
+    if (!definition || typeof definition.handler !== "function") {
+      return ALLOW;
+    }
+    const perHost = definition.hosts?.[platformId]?.handler;
+    const handler = typeof perHost === "function" ? perHost : definition.handler;
+    const subject = eventMatcherSubject(evt);
+    if (subject !== void 0) {
+      const re = compileMatcher(definition.matcher);
+      if (re && !re.test(subject)) return ALLOW;
+    }
+    const handlerResult = await handler(
+      // The adapter parsed `evt` as exactly this event's payload type; the
+      // HooksConfig handler for the same event expects that payload.
+      evt
+    );
+    const response = normalizeResponse(handlerResult);
+    recordHookTelemetry(opts, connector, evt, response);
+    const reply = adapter.formatReply(event, response);
+    return {
+      exitCode: reply.exitCode,
+      ...reply.stdout !== void 0 ? { stdout: reply.stdout } : {},
+      ...reply.stderr !== void 0 ? { stderr: reply.stderr } : {}
+    };
+  } catch (err) {
+    const message = err instanceof Error ? err.message : String(err);
+    log.error(`hook ${platformId}/${event} (${connectorId}) failed:`, message);
+    return failOpenOrPreserveDeny(opts, message);
+  }
+}
+var DENY_PRESERVE_EVENTS = /* @__PURE__ */ new Set([
+  "PreToolUse",
+  "PermissionRequest"
+]);
+async function failOpenOrPreserveDeny(opts, errorMessage) {
+  if (!DENY_PRESERVE_EVENTS.has(opts.event)) return ALLOW;
+  try {
+    const connector = await loadRegisteredConnector(opts.connectorId);
+    const adapter = await loadAdapter(opts.platformId);
+    if (!adapter?.parseEvent || !adapter.formatReply) return ALLOW;
+    const definition = connector.hooks[opts.event];
+    if (!definition || typeof definition.handler !== "function") return ALLOW;
+    const perHost = definition.hosts?.[opts.platformId]?.handler;
+    const handler = typeof perHost === "function" ? perHost : definition.handler;
+    const raw = parseStdin(opts.stdin);
+    const evt = adapter.parseEvent(opts.event, raw);
+    evt.connectorId = opts.connectorId;
+    evt.capabilities = adapter.capabilities;
+    evt.scope = readRegisteredMeta(opts.connectorId)?.scope;
+    evt.telemetry = buildTelemetryAccessor(opts.connectorId);
+    const subject = eventMatcherSubject(evt);
+    if (subject !== void 0) {
+      const re = compileMatcher(definition.matcher);
+      if (re && !re.test(subject)) return ALLOW;
+    }
+    const response = normalizeResponse(await handler(evt));
+    if (response.decision !== "deny") return ALLOW;
+    const reply = adapter.formatReply(opts.event, response);
+    return {
+      exitCode: reply.exitCode,
+      ...reply.stdout !== void 0 ? { stdout: reply.stdout } : {},
+      ...reply.stderr !== void 0 ? { stderr: reply.stderr } : { stderr: errorMessage }
+    };
+  } catch {
+    return ALLOW;
+  }
+}
+function nativeHookDef(connector, platformId, event) {
+  return connector.platforms[platformId]?.nativeHooks?.[event];
+}
+async function isNativeHookDeclared(platformId, event, connectorId) {
+  try {
+    const connector = await loadRegisteredConnector(connectorId);
+    return typeof nativeHookDef(connector, platformId, event)?.handler === "function";
+  } catch {
+    return false;
+  }
+}
+async function runNativeHook(opts) {
+  const { platformId, event, connectorId, stdin } = opts;
+  try {
+    const connector = await loadRegisteredConnector(connectorId);
+    const def = nativeHookDef(connector, platformId, event);
+    if (!def || typeof def.handler !== "function") {
+      return ALLOW;
+    }
+    const raw = parseStdin(stdin);
+    const sessionId = typeof raw?.session_id === "string" ? raw.session_id : "";
+    const cwd = raw?.cwd;
+    const evt = {
+      event,
+      hostPlatform: REGISTERED_PLATFORM_IDS.has(platformId) ? platformId : "unknown",
+      sessionId,
+      ...typeof cwd === "string" && cwd !== "" ? { projectDir: cwd } : {},
+      raw
+    };
+    const result = await def.handler(evt);
+    recordHookTelemetry(opts, connector, evt, result === void 0 ? {} : result);
+    if (result === void 0) return ALLOW;
+    const json = JSON.stringify(result);
+    if (json === void 0) return ALLOW;
+    return { exitCode: 0, stdout: json };
+  } catch (err) {
+    const message = err instanceof Error ? err.message : String(err);
+    log.error(
+      `native hook ${platformId}/${event} (${connectorId}) failed:`,
+      message
+    );
+    return ALLOW;
+  }
+}
+
+export {
+  buildTelemetryAccessor,
+  measureToolCall,
+  measureToolDefs,
+  eventMatcherSubject,
+  compileMatcher,
+  runHook,
+  isNativeHookDeclared,
+  runNativeHook
+};
+//# sourceMappingURL=chunk-2AVLX7GH.js.map