@yeshwanthyk/runtime-effect 0.1.0

package/dist/extensibility/validation.js

@@ -0,0 +1,59 @@
+import { Value } from "@sinclair/typebox/value";
+import { customCommandSchema, customToolSchema, hookDescriptorSchema, } from "./schema.js";
+const formatSchemaErrorMessage = (error) => {
+    const path = error.path === "" ? "value" : error.path;
+    return `${path}: ${error.message}`;
+};
+const createIssue = (params) => {
+    const issue = {
+        kind: params.kind,
+        path: params.path,
+        message: params.message,
+        severity: params.severity ?? "error",
+    };
+    if (params.hint !== undefined) {
+        issue.hint = params.hint;
+    }
+    return issue;
+};
+export const issueFromError = (kind, path, error, options) => {
+    const message = error instanceof Error
+        ? error.message
+        : typeof error === "string"
+            ? error
+            : String(error);
+    const params = { kind, path, message, severity: options?.severity ?? "error" };
+    if (options?.hint !== undefined) {
+        params.hint = options.hint;
+    }
+    return createIssue(params);
+};
+const validateWithSchema = (schema, value, ctx) => {
+    const errors = [...Value.Errors(schema, value)];
+    return errors.map((error) => createIssue({
+        kind: ctx.kind,
+        path: ctx.path,
+        message: formatSchemaErrorMessage(error),
+        severity: ctx.severity ?? "error",
+    }));
+};
+export const validateCustomCommand = (manifest, path) => {
+    return validateWithSchema(customCommandSchema, manifest, { kind: "command", path });
+};
+export const validateCustomTool = (descriptor, path) => {
+    return validateWithSchema(customToolSchema, descriptor, { kind: "tool", path });
+};
+export const validateHookDescriptor = (descriptor) => {
+    return validateWithSchema(hookDescriptorSchema, descriptor, {
+        kind: "hook",
+        path: descriptor.path,
+        severity: "warning",
+    });
+};
+export const formatValidationIssue = (issue) => {
+    const prefix = `[${issue.severity.toUpperCase()}][${issue.kind}]`;
+    const hint = issue.hint ? `\n  hint: ${issue.hint}` : "";
+    return `${prefix} ${issue.path}: ${issue.message}${hint}`;
+};
+export const hasBlockingIssues = (issues) => issues.some((issue) => issue.severity === "error");
+//# sourceMappingURL=validation.js.map

package/dist/extensibility/validation.js.map

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

package/dist/hooks/context-controller.d.ts

@@ -0,0 +1,25 @@
+import { Context, Effect, Layer } from "effect";
+import type { Api, Model } from "@yeshwanthyk/ai";
+import type { AppendEntryHandler, DeliveryHandler, IsIdleHandler, SendHandler, SendMessageHandler, SendUserMessageHandler } from "./loader.js";
+import type { HookSessionContext, HookUIContext } from "./types.js";
+export interface HookContextHandlers {
+    sendHandler: SendHandler;
+    sendMessageHandler: SendMessageHandler;
+    sendUserMessageHandler: SendUserMessageHandler;
+    steerHandler: DeliveryHandler;
+    followUpHandler: DeliveryHandler;
+    isIdleHandler: IsIdleHandler;
+    appendEntryHandler: AppendEntryHandler;
+    getSessionId: () => string | null;
+    getModel: () => Model<Api> | null;
+    uiContext?: HookUIContext;
+    sessionContext?: HookSessionContext;
+    hasUI?: boolean;
+}
+export interface HookContextController {
+    configure(handlers: HookContextHandlers): Effect.Effect<void>;
+    configured(): Effect.Effect<boolean>;
+}
+export declare const HookContextControllerTag: Context.Tag<HookContextController, HookContextController>;
+export declare const HookContextControllerLayer: Layer.Layer<HookContextController, never, import("../instrumentation.js").InstrumentationService | import("../extensibility/index.js").ExtensibilityService>;
+//# sourceMappingURL=context-controller.d.ts.map

package/dist/hooks/context-controller.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context-controller.d.ts","sourceRoot":"","sources":["../../src/hooks/context-controller.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,EAAO,MAAM,QAAQ,CAAA;AACpD,OAAO,KAAK,EAAE,GAAG,EAAE,KAAK,EAAE,MAAM,iBAAiB,CAAA;AACjD,OAAO,KAAK,EACX,kBAAkB,EAClB,eAAe,EACf,aAAa,EACb,WAAW,EACX,kBAAkB,EAClB,sBAAsB,EACtB,MAAM,aAAa,CAAA;AACpB,OAAO,KAAK,EAAE,kBAAkB,EAAE,aAAa,EAAE,MAAM,YAAY,CAAA;AAInE,MAAM,WAAW,mBAAmB;IACnC,WAAW,EAAE,WAAW,CAAA;IACxB,kBAAkB,EAAE,kBAAkB,CAAA;IACtC,sBAAsB,EAAE,sBAAsB,CAAA;IAC9C,YAAY,EAAE,eAAe,CAAA;IAC7B,eAAe,EAAE,eAAe,CAAA;IAChC,aAAa,EAAE,aAAa,CAAA;IAC5B,kBAAkB,EAAE,kBAAkB,CAAA;IACtC,YAAY,EAAE,MAAM,MAAM,GAAG,IAAI,CAAA;IACjC,QAAQ,EAAE,MAAM,KAAK,CAAC,GAAG,CAAC,GAAG,IAAI,CAAA;IACjC,SAAS,CAAC,EAAE,aAAa,CAAA;IACzB,cAAc,CAAC,EAAE,kBAAkB,CAAA;IACnC,KAAK,CAAC,EAAE,OAAO,CAAA;CACf;AAED,MAAM,WAAW,qBAAqB;IACrC,SAAS,CAAC,QAAQ,EAAE,mBAAmB,GAAG,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAA;IAC7D,UAAU,IAAI,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAA;CACpC;AAED,eAAO,MAAM,wBAAwB,2DAAoF,CAAA;AAEzH,eAAO,MAAM,0BAA0B,8JAmBtC,CAAA"}

package/dist/hooks/context-controller.js

@@ -0,0 +1,21 @@
+import { Context, Effect, Layer, Ref } from "effect";
+import { ExtensibilityTag } from "../extensibility/index.js";
+import { InstrumentationTag } from "../instrumentation.js";
+export const HookContextControllerTag = Context.GenericTag("runtime-effect/HookContextController");
+export const HookContextControllerLayer = Layer.effect(HookContextControllerTag, Effect.gen(function* () {
+    const { hookRunner } = yield* ExtensibilityTag;
+    const instrumentation = yield* InstrumentationTag;
+    const configuredRef = yield* Ref.make(false);
+    return {
+        configure: Effect.fn(function* (handlers) {
+            hookRunner.initialize(handlers);
+            instrumentation.record({
+                type: "hook:context-configured",
+                hasUI: handlers.hasUI ?? false,
+            });
+            yield* Ref.set(configuredRef, true);
+        }),
+        configured: () => Ref.get(configuredRef),
+    };
+}));
+//# sourceMappingURL=context-controller.js.map

package/dist/hooks/context-controller.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"context-controller.js","sourceRoot":"","sources":["../../src/hooks/context-controller.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG,EAAE,MAAM,QAAQ,CAAA;AAWpD,OAAO,EAAE,gBAAgB,EAAE,MAAM,2BAA2B,CAAA;AAC5D,OAAO,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAA;AAsB1D,MAAM,CAAC,MAAM,wBAAwB,GAAG,OAAO,CAAC,UAAU,CAAwB,sCAAsC,CAAC,CAAA;AAEzH,MAAM,CAAC,MAAM,0BAA0B,GAAG,KAAK,CAAC,MAAM,CACrD,wBAAwB,EACxB,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC;IACnB,MAAM,EAAE,UAAU,EAAE,GAAG,KAAK,CAAC,CAAC,gBAAgB,CAAA;IAC9C,MAAM,eAAe,GAAG,KAAK,CAAC,CAAC,kBAAkB,CAAA;IACjD,MAAM,aAAa,GAAG,KAAK,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,CAAA;IAE3C,OAAO;QACN,SAAS,EAAE,MAAM,CAAC,EAAE,CAAC,QAAQ,CAAC,EAAE,QAA6B;YAC5D,UAAU,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAA;YAC/B,eAAe,CAAC,MAAM,CAAC;gBACtB,IAAI,EAAE,yBAAyB;gBAC/B,KAAK,EAAE,QAAQ,CAAC,KAAK,IAAI,KAAK;aAC9B,CAAC,CAAA;YACF,KAAK,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,aAAa,EAAE,IAAI,CAAC,CAAA;QACpC,CAAC,CAAC;QACF,UAAU,EAAE,GAAG,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,aAAa,CAAC;KACR,CAAA;AACnC,CAAC,CAAC,CACF,CAAA"}

package/dist/hooks/effects.d.ts

@@ -0,0 +1,25 @@
+import { Context, Effect } from "effect";
+import type { AgentRunConfig } from "@yeshwanthyk/agent-core";
+import type { Message, ImageContent } from "@yeshwanthyk/ai";
+import type { HookRunner } from "./runner.js";
+import type { BeforeAgentStartResult, ChatMessageEvent, HookEvent, ToolExecuteAfterEvent, ToolExecuteAfterResult, ToolExecuteBeforeEvent, ToolExecuteBeforeResult } from "./types.js";
+export interface HookEffects {
+    emit(event: HookEvent): Effect.Effect<void, unknown>;
+    emitBeforeAgentStart(prompt: string, images?: ImageContent[]): Effect.Effect<BeforeAgentStartResult | undefined, unknown>;
+    emitChatMessage(input: ChatMessageEvent["input"], output: ChatMessageEvent["output"]): Effect.Effect<void, unknown>;
+    emitToolExecuteBefore(event: ToolExecuteBeforeEvent): Effect.Effect<ToolExecuteBeforeResult | undefined, unknown>;
+    emitToolExecuteAfter(event: ToolExecuteAfterEvent): Effect.Effect<ToolExecuteAfterResult | undefined, unknown>;
+    emitContext(messages: Message[]): Effect.Effect<Message[], unknown>;
+    applyRunConfig(cfg: AgentRunConfig, sessionId: string | null): Effect.Effect<AgentRunConfig, unknown>;
+}
+export declare const HookEffectsTag: Context.Tag<HookEffects, HookEffects>;
+export declare const createHookEffects: (hookRunner: HookRunner) => Effect.Effect<{
+    emit: (event: HookEvent) => Effect.Effect<undefined, unknown, never>;
+    emitBeforeAgentStart: (prompt: string, images?: ImageContent[]) => Effect.Effect<BeforeAgentStartResult | undefined, unknown, never>;
+    emitChatMessage: (input: ChatMessageEvent["input"], output: ChatMessageEvent["output"]) => Effect.Effect<undefined, unknown, never>;
+    emitToolExecuteBefore: (event: ToolExecuteBeforeEvent) => Effect.Effect<ToolExecuteBeforeResult | undefined, unknown, never>;
+    emitToolExecuteAfter: (event: ToolExecuteAfterEvent) => Effect.Effect<ToolExecuteAfterResult<unknown> | undefined, unknown, never>;
+    emitContext: (messages: Message[]) => Effect.Effect<Message[], unknown, never>;
+    applyRunConfig: (cfg: AgentRunConfig, sessionId: string | null) => Effect.Effect<AgentRunConfig, unknown, never>;
+}, never, import("effect/Scope").Scope>;
+//# sourceMappingURL=effects.d.ts.map

package/dist/hooks/effects.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"effects.d.ts","sourceRoot":"","sources":["../../src/hooks/effects.ts"],"names":[],"mappings":"AAAA,OAAO,EAAW,OAAO,EAAY,MAAM,EAAuB,MAAM,QAAQ,CAAA;AAEhF,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAA;AAC7D,OAAO,KAAK,EAAE,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAA;AAC5D,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAA;AAC7C,OAAO,KAAK,EACX,sBAAsB,EACtB,gBAAgB,EAChB,SAAS,EACT,qBAAqB,EACrB,sBAAsB,EACtB,sBAAsB,EACtB,uBAAuB,EACvB,MAAM,YAAY,CAAA;AAgBnB,MAAM,WAAW,WAAW;IAC3B,IAAI,CAAC,KAAK,EAAE,SAAS,GAAG,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,OAAO,CAAC,CAAA;IACpD,oBAAoB,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,YAAY,EAAE,GAAG,MAAM,CAAC,MAAM,CAAC,sBAAsB,GAAG,SAAS,EAAE,OAAO,CAAC,CAAA;IACzH,eAAe,CAAC,KAAK,EAAE,gBAAgB,CAAC,OAAO,CAAC,EAAE,MAAM,EAAE,gBAAgB,CAAC,QAAQ,CAAC,GAAG,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,OAAO,CAAC,CAAA;IACnH,qBAAqB,CAAC,KAAK,EAAE,sBAAsB,GAAG,MAAM,CAAC,MAAM,CAAC,uBAAuB,GAAG,SAAS,EAAE,OAAO,CAAC,CAAA;IACjH,oBAAoB,CAAC,KAAK,EAAE,qBAAqB,GAAG,MAAM,CAAC,MAAM,CAAC,sBAAsB,GAAG,SAAS,EAAE,OAAO,CAAC,CAAA;IAC9G,WAAW,CAAC,QAAQ,EAAE,OAAO,EAAE,GAAG,MAAM,CAAC,MAAM,CAAC,OAAO,EAAE,EAAE,OAAO,CAAC,CAAA;IACnE,cAAc,CAAC,GAAG,EAAE,cAAc,EAAE,SAAS,EAAE,MAAM,GAAG,IAAI,GAAG,MAAM,CAAC,MAAM,CAAC,cAAc,EAAE,OAAO,CAAC,CAAA;CACrG;AAED,eAAO,MAAM,cAAc,uCAAgE,CAAA;AA+B3F,eAAO,MAAM,iBAAiB;kBAUb,SAAS;mCACQ,MAAM,WAAW,YAAY,EAAE;6BAErC,gBAAgB,CAAC,OAAO,CAAC,UAAU,gBAAgB,CAAC,QAAQ,CAAC;mCAEvD,sBAAsB;kCAGvB,qBAAqB;4BAG3B,OAAO,EAAE;0BACX,cAAc,aAAa,MAAM,GAAG,IAAI;uCAG9D,CAAA"}

package/dist/hooks/effects.js

@@ -0,0 +1,45 @@
+import { Channel, Context, Deferred, Effect, Either, Exit, Queue } from "effect";
+import { pipe } from "effect/Function";
+class HookTaskFailure extends Error {
+    _tag = "HookTaskFailure";
+    constructor(message) {
+        super(message);
+    }
+}
+export const HookEffectsTag = Context.GenericTag("runtime-effect/HookEffects");
+const createQueue = () => Queue.unbounded();
+const processTask = (task) => Effect.matchEffect(Effect.tryPromise({
+    try: task.run,
+    catch: (error) => new HookTaskFailure(error instanceof Error ? error.message : String(error)),
+}), {
+    onFailure: (error) => Deferred.fail(task.deferred, error),
+    onSuccess: (value) => Deferred.succeed(task.deferred, value),
+}).pipe((effect) => Effect.as(effect, undefined));
+const finishQueue = (queue) => pipe(queue.offer(Either.left(Exit.succeed(undefined))), (effect) => Effect.zipRight(effect, queue.shutdown));
+const enqueue = Effect.fn(function* (queue, run) {
+    const deferred = yield* Deferred.make();
+    const task = {
+        run: run,
+        deferred: deferred,
+    };
+    yield* queue.offer(Either.right(task));
+    return yield* Deferred.await(deferred);
+});
+export const createHookEffects = Effect.fn(function* (hookRunner) {
+    const queue = yield* createQueue();
+    const worker = Channel.fromQueue(queue).pipe(Channel.mapOutEffect(processTask), Channel.drain);
+    yield* Effect.addFinalizer(() => finishQueue(queue));
+    yield* Effect.forkScoped(Channel.runDrain(worker));
+    const submit = (run) => enqueue(queue, run);
+    const submitUnit = (run) => submit(run).pipe((effect) => Effect.as(effect, undefined));
+    return {
+        emit: (event) => submitUnit(() => hookRunner.emit(event)),
+        emitBeforeAgentStart: (prompt, images) => submit(() => hookRunner.emitBeforeAgentStart(prompt, images)),
+        emitChatMessage: (input, output) => submitUnit(() => hookRunner.emitChatMessage(input, output)),
+        emitToolExecuteBefore: (event) => submit(() => hookRunner.emitToolExecuteBefore(event)),
+        emitToolExecuteAfter: (event) => submit(() => hookRunner.emitToolExecuteAfter(event)),
+        emitContext: (messages) => submit(() => hookRunner.emitContext(messages)),
+        applyRunConfig: (cfg, sessionId) => submit(() => hookRunner.applyRunConfig(cfg, sessionId)),
+    };
+});
+//# sourceMappingURL=effects.js.map

package/dist/hooks/effects.js.map

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

package/dist/hooks/hook-messages.d.ts

@@ -0,0 +1,10 @@
+import type { HookMessage } from "./types.js";
+/**
+ * Create a HookMessage with current timestamp.
+ */
+export declare function createHookMessage<T = unknown>(input: Pick<HookMessage<T>, "customType" | "content" | "display" | "details">): HookMessage<T>;
+/**
+ * Extract text content from a HookMessage.
+ */
+export declare function hookMessageToText(message: HookMessage): string;
+//# sourceMappingURL=hook-messages.d.ts.map

package/dist/hooks/hook-messages.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hook-messages.d.ts","sourceRoot":"","sources":["../../src/hooks/hook-messages.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAA;AAG7C;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,CAAC,GAAG,OAAO,EAC5C,KAAK,EAAE,IAAI,CAAC,WAAW,CAAC,CAAC,CAAC,EAAE,YAAY,GAAG,SAAS,GAAG,SAAS,GAAG,SAAS,CAAC,GAC3E,WAAW,CAAC,CAAC,CAAC,CAchB;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,WAAW,GAAG,MAAM,CAM9D"}

package/dist/hooks/hook-messages.js

@@ -0,0 +1,28 @@
+/**
+ * Create a HookMessage with current timestamp.
+ */
+export function createHookMessage(input) {
+    const message = {
+        role: "hookMessage",
+        customType: input.customType,
+        content: input.content,
+        display: input.display,
+        timestamp: Date.now(),
+    };
+    if (input.details !== undefined) {
+        message.details = input.details;
+    }
+    return message;
+}
+/**
+ * Extract text content from a HookMessage.
+ */
+export function hookMessageToText(message) {
+    if (typeof message.content === "string")
+        return message.content;
+    const parts = message.content
+        .filter((part) => part.type === "text")
+        .map((part) => part.text);
+    return parts.join("\n");
+}
+//# sourceMappingURL=hook-messages.js.map

package/dist/hooks/hook-messages.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hook-messages.js","sourceRoot":"","sources":["../../src/hooks/hook-messages.ts"],"names":[],"mappings":"AAGA;;GAEG;AACH,MAAM,UAAU,iBAAiB,CAChC,KAA6E;IAE7E,MAAM,OAAO,GAAmB;QAC/B,IAAI,EAAE,aAAa;QACnB,UAAU,EAAE,KAAK,CAAC,UAAU;QAC5B,OAAO,EAAE,KAAK,CAAC,OAAO;QACtB,OAAO,EAAE,KAAK,CAAC,OAAO;QACtB,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE;KACrB,CAAA;IAED,IAAI,KAAK,CAAC,OAAO,KAAK,SAAS,EAAE,CAAC;QACjC,OAAO,CAAC,OAAO,GAAG,KAAK,CAAC,OAAO,CAAA;IAChC,CAAC;IAED,OAAO,OAAO,CAAA;AACf,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,iBAAiB,CAAC,OAAoB;IACrD,IAAI,OAAO,OAAO,CAAC,OAAO,KAAK,QAAQ;QAAE,OAAO,OAAO,CAAC,OAAO,CAAA;IAC/D,MAAM,KAAK,GAAG,OAAO,CAAC,OAAO;SAC3B,MAAM,CAAC,CAAC,IAAI,EAAuB,EAAE,CAAC,IAAI,CAAC,IAAI,KAAK,MAAM,CAAC;SAC3D,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;IAC1B,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;AACxB,CAAC"}

package/dist/hooks/hook-tool-adapter.d.ts

@@ -0,0 +1,12 @@
+import type { AgentTool } from "@yeshwanthyk/ai";
+import type { HookRunner } from "./runner.js";
+import type { RegisteredTool, HookEventContext } from "./types.js";
+/**
+ * Converts a hook-registered tool to an AgentTool.
+ */
+export declare function createHookToolAdapter(tool: RegisteredTool, getContext: () => HookEventContext): AgentTool<any, undefined>;
+/**
+ * Get all hook-registered tools as AgentTools.
+ */
+export declare function getHookTools(hookRunner: HookRunner): AgentTool[];
+//# sourceMappingURL=hook-tool-adapter.d.ts.map

package/dist/hooks/hook-tool-adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hook-tool-adapter.d.ts","sourceRoot":"","sources":["../../src/hooks/hook-tool-adapter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAe,MAAM,iBAAiB,CAAA;AAC7D,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAA;AAC7C,OAAO,KAAK,EAAE,cAAc,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAA;AAElE;;GAEG;AACH,wBAAgB,qBAAqB,CACpC,IAAI,EAAE,cAAc,EACpB,UAAU,EAAE,MAAM,gBAAgB,GAEhC,SAAS,CAAC,GAAG,EAAE,SAAS,CAAC,CA2B3B;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,UAAU,EAAE,UAAU,GAAG,SAAS,EAAE,CAIhE"}

package/dist/hooks/hook-tool-adapter.js

@@ -0,0 +1,39 @@
+/**
+ * Converts a hook-registered tool to an AgentTool.
+ */
+export function createHookToolAdapter(tool, getContext
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+) {
+    return {
+        name: tool.name,
+        label: tool.name,
+        description: tool.description,
+        parameters: {
+            type: "object",
+            properties: Object.fromEntries(Object.entries(tool.schema.properties).map(([key, prop]) => [
+                key,
+                { type: prop.type, description: prop.description, enum: prop.enum },
+            ])),
+            required: tool.schema.required ?? [],
+        },
+        async execute(_toolCallId, params, _signal, _onUpdate) {
+            try {
+                const result = await tool.execute(params, getContext());
+                const content = [{ type: "text", text: result }];
+                return { content, details: undefined };
+            }
+            catch (err) {
+                const errorText = err instanceof Error ? err.message : String(err);
+                const content = [{ type: "text", text: `Error: ${errorText}` }];
+                return { content, details: undefined };
+            }
+        },
+    };
+}
+/**
+ * Get all hook-registered tools as AgentTools.
+ */
+export function getHookTools(hookRunner) {
+    return hookRunner.getRegisteredTools().map((tool) => createHookToolAdapter(tool, () => hookRunner.getContext()));
+}
+//# sourceMappingURL=hook-tool-adapter.js.map

package/dist/hooks/hook-tool-adapter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hook-tool-adapter.js","sourceRoot":"","sources":["../../src/hooks/hook-tool-adapter.ts"],"names":[],"mappings":"AAIA;;GAEG;AACH,MAAM,UAAU,qBAAqB,CACpC,IAAoB,EACpB,UAAkC;AAClC,8DAA8D;;IAE9D,OAAO;QACN,IAAI,EAAE,IAAI,CAAC,IAAI;QACf,KAAK,EAAE,IAAI,CAAC,IAAI;QAChB,WAAW,EAAE,IAAI,CAAC,WAAW;QAC7B,UAAU,EAAE;YACX,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE,MAAM,CAAC,WAAW,CAC7B,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,EAAE,IAAI,CAAC,EAAE,EAAE,CAAC;gBAC3D,GAAG;gBACH,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,WAAW,EAAE,IAAI,CAAC,WAAW,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE;aACnE,CAAC,CACF;YACD,QAAQ,EAAE,IAAI,CAAC,MAAM,CAAC,QAAQ,IAAI,EAAE;SACpC;QACD,KAAK,CAAC,OAAO,CAAC,WAAW,EAAE,MAAM,EAAE,OAAO,EAAE,SAAS;YACpD,IAAI,CAAC;gBACJ,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,MAAiC,EAAE,UAAU,EAAE,CAAC,CAAA;gBAClF,MAAM,OAAO,GAAkB,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC,CAAA;gBAC/D,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,SAAS,EAAE,CAAA;YACvC,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACd,MAAM,SAAS,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAA;gBAClE,MAAM,OAAO,GAAkB,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,UAAU,SAAS,EAAE,EAAE,CAAC,CAAA;gBAC9E,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,SAAS,EAAE,CAAA;YACvC,CAAC;QACF,CAAC;KACD,CAAA;AACF,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,YAAY,CAAC,UAAsB;IAClD,OAAO,UAAU,CAAC,kBAAkB,EAAE,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CACnD,qBAAqB,CAAC,IAAI,EAAE,GAAG,EAAE,CAAC,UAAU,CAAC,UAAU,EAAE,CAAC,CAC1D,CAAA;AACF,CAAC"}

package/dist/hooks/hook-transport.d.ts

@@ -0,0 +1,19 @@
+import type { AgentRunConfig, AgentTransport } from "@yeshwanthyk/agent-core";
+import type { AgentEvent, Message } from "@yeshwanthyk/ai";
+import type { HookRunner } from "./runner.js";
+/**
+ * Transport wrapper that applies hook transforms before passing to inner transport.
+ * - Applies chat.messages.transform to message history
+ * - Applies chat.system.transform to system prompt
+ * - Applies chat.params to stream options
+ * - Applies auth.get for API key/headers overrides
+ * - Applies model.resolve for model routing
+ */
+export declare class HookedTransport implements AgentTransport {
+    private inner;
+    private hooks;
+    constructor(inner: AgentTransport, hooks: HookRunner);
+    run(messages: Message[], userMessage: Message, cfg: AgentRunConfig, signal?: AbortSignal): AsyncIterable<AgentEvent>;
+    continue(messages: Message[], cfg: AgentRunConfig, signal?: AbortSignal): AsyncIterable<AgentEvent>;
+}
+//# sourceMappingURL=hook-transport.d.ts.map

package/dist/hooks/hook-transport.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hook-transport.d.ts","sourceRoot":"","sources":["../../src/hooks/hook-transport.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAA;AAC7E,OAAO,KAAK,EAAE,UAAU,EAAE,OAAO,EAAE,MAAM,iBAAiB,CAAA;AAC1D,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAA;AAE7C;;;;;;;GAOG;AACH,qBAAa,eAAgB,YAAW,cAAc;IAEpD,OAAO,CAAC,KAAK;IACb,OAAO,CAAC,KAAK;gBADL,KAAK,EAAE,cAAc,EACrB,KAAK,EAAE,UAAU;IAGnB,GAAG,CACT,QAAQ,EAAE,OAAO,EAAE,EACnB,WAAW,EAAE,OAAO,EACpB,GAAG,EAAE,cAAc,EACnB,MAAM,CAAC,EAAE,WAAW,GAClB,aAAa,CAAC,UAAU,CAAC;IAOrB,QAAQ,CACd,QAAQ,EAAE,OAAO,EAAE,EACnB,GAAG,EAAE,cAAc,EACnB,MAAM,CAAC,EAAE,WAAW,GAClB,aAAa,CAAC,UAAU,CAAC;CAM5B"}

package/dist/hooks/hook-transport.js

@@ -0,0 +1,29 @@
+/**
+ * Transport wrapper that applies hook transforms before passing to inner transport.
+ * - Applies chat.messages.transform to message history
+ * - Applies chat.system.transform to system prompt
+ * - Applies chat.params to stream options
+ * - Applies auth.get for API key/headers overrides
+ * - Applies model.resolve for model routing
+ */
+export class HookedTransport {
+    inner;
+    hooks;
+    constructor(inner, hooks) {
+        this.inner = inner;
+        this.hooks = hooks;
+    }
+    async *run(messages, userMessage, cfg, signal) {
+        const sessionId = this.hooks.getSessionId();
+        const nextCfg = await this.hooks.applyRunConfig(cfg, sessionId);
+        const transformed = await this.hooks.emitContext(messages);
+        yield* this.inner.run(transformed, userMessage, nextCfg, signal);
+    }
+    async *continue(messages, cfg, signal) {
+        const sessionId = this.hooks.getSessionId();
+        const nextCfg = await this.hooks.applyRunConfig(cfg, sessionId);
+        const transformed = await this.hooks.emitContext(messages);
+        yield* this.inner.continue(transformed, nextCfg, signal);
+    }
+}
+//# sourceMappingURL=hook-transport.js.map

package/dist/hooks/hook-transport.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hook-transport.js","sourceRoot":"","sources":["../../src/hooks/hook-transport.ts"],"names":[],"mappings":"AAIA;;;;;;;GAOG;AACH,MAAM,OAAO,eAAe;IAElB;IACA;IAFT,YACS,KAAqB,EACrB,KAAiB;QADjB,UAAK,GAAL,KAAK,CAAgB;QACrB,UAAK,GAAL,KAAK,CAAY;IACvB,CAAC;IAEJ,KAAK,CAAC,CAAC,GAAG,CACT,QAAmB,EACnB,WAAoB,EACpB,GAAmB,EACnB,MAAoB;QAEpB,MAAM,SAAS,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,EAAE,CAAA;QAC3C,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,cAAc,CAAC,GAAG,EAAE,SAAS,CAAC,CAAA;QAC/D,MAAM,WAAW,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,WAAW,CAAC,QAAQ,CAAC,CAAA;QAC1D,KAAK,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,WAAW,EAAE,WAAW,EAAE,OAAO,EAAE,MAAM,CAAC,CAAA;IACjE,CAAC;IAED,KAAK,CAAC,CAAC,QAAQ,CACd,QAAmB,EACnB,GAAmB,EACnB,MAAoB;QAEpB,MAAM,SAAS,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,EAAE,CAAA;QAC3C,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,cAAc,CAAC,GAAG,EAAE,SAAS,CAAC,CAAA;QAC/D,MAAM,WAAW,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,WAAW,CAAC,QAAQ,CAAC,CAAA;QAC1D,KAAK,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,WAAW,EAAE,OAAO,EAAE,MAAM,CAAC,CAAA;IACzD,CAAC;CACD"}

package/dist/hooks/hook-ui-context.d.ts

@@ -0,0 +1,20 @@
+import type { HookUIContext } from "./types.js";
+import type { JSX } from "solid-js";
+/**
+ * Handlers for creating a HookUIContext.
+ */
+export interface HookUIHandlers {
+    setEditorText: (text: string) => void;
+    getEditorText: () => string;
+    showSelect: (title: string, options: string[]) => Promise<string | undefined>;
+    showInput: (title: string, placeholder?: string) => Promise<string | undefined>;
+    showConfirm: (title: string, message: string) => Promise<boolean>;
+    showNotify: (message: string, type?: "info" | "warning" | "error") => void;
+    showEditor?: (title: string, initialText?: string) => Promise<string | undefined>;
+    showCustom?: <T>(factory: (done: (result: T) => void) => JSX.Element) => Promise<T | undefined>;
+}
+/**
+ * Create a HookUIContext from UI handlers.
+ */
+export declare function createHookUIContext(handlers: HookUIHandlers): HookUIContext;
+//# sourceMappingURL=hook-ui-context.d.ts.map

package/dist/hooks/hook-ui-context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hook-ui-context.d.ts","sourceRoot":"","sources":["../../src/hooks/hook-ui-context.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAA;AAC/C,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,UAAU,CAAA;AAEnC;;GAEG;AACH,MAAM,WAAW,cAAc;IAC9B,aAAa,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAA;IACrC,aAAa,EAAE,MAAM,MAAM,CAAA;IAC3B,UAAU,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAAA;IAC7E,SAAS,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAAA;IAC/E,WAAW,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,CAAC,CAAA;IACjE,UAAU,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,GAAG,OAAO,KAAK,IAAI,CAAA;IAC1E,UAAU,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAAA;IACjF,UAAU,CAAC,EAAE,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,IAAI,EAAE,CAAC,MAAM,EAAE,CAAC,KAAK,IAAI,KAAK,GAAG,CAAC,OAAO,KAAK,OAAO,CAAC,CAAC,GAAG,SAAS,CAAC,CAAA;CAC/F;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,cAAc,GAAG,aAAa,CAW3E"}

package/dist/hooks/hook-ui-context.js

@@ -0,0 +1,16 @@
+/**
+ * Create a HookUIContext from UI handlers.
+ */
+export function createHookUIContext(handlers) {
+    return {
+        select: handlers.showSelect,
+        confirm: handlers.showConfirm,
+        input: handlers.showInput,
+        editor: handlers.showEditor ?? (async () => undefined),
+        notify: handlers.showNotify,
+        custom: handlers.showCustom ?? (async () => undefined),
+        setEditorText: handlers.setEditorText,
+        getEditorText: handlers.getEditorText,
+    };
+}
+//# sourceMappingURL=hook-ui-context.js.map

package/dist/hooks/hook-ui-context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hook-ui-context.js","sourceRoot":"","sources":["../../src/hooks/hook-ui-context.ts"],"names":[],"mappings":"AAiBA;;GAEG;AACH,MAAM,UAAU,mBAAmB,CAAC,QAAwB;IAC3D,OAAO;QACN,MAAM,EAAE,QAAQ,CAAC,UAAU;QAC3B,OAAO,EAAE,QAAQ,CAAC,WAAW;QAC7B,KAAK,EAAE,QAAQ,CAAC,SAAS;QACzB,MAAM,EAAE,QAAQ,CAAC,UAAU,IAAI,CAAC,KAAK,IAAI,EAAE,CAAC,SAAS,CAAC;QACtD,MAAM,EAAE,QAAQ,CAAC,UAAU;QAC3B,MAAM,EAAE,QAAQ,CAAC,UAAU,IAAI,CAAC,KAAK,IAAI,EAAE,CAAC,SAAS,CAAC;QACtD,aAAa,EAAE,QAAQ,CAAC,aAAa;QACrC,aAAa,EAAE,QAAQ,CAAC,aAAa;KACrC,CAAA;AACF,CAAC"}

package/dist/hooks/index.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Hook system for Marvin coding agent.
+ *
+ * Hooks are TypeScript modules that subscribe to agent lifecycle events.
+ * Load from ~/.config/marvin/hooks/*.ts
+ */
+export * from "./types.js";
+export { loadHooks, type LoadedHook, type LoadHooksResult, type SendHandler, type SendMessageHandler, type SendUserMessageHandler, type DeliveryHandler, type IsIdleHandler, type AppendEntryHandler, } from "./loader.js";
+export { HookRunner, createEmptyRunner, type HookErrorListener } from "./runner.js";
+export { wrapToolWithHooks, wrapToolsWithHooks } from "./tool-wrapper.js";
+export { createHookMessage, hookMessageToText } from "./hook-messages.js";
+export { transformMessages } from "./message-transformer.js";
+export { HookedTransport } from "./hook-transport.js";
+export { createHookToolAdapter, getHookTools } from "./hook-tool-adapter.js";
+export { createHookUIContext, type HookUIHandlers } from "./hook-ui-context.js";
+export { HookContextControllerLayer, HookContextControllerTag, type HookContextController, type HookContextHandlers, } from "./context-controller.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/hooks/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/hooks/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,cAAc,YAAY,CAAA;AAG1B,OAAO,EACN,SAAS,EACT,KAAK,UAAU,EACf,KAAK,eAAe,EACpB,KAAK,WAAW,EAChB,KAAK,kBAAkB,EACvB,KAAK,sBAAsB,EAC3B,KAAK,eAAe,EACpB,KAAK,aAAa,EAClB,KAAK,kBAAkB,GACvB,MAAM,aAAa,CAAA;AAGpB,OAAO,EAAE,UAAU,EAAE,iBAAiB,EAAE,KAAK,iBAAiB,EAAE,MAAM,aAAa,CAAA;AAGnF,OAAO,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAA;AAGzE,OAAO,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAA;AAGzE,OAAO,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAA;AAG5D,OAAO,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAA;AAGrD,OAAO,EAAE,qBAAqB,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAA;AAG5E,OAAO,EAAE,mBAAmB,EAAE,KAAK,cAAc,EAAE,MAAM,sBAAsB,CAAA;AAG/E,OAAO,EACN,0BAA0B,EAC1B,wBAAwB,EACxB,KAAK,qBAAqB,EAC1B,KAAK,mBAAmB,GACxB,MAAM,yBAAyB,CAAA"}

package/dist/hooks/index.js

@@ -0,0 +1,27 @@
+/**
+ * Hook system for Marvin coding agent.
+ *
+ * Hooks are TypeScript modules that subscribe to agent lifecycle events.
+ * Load from ~/.config/marvin/hooks/*.ts
+ */
+// Re-export all types for hook authors
+export * from "./types.js";
+// Loader
+export { loadHooks, } from "./loader.js";
+// Runner
+export { HookRunner, createEmptyRunner } from "./runner.js";
+// Tool wrapping
+export { wrapToolWithHooks, wrapToolsWithHooks } from "./tool-wrapper.js";
+// Hook message utilities
+export { createHookMessage, hookMessageToText } from "./hook-messages.js";
+// Message transformer
+export { transformMessages } from "./message-transformer.js";
+// Hook transport wrapper
+export { HookedTransport } from "./hook-transport.js";
+// Hook tool adapter
+export { createHookToolAdapter, getHookTools } from "./hook-tool-adapter.js";
+// Hook UI context
+export { createHookUIContext } from "./hook-ui-context.js";
+// Hook context controller
+export { HookContextControllerLayer, HookContextControllerTag, } from "./context-controller.js";
+//# sourceMappingURL=index.js.map

package/dist/hooks/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/hooks/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,uCAAuC;AACvC,cAAc,YAAY,CAAA;AAE1B,SAAS;AACT,OAAO,EACN,SAAS,GAST,MAAM,aAAa,CAAA;AAEpB,SAAS;AACT,OAAO,EAAE,UAAU,EAAE,iBAAiB,EAA0B,MAAM,aAAa,CAAA;AAEnF,gBAAgB;AAChB,OAAO,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAA;AAEzE,yBAAyB;AACzB,OAAO,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAA;AAEzE,sBAAsB;AACtB,OAAO,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAA;AAE5D,yBAAyB;AACzB,OAAO,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAA;AAErD,oBAAoB;AACpB,OAAO,EAAE,qBAAqB,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAA;AAE5E,kBAAkB;AAClB,OAAO,EAAE,mBAAmB,EAAuB,MAAM,sBAAsB,CAAA;AAE/E,0BAA0B;AAC1B,OAAO,EACN,0BAA0B,EAC1B,wBAAwB,GAGxB,MAAM,yBAAyB,CAAA"}

package/dist/hooks/loader.d.ts

@@ -0,0 +1,59 @@
+/**
+ * Hook loader - discovers and loads TypeScript hook modules.
+ *
+ * Hooks are loaded from ~/.config/marvin/hooks/*.ts (non-recursive).
+ * Uses Bun's native import() which handles TypeScript directly.
+ */
+import type { HookEventType, HookMessage, HookMessageRenderer, RegisteredCommand, RegisteredTool } from "./types.js";
+import type { ValidationIssue } from "../extensibility/schema.js";
+import type { PromptDeliveryMode } from "../session/prompt-queue.js";
+/** Generic handler function type for internal storage */
+type HandlerFn = (event: any, ctx: any) => Promise<unknown> | unknown;
+/** Send handler type for marvin.send() */
+export type SendHandler = (text: string) => void;
+/** Send message handler type for marvin.sendMessage() */
+export type SendMessageHandler = <T = unknown>(message: Pick<HookMessage<T>, "customType" | "content" | "display" | "details">, triggerTurn?: boolean) => void;
+export type SendUserMessageHandler = (text: string, options?: {
+    deliverAs?: PromptDeliveryMode;
+}) => Promise<void> | void;
+export type DeliveryHandler = (text: string) => Promise<void> | void;
+export type IsIdleHandler = () => boolean;
+/** Append entry handler type for marvin.appendEntry() */
+export type AppendEntryHandler = <T = unknown>(customType: string, data?: T) => void;
+/** Registered handlers for a loaded hook */
+export interface LoadedHook {
+    /** Original file path */
+    path: string;
+    /** Map of event type to handler functions */
+    handlers: Map<HookEventType, HandlerFn[]>;
+    /** Map of custom type to message renderer */
+    messageRenderers: Map<string, HookMessageRenderer>;
+    /** Map of command name to registered command */
+    commands: Map<string, RegisteredCommand>;
+    /** Map of tool name to registered tool */
+    tools: Map<string, RegisteredTool>;
+    /** Set the send handler for this hook's marvin.send() */
+    setSendHandler: (handler: SendHandler) => void;
+    /** Set the sendMessage handler for this hook's marvin.sendMessage() */
+    setSendMessageHandler: (handler: SendMessageHandler) => void;
+    setSendUserMessageHandler: (handler: SendUserMessageHandler) => void;
+    setSteerHandler: (handler: DeliveryHandler) => void;
+    setFollowUpHandler: (handler: DeliveryHandler) => void;
+    setIsIdleHandler: (handler: IsIdleHandler) => void;
+    /** Set the appendEntry handler for this hook's marvin.appendEntry() */
+    setAppendEntryHandler: (handler: AppendEntryHandler) => void;
+}
+/** Result of loading hooks */
+export interface LoadHooksResult {
+    hooks: LoadedHook[];
+    issues: ValidationIssue[];
+}
+/**
+ * Discover and load hooks from the config directory.
+ * Loads from ~/.config/marvin/hooks/*.ts
+ *
+ * @param configDir - Base config directory (e.g., ~/.config/marvin)
+ */
+export declare function loadHooks(configDir: string): Promise<LoadHooksResult>;
+export {};
+//# sourceMappingURL=loader.d.ts.map

package/dist/hooks/loader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"loader.d.ts","sourceRoot":"","sources":["../../src/hooks/loader.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAKH,OAAO,KAAK,EAEX,aAAa,EAEb,WAAW,EACX,mBAAmB,EACnB,iBAAiB,EACjB,cAAc,EACd,MAAM,YAAY,CAAA;AACnB,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAA;AAEjE,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,4BAA4B,CAAA;AAEpE,yDAAyD;AAEzD,KAAK,SAAS,GAAG,CAAC,KAAK,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,KAAK,OAAO,CAAC,OAAO,CAAC,GAAG,OAAO,CAAA;AAErE,0CAA0C;AAC1C,MAAM,MAAM,WAAW,GAAG,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAA;AAEhD,yDAAyD;AACzD,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,GAAG,OAAO,EAC5C,OAAO,EAAE,IAAI,CAAC,WAAW,CAAC,CAAC,CAAC,EAAE,YAAY,GAAG,SAAS,GAAG,SAAS,GAAG,SAAS,CAAC,EAC/E,WAAW,CAAC,EAAE,OAAO,KACjB,IAAI,CAAA;AAET,MAAM,MAAM,sBAAsB,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;IAAE,SAAS,CAAC,EAAE,kBAAkB,CAAA;CAAE,KAAK,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAA;AACzH,MAAM,MAAM,eAAe,GAAG,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAA;AACpE,MAAM,MAAM,aAAa,GAAG,MAAM,OAAO,CAAA;AAEzC,yDAAyD;AACzD,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,GAAG,OAAO,EAAE,UAAU,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,CAAC,KAAK,IAAI,CAAA;AAEpF,4CAA4C;AAC5C,MAAM,WAAW,UAAU;IAC1B,yBAAyB;IACzB,IAAI,EAAE,MAAM,CAAA;IACZ,6CAA6C;IAC7C,QAAQ,EAAE,GAAG,CAAC,aAAa,EAAE,SAAS,EAAE,CAAC,CAAA;IACzC,6CAA6C;IAC7C,gBAAgB,EAAE,GAAG,CAAC,MAAM,EAAE,mBAAmB,CAAC,CAAA;IAClD,gDAAgD;IAChD,QAAQ,EAAE,GAAG,CAAC,MAAM,EAAE,iBAAiB,CAAC,CAAA;IACxC,0CAA0C;IAC1C,KAAK,EAAE,GAAG,CAAC,MAAM,EAAE,cAAc,CAAC,CAAA;IAClC,yDAAyD;IACzD,cAAc,EAAE,CAAC,OAAO,EAAE,WAAW,KAAK,IAAI,CAAA;IAC9C,uEAAuE;IACvE,qBAAqB,EAAE,CAAC,OAAO,EAAE,kBAAkB,KAAK,IAAI,CAAA;IAC5D,yBAAyB,EAAE,CAAC,OAAO,EAAE,sBAAsB,KAAK,IAAI,CAAA;IACpE,eAAe,EAAE,CAAC,OAAO,EAAE,eAAe,KAAK,IAAI,CAAA;IACnD,kBAAkB,EAAE,CAAC,OAAO,EAAE,eAAe,KAAK,IAAI,CAAA;IACtD,gBAAgB,EAAE,CAAC,OAAO,EAAE,aAAa,KAAK,IAAI,CAAA;IAClD,uEAAuE;IACvE,qBAAqB,EAAE,CAAC,OAAO,EAAE,kBAAkB,KAAK,IAAI,CAAA;CAC5D;AAED,8BAA8B;AAC9B,MAAM,WAAW,eAAe;IAC/B,KAAK,EAAE,UAAU,EAAE,CAAA;IACnB,MAAM,EAAE,eAAe,EAAE,CAAA;CACzB;AA8JD;;;;;GAKG;AACH,wBAAsB,SAAS,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,CAAC,CA2B3E"}