@agentxm/extension-model 0.38.0 → 0.39.0

package/dist/src/unstable/hooks/manifest-schema.d.ts

@@ -1,137 +1,243 @@
-/**
- * Hook manifest schema definition.
- *
- * @experimental This API is unstable and may change without notice.
- */
+/** Native Hook package contract. @experimental */
+import * as Result from "effect/Result";
 import * as Schema from "effect/Schema";
 export declare const HOOK_MANIFEST_FILENAME = "hook.json";
 export declare const HOOK_EXTENSION_DIR = "hooks";
 export declare const HOOK_MANIFEST_SCHEMA_URL = "https://axm.sh/schemas/hook.schema.json";
 export declare const HookRuntimeSchema: Schema.Literals<readonly ["bash", "node", "python"]>;
-/** @experimental */
 export type HookRuntime = Schema.Schema.Type<typeof HookRuntimeSchema>;
-export declare const HookEventSchema: Schema.Literals<readonly ["session.start", "prompt.submit", "turn.end", "tool.pre", "tool.post", "subagent.stop", "compaction.pre"]>;
-/** @experimental */
-export type HookEvent = Schema.Schema.Type<typeof HookEventSchema>;
-export declare const HookMatchSchema: Schema.Struct<{
-    readonly tools: Schema.optional<Schema.NonEmptyArray<Schema.Literals<readonly ["file.read", "file.write", "file.edit", "shell.exec", "web.fetch", "mcp.call"]>>>;
+export declare const HookPackagePathSchema: Schema.NonEmptyString;
+/** Symbolic references are preserved, never resolved against the author's environment. */
+export declare const HookEnvironmentReferenceSchema: Schema.Struct<{
+    readonly env: Schema.NonEmptyString;
 }>;
-/** @experimental */
-export type HookMatch = Schema.Schema.Type<typeof HookMatchSchema>;
-export declare const HookDecisionRequirementSchema: Schema.Union<readonly [Schema.Struct<{
-    readonly kind: Schema.Literal<"observe">;
+export declare const HookValueSchema: Schema.Union<readonly [Schema.String, Schema.Struct<{
+    readonly config: Schema.NonEmptyString;
 }>, Schema.Struct<{
-    readonly kind: Schema.Literal<"block">;
-    readonly outcomes: Schema.optional<Schema.NonEmptyArray<Schema.Literals<readonly ["allow", "deny", "ask"]>>>;
+    readonly env: Schema.NonEmptyString;
+}>]>;
+export type HookValue = Schema.Schema.Type<typeof HookValueSchema>;
+export declare const HookConfigurationValueSchema: Schema.Union<readonly [Schema.String, Schema.Finite, Schema.Boolean, Schema.Struct<{
+    readonly env: Schema.NonEmptyString;
+}>]>;
+export type HookConfigurationValue = Schema.Schema.Type<typeof HookConfigurationValueSchema>;
+export declare const HookConfigurationValuesSchema: Schema.$Record<Schema.NonEmptyString, Schema.Union<readonly [Schema.String, Schema.Finite, Schema.Boolean, Schema.Struct<{
+    readonly env: Schema.NonEmptyString;
+}>]>>;
+export type HookConfigurationValues = Schema.Schema.Type<typeof HookConfigurationValuesSchema>;
+export declare const HookConfigurationFieldSchema: Schema.Union<readonly [Schema.Struct<{
+    readonly type: Schema.Literal<"string">;
+    readonly default: Schema.optional<Schema.String>;
+    readonly secret: Schema.optional<Schema.Boolean>;
+    readonly allowEmpty: Schema.optional<Schema.Boolean>;
+    readonly minLength: Schema.optional<Schema.Int>;
+    readonly maxLength: Schema.optional<Schema.Int>;
+    readonly description: Schema.optional<Schema.NonEmptyString>;
+    readonly required: Schema.optional<Schema.Boolean>;
 }>, Schema.Struct<{
-    readonly kind: Schema.Literal<"modify">;
-    readonly operations: Schema.optional<Schema.NonEmptyArray<Schema.Literals<readonly ["modify-input", "inject-context", "modify-output", "synthesize", "redact"]>>>;
+    readonly type: Schema.Literal<"number">;
+    readonly default: Schema.optional<Schema.Finite>;
+    readonly minimum: Schema.optional<Schema.Finite>;
+    readonly maximum: Schema.optional<Schema.Finite>;
+    readonly description: Schema.optional<Schema.NonEmptyString>;
+    readonly required: Schema.optional<Schema.Boolean>;
+}>, Schema.Struct<{
+    readonly type: Schema.Literal<"boolean">;
+    readonly default: Schema.optional<Schema.Boolean>;
+    readonly description: Schema.optional<Schema.NonEmptyString>;
+    readonly required: Schema.optional<Schema.Boolean>;
+}>, Schema.Struct<{
+    readonly type: Schema.Literal<"enum">;
+    readonly values: Schema.NonEmptyArray<Schema.NonEmptyString>;
+    readonly default: Schema.optional<Schema.NonEmptyString>;
+    readonly description: Schema.optional<Schema.NonEmptyString>;
+    readonly required: Schema.optional<Schema.Boolean>;
 }>]>;
-/** @experimental */
-export type HookDecisionRequirement = Schema.Schema.Type<typeof HookDecisionRequirementSchema>;
-export declare const HookBindingTargetSchema: Schema.Struct<{
-    readonly matcherRaw: Schema.optional<Schema.NonEmptyString>;
+export type HookConfigurationField = Schema.Schema.Type<typeof HookConfigurationFieldSchema>;
+export declare const HookBindingRequirementsSchema: Schema.Struct<{
+    readonly outcomes: Schema.optional<Schema.NonEmptyArray<Schema.Literals<readonly ["allow", "deny", "ask"]>>>;
+    readonly operations: Schema.optional<Schema.NonEmptyArray<Schema.Literals<readonly ["modify-input", "inject-context", "modify-output", "synthesize", "redact"]>>>;
 }>;
-export declare const CanonicalHookBindingSchema: Schema.Struct<{
-    readonly on: Schema.Literals<readonly ["session.start", "prompt.submit", "turn.end", "tool.pre", "tool.post", "subagent.stop", "compaction.pre"]>;
-    readonly match: Schema.optional<Schema.Struct<{
-        readonly tools: Schema.optional<Schema.NonEmptyArray<Schema.Literals<readonly ["file.read", "file.write", "file.edit", "shell.exec", "web.fetch", "mcp.call"]>>>;
-    }>>;
-    readonly matcherRaw: Schema.optional<Schema.NonEmptyString>;
-    readonly targets: Schema.optional<Schema.$Record<Schema.String, Schema.Struct<{
-        readonly matcherRaw: Schema.optional<Schema.NonEmptyString>;
-    }>>>;
-    readonly requires: Schema.optional<Schema.Struct<{
-        readonly decision: Schema.Union<readonly [Schema.Struct<{
-            readonly kind: Schema.Literal<"observe">;
+export declare const HookCommandHandlerSchema: Schema.Struct<{
+    readonly type: Schema.Literal<"command">;
+    readonly name: Schema.optional<Schema.NonEmptyString>;
+    readonly runtime: Schema.Literals<readonly ["bash", "node", "python"]>;
+    readonly entrypoint: Schema.NonEmptyString;
+    readonly args: Schema.optional<Schema.$Array<Schema.Union<readonly [Schema.String, Schema.Struct<{
+        readonly config: Schema.NonEmptyString;
+    }>, Schema.Struct<{
+        readonly env: Schema.NonEmptyString;
+    }>]>>>;
+    readonly env: Schema.optional<Schema.$Record<Schema.NonEmptyString, Schema.Union<readonly [Schema.String, Schema.Struct<{
+        readonly config: Schema.NonEmptyString;
+    }>, Schema.Struct<{
+        readonly env: Schema.NonEmptyString;
+    }>]>>>;
+    readonly timeoutMs: Schema.optional<Schema.Int>;
+}>;
+export type HookCommandHandler = Schema.Schema.Type<typeof HookCommandHandlerSchema>;
+export declare const HookEventSchema: Schema.NonEmptyString;
+export type HookEvent = Schema.Schema.Type<typeof HookEventSchema>;
+export declare const HookBindingSchema: Schema.Struct<{
+    readonly id: Schema.NonEmptyString;
+    readonly event: Schema.NonEmptyString;
+    readonly matcher: Schema.optional<Schema.NonEmptyString>;
+    readonly handler: Schema.Struct<{
+        readonly type: Schema.Literal<"command">;
+        readonly name: Schema.optional<Schema.NonEmptyString>;
+        readonly runtime: Schema.Literals<readonly ["bash", "node", "python"]>;
+        readonly entrypoint: Schema.NonEmptyString;
+        readonly args: Schema.optional<Schema.$Array<Schema.Union<readonly [Schema.String, Schema.Struct<{
+            readonly config: Schema.NonEmptyString;
         }>, Schema.Struct<{
-            readonly kind: Schema.Literal<"block">;
-            readonly outcomes: Schema.optional<Schema.NonEmptyArray<Schema.Literals<readonly ["allow", "deny", "ask"]>>>;
+            readonly env: Schema.NonEmptyString;
+        }>]>>>;
+        readonly env: Schema.optional<Schema.$Record<Schema.NonEmptyString, Schema.Union<readonly [Schema.String, Schema.Struct<{
+            readonly config: Schema.NonEmptyString;
         }>, Schema.Struct<{
-            readonly kind: Schema.Literal<"modify">;
-            readonly operations: Schema.optional<Schema.NonEmptyArray<Schema.Literals<readonly ["modify-input", "inject-context", "modify-output", "synthesize", "redact"]>>>;
-        }>]>;
+            readonly env: Schema.NonEmptyString;
+        }>]>>>;
+        readonly timeoutMs: Schema.optional<Schema.Int>;
+    }>;
+    readonly requires: Schema.optional<Schema.Struct<{
+        readonly outcomes: Schema.optional<Schema.NonEmptyArray<Schema.Literals<readonly ["allow", "deny", "ask"]>>>;
+        readonly operations: Schema.optional<Schema.NonEmptyArray<Schema.Literals<readonly ["modify-input", "inject-context", "modify-output", "synthesize", "redact"]>>>;
     }>>;
 }>;
-export declare const HookBindingSchema: Schema.Struct<{
-    readonly on: Schema.Literals<readonly ["session.start", "prompt.submit", "turn.end", "tool.pre", "tool.post", "subagent.stop", "compaction.pre"]>;
-    readonly match: Schema.optional<Schema.Struct<{
-        readonly tools: Schema.optional<Schema.NonEmptyArray<Schema.Literals<readonly ["file.read", "file.write", "file.edit", "shell.exec", "web.fetch", "mcp.call"]>>>;
-    }>>;
-    readonly matcherRaw: Schema.optional<Schema.NonEmptyString>;
-    readonly targets: Schema.optional<Schema.$Record<Schema.String, Schema.Struct<{
-        readonly matcherRaw: Schema.optional<Schema.NonEmptyString>;
-    }>>>;
+export type HookBinding = Schema.Schema.Type<typeof HookBindingSchema>;
+export declare const HookImplementationSchema: Schema.Struct<{
+    readonly id: Schema.NonEmptyString;
+    readonly protocol: Schema.Literals<readonly ["adal", "fx", "muse-code", "mimo-code", "coder-agents", "aider-desk", "amp", "antigravity", "antigravity-cli", "augment", "claude-code", "cline", "codearts-agent", "codebuddy", "codemaker", "codestudio", "codex", "command-code", "continue", "cortex", "crush", "cursor", "deepagents", "devin", "dexto", "droid", "firebender", "forgecode", "gemini-cli", "github-copilot-cli", "goose", "grok-cli", "hermes", "ibm-bob", "iflow-cli", "junie", "lingma", "kilo", "kimi-cli", "kiro-cli", "kode", "mcpjam", "minimax-code", "mistral-vibe", "mux", "neovate", "openclaw", "opencode", "openhands", "ona", "pi", "vscode", "pochi", "qoder", "qoder-cn", "qwen-code", "replit", "roo", "rovodev", "tabnine-cli", "trae-cn", "trae", "warp", "windsurf", "zencoder", "zed", "zenflow"]>;
     readonly requires: Schema.optional<Schema.Struct<{
-        readonly decision: Schema.Union<readonly [Schema.Struct<{
-            readonly kind: Schema.Literal<"observe">;
-        }>, Schema.Struct<{
-            readonly kind: Schema.Literal<"block">;
+        readonly hostVersion: Schema.optional<Schema.brand<Schema.NonEmptyString, "VersionRange">>;
+        readonly profiles: Schema.optional<Schema.NonEmptyArray<Schema.NonEmptyString>>;
+        readonly platforms: Schema.optional<Schema.NonEmptyArray<Schema.Literals<readonly ["darwin", "linux", "win32"]>>>;
+        readonly scopes: Schema.optional<Schema.NonEmptyArray<Schema.Literals<readonly ["project", "user"]>>>;
+    }>>;
+    readonly bindings: Schema.NonEmptyArray<Schema.Struct<{
+        readonly id: Schema.NonEmptyString;
+        readonly event: Schema.NonEmptyString;
+        readonly matcher: Schema.optional<Schema.NonEmptyString>;
+        readonly handler: Schema.Struct<{
+            readonly type: Schema.Literal<"command">;
+            readonly name: Schema.optional<Schema.NonEmptyString>;
+            readonly runtime: Schema.Literals<readonly ["bash", "node", "python"]>;
+            readonly entrypoint: Schema.NonEmptyString;
+            readonly args: Schema.optional<Schema.$Array<Schema.Union<readonly [Schema.String, Schema.Struct<{
+                readonly config: Schema.NonEmptyString;
+            }>, Schema.Struct<{
+                readonly env: Schema.NonEmptyString;
+            }>]>>>;
+            readonly env: Schema.optional<Schema.$Record<Schema.NonEmptyString, Schema.Union<readonly [Schema.String, Schema.Struct<{
+                readonly config: Schema.NonEmptyString;
+            }>, Schema.Struct<{
+                readonly env: Schema.NonEmptyString;
+            }>]>>>;
+            readonly timeoutMs: Schema.optional<Schema.Int>;
+        }>;
+        readonly requires: Schema.optional<Schema.Struct<{
             readonly outcomes: Schema.optional<Schema.NonEmptyArray<Schema.Literals<readonly ["allow", "deny", "ask"]>>>;
-        }>, Schema.Struct<{
-            readonly kind: Schema.Literal<"modify">;
             readonly operations: Schema.optional<Schema.NonEmptyArray<Schema.Literals<readonly ["modify-input", "inject-context", "modify-output", "synthesize", "redact"]>>>;
-        }>]>;
+        }>>;
     }>>;
 }>;
-/** @experimental */
-export type HookBinding = Schema.Schema.Type<typeof HookBindingSchema>;
-export declare const HookCapabilitiesSchema: Schema.Struct<{
-    readonly network: Schema.optional<Schema.Boolean>;
-    readonly filesystemWrite: Schema.optional<Schema.Boolean>;
-    readonly exec: Schema.optional<Schema.$Array<Schema.NonEmptyString>>;
-    readonly env: Schema.optional<Schema.$Array<Schema.NonEmptyString>>;
+export type HookImplementation = Schema.Schema.Type<typeof HookImplementationSchema>;
+export declare const HookFixtureSchema: Schema.Struct<{
+    readonly id: Schema.NonEmptyString;
+    readonly implementation: Schema.NonEmptyString;
+    readonly binding: Schema.NonEmptyString;
+    readonly input: Schema.NonEmptyString;
+    readonly expect: Schema.Struct<{
+        readonly exitCode: Schema.Int;
+        readonly stdout: Schema.optional<Schema.NonEmptyString>;
+        readonly stderr: Schema.optional<Schema.NonEmptyString>;
+    }>;
 }>;
-/** @experimental */
-export type HookCapabilities = Schema.Schema.Type<typeof HookCapabilitiesSchema>;
-/**
- * Schema for hook manifest files (hook.json).
- *
- * Hooks distribute an executable body plus agent event bindings. Install
- * materializes the body under agent_extensions and registers native agent hook
- * settings that invoke the materialized entrypoint.
- *
- * @experimental This API is unstable and may change without notice.
- */
+export type HookFixture = Schema.Schema.Type<typeof HookFixtureSchema>;
 export declare const HookManifestSchema: Schema.Struct<{
+    readonly enhances: Schema.optional<Schema.$Array<Schema.NonEmptyString>>;
+    readonly requires: Schema.optional<Schema.$Array<Schema.NonEmptyString>>;
+    readonly recommendedPacks: Schema.optional<Schema.$Array<Schema.brand<Schema.NonEmptyString, "PackSpec">>>;
+    readonly standalone: Schema.optional<Schema.Boolean>;
     readonly type: Schema.Literal<"hook">;
     readonly name: Schema.brand<Schema.NonEmptyString, "ExtensionName">;
     readonly title: Schema.optional<Schema.NonEmptyString>;
-    readonly runtime: Schema.Literals<readonly ["bash", "node", "python"]>;
-    readonly entrypoint: Schema.NonEmptyString;
-    readonly bindings: Schema.$Array<Schema.Struct<{
-        readonly on: Schema.Literals<readonly ["session.start", "prompt.submit", "turn.end", "tool.pre", "tool.post", "subagent.stop", "compaction.pre"]>;
-        readonly match: Schema.optional<Schema.Struct<{
-            readonly tools: Schema.optional<Schema.NonEmptyArray<Schema.Literals<readonly ["file.read", "file.write", "file.edit", "shell.exec", "web.fetch", "mcp.call"]>>>;
-        }>>;
-        readonly matcherRaw: Schema.optional<Schema.NonEmptyString>;
-        readonly targets: Schema.optional<Schema.$Record<Schema.String, Schema.Struct<{
-            readonly matcherRaw: Schema.optional<Schema.NonEmptyString>;
-        }>>>;
+    readonly implementations: Schema.NonEmptyArray<Schema.Struct<{
+        readonly id: Schema.NonEmptyString;
+        readonly protocol: Schema.Literals<readonly ["adal", "fx", "muse-code", "mimo-code", "coder-agents", "aider-desk", "amp", "antigravity", "antigravity-cli", "augment", "claude-code", "cline", "codearts-agent", "codebuddy", "codemaker", "codestudio", "codex", "command-code", "continue", "cortex", "crush", "cursor", "deepagents", "devin", "dexto", "droid", "firebender", "forgecode", "gemini-cli", "github-copilot-cli", "goose", "grok-cli", "hermes", "ibm-bob", "iflow-cli", "junie", "lingma", "kilo", "kimi-cli", "kiro-cli", "kode", "mcpjam", "minimax-code", "mistral-vibe", "mux", "neovate", "openclaw", "opencode", "openhands", "ona", "pi", "vscode", "pochi", "qoder", "qoder-cn", "qwen-code", "replit", "roo", "rovodev", "tabnine-cli", "trae-cn", "trae", "warp", "windsurf", "zencoder", "zed", "zenflow"]>;
         readonly requires: Schema.optional<Schema.Struct<{
-            readonly decision: Schema.Union<readonly [Schema.Struct<{
-                readonly kind: Schema.Literal<"observe">;
-            }>, Schema.Struct<{
-                readonly kind: Schema.Literal<"block">;
+            readonly hostVersion: Schema.optional<Schema.brand<Schema.NonEmptyString, "VersionRange">>;
+            readonly profiles: Schema.optional<Schema.NonEmptyArray<Schema.NonEmptyString>>;
+            readonly platforms: Schema.optional<Schema.NonEmptyArray<Schema.Literals<readonly ["darwin", "linux", "win32"]>>>;
+            readonly scopes: Schema.optional<Schema.NonEmptyArray<Schema.Literals<readonly ["project", "user"]>>>;
+        }>>;
+        readonly bindings: Schema.NonEmptyArray<Schema.Struct<{
+            readonly id: Schema.NonEmptyString;
+            readonly event: Schema.NonEmptyString;
+            readonly matcher: Schema.optional<Schema.NonEmptyString>;
+            readonly handler: Schema.Struct<{
+                readonly type: Schema.Literal<"command">;
+                readonly name: Schema.optional<Schema.NonEmptyString>;
+                readonly runtime: Schema.Literals<readonly ["bash", "node", "python"]>;
+                readonly entrypoint: Schema.NonEmptyString;
+                readonly args: Schema.optional<Schema.$Array<Schema.Union<readonly [Schema.String, Schema.Struct<{
+                    readonly config: Schema.NonEmptyString;
+                }>, Schema.Struct<{
+                    readonly env: Schema.NonEmptyString;
+                }>]>>>;
+                readonly env: Schema.optional<Schema.$Record<Schema.NonEmptyString, Schema.Union<readonly [Schema.String, Schema.Struct<{
+                    readonly config: Schema.NonEmptyString;
+                }>, Schema.Struct<{
+                    readonly env: Schema.NonEmptyString;
+                }>]>>>;
+                readonly timeoutMs: Schema.optional<Schema.Int>;
+            }>;
+            readonly requires: Schema.optional<Schema.Struct<{
                 readonly outcomes: Schema.optional<Schema.NonEmptyArray<Schema.Literals<readonly ["allow", "deny", "ask"]>>>;
-            }>, Schema.Struct<{
-                readonly kind: Schema.Literal<"modify">;
                 readonly operations: Schema.optional<Schema.NonEmptyArray<Schema.Literals<readonly ["modify-input", "inject-context", "modify-output", "synthesize", "redact"]>>>;
-            }>]>;
+            }>>;
         }>>;
     }>>;
-    readonly timeoutMs: Schema.optional<Schema.Int>;
-    readonly capabilities: Schema.optional<Schema.Struct<{
-        readonly network: Schema.optional<Schema.Boolean>;
-        readonly filesystemWrite: Schema.optional<Schema.Boolean>;
-        readonly exec: Schema.optional<Schema.$Array<Schema.NonEmptyString>>;
-        readonly env: Schema.optional<Schema.$Array<Schema.NonEmptyString>>;
-    }>>;
-    readonly enhances: Schema.optional<Schema.$Array<Schema.NonEmptyString>>;
-    readonly requires: Schema.optional<Schema.$Array<Schema.NonEmptyString>>;
-    readonly fallback: Schema.optional<Schema.Literals<readonly ["auto", "none"]>>;
-    readonly recommendedPacks: Schema.optional<Schema.$Array<Schema.brand<Schema.NonEmptyString, "PackSpec">>>;
-    readonly standalone: Schema.optional<Schema.Boolean>;
+    readonly configuration: Schema.optional<Schema.$Record<Schema.NonEmptyString, Schema.Union<readonly [Schema.Struct<{
+        readonly type: Schema.Literal<"string">;
+        readonly default: Schema.optional<Schema.String>;
+        readonly secret: Schema.optional<Schema.Boolean>;
+        readonly allowEmpty: Schema.optional<Schema.Boolean>;
+        readonly minLength: Schema.optional<Schema.Int>;
+        readonly maxLength: Schema.optional<Schema.Int>;
+        readonly description: Schema.optional<Schema.NonEmptyString>;
+        readonly required: Schema.optional<Schema.Boolean>;
+    }>, Schema.Struct<{
+        readonly type: Schema.Literal<"number">;
+        readonly default: Schema.optional<Schema.Finite>;
+        readonly minimum: Schema.optional<Schema.Finite>;
+        readonly maximum: Schema.optional<Schema.Finite>;
+        readonly description: Schema.optional<Schema.NonEmptyString>;
+        readonly required: Schema.optional<Schema.Boolean>;
+    }>, Schema.Struct<{
+        readonly type: Schema.Literal<"boolean">;
+        readonly default: Schema.optional<Schema.Boolean>;
+        readonly description: Schema.optional<Schema.NonEmptyString>;
+        readonly required: Schema.optional<Schema.Boolean>;
+    }>, Schema.Struct<{
+        readonly type: Schema.Literal<"enum">;
+        readonly values: Schema.NonEmptyArray<Schema.NonEmptyString>;
+        readonly default: Schema.optional<Schema.NonEmptyString>;
+        readonly description: Schema.optional<Schema.NonEmptyString>;
+        readonly required: Schema.optional<Schema.Boolean>;
+    }>]>>>;
+    readonly assets: Schema.optional<Schema.$Array<Schema.NonEmptyString>>;
+    readonly fixtures: Schema.optional<Schema.$Array<Schema.Struct<{
+        readonly id: Schema.NonEmptyString;
+        readonly implementation: Schema.NonEmptyString;
+        readonly binding: Schema.NonEmptyString;
+        readonly input: Schema.NonEmptyString;
+        readonly expect: Schema.Struct<{
+            readonly exitCode: Schema.Int;
+            readonly stdout: Schema.optional<Schema.NonEmptyString>;
+            readonly stderr: Schema.optional<Schema.NonEmptyString>;
+        }>;
+    }>>>;
     readonly publish: Schema.optional<Schema.Struct<{
         readonly visibility: Schema.optional<Schema.Literals<readonly ["public", "private"]>>;
         readonly ignore: Schema.optional<Schema.$Array<Schema.NonEmptyString>>;
@@ -170,6 +276,16 @@ export declare const HookManifestSchema: Schema.Struct<{
     }>>>;
     readonly $schema: Schema.optional<Schema.String>;
 }>;
-/** @experimental */
 export type HookManifest = Schema.Schema.Type<typeof HookManifestSchema>;
+/** Files required to install and activate any declared implementation. */
+export declare const requiredHookRuntimeFiles: (manifest: HookManifest) => ReadonlyArray<string>;
+/** Source-authoring closure; fixtures may be omitted from a distributed package. */
+export declare const referencedHookPackageFiles: (manifest: HookManifest) => ReadonlyArray<string>;
+export interface HookConfigurationIssue {
+    readonly key: string;
+    readonly code: "unknown" | "missing" | "invalid";
+    readonly message: string;
+}
+/** Explicit consumer values override author defaults; no source objects are mutated. */
+export declare const resolveHookConfiguration: (manifest: Pick<HookManifest, "configuration">, values?: Readonly<Record<string, unknown>>) => Result.Result<Readonly<Record<string, HookConfigurationValue>>, ReadonlyArray<HookConfigurationIssue>>;
 //# sourceMappingURL=manifest-schema.d.ts.map