@agent-native/core 0.82.0 → 0.84.0

package/corpus/core/src/sharing/access.ts

@@ -233,6 +233,23 @@ export interface ResolvedAccess {
   resource: any;
 }
 
+async function publicAccessRoleForResource(
+  reg: ShareableResourceRegistration,
+  resource: any,
+  ctx: AccessContext,
+): Promise<ShareRole> {
+  const roleResolver = reg.publicAccessRole;
+  if (!roleResolver) return "viewer";
+  return typeof roleResolver === "function"
+    ? await roleResolver(resource, ctx)
+    : roleResolver;
+}
+
+function higherShareRole(a: ShareRole, b: ShareRole | null): ShareRole {
+  if (!b) return a;
+  return ROLE_RANK[b] > ROLE_RANK[a] ? b : a;
+}
+
 /**
  * Return the effective role the current user has on a specific resource, or
  * null if they have no access. Loads the resource and relevant share rows.
@@ -263,9 +280,12 @@ export async function resolveAccess(
     return { role: "owner", resource };
   }
   if (resource.visibility === "public" && reg.allowPublic !== false) {
-    // No share row needed; default viewer unless upgraded below.
+    // No share row needed; default viewer unless the resource registration
+    // deliberately grants a stronger public-by-link role or explicit shares
+    // upgrade the current principal.
+    const publicRole = await publicAccessRoleForResource(reg, resource, ctx);
     const role = await highestShareRole(reg, resourceId, ctx, resource);
-    return { role: role ?? "viewer", resource };
+    return { role: higherShareRole(publicRole, role), resource };
   }
   // `visibility === "public"` on an `allowPublic: false` resource is treated
   // as private: only owner + explicit shares grant access. Falls through to

package/corpus/core/src/sharing/registry.ts

@@ -56,6 +56,24 @@ export interface ShareableResourceRegistration {
    * Default: `true` (matches the historical behavior — most resources can be public).
    */
   allowPublic?: boolean;
+  /**
+   * Optional role granted by a public-by-link read. Most resources should omit
+   * this so public visibility remains viewer-only. Use narrowly for local or
+   * otherwise constrained resources where the resource owner intentionally wants
+   * unauthenticated link holders to do more than view.
+   */
+  publicAccessRole?:
+    | "viewer"
+    | "editor"
+    | "admin"
+    | ((
+        resource: any,
+        ctx: { userEmail?: string; orgId?: string },
+      ) =>
+        | "viewer"
+        | "editor"
+        | "admin"
+        | Promise<"viewer" | "editor" | "admin">);
   /**
    * When `true`, individual user shares (`principalType: "user"`) must target
    * an email that is already a member of the same org as the resource, OR has

package/corpus/core/src/styles/agent-native.css

@@ -167,17 +167,6 @@
   container: agent-native-main / inline-size;
 }
 
-.agent-layout-main-surface::before,
-.agent-sidebar-main-surface::before {
-  content: "";
-  position: absolute;
-  inset: 0;
-  z-index: 20;
-  pointer-events: none;
-  border-radius: inherit;
-  box-shadow: var(--agent-native-raised-outline);
-}
-
 .agent-layout-shell
   :where(.agent-layout-main-surface, .agent-sidebar-main-surface)
   > :first-child
@@ -537,6 +526,57 @@
   }
 }
 
+/* Guided questions size themselves from the rendered container, not viewport
+   breakpoints, so they stay readable in narrow chat sidebars. */
+.guided-question-flow {
+  container-type: inline-size;
+  container-name: guided-question-flow;
+}
+
+.guided-question-flow-options {
+  grid-template-columns: minmax(0, 1fr);
+}
+
+@container guided-question-flow (min-width: 42rem) {
+  .guided-question-flow-inner {
+    padding: 2rem;
+  }
+
+  .guided-question-flow-header {
+    margin-bottom: 1.5rem;
+  }
+
+  .guided-question-flow-title {
+    font-size: 1.5rem;
+    line-height: 2rem;
+  }
+
+  .guided-question-flow-options {
+    grid-template-columns: repeat(2, minmax(0, 1fr));
+  }
+
+  .guided-question-flow-footer {
+    margin-top: 1.25rem;
+    padding-top: 1rem;
+  }
+}
+
+@container guided-question-flow (max-width: 24rem) {
+  .guided-question-flow-description {
+    font-size: 0.8125rem;
+    line-height: 1.25rem;
+  }
+
+  .guided-question-flow-footer {
+    align-items: stretch;
+    flex-direction: column;
+  }
+
+  .guided-question-flow-footer > :last-child {
+    justify-content: flex-end;
+  }
+}
+
 /* Connect AI card: use the card width, not the viewport, so narrow embedded
    sidebars stack the copy and actions before the secondary button clips. */
 .agent-builder-setup-card {
@@ -548,6 +588,32 @@
   container-name: agent-builder-setup;
 }
 
+.agent-builder-setup-card--sidebar .agent-builder-setup-card__actions {
+  gap: 0.25rem;
+}
+
+.agent-builder-setup-card--sidebar .agent-builder-setup-card__builder-button {
+  justify-content: center;
+  min-height: 2rem;
+}
+
+.agent-builder-setup-card--sidebar .agent-builder-setup-card__key-button {
+  align-self: center;
+  justify-content: center;
+  width: auto;
+  min-height: 1.5rem;
+  height: 1.5rem;
+  border: 0;
+  background: transparent;
+  color: hsl(var(--muted-foreground));
+  padding-inline: 0.25rem;
+}
+
+.agent-builder-setup-card--sidebar .agent-builder-setup-card__key-button:hover {
+  background: transparent;
+  color: hsl(var(--foreground));
+}
+
 @container agent-builder-setup (max-width: 560px) {
   .agent-builder-setup-card__content {
     align-items: stretch;
@@ -564,23 +630,19 @@
 
   .agent-builder-setup-card__builder-cta {
     align-items: stretch;
-    flex: 1 1 11rem;
+    flex: 0 1 auto;
   }
 
-  .agent-builder-setup-card__builder-button,
-  .agent-builder-setup-card__key-button {
+  .agent-builder-setup-card__builder-button {
     justify-content: center;
     min-width: 0;
     width: 100%;
   }
 
   .agent-builder-setup-card__key-button {
-    border: 1px solid hsl(var(--border));
-    background: hsl(var(--background));
-    color: hsl(var(--foreground));
-    flex: 1 1 8rem;
-    height: 2rem;
-    padding-inline: 0.75rem;
+    flex: 0 0 auto;
+    min-width: 0;
+    width: auto;
   }
 }
 
@@ -629,6 +691,28 @@
   overflow: visible;
 }
 
+[data-agent-empty-state="compact-setup"] > .agent-chat-scroll {
+  flex: 0 0 auto;
+  overflow: visible;
+}
+
+[data-agent-empty-state="compact-setup"] .agent-empty-state {
+  height: auto;
+  min-height: 5rem;
+  gap: 0.5rem;
+  padding-block: 0.875rem;
+}
+
+[data-agent-empty-state="compact-setup"] .agent-empty-state > div:first-child {
+  width: 2rem;
+  height: 2rem;
+}
+
+[data-agent-empty-state="compact-setup"] .agent-empty-state svg {
+  width: 1rem;
+  height: 1rem;
+}
+
 .agent-thinking-indicator {
   display: inline-flex;
   align-items: center;

package/corpus/core/src/styles/rich-markdown-editor.css

@@ -333,11 +333,12 @@
   display: flex;
   align-items: center;
   border-radius: 6px;
-  background: hsl(0 0% 15%);
+  background: hsl(var(--popover));
+  color: hsl(var(--popover-foreground));
   padding: 3px;
   box-shadow:
     0 4px 16px rgb(0 0 0 / 0.25),
-    0 0 0 1px rgb(255 255 255 / 0.06);
+    0 0 0 1px hsl(var(--border));
 }
 
 .an-rich-md-bubble-items,
@@ -351,7 +352,7 @@
   padding: 3px 6px;
   border-radius: 4px;
   font-size: 12px;
-  color: rgb(255 255 255 / 0.76);
+  color: hsl(var(--popover-foreground) / 0.76);
   background: none;
   border: none;
   cursor: pointer;
@@ -359,20 +360,20 @@
 }
 
 .an-rich-md-bubble-button:hover {
-  background: rgb(255 255 255 / 0.12);
-  color: white;
+  background: hsl(var(--accent));
+  color: hsl(var(--accent-foreground));
 }
 
 .an-rich-md-bubble-button--active {
-  background: rgb(255 255 255 / 0.18);
-  color: white;
+  background: hsl(var(--accent));
+  color: hsl(var(--accent-foreground));
 }
 
 .an-rich-md-bubble-divider {
   width: 1px;
   height: 16px;
   margin: 0 2px;
-  background: rgb(255 255 255 / 0.2);
+  background: hsl(var(--border));
 }
 
 .an-rich-md-link-editor {
@@ -384,7 +385,7 @@
   border: none;
   outline: none;
   background: transparent;
-  color: white;
+  color: hsl(var(--popover-foreground));
   font-size: 12px;
   padding: 2px 4px;
 }
@@ -392,7 +393,7 @@
 .an-rich-md-link-editor button {
   border: none;
   background: none;
-  color: #60a5fa;
+  color: hsl(var(--primary));
   cursor: pointer;
   font-size: 11px;
   font-weight: 500;

package/corpus/templates/analytics/actions/hubspot-deals.ts

@@ -264,6 +264,12 @@ function hasStructuredFilters(filters: ReturnType<typeof buildFilterSummary>) {
 function buildGuidance(options: {
   query: string | undefined;
   structuredFilters: boolean;
+  truncated: boolean;
+  hasMore: boolean;
+  total: number;
+  returned: number;
+  offset: number;
+  limit: number;
 }) {
   const guidance: string[] = [];
 
@@ -285,6 +291,15 @@ function buildGuidance(options: {
     );
   }
 
+  if (options.truncated) {
+    const more = options.hasMore
+      ? `Fetch the next page with offset ${options.offset + options.returned}.`
+      : "This is the last page of the cohort.";
+    guidance.push(
+      `Returned ${options.returned} of ${options.total} matching deals (limit ${options.limit}, offset ${options.offset}). This is a partial slice — do NOT treat it as the full cohort. Use total for counts/aggregates. ${more} Narrow the filters or, for exhaustive cohort analysis, use provider-api-request with provider = hubspot and stageAs.`,
+    );
+  }
+
   return guidance.join(" ");
 }
 
@@ -293,7 +308,7 @@ export default defineAction({
   // reusable across continuation retries (no re-fetch on resume).
   readOnly: true,
   description:
-    "Get HubSpot deals with normalized stage, pipeline, owner, forecast, and NBM fields. This is a bounded deal analytics shortcut, not the full HubSpot capability surface. Use query for a specific customer/deal/account deep dive. For cohorts like products field = Publish, closed-won, pipeline = New Business, or close date in a range, use the structured product, pipeline, closedStatus, closedDateFrom, and closedDateTo filters instead of query when the answer is the deal list itself. If the cohort feeds a cross-source join, transcript/message/ticket search, exhaustive absence check, or downstream code/corpus workflow, prefer provider-api-catalog/provider-api-request with provider = hubspot and stageAs so the cohort is available as a staged dataset. For non-deal CRM records use hubspot-records; for arbitrary HubSpot endpoints, filters, associations, batch APIs, or payloads use provider-api-catalog/provider-api-docs/provider-api-request with provider = hubspot.",
+    "Get HubSpot deals with normalized stage, pipeline, owner, forecast, and NBM fields. This is a bounded deal analytics shortcut, not the full HubSpot capability surface. Use query for a specific customer/deal/account deep dive. For cohorts like products field = Publish, closed-won, pipeline = New Business, or close date in a range, use the structured product, pipeline, closedStatus, closedDateFrom, and closedDateTo filters instead of query when the answer is the deal list itself. If the cohort feeds a cross-source join, transcript/message/ticket search, exhaustive absence check, or downstream code/corpus workflow, prefer provider-api-catalog/provider-api-request with provider = hubspot and stageAs so the cohort is available as a staged dataset. Both paths are bounded: at most limit deals are returned (default 25, max 100). The structured-filter path returns total as the true matched count and a truncated flag; page with offset (or narrow filters) instead of expecting the whole cohort in one call, since a full enriched cohort can be several MB and overruns extension and context budgets. For non-deal CRM records use hubspot-records; for arbitrary HubSpot endpoints, filters, associations, batch APIs, or payloads use provider-api-catalog/provider-api-docs/provider-api-request with provider = hubspot.",
   schema: z.object({
     properties: StringListSchema.describe(
       "Optional comma-separated extra HubSpot deal property names to include.",
@@ -344,7 +359,17 @@ export default defineAction({
       .min(1)
       .max(100)
       .default(25)
-      .describe("Maximum records to return when query is provided."),
+      .describe(
+        "Maximum deals to return. Applies to BOTH full-text query results and structured-filter cohorts. The structured-filter path returns at most this many enriched deals (use total for the true matched count and offset to page).",
+      ),
+    offset: z.coerce
+      .number()
+      .int()
+      .min(0)
+      .default(0)
+      .describe(
+        "Number of structured-filter results to skip before returning limit deals. Use for paging through a large cohort; ignored when query is provided.",
+      ),
     after: z
       .string()
       .optional()
@@ -362,6 +387,7 @@ export default defineAction({
     closedDateTo,
     query,
     limit = 25,
+    offset = 0,
     after,
   }) => {
     const trimmedQuery = query?.trim();
@@ -414,7 +440,7 @@ export default defineAction({
       closedDateTo: closedDateTo?.trim(),
     });
     const structuredFilters = hasStructuredFilters(filters);
-    const deals = rawDeals
+    const matchedDeals = rawDeals
       .filter((d) => visibleIds.has(String(d.properties.pipeline)))
       .map((deal) => enrichDeal(deal, lookups, owners))
       .filter((deal) => {
@@ -435,18 +461,52 @@ export default defineAction({
         return matchesDateRange(deal, fromMs, toMs);
       });
 
+    // The full-text query path is already bounded by HubSpot's own `limit`.
+    // EVERY non-query call (with or without structured filters) scans the whole
+    // visible deal set, so bound the returned cohort here. This is deliberately
+    // NOT gated on `structuredFilters`: the unfiltered `hubspot-deals({})` call
+    // is the LARGEST payload of all (every visible deal), so it must be bounded
+    // too — a full enriched cohort can be multiple MB, which overruns the
+    // extension iframe bridge and the agent context. We
+    // keep `total` as the true matched count and signal partial slices via
+    // `truncated` so callers never mistake a page for the full cohort.
+    // `truncated` means "this response is only part of the cohort" (returned <
+    // total) and stays true on the LAST page of a paginated read too; pagination
+    // (is there a next page) is reported separately via `hasMore` / `nextOffset`.
+    const matchedTotal = matchedDeals.length;
+    const deals = trimmedQuery
+      ? matchedDeals
+      : matchedDeals.slice(offset, offset + limit);
+    const truncated = !trimmedQuery && deals.length < matchedTotal;
+    const hasMore = !trimmedQuery && offset + deals.length < matchedTotal;
+
     return {
       deals,
       stageLabels: lookups.stageLabels,
       pipelineLabels: lookups.pipelineLabels,
-      total: deals.length,
+      total: matchedTotal,
       count: deals.length,
       query: trimmedQuery || null,
       filters,
       nextAfter: Array.isArray(dealResult) ? null : dealResult.nextAfter,
+      ...(trimmedQuery
+        ? {}
+        : {
+            limit,
+            offset,
+            truncated,
+            hasMore,
+            nextOffset: hasMore ? offset + deals.length : null,
+          }),
       guidance: buildGuidance({
         query: trimmedQuery,
         structuredFilters,
+        truncated,
+        hasMore,
+        total: matchedTotal,
+        returned: deals.length,
+        offset,
+        limit,
       }),
       ...(Array.isArray(dealResult)
         ? {}

package/corpus/templates/analytics/app/components/dashboard/CumulativeNetChart.tsx

@@ -12,6 +12,11 @@ import {
 
 import { Card, CardContent, CardHeader, CardTitle } from "@/components/ui/card";
 import { Skeleton } from "@/components/ui/skeleton";
+import {
+  chartAxisStroke,
+  chartGridStroke,
+  chartTooltipContentStyle,
+} from "@/lib/chart-theme";
 
 interface CumulativeNetChartProps {
   title: string;
@@ -78,14 +83,14 @@ export function CumulativeNetChart({
                 </defs>
                 <XAxis
                   dataKey="day"
-                  stroke="#52525b"
+                  stroke={chartAxisStroke}
                   fontSize={12}
                   tickLine={false}
                   axisLine={false}
                   tickFormatter={formatDate}
                 />
                 <YAxis
-                  stroke="#52525b"
+                  stroke={chartAxisStroke}
                   fontSize={12}
                   tickLine={false}
                   axisLine={false}
@@ -93,17 +98,12 @@ export function CumulativeNetChart({
                 />
                 <CartesianGrid
                   strokeDasharray="3 3"
-                  stroke="#27272a"
+                  stroke={chartGridStroke}
                   vertical={false}
                 />
-                <ReferenceLine y={0} stroke="#52525b" strokeWidth={1} />
+                <ReferenceLine y={0} stroke={chartAxisStroke} strokeWidth={1} />
                 <Tooltip
-                  contentStyle={{
-                    backgroundColor: "#09090b",
-                    border: "1px solid #27272a",
-                    borderRadius: "8px",
-                    color: "#fafafa",
-                  }}
+                  contentStyle={chartTooltipContentStyle}
                   labelFormatter={formatDate}
                   formatter={(value: any) => [
                     `$${Number(value).toLocaleString(undefined, { maximumFractionDigits: 0 })}`,

package/corpus/templates/analytics/app/components/dashboard/RevenueChart.tsx

@@ -10,6 +10,11 @@ import {
 } from "recharts";
 
 import { Card, CardContent, CardHeader, CardTitle } from "@/components/ui/card";
+import {
+  chartAxisStroke,
+  chartGridStroke,
+  chartTooltipContentStyle,
+} from "@/lib/chart-theme";
 
 const data = [
   { name: "Jan", total: 1200 },
@@ -49,13 +54,13 @@ export function RevenueChart() {
               </defs>
               <XAxis
                 dataKey="name"
-                stroke="#52525b"
+                stroke={chartAxisStroke}
                 fontSize={12}
                 tickLine={false}
                 axisLine={false}
               />
               <YAxis
-                stroke="#52525b"
+                stroke={chartAxisStroke}
                 fontSize={12}
                 tickLine={false}
                 axisLine={false}
@@ -63,17 +68,12 @@ export function RevenueChart() {
               />
               <CartesianGrid
                 strokeDasharray="3 3"
-                stroke="#27272a"
+                stroke={chartGridStroke}
                 vertical={false}
               />
               <Tooltip
-                contentStyle={{
-                  backgroundColor: "#09090b",
-                  border: "1px solid #27272a",
-                  borderRadius: "8px",
-                  color: "#fafafa",
-                }}
-                itemStyle={{ color: "#38bdf8" }}
+                contentStyle={chartTooltipContentStyle}
+                itemStyle={{ color: "var(--brand-blue)" }}
               />
               <Area
                 type="monotone"

package/corpus/templates/analytics/app/components/dashboard/RevenueComparisonChart.tsx

@@ -14,6 +14,7 @@ import {
 
 import { Card, CardContent, CardHeader, CardTitle } from "@/components/ui/card";
 import { Skeleton } from "@/components/ui/skeleton";
+import { chartAxisStroke, chartGridStroke } from "@/lib/chart-theme";
 
 interface RevenueComparisonChartProps {
   title: string;
@@ -42,7 +43,7 @@ const formatDate = (value: string) => {
 function CustomTooltip({ active, payload, label }: any) {
   if (!active || !payload?.length) return null;
   return (
-    <div className="rounded-lg border border-border bg-[#09090b] px-3 py-2 text-xs text-foreground shadow-lg">
+    <div className="rounded-lg border border-border bg-popover px-3 py-2 text-xs text-popover-foreground shadow-lg">
       <p className="mb-1 font-medium">{formatDate(label)}</p>
       {payload.map((entry: any) => (
         <p
@@ -94,19 +95,19 @@ export function RevenueComparisonChart({
               <ComposedChart data={chartData}>
                 <CartesianGrid
                   strokeDasharray="3 3"
-                  stroke="#27272a"
+                  stroke={chartGridStroke}
                   vertical={false}
                 />
                 <XAxis
                   dataKey="day"
-                  stroke="#52525b"
+                  stroke={chartAxisStroke}
                   fontSize={12}
                   tickLine={false}
                   axisLine={false}
                   tickFormatter={formatDate}
                 />
                 <YAxis
-                  stroke="#52525b"
+                  stroke={chartAxisStroke}
                   fontSize={12}
                   tickLine={false}
                   axisLine={false}
@@ -116,7 +117,7 @@ export function RevenueComparisonChart({
                     return `$${v}`;
                   }}
                 />
-                <ReferenceLine y={0} stroke="#52525b" strokeWidth={1} />
+                <ReferenceLine y={0} stroke={chartAxisStroke} strokeWidth={1} />
                 <Tooltip content={<CustomTooltip />} />
                 <Legend
                   wrapperStyle={{ fontSize: "12px", paddingTop: "8px" }}

package/corpus/templates/analytics/app/components/dashboard/TimeSeriesChart.tsx

@@ -11,6 +11,11 @@ import {
 
 import { Card, CardContent, CardHeader, CardTitle } from "@/components/ui/card";
 import { Skeleton } from "@/components/ui/skeleton";
+import {
+  chartAxisStroke,
+  chartGridStroke,
+  chartTooltipContentStyle,
+} from "@/lib/chart-theme";
 
 interface TimeSeriesChartProps {
   title: string;
@@ -75,14 +80,14 @@ export function TimeSeriesChart({
                 </defs>
                 <XAxis
                   dataKey={xKey}
-                  stroke="#52525b"
+                  stroke={chartAxisStroke}
                   fontSize={12}
                   tickLine={false}
                   axisLine={false}
                   tickFormatter={formatXLabel}
                 />
                 <YAxis
-                  stroke="#52525b"
+                  stroke={chartAxisStroke}
                   fontSize={12}
                   tickLine={false}
                   axisLine={false}
@@ -90,16 +95,11 @@ export function TimeSeriesChart({
                 />
                 <CartesianGrid
                   strokeDasharray="3 3"
-                  stroke="#27272a"
+                  stroke={chartGridStroke}
                   vertical={false}
                 />
                 <Tooltip
-                  contentStyle={{
-                    backgroundColor: "#09090b",
-                    border: "1px solid #27272a",
-                    borderRadius: "8px",
-                    color: "#fafafa",
-                  }}
+                  contentStyle={chartTooltipContentStyle}
                   labelFormatter={formatXLabel}
                 />
                 <Area

package/corpus/templates/analytics/app/global.css

@@ -191,6 +191,10 @@
   overflow: visible;
 }
 
+.analytics-chat-panel .agent-composer-area--hero {
+  padding-inline: 1rem;
+}
+
 .analytics-chat-panel [data-agent-empty-state="centered"] .agent-composer-area {
   width: 100%;
   max-width: min(760px, 90%);

package/corpus/templates/analytics/app/lib/chart-theme.ts

@@ -0,0 +1,13 @@
+import type { CSSProperties } from "react";
+
+export const chartAxisStroke = "hsl(var(--muted-foreground))";
+export const chartGridStroke = "hsl(var(--border))";
+export const chartTooltipCursorStroke = "hsl(var(--muted-foreground) / 0.25)";
+export const chartTooltipCursorFill = "hsl(var(--muted) / 0.5)";
+
+export const chartTooltipContentStyle = {
+  backgroundColor: "hsl(var(--popover))",
+  border: "1px solid hsl(var(--border))",
+  borderRadius: "8px",
+  color: "hsl(var(--popover-foreground))",
+} satisfies CSSProperties;