agentic-ui-kit 0.4.0 → 0.5.1

package/README.md

@@ -35,6 +35,12 @@ pnpm --filter agentic-ui-kit pack        # builds and writes agentic-ui-kit-0.1.
 cd ../your-app && npm install ../agentic-ui-kit/agentic-ui-kit-0.1.0.tgz
 ```
 
+### Upgrading
+
+Vite pre-bundles dependencies. After you upgrade the kit, a running dev server can keep serving the old
+build, and you get errors like "does not provide an export named …". Restart it with `vite --force` (or
+delete `node_modules/.vite`).
+
 ## Quick start
 
 ```tsx

package/dist/core.js

@@ -1,5 +1,10 @@
-import { A as salvageJson, C as awaitingToolCalls, D as resolveEffort, E as reduceEvents, O as settleToolCall, S as applyEvent, T as outputTokens, _ as formatEvent, a as readUiValue, b as toBlocks, c as uiMarkupGuide, d as isStateRef, f as matchesSchema, g as uiActionSchema, h as schemaErrors, i as parseUiMarkup, k as parsePartialJson, l as uiMarkupLanguage, m as renderUiToolName, n as checkUiMarkupCode, o as showUiTool, p as renderUiTool, r as findUiBlocks, s as showUiToolName, t as checkUiMarkup, u as checkUiTree, v as readEventStream, w as estimateTokens, x as activityTokens, y as isActivityPart } from "./ui-markup-DtMYer7I.js";
+import { A as awaitingToolCalls, C as widgetLoaderMessages, D as toBlocks, E as isActivityPart, F as settleToolCall, I as parsePartialJson, L as salvageJson, M as outputTokens, N as reduceEvents, O as activityTokens, P as resolveEffort, S as widgetFrameLoader, T as readEventStream, _ as replacedId, a as readUiValue, b as resolveReplaces, c as uiMarkupGuide, d as isStateRef, f as matchesSchema, g as uiActionSchema, h as schemaErrors, i as parseUiMarkup, j as estimateTokens, k as applyEvent, l as uiMarkupLanguage, m as renderUiToolName, n as checkUiMarkupCode, o as showUiTool, p as renderUiTool, r as findUiBlocks, s as showUiToolName, t as checkUiMarkup, u as checkUiTree, v as replacesGuide, w as formatEvent, x as withCallId, y as replacesProperty } from "./src-Ce7xTfGU.js";
 // ../core/src/visualize.ts
+/**
+* The visualize preset: a tool the model calls to draw an interactive visual inline (like claude.ai's
+* visualize tool), and the design guide to put in the system prompt. The kit's `show_widget` tool view feeds
+* the streaming `widget_code` into a sandboxed WidgetFrame. The backend runs the tool as a no-op ("shown").
+*/
 /** The tool definition to give the model. Same shape as a page tool's `ToolSpec`. */
 const visualizeTool = {
 	name: "show_widget",
@@ -21,7 +26,8 @@ const visualizeTool = {
 				minItems: 1,
 				maxItems: 4,
 				description: "1-4 short lines shown while you write it, e.g. \"Finding free slots\"."
-			}
+			},
+			replaces: replacesProperty
 		},
 		required: ["widget_code"]
 	}
@@ -40,6 +46,7 @@ How the frame works
 - Two globals: sendPrompt(text) sends a message as the user (for "Add these to my calendar", "Explain this"),
   openLink(url) opens an http(s) link. Prefer local state (JavaScript in the widget) over round trips: filter,
   toggle, recalculate and animate in place; use sendPrompt only for what needs you.
+- ${replacesGuide}
 
 Look
 - Use the chat's theme variables, never hard-coded colors or fonts: var(--chat-fg) text, var(--chat-muted) and
@@ -90,7 +97,7 @@ function checkWidgetCode(html, allow = {}, toolName = visualizeTool.name) {
 		ok,
 		errors,
 		warnings,
-		feedback: ok && !warnings.length ? "Shown to the user." : ok ? `Shown. To fit the chat better next time:\n${lines}` : `Shown, but it will not work as written. Fix these and call ${toolName} again, without remarking on the fix to the user:\n${lines}`
+		feedback: ok && !warnings.length ? "Shown to the user." : ok ? `Shown to the user, and it works: do not draw it again now. Next time, to fit the chat better:\n${lines}` : `Shown, but it will not work as written. Fix these and call ${toolName} again with "replaces" set to this call's id, without remarking on the fix to the user:\n${lines}`
 	};
 }
-export { activityTokens, applyEvent, awaitingToolCalls, checkUiMarkup, checkUiMarkupCode, checkUiTree, checkWidgetCode, estimateTokens, findUiBlocks, formatEvent, isActivityPart, isStateRef, matchesSchema, outputTokens, parsePartialJson, parseUiMarkup, readEventStream, readUiValue, reduceEvents, renderUiTool, renderUiToolName, resolveEffort, salvageJson, schemaErrors, settleToolCall, showUiTool, showUiToolName, toBlocks, uiActionSchema, uiMarkupGuide, uiMarkupLanguage, visualizeGuide, visualizeTool };
+export { activityTokens, applyEvent, awaitingToolCalls, checkUiMarkup, checkUiMarkupCode, checkUiTree, checkWidgetCode, estimateTokens, findUiBlocks, formatEvent, isActivityPart, isStateRef, matchesSchema, outputTokens, parsePartialJson, parseUiMarkup, readEventStream, readUiValue, reduceEvents, renderUiTool, renderUiToolName, replacedId, replacesGuide, replacesProperty, resolveEffort, resolveReplaces, salvageJson, schemaErrors, settleToolCall, showUiTool, showUiToolName, toBlocks, uiActionSchema, uiMarkupGuide, uiMarkupLanguage, visualizeGuide, visualizeTool, widgetFrameLoader, widgetLoaderMessages, withCallId };