@koda-sl/baker-cli 0.15.0 → 0.18.0

package/dist/commands/research/web.js

@@ -0,0 +1,112 @@
+import { defineCommand } from "citty";
+import { apiGet, apiPost } from "../../client.js";
+import { registerSchema } from "../../schemas.js";
+import { handleResearchError, writeResearchJson } from "./output.js";
+registerSchema({
+    command: "research.web",
+    description: "Search the web with AI to answer marketing questions — competitors, ICP, pricing, pain points, market trends. Three depth levels: medium (quick, default), high (thorough), xhigh (exhaustive deep research).",
+    args: {
+        question: {
+            type: "string",
+            description: "The research question to answer using live web data",
+            required: true,
+        },
+        depth: {
+            type: "string",
+            description: "Research depth: medium (quick), high (thorough), xhigh (exhaustive). Default: medium",
+            required: false,
+            enum: ["medium", "high", "xhigh"],
+        },
+    },
+});
+const TIMEOUT_MS = {
+    medium: 180_000,
+    high: 360_000,
+    xhigh: 900_000,
+};
+const FIELDS = {
+    answer: "AI-generated research answer (markdown)",
+    sources: "Array of {title, url} sources used for grounding",
+};
+function sleep(ms) {
+    return new Promise((resolve) => setTimeout(resolve, ms));
+}
+async function runDeepResearch(question) {
+    const { interactionId } = await apiPost("/api/research/deep-research/start", { question });
+    process.stderr.write(`Deep research started (${interactionId}). Polling...\n`);
+    const deadline = Date.now() + TIMEOUT_MS.xhigh;
+    while (Date.now() < deadline) {
+        await sleep(10_000);
+        const poll = await apiGet("/api/research/deep-research/poll", {
+            id: interactionId,
+        });
+        if (poll.status === "completed" && poll.result) {
+            return poll.result;
+        }
+        if (poll.status === "failed" || poll.status === "cancelled") {
+            throw new Error(`Deep research ${poll.status}`);
+        }
+        process.stderr.write(`  status: ${poll.status}\n`);
+    }
+    throw new Error("Deep research timed out");
+}
+export const webCommand = defineCommand({
+    meta: {
+        name: "web",
+        description: `Search the web with AI to answer any open-ended marketing question. Uses live internet data via Google Search.
+
+Depth levels:
+  medium  — Quick lookup using Gemini Flash with minimal thinking (default)
+  high    — Thorough answer using Gemini Flash with deep thinking
+  xhigh   — Exhaustive deep research using Gemini Deep Research (slow, use sparingly)
+
+Examples:
+  baker research web "Who are the main competitors of HubSpot CRM?"
+  baker research web "What are the top pain points for SMB CRM buyers?" --depth high
+  baker research web "Full competitive analysis of project management SaaS" --depth xhigh`,
+    },
+    args: {
+        question: { type: "positional", description: "The research question", required: true },
+        depth: { type: "string", description: "Research depth: medium|high|xhigh (default: medium)", required: false },
+        output: { type: "string", description: "Format: json|md (default: json)", required: false, default: "json" },
+    },
+    run: async ({ args }) => {
+        const question = args.question;
+        if (question.length < 5) {
+            writeResearchJson({
+                ok: false,
+                error: { code: "VALIDATION_ERROR", message: "Question must be at least 5 characters" },
+            });
+            process.exit(1);
+        }
+        const depth = (args.depth || "medium");
+        if (!["medium", "high", "xhigh"].includes(depth)) {
+            writeResearchJson({
+                ok: false,
+                error: { code: "VALIDATION_ERROR", message: "Depth must be one of: medium, high, xhigh" },
+            });
+            process.exit(1);
+        }
+        try {
+            const data = depth === "xhigh"
+                ? await runDeepResearch(question)
+                : await apiPost("/api/research/explore", { question, depth }, { timeoutMs: TIMEOUT_MS[depth] });
+            const format = args.output || "json";
+            if (format === "md") {
+                process.stdout.write(`${data.answer}\n`);
+                if (data.sources.length > 0) {
+                    process.stdout.write("\n## Sources\n");
+                    for (const s of data.sources) {
+                        process.stdout.write(`- [${s.title}](${s.url})\n`);
+                    }
+                }
+                return;
+            }
+            writeResearchJson({ ok: true, data, fields: FIELDS });
+        }
+        catch (err) {
+            handleResearchError(err);
+        }
+    },
+});
+//# sourceMappingURL=web.js.map

package/dist/commands/research/web.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"web.js","sourceRoot":"","sources":["../../../src/commands/research/web.ts"],"names":[],"mappings":"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"}

package/dist/env.d.ts

@@ -2,6 +2,8 @@ type Env = {
     BAKER_API_KEY: string;
     BAKER_API_URL: string;
     BAKER_GOOGLE_ADS_CUSTOMER_ID?: string;
+    BAKER_GA4_PROPERTY_ID?: string;
+    BAKER_GSC_SITE_URL?: string;
 };
 export declare function getEnv(): Env;
 export {};

package/dist/env.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"env.d.ts","sourceRoot":"","sources":["../src/env.ts"],"names":[],"mappings":"AAGA,KAAK,GAAG,GAAG;IACT,aAAa,EAAE,MAAM,CAAC;IACtB,aAAa,EAAE,MAAM,CAAC;IACtB,4BAA4B,CAAC,EAAE,MAAM,CAAC;CACvC,CAAC;AAIF,wBAAgB,MAAM,IAAI,GAAG,CAe5B"}
+{"version":3,"file":"env.d.ts","sourceRoot":"","sources":["../src/env.ts"],"names":[],"mappings":"AAGA,KAAK,GAAG,GAAG;IACT,aAAa,EAAE,MAAM,CAAC;IACtB,aAAa,EAAE,MAAM,CAAC;IACtB,4BAA4B,CAAC,EAAE,MAAM,CAAC;IACtC,qBAAqB,CAAC,EAAE,MAAM,CAAC;IAC/B,kBAAkB,CAAC,EAAE,MAAM,CAAC;CAC7B,CAAC;AAIF,wBAAgB,MAAM,IAAI,GAAG,CAiB5B"}

package/dist/env.js

@@ -11,6 +11,8 @@ export function getEnv() {
                     .string()
                     .regex(/^\d{10}$/)
                     .optional(),
+                BAKER_GA4_PROPERTY_ID: z.string().optional(),
+                BAKER_GSC_SITE_URL: z.string().optional(),
             },
             runtimeEnv: process.env,
         });

package/dist/env.js.map

@@ -1 +1 @@
-{"version":3,"file":"env.js","sourceRoot":"","sources":["../src/env.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAC7C,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAQxB,IAAI,MAAuB,CAAC;AAE5B,MAAM,UAAU,MAAM;IACpB,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,MAAM,GAAG,SAAS,CAAC;YACjB,MAAM,EAAE;gBACN,aAAa,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,UAAU,CAAC,KAAK,EAAE,+BAA+B,CAAC;gBAC5E,aAAa,EAAE,CAAC,CAAC,GAAG,CAAC,mCAAmC,CAAC;gBACzD,4BAA4B,EAAE,CAAC;qBAC5B,MAAM,EAAE;qBACR,KAAK,CAAC,UAAU,CAAC;qBACjB,QAAQ,EAAE;aACd;YACD,UAAU,EAAE,OAAO,CAAC,GAAG;SACxB,CAAC,CAAC;IACL,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC"}
+{"version":3,"file":"env.js","sourceRoot":"","sources":["../src/env.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAC7C,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAUxB,IAAI,MAAuB,CAAC;AAE5B,MAAM,UAAU,MAAM;IACpB,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,MAAM,GAAG,SAAS,CAAC;YACjB,MAAM,EAAE;gBACN,aAAa,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,UAAU,CAAC,KAAK,EAAE,+BAA+B,CAAC;gBAC5E,aAAa,EAAE,CAAC,CAAC,GAAG,CAAC,mCAAmC,CAAC;gBACzD,4BAA4B,EAAE,CAAC;qBAC5B,MAAM,EAAE;qBACR,KAAK,CAAC,UAAU,CAAC;qBACjB,QAAQ,EAAE;gBACb,qBAAqB,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;gBAC5C,kBAAkB,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;aAC1C;YACD,UAAU,EAAE,OAAO,CAAC,GAAG;SACxB,CAAC,CAAC;IACL,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/error-handler.d.ts

@@ -0,0 +1,8 @@
+type ConnectionPlatform = "google_ads" | "ga4" | "gsc";
+/**
+ * Shared error handler for "No Connection" scenarios.
+ * Provides a structured error for AI agents with a suggested fix and alternative commands.
+ */
+export declare function handleConnectionError(platform: ConnectionPlatform, originalMessage?: string): never;
+export {};
+//# sourceMappingURL=error-handler.d.ts.map

package/dist/error-handler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"error-handler.d.ts","sourceRoot":"","sources":["../src/error-handler.ts"],"names":[],"mappings":"AAEA,KAAK,kBAAkB,GAAG,YAAY,GAAG,KAAK,GAAG,KAAK,CAAC;AAEvD;;;GAGG;AACH,wBAAgB,qBAAqB,CAAC,QAAQ,EAAE,kBAAkB,EAAE,eAAe,CAAC,EAAE,MAAM,GAAG,KAAK,CAkCnG"}

package/dist/error-handler.js

@@ -0,0 +1,37 @@
+import { writeJsonEnvelope } from "./commands/ads/output.js";
+/**
+ * Shared error handler for "No Connection" scenarios.
+ * Provides a structured error for AI agents with a suggested fix and alternative commands.
+ */
+export function handleConnectionError(platform, originalMessage) {
+    const platformName = {
+        google_ads: "Google Ads",
+        ga4: "Google Analytics 4",
+        gsc: "Google Search Console",
+    }[platform];
+    const alternative = {
+        google_ads: "keywords-for-site or research advertisers",
+        ga4: "lighthouse for page performance",
+        gsc: "keywords-for-site or research keyword-gap",
+    }[platform];
+    const code = {
+        google_ads: "NO_GOOGLE_ADS_CONNECTION",
+        ga4: "NO_GA4_CONNECTION",
+        gsc: "NO_GSC_CONNECTION",
+    }[platform];
+    const envelope = {
+        ok: false,
+        error: {
+            code,
+            message: originalMessage || `No ${platformName} connection found for this company.`,
+            fix: {
+                action: "authenticate",
+                explanation: `AGENT INSTRUCTION: You cannot resolve this error programmatically. The user has not connected their ${platformName} account. Step 1: Inform the user that they must connect ${platformName} in their Baker dashboard settings for direct data queries. Step 2: Do not fail the overall audit or playbook. Document the missing connection, skip this specific check, and proceed with the rest of your tasks. (Optional fallback: use 'baker research ${alternative}' for estimated external insights).`,
+            },
+            retryable: false,
+        },
+    };
+    writeJsonEnvelope(envelope);
+    process.exit(1);
+}
+//# sourceMappingURL=error-handler.js.map

package/dist/error-handler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"error-handler.js","sourceRoot":"","sources":["../src/error-handler.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAI7D;;;GAGG;AACH,MAAM,UAAU,qBAAqB,CAAC,QAA4B,EAAE,eAAwB;IAC1F,MAAM,YAAY,GAAG;QACnB,UAAU,EAAE,YAAY;QACxB,GAAG,EAAE,oBAAoB;QACzB,GAAG,EAAE,uBAAuB;KAC7B,CAAC,QAAQ,CAAC,CAAC;IAEZ,MAAM,WAAW,GAAG;QAClB,UAAU,EAAE,2CAA2C;QACvD,GAAG,EAAE,iCAAiC;QACtC,GAAG,EAAE,2CAA2C;KACjD,CAAC,QAAQ,CAAC,CAAC;IAEZ,MAAM,IAAI,GAAG;QACX,UAAU,EAAE,0BAA0B;QACtC,GAAG,EAAE,mBAAmB;QACxB,GAAG,EAAE,mBAAmB;KACzB,CAAC,QAAQ,CAAC,CAAC;IAEZ,MAAM,QAAQ,GAAG;QACf,EAAE,EAAE,KAAK;QACT,KAAK,EAAE;YACL,IAAI;YACJ,OAAO,EAAE,eAAe,IAAI,MAAM,YAAY,qCAAqC;YACnF,GAAG,EAAE;gBACH,MAAM,EAAE,cAAc;gBACtB,WAAW,EAAE,uGAAuG,YAAY,4DAA4D,YAAY,8PAA8P,WAAW,qCAAqC;aACvf;YACD,SAAS,EAAE,KAAK;SACjB;KACF,CAAC;IAEF,iBAAiB,CAAC,QAAQ,CAAC,CAAC;IAC5B,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@koda-sl/baker-cli",
-  "version": "0.15.0",
+  "version": "0.18.0",
   "description": "AI-agent-first CLI for interacting with Baker",
   "type": "module",
   "bin": {