@agent-native/core 0.109.4 → 0.110.1

package/dist/package-lifecycle/migration-manifest.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"migration-manifest.d.ts","sourceRoot":"","sources":["../../src/package-lifecycle/migration-manifest.ts"],"names":[],"mappings":"AAKA,MAAM,WAAW,mBAAmB;IAClC,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,mBAAmB,CAAC;CAC9B;AAED,MAAM,WAAW,aAAa;IAC5B,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,mBAAmB,CAAC,CAAC;IACvD,MAAM,CAAC,EAAE,mBAAmB,CAAC;CAC9B;AAED,MAAM,MAAM,mBAAmB,GAAG,QAAQ,GAAG,SAAS,CAAC;AAEvD,MAAM,WAAW,iBAAiB;IAChC,YAAY,EAAE,MAAM,CAAC;IACrB,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC;CACtC;AAED,MAAM,WAAW,2BAA2B;IAC1C,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,mBAAmB,CAAC;CAC7B;AAED,wBAAgB,mBAAmB,CACjC,IAAI,EAAE,IAAI,CAAC,aAAa,EAAE,QAAQ,CAAC,GAClC,mBAAmB,CAErB;AAED,wBAAgB,qBAAqB,CACnC,YAAY,EAAE,MAAM,GACnB,iBAAiB,GAAG,IAAI,CAgB1B;AAED,wBAAgB,gCAAgC,IAAI,MAAM,CAGzD;AAED,wBAAgB,yBAAyB,IAAI,MAAM,GAAG,IAAI,CAezD;AAQD,wBAAgB,yBAAyB,CACvC,QAAQ,EAAE,iBAAiB,EAC3B,cAAc,EAAE,MAAM,GAAG,IAAI,GAC5B,OAAO,CAST;AAcD,wBAAgB,gCAAgC,CAC9C,WAAW,EAAE,MAAM,GAClB,iBAAiB,EAAE,CAYrB;AAED,wBAAgB,0BAA0B,CACxC,IAAI,EAAE,aAAa,EACnB,YAAY,EAAE,MAAM,GACnB,2BAA2B,GAAG,IAAI,CA6BpC"}

package/dist/package-lifecycle/migration-manifest.js

@@ -0,0 +1,102 @@
+import fs from "node:fs";
+import { createRequire } from "node:module";
+import path from "node:path";
+import { fileURLToPath } from "node:url";
+export function migrationMoveStatus(move) {
+    return move.status === "planned" ? "planned" : "active";
+}
+export function readMigrationManifest(manifestPath) {
+    try {
+        const parsed = JSON.parse(fs.readFileSync(manifestPath, "utf-8"));
+        if (typeof parsed.sinceVersion !== "string" ||
+            !parsed.moves ||
+            typeof parsed.moves !== "object") {
+            return null;
+        }
+        return parsed;
+    }
+    catch {
+        return null;
+    }
+}
+export function bundledCoreMigrationManifestPath() {
+    const here = path.dirname(fileURLToPath(import.meta.url));
+    return path.resolve(here, "../../migration-manifest.json");
+}
+export function bundledCorePackageVersion() {
+    try {
+        const manifest = JSON.parse(fs.readFileSync(path.resolve(path.dirname(fileURLToPath(import.meta.url)), "../../package.json"), "utf-8"));
+        return typeof manifest.version === "string" ? manifest.version : null;
+    }
+    catch {
+        return null;
+    }
+}
+function numericVersion(version) {
+    const match = version.match(/^(\d+)\.(\d+)\.(\d+)/);
+    if (!match)
+        return null;
+    return [Number(match[1]), Number(match[2]), Number(match[3])];
+}
+export function isMigrationManifestActive(manifest, packageVersion) {
+    if (!packageVersion)
+        return false;
+    const current = numericVersion(packageVersion);
+    const since = numericVersion(manifest.sinceVersion);
+    if (!current || !since)
+        return false;
+    for (let index = 0; index < current.length; index += 1) {
+        if (current[index] !== since[index])
+            return current[index] > since[index];
+    }
+    return true;
+}
+function resolveOptionalManifest(projectRoot, specifier) {
+    try {
+        const require = createRequire(path.join(projectRoot, "package.json"));
+        return require.resolve(specifier);
+    }
+    catch {
+        return null;
+    }
+}
+export function loadMigrationManifestsForProject(projectRoot) {
+    const paths = [
+        bundledCoreMigrationManifestPath(),
+        resolveOptionalManifest(projectRoot, "@agent-native/toolkit/migration-manifest.json"),
+    ];
+    return paths
+        .filter((manifestPath) => Boolean(manifestPath))
+        .map(readMigrationManifest)
+        .filter((manifest) => Boolean(manifest));
+}
+export function resolveMigrationSymbolMove(move, importedName) {
+    if (!move.symbols) {
+        return {
+            to: move.to,
+            name: importedName,
+            status: migrationMoveStatus(move),
+        };
+    }
+    const symbolMove = move.symbols[importedName];
+    if (typeof symbolMove === "string") {
+        return {
+            to: move.to,
+            name: symbolMove,
+            status: migrationMoveStatus(move),
+        };
+    }
+    if (symbolMove) {
+        return {
+            to: symbolMove.to,
+            name: symbolMove.name ?? importedName,
+            status: symbolMove.status === "planned"
+                ? "planned"
+                : symbolMove.status === "active"
+                    ? "active"
+                    : migrationMoveStatus(move),
+        };
+    }
+    return null;
+}
+//# sourceMappingURL=migration-manifest.js.map

package/dist/package-lifecycle/migration-manifest.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"migration-manifest.js","sourceRoot":"","sources":["../../src/package-lifecycle/migration-manifest.ts"],"names":[],"mappings":"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","sourcesContent":["import fs from \"node:fs\";\nimport { createRequire } from \"node:module\";\nimport path from \"node:path\";\nimport { fileURLToPath } from \"node:url\";\n\nexport interface MigrationSymbolMove {\n  to: string;\n  name?: string;\n  status?: MigrationMoveStatus;\n}\n\nexport interface MigrationMove {\n  to: string;\n  symbols?: Record<string, string | MigrationSymbolMove>;\n  status?: MigrationMoveStatus;\n}\n\nexport type MigrationMoveStatus = \"active\" | \"planned\";\n\nexport interface MigrationManifest {\n  sinceVersion: string;\n  moves: Record<string, MigrationMove>;\n}\n\nexport interface ResolvedMigrationSymbolMove {\n  to: string;\n  name: string;\n  status: MigrationMoveStatus;\n}\n\nexport function migrationMoveStatus(\n  move: Pick<MigrationMove, \"status\">,\n): MigrationMoveStatus {\n  return move.status === \"planned\" ? \"planned\" : \"active\";\n}\n\nexport function readMigrationManifest(\n  manifestPath: string,\n): MigrationManifest | null {\n  try {\n    const parsed = JSON.parse(\n      fs.readFileSync(manifestPath, \"utf-8\"),\n    ) as Partial<MigrationManifest>;\n    if (\n      typeof parsed.sinceVersion !== \"string\" ||\n      !parsed.moves ||\n      typeof parsed.moves !== \"object\"\n    ) {\n      return null;\n    }\n    return parsed as MigrationManifest;\n  } catch {\n    return null;\n  }\n}\n\nexport function bundledCoreMigrationManifestPath(): string {\n  const here = path.dirname(fileURLToPath(import.meta.url));\n  return path.resolve(here, \"../../migration-manifest.json\");\n}\n\nexport function bundledCorePackageVersion(): string | null {\n  try {\n    const manifest = JSON.parse(\n      fs.readFileSync(\n        path.resolve(\n          path.dirname(fileURLToPath(import.meta.url)),\n          \"../../package.json\",\n        ),\n        \"utf-8\",\n      ),\n    ) as { version?: unknown };\n    return typeof manifest.version === \"string\" ? manifest.version : null;\n  } catch {\n    return null;\n  }\n}\n\nfunction numericVersion(version: string): [number, number, number] | null {\n  const match = version.match(/^(\\d+)\\.(\\d+)\\.(\\d+)/);\n  if (!match) return null;\n  return [Number(match[1]), Number(match[2]), Number(match[3])];\n}\n\nexport function isMigrationManifestActive(\n  manifest: MigrationManifest,\n  packageVersion: string | null,\n): boolean {\n  if (!packageVersion) return false;\n  const current = numericVersion(packageVersion);\n  const since = numericVersion(manifest.sinceVersion);\n  if (!current || !since) return false;\n  for (let index = 0; index < current.length; index += 1) {\n    if (current[index] !== since[index]) return current[index] > since[index];\n  }\n  return true;\n}\n\nfunction resolveOptionalManifest(\n  projectRoot: string,\n  specifier: string,\n): string | null {\n  try {\n    const require = createRequire(path.join(projectRoot, \"package.json\"));\n    return require.resolve(specifier);\n  } catch {\n    return null;\n  }\n}\n\nexport function loadMigrationManifestsForProject(\n  projectRoot: string,\n): MigrationManifest[] {\n  const paths = [\n    bundledCoreMigrationManifestPath(),\n    resolveOptionalManifest(\n      projectRoot,\n      \"@agent-native/toolkit/migration-manifest.json\",\n    ),\n  ];\n  return paths\n    .filter((manifestPath): manifestPath is string => Boolean(manifestPath))\n    .map(readMigrationManifest)\n    .filter((manifest): manifest is MigrationManifest => Boolean(manifest));\n}\n\nexport function resolveMigrationSymbolMove(\n  move: MigrationMove,\n  importedName: string,\n): ResolvedMigrationSymbolMove | null {\n  if (!move.symbols) {\n    return {\n      to: move.to,\n      name: importedName,\n      status: migrationMoveStatus(move),\n    };\n  }\n  const symbolMove = move.symbols[importedName];\n  if (typeof symbolMove === \"string\") {\n    return {\n      to: move.to,\n      name: symbolMove,\n      status: migrationMoveStatus(move),\n    };\n  }\n  if (symbolMove) {\n    return {\n      to: symbolMove.to,\n      name: symbolMove.name ?? importedName,\n      status:\n        symbolMove.status === \"planned\"\n          ? \"planned\"\n          : symbolMove.status === \"active\"\n            ? \"active\"\n            : migrationMoveStatus(move),\n    };\n  }\n  return null;\n}\n"]}

package/dist/package-lifecycle/migration-message.d.ts

@@ -0,0 +1,3 @@
+export declare const AGENT_NATIVE_UPGRADE_CODEMOD_COMMAND = "npx @agent-native/core@latest upgrade --codemods";
+export declare function migrationMoveMessage(from: string, to: string): string;
+//# sourceMappingURL=migration-message.d.ts.map

package/dist/package-lifecycle/migration-message.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"migration-message.d.ts","sourceRoot":"","sources":["../../src/package-lifecycle/migration-message.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,oCAAoC,qDACG,CAAC;AAErD,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,MAAM,CAErE"}

package/dist/package-lifecycle/migration-message.js

@@ -0,0 +1,5 @@
+export const AGENT_NATIVE_UPGRADE_CODEMOD_COMMAND = "npx @agent-native/core@latest upgrade --codemods";
+export function migrationMoveMessage(from, to) {
+    return `${from} moved to ${to}. Run: ${AGENT_NATIVE_UPGRADE_CODEMOD_COMMAND}`;
+}
+//# sourceMappingURL=migration-message.js.map

package/dist/package-lifecycle/migration-message.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"migration-message.js","sourceRoot":"","sources":["../../src/package-lifecycle/migration-message.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,oCAAoC,GAC/C,kDAAkD,CAAC;AAErD,MAAM,UAAU,oBAAoB,CAAC,IAAY,EAAE,EAAU;IAC3D,OAAO,GAAG,IAAI,aAAa,EAAE,UAAU,oCAAoC,EAAE,CAAC;AAChF,CAAC","sourcesContent":["export const AGENT_NATIVE_UPGRADE_CODEMOD_COMMAND =\n  \"npx @agent-native/core@latest upgrade --codemods\";\n\nexport function migrationMoveMessage(from: string, to: string): string {\n  return `${from} moved to ${to}. Run: ${AGENT_NATIVE_UPGRADE_CODEMOD_COMMAND}`;\n}\n"]}

package/dist/package-lifecycle/tombstone.d.ts

@@ -0,0 +1,10 @@
+import { type MigrationManifest } from "./migration-manifest.js";
+export interface TombstoneModuleOptions {
+    from: string;
+    manifest: MigrationManifest;
+    helperImport: string;
+    valueExports?: string[];
+    typeExports?: string[];
+}
+export declare function renderTombstoneModule(options: TombstoneModuleOptions): string;
+//# sourceMappingURL=tombstone.d.ts.map

package/dist/package-lifecycle/tombstone.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tombstone.d.ts","sourceRoot":"","sources":["../../src/package-lifecycle/tombstone.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,iBAAiB,EACvB,MAAM,yBAAyB,CAAC;AAGjC,MAAM,WAAW,sBAAsB;IACrC,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,iBAAiB,CAAC;IAC5B,YAAY,EAAE,MAAM,CAAC;IACrB,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;CACxB;AAED,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,sBAAsB,GAAG,MAAM,CA6B7E"}

package/dist/package-lifecycle/tombstone.js

@@ -0,0 +1,23 @@
+import { migrationMoveStatus, } from "./migration-manifest.js";
+import { migrationMoveMessage } from "./migration-message.js";
+export function renderTombstoneModule(options) {
+    const move = options.manifest.moves[options.from];
+    if (!move || migrationMoveStatus(move) !== "active") {
+        throw new Error(`Cannot render a tombstone for ${options.from} without an active exact migration manifest move.`);
+    }
+    const to = move.to;
+    const message = migrationMoveMessage(options.from, to);
+    const lines = [
+        `import { throwMovedAgentNativeModule, type DeprecatedExport } from ${JSON.stringify(options.helperImport)};`,
+        "",
+        `throwMovedAgentNativeModule(${JSON.stringify(options.from)}, ${JSON.stringify(to)});`,
+    ];
+    for (const name of [...(options.valueExports ?? [])].sort()) {
+        lines.push("", `/** @deprecated ${message} */`, `export const ${name} = undefined as DeprecatedExport<${JSON.stringify(message)}>;`);
+    }
+    for (const name of [...(options.typeExports ?? [])].sort()) {
+        lines.push("", `/** @deprecated ${message} */`, `export type ${name} = DeprecatedExport<${JSON.stringify(message)}>;`);
+    }
+    return `${lines.join("\n")}\n`;
+}
+//# sourceMappingURL=tombstone.js.map

package/dist/package-lifecycle/tombstone.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tombstone.js","sourceRoot":"","sources":["../../src/package-lifecycle/tombstone.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,mBAAmB,GAEpB,MAAM,yBAAyB,CAAC;AACjC,OAAO,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AAU9D,MAAM,UAAU,qBAAqB,CAAC,OAA+B;IACnE,MAAM,IAAI,GAAG,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;IAClD,IAAI,CAAC,IAAI,IAAI,mBAAmB,CAAC,IAAI,CAAC,KAAK,QAAQ,EAAE,CAAC;QACpD,MAAM,IAAI,KAAK,CACb,iCAAiC,OAAO,CAAC,IAAI,mDAAmD,CACjG,CAAC;IACJ,CAAC;IACD,MAAM,EAAE,GAAG,IAAI,CAAC,EAAE,CAAC;IACnB,MAAM,OAAO,GAAG,oBAAoB,CAAC,OAAO,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;IACvD,MAAM,KAAK,GAAG;QACZ,sEAAsE,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,YAAY,CAAC,GAAG;QAC7G,EAAE;QACF,+BAA+B,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,IAAI,CAAC,SAAS,CAAC,EAAE,CAAC,IAAI;KACvF,CAAC;IACF,KAAK,MAAM,IAAI,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,YAAY,IAAI,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC;QAC5D,KAAK,CAAC,IAAI,CACR,EAAE,EACF,mBAAmB,OAAO,KAAK,EAC/B,gBAAgB,IAAI,oCAAoC,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,IAAI,CACpF,CAAC;IACJ,CAAC;IACD,KAAK,MAAM,IAAI,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,WAAW,IAAI,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC;QAC3D,KAAK,CAAC,IAAI,CACR,EAAE,EACF,mBAAmB,OAAO,KAAK,EAC/B,eAAe,IAAI,uBAAuB,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,IAAI,CACtE,CAAC;IACJ,CAAC;IACD,OAAO,GAAG,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC;AACjC,CAAC","sourcesContent":["import {\n  migrationMoveStatus,\n  type MigrationManifest,\n} from \"./migration-manifest.js\";\nimport { migrationMoveMessage } from \"./migration-message.js\";\n\nexport interface TombstoneModuleOptions {\n  from: string;\n  manifest: MigrationManifest;\n  helperImport: string;\n  valueExports?: string[];\n  typeExports?: string[];\n}\n\nexport function renderTombstoneModule(options: TombstoneModuleOptions): string {\n  const move = options.manifest.moves[options.from];\n  if (!move || migrationMoveStatus(move) !== \"active\") {\n    throw new Error(\n      `Cannot render a tombstone for ${options.from} without an active exact migration manifest move.`,\n    );\n  }\n  const to = move.to;\n  const message = migrationMoveMessage(options.from, to);\n  const lines = [\n    `import { throwMovedAgentNativeModule, type DeprecatedExport } from ${JSON.stringify(options.helperImport)};`,\n    \"\",\n    `throwMovedAgentNativeModule(${JSON.stringify(options.from)}, ${JSON.stringify(to)});`,\n  ];\n  for (const name of [...(options.valueExports ?? [])].sort()) {\n    lines.push(\n      \"\",\n      `/** @deprecated ${message} */`,\n      `export const ${name} = undefined as DeprecatedExport<${JSON.stringify(message)}>;`,\n    );\n  }\n  for (const name of [...(options.typeExports ?? [])].sort()) {\n    lines.push(\n      \"\",\n      `/** @deprecated ${message} */`,\n      `export type ${name} = DeprecatedExport<${JSON.stringify(message)}>;`,\n    );\n  }\n  return `${lines.join(\"\\n\")}\\n`;\n}\n"]}

package/dist/package-lifecycle/upgrade-error.d.ts

@@ -0,0 +1,11 @@
+declare const deprecatedExportBrand: unique symbol;
+export type DeprecatedExport<Message extends string> = never & {
+    readonly [deprecatedExportBrand]: Message;
+};
+export declare class AgentNativeUpgradeError extends Error {
+    readonly name = "AgentNativeUpgradeError";
+    constructor(from: string, to: string);
+}
+export declare function throwMovedAgentNativeModule(from: string, to: string): never;
+export {};
+//# sourceMappingURL=upgrade-error.d.ts.map

package/dist/package-lifecycle/upgrade-error.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"upgrade-error.d.ts","sourceRoot":"","sources":["../../src/package-lifecycle/upgrade-error.ts"],"names":[],"mappings":"AAEA,OAAO,CAAC,MAAM,qBAAqB,EAAE,OAAO,MAAM,CAAC;AAEnD,MAAM,MAAM,gBAAgB,CAAC,OAAO,SAAS,MAAM,IAAI,KAAK,GAAG;IAC7D,QAAQ,CAAC,CAAC,qBAAqB,CAAC,EAAE,OAAO,CAAC;CAC3C,CAAC;AAEF,qBAAa,uBAAwB,SAAQ,KAAK;IAChD,SAAkB,IAAI,6BAA6B;IAEnD,YAAY,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAEnC;CACF;AAED,wBAAgB,2BAA2B,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,KAAK,CAE3E"}

package/dist/package-lifecycle/upgrade-error.js

@@ -0,0 +1,11 @@
+import { migrationMoveMessage } from "./migration-message.js";
+export class AgentNativeUpgradeError extends Error {
+    name = "AgentNativeUpgradeError";
+    constructor(from, to) {
+        super(migrationMoveMessage(from, to));
+    }
+}
+export function throwMovedAgentNativeModule(from, to) {
+    throw new AgentNativeUpgradeError(from, to);
+}
+//# sourceMappingURL=upgrade-error.js.map

package/dist/package-lifecycle/upgrade-error.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"upgrade-error.js","sourceRoot":"","sources":["../../src/package-lifecycle/upgrade-error.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AAQ9D,MAAM,OAAO,uBAAwB,SAAQ,KAAK;IAC9B,IAAI,GAAG,yBAAyB,CAAC;IAEnD,YAAY,IAAY,EAAE,EAAU;QAClC,KAAK,CAAC,oBAAoB,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,CAAC;IACxC,CAAC;CACF;AAED,MAAM,UAAU,2BAA2B,CAAC,IAAY,EAAE,EAAU;IAClE,MAAM,IAAI,uBAAuB,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;AAC9C,CAAC","sourcesContent":["import { migrationMoveMessage } from \"./migration-message.js\";\n\ndeclare const deprecatedExportBrand: unique symbol;\n\nexport type DeprecatedExport<Message extends string> = never & {\n  readonly [deprecatedExportBrand]: Message;\n};\n\nexport class AgentNativeUpgradeError extends Error {\n  override readonly name = \"AgentNativeUpgradeError\";\n\n  constructor(from: string, to: string) {\n    super(migrationMoveMessage(from, to));\n  }\n}\n\nexport function throwMovedAgentNativeModule(from: string, to: string): never {\n  throw new AgentNativeUpgradeError(from, to);\n}\n"]}

package/dist/progress/routes.d.ts

@@ -15,7 +15,7 @@ export declare function createProgressHandler(): import("h3").EventHandlerWithFe
     error: string;
     ok?: undefined;
 } | {
-    error?: undefined;
     ok: boolean;
+    error?: undefined;
 }>>;
 //# sourceMappingURL=routes.d.ts.map

package/dist/resources/handlers.d.ts

@@ -49,8 +49,8 @@ export declare function handleUpdateResource(event: any): Promise<import("./stor
 }>;
 /** DELETE /_agent-native/resources/:id — delete a resource */
 export declare function handleDeleteResource(event: any): Promise<{
-    ok?: undefined;
     error: string;
+    ok?: undefined;
 } | {
     error?: undefined;
     ok: boolean;

package/dist/secrets/routes.d.ts

@@ -34,37 +34,37 @@ export declare function createListSecretsHandler(): import("h3").EventHandlerWit
 /** POST /_agent-native/secrets/:key — write a secret. */
 export declare function createWriteSecretHandler(): import("h3").EventHandlerWithFetch<import("h3").EventHandlerRequest, Promise<{
     error: string;
-    ok?: undefined;
     status?: undefined;
+    ok?: undefined;
 } | {
-    error?: undefined;
     ok: boolean;
     status: string;
+    error?: undefined;
 } | {
-    ok?: undefined;
     error: string;
     removed?: undefined;
+    ok?: undefined;
 } | {
-    error?: undefined;
     ok: boolean;
     removed: boolean;
+    error?: undefined;
 }>>;
 /**
  * POST /_agent-native/secrets/:key/test — re-run the validator against the
  * current stored value without changing anything. Useful for the "Test" button.
  */
 export declare function createTestSecretHandler(): import("h3").EventHandlerWithFetch<import("h3").EventHandlerRequest, Promise<{
-    ok?: undefined;
     error: string;
     note?: undefined;
+    ok?: undefined;
 } | {
-    error?: undefined;
     ok: boolean;
     note?: undefined;
-} | {
     error?: undefined;
+} | {
     ok: boolean;
     note: string;
+    error?: undefined;
 } | {
     note?: undefined;
     ok: boolean;
@@ -95,12 +95,12 @@ export interface AdHocSecretPayload {
 export declare function createAdHocSecretHandler(): import("h3").EventHandlerWithFetch<import("h3").EventHandlerRequest, Promise<AdHocSecretPayload[] | {
     error: string;
 } | {
-    error?: undefined;
     ok: boolean;
     key: string;
-} | {
     error?: undefined;
+} | {
     ok: boolean;
     removed: boolean;
+    error?: undefined;
 }>>;
 //# sourceMappingURL=routes.d.ts.map

package/dist/server/agent-engine-api-key-route.d.ts

@@ -27,11 +27,11 @@ export declare function resolveAgentEngineApiKeyWriteTarget(event: H3Event, scop
 export declare function createAgentEngineApiKeyHandler(): import("h3").EventHandlerWithFetch<import("h3").EventHandlerRequest, Promise<{
     error: any;
 } | {
-    error?: undefined;
     ok: boolean;
     key: string;
     baseUrlKey?: string;
     scope: AgentEngineApiKeyScope;
+    error?: undefined;
 }>>;
 export {};
 //# sourceMappingURL=agent-engine-api-key-route.d.ts.map

package/dist/server/transcribe-voice.d.ts

@@ -20,7 +20,7 @@ export declare function createTranscribeVoiceHandler(): import("h3").EventHandle
     error: string;
     text?: undefined;
 } | {
-    error?: undefined;
     text: string;
+    error?: undefined;
 }>>;
 //# sourceMappingURL=transcribe-voice.d.ts.map

package/dist/templates/chat/.agents/skills/actions/SKILL.md

@@ -309,7 +309,7 @@ The frontend calls actions using React Query hooks from `@agent-native/core/clie
 ### `useActionQuery` — for GET actions
 
 ```ts
-import { useActionQuery } from "@agent-native/core/client";
+import { useActionQuery } from "@agent-native/core/client/hooks";
 
 function MealList() {
   // Types are auto-inferred from the action's schema + return type — no manual generic needed
@@ -323,7 +323,7 @@ function MealList() {
 ### `useActionMutation` — for POST/PUT/DELETE actions
 
 ```ts
-import { useActionMutation } from "@agent-native/core/client";
+import { useActionMutation } from "@agent-native/core/client/hooks";
 
 function AddMealButton() {
   // Types are auto-inferred — no manual generic needed
@@ -343,7 +343,7 @@ Mutations automatically invalidate all `["action"]` query keys on success, so GE
 ### `callAction` — for imperative client code
 
 ```ts
-import { callAction } from "@agent-native/core/client";
+import { callAction } from "@agent-native/core/client/hooks";
 
 const people = await callAction("search-people", { query }, { method: "GET" });
 ```

package/dist/templates/chat/.agents/skills/adding-a-feature/SKILL.md

@@ -32,7 +32,7 @@ Build the user-facing interface — a page, component, dialog, or route. Use `us
 - **Raw `useQuery` with custom keys** — needs explicit wiring. Fold `useChangeVersions([<source>, "action"])` from `@agent-native/core/client` into the `queryKey` and set `placeholderData: (prev) => prev`. The `action` source is the reliable signal (the agent runner emits it after every successful tool call); the resource-specific source (`"dashboards"`, `"analyses"`, `"settings"`, etc.) is bonus when emitted. Without this wiring, agent writes will be invisible until manual refresh — that breaks the framework's #1 promise.
 
   ```tsx
-  import { useChangeVersions } from "@agent-native/core/client";
+  import { useChangeVersions } from "@agent-native/core/client/hooks";
   import { useQuery } from "@tanstack/react-query";
 
   const v = useChangeVersions(["dashboards", "action"]);

package/dist/templates/chat/.agents/skills/delegate-to-agent/SKILL.md

@@ -29,7 +29,7 @@ The agent is the single AI interface. It has context about the full project, can
 **From the UI (client):**
 
 ```ts
-import { sendToAgentChat } from "@agent-native/core/client";
+import { sendToAgentChat } from "@agent-native/core/client/agent-chat";
 
 sendToAgentChat({
   message: "Generate a summary of this document",
@@ -41,7 +41,7 @@ sendToAgentChat({
 **From the UI, in the background:**
 
 ```ts
-import { sendToAgentChat } from "@agent-native/core/client";
+import { sendToAgentChat } from "@agent-native/core/client/agent-chat";
 
 sendToAgentChat({
   message: "Analyze this import and create any missing records",
@@ -83,7 +83,7 @@ Do not call provider SDKs directly.
 **From the UI, detecting when agent is done:**
 
 ```ts
-import { useAgentChatGenerating } from "@agent-native/core/client";
+import { useAgentChatGenerating } from "@agent-native/core/client/agent-chat";
 
 function MyComponent() {
   const isGenerating = useAgentChatGenerating();

package/dist/templates/chat/.agents/skills/feature-flags/SKILL.md

@@ -81,7 +81,7 @@ run: async (args, ctx) => {
 Use the client hook only to hide or reveal hydrated UI:
 
 ```tsx
-import { useFeatureFlag } from "@agent-native/core/client";
+import { useFeatureFlag } from "@agent-native/core/client/feature-flags";
 
 const enabled = useFeatureFlag(FULL_APP_BUILDING.key);
 return enabled ? <FullAppOption /> : null;

package/dist/templates/chat/.agents/skills/real-time-sync/SKILL.md

@@ -26,7 +26,7 @@ The agent modifies data in SQL, but the UI runs in the browser. SSE bridges same
 2. **Client** listens for sync events and updates per-source change counters:
 
    ```ts
-   import { useDbSync } from "@agent-native/core/client";
+   import { useDbSync } from "@agent-native/core/client/hooks";
    useDbSync({ queryClient });
    ```
 
@@ -35,7 +35,7 @@ The agent modifies data in SQL, but the UI runs in the browser. SSE bridges same
 3. **Templates fold per-source counters into their query keys.** This is the pattern that makes "agent writes show up without a manual refresh" reliable:
 
    ```ts
-   import { useChangeVersion } from "@agent-native/core/client";
+   import { useChangeVersion } from "@agent-native/core/client/hooks";
    import { useQuery } from "@tanstack/react-query";
 
    const v = useChangeVersion("dashboards");
@@ -61,7 +61,7 @@ The agent modifies data in SQL, but the UI runs in the browser. SSE bridges same
 - Don't open your own `EventSource` to `/_agent-native/events`. A tab must hold exactly ONE SSE connection no matter how many features listen — extra streams eat the browser's per-origin connection budget and can starve ordinary data fetches (worst on HTTP/1.1 dev servers). Subscribe to the shared transport instead:
 
   ```ts
-  import { subscribeSyncEvents } from "@agent-native/core/client";
+  import { subscribeSyncEvents } from "@agent-native/core/client/hooks";
 
   const unsubscribe = subscribeSyncEvents({
     onEvents: (events) => {
@@ -198,7 +198,7 @@ When the agent renames the record, the query refetches, `props.title` updates, b
 **Derived-state surfaces (form fields, inline editors, popovers): use `useReconciledState`.** It re-adopts the authoritative external value when it changes, except while the user is actively editing that field — so agent mutations show up live without clobbering in-progress typing:
 
 ```ts
-import { useReconciledState } from "@agent-native/core/client";
+import { useReconciledState } from "@agent-native/core/client/hooks";
 
 // `active` = true while the user is editing this field (focused / dirty).
 const [title, setTitle] = useReconciledState(props.title, { active: isEditing });

package/dist/templates/chat/.agents/skills/upgrade-agent-native/SKILL.md

@@ -28,18 +28,20 @@ install → refresh scaffold skills → verify, then fix **app** code only.
 
 ## How
 
-1. **Doctor first (optional but recommended)**
+1. **Preview migration codemods first**
 
    ```bash
-   npx @agent-native/core@latest upgrade check
+   npx @agent-native/core@latest upgrade --codemods
    ```
 
-   This reports framework overrides/patches and pending `@agent-native/*`
-   bumps. If overrides/patches are present, remove them before continuing.
+   Codemods are preview-by-default: read the diff before applying it. Do not
+   manually edit imports before running this command; the migration manifest is
+   the source of truth for renamed specifiers and symbols.
 
-2. **Run the upgrade**
+2. **Apply the reviewed codemods, then run the upgrade**
 
    ```bash
+   npx @agent-native/core@latest upgrade --codemods --yes
    npx @agent-native/core@latest upgrade
    ```
 
@@ -67,8 +69,13 @@ install → refresh scaffold skills → verify, then fix **app** code only.
    agent-native upgrade --dry-run
    agent-native upgrade --skip-verify
    agent-native upgrade --skip-install   # package.json bumps only
+   agent-native doctor --only migration-manifest
    ```
 
+   `migration-manifest` has no opt-out. Run it in CI before upgrading to find
+   imports that will break, then use `npx @agent-native/core@latest upgrade --codemods`
+   to preview the supported rewrite.
+
 ## Don't
 
 - Don't add `pnpm.overrides`, `overrides`, `resolutions`, or

package/dist/templates/chat/app/components/layout/Header.tsx

@@ -1,4 +1,5 @@
-import { AgentToggleButton, useT } from "@agent-native/core/client";
+import { AgentToggleButton } from "@agent-native/core/client/agent-chat";
+import { useT } from "@agent-native/core/client/i18n";
 import {
   useHeaderTitle,
   useHeaderActions,

package/dist/templates/chat/app/components/layout/Layout.tsx

@@ -4,8 +4,8 @@ import {
   navigateWithAgentChatViewTransition,
   useAgentChatHomeHandoff,
   useAgentChatHomeHandoffLinks,
-  useT,
-} from "@agent-native/core/client";
+} from "@agent-native/core/client/agent-chat";
+import { useT } from "@agent-native/core/client/i18n";
 import { HeaderActionsProvider } from "@agent-native/toolkit/app-shell";
 import { IconMenu2 } from "@tabler/icons-react";
 import { useState, useEffect } from "react";

package/dist/templates/chat/app/components/layout/Sidebar.tsx

@@ -1,13 +1,13 @@
 import {
-  appPath,
-  FeedbackButton,
   navigateWithAgentChatViewTransition,
   useChatThreads,
-  useT,
   type ChatThreadSummary,
-} from "@agent-native/core/client";
+} from "@agent-native/core/client/agent-chat";
+import { appPath } from "@agent-native/core/client/api-path";
 import { ExtensionsSidebarSection } from "@agent-native/core/client/extensions";
+import { useT } from "@agent-native/core/client/i18n";
 import { OrgSwitcher } from "@agent-native/core/client/org";
+import { FeedbackButton } from "@agent-native/core/client/ui";
 import {
   IconArchive,
   IconBrain,

package/dist/templates/chat/app/hooks/use-navigation-state.ts

@@ -1,10 +1,9 @@
 import {
-  appBasePath,
   isAgentChatHomeHandoffActive,
-  appPath,
   markAgentChatHomeHandoff,
-  useAgentRouteState,
-} from "@agent-native/core/client";
+} from "@agent-native/core/client/agent-chat";
+import { appBasePath, appPath } from "@agent-native/core/client/api-path";
+import { useAgentRouteState } from "@agent-native/core/client/navigation";
 import { useLocation } from "react-router";
 
 import { TAB_ID } from "@/lib/tab-id";

package/dist/templates/chat/app/i18n/index.ts

@@ -1,4 +1,4 @@
-import type { AgentNativeI18nCatalog } from "@agent-native/core/client";
+import { type AgentNativeI18nCatalog } from "@agent-native/core/client/i18n";
 
 import enUS from "./en-US";
 

package/dist/templates/chat/app/i18n-data.ts

@@ -1,4 +1,4 @@
-import type { LocaleCode } from "@agent-native/core/client";
+import { type LocaleCode } from "@agent-native/core/client/i18n";
 
 import zhTW from "./i18n/zh-TW";
 

package/dist/templates/chat/app/lib/utils.ts

@@ -1 +1 @@
-export { cn } from "@agent-native/core/client";
+export { cn } from "@agent-native/toolkit/utils";

package/dist/templates/chat/app/root.tsx

@@ -1,15 +1,16 @@
-import { useDbSync } from "@agent-native/core/client";
+import { configureTracking } from "@agent-native/core/client/analytics";
+import { appPath } from "@agent-native/core/client/api-path";
+import { useDbSync } from "@agent-native/core/client/hooks";
 import {
   AppProviders,
-  CommandMenu,
-  appPath,
-  configureTracking,
   createAgentNativeQueryClient,
-  getLocaleInitScript,
-  getThemeInitScript,
+} from "@agent-native/core/client/hooks";
+import { getLocaleInitScript, useT } from "@agent-native/core/client/i18n";
+import {
+  CommandMenu,
   useCommandMenuShortcut,
-  useT,
-} from "@agent-native/core/client";
+} from "@agent-native/core/client/navigation";
+import { getThemeInitScript } from "@agent-native/core/client/ui";
 import { IconBrain, IconSun, IconMoon } from "@tabler/icons-react";
 import { useQueryClient } from "@tanstack/react-query";
 import { useTheme } from "next-themes";
@@ -169,4 +170,4 @@ export default function Root() {
   );
 }
 
-export { ErrorBoundary } from "@agent-native/core/client";
+export { ErrorBoundary } from "@agent-native/core/client/ui";

package/dist/templates/chat/app/routes/_index.tsx

@@ -1,8 +1,8 @@
 import {
   AgentChatSurface,
   markAgentChatHomeHandoff,
-  useT,
-} from "@agent-native/core/client";
+} from "@agent-native/core/client/agent-chat";
+import { useT } from "@agent-native/core/client/i18n";
 import { useEffect } from "react";
 import { useNavigate, useParams } from "react-router";
 

package/dist/templates/chat/app/routes/agent.tsx

@@ -1,4 +1,8 @@
-import * as AgentClient from "@agent-native/core/client";
+import {
+  AgentChatSurface,
+  AgentTabsPage,
+} from "@agent-native/core/client/agent-chat";
+import { useT } from "@agent-native/core/client/i18n";
 import { useSetPageTitle } from "@agent-native/toolkit/app-shell";
 
 import { resolveAgentPageComponent } from "@/lib/agent-page";
@@ -9,9 +13,12 @@ export function meta() {
 }
 
 export default function AgentRoute() {
-  const t = AgentClient.useT();
+  const t = useT();
   useSetPageTitle(t("settings.agentTitle"));
 
-  const AgentPage = resolveAgentPageComponent(AgentClient);
+  const AgentPage = resolveAgentPageComponent({
+    AgentChatSurface,
+    AgentTabsPage,
+  });
   return <AgentPage appName={APP_TITLE} />;
 }

package/dist/templates/chat/app/routes/database.tsx

@@ -1,5 +1,5 @@
-import { useT } from "@agent-native/core/client";
 import { DbAdminPage } from "@agent-native/core/client/db-admin";
+import { useT } from "@agent-native/core/client/i18n";
 import { useSetPageTitle } from "@agent-native/toolkit/app-shell";
 
 export function meta() {