@yeshwanthyk/runtime-effect 0.1.0

package/dist/hooks/types.d.ts

@@ -0,0 +1,431 @@
+/**
+ * Hook system types.
+ *
+ * Hooks are TypeScript modules that subscribe to agent lifecycle events.
+ * Load from ~/.config/marvin/hooks/*.ts
+ */
+import type { AppMessage } from "@yeshwanthyk/agent-core";
+import type { Api, ImageContent, Message, Model, SimpleStreamOptions, TextContent, ToolResultMessage } from "@yeshwanthyk/ai";
+import type { JSX } from "solid-js";
+import type { ReadonlySessionManager } from "../session-manager.js";
+import type { PromptDeliveryMode } from "../session/prompt-queue.js";
+export interface HookTheme {
+    name?: string;
+    mode?: string;
+    readonly [key: string]: unknown;
+}
+/** Result of executing a command via ctx.exec() */
+export interface ExecResult {
+    stdout: string;
+    stderr: string;
+    code: number;
+    killed?: boolean;
+}
+export interface ExecOptions {
+    signal?: AbortSignal;
+    timeout?: number;
+}
+/** Context passed to hook event handlers */
+export interface HookEventContext {
+    /** Execute a shell command */
+    exec(command: string, args: string[], options?: ExecOptions): Promise<ExecResult>;
+    /** Current working directory */
+    cwd: string;
+    /** Config directory (~/.config/marvin) */
+    configDir: string;
+    /** Current session ID (null if no session) */
+    sessionId: string | null;
+    /** Read-only session manager for accessing session data */
+    sessionManager: ReadonlySessionManager;
+    /** Current model (null if not set) */
+    model: Model<Api> | null;
+    /** UI context for prompts/notifications */
+    ui: HookUIContext;
+    /** Whether UI is available (false in headless/ACP) */
+    hasUI: boolean;
+    /** Session operations (summarize, toast, etc.) */
+    session: HookSessionContext;
+    /** Delivery-aware helpers */
+    isIdle(): boolean;
+    steer(text: string): Promise<void>;
+    followUp(text: string): Promise<void>;
+    sendUserMessage(text: string, options?: {
+        deliverAs?: PromptDeliveryMode;
+    }): Promise<void>;
+}
+/** UI context for hook prompts and notifications */
+export interface HookUIContext {
+    select(title: string, options: string[]): Promise<string | undefined>;
+    confirm(title: string, message: string): Promise<boolean>;
+    input(title: string, placeholder?: string): Promise<string | undefined>;
+    editor(title: string, initialText?: string): Promise<string | undefined>;
+    notify(message: string, type?: "info" | "warning" | "error"): void;
+    custom<T>(factory: (done: (result: T) => void) => JSX.Element): Promise<T | undefined>;
+    setEditorText(text: string): void;
+    getEditorText(): string;
+}
+/** Token usage stats */
+export interface TokenUsage {
+    input: number;
+    output: number;
+    cacheRead?: number;
+    cacheWrite?: number;
+    total: number;
+}
+/** Result from an LLM completion */
+export interface CompletionResult {
+    text: string;
+    stopReason: "end" | "tool_use" | "max_tokens" | "aborted" | "error";
+}
+/** Session operations available to hooks */
+export interface HookSessionContext {
+    /** Trigger session compaction/summarization */
+    summarize(): Promise<void>;
+    /** Show toast notification (TUI only, no-op in headless) */
+    toast(title: string, message: string, variant?: "info" | "warning" | "success" | "error"): void;
+    /** Get current token usage for the session */
+    getTokenUsage(): TokenUsage | undefined;
+    /** Get model context limit */
+    getContextLimit(): number | undefined;
+    /** Create a new session, optionally linking to parent */
+    newSession(opts?: {
+        parentSession?: string;
+    }): Promise<{
+        cancelled: boolean;
+        sessionId?: string;
+    }>;
+    /** Get API key for a model's provider (may not work for OAuth) */
+    getApiKey(model: Model<Api>): Promise<string | undefined>;
+    /** Make an LLM completion using the app's transport (handles OAuth, etc.) */
+    complete(systemPrompt: string, userText: string): Promise<CompletionResult>;
+}
+/** Message part (text or image) */
+export type MessagePart = TextContent | ImageContent;
+/** Hook-injected message */
+export interface HookMessage<T = unknown> {
+    role: "hookMessage";
+    customType: string;
+    content: string | MessagePart[];
+    display: boolean;
+    details?: T;
+    timestamp: number;
+}
+/** Registered slash command from a hook */
+export interface RegisteredCommand {
+    name: string;
+    description?: string;
+    handler: (args: string, ctx: HookEventContext) => Promise<void>;
+}
+/** Renderer for hook messages */
+export type HookMessageRenderer<T = unknown> = (message: HookMessage<T>, options: {
+    expanded: boolean;
+}, theme: HookTheme) => JSX.Element | undefined;
+/** Schema for hook-registered tool */
+export interface HookToolSchema {
+    type: "object";
+    properties: Record<string, {
+        type: "string" | "number" | "boolean" | "array" | "object";
+        description?: string;
+        enum?: string[];
+        optional?: boolean;
+    }>;
+    required?: string[];
+}
+/** Tool registered by a hook */
+export interface RegisteredTool {
+    name: string;
+    description: string;
+    schema: HookToolSchema;
+    execute: (args: Record<string, unknown>, ctx: HookEventContext) => Promise<string>;
+}
+/** Fired after config load, before agent starts */
+export interface AppStartEvent {
+    type: "app.start";
+}
+/** Fired when session starts/resumes/clears */
+export interface SessionEvent {
+    type: "session.start" | "session.resume" | "session.clear";
+    sessionId: string | null;
+}
+/** Fired when agent loop starts (once per user prompt) */
+export interface AgentStartEvent {
+    type: "agent.start";
+    sessionId: string | null;
+}
+/** Fired when agent loop ends */
+export interface AgentEndEvent {
+    type: "agent.end";
+    sessionId: string | null;
+    messages: AppMessage[];
+    totalTokens: TokenUsage;
+    contextLimit: number;
+}
+/** Fired when a turn starts (one LLM call cycle) */
+export interface TurnStartEvent {
+    type: "turn.start";
+    sessionId: string | null;
+    turnIndex: number;
+}
+/** Context usage info for hooks */
+export interface ContextUsage {
+    /** Current token count */
+    current: number;
+    /** Max context window */
+    max: number;
+    /** Usage percentage (0-100) */
+    percent: number;
+}
+/** Fired when a turn ends */
+export interface TurnEndEvent {
+    type: "turn.end";
+    sessionId: string | null;
+    turnIndex: number;
+    message: AppMessage;
+    toolResults: ToolResultMessage[];
+    tokens: TokenUsage;
+    contextLimit: number;
+    /** @deprecated Use tokens and contextLimit instead */
+    usage?: ContextUsage;
+}
+/** Fired before a tool executes. Hooks can block or modify input. */
+export interface ToolExecuteBeforeEvent {
+    type: "tool.execute.before";
+    sessionId: string | null;
+    toolName: string;
+    toolCallId: string;
+    input: Record<string, unknown>;
+}
+/** Fired after a tool executes. Hooks can modify result. */
+export interface ToolExecuteAfterEvent<TDetails = unknown> {
+    type: "tool.execute.after";
+    sessionId: string | null;
+    toolName: string;
+    toolCallId: string;
+    input: Record<string, unknown>;
+    content: (TextContent | ImageContent)[];
+    details: TDetails;
+    isError: boolean;
+}
+/** Fired before agent starts, allows injecting context */
+export interface BeforeAgentStartEvent {
+    type: "agent.before_start";
+    prompt: string;
+    images?: ImageContent[];
+}
+/** Result from agent.before_start handler */
+export interface BeforeAgentStartResult {
+    message?: Pick<HookMessage, "customType" | "content" | "display" | "details">;
+}
+/** Mutates user input before sending to LLM */
+export interface ChatMessageEvent {
+    type: "chat.message";
+    input: {
+        sessionId: string | null;
+        text: string;
+    };
+    output: {
+        parts: MessagePart[];
+    };
+}
+/** Transforms full message history before LLM call */
+export interface ChatMessagesTransformEvent {
+    type: "chat.messages.transform";
+    messages: Message[];
+}
+/** Transforms system prompt before LLM call */
+export interface ChatSystemTransformEvent {
+    type: "chat.system.transform";
+    input: {
+        sessionId: string | null;
+        systemPrompt: string;
+    };
+    output: {
+        systemPrompt: string;
+    };
+}
+/** Mutates stream options before LLM call */
+export interface ChatParamsEvent {
+    type: "chat.params";
+    input: {
+        sessionId: string | null;
+    };
+    output: {
+        streamOptions: SimpleStreamOptions;
+    };
+}
+/** Provides auth overrides per request */
+export interface AuthGetEvent {
+    type: "auth.get";
+    input: {
+        sessionId: string | null;
+        provider: string;
+        modelId: string;
+    };
+    output: {
+        apiKey?: string;
+        headers?: Record<string, string>;
+        baseUrl?: string;
+    };
+}
+/** Resolves/overrides model for request */
+export interface ModelResolveEvent {
+    type: "model.resolve";
+    input: {
+        sessionId: string | null;
+        model: Model<Api>;
+    };
+    output: {
+        model: Model<Api>;
+    };
+}
+/** Fired before session compaction */
+export interface SessionBeforeCompactEvent {
+    type: "session.before_compact";
+    input: {
+        sessionId: string | null;
+    };
+    output: {
+        cancel?: boolean;
+        prompt?: string;
+        context?: string[];
+    };
+}
+/** Fired after session compaction completes */
+export interface SessionCompactEvent {
+    type: "session.compact";
+    sessionId: string | null;
+    summary: string;
+}
+/** Fired when session/app is shutting down */
+export interface SessionShutdownEvent {
+    type: "session.shutdown";
+    sessionId: string | null;
+}
+/** Union of all hook event types */
+export type HookEvent = AppStartEvent | SessionEvent | SessionBeforeCompactEvent | SessionCompactEvent | SessionShutdownEvent | BeforeAgentStartEvent | AgentStartEvent | AgentEndEvent | TurnStartEvent | TurnEndEvent | ToolExecuteBeforeEvent | ToolExecuteAfterEvent | ChatMessageEvent | ChatMessagesTransformEvent | ChatSystemTransformEvent | ChatParamsEvent | AuthGetEvent | ModelResolveEvent;
+/** Return type for tool.execute.before handlers - can block execution or modify input */
+export interface ToolExecuteBeforeResult {
+    block?: boolean;
+    reason?: string;
+    /** Modified input to use instead of original */
+    input?: Record<string, unknown>;
+}
+/** Return type for tool.execute.after handlers - can modify result */
+export interface ToolExecuteAfterResult<TDetails = unknown> {
+    content?: (TextContent | ImageContent)[];
+    details?: TDetails;
+    isError?: boolean;
+}
+/** Handler function type */
+export type HookHandler<E, R = void> = (event: E, ctx: HookEventContext) => Promise<R> | R;
+/** Event type string literals */
+export type HookEventType = HookEvent["type"];
+/** Map event type to event data */
+export interface HookEventMap {
+    "app.start": AppStartEvent;
+    "session.start": SessionEvent;
+    "session.resume": SessionEvent;
+    "session.clear": SessionEvent;
+    "session.before_compact": SessionBeforeCompactEvent;
+    "session.compact": SessionCompactEvent;
+    "session.shutdown": SessionShutdownEvent;
+    "agent.before_start": BeforeAgentStartEvent;
+    "agent.start": AgentStartEvent;
+    "agent.end": AgentEndEvent;
+    "turn.start": TurnStartEvent;
+    "turn.end": TurnEndEvent;
+    "tool.execute.before": ToolExecuteBeforeEvent;
+    "tool.execute.after": ToolExecuteAfterEvent;
+    "chat.message": ChatMessageEvent;
+    "chat.messages.transform": ChatMessagesTransformEvent;
+    "chat.system.transform": ChatSystemTransformEvent;
+    "chat.params": ChatParamsEvent;
+    "auth.get": AuthGetEvent;
+    "model.resolve": ModelResolveEvent;
+}
+/** Map event type to result type */
+export interface HookResultMap {
+    "app.start": void;
+    "session.start": void;
+    "session.resume": void;
+    "session.clear": void;
+    "session.before_compact": void;
+    "session.compact": void;
+    "session.shutdown": void;
+    "agent.before_start": BeforeAgentStartResult | undefined;
+    "agent.start": void;
+    "agent.end": void;
+    "turn.start": void;
+    "turn.end": void;
+    "tool.execute.before": ToolExecuteBeforeResult | undefined;
+    "tool.execute.after": ToolExecuteAfterResult | undefined;
+    "chat.message": void;
+    "chat.messages.transform": void;
+    "chat.system.transform": void;
+    "chat.params": void;
+    "auth.get": void;
+    "model.resolve": void;
+}
+/**
+ * HookAPI passed to hook factory functions.
+ * Hooks use marvin.on() to subscribe to events and marvin.send() to inject messages.
+ */
+export interface HookAPI {
+    on<T extends HookEventType>(event: T, handler: HookHandler<HookEventMap[T], HookResultMap[T]>): void;
+    /**
+     * Send a message to the agent.
+     * If agent is streaming, message is queued.
+     * If agent is idle, triggers a new agent loop.
+     */
+    send(text: string): void;
+    /**
+     * Send a user message with explicit delivery mode.
+     * Defaults to follow-up when agent is busy, otherwise triggers a new turn.
+     */
+    sendUserMessage(text: string, options?: {
+        deliverAs?: PromptDeliveryMode;
+    }): Promise<void>;
+    /** Queue steering instructions or send immediately if idle. */
+    steer(text: string): Promise<void>;
+    /** Queue follow-up instructions or send immediately if idle. */
+    followUp(text: string): Promise<void>;
+    /** True when the agent is not currently streaming or running tools. */
+    isIdle(): boolean;
+    /**
+     * Send a hook message to the agent.
+     * Message is persisted and optionally triggers a new turn.
+     */
+    sendMessage<T = unknown>(message: Pick<HookMessage<T>, "customType" | "content" | "display" | "details">, triggerTurn?: boolean): void;
+    /**
+     * Append a custom entry to the session log.
+     * Does not affect agent state, only persists data.
+     */
+    appendEntry<T = unknown>(customType: string, data?: T): void;
+    /**
+     * Register a custom renderer for hook messages of a given type.
+     */
+    registerMessageRenderer<T = unknown>(customType: string, renderer: HookMessageRenderer<T>): void;
+    /**
+     * Register a slash command.
+     */
+    registerCommand(name: string, options: {
+        description?: string;
+        handler: RegisteredCommand["handler"];
+    }): void;
+    /**
+     * Register a tool that will be available to the agent.
+     */
+    registerTool(tool: RegisteredTool): void;
+}
+/**
+ * Hook factory function type.
+ * Hooks export a default function that receives the HookAPI.
+ */
+export type HookFactory = (marvin: HookAPI) => void | Promise<void>;
+/** Error emitted when a hook fails */
+export interface HookError {
+    hookPath: string;
+    event: string;
+    error: string;
+}
+//# sourceMappingURL=types.d.ts.map

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

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

package/dist/hooks/types.js

@@ -0,0 +1,8 @@
+/**
+ * Hook system types.
+ *
+ * Hooks are TypeScript modules that subscribe to agent lifecycle events.
+ * Load from ~/.config/marvin/hooks/*.ts
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/hooks/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/hooks/types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG"}

package/dist/index.d.ts

@@ -0,0 +1,17 @@
+export * from "./config.js";
+export * from "./session-manager.js";
+export * from "./transports.js";
+export * from "./tools.js";
+export * from "./agent.js";
+export * from "./extensibility/index.js";
+export * from "./extensibility/custom-commands.js";
+export * from "./extensibility/schema.js";
+export * from "./extensibility/validation.js";
+export * from "./hooks/index.js";
+export * from "./lazy-tool-loader.js";
+export * from "./session/prompt-queue.js";
+export * from "./session/execution-plan.js";
+export * from "./session/orchestrator.js";
+export * from "./instrumentation.js";
+export * from "./runtime.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAC;AAC5B,cAAc,sBAAsB,CAAC;AACrC,cAAc,iBAAiB,CAAC;AAChC,cAAc,YAAY,CAAC;AAC3B,cAAc,YAAY,CAAC;AAC3B,cAAc,0BAA0B,CAAC;AACzC,cAAc,oCAAoC,CAAC;AACnD,cAAc,2BAA2B,CAAC;AAC1C,cAAc,+BAA+B,CAAC;AAC9C,cAAc,kBAAkB,CAAC;AACjC,cAAc,uBAAuB,CAAC;AACtC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,6BAA6B,CAAC;AAC5C,cAAc,2BAA2B,CAAC;AAC1C,cAAc,sBAAsB,CAAC;AACrC,cAAc,cAAc,CAAC"}

package/dist/index.js

@@ -0,0 +1,17 @@
+export * from "./config.js";
+export * from "./session-manager.js";
+export * from "./transports.js";
+export * from "./tools.js";
+export * from "./agent.js";
+export * from "./extensibility/index.js";
+export * from "./extensibility/custom-commands.js";
+export * from "./extensibility/schema.js";
+export * from "./extensibility/validation.js";
+export * from "./hooks/index.js";
+export * from "./lazy-tool-loader.js";
+export * from "./session/prompt-queue.js";
+export * from "./session/execution-plan.js";
+export * from "./session/orchestrator.js";
+export * from "./instrumentation.js";
+export * from "./runtime.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAC;AAC5B,cAAc,sBAAsB,CAAC;AACrC,cAAc,iBAAiB,CAAC;AAChC,cAAc,YAAY,CAAC;AAC3B,cAAc,YAAY,CAAC;AAC3B,cAAc,0BAA0B,CAAC;AACzC,cAAc,oCAAoC,CAAC;AACnD,cAAc,2BAA2B,CAAC;AAC1C,cAAc,+BAA+B,CAAC;AAC9C,cAAc,kBAAkB,CAAC;AACjC,cAAc,uBAAuB,CAAC;AACtC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,6BAA6B,CAAC;AAC5C,cAAc,2BAA2B,CAAC;AAC1C,cAAc,sBAAsB,CAAC;AACrC,cAAc,cAAc,CAAC"}

package/dist/instrumentation.d.ts

@@ -0,0 +1,56 @@
+import { Context, Layer } from "effect";
+import type { ValidationIssue } from "./extensibility/schema.js";
+export type InstrumentationEvent = {
+    type: "hook:error";
+    hookPath: string;
+    event: string;
+    error: string;
+} | {
+    type: "hook:context-configured";
+    hasUI: boolean;
+} | {
+    type: "extensibility:validation-issue";
+    issue: ValidationIssue;
+} | {
+    type: "extensibility:loaded";
+    hooks: number;
+    customTools: number;
+    customCommands?: number;
+} | {
+    type: "extensibility:commands-loaded";
+    count: number;
+    names: string[];
+} | {
+    type: "extensibility:custom-tools-loaded";
+    count: number;
+    entries: Array<{
+        name: string;
+        path: string;
+    }>;
+} | {
+    type: "lsp:activity";
+    active: boolean;
+} | {
+    type: "execution-plan:registered";
+    steps: Array<{
+        id: string;
+        provider: string;
+        modelId: string;
+        attempts: number;
+        isFallback: boolean;
+    }>;
+} | {
+    type: "tmux:log";
+    level: "info" | "warn" | "error";
+    message: string;
+    details?: Record<string, unknown>;
+};
+export interface InstrumentationService {
+    record: (event: InstrumentationEvent) => void;
+}
+export declare const InstrumentationTag: Context.Tag<InstrumentationService, InstrumentationService>;
+export declare const NoopInstrumentationLayer: Layer.Layer<InstrumentationService, never, never>;
+export declare const ConsoleInstrumentationLayer: (options?: {
+    prefix?: string;
+}) => Layer.Layer<InstrumentationService, never, never>;
+//# sourceMappingURL=instrumentation.d.ts.map

package/dist/instrumentation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"instrumentation.d.ts","sourceRoot":"","sources":["../src/instrumentation.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,QAAQ,CAAA;AACvC,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAA;AAEhE,MAAM,MAAM,oBAAoB,GAC7B;IAAE,IAAI,EAAE,YAAY,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GACtE;IAAE,IAAI,EAAE,yBAAyB,CAAC;IAAC,KAAK,EAAE,OAAO,CAAA;CAAE,GACnD;IAAE,IAAI,EAAE,gCAAgC,CAAC;IAAC,KAAK,EAAE,eAAe,CAAA;CAAE,GAClE;IAAE,IAAI,EAAE,sBAAsB,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,MAAM,CAAC;IAAC,cAAc,CAAC,EAAE,MAAM,CAAA;CAAE,GAC7F;IAAE,IAAI,EAAE,+BAA+B,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,EAAE,CAAA;CAAE,GACzE;IACA,IAAI,EAAE,mCAAmC,CAAA;IACzC,KAAK,EAAE,MAAM,CAAA;IACb,OAAO,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAA;CAC7C,GACD;IAAE,IAAI,EAAE,cAAc,CAAC;IAAC,MAAM,EAAE,OAAO,CAAA;CAAE,GACzC;IACA,IAAI,EAAE,2BAA2B,CAAA;IACjC,KAAK,EAAE,KAAK,CAAC;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,OAAO,CAAA;KAAE,CAAC,CAAA;CACrG,GACD;IAAE,IAAI,EAAE,UAAU,CAAC;IAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CAAE,CAAA;AAE7G,MAAM,WAAW,sBAAsB;IACtC,MAAM,EAAE,CAAC,KAAK,EAAE,oBAAoB,KAAK,IAAI,CAAA;CAC7C;AAED,eAAO,MAAM,kBAAkB,6DAAsF,CAAA;AAErH,eAAO,MAAM,wBAAwB,mDAEnC,CAAA;AAEF,eAAO,MAAM,2BAA2B,GAAI,UAAU;IAAE,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,sDAOtE,CAAA"}

package/dist/instrumentation.js

@@ -0,0 +1,13 @@
+import { Context, Layer } from "effect";
+export const InstrumentationTag = Context.GenericTag("runtime-effect/InstrumentationService");
+export const NoopInstrumentationLayer = Layer.succeed(InstrumentationTag, {
+    record: () => { },
+});
+export const ConsoleInstrumentationLayer = (options) => Layer.succeed(InstrumentationTag, {
+    record: (event) => {
+        const prefix = options?.prefix ?? "[runtime]";
+        // eslint-disable-next-line no-console
+        console.error(`${prefix} ${event.type}`, event);
+    },
+});
+//# sourceMappingURL=instrumentation.js.map

package/dist/instrumentation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"instrumentation.js","sourceRoot":"","sources":["../src/instrumentation.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,QAAQ,CAAA;AAyBvC,MAAM,CAAC,MAAM,kBAAkB,GAAG,OAAO,CAAC,UAAU,CAAyB,uCAAuC,CAAC,CAAA;AAErH,MAAM,CAAC,MAAM,wBAAwB,GAAG,KAAK,CAAC,OAAO,CAAC,kBAAkB,EAAE;IACzE,MAAM,EAAE,GAAG,EAAE,GAAE,CAAC;CAChB,CAAC,CAAA;AAEF,MAAM,CAAC,MAAM,2BAA2B,GAAG,CAAC,OAA6B,EAAE,EAAE,CAC5E,KAAK,CAAC,OAAO,CAAC,kBAAkB,EAAE;IACjC,MAAM,EAAE,CAAC,KAA2B,EAAE,EAAE;QACvC,MAAM,MAAM,GAAG,OAAO,EAAE,MAAM,IAAI,WAAW,CAAA;QAC7C,sCAAsC;QACtC,OAAO,CAAC,KAAK,CAAC,GAAG,MAAM,IAAI,KAAK,CAAC,IAAI,EAAE,EAAE,KAAK,CAAC,CAAA;IAChD,CAAC;CACD,CAAC,CAAA"}

package/dist/lazy-tool-loader.d.ts

@@ -0,0 +1,67 @@
+import type { AgentTool } from "@yeshwanthyk/ai";
+import type { ToolDef } from "@yeshwanthyk/base-tools";
+/**
+ * Lazily loads tools from registry + manages custom/hook tools.
+ * Pre-loads core tools (read, bash) on instantiation for fast startup.
+ */
+export declare class LazyToolLoader {
+    private registry;
+    private customTools;
+    private hookTools;
+    private loaded;
+    private loading;
+    constructor(registry: Record<string, ToolDef>, customTools?: AgentTool[], hookTools?: AgentTool[]);
+    /**
+     * Pre-load core tools for fast startup.
+     * Call this after construction but before agent runs.
+     */
+    preloadCoreTools(): Promise<void>;
+    /**
+     * Get a tool, loading lazily if not yet loaded.
+     * Returns null if tool doesn't exist.
+     */
+    getTool(name: string): Promise<AgentTool | null>;
+    /**
+     * Get all currently loaded tools as an array.
+     * Includes custom and hook tools.
+     */
+    getLoadedTools(): AgentTool[];
+    /**
+     * Get all tools (loaded + pre-loaded + custom + hooks)
+     * For use with agent initialization.
+     * Returns a proxy array that supports find() without full loading.
+     */
+    getToolsProxy(): ToolProxyArray;
+}
+/**
+ * Proxy array that supports array operations but loads tools lazily.
+ * Used for agent.state.tools to maintain array interface.
+ */
+export declare class ToolProxyArray {
+    private loader;
+    constructor(loader: LazyToolLoader);
+    /**
+     * Find a tool by predicate.
+     * Only searches pre-loaded tools (core + custom + hooks).
+     * Secondary tools are loaded on-demand by agent-loop.
+     */
+    find(predicate: (tool: AgentTool) => boolean): AgentTool | undefined;
+    /**
+     * Check if array is empty.
+     */
+    get length(): number;
+    /**
+     * Iterate over loaded tools.
+     */
+    [Symbol.iterator](): ArrayIterator<AgentTool<import("@sinclair/typebox").TSchema, any>>;
+    /**
+     * Filter loaded tools.
+     */
+    filter(predicate: (tool: AgentTool) => boolean): AgentTool[];
+    /**
+     * Map over loaded tools.
+     */
+    map<T>(fn: (tool: AgentTool) => T): T[];
+    toArray(): AgentTool[];
+}
+//# sourceMappingURL=lazy-tool-loader.d.ts.map

package/dist/lazy-tool-loader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lazy-tool-loader.d.ts","sourceRoot":"","sources":["../src/lazy-tool-loader.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AACjD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,yBAAyB,CAAC;AAEvD;;;GAGG;AACH,qBAAa,cAAc;IAKzB,OAAO,CAAC,QAAQ;IAChB,OAAO,CAAC,WAAW;IACnB,OAAO,CAAC,SAAS;IANlB,OAAO,CAAC,MAAM,CAAgC;IAC9C,OAAO,CAAC,OAAO,CAAyC;gBAG/C,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACjC,WAAW,GAAE,SAAS,EAAO,EAC7B,SAAS,GAAE,SAAS,EAAO;IAGpC;;;OAGG;IACG,gBAAgB,IAAI,OAAO,CAAC,IAAI,CAAC;IAIvC;;;OAGG;IACG,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,GAAG,IAAI,CAAC;IAyCtD;;;OAGG;IACH,cAAc,IAAI,SAAS,EAAE;IAQ7B;;;;OAIG;IACH,aAAa,IAAI,cAAc;CAG/B;AAED;;;GAGG;AACH,qBAAa,cAAc;IACd,OAAO,CAAC,MAAM;gBAAN,MAAM,EAAE,cAAc;IAE1C;;;;OAIG;IACH,IAAI,CAAC,SAAS,EAAE,CAAC,IAAI,EAAE,SAAS,KAAK,OAAO,GAAG,SAAS,GAAG,SAAS;IAIpE;;OAEG;IACH,IAAI,MAAM,IAAI,MAAM,CAEnB;IAED;;OAEG;IACH,CAAC,MAAM,CAAC,QAAQ,CAAC;IAIjB;;OAEG;IACH,MAAM,CAAC,SAAS,EAAE,CAAC,IAAI,EAAE,SAAS,KAAK,OAAO,GAAG,SAAS,EAAE;IAI5D;;OAEG;IACH,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,IAAI,EAAE,SAAS,KAAK,CAAC,GAAG,CAAC,EAAE;IAIvC,OAAO,IAAI,SAAS,EAAE;CAGtB"}