@agent-native/core 0.119.4 → 0.119.5

package/corpus/templates/tasks/actions/mark-inbox-item-ready.ts

@@ -5,12 +5,14 @@ import { z } from "zod";
 import { markInboxItemReady, requireUserEmail } from "../server/inbox/store.js";
 import type { Task } from "../server/tasks/store.js";
 
+export const markInboxItemReadySchema = z.object({
+  inboxItemId: z.string().describe("Inbox item id"),
+});
+
 export default defineAction({
   description:
-    "Mark an inbox item ready: promotes the inbox item to an incomplete task (same id).",
-  schema: z.object({
-    inboxItemId: z.string().describe("Inbox item id"),
-  }),
+    "Promote one inbox item to an incomplete task, preserving its id. Use bulk-mark-inbox-items-ready for multiple items.",
+  schema: markInboxItemReadySchema,
   run: async (args, ctx) => {
     const ownerEmail = requireUserEmail(ctx?.userEmail);
     return markInboxItemReady({ ownerEmail, id: args.inboxItemId });

package/corpus/templates/tasks/actions/navigate.ts

@@ -21,22 +21,24 @@ import { optionalBooleanQueryParam } from "./lib/boolean-query-param.js";
 
 const viewSchema = z.enum(NAV_VIEW_INPUTS);
 
+export const navigateSchema = z.object({
+  view: viewSchema.describe(
+    "View name to navigate to; home and ask are aliases for tasks",
+  ),
+  taskId: z.string().optional().describe("Selected task id on /tasks"),
+  fieldId: z
+    .string()
+    .optional()
+    .describe("Selected custom field id on /fields"),
+  includeDone: optionalBooleanQueryParam().describe(
+    "When true, show completed tasks on /tasks",
+  ),
+});
+
 export default defineAction({
   description:
-    "Navigate the UI to a specific view. Writes a navigate command to application state which the UI reads and auto-deletes.",
-  schema: z.object({
-    view: viewSchema.describe(
-      "View name to navigate to; home and ask are aliases for tasks",
-    ),
-    taskId: z.string().optional().describe("Selected task id on /tasks"),
-    fieldId: z
-      .string()
-      .optional()
-      .describe("Selected custom field id on /fields"),
-    includeDone: optionalBooleanQueryParam().describe(
-      "When true, show completed tasks on /tasks",
-    ),
-  }),
+    "Navigate the Tasks UI to a view, optionally selecting a task or custom field.",
+  schema: navigateSchema,
   http: false,
   run: async (args) => {
     const view = resolveNavView(args.view);

package/corpus/templates/tasks/actions/reorder-inbox-items.ts

@@ -4,16 +4,18 @@ import { z } from "zod";
 import { reorderInboxItems, requireUserEmail } from "../server/inbox/store.js";
 import { BULK_ID_LIMIT } from "../shared/bulk-limits.js";
 
+export const reorderInboxItemsSchema = z.object({
+  inboxItemIds: z
+    .array(z.string())
+    .min(1)
+    .max(BULK_ID_LIMIT)
+    .describe("Inbox item ids in the desired order from top to bottom."),
+});
+
 export default defineAction({
   description:
     "Reorder the inbox list by passing inbox item ids top-to-bottom.",
-  schema: z.object({
-    inboxItemIds: z
-      .array(z.string())
-      .min(1)
-      .max(BULK_ID_LIMIT)
-      .describe("Inbox item ids in the desired order from top to bottom."),
-  }),
+  schema: reorderInboxItemsSchema,
   run: async (args, ctx) => {
     const ownerEmail = requireUserEmail(ctx?.userEmail);
     return reorderInboxItems({

package/corpus/templates/tasks/actions/update-inbox-item.ts

@@ -4,12 +4,14 @@ import { z } from "zod";
 import { UserInputError } from "../server/errors.js";
 import { requireUserEmail, updateInboxItem } from "../server/inbox/store.js";
 
+export const updateInboxItemSchema = z.object({
+  inboxItemId: z.string().describe("Inbox item id"),
+  title: z.string().min(1).optional().describe("New inbox item title"),
+});
+
 export default defineAction({
   description: "Update an inbox item title.",
-  schema: z.object({
-    inboxItemId: z.string().describe("Inbox item id"),
-    title: z.string().min(1).optional().describe("New inbox item title"),
-  }),
+  schema: updateInboxItemSchema,
   run: async (args, ctx) => {
     const ownerEmail = requireUserEmail(ctx?.userEmail);
     if (args.title === undefined) {

package/corpus/templates/tasks/actions/update-task.ts

@@ -25,16 +25,19 @@ const fieldValuesSchema: z.ZodType<FieldValuePatch[]> = z.preprocess(
   z.array(fieldValuePatchSchema),
 );
 
+export const updateTaskSchema = z.object({
+  taskId: z.string().describe("Task id"),
+  title: z.string().min(1).optional().describe("New task title"),
+  done: z.boolean().optional().describe("Completion state"),
+  fieldValues: fieldValuesSchema
+    .optional()
+    .describe("Custom field values to set or clear for this task"),
+});
+
 export default defineAction({
-  description: "Update a task title, completion state, and/or custom fields.",
-  schema: z.object({
-    taskId: z.string().describe("Task id"),
-    title: z.string().min(1).optional().describe("New task title"),
-    done: z.boolean().optional().describe("Completion state"),
-    fieldValues: fieldValuesSchema
-      .optional()
-      .describe("Custom field values to set or clear for this task"),
-  }),
+  description:
+    "Update one task's title, completion state, and/or custom fields. Use bulk-update-tasks to apply the same title or completion state to multiple tasks.",
+  schema: updateTaskSchema,
   run: async (args, ctx) => {
     const ownerEmail = requireUserEmail(ctx?.userEmail);
     if (

package/corpus/templates/tasks/actions/update-visible-task-fields.ts

@@ -5,17 +5,19 @@ import { requireUserEmail } from "../server/custom-fields/store.js";
 import { setTaskCardFieldIds } from "../server/user-config/store.js";
 import { TASK_CARD_FIELD_LIMIT } from "../shared/visible-task-fields.js";
 
+export const updateVisibleTaskFieldsSchema = z.object({
+  fieldIds: z
+    .array(z.string())
+    .max(TASK_CARD_FIELD_LIMIT)
+    .describe(
+      `Field ids to show on task cards, top-to-bottom. Max ${TASK_CARD_FIELD_LIMIT}.`,
+    ),
+});
+
 export default defineAction({
   description:
     "Replace the custom fields shown on task cards for the current user.",
-  schema: z.object({
-    fieldIds: z
-      .array(z.string())
-      .max(TASK_CARD_FIELD_LIMIT)
-      .describe(
-        `Field ids to show on task cards, top-to-bottom. Max ${TASK_CARD_FIELD_LIMIT}.`,
-      ),
-  }),
+  schema: updateVisibleTaskFieldsSchema,
   run: async (args, ctx) => {
     const ownerEmail = requireUserEmail(ctx?.userEmail);
     const fieldIds = await setTaskCardFieldIds({

package/corpus/templates/tasks/actions/view-screen.ts

@@ -89,7 +89,7 @@ async function readParsedAppState<T>(
 
 export default defineAction({
   description:
-    "See what the user is currently looking at on screen. Returns navigation state, UI bulk selection on /tasks or /inbox when active, visible list snapshot, and selected item. Always call this first before ambiguous task or inbox edits.",
+    "Inspect the current Tasks screen. Returns navigation, visible items, the selected item, and active bulk selection.",
   schema: z.object({}),
   http: false,
   readOnly: true,

package/corpus/templates/tasks/app/components/tasks/fields/TaskFieldsSidebar.tsx

@@ -1,3 +1,4 @@
+import { ExtensionSlot } from "@agent-native/core/client/extensions";
 import { useT } from "@agent-native/core/client/i18n";
 import { useCallback } from "react";
 import { toast } from "sonner";
@@ -76,6 +77,20 @@ function TaskFieldsSidebarPanel({ task }: { task: TaskWithFields }) {
           />
         ))
       )}
+
+      {/* Stable extension contract: changing this slot id or context requires a migration. */}
+      <ExtensionSlot
+        id="tasks.task-detail.bottom"
+        context={{
+          taskId: task.id,
+          title: task.title,
+          done: task.done,
+          fieldValues: fields.map((field) => ({
+            fieldId: field.id,
+            value: field.value ?? null,
+          })),
+        }}
+      />
     </div>
   );
 }

package/corpus/templates/tasks/changelog/2026-07-23-task-detail-extensions.md

@@ -0,0 +1,6 @@
+---
+type: added
+date: 2026-07-23
+---
+
+Task detail panels can now host installed extension widgets.

package/corpus/templates/tasks/drizzle.config.ts

@@ -0,0 +1,3 @@
+import { createDrizzleConfig } from "@agent-native/core/db/drizzle-config";
+
+export default createDrizzleConfig();

package/corpus/templates/tasks/package.json

@@ -12,6 +12,8 @@
     "typecheck": "agent-native typecheck",
     "action": "agent-native action",
     "script": "agent-native script",
+    "db:push": "drizzle-kit push",
+    "db:generate": "drizzle-kit generate",
     "test": "vitest --run --config vitest.config.ts",
     "test:e2e": "playwright test",
     "test:e2e:install": "playwright install chromium",
@@ -26,6 +28,7 @@
     "@fontsource-variable/inter": "^5.2.8",
     "@libsql/client": "^0.15.8",
     "@tabler/icons-react": "catalog:",
+    "drizzle-orm": "^0.45.2",
     "h3": "^2.0.1-rc.20",
     "isbot": "^5",
     "node-pty": "^1.1.0",
@@ -78,7 +81,7 @@
     "class-variance-authority": "^0.7.1",
     "clsx": "^2.1.1",
     "cmdk": "^1.1.1",
-    "drizzle-orm": "^0.45.2",
+    "drizzle-kit": "^0.31.10",
     "embla-carousel-react": "^8.6.0",
     "input-otp": "^1.4.2",
     "next-themes": "^0.4.6",

package/corpus/templates/tasks/server/db/schema.ts

@@ -51,17 +51,7 @@ export const customFieldValues = table(
   }),
 );
 
-export const userConfig = table("user_config", {
-  ownerEmail: text("owner_email").primaryKey(),
-  taskCardFieldIdsJson: text("task_card_field_ids_json")
-    .notNull()
-    .default("[]"),
-  updatedAt: text("updated_at").notNull().default(now()),
-});
-
 export type StoredCustomField = typeof customFields.$inferSelect;
 export type NewCustomField = typeof customFields.$inferInsert;
 export type StoredCustomFieldValue = typeof customFieldValues.$inferSelect;
 export type NewCustomFieldValue = typeof customFieldValues.$inferInsert;
-export type StoredUserConfig = typeof userConfig.$inferSelect;
-export type NewUserConfig = typeof userConfig.$inferInsert;

package/corpus/templates/tasks/server/db/test-tasks-table.ts

@@ -51,11 +51,6 @@ CREATE INDEX IF NOT EXISTS idx_custom_field_values_owner_task
   ON custom_field_values (owner_email, task_id);
 CREATE INDEX IF NOT EXISTS idx_custom_field_values_owner_field
   ON custom_field_values (owner_email, field_id);
-CREATE TABLE IF NOT EXISTS user_config (
-  owner_email TEXT PRIMARY KEY,
-  task_card_field_ids_json TEXT NOT NULL DEFAULT '[]',
-  updated_at TEXT NOT NULL DEFAULT CURRENT_TIMESTAMP
-);
 `;
 
 // libsql, not better-sqlite3: its sync driver lets `.run()`/`.all()`/`.get()` pass here and fail in production.

package/corpus/templates/tasks/server/plugins/agent-chat.ts

@@ -43,6 +43,6 @@ When the user asks to see, review, or manage the task list, check the current-sc
 When view-screen returns selection, treat selectedItems as the user's current UI multi-select on /tasks or /inbox.
 Prefer bulk-update-tasks and bulk-delete-tasks when the user clearly means multiple tasks (e.g. "mark these done", "delete the selected ones", or several titles at once). Use single-task actions for one task or when bulk selection is not in play.
 Prefer bulk-delete-inbox-items when the user clearly means multiple inbox items.
-Ask for confirmation before delete-task, bulk-delete-tasks, delete-inbox-item, and bulk-delete-inbox-items.
+Ask for confirmation before deleting tasks, inbox items, or custom fields.
 Do not use db-query for normal task or inbox operations.`,
 });

package/corpus/templates/tasks/server/plugins/db.ts

@@ -1,6 +1,14 @@
-import { runMigrations } from "@agent-native/core/db";
+import {
+  ensureAdditiveColumns,
+  getDbExec,
+  runMigrations,
+} from "@agent-native/core/db";
 
-export default runMigrations(
+import * as schema from "../db/schema.js";
+
+// Keep historical entries unnamed for legacy-ledger compatibility; every new
+// migration must add a stable, unique `name` slug.
+const runTasksMigrations = runMigrations(
   [
     {
       version: 1,
@@ -77,14 +85,39 @@ export default runMigrations(
       CREATE INDEX IF NOT EXISTS idx_custom_field_values_owner_field
         ON custom_field_values (owner_email, field_id)`,
     },
-    {
-      version: 8,
-      sql: `CREATE TABLE IF NOT EXISTS user_config (
-        owner_email TEXT PRIMARY KEY,
-        task_card_field_ids_json TEXT NOT NULL DEFAULT '[]',
-        updated_at TEXT NOT NULL DEFAULT CURRENT_TIMESTAMP
-      )`,
-    },
   ],
   { table: "tasks_migrations" },
 );
+
+function isDrizzleTable(value: unknown): value is object {
+  return (
+    !!value &&
+    typeof value === "object" &&
+    Object.getOwnPropertySymbols(value).some((s) =>
+      s.toString().includes("drizzle"),
+    )
+  );
+}
+
+const schemaTables = Object.values(schema).filter(isDrizzleTable);
+
+export default async (nitroApp: any): Promise<void> => {
+  await runTasksMigrations(nitroApp);
+  try {
+    const summary = await ensureAdditiveColumns({
+      db: getDbExec(),
+      tables: schemaTables,
+    });
+    if (summary.errors.length > 0) {
+      console.warn(
+        "[db] ensureAdditiveColumns completed with errors:",
+        summary.errors,
+      );
+    }
+  } catch (err) {
+    console.warn(
+      "[db] ensureAdditiveColumns failed (non-fatal):",
+      err instanceof Error ? err.message : err,
+    );
+  }
+};

package/corpus/templates/tasks/server/user-config/store.ts

@@ -1,18 +1,16 @@
-import { eq } from "drizzle-orm";
+import { getUserSetting, putUserSetting } from "@agent-native/core/settings";
 
 import {
   DEFAULT_TASK_CARD_FIELD_NAMES,
   TASK_CARD_FIELD_LIMIT,
 } from "../../shared/visible-task-fields.js";
 import { listCustomFields } from "../custom-fields/store.js";
-import { getDb } from "../db/index.js";
-import { timestamp } from "../db/record-utils.js";
-import { userConfig } from "../db/schema.js";
-import type { DbHandle } from "../db/transaction.js";
 import { UserInputError } from "../errors.js";
 
 export { DEFAULT_TASK_CARD_FIELD_NAMES, TASK_CARD_FIELD_LIMIT };
 
+const VISIBLE_TASK_FIELDS_SETTING_KEY = "visible-task-fields";
+
 function fieldIdsForNames(
   fieldNames: readonly string[],
   fields: readonly { id: string; title: string }[],
@@ -26,16 +24,11 @@ function fieldIdsForNames(
     .slice(0, TASK_CARD_FIELD_LIMIT);
 }
 
-function parseStoredFieldIds(raw: string): string[] {
-  try {
-    const parsed = JSON.parse(raw);
-    if (!Array.isArray(parsed)) return [];
-    return parsed
-      .filter((value): value is string => typeof value === "string")
-      .slice(0, TASK_CARD_FIELD_LIMIT);
-  } catch {
-    return [];
-  }
+function parseFieldIdsValue(value: unknown): string[] {
+  if (!Array.isArray(value)) return [];
+  return value
+    .filter((entry): entry is string => typeof entry === "string")
+    .slice(0, TASK_CARD_FIELD_LIMIT);
 }
 
 function dedupeFieldIds(fieldIds: readonly string[]) {
@@ -49,39 +42,34 @@ function filterKnownFieldIds(
   return fieldIds.filter((fieldId) => knownIds.has(fieldId));
 }
 
-export async function getTaskCardFieldIds(
-  input: {
-    ownerEmail: string;
-  },
-  db: DbHandle = getDb(),
-): Promise<string[]> {
+async function readStoredFieldIds(
+  ownerEmail: string,
+): Promise<string[] | null> {
+  const setting = await getUserSetting(
+    ownerEmail,
+    VISIBLE_TASK_FIELDS_SETTING_KEY,
+  );
+  return setting ? parseFieldIdsValue(setting.fieldIds) : null;
+}
+
+export async function getTaskCardFieldIds(input: {
+  ownerEmail: string;
+}): Promise<string[]> {
   const { fields } = await listCustomFields({ ownerEmail: input.ownerEmail });
   const knownIds = new Set(fields.map((field) => field.id));
 
-  const [row] = await db
-    .select()
-    .from(userConfig)
-    .where(eq(userConfig.ownerEmail, input.ownerEmail))
-    .limit(1);
-
-  if (!row) {
+  const stored = await readStoredFieldIds(input.ownerEmail);
+  if (stored === null) {
     return fieldIdsForNames(DEFAULT_TASK_CARD_FIELD_NAMES, fields);
   }
 
-  return filterKnownFieldIds(
-    parseStoredFieldIds(row.taskCardFieldIdsJson),
-    knownIds,
-  );
+  return filterKnownFieldIds(stored, knownIds);
 }
 
-export async function setTaskCardFieldIds(
-  input: {
-    ownerEmail: string;
-    fieldIds: readonly string[];
-    now?: string;
-  },
-  db: DbHandle = getDb(),
-): Promise<string[]> {
+export async function setTaskCardFieldIds(input: {
+  ownerEmail: string;
+  fieldIds: readonly string[];
+}): Promise<string[]> {
   const { fields } = await listCustomFields({ ownerEmail: input.ownerEmail });
   const knownIds = new Set(fields.map((field) => field.id));
   const next = dedupeFieldIds(input.fieldIds);
@@ -90,49 +78,22 @@ export async function setTaskCardFieldIds(
     throw new UserInputError("fieldIds must reference existing custom fields.");
   }
 
-  const updatedAt = timestamp(input.now);
-  const taskCardFieldIdsJson = JSON.stringify(next);
-
-  await db
-    .insert(userConfig)
-    .values({
-      ownerEmail: input.ownerEmail,
-      taskCardFieldIdsJson,
-      updatedAt,
-    })
-    .onConflictDoUpdate({
-      target: userConfig.ownerEmail,
-      set: { taskCardFieldIdsJson, updatedAt },
-    });
+  await putUserSetting(input.ownerEmail, VISIBLE_TASK_FIELDS_SETTING_KEY, {
+    fieldIds: next,
+  });
 
   return next;
 }
 
-export async function removeTaskCardFieldId(
-  input: {
-    ownerEmail: string;
-    fieldId: string;
-    now?: string;
-  },
-  db: DbHandle = getDb(),
-): Promise<void> {
-  const [row] = await db
-    .select()
-    .from(userConfig)
-    .where(eq(userConfig.ownerEmail, input.ownerEmail))
-    .limit(1);
-
-  if (!row) return;
-
-  const next = parseStoredFieldIds(row.taskCardFieldIdsJson).filter(
-    (fieldId) => fieldId !== input.fieldId,
-  );
-
-  await db
-    .update(userConfig)
-    .set({
-      taskCardFieldIdsJson: JSON.stringify(next),
-      updatedAt: timestamp(input.now),
-    })
-    .where(eq(userConfig.ownerEmail, input.ownerEmail));
+export async function removeTaskCardFieldId(input: {
+  ownerEmail: string;
+  fieldId: string;
+}): Promise<void> {
+  const stored = await readStoredFieldIds(input.ownerEmail);
+  if (stored === null) return;
+
+  const next = stored.filter((fieldId) => fieldId !== input.fieldId);
+  await putUserSetting(input.ownerEmail, VISIBLE_TASK_FIELDS_SETTING_KEY, {
+    fieldIds: next,
+  });
 }

package/corpus/templates/tasks/tsconfig.json

@@ -19,6 +19,5 @@
     "react-router.config.ts",
     ".react-router/types/**/*",
     ".generated/**/*"
-  ],
-  "exclude": ["**/*.test.ts", "**/*.spec.ts"]
+  ]
 }

package/corpus/templates/tasks/vitest.config.ts

@@ -1,8 +1,17 @@
+import path from "node:path";
+
 import { defineConfig } from "vitest/config";
 
 export default defineConfig({
+  resolve: {
+    alias: {
+      "@": path.resolve(__dirname, "./app"),
+      "@shared": path.resolve(__dirname, "./shared"),
+    },
+  },
   test: {
-    include: ["**/*.test.ts"],
+    include: ["**/*.{test,spec}.?(c|m)[jt]s?(x)"],
+    exclude: ["**/node_modules/**", "**/.git/**", "**/dist/**", "**/e2e/**"],
     environment: "node",
   },
 });

package/dist/agent/engine/index.d.ts

@@ -2,7 +2,7 @@
  * Public exports for the pluggable agent engine system.
  */
 export type { AgentEngine, EngineCapabilities, EngineTool, EngineMessage, EngineContentPart, EngineTextPart, EngineImagePart, EngineToolCallPart, EngineToolResultPart, EngineThinkingPart, EngineEvent, EngineStreamOptions, } from "./types.js";
-export { registerAgentEngine, getAgentEngineEntry, listAgentEngines, resolveEngine, getConfiguredEngineNameForRequest, getStoredModelForEngine, normalizeModelForEngine, detectEngineFromEnv, detectEngineFromEnvForRequest, detectEngineFromUserSecrets, isAgentEngineSettingConfigured, isAgentEnginePackageInstalled, isStoredEngineUsable, isStoredEngineUsableForRequest, isResolvedEngineUsableForRequest, type AgentEngineEntry, type ResolveEngineConfig, } from "./registry.js";
+export { registerAgentEngine, getAgentEngineEntry, listAgentEngines, resolveEngine, getConfiguredEngineNameForRequest, getStoredModelForEngine, normalizeModelForEngine, resolveEnginePreservesCustomModels, type NormalizeModelOptions, detectEngineFromEnv, detectEngineFromEnvForRequest, detectEngineFromUserSecrets, isAgentEngineSettingConfigured, isAgentEnginePackageInstalled, isStoredEngineUsable, isStoredEngineUsableForRequest, isResolvedEngineUsableForRequest, type AgentEngineEntry, type ResolveEngineConfig, } from "./registry.js";
 export { createBuilderEngine, BUILDER_DEFAULT_MODEL, BUILDER_SUPPORTED_MODELS, BUILDER_CAPABILITIES, } from "./builder-engine.js";
 export { createAnthropicEngine, ANTHROPIC_DEFAULT_MODEL, ANTHROPIC_SUPPORTED_MODELS, ANTHROPIC_CAPABILITIES, } from "./anthropic-engine.js";
 export { createAISDKEngine, type AISDKProvider } from "./ai-sdk-engine.js";

package/dist/agent/engine/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/agent/engine/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,YAAY,EACV,WAAW,EACX,kBAAkB,EAClB,UAAU,EACV,aAAa,EACb,iBAAiB,EACjB,cAAc,EACd,eAAe,EACf,kBAAkB,EAClB,oBAAoB,EACpB,kBAAkB,EAClB,WAAW,EACX,mBAAmB,GACpB,MAAM,YAAY,CAAC;AAEpB,OAAO,EACL,mBAAmB,EACnB,mBAAmB,EACnB,gBAAgB,EAChB,aAAa,EACb,iCAAiC,EACjC,uBAAuB,EACvB,uBAAuB,EACvB,mBAAmB,EACnB,6BAA6B,EAC7B,2BAA2B,EAC3B,8BAA8B,EAC9B,6BAA6B,EAC7B,oBAAoB,EACpB,8BAA8B,EAC9B,gCAAgC,EAChC,KAAK,gBAAgB,EACrB,KAAK,mBAAmB,GACzB,MAAM,eAAe,CAAC;AAEvB,OAAO,EACL,mBAAmB,EACnB,qBAAqB,EACrB,wBAAwB,EACxB,oBAAoB,GACrB,MAAM,qBAAqB,CAAC;AAE7B,OAAO,EACL,qBAAqB,EACrB,uBAAuB,EACvB,0BAA0B,EAC1B,sBAAsB,GACvB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EAAE,iBAAiB,EAAE,KAAK,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAC3E,OAAO,EAAE,sBAAsB,EAAE,MAAM,cAAc,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/agent/engine/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,YAAY,EACV,WAAW,EACX,kBAAkB,EAClB,UAAU,EACV,aAAa,EACb,iBAAiB,EACjB,cAAc,EACd,eAAe,EACf,kBAAkB,EAClB,oBAAoB,EACpB,kBAAkB,EAClB,WAAW,EACX,mBAAmB,GACpB,MAAM,YAAY,CAAC;AAEpB,OAAO,EACL,mBAAmB,EACnB,mBAAmB,EACnB,gBAAgB,EAChB,aAAa,EACb,iCAAiC,EACjC,uBAAuB,EACvB,uBAAuB,EACvB,kCAAkC,EAClC,KAAK,qBAAqB,EAC1B,mBAAmB,EACnB,6BAA6B,EAC7B,2BAA2B,EAC3B,8BAA8B,EAC9B,6BAA6B,EAC7B,oBAAoB,EACpB,8BAA8B,EAC9B,gCAAgC,EAChC,KAAK,gBAAgB,EACrB,KAAK,mBAAmB,GACzB,MAAM,eAAe,CAAC;AAEvB,OAAO,EACL,mBAAmB,EACnB,qBAAqB,EACrB,wBAAwB,EACxB,oBAAoB,GACrB,MAAM,qBAAqB,CAAC;AAE7B,OAAO,EACL,qBAAqB,EACrB,uBAAuB,EACvB,0BAA0B,EAC1B,sBAAsB,GACvB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EAAE,iBAAiB,EAAE,KAAK,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAC3E,OAAO,EAAE,sBAAsB,EAAE,MAAM,cAAc,CAAC"}

package/dist/agent/engine/index.js

@@ -1,7 +1,7 @@
 /**
  * Public exports for the pluggable agent engine system.
  */
-export { registerAgentEngine, getAgentEngineEntry, listAgentEngines, resolveEngine, getConfiguredEngineNameForRequest, getStoredModelForEngine, normalizeModelForEngine, detectEngineFromEnv, detectEngineFromEnvForRequest, detectEngineFromUserSecrets, isAgentEngineSettingConfigured, isAgentEnginePackageInstalled, isStoredEngineUsable, isStoredEngineUsableForRequest, isResolvedEngineUsableForRequest, } from "./registry.js";
+export { registerAgentEngine, getAgentEngineEntry, listAgentEngines, resolveEngine, getConfiguredEngineNameForRequest, getStoredModelForEngine, normalizeModelForEngine, resolveEnginePreservesCustomModels, detectEngineFromEnv, detectEngineFromEnvForRequest, detectEngineFromUserSecrets, isAgentEngineSettingConfigured, isAgentEnginePackageInstalled, isStoredEngineUsable, isStoredEngineUsableForRequest, isResolvedEngineUsableForRequest, } from "./registry.js";
 export { createBuilderEngine, BUILDER_DEFAULT_MODEL, BUILDER_SUPPORTED_MODELS, BUILDER_CAPABILITIES, } from "./builder-engine.js";
 export { createAnthropicEngine, ANTHROPIC_DEFAULT_MODEL, ANTHROPIC_SUPPORTED_MODELS, ANTHROPIC_CAPABILITIES, } from "./anthropic-engine.js";
 export { createAISDKEngine } from "./ai-sdk-engine.js";

package/dist/agent/engine/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/agent/engine/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAiBH,OAAO,EACL,mBAAmB,EACnB,mBAAmB,EACnB,gBAAgB,EAChB,aAAa,EACb,iCAAiC,EACjC,uBAAuB,EACvB,uBAAuB,EACvB,mBAAmB,EACnB,6BAA6B,EAC7B,2BAA2B,EAC3B,8BAA8B,EAC9B,6BAA6B,EAC7B,oBAAoB,EACpB,8BAA8B,EAC9B,gCAAgC,GAGjC,MAAM,eAAe,CAAC;AAEvB,OAAO,EACL,mBAAmB,EACnB,qBAAqB,EACrB,wBAAwB,EACxB,oBAAoB,GACrB,MAAM,qBAAqB,CAAC;AAE7B,OAAO,EACL,qBAAqB,EACrB,uBAAuB,EACvB,0BAA0B,EAC1B,sBAAsB,GACvB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EAAE,iBAAiB,EAAsB,MAAM,oBAAoB,CAAC;AAC3E,OAAO,EAAE,sBAAsB,EAAE,MAAM,cAAc,CAAC","sourcesContent":["/**\n * Public exports for the pluggable agent engine system.\n */\n\nexport type {\n  AgentEngine,\n  EngineCapabilities,\n  EngineTool,\n  EngineMessage,\n  EngineContentPart,\n  EngineTextPart,\n  EngineImagePart,\n  EngineToolCallPart,\n  EngineToolResultPart,\n  EngineThinkingPart,\n  EngineEvent,\n  EngineStreamOptions,\n} from \"./types.js\";\n\nexport {\n  registerAgentEngine,\n  getAgentEngineEntry,\n  listAgentEngines,\n  resolveEngine,\n  getConfiguredEngineNameForRequest,\n  getStoredModelForEngine,\n  normalizeModelForEngine,\n  detectEngineFromEnv,\n  detectEngineFromEnvForRequest,\n  detectEngineFromUserSecrets,\n  isAgentEngineSettingConfigured,\n  isAgentEnginePackageInstalled,\n  isStoredEngineUsable,\n  isStoredEngineUsableForRequest,\n  isResolvedEngineUsableForRequest,\n  type AgentEngineEntry,\n  type ResolveEngineConfig,\n} from \"./registry.js\";\n\nexport {\n  createBuilderEngine,\n  BUILDER_DEFAULT_MODEL,\n  BUILDER_SUPPORTED_MODELS,\n  BUILDER_CAPABILITIES,\n} from \"./builder-engine.js\";\n\nexport {\n  createAnthropicEngine,\n  ANTHROPIC_DEFAULT_MODEL,\n  ANTHROPIC_SUPPORTED_MODELS,\n  ANTHROPIC_CAPABILITIES,\n} from \"./anthropic-engine.js\";\nexport { createAISDKEngine, type AISDKProvider } from \"./ai-sdk-engine.js\";\nexport { registerBuiltinEngines } from \"./builtin.js\";\n"]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/agent/engine/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAiBH,OAAO,EACL,mBAAmB,EACnB,mBAAmB,EACnB,gBAAgB,EAChB,aAAa,EACb,iCAAiC,EACjC,uBAAuB,EACvB,uBAAuB,EACvB,kCAAkC,EAElC,mBAAmB,EACnB,6BAA6B,EAC7B,2BAA2B,EAC3B,8BAA8B,EAC9B,6BAA6B,EAC7B,oBAAoB,EACpB,8BAA8B,EAC9B,gCAAgC,GAGjC,MAAM,eAAe,CAAC;AAEvB,OAAO,EACL,mBAAmB,EACnB,qBAAqB,EACrB,wBAAwB,EACxB,oBAAoB,GACrB,MAAM,qBAAqB,CAAC;AAE7B,OAAO,EACL,qBAAqB,EACrB,uBAAuB,EACvB,0BAA0B,EAC1B,sBAAsB,GACvB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EAAE,iBAAiB,EAAsB,MAAM,oBAAoB,CAAC;AAC3E,OAAO,EAAE,sBAAsB,EAAE,MAAM,cAAc,CAAC","sourcesContent":["/**\n * Public exports for the pluggable agent engine system.\n */\n\nexport type {\n  AgentEngine,\n  EngineCapabilities,\n  EngineTool,\n  EngineMessage,\n  EngineContentPart,\n  EngineTextPart,\n  EngineImagePart,\n  EngineToolCallPart,\n  EngineToolResultPart,\n  EngineThinkingPart,\n  EngineEvent,\n  EngineStreamOptions,\n} from \"./types.js\";\n\nexport {\n  registerAgentEngine,\n  getAgentEngineEntry,\n  listAgentEngines,\n  resolveEngine,\n  getConfiguredEngineNameForRequest,\n  getStoredModelForEngine,\n  normalizeModelForEngine,\n  resolveEnginePreservesCustomModels,\n  type NormalizeModelOptions,\n  detectEngineFromEnv,\n  detectEngineFromEnvForRequest,\n  detectEngineFromUserSecrets,\n  isAgentEngineSettingConfigured,\n  isAgentEnginePackageInstalled,\n  isStoredEngineUsable,\n  isStoredEngineUsableForRequest,\n  isResolvedEngineUsableForRequest,\n  type AgentEngineEntry,\n  type ResolveEngineConfig,\n} from \"./registry.js\";\n\nexport {\n  createBuilderEngine,\n  BUILDER_DEFAULT_MODEL,\n  BUILDER_SUPPORTED_MODELS,\n  BUILDER_CAPABILITIES,\n} from \"./builder-engine.js\";\n\nexport {\n  createAnthropicEngine,\n  ANTHROPIC_DEFAULT_MODEL,\n  ANTHROPIC_SUPPORTED_MODELS,\n  ANTHROPIC_CAPABILITIES,\n} from \"./anthropic-engine.js\";\nexport { createAISDKEngine, type AISDKProvider } from \"./ai-sdk-engine.js\";\nexport { registerBuiltinEngines } from \"./builtin.js\";\n"]}

package/dist/agent/engine/registry.d.ts

@@ -38,7 +38,38 @@ export declare function getAgentEngineEntry(name: string): AgentEngineEntry | un
 /** List all registered engine entries */
 export declare function listAgentEngines(): AgentEngineEntry[];
 export declare function isAgentEnginePackageInstalled(entry: AgentEngineEntry): boolean;
-export declare function normalizeModelForEngine(engine: Pick<AgentEngine, "name" | "defaultModel" | "supportedModels" | "preserveCustomModels">, model: string | null | undefined): string;
+export interface NormalizeModelOptions {
+    /**
+     * Force unrecognized (custom) model IDs to be kept verbatim, as if
+     * `engine.preserveCustomModels` were set on a live engine instance.
+     *
+     * The settings actions call `normalizeModelForEngine` with a static registry
+     * ENTRY, which never carries the runtime `preserveCustomModels` flag — that
+     * is only set on the engine INSTANCE created with an OpenAI-compatible
+     * `baseUrl`. They resolve the capability with
+     * {@link resolveEnginePreservesCustomModels} and pass it here so a gateway
+     * model (e.g. an Ollama `gemma4`) is not rewritten to the OpenAI default on
+     * save/read. First-party OpenAI (no gateway) leaves this unset, so an unknown
+     * or invalid model still normalizes to a supported one.
+     */
+    preserveCustomModels?: boolean;
+}
+export declare function normalizeModelForEngine(engine: Pick<AgentEngine, "name" | "defaultModel" | "supportedModels" | "preserveCustomModels">, model: string | null | undefined, options?: NormalizeModelOptions): string;
+/**
+ * Whether models saved or read for this engine ENTRY should be preserved
+ * verbatim instead of normalized against the built-in catalog.
+ *
+ * `normalizeModelForEngine` honors a live engine's `preserveCustomModels`, but
+ * that flag is only set on an AI SDK engine INSTANCE when the OpenAI provider
+ * is pointed at an OpenAI-compatible gateway (a custom base URL — e.g. Ollama
+ * Cloud or LiteLLM), whose model IDs are not in the built-in OpenAI catalog.
+ * The static registry entry the settings actions pass to
+ * `normalizeModelForEngine` cannot carry that runtime flag, so this async
+ * helper reproduces the same decision — `ai-sdk:openai` AND a resolved base URL
+ * — from the request's stored/deploy config. First-party OpenAI (no gateway)
+ * returns false so an unknown/invalid model still normalizes to a supported one.
+ */
+export declare function resolveEnginePreservesCustomModels(entry: Pick<AgentEngineEntry, "name">): Promise<boolean>;
 /**
  * First registered engine whose requiredEnvVars are all set. Registration
  * order controls priority — the Builder gateway is registered first so it

package/dist/agent/engine/registry.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../../src/agent/engine/registry.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../../src/agent/engine/registry.ts"],"names":[],"mappings":"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"}