@ainyc/canonry 1.48.4 → 2.2.1

package/dist/cli.js

@@ -1,53 +1,41 @@
 #!/usr/bin/env node --import tsx
 import {
-  AGENT_WEBHOOK_EVENTS,
-  AgentManager,
   CliError,
   EXIT_SYSTEM_ERROR,
-  EXIT_USER_ERROR,
   ProviderNames,
   RunKinds,
-  attachAgentWebhookDirect,
-  buildAgentWebhookUrl,
+  coerceAgentProvider,
   computeCompetitorOverlap,
   configExists,
-  configureOpenClawGateway,
+  createApiClient,
   createServer,
-  detectOpenClaw,
   determineAnswerMentioned,
   determineCitationState,
   effectiveDomains,
   extractRecommendedCompetitors,
   formatAuditFactorScore,
-  getAeroStateDir,
   getConfigDir,
   getConfigPath,
   getOrCreateAnonymousId,
-  initializeOpenClawProfile,
-  installOpenClaw,
   isFirstRun,
   isTelemetryEnabled,
+  listAgentProviders,
   loadConfig,
   notificationEventSchema,
   printCliError,
-  providerEnvVar,
   providerQuotaPolicySchema,
   reparseStoredResult,
   reparseStoredResult2,
   reparseStoredResult3,
   reparseStoredResult4,
-  resolveAgentCredentials,
   resolveProviderInput,
   saveConfig,
   saveConfigPatch,
-  seedWorkspace,
   setGoogleAuthConfig,
-  setOpenClawModel,
   showFirstRunNotice,
   trackEvent,
-  usageError,
-  writeAgentEnv
-} from "./chunk-IPOVH342.js";
+  usageError
+} from "./chunk-2QNWFP6R.js";
 import {
   apiKeys,
   competitors,
@@ -57,7 +45,7 @@ import {
   projects,
   querySnapshots,
   runs
-} from "./chunk-ZZ57GRV6.js";
+} from "./chunk-TAII35VC.js";
 
 // src/cli.ts
 import { pathToFileURL } from "url";
@@ -67,9 +55,9 @@ import { parseArgs } from "util";
 function commandId(spec) {
   return spec.path.join(".");
 }
-function matchesPath(args, path7) {
-  if (args.length < path7.length) return false;
-  return path7.every((segment, index) => args[index] === segment);
+function matchesPath(args, path6) {
+  if (args.length < path6.length) return false;
+  return path6.every((segment, index) => args[index] === segment);
 }
 function withFormatOption(options) {
   if (!options) {
@@ -304,7 +292,7 @@ async function backfillAnswerVisibilityCommand(opts) {
   console.log(`  Errors:   ${providerErrors}`);
 }
 async function backfillInsightsCommand(project, opts) {
-  const { IntelligenceService } = await import("./intelligence-service-MZ7SXEGE.js");
+  const { IntelligenceService } = await import("./intelligence-service-C5LAYDFM.js");
   const config = loadConfig();
   const db = createClient(config.database);
   migrate(db);
@@ -513,460 +501,6 @@ var BACKFILL_CLI_COMMANDS = [
   }
 ];
 
-// src/client.ts
-function createApiClient() {
-  const config = loadConfig();
-  const basePathResolved = !!config.basePath || "CANONRY_BASE_PATH" in process.env;
-  return new ApiClient(config.apiUrl, config.apiKey, { skipProbe: basePathResolved });
-}
-var ApiClient = class {
-  baseUrl;
-  originUrl;
-  apiKey;
-  probePromise = null;
-  probeSkipped;
-  constructor(baseUrl, apiKey, opts) {
-    this.originUrl = baseUrl.replace(/\/$/, "");
-    this.baseUrl = this.originUrl + "/api/v1";
-    this.apiKey = apiKey;
-    this.probeSkipped = opts?.skipProbe ?? false;
-  }
-  /**
-   * On first API call, probe /health to auto-discover basePath when the user
-   * hasn't configured one locally. This lets `canonry run` in a separate shell
-   * discover that the server is running at e.g. /canonry/ without requiring
-   * config.yaml edits or CANONRY_BASE_PATH in every shell.
-   */
-  probeBasePath() {
-    if (this.probeSkipped) return Promise.resolve();
-    if (!this.probePromise) {
-      this.probePromise = (async () => {
-        try {
-          const origin = new URL(this.originUrl).origin;
-          const res = await fetch(`${origin}/health`, {
-            signal: AbortSignal.timeout(2e3)
-          });
-          if (res.ok) {
-            const body = await res.json();
-            if (body.basePath && typeof body.basePath === "string") {
-              const normalized = "/" + body.basePath.replace(/^\/|\/$/g, "");
-              if (normalized !== "/") {
-                this.originUrl = origin + normalized;
-                this.baseUrl = this.originUrl + "/api/v1";
-              }
-            }
-          }
-        } catch {
-        }
-      })();
-    }
-    return this.probePromise;
-  }
-  async request(method, path7, body) {
-    await this.probeBasePath();
-    const url = `${this.baseUrl}${path7}`;
-    const serializedBody = body != null ? JSON.stringify(body) : void 0;
-    const headers = {
-      "Authorization": `Bearer ${this.apiKey}`,
-      "Accept": "application/json",
-      ...serializedBody != null ? { "Content-Type": "application/json" } : {}
-    };
-    let res;
-    try {
-      res = await fetch(url, {
-        method,
-        headers,
-        body: serializedBody
-      });
-    } catch (err) {
-      if (err instanceof CliError) throw err;
-      const msg = err instanceof Error ? err.message : String(err);
-      if (msg.includes("fetch failed") || msg.includes("ECONNREFUSED") || msg.includes("connect ECONNREFUSED")) {
-        throw new CliError({
-          code: "CONNECTION_ERROR",
-          message: `Could not connect to canonry server at ${this.baseUrl.replace("/api/v1", "")}. Start it with "canonry serve" (or "canonry serve &" to run in background).`,
-          exitCode: EXIT_SYSTEM_ERROR
-        });
-      }
-      throw new CliError({ code: "CONNECTION_ERROR", message: msg, exitCode: EXIT_SYSTEM_ERROR });
-    }
-    if (!res.ok) {
-      let errorBody;
-      try {
-        errorBody = await res.json();
-      } catch {
-        errorBody = { error: { code: "UNKNOWN", message: res.statusText } };
-      }
-      const errorObj = errorBody && typeof errorBody === "object" && "error" in errorBody && errorBody.error && typeof errorBody.error === "object" ? errorBody.error : null;
-      const msg = errorObj?.message ? String(errorObj.message) : `HTTP ${res.status}: ${res.statusText}`;
-      const code = errorObj?.code ? String(errorObj.code) : "API_ERROR";
-      const exitCode = res.status >= 500 ? EXIT_SYSTEM_ERROR : EXIT_USER_ERROR;
-      throw new CliError({ code, message: msg, exitCode });
-    }
-    if (res.status === 204) {
-      return void 0;
-    }
-    return await res.json();
-  }
-  async putProject(name, body) {
-    return this.request("PUT", `/projects/${encodeURIComponent(name)}`, body);
-  }
-  async listProjects() {
-    return this.request("GET", "/projects");
-  }
-  async getProject(name) {
-    return this.request("GET", `/projects/${encodeURIComponent(name)}`);
-  }
-  async deleteProject(name) {
-    await this.request("DELETE", `/projects/${encodeURIComponent(name)}`);
-  }
-  async putKeywords(project, keywords) {
-    await this.request("PUT", `/projects/${encodeURIComponent(project)}/keywords`, { keywords });
-  }
-  async listKeywords(project) {
-    return this.request("GET", `/projects/${encodeURIComponent(project)}/keywords`);
-  }
-  async deleteKeywords(project, keywords) {
-    await this.request("DELETE", `/projects/${encodeURIComponent(project)}/keywords`, { keywords });
-  }
-  async appendKeywords(project, keywords) {
-    await this.request("POST", `/projects/${encodeURIComponent(project)}/keywords`, { keywords });
-  }
-  async putCompetitors(project, competitors2) {
-    await this.request("PUT", `/projects/${encodeURIComponent(project)}/competitors`, { competitors: competitors2 });
-  }
-  async listCompetitors(project) {
-    return this.request("GET", `/projects/${encodeURIComponent(project)}/competitors`);
-  }
-  async triggerRun(project, body) {
-    return this.request("POST", `/projects/${encodeURIComponent(project)}/runs`, body ?? {});
-  }
-  async listRuns(project, limit) {
-    const query = limit != null ? `?limit=${encodeURIComponent(String(limit))}` : "";
-    return this.request("GET", `/projects/${encodeURIComponent(project)}/runs${query}`);
-  }
-  async getRun(id) {
-    return this.request("GET", `/runs/${encodeURIComponent(id)}`);
-  }
-  async cancelRun(id) {
-    return this.request("POST", `/runs/${encodeURIComponent(id)}/cancel`);
-  }
-  async getTimeline(project) {
-    return this.request("GET", `/projects/${encodeURIComponent(project)}/timeline`);
-  }
-  async getHistory(project) {
-    return this.request("GET", `/projects/${encodeURIComponent(project)}/history`);
-  }
-  async getExport(project) {
-    return this.request("GET", `/projects/${encodeURIComponent(project)}/export`);
-  }
-  async apply(config) {
-    return this.request("POST", "/apply", config);
-  }
-  async getStatus(project) {
-    return this.request("GET", `/projects/${encodeURIComponent(project)}`);
-  }
-  async getSettings() {
-    return this.request("GET", "/settings");
-  }
-  async createSnapshot(body) {
-    return this.request("POST", "/snapshot", body);
-  }
-  async updateProvider(name, body) {
-    return this.request("PUT", `/settings/providers/${encodeURIComponent(name)}`, body);
-  }
-  async putSchedule(project, body) {
-    return this.request("PUT", `/projects/${encodeURIComponent(project)}/schedule`, body);
-  }
-  async getSchedule(project) {
-    return this.request("GET", `/projects/${encodeURIComponent(project)}/schedule`);
-  }
-  async deleteSchedule(project) {
-    await this.request("DELETE", `/projects/${encodeURIComponent(project)}/schedule`);
-  }
-  async createNotification(project, body) {
-    return this.request("POST", `/projects/${encodeURIComponent(project)}/notifications`, body);
-  }
-  async listNotifications(project) {
-    return this.request("GET", `/projects/${encodeURIComponent(project)}/notifications`);
-  }
-  async deleteNotification(project, id) {
-    await this.request("DELETE", `/projects/${encodeURIComponent(project)}/notifications/${encodeURIComponent(id)}`);
-  }
-  async testNotification(project, id) {
-    return this.request("POST", `/projects/${encodeURIComponent(project)}/notifications/${encodeURIComponent(id)}/test`);
-  }
-  async addLocation(project, body) {
-    return this.request("POST", `/projects/${encodeURIComponent(project)}/locations`, body);
-  }
-  async listLocations(project) {
-    return this.request("GET", `/projects/${encodeURIComponent(project)}/locations`);
-  }
-  async removeLocation(project, label) {
-    await this.request("DELETE", `/projects/${encodeURIComponent(project)}/locations/${encodeURIComponent(label)}`);
-  }
-  async setDefaultLocation(project, label) {
-    return this.request("PUT", `/projects/${encodeURIComponent(project)}/locations/default`, { label });
-  }
-  async getTelemetry() {
-    return this.request("GET", "/telemetry");
-  }
-  async updateTelemetry(enabled) {
-    return this.request("PUT", "/telemetry", { enabled });
-  }
-  async generateKeywords(project, provider, count) {
-    return this.request(
-      "POST",
-      `/projects/${encodeURIComponent(project)}/keywords/generate`,
-      { provider, count }
-    );
-  }
-  // Google connection management
-  async googleConnect(project, body) {
-    return this.request("POST", `/projects/${encodeURIComponent(project)}/google/connect`, body);
-  }
-  async googleConnections(project) {
-    return this.request("GET", `/projects/${encodeURIComponent(project)}/google/connections`);
-  }
-  async googleDisconnect(project, type) {
-    await this.request("DELETE", `/projects/${encodeURIComponent(project)}/google/connections/${encodeURIComponent(type)}`);
-  }
-  async googleProperties(project) {
-    return this.request("GET", `/projects/${encodeURIComponent(project)}/google/properties`);
-  }
-  async googleSetProperty(project, type, propertyId) {
-    return this.request("PUT", `/projects/${encodeURIComponent(project)}/google/connections/${encodeURIComponent(type)}/property`, { propertyId });
-  }
-  async googleSetSitemap(project, type, sitemapUrl) {
-    return this.request("PUT", `/projects/${encodeURIComponent(project)}/google/connections/${encodeURIComponent(type)}/sitemap`, { sitemapUrl });
-  }
-  // GSC data
-  async gscSync(project, body) {
-    return this.request("POST", `/projects/${encodeURIComponent(project)}/google/gsc/sync`, body ?? {});
-  }
-  async gscPerformance(project, params) {
-    const qs = params ? "?" + new URLSearchParams(params).toString() : "";
-    return this.request("GET", `/projects/${encodeURIComponent(project)}/google/gsc/performance${qs}`);
-  }
-  async gscInspect(project, url) {
-    return this.request("POST", `/projects/${encodeURIComponent(project)}/google/gsc/inspect`, { url });
-  }
-  async gscInspections(project, params) {
-    const qs = params ? "?" + new URLSearchParams(params).toString() : "";
-    return this.request("GET", `/projects/${encodeURIComponent(project)}/google/gsc/inspections${qs}`);
-  }
-  async gscDeindexed(project) {
-    return this.request("GET", `/projects/${encodeURIComponent(project)}/google/gsc/deindexed`);
-  }
-  async gscCoverage(project) {
-    return this.request("GET", `/projects/${encodeURIComponent(project)}/google/gsc/coverage`);
-  }
-  async gscCoverageHistory(project, params) {
-    const qs = params?.limit != null ? `?limit=${params.limit}` : "";
-    return this.request("GET", `/projects/${encodeURIComponent(project)}/google/gsc/coverage/history${qs}`);
-  }
-  async gscInspectSitemap(project, body) {
-    return this.request("POST", `/projects/${encodeURIComponent(project)}/google/gsc/inspect-sitemap`, body ?? {});
-  }
-  async gscSitemaps(project) {
-    return this.request("GET", `/projects/${encodeURIComponent(project)}/google/gsc/sitemaps`);
-  }
-  async gscDiscoverSitemaps(project) {
-    return this.request("POST", `/projects/${encodeURIComponent(project)}/google/gsc/discover-sitemaps`, {});
-  }
-  // Analytics
-  async getAnalyticsMetrics(project, window) {
-    const qs = window ? `?window=${encodeURIComponent(window)}` : "";
-    return this.request("GET", `/projects/${encodeURIComponent(project)}/analytics/metrics${qs}`);
-  }
-  async getAnalyticsGaps(project, window) {
-    const qs = window ? `?window=${encodeURIComponent(window)}` : "";
-    return this.request("GET", `/projects/${encodeURIComponent(project)}/analytics/gaps${qs}`);
-  }
-  async getAnalyticsSources(project, window) {
-    const qs = window ? `?window=${encodeURIComponent(window)}` : "";
-    return this.request("GET", `/projects/${encodeURIComponent(project)}/analytics/sources${qs}`);
-  }
-  // Google Indexing API
-  async googleRequestIndexing(project, body) {
-    return this.request("POST", `/projects/${encodeURIComponent(project)}/google/indexing/request`, body);
-  }
-  // Bing Webmaster Tools
-  async bingConnect(project, body) {
-    return this.request("POST", `/projects/${encodeURIComponent(project)}/bing/connect`, body);
-  }
-  async bingDisconnect(project) {
-    await this.request("DELETE", `/projects/${encodeURIComponent(project)}/bing/disconnect`);
-  }
-  async bingStatus(project) {
-    return this.request("GET", `/projects/${encodeURIComponent(project)}/bing/status`);
-  }
-  async bingSites(project) {
-    return this.request("GET", `/projects/${encodeURIComponent(project)}/bing/sites`);
-  }
-  async bingSetSite(project, siteUrl) {
-    return this.request("POST", `/projects/${encodeURIComponent(project)}/bing/set-site`, { siteUrl });
-  }
-  async bingCoverage(project) {
-    return this.request("GET", `/projects/${encodeURIComponent(project)}/bing/coverage`);
-  }
-  async bingCoverageHistory(project, params) {
-    const qs = params?.limit != null ? `?limit=${params.limit}` : "";
-    return this.request("GET", `/projects/${encodeURIComponent(project)}/bing/coverage/history${qs}`);
-  }
-  async bingInspections(project, params) {
-    const qs = params ? "?" + new URLSearchParams(params).toString() : "";
-    return this.request("GET", `/projects/${encodeURIComponent(project)}/bing/inspections${qs}`);
-  }
-  async bingInspectUrl(project, url) {
-    return this.request("POST", `/projects/${encodeURIComponent(project)}/bing/inspect-url`, { url });
-  }
-  async bingRequestIndexing(project, body) {
-    return this.request("POST", `/projects/${encodeURIComponent(project)}/bing/request-indexing`, body);
-  }
-  async bingPerformance(project, params) {
-    const qs = params ? "?" + new URLSearchParams(params).toString() : "";
-    return this.request("GET", `/projects/${encodeURIComponent(project)}/bing/performance${qs}`);
-  }
-  // CDP browser provider
-  async getCdpStatus() {
-    return this.request("GET", "/cdp/status");
-  }
-  async cdpScreenshot(query, targets) {
-    return this.request("POST", "/cdp/screenshot", { query, targets });
-  }
-  async getBrowserDiff(project, runId) {
-    return this.request("GET", `/projects/${encodeURIComponent(project)}/runs/${encodeURIComponent(runId)}/browser-diff`);
-  }
-  // Google Analytics 4
-  async gaConnect(project, body) {
-    return this.request("POST", `/projects/${encodeURIComponent(project)}/ga/connect`, body);
-  }
-  async gaDisconnect(project) {
-    await this.request("DELETE", `/projects/${encodeURIComponent(project)}/ga/disconnect`);
-  }
-  async gaStatus(project) {
-    return this.request("GET", `/projects/${encodeURIComponent(project)}/ga/status`);
-  }
-  async gaSync(project, body) {
-    return this.request("POST", `/projects/${encodeURIComponent(project)}/ga/sync`, body ?? {});
-  }
-  async gaTraffic(project, params) {
-    const qs = params ? "?" + new URLSearchParams(params).toString() : "";
-    return this.request("GET", `/projects/${encodeURIComponent(project)}/ga/traffic${qs}`);
-  }
-  async gaCoverage(project) {
-    return this.request("GET", `/projects/${encodeURIComponent(project)}/ga/coverage`);
-  }
-  async gaAiReferralHistory(project, params) {
-    const qs = params ? "?" + new URLSearchParams(params).toString() : "";
-    return this.request("GET", `/projects/${encodeURIComponent(project)}/ga/ai-referral-history${qs}`);
-  }
-  async gaSocialReferralHistory(project, params) {
-    const qs = params ? "?" + new URLSearchParams(params).toString() : "";
-    return this.request("GET", `/projects/${encodeURIComponent(project)}/ga/social-referral-history${qs}`);
-  }
-  async gaSocialReferralTrend(project) {
-    return this.request("GET", `/projects/${encodeURIComponent(project)}/ga/social-referral-trend`);
-  }
-  async gaAttributionTrend(project) {
-    return this.request("GET", `/projects/${encodeURIComponent(project)}/ga/attribution-trend`);
-  }
-  async gaSessionHistory(project, params) {
-    const qs = params ? "?" + new URLSearchParams(params).toString() : "";
-    return this.request("GET", `/projects/${encodeURIComponent(project)}/ga/session-history${qs}`);
-  }
-  async wordpressConnect(project, body) {
-    return this.request("POST", `/projects/${encodeURIComponent(project)}/wordpress/connect`, body);
-  }
-  async wordpressDisconnect(project) {
-    await this.request("DELETE", `/projects/${encodeURIComponent(project)}/wordpress/disconnect`);
-  }
-  async wordpressStatus(project) {
-    return this.request("GET", `/projects/${encodeURIComponent(project)}/wordpress/status`);
-  }
-  async wordpressPages(project, env) {
-    const qs = env ? `?env=${encodeURIComponent(env)}` : "";
-    return this.request("GET", `/projects/${encodeURIComponent(project)}/wordpress/pages${qs}`);
-  }
-  async wordpressPage(project, slug, env) {
-    const params = new URLSearchParams({ slug });
-    if (env) params.set("env", env);
-    return this.request("GET", `/projects/${encodeURIComponent(project)}/wordpress/page?${params.toString()}`);
-  }
-  async wordpressCreatePage(project, body) {
-    return this.request("POST", `/projects/${encodeURIComponent(project)}/wordpress/pages`, body);
-  }
-  async wordpressUpdatePage(project, body) {
-    return this.request("PUT", `/projects/${encodeURIComponent(project)}/wordpress/page`, body);
-  }
-  async wordpressSetMeta(project, body) {
-    return this.request("POST", `/projects/${encodeURIComponent(project)}/wordpress/page/meta`, body);
-  }
-  async wordpressBulkSetMeta(project, body) {
-    return this.request("POST", `/projects/${encodeURIComponent(project)}/wordpress/pages/meta/bulk`, body);
-  }
-  async wordpressSchema(project, slug, env) {
-    const params = new URLSearchParams({ slug });
-    if (env) params.set("env", env);
-    return this.request("GET", `/projects/${encodeURIComponent(project)}/wordpress/schema?${params.toString()}`);
-  }
-  async wordpressSetSchema(project, body) {
-    return this.request("POST", `/projects/${encodeURIComponent(project)}/wordpress/schema/manual`, body);
-  }
-  async wordpressSchemaDeploy(project, body) {
-    return this.request("POST", `/projects/${encodeURIComponent(project)}/wordpress/schema/deploy`, body);
-  }
-  async wordpressSchemaStatus(project, env) {
-    const params = new URLSearchParams();
-    if (env) params.set("env", env);
-    const qs = params.toString();
-    return this.request("GET", `/projects/${encodeURIComponent(project)}/wordpress/schema/status${qs ? `?${qs}` : ""}`);
-  }
-  async wordpressOnboard(project, body) {
-    return this.request("POST", `/projects/${encodeURIComponent(project)}/wordpress/onboard`, body);
-  }
-  async wordpressLlmsTxt(project, env) {
-    const qs = env ? `?env=${encodeURIComponent(env)}` : "";
-    return this.request("GET", `/projects/${encodeURIComponent(project)}/wordpress/llms-txt${qs}`);
-  }
-  async wordpressSetLlmsTxt(project, body) {
-    return this.request("POST", `/projects/${encodeURIComponent(project)}/wordpress/llms-txt/manual`, body);
-  }
-  async wordpressAudit(project, env) {
-    const qs = env ? `?env=${encodeURIComponent(env)}` : "";
-    return this.request("GET", `/projects/${encodeURIComponent(project)}/wordpress/audit${qs}`);
-  }
-  async wordpressDiff(project, slug) {
-    const params = new URLSearchParams({ slug });
-    return this.request("GET", `/projects/${encodeURIComponent(project)}/wordpress/diff?${params.toString()}`);
-  }
-  async wordpressStagingStatus(project) {
-    return this.request("GET", `/projects/${encodeURIComponent(project)}/wordpress/staging/status`);
-  }
-  async wordpressStagingPush(project) {
-    return this.request("POST", `/projects/${encodeURIComponent(project)}/wordpress/staging/push`);
-  }
-  // ── Intelligence ──────────────────────────────────────────────────────
-  async getInsights(project, opts) {
-    const params = new URLSearchParams();
-    if (opts?.dismissed) params.set("dismissed", "true");
-    if (opts?.runId) params.set("runId", opts.runId);
-    const qs = params.toString();
-    return this.request("GET", `/projects/${encodeURIComponent(project)}/insights${qs ? `?${qs}` : ""}`);
-  }
-  async dismissInsight(project, id) {
-    return this.request("POST", `/projects/${encodeURIComponent(project)}/insights/${encodeURIComponent(id)}/dismiss`);
-  }
-  async getHealth(project) {
-    return this.request("GET", `/projects/${encodeURIComponent(project)}/health/latest`);
-  }
-  async getHealthHistory(project, limit) {
-    const qs = limit ? `?limit=${limit}` : "";
-    return this.request("GET", `/projects/${encodeURIComponent(project)}/health/history${qs}`);
-  }
-};
-
 // src/commands/bing.ts
 function getClient() {
   return createApiClient();
@@ -6868,8 +6402,8 @@ async function wordpressSetMeta(project, body) {
 }
 async function wordpressBulkSetMeta(project, opts) {
   const fs8 = await import("fs/promises");
-  const path7 = await import("path");
-  const filePath = path7.resolve(opts.from);
+  const path6 = await import("path");
+  const filePath = path6.resolve(opts.from);
   let raw;
   try {
     raw = await fs8.readFile(filePath, "utf8");
@@ -6970,9 +6504,9 @@ async function wordpressSetSchema(project, body) {
 }
 async function wordpressSchemaDeploy(project, opts) {
   const fs8 = await import("fs/promises");
-  const path7 = await import("path");
+  const path6 = await import("path");
   const yaml = await import("yaml").catch(() => null);
-  const filePath = path7.resolve(opts.profile);
+  const filePath = path6.resolve(opts.profile);
   let raw;
   try {
     raw = await fs8.readFile(filePath, "utf8");
@@ -7081,9 +6615,9 @@ async function wordpressOnboard(project, opts) {
   let profileData;
   if (opts.profile) {
     const fs8 = await import("fs/promises");
-    const path7 = await import("path");
+    const path6 = await import("path");
     const yaml = await import("yaml").catch(() => null);
-    const filePath = path7.resolve(opts.profile);
+    const filePath = path6.resolve(opts.profile);
     let raw;
     try {
       raw = await fs8.readFile(filePath, "utf8");
@@ -7667,215 +7201,11 @@ var WORDPRESS_CLI_COMMANDS = [
   }
 ];
 
+// src/agent-webhook.ts
+var AGENT_WEBHOOK_EVENTS = ["run.completed", "insight.critical", "insight.high", "citation.gained"];
+
 // src/commands/agent.ts
-import path6 from "path";
-function resolveStateDir(opts) {
-  if (opts?.stateDir) return opts.stateDir;
-  try {
-    const config = loadConfig();
-    const profile = config.agent?.profile ?? "aero";
-    return getAeroStateDir(profile);
-  } catch {
-    return getAeroStateDir();
-  }
-}
-function resolveConfig() {
-  try {
-    return loadConfig().agent ?? {};
-  } catch {
-    return {};
-  }
-}
-async function agentStatus(opts) {
-  const stateDir = resolveStateDir(opts);
-  const config = resolveConfig();
-  const mgr = new AgentManager(config, stateDir);
-  const status = mgr.status();
-  if (opts?.format === "json") {
-    console.log(JSON.stringify(status, null, 2));
-    return;
-  }
-  if (status.state === "running") {
-    console.log(`Agent: running (PID ${status.pid}, port ${status.port})`);
-    if (status.startedAt) {
-      console.log(`Started: ${status.startedAt}`);
-    }
-  } else {
-    console.log("Agent: stopped");
-  }
-}
-async function agentStart(opts) {
-  const stateDir = resolveStateDir(opts);
-  const config = resolveConfig();
-  const mgr = new AgentManager(config, stateDir);
-  await mgr.start();
-  const status = mgr.status();
-  if (opts?.format === "json") {
-    console.log(JSON.stringify(status, null, 2));
-  } else {
-    console.log(`Agent started (PID ${status.pid}, port ${status.port})`);
-  }
-}
-async function agentStop(opts) {
-  const stateDir = resolveStateDir(opts);
-  const config = resolveConfig();
-  const mgr = new AgentManager(config, stateDir);
-  await mgr.stop();
-  if (opts?.format === "json") {
-    console.log(JSON.stringify({ state: "stopped" }, null, 2));
-  } else {
-    console.log("Agent stopped");
-  }
-}
-async function agentReset(opts) {
-  const stateDir = resolveStateDir(opts);
-  const config = resolveConfig();
-  const mgr = new AgentManager(config, stateDir);
-  await mgr.reset();
-  if (opts?.format === "json") {
-    console.log(JSON.stringify({ state: "reset" }, null, 2));
-  } else {
-    console.log('Agent reset \u2014 workspace wiped. Run "canonry agent setup" to re-initialize.');
-  }
-}
-async function agentSetup(opts) {
-  const isJson = opts?.format === "json";
-  let agentLLM;
-  if (!configExists()) {
-    const initOpts = {
-      geminiKey: opts?.geminiKey,
-      openaiKey: opts?.openaiKey,
-      claudeKey: opts?.claudeKey,
-      perplexityKey: opts?.perplexityKey,
-      localUrl: opts?.localUrl,
-      localModel: opts?.localModel,
-      localKey: opts?.localKey,
-      googleClientId: opts?.googleClientId,
-      googleClientSecret: opts?.googleClientSecret,
-      agentProvider: opts?.agentProvider,
-      agentKey: opts?.agentKey,
-      agentModel: opts?.agentModel
-    };
-    if (isJson) {
-      agentLLM = await suppressStdout(() => initCommand(initOpts)) ?? void 0;
-    } else {
-      agentLLM = await initCommand(initOpts) ?? void 0;
-    }
-  }
-  const existingConfig = resolveConfig();
-  let detection = await detectOpenClaw(existingConfig);
-  if (!detection.found) {
-    detection = await autoInstallOrFail(opts?.format);
-  }
-  const profile = existingConfig.profile ?? "aero";
-  const gatewayPort = opts?.gatewayPort ?? existingConfig.gatewayPort ?? 3579;
-  const stateDir = opts?.stateDir ?? getAeroStateDir(profile);
-  saveConfigPatch({
-    agent: {
-      binary: detection.path,
-      profile,
-      gatewayPort,
-      autoStart: existingConfig.autoStart
-    }
-  });
-  initializeOpenClawProfile(detection.path, profile, path6.join(stateDir, "workspace"));
-  configureOpenClawGateway(detection.path, profile, gatewayPort);
-  const creds = agentLLM ?? resolveAgentCredentials({
-    agentProvider: opts?.agentProvider,
-    agentKey: opts?.agentKey,
-    agentModel: opts?.agentModel,
-    stateDir
-  });
-  if (creds.key) {
-    writeAgentEnv(stateDir, providerEnvVar(creds.provider), creds.key);
-    if (opts?.format !== "json") {
-      console.log(`Agent LLM: ${creds.provider} credentials configured`);
-    }
-  }
-  if (creds.model) {
-    setOpenClawModel(detection.path, profile, creds.model);
-    if (opts?.format !== "json") {
-      console.log(`Agent model: ${creds.model}`);
-    }
-  }
-  seedWorkspace(stateDir);
-  const attachSummary = await attachAgentWebhookToAllProjects(gatewayPort);
-  if (opts?.format === "json") {
-    console.log(JSON.stringify({
-      state: "configured",
-      binary: detection.path,
-      version: detection.version,
-      profile,
-      gatewayPort,
-      stateDir,
-      attached: attachSummary
-    }, null, 2));
-  } else {
-    console.log(`OpenClaw: ${detection.path} (${detection.version})`);
-    console.log(`Profile: ${profile}`);
-    console.log(`Gateway port: ${gatewayPort}`);
-    console.log(`State dir: ${stateDir}`);
-    if (attachSummary.attached > 0 || attachSummary.alreadyAttached > 0) {
-      console.log(
-        `Agent webhook: ${attachSummary.attached} attached, ${attachSummary.alreadyAttached} already present (via ${attachSummary.path})`
-      );
-    }
-    console.log("Agent setup complete.");
-  }
-}
-async function attachAgentWebhookToAllProjects(gatewayPort) {
-  let config;
-  try {
-    config = loadConfig();
-  } catch {
-    return { path: "skipped", attached: 0, alreadyAttached: 0 };
-  }
-  try {
-    const client = createApiClient();
-    const projectList = await client.listProjects();
-    const agentUrl = buildAgentWebhookUrl(gatewayPort);
-    let attached2 = 0;
-    let alreadyAttached2 = 0;
-    for (const project of projectList) {
-      const existing = await client.listNotifications(project.name);
-      if (existing.some((n) => n.source === "agent")) {
-        alreadyAttached2++;
-        continue;
-      }
-      await client.createNotification(project.name, {
-        channel: "webhook",
-        url: agentUrl,
-        events: [...AGENT_WEBHOOK_EVENTS],
-        source: "agent"
-      });
-      attached2++;
-    }
-    return { path: "api", attached: attached2, alreadyAttached: alreadyAttached2 };
-  } catch (err) {
-    if (!isConnectionError(err)) throw err;
-  }
-  const db = createClient(config.database);
-  migrate(db);
-  const rows = db.select({ id: projects.id }).from(projects).all();
-  let attached = 0;
-  let alreadyAttached = 0;
-  for (const row of rows) {
-    const result = attachAgentWebhookDirect(db, row.id, gatewayPort);
-    if (result === "attached") attached++;
-    else alreadyAttached++;
-  }
-  return { path: "db", attached, alreadyAttached };
-}
-function isConnectionError(err) {
-  if (!(err instanceof Error)) return false;
-  const msg = err.message.toLowerCase();
-  const code = err.code ?? "";
-  return code === "CONNECTION_ERROR" || code === "ECONNREFUSED" || code === "ENOTFOUND" || msg.includes("could not connect") || msg.includes("econnrefused") || msg.includes("fetch failed") || msg.includes("connection refused");
-}
 async function agentAttach(opts) {
-  const config = loadConfig();
-  const gatewayPort = config.agent?.gatewayPort ?? 3579;
-  const agentUrl = buildAgentWebhookUrl(gatewayPort);
   const client = createApiClient();
   const existing = await client.listNotifications(opts.project);
   const hasAgent = existing.some((n) => n.source === "agent");
@@ -7889,14 +7219,14 @@ async function agentAttach(opts) {
   }
   const result = await client.createNotification(opts.project, {
     channel: "webhook",
-    url: agentUrl,
+    url: opts.url,
     events: [...AGENT_WEBHOOK_EVENTS],
     source: "agent"
   });
   if (opts.format === "json") {
     console.log(JSON.stringify({ status: "attached", project: opts.project, notificationId: result.id }));
   } else {
-    console.log(`Agent webhook attached to "${opts.project}"`);
+    console.log(`Agent webhook attached to "${opts.project}" (${opts.url})`);
   }
 }
 async function agentDetach(opts) {
@@ -7918,136 +7248,441 @@ async function agentDetach(opts) {
     console.log(`Agent webhook detached from "${opts.project}"`);
   }
 }
-async function autoInstallOrFail(format) {
-  if (format !== "json") {
-    console.log("OpenClaw not found, installing pinned openclaw@2026.4.14 via npm...");
+
+// src/commands/agent-ask.ts
+async function agentAsk(opts) {
+  const format = opts.format === "json" ? "json" : "text";
+  const isJson = format === "json";
+  const controller = new AbortController();
+  const onSigint = () => controller.abort();
+  process.on("SIGINT", onSigint);
+  let sawStreamError = false;
+  try {
+    const client = createApiClient();
+    const res = await client.streamPost(
+      `/projects/${encodeURIComponent(opts.project)}/agent/prompt`,
+      {
+        prompt: opts.prompt,
+        provider: opts.provider,
+        modelId: opts.modelId,
+        scope: opts.scope ?? "all"
+      },
+      controller.signal
+    );
+    if (!res.body) {
+      throw new CliError({
+        code: "API_ERROR",
+        message: "Server returned no response body",
+        exitCode: EXIT_SYSTEM_ERROR
+      });
+    }
+    for await (const event of parseSse(res.body)) {
+      renderEvent(event, isJson);
+      if (event.type === "message_end" && event.message.role === "assistant") {
+        const msg = event.message;
+        if (msg.stopReason === "error" || msg.errorMessage) sawStreamError = true;
+      } else if (event.type === "error") {
+        sawStreamError = true;
+      }
+    }
+    if (sawStreamError) process.exitCode = EXIT_SYSTEM_ERROR;
+  } catch (err) {
+    printCliError(err, format);
+    process.exitCode = err instanceof CliError ? err.exitCode : EXIT_SYSTEM_ERROR;
+  } finally {
+    process.off("SIGINT", onSigint);
+  }
+}
+async function* parseSse(stream) {
+  const reader = stream.getReader();
+  const decoder = new TextDecoder();
+  let buffer = "";
+  try {
+    while (true) {
+      const { value, done } = await reader.read();
+      if (done) break;
+      buffer += decoder.decode(value, { stream: true });
+      let boundary = buffer.indexOf("\n\n");
+      while (boundary !== -1) {
+        const frame = buffer.slice(0, boundary);
+        buffer = buffer.slice(boundary + 2);
+        for (const line of frame.split("\n")) {
+          if (!line.startsWith("data:")) continue;
+          const payload = line.slice(5).trim();
+          if (!payload) continue;
+          try {
+            yield JSON.parse(payload);
+          } catch {
+          }
+        }
+        boundary = buffer.indexOf("\n\n");
+      }
+    }
+  } finally {
+    try {
+      reader.releaseLock();
+    } catch {
+    }
+  }
+}
+function renderEvent(event, isJson) {
+  if (isJson) {
+    console.log(JSON.stringify(event));
+    return;
+  }
+  switch (event.type) {
+    case "tool_execution_start":
+      console.log(`
+\u27D0 ${event.toolName} ${JSON.stringify(event.args)}`);
+      break;
+    case "tool_execution_end":
+      console.log(`  ${event.isError ? "\u2717" : "\u2713"} ${event.toolName}`);
+      break;
+    case "message_end": {
+      const message = event.message;
+      if (message.role === "assistant") {
+        for (const block of message.content) {
+          if (block.type === "text" && block.text.trim().length > 0) {
+            console.log("\n" + block.text);
+          }
+        }
+      }
+      break;
+    }
+    case "error":
+      console.error(`Agent stream error: ${event.message}`);
+      break;
+  }
+}
+
+// src/commands/agent-providers.ts
+async function agentProviders(opts) {
+  const format = opts.format === "json" ? "json" : "text";
+  try {
+    const client = createApiClient();
+    const res = await client.listAgentProviders(opts.project);
+    if (format === "json") {
+      console.log(JSON.stringify(res, null, 2));
+      return;
+    }
+    console.log(
+      `Aero providers for ${opts.project} (default: ${res.defaultProvider ?? "none configured"})
+`
+    );
+    const idWidth = Math.max(...res.providers.map((p) => p.id.length), 8);
+    for (const p of res.providers) {
+      const status = p.configured ? "\u2713" : "\u2717";
+      const source = p.keySource ? `(${p.keySource})` : "";
+      console.log(
+        `  ${status} ${p.id.padEnd(idWidth)}  ${p.label}  \u2014 model ${p.defaultModel} ${source}`.trimEnd()
+      );
+    }
+  } catch (err) {
+    printCliError(err, format);
+    if (err instanceof CliError) process.exitCode = err.exitCode;
+    else process.exitCode = 2;
   }
-  const install = await installOpenClaw({ silent: format === "json" });
-  if (!install.success) {
-    const msg = `Failed to install OpenClaw: ${install.error}`;
+}
+
+// src/commands/agent-transcript.ts
+async function agentTranscript(opts) {
+  const format = opts.format === "json" ? "json" : "text";
+  try {
+    const client = createApiClient();
+    const transcript = await client.getAgentTranscript(opts.project);
     if (format === "json") {
-      console.error(JSON.stringify({ error: { code: "AGENT_INSTALL_FAILED", message: msg } }));
+      console.log(JSON.stringify(transcript, null, 2));
+      return;
+    }
+    if (transcript.messages.length === 0) {
+      console.log(`No Aero conversation yet for "${opts.project}".`);
+      return;
+    }
+    console.log(
+      `Aero session for ${opts.project} \u2014 ${transcript.modelProvider ?? "unknown"}/${transcript.modelId ?? "unknown"} \u2014 updated ${transcript.updatedAt ?? "never"}`
+    );
+    console.log(`${transcript.messages.length} message${transcript.messages.length === 1 ? "" : "s"}
+`);
+    for (const msg of transcript.messages) {
+      console.log(`[${msg.role}]`);
+      if (typeof msg.content === "string") {
+        console.log(msg.content);
+      } else if (Array.isArray(msg.content)) {
+        for (const block of msg.content) {
+          const t = block.type;
+          if (t === "text") console.log(block.text);
+          else if (t === "toolCall") console.log(`\u27D0 ${block.name} ${JSON.stringify(block.arguments)}`);
+          else if (t === "toolResult") console.log(`  ${block.isError ? "\u2717" : "\u2713"} tool-result`);
+        }
+      }
+      console.log();
+    }
+  } catch (err) {
+    printCliError(err, format);
+    if (err instanceof CliError) process.exitCode = err.exitCode;
+    else process.exitCode = 2;
+  }
+}
+async function agentTranscriptReset(opts) {
+  const format = opts.format === "json" ? "json" : "text";
+  try {
+    const client = createApiClient();
+    await client.resetAgentTranscript(opts.project);
+    if (format === "json") {
+      console.log(JSON.stringify({ status: "reset", project: opts.project }));
     } else {
-      console.error(msg);
+      console.log(`Aero conversation reset for "${opts.project}".`);
     }
-    process.exitCode = 1;
-    throw new Error(msg);
+  } catch (err) {
+    printCliError(err, format);
+    if (err instanceof CliError) process.exitCode = err.exitCode;
+    else process.exitCode = 2;
   }
-  if (format !== "json") {
-    console.log(`Installed OpenClaw ${install.detection.version}`);
+}
+
+// src/commands/agent-memory.ts
+function toFormat2(raw) {
+  return raw === "json" ? "json" : "text";
+}
+async function agentMemoryList(opts) {
+  const format = toFormat2(opts.format);
+  try {
+    const client = createApiClient();
+    const result = await client.listAgentMemory(opts.project);
+    if (format === "json") {
+      console.log(JSON.stringify(result, null, 2));
+      return;
+    }
+    if (result.entries.length === 0) {
+      console.log(`No Aero memory notes for "${opts.project}".`);
+      return;
+    }
+    console.log(`Aero memory for ${opts.project} \u2014 ${result.entries.length} note(s)
+`);
+    for (const entry of result.entries) {
+      console.log(`[${entry.source}] ${entry.key}  (updated ${entry.updatedAt})`);
+      console.log(`  ${entry.value.replace(/\n/g, "\n  ")}`);
+      console.log();
+    }
+  } catch (err) {
+    printCliError(err, format);
+    process.exitCode = err instanceof CliError ? err.exitCode : 2;
   }
-  return install.detection;
 }
-async function suppressStdout(fn) {
-  const original = console.log;
-  console.log = () => {
-  };
+async function agentMemorySet(opts) {
+  const format = toFormat2(opts.format);
   try {
-    return await fn();
-  } finally {
-    console.log = original;
+    const client = createApiClient();
+    const result = await client.setAgentMemory(opts.project, {
+      key: opts.key,
+      value: opts.value
+    });
+    if (format === "json") {
+      console.log(JSON.stringify(result, null, 2));
+      return;
+    }
+    console.log(`Stored note "${result.entry.key}" for "${opts.project}" (source=${result.entry.source}).`);
+  } catch (err) {
+    printCliError(err, format);
+    process.exitCode = err instanceof CliError ? err.exitCode : 2;
+  }
+}
+async function agentMemoryForget(opts) {
+  const format = toFormat2(opts.format);
+  try {
+    const client = createApiClient();
+    const result = await client.forgetAgentMemory(opts.project, opts.key);
+    if (format === "json") {
+      console.log(JSON.stringify(result, null, 2));
+      return;
+    }
+    if (result.status === "forgotten") {
+      console.log(`Forgot note "${opts.key}" for "${opts.project}".`);
+    } else {
+      console.log(`No note with key "${opts.key}" for "${opts.project}".`);
+    }
+  } catch (err) {
+    printCliError(err, format);
+    process.exitCode = err instanceof CliError ? err.exitCode : 2;
   }
 }
 
 // src/cli-commands/agent.ts
+var AGENT_ASK_SCOPES = ["all", "read-only"];
 var AGENT_CLI_COMMANDS = [
   {
-    path: ["agent", "status"],
-    usage: "canonry agent status [--format json]",
-    options: {},
+    path: ["agent", "ask"],
+    usage: `canonry agent ask <project> "<prompt>" [--provider ${listAgentProviders().join("|")}] [--model <id>] [--scope all|read-only] [--format json]`,
+    options: {
+      provider: stringOption(),
+      model: stringOption(),
+      scope: stringOption()
+    },
     run: async (input) => {
-      await agentStatus({ format: input.format });
+      const [project, ...rest] = input.positionals;
+      if (!project || rest.length === 0) {
+        console.error('Usage: canonry agent ask <project> "<prompt>"');
+        process.exitCode = 1;
+        return;
+      }
+      const providerInput = getString(input.values, "provider");
+      if (providerInput && !coerceAgentProvider(providerInput)) {
+        console.error(`--provider must be one of: ${listAgentProviders().join(", ")}`);
+        process.exitCode = 1;
+        return;
+      }
+      const scopeInput = getString(input.values, "scope");
+      if (scopeInput && !AGENT_ASK_SCOPES.includes(scopeInput)) {
+        console.error(`--scope must be one of: ${AGENT_ASK_SCOPES.join(", ")}`);
+        process.exitCode = 1;
+        return;
+      }
+      await agentAsk({
+        project,
+        prompt: rest.join(" "),
+        provider: coerceAgentProvider(providerInput),
+        modelId: getString(input.values, "model"),
+        scope: scopeInput,
+        format: input.format
+      });
     }
   },
   {
-    path: ["agent", "start"],
-    usage: "canonry agent start [--format json]",
+    path: ["agent", "providers"],
+    usage: "canonry agent providers <project> [--format json]",
     options: {},
     run: async (input) => {
-      await agentStart({ format: input.format });
+      const project = input.positionals[0];
+      if (!project) {
+        console.error("Usage: canonry agent providers <project>");
+        process.exitCode = 1;
+        return;
+      }
+      await agentProviders({ project, format: input.format });
     }
   },
   {
-    path: ["agent", "stop"],
-    usage: "canonry agent stop [--format json]",
-    options: {},
+    path: ["agent", "attach"],
+    usage: "canonry agent attach <project> --url <webhook-url> [--format json]",
+    options: {
+      url: stringOption()
+    },
     run: async (input) => {
-      await agentStop({ format: input.format });
+      const project = input.positionals[0];
+      if (!project) {
+        console.error("Usage: canonry agent attach <project> --url <webhook-url>");
+        process.exitCode = 1;
+        return;
+      }
+      const url = getString(input.values, "url");
+      if (!url) {
+        console.error("Missing required --url flag. Specify the agent webhook URL to attach.");
+        process.exitCode = 1;
+        return;
+      }
+      await agentAttach({ project, url, format: input.format });
     }
   },
   {
-    path: ["agent", "reset"],
-    usage: "canonry agent reset [--format json]",
+    path: ["agent", "detach"],
+    usage: "canonry agent detach <project> [--format json]",
     options: {},
     run: async (input) => {
-      await agentReset({ format: input.format });
+      const project = input.positionals[0];
+      if (!project) {
+        console.error("Usage: canonry agent detach <project>");
+        process.exitCode = 1;
+        return;
+      }
+      await agentDetach({ project, format: input.format });
     }
   },
   {
-    path: ["agent", "attach"],
-    usage: "canonry agent attach <project> [--format json]",
+    path: ["agent", "transcript"],
+    usage: "canonry agent transcript <project> [--format json]",
     options: {},
     run: async (input) => {
       const project = input.positionals[0];
       if (!project) {
-        console.error("Usage: canonry agent attach <project>");
+        console.error("Usage: canonry agent transcript <project>");
         process.exitCode = 1;
         return;
       }
-      await agentAttach({ project, format: input.format });
+      await agentTranscript({ project, format: input.format });
     }
   },
   {
-    path: ["agent", "detach"],
-    usage: "canonry agent detach <project> [--format json]",
+    path: ["agent", "reset"],
+    usage: "canonry agent reset <project> [--format json]",
     options: {},
     run: async (input) => {
       const project = input.positionals[0];
       if (!project) {
-        console.error("Usage: canonry agent detach <project>");
+        console.error("Usage: canonry agent reset <project>");
         process.exitCode = 1;
         return;
       }
-      await agentDetach({ project, format: input.format });
+      await agentTranscriptReset({ project, format: input.format });
+    }
+  },
+  {
+    path: ["agent", "memory", "list"],
+    usage: "canonry agent memory list <project> [--format json]",
+    options: {},
+    run: async (input) => {
+      const project = input.positionals[0];
+      if (!project) {
+        throw usageError("Usage: canonry agent memory list <project>", {
+          message: "project name is required"
+        });
+      }
+      await agentMemoryList({ project, format: input.format });
     }
   },
   {
-    path: ["agent", "setup"],
-    usage: "canonry agent setup [--agent-provider <id>] [--agent-key <key>] [--agent-model <model>] [--gateway-port <port>] [--gemini-key <key>] [--openai-key <key>] [--claude-key <key>] [--perplexity-key <key>] [--format json]",
+    path: ["agent", "memory", "set"],
+    usage: "canonry agent memory set <project> --key <k> --value <v> [--format json]",
     options: {
-      "agent-provider": stringOption(),
-      "agent-key": stringOption(),
-      "agent-model": stringOption(),
-      "gateway-port": { type: "string" },
-      "gemini-key": stringOption(),
-      "openai-key": stringOption(),
-      "claude-key": stringOption(),
-      "perplexity-key": stringOption(),
-      "local-url": stringOption(),
-      "local-model": stringOption(),
-      "local-key": stringOption(),
-      "google-client-id": stringOption(),
-      "google-client-secret": stringOption()
+      key: stringOption(),
+      value: stringOption()
     },
     run: async (input) => {
-      const portStr = input.values["gateway-port"];
-      const gatewayPort = typeof portStr === "string" ? Number.parseInt(portStr, 10) : void 0;
-      await agentSetup({
-        agentProvider: getString(input.values, "agent-provider"),
-        agentKey: getString(input.values, "agent-key"),
-        agentModel: getString(input.values, "agent-model"),
-        gatewayPort,
-        format: input.format,
-        geminiKey: getString(input.values, "gemini-key"),
-        openaiKey: getString(input.values, "openai-key"),
-        claudeKey: getString(input.values, "claude-key"),
-        perplexityKey: getString(input.values, "perplexity-key"),
-        localUrl: getString(input.values, "local-url"),
-        localModel: getString(input.values, "local-model"),
-        localKey: getString(input.values, "local-key"),
-        googleClientId: getString(input.values, "google-client-id"),
-        googleClientSecret: getString(input.values, "google-client-secret")
-      });
+      const project = input.positionals[0];
+      if (!project) {
+        throw usageError("Usage: canonry agent memory set <project> --key <k> --value <v>", {
+          message: "project name is required"
+        });
+      }
+      const key = getString(input.values, "key");
+      const value = getString(input.values, "value");
+      if (!key || !value) {
+        throw usageError("--key and --value are both required.", {
+          message: "--key and --value are both required"
+        });
+      }
+      await agentMemorySet({ project, key, value, format: input.format });
+    }
+  },
+  {
+    path: ["agent", "memory", "forget"],
+    usage: "canonry agent memory forget <project> --key <k> [--format json]",
+    options: {
+      key: stringOption()
+    },
+    run: async (input) => {
+      const project = input.positionals[0];
+      if (!project) {
+        throw usageError("Usage: canonry agent memory forget <project> --key <k>", {
+          message: "project name is required"
+        });
+      }
+      const key = getString(input.values, "key");
+      if (!key) {
+        throw usageError("--key is required.", {
+          message: "--key is required"
+        });
+      }
+      await agentMemoryForget({ project, key, format: input.format });
     }
   }
 ];