@cursor/july 0.1.42 → 0.1.45

package/dist/internal/init-project.js

@@ -11,11 +11,91 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
     });
 };
 import { spawn } from "node:child_process";
-import { existsSync } from "node:fs";
-import { mkdir, writeFile } from "node:fs/promises";
+import { existsSync, readdirSync, readFileSync } from "node:fs";
+import { mkdir, readdir, readFile, writeFile } from "node:fs/promises";
 import { basename, dirname, join, relative, resolve } from "node:path";
-import { CLI_COMMAND_NAME, PACKAGE_NAME, packageVersion, } from "./distribution.js";
+import { CLI_COMMAND_NAME, PACKAGE_NAME, packageRootDir, packageVersion, } from "./distribution.js";
 import { makePalette, stdoutPalette, } from "./terminal-style.js";
+export function availableTemplates() {
+    const templatesDir = join(packageRootDir(), "templates");
+    try {
+        return readdirSync(templatesDir, { withFileTypes: true })
+            .filter((entry) => entry.isDirectory())
+            .map((entry) => entry.name)
+            .sort();
+    }
+    catch (error) {
+        if (hasErrorCode(error, "ENOENT")) {
+            return [];
+        }
+        throw error;
+    }
+}
+export function resolveTemplate(name) {
+    if (!/^[a-z][a-z0-9-]*$/.test(name)) {
+        return {
+            ok: false,
+            message: "template name must match /^[a-z][a-z0-9-]*$/",
+        };
+    }
+    const available = availableTemplates();
+    if (!available.includes(name)) {
+        const detail = available.length === 0
+            ? "no templates ship with this build"
+            : `available: ${available.join(", ")}`;
+        return {
+            ok: false,
+            message: `unknown template "${name}" (${detail})`,
+        };
+    }
+    return {
+        ok: true,
+        name,
+        dir: join(packageRootDir(), "templates", name),
+    };
+}
+/**
+ * Re-init must keep the mode the project was scaffolded with: template
+ * scaffolds stamp `cursorAgentTemplate` into package.json, and a mismatch
+ * here would silently mix default-scaffold files into a template project
+ * (or the reverse).
+ */
+export function checkInitTarget(rootDir, template) {
+    const pkgPath = join(rootDir, "package.json");
+    if (!existsSync(pkgPath)) {
+        return { ok: true };
+    }
+    let marker;
+    try {
+        const pkg = JSON.parse(readFileSync(pkgPath, "utf8"));
+        marker =
+            typeof pkg.cursorAgentTemplate === "string"
+                ? pkg.cursorAgentTemplate
+                : undefined;
+    }
+    catch (_a) {
+        marker = undefined;
+    }
+    if (marker === template) {
+        return { ok: true };
+    }
+    if (template === undefined) {
+        return {
+            ok: false,
+            message: `${rootDir} was scaffolded from the "${marker}" template; re-run with --template ${marker}`,
+        };
+    }
+    if (marker === undefined) {
+        return {
+            ok: false,
+            message: `${rootDir} already has a package.json without template provenance; re-run init without --template, or scaffold into a fresh directory`,
+        };
+    }
+    return {
+        ok: false,
+        message: `${rootDir} was scaffolded from the "${marker}" template, not "${template}"`,
+    };
+}
 const DEFAULT_MODEL = {
     id: "grok-4.5",
     params: [
@@ -43,10 +123,9 @@ export function initProject(options) {
     return __awaiter(this, void 0, void 0, function* () {
         var _a, _b;
         const rootDir = resolve(options.dir);
-        const name = (_a = options.name) !== null && _a !== void 0 ? _a : basename(rootDir);
+        const projectName = basename(rootDir);
+        const name = (_a = options.name) !== null && _a !== void 0 ? _a : projectName;
         const model = formatModelLiteral((_b = options.model) !== null && _b !== void 0 ? _b : DEFAULT_MODEL);
-        const agentDir = join(rootDir, "agent");
-        yield mkdir(agentDir, { recursive: true });
         const files = [];
         const write = (rel, contents) => __awaiter(this, void 0, void 0, function* () {
             const abs = join(rootDir, rel);
@@ -64,6 +143,42 @@ export function initProject(options) {
                 throw error;
             }
         });
+        if (options.templateDir !== undefined) {
+            const templateDir = options.templateDir;
+            const entries = yield readdir(templateDir, {
+                recursive: true,
+                withFileTypes: true,
+            });
+            const relativePaths = entries
+                .filter((entry) => entry.isFile())
+                .map((entry) => relative(templateDir, join(entry.parentPath, entry.name)))
+                .sort();
+            for (const rel of relativePaths) {
+                const source = join(templateDir, rel);
+                if (rel === "package.json") {
+                    const packageJson = JSON.parse(yield readFile(source, "utf8"));
+                    packageJson.name = projectName;
+                    packageJson.dependencies[PACKAGE_NAME] = `^${packageVersion()}`;
+                    packageJson.cursorAgentTemplate = basename(templateDir);
+                    yield write(rel, `${JSON.stringify(packageJson, null, 2)}\n`);
+                }
+                else {
+                    yield write(rel, yield readFile(source));
+                }
+            }
+            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),
+            };
+        }
+        const agentDir = join(rootDir, "agent");
+        yield mkdir(agentDir, { recursive: true });
         yield write("package.json", `${JSON.stringify({
             name,
             private: true,
@@ -154,10 +269,13 @@ export default memoryHook();
     });
 }
 export function isEexist(error) {
+    return hasErrorCode(error, "EEXIST");
+}
+function hasErrorCode(error, code) {
     return (error !== null &&
         typeof error === "object" &&
         "code" in error &&
-        error.code === "EEXIST");
+        error.code === code);
 }
 /**
  * Install the scaffold's npm dependencies so `dev` / `run` can resolve
@@ -399,20 +517,20 @@ function initNextStepEntries(options) {
     if (cd !== undefined) {
         steps.push({ command: cd });
     }
-    if (!options.cliOnPath) {
-        steps.push({
-            command: 'export PATH="$PWD/node_modules/.bin:$PATH"',
-            note: "use the project-local agent-sdk bin",
-        });
-    }
     if (!options.signedIn) {
+        const login = options.cliOnPath
+            ? `${CLI_COMMAND_NAME} login`
+            : `npx ${PACKAGE_NAME} login`;
         steps.push({
-            command: `${CLI_COMMAND_NAME} login`,
+            command: login,
             note: "connect your Cursor account (powers model turns)",
         });
     }
+    const dev = options.cliOnPath
+        ? `${CLI_COMMAND_NAME} dev`
+        : `npx ${PACKAGE_NAME} dev`;
     steps.push({
-        command: `${CLI_COMMAND_NAME} dev`,
+        command: dev,
         note: "start the local playground",
     });
     return steps;
@@ -432,8 +550,9 @@ export function printInitGuide() {
     process.stdout.write(`${CLI_COMMAND_NAME} — coding agent setup
 
 Scaffold a project, then open the playground:
-  npx ${PACKAGE_NAME} init ./my-agent   # installs deps + puts agent-sdk on PATH
-  cd ./my-agent && ${CLI_COMMAND_NAME} dev
+  npx ${PACKAGE_NAME} init ./my-agent   # installs deps + links agent-sdk onto PATH
+  npx ${PACKAGE_NAME} init ./my-triage --template triage   # start from a template (agent-sdk templates: triage)
+  cd ./my-agent && agent-sdk dev        # or: npx ${PACKAGE_NAME} dev
 
 Recommended loop once the project exists (from the project directory):
   1. Edit agent/ + tools under agent/tools/

package/dist/internal/otel/attrs.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Build OTel attribute maps without conditional spreads. `undefined` values
+ * are dropped (the OTel API rejects them).
+ */
+export type AttrValue = string | number | boolean;
+export declare function attrs(input: Record<string, AttrValue | undefined>): Record<string, AttrValue>;
+//# sourceMappingURL=attrs.d.ts.map

package/dist/internal/otel/attrs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"attrs.d.ts","sourceRoot":"","sources":["../../../src/internal/otel/attrs.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,MAAM,SAAS,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC;AAElD,wBAAgB,KAAK,CACnB,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,GAAG,SAAS,CAAC,GAC3C,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,CAQ3B"}

package/dist/internal/otel/attrs.js

@@ -0,0 +1,13 @@
+/**
+ * Build OTel attribute maps without conditional spreads. `undefined` values
+ * are dropped (the OTel API rejects them).
+ */
+export function attrs(input) {
+    const out = {};
+    for (const [key, value] of Object.entries(input)) {
+        if (value !== undefined) {
+            out[key] = value;
+        }
+    }
+    return out;
+}

package/dist/internal/otel/collector.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Maps the durable session event stream onto OTel traces / metrics / logs.
+ *
+ * Attribute names reuse Cursor enterprise wire keys where they overlap
+ * (`cursor.conversation.id`, `cursor.token.*`, `cursor.tool.*`,
+ * `cursor.cost.usage`, `cursor.model.name`) so Agent SDK traces join org
+ * metrics/logs in the same collector. Agent-SDK-only fields use `agent_sdk.*`.
+ */
+import type { SessionEvent, SessionInfo } from "../../types.js";
+import { type AttrValue } from "./attrs.js";
+import type { OtelRuntime } from "./runtime.js";
+export interface OtelCollector {
+    onEvent(event: SessionEvent, session: SessionInfo): void;
+    close(): void;
+    /** Merge author tags onto the session; paints open spans immediately. */
+    setSessionAttributes(sessionId: string, attributes: Record<string, AttrValue>): void;
+    /** Session tags previously set by {@link setSessionAttributes}. */
+    getSessionAttributes(sessionId: string): Record<string, AttrValue> | undefined;
+}
+export declare function createOtelCollector(runtime: OtelRuntime, agentName: string, log: (line: string) => void): OtelCollector;
+//# sourceMappingURL=collector.d.ts.map

package/dist/internal/otel/collector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"collector.d.ts","sourceRoot":"","sources":["../../../src/internal/otel/collector.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAaH,OAAO,KAAK,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAChE,OAAO,EAAE,KAAK,SAAS,EAAS,MAAM,YAAY,CAAC;AACnD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAIhD,MAAM,WAAW,aAAa;IAC5B,OAAO,CAAC,KAAK,EAAE,YAAY,EAAE,OAAO,EAAE,WAAW,GAAG,IAAI,CAAC;IACzD,KAAK,IAAI,IAAI,CAAC;IACd,yEAAyE;IACzE,oBAAoB,CAClB,SAAS,EAAE,MAAM,EACjB,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,GACpC,IAAI,CAAC;IACR,mEAAmE;IACnE,oBAAoB,CAClB,SAAS,EAAE,MAAM,GAChB,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,GAAG,SAAS,CAAC;CAC1C;AAgBD,wBAAgB,mBAAmB,CACjC,OAAO,EAAE,WAAW,EACpB,SAAS,EAAE,MAAM,EACjB,GAAG,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,GAC1B,aAAa,CAgwBf"}