@agentick/core 0.0.1

package/dist/hooks/knobs-component.js.map

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

package/dist/hooks/lifecycle.d.ts

@@ -0,0 +1,158 @@
+/**
+ * Lifecycle Hooks
+ *
+ * Event-driven hooks for component and tick lifecycle phases.
+ * All callbacks receive data first, ctx (context) last.
+ */
+import type { TickStartCallback, TickEndCallback, AfterCompileCallback, MountCallback, UnmountCallback } from "./types";
+/**
+ * Register a callback to run when the component mounts.
+ *
+ * @example
+ * ```tsx
+ * useOnMount((ctx) => {
+ *   console.log("Component mounted");
+ *   ctx.setState("initialized", true);
+ * });
+ * ```
+ */
+export declare function useOnMount(callback: MountCallback): void;
+/**
+ * Register a callback to run when the component unmounts.
+ *
+ * @example
+ * ```tsx
+ * useOnUnmount((ctx) => {
+ *   console.log("Component unmounting");
+ *   ctx.setState("initialized", false);
+ * });
+ * ```
+ */
+export declare function useOnUnmount(callback: UnmountCallback): void;
+/**
+ * Register a callback to run at the start of each tick.
+ *
+ * @example
+ * ```tsx
+ * useOnTickStart((tickState) => {
+ *   console.log(`Tick ${tickState.tick} starting!`);
+ * });
+ *
+ * useOnTickStart((tickState, ctx) => {
+ *   ctx.setState("lastTickStart", tickState.tick);
+ * });
+ * ```
+ *
+ * **Timing:** Fires from tick 2+ (the tick after the component mounts).
+ * This follows the React lifecycle model — the component must render
+ * before its effects can register callbacks, and `notifyTickStart`
+ * fires before compilation.
+ *
+ * For first-tick setup, use `useOnMount`. For logic that must run
+ * on every tick including the first, combine both:
+ *
+ * ```tsx
+ * useOnMount((ctx) => { setupForFirstTick(ctx); });
+ * useOnTickStart((tickState, ctx) => { setupForSubsequentTicks(tickState, ctx); });
+ * ```
+ */
+export declare function useOnTickStart(callback: TickStartCallback): void;
+/**
+ * Register a callback to run at the end of each tick.
+ *
+ * The callback receives TickResult (primary data) and COM (context).
+ * TickResult contains data about the completed tick and control methods
+ * to influence whether execution continues.
+ *
+ * @example
+ * ```tsx
+ * // Simple: inspect results
+ * useOnTickEnd((result) => {
+ *   console.log(`Tick ${result.tick} complete, tokens: ${result.usage?.totalTokens}`);
+ * });
+ *
+ * // Control continuation with boolean return
+ * useOnTickEnd((result) => !result.text?.includes("<DONE>"));
+ *
+ * // Control continuation with methods (includes reasons)
+ * useOnTickEnd((result, ctx) => {
+ *   if (result.text?.includes("<DONE>")) {
+ *     result.stop("task-complete");
+ *   } else {
+ *     result.continue("still-working");
+ *   }
+ * });
+ *
+ * // Async verification
+ * useOnTickEnd(async (result) => {
+ *   const verified = await checkWithModel(result.text);
+ *   return !verified; // continue if not verified
+ * });
+ * ```
+ */
+export declare function useOnTickEnd(callback: TickEndCallback): void;
+/**
+ * Register a callback to run after compilation.
+ * This is where you can inspect the compiled output and request recompilation.
+ *
+ * @example
+ * ```tsx
+ * // Inspect compiled output
+ * useAfterCompile((compiled) => {
+ *   console.log(`Compiled ${compiled.tools.length} tools`);
+ * });
+ *
+ * // Request recompilation when needed
+ * useAfterCompile((compiled, ctx) => {
+ *   if (compiled.tools.length === 0) {
+ *     registerMoreTools();
+ *     ctx.requestRecompile('adding tools');
+ *   }
+ * });
+ * ```
+ */
+export declare function useAfterCompile(callback: AfterCompileCallback): void;
+/**
+ * Control whether execution continues after each tick.
+ *
+ * This is the primary hook for implementing agent loops with custom termination conditions.
+ * The callback receives TickResult and optionally COM, and should return whether to continue.
+ *
+ * The callback can:
+ * 1. Return a boolean (true = continue, false = stop)
+ * 2. Call result.stop(reason?) or result.continue(reason?) for control with reasons
+ * 3. Be async for verification with external services
+ *
+ * @param shouldContinue - Callback that determines whether to continue execution
+ *
+ * @example
+ * ```tsx
+ * // Simple: continue until done token
+ * useContinuation((r) => !r.text?.includes("<DONE>"));
+ *
+ * // With reasons
+ * useContinuation((r) => {
+ *   if (r.text?.includes("<DONE>")) {
+ *     r.stop("task-complete");
+ *   } else if (r.tick >= 10) {
+ *     r.stop("max-ticks-reached");
+ *   } else {
+ *     r.continue("still-working");
+ *   }
+ * });
+ *
+ * // Async verification
+ * useContinuation(async (r) => {
+ *   const verified = await verifyWithModel(r.text);
+ *   return verified ? false : true; // stop if verified
+ * });
+ *
+ * // Multiple conditions
+ * useContinuation((r) =>
+ *   r.toolCalls.length > 0 ||           // pending tools
+ *   (r.tick < 10 && !r.text?.includes("DONE"))
+ * );
+ * ```
+ */
+export declare function useContinuation(shouldContinue: TickEndCallback): void;
+//# sourceMappingURL=lifecycle.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"lifecycle.d.ts","sourceRoot":"","sources":["../../src/hooks/lifecycle.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAKH,OAAO,KAAK,EACV,iBAAiB,EACjB,eAAe,EACf,oBAAoB,EACpB,aAAa,EACb,eAAe,EAChB,MAAM,SAAS,CAAC;AAEjB;;;;;;;;;;GAUG;AACH,wBAAgB,UAAU,CAAC,QAAQ,EAAE,aAAa,GAAG,IAAI,CAUxD;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,YAAY,CAAC,QAAQ,EAAE,eAAe,GAAG,IAAI,CAY5D;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,wBAAgB,cAAc,CAAC,QAAQ,EAAE,iBAAiB,GAAG,IAAI,CAgBhE;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AACH,wBAAgB,YAAY,CAAC,QAAQ,EAAE,eAAe,GAAG,IAAI,CAc5D;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,eAAe,CAAC,QAAQ,EAAE,oBAAoB,GAAG,IAAI,CAcpE;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAyCG;AACH,wBAAgB,eAAe,CAAC,cAAc,EAAE,eAAe,GAAG,IAAI,CAErE"}

package/dist/hooks/lifecycle.js

@@ -0,0 +1,217 @@
+/**
+ * Lifecycle Hooks
+ *
+ * Event-driven hooks for component and tick lifecycle phases.
+ * All callbacks receive data first, ctx (context) last.
+ */
+import { useEffect, useRef, useDebugValue } from "react";
+import { useRuntimeStore } from "./runtime-context";
+import { useCom } from "./context";
+/**
+ * Register a callback to run when the component mounts.
+ *
+ * @example
+ * ```tsx
+ * useOnMount((ctx) => {
+ *   console.log("Component mounted");
+ *   ctx.setState("initialized", true);
+ * });
+ * ```
+ */
+export function useOnMount(callback) {
+    const ctx = useCom();
+    const savedCallback = useRef(callback);
+    savedCallback.current = callback;
+    useDebugValue("onMount registered");
+    useEffect(() => {
+        savedCallback.current(ctx);
+    }, [ctx]);
+}
+/**
+ * Register a callback to run when the component unmounts.
+ *
+ * @example
+ * ```tsx
+ * useOnUnmount((ctx) => {
+ *   console.log("Component unmounting");
+ *   ctx.setState("initialized", false);
+ * });
+ * ```
+ */
+export function useOnUnmount(callback) {
+    const ctx = useCom();
+    const savedCallback = useRef(callback);
+    savedCallback.current = callback;
+    useDebugValue("onUnmount registered");
+    useEffect(() => {
+        return () => {
+            savedCallback.current(ctx);
+        };
+    }, [ctx]);
+}
+/**
+ * Register a callback to run at the start of each tick.
+ *
+ * @example
+ * ```tsx
+ * useOnTickStart((tickState) => {
+ *   console.log(`Tick ${tickState.tick} starting!`);
+ * });
+ *
+ * useOnTickStart((tickState, ctx) => {
+ *   ctx.setState("lastTickStart", tickState.tick);
+ * });
+ * ```
+ *
+ * **Timing:** Fires from tick 2+ (the tick after the component mounts).
+ * This follows the React lifecycle model — the component must render
+ * before its effects can register callbacks, and `notifyTickStart`
+ * fires before compilation.
+ *
+ * For first-tick setup, use `useOnMount`. For logic that must run
+ * on every tick including the first, combine both:
+ *
+ * ```tsx
+ * useOnMount((ctx) => { setupForFirstTick(ctx); });
+ * useOnTickStart((tickState, ctx) => { setupForSubsequentTicks(tickState, ctx); });
+ * ```
+ */
+export function useOnTickStart(callback) {
+    const store = useRuntimeStore();
+    const savedCallback = useRef(callback);
+    // Update ref on each render so callback has fresh closure
+    savedCallback.current = callback;
+    useDebugValue("onTickStart registered");
+    useEffect(() => {
+        const cb = (tickState, ctx) => savedCallback.current(tickState, ctx);
+        store.tickStartCallbacks.add(cb);
+        return () => {
+            store.tickStartCallbacks.delete(cb);
+        };
+    }, [store]);
+}
+/**
+ * Register a callback to run at the end of each tick.
+ *
+ * The callback receives TickResult (primary data) and COM (context).
+ * TickResult contains data about the completed tick and control methods
+ * to influence whether execution continues.
+ *
+ * @example
+ * ```tsx
+ * // Simple: inspect results
+ * useOnTickEnd((result) => {
+ *   console.log(`Tick ${result.tick} complete, tokens: ${result.usage?.totalTokens}`);
+ * });
+ *
+ * // Control continuation with boolean return
+ * useOnTickEnd((result) => !result.text?.includes("<DONE>"));
+ *
+ * // Control continuation with methods (includes reasons)
+ * useOnTickEnd((result, ctx) => {
+ *   if (result.text?.includes("<DONE>")) {
+ *     result.stop("task-complete");
+ *   } else {
+ *     result.continue("still-working");
+ *   }
+ * });
+ *
+ * // Async verification
+ * useOnTickEnd(async (result) => {
+ *   const verified = await checkWithModel(result.text);
+ *   return !verified; // continue if not verified
+ * });
+ * ```
+ */
+export function useOnTickEnd(callback) {
+    const store = useRuntimeStore();
+    const savedCallback = useRef(callback);
+    savedCallback.current = callback;
+    useDebugValue("onTickEnd registered");
+    useEffect(() => {
+        const cb = (result, ctx) => savedCallback.current(result, ctx);
+        store.tickEndCallbacks.add(cb);
+        return () => {
+            store.tickEndCallbacks.delete(cb);
+        };
+    }, [store]);
+}
+/**
+ * Register a callback to run after compilation.
+ * This is where you can inspect the compiled output and request recompilation.
+ *
+ * @example
+ * ```tsx
+ * // Inspect compiled output
+ * useAfterCompile((compiled) => {
+ *   console.log(`Compiled ${compiled.tools.length} tools`);
+ * });
+ *
+ * // Request recompilation when needed
+ * useAfterCompile((compiled, ctx) => {
+ *   if (compiled.tools.length === 0) {
+ *     registerMoreTools();
+ *     ctx.requestRecompile('adding tools');
+ *   }
+ * });
+ * ```
+ */
+export function useAfterCompile(callback) {
+    const store = useRuntimeStore();
+    const savedCallback = useRef(callback);
+    savedCallback.current = callback;
+    useDebugValue("onAfterCompile registered");
+    useEffect(() => {
+        const cb = (compiled, ctx) => savedCallback.current(compiled, ctx);
+        store.afterCompileCallbacks.add(cb);
+        return () => {
+            store.afterCompileCallbacks.delete(cb);
+        };
+    }, [store]);
+}
+/**
+ * Control whether execution continues after each tick.
+ *
+ * This is the primary hook for implementing agent loops with custom termination conditions.
+ * The callback receives TickResult and optionally COM, and should return whether to continue.
+ *
+ * The callback can:
+ * 1. Return a boolean (true = continue, false = stop)
+ * 2. Call result.stop(reason?) or result.continue(reason?) for control with reasons
+ * 3. Be async for verification with external services
+ *
+ * @param shouldContinue - Callback that determines whether to continue execution
+ *
+ * @example
+ * ```tsx
+ * // Simple: continue until done token
+ * useContinuation((r) => !r.text?.includes("<DONE>"));
+ *
+ * // With reasons
+ * useContinuation((r) => {
+ *   if (r.text?.includes("<DONE>")) {
+ *     r.stop("task-complete");
+ *   } else if (r.tick >= 10) {
+ *     r.stop("max-ticks-reached");
+ *   } else {
+ *     r.continue("still-working");
+ *   }
+ * });
+ *
+ * // Async verification
+ * useContinuation(async (r) => {
+ *   const verified = await verifyWithModel(r.text);
+ *   return verified ? false : true; // stop if verified
+ * });
+ *
+ * // Multiple conditions
+ * useContinuation((r) =>
+ *   r.toolCalls.length > 0 ||           // pending tools
+ *   (r.tick < 10 && !r.text?.includes("DONE"))
+ * );
+ * ```
+ */
+export function useContinuation(shouldContinue) {
+    useOnTickEnd(shouldContinue);
+}
+//# sourceMappingURL=lifecycle.js.map

package/dist/hooks/lifecycle.js.map

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

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

@@ -0,0 +1,101 @@
+/**
+ * V2 Message Context
+ *
+ * Provides message handling capabilities to components.
+ * This enables components to react to incoming messages and queue outgoing messages.
+ *
+ * Architecture:
+ * - The React tree stays mounted across ticks (persistent)
+ * - Components can register message handlers that are called when messages arrive
+ * - Components can queue messages for the next tick
+ * - The runtime drains the queue when entering a tick
+ */
+import React, { type ReactNode } from "react";
+import type { ExecutionMessage } from "../engine/execution-types";
+import type { COM } from "../com/object-model";
+import type { TickState } from "../component/component";
+/**
+ * Message handler signature.
+ * @param message - The message that was received
+ * @param ctx - The Context Object Model
+ * @param state - The current tick state
+ */
+export type MessageHandler = (message: ExecutionMessage, ctx: COM, state: TickState) => void | Promise<void>;
+export interface MessageStore {
+    /** Queued messages */
+    queue: ExecutionMessage[];
+    /** Message handlers - just the handler functions */
+    handlers: Set<MessageHandler>;
+    /** Last received message */
+    lastMessage: ExecutionMessage | null;
+    /** Subscribers for state changes */
+    subscribers: Set<() => void>;
+    /** Current COM reference (set by compiler) */
+    ctx: COM | null;
+    /** Current TickState reference (set by compiler) */
+    tickState: TickState | null;
+}
+export declare function createMessageStore(): MessageStore;
+export interface MessageContextValue {
+    /** Queue a message for the next tick */
+    queueMessage: (message: ExecutionMessage) => void;
+    /** Get all queued messages */
+    getQueuedMessages: () => ExecutionMessage[];
+    /** Clear the queue and return all messages */
+    drainQueue: () => ExecutionMessage[];
+    /** Register a message handler */
+    addMessageHandler: (handler: MessageHandler) => () => void;
+    /** Last received message */
+    lastMessage: ExecutionMessage | null;
+}
+/**
+ * Provider for message context.
+ */
+export declare function MessageProvider({ store, children, }: {
+    store: MessageStore;
+    children?: ReactNode;
+}): React.ReactElement;
+/**
+ * Get the message context.
+ */
+export declare function useMessageContext(): MessageContextValue;
+/**
+ * Register a handler for incoming messages.
+ *
+ * @example
+ * ```tsx
+ * function MyComponent() {
+ *   useOnMessage((message, ctx, state) => {
+ *     console.log('Received:', message);
+ *   });
+ *   return <System>I respond to messages</System>;
+ * }
+ * ```
+ */
+export declare function useOnMessage(handler: MessageHandler): void;
+/**
+ * Get the queue of pending messages for this tick.
+ *
+ * Returns messages queued for this tick from tickState.queuedMessages.
+ *
+ * @example
+ * ```tsx
+ * function MyComponent() {
+ *   const queuedMessages = useQueuedMessages();
+ *
+ *   return (
+ *     <div>
+ *       {queuedMessages.map((msg, i) => (
+ *         <span key={i}>{msg.type}</span>
+ *       ))}
+ *     </div>
+ *   );
+ * }
+ * ```
+ */
+export declare function useQueuedMessages(): ExecutionMessage[];
+/**
+ * Get the last received message.
+ */
+export declare function useLastMessage(): ExecutionMessage | null;
+//# sourceMappingURL=message-context.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"message-context.d.ts","sourceRoot":"","sources":["../../src/hooks/message-context.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,EAAE,EAMZ,KAAK,SAAS,EACf,MAAM,OAAO,CAAC;AACf,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,2BAA2B,CAAC;AAClE,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,qBAAqB,CAAC;AAC/C,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AAUxD;;;;;GAKG;AACH,MAAM,MAAM,cAAc,GAAG,CAC3B,OAAO,EAAE,gBAAgB,EACzB,GAAG,EAAE,GAAG,EACR,KAAK,EAAE,SAAS,KACb,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;AAM1B,MAAM,WAAW,YAAY;IAC3B,sBAAsB;IACtB,KAAK,EAAE,gBAAgB,EAAE,CAAC;IAE1B,oDAAoD;IACpD,QAAQ,EAAE,GAAG,CAAC,cAAc,CAAC,CAAC;IAE9B,4BAA4B;IAC5B,WAAW,EAAE,gBAAgB,GAAG,IAAI,CAAC;IAErC,oCAAoC;IACpC,WAAW,EAAE,GAAG,CAAC,MAAM,IAAI,CAAC,CAAC;IAE7B,8CAA8C;IAC9C,GAAG,EAAE,GAAG,GAAG,IAAI,CAAC;IAEhB,oDAAoD;IACpD,SAAS,EAAE,SAAS,GAAG,IAAI,CAAC;CAC7B;AAED,wBAAgB,kBAAkB,IAAI,YAAY,CASjD;AAMD,MAAM,WAAW,mBAAmB;IAClC,wCAAwC;IACxC,YAAY,EAAE,CAAC,OAAO,EAAE,gBAAgB,KAAK,IAAI,CAAC;IAElD,8BAA8B;IAC9B,iBAAiB,EAAE,MAAM,gBAAgB,EAAE,CAAC;IAE5C,8CAA8C;IAC9C,UAAU,EAAE,MAAM,gBAAgB,EAAE,CAAC;IAErC,iCAAiC;IACjC,iBAAiB,EAAE,CAAC,OAAO,EAAE,cAAc,KAAK,MAAM,IAAI,CAAC;IAE3D,4BAA4B;IAC5B,WAAW,EAAE,gBAAgB,GAAG,IAAI,CAAC;CACtC;AAQD;;GAEG;AACH,wBAAgB,eAAe,CAAC,EAC9B,KAAK,EACL,QAAQ,GACT,EAAE;IACD,KAAK,EAAE,YAAY,CAAC;IACpB,QAAQ,CAAC,EAAE,SAAS,CAAC;CACtB,GAAG,KAAK,CAAC,YAAY,CAwCrB;AAMD;;GAEG;AACH,wBAAgB,iBAAiB,IAAI,mBAAmB,CAMvD;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,YAAY,CAAC,OAAO,EAAE,cAAc,GAAG,IAAI,CAmB1D;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,iBAAiB,IAAI,gBAAgB,EAAE,CAStD;AAED;;GAEG;AACH,wBAAgB,cAAc,IAAI,gBAAgB,GAAG,IAAI,CAGxD"}

package/dist/hooks/message-context.js

@@ -0,0 +1,145 @@
+/**
+ * V2 Message Context
+ *
+ * Provides message handling capabilities to components.
+ * This enables components to react to incoming messages and queue outgoing messages.
+ *
+ * Architecture:
+ * - The React tree stays mounted across ticks (persistent)
+ * - Components can register message handlers that are called when messages arrive
+ * - Components can queue messages for the next tick
+ * - The runtime drains the queue when entering a tick
+ */
+import React, { createContext, useContext, useCallback, useRef, useEffect, } from "react";
+import { useTickState } from "./context";
+// Helper for createElement
+const h = React.createElement;
+export function createMessageStore() {
+    return {
+        queue: [],
+        handlers: new Set(),
+        lastMessage: null,
+        subscribers: new Set(),
+        ctx: null,
+        tickState: null,
+    };
+}
+// ============================================================
+// React Context
+// ============================================================
+const MessageContext = createContext(null);
+/**
+ * Provider for message context.
+ */
+export function MessageProvider({ store, children, }) {
+    // Stable reference to store operations
+    const queueMessage = useCallback((message) => {
+        store.queue.push(message);
+        // Notify subscribers
+        for (const sub of store.subscribers) {
+            sub();
+        }
+    }, [store]);
+    const getQueuedMessages = useCallback(() => [...store.queue], [store]);
+    const drainQueue = useCallback(() => {
+        const messages = store.queue;
+        store.queue = [];
+        return messages;
+    }, [store]);
+    const addMessageHandler = useCallback((handler) => {
+        store.handlers.add(handler);
+        return () => {
+            store.handlers.delete(handler);
+        };
+    }, [store]);
+    const value = {
+        queueMessage,
+        getQueuedMessages,
+        drainQueue,
+        addMessageHandler,
+        lastMessage: store.lastMessage,
+    };
+    return h(MessageContext.Provider, { value }, children);
+}
+// ============================================================
+// Hooks
+// ============================================================
+/**
+ * Get the message context.
+ */
+export function useMessageContext() {
+    const ctx = useContext(MessageContext);
+    if (!ctx) {
+        throw new Error("useMessageContext must be used within a MessageProvider");
+    }
+    return ctx;
+}
+/**
+ * Register a handler for incoming messages.
+ *
+ * @example
+ * ```tsx
+ * function MyComponent() {
+ *   useOnMessage((message, ctx, state) => {
+ *     console.log('Received:', message);
+ *   });
+ *   return <System>I respond to messages</System>;
+ * }
+ * ```
+ */
+export function useOnMessage(handler) {
+    const ctx = useContext(MessageContext);
+    const handlerRef = useRef(handler);
+    handlerRef.current = handler;
+    useEffect(() => {
+        if (!ctx)
+            return;
+        // Create a stable wrapper that always calls the latest handler
+        const wrappedHandler = (message, ctx, state) => {
+            return handlerRef.current(message, ctx, state);
+        };
+        const cleanup = ctx.addMessageHandler(wrappedHandler);
+        return () => {
+            cleanup();
+        };
+    }, [ctx]);
+}
+/**
+ * Get the queue of pending messages for this tick.
+ *
+ * Returns messages queued for this tick from tickState.queuedMessages.
+ *
+ * @example
+ * ```tsx
+ * function MyComponent() {
+ *   const queuedMessages = useQueuedMessages();
+ *
+ *   return (
+ *     <div>
+ *       {queuedMessages.map((msg, i) => (
+ *         <span key={i}>{msg.type}</span>
+ *       ))}
+ *     </div>
+ *   );
+ * }
+ * ```
+ */
+export function useQueuedMessages() {
+    try {
+        const tickState = useTickState();
+        return (tickState?.queuedMessages ?? []);
+    }
+    catch {
+        // Fallback to message context queue if outside AgentickProvider
+        const ctx = useContext(MessageContext);
+        return ctx?.getQueuedMessages() ?? [];
+    }
+}
+/**
+ * Get the last received message.
+ */
+export function useLastMessage() {
+    const ctx = useContext(MessageContext);
+    return ctx?.lastMessage ?? null;
+}
+//# sourceMappingURL=message-context.js.map

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

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"policy-context.d.ts","sourceRoot":"","sources":["../../src/hooks/policy-context.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,EAA6B,KAAK,SAAS,EAAE,MAAM,OAAO,CAAC;AASzE,MAAM,WAAW,gBAAgB,CAAC,CAAC;IACjC,QAAQ,EAAE,KAAK,CAAC,EAAE,CAAC;QAAE,KAAK,EAAE,CAAC,CAAC;QAAC,QAAQ,EAAE,SAAS,CAAA;KAAE,CAAC,CAAC;IACtD,SAAS,EAAE,MAAM,CAAC,GAAG,IAAI,CAAC;CAC3B;AAMD;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,CAAC,EAAE,CAAC,GAAG,OAAO,EACzC,KAAK,EAAE,MAAM,EACb,UAAU,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,EAAE,EAAE,KAAK,EAAE,CAAC,KAAK,OAAO,CAAC,CAAC,EAAE,CAAC,GACpD,gBAAgB,CAAC,CAAC,CAAC,CAqBrB"}