@ainyc/canonry 2.14.2 → 2.16.0

package/dist/{chunk-CILBPOHB.js → chunk-CKABU6PE.js}

@@ -1,5 +1,4 @@
 import {
-  AGENT_MEMORY_KEY_MAX_LENGTH,
   AGENT_MEMORY_VALUE_MAX_BYTES,
   AGENT_PROVIDER_IDS,
   AgentProviderIds,
@@ -21,6 +20,7 @@ import {
   authRequired,
   brandKeyFromText,
   buildRunErrorFromMessages,
+  canonryMcpTools,
   categorizeSource,
   categoryLabel,
   competitorBatchRequestSchema,
@@ -60,7 +60,7 @@ import {
   visibilityStateFromAnswerMentioned,
   windowCutoff,
   wordpressEnvSchema
-} from "./chunk-7VWSR5F6.js";
+} from "./chunk-HNVRN5QL.js";
 import {
   IntelligenceService,
   agentMemory,
@@ -5547,6 +5547,73 @@ var canonryLocalRouteCatalog = [
       404: { description: "Project not found." }
     }
   },
+  {
+    method: "get",
+    path: "/api/v1/projects/{name}/agent/memory",
+    summary: "List durable Aero memory entries for a project",
+    description: "Returns the project-scoped agent_memory rows newest-first. Includes both operator-authored notes (source `user`/`aero`) and LLM-authored compaction summaries (source `compaction`, key prefix `compaction:`). The N most-recent rows are also injected into the system prompt at every new session start.",
+    tags: ["agent"],
+    parameters: [nameParameter],
+    responses: {
+      200: { description: "Memory entries returned." },
+      404: { description: "Project not found." }
+    }
+  },
+  {
+    method: "put",
+    path: "/api/v1/projects/{name}/agent/memory",
+    summary: "Upsert a durable Aero memory entry",
+    description: "Creates or replaces a project-scoped note (max 2 KB, max 128-char key). Same key replaces the prior value. Keys with the reserved `compaction:` prefix are rejected \u2014 that namespace is owned by transcript compaction.",
+    tags: ["agent"],
+    parameters: [nameParameter],
+    requestBody: {
+      required: true,
+      content: {
+        "application/json": {
+          schema: {
+            type: "object",
+            required: ["key", "value"],
+            properties: {
+              key: { type: "string", description: "Stable identifier for this note (max 128 chars)." },
+              value: { type: "string", description: "Plain-text note body (max 2 KB)." }
+            }
+          }
+        }
+      }
+    },
+    responses: {
+      200: { description: "Entry upserted." },
+      400: { description: "Validation failed (key length, value size, reserved prefix)." },
+      404: { description: "Project not found." }
+    }
+  },
+  {
+    method: "delete",
+    path: "/api/v1/projects/{name}/agent/memory",
+    summary: "Delete a durable Aero memory entry",
+    description: "Removes a single project-scoped note by key. Returns `status: missing` (non-error) when the key never existed. Keys with the reserved `compaction:` prefix are rejected \u2014 those notes are pruned automatically.",
+    tags: ["agent"],
+    parameters: [nameParameter],
+    requestBody: {
+      required: true,
+      content: {
+        "application/json": {
+          schema: {
+            type: "object",
+            required: ["key"],
+            properties: {
+              key: { type: "string", description: "Exact key of the note to remove." }
+            }
+          }
+        }
+      }
+    },
+    responses: {
+      200: { description: "Entry removed or already absent." },
+      400: { description: "Validation failed (reserved prefix)." },
+      404: { description: "Project not found." }
+    }
+  },
   {
     method: "get",
     path: "/api/v1/projects/{name}/agent/providers",
@@ -8848,6 +8915,10 @@ async function ga4Routes(app, opts) {
           GROUP BY date, source, medium
         )`
     ).get();
+    const aiBySession = app.db.select({
+      sessions: sql5`COALESCE(SUM(${gaAiReferrals.sessions}), 0)`,
+      users: sql5`COALESCE(SUM(${gaAiReferrals.users}), 0)`
+    }).from(gaAiReferrals).where(and8(...aiConditions, eq19(gaAiReferrals.sourceDimension, "session"))).get();
     const socialReferrals = app.db.select({
       source: gaSocialReferrals.source,
       medium: gaSocialReferrals.medium,
@@ -8883,6 +8954,8 @@ async function ga4Routes(app, opts) {
       })),
       aiSessionsDeduped: aiDeduped?.sessions ?? 0,
       aiUsersDeduped: aiDeduped?.users ?? 0,
+      aiSessionsBySession: aiBySession?.sessions ?? 0,
+      aiUsersBySession: aiBySession?.users ?? 0,
       socialReferrals: socialReferrals.map((r) => ({
         source: r.source,
         medium: r.medium,
@@ -8894,6 +8967,7 @@ async function ga4Routes(app, opts) {
       socialUsers: socialTotals?.users ?? 0,
       organicSharePct: total > 0 ? Math.round((summaryRow?.totalOrganicSessions ?? 0) / total * 100) : 0,
       aiSharePct: total > 0 ? Math.round((aiDeduped?.sessions ?? 0) / total * 100) : 0,
+      aiSharePctBySession: total > 0 ? Math.round((aiBySession?.sessions ?? 0) / total * 100) : 0,
       directSharePct: total > 0 ? Math.round(totalDirectSessions / total * 100) : 0,
       socialSharePct: total > 0 ? Math.round((socialTotals?.sessions ?? 0) / total * 100) : 0,
       lastSyncedAt: latestSync?.syncedAt ?? null,
@@ -9013,12 +9087,13 @@ async function ga4Routes(app, opts) {
     const pct = (cur, prev) => prev === 0 ? null : Math.round((cur - prev) / prev * 100);
     const sumTotal = (from, to) => app.db.select({ sessions: sql5`COALESCE(SUM(${gaTrafficSnapshots.sessions}), 0)` }).from(gaTrafficSnapshots).where(and8(eq19(gaTrafficSnapshots.projectId, project.id), sql5`${gaTrafficSnapshots.date} >= ${from}`, sql5`${gaTrafficSnapshots.date} < ${to}`)).get();
     const sumOrganic = (from, to) => app.db.select({ sessions: sql5`COALESCE(SUM(${gaTrafficSnapshots.organicSessions}), 0)` }).from(gaTrafficSnapshots).where(and8(eq19(gaTrafficSnapshots.projectId, project.id), sql5`${gaTrafficSnapshots.date} >= ${from}`, sql5`${gaTrafficSnapshots.date} < ${to}`)).get();
-    const sumAi = (from, to) => app.db.select({ sessions: sql5`COALESCE(SUM(max_sessions), 0)` }).from(sql5`(
-        SELECT date, source, medium, MAX(sessions) AS max_sessions
-        FROM ga_ai_referrals
-        WHERE project_id = ${project.id} AND date >= ${from} AND date < ${to}
-        GROUP BY date, source, medium
-      )`).get();
+    const sumDirect = (from, to) => app.db.select({ sessions: sql5`COALESCE(SUM(${gaTrafficSnapshots.directSessions}), 0)` }).from(gaTrafficSnapshots).where(and8(eq19(gaTrafficSnapshots.projectId, project.id), sql5`${gaTrafficSnapshots.date} >= ${from}`, sql5`${gaTrafficSnapshots.date} < ${to}`)).get();
+    const sumAi = (from, to) => app.db.select({ sessions: sql5`COALESCE(SUM(${gaAiReferrals.sessions}), 0)` }).from(gaAiReferrals).where(and8(
+      eq19(gaAiReferrals.projectId, project.id),
+      sql5`${gaAiReferrals.date} >= ${from}`,
+      sql5`${gaAiReferrals.date} < ${to}`,
+      eq19(gaAiReferrals.sourceDimension, "session")
+    )).get();
     const sumSocial = (from, to) => app.db.select({ sessions: sql5`COALESCE(SUM(${gaSocialReferrals.sessions}), 0)` }).from(gaSocialReferrals).where(and8(eq19(gaSocialReferrals.projectId, project.id), sql5`${gaSocialReferrals.date} >= ${from}`, sql5`${gaSocialReferrals.date} < ${to}`)).get();
     const todayStr = fmt(today);
     const buildTrend = (sum) => {
@@ -9028,18 +9103,18 @@ async function ga4Routes(app, opts) {
       const p30 = sum(daysAgo2(60), daysAgo2(30))?.sessions ?? 0;
       return { sessions7d: c7, sessionsPrev7d: p7, trend7dPct: pct(c7, p7), sessions30d: c30, sessionsPrev30d: p30, trend30dPct: pct(c30, p30) };
     };
-    const aiSourceCurrent = app.db.select({ source: sql5`source`, sessions: sql5`COALESCE(SUM(max_sessions), 0)` }).from(sql5`(
-        SELECT date, source, medium, MAX(sessions) AS max_sessions
-        FROM ga_ai_referrals
-        WHERE project_id = ${project.id} AND date >= ${daysAgo2(7)} AND date < ${todayStr}
-        GROUP BY date, source, medium
-      )`).groupBy(sql5`source`).all();
-    const aiSourcePrev = app.db.select({ source: sql5`source`, sessions: sql5`COALESCE(SUM(max_sessions), 0)` }).from(sql5`(
-        SELECT date, source, medium, MAX(sessions) AS max_sessions
-        FROM ga_ai_referrals
-        WHERE project_id = ${project.id} AND date >= ${daysAgo2(14)} AND date < ${daysAgo2(7)}
-        GROUP BY date, source, medium
-      )`).groupBy(sql5`source`).all();
+    const aiSourceCurrent = app.db.select({ source: gaAiReferrals.source, sessions: sql5`COALESCE(SUM(${gaAiReferrals.sessions}), 0)` }).from(gaAiReferrals).where(and8(
+      eq19(gaAiReferrals.projectId, project.id),
+      sql5`${gaAiReferrals.date} >= ${daysAgo2(7)}`,
+      sql5`${gaAiReferrals.date} < ${todayStr}`,
+      eq19(gaAiReferrals.sourceDimension, "session")
+    )).groupBy(gaAiReferrals.source).all();
+    const aiSourcePrev = app.db.select({ source: gaAiReferrals.source, sessions: sql5`COALESCE(SUM(${gaAiReferrals.sessions}), 0)` }).from(gaAiReferrals).where(and8(
+      eq19(gaAiReferrals.projectId, project.id),
+      sql5`${gaAiReferrals.date} >= ${daysAgo2(14)}`,
+      sql5`${gaAiReferrals.date} < ${daysAgo2(7)}`,
+      eq19(gaAiReferrals.sourceDimension, "session")
+    )).groupBy(gaAiReferrals.source).all();
     const findBiggestMover = (current, prev) => {
       const prevMap = new Map(prev.map((r) => [r.source, r.sessions]));
       let mover = null;
@@ -9061,6 +9136,7 @@ async function ga4Routes(app, opts) {
       organic: buildTrend(sumOrganic),
       ai: buildTrend(sumAi),
       social: buildTrend(sumSocial),
+      direct: buildTrend(sumDirect),
       aiBiggestMover: findBiggestMover(aiSourceCurrent, aiSourcePrev),
       socialBiggestMover: findBiggestMover(socialSourceCurrent, socialSourcePrev)
     };
@@ -16670,8 +16746,138 @@ function buildSkillDocTools() {
   ];
 }
 
-// src/agent/tools.ts
+// src/agent/mcp-to-agent-tool.ts
 import { Type as Type2 } from "@sinclair/typebox";
+var MAX_TOOL_RESULT_CHARS = 2e4;
+function truncate(json) {
+  if (json.length <= MAX_TOOL_RESULT_CHARS) return json;
+  return json.slice(0, MAX_TOOL_RESULT_CHARS) + "\n... (truncated \u2014 result too large)";
+}
+function textResult2(details) {
+  return {
+    content: [{ type: "text", text: truncate(JSON.stringify(details, null, 2)) }],
+    details
+  };
+}
+function stripProjectFromJsonSchema(jsonSchema) {
+  if (!jsonSchema || typeof jsonSchema !== "object") {
+    return { schema: jsonSchema, hadProject: false };
+  }
+  const obj = jsonSchema;
+  const properties = obj.properties;
+  if (!properties || typeof properties !== "object" || !("project" in properties)) {
+    return { schema: jsonSchema, hadProject: false };
+  }
+  const { project: _project, ...remainingProps } = properties;
+  const required = Array.isArray(obj.required) ? obj.required.filter((name) => name !== "project") : obj.required;
+  const stripped = { ...obj, properties: remainingProps };
+  if (required === void 0) {
+    delete stripped.required;
+  } else {
+    stripped.required = required;
+  }
+  return { schema: stripped, hadProject: true };
+}
+function mcpToAgentTool(tool, ctx) {
+  const { schema: visibleSchema, hadProject } = stripProjectFromJsonSchema(tool.inputJsonSchema);
+  const parameters = Type2.Unsafe(visibleSchema);
+  const execute = async (_toolCallId, params) => {
+    const handlerInput = hadProject ? { ...params, project: ctx.projectName } : params;
+    const result = await tool.handler(ctx.client, handlerInput);
+    return textResult2(result);
+  };
+  return {
+    name: tool.name,
+    label: tool.title,
+    description: tool.description,
+    parameters,
+    execute
+  };
+}
+var AERO_EXCLUDED_MCP_TOOLS = /* @__PURE__ */ new Set([
+  "canonry_agent_clear"
+]);
+function buildMcpAgentTools(registry, ctx, opts = {}) {
+  return registry.filter((tool) => !AERO_EXCLUDED_MCP_TOOLS.has(tool.name)).filter((tool) => opts.readOnly ? tool.access === "read" : true).map((tool) => mcpToAgentTool(tool, ctx));
+}
+
+// src/agent/tools.ts
+function buildReadTools(ctx) {
+  return buildMcpAgentTools(canonryMcpTools, ctx, { readOnly: true });
+}
+function buildAllTools(ctx) {
+  return buildMcpAgentTools(canonryMcpTools, ctx);
+}
+
+// src/agent/session.ts
+var builtinsRegistered = false;
+function ensureBuiltinsRegistered() {
+  if (!builtinsRegistered) {
+    registerBuiltInApiProviders();
+    validateAgentProviderRegistry();
+    builtinsRegistered = true;
+  }
+}
+function loadAeroSystemPrompt(pkgDir) {
+  const skillDir = resolveAeroSkillDir(pkgDir);
+  const skillBody = fs11.readFileSync(path13.join(skillDir, "SKILL.md"), "utf-8");
+  const soulPath = path13.join(skillDir, "soul.md");
+  if (!fs11.existsSync(soulPath)) return skillBody;
+  const soulBody = fs11.readFileSync(soulPath, "utf-8");
+  return `${soulBody.trimEnd()}
+
+---
+
+${skillBody}`;
+}
+function missingProviderMessage() {
+  const configHints = agentProvidersByPriority().join(", ");
+  const envHints = agentProvidersByPriority().map((p) => `${AGENT_PROVIDERS[p].piAiProvider.toUpperCase()}_API_KEY`).join(" / ");
+  return `No agent LLM provider configured. Add an API key for one of: ${configHints} in ~/.canonry/config.yaml, or export ${envHints}.`;
+}
+function detectAgentProvider(config) {
+  for (const provider of agentProvidersByPriority()) {
+    if (resolveApiKeyFor(provider, config)) return provider;
+  }
+  return void 0;
+}
+function resolveAeroModel(provider, modelId) {
+  ensureBuiltinsRegistered();
+  return resolveModelForProvider(provider, modelId);
+}
+function buildApiKeyResolver(config) {
+  return (piAiProvider) => resolveApiKeyFor(piAiProvider, config);
+}
+function createAeroSession(opts) {
+  const systemPrompt = opts.systemPromptOverride ?? loadAeroSystemPrompt();
+  const provider = opts.provider ?? detectAgentProvider(opts.config);
+  if (!provider) throw new Error(missingProviderMessage());
+  const model = resolveAeroModel(provider, opts.modelId);
+  const toolScope = opts.toolScope ?? "all";
+  const toolCtx = {
+    client: opts.client,
+    projectName: opts.projectName
+  };
+  const stateTools = toolScope === "read-only" ? buildReadTools(toolCtx) : buildAllTools(toolCtx);
+  const defaultTools = [...stateTools, ...buildSkillDocTools()];
+  const tools = opts.tools ?? defaultTools;
+  return new Agent({
+    initialState: {
+      systemPrompt,
+      model,
+      tools,
+      ...opts.initialMessages ? { messages: opts.initialMessages } : {}
+    },
+    streamFn: opts.streamFn,
+    getApiKey: buildApiKeyResolver(opts.config)
+  });
+}
+function resolveSessionProviderAndModel(config, opts) {
+  const provider = opts?.provider ?? detectAgentProvider(config);
+  if (!provider) throw new Error(missingProviderMessage());
+  const modelId = opts?.modelId ?? getAgentProvider(provider).defaultModel;
+  return { provider, modelId };
+}
 
 // src/agent/memory-store.ts
 import crypto26 from "crypto";
@@ -16770,556 +16976,6 @@ function writeCompactionNote(db, args) {
   return inserted;
 }
 
-// src/agent/tools.ts
-var MAX_TOOL_RESULT_CHARS = 2e4;
-function truncate(json) {
-  if (json.length <= MAX_TOOL_RESULT_CHARS) return json;
-  return json.slice(0, MAX_TOOL_RESULT_CHARS) + "\n... (truncated \u2014 result too large)";
-}
-function textResult2(details) {
-  return {
-    content: [{ type: "text", text: truncate(JSON.stringify(details, null, 2)) }],
-    details
-  };
-}
-var StatusSchema = Type2.Object({
-  runLimit: Type2.Optional(
-    Type2.Number({
-      description: "Max recent runs to include. Default 5.",
-      minimum: 1,
-      maximum: 50
-    })
-  )
-});
-function buildGetStatusTool(ctx) {
-  return {
-    name: "get_status",
-    label: "Get status",
-    description: "Current project overview with its most recent runs.",
-    parameters: StatusSchema,
-    execute: async (_toolCallId, params) => {
-      const runLimit = params.runLimit ?? 5;
-      const [project, runs2] = await Promise.all([
-        ctx.client.getProject(ctx.projectName),
-        ctx.client.listRuns(ctx.projectName, runLimit)
-      ]);
-      return textResult2({ project, runs: runs2 });
-    }
-  };
-}
-var HealthSchema = Type2.Object({});
-function buildGetHealthTool(ctx) {
-  return {
-    name: "get_health",
-    label: "Get health",
-    description: 'Latest visibility health snapshot including overall cited rate, pair counts, and per-provider breakdown. Returns `status: "no-data"` with `reason: "no-runs-yet"` and zeroed metrics for projects with no successful runs yet.',
-    parameters: HealthSchema,
-    execute: async () => {
-      const health = await ctx.client.getHealth(ctx.projectName);
-      return textResult2(health);
-    }
-  };
-}
-var TimelineSchema = Type2.Object({
-  keyword: Type2.Optional(
-    Type2.String({
-      description: "Restrict the timeline to a single keyword. Omit to return all keywords."
-    })
-  )
-});
-function buildGetTimelineTool(ctx) {
-  return {
-    name: "get_timeline",
-    label: "Get timeline",
-    description: "Per-keyword citation timeline showing how visibility evolved across runs. Use to identify regressions, emerging citations, or competitor movement.",
-    parameters: TimelineSchema,
-    execute: async (_toolCallId, params) => {
-      const timeline = await ctx.client.getTimeline(ctx.projectName);
-      const filtered = params.keyword ? timeline.filter((row) => row.keyword === params.keyword) : timeline;
-      return textResult2(filtered);
-    }
-  };
-}
-var InsightsSchema = Type2.Object({
-  includeDismissed: Type2.Optional(
-    Type2.Boolean({
-      description: "Include dismissed insights. Default false (only active insights)."
-    })
-  ),
-  runId: Type2.Optional(
-    Type2.String({
-      description: "Restrict insights to a specific run id. Omit for all runs."
-    })
-  )
-});
-function buildGetInsightsTool(ctx) {
-  return {
-    name: "get_insights",
-    label: "Get insights",
-    description: "Insights produced by the canonry intelligence engine \u2014 regressions, gains, and opportunities with cause/recommendation metadata. Query this before re-deriving conclusions from raw timeline data.",
-    parameters: InsightsSchema,
-    execute: async (_toolCallId, params) => {
-      const insights2 = await ctx.client.getInsights(ctx.projectName, {
-        dismissed: params.includeDismissed,
-        runId: params.runId
-      });
-      return textResult2(insights2);
-    }
-  };
-}
-var KeywordsSchema = Type2.Object({});
-function buildListKeywordsTool(ctx) {
-  return {
-    name: "list_keywords",
-    label: "List keywords",
-    description: "All keywords currently tracked for this project.",
-    parameters: KeywordsSchema,
-    execute: async () => {
-      const keywords2 = await ctx.client.listKeywords(ctx.projectName);
-      return textResult2(keywords2);
-    }
-  };
-}
-var CompetitorsSchema = Type2.Object({});
-function buildListCompetitorsTool(ctx) {
-  return {
-    name: "list_competitors",
-    label: "List competitors",
-    description: "Competitor domains tracked alongside this project for side-by-side comparison.",
-    parameters: CompetitorsSchema,
-    execute: async () => {
-      const competitors2 = await ctx.client.listCompetitors(ctx.projectName);
-      return textResult2(competitors2);
-    }
-  };
-}
-var ContentTargetsSchema = Type2.Object({
-  limit: Type2.Optional(
-    Type2.Number({
-      description: "Max rows. Defaults to all. Use a small number (3\u201310) when summarizing for the user."
-    })
-  ),
-  includeInProgress: Type2.Optional(
-    Type2.Boolean({
-      description: "Include rows that already have an in-flight tracked action. Default false."
-    })
-  )
-});
-function buildGetContentTargetsTool(ctx) {
-  return {
-    name: "get_content_targets",
-    label: "Get content targets",
-    description: "Ranked, action-typed content opportunities. Each row is `{query, action \u2208 create|expand|refresh|add-schema, ourBestPage?, winningCompetitor?, score, scoreBreakdown, drivers[], demandSource, actionConfidence}`. Use this to recommend which post the user should write/refresh next.",
-    parameters: ContentTargetsSchema,
-    execute: async (_toolCallId, params) => {
-      const response = await ctx.client.getContentTargets(ctx.projectName, {
-        limit: params.limit,
-        includeInProgress: params.includeInProgress === true
-      });
-      return textResult2(response);
-    }
-  };
-}
-var ContentSourcesSchema = Type2.Object({});
-function buildGetContentSourcesTool(ctx) {
-  return {
-    name: "get_grounding_sources",
-    label: "Get grounding sources",
-    description: "URL-level competitive grounding-source map. Per query, lists every URL the LLM cited (our domain vs competitors), with citation count and providers. Read this to understand what specific competitor URL is winning a query.",
-    parameters: ContentSourcesSchema,
-    execute: async () => {
-      const response = await ctx.client.getContentSources(ctx.projectName);
-      return textResult2(response);
-    }
-  };
-}
-var ContentGapsSchema = Type2.Object({});
-function buildGetContentGapsTool(ctx) {
-  return {
-    name: "get_content_gaps",
-    label: "Get content gaps",
-    description: 'Queries where competitors are cited but our domain is not. Ranked by miss rate. The blunt-instrument view of "what competitors are winning that we are not." Use `get_content_targets` for action-typed recommendations on the same data.',
-    parameters: ContentGapsSchema,
-    execute: async () => {
-      const response = await ctx.client.getContentGaps(ctx.projectName);
-      return textResult2(response);
-    }
-  };
-}
-var RunDetailSchema = Type2.Object({
-  runId: Type2.String({
-    description: "Run id (UUID) to fetch. Typically obtained from get_status runs[].id."
-  })
-});
-function buildGetRunTool(ctx) {
-  return {
-    name: "get_run",
-    label: "Get run detail",
-    description: "Full detail for a specific run including per-keyword snapshots, error messages, and provider breakdown. Use to investigate failed runs or drill into a particular sweep.",
-    parameters: RunDetailSchema,
-    execute: async (_toolCallId, params) => {
-      const run = await ctx.client.getRun(params.runId);
-      return textResult2(run);
-    }
-  };
-}
-var BacklinksSchema = Type2.Object({
-  limit: Type2.Optional(
-    Type2.Number({
-      description: "Max linking-domain rows to include. Default 50, max 200.",
-      minimum: 1,
-      maximum: 200
-    })
-  ),
-  release: Type2.Optional(
-    Type2.String({
-      description: "Common Crawl release id (e.g., cc-main-2026-jan-feb-mar). Omit for the most recent release with data."
-    })
-  )
-});
-function buildListBacklinksTool(ctx) {
-  return {
-    name: "list_backlinks",
-    label: "List backlinks",
-    description: "Backlink summary and top linking domains from the most recent ready Common Crawl release. Off-site authority signal that correlates with citation likelihood. Returns null summary when no release sync has completed for this workspace.",
-    parameters: BacklinksSchema,
-    execute: async (_toolCallId, params) => {
-      const response = await ctx.client.backlinksDomains(ctx.projectName, {
-        limit: params.limit ?? 50,
-        release: params.release
-      });
-      return textResult2(response);
-    }
-  };
-}
-var RecallSchema = Type2.Object({
-  limit: Type2.Optional(
-    Type2.Number({
-      description: "Max notes to return, ordered newest-first. Default 50. Max 100.",
-      minimum: 1,
-      maximum: 100
-    })
-  )
-});
-function buildRecallTool(ctx) {
-  return {
-    name: "recall",
-    label: "Recall memory",
-    description: "Read project-scoped durable notes Aero has stored via `remember` (plus compaction summaries). Returns entries newest-first. The N most-recent entries are also injected into the system prompt at session start, so you usually do not need to call this \u2014 reach for it when you need older context or the full note value.",
-    parameters: RecallSchema,
-    execute: async (_toolCallId, params) => {
-      const entries = listMemoryEntries(ctx.db, ctx.projectId, { limit: params.limit ?? 50 });
-      return textResult2({ entries });
-    }
-  };
-}
-function buildReadTools(ctx) {
-  return [
-    buildGetStatusTool(ctx),
-    buildGetHealthTool(ctx),
-    buildGetTimelineTool(ctx),
-    buildGetInsightsTool(ctx),
-    buildListKeywordsTool(ctx),
-    buildListCompetitorsTool(ctx),
-    buildGetRunTool(ctx),
-    buildRecallTool(ctx),
-    buildListBacklinksTool(ctx),
-    buildGetContentTargetsTool(ctx),
-    buildGetContentSourcesTool(ctx),
-    buildGetContentGapsTool(ctx)
-  ];
-}
-var RunSweepSchema = Type2.Object({
-  providers: Type2.Optional(
-    Type2.Array(Type2.String(), {
-      description: "Subset of providers to run. Omit to use every configured provider on the project."
-    })
-  ),
-  noLocation: Type2.Optional(
-    Type2.Boolean({
-      description: "Run without a location context. Default: use the project default location."
-    })
-  )
-});
-function buildRunSweepTool(ctx) {
-  return {
-    name: "run_sweep",
-    label: "Trigger sweep",
-    description: "Trigger a new answer-visibility sweep for this project across configured AI providers. Returns the run id(s). Use when fresh citation data is needed.",
-    parameters: RunSweepSchema,
-    execute: async (_toolCallId, params) => {
-      const body = {};
-      if (params.providers?.length) body.providers = params.providers;
-      if (params.noLocation) body.noLocation = true;
-      const result = await ctx.client.triggerRun(ctx.projectName, body);
-      return textResult2(result);
-    }
-  };
-}
-var DismissInsightSchema = Type2.Object({
-  insightId: Type2.String({
-    description: "Insight id to dismiss. Obtain from get_insights details[].id."
-  })
-});
-function buildDismissInsightTool(ctx) {
-  return {
-    name: "dismiss_insight",
-    label: "Dismiss insight",
-    description: "Mark an insight as dismissed so it no longer surfaces in active insight lists. Reversible via the dashboard.",
-    parameters: DismissInsightSchema,
-    execute: async (_toolCallId, params) => {
-      const result = await ctx.client.dismissInsight(ctx.projectName, params.insightId);
-      return textResult2(result);
-    }
-  };
-}
-var AddKeywordsSchema = Type2.Object({
-  keywords: Type2.Array(Type2.String(), {
-    minItems: 1,
-    description: "Keywords to add to the tracking list. Duplicates against existing keywords are ignored server-side."
-  })
-});
-function buildAddKeywordsTool(ctx) {
-  return {
-    name: "add_keywords",
-    label: "Add keywords",
-    description: "Append keywords to the project tracking list. Additive only \u2014 existing keywords are preserved. Use exact phrasing you want tracked.",
-    parameters: AddKeywordsSchema,
-    execute: async (_toolCallId, params) => {
-      await ctx.client.appendKeywords(ctx.projectName, params.keywords);
-      return textResult2({ added: params.keywords });
-    }
-  };
-}
-var AddCompetitorsSchema = Type2.Object({
-  domains: Type2.Array(Type2.String(), {
-    minItems: 1,
-    description: 'Competitor domains to track. Provide bare domains (e.g. "example.com"), not URLs.'
-  })
-});
-function buildAddCompetitorsTool(ctx) {
-  return {
-    name: "add_competitors",
-    label: "Add competitors",
-    description: "Append competitor domains to the project. Existing competitors are skipped by the API.",
-    parameters: AddCompetitorsSchema,
-    execute: async (_toolCallId, params) => {
-      const existing = await ctx.client.listCompetitors(ctx.projectName);
-      const existingDomains = new Set(existing.map((c) => c.domain));
-      const newDomains = params.domains.filter((d) => !existingDomains.has(d));
-      if (newDomains.length === 0) {
-        return textResult2({ added: [], alreadyTracked: params.domains });
-      }
-      await ctx.client.appendCompetitors(ctx.projectName, newDomains);
-      return textResult2({ added: newDomains, alreadyTracked: params.domains.filter((d) => existingDomains.has(d)) });
-    }
-  };
-}
-var UpdateScheduleSchema = Type2.Object({
-  cron: Type2.Optional(
-    Type2.String({ description: 'Cron expression (e.g. "0 */6 * * *"). Provide cron OR preset, not both.' })
-  ),
-  preset: Type2.Optional(
-    Type2.String({ description: 'Preset keyword (e.g. "daily", "hourly"). Provide cron OR preset, not both.' })
-  ),
-  timezone: Type2.Optional(Type2.String({ description: 'IANA timezone. Default: "UTC".' })),
-  enabled: Type2.Optional(
-    Type2.Boolean({ description: "Whether the schedule is active. Default: true." })
-  ),
-  providers: Type2.Optional(
-    Type2.Array(Type2.String(), {
-      description: "Providers to run on each scheduled sweep. Omit to use all configured providers."
-    })
-  )
-});
-function buildUpdateScheduleTool(ctx) {
-  return {
-    name: "update_schedule",
-    label: "Update schedule",
-    description: "Create or update the recurring sweep schedule for this project. Provide exactly one of `cron` (expression) or `preset` (keyword). Fully replaces any existing schedule.",
-    parameters: UpdateScheduleSchema,
-    execute: async (_toolCallId, params) => {
-      if (params.cron && params.preset || !params.cron && !params.preset) {
-        throw new Error("update_schedule: provide exactly one of `cron` or `preset`");
-      }
-      const body = {};
-      if (params.cron) body.cron = params.cron;
-      if (params.preset) body.preset = params.preset;
-      if (params.timezone) body.timezone = params.timezone;
-      if (params.enabled !== void 0) body.enabled = params.enabled;
-      if (params.providers?.length) body.providers = params.providers;
-      const result = await ctx.client.putSchedule(ctx.projectName, body);
-      return textResult2(result);
-    }
-  };
-}
-var AttachAgentWebhookSchema = Type2.Object({
-  url: Type2.String({
-    description: "External agent webhook URL. Canonry will POST run.completed, insight.critical, insight.high, and citation.gained events to it."
-  })
-});
-function buildAttachAgentWebhookTool(ctx) {
-  return {
-    name: "attach_agent_webhook",
-    label: "Attach agent webhook",
-    description: "Register an external agent webhook for this project. Use when wiring a Claude Code / Codex / custom agent to receive canonry run and insight events. Idempotent \u2014 skips if one already exists.",
-    parameters: AttachAgentWebhookSchema,
-    execute: async (_toolCallId, params) => {
-      const existing = await ctx.client.listNotifications(ctx.projectName);
-      const hasAgent = existing.some((n) => n.source === "agent");
-      if (hasAgent) {
-        return textResult2({ status: "already-attached" });
-      }
-      const result = await ctx.client.createNotification(ctx.projectName, {
-        channel: "webhook",
-        url: params.url,
-        events: ["run.completed", "insight.critical", "insight.high", "citation.gained"],
-        source: "agent"
-      });
-      return textResult2({ status: "attached", notificationId: result.id, url: params.url });
-    }
-  };
-}
-var RememberSchema = Type2.Object({
-  key: Type2.String({
-    description: `Stable identifier for this note (max ${AGENT_MEMORY_KEY_MAX_LENGTH} chars). Writing the same key overwrites the prior value. Do NOT use the "${COMPACTION_KEY_PREFIX}" prefix \u2014 that namespace is reserved for transcript compaction summaries.`,
-    minLength: 1,
-    maxLength: AGENT_MEMORY_KEY_MAX_LENGTH
-  }),
-  value: Type2.String({
-    description: `Plain-text note to persist (max ${AGENT_MEMORY_VALUE_MAX_BYTES} bytes). Use for durable operator preferences, migration context, or non-obvious reasoning you'll want on a future turn. Do NOT duplicate data canonry already tracks (runs, insights, timelines) \u2014 query those instead.`,
-    minLength: 1
-  })
-});
-function buildRememberTool(ctx) {
-  return {
-    name: "remember",
-    label: "Remember",
-    description: "Persist a project-scoped durable note visible to every future Aero session for this project. Upsert \u2014 writing the same key replaces the prior value. Capped at 2 KB per note.",
-    parameters: RememberSchema,
-    execute: async (_toolCallId, params) => {
-      const entry = upsertMemoryEntry(ctx.db, {
-        projectId: ctx.projectId,
-        key: params.key,
-        value: params.value,
-        source: MemorySources.aero
-      });
-      return textResult2({ status: "remembered", entry });
-    }
-  };
-}
-var ForgetSchema = Type2.Object({
-  key: Type2.String({
-    description: "Exact key of the note to remove. No-op (status=missing) when no note exists for that key.",
-    minLength: 1,
-    maxLength: AGENT_MEMORY_KEY_MAX_LENGTH
-  })
-});
-function buildForgetTool(ctx) {
-  return {
-    name: "forget",
-    label: "Forget",
-    description: "Delete a durable note by key. Use when a previously-remembered fact is wrong or no longer relevant.",
-    parameters: ForgetSchema,
-    execute: async (_toolCallId, params) => {
-      if (params.key.startsWith(COMPACTION_KEY_PREFIX)) {
-        throw new Error(
-          `cannot forget compaction notes directly \u2014 they are pruned automatically (key prefix "${COMPACTION_KEY_PREFIX}" is reserved)`
-        );
-      }
-      const removed = deleteMemoryEntry(ctx.db, ctx.projectId, params.key);
-      return textResult2({ status: removed ? "forgotten" : "missing", key: params.key });
-    }
-  };
-}
-function buildWriteTools(ctx) {
-  return [
-    buildRunSweepTool(ctx),
-    buildDismissInsightTool(ctx),
-    buildAddKeywordsTool(ctx),
-    buildAddCompetitorsTool(ctx),
-    buildUpdateScheduleTool(ctx),
-    buildAttachAgentWebhookTool(ctx),
-    buildRememberTool(ctx),
-    buildForgetTool(ctx)
-  ];
-}
-function buildAllTools(ctx) {
-  return [...buildReadTools(ctx), ...buildWriteTools(ctx)];
-}
-
-// src/agent/session.ts
-var builtinsRegistered = false;
-function ensureBuiltinsRegistered() {
-  if (!builtinsRegistered) {
-    registerBuiltInApiProviders();
-    validateAgentProviderRegistry();
-    builtinsRegistered = true;
-  }
-}
-function loadAeroSystemPrompt(pkgDir) {
-  const skillDir = resolveAeroSkillDir(pkgDir);
-  const skillBody = fs11.readFileSync(path13.join(skillDir, "SKILL.md"), "utf-8");
-  const soulPath = path13.join(skillDir, "soul.md");
-  if (!fs11.existsSync(soulPath)) return skillBody;
-  const soulBody = fs11.readFileSync(soulPath, "utf-8");
-  return `${soulBody.trimEnd()}
-
----
-
-${skillBody}`;
-}
-function missingProviderMessage() {
-  const configHints = agentProvidersByPriority().join(", ");
-  const envHints = agentProvidersByPriority().map((p) => `${AGENT_PROVIDERS[p].piAiProvider.toUpperCase()}_API_KEY`).join(" / ");
-  return `No agent LLM provider configured. Add an API key for one of: ${configHints} in ~/.canonry/config.yaml, or export ${envHints}.`;
-}
-function detectAgentProvider(config) {
-  for (const provider of agentProvidersByPriority()) {
-    if (resolveApiKeyFor(provider, config)) return provider;
-  }
-  return void 0;
-}
-function resolveAeroModel(provider, modelId) {
-  ensureBuiltinsRegistered();
-  return resolveModelForProvider(provider, modelId);
-}
-function buildApiKeyResolver(config) {
-  return (piAiProvider) => resolveApiKeyFor(piAiProvider, config);
-}
-function createAeroSession(opts) {
-  const systemPrompt = opts.systemPromptOverride ?? loadAeroSystemPrompt();
-  const provider = opts.provider ?? detectAgentProvider(opts.config);
-  if (!provider) throw new Error(missingProviderMessage());
-  const model = resolveAeroModel(provider, opts.modelId);
-  const toolScope = opts.toolScope ?? "all";
-  const toolCtx = {
-    client: opts.client,
-    projectName: opts.projectName,
-    db: opts.db,
-    projectId: opts.projectId
-  };
-  const stateTools = toolScope === "read-only" ? buildReadTools(toolCtx) : buildAllTools(toolCtx);
-  const defaultTools = [...stateTools, ...buildSkillDocTools()];
-  const tools = opts.tools ?? defaultTools;
-  return new Agent({
-    initialState: {
-      systemPrompt,
-      model,
-      tools,
-      ...opts.initialMessages ? { messages: opts.initialMessages } : {}
-    },
-    streamFn: opts.streamFn,
-    getApiKey: buildApiKeyResolver(opts.config)
-  });
-}
-function resolveSessionProviderAndModel(config, opts) {
-  const provider = opts?.provider ?? detectAgentProvider(config);
-  if (!provider) throw new Error(missingProviderMessage());
-  const modelId = opts?.modelId ?? getAgentProvider(provider).defaultModel;
-  return { provider, modelId };
-}
-
 // src/agent/compaction.ts
 import { complete } from "@mariozechner/pi-ai";
 
@@ -17501,8 +17157,6 @@ var SessionRegistry = class {
         projectName,
         client: this.opts.client,
         config: this.opts.config,
-        db: this.opts.db,
-        projectId,
         provider: effectiveProvider,
         modelId: effectiveModelId,
         systemPromptOverride: this.buildHydratedSystemPrompt(projectId, row.systemPrompt),
@@ -17525,8 +17179,6 @@ var SessionRegistry = class {
       projectName,
       client: this.opts.client,
       config: this.opts.config,
-      db: this.opts.db,
-      projectId,
       provider,
       modelId,
       // Hydrate on the fresh path too — a brand-new session may still see
@@ -17586,7 +17238,7 @@ var SessionRegistry = class {
 ---
 
 <memory>
-Project-scoped durable notes (newest first). Use remember/forget/recall to manage. Entries tagged [compaction] are LLM-summarized transcript slices.
+Project-scoped durable notes (newest first). Use canonry_memory_set/canonry_memory_forget/canonry_memory_list to manage. Entries tagged [compaction] are LLM-summarized transcript slices.
 
 ${lines.join("\n")}
 </memory>`;
@@ -17693,7 +17345,7 @@ ${lines.join("\n")}
     if (this.scopes.get(projectName) === wantScope) return;
     const projectId = this.projectIds.get(projectName) ?? this.resolveProjectId(projectName);
     this.projectIds.set(projectName, projectId);
-    const toolCtx = { client: this.opts.client, projectName, db: this.opts.db, projectId };
+    const toolCtx = { client: this.opts.client, projectName };
     const stateTools = wantScope === "read-only" ? buildReadTools(toolCtx) : buildAllTools(toolCtx);
     agent.state.tools = [...stateTools, ...buildSkillDocTools()];
     this.scopes.set(projectName, wantScope);
@@ -18964,7 +18616,7 @@ async function createServer(opts) {
       if (!project) return;
       sessionRegistry.queueFollowUp(project.name, {
         role: "user",
-        content: `[system] Run ${runId} completed for project ${project.name}. ${insightCount} insights generated (${criticalOrHigh} critical/high). Use get_run to inspect the run and get_insights to review new findings. Surface anything notable briefly \u2014 skip chit-chat.`,
+        content: `[system] Run ${runId} completed for project ${project.name}. ${insightCount} insights generated (${criticalOrHigh} critical/high). Use canonry_run_get to inspect the run and canonry_insights_list to review new findings. Surface anything notable briefly \u2014 skip chit-chat.`,
         timestamp: Date.now()
       });
       void sessionRegistry.drainNow(project.name);