@cursor/july 0.1.2 → 0.1.4

package/dist/internal/install-cursor-skills.js

@@ -0,0 +1,274 @@
+/**
+ * Offer to install the package's coding-agent skills into the user's
+ * personal Cursor skills dir under `~/.cursor/skills/agentkit/<skill>/`.
+ *
+ * Cursor walks `~/.cursor/skills` recursively, so the `agentkit/` folder is
+ * only organizational — identity comes from the leaf folder that holds
+ * SKILL.md. Skipped for `--json` / non-TTY hosts.
+ */
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+import { access, cp, mkdir, readdir, readFile, rm, writeFile, } from "node:fs/promises";
+import { homedir } from "node:os";
+import { join } from "node:path";
+import { packageRootDir } from "./distribution.js";
+import { stdoutPalette } from "./terminal-style.js";
+/** Monorepo-only skill; excluded from the published package. */
+const SKIP_SKILL_DIRS = new Set(["operate"]);
+/** Category folder under ~/.cursor/skills (Cursor discovers nested skills). */
+export const CURSOR_SKILLS_NAMESPACE = "agentkit";
+export function cursorSkillsHome(home) {
+    var _a;
+    if (home === void 0) { home = (_a = process.env.HOME) !== null && _a !== void 0 ? _a : homedir(); }
+    const resolved = home.trim() === "" ? homedir() : home;
+    return join(resolved, ".cursor", "skills");
+}
+/** `~/.cursor/skills/agentkit` — where package skills are installed. */
+export function agentkitCursorSkillsDir(skillsHome = cursorSkillsHome()) {
+    return join(skillsHome, CURSOR_SKILLS_NAMESPACE);
+}
+/** Absolute install path for one skill: `…/agentkit/<leafDir>`. */
+export function skillInstallPath(skill, skillsHome = cursorSkillsHome()) {
+    return join(agentkitCursorSkillsDir(skillsHome), skill.leafDir);
+}
+/**
+ * Skills shipped next to the running package. Uses the frontmatter `name`
+ * when present, otherwise `agentkit-<dir>`.
+ */
+export function listShippedPackageSkills() {
+    return __awaiter(this, arguments, void 0, function* (packageRoot = packageRootDir()) {
+        var _a;
+        const skillsRoot = join(packageRoot, "skills");
+        let entries;
+        try {
+            entries = yield readdir(skillsRoot, { withFileTypes: true });
+        }
+        catch (_b) {
+            return [];
+        }
+        const skills = [];
+        for (const entry of entries) {
+            if (!entry.isDirectory() || SKIP_SKILL_DIRS.has(entry.name)) {
+                continue;
+            }
+            const sourceDir = join(skillsRoot, entry.name);
+            const skillMd = join(sourceDir, "SKILL.md");
+            try {
+                yield access(skillMd);
+            }
+            catch (_c) {
+                continue;
+            }
+            const raw = yield readFile(skillMd, "utf8");
+            const name = (_a = parseSkillName(raw)) !== null && _a !== void 0 ? _a : `agentkit-${entry.name}`;
+            skills.push({ name, leafDir: entry.name, sourceDir });
+        }
+        skills.sort((a, b) => a.leafDir.localeCompare(b.leafDir));
+        return skills;
+    });
+}
+/**
+ * Skills that do not yet have a SKILL.md under ~/.cursor/skills/agentkit/.
+ * Install still overwrites every shipped skill when the user confirms — this
+ * helper is for messaging (fresh install vs update).
+ */
+export function findMissingCursorSkills(options) {
+    return __awaiter(this, void 0, void 0, function* () {
+        var _a;
+        const shipped = yield listShippedPackageSkills(options === null || options === void 0 ? void 0 : options.packageRoot);
+        const home = (_a = options === null || options === void 0 ? void 0 : options.skillsHome) !== null && _a !== void 0 ? _a : cursorSkillsHome();
+        const missing = [];
+        for (const skill of shipped) {
+            try {
+                yield access(join(skillInstallPath(skill, home), "SKILL.md"));
+            }
+            catch (_b) {
+                missing.push(skill);
+            }
+        }
+        return missing;
+    });
+}
+/**
+ * Copy each skill directory into `skillsHome/agentkit/<leafDir>/`.
+ * Always overwrites so a package upgrade refreshes local Cursor skills.
+ * Strips monorepo-only frontmatter and removes leaf dirs no longer shipped.
+ */
+export function installCursorSkills(skills_1) {
+    return __awaiter(this, arguments, void 0, function* (skills, skillsHome = cursorSkillsHome()) {
+        const namespaceDir = agentkitCursorSkillsDir(skillsHome);
+        yield mkdir(namespaceDir, { recursive: true });
+        const shippedLeaves = new Set(skills.map((skill) => skill.leafDir));
+        let existingLeaves = [];
+        try {
+            const entries = yield readdir(namespaceDir, { withFileTypes: true });
+            existingLeaves = entries
+                .filter((entry) => entry.isDirectory())
+                .map((entry) => entry.name);
+        }
+        catch (_a) {
+            existingLeaves = [];
+        }
+        for (const leaf of existingLeaves) {
+            if (!shippedLeaves.has(leaf)) {
+                yield rm(join(namespaceDir, leaf), { recursive: true, force: true });
+            }
+        }
+        const installed = [];
+        for (const skill of skills) {
+            const target = skillInstallPath(skill, skillsHome);
+            yield cp(skill.sourceDir, target, { recursive: true, force: true });
+            const skillMdPath = join(target, "SKILL.md");
+            const raw = yield readFile(skillMdPath, "utf8");
+            const adjusted = prepareSkillMarkdownForCursorInstall(raw);
+            if (adjusted !== raw) {
+                yield writeFile(skillMdPath, adjusted, "utf8");
+            }
+            installed.push(skill.leafDir);
+        }
+        return installed;
+    });
+}
+/** Drop monorepo `paths` globs and fix package doc links for ~/.cursor installs. */
+export function prepareSkillMarkdownForCursorInstall(content) {
+    var _a;
+    const match = /^---\r?\n([\s\S]*?)\r?\n---/.exec(content);
+    if (match === null) {
+        return content;
+    }
+    const frontmatter = stripPathsFromFrontmatter((_a = match[1]) !== null && _a !== void 0 ? _a : "");
+    const body = content.slice(match[0].length);
+    const adjustedBody = body.replace(/\[`docs\/([^`]+)`\]\(\.\.\/\.\.\/docs\/[^)]+\)/g, "docs/$1 in the @cursor/july package");
+    return `---\n${frontmatter.trimEnd()}\n---${adjustedBody}`;
+}
+function stripPathsFromFrontmatter(frontmatter) {
+    var _a, _b;
+    const lines = frontmatter.split(/\r?\n/);
+    const out = [];
+    for (let i = 0; i < lines.length; i++) {
+        const line = (_a = lines[i]) !== null && _a !== void 0 ? _a : "";
+        if (line.trimStart().startsWith("paths:")) {
+            i++;
+            while (i < lines.length && /^[ \t]*-/.test((_b = lines[i]) !== null && _b !== void 0 ? _b : "")) {
+                i++;
+            }
+            i--;
+            continue;
+        }
+        out.push(line);
+    }
+    return out.join("\n");
+}
+/**
+ * On a TTY, offer to install/update every shipped package skill into
+ * ~/.cursor/skills/agentkit (always overwriting). No-op when non-interactive
+ * or the package ships no skills.
+ */
+export function offerInstallCursorSkills() {
+    return __awaiter(this, arguments, void 0, function* (options = {}) {
+        var _a, _b, _c, _d;
+        const out = (_a = options.out) !== null && _a !== void 0 ? _a : ((text) => process.stdout.write(text));
+        const interactive = (_b = options.interactive) !== null && _b !== void 0 ? _b : (process.stdin.isTTY === true && process.stdout.isTTY === true);
+        const shipped = yield listShippedPackageSkills(options.packageRoot);
+        if (shipped.length === 0) {
+            return { installed: [], skipped: true };
+        }
+        const home = (_c = options.skillsHome) !== null && _c !== void 0 ? _c : cursorSkillsHome();
+        const targetDir = agentkitCursorSkillsDir(home);
+        const missing = yield findMissingCursorSkills({
+            packageRoot: options.packageRoot,
+            skillsHome: home,
+        });
+        const names = shipped.map((skill) => skill.leafDir).join(", ");
+        const noun = shipped.length === 1 ? "skill" : "skills";
+        const verb = missing.length === shipped.length ? "Install" : "Update";
+        const question = `${verb} ${shipped.length} agentkit ${noun} in ${targetDir}?`;
+        if (!interactive) {
+            return { installed: [], skipped: true };
+        }
+        const c = stdoutPalette();
+        out(`${question}\n`);
+        out(c.dim(`  ${names}\n`));
+        if (missing.length < shipped.length) {
+            out(c.dim("  (overwrites existing copies with the package version)\n"));
+        }
+        const confirm = (_d = options.confirm) !== null && _d !== void 0 ? _d : ((q) => promptYesNo(q, { defaultYes: true, out }));
+        const accepted = yield confirm(missing.length === shipped.length ? "Install now?" : "Update now?");
+        if (!accepted) {
+            out(c.dim("Skipped skill install.\n\n"));
+            return { installed: [], skipped: true };
+        }
+        const installed = yield installCursorSkills(shipped, home);
+        out(`${verb === "Install" ? "Installed" : "Updated"} ${installed.length} ${noun} in ${targetDir}\n\n`);
+        return { installed, skipped: false };
+    });
+}
+function parseSkillName(skillMd) {
+    var _a;
+    var _b;
+    const match = /^---\r?\n([\s\S]*?)\r?\n---/.exec(skillMd);
+    if (match === null) {
+        return undefined;
+    }
+    const nameLine = /^name:\s*(.+)\s*$/m.exec((_b = match[1]) !== null && _b !== void 0 ? _b : "");
+    if (nameLine === null) {
+        return undefined;
+    }
+    const raw = (_a = nameLine[1]) === null || _a === void 0 ? void 0 : _a.trim();
+    if (raw === undefined || raw === "") {
+        return undefined;
+    }
+    // Strip optional quotes around the YAML scalar.
+    return raw.replace(/^["']|["']$/g, "");
+}
+function promptYesNo(question, options) {
+    return __awaiter(this, void 0, void 0, function* () {
+        const hint = options.defaultYes ? "Y/n" : "y/N";
+        options.out(`${question} [${hint}] `);
+        process.stdin.resume();
+        const line = yield readOneLine(process.stdin);
+        process.stdin.pause();
+        if (line === undefined || line.trim() === "") {
+            return options.defaultYes;
+        }
+        const answer = line.trim().toLowerCase();
+        if (answer === "y" || answer === "yes") {
+            return true;
+        }
+        if (answer === "n" || answer === "no") {
+            return false;
+        }
+        return options.defaultYes;
+    });
+}
+function readOneLine(stream) {
+    return new Promise((resolve) => {
+        let buffer = "";
+        const onData = (chunk) => {
+            buffer += typeof chunk === "string" ? chunk : chunk.toString("utf8");
+            const newline = buffer.indexOf("\n");
+            if (newline === -1) {
+                return;
+            }
+            cleanup();
+            resolve(buffer.slice(0, newline).replace(/\r$/, ""));
+        };
+        const onEnd = () => {
+            cleanup();
+            resolve(buffer === "" ? undefined : buffer.replace(/\r$/, ""));
+        };
+        const cleanup = () => {
+            stream.off("data", onData);
+            stream.off("end", onEnd);
+        };
+        stream.on("data", onData);
+        stream.on("end", onEnd);
+    });
+}

package/dist/internal/logs-client.d.ts

@@ -0,0 +1,60 @@
+/**
+ * `agentkit logs` — follow deploy progress (hosted) then runtime `/v1/logs`.
+ *
+ * Customer-facing output never includes hosting URLs, tokens, or infra jargon.
+ */
+import { type DeploymentDetail, type DeploymentProgress } from "./deploy-client.js";
+import { type RequestAuth } from "./request-headers.js";
+export interface LogRingEntry {
+    index: number;
+    at: string;
+    line: string;
+}
+export interface LogsResponse {
+    entries: LogRingEntry[];
+    nextAfter: number;
+}
+export type LogsProgress = DeploymentProgress | "queued" | "preparing" | "building" | "finalizing" | "running" | "failed" | "stopping" | "stopped" | "degraded";
+export declare function progressMessage(progress: LogsProgress, lastError?: string | null): string;
+/** Strip obvious hosting internals from error text shown to customers. */
+export declare function sanitizeCustomerError(message: string): string;
+export declare function fetchLogs(args: {
+    baseUrl: string;
+    after?: number;
+    auth?: RequestAuth;
+    fetchImpl?: typeof fetch;
+    signal?: AbortSignal;
+}): Promise<LogsResponse>;
+export interface RunLogsTailOptions {
+    /** When true, use hosted deploy progress then runtime logs. */
+    prod?: boolean;
+    dir: string;
+    cwd?: string;
+    slug?: string;
+    team?: string;
+    apiKey?: string;
+    url?: string;
+    bearerToken?: string;
+    once?: boolean;
+    json?: boolean;
+    fetchImpl?: typeof fetch;
+    signal?: AbortSignal;
+    intervalMs?: number;
+    /** stdout writer (test seam). */
+    write?: (text: string) => void;
+    /** stderr writer (test seam). */
+    err?: (text: string) => void;
+    /**
+     * Deploy detail fetcher for `--prod` progress (test seam). Defaults to
+     * management API via resolveProdTarget's auth path.
+     */
+    getDeployment?: () => Promise<DeploymentDetail>;
+    /** After deploy is running, resolve runtime base URL + headers. */
+    resolveRuntime?: () => Promise<{
+        agentUrl: string;
+        headers?: Record<string, string>;
+    }>;
+    sleep?: (ms: number, signal?: AbortSignal) => Promise<void>;
+}
+export declare function runLogsTail(options: RunLogsTailOptions): Promise<void>;
+//# sourceMappingURL=logs-client.d.ts.map

package/dist/internal/logs-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logs-client.d.ts","sourceRoot":"","sources":["../../src/internal/logs-client.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAEL,KAAK,gBAAgB,EACrB,KAAK,kBAAkB,EACxB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAuB,KAAK,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAW7E,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE,MAAM,CAAC;IACd,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,YAAY,EAAE,CAAC;IACxB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,MAAM,YAAY,GACpB,kBAAkB,GAClB,QAAQ,GACR,WAAW,GACX,UAAU,GACV,YAAY,GACZ,SAAS,GACT,QAAQ,GACR,UAAU,GACV,SAAS,GACT,UAAU,CAAC;AAcf,wBAAgB,eAAe,CAC7B,QAAQ,EAAE,YAAY,EACtB,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,GACxB,MAAM,CAgBR;AAED,0EAA0E;AAC1E,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAS7D;AAED,wBAAsB,SAAS,CAAC,IAAI,EAAE;IACpC,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,WAAW,CAAC;IACnB,SAAS,CAAC,EAAE,OAAO,KAAK,CAAC;IACzB,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB,GAAG,OAAO,CAAC,YAAY,CAAC,CA0BxB;AAED,MAAM,WAAW,kBAAkB;IACjC,+DAA+D;IAC/D,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,GAAG,EAAE,MAAM,CAAC;IACZ,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,SAAS,CAAC,EAAE,OAAO,KAAK,CAAC;IACzB,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,iCAAiC;IACjC,KAAK,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IAC/B,iCAAiC;IACjC,GAAG,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IAC7B;;;OAGG;IACH,aAAa,CAAC,EAAE,MAAM,OAAO,CAAC,gBAAgB,CAAC,CAAC;IAChD,mEAAmE;IACnE,cAAc,CAAC,EAAE,MAAM,OAAO,CAAC;QAC7B,QAAQ,EAAE,MAAM,CAAC;QACjB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;KAClC,CAAC,CAAC;IACH,KAAK,CAAC,EAAE,CAAC,EAAE,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,WAAW,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;CAC7D;AAED,wBAAsB,WAAW,CAAC,OAAO,EAAE,kBAAkB,GAAG,OAAO,CAAC,IAAI,CAAC,CAoC5E"}

package/dist/internal/logs-client.js

@@ -0,0 +1,311 @@
+/**
+ * `agentkit logs` — follow deploy progress (hosted) then runtime `/v1/logs`.
+ *
+ * Customer-facing output never includes hosting URLs, tokens, or infra jargon.
+ */
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+import { DeployApiError, } from "./deploy-client.js";
+import { mergeRequestHeaders } from "./request-headers.js";
+import { resolveProdTarget } from "./resolve-prod-target.js";
+import { stderrPalette } from "./terminal-style.js";
+const DEFAULT_POLL_INTERVAL_MS = 1000;
+/** Re-read abort state after await (loop narrowing would hide async abort). */
+function isAborted(signal) {
+    return (signal === null || signal === void 0 ? void 0 : signal.aborted) === true;
+}
+const PROGRESS_MESSAGES = {
+    queued: "Waiting to start…",
+    preparing: "Preparing runtime…",
+    building: "Building and starting agent…",
+    finalizing: "Finishing deployment…",
+    running: "Deployment running",
+    failed: "Deploy failed",
+    stopping: "Stopping deployment…",
+    stopped: "Deployment stopped",
+    degraded: "Deployment degraded",
+};
+export function progressMessage(progress, lastError) {
+    if (progress === "failed") {
+        const detail = lastError === null || lastError === undefined || lastError.trim() === ""
+            ? ""
+            : `: ${sanitizeCustomerError(lastError)}`;
+        return `Deploy failed${detail}`;
+    }
+    if (progress === "degraded") {
+        const detail = lastError === null || lastError === undefined || lastError.trim() === ""
+            ? ""
+            : `: ${sanitizeCustomerError(lastError)}`;
+        return `Deployment degraded${detail}`;
+    }
+    return PROGRESS_MESSAGES[progress];
+}
+/** Strip obvious hosting internals from error text shown to customers. */
+export function sanitizeCustomerError(message) {
+    return message
+        .replace(/https?:\/\/\S+/gi, "[url]")
+        .replace(/\bpod-[a-z0-9]+\b/gi, "[runtime]")
+        .replace(/\banyrun\b/gi, "runtime")
+        .replace(/\bcursorvm\.com\b/gi, "host")
+        .replace(/\bx-anyrun-[a-z0-9-]+\b/gi, "header")
+        .replace(/\bPROVISIONING\b/g, "building")
+        .replace(/\bPLANNED\b/g, "preparing");
+}
+export function fetchLogs(args) {
+    return __awaiter(this, void 0, void 0, function* () {
+        var _a;
+        var _b, _c, _d;
+        const fetchImpl = (_b = args.fetchImpl) !== null && _b !== void 0 ? _b : fetch;
+        const after = (_c = args.after) !== null && _c !== void 0 ? _c : -1;
+        const url = new URL(`${args.baseUrl.replace(/\/$/, "")}/v1/logs`);
+        if (after >= 0) {
+            url.searchParams.set("after", String(after));
+        }
+        const resp = yield fetchImpl(url, {
+            headers: mergeRequestHeaders(args.auth),
+            signal: args.signal,
+        });
+        if (!resp.ok) {
+            throw new Error(`Could not fetch logs (HTTP ${resp.status}).`);
+        }
+        const body = (yield resp.json());
+        const entries = Array.isArray(body.entries) ? body.entries : [];
+        const nextAfter = typeof body.nextAfter === "number"
+            ? body.nextAfter
+            : entries.length === 0
+                ? after
+                : ((_d = (_a = entries[entries.length - 1]) === null || _a === void 0 ? void 0 : _a.index) !== null && _d !== void 0 ? _d : after);
+        return { entries, nextAfter };
+    });
+}
+export function runLogsTail(options) {
+    return __awaiter(this, void 0, void 0, function* () {
+        var _a, _b, _c, _d, _e;
+        const write = (_a = options.write) !== null && _a !== void 0 ? _a : ((text) => void process.stdout.write(text));
+        const err = (_b = options.err) !== null && _b !== void 0 ? _b : ((text) => void process.stderr.write(text));
+        const sleep = (_c = options.sleep) !== null && _c !== void 0 ? _c : sleepMs;
+        const intervalMs = (_d = options.intervalMs) !== null && _d !== void 0 ? _d : DEFAULT_POLL_INTERVAL_MS;
+        const c = stderrPalette();
+        if (options.prod === true) {
+            yield followProdLogs(Object.assign(Object.assign({}, options), { write,
+                err,
+                sleep,
+                intervalMs, palette: c }));
+            return;
+        }
+        const baseUrl = ((_e = options.url) !== null && _e !== void 0 ? _e : "http://127.0.0.1:3000").replace(/\/$/, "");
+        if (options.once !== true) {
+            err(c.dim("Tailing logs… (Ctrl-C to stop)\n"));
+        }
+        yield followRuntimeLogs({
+            baseUrl,
+            auth: { bearerToken: options.bearerToken },
+            once: options.once === true,
+            json: options.json === true,
+            fetchImpl: options.fetchImpl,
+            signal: options.signal,
+            intervalMs,
+            write,
+            sleep,
+        });
+    });
+}
+function followProdLogs(args) {
+    return __awaiter(this, void 0, void 0, function* () {
+        var _a, _b;
+        const resolveRuntime = (_a = args.resolveRuntime) !== null && _a !== void 0 ? _a : (() => __awaiter(this, void 0, void 0, function* () {
+            const target = yield resolveProdTarget({
+                dir: args.dir,
+                cwd: args.cwd,
+                slug: args.slug,
+                team: args.team,
+                apiKey: args.apiKey,
+                fetchImpl: args.fetchImpl,
+                err: () => { },
+            });
+            return { agentUrl: target.agentUrl, headers: target.headers };
+        }));
+        const getDeployment = (_b = args.getDeployment) !== null && _b !== void 0 ? _b : (() => __awaiter(this, void 0, void 0, function* () {
+            // Lazy import path via resolveProdTarget side: re-fetch through a
+            // one-shot resolve that throws if not running is wrong for progress.
+            // Callers that omit getDeployment must provide it in production via
+            // cmdLogs (which wires deploy auth).
+            throw new Error("Internal error: deploy progress requires a deployment lookup.");
+        }));
+        let lastProgress;
+        const slugHint = args.slug !== undefined && args.slug !== "" ? args.slug : "";
+        if (args.once !== true) {
+            const label = slugHint !== "" ? slugHint : "deployment";
+            args.err(args.palette.dim(`Tailing logs for ${label}… (Ctrl-C to stop)\n`));
+        }
+        while (!isAborted(args.signal)) {
+            let detail;
+            try {
+                detail = yield getDeployment();
+            }
+            catch (error) {
+                if (isAborted(args.signal)) {
+                    return;
+                }
+                throw customerDeployLookupError(error);
+            }
+            const progress = resolveProgress(detail);
+            if (progress === "failed") {
+                const message = progressMessage(progress, detail.lastError);
+                if (progress !== lastProgress) {
+                    lastProgress = progress;
+                    emitProgress(args.write, args.json === true, progress, message);
+                }
+                throw new Error(`Deployment "${detail.slug}" failed.`);
+            }
+            if (progress === "stopped") {
+                const message = progressMessage(progress, detail.lastError);
+                if (progress !== lastProgress) {
+                    lastProgress = progress;
+                    emitProgress(args.write, args.json === true, progress, message);
+                }
+                throw new Error(`Deployment "${detail.slug}" is stopped.`);
+            }
+            if (progress === "running" || progress === "degraded") {
+                // Hand off to runtime logs. Print degraded once; skip a "running" line.
+                if (progress === "degraded" && progress !== lastProgress) {
+                    lastProgress = progress;
+                    emitProgress(args.write, args.json === true, progress, progressMessage(progress, detail.lastError));
+                }
+                const runtime = yield resolveRuntime();
+                yield followRuntimeLogs({
+                    baseUrl: runtime.agentUrl,
+                    auth: {
+                        bearerToken: args.bearerToken,
+                        headers: runtime.headers,
+                    },
+                    once: args.once === true,
+                    json: args.json === true,
+                    fetchImpl: args.fetchImpl,
+                    signal: args.signal,
+                    intervalMs: args.intervalMs,
+                    write: args.write,
+                    sleep: args.sleep,
+                });
+                return;
+            }
+            const message = progressMessage(progress, detail.lastError);
+            if (progress !== lastProgress) {
+                lastProgress = progress;
+                emitProgress(args.write, args.json === true, progress, message);
+            }
+            if (args.once === true) {
+                return;
+            }
+            yield args.sleep(args.intervalMs, args.signal);
+        }
+    });
+}
+function resolveProgress(detail) {
+    if (detail.progress !== undefined) {
+        return detail.progress;
+    }
+    switch (detail.status) {
+        case "pending":
+            return "queued";
+        case "deploying":
+            return "building";
+        case "running":
+            return "running";
+        case "failed":
+            return "failed";
+        case "degraded":
+            return "degraded";
+        case "stopping":
+            return "stopping";
+        case "stopped":
+            return "stopped";
+        default:
+            return "queued";
+    }
+}
+function emitProgress(write, json, progress, message) {
+    if (json) {
+        write(`${JSON.stringify({ type: "progress", progress, message })}\n`);
+        return;
+    }
+    write(`${message}\n`);
+}
+function followRuntimeLogs(args) {
+    return __awaiter(this, void 0, void 0, function* () {
+        let after = -1;
+        for (;;) {
+            if (isAborted(args.signal)) {
+                return;
+            }
+            let batch;
+            try {
+                batch = yield fetchLogs({
+                    baseUrl: args.baseUrl,
+                    after,
+                    auth: args.auth,
+                    fetchImpl: args.fetchImpl,
+                    signal: args.signal,
+                });
+            }
+            catch (error) {
+                if (isAborted(args.signal)) {
+                    return;
+                }
+                throw error instanceof Error ? error : new Error("Could not fetch logs.");
+            }
+            for (const entry of batch.entries) {
+                if (args.json) {
+                    args.write(`${JSON.stringify({
+                        type: "log",
+                        index: entry.index,
+                        at: entry.at,
+                        line: entry.line,
+                    })}\n`);
+                }
+                else {
+                    args.write(`${entry.line}\n`);
+                }
+            }
+            after = batch.nextAfter;
+            if (args.once) {
+                return;
+            }
+            yield args.sleep(args.intervalMs, args.signal);
+        }
+    });
+}
+function customerDeployLookupError(error) {
+    if (error instanceof DeployApiError) {
+        return new Error(`Could not look up deployment: ${sanitizeCustomerError(error.message)}`);
+    }
+    if (error instanceof Error) {
+        return new Error(sanitizeCustomerError(error.message));
+    }
+    return new Error("Could not look up deployment.");
+}
+function sleepMs(ms, signal) {
+    return __awaiter(this, void 0, void 0, function* () {
+        if (isAborted(signal)) {
+            return;
+        }
+        yield new Promise((resolve) => {
+            const timer = setTimeout(() => {
+                signal === null || signal === void 0 ? void 0 : signal.removeEventListener("abort", onAbort);
+                resolve();
+            }, ms);
+            const onAbort = () => {
+                clearTimeout(timer);
+                resolve();
+            };
+            signal === null || signal === void 0 ? void 0 : signal.addEventListener("abort", onAbort, { once: true });
+        });
+    });
+}

package/dist/internal/mcp-endpoint.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"mcp-endpoint.d.ts","sourceRoot":"","sources":["../../src/internal/mcp-endpoint.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAGH,OAAO,EAAE,wCAAwC,EAAE,MAAM,+DAA+D,CAAC;AAEzH,OAAO,KAAK,EACV,YAAY,EACZ,WAAW,EAGZ,MAAM,aAAa,CAAC;AAErB,OAAO,EAEL,KAAK,aAAa,EAKnB,MAAM,qBAAqB,CAAC;AAE7B,uEAAuE;AACvE,eAAO,MAAM,cAAc,QAAQ,CAAC;AAEpC,iEAAiE;AACjE,eAAO,MAAM,iBAAiB,YAAY,CAAC;AAU3C,MAAM,WAAW,gBAAgB;IAC/B;;;;OAIG;IACH,MAAM,CAAC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,WAAW,GAAG,IAAI,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAC;CACvE;AAED,yEAAyE;AACzE,UAAU,oBAAoB;IAC5B,OAAO,CAAC,SAAS,EAAE,wCAAwC,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC5E,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACxB;AAED;;;;;GAKG;AACH,wBAAsB,yBAAyB,CAAC,IAAI,EAAE;IACpD,OAAO,EAAE,OAAO,CAAC;IACjB,0EAA0E;IAC1E,WAAW,EAAE,MAAM,oBAAoB,CAAC;IACxC,iEAAiE;IACjE,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;CACjC,GAAG,OAAO,CAAC,QAAQ,CAAC,CA2CpB;AAED,0EAA0E;AAC1E,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,YAAY,GAAG,MAAM,EAAE,CAMpE;AAED,wBAAgB,sBAAsB,CAAC,IAAI,EAAE;IAC3C,MAAM,EAAE,aAAa,CAAC;IACtB,MAAM,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;CACjC,GAAG,gBAAgB,CAanB"}
+{"version":3,"file":"mcp-endpoint.d.ts","sourceRoot":"","sources":["../../src/internal/mcp-endpoint.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAGH,OAAO,EAAE,wCAAwC,EAAE,MAAM,+DAA+D,CAAC;AAEzH,OAAO,KAAK,EACV,YAAY,EACZ,WAAW,EAGZ,MAAM,aAAa,CAAC;AAErB,OAAO,EAEL,KAAK,aAAa,EAKnB,MAAM,qBAAqB,CAAC;AAE7B,uEAAuE;AACvE,eAAO,MAAM,cAAc,QAAQ,CAAC;AAEpC,iEAAiE;AACjE,eAAO,MAAM,iBAAiB,YAAY,CAAC;AAU3C,MAAM,WAAW,gBAAgB;IAC/B;;;;OAIG;IACH,MAAM,CAAC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,WAAW,GAAG,IAAI,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAC;CACvE;AAED,yEAAyE;AACzE,UAAU,oBAAoB;IAC5B,OAAO,CAAC,SAAS,EAAE,wCAAwC,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC5E,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACxB;AAED;;;;;GAKG;AACH,wBAAsB,yBAAyB,CAAC,IAAI,EAAE;IACpD,OAAO,EAAE,OAAO,CAAC;IACjB,0EAA0E;IAC1E,WAAW,EAAE,MAAM,oBAAoB,CAAC;IACxC,iEAAiE;IACjE,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;CACjC,GAAG,OAAO,CAAC,QAAQ,CAAC,CAyCpB;AAED,0EAA0E;AAC1E,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,YAAY,GAAG,MAAM,EAAE,CAMpE;AAED,wBAAgB,sBAAsB,CAAC,IAAI,EAAE;IAC3C,MAAM,EAAE,aAAa,CAAC;IACtB,MAAM,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;CACjC,GAAG,gBAAgB,CAanB"}

package/dist/internal/mcp-endpoint.js

@@ -75,7 +75,7 @@ export function handleStatelessMcpRequest(args) {
             return yield transport.handleRequest(args.request);
         }
         catch (error) {
-            logger(`[agent-serve] ${args.label} request failed: ${describeError(error)}`);
+            logger(`[agentkit] ${args.label} request failed: ${describeError(error)}`);
             return new Response(JSON.stringify({
                 jsonrpc: "2.0",
                 error: { code: -32603, message: "Internal server error." },

package/dist/internal/open-browser.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Best-effort browser open; callers should always print the URL as fallback.
+ */
+export declare function openBrowser(url: string): void;
+//# sourceMappingURL=open-browser.d.ts.map

package/dist/internal/open-browser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"open-browser.d.ts","sourceRoot":"","sources":["../../src/internal/open-browser.ts"],"names":[],"mappings":"AAAA;;GAEG;AAKH,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAiC7C"}