@agent-native/core 0.90.11 → 0.91.0

package/corpus/core/src/vite/client.ts

@@ -7,6 +7,10 @@ import { fileURLToPath } from "url";
 
 import type { ConfigEnv, Plugin, UserConfig } from "vite";
 
+import {
+  mergePendingChangelog,
+  parsePendingEntry,
+} from "../changelog/parse.js";
 import { getViteDevRecoveryScript } from "../client/vite-dev-recovery-script.js";
 import { findWorkspaceRoot } from "../scripts/utils.js";
 import { verifyEmbedSessionToken } from "../server/embed-session.js";
@@ -302,9 +306,8 @@ function findWorkspaceCoreSync(
 
 function findLocalWorkspacePackageDeps(
   startDir: string,
-  workspaceRoot: string | null,
+  _workspaceRoot: string | null,
 ): Array<{ packageName: string; packageDir: string }> {
-  if (!workspaceRoot) return [];
   const pkgPath = path.join(startDir, "package.json");
   if (!fs.existsSync(pkgPath)) return [];
 
@@ -315,23 +318,26 @@ function findLocalWorkspacePackageDeps(
       ...(pkg.devDependencies ?? {}),
       ...(pkg.peerDependencies ?? {}),
     } as Record<string, string>;
-    const req = createRequire(pkgPath);
     const seen = new Set<string>();
     const packages: Array<{ packageName: string; packageDir: string }> = [];
 
     for (const [packageName, range] of Object.entries(deps)) {
-      if (!range.startsWith("workspace:")) continue;
       if (seen.has(packageName)) continue;
       seen.add(packageName);
 
       try {
-        const packageJsonPath =
-          findInstalledPackageJsonPath(pkgPath, packageName) ??
-          findPackageJsonFromEntry(req.resolve(packageName));
+        let packageJsonPath: string | null = null;
+        if (range.startsWith("file:")) {
+          packageJsonPath = findFilePackageJsonPath(pkgPath, range);
+        } else {
+          continue;
+        }
         if (!packageJsonPath) continue;
         const packageDir = fs.realpathSync(path.dirname(packageJsonPath));
-        if (!packageDir.startsWith(path.join(workspaceRoot, "packages")))
-          continue;
+        const packageJson = JSON.parse(
+          fs.readFileSync(packageJsonPath, "utf-8"),
+        );
+        if (packageJson?.name !== packageName) continue;
         packages.push({ packageName, packageDir });
       } catch {
         // Dependency may not have been installed yet; ignore it for dev config.
@@ -344,31 +350,16 @@ function findLocalWorkspacePackageDeps(
   }
 }
 
-function findInstalledPackageJsonPath(
+function findFilePackageJsonPath(
   pkgPath: string,
-  packageName: string,
+  range: string,
 ): string | null {
-  const candidate = path.join(
-    path.dirname(pkgPath),
-    "node_modules",
-    ...packageName.split("/"),
-    "package.json",
-  );
-  return fs.existsSync(candidate) ? candidate : null;
-}
-
-function findPackageJsonFromEntry(entryPath: string): string | null {
-  let dir = fs.statSync(entryPath).isDirectory()
-    ? entryPath
-    : path.dirname(entryPath);
-  for (let i = 0; i < 20; i++) {
-    const candidate = path.join(dir, "package.json");
-    if (fs.existsSync(candidate)) return candidate;
-    const parent = path.dirname(dir);
-    if (parent === dir) break;
-    dir = parent;
-  }
-  return null;
+  const spec = range.slice("file:".length);
+  const packageDir = spec.startsWith("//")
+    ? fileURLToPath(range)
+    : path.resolve(path.dirname(pkgPath), spec);
+  const packageJsonPath = path.join(packageDir, "package.json");
+  return fs.existsSync(packageJsonPath) ? packageJsonPath : null;
 }
 
 function findPnpmWorkspaceRoot(startDir: string): string | null {
@@ -600,6 +591,18 @@ const CORE_CLIENT_SUBPATHS = [
   "@agent-native/core/voice",
 ];
 
+const TOOLKIT_CLIENT_SUBPATHS = [
+  "@agent-native/toolkit",
+  "@agent-native/toolkit/app-shell",
+  "@agent-native/toolkit/collab-ui",
+  "@agent-native/toolkit/hooks",
+  "@agent-native/toolkit/onboarding",
+  "@agent-native/toolkit/provider",
+  "@agent-native/toolkit/sharing",
+  "@agent-native/toolkit/ui",
+  "@agent-native/toolkit/utils",
+];
+
 const NODE_SSR_NATIVE_EXTERNALS = ["better-sqlite3", "bindings"];
 
 function getDefaultOptimizeDeps(cwd: string): string[] {
@@ -658,6 +661,10 @@ function getDefaultOptimizeDeps(cwd: string): string[] {
             specifier: "@agent-native/core/client/tools",
             packageName: "@agent-native/core",
           },
+          ...TOOLKIT_CLIENT_SUBPATHS.map((specifier) => ({
+            specifier,
+            packageName: "@agent-native/toolkit",
+          })),
         ] as Array<{ specifier: string; packageName?: string }>)),
     { specifier: "@libsql/client" },
     { specifier: "@amplitude/analytics-browser" },
@@ -1809,6 +1816,133 @@ function ssrStubPlugin(packages: string[]): Plugin | null {
   };
 }
 
+function splitViteRequest(id: string): { file: string; query: string } | null {
+  const queryIndex = id.indexOf("?");
+  if (queryIndex === -1) return null;
+  return {
+    file: id.slice(0, queryIndex),
+    query: id.slice(queryIndex + 1),
+  };
+}
+
+function hasRawQuery(query: string): boolean {
+  return new URLSearchParams(query).has("raw");
+}
+
+function normalizeViteFilePath(file: string): string | null {
+  if (!file || file.startsWith("\0")) return null;
+  const fsPath = file.startsWith("/@fs/") ? file.slice("/@fs".length) : file;
+  try {
+    return decodeURI(fsPath);
+  } catch {
+    return fsPath;
+  }
+}
+
+function changelogRawPathFromId(id: string): string | null {
+  const request = splitViteRequest(id);
+  if (!request || !hasRawQuery(request.query)) return null;
+  const file = normalizeViteFilePath(request.file);
+  if (!file || path.basename(file) !== "CHANGELOG.md") return null;
+  return path.resolve(file);
+}
+
+function resolveChangelogRawImport(
+  source: string,
+  importer: string | undefined,
+): string | null {
+  const request = splitViteRequest(source);
+  if (!request || !hasRawQuery(request.query)) return null;
+  const rawFile = normalizeViteFilePath(request.file);
+  if (!rawFile || path.basename(rawFile) !== "CHANGELOG.md") return null;
+
+  const rawImporter = importer?.split("?")[0];
+  const importerFile =
+    (rawImporter && normalizeViteFilePath(rawImporter)) ||
+    rawImporter ||
+    path.join(process.cwd(), "index.ts");
+  const resolved = path.isAbsolute(rawFile)
+    ? rawFile
+    : path.resolve(path.dirname(importerFile), rawFile);
+  return `${resolved}?${request.query}`;
+}
+
+function readAppChangelogMarkdown(
+  changelogPath: string,
+  watchFile: (file: string) => void,
+): string {
+  // Only ever register real files with Vite's `addWatchFile`. Passing a
+  // directory makes import-analysis try to resolve it as a module and fail
+  // with "Failed to resolve import .../changelog", which breaks hydration for
+  // every template in dev. New/removed pending files are still picked up via
+  // `handleHotUpdate` (Vite watches the project root recursively).
+  watchFile(changelogPath);
+  const existing = fs.existsSync(changelogPath)
+    ? fs.readFileSync(changelogPath, "utf-8")
+    : "";
+  const pendingDir = path.join(path.dirname(changelogPath), "changelog");
+  if (!fs.existsSync(pendingDir)) {
+    return existing;
+  }
+
+  const pending = fs
+    .readdirSync(pendingDir)
+    .filter(
+      (file) => file.endsWith(".md") && file.toLowerCase() !== "readme.md",
+    )
+    .sort()
+    .map((file) => {
+      const filePath = path.join(pendingDir, file);
+      watchFile(filePath);
+      return parsePendingEntry(fs.readFileSync(filePath, "utf-8"));
+    });
+  return mergePendingChangelog(existing, pending);
+}
+
+function isChangelogSourceFile(file: string): boolean {
+  if (path.basename(file) === "CHANGELOG.md") return true;
+  return (
+    path.basename(path.dirname(file)) === "changelog" &&
+    file.endsWith(".md") &&
+    path.basename(file).toLowerCase() !== "readme.md"
+  );
+}
+
+function invalidateChangelogRawModules(server: {
+  moduleGraph?: { idToModuleMap?: Map<string, any>; invalidateModule?: any };
+}) {
+  const moduleGraph = server.moduleGraph;
+  if (!moduleGraph?.idToModuleMap || !moduleGraph.invalidateModule) return;
+  for (const mod of moduleGraph.idToModuleMap.values()) {
+    if (!mod?.id || !changelogRawPathFromId(mod.id)) continue;
+    moduleGraph.invalidateModule(mod);
+  }
+}
+
+function appChangelogRawPlugin(): Plugin {
+  return {
+    name: "agent-native-app-changelog-raw",
+    enforce: "pre",
+    resolveId(source, importer) {
+      return resolveChangelogRawImport(source, importer);
+    },
+    load(id) {
+      const changelogPath = changelogRawPathFromId(id);
+      if (!changelogPath) return null;
+      const markdown = readAppChangelogMarkdown(changelogPath, (file) =>
+        this.addWatchFile(file),
+      );
+      return `export default ${JSON.stringify(markdown)};`;
+    },
+    handleHotUpdate(ctx) {
+      if (!isChangelogSourceFile(ctx.file)) return;
+      invalidateChangelogRawModules(ctx.server as any);
+      ctx.server.ws.send({ type: "full-reload" });
+      return [];
+    },
+  };
+}
+
 /**
  * Expose the resolved Vite dev server port as process.env.PORT so that
  * in-process scripts (which use localFetch → http://localhost:${PORT}/api/...)
@@ -2034,12 +2168,13 @@ function localWorkspacePackageAliases(
       if (!exportsMap || typeof exportsMap !== "object") continue;
 
       for (const [exportPath, target] of Object.entries(exportsMap)) {
-        if (typeof target !== "string") continue;
+        const exportTarget = localWorkspaceExportTarget(packageDir, target);
+        if (!exportTarget) continue;
         const importPath =
           exportPath === "."
             ? packageName
             : `${packageName}${exportPath.slice(1)}`;
-        const replacement = path.resolve(packageDir, target);
+        const replacement = path.resolve(packageDir, exportTarget);
 
         if (importPath.includes("*") || replacement.includes("*")) {
           aliases.push({
@@ -2064,6 +2199,53 @@ function localWorkspacePackageAliases(
   return aliases;
 }
 
+function localWorkspaceExportTarget(
+  packageDir: string,
+  target: unknown,
+): string | null {
+  const rawTarget = pickLocalWorkspaceExportTarget(target);
+  if (!rawTarget) return null;
+  return distExportToSourceTarget(packageDir, rawTarget);
+}
+
+function pickLocalWorkspaceExportTarget(target: unknown): string | null {
+  if (typeof target === "string") return target;
+  if (!target || typeof target !== "object" || Array.isArray(target)) {
+    return null;
+  }
+
+  const record = target as Record<string, unknown>;
+  for (const condition of ["development", "browser", "import", "default"]) {
+    const resolved = pickLocalWorkspaceExportTarget(record[condition]);
+    if (resolved) return resolved;
+  }
+  return null;
+}
+
+function distExportToSourceTarget(packageDir: string, target: string): string {
+  if (!target.startsWith("./dist/")) return target;
+
+  if (target.includes("*")) {
+    return target
+      .replace("./dist/", "./src/")
+      .replace(/\.d\.ts$/, "")
+      .replace(/\.js$/, "");
+  }
+
+  const sourceBase = target
+    .replace("./dist/", "./src/")
+    .replace(/\.d\.ts$/, "")
+    .replace(/\.js$/, "");
+  const candidates = target.endsWith(".css")
+    ? [sourceBase]
+    : [`${sourceBase}.tsx`, `${sourceBase}.ts`, sourceBase];
+
+  for (const candidate of candidates) {
+    if (fs.existsSync(path.resolve(packageDir, candidate))) return candidate;
+  }
+  return target;
+}
+
 function aliasArrayFrom(alias: unknown): any[] {
   if (!alias) return [];
   if (Array.isArray(alias)) return alias;
@@ -2082,7 +2264,6 @@ const DEFAULT_VITE_WATCH_IGNORES = [
   "**/.generated/**",
   "**/.agents/**",
   "**/.claude/**",
-  "**/changelog/**",
   "**/data/**",
   "**/dist/**",
   "**/build/**",
@@ -2118,6 +2299,7 @@ function createAgentNativePlugins(
     // the server, so we can't blanket-stub it here).
     ssrStubPlugin(options.ssrStubs ?? []),
     ...userPlugins,
+    appChangelogRawPlugin(),
     actionTypesPlugin(),
     agentsBundlePlugin(),
     autoReloadOnOptimizeDep(),

package/corpus/templates/analytics/.agents/skills/adhoc-analysis/SKILL.md

@@ -52,14 +52,14 @@ Use the available actions to pull data. Read the relevant `.agents/skills/<provi
 
 **Common data source combinations:**
 
-| Analysis type           | Data sources                                                    |
-| ----------------------- | --------------------------------------------------------------- |
+| Analysis type           | Data sources                                                     |
+| ----------------------- | ---------------------------------------------------------------- |
 | Deal/account deep dive  | `account-deep-dive` bundle, then targeted HubSpot/Gong follow-up |
-| Sales pipeline analysis | HubSpot deals + Gong calls + Slack mentions                     |
-| Customer health check   | HubSpot deals + Pylon support tickets + BigQuery usage events   |
-| Content performance     | BigQuery pageviews + GA4 + SEO keywords + HubSpot signups       |
-| Engineering velocity    | GitHub PRs + Jira tickets + BigQuery deploy events              |
-| Churn investigation     | Stripe billing + HubSpot deals + Pylon tickets + BigQuery usage |
+| Sales pipeline analysis | HubSpot deals + Gong calls + Slack mentions                      |
+| Customer health check   | HubSpot deals + Pylon support tickets + BigQuery usage events    |
+| Content performance     | BigQuery pageviews + GA4 + SEO keywords + HubSpot signups        |
+| Engineering velocity    | GitHub PRs + Jira tickets + BigQuery deploy events               |
+| Churn investigation     | Stripe billing + HubSpot deals + Pylon tickets + BigQuery usage  |
 
 **Tips for data gathering:**
 
@@ -270,6 +270,7 @@ iteration independent.
 
 After completing a significant analysis, update `LEARNINGS.md` (via the
 `resources` tool) or `save-memory` with newly confirmed:
+
 - Metric definitions (how a metric is actually calculated in this dataset)
 - Provider gotchas discovered during the analysis
 - Schema discoveries (table names, column names, join patterns that worked)

package/corpus/templates/analytics/.agents/skills/analysis-workspace/SKILL.md

@@ -52,13 +52,13 @@ window, then read them back selectively for synthesis.
 
 Inside `run-code`, use the workspace helper functions:
 
-| Helper | Use |
-|--------|-----|
-| `workspaceWrite(path, content, contentType?)` | Create or overwrite a file |
-| `workspaceAppend(path, content)` | Append text to a file |
-| `workspaceRead(path, opts?)` | Read content, with optional paging |
-| `workspaceReadMeta(path, opts?)` | Read content plus metadata/truncation info |
-| `workspaceList(prefix?)` | List files under a prefix |
+| Helper                                        | Use                                        |
+| --------------------------------------------- | ------------------------------------------ |
+| `workspaceWrite(path, content, contentType?)` | Create or overwrite a file                 |
+| `workspaceAppend(path, content)`              | Append text to a file                      |
+| `workspaceRead(path, opts?)`                  | Read content, with optional paging         |
+| `workspaceReadMeta(path, opts?)`              | Read content plus metadata/truncation info |
+| `workspaceList(prefix?)`                      | List files under a prefix                  |
 
 - `read` supports `{ offset, maxChars }` for paging large files.
 - `list` supports a prefix filter, e.g. `workspaceList("scratch/q2/")`.
@@ -78,7 +78,7 @@ For large fan-outs (account deep dives, Gong call reviews, deal cohorts):
    await workspaceWrite(
      "scratch/analysis/q2-churn/acme-corp.md",
      "## Acme Corp\n\n**ARR**: $120k\n**Risk signals**: ...",
-     "text/markdown"
+     "text/markdown",
    );
    ```
 4. **Synthesize**: after all items are processed, list files and read each memo:
@@ -131,8 +131,11 @@ provider-api-request
 Returns: `{ savedToFile: true, savedTo, status, bytes, contentType, preview }`.
 
 Then use `run-code` to process the saved file:
+
 ```javascript
-const raw = await workspaceRead("scratch/analysis/provider-records-2026-q2.json");
+const raw = await workspaceRead(
+  "scratch/analysis/provider-records-2026-q2.json",
+);
 const records = JSON.parse(raw);
 // … aggregate, filter, join …
 ```
@@ -157,6 +160,7 @@ provider-api-request
 ```
 
 Common cursor paths:
+
 - HubSpot: `paging.next.after` / `after`
 - Gong: `records.cursor` / `cursor`
 - Pylon: `nextCursor` / `cursor`
@@ -183,7 +187,7 @@ for (const deal of deals) {
 await workspaceWrite(
   "scratch/analysis/deals-by-stage.json",
   JSON.stringify(byStage, null, 2),
-  "application/json"
+  "application/json",
 );
 console.log(JSON.stringify(byStage, null, 2));
 ```

package/corpus/templates/analytics/.agents/skills/bigquery/SKILL.md

@@ -13,7 +13,7 @@ description: >-
 **`bigquery` is available directly in the agent's tool list as a native callable tool.**
 
 - If you see `bigquery` in your available tools — **call it directly with your SQL**. Do not use HTTP workarounds, web-request hacks, or scripts as a substitute.
-- The `server/lib/bigquery.ts` description below is the *underlying implementation*. It does **not** mean BigQuery is only accessible via terminal commands or scripts.
+- The `server/lib/bigquery.ts` description below is the _underlying implementation_. It does **not** mean BigQuery is only accessible via terminal commands or scripts.
 - **When uncertain if the tool works, call it — don't reason your way to "it won't work".** Empirically test by calling the tool.
 
 ## Data-Dictionary-First Discipline
@@ -71,12 +71,12 @@ answers the question.
 
 ## Actions
 
-| Action | Use |
-| --- | --- |
-| `data-source-status --key bigquery` | Check whether BigQuery credentials and project are configured. |
-| `list-data-dictionary --search <topic>` | Find canonical metric/table definitions before SQL. |
-| `search-bigquery-schema` | List datasets, list tables in a dataset, or describe table columns. |
-| `bigquery --sql "<sql>"` | Run a real warehouse query after table/column names are known. |
+| Action                                  | Use                                                                 |
+| --------------------------------------- | ------------------------------------------------------------------- |
+| `data-source-status --key bigquery`     | Check whether BigQuery credentials and project are configured.      |
+| `list-data-dictionary --search <topic>` | Find canonical metric/table definitions before SQL.                 |
+| `search-bigquery-schema`                | List datasets, list tables in a dataset, or describe table columns. |
+| `bigquery --sql "<sql>"`                | Run a real warehouse query after table/column names are known.      |
 
 For direct Amplitude/PostHog/Mixpanel product-event data (outside the warehouse
 copy), there is no first-class action — call `provider-api-catalog` /
@@ -122,15 +122,15 @@ prefer saving a reviewed dictionary update once the meaning is clear.
 
 ## Column Name Differences (Common Bug Sources)
 
-| Spec Column | Actual Column | Table |
-|---|---|---|
+| Spec Column           | Actual Column              | Table           |
+| --------------------- | -------------------------- | --------------- |
 | `first_pageview_date` | `created_date` (TIMESTAMP) | first_pageviews |
-| `channel` (pageviews) | `first_touch_channel` | all_pageviews |
-| `referrer` | `c_referrer` | all_pageviews |
-| `referrer_channel` | `session_channel` | all_pageviews |
-| `user_create_date` | `user_create_d` | product_signups |
-| `deal_stage` | `stage_name` | dim_deals |
-| `deal_amount` | `amount` | dim_deals |
+| `channel` (pageviews) | `first_touch_channel`      | all_pageviews   |
+| `referrer`            | `c_referrer`               | all_pageviews   |
+| `referrer_channel`    | `session_channel`          | all_pageviews   |
+| `user_create_date`    | `user_create_d`            | product_signups |
+| `deal_stage`          | `stage_name`               | dim_deals       |
+| `deal_amount`         | `amount`                   | dim_deals       |
 
 Always verify with `search-bigquery-schema` before writing SQL against an unfamiliar table.
 

package/corpus/templates/analytics/.agents/skills/cross-source-analysis/SKILL.md

@@ -151,6 +151,7 @@ Example provenance footer:
 
 ```markdown
 ## Methodology
+
 - Identities: HubSpot contacts (joined to BigQuery on contact_id + lowercased email)
 - Usage: BigQuery `analytics.events`, 2026-04-01 .. 2026-05-01 UTC
 - Support: Pylon tickets, same window

package/corpus/templates/analytics/.agents/skills/dashboard-management/SKILL.md

@@ -237,8 +237,24 @@ type DashboardPatch = {
 type PanelPatch = {
   title?: string;
   sql?: string;
-  source?: "bigquery" | "ga4" | "amplitude" | "first-party" | "demo" | "prometheus";
-  chartType?: "line" | "area" | "bar" | "metric" | "table" | "pie" | "section" | "heatmap" | "callout" | "extension";
+  source?:
+    | "bigquery"
+    | "ga4"
+    | "amplitude"
+    | "first-party"
+    | "demo"
+    | "prometheus";
+  chartType?:
+    | "line"
+    | "area"
+    | "bar"
+    | "metric"
+    | "table"
+    | "pie"
+    | "section"
+    | "heatmap"
+    | "callout"
+    | "extension";
   width?: number;
   columns?: number;
   tab?: string;
@@ -302,27 +318,27 @@ Examples:
 dashboard.panels(["dau-over-time", "wau-over-time"]).moveToTop();
 dashboard.panel("top-referrers").setTitle("Top Referrers by Domain");
 dashboard.panel("retention").set({
-  "width": 2,
-  "config": { "description": "Updated definition." }
+  width: 2,
+  config: { description: "Updated definition." },
 });
-dashboard.panelsMatching({ "source": "first-party" }).setWidth(2);
-dashboard.panelsMatching({ "titleIncludes": "Revenue" }).setConfigPath(
-  "yAxis.format",
-  "currency"
-);
-dashboard.panelsMatching({ "titleIncludes": "Signed-In" }).moveToTop();
-dashboard.section("retention-activity-section").append([
-  "repeat-users",
-  "retention-over-time"
-]);
-dashboard.insertPanel({
-  "id": "new-kpi",
-  "title": "New KPI",
-  "source": "first-party",
-  "chartType": "metric",
-  "width": 1,
-  "sql": "SELECT COUNT(*) AS value FROM analytics_events"
-}).atTop();
+dashboard.panelsMatching({ source: "first-party" }).setWidth(2);
+dashboard
+  .panelsMatching({ titleIncludes: "Revenue" })
+  .setConfigPath("yAxis.format", "currency");
+dashboard.panelsMatching({ titleIncludes: "Signed-In" }).moveToTop();
+dashboard
+  .section("retention-activity-section")
+  .append(["repeat-users", "retention-over-time"]);
+dashboard
+  .insertPanel({
+    id: "new-kpi",
+    title: "New KPI",
+    source: "first-party",
+    chartType: "metric",
+    width: 1,
+    sql: "SELECT COUNT(*) AS value FROM analytics_events",
+  })
+  .atTop();
 ```
 
 Native tool call: