@cursor/july 0.1.2 → 0.1.4

package/dist/internal/host-platforms.js

@@ -81,7 +81,7 @@ export function warmupHostGitHubAuth(options) {
         var _a;
         const source = (_a = options.authSource) !== null && _a !== void 0 ? _a : (yield resolveHostGitHubAuthSource());
         if (source === "unavailable") {
-            options.logger("[agent-serve] GitHub auth: unavailable (set GITHUB_APP_ID + GITHUB_APP_PRIVATE_KEY + GITHUB_APP_INSTALLATION_ID, or GITHUB_TOKEN / GH_TOKEN, or run `gh auth login`)");
+            options.logger("[agentkit] GitHub auth: unavailable (set GITHUB_APP_ID + GITHUB_APP_PRIVATE_KEY + GITHUB_APP_INSTALLATION_ID, or GITHUB_TOKEN / GH_TOKEN, or run `gh auth login`)");
             return source;
         }
         let exportedGhToken = false;
@@ -90,7 +90,7 @@ export function warmupHostGitHubAuth(options) {
                 exportedGhToken = yield ensureGhCliTokenEnv();
             }
             catch (error) {
-                options.logger(`[agent-serve] GitHub auth: failed to export GH_TOKEN for gh CLI: ${error instanceof Error ? error.message : String(error)}`);
+                options.logger(`[agentkit] GitHub auth: failed to export GH_TOKEN for gh CLI: ${error instanceof Error ? error.message : String(error)}`);
             }
         }
         const label = source === "cursor-account"
@@ -103,15 +103,15 @@ export function warmupHostGitHubAuth(options) {
                     ? "GITHUB_TOKEN/GH_TOKEN"
                     : "gh auth token";
         if (options.github === undefined) {
-            options.logger(`[agent-serve] GitHub auth: ${label}`);
+            options.logger(`[agentkit] GitHub auth: ${label}`);
             return source;
         }
         try {
             yield options.github.getOctokit();
-            options.logger(`[agent-serve] GitHub auth: ${label}`);
+            options.logger(`[agentkit] GitHub auth: ${label}`);
         }
         catch (error) {
-            options.logger(`[agent-serve] GitHub auth: ${label} resolved but Octokit warmup failed: ${error instanceof Error ? error.message : String(error)}`);
+            options.logger(`[agentkit] GitHub auth: ${label} resolved but Octokit warmup failed: ${error instanceof Error ? error.message : String(error)}`);
         }
         return source;
     });

package/dist/internal/init-project.d.ts

@@ -9,11 +9,98 @@ export interface InitProjectOptions {
     /** Model id override written into agent.ts. */
     model?: string;
 }
+export type InitFileAction = "create" | "exist";
+export interface InitFileEntry {
+    path: string;
+    action: InitFileAction;
+}
 export interface InitProjectResult {
     rootDir: string;
-    files: string[];
+    /** Scaffold files in write order, with create/exist for each. */
+    files: InitFileEntry[];
+    /** Paths newly written. */
+    created: string[];
+    /** Paths left alone because they already existed. */
+    skipped: string[];
 }
 export declare function initProject(options: InitProjectOptions): Promise<InitProjectResult>;
+export interface InstallScaffoldDependenciesOptions {
+    /**
+     * `inherit` streams npm output to the terminal (human `init`);
+     * `pipe` captures it ( `--json` / tests).
+     */
+    stdio?: "inherit" | "pipe";
+    /** Test seam — replaces the real `npm install` spawn. */
+    runner?: (args: {
+        command: string;
+        args: string[];
+        cwd: string;
+        stdio: "inherit" | "pipe";
+    }) => Promise<{
+        exitCode: number;
+        stderr: string;
+    }>;
+}
+export interface InstallScaffoldDependenciesResult {
+    ok: boolean;
+    exitCode: number;
+    stderr: string;
+}
+/**
+ * Install the scaffold's npm dependencies so `dev` / `run` can resolve
+ * `@cursor/july` immediately after `init`.
+ */
+export declare function installScaffoldDependencies(rootDir: string, options?: InstallScaffoldDependenciesOptions): Promise<InstallScaffoldDependenciesResult>;
+export interface InitScaffoldSummaryOptions {
+    /** Scaffolded project root (absolute). */
+    rootDir: string;
+    /** Scaffold files in write order (`create` / `exist`). */
+    files: InitFileEntry[];
+    /** Override TTY color detection (tests / `--json` callers). */
+    color?: boolean;
+}
+export interface InitNextStepsOptions {
+    /** Scaffolded project root (absolute). */
+    rootDir: string;
+    /** Directory the command ran from. */
+    cwd: string;
+    /**
+     * True when a Cursor credential resolves. When false, next steps include
+     * `login` (used for `--json` and when an interactive login attempt failed).
+     */
+    signedIn: boolean;
+    /** Override TTY color detection (tests / `--json` callers). */
+    color?: boolean;
+}
+export type InitSummaryOptions = InitScaffoldSummaryOptions & InitNextStepsOptions;
+/**
+ * Created/skipped files plus the project path. Printed before an interactive
+ * login so the scaffold is visible while the browser flow runs.
+ */
+export declare function formatInitScaffoldSummary(options: InitScaffoldSummaryOptions): string;
+/**
+ * Numbered next steps after scaffold (and after login when init ran it).
+ * Includes `cd` when init did not already run inside the project.
+ */
+export declare function formatInitNextSteps(options: InitNextStepsOptions): string;
+/**
+ * Full human-readable scaffold summary (scaffold + next steps).
+ */
+export declare function formatInitSummary(options: InitSummaryOptions): string;
+/**
+ * `cd` into the scaffold when init did not already run inside it. Relative
+ * when the target sits under the invoking directory, absolute otherwise.
+ */
+export declare function formatCdCommand(cwd: string, rootDir: string): string | undefined;
+/**
+ * Next-step commands for the `--json` scaffold summary (login omitted when
+ * the host already has a Cursor credential).
+ */
+export declare function initNextCommands(options: {
+    rootDir: string;
+    cwd: string;
+    signedIn: boolean;
+}): string[];
 /**
  * Coding-agent setup guide printed by `agent-serve init`
  * with no target directory (does not scaffold).

package/dist/internal/init-project.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"init-project.d.ts","sourceRoot":"","sources":["../../src/internal/init-project.ts"],"names":[],"mappings":"AAAA;;GAEG;AAWH,MAAM,WAAW,kBAAkB;IACjC,gDAAgD;IAChD,GAAG,EAAE,MAAM,CAAC;IACZ,8DAA8D;IAC9D,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,+CAA+C;IAC/C,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,iBAAiB;IAChC,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,EAAE,CAAC;CACjB;AAUD,wBAAsB,WAAW,CAC/B,OAAO,EAAE,kBAAkB,GAC1B,OAAO,CAAC,iBAAiB,CAAC,CA+E5B;AAuBD;;;GAGG;AACH,wBAAgB,cAAc,IAAI,IAAI,CAqBrC"}
+{"version":3,"file":"init-project.d.ts","sourceRoot":"","sources":["../../src/internal/init-project.ts"],"names":[],"mappings":"AAAA;;GAEG;AAiBH,MAAM,WAAW,kBAAkB;IACjC,gDAAgD;IAChD,GAAG,EAAE,MAAM,CAAC;IACZ,8DAA8D;IAC9D,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,+CAA+C;IAC/C,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,MAAM,cAAc,GAAG,QAAQ,GAAG,OAAO,CAAC;AAEhD,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,cAAc,CAAC;CACxB;AAED,MAAM,WAAW,iBAAiB;IAChC,OAAO,EAAE,MAAM,CAAC;IAChB,iEAAiE;IACjE,KAAK,EAAE,aAAa,EAAE,CAAC;IACvB,2BAA2B;IAC3B,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,qDAAqD;IACrD,OAAO,EAAE,MAAM,EAAE,CAAC;CACnB;AA2BD,wBAAsB,WAAW,CAC/B,OAAO,EAAE,kBAAkB,GAC1B,OAAO,CAAC,iBAAiB,CAAC,CAgH5B;AAWD,MAAM,WAAW,kCAAkC;IACjD;;;OAGG;IACH,KAAK,CAAC,EAAE,SAAS,GAAG,MAAM,CAAC;IAC3B,yDAAyD;IACzD,MAAM,CAAC,EAAE,CAAC,IAAI,EAAE;QACd,OAAO,EAAE,MAAM,CAAC;QAChB,IAAI,EAAE,MAAM,EAAE,CAAC;QACf,GAAG,EAAE,MAAM,CAAC;QACZ,KAAK,EAAE,SAAS,GAAG,MAAM,CAAC;KAC3B,KAAK,OAAO,CAAC;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CACrD;AAED,MAAM,WAAW,iCAAiC;IAChD,EAAE,EAAE,OAAO,CAAC;IACZ,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED;;;GAGG;AACH,wBAAsB,2BAA2B,CAC/C,OAAO,EAAE,MAAM,EACf,OAAO,GAAE,kCAAuC,GAC/C,OAAO,CAAC,iCAAiC,CAAC,CAW5C;AAkDD,MAAM,WAAW,0BAA0B;IACzC,0CAA0C;IAC1C,OAAO,EAAE,MAAM,CAAC;IAChB,0DAA0D;IAC1D,KAAK,EAAE,aAAa,EAAE,CAAC;IACvB,+DAA+D;IAC/D,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED,MAAM,WAAW,oBAAoB;IACnC,0CAA0C;IAC1C,OAAO,EAAE,MAAM,CAAC;IAChB,sCAAsC;IACtC,GAAG,EAAE,MAAM,CAAC;IACZ;;;OAGG;IACH,QAAQ,EAAE,OAAO,CAAC;IAClB,+DAA+D;IAC/D,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED,MAAM,MAAM,kBAAkB,GAAG,0BAA0B,GACzD,oBAAoB,CAAC;AAMvB;;;GAGG;AACH,wBAAgB,yBAAyB,CACvC,OAAO,EAAE,0BAA0B,GAClC,MAAM,CAkBR;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,oBAAoB,GAAG,MAAM,CAgBzE;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,kBAAkB,GAAG,MAAM,CAErE;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAC7B,GAAG,EAAE,MAAM,EACX,OAAO,EAAE,MAAM,GACd,MAAM,GAAG,SAAS,CAQpB;AAwBD;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE;IACxC,OAAO,EAAE,MAAM,CAAC;IAChB,GAAG,EAAE,MAAM,CAAC;IACZ,QAAQ,EAAE,OAAO,CAAC;CACnB,GAAG,MAAM,EAAE,CAEX;AAED;;;GAGG;AACH,wBAAgB,cAAc,IAAI,IAAI,CAsBrC"}

package/dist/internal/init-project.js

@@ -10,9 +10,11 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
         step((generator = generator.apply(thisArg, _arguments || [])).next());
     });
 };
+import { spawn } from "node:child_process";
 import { mkdir, writeFile } from "node:fs/promises";
-import { basename, dirname, join, resolve } from "node:path";
+import { basename, dirname, join, relative, resolve } from "node:path";
 import { CLI_COMMAND_NAME, PACKAGE_NAME, packageVersion, } from "./distribution.js";
+import { makePalette, stdoutPalette, } from "./terminal-style.js";
 const DEFAULT_MODEL = {
     id: "grok-4.5",
     params: [
@@ -20,6 +22,22 @@ const DEFAULT_MODEL = {
         { id: "fast", value: "true" },
     ],
 };
+/**
+ * Empty capability folders the scaffold creates (each gets a `.gitkeep`).
+ * `agent/tools/` is omitted — the demo `echo.ts` already keeps it in git.
+ */
+const SCAFFOLD_EMPTY_DIRS = [
+    "agent/skills",
+    "agent/mcp-connections",
+    "agent/subagents",
+    "agent/channels",
+    "agent/hooks",
+    "agent/ab",
+    "agent/schedules",
+    "agent/sandbox/workspace",
+    "agent/lib",
+    "evals",
+];
 export function initProject(options) {
     return __awaiter(this, void 0, void 0, function* () {
         var _a, _b;
@@ -28,36 +46,67 @@ export function initProject(options) {
         const model = formatModelLiteral((_b = options.model) !== null && _b !== void 0 ? _b : DEFAULT_MODEL);
         const agentDir = join(rootDir, "agent");
         yield mkdir(agentDir, { recursive: true });
-        const written = [];
+        const files = [];
         const write = (rel, contents) => __awaiter(this, void 0, void 0, function* () {
             const abs = join(rootDir, rel);
             yield mkdir(dirname(abs), { recursive: true });
-            yield writeFile(abs, contents, { flag: "wx" });
-            written.push(rel);
+            try {
+                yield writeFile(abs, contents, { flag: "wx" });
+                files.push({ path: rel, action: "create" });
+            }
+            catch (error) {
+                if (isEexist(error)) {
+                    // Rails generators leave existing files alone (`exist`).
+                    files.push({ path: rel, action: "exist" });
+                    return;
+                }
+                throw error;
+            }
         });
-        try {
-            yield write("package.json", `${JSON.stringify({
-                name,
-                private: true,
-                type: "module",
-                description: `agent project: ${name}`,
-                dependencies: {
-                    [PACKAGE_NAME]: `^${packageVersion()}`,
-                    zod: "^3.25.0",
-                },
-            }, null, 2)}\n`);
-            yield write("agent/agent.ts", `import { defineAgent } from "${PACKAGE_NAME}";
+        yield write("package.json", `${JSON.stringify({
+            name,
+            private: true,
+            type: "module",
+            description: `agent project: ${name}`,
+            scripts: {
+                check: "tsc --noEmit",
+            },
+            dependencies: {
+                [PACKAGE_NAME]: `^${packageVersion()}`,
+                zod: "^3.25.0",
+            },
+            devDependencies: {
+                "@types/node": "^22.14.0",
+                typescript: "^5.8.0",
+            },
+        }, null, 2)}\n`);
+        yield write("tsconfig.json", `{
+  // Type-checking only (npm run check): the framework runs agent/ code
+  // directly through tsx, so nothing is compiled.
+  "compilerOptions": {
+    "target": "ES2022",
+    "module": "ESNext",
+    "moduleResolution": "bundler",
+    "strict": true,
+    "noEmit": true,
+    "skipLibCheck": true,
+    "types": ["node"]
+  },
+  "include": ["agent/**/*", "evals/**/*"]
+}
+`);
+        yield write("agent/agent.ts", `import { defineAgent } from "${PACKAGE_NAME}";
 
 export default defineAgent({
   model: ${model},
 });
 `);
-            yield write("agent/instructions.md", `# ${name}
+        yield write("agent/instructions.md", `# ${name}
 
 You are a helpful agent. Prefer tools when they fit the request.
 Keep answers concise unless the user asks for detail.
 `);
-            yield write("agent/tools/echo.ts", `import { defineTool } from "${PACKAGE_NAME}/tools";
+        yield write("agent/tools/echo.ts", `import { defineTool } from "${PACKAGE_NAME}/tools";
 import { z } from "zod";
 
 export default defineTool({
@@ -68,17 +117,68 @@ export default defineTool({
   },
 });
 `);
+        for (const dir of SCAFFOLD_EMPTY_DIRS) {
+            yield write(`${dir}/.gitkeep`, "");
         }
-        catch (error) {
-            if (error !== null &&
-                typeof error === "object" &&
-                "code" in error &&
-                error.code === "EEXIST") {
-                throw new Error(`Refusing to overwrite existing files under ${rootDir}. Pick an empty directory or remove the conflicting files.`);
+        return {
+            rootDir,
+            files,
+            created: files
+                .filter((entry) => entry.action === "create")
+                .map((entry) => entry.path),
+            skipped: files
+                .filter((entry) => entry.action === "exist")
+                .map((entry) => entry.path),
+        };
+    });
+}
+function isEexist(error) {
+    return (error !== null &&
+        typeof error === "object" &&
+        "code" in error &&
+        error.code === "EEXIST");
+}
+/**
+ * Install the scaffold's npm dependencies so `dev` / `run` can resolve
+ * `@cursor/july` immediately after `init`.
+ */
+export function installScaffoldDependencies(rootDir_1) {
+    return __awaiter(this, arguments, void 0, function* (rootDir, options = {}) {
+        var _a, _b;
+        const stdio = (_a = options.stdio) !== null && _a !== void 0 ? _a : "inherit";
+        const command = process.platform === "win32" ? "npm.cmd" : "npm";
+        const args = ["install", "--no-fund", "--no-audit"];
+        const runner = (_b = options.runner) !== null && _b !== void 0 ? _b : defaultNpmInstallRunner;
+        const result = yield runner({ command, args, cwd: rootDir, stdio });
+        return {
+            ok: result.exitCode === 0,
+            exitCode: result.exitCode,
+            stderr: result.stderr,
+        };
+    });
+}
+function defaultNpmInstallRunner(args) {
+    return __awaiter(this, void 0, void 0, function* () {
+        return yield new Promise((resolvePromise, reject) => {
+            var _a, _b, _c;
+            const child = spawn(args.command, args.args, {
+                cwd: args.cwd,
+                stdio: args.stdio === "inherit" ? "inherit" : ["ignore", "pipe", "pipe"],
+                env: process.env,
+            });
+            let stderr = "";
+            if (args.stdio === "pipe") {
+                (_a = child.stderr) === null || _a === void 0 ? void 0 : _a.setEncoding("utf8");
+                (_b = child.stderr) === null || _b === void 0 ? void 0 : _b.on("data", (chunk) => {
+                    stderr += chunk;
+                });
+                (_c = child.stdout) === null || _c === void 0 ? void 0 : _c.resume();
             }
-            throw error;
-        }
-        return { rootDir, files: written };
+            child.on("error", reject);
+            child.on("close", (code) => {
+                resolvePromise({ exitCode: code !== null && code !== void 0 ? code : 1, stderr });
+            });
+        });
     });
 }
 function formatModelLiteral(model) {
@@ -97,6 +197,95 @@ ${model.params
     id: ${JSON.stringify(model.id)}${params},
   }`;
 }
+function initPalette(color) {
+    return color === undefined ? stdoutPalette() : makePalette(color);
+}
+/**
+ * Created/skipped files plus the project path. Printed before an interactive
+ * login so the scaffold is visible while the browser flow runs.
+ */
+export function formatInitScaffoldSummary(options) {
+    const c = initPalette(options.color);
+    const name = basename(options.rootDir);
+    const lines = [];
+    lines.push(`Initialized agent ${name}`);
+    lines.push("");
+    for (const file of options.files) {
+        // Empty-dir placeholders stay on disk but clutter the summary.
+        if (file.path.endsWith("/.gitkeep") || file.path === ".gitkeep") {
+            continue;
+        }
+        // Thor/Rails status column is 12 chars, right-aligned.
+        lines.push(c.dim(`${file.action.padStart(12)}  ${file.path}`));
+    }
+    lines.push("");
+    lines.push(c.dim(`Project: ${options.rootDir}`));
+    lines.push("");
+    return `${lines.join("\n")}\n`;
+}
+/**
+ * Numbered next steps after scaffold (and after login when init ran it).
+ * Includes `cd` when init did not already run inside the project.
+ */
+export function formatInitNextSteps(options) {
+    const c = initPalette(options.color);
+    const lines = [];
+    lines.push("Next steps:");
+    lines.push("");
+    const steps = initNextStepEntries(options);
+    const width = Math.max(...steps.map((step) => step.command.length));
+    for (const [index, step] of steps.entries()) {
+        const command = step.note === undefined
+            ? step.command
+            : `${step.command.padEnd(width)}   ${c.dim(`# ${step.note}`)}`;
+        lines.push(`  ${index + 1}. ${command}`);
+    }
+    return `${lines.join("\n")}\n`;
+}
+/**
+ * Full human-readable scaffold summary (scaffold + next steps).
+ */
+export function formatInitSummary(options) {
+    return formatInitScaffoldSummary(options) + formatInitNextSteps(options);
+}
+/**
+ * `cd` into the scaffold when init did not already run inside it. Relative
+ * when the target sits under the invoking directory, absolute otherwise.
+ */
+export function formatCdCommand(cwd, rootDir) {
+    const rel = relative(cwd, rootDir);
+    if (rel === "") {
+        return undefined;
+    }
+    const path = rel.startsWith("..") ? rootDir : rel;
+    const quoted = /\s/.test(path) ? JSON.stringify(path) : path;
+    return `cd ${quoted}`;
+}
+function initNextStepEntries(options) {
+    const steps = [];
+    const cd = formatCdCommand(options.cwd, options.rootDir);
+    if (cd !== undefined) {
+        steps.push({ command: cd });
+    }
+    if (!options.signedIn) {
+        steps.push({
+            command: `${CLI_COMMAND_NAME} login`,
+            note: "connect your Cursor account (powers model turns)",
+        });
+    }
+    steps.push({
+        command: `${CLI_COMMAND_NAME} dev`,
+        note: "start the local playground",
+    });
+    return steps;
+}
+/**
+ * Next-step commands for the `--json` scaffold summary (login omitted when
+ * the host already has a Cursor credential).
+ */
+export function initNextCommands(options) {
+    return initNextStepEntries(options).map((step) => step.command);
+}
 /**
  * Coding-agent setup guide printed by `agent-serve init`
  * with no target directory (does not scaffold).
@@ -104,15 +293,16 @@ ${model.params
 export function printInitGuide() {
     process.stdout.write(`${CLI_COMMAND_NAME} — coding agent setup
 
-Recommended loop:
+Scaffold a project, then open the playground:
+  ${CLI_COMMAND_NAME} init ./my-agent   # installs deps; signs you in when needed
+  cd ./my-agent && ${CLI_COMMAND_NAME} dev
+
+Recommended loop once the project exists:
   1. Edit agent/ + tools under agent/tools/
   2. ${CLI_COMMAND_NAME} info --dir . --json
   3. ${CLI_COMMAND_NAME} run --dir . --message "..."
   4. ${CLI_COMMAND_NAME} eval --dir .
 
-Scaffold a project:
-  ${CLI_COMMAND_NAME} init ./my-agent
-
 Evals:
   Create evals/**/*.eval.ts using defineEval from ${PACKAGE_NAME}/evals
   Case id is the path: evals/weather/nyc.eval.ts → weather/nyc

package/dist/internal/install-cursor-skills.d.ts

@@ -0,0 +1,64 @@
+/**
+ * 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.
+ */
+/** Category folder under ~/.cursor/skills (Cursor discovers nested skills). */
+export declare const CURSOR_SKILLS_NAMESPACE = "agentkit";
+export interface PackageSkill {
+    /** Frontmatter `name` (e.g. agentkit-create-agent). */
+    name: string;
+    /** Leaf install directory under agentkit/ (e.g. create-agent). */
+    leafDir: string;
+    /** Absolute path to the source skill directory in the package. */
+    sourceDir: string;
+}
+export declare function cursorSkillsHome(home?: string): string;
+/** `~/.cursor/skills/agentkit` — where package skills are installed. */
+export declare function agentkitCursorSkillsDir(skillsHome?: string): string;
+/** Absolute install path for one skill: `…/agentkit/<leafDir>`. */
+export declare function skillInstallPath(skill: Pick<PackageSkill, "leafDir">, skillsHome?: string): string;
+/**
+ * Skills shipped next to the running package. Uses the frontmatter `name`
+ * when present, otherwise `agentkit-<dir>`.
+ */
+export declare function listShippedPackageSkills(packageRoot?: string): Promise<PackageSkill[]>;
+/**
+ * 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 declare function findMissingCursorSkills(options?: {
+    packageRoot?: string;
+    skillsHome?: string;
+}): Promise<PackageSkill[]>;
+/**
+ * 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 declare function installCursorSkills(skills: readonly PackageSkill[], skillsHome?: string): Promise<string[]>;
+/** Drop monorepo `paths` globs and fix package doc links for ~/.cursor installs. */
+export declare function prepareSkillMarkdownForCursorInstall(content: string): string;
+export interface OfferInstallCursorSkillsOptions {
+    /** Skip when false (non-TTY / `--json`). */
+    interactive?: boolean;
+    packageRoot?: string;
+    skillsHome?: string;
+    /** Injected yes/no for tests. */
+    confirm?: (question: string) => Promise<boolean>;
+    out?: (text: string) => void;
+}
+/**
+ * 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 declare function offerInstallCursorSkills(options?: OfferInstallCursorSkillsOptions): Promise<{
+    installed: string[];
+    skipped: boolean;
+}>;
+//# sourceMappingURL=install-cursor-skills.d.ts.map

package/dist/internal/install-cursor-skills.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"install-cursor-skills.d.ts","sourceRoot":"","sources":["../../src/internal/install-cursor-skills.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAmBH,+EAA+E;AAC/E,eAAO,MAAM,uBAAuB,aAAa,CAAC;AAElD,MAAM,WAAW,YAAY;IAC3B,uDAAuD;IACvD,IAAI,EAAE,MAAM,CAAC;IACb,kEAAkE;IAClE,OAAO,EAAE,MAAM,CAAC;IAChB,kEAAkE;IAClE,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,wBAAgB,gBAAgB,CAC9B,IAAI,GAAE,MAAsC,GAC3C,MAAM,CAGR;AAED,wEAAwE;AACxE,wBAAgB,uBAAuB,CACrC,UAAU,GAAE,MAA2B,GACtC,MAAM,CAER;AAED,mEAAmE;AACnE,wBAAgB,gBAAgB,CAC9B,KAAK,EAAE,IAAI,CAAC,YAAY,EAAE,SAAS,CAAC,EACpC,UAAU,GAAE,MAA2B,GACtC,MAAM,CAER;AAED;;;GAGG;AACH,wBAAsB,wBAAwB,CAC5C,WAAW,GAAE,MAAyB,GACrC,OAAO,CAAC,YAAY,EAAE,CAAC,CA2BzB;AAED;;;;GAIG;AACH,wBAAsB,uBAAuB,CAAC,OAAO,CAAC,EAAE;IACtD,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC,CAY1B;AAED;;;;GAIG;AACH,wBAAsB,mBAAmB,CACvC,MAAM,EAAE,SAAS,YAAY,EAAE,EAC/B,UAAU,GAAE,MAA2B,GACtC,OAAO,CAAC,MAAM,EAAE,CAAC,CAiCnB;AAED,oFAAoF;AACpF,wBAAgB,oCAAoC,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAY5E;AAoBD,MAAM,WAAW,+BAA+B;IAC9C,4CAA4C;IAC5C,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,iCAAiC;IACjC,OAAO,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;IACjD,GAAG,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;CAC9B;AAED;;;;GAIG;AACH,wBAAsB,wBAAwB,CAC5C,OAAO,GAAE,+BAAoC,GAC5C,OAAO,CAAC;IAAE,SAAS,EAAE,MAAM,EAAE,CAAC;IAAC,OAAO,EAAE,OAAO,CAAA;CAAE,CAAC,CA+CpD"}