@agentick/core 0.7.0 → 0.9.0

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";
 // ============================================================================
@@ -27,7 +29,7 @@ export { useState, useEffect, useReducer, useMemo, useCallback, useRef } from "r
 // ============================================================================
 export { useSignal, useComputed, useCom, useTickState, 
 // Lifecycle hooks
-useOnMount, useOnUnmount, useOnTickStart, useOnTickEnd, useAfterCompile, useOnExecutionEnd, useContinuation, 
+useOnMount, useOnUnmount, useOnTickStart, useOnTickEnd, useAfterCompile, useOnExecutionEnd, useOnExecutionStart, useContinuation, 
 // Data hooks
 useData, useInvalidateData, useComState, 
 // Timeline
@@ -36,6 +38,8 @@ useTimeline,
 useResolved, 
 // Expandable content
 Expandable, 
+// Gates
+gate, useGate, 
 // Knobs
 knob, isKnob, useKnob, Knobs, useKnobsContext, useKnobsContextOptional, 
 // Context utilization
@@ -43,7 +47,7 @@ useContextInfo, useContextInfoStore, createContextInfoStore, ContextInfoProvider
 // ============================================================================
 // Tools
 // ============================================================================
-export { createTool } from "./tool/index";
+export { createTool, useToolProcedure } from "./tool/index";
 // ============================================================================
 // Model
 // ============================================================================

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,mBAAmB,EACnB,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,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAG5D,+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"}

package/dist/jsx/components/collapsed.d.ts

@@ -2,11 +2,21 @@ import React from "react";
 export interface CollapsedProps {
     name: string;
     group?: string;
-    children?: string;
+    children?: React.ReactNode;
 }
+/**
+ * Collapsed intrinsic wrapper.
+ *
+ * Compiles to a text content block with semantic metadata:
+ * - `rendererTag: "collapsed"` for format-specific rendering
+ * - `rendererAttrs: { name, group }` for expand targeting
+ *
+ * String children pass through as `text` prop.
+ * ReactNode children render as child elements — the collector's
+ * extractText recursively collects text from them.
+ */
 export declare function Collapsed({ name, group, children }: CollapsedProps): React.ReactElement<{
     name: string;
     group: string | undefined;
-    text: string;
 }, string | React.JSXElementConstructor<any>>;
 //# sourceMappingURL=collapsed.d.ts.map

package/dist/jsx/components/collapsed.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"collapsed.d.ts","sourceRoot":"","sources":["../../../src/jsx/components/collapsed.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAI1B,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,wBAAgB,SAAS,CAAC,EAAE,IAAI,EAAE,KAAK,EAAE,QAAQ,EAAE,EAAE,cAAc;;;;8CAElE"}
+{"version":3,"file":"collapsed.d.ts","sourceRoot":"","sources":["../../../src/jsx/components/collapsed.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAI1B,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;CAC5B;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,SAAS,CAAC,EAAE,IAAI,EAAE,KAAK,EAAE,QAAQ,EAAE,EAAE,cAAc;;;8CAMlE"}

package/dist/jsx/components/collapsed.js

@@ -1,6 +1,21 @@
 import React from "react";
 const h = React.createElement;
+/**
+ * Collapsed intrinsic wrapper.
+ *
+ * Compiles to a text content block with semantic metadata:
+ * - `rendererTag: "collapsed"` for format-specific rendering
+ * - `rendererAttrs: { name, group }` for expand targeting
+ *
+ * String children pass through as `text` prop.
+ * ReactNode children render as child elements — the collector's
+ * extractText recursively collects text from them.
+ */
 export function Collapsed({ name, group, children }) {
-    return h("Collapsed", { name, group, text: children ?? "" });
+    if (typeof children === "string" || typeof children === "number") {
+        return h("Collapsed", { name, group, text: String(children) });
+    }
+    // ReactNode children: render as child elements for recursive text extraction
+    return h("Collapsed", { name, group }, children);
 }
 //# sourceMappingURL=collapsed.js.map

package/dist/jsx/components/collapsed.js.map

@@ -1 +1 @@
-{"version":3,"file":"collapsed.js","sourceRoot":"","sources":["../../../src/jsx/components/collapsed.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAE1B,MAAM,CAAC,GAAG,KAAK,CAAC,aAAa,CAAC;AAQ9B,MAAM,UAAU,SAAS,CAAC,EAAE,IAAI,EAAE,KAAK,EAAE,QAAQ,EAAkB;IACjE,OAAO,CAAC,CAAC,WAAW,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,QAAQ,IAAI,EAAE,EAAE,CAAC,CAAC;AAC/D,CAAC"}
+{"version":3,"file":"collapsed.js","sourceRoot":"","sources":["../../../src/jsx/components/collapsed.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAE1B,MAAM,CAAC,GAAG,KAAK,CAAC,aAAa,CAAC;AAQ9B;;;;;;;;;;GAUG;AACH,MAAM,UAAU,SAAS,CAAC,EAAE,IAAI,EAAE,KAAK,EAAE,QAAQ,EAAkB;IACjE,IAAI,OAAO,QAAQ,KAAK,QAAQ,IAAI,OAAO,QAAQ,KAAK,QAAQ,EAAE,CAAC;QACjE,OAAO,CAAC,CAAC,WAAW,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC;IACjE,CAAC;IACD,6EAA6E;IAC7E,OAAO,CAAC,CAAC,WAAW,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,EAAE,QAAQ,CAAC,CAAC;AACnD,CAAC"}

package/dist/jsx/components/content.d.ts

@@ -1,12 +1,27 @@
+import React from "react";
 import type { JSX } from "react";
 import type { ContentBlock as ContentBlockType, MediaSource } from "@agentick/shared";
 import type { CodeLanguage } from "@agentick/shared";
 import type { ComponentBaseProps } from "../jsx-types";
+/**
+ * Collapse props shared by all expandable content blocks.
+ * When `collapsed` is provided, the block renders an Expandable wrapper
+ * that shows a summary by default, expandable via set_knob.
+ *
+ * - `true`: auto-summarize based on content block type
+ * - `string`: use this string as the collapsed summary
+ * - `ReactNode`: render this as collapsed content (must produce text)
+ */
+export interface CollapseProps {
+    collapsed?: boolean | string | React.ReactNode;
+    collapsedName?: string;
+    collapsedGroup?: string;
+}
 /**
  * Content component primitives for composing Message content.
  * These provide a React-like API for building ContentBlock[].
  */
-export interface ContentBlockProps extends ComponentBaseProps {
+export interface ContentBlockProps extends ComponentBaseProps, CollapseProps {
     id?: string;
 }
 export type { ContentBlockType };
@@ -14,19 +29,9 @@ export type { ContentBlockType };
  * Text content block.
  * Usage: <Text>Hello world</Text> or <Text text="Hello" />
  *
- * Children take precedence over text prop (React convention - explicit wins).
- * Children can include JSX formatting elements (bold, italic, code, etc.)
- * which will be collected and formatted appropriately.
- *
  * @example
- * // Plain text
  * <Text>Hello world</Text>
- *
- * // With inline formatting
  * <Text>Hello <b>bold</b> and <inlineCode>code</inlineCode></Text>
- *
- * // With dynamic content
- * <Text><b>{isOld ? '[OLD] ' : ''}</b>{message.text}</Text>
  */
 export interface TextProps extends ContentBlockProps {
     children?: any;
@@ -86,8 +91,6 @@ export declare function Code(props: CodeProps): JSX.Element;
 /**
  * JSON content block.
  * Usage: <Json data={{ key: 'value' }} />
- *
- * Children take precedence over text prop (React convention - explicit wins).
  */
 export interface JsonProps extends ContentBlockProps {
     data?: any;
@@ -95,4 +98,14 @@ export interface JsonProps extends ContentBlockProps {
     text?: string;
 }
 export declare function Json(props: JsonProps): JSX.Element;
+/**
+ * Tool use content block.
+ * Usage: <ToolUse name="shell" toolUseId="call_1" input={{ cmd: "ls" }} />
+ */
+export interface ToolUseProps extends ContentBlockProps {
+    name: string;
+    toolUseId: string;
+    input?: Record<string, unknown>;
+}
+export declare function ToolUse(props: ToolUseProps): JSX.Element;
 //# sourceMappingURL=content.d.ts.map

package/dist/jsx/components/content.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"content.d.ts","sourceRoot":"","sources":["../../../src/jsx/components/content.tsx"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,OAAO,CAAC;AACjC,OAAO,KAAK,EAAE,YAAY,IAAI,gBAAgB,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AACtF,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AACrD,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC;AAKvD;;;GAGG;AACH,MAAM,WAAW,iBAAkB,SAAQ,kBAAkB;IAC3D,EAAE,CAAC,EAAE,MAAM,CAAC;CACb;AAGD,YAAY,EAAE,gBAAgB,EAAE,CAAC;AAEjC;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,WAAW,SAAU,SAAQ,iBAAiB;IAClD,QAAQ,CAAC,EAAE,GAAG,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AACD,wBAAgB,IAAI,CAAC,KAAK,EAAE,SAAS,GAAG,GAAG,CAAC,OAAO,CAElD;AAED;;;GAGG;AACH,MAAM,WAAW,UAAW,SAAQ,iBAAiB;IACnD,MAAM,EAAE,WAAW,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AACD,wBAAgB,KAAK,CAAC,KAAK,EAAE,UAAU,GAAG,GAAG,CAAC,OAAO,CAEpD;AAED;;;GAGG;AACH,MAAM,WAAW,aAAc,SAAQ,iBAAiB;IACtD,MAAM,EAAE,WAAW,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AACD,wBAAgB,QAAQ,CAAC,KAAK,EAAE,aAAa,GAAG,GAAG,CAAC,OAAO,CAE1D;AAED;;;GAGG;AACH,MAAM,WAAW,UAAW,SAAQ,iBAAiB;IACnD,MAAM,EAAE,WAAW,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AACD,wBAAgB,KAAK,CAAC,KAAK,EAAE,UAAU,GAAG,GAAG,CAAC,OAAO,CAEpD;AAED;;;GAGG;AACH,MAAM,WAAW,UAAW,SAAQ,iBAAiB;IACnD,MAAM,EAAE,WAAW,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AACD,wBAAgB,KAAK,CAAC,KAAK,EAAE,UAAU,GAAG,GAAG,CAAC,OAAO,CAEpD;AAED;;;GAGG;AACH,MAAM,WAAW,SAAU,SAAQ,iBAAiB;IAClD,QAAQ,EAAE,YAAY,GAAG,MAAM,CAAC;IAChC,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;IAC7B,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AACD,wBAAgB,IAAI,CAAC,KAAK,EAAE,SAAS,GAAG,GAAG,CAAC,OAAO,CAElD;AAED;;;;;GAKG;AACH,MAAM,WAAW,SAAU,SAAQ,iBAAiB;IAClD,IAAI,CAAC,EAAE,GAAG,CAAC;IACX,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;IAC7B,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AACD,wBAAgB,IAAI,CAAC,KAAK,EAAE,SAAS,GAAG,GAAG,CAAC,OAAO,CAYlD"}
+{"version":3,"file":"content.d.ts","sourceRoot":"","sources":["../../../src/jsx/components/content.tsx"],"names":[],"mappings":"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"}

package/dist/jsx/components/content.js

@@ -1,36 +1,85 @@
 import React from "react";
+import { Expandable } from "../../hooks/expandable";
+import { Collapsed } from "./collapsed";
+import { autoContentSummary } from "./auto-summary";
 // Helper for createElement
 const h = React.createElement;
+// ============================================================================
+// Helper to strip collapse props before passing to intrinsic elements
+// ============================================================================
+function stripCollapse(props) {
+    const { collapsed: _c, collapsedName: _cn, collapsedGroup: _cg, ...rest } = props;
+    return rest;
+}
+/**
+ * Wrap an intrinsic element in Expandable when collapsed prop is set.
+ * Collapsed state renders a Collapsed intrinsic; expanded renders the original block.
+ *
+ * The `intrinsicType` and `intrinsicProps` are needed for auto-summary
+ * when collapsed={true} — the summary is derived from the block type and props.
+ */
+function withCollapse(props, intrinsic, intrinsicType, intrinsicProps) {
+    if (props.collapsed === undefined || props.collapsed === false)
+        return intrinsic;
+    // Derive knob summary (always a string, for set_knob tool description)
+    const summary = typeof props.collapsed === "string"
+        ? props.collapsed
+        : autoContentSummary(intrinsicType, intrinsicProps);
+    // Derive collapsed children for the Collapsed intrinsic
+    const collapsedChildren = props.collapsed === true ? summary : props.collapsed;
+    return h(Expandable, {
+        name: props.collapsedName,
+        group: props.collapsedGroup,
+        summary,
+        children: (expanded, name) => expanded ? intrinsic : h(Collapsed, { name, group: props.collapsedGroup }, collapsedChildren),
+    });
+}
 export function Text(props) {
-    return h("Text", props);
+    const stripped = stripCollapse(props);
+    return withCollapse(props, h("Text", stripped), "Text", stripped);
 }
 export function Image(props) {
-    return h("Image", props);
+    const stripped = stripCollapse(props);
+    return withCollapse(props, h("Image", stripped), "Image", stripped);
 }
 export function Document(props) {
-    return h("Document", props);
+    const stripped = stripCollapse(props);
+    return withCollapse(props, h("Document", stripped), "Document", stripped);
 }
 export function Audio(props) {
-    return h("Audio", props);
+    const stripped = stripCollapse(props);
+    return withCollapse(props, h("Audio", stripped), "Audio", stripped);
 }
 export function Video(props) {
-    return h("Video", props);
+    const stripped = stripCollapse(props);
+    return withCollapse(props, h("Video", stripped), "Video", stripped);
 }
 export function Code(props) {
-    return h("Code", props);
+    const stripped = stripCollapse(props);
+    return withCollapse(props, h("Code", stripped), "Code", stripped);
 }
 export function Json(props) {
-    const childrenText = props.children !== undefined
-        ? typeof props.children === "string"
-            ? props.children
-            : props.children?.join("") || ""
+    const stripped = stripCollapse(props);
+    const childrenText = stripped.children !== undefined
+        ? typeof stripped.children === "string"
+            ? stripped.children
+            : stripped.children?.join("") || ""
         : undefined;
-    const text = childrenText ?? props.text ?? "";
-    return h("Json", {
-        ...omit(props, ["children"]),
-        text: text || JSON.stringify(props.data),
-    });
+    const text = childrenText ?? stripped.text ?? "";
+    const intrinsicProps = {
+        ...omit(stripped, ["children"]),
+        text: text || JSON.stringify(stripped.data),
+    };
+    const intrinsic = h("Json", intrinsicProps);
+    return withCollapse(props, intrinsic, "Json", intrinsicProps);
+}
+export function ToolUse(props) {
+    const stripped = stripCollapse(props);
+    return withCollapse(props, h("ToolUse", stripped), "ToolUse", stripped);
 }
+// ============================================================================
+// Helpers
+// ============================================================================
 function omit(obj, keys) {
     const result = { ...obj };
     for (const key of keys) {

package/dist/jsx/components/content.js.map

@@ -1 +1 @@
-{"version":3,"file":"content.js","sourceRoot":"","sources":["../../../src/jsx/components/content.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAM1B,2BAA2B;AAC3B,MAAM,CAAC,GAAG,KAAK,CAAC,aAAa,CAAC;AAmC9B,MAAM,UAAU,IAAI,CAAC,KAAgB;IACnC,OAAO,CAAC,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;AAC1B,CAAC;AAWD,MAAM,UAAU,KAAK,CAAC,KAAiB;IACrC,OAAO,CAAC,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;AAC3B,CAAC;AAWD,MAAM,UAAU,QAAQ,CAAC,KAAoB;IAC3C,OAAO,CAAC,CAAC,UAAU,EAAE,KAAK,CAAC,CAAC;AAC9B,CAAC;AAWD,MAAM,UAAU,KAAK,CAAC,KAAiB;IACrC,OAAO,CAAC,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;AAC3B,CAAC;AAWD,MAAM,UAAU,KAAK,CAAC,KAAiB;IACrC,OAAO,CAAC,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;AAC3B,CAAC;AAWD,MAAM,UAAU,IAAI,CAAC,KAAgB;IACnC,OAAO,CAAC,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;AAC1B,CAAC;AAaD,MAAM,UAAU,IAAI,CAAC,KAAgB;IACnC,MAAM,YAAY,GAChB,KAAK,CAAC,QAAQ,KAAK,SAAS;QAC1B,CAAC,CAAC,OAAO,KAAK,CAAC,QAAQ,KAAK,QAAQ;YAClC,CAAC,CAAC,KAAK,CAAC,QAAQ;YAChB,CAAC,CAAC,KAAK,CAAC,QAAQ,EAAE,IAAI,CAAC,EAAE,CAAC,IAAI,EAAE;QAClC,CAAC,CAAC,SAAS,CAAC;IAChB,MAAM,IAAI,GAAG,YAAY,IAAI,KAAK,CAAC,IAAI,IAAI,EAAE,CAAC;IAC9C,OAAO,CAAC,CAAC,MAAM,EAAE;QACf,GAAG,IAAI,CAAC,KAAK,EAAE,CAAC,UAAU,CAAC,CAAC;QAC5B,IAAI,EAAE,IAAI,IAAI,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,IAAI,CAAC;KACzC,CAAC,CAAC;AACL,CAAC;AAED,SAAS,IAAI,CAAuB,GAAM,EAAE,IAAS;IACnD,MAAM,MAAM,GAAQ,EAAE,GAAG,GAAG,EAAE,CAAC;IAC/B,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;QACvB,OAAO,MAAM,CAAC,GAAG,CAAC,CAAC;IACrB,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC"}
+{"version":3,"file":"content.js","sourceRoot":"","sources":["../../../src/jsx/components/content.tsx"],"names":[],"mappings":"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"}

package/dist/jsx/components/index.d.ts

@@ -9,4 +9,5 @@ export * from "./xml";
 export * from "./token-budget";
 export * from "./timeline";
 export * from "./collapsed";
+export * from "./auto-summary";
 //# sourceMappingURL=index.d.ts.map

package/dist/jsx/components/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/jsx/components/index.ts"],"names":[],"mappings":"AAAA,cAAc,SAAS,CAAC;AACxB,cAAc,cAAc,CAAC;AAC7B,cAAc,YAAY,CAAC;AAC3B,cAAc,YAAY,CAAC;AAC3B,cAAc,WAAW,CAAC;AAC1B,cAAc,YAAY,CAAC;AAC3B,cAAc,YAAY,CAAC;AAC3B,cAAc,OAAO,CAAC;AACtB,cAAc,gBAAgB,CAAC;AAC/B,cAAc,YAAY,CAAC;AAC3B,cAAc,aAAa,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/jsx/components/index.ts"],"names":[],"mappings":"AAAA,cAAc,SAAS,CAAC;AACxB,cAAc,cAAc,CAAC;AAC7B,cAAc,YAAY,CAAC;AAC3B,cAAc,YAAY,CAAC;AAC3B,cAAc,WAAW,CAAC;AAC1B,cAAc,YAAY,CAAC;AAC3B,cAAc,YAAY,CAAC;AAC3B,cAAc,OAAO,CAAC;AACtB,cAAc,gBAAgB,CAAC;AAC/B,cAAc,YAAY,CAAC;AAC3B,cAAc,aAAa,CAAC;AAC5B,cAAc,gBAAgB,CAAC"}

package/dist/jsx/components/index.js

@@ -9,4 +9,5 @@ export * from "./xml";
 export * from "./token-budget";
 export * from "./timeline";
 export * from "./collapsed";
+export * from "./auto-summary";
 //# sourceMappingURL=index.js.map

package/dist/jsx/components/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/jsx/components/index.ts"],"names":[],"mappings":"AAAA,cAAc,SAAS,CAAC;AACxB,cAAc,cAAc,CAAC;AAC7B,cAAc,YAAY,CAAC;AAC3B,cAAc,YAAY,CAAC;AAC3B,cAAc,WAAW,CAAC;AAC1B,cAAc,YAAY,CAAC;AAC3B,cAAc,YAAY,CAAC;AAC3B,cAAc,OAAO,CAAC;AACtB,cAAc,gBAAgB,CAAC;AAC/B,cAAc,YAAY,CAAC;AAC3B,cAAc,aAAa,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/jsx/components/index.ts"],"names":[],"mappings":"AAAA,cAAc,SAAS,CAAC;AACxB,cAAc,cAAc,CAAC;AAC7B,cAAc,YAAY,CAAC;AAC3B,cAAc,YAAY,CAAC;AAC3B,cAAc,WAAW,CAAC;AAC1B,cAAc,YAAY,CAAC;AAC3B,cAAc,YAAY,CAAC;AAC3B,cAAc,OAAO,CAAC;AACtB,cAAc,gBAAgB,CAAC;AAC/B,cAAc,YAAY,CAAC;AAC3B,cAAc,aAAa,CAAC;AAC5B,cAAc,gBAAgB,CAAC"}

package/dist/jsx/components/primitives.d.ts

@@ -1,4 +1,5 @@
 import type { ContentBlock, Message, MessageRoles } from "@agentick/shared";
+import React from "react";
 import type { JSX } from "react";
 import type { JSX as AgentickJSX } from "../jsx-runtime";
 import type { StreamEvent } from "../../engine/engine-events";
@@ -66,12 +67,31 @@ export type EntryProps = {
     } & EntryCommonProps;
 }[EntryKind];
 export declare function Entry(props: EntryProps): JSX.Element;
+/**
+ * Section primitive component props.
+ * Extends intrinsic section props with collapse support.
+ */
+export type SectionProps = AgentickJSX.IntrinsicElements["section"] & {
+    /**
+     * Enables collapse behavior.
+     * - `true`: auto-summarize from title/id
+     * - `string`: use as collapsed summary
+     * - `ReactNode`: render as collapsed content (must produce text)
+     */
+    collapsed?: boolean | string | React.ReactNode;
+    /** Explicit knob name for collapse toggle. Auto-generated if omitted. */
+    collapsedName?: string;
+    /** Group name for batch expansion via set_knob. */
+    collapsedGroup?: string;
+};
 /**
  * Section primitive component.
  * When used in JSX: <Section id="..." content="..." />
  * Returns an intrinsic "section" element for react-reconciler compatibility.
+ *
+ * When `collapsed` is provided, enables collapse/expand behavior via knob.
  */
-export declare function Section(props: AgentickJSX.IntrinsicElements["section"]): JSX.Element;
+export declare function Section(props: SectionProps): JSX.Element;
 /**
  * Message primitive component props.
  * Allows spreading Message objects directly, plus JSX-specific props.
@@ -88,16 +108,28 @@ export type MessageProps = Partial<Omit<Message, "content" | "role">> & {
     tags?: string[];
     visibility?: "model" | "observer" | "log";
     children?: any;
+    /**
+     * Enables collapse behavior.
+     * - `true`: auto-summarize from role and content
+     * - `string`: use as collapsed summary
+     * - `ReactNode`: render as collapsed content (must produce text)
+     */
+    collapsed?: boolean | string | React.ReactNode;
+    /** Explicit knob name for collapse toggle. Auto-generated if omitted. */
+    collapsedName?: string;
+    /** Group name for batch expansion via set_knob. */
+    collapsedGroup?: string;
 } & ComponentBaseProps;
 /**
  * Message primitive component.
- * Semantic sugar wrapper that wraps Entry with kind="message" for intuitive API.
  *
  * Accepts Message objects via spreading, converts to Entry structure.
+ * When `collapsed` is provided, enables collapse/expand behavior via knob.
  *
  * Usage:
  *   <Message role="user">Hello</Message>
  *   <Message {...messageFromTimeline} tags={['important']} />
+ *   <Message {...msg} collapsed="[ref:3] user asked about weather" />
  * Compiles to: <Entry kind="message" message={{ role: 'user', content: [...] }} />
  */
 export declare function Message(props: MessageProps): JSX.Element;

package/dist/jsx/components/primitives.d.ts.map

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