@goodfoot/agent-hooks 1.0.8 → 1.0.10

package/types/cli.d.ts

@@ -28,7 +28,7 @@ type HookContext = "plugin" | "agent";
  * Command-line arguments parsed from process.argv.
  */
 interface CliArgs {
-    /** Target agent runtime (required): "claude-code" | "codex" | "antigravity". */
+    /** Target agent runtime (required): "claude-code" | "codex" | "antigravity" | "opencode". */
     agent: string;
     /** Glob pattern for hook source files. */
     input: string;
@@ -54,7 +54,7 @@ interface CliArgs {
     pluginRoot?: boolean;
     /** Emit hash-free `<name>.mjs` bundles. Defaults to true; set false with --no-stable-names. */
     stableNames?: boolean;
-    /** Embed an inline sourcemap in compiled bundles. Defaults to true; set false with --no-sourcemap. */
+    /** Embed an inline sourcemap in compiled bundles. Defaults to false; enable with --sourcemap. */
     sourcemap?: boolean;
 }
 type HookLoaderMap = Record<string, esbuild.Loader>;
@@ -173,14 +173,14 @@ interface CompileHookOptions {
     logEnvVar?: string;
     /** Explicit esbuild loaders for non-code imports. */
     loaders: HookLoaderMap;
-    /** Embed an inline sourcemap in the compiled content. Defaults to true; set false with --no-sourcemap. */
+    /** Embed an inline sourcemap in the compiled content. Defaults to false; enable with --sourcemap. */
     sourcemap?: boolean;
 }
 /**
  * Result of compiling a hook.
  */
 interface CompileHookResult {
-    /** Compiled content, with inline sourcemaps unless disabled. */
+    /** Compiled content, with inline sourcemaps when enabled. */
     content: string;
     /** Stable content hash generated from sourcemap-free output. */
     contentHash: string;
@@ -203,6 +203,17 @@ interface CompileHookResult {
  * checkout-local.
  */
 declare function symlinkVisiblePath(realPath: string, resolveDir: string): string;
+/**
+ * Returns the stable project anchor for a module reached through node_modules.
+ *
+ * esbuild otherwise uses process.cwd() when rendering module-boundary comments
+ * and sourcemap source paths. A workspace script normally runs from the
+ * consuming package, while its dependencies may be hoisted several directories
+ * higher, making those emitted paths depend on the consumer's nesting depth.
+ * Anchoring at the directory which owns the visible node_modules keeps the
+ * canonical `node_modules/...` form in every such layout.
+ */
+declare function moduleWorkingDir(modulePath: string, fallback: string): string;
 /**
  * Compiles a TypeScript hook file to a self-contained ESM executable.
  *
@@ -312,4 +323,4 @@ declare function extractPreservedHooks(existingHooksJson: HooksJson): Partial<Re
  */
 declare function mergeHooksJson(newHooksJson: HooksJson, preservedHooks: Partial<Record<HookEventName, MatcherEntry[]>>): HooksJson;
 export type { CliArgs, CompiledHook, HookConfig, HookLoaderMap, HookMetadata, HooksJson, MatcherEntry };
-export { analyzeHookFile, buildLoaderMap, buildLoaderMap as buildEsbuildLoaderMap, compileHook, detectHookContext, discoverHookFiles, discoverHookFiles as discoverHookSourceFiles, extractPreservedHooks, generateCommandPath, generateContentHash, generateContentHash as sha256Prefix8, generateHooksJson, groupHooksByEventAndMatcher, HOOK_FACTORY_TO_EVENT, mergeHooksJson, parseArgs, parseLoaderFlag, parseLoaderFlag as parseEsbuildLoaderFlag, pruneStaleHashedBundles, readExistingHooksJson, removeOldGeneratedFiles, symlinkVisiblePath, validateArgs, };
+export { analyzeHookFile, buildLoaderMap, buildLoaderMap as buildEsbuildLoaderMap, compileHook, detectHookContext, discoverHookFiles, discoverHookFiles as discoverHookSourceFiles, extractPreservedHooks, generateCommandPath, generateContentHash, generateContentHash as sha256Prefix8, generateHooksJson, groupHooksByEventAndMatcher, HOOK_FACTORY_TO_EVENT, mergeHooksJson, moduleWorkingDir, parseArgs, parseLoaderFlag, parseLoaderFlag as parseEsbuildLoaderFlag, pruneStaleHashedBundles, readExistingHooksJson, removeOldGeneratedFiles, symlinkVisiblePath, validateArgs, };

package/types/index.d.ts

@@ -6,8 +6,8 @@
  * {@link HookBlockError}, the Logger, env utilities, and stdin helpers.
  *
  * Per-agent entry points (`@goodfoot/agent-hooks/claude-code`, `/codex`,
- * `/antigravity`) are added to the package `exports` map only in the step
- * that lands their implementation — never pre-declared.
+ * `/opencode`, `/antigravity`) expose each host's native protocol without
+ * leaking host-specific types through this root module.
  * @module
  */
 export { defineHook } from "./core/define-hook.js";