@agent-native/core 0.90.2 → 0.90.3

package/corpus/core/src/client/setup-connections/index.ts

@@ -0,0 +1,46 @@
+export {
+  BuilderConnectCard,
+  type BuilderConnectCardProps,
+} from "./BuilderConnectCard.js";
+export {
+  ProviderReadinessBadge,
+  type ProviderReadinessBadgeProps,
+} from "./ProviderReadinessBadge.js";
+export {
+  SetupConnectionsPage,
+  type SetupConnectionsPageProps,
+} from "./SetupConnectionsPage.js";
+export {
+  OnboardingBanner,
+  OnboardingPanel,
+  SetupButton,
+  useOnboarding,
+  useOnboardingPreviewMode,
+  type OnboardingFormField,
+  type OnboardingMethod,
+  type OnboardingMethodBadge,
+  type OnboardingStep,
+  type OnboardingStepStatus,
+  type UseOnboardingResult,
+} from "../onboarding/index.js";
+export {
+  SecretsSection,
+  SettingsPanel,
+  SettingsTabsPage,
+  openBuilderConnectPopup,
+  useBuilderConnectFlow,
+  useBuilderStatus,
+  type BuilderConnectFlow,
+  type BuilderConnectFlowOptions,
+  type BuilderStatus,
+  type OpenBuilderConnectPopupOptions,
+  type SecretsSectionProps,
+  type SettingsPanelProps,
+  type SettingsTabItem,
+  type SettingsTabsPageProps,
+} from "../settings/index.js";
+export {
+  IntegrationsPanel,
+  useIntegrationStatus,
+  type IntegrationStatus,
+} from "../integrations/index.js";

package/corpus/core/src/client/sharing/ShareButton.tsx

@@ -1,7 +1,6 @@
 import * as Select from "@radix-ui/react-select";
 import {
   IconLock,
-  IconBuilding,
   IconWorld,
   IconTrash,
   IconCheck,
@@ -11,6 +10,7 @@ import {
   IconSearch,
   IconSearchOff,
   IconShare3,
+  IconUsersGroup,
 } from "@tabler/icons-react";
 import { useQueryClient } from "@tanstack/react-query";
 import {
@@ -46,11 +46,11 @@ export interface ShareButtonProps {
   /** @deprecated No longer affects rendering — trigger always says
    *  "Share". Kept for callsite compatibility. */
   variant?: "compact" | "label";
-  /** Optional trigger style. Defaults to the Google-Docs-style "Share" label.
-   *  Use "label-icon" to render a leading share glyph alongside the label so
-   *  the trigger matches adjacent icon+label buttons; "icon" is icon-only. */
+  /** Optional trigger style. Defaults to the Google-Docs-style "Share" label
+   *  with a leading visibility icon. "label-icon" is kept for callsites that
+   *  want to explicitly opt into icon+label parity; "icon" is icon-only. */
   trigger?: "label" | "icon" | "label-icon";
-  /** @deprecated Label triggers no longer render a visibility/share glyph. */
+  /** @deprecated No longer affects rendering — triggers show visibility state. */
   hideTriggerIcon?: boolean;
   /** Optional className applied to the trigger button. */
   triggerClassName?: string;
@@ -197,7 +197,7 @@ const VIS_META: Record<
   org: {
     label: "Organization",
     description: "Anyone in your organization can view",
-    Icon: IconBuilding,
+    Icon: IconUsersGroup,
   },
   public: {
     label: "Public",
@@ -356,10 +356,17 @@ export function ShareButton(props: ShareButtonProps) {
     });
   };
 
-  // The default trigger stays text-only; the icon trigger keeps the share glyph.
-  // "label-icon" renders the glyph alongside the label for icon+label parity.
+  const triggerVisibility =
+    pendingVisibility ??
+    (sharesQuery.data
+      ? ((sharesQuery.data.visibility as Visibility | null) ?? "private")
+      : null);
+  const triggerMeta = triggerVisibility
+    ? visibilityMeta(triggerVisibility, props.visibilityCopy)
+    : null;
+  const TriggerIcon = triggerMeta?.Icon ?? IconShare3;
+  const triggerLabel = triggerMeta ? `Share (${triggerMeta.label})` : "Share";
   const iconOnly = props.trigger === "icon";
-  const showLabelIcon = props.trigger === "label-icon";
 
   return (
     <Popover open={open} onOpenChange={handleOpenChange}>
@@ -370,11 +377,10 @@ export function ShareButton(props: ShareButtonProps) {
             iconOnly ? BUTTON_GHOST_ICON : BUTTON_OUTLINE_SM,
             props.triggerClassName,
           )}
-          aria-label={iconOnly ? "Share" : undefined}
+          aria-label={triggerLabel}
+          title={triggerLabel}
         >
-          {iconOnly || showLabelIcon ? (
-            <IconShare3 size={16} strokeWidth={1.75} />
-          ) : null}
+          <TriggerIcon size={16} strokeWidth={1.75} />
           {!iconOnly && <span>Share</span>}
         </button>
       </PopoverTrigger>
@@ -1663,7 +1669,7 @@ function Avatar({ label, org }: { label: string; org?: boolean }) {
       aria-hidden
       className="inline-flex h-7 w-7 shrink-0 items-center justify-center rounded-full bg-muted text-[11px] font-semibold text-muted-foreground"
     >
-      {org ? <IconBuilding size={14} strokeWidth={1.75} /> : initials(label)}
+      {org ? <IconUsersGroup size={14} strokeWidth={1.75} /> : initials(label)}
     </span>
   );
 }

package/corpus/core/src/client/sharing/ShareDialog.tsx

@@ -3,7 +3,6 @@ import {
   IconX,
   IconTrash,
   IconLock,
-  IconBuilding,
   IconWorld,
   IconCheck,
   IconCopy,
@@ -11,6 +10,7 @@ import {
   IconMail,
   IconCode,
   IconChevronDown,
+  IconUsersGroup,
 } from "@tabler/icons-react";
 import { useEffect, useState, type ReactNode } from "react";
 import { createPortal } from "react-dom";
@@ -117,7 +117,7 @@ const BUTTON_GHOST_ICON = cn(
 
 const VIS_ICONS: Record<Visibility, typeof IconLock> = {
   private: IconLock,
-  org: IconBuilding,
+  org: IconUsersGroup,
   public: IconWorld,
 };
 
@@ -824,7 +824,7 @@ function Avatar({ label, org }: { label: string; org?: boolean }) {
       className="inline-flex h-7 w-7 shrink-0 items-center justify-center rounded-full bg-muted text-[11px] font-semibold text-muted-foreground"
     >
       {org ? (
-        <IconBuilding size={14} strokeWidth={1.75} />
+        <IconUsersGroup size={14} strokeWidth={1.75} />
       ) : (
         (label.split("@")[0]?.[0] ?? label[0] ?? "?").toUpperCase()
       )}

package/corpus/core/src/command-navigation/actions.ts

@@ -0,0 +1,100 @@
+import { z } from "zod";
+
+import { defineAction } from "../action.js";
+import { readAppState, writeAppState } from "../application-state/index.js";
+
+const navigateSchema = z
+  .object({
+    view: z.string().optional().describe("View name to navigate to"),
+    path: z.string().optional().describe("URL path to navigate to"),
+  })
+  .passthrough();
+
+export interface CreateNavigateActionOptions {
+  description?: string;
+  stateKey?: string;
+  normalize?: (
+    args: z.infer<typeof navigateSchema>,
+  ) => Record<string, unknown> | Promise<Record<string, unknown>>;
+  describeResult?: (
+    navigation: Record<string, unknown>,
+    args: z.infer<typeof navigateSchema>,
+  ) => string;
+}
+
+export interface CreateViewScreenActionOptions {
+  description?: string;
+  navigationStateKey?: string;
+  extraStateKeys?: string[];
+  describeResult?: (
+    screen: Record<string, unknown>,
+  ) =>
+    | Record<string, unknown>
+    | string
+    | Promise<Record<string, unknown> | string>;
+}
+
+function writeId(): string {
+  return `${Date.now()}-${Math.random().toString(36).slice(2, 8)}`;
+}
+
+export function createNavigateAction(
+  options: CreateNavigateActionOptions = {},
+) {
+  const stateKey = options.stateKey ?? "navigate";
+  return defineAction({
+    description:
+      options.description ??
+      "Navigate the UI to a specific view or path. Writes a navigate command to application state which the UI reads and auto-deletes.",
+    schema: navigateSchema,
+    http: false,
+    run: async (args) => {
+      if (!args.view && !args.path) {
+        throw new Error("At least --view or --path is required.");
+      }
+      const navigation = options.normalize
+        ? await options.normalize(args)
+        : ({
+            ...(args.view ? { view: args.view } : null),
+            ...(args.path ? { path: args.path } : null),
+          } as Record<string, unknown>);
+      navigation._writeId = writeId();
+      await writeAppState(stateKey, navigation);
+      return (
+        options.describeResult?.(navigation, args) ??
+        `Navigating to ${String(args.view || args.path)}`
+      );
+    },
+  });
+}
+
+export function createViewScreenAction(
+  options: CreateViewScreenActionOptions = {},
+) {
+  const navigationStateKey = options.navigationStateKey ?? "navigation";
+  return defineAction({
+    description:
+      options.description ??
+      "See what the user is currently looking at on screen. Returns the current navigation state.",
+    schema: z.object({}),
+    http: false,
+    readOnly: true,
+    run: async () => {
+      const screen: Record<string, unknown> = {};
+      const navigation = await readAppState(navigationStateKey);
+      if (navigation) screen.navigation = navigation;
+
+      for (const key of options.extraStateKeys ?? []) {
+        const value = await readAppState(key);
+        if (value !== null && value !== undefined) screen[key] = value;
+      }
+
+      if (Object.keys(screen).length === 0) {
+        return "No application state found. Is the app running?";
+      }
+      return options.describeResult
+        ? await options.describeResult(screen)
+        : screen;
+    },
+  });
+}

package/corpus/core/src/command-navigation/index.ts

@@ -0,0 +1,12 @@
+export * from "../navigation/index.js";
+export * from "./actions.js";
+export {
+  buildDeepLink,
+  toAbsoluteOpenUrl,
+  toDesktopOpenUrl,
+  toVsCodeOpenUrl,
+  DESKTOP_OPEN_URL,
+  OPEN_ROUTE_SUBPATH,
+  VSCODE_OPEN_URL,
+  type DeepLinkInput,
+} from "../server/deep-link.js";

package/corpus/core/src/comments-review/index.ts

@@ -0,0 +1 @@
+export * from "../review/index.js";

package/corpus/core/src/file-upload/builder.ts

@@ -60,6 +60,15 @@ function setSkipCompressionQueryParams(url: URL): void {
   }
 }
 
+function setRecordAssetQueryParam(
+  url: URL,
+  recordAsset: boolean | undefined,
+): void {
+  if (recordAsset === false) {
+    url.searchParams.set("record", "false");
+  }
+}
+
 async function assertOk(res: Response, label: string): Promise<void> {
   if (!res.ok) {
     const body = await res.text().catch(() => "");
@@ -111,7 +120,10 @@ async function uploadLargeFileViaSignedUrl(
     privateKey,
     assetId,
     input.filename,
-    { skipCompressionWait: input.skipCompressionWait },
+    {
+      skipCompressionWait: input.skipCompressionWait,
+      recordAsset: input.recordAsset,
+    },
   );
   console.log(`[builder-upload] done [${assetId}]: ${url}`);
   return { url, id, provider: "builder" };
@@ -165,20 +177,25 @@ async function completeBuilderUpload(
   privateKey: string,
   assetId: string,
   filename: string | undefined,
-  options?: { skipCompressionWait?: boolean },
+  options?: { skipCompressionWait?: boolean; recordAsset?: boolean },
 ): Promise<{ url: string; id?: string }> {
   const host = builderUploadHost();
   const url = new URL("/api/v1/upload/complete", host);
   if (options?.skipCompressionWait) {
     setSkipCompressionQueryParams(url);
   }
+  setRecordAssetQueryParam(url, options?.recordAsset);
   const res = await fetchWithTimeout(url.toString(), {
     method: "POST",
     headers: {
       Authorization: `Bearer ${privateKey}`,
       "Content-Type": "application/json",
     },
-    body: JSON.stringify({ assetId, name: filename }),
+    body: JSON.stringify({
+      assetId,
+      name: filename,
+      ...(options?.recordAsset === false ? { record: false } : {}),
+    }),
   });
   await assertOk(res, "Builder.io upload complete failed");
   const json = (await res.json()) as { url?: string; id?: string };
@@ -273,6 +290,7 @@ export const builderFileUploadProvider: FileUploadProvider = {
     if (input.skipCompressionWait) {
       setSkipCompressionQueryParams(url);
     }
+    setRecordAssetQueryParam(url, input.recordAsset);
 
     const response = await uploadSmallFile(url, {
       method: "POST",
@@ -414,6 +432,9 @@ export const builderFileUploadProvider: FileUploadProvider = {
           skipCompressionWait:
             options?.skipCompressionWait ||
             session.meta.skipCompressionWait === true,
+          recordAsset:
+            options?.recordAsset ??
+            (session.meta.recordAsset === false ? false : undefined),
         },
       );
       console.log(`[builder-resumable] upload complete: ${url}`);

package/corpus/core/src/file-upload/types.ts

@@ -18,6 +18,8 @@ export interface FileUploadInput {
   ownerEmail?: string;
   /** Builder.io upload hint: return after asset registration instead of waiting for server-side compression. */
   skipCompressionWait?: boolean;
+  /** Builder.io upload hint: set false for internal artifacts that should not appear in the asset library. */
+  recordAsset?: boolean;
 }
 
 export interface FileUploadResult {
@@ -79,7 +81,7 @@ export interface FileUploadProvider {
     completeSession(
       session: ResumableUploadSession,
       filename: string,
-      options?: { skipCompressionWait?: boolean },
+      options?: { skipCompressionWait?: boolean; recordAsset?: boolean },
     ): Promise<string>;
   };
 }

package/corpus/core/src/history/actions/create-resource-version.ts

@@ -0,0 +1,89 @@
+import { z } from "zod";
+
+import { defineAction } from "../../action.js";
+import {
+  assertVersionedResourceAccess,
+  getVersionedResource,
+  normalizeHistoryVisibility,
+} from "../registry.js";
+import { insertResourceVersion } from "../store.js";
+import type { HistoryActorKind, VersionedResourceContext } from "../types.js";
+
+const schema = z.object({
+  resourceType: z.string().min(1),
+  resourceId: z.string().min(1),
+  title: z.string().optional(),
+  summary: z.string().optional(),
+  snapshot: z.unknown().optional(),
+  metadata: z.record(z.string(), z.unknown()).optional(),
+});
+
+export default defineAction({
+  description: "Create a reusable version-history snapshot for a resource.",
+  schema,
+  run: async (args, ctx) => {
+    const actionCtx = ctx as VersionedResourceContext | undefined;
+    const access = await assertVersionedResourceAccess(
+      args.resourceType,
+      args.resourceId,
+      actionCtx,
+      "editor",
+    );
+    const registration = getVersionedResource(args.resourceType);
+    const snapshot =
+      args.snapshot !== undefined
+        ? args.snapshot
+        : await registration?.getSnapshot?.({
+            resourceType: args.resourceType,
+            resourceId: args.resourceId,
+            ctx: actionCtx,
+            access,
+          });
+
+    if (snapshot === undefined) {
+      throw new Error(
+        `No snapshot was provided and ${args.resourceType} has no getSnapshot history handler`,
+      );
+    }
+
+    return insertResourceVersion({
+      resourceType: args.resourceType,
+      resourceId: args.resourceId,
+      createdBy: actionCtx?.userEmail ?? null,
+      actorKind: actorKindFromContext(actionCtx),
+      ownerEmail: access.ownerEmail ?? actionCtx?.userEmail ?? null,
+      orgId: access.orgId ?? actionCtx?.orgId ?? null,
+      visibility: normalizeHistoryVisibility(access.visibility),
+      title: args.title,
+      summary: args.summary,
+      snapshot,
+      metadata: args.metadata,
+    });
+  },
+  audit: {
+    target: (args, result) => {
+      const version = result as {
+        ownerEmail?: string | null;
+        orgId?: string | null;
+        visibility?: "private" | "org" | "public";
+      };
+      return {
+        type: args.resourceType,
+        id: args.resourceId,
+        ownerEmail: version.ownerEmail,
+        orgId: version.orgId,
+        visibility: version.visibility,
+      };
+    },
+  },
+});
+
+function actorKindFromContext(
+  ctx: VersionedResourceContext | undefined,
+): HistoryActorKind {
+  const caller = typeof ctx?.caller === "string" ? ctx.caller : "";
+  if (caller === "agent" || caller === "tool") {
+    return "agent";
+  }
+  return ctx?.userEmail ? "human" : "system";
+}

package/corpus/core/src/history/actions/get-resource-version.ts

@@ -0,0 +1,60 @@
+import { z } from "zod";
+
+import { defineAction } from "../../action.js";
+import { assertVersionedResourceAccess } from "../registry.js";
+import {
+  getResourceVersionById,
+  getResourceVersionByNumber,
+} from "../store.js";
+import type { VersionedResourceContext } from "../types.js";
+
+const schema = z
+  .object({
+    id: z.string().optional(),
+    resourceType: z.string().min(1).optional(),
+    resourceId: z.string().min(1).optional(),
+    versionNumber: z.number().int().positive().optional(),
+  })
+  .refine(
+    (value) =>
+      value.id ||
+      (value.resourceType && value.resourceId && value.versionNumber),
+    {
+      message:
+        "Provide either id or resourceType, resourceId, and versionNumber",
+    },
+  );
+
+export default defineAction({
+  description: "Read one version-history snapshot for a reusable resource.",
+  schema,
+  http: { method: "GET" },
+  readOnly: true,
+  parallelSafe: true,
+  run: async (args, ctx) => {
+    const actionCtx = ctx as VersionedResourceContext | undefined;
+    const scope = {
+      userEmail: actionCtx?.userEmail ?? null,
+      orgId: actionCtx?.orgId ?? null,
+    };
+    const version = args.id
+      ? await getResourceVersionById(args.id, scope, { bypassScope: true })
+      : await getResourceVersionByNumber(
+          args.resourceType!,
+          args.resourceId!,
+          args.versionNumber!,
+          scope,
+          { bypassScope: true },
+        );
+    if (!version) {
+      throw new Error("Resource version not found");
+    }
+    await assertVersionedResourceAccess(
+      version.resourceType,
+      version.resourceId,
+      actionCtx,
+      "viewer",
+    );
+    return { version };
+  },
+});

package/corpus/core/src/history/actions/list-resource-history.ts

@@ -0,0 +1,53 @@
+import { z } from "zod";
+
+import { defineAction } from "../../action.js";
+import { queryAuditEvents } from "../../audit/store.js";
+import { assertVersionedResourceAccess } from "../registry.js";
+import { queryResourceVersions } from "../store.js";
+import type { VersionedResourceContext } from "../types.js";
+
+const schema = z.object({
+  resourceType: z.string().min(1),
+  resourceId: z.string().min(1),
+  limit: z.number().int().positive().max(200).optional(),
+});
+
+export default defineAction({
+  description: "List versions and audit events for a reusable resource.",
+  schema,
+  http: { method: "GET" },
+  readOnly: true,
+  parallelSafe: true,
+  run: async (args, ctx) => {
+    const actionCtx = ctx as VersionedResourceContext | undefined;
+    await assertVersionedResourceAccess(
+      args.resourceType,
+      args.resourceId,
+      actionCtx,
+      "viewer",
+    );
+    const scope = {
+      userEmail: actionCtx?.userEmail ?? null,
+      orgId: actionCtx?.orgId ?? null,
+    };
+    const auditScope = {
+      userEmail: actionCtx?.userEmail ?? undefined,
+      orgId: actionCtx?.orgId ?? undefined,
+    };
+    const [versions, auditEvents] = await Promise.all([
+      queryResourceVersions({
+        resourceType: args.resourceType,
+        resourceId: args.resourceId,
+        scope,
+        bypassScope: true,
+        limit: args.limit,
+      }),
+      queryAuditEvents(auditScope, {
+        targetType: args.resourceType,
+        targetId: args.resourceId,
+        limit: args.limit ?? 50,
+      }),
+    ]);
+    return { versions, auditEvents };
+  },
+});

package/corpus/core/src/history/actions/list-resource-versions.ts

@@ -0,0 +1,43 @@
+import { z } from "zod";
+
+import { defineAction } from "../../action.js";
+import { assertVersionedResourceAccess } from "../registry.js";
+import { queryResourceVersions } from "../store.js";
+import type { VersionedResourceContext } from "../types.js";
+
+const schema = z.object({
+  resourceType: z.string().min(1),
+  resourceId: z.string().min(1),
+  limit: z.number().int().positive().max(200).optional(),
+  offset: z.number().int().nonnegative().optional(),
+});
+
+export default defineAction({
+  description: "List version-history snapshots for a reusable resource.",
+  schema,
+  http: { method: "GET" },
+  readOnly: true,
+  parallelSafe: true,
+  run: async (args, ctx) => {
+    const actionCtx = ctx as VersionedResourceContext | undefined;
+    await assertVersionedResourceAccess(
+      args.resourceType,
+      args.resourceId,
+      actionCtx,
+      "viewer",
+    );
+    return {
+      versions: await queryResourceVersions({
+        resourceType: args.resourceType,
+        resourceId: args.resourceId,
+        scope: {
+          userEmail: actionCtx?.userEmail ?? null,
+          orgId: actionCtx?.orgId ?? null,
+        },
+        bypassScope: true,
+        limit: args.limit,
+        offset: args.offset,
+      }),
+    };
+  },
+});