@canonry/canonry 5.10.0 → 5.12.0

package/dist/{chunk-GQ37ALYP.js → chunk-WJGUBZSW.js}

@@ -4,6 +4,7 @@ import {
 import {
   AGENT_MEMORY_KEY_MAX_LENGTH,
   AGENT_MEMORY_VALUE_MAX_BYTES,
+  AGENT_PROVIDER_IDS,
   CANONRY_NPM_PACKAGE_URL,
   CodingAgents,
   DEFAULT_VIEWER_RESEARCH_DAILY_RUN_LIMIT,
@@ -26,7 +27,9 @@ import {
   adsOperationReconcileRequestSchema,
   adsPauseRequestSchema,
   adsUnresolvedOperationListQuerySchema,
+  agentConversationCreateSchema,
   agentPluginClientLabel,
+  agentProviderIdSchema,
   apiKeyDtoSchema,
   backlinkSourceSchema,
   canonicalizeGtmAccountId,
@@ -130,7 +133,7 @@ import {
   upgradeCaveatFor,
   upgradeCommandFor,
   visibilityReportRequestSchema
-} from "./chunk-KEMMVSAQ.js";
+} from "./chunk-NYRRWWEE.js";
 
 // src/cli-error.ts
 function isMachineFormat(format) {
@@ -205,6 +208,8 @@ var dashboardManagedSweepsSchema = z.boolean().nullish();
 var researchAllowViewersSchema = z.boolean().nullish();
 var researchViewerDailyRunLimitSchema = z.number().int().positive().nullish();
 var dashboardManagedRunKindsSchema = z.array(schedulableRunKindSchema).nullish();
+var agentProviderSchema = agentProviderIdSchema.nullish();
+var agentModelSchema = z.string().trim().min(1).nullish();
 function resolveOperatorApiKeyIds(source) {
   const raw = source.CANONRY_OPERATOR_KEY_IDS?.trim();
   if (!raw) return [];
@@ -459,6 +464,24 @@ Do not use "canonry init --force" for recovery. It replaces credentials without
       message: `Invalid config at ${configPath}: research.viewerDailyRunLimit must be a positive integer or left blank.`
     });
   }
+  if (!agentProviderSchema.safeParse(parsed.agent?.provider).success) {
+    throw new CliError({
+      code: "CONFIG_INVALID",
+      message: `Invalid config at ${configPath}: agent.provider must be one of ${AGENT_PROVIDER_IDS.join(", ")}, or left blank.`
+    });
+  }
+  if (!agentModelSchema.safeParse(parsed.agent?.model).success) {
+    throw new CliError({
+      code: "CONFIG_INVALID",
+      message: `Invalid config at ${configPath}: agent.model must be a non-empty string or left blank.`
+    });
+  }
+  if (parsed.agent?.model && !parsed.agent?.provider) {
+    throw new CliError({
+      code: "CONFIG_INVALID",
+      message: `Invalid config at ${configPath}: agent.model requires agent.provider \u2014 a model id is only meaningful against the provider that serves it.`
+    });
+  }
   if (parsed.geminiApiKey && !parsed.providers?.gemini) {
     parsed.providers = {
       ...parsed.providers,
@@ -624,56 +647,6 @@ function configExists() {
   return fs.existsSync(getConfigPath());
 }
 
-// src/client.ts
-import { AsyncLocalStorage } from "async_hooks";
-
-// src/client-reliability.ts
-function parseRetryAfterMs(header, now = Date.now()) {
-  if (!header) return void 0;
-  const value = header.trim();
-  if (!value) return void 0;
-  if (/^\d+(?:\.\d+)?$/.test(value)) {
-    const delayMs2 = Number(value) * 1e3;
-    return Number.isFinite(delayMs2) && delayMs2 >= 0 && delayMs2 <= Number.MAX_SAFE_INTEGER ? delayMs2 : void 0;
-  }
-  if (!/^[a-z]{3},\s/i.test(value)) return void 0;
-  const target = Date.parse(value);
-  if (!Number.isFinite(target)) return void 0;
-  const delayMs = Math.max(0, target - now);
-  return Number.isSafeInteger(delayMs) ? delayMs : void 0;
-}
-function httpErrorDetails(serverDetails, response) {
-  const retryAfterMs = parseRetryAfterMs(response.headers.get("retry-after"));
-  const requestId = response.headers.get("x-request-id") ?? response.headers.get("request-id");
-  return {
-    ...serverDetails && typeof serverDetails === "object" && !Array.isArray(serverDetails) ? serverDetails : {},
-    httpStatus: response.status,
-    ...retryAfterMs === void 0 ? {} : { retryAfterMs },
-    ...requestId ? { requestId } : {}
-  };
-}
-function isConnectionFailure(message) {
-  return message.includes("fetch failed") || message.includes("ECONNREFUSED") || message.includes("connect ECONNREFUSED");
-}
-function connectionFailureMessage(target) {
-  return `Could not connect to canonry server at ${redactRequestTarget(target)}. Check that this URL is reachable and the server is running. For a local Canonry instance, start it with "canonry start" (a background daemon, stopped with "canonry stop"), or "canonry serve" to run it in the foreground.`;
-}
-function redactRequestTarget(target) {
-  try {
-    const url = new URL(target);
-    url.username = "";
-    url.password = "";
-    for (const key of [...url.searchParams.keys()]) {
-      if (isSensitiveDiagnosticQueryKey(key)) {
-        url.searchParams.set(key, "<redacted>");
-      }
-    }
-    return url.toString();
-  } catch {
-    return target.replace(/\/\/[^/@]*@/, "//");
-  }
-}
-
 // ../api-client-generated/src/generated/core/bodySerializer.gen.ts
 var jsonBodySerializer = {
   bodySerializer: (body) => JSON.stringify(
@@ -5939,6 +5912,70 @@ var getApiV1ProjectsByNameTechnicalAeoRunsByRunIdProgress = (options) => {
     ...options
   });
 };
+var getApiV1ProjectsByNameAgentConversations = (options) => {
+  return (options.client ?? client).get({
+    security: [
+      {
+        scheme: "bearer",
+        type: "http"
+      }
+    ],
+    url: "/api/v1/projects/{name}/agent/conversations",
+    ...options
+  });
+};
+var postApiV1ProjectsByNameAgentConversations = (options) => {
+  return (options.client ?? client).post({
+    security: [
+      {
+        scheme: "bearer",
+        type: "http"
+      }
+    ],
+    url: "/api/v1/projects/{name}/agent/conversations",
+    ...options,
+    headers: {
+      "Content-Type": "application/json",
+      ...options.headers
+    }
+  });
+};
+var deleteApiV1ProjectsByNameAgentConversationsById = (options) => {
+  return (options.client ?? client).delete({
+    security: [
+      {
+        scheme: "bearer",
+        type: "http"
+      }
+    ],
+    url: "/api/v1/projects/{name}/agent/conversations/{id}",
+    ...options
+  });
+};
+var getApiV1ProjectsByNameAgentConversationsById = (options) => {
+  return (options.client ?? client).get({
+    security: [
+      {
+        scheme: "bearer",
+        type: "http"
+      }
+    ],
+    url: "/api/v1/projects/{name}/agent/conversations/{id}",
+    ...options
+  });
+};
+var postApiV1ProjectsByNameAgentConversationsByIdResume = (options) => {
+  return (options.client ?? client).post({
+    security: [
+      {
+        scheme: "bearer",
+        type: "http"
+      }
+    ],
+    url: "/api/v1/projects/{name}/agent/conversations/{id}/resume",
+    ...options
+  });
+};
 var deleteApiV1ProjectsByNameAgentTranscript = (options) => {
   return (options.client ?? client).delete({
     security: [
@@ -6033,6 +6070,56 @@ function createClient2(opts) {
   return createClient(config);
 }
 
+// src/client.ts
+import { AsyncLocalStorage } from "async_hooks";
+
+// src/client-reliability.ts
+function parseRetryAfterMs(header, now = Date.now()) {
+  if (!header) return void 0;
+  const value = header.trim();
+  if (!value) return void 0;
+  if (/^\d+(?:\.\d+)?$/.test(value)) {
+    const delayMs2 = Number(value) * 1e3;
+    return Number.isFinite(delayMs2) && delayMs2 >= 0 && delayMs2 <= Number.MAX_SAFE_INTEGER ? delayMs2 : void 0;
+  }
+  if (!/^[a-z]{3},\s/i.test(value)) return void 0;
+  const target = Date.parse(value);
+  if (!Number.isFinite(target)) return void 0;
+  const delayMs = Math.max(0, target - now);
+  return Number.isSafeInteger(delayMs) ? delayMs : void 0;
+}
+function httpErrorDetails(serverDetails, response) {
+  const retryAfterMs = parseRetryAfterMs(response.headers.get("retry-after"));
+  const requestId = response.headers.get("x-request-id") ?? response.headers.get("request-id");
+  return {
+    ...serverDetails && typeof serverDetails === "object" && !Array.isArray(serverDetails) ? serverDetails : {},
+    httpStatus: response.status,
+    ...retryAfterMs === void 0 ? {} : { retryAfterMs },
+    ...requestId ? { requestId } : {}
+  };
+}
+function isConnectionFailure(message) {
+  return message.includes("fetch failed") || message.includes("ECONNREFUSED") || message.includes("connect ECONNREFUSED");
+}
+function connectionFailureMessage(target) {
+  return `Could not connect to canonry server at ${redactRequestTarget(target)}. Check that this URL is reachable and the server is running. For a local Canonry instance, start it with "canonry start" (a background daemon, stopped with "canonry stop"), or "canonry serve" to run it in the foreground.`;
+}
+function redactRequestTarget(target) {
+  try {
+    const url = new URL(target);
+    url.username = "";
+    url.password = "";
+    for (const key of [...url.searchParams.keys()]) {
+      if (isSensitiveDiagnosticQueryKey(key)) {
+        url.searchParams.set(key, "<redacted>");
+      }
+    }
+    return url.toString();
+  } catch {
+    return target.replace(/\/\/[^/@]*@/, "//");
+  }
+}
+
 // src/client.ts
 function parseServerUpdateAvailable(value) {
   if (!value || typeof value !== "object") return null;
@@ -6212,6 +6299,21 @@ var ApiClient = class {
   // generated SDK and we route them through `invoke()` like every other
   // endpoint. The SSE `POST /agent/prompt` is intentionally not here — it
   // stays on `streamPost()` below since the SDK can't represent SSE cleanly.
+  async listAgentConversations(project, query) {
+    return this.invoke(() => getApiV1ProjectsByNameAgentConversations({ client: this.heyClient, path: { name: project }, query }));
+  }
+  async getAgentConversation(project, id) {
+    return this.invoke(() => getApiV1ProjectsByNameAgentConversationsById({ client: this.heyClient, path: { name: project, id } }));
+  }
+  async createAgentConversation(project, id) {
+    return this.invoke(() => postApiV1ProjectsByNameAgentConversations({ client: this.heyClient, path: { name: project }, body: { id } }));
+  }
+  async resumeAgentConversation(project, id) {
+    return this.invoke(() => postApiV1ProjectsByNameAgentConversationsByIdResume({ client: this.heyClient, path: { name: project, id } }));
+  }
+  async deleteAgentConversation(project, id) {
+    return this.invoke(() => deleteApiV1ProjectsByNameAgentConversationsById({ client: this.heyClient, path: { name: project, id } }));
+  }
   async getAgentTranscript(project) {
     return this.invoke(
       () => getApiV1ProjectsByNameAgentTranscript({ client: this.heyClient, path: { name: project } })
@@ -11784,10 +11886,65 @@ var canonryMcpTools = [
     openApiOperations: ["DELETE /api/v1/projects/{name}/agent/memory"],
     handler: (client2, input) => client2.forgetAgentMemory(input.project, input.key)
   }),
+  defineTool({
+    name: "canonry_agent_conversations_list",
+    title: "List Aero conversations",
+    description: "List Aero conversations. Instance administrators only. New and resume preserve the previous conversation; shared project notes are retained. Creation requires a UUID that must be reused on retries.",
+    access: "read",
+    tier: "agent",
+    inputSchema: projectInputSchema.extend({ offset: z4.number().int().min(0).optional(), limit: z4.number().int().min(1).max(100).optional() }),
+    annotations: readAnnotations(),
+    openApiOperations: ["GET /api/v1/projects/{name}/agent/conversations"],
+    handler: (client2, input) => client2.listAgentConversations(input.project, { offset: input.offset, limit: input.limit })
+  }),
+  defineTool({
+    name: "canonry_agent_conversations_get",
+    title: "Read an Aero conversation",
+    description: "Read an Aero conversation. Instance administrators only. New and resume preserve the previous conversation; shared project notes are retained. Creation requires a UUID that must be reused on retries.",
+    access: "read",
+    tier: "agent",
+    inputSchema: projectInputSchema.extend({ id: z4.string().min(1) }),
+    annotations: readAnnotations(),
+    openApiOperations: ["GET /api/v1/projects/{name}/agent/conversations/{id}"],
+    handler: (client2, input) => client2.getAgentConversation(input.project, input.id)
+  }),
+  defineTool({
+    name: "canonry_agent_conversations_new",
+    title: "Start a new Aero conversation",
+    description: "Start a new Aero conversation. Instance administrators only. New and resume preserve the previous conversation; shared project notes are retained. Creation requires a UUID that must be reused on retries.",
+    access: "write",
+    tier: "agent",
+    inputSchema: projectInputSchema.extend(agentConversationCreateSchema.shape),
+    annotations: writeAnnotations({ idempotentHint: true }),
+    openApiOperations: ["POST /api/v1/projects/{name}/agent/conversations"],
+    handler: (client2, input) => client2.createAgentConversation(input.project, input.id)
+  }),
+  defineTool({
+    name: "canonry_agent_conversations_resume",
+    title: "Resume an Aero conversation",
+    description: "Resume an Aero conversation. Instance administrators only. New and resume preserve the previous conversation; shared project notes are retained. Creation requires a UUID that must be reused on retries.",
+    access: "write",
+    tier: "agent",
+    inputSchema: projectInputSchema.extend({ id: z4.string().min(1) }),
+    annotations: writeAnnotations({ idempotentHint: true }),
+    openApiOperations: ["POST /api/v1/projects/{name}/agent/conversations/{id}/resume"],
+    handler: (client2, input) => client2.resumeAgentConversation(input.project, input.id)
+  }),
+  defineTool({
+    name: "canonry_agent_conversations_delete",
+    title: "Delete an Aero conversation",
+    description: "Delete an Aero conversation. Instance administrators only. New and resume preserve the previous conversation; shared project notes are retained. Creation requires a UUID that must be reused on retries.",
+    access: "write",
+    tier: "agent",
+    inputSchema: projectInputSchema.extend({ id: z4.string().min(1) }),
+    annotations: writeAnnotations({ idempotentHint: true, destructiveHint: true }),
+    openApiOperations: ["DELETE /api/v1/projects/{name}/agent/conversations/{id}"],
+    handler: (client2, input) => client2.deleteAgentConversation(input.project, input.id)
+  }),
   defineTool({
     name: "canonry_agent_clear",
     title: "Clear agent transcript",
-    description: "Clear the rolling Aero conversation for a project \u2014 wipes the transcript, the in-memory pending follow-up buffer, and the persisted follow-up queue. Memory entries (canonry_memory_*) are preserved. Use when starting a fresh dialogue or when the operator wants to reset context.",
+    description: "Clear the rolling Aero conversation for a project \u2014 wipes the transcript, the in-memory pending follow-up buffer, and the persisted follow-up queue. Memory entries (canonry_memory_*) are preserved. Destructive legacy operation. Prefer canonry_agent_conversations_new to start fresh while preserving history.",
     access: "write",
     tier: "agent",
     inputSchema: projectInputSchema,

package/dist/cli.js

@@ -35,11 +35,11 @@ import {
   trackCliCommandFinished,
   trackEvent,
   waitForServerRuntimeStartup
-} from "./chunk-W67ORZUR.js";
+} from "./chunk-KBSAEALE.js";
 import {
   autoSyncSkills,
   formatAutoSyncNotice
-} from "./chunk-HF6MAKWE.js";
+} from "./chunk-S4BIBUCK.js";
 import {
   CliError,
   EXIT_SYSTEM_ERROR,
@@ -66,13 +66,13 @@ import {
   shouldPrintServeSkillsNudge,
   systemError,
   usageError
-} from "./chunk-GQ37ALYP.js";
+} from "./chunk-WJGUBZSW.js";
 import {
   DEFAULT_DEMO_TRUSTED_PROXIES,
   trustedProxiesProblem,
   trustedProxyProblem
 } from "./chunk-RB2F4D3Z.js";
-import "./chunk-S7D23FEE.js";
+import "./chunk-LWGYRN3T.js";
 import "./chunk-AOJU5LKX.js";
 import {
   CLOUDFLARE_WORKER_BINDINGS,
@@ -88,7 +88,7 @@ import {
   queries,
   renderReportHtml,
   runs
-} from "./chunk-KBPSOB55.js";
+} from "./chunk-DOC4QQLS.js";
 import {
   AdsDeliverySnapshotStatuses,
   AdsHistoricalCampaignRollupStatuses,
@@ -123,6 +123,7 @@ import {
   adsGeoSearchQuerySchema,
   adsImageUploadRequestSchema,
   adsPauseRequestSchema,
+  agentConversationListQuerySchema,
   agentTurnLimitsSchema,
   agentViewContextSchema,
   backlinkSourceSchema,
@@ -172,7 +173,7 @@ import {
   snapshotProviderModeSchema,
   visibilityReportRequestSchema,
   winnabilityClassSchema
-} from "./chunk-KEMMVSAQ.js";
+} from "./chunk-NYRRWWEE.js";
 
 // src/cli.ts
 import { pathToFileURL } from "url";
@@ -437,7 +438,7 @@ function parseDemoTrustedProxies(values) {
 async function demoCommand(options) {
   const { host, port } = parseDemoListenOptions(options);
   const trustProxy = parseDemoTrustedProxies(options.trustProxy);
-  const { createDemoServer } = await import("./demo-server-DKH73GRD.js");
+  const { createDemoServer } = await import("./demo-server-OTXS6ZHS.js");
   const app = await createDemoServer({ trustProxy });
   let stopping = false;
   const stop = () => {
@@ -12943,18 +12944,33 @@ async function listSchedules(project, format) {
 function getClient24() {
   return createApiClient();
 }
+async function readCurrentSchedule(client, project, kind) {
+  try {
+    return await client.getSchedule(project, kind);
+  } catch {
+    return void 0;
+  }
+}
 async function setSchedule(project, opts) {
   const client = getClient24();
+  const current = await readCurrentSchedule(client, project, opts.kind);
   const body = {};
   if (opts.kind) body.kind = opts.kind;
-  if (opts.sourceId) body.sourceId = opts.sourceId;
-  if (opts.preset) body.preset = opts.preset;
-  if (opts.cron) body.cron = opts.cron;
+  else if (current) body.kind = current.kind;
   if (opts.everyDays || opts.startDate || opts.at) {
     body.recurrence = { everyDays: Number(opts.everyDays), startDate: opts.startDate, time: opts.at };
-  }
+  } else if (opts.preset) body.preset = opts.preset;
+  else if (opts.cron) body.cron = opts.cron;
+  else if (current?.recurrence) body.recurrence = current.recurrence;
+  else if (current?.preset) body.preset = current.preset;
+  else if (current?.cronExpr) body.cron = current.cronExpr;
   if (opts.timezone) body.timezone = opts.timezone;
+  else if (current) body.timezone = current.timezone;
   if (opts.providers?.length) body.providers = opts.providers;
+  else if (current?.providers.length) body.providers = current.providers;
+  if (opts.sourceId) body.sourceId = opts.sourceId;
+  else if (current?.sourceId) body.sourceId = current.sourceId;
+  if (current) body.expectedUpdatedAt = current.updatedAt;
   const result = await client.putSchedule(project, body);
   if (isMachineFormat(opts.format)) {
     console.log(JSON.stringify(result, null, 2));
@@ -13014,6 +13030,29 @@ async function removeSchedule(project, format, kind) {
   }
   console.log(`Schedule removed for "${project}" (kind: ${resolvedKind})`);
 }
+function formatNextRun(nextRunAt, timezone) {
+  const at = new Date(nextRunAt);
+  if (Number.isNaN(at.getTime())) return nextRunAt;
+  try {
+    const parts = new Intl.DateTimeFormat("en-CA", {
+      timeZone: timezone,
+      year: "numeric",
+      month: "2-digit",
+      day: "2-digit",
+      hour: "2-digit",
+      minute: "2-digit",
+      hour12: false,
+      timeZoneName: "longOffset"
+    }).formatToParts(at);
+    const get = (type) => parts.find((part) => part.type === type)?.value ?? "";
+    const offset = get("timeZoneName").replace("GMT", "") || "+00:00";
+    const local = `${get("year")}-${get("month")}-${get("day")} ${get("hour")}:${get("minute")}`;
+    const utc = `${String(at.getUTCHours()).padStart(2, "0")}:${String(at.getUTCMinutes()).padStart(2, "0")}Z`;
+    return `${local} (${offset}) / ${utc}`;
+  } catch {
+    return nextRunAt;
+  }
+}
 function printSchedule(s) {
   console.log(`  Kind:      ${s.kind}`);
   if (s.preset) {
@@ -13038,7 +13077,7 @@ function printSchedule(s) {
     console.log(`  Last run:  ${s.lastRunAt}`);
   }
   if (s.nextRunAt) {
-    console.log(`  Next run:  ${s.nextRunAt}`);
+    console.log(`  Next run:  ${formatNextRun(s.nextRunAt, s.timezone)}`);
   }
 }
 
@@ -18461,6 +18500,43 @@ var WORDPRESS_CLI_COMMANDS = [
   }
 ];
 
+// src/commands/agent-conversations.ts
+import { randomUUID as randomUUID2 } from "crypto";
+async function agentConversations(opts) {
+  try {
+    const client = createApiClient();
+    const result = await (() => {
+      switch (opts.action) {
+        case "list":
+          return client.listAgentConversations(opts.project, { offset: opts.offset, limit: opts.limit });
+        case "new":
+          return client.createAgentConversation(opts.project, opts.id ?? randomUUID2());
+        case "show":
+          return client.getAgentConversation(opts.project, opts.id);
+        case "resume":
+          return client.resumeAgentConversation(opts.project, opts.id);
+        case "delete":
+          return client.deleteAgentConversation(opts.project, opts.id);
+      }
+    })();
+    if (isMachineFormat(opts.format)) {
+      console.log(JSON.stringify(result, null, 2));
+      return;
+    }
+    if ("conversations" in result) {
+      if (!result.conversations.length) console.log("No Aero conversations yet.");
+      for (const conversation of result.conversations) console.log(`${conversation.active ? "* " : "  "}${conversation.id}  ${conversation.title}  ${conversation.updatedAt}`);
+      if (result.nextOffset !== null) console.log(`More conversations: --offset ${result.nextOffset}`);
+    } else if ("messages" in result) {
+      console.log(`${result.title} \u2014 ${result.id}${result.active ? " (current)" : ""}`);
+      for (const message of result.messages) console.log(`[${message.role}] ${typeof message.content === "string" ? message.content : JSON.stringify(message.content)}`);
+    } else console.log(`Conversation deleted: ${result.id}. Shared project notes kept.`);
+  } catch (error) {
+    printCliError(error, opts.format);
+    process.exitCode = error instanceof CliError ? error.exitCode : 2;
+  }
+}
+
 // src/agent-webhook.ts
 var AGENT_WEBHOOK_EVENTS = ["run.completed", "insight.critical", "insight.high", "citation.gained"];
 
@@ -18529,6 +18605,7 @@ async function agentAsk(opts) {
       `/projects/${encodeURIComponent(opts.project)}/agent/prompt`,
       {
         prompt: opts.prompt,
+        ...opts.conversationId ? { conversationId: opts.conversationId } : {},
         provider: opts.provider,
         modelId: opts.modelId,
         scope: opts.scope ?? "all",
@@ -18805,20 +18882,34 @@ async function agentMemoryForget(opts) {
 // src/cli-commands/agent.ts
 var AGENT_ASK_SCOPES = ["all", "read-only"];
 var AGENT_CLI_COMMANDS = [
+  ...["list", "new", "show", "resume", "delete"].map((action) => ({
+    path: ["agent", "conversations", action],
+    usage: `canonry agent conversations ${action} <project> [--id <conversation-id>] [--offset <n>] [--limit <n>] [--format json]`,
+    options: { id: stringOption(), offset: stringOption(), limit: stringOption() },
+    run: async (input) => {
+      const usage = `canonry agent conversations ${action} <project>`;
+      const project = requireProject(input, `agent.conversations.${action}`, usage);
+      const id = action === "new" || action === "list" ? getString(input.values, "id") : requireStringOption(input, "id", { command: `agent.conversations.${action}`, usage, message: "--id is required" });
+      const query = agentConversationListQuerySchema.safeParse({ offset: getString(input.values, "offset"), limit: getString(input.values, "limit") });
+      if (!query.success) throw usageError("Invalid history pagination", { message: query.error.message });
+      await agentConversations({ project, action, id, ...query.data, format: input.format });
+    }
+  })),
   {
     path: ["agent", "ask"],
-    usage: `canonry agent ask <project> "<prompt>" [--provider ${listAgentProviders().join("|")}] [--model <id>] [--scope all|read-only] [--profile default|ads-operator] [--context <json>] [--max-tool-calls <n>] [--timeout-ms <ms>] [--format json]`,
+    usage: `canonry agent ask <project> "<prompt>" [--provider ${listAgentProviders().join("|")}] [--model <id>] [--scope all|read-only] [--profile default|ads-operator] [--context <json>] [--conversation <id>] [--max-tool-calls <n>] [--timeout-ms <ms>] [--format json]`,
     options: {
       provider: stringOption(),
       model: stringOption(),
       scope: stringOption(),
       profile: stringOption(),
       context: stringOption(),
+      conversation: stringOption(),
       "max-tool-calls": stringOption(),
       "timeout-ms": stringOption()
     },
     run: async (input) => {
-      const usage = `canonry agent ask <project> "<prompt>" [--provider ${listAgentProviders().join("|")}] [--model <id>] [--scope all|read-only] [--profile default|ads-operator] [--context <json>] [--max-tool-calls <n>] [--timeout-ms <ms>] [--format json]`;
+      const usage = `canonry agent ask <project> "<prompt>" [--provider ${listAgentProviders().join("|")}] [--model <id>] [--scope all|read-only] [--profile default|ads-operator] [--context <json>] [--conversation <id>] [--max-tool-calls <n>] [--timeout-ms <ms>] [--format json]`;
       const project = requireProject(input, "agent.ask", usage);
       const prompt2 = input.positionals.slice(1).join(" ").trim();
       if (!prompt2) {
@@ -18884,6 +18975,7 @@ Usage: ${usage}`, {
       if (!parsedLimits.success) throw usageError("Invalid Aero turn limits", { message: parsedLimits.error.message });
       await agentAsk({
         context,
+        conversationId: getString(input.values, "conversation"),
         limits: parsedLimits.data,
         project,
         prompt: prompt2,

package/dist/{demo-server-DKH73GRD.js → demo-server-OTXS6ZHS.js}

@@ -4,7 +4,7 @@ import {
 import {
   layoutSiteCrawlGraphInput,
   persistSiteCrawlGraphLayout
-} from "./chunk-S7D23FEE.js";
+} from "./chunk-LWGYRN3T.js";
 import {
   PACKAGE_VERSION
 } from "./chunk-AOJU5LKX.js";
@@ -83,7 +83,7 @@ import {
   siteCrawlPages,
   siteCrawlSnapshots,
   trafficSources
-} from "./chunk-KBPSOB55.js";
+} from "./chunk-DOC4QQLS.js";
 import {
   RunKinds,
   SiteCrawlFetchStates,
@@ -104,7 +104,7 @@ import {
   measurementPlanV2Schema,
   placementLinkDecision,
   siteAuditPageFactorSchema
-} from "./chunk-KEMMVSAQ.js";
+} from "./chunk-NYRRWWEE.js";
 
 // src/demo-server.ts
 import { dirname, join as join2 } from "path";

package/dist/index.d.ts

@@ -1,6 +1,6 @@
 import { FastifyInstance } from 'fastify';
 import { DatabaseClient } from '@ainyc/canonry-db';
-import { ProviderQuotaPolicy, SchedulableRunKind, EmbedConfigEntry, AgentPluginState, GoogleAdsCampaignMetricsQuery, GoogleAdsRawSnapshotDto, GoogleAdsEffectiveGoalGraphDto, GoogleMarketingProvider, GoogleAdsAccessibleCustomersResponse, GoogleAdsAccessibleCustomerDto, GtmAccountsResponse, GtmContainerListResponse, GtmWorkspaceListResponse, GtmRawSnapshotDto } from '@ainyc/canonry-contracts';
+import { ProviderQuotaPolicy, SchedulableRunKind, AgentProviderId, EmbedConfigEntry, AgentPluginState, GoogleAdsCampaignMetricsQuery, GoogleAdsRawSnapshotDto, GoogleAdsEffectiveGoalGraphDto, GoogleMarketingProvider, GoogleAdsAccessibleCustomersResponse, GoogleAdsAccessibleCustomerDto, GtmAccountsResponse, GtmContainerListResponse, GtmWorkspaceListResponse, GtmRawSnapshotDto } from '@ainyc/canonry-contracts';
 import { GoogleTokenResponse } from '@ainyc/canonry-integration-google';
 
 type GoogleConnectionType = 'gsc' | 'ga4' | 'gbp';
@@ -289,6 +289,33 @@ interface AgentConfigEntry {
      * Both resolvers live in agent-config.ts.
      */
     mode?: 'disabled' | 'prompt-only';
+    /**
+     * Pin the LLM provider Aero reasons with.
+     *
+     * Absent (the default) keeps the historical behaviour: the first provider
+     * holding a usable key wins, by `autoDetectPriority`. That default is an
+     * accident of which ANSWER-ENGINE keys the install happens to hold -- an
+     * install that sweeps with Claude silently gets Claude for Aero too, at that
+     * provider's agent-tier pricing -- so any deployment that cares which model
+     * answers has to say so here rather than rely on detection order.
+     *
+     * Ranked by `resolveSessionProviderAndModel`: an explicit per-request
+     * provider beats this pin, and this pin beats both the persisted session row
+     * and auto-detection. Because it outranks the row, a pin survives the
+     * conversation-delete path that drops that row entirely. An explicit request
+     * lasts one turn: the next turn that names no provider returns to the pin.
+     *
+     * Removing the pin does not move an existing session back to detection:
+     * without a pin a session keeps its stored provider, as it always has, until
+     * its conversation is deleted. Starting a new conversation keeps it too.
+     */
+    provider?: AgentProviderId;
+    /**
+     * Model id for `provider`. Ignored unless `provider` is set: a model slug is
+     * only meaningful against the provider that serves it. Absent uses that
+     * provider's agent-tier default.
+     */
+    model?: string;
 }
 interface DashboardConfigEntry {
     /**

package/dist/index.js

@@ -3,14 +3,14 @@ import {
   createGoogleMarketingCredentialStore,
   createGoogleMarketingRuntime,
   createServer
-} from "./chunk-W67ORZUR.js";
+} from "./chunk-KBSAEALE.js";
 import {
   loadConfig
-} from "./chunk-GQ37ALYP.js";
-import "./chunk-S7D23FEE.js";
+} from "./chunk-WJGUBZSW.js";
+import "./chunk-LWGYRN3T.js";
 import "./chunk-AOJU5LKX.js";
-import "./chunk-KBPSOB55.js";
-import "./chunk-KEMMVSAQ.js";
+import "./chunk-DOC4QQLS.js";
+import "./chunk-NYRRWWEE.js";
 export {
   GoogleMarketingRuntimeError,
   createGoogleMarketingCredentialStore,

package/dist/{intelligence-service-7PVUFJTX.js → intelligence-service-K4U55A2J.js}

@@ -1,8 +1,8 @@
 import {
   HISTORY_WINDOW_RUNS,
   IntelligenceService
-} from "./chunk-KBPSOB55.js";
-import "./chunk-KEMMVSAQ.js";
+} from "./chunk-DOC4QQLS.js";
+import "./chunk-NYRRWWEE.js";
 export {
   HISTORY_WINDOW_RUNS,
   IntelligenceService