@agentick/core 0.7.0 → 0.8.0

package/dist/engine/tool-executor.d.ts

@@ -97,6 +97,19 @@ export declare class ToolExecutor {
      * Create an error result with structured error information.
      */
     private createErrorResult;
+    /**
+     * Execute a tool call with sandbox access recovery.
+     *
+     * If executeSingleTool throws SandboxAccessError (path escapes sandbox),
+     * prompts the user for confirmation via the existing confirmation pipeline.
+     * On approval, calls the error's recover() to mount/allow, retries execution,
+     * then cleans up any temporary allows.
+     *
+     * Uses call.id as the confirmation ID. No collision with pre-execution
+     * confirmations: by the time we get here, the pre-execution confirmation
+     * is already resolved and removed from the coordinator's pending map.
+     */
+    private executeWithSandboxRecovery;
     /**
      * Process a single tool call with confirmation flow.
      *
@@ -104,7 +117,8 @@ export declare class ToolExecutor {
      * 1. Check if confirmation is required
      * 2. If yes, emit confirmation_required event and wait for response
      * 3. Execute tool (or create denial result if denied)
-     * 4. Return result with any events that occurred
+     * 4. If execution hits sandbox boundary, prompt for access and retry
+     * 5. Return result with any events that occurred
      *
      * This is designed for parallel execution - each tool can independently
      * wait for confirmation while other tools are being processed.

package/dist/engine/tool-executor.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"tool-executor.d.ts","sourceRoot":"","sources":["../../src/engine/tool-executor.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,QAAQ,EACb,KAAK,UAAU,EACf,KAAK,cAAc,EACnB,KAAK,sBAAsB,EAE5B,MAAM,cAAc,CAAC;AACtB,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,qBAAqB,CAAC;AAG/C,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAI3D,OAAO,EAAE,qBAAqB,EAAE,MAAM,2BAA2B,CAAC;AAClE,OAAO,EAAE,2BAA2B,EAAE,MAAM,iCAAiC,CAAC;AAE9E;;GAEG;AACH,MAAM,WAAW,uBAAuB;IACtC,uCAAuC;IACvC,QAAQ,EAAE,OAAO,CAAC;IAClB,yCAAyC;IACzC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,gCAAgC;IAChC,IAAI,EAAE,cAAc,CAAC;CACtB;AAeD;;;;;;GAMG;AACH,qBAAa,YAAY;IAIX,OAAO,CAAC,SAAS,CAAC;IAH9B,OAAO,CAAC,qBAAqB,CAAwB;IACrD,OAAO,CAAC,uBAAuB,CAA8B;gBAEzC,SAAS,CAAC,EAAE,gBAAgB,YAAA;IAKhD;;OAEG;IACH,wBAAwB,IAAI,qBAAqB;IAIjD;;OAEG;IACH,0BAA0B,IAAI,2BAA2B;IAIzD;;;;;;;;OAQG;IACG,yBAAyB,CAC7B,IAAI,EAAE,QAAQ,EACd,GAAG,EAAE,GAAG,EACR,WAAW,GAAE,cAAc,EAAO,GACjC,OAAO,CAAC,uBAAuB,GAAG,IAAI,CAAC;IA0C1C;;;;;;OAMG;IACG,mBAAmB,CAAC,IAAI,EAAE,QAAQ,GAAG,OAAO,CAAC,sBAAsB,CAAC;IAI1E;;OAEG;IACH,kBAAkB,CAAC,IAAI,EAAE,QAAQ,GAAG,UAAU;IAe9C;;;;;;OAMG;IACH,OAAO,CAAC,WAAW;IAsBnB;;;;;;;;OAQG;IACG,gBAAgB,CACpB,SAAS,EAAE,QAAQ,EAAE,EACrB,GAAG,EAAE,GAAG,EACR,QAAQ,GAAE,OAAe,EACzB,WAAW,GAAE,cAAc,EAAO,GACjC,OAAO,CAAC,UAAU,EAAE,CAAC;IAOxB;;;OAGG;YACW,iBAAiB;IAe/B;;OAEG;YACW,eAAe;IAS7B;;;;;;;;OAQG;IACG,iBAAiB,CACrB,IAAI,EAAE,QAAQ,EACd,GAAG,EAAE,GAAG,EACR,WAAW,GAAE,cAAc,EAAO,GACjC,OAAO,CAAC,UAAU,CAAC;IA0ItB;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAoCzB;;;;;;;;;;;;;;;;;;;;;;OAsBG;IACG,2BAA2B,CAC/B,IAAI,EAAE,QAAQ,EACd,GAAG,EAAE,GAAG,EACR,WAAW,GAAE,cAAc,EAAO,EAClC,SAAS,GAAE;QACT,sBAAsB,CAAC,EAAE,CACvB,IAAI,EAAE,QAAQ,EACd,OAAO,EAAE,MAAM,EACf,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAC/B,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;QAC1B,oBAAoB,CAAC,EAAE,CACrB,YAAY,EAAE,sBAAsB,EACpC,IAAI,EAAE,QAAQ,KACX,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;KACtB,GACL,OAAO,CAAC;QACT,MAAM,EAAE,UAAU,CAAC;QACnB,YAAY,EAAE,uBAAuB,GAAG,IAAI,CAAC;QAC7C,YAAY,EAAE,sBAAsB,GAAG,IAAI,CAAC;KAC7C,CAAC;CAiDH"}
+{"version":3,"file":"tool-executor.d.ts","sourceRoot":"","sources":["../../src/engine/tool-executor.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,QAAQ,EACb,KAAK,UAAU,EACf,KAAK,cAAc,EACnB,KAAK,sBAAsB,EAE5B,MAAM,cAAc,CAAC;AACtB,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,qBAAqB,CAAC;AAG/C,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAI3D,OAAO,EAAE,qBAAqB,EAAE,MAAM,2BAA2B,CAAC;AAClE,OAAO,EAAE,2BAA2B,EAAE,MAAM,iCAAiC,CAAC;AAE9E;;GAEG;AACH,MAAM,WAAW,uBAAuB;IACtC,uCAAuC;IACvC,QAAQ,EAAE,OAAO,CAAC;IAClB,yCAAyC;IACzC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,gCAAgC;IAChC,IAAI,EAAE,cAAc,CAAC;CACtB;AAeD;;;;;;GAMG;AACH,qBAAa,YAAY;IAIX,OAAO,CAAC,SAAS,CAAC;IAH9B,OAAO,CAAC,qBAAqB,CAAwB;IACrD,OAAO,CAAC,uBAAuB,CAA8B;gBAEzC,SAAS,CAAC,EAAE,gBAAgB,YAAA;IAKhD;;OAEG;IACH,wBAAwB,IAAI,qBAAqB;IAIjD;;OAEG;IACH,0BAA0B,IAAI,2BAA2B;IAIzD;;;;;;;;OAQG;IACG,yBAAyB,CAC7B,IAAI,EAAE,QAAQ,EACd,GAAG,EAAE,GAAG,EACR,WAAW,GAAE,cAAc,EAAO,GACjC,OAAO,CAAC,uBAAuB,GAAG,IAAI,CAAC;IA0C1C;;;;;;OAMG;IACG,mBAAmB,CAAC,IAAI,EAAE,QAAQ,GAAG,OAAO,CAAC,sBAAsB,CAAC;IAI1E;;OAEG;IACH,kBAAkB,CAAC,IAAI,EAAE,QAAQ,GAAG,UAAU;IAe9C;;;;;;OAMG;IACH,OAAO,CAAC,WAAW;IAsBnB;;;;;;;;OAQG;IACG,gBAAgB,CACpB,SAAS,EAAE,QAAQ,EAAE,EACrB,GAAG,EAAE,GAAG,EACR,QAAQ,GAAE,OAAe,EACzB,WAAW,GAAE,cAAc,EAAO,GACjC,OAAO,CAAC,UAAU,EAAE,CAAC;IAOxB;;;OAGG;YACW,iBAAiB;IAe/B;;OAEG;YACW,eAAe;IAS7B;;;;;;;;OAQG;IACG,iBAAiB,CACrB,IAAI,EAAE,QAAQ,EACd,GAAG,EAAE,GAAG,EACR,WAAW,GAAE,cAAc,EAAO,GACjC,OAAO,CAAC,UAAU,CAAC;IA8ItB;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAoCzB;;;;;;;;;;;OAWG;YACW,0BAA0B;IAoExC;;;;;;;;;;;;;;;;;;;;;;;OAuBG;IACG,2BAA2B,CAC/B,IAAI,EAAE,QAAQ,EACd,GAAG,EAAE,GAAG,EACR,WAAW,GAAE,cAAc,EAAO,EAClC,SAAS,GAAE;QACT,sBAAsB,CAAC,EAAE,CACvB,IAAI,EAAE,QAAQ,EACd,OAAO,EAAE,MAAM,EACf,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAC/B,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;QAC1B,oBAAoB,CAAC,EAAE,CACrB,YAAY,EAAE,sBAAsB,EACpC,IAAI,EAAE,QAAQ,KACX,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;KACtB,GACL,OAAO,CAAC;QACT,MAAM,EAAE,UAAU,CAAC;QACnB,YAAY,EAAE,uBAAuB,GAAG,IAAI,CAAC;QAC7C,YAAY,EAAE,sBAAsB,GAAG,IAAI,CAAC;KAC7C,CAAC;CAiDH"}

package/dist/engine/tool-executor.js

@@ -274,7 +274,10 @@ export class ToolExecutor {
             return toolResult;
         }
         catch (error) {
-            // Enhanced error handling
+            // SandboxAccessError propagates to processToolWithConfirmation for recovery
+            if (error?.name === "SandboxAccessError") {
+                throw error;
+            }
             const errorMessage = error?.message || "Tool execution failed";
             const errorType = classifyError(error);
             return this.createErrorResult(call, errorMessage, errorType, error);
@@ -310,6 +313,60 @@ export class ToolExecutor {
         call.result = toolResult;
         return toolResult;
     }
+    /**
+     * Execute a tool call with sandbox access recovery.
+     *
+     * If executeSingleTool throws SandboxAccessError (path escapes sandbox),
+     * prompts the user for confirmation via the existing confirmation pipeline.
+     * On approval, calls the error's recover() to mount/allow, retries execution,
+     * then cleans up any temporary allows.
+     *
+     * Uses call.id as the confirmation ID. No collision with pre-execution
+     * confirmations: by the time we get here, the pre-execution confirmation
+     * is already resolved and removed from the coordinator's pending map.
+     */
+    async executeWithSandboxRecovery(call, ctx, configTools, callbacks) {
+        try {
+            return await this.executeSingleTool(call, ctx, configTools);
+        }
+        catch (error) {
+            // Only handle SandboxAccessError with a recover function
+            if (error?.name !== "SandboxAccessError" || typeof error.recover !== "function") {
+                return this.createErrorResult(call, error?.message || "Tool execution failed", classifyError(error), error);
+            }
+            // Emit sandbox access confirmation
+            const message = `${call.name} wants to access ${error.requestedPath} (outside sandbox). Allow?`;
+            if (callbacks.onConfirmationRequired) {
+                await callbacks.onConfirmationRequired(call, message, {
+                    type: "sandbox_access",
+                    requestedPath: error.requestedPath,
+                    resolvedPath: error.resolvedPath,
+                    mode: error.mode,
+                });
+            }
+            // Wait for user decision via confirmation coordinator
+            const confirmation = await this.confirmationCoordinator.waitForConfirmation(call.id, call.name);
+            if (callbacks.onConfirmationResult) {
+                await callbacks.onConfirmationResult(confirmation, call);
+            }
+            if (!confirmation.confirmed) {
+                return this.createDenialResult(call);
+            }
+            // Apply recovery (mount or one-time allow) and retry
+            const cleanup = await error.recover(confirmation.always);
+            try {
+                return await this.executeSingleTool(call, ctx, configTools);
+            }
+            catch (retryError) {
+                // Retry failed — return as normal error
+                const retryMessage = retryError?.message || "Tool execution failed after sandbox recovery";
+                return this.createErrorResult(call, retryMessage, classifyError(retryError), retryError);
+            }
+            finally {
+                cleanup?.();
+            }
+        }
+    }
     /**
      * Process a single tool call with confirmation flow.
      *
@@ -317,7 +374,8 @@ export class ToolExecutor {
      * 1. Check if confirmation is required
      * 2. If yes, emit confirmation_required event and wait for response
      * 3. Execute tool (or create denial result if denied)
-     * 4. Return result with any events that occurred
+     * 4. If execution hits sandbox boundary, prompt for access and retry
+     * 5. Return result with any events that occurred
      *
      * This is designed for parallel execution - each tool can independently
      * wait for confirmation while other tools are being processed.
@@ -364,13 +422,13 @@ export class ToolExecutor {
                 result = this.createDenialResult(call);
             }
             else {
-                // User confirmed - execute the tool
-                result = await this.executeSingleTool(call, ctx, configTools);
+                // User confirmed - execute with sandbox recovery
+                result = await this.executeWithSandboxRecovery(call, ctx, configTools, callbacks);
             }
         }
         else {
-            // No confirmation needed - execute directly
-            result = await this.executeSingleTool(call, ctx, configTools);
+            // No confirmation needed - execute with sandbox recovery
+            result = await this.executeWithSandboxRecovery(call, ctx, configTools, callbacks);
         }
         return { result, confirmCheck, confirmation };
     }

package/dist/engine/tool-executor.js.map

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

package/dist/hooks/expandable.d.ts

@@ -1,10 +1,37 @@
 import React from "react";
+import type { JSX } from "react";
+export type ExpandableRenderFn = (expanded: boolean, name: string) => React.ReactNode;
 export interface ExpandableProps {
     name?: string;
     group?: string;
     summary: string;
     momentary?: boolean;
-    children?: React.ReactNode;
+    children?: ExpandableRenderFn;
 }
-export declare function Expandable({ name, group, summary, momentary, children }: ExpandableProps): React.FunctionComponentElement<React.FragmentProps> | React.FunctionComponentElement<import("@agentick/core").CollapsedProps>;
+/**
+ * Headless expand/collapse toggle.
+ *
+ * Manages a momentary knob and passes `(expanded, effectiveName)` to its
+ * render function. The consumer decides what both states look like —
+ * Expandable has no opinion on rendering.
+ *
+ * @example
+ * // Content block: collapsed → Collapsed intrinsic, expanded → Image intrinsic
+ * <Expandable name="img:0" summary="[image]">
+ *   {(expanded, name) => expanded
+ *     ? <image source={src} />
+ *     : <Collapsed name={name}>[image]</Collapsed>
+ *   }
+ * </Expandable>
+ *
+ * @example
+ * // Message: collapsed → summary text, expanded → full content
+ * <Expandable name="ref:3" summary="[ref:3] user asked...">
+ *   {(expanded) => expanded
+ *     ? <MessageInner {...fullProps} />
+ *     : <MessageInner {...summaryProps} />
+ *   }
+ * </Expandable>
+ */
+export declare function Expandable({ name, group, summary, momentary, children, }: ExpandableProps): JSX.Element;
 //# sourceMappingURL=expandable.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"expandable.d.ts","sourceRoot":"","sources":["../../src/hooks/expandable.ts"],"names":[],"mappings":"AAAA,OAAO,KAAkB,MAAM,OAAO,CAAC;AAQvC,MAAM,WAAW,eAAe;IAC9B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,QAAQ,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;CAC5B;AAED,wBAAgB,UAAU,CAAC,EAAE,IAAI,EAAE,KAAK,EAAE,OAAO,EAAE,SAAgB,EAAE,QAAQ,EAAE,EAAE,eAAe,iIAe/F"}
+{"version":3,"file":"expandable.d.ts","sourceRoot":"","sources":["../../src/hooks/expandable.ts"],"names":[],"mappings":"AAAA,OAAO,KAAkB,MAAM,OAAO,CAAC;AACvC,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,OAAO,CAAC;AAOjC,MAAM,MAAM,kBAAkB,GAAG,CAAC,QAAQ,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,KAAK,KAAK,CAAC,SAAS,CAAC;AAEtF,MAAM,WAAW,eAAe;IAC9B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,QAAQ,CAAC,EAAE,kBAAkB,CAAC;CAC/B;AAED;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,wBAAgB,UAAU,CAAC,EACzB,IAAI,EACJ,KAAK,EACL,OAAO,EACP,SAAgB,EAChB,QAAQ,GACT,EAAE,eAAe,GAAG,GAAG,CAAC,OAAO,CAW/B"}

package/dist/hooks/expandable.js

@@ -1,19 +1,40 @@
 import React, { useMemo } from "react";
 import { useKnob } from "./knob";
-import { Collapsed } from "../jsx/components/collapsed";
 const h = React.createElement;
 let expandableCounter = 0;
-export function Expandable({ name, group, summary, momentary = true, children }) {
+/**
+ * Headless expand/collapse toggle.
+ *
+ * Manages a momentary knob and passes `(expanded, effectiveName)` to its
+ * render function. The consumer decides what both states look like —
+ * Expandable has no opinion on rendering.
+ *
+ * @example
+ * // Content block: collapsed → Collapsed intrinsic, expanded → Image intrinsic
+ * <Expandable name="img:0" summary="[image]">
+ *   {(expanded, name) => expanded
+ *     ? <image source={src} />
+ *     : <Collapsed name={name}>[image]</Collapsed>
+ *   }
+ * </Expandable>
+ *
+ * @example
+ * // Message: collapsed → summary text, expanded → full content
+ * <Expandable name="ref:3" summary="[ref:3] user asked...">
+ *   {(expanded) => expanded
+ *     ? <MessageInner {...fullProps} />
+ *     : <MessageInner {...summaryProps} />
+ *   }
+ * </Expandable>
+ */
+export function Expandable({ name, group, summary, momentary = true, children, }) {
     const effectiveName = useMemo(() => name ?? `_expand_${++expandableCounter}`, [name]);
     const [expanded] = useKnob(effectiveName, false, {
-        description: `Expand: ${summary}`,
+        description: `Expand: ${summary.slice(0, 60)}`,
         group,
         inline: true,
         momentary,
     });
-    if (!expanded) {
-        return h(Collapsed, { name: effectiveName, group }, summary);
-    }
-    return h(React.Fragment, null, children);
+    return h(React.Fragment, null, children(expanded, effectiveName));
 }
 //# sourceMappingURL=expandable.js.map

package/dist/hooks/expandable.js.map

@@ -1 +1 @@
-{"version":3,"file":"expandable.js","sourceRoot":"","sources":["../../src/hooks/expandable.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,EAAE,OAAO,EAAE,MAAM,OAAO,CAAC;AACvC,OAAO,EAAE,OAAO,EAAE,MAAM,QAAQ,CAAC;AACjC,OAAO,EAAE,SAAS,EAAE,MAAM,6BAA6B,CAAC;AAExD,MAAM,CAAC,GAAG,KAAK,CAAC,aAAa,CAAC;AAE9B,IAAI,iBAAiB,GAAG,CAAC,CAAC;AAU1B,MAAM,UAAU,UAAU,CAAC,EAAE,IAAI,EAAE,KAAK,EAAE,OAAO,EAAE,SAAS,GAAG,IAAI,EAAE,QAAQ,EAAmB;IAC9F,MAAM,aAAa,GAAG,OAAO,CAAC,GAAG,EAAE,CAAC,IAAI,IAAI,WAAW,EAAE,iBAAiB,EAAE,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC;IAEtF,MAAM,CAAC,QAAQ,CAAC,GAAG,OAAO,CAAC,aAAa,EAAE,KAAK,EAAE;QAC/C,WAAW,EAAE,WAAW,OAAO,EAAE;QACjC,KAAK;QACL,MAAM,EAAE,IAAI;QACZ,SAAS;KACV,CAAC,CAAC;IAEH,IAAI,CAAC,QAAQ,EAAE,CAAC;QACd,OAAO,CAAC,CAAC,SAAS,EAAE,EAAE,IAAI,EAAE,aAAa,EAAE,KAAK,EAAE,EAAE,OAAO,CAAC,CAAC;IAC/D,CAAC;IAED,OAAO,CAAC,CAAC,KAAK,CAAC,QAAQ,EAAE,IAAI,EAAE,QAAQ,CAAC,CAAC;AAC3C,CAAC"}
+{"version":3,"file":"expandable.js","sourceRoot":"","sources":["../../src/hooks/expandable.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,EAAE,OAAO,EAAE,MAAM,OAAO,CAAC;AAEvC,OAAO,EAAE,OAAO,EAAE,MAAM,QAAQ,CAAC;AAEjC,MAAM,CAAC,GAAG,KAAK,CAAC,aAAa,CAAC;AAE9B,IAAI,iBAAiB,GAAG,CAAC,CAAC;AAY1B;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,MAAM,UAAU,UAAU,CAAC,EACzB,IAAI,EACJ,KAAK,EACL,OAAO,EACP,SAAS,GAAG,IAAI,EAChB,QAAQ,GACQ;IAChB,MAAM,aAAa,GAAG,OAAO,CAAC,GAAG,EAAE,CAAC,IAAI,IAAI,WAAW,EAAE,iBAAiB,EAAE,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC;IAEtF,MAAM,CAAC,QAAQ,CAAC,GAAG,OAAO,CAAC,aAAa,EAAE,KAAK,EAAE;QAC/C,WAAW,EAAE,WAAW,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,EAAE;QAC9C,KAAK;QACL,MAAM,EAAE,IAAI;QACZ,SAAS;KACV,CAAC,CAAC;IAEH,OAAO,CAAC,CAAC,KAAK,CAAC,QAAQ,EAAE,IAAI,EAAE,QAAS,CAAC,QAAQ,EAAE,aAAa,CAAC,CAAC,CAAC;AACrE,CAAC"}

package/dist/hooks/gate.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Gate — knob-backed continuation condition.
+ *
+ * A gate is a three-state knob (inactive/active/deferred) that blocks
+ * execution from completing until the model explicitly clears it.
+ * Auto-activates when `activateWhen` fires. Auto-renders an Ephemeral
+ * element with instructions when active.
+ */
+import type { JSX } from "react";
+import type { TickResult } from "./types";
+export type GateValue = "inactive" | "active" | "deferred";
+export interface GateDescriptor {
+    description: string;
+    instructions: string;
+    activateWhen: (result: TickResult) => boolean;
+}
+export interface GateState {
+    active: boolean;
+    deferred: boolean;
+    engaged: boolean;
+    clear: () => void;
+    defer: () => void;
+    element: JSX.Element | null;
+}
+export declare function gate(opts: GateDescriptor): GateDescriptor;
+export declare function useGate(name: string, options: GateDescriptor): GateState;
+//# sourceMappingURL=gate.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"gate.d.ts","sourceRoot":"","sources":["../../src/hooks/gate.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,OAAO,CAAC;AAIjC,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAE1C,MAAM,MAAM,SAAS,GAAG,UAAU,GAAG,QAAQ,GAAG,UAAU,CAAC;AAE3D,MAAM,WAAW,cAAc;IAC7B,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,YAAY,EAAE,CAAC,MAAM,EAAE,UAAU,KAAK,OAAO,CAAC;CAC/C;AAED,MAAM,WAAW,SAAS;IACxB,MAAM,EAAE,OAAO,CAAC;IAChB,QAAQ,EAAE,OAAO,CAAC;IAClB,OAAO,EAAE,OAAO,CAAC;IACjB,KAAK,EAAE,MAAM,IAAI,CAAC;IAClB,KAAK,EAAE,MAAM,IAAI,CAAC;IAClB,OAAO,EAAE,GAAG,CAAC,OAAO,GAAG,IAAI,CAAC;CAC7B;AAED,wBAAgB,IAAI,CAAC,IAAI,EAAE,cAAc,GAAG,cAAc,CAEzD;AAED,wBAAgB,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,cAAc,GAAG,SAAS,CAuDxE"}

package/dist/hooks/gate.js

@@ -0,0 +1,59 @@
+/**
+ * Gate — knob-backed continuation condition.
+ *
+ * A gate is a three-state knob (inactive/active/deferred) that blocks
+ * execution from completing until the model explicitly clears it.
+ * Auto-activates when `activateWhen` fires. Auto-renders an Ephemeral
+ * element with instructions when active.
+ */
+import { createElement, useRef, useCallback } from "react";
+import { useOnTickEnd } from "./lifecycle";
+import { useKnob } from "./knob";
+import { Ephemeral } from "../jsx/components/messages";
+export function gate(opts) {
+    return opts;
+}
+export function useGate(name, options) {
+    const [state, setState] = useKnob(name, "inactive", {
+        description: options.description,
+        group: "gates",
+        options: ["inactive", "active", "deferred"],
+    });
+    const activateRef = useRef(options.activateWhen);
+    activateRef.current = options.activateWhen;
+    // Ref tracks ground truth — survives the render→callback gap.
+    // Syncs from knob on each render (picks up external set_knob changes).
+    const stateRef = useRef(state);
+    stateRef.current = state;
+    useOnTickEnd((result) => {
+        // Activate only when inactive — once engaged, model controls it
+        if (stateRef.current === "inactive" && activateRef.current(result)) {
+            setState("active");
+            stateRef.current = "active";
+        }
+        // Block completion when gate is engaged (active or deferred)
+        if (stateRef.current !== "inactive" && !result.shouldContinue) {
+            // Un-defer: model must face the gate before completing
+            if (stateRef.current === "deferred") {
+                setState("active");
+                stateRef.current = "active";
+            }
+            result.continue(`gate:${name}`);
+        }
+    });
+    const clear = useCallback(() => {
+        setState("inactive");
+        stateRef.current = "inactive";
+    }, [setState]);
+    const defer = useCallback(() => {
+        setState("deferred");
+        stateRef.current = "deferred";
+    }, [setState]);
+    const active = state === "active";
+    const deferred = state === "deferred";
+    const element = active
+        ? createElement(Ephemeral, { type: "gate", position: "end", id: `gate:${name}` }, options.instructions)
+        : null;
+    return { active, deferred, engaged: active || deferred, clear, defer, element };
+}
+//# sourceMappingURL=gate.js.map

package/dist/hooks/gate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"gate.js","sourceRoot":"","sources":["../../src/hooks/gate.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,aAAa,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,OAAO,CAAC;AAE3D,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC3C,OAAO,EAAE,OAAO,EAAE,MAAM,QAAQ,CAAC;AACjC,OAAO,EAAE,SAAS,EAAE,MAAM,4BAA4B,CAAC;AAoBvD,MAAM,UAAU,IAAI,CAAC,IAAoB;IACvC,OAAO,IAAI,CAAC;AACd,CAAC;AAED,MAAM,UAAU,OAAO,CAAC,IAAY,EAAE,OAAuB;IAC3D,MAAM,CAAC,KAAK,EAAE,QAAQ,CAAC,GAAG,OAAO,CAAS,IAAI,EAAE,UAAU,EAAE;QAC1D,WAAW,EAAE,OAAO,CAAC,WAAW;QAChC,KAAK,EAAE,OAAO;QACd,OAAO,EAAE,CAAC,UAAU,EAAE,QAAQ,EAAE,UAAU,CAAC;KAC5C,CAAC,CAAC;IAEH,MAAM,WAAW,GAAG,MAAM,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC;IACjD,WAAW,CAAC,OAAO,GAAG,OAAO,CAAC,YAAY,CAAC;IAE3C,8DAA8D;IAC9D,uEAAuE;IACvE,MAAM,QAAQ,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC;IAC/B,QAAQ,CAAC,OAAO,GAAG,KAAK,CAAC;IAEzB,YAAY,CAAC,CAAC,MAAM,EAAE,EAAE;QACtB,gEAAgE;QAChE,IAAI,QAAQ,CAAC,OAAO,KAAK,UAAU,IAAI,WAAW,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;YACnE,QAAQ,CAAC,QAAQ,CAAC,CAAC;YACnB,QAAQ,CAAC,OAAO,GAAG,QAAQ,CAAC;QAC9B,CAAC;QAED,6DAA6D;QAC7D,IAAI,QAAQ,CAAC,OAAO,KAAK,UAAU,IAAI,CAAC,MAAM,CAAC,cAAc,EAAE,CAAC;YAC9D,uDAAuD;YACvD,IAAI,QAAQ,CAAC,OAAO,KAAK,UAAU,EAAE,CAAC;gBACpC,QAAQ,CAAC,QAAQ,CAAC,CAAC;gBACnB,QAAQ,CAAC,OAAO,GAAG,QAAQ,CAAC;YAC9B,CAAC;YACD,MAAM,CAAC,QAAQ,CAAC,QAAQ,IAAI,EAAE,CAAC,CAAC;QAClC,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,MAAM,KAAK,GAAG,WAAW,CAAC,GAAG,EAAE;QAC7B,QAAQ,CAAC,UAAU,CAAC,CAAC;QACrB,QAAQ,CAAC,OAAO,GAAG,UAAU,CAAC;IAChC,CAAC,EAAE,CAAC,QAAQ,CAAC,CAAC,CAAC;IAEf,MAAM,KAAK,GAAG,WAAW,CAAC,GAAG,EAAE;QAC7B,QAAQ,CAAC,UAAU,CAAC,CAAC;QACrB,QAAQ,CAAC,OAAO,GAAG,UAAU,CAAC;IAChC,CAAC,EAAE,CAAC,QAAQ,CAAC,CAAC,CAAC;IAEf,MAAM,MAAM,GAAG,KAAK,KAAK,QAAQ,CAAC;IAClC,MAAM,QAAQ,GAAG,KAAK,KAAK,UAAU,CAAC;IAEtC,MAAM,OAAO,GAAG,MAAM;QACpB,CAAC,CAAC,aAAa,CACX,SAAS,EACT,EAAE,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,KAAK,EAAE,EAAE,EAAE,QAAQ,IAAI,EAAE,EAAE,EACrD,OAAO,CAAC,YAAY,CACrB;QACH,CAAC,CAAC,IAAI,CAAC;IAET,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,IAAI,QAAQ,EAAE,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC;AAClF,CAAC"}

package/dist/hooks/index.d.ts

@@ -9,6 +9,7 @@ export { useComState, type UseComStateOptions } from "./com-state";
 export { createRuntimeStore, useRuntimeStore, RuntimeProvider, storeHasPendingData, storeResolvePendingData, storeRunTickStartCallbacks, storeRunTickStartCatchUp, storeRunTickEndCallbacks, storeRunAfterCompileCallbacks, storeRunExecutionEndCallbacks, storeClearLifecycleCallbacks, storeClearDataCache, storeGetSerializableDataCache, storeGetSerializableComState, storeSetDataCache, storeInvalidateData, type RuntimeStore, type CacheEntry, type SerializableCacheEntry, type KnobRegistration, type HookPersistenceOptions, } from "./runtime-context";
 export { knob, isKnob, useKnob, type KnobDescriptor, type KnobOpts, type KnobPrimitive, type KnobConstraints, } from "./knob";
 export { Knobs, useKnobsContext, useKnobsContextOptional, type KnobsContextValue, type KnobInfo, type KnobGroup, type KnobsRenderFn, } from "./knobs-component";
+export { gate, useGate, type GateDescriptor, type GateState, type GateValue } from "./gate";
 export { Expandable, type ExpandableProps } from "./expandable";
 export { useOnMount, useOnUnmount, useOnTickStart, useOnTickEnd, useAfterCompile, useOnExecutionEnd, useContinuation, } from "./lifecycle";
 export { useData, useInvalidateData, type UseDataOptions } from "./data";

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/hooks/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,EAAE,WAAW,EAAE,OAAO,EAAE,UAAU,EAAE,MAAM,OAAO,CAAC;AAGtF,OAAO,EAAE,MAAM,EAAE,YAAY,EAAE,WAAW,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,MAAM,WAAW,CAAC;AAGnG,OAAO,EAAE,WAAW,EAAE,KAAK,kBAAkB,EAAE,MAAM,aAAa,CAAC;AAGnE,OAAO,EACL,kBAAkB,EAClB,eAAe,EACf,eAAe,EACf,mBAAmB,EACnB,uBAAuB,EACvB,0BAA0B,EAC1B,wBAAwB,EACxB,wBAAwB,EACxB,6BAA6B,EAC7B,6BAA6B,EAC7B,4BAA4B,EAC5B,mBAAmB,EACnB,6BAA6B,EAC7B,4BAA4B,EAC5B,iBAAiB,EACjB,mBAAmB,EACnB,KAAK,YAAY,EACjB,KAAK,UAAU,EACf,KAAK,sBAAsB,EAC3B,KAAK,gBAAgB,EACrB,KAAK,sBAAsB,GAC5B,MAAM,mBAAmB,CAAC;AAG3B,OAAO,EACL,IAAI,EACJ,MAAM,EACN,OAAO,EACP,KAAK,cAAc,EACnB,KAAK,QAAQ,EACb,KAAK,aAAa,EAClB,KAAK,eAAe,GACrB,MAAM,QAAQ,CAAC;AAChB,OAAO,EACL,KAAK,EACL,eAAe,EACf,uBAAuB,EACvB,KAAK,iBAAiB,EACtB,KAAK,QAAQ,EACb,KAAK,SAAS,EACd,KAAK,aAAa,GACnB,MAAM,mBAAmB,CAAC;AAG3B,OAAO,EAAE,UAAU,EAAE,KAAK,eAAe,EAAE,MAAM,cAAc,CAAC;AAGhE,OAAO,EACL,UAAU,EACV,YAAY,EACZ,cAAc,EACd,YAAY,EACZ,eAAe,EACf,iBAAiB,EACjB,eAAe,GAChB,MAAM,aAAa,CAAC;AAGrB,OAAO,EAAE,OAAO,EAAE,iBAAiB,EAAE,KAAK,cAAc,EAAE,MAAM,QAAQ,CAAC;AAGzE,OAAO,EAEL,SAAS,EACT,WAAW,EAEX,MAAM,EACN,QAAQ,EACR,MAAM,EACN,YAAY,EAEZ,KAAK,EACL,SAAS,EAET,QAAQ,EACR,UAAU,EACV,QAAQ,EAER,oBAAoB,EACpB,4BAA4B,EAE5B,oBAAoB,EACpB,yBAAyB,EAEzB,aAAa,EACb,eAAe,EACf,aAAa,EACb,iBAAiB,EACjB,mBAAmB,EACnB,mBAAmB,EACnB,qBAAqB,EAErB,KAAK,MAAM,EACX,KAAK,cAAc,EACnB,KAAK,cAAc,EACnB,KAAK,SAAS,EACd,KAAK,aAAa,GACnB,MAAM,UAAU,CAAC;AAGlB,OAAO,EAAE,iBAAiB,EAAE,YAAY,EAAE,KAAK,qBAAqB,EAAE,MAAM,qBAAqB,CAAC;AAGlG,OAAO,EACL,kBAAkB,EAClB,eAAe,EACf,iBAAiB,EACjB,YAAY,EACZ,iBAAiB,EACjB,cAAc,EACd,KAAK,YAAY,EACjB,KAAK,cAAc,EACnB,KAAK,mBAAmB,GACzB,MAAM,mBAAmB,CAAC;AAG3B,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAGzC,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAGzC,OAAO,EACL,kBAAkB,EAClB,0BAA0B,EAC1B,sBAAsB,GACvB,MAAM,4BAA4B,CAAC;AAGpC,OAAO,EACL,cAAc,EACd,mBAAmB,EACnB,sBAAsB,EACtB,mBAAmB,EACnB,KAAK,WAAW,EAChB,KAAK,gBAAgB,GACtB,MAAM,gBAAgB,CAAC;AAGxB,cAAc,SAAS,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/hooks/index.ts"],"names":[],"mappings":"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"}

package/dist/hooks/index.js

@@ -14,6 +14,8 @@ export { createRuntimeStore, useRuntimeStore, RuntimeProvider, storeHasPendingDa
 // Knobs
 export { knob, isKnob, useKnob, } from "./knob";
 export { Knobs, useKnobsContext, useKnobsContextOptional, } from "./knobs-component";
+// Gates
+export { gate, useGate } from "./gate";
 // Expandable content
 export { Expandable } from "./expandable";
 // Lifecycle hooks

package/dist/hooks/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/hooks/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,wCAAwC;AACxC,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,EAAE,WAAW,EAAE,OAAO,EAAE,UAAU,EAAE,MAAM,OAAO,CAAC;AAEtF,gBAAgB;AAChB,OAAO,EAAE,MAAM,EAAE,YAAY,EAAE,WAAW,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,MAAM,WAAW,CAAC;AAEnG,iBAAiB;AACjB,OAAO,EAAE,WAAW,EAA2B,MAAM,aAAa,CAAC;AAEnE,sCAAsC;AACtC,OAAO,EACL,kBAAkB,EAClB,eAAe,EACf,eAAe,EACf,mBAAmB,EACnB,uBAAuB,EACvB,0BAA0B,EAC1B,wBAAwB,EACxB,wBAAwB,EACxB,6BAA6B,EAC7B,6BAA6B,EAC7B,4BAA4B,EAC5B,mBAAmB,EACnB,6BAA6B,EAC7B,4BAA4B,EAC5B,iBAAiB,EACjB,mBAAmB,GAMpB,MAAM,mBAAmB,CAAC;AAE3B,QAAQ;AACR,OAAO,EACL,IAAI,EACJ,MAAM,EACN,OAAO,GAKR,MAAM,QAAQ,CAAC;AAChB,OAAO,EACL,KAAK,EACL,eAAe,EACf,uBAAuB,GAKxB,MAAM,mBAAmB,CAAC;AAE3B,qBAAqB;AACrB,OAAO,EAAE,UAAU,EAAwB,MAAM,cAAc,CAAC;AAEhE,kBAAkB;AAClB,OAAO,EACL,UAAU,EACV,YAAY,EACZ,cAAc,EACd,YAAY,EACZ,eAAe,EACf,iBAAiB,EACjB,eAAe,GAChB,MAAM,aAAa,CAAC;AAErB,YAAY;AACZ,OAAO,EAAE,OAAO,EAAE,iBAAiB,EAAuB,MAAM,QAAQ,CAAC;AAEzE,6BAA6B;AAC7B,OAAO;AACL,cAAc;AACd,SAAS,EACT,WAAW;AACX,8BAA8B;AAC9B,MAAM,EACN,QAAQ,EACR,MAAM,EACN,YAAY;AACZ,yBAAyB;AACzB,KAAK,EACL,SAAS;AACT,cAAc;AACd,QAAQ,EACR,UAAU,EACV,QAAQ;AACR,wBAAwB;AACxB,oBAAoB,EACpB,4BAA4B;AAC5B,oBAAoB;AACpB,oBAAoB,EACpB,yBAAyB;AACzB,6BAA6B;AAC7B,aAAa,EACb,eAAe,EACf,aAAa,EACb,iBAAiB,EACjB,mBAAmB,EACnB,mBAAmB,EACnB,qBAAqB,GAOtB,MAAM,UAAU,CAAC;AAElB,oBAAoB;AACpB,OAAO,EAAE,iBAAiB,EAAE,YAAY,EAA8B,MAAM,qBAAqB,CAAC;AAElG,kBAAkB;AAClB,OAAO,EACL,kBAAkB,EAClB,eAAe,EACf,iBAAiB,EACjB,YAAY,EACZ,iBAAiB,EACjB,cAAc,GAIf,MAAM,mBAAmB,CAAC;AAE3B,iBAAiB;AACjB,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAEzC,gBAAgB;AAChB,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAEzC,4EAA4E;AAC5E,OAAO,EACL,kBAAkB,EAClB,0BAA0B,EAC1B,sBAAsB,GACvB,MAAM,4BAA4B,CAAC;AAEpC,oDAAoD;AACpD,OAAO,EACL,cAAc,EACd,mBAAmB,EACnB,sBAAsB,EACtB,mBAAmB,GAGpB,MAAM,gBAAgB,CAAC;AAExB,QAAQ;AACR,cAAc,SAAS,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/hooks/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,wCAAwC;AACxC,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,EAAE,WAAW,EAAE,OAAO,EAAE,UAAU,EAAE,MAAM,OAAO,CAAC;AAEtF,gBAAgB;AAChB,OAAO,EAAE,MAAM,EAAE,YAAY,EAAE,WAAW,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,MAAM,WAAW,CAAC;AAEnG,iBAAiB;AACjB,OAAO,EAAE,WAAW,EAA2B,MAAM,aAAa,CAAC;AAEnE,sCAAsC;AACtC,OAAO,EACL,kBAAkB,EAClB,eAAe,EACf,eAAe,EACf,mBAAmB,EACnB,uBAAuB,EACvB,0BAA0B,EAC1B,wBAAwB,EACxB,wBAAwB,EACxB,6BAA6B,EAC7B,6BAA6B,EAC7B,4BAA4B,EAC5B,mBAAmB,EACnB,6BAA6B,EAC7B,4BAA4B,EAC5B,iBAAiB,EACjB,mBAAmB,GAMpB,MAAM,mBAAmB,CAAC;AAE3B,QAAQ;AACR,OAAO,EACL,IAAI,EACJ,MAAM,EACN,OAAO,GAKR,MAAM,QAAQ,CAAC;AAChB,OAAO,EACL,KAAK,EACL,eAAe,EACf,uBAAuB,GAKxB,MAAM,mBAAmB,CAAC;AAE3B,QAAQ;AACR,OAAO,EAAE,IAAI,EAAE,OAAO,EAAuD,MAAM,QAAQ,CAAC;AAE5F,qBAAqB;AACrB,OAAO,EAAE,UAAU,EAAwB,MAAM,cAAc,CAAC;AAEhE,kBAAkB;AAClB,OAAO,EACL,UAAU,EACV,YAAY,EACZ,cAAc,EACd,YAAY,EACZ,eAAe,EACf,iBAAiB,EACjB,eAAe,GAChB,MAAM,aAAa,CAAC;AAErB,YAAY;AACZ,OAAO,EAAE,OAAO,EAAE,iBAAiB,EAAuB,MAAM,QAAQ,CAAC;AAEzE,6BAA6B;AAC7B,OAAO;AACL,cAAc;AACd,SAAS,EACT,WAAW;AACX,8BAA8B;AAC9B,MAAM,EACN,QAAQ,EACR,MAAM,EACN,YAAY;AACZ,yBAAyB;AACzB,KAAK,EACL,SAAS;AACT,cAAc;AACd,QAAQ,EACR,UAAU,EACV,QAAQ;AACR,wBAAwB;AACxB,oBAAoB,EACpB,4BAA4B;AAC5B,oBAAoB;AACpB,oBAAoB,EACpB,yBAAyB;AACzB,6BAA6B;AAC7B,aAAa,EACb,eAAe,EACf,aAAa,EACb,iBAAiB,EACjB,mBAAmB,EACnB,mBAAmB,EACnB,qBAAqB,GAOtB,MAAM,UAAU,CAAC;AAElB,oBAAoB;AACpB,OAAO,EAAE,iBAAiB,EAAE,YAAY,EAA8B,MAAM,qBAAqB,CAAC;AAElG,kBAAkB;AAClB,OAAO,EACL,kBAAkB,EAClB,eAAe,EACf,iBAAiB,EACjB,YAAY,EACZ,iBAAiB,EACjB,cAAc,GAIf,MAAM,mBAAmB,CAAC;AAE3B,iBAAiB;AACjB,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAEzC,gBAAgB;AAChB,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAEzC,4EAA4E;AAC5E,OAAO,EACL,kBAAkB,EAClB,0BAA0B,EAC1B,sBAAsB,GACvB,MAAM,4BAA4B,CAAC;AAEpC,oDAAoD;AACpD,OAAO,EACL,cAAc,EACd,mBAAmB,EACnB,sBAAsB,EACtB,mBAAmB,GAGpB,MAAM,gBAAgB,CAAC;AAExB,QAAQ;AACR,cAAc,SAAS,CAAC"}

package/dist/index.d.ts

@@ -6,9 +6,9 @@
 export * from "@agentick/kernel";
 export * from "./app/types.js";
 export { createApp, Agentick, AgentickInstance, run, runComponent, SessionImpl } from "./app.js";
-export { Model, Section, Timeline, Message, User, Assistant, System, ToolResult as ToolResultComponent, Markdown, XML, Collapsed, type CollapsedProps, compactEntries, type CompactionStrategy, type CompactionFunction, type CompactionResult, type CompactOptions, type CompactResult, type TokenBudgetInfo, type TimelineContextValue, type TimelineRenderFn, type TimelineProps, type TimelineBudgetOptions, } from "./jsx/components/index";
+export { Model, Section, Timeline, Message, User, Assistant, System, ToolResult as ToolResultComponent, Markdown, XML, Ephemeral, type EphemeralProps, type EphemeralPosition, Grounding, type GroundingProps, Collapsed, type CollapsedProps, autoMessageSummary, autoSectionSummary, autoContentSummary, compactEntries, type CompactionStrategy, type CompactionFunction, type CompactionResult, type CompactOptions, type CompactResult, type TokenBudgetInfo, type TimelineContextValue, type TimelineRenderFn, type TimelineProps, type TimelineBudgetOptions, } from "./jsx/components/index";
 export { useState, useEffect, useReducer, useMemo, useCallback, useRef } from "react";
-export { useSignal, useComputed, useCom, useTickState, useOnMount, useOnUnmount, useOnTickStart, useOnTickEnd, useAfterCompile, useOnExecutionEnd, useContinuation, useData, useInvalidateData, type UseDataOptions, useComState, type UseComStateOptions, type HookPersistenceOptions, useTimeline, useResolved, Expandable, type ExpandableProps, knob, isKnob, useKnob, Knobs, useKnobsContext, useKnobsContextOptional, type KnobDescriptor, type KnobOpts, type KnobPrimitive, type KnobConstraints, type KnobRegistration, type KnobsContextValue, type KnobInfo, type KnobGroup, type KnobsRenderFn, useContextInfo, useContextInfoStore, createContextInfoStore, ContextInfoProvider, type ContextInfo, type ContextInfoStore, } from "./hooks";
+export { useSignal, useComputed, useCom, useTickState, useOnMount, useOnUnmount, useOnTickStart, useOnTickEnd, useAfterCompile, useOnExecutionEnd, useContinuation, useData, useInvalidateData, type UseDataOptions, useComState, type UseComStateOptions, type HookPersistenceOptions, useTimeline, useResolved, Expandable, type ExpandableProps, gate, useGate, type GateDescriptor, type GateState, type GateValue, knob, isKnob, useKnob, Knobs, useKnobsContext, useKnobsContextOptional, type KnobDescriptor, type KnobOpts, type KnobPrimitive, type KnobConstraints, type KnobRegistration, type KnobsContextValue, type KnobInfo, type KnobGroup, type KnobsRenderFn, useContextInfo, useContextInfoStore, createContextInfoStore, ContextInfoProvider, type ContextInfo, type ContextInfoStore, } from "./hooks";
 export { createTool } from "./tool/index";
 export type { ToolClass, ToolDefinition, ToolMetadata, ToolPropOverrides } from "./tool/index";
 export { createAdapter } from "./model/adapter";

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAKH,cAAc,kBAAkB,CAAC;AAKjC,cAAc,gBAAgB,CAAC;AAC/B,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,gBAAgB,EAAE,GAAG,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AAKjG,OAAO,EACL,KAAK,EACL,OAAO,EACP,QAAQ,EACR,OAAO,EACP,IAAI,EACJ,SAAS,EACT,MAAM,EACN,UAAU,IAAI,mBAAmB,EACjC,QAAQ,EACR,GAAG,EACH,SAAS,EACT,KAAK,cAAc,EAEnB,cAAc,EACd,KAAK,kBAAkB,EACvB,KAAK,kBAAkB,EACvB,KAAK,gBAAgB,EACrB,KAAK,cAAc,EACnB,KAAK,aAAa,EAClB,KAAK,eAAe,EAEpB,KAAK,oBAAoB,EACzB,KAAK,gBAAgB,EACrB,KAAK,aAAa,EAClB,KAAK,qBAAqB,GAC3B,MAAM,wBAAwB,CAAC;AAKhC,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,UAAU,EAAE,OAAO,EAAE,WAAW,EAAE,MAAM,EAAE,MAAM,OAAO,CAAC;AAKtF,OAAO,EACL,SAAS,EACT,WAAW,EACX,MAAM,EACN,YAAY,EAEZ,UAAU,EACV,YAAY,EACZ,cAAc,EACd,YAAY,EACZ,eAAe,EACf,iBAAiB,EACjB,eAAe,EAEf,OAAO,EACP,iBAAiB,EACjB,KAAK,cAAc,EACnB,WAAW,EACX,KAAK,kBAAkB,EACvB,KAAK,sBAAsB,EAE3B,WAAW,EAEX,WAAW,EAEX,UAAU,EACV,KAAK,eAAe,EAEpB,IAAI,EACJ,MAAM,EACN,OAAO,EACP,KAAK,EACL,eAAe,EACf,uBAAuB,EACvB,KAAK,cAAc,EACnB,KAAK,QAAQ,EACb,KAAK,aAAa,EAClB,KAAK,eAAe,EACpB,KAAK,gBAAgB,EACrB,KAAK,iBAAiB,EACtB,KAAK,QAAQ,EACb,KAAK,SAAS,EACd,KAAK,aAAa,EAElB,cAAc,EACd,mBAAmB,EACnB,sBAAsB,EACtB,mBAAmB,EACnB,KAAK,WAAW,EAChB,KAAK,gBAAgB,GACtB,MAAM,SAAS,CAAC;AAKjB,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC1C,YAAY,EAAE,SAAS,EAAE,cAAc,EAAE,YAAY,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AAK/F,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAChD,YAAY,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAClD,YAAY,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAChE,cAAc,SAAS,CAAC;AAKxB,YAAY,EAAE,gBAAgB,EAAE,UAAU,EAAE,QAAQ,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAK1F,OAAO,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAC;AAKzD,OAAO,EACL,mBAAmB,EACnB,wBAAwB,EACxB,uBAAuB,GACxB,MAAM,yBAAyB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAKH,cAAc,kBAAkB,CAAC;AAKjC,cAAc,gBAAgB,CAAC;AAC/B,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,gBAAgB,EAAE,GAAG,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AAKjG,OAAO,EACL,KAAK,EACL,OAAO,EACP,QAAQ,EACR,OAAO,EACP,IAAI,EACJ,SAAS,EACT,MAAM,EACN,UAAU,IAAI,mBAAmB,EACjC,QAAQ,EACR,GAAG,EACH,SAAS,EACT,KAAK,cAAc,EACnB,KAAK,iBAAiB,EACtB,SAAS,EACT,KAAK,cAAc,EACnB,SAAS,EACT,KAAK,cAAc,EAEnB,kBAAkB,EAClB,kBAAkB,EAClB,kBAAkB,EAElB,cAAc,EACd,KAAK,kBAAkB,EACvB,KAAK,kBAAkB,EACvB,KAAK,gBAAgB,EACrB,KAAK,cAAc,EACnB,KAAK,aAAa,EAClB,KAAK,eAAe,EAEpB,KAAK,oBAAoB,EACzB,KAAK,gBAAgB,EACrB,KAAK,aAAa,EAClB,KAAK,qBAAqB,GAC3B,MAAM,wBAAwB,CAAC;AAKhC,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,UAAU,EAAE,OAAO,EAAE,WAAW,EAAE,MAAM,EAAE,MAAM,OAAO,CAAC;AAKtF,OAAO,EACL,SAAS,EACT,WAAW,EACX,MAAM,EACN,YAAY,EAEZ,UAAU,EACV,YAAY,EACZ,cAAc,EACd,YAAY,EACZ,eAAe,EACf,iBAAiB,EACjB,eAAe,EAEf,OAAO,EACP,iBAAiB,EACjB,KAAK,cAAc,EACnB,WAAW,EACX,KAAK,kBAAkB,EACvB,KAAK,sBAAsB,EAE3B,WAAW,EAEX,WAAW,EAEX,UAAU,EACV,KAAK,eAAe,EAEpB,IAAI,EACJ,OAAO,EACP,KAAK,cAAc,EACnB,KAAK,SAAS,EACd,KAAK,SAAS,EAEd,IAAI,EACJ,MAAM,EACN,OAAO,EACP,KAAK,EACL,eAAe,EACf,uBAAuB,EACvB,KAAK,cAAc,EACnB,KAAK,QAAQ,EACb,KAAK,aAAa,EAClB,KAAK,eAAe,EACpB,KAAK,gBAAgB,EACrB,KAAK,iBAAiB,EACtB,KAAK,QAAQ,EACb,KAAK,SAAS,EACd,KAAK,aAAa,EAElB,cAAc,EACd,mBAAmB,EACnB,sBAAsB,EACtB,mBAAmB,EACnB,KAAK,WAAW,EAChB,KAAK,gBAAgB,GACtB,MAAM,SAAS,CAAC;AAKjB,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC1C,YAAY,EAAE,SAAS,EAAE,cAAc,EAAE,YAAY,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AAK/F,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAChD,YAAY,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAClD,YAAY,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAChE,cAAc,SAAS,CAAC;AAKxB,YAAY,EAAE,gBAAgB,EAAE,UAAU,EAAE,QAAQ,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAK1F,OAAO,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAC;AAKzD,OAAO,EACL,mBAAmB,EACnB,wBAAwB,EACxB,uBAAuB,GACxB,MAAM,yBAAyB,CAAC"}

package/dist/index.js

@@ -15,7 +15,9 @@ export { createApp, Agentick, AgentickInstance, run, runComponent, SessionImpl }
 // ============================================================================
 // JSX Components (re-export from jsx/components)
 // ============================================================================
-export { Model, Section, Timeline, Message, User, Assistant, System, ToolResult as ToolResultComponent, Markdown, XML, Collapsed, 
+export { Model, Section, Timeline, Message, User, Assistant, System, ToolResult as ToolResultComponent, Markdown, XML, Ephemeral, Grounding, Collapsed, 
+// Auto-summary for collapsed components
+autoMessageSummary, autoSectionSummary, autoContentSummary, 
 // Token budget (types + pure functions, used via Timeline props)
 compactEntries, } from "./jsx/components/index";
 // ============================================================================
@@ -36,6 +38,8 @@ useTimeline,
 useResolved, 
 // Expandable content
 Expandable, 
+// Gates
+gate, useGate, 
 // Knobs
 knob, isKnob, useKnob, Knobs, useKnobsContext, useKnobsContextOptional, 
 // Context utilization

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,+EAA+E;AAC/E,oBAAoB;AACpB,+EAA+E;AAC/E,cAAc,kBAAkB,CAAC;AAEjC,+EAA+E;AAC/E,gBAAgB;AAChB,+EAA+E;AAC/E,cAAc,gBAAgB,CAAC;AAC/B,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,gBAAgB,EAAE,GAAG,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AAEjG,+EAA+E;AAC/E,iDAAiD;AACjD,+EAA+E;AAC/E,OAAO,EACL,KAAK,EACL,OAAO,EACP,QAAQ,EACR,OAAO,EACP,IAAI,EACJ,SAAS,EACT,MAAM,EACN,UAAU,IAAI,mBAAmB,EACjC,QAAQ,EACR,GAAG,EACH,SAAS;AAET,iEAAiE;AACjE,cAAc,GAYf,MAAM,wBAAwB,CAAC;AAEhC,+EAA+E;AAC/E,uCAAuC;AACvC,+EAA+E;AAC/E,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,UAAU,EAAE,OAAO,EAAE,WAAW,EAAE,MAAM,EAAE,MAAM,OAAO,CAAC;AAEtF,+EAA+E;AAC/E,iBAAiB;AACjB,+EAA+E;AAC/E,OAAO,EACL,SAAS,EACT,WAAW,EACX,MAAM,EACN,YAAY;AACZ,kBAAkB;AAClB,UAAU,EACV,YAAY,EACZ,cAAc,EACd,YAAY,EACZ,eAAe,EACf,iBAAiB,EACjB,eAAe;AACf,aAAa;AACb,OAAO,EACP,iBAAiB,EAEjB,WAAW;AAGX,WAAW;AACX,WAAW;AACX,UAAU;AACV,WAAW;AACX,qBAAqB;AACrB,UAAU;AAEV,QAAQ;AACR,IAAI,EACJ,MAAM,EACN,OAAO,EACP,KAAK,EACL,eAAe,EACf,uBAAuB;AAUvB,sBAAsB;AACtB,cAAc,EACd,mBAAmB,EACnB,sBAAsB,EACtB,mBAAmB,GAGpB,MAAM,SAAS,CAAC;AAEjB,+EAA+E;AAC/E,QAAQ;AACR,+EAA+E;AAC/E,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAG1C,+EAA+E;AAC/E,QAAQ;AACR,+EAA+E;AAC/E,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAGhD,cAAc,SAAS,CAAC;AAOxB,+EAA+E;AAC/E,kBAAkB;AAClB,+EAA+E;AAC/E,OAAO,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAC;AAEzD,+EAA+E;AAC/E,WAAW;AACX,+EAA+E;AAC/E,OAAO,EACL,mBAAmB,EACnB,wBAAwB,EACxB,uBAAuB,GACxB,MAAM,yBAAyB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,+EAA+E;AAC/E,oBAAoB;AACpB,+EAA+E;AAC/E,cAAc,kBAAkB,CAAC;AAEjC,+EAA+E;AAC/E,gBAAgB;AAChB,+EAA+E;AAC/E,cAAc,gBAAgB,CAAC;AAC/B,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,gBAAgB,EAAE,GAAG,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AAEjG,+EAA+E;AAC/E,iDAAiD;AACjD,+EAA+E;AAC/E,OAAO,EACL,KAAK,EACL,OAAO,EACP,QAAQ,EACR,OAAO,EACP,IAAI,EACJ,SAAS,EACT,MAAM,EACN,UAAU,IAAI,mBAAmB,EACjC,QAAQ,EACR,GAAG,EACH,SAAS,EAGT,SAAS,EAET,SAAS;AAET,wCAAwC;AACxC,kBAAkB,EAClB,kBAAkB,EAClB,kBAAkB;AAClB,iEAAiE;AACjE,cAAc,GAYf,MAAM,wBAAwB,CAAC;AAEhC,+EAA+E;AAC/E,uCAAuC;AACvC,+EAA+E;AAC/E,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,UAAU,EAAE,OAAO,EAAE,WAAW,EAAE,MAAM,EAAE,MAAM,OAAO,CAAC;AAEtF,+EAA+E;AAC/E,iBAAiB;AACjB,+EAA+E;AAC/E,OAAO,EACL,SAAS,EACT,WAAW,EACX,MAAM,EACN,YAAY;AACZ,kBAAkB;AAClB,UAAU,EACV,YAAY,EACZ,cAAc,EACd,YAAY,EACZ,eAAe,EACf,iBAAiB,EACjB,eAAe;AACf,aAAa;AACb,OAAO,EACP,iBAAiB,EAEjB,WAAW;AAGX,WAAW;AACX,WAAW;AACX,UAAU;AACV,WAAW;AACX,qBAAqB;AACrB,UAAU;AAEV,QAAQ;AACR,IAAI,EACJ,OAAO;AAIP,QAAQ;AACR,IAAI,EACJ,MAAM,EACN,OAAO,EACP,KAAK,EACL,eAAe,EACf,uBAAuB;AAUvB,sBAAsB;AACtB,cAAc,EACd,mBAAmB,EACnB,sBAAsB,EACtB,mBAAmB,GAGpB,MAAM,SAAS,CAAC;AAEjB,+EAA+E;AAC/E,QAAQ;AACR,+EAA+E;AAC/E,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAG1C,+EAA+E;AAC/E,QAAQ;AACR,+EAA+E;AAC/E,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAGhD,cAAc,SAAS,CAAC;AAOxB,+EAA+E;AAC/E,kBAAkB;AAClB,+EAA+E;AAC/E,OAAO,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAC;AAEzD,+EAA+E;AAC/E,WAAW;AACX,+EAA+E;AAC/E,OAAO,EACL,mBAAmB,EACnB,wBAAwB,EACxB,uBAAuB,GACxB,MAAM,yBAAyB,CAAC"}

package/dist/jsx/components/auto-summary.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Auto-summary functions for collapsed components.
+ *
+ * Pure functions — no React, fully testable.
+ * Each returns a short text summary suitable for:
+ * - Knob description (model sees this in set_knob tool)
+ * - Collapsed rendering fallback (when collapsed={true})
+ */
+import type { ContentBlock, MessageRoles } from "@agentick/shared";
+/**
+ * Auto-summarize a message.
+ *
+ * Role-aware:
+ * - Assistant messages: text-only (no tool/media metadata).
+ *   Including fake metadata like "[tools: shell ×3]" in assistant
+ *   summaries causes ICL corruption — the model starts producing
+ *   literal metadata strings instead of real tool calls.
+ * - Other roles: role prefix + truncated text.
+ */
+export declare function autoMessageSummary(role: MessageRoles, content?: ContentBlock[] | string | any[]): string;
+/**
+ * Auto-summarize a section.
+ * Uses title, falls back to id, falls back to "section".
+ */
+export declare function autoSectionSummary(title?: string, id?: string): string;
+/**
+ * Auto-summarize a content block by type.
+ * Returns a type-specific default like "[image]", "[code: ts]", etc.
+ */
+export declare function autoContentSummary(type: string, props: Record<string, any>): string;
+//# sourceMappingURL=auto-summary.d.ts.map

package/dist/jsx/components/auto-summary.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"auto-summary.d.ts","sourceRoot":"","sources":["../../../src/jsx/components/auto-summary.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAUnE;;;;;;;;;GASG;AACH,wBAAgB,kBAAkB,CAChC,IAAI,EAAE,YAAY,EAClB,OAAO,CAAC,EAAE,YAAY,EAAE,GAAG,MAAM,GAAG,GAAG,EAAE,GACxC,MAAM,CAaR;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,CAAC,EAAE,MAAM,EAAE,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,CAEtE;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,MAAM,CAgCnF"}

package/dist/jsx/components/auto-summary.js

@@ -0,0 +1,83 @@
+/**
+ * Auto-summary functions for collapsed components.
+ *
+ * Pure functions — no React, fully testable.
+ * Each returns a short text summary suitable for:
+ * - Knob description (model sees this in set_knob tool)
+ * - Collapsed rendering fallback (when collapsed={true})
+ */
+import { extractText } from "@agentick/shared";
+const MAX_SUMMARY_LENGTH = 80;
+function truncate(text, max = MAX_SUMMARY_LENGTH) {
+    if (text.length <= max)
+        return text;
+    return text.slice(0, max - 1) + "…";
+}
+/**
+ * Auto-summarize a message.
+ *
+ * Role-aware:
+ * - Assistant messages: text-only (no tool/media metadata).
+ *   Including fake metadata like "[tools: shell ×3]" in assistant
+ *   summaries causes ICL corruption — the model starts producing
+ *   literal metadata strings instead of real tool calls.
+ * - Other roles: role prefix + truncated text.
+ */
+export function autoMessageSummary(role, content) {
+    if (!content)
+        return `[${role}]`;
+    const text = typeof content === "string" ? content : extractText(content, " ");
+    if (!text)
+        return `[${role}]`;
+    if (role === "assistant") {
+        // Text-only for assistant — never include tool/media metadata
+        return truncate(text);
+    }
+    return truncate(`${role}: ${text}`);
+}
+/**
+ * Auto-summarize a section.
+ * Uses title, falls back to id, falls back to "section".
+ */
+export function autoSectionSummary(title, id) {
+    return title ?? id ?? "section";
+}
+/**
+ * Auto-summarize a content block by type.
+ * Returns a type-specific default like "[image]", "[code: ts]", etc.
+ */
+export function autoContentSummary(type, props) {
+    switch (type) {
+        case "Text":
+        case "text": {
+            const text = props.text ?? props.children;
+            if (typeof text === "string")
+                return truncate(text);
+            return "[text]";
+        }
+        case "Image":
+        case "image":
+            return props.altText ? `[image: ${truncate(props.altText, 40)}]` : "[image]";
+        case "Code":
+        case "code":
+            return props.language ? `[code: ${props.language}]` : "[code]";
+        case "Json":
+        case "json":
+            return "[json]";
+        case "Document":
+        case "document":
+            return props.title ? `[document: ${truncate(props.title, 40)}]` : "[document]";
+        case "Audio":
+        case "audio":
+            return "[audio]";
+        case "Video":
+        case "video":
+            return "[video]";
+        case "ToolUse":
+        case "tooluse":
+            return props.name ? `[tool: ${props.name}]` : "[tool]";
+        default:
+            return `[${type}]`;
+    }
+}
+//# sourceMappingURL=auto-summary.js.map

package/dist/jsx/components/auto-summary.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"auto-summary.js","sourceRoot":"","sources":["../../../src/jsx/components/auto-summary.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAE/C,MAAM,kBAAkB,GAAG,EAAE,CAAC;AAE9B,SAAS,QAAQ,CAAC,IAAY,EAAE,GAAG,GAAG,kBAAkB;IACtD,IAAI,IAAI,CAAC,MAAM,IAAI,GAAG;QAAE,OAAO,IAAI,CAAC;IACpC,OAAO,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,GAAG,CAAC,CAAC,GAAG,GAAG,CAAC;AACtC,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,UAAU,kBAAkB,CAChC,IAAkB,EAClB,OAAyC;IAEzC,IAAI,CAAC,OAAO;QAAE,OAAO,IAAI,IAAI,GAAG,CAAC;IAEjC,MAAM,IAAI,GAAG,OAAO,OAAO,KAAK,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,WAAW,CAAC,OAAyB,EAAE,GAAG,CAAC,CAAC;IAEjG,IAAI,CAAC,IAAI;QAAE,OAAO,IAAI,IAAI,GAAG,CAAC;IAE9B,IAAI,IAAI,KAAK,WAAW,EAAE,CAAC;QACzB,8DAA8D;QAC9D,OAAO,QAAQ,CAAC,IAAI,CAAC,CAAC;IACxB,CAAC;IAED,OAAO,QAAQ,CAAC,GAAG,IAAI,KAAK,IAAI,EAAE,CAAC,CAAC;AACtC,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,kBAAkB,CAAC,KAAc,EAAE,EAAW;IAC5D,OAAO,KAAK,IAAI,EAAE,IAAI,SAAS,CAAC;AAClC,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,kBAAkB,CAAC,IAAY,EAAE,KAA0B;IACzE,QAAQ,IAAI,EAAE,CAAC;QACb,KAAK,MAAM,CAAC;QACZ,KAAK,MAAM,CAAC,CAAC,CAAC;YACZ,MAAM,IAAI,GAAG,KAAK,CAAC,IAAI,IAAI,KAAK,CAAC,QAAQ,CAAC;YAC1C,IAAI,OAAO,IAAI,KAAK,QAAQ;gBAAE,OAAO,QAAQ,CAAC,IAAI,CAAC,CAAC;YACpD,OAAO,QAAQ,CAAC;QAClB,CAAC;QACD,KAAK,OAAO,CAAC;QACb,KAAK,OAAO;YACV,OAAO,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,WAAW,QAAQ,CAAC,KAAK,CAAC,OAAO,EAAE,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,SAAS,CAAC;QAC/E,KAAK,MAAM,CAAC;QACZ,KAAK,MAAM;YACT,OAAO,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAC,UAAU,KAAK,CAAC,QAAQ,GAAG,CAAC,CAAC,CAAC,QAAQ,CAAC;QACjE,KAAK,MAAM,CAAC;QACZ,KAAK,MAAM;YACT,OAAO,QAAQ,CAAC;QAClB,KAAK,UAAU,CAAC;QAChB,KAAK,UAAU;YACb,OAAO,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,cAAc,QAAQ,CAAC,KAAK,CAAC,KAAK,EAAE,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,YAAY,CAAC;QACjF,KAAK,OAAO,CAAC;QACb,KAAK,OAAO;YACV,OAAO,SAAS,CAAC;QACnB,KAAK,OAAO,CAAC;QACb,KAAK,OAAO;YACV,OAAO,SAAS,CAAC;QACnB,KAAK,SAAS,CAAC;QACf,KAAK,SAAS;YACZ,OAAO,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,UAAU,KAAK,CAAC,IAAI,GAAG,CAAC,CAAC,CAAC,QAAQ,CAAC;QACzD;YACE,OAAO,IAAI,IAAI,GAAG,CAAC;IACvB,CAAC;AACH,CAAC"}