@agent-native/core 0.103.1 → 0.104.0

package/corpus/README.md

@@ -27,5 +27,5 @@ rg -n "defineAction|useActionQuery" node_modules/@agent-native/core/corpus
 
 ## Generated Counts
 
-- core files: 2259
-- template files: 6007
+- core files: 2277
+- template files: 6054

package/corpus/core/CHANGELOG.md

@@ -1,5 +1,35 @@
 # @agent-native/core
 
+## 0.104.0
+
+### Minor Changes
+
+- 2625de5: Add the Creative Context package for importing, versioning, searching, and reusing workspace decks, designs, assets, websites, and content across creative apps.
+
+  Expose reusable ingestion, prompt-context provider, and search utility seams from core for package-driven creative context.
+
+  Includes bounded image-region cropping for durable localized creative-context fallbacks.
+
+- 2625de5: Redesign the agent workspace with plain files first, dedicated resource collections, and a snapshots view for recent context inspection.
+- 2625de5: Add public session replay context and timestamped Analytics links, support host-owned tracking identity, and allow Analytics replay pages to open at a requested timeline offset.
+
+### Patch Changes
+
+- 2625de5: Disable app-shell transitions across the shared AgentSidebar subtree while the sidebar is being resized.
+- 2625de5: Count explicitly failed action tool events as errors in observability traces and summaries even when their result text does not start with `Error`.
+- 2625de5: Fix managed Slack OAuth to resolve scoped app credentials within the signed-in request context.
+- 2625de5: Render dashboard, form, and other resource context as a normal composer chip instead of a scoped-chat badge and history partition.
+- 2625de5: Protect existing extension visual design during data-only repairs by requiring explicit intent for full-body replacements, stop deterministic edit failures before the agent retries the same arguments, and resume cleanly when a provider closes while an action input is still being assembled.
+- 2625de5: Teach Plan agents to fence destructive edits against fresh plan revisions and verify persisted content before closing feedback.
+- 2625de5: Inline `AgentChatSurface` and `AgentChatHome` instances now hide the legacy Chat/Workspace header and chat tab row by default.
+- 2625de5: Share package-registered actions across runtime module instances and mount them alongside explicit app action registries.
+- 2625de5: Keep sidebar chat tabs visible in the header and place them beside the new-chat, options, and close controls.
+- 2625de5: Re-enable the sticky 80/20 Sonnet 5 versus GPT-5.6 Luna default-model experiment across first-party hosted templates.
+- 2625de5: Avoid repeated desktop sidebar width transitions while the agent sidebar is being resized.
+- 2625de5: Prevent duplicate recovery submissions and reject late worker events after an agent run has already reached a terminal state.
+- Updated dependencies [2625de5]
+  - @agent-native/recap-cli@0.4.2
+
 ## 0.103.1
 
 ### Patch Changes

package/corpus/core/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agent-native/core",
-  "version": "0.103.1",
+  "version": "0.104.0",
   "description": "Framework for agent-native application development — where AI agents and UI share SQL state, actions, and context",
   "homepage": "https://github.com/BuilderIO/agent-native#readme",
   "bugs": {
@@ -48,6 +48,8 @@
     "./server/request-context": "./dist/server/request-context.js",
     "./server/design-token-utils": "./dist/server/design-token-utils.js",
     "./integrations": "./dist/integrations/index.js",
+    "./ingestion": "./dist/ingestion/index.js",
+    "./search-utils": "./dist/search-utils/index.js",
     "./automation": "./dist/automation/index.js",
     "./brand-kit": "./dist/brand-kit/index.js",
     "./brand-kit/fig": "./dist/brand-kit/fig/index.js",
@@ -520,7 +522,12 @@
   },
   "optionalDependencies": {
     "@opentelemetry/api": "^1.9.1",
-    "playwright": "^1.61.1"
+    "fast-xml-parser": "^5.10.1",
+    "jszip": "^3.10.1",
+    "mammoth": "^1.12.0",
+    "officeparser": "^7.3.0",
+    "playwright": "^1.61.1",
+    "sharp": "^0.35.3"
   },
   "engines": {
     "node": ">=22.22.0"

package/corpus/core/src/agent/engine/credential-errors.ts

@@ -3,7 +3,7 @@ import { PROVIDER_ENV_VARS } from "./provider-env-vars.js";
 export const LLM_MISSING_CREDENTIALS_ERROR_CODE = "missing_credentials";
 
 export const LLM_MISSING_CREDENTIALS_MESSAGE =
-  "No LLM provider is connected. Open this app's Agent settings > LLM, then connect Builder.io or add a provider key.";
+  "No LLM provider is connected. Open this app's Agent workspace > LLM, then connect Builder.io or add a provider key.";
 
 const LLM_CREDENTIAL_KEYS = new Set([
   ...PROVIDER_ENV_VARS,
@@ -45,7 +45,7 @@ export function formatLlmCredentialErrorMessage(options?: {
 }): string {
   const agentName = options?.agentName?.trim();
   if (agentName) {
-    return `The ${agentName} agent could not finish this request because that app needs an LLM connection. Open ${agentName}'s Agent settings > LLM, then connect Builder.io or add a provider key.`;
+    return `The ${agentName} agent could not finish this request because that app needs an LLM connection. Open ${agentName}'s Agent workspace > LLM, then connect Builder.io or add a provider key.`;
   }
   return LLM_MISSING_CREDENTIALS_MESSAGE;
 }

package/corpus/core/src/agent/production-agent.ts

@@ -3772,6 +3772,20 @@ export async function runAgentLoop(opts: {
           return usage;
         }
 
+        // A provider can close cleanly after streaming only a partial tool
+        // input. Do not treat that as a completed turn or execute guessed args.
+        const hasEmptyAssistantContent =
+          assistantContent === undefined || assistantContent.length === 0;
+        const hasUnfinishedToolInput =
+          activeToolInputs.size > 0 &&
+          hasEmptyAssistantContent &&
+          streamedAssistantToolCalls.length === 0 &&
+          toolCallErrors.size === 0;
+        if (hasUnfinishedToolInput) {
+          send({ type: "auto_continue", reason: "stream_ended" });
+          return usage;
+        }
+
         break;
       } catch (err: unknown) {
         if (signal.aborted) throw err;
@@ -6527,6 +6541,22 @@ export function createProductionAgentHandler(
             modelSelectionSource = "experiment";
           }
         }
+
+        if (modelSelectionSource === "default") {
+          const { resolveHostedDefaultModelExperiment } =
+            await import("../observability/hosted-model-experiment.js");
+          const hostedExperiment = resolveHostedDefaultModelExperiment({
+            userId: ownerEmail,
+            engineName: engine.name,
+            isDefaultModelSelection: true,
+            supportedModels: engine.supportedModels,
+          });
+          if (hostedExperiment) {
+            effectiveModel = hostedExperiment.model;
+            experimentAssignments.push(hostedExperiment.assignment);
+            modelSelectionSource = "experiment";
+          }
+        }
       }
     } catch {
       // Experiments are best-effort. Model resolution must keep working if the

package/corpus/core/src/agent/run-store.ts

@@ -1794,9 +1794,19 @@ export async function insertRunEvent(
   // It can also race with `appendTerminalRunEvent` (max-seq + 1) when a
   // run aborts at the same time the producer emits its final event.
   // Treat the second write as a no-op so the run completes cleanly.
+  // A producer can also outlive a stale-run reap or explicit abort. Reject
+  // those zombie writes atomically once the run row is terminal. Allowing a
+  // missing run row preserves the existing startRun race where the producer
+  // may emit before the non-blocking run-row insert has landed.
   await client.execute({
-    sql: `INSERT INTO agent_run_events (run_id, seq, event_at, event_data) VALUES (?, ?, ?, ?) ON CONFLICT (run_id, seq) DO NOTHING`,
-    args: [runId, seq, Date.now(), eventData],
+    sql: `INSERT INTO agent_run_events (run_id, seq, event_at, event_data)
+      SELECT ?, ?, ?, ?
+      WHERE NOT EXISTS (
+        SELECT 1 FROM agent_runs
+        WHERE id = ? AND status <> 'running'
+      )
+      ON CONFLICT (run_id, seq) DO NOTHING`,
+    args: [runId, seq, Date.now(), eventData, runId],
   });
 }
 

package/corpus/core/src/cli/create.ts

@@ -36,6 +36,7 @@ const REACT_ROUTER_BUILD_DEPENDENCIES = [
 const MINIMUM_RELEASE_AGE_EXCLUDES = [
   '"@typescript/*"',
   '"@sentry/*"',
+  "fast-xml-parser",
   "typescript",
   "typescript-7",
 ];

package/corpus/core/src/cli/skills-content/visual-plan-skill.ts

@@ -191,12 +191,22 @@ forward only the code-research and plan-composition guidance here.
    targeted \`contentPatches\`.
    Treat the top-level \`content\` payload as a full replacement, not a merge; do
    not send a partial \`content\` object to add a canvas or one block. If a full
-   replacement is unavoidable, first read the complete plan source/content, carry
-   forward every existing block and visual surface, and verify the source/export
-   afterward so the document body was not truncated. When the user wants
-   source-control friendly edits, use \`patch-visual-plan-source\` against the MDX
-   files instead of regenerating the plan.
-7. For hosted plans, export with \`export-visual-plan\` only when the user wants a
+   replacement or \`replace-blocks\` is unavoidable, call \`get-visual-plan\`
+   immediately before the write, pass its \`plan.updatedAt\` as
+   \`expectedUpdatedAt\`, and carry forward every existing block and visual
+   surface. Never reuse a revision from an earlier read or feedback payload.
+   For source-control friendly edits, use granular \`patch-visual-plan-source\`
+   operations against the MDX files instead of regenerating the plan;
+   \`replace-file\` is also destructive and requires the same fresh
+   \`expectedUpdatedAt\` fence.
+7. After every hosted-plan write, call \`get-visual-plan\` again and compare the
+   persisted text, block IDs/counts, canvas frames, and prototype with the
+   intended result. A successful mutation response is not proof that unrelated
+   content survived. If the edit addressed agent-targeted feedback, only after
+   this verification call \`resolve-plan-comment\` for the thread and
+   \`consume-plan-feedback\` for its comments; do both so addressed feedback is
+   neither visibly open nor returned as pending work.
+8. For hosted plans, export with \`export-visual-plan\` only when the user wants a
    shareable receipt or repo-check-in artifacts.
 
 ## Self-Review Before Handoff
@@ -345,14 +355,20 @@ directory before authoring a plan.
 - \`create-visual-questions\`: use only when the user explicitly asks for a visual
   intake questionnaire, not as \`/visual-plan\` preflight.
 - \`update-visual-plan\`: revise content, status, or comments with targeted
-  \`contentPatches\` (see Core Workflow step 6).
+  \`contentPatches\` (see Core Workflow steps 6-7). \`replace-blocks\` and full
+  \`content\` replacement require \`expectedUpdatedAt\` from a fresh
+  \`get-visual-plan\` call.
 - \`read-visual-plan-source\`: read the normalized plan as \`plan.mdx\`,
   optional \`canvas.mdx\`, optional \`.plan-state.json\`, and JSON.
 - \`patch-visual-plan-source\`: apply granular MDX AST patches by stable block,
-  artboard, annotation, component, or wireframe-node id.
+  artboard, annotation, component, or wireframe-node id. Prefer those targeted
+  operations; \`replace-file\` requires \`expectedUpdatedAt\` from a fresh
+  \`get-visual-plan\` call.
 - \`import-visual-plan-source\`: create or replace a plan from an MDX folder.
-- \`get-visual-plan\`: read the current structured plan, exported HTML, and
-  annotations; it also returns the MDX folder for source workflows.
+- \`get-visual-plan\`: read the current structured plan, exported HTML,
+  annotations, and \`plan.updatedAt\`; it also returns the MDX folder for source
+  workflows. Re-read immediately before a destructive write for its concurrency
+  fence and again after every write to verify persisted state.
 - \`get-plan-feedback\`: read unconsumed human feedback. Use it frequently; it
   returns grouped threads, exact anchor details, expected resolver, and recent
   review-event payloads so agents can act only on the comments meant for them.
@@ -411,7 +427,10 @@ local bridge check/serve/verify command, and report the new local URL.
 - **Two-axis state.** Mark every ingested comment as consumed
   (\`consumedCommentIds\` on \`update-visual-plan\`). Set \`status=resolved\` only on
   agent-targeted comments you actually addressed; leave human-targeted comments
-  open.
+  open. When an edit addresses feedback, first re-read the persisted plan and
+  verify the requested change. Only then call \`resolve-plan-comment\` for the
+  addressed thread and \`consume-plan-feedback\` for its comments; never mark
+  addressed feedback along only one axis.
 
 ## Visibility & Sharing
 

package/corpus/core/src/cli/templates-meta.ts

@@ -74,6 +74,7 @@ export const TEMPLATES: TemplateMeta[] = [
     devPort: 8083,
     prodUrl: "https://content.agent-native.com",
     defaultMode: "prod",
+    requiredPackages: ["creative-context"],
     core: true,
   },
   {
@@ -98,7 +99,7 @@ export const TEMPLATES: TemplateMeta[] = [
     devPort: 8086,
     prodUrl: "https://slides.agent-native.com",
     defaultMode: "prod",
-    requiredPackages: ["pinpoint"],
+    requiredPackages: ["pinpoint", "creative-context"],
     core: true,
   },
   {
@@ -197,7 +198,7 @@ export const TEMPLATES: TemplateMeta[] = [
     devPort: 8099,
     prodUrl: "https://design.agent-native.com",
     defaultMode: "prod",
-    requiredPackages: ["pinpoint", "embedding"],
+    requiredPackages: ["pinpoint", "embedding", "creative-context"],
     core: true,
   },
   {
@@ -211,7 +212,7 @@ export const TEMPLATES: TemplateMeta[] = [
     prodUrl: "https://assets.agent-native.com",
     defaultMode: "prod",
     defaultAgent: true,
-    requiredPackages: ["embedding"],
+    requiredPackages: ["embedding", "creative-context"],
     core: true,
   },
   {

package/corpus/core/src/client/AgentAskPopover.tsx

@@ -0,0 +1,89 @@
+import { Button } from "@agent-native/toolkit/ui/button";
+import { useCallback, useState } from "react";
+
+import { sendToAgentChat } from "./agent-chat.js";
+import {
+  Popover,
+  PopoverContent,
+  PopoverTrigger,
+} from "./components/ui/popover.js";
+import { PromptComposer } from "./composer/PromptComposer.js";
+import { useT } from "./i18n.js";
+
+export interface AgentAskPopoverProps {
+  prompt: string;
+  title?: string;
+  label?: string;
+  placeholder?: string;
+  context?: string;
+  className?: string;
+}
+
+/** A low-emphasis entry point for asking the agent without losing the current surface. */
+export function AgentAskPopover({
+  prompt,
+  title,
+  label,
+  placeholder,
+  context,
+  className,
+}: AgentAskPopoverProps) {
+  const t = useT();
+  const [open, setOpen] = useState(false);
+  const handleSubmit = useCallback(
+    (text: string) => {
+      const trimmed = text.trim();
+      if (!trimmed) return;
+      sendToAgentChat({
+        message: trimmed,
+        context,
+        submit: true,
+        newTab: true,
+      });
+      setOpen(false);
+    },
+    [context],
+  );
+
+  return (
+    <Popover open={open} onOpenChange={setOpen}>
+      <PopoverTrigger asChild>
+        <Button
+          type="button"
+          variant="outline"
+          size="sm"
+          className={className ?? "cursor-pointer"}
+        >
+          {label ?? t("agentPanel.askAgent", { defaultValue: "Ask the agent" })}
+        </Button>
+      </PopoverTrigger>
+      <PopoverContent
+        align="end"
+        sideOffset={8}
+        collisionPadding={12}
+        className="z-[260] w-[calc(100vw-32px)] max-w-[420px] p-3"
+      >
+        <p className="px-1 pb-2 text-sm font-semibold text-foreground">
+          {title ??
+            t("agentPanel.askAgentTitle", { defaultValue: "Ask the agent" })}
+        </p>
+        <PromptComposer
+          autoFocus
+          attachmentsEnabled={false}
+          initialText={prompt}
+          initialTextKey={prompt}
+          layoutVariant="compact"
+          placeholder={
+            placeholder ??
+            t("agentPanel.askAgentPlaceholder", {
+              defaultValue: "Tell the agent what you want to do…",
+            })
+          }
+          showModelSelector={false}
+          voiceEnabled={false}
+          onSubmit={handleSubmit}
+        />
+      </PopoverContent>
+    </Popover>
+  );
+}

package/corpus/core/src/client/AgentChatHome.tsx

@@ -31,6 +31,8 @@ export function AgentChatHome({
   surfaceClassName,
   chatViewTransition = true,
   defaultMode = "chat",
+  showHeader = false,
+  showTabBar = false,
   ...props
 }: AgentChatHomeProps) {
   return (
@@ -50,6 +52,8 @@ export function AgentChatHome({
           {...props}
           mode="page"
           defaultMode={defaultMode}
+          showHeader={showHeader}
+          showTabBar={showTabBar}
           chatViewTransition={chatViewTransition}
           className={cn(
             "min-h-0 flex-1 rounded-lg border border-border shadow-sm",