Skip to content

@agent-native/core@0.229.0

Choose a tag to compare

@builder-io-integration builder-io-integration released this 16 Nov 21:03
· 11 commits to main since this release
fc26b78

Minor Changes

  • 9af0433: Add defineAppConfigSection(key, schema) so an app can register its own typed server config section. Its fields resolve like the framework's (declared default, .meta({ env }) aliases, then defineAppConfig()), and getAppConfig()[key] or the returned read() reads it. Declare the section's type by augmenting AppConfigSections. Keys that collide with framework sections and env aliases another field already reads are refused at registration.
  • 62bbf91: Two files created under one name at the same moment no longer collide. Core adds nextFreeName in @agent-native/core/free-name, which gives name.html, then name-2.html, name-3.html and so on, and nameTaken in @agent-native/core/free-name/server, one typed name_taken refusal that carries a free name to use instead. Design uses them first: copies made at once each save under their own name, a rename onto a taken name says so and suggests a free one, and older files that already share a name are given free names so Design's unique filename index can hold.
  • f152dfe: Framework reliability improvements: agent runs, run recovery and tool approvals report failures instead of settling as empty successes; actions, the action query cache and session hooks handle cold starts, retries and mounted base paths; sign-in, organization context and workspace connections resolve the right org and credential; provider API calls are metered per app and operation; deploy builds bundle the installed optional ingestion parsers; and MCP tool-search can recommend tools for a short task summary.
  • dd24195: Add agent-native netlify-deploy, which zips workspace functions deterministically with the installed Netlify CLI's bundler and runs netlify deploy in the same command, so unchanged functions keep their digest and are not re-uploaded. It fails with a manifest-expired line instead of silently deploying unstable ZIPs.
  • e79c1ae: Comments & Review Kit: the comment box formats. Select text for a bar with bold, italic, strikethrough, code and links, use their shortcuts, or type Markdown as you go, including lists, quotes and code blocks. The box saves Markdown that shows the way it looked, opens a saved comment the way it shows, and reads pasted text as Markdown. @agent-native/core/review/markdown converts between a comment's Markdown and the box's document, and findCommentMentions in @agent-native/core/review/plain-text finds a comment's mentions the way the renderer chips them. Cmd/Ctrl+K in the box opens its link field even in apps whose command menu takes the shortcut from editable text: the command menu now leaves it to any field inside data-command-menu-shortcut="own". The box shows its placeholder again once a comment is sent.
  • a6ccc79: Comments & Review Kit: the comment box keeps drafts and takes images. useReviewCommentDraft() keeps a box's unsent text, mentions and images in the browser per thread, reply or edit, so a reload doesn't lose them. Give ReviewCommentComposer images and onImagesChange and it uploads pasted, dropped or picked images, up to five, and sends a comment that's only an image; a paste with text in it still pastes as text. Give the box the draft's target as imageTarget, so an image still uploading when the box moves to another draft isn't added to it. create-review-comment and reply-review-comment take an empty body when the comment keeps an image, and refuse one with neither as empty_comment. update-review-comment takes attachments to change an author's images, checked as a new comment's are; sent without expectedRevision, an image edit is refused as revision_conflict if the comment changes before it saves.
  • 88c2e4b: Include email verification status on signup analytics and record completed email verification.
  • 453ecb4: Workspace deploys now cache each app's build. An app whose source, built workspace-package outputs, lockfile, Node major, preset and build environment are unchanged restores its previous build output and function bundle instead of rebuilding. Cache problems always rebuild with a typed miss reason, never ship a partial restore, and AGENT_NATIVE_DEPLOY_CACHE_VERIFY rebuilds a sample of cached apps and fails on any output difference. Turn it off with AGENT_NATIVE_DEPLOY_CACHE=false.

Patch Changes

  • e04e57c: Give hand-written action queries the read rules useActionQuery applies. useActionQueryCanFetch says whether a read may start: never while the app's API is off, and, while the browser's saved results are still being tied to the signed-in user, only for a query already fetching or holding data. runActionQueryRead runs one read so a 401, 403 or 404 drops the rows it showed and the saved copy, and a success joins the saved results only for the binding active when it began. useActionQuery now uses both.
  • cdf52f4: Report unexpected late action failures separately from late outcome persistence errors, while avoiding false reports for expected action rejections.
  • a4a4f9e: Background tasks started with agent-teams now finish in Chat's task list once the agent reads their result, keep their name and description after a reload, and no longer repeat as separate status cards. The answers summary after guided questions is given once. An @-mentioned agent's reply shows as one message in its step instead of one row per streamed piece.
  • fd79105: Expose assertIdentityColumnsRegistered(db) from @agent-native/core/org so apps can test their migrated schema against the same identity policies used for email changes and offboarding.
  • aa0f567: Preserve allowlisted provider classifications in no-detail Builder gateway error diagnostics without capturing unknown provider codes.
  • 4ec7533: The npm README now includes the CLI telemetry notice and the section on private action results. Both had been added to a generated copy of the README that publishing overwrote, so they never appeared on npm.
  • 4a2b64d: Add measureCpuMs at @agent-native/core/testing/cpu-time: the CPU milliseconds the current thread spends running a function, for tests that need a performance budget. Unlike Date.now() or performance.now(), it does not count time a loaded machine spends on other work, so a correct run does not fail its budget on a busy CI runner.
  • dfe5aa0: Return a typed 409 instead of a 500 when the organization changes during a Builder credit check, and send explicit personal scope from the shared notice.
  • 31c3b35: Export declaredLinkOrigin from @agent-native/core/server, so an app can build an absolute link only on an origin it trusts. A request keeps its own origin only when the app declares it; otherwise the link uses the app's declared origin, so a forwarded host can't send it elsewhere.
  • b2d106b: Workspace deploy build cache ignores per-run GitHub Actions environment variables, so CI runs can reuse cached app builds.
  • 5d8c5a6: Let the workspace deploy build cache hit across commits for apps whose inputs did not change. When a workspace sets AGENT_NATIVE_BUILD_ID to a full commit SHA and the cache is on, each app is built with a build id derived from its own cache key instead, so an unchanged app restores byte-identical output. The commit is still stamped on Netlify responses as x-agent-native-build-sha, next to a new x-agent-native-app-build-id header that carries the app's baked id. The deploy writes the expected ids to .netlify/agent-native-served-builds.json, and @agent-native/core/deploy/served-build exports checkServedAppBuild to verify a live response against them. Any other AGENT_NATIVE_BUILD_ID value is baked and keyed as before. The client commit-SHA define still records the commit each app was built at, and every Netlify response carries x-agent-native-app-build-id, including deploys that name no full commit.
  • 232c492: Workspace deploy build cache names the environment variable that changed when an app misses.
  • 6e21c72: Workspace deploy build cache ignores the per-run GitHub artifact and systemd process variables, so a restored CI cache can hit.
  • 2a5ad45: Workspace deploy build cache ignores login-shell and terminal session variables (such as MANPATH, INFOPATH, LESS*, TMUX*, XDG_RUNTIME_DIR, and __CF*) and Markdown files at the workspace root, so a deploy loop started from different shells, or a docs-only commit, reuses cached app builds.
  • 3420968: Let toDesktopOpenUrl target the nightly desktop scheme and export DESKTOP_DEEP_LINK_PROTOCOLS.
  • 3420968: Support Design visual-edit launch destinations, safe local reference copies, and shared live-preview tunnel mappings with snapshot fallbacks.
  • 3420968: Export isNonPublicHostname from @agent-native/core/shared/public-host so browser-loaded URLs share one private-network hostname check.
  • d9515da: Scope settings change events to their owner.
  • Release all public npm packages with a patch version bump.
  • fd05133: Open embedded apps in Claude's side panel, give MCP hosts read_view and navigate_view tools on the open app view, and answer the RFC 9728 path-inserted OAuth metadata URL for apps mounted under a base path.
  • 59a97ba: Use a valid MCP caller location timezone for relative dates, with a UTC fallback.
  • 65eafd8: Let the MCP endpoint trust the local owner hint when an app runs under agent-native dev. The dev server serves the app from a worker behind the Vite proxy, so the request's Host port never matched the worker's own socket port and every local MCP call with x-agent-native-owner-email got a 401. The port check is now skipped for MCP requests when NODE_ENV is development; every other check (literal 127.0.0.1 Host, loopback peer and socket, no forwarded headers, same-origin) still applies, and production builds are unchanged.
  • 9af0433: Add the notifications.usageLimitNotices server config (env AGENT_NATIVE_NOTIFICATIONS_USAGE_LIMIT_NOTICES, default true). When false, usage-limit alerts are left out of the notifications inbox, its unread count, and bulk archiving.
  • 9cbe92b: open_app now embeds another workspace app mounted on the MCP server's origin, such as Mail opened from Dispatch, instead of returning a link. The caller signs a short, single-use handoff with the workspace A2A_SECRET, and the target app's embed start route exchanges it for its own embed ticket. Apps on another origin, or a workspace without A2A_SECRET, still get a link.
  • 7e17b65: Correct the documented redirect order for /_agent-native/open links in the external-agents skill and the external agents docs: a template's resolveOpenPath is tried before the /<view> fallback.
  • 9af0433: Add personal integration grants. beginUserIntegrationGrant, completeUserIntegrationGrant, getUserIntegrationGrant, resolveUserIntegrationGrant and revokeUserIntegrationGrant store one user's own provider authorization in the new integration_user_grants table, keyed to the signed-in account and active organization. The token bundle lives only in the encrypted vault, each new authorization starts a new generation so a stale callback cannot overwrite a newer one, and another user's grant reads as absent. Identity re-keying now covers the table's owner column.
  • d6b72f4: An open tab no longer falls behind when the change feed fills with other accounts' events. When a poll comes back at its 1,000-row limit with more changes waiting, the tab reads the next page at once instead of waiting its usual interval, for up to 20 more pages in a row while it's visible, and those pages no longer count as idle ones that slow its polling down. A collaborative document's own poll reads a backlog the same way.
  • cd02f94: Preserve upstream HTTP status when a provider error response cannot be saved as text.
  • 58b52d0: Provider API requests accept WebDAV PROPFIND and REPORT methods. A runtime created with unsafeRequestPolicy: "single-attempt" sends each non-GET/HEAD request at most once (no quota retries, no unsafe pagination) and advertises this as requestCapabilities.singleAttemptUnsafeRequests. Google service-account tokens honor the request's abort signal and timeout, never cache a cancelled exchange, and are bound to the selected workspace connection: an explicit connectionId whose credential is missing or revoked fails instead of falling back to another credential. Every provider request is now recorded in the per-app provider call census.
  • 3420968: Proxy reference-copy subresources through the SSRF-safe design bridge.
  • 79bc394: Refresh AI readiness after automatic Builder account setup succeeds.
  • 5e5c149: Add the exported remix Design skill, so npx @agent-native/core skills add remix installs it with the hosted Design connector.
  • 3069c20: Return a retryable service-unavailable status when a Builder OAuth refresh fails temporarily during readiness checks.
  • c7d628a: Keep drizzle-orm in one server chunk on Netlify, Vercel, Node and Amplify builds. Split across chunks that import each other in a cycle, its query builders crashed some apps at module load with "Class extends value undefined is not a constructor or null".
  • 9af0433: Add a user-only Slack install. /_agent-native/integrations/slack/oauth/install?mode=user requests read-only Slack user scopes with no bot scope, and the callback stores the returned user token as a personal integration grant instead of a bot installation. It is off by default: set integrations.slackInternalTeamIds (env SLACK_INTERNAL_TEAM_IDS) to the workspaces allowed to use it, or turn on integrations.slackUserInstallBootstrap (env SLACK_USER_INSTALL_BOOTSTRAP) for the first install while the workspace id is still unknown. The bot install path is unchanged.
  • 9af0433: Production client bundles no longer carry the Vite dev-server recovery script. getThemeInitScript() now gates it on a static import.meta.env?.DEV read that the bundler folds away, so apps stop shipping it to every visitor. Pages a dev server renders still inline it, and server rendering where core loads unbundled still works.
  • 5e5c149: Support repo-only remix workflows and specify clean-room implementation with exact behavior.
  • cd02f94: Reject binary responses when saving web-request and provider responses to text workspace files, allow empty provider responses, and preserve safe rate-limit details in save errors.
  • 77bf28a: The CLI starts npm and pnpm through a shell on Windows, where they are .cmd shims that Node will not start directly. agent-native add can inspect a package that isn't installed yet (it failed with spawnSync npm ENOENT), add --apply and eject --apply can run the install, and agent-native create from a local framework checkout (AGENT_NATIVE_CREATE_USE_LOCAL_CORE=1) can pack local packages again (it failed with spawnSync npm.cmd EINVAL).
  • 7b2d487: Netlify workspace deploys now honor AGENT_NATIVE_ENABLE_KEEP_WARM: they emit one scheduled function that keeps every app's server function warm, and AGENT_NATIVE_KEEP_WARM_CONCURRENCY sets how many instances each app keeps warm, so opening a quiet app no longer cold-starts every request of its first page load.
  • Updated dependencies [f152dfe]
  • Updated dependencies
    • @agent-native/agentkit@0.229.0
    • @agent-native/recap-cli@0.5.104