@cursor/july 0.1.101 → 0.1.103

package/dist/internal/discovery/seed-files.js

@@ -0,0 +1,41 @@
+/**
+ * `agent/sandbox/workspace/**`: files seeded into each local session workspace.
+ */
+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 { join, relative } from "node:path";
+import { displayPath } from "./context.js";
+import { isDirectory, isFile, toPosix, walkFiles } from "./fs.js";
+export function loadSeedFiles(ctx, agentDir) {
+    return __awaiter(this, void 0, void 0, function* () {
+        const sandboxDir = join(agentDir, "sandbox");
+        for (const candidate of ["sandbox.ts", join("sandbox", "sandbox.ts")]) {
+            if (yield isFile(join(agentDir, candidate))) {
+                ctx.diagnostics.push({
+                    severity: "warning",
+                    path: displayPath(ctx, join(agentDir, candidate)),
+                    message: "Custom sandbox backends are not supported; the agent runs in the session workspace directory. Ignoring.",
+                });
+            }
+        }
+        const workspaceDir = join(sandboxDir, "workspace");
+        if (!(yield isDirectory(workspaceDir))) {
+            return [];
+        }
+        const seedFiles = [];
+        for (const filePath of yield walkFiles(workspaceDir)) {
+            seedFiles.push({
+                relativePath: toPosix(relative(workspaceDir, filePath)),
+                sourcePath: filePath,
+            });
+        }
+        return seedFiles;
+    });
+}

package/dist/internal/discovery/services.d.ts

@@ -0,0 +1,21 @@
+/**
+ * `agent/storage.ts`, `agent/otel.ts`, `agent/artifacts.ts`,
+ * `agent/result.ts`: host services the agent configures.
+ */
+import type { OtelDefinition } from "../../otel.js";
+import type { StorageDefinition } from "../../storage.js";
+import type { AgentArchitecture, ArtifactsDefinition, ResolvedAgent, ResultDefinition } from "../../types.js";
+import { type DiscoveryContext } from "./context.js";
+export declare function loadStorage(ctx: DiscoveryContext, agentDir: string, architecture: AgentArchitecture | undefined): Promise<StorageDefinition | undefined>;
+export declare function loadOtel(ctx: DiscoveryContext, agentDir: string): Promise<OtelDefinition | undefined>;
+export declare function loadArtifacts(ctx: DiscoveryContext, agentDir: string): Promise<ArtifactsDefinition | undefined>;
+export declare function loadResult(ctx: DiscoveryContext, agentDir: string): Promise<ResultDefinition | undefined>;
+/** Merge namespaced extension kinds onto the agent's artifacts registry. */
+export declare function mergeArtifacts(agent: ArtifactsDefinition | undefined, extra: ArtifactsDefinition | undefined): ArtifactsDefinition | undefined;
+/**
+ * Materialize the `tag_artifact` built-in when `defineArtifacts` set
+ * `agentTool: true`. Appended after `loadAgent` because the tool is
+ * generated from the artifacts kinds registry, not `AgentConfig.builtinTools`.
+ */
+export declare function appendArtifactTool(ctx: DiscoveryContext, agentDir: string, agent: ResolvedAgent, artifacts: ArtifactsDefinition | undefined): Promise<void>;
+//# sourceMappingURL=services.d.ts.map

package/dist/internal/discovery/services.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"services.d.ts","sourceRoot":"","sources":["../../../src/internal/discovery/services.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AACpD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAC1D,OAAO,KAAK,EACV,iBAAiB,EACjB,mBAAmB,EACnB,aAAa,EACb,gBAAgB,EACjB,MAAM,gBAAgB,CAAC;AAKxB,OAAO,EAAE,KAAK,gBAAgB,EAAe,MAAM,cAAc,CAAC;AAIlE,wBAAsB,WAAW,CAC/B,GAAG,EAAE,gBAAgB,EACrB,QAAQ,EAAE,MAAM,EAChB,YAAY,EAAE,iBAAiB,GAAG,SAAS,GAC1C,OAAO,CAAC,iBAAiB,GAAG,SAAS,CAAC,CA6BxC;AAED,wBAAsB,QAAQ,CAC5B,GAAG,EAAE,gBAAgB,EACrB,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,cAAc,GAAG,SAAS,CAAC,CAOrC;AAED,wBAAsB,aAAa,CACjC,GAAG,EAAE,gBAAgB,EACrB,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,mBAAmB,GAAG,SAAS,CAAC,CAsB1C;AAED,wBAAsB,UAAU,CAC9B,GAAG,EAAE,gBAAgB,EACrB,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,gBAAgB,GAAG,SAAS,CAAC,CAUvC;AAED,4EAA4E;AAC5E,wBAAgB,cAAc,CAC5B,KAAK,EAAE,mBAAmB,GAAG,SAAS,EACtC,KAAK,EAAE,mBAAmB,GAAG,SAAS,GACrC,mBAAmB,GAAG,SAAS,CAYjC;AAED;;;;GAIG;AACH,wBAAsB,kBAAkB,CACtC,GAAG,EAAE,gBAAgB,EACrB,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,aAAa,EACpB,SAAS,EAAE,mBAAmB,GAAG,SAAS,GACzC,OAAO,CAAC,IAAI,CAAC,CAmBf"}

package/dist/internal/discovery/services.js

@@ -0,0 +1,134 @@
+/**
+ * `agent/storage.ts`, `agent/otel.ts`, `agent/artifacts.ts`,
+ * `agent/result.ts`: host services the agent configures.
+ */
+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 { join } from "node:path";
+import { defineArtifacts } from "../../artifacts.js";
+import { artifactBuiltinTool, TAG_ARTIFACT_TOOL_NAME, } from "../builtin-tools/index.js";
+import { displayPath } from "./context.js";
+import { findModuleFile } from "./fs.js";
+import { importDefault } from "./modules.js";
+export function loadStorage(ctx, agentDir, architecture) {
+    return __awaiter(this, void 0, void 0, function* () {
+        const path = yield findModuleFile(agentDir, "storage");
+        if (path === undefined) {
+            return undefined;
+        }
+        if (architecture === "v2") {
+            // Storage is a hosting-mode decision on v2, made by
+            // framework-storage-selection.ts: the state root when self-hosted,
+            // Cursor-managed storage on Cursor hosting. Fail early (error
+            // diagnostics refuse serve and deploy) rather than silently running
+            // with storage the author believes they configured. Not imported.
+            ctx.diagnostics.push({
+                severity: "error",
+                path: displayPath(ctx, path),
+                message: 'agent/storage.ts is not supported on architecture "v2": the platform selects storage (the local state root when self-hosted; Cursor-managed storage on Cursor hosting). Delete the file.',
+            });
+            return undefined;
+        }
+        // v1 keeps loading the authored sink, with notice: defineStorage is going
+        // away with the v1 control plane.
+        ctx.diagnostics.push({
+            severity: "warning",
+            path: displayPath(ctx, path),
+            message: 'agent/storage.ts (defineStorage) is deprecated and going away: architecture "v2" selects storage automatically (the local state root when self-hosted; Cursor-managed storage on Cursor hosting). Still honored on v1.',
+        });
+        const definition = yield importDefault(ctx, path, "storage");
+        return definition;
+    });
+}
+export function loadOtel(ctx, agentDir) {
+    return __awaiter(this, void 0, void 0, function* () {
+        const path = yield findModuleFile(agentDir, "otel");
+        if (path === undefined) {
+            return undefined;
+        }
+        const definition = yield importDefault(ctx, path, "otel");
+        return definition;
+    });
+}
+export function loadArtifacts(ctx, agentDir) {
+    return __awaiter(this, void 0, void 0, function* () {
+        var _a;
+        const path = yield findModuleFile(agentDir, "artifacts");
+        if (path === undefined) {
+            return undefined;
+        }
+        const imported = yield importDefault(ctx, path, "artifacts");
+        if (imported === undefined) {
+            return undefined;
+        }
+        const definition = imported;
+        if (definition.agentTool === true &&
+            Object.keys((_a = definition.kinds) !== null && _a !== void 0 ? _a : {}).length === 0) {
+            ctx.diagnostics.push({
+                severity: "error",
+                path: displayPath(ctx, path),
+                message: "artifacts.agentTool requires kinds: the tag_artifact tool needs at least one declared kind; its descriptions are the tool prompt.",
+            });
+        }
+        return definition;
+    });
+}
+export function loadResult(ctx, agentDir) {
+    return __awaiter(this, void 0, void 0, function* () {
+        const path = yield findModuleFile(agentDir, "result");
+        if (path === undefined) {
+            return undefined;
+        }
+        const imported = yield importDefault(ctx, path, "result");
+        if (imported === undefined) {
+            return undefined;
+        }
+        return imported;
+    });
+}
+/** Merge namespaced extension kinds onto the agent's artifacts registry. */
+export function mergeArtifacts(agent, extra) {
+    var _a;
+    if (extra === undefined) {
+        return agent;
+    }
+    if (agent === undefined) {
+        return extra;
+    }
+    return defineArtifacts({
+        kinds: Object.assign(Object.assign({}, agent.kinds), extra.kinds),
+        agentTool: agent.agentTool === true || extra.agentTool === true,
+        max: (_a = agent.max) !== null && _a !== void 0 ? _a : extra.max,
+    });
+}
+/**
+ * Materialize the `tag_artifact` built-in when `defineArtifacts` set
+ * `agentTool: true`. Appended after `loadAgent` because the tool is
+ * generated from the artifacts kinds registry, not `AgentConfig.builtinTools`.
+ */
+export function appendArtifactTool(ctx, agentDir, agent, artifacts) {
+    return __awaiter(this, void 0, void 0, function* () {
+        var _a;
+        const tool = artifactBuiltinTool(artifacts);
+        if (tool === undefined) {
+            return;
+        }
+        const artifactsPath = displayPath(ctx, (_a = (yield findModuleFile(agentDir, "artifacts"))) !== null && _a !== void 0 ? _a : join(agentDir, "artifacts.ts"));
+        if (agent.tools.some((t) => t.name === TAG_ARTIFACT_TOOL_NAME)) {
+            ctx.diagnostics.push({
+                severity: "warning",
+                path: artifactsPath,
+                message: `Authored tool "${TAG_ARTIFACT_TOOL_NAME}" shadows the built-in tool of the same name; the authored tool wins.`,
+            });
+            return;
+        }
+        agent.tools.push(tool);
+    });
+}

package/dist/internal/discovery/skills.d.ts

@@ -0,0 +1,11 @@
+/**
+ * `agent/skills/*`: markdown, packaged, and `defineSkill` skills.
+ */
+import type { DiscoveredSkill, SkillFileSource } from "../../types.js";
+import { type DiscoveryContext } from "./context.js";
+/** Declared frontmatter, else the body's first line, else a generic line. */
+export declare function skillDescription(name: string, declared: string | undefined, body: string): string;
+/** A packaged skill's sibling files, keyed by path relative to the skill dir. */
+export declare function skillFiles(skillDir: string): Promise<Record<string, SkillFileSource>>;
+export declare function loadSkills(ctx: DiscoveryContext, skillsDir: string, onDisable?: (name: string, path: string) => void): Promise<DiscoveredSkill[]>;
+//# sourceMappingURL=skills.d.ts.map

package/dist/internal/discovery/skills.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"skills.d.ts","sourceRoot":"","sources":["../../../src/internal/discovery/skills.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH,OAAO,KAAK,EACV,eAAe,EAGf,eAAe,EAChB,MAAM,gBAAgB,CAAC;AAGxB,OAAO,EAAE,KAAK,gBAAgB,EAAwB,MAAM,cAAc,CAAC;AAa3E,6EAA6E;AAC7E,wBAAgB,gBAAgB,CAC9B,IAAI,EAAE,MAAM,EACZ,QAAQ,EAAE,MAAM,GAAG,SAAS,EAC5B,IAAI,EAAE,MAAM,GACX,MAAM,CAMR;AAED,iFAAiF;AACjF,wBAAsB,UAAU,CAC9B,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,eAAe,CAAC,CAAC,CAS1C;AAED,wBAAsB,UAAU,CAC9B,GAAG,EAAE,gBAAgB,EACrB,SAAS,EAAE,MAAM,EACjB,SAAS,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,KAAK,IAAI,GAC/C,OAAO,CAAC,eAAe,EAAE,CAAC,CAsD5B"}

package/dist/internal/discovery/skills.js

@@ -0,0 +1,156 @@
+/**
+ * `agent/skills/*`: markdown, packaged, and `defineSkill` skills.
+ */
+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 { readFile } from "node:fs/promises";
+import { join, relative } from "node:path";
+import { getDefinitionKind } from "../brand.js";
+import { parseFrontmatter } from "../frontmatter.js";
+import { displayPath, isBlank } from "./context.js";
+import { isDirectory, isFile, isModuleFile, moduleStem, sortedEntries, toPosix, walkFiles, } from "./fs.js";
+import { importDefault } from "./modules.js";
+import { validateName } from "./names.js";
+/** Declared frontmatter, else the body's first line, else a generic line. */
+export function skillDescription(name, declared, body) {
+    var _a;
+    return ((_a = declared !== null && declared !== void 0 ? declared : deriveSkillDescription(body)) !== null && _a !== void 0 ? _a : `Instructions for the ${name} skill.`);
+}
+/** A packaged skill's sibling files, keyed by path relative to the skill dir. */
+export function skillFiles(skillDir) {
+    return __awaiter(this, void 0, void 0, function* () {
+        const files = {};
+        for (const filePath of yield walkFiles(skillDir)) {
+            const rel = toPosix(relative(skillDir, filePath));
+            if (rel !== "SKILL.md") {
+                files[rel] = { sourcePath: filePath };
+            }
+        }
+        return files;
+    });
+}
+export function loadSkills(ctx, skillsDir, onDisable) {
+    return __awaiter(this, void 0, void 0, function* () {
+        if (!(yield isDirectory(skillsDir))) {
+            return [];
+        }
+        const skills = [];
+        for (const entry of yield sortedEntries(skillsDir)) {
+            const entryPath = join(skillsDir, entry.name);
+            if (entry.isDirectory()) {
+                const skill = yield loadPackagedSkill(ctx, entryPath, entry.name);
+                if (skill !== undefined) {
+                    skills.push(skill);
+                }
+                continue;
+            }
+            if (!entry.isFile()) {
+                continue;
+            }
+            if (entry.name.endsWith(".md")) {
+                const name = entry.name.slice(0, -".md".length);
+                if (!validateName(ctx, "skill", name, entryPath)) {
+                    continue;
+                }
+                const { data, body } = parseFrontmatter(yield readFile(entryPath, "utf8"));
+                skills.push({
+                    name,
+                    description: skillDescription(name, data.description, body),
+                    markdown: body.trim(),
+                    files: {},
+                });
+                continue;
+            }
+            if (isModuleFile(entry.name)) {
+                const name = moduleStem(entry.name);
+                if (!validateName(ctx, "skill", name, entryPath)) {
+                    continue;
+                }
+                const definition = yield importDefault(ctx, entryPath, onDisable === undefined ? "skill" : ["skill", "disabled"]);
+                if (definition === undefined) {
+                    continue;
+                }
+                if (getDefinitionKind(definition) === "disabled") {
+                    onDisable === null || onDisable === void 0 ? void 0 : onDisable(name, entryPath);
+                    continue;
+                }
+                skills.push(compileSkill(name, definition));
+            }
+        }
+        return skills;
+    });
+}
+/** A skill whose body and sibling files are in memory (`defineSkill`, extensions). */
+function compileSkill(name, skill) {
+    var _a;
+    const files = {};
+    for (const [rel, contents] of Object.entries((_a = skill.files) !== null && _a !== void 0 ? _a : {})) {
+        files[rel] = { contents };
+    }
+    return {
+        name,
+        description: skillDescription(name, skill.description, skill.markdown),
+        markdown: skill.markdown.trim(),
+        files,
+    };
+}
+function loadPackagedSkill(ctx, skillDir, name) {
+    return __awaiter(this, void 0, void 0, function* () {
+        const skillMdPath = join(skillDir, "SKILL.md");
+        if (!(yield isFile(skillMdPath))) {
+            ctx.diagnostics.push({
+                severity: "warning",
+                path: displayPath(ctx, skillDir),
+                message: "Skill directories must contain a SKILL.md; ignoring.",
+            });
+            return undefined;
+        }
+        if (!validateName(ctx, "skill", name, skillDir)) {
+            return undefined;
+        }
+        const { data, body } = parseFrontmatter(yield readFile(skillMdPath, "utf8"));
+        if (data.description === undefined || isBlank(data.description)) {
+            ctx.diagnostics.push({
+                severity: "error",
+                path: displayPath(ctx, skillMdPath),
+                message: "Packaged skills require `description` frontmatter in SKILL.md (there is no filename slug to fall back on).",
+            });
+            return undefined;
+        }
+        return {
+            name,
+            description: data.description,
+            markdown: body.trim(),
+            files: yield skillFiles(skillDir),
+        };
+    });
+}
+/**
+ * Advertise the first non-empty, non-code-fence line of the body, with any
+ * leading `#`, `>`, `*`, or `-` markers stripped.
+ */
+function deriveSkillDescription(markdown) {
+    let inFence = false;
+    for (const rawLine of markdown.split(/\r?\n/)) {
+        const line = rawLine.trim();
+        if (line.startsWith("```")) {
+            inFence = !inFence;
+            continue;
+        }
+        if (inFence || line === "") {
+            continue;
+        }
+        const stripped = line.replace(/^[#>*\s-]+/, "").trim();
+        if (stripped !== "") {
+            return stripped.length > 200 ? `${stripped.slice(0, 197)}...` : stripped;
+        }
+    }
+    return undefined;
+}

package/dist/internal/discovery/subagent.d.ts

@@ -0,0 +1,16 @@
+/**
+ * A subagent as the Cursor harness runs it: description, model, and prompt. Its other slots are inert.
+ */
+import type { ModelSetting, ResolvedAgent } from "../../types.js";
+import { type DiscoveryContext } from "./context.js";
+interface SubagentFields {
+    description?: string;
+    model?: ModelSetting;
+    /** Authored prompt; the identity preamble is prepended. */
+    prompt?: string;
+}
+export declare function subagent(name: string, fields: SubagentFields): ResolvedAgent;
+export declare function loadSubagents(ctx: DiscoveryContext, subagentsDir: string): Promise<ResolvedAgent[]>;
+export declare function loadSubagent(ctx: DiscoveryContext, agentDir: string, name: string): Promise<ResolvedAgent>;
+export {};
+//# sourceMappingURL=subagent.d.ts.map

package/dist/internal/discovery/subagent.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"subagent.d.ts","sourceRoot":"","sources":["../../../src/internal/discovery/subagent.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,KAAK,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAGlE,OAAO,EAAE,KAAK,gBAAgB,EAAe,MAAM,cAAc,CAAC;AAKlE,UAAU,cAAc;IACtB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,KAAK,CAAC,EAAE,YAAY,CAAC;IACrB,2DAA2D;IAC3D,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,wBAAgB,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,cAAc,GAAG,aAAa,CAc5E;AAED,wBAAsB,aAAa,CACjC,GAAG,EAAE,gBAAgB,EACrB,YAAY,EAAE,MAAM,GACnB,OAAO,CAAC,aAAa,EAAE,CAAC,CAgB1B;AAED,wBAAsB,YAAY,CAChC,GAAG,EAAE,gBAAgB,EACrB,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,MAAM,GACX,OAAO,CAAC,aAAa,CAAC,CA+CxB"}

package/dist/internal/discovery/subagent.js

@@ -0,0 +1,128 @@
+/**
+ * A subagent as the Cursor harness runs it: description, model, and prompt. Its other slots are inert.
+ */
+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 { join } from "node:path";
+import { withIdentityPreamble } from "../workspace.js";
+import { loadAgentConfig } from "./agent-config.js";
+import { displayPath } from "./context.js";
+import { findModuleFile, isDirectory, sortedEntries } from "./fs.js";
+import { loadInstructions } from "./instructions.js";
+import { validateName } from "./names.js";
+export function subagent(name, fields) {
+    return {
+        name,
+        description: fields.description,
+        model: fields.model,
+        instructions: withIdentityPreamble(name, fields.prompt),
+        runtime: "local",
+        tools: [],
+        skills: [],
+        connections: [],
+        hostConnections: [],
+        subagents: [],
+        seedFiles: [],
+    };
+}
+export function loadSubagents(ctx, subagentsDir) {
+    return __awaiter(this, void 0, void 0, function* () {
+        if (!(yield isDirectory(subagentsDir))) {
+            return [];
+        }
+        const subagents = [];
+        for (const entry of yield sortedEntries(subagentsDir)) {
+            if (!entry.isDirectory()) {
+                continue;
+            }
+            const subagentDir = join(subagentsDir, entry.name);
+            if (!validateName(ctx, "subagent", entry.name, subagentDir)) {
+                continue;
+            }
+            subagents.push(yield loadSubagent(ctx, subagentDir, entry.name));
+        }
+        return subagents;
+    });
+}
+export function loadSubagent(ctx, agentDir, name) {
+    return __awaiter(this, void 0, void 0, function* () {
+        var _a;
+        const config = yield loadAgentConfig(ctx, agentDir, false);
+        const prompt = yield loadInstructions(ctx, agentDir, config, false);
+        yield warnUnsupportedSubagentSlots(ctx, agentDir);
+        if ((config === null || config === void 0 ? void 0 : config.builtinTools) !== undefined) {
+            ctx.diagnostics.push({
+                severity: "warning",
+                path: displayPath(ctx, join(agentDir, "agent.ts")),
+                message: "builtinTools is not supported on subagents; ignoring.",
+            });
+        }
+        if ((config === null || config === void 0 ? void 0 : config.tools) !== undefined) {
+            ctx.diagnostics.push({
+                severity: "warning",
+                path: displayPath(ctx, join(agentDir, "agent.ts")),
+                message: "tools is not supported on subagents (they keep the harness task-tool toolset); ignoring.",
+            });
+        }
+        if ((config === null || config === void 0 ? void 0 : config.architecture) !== undefined) {
+            ctx.diagnostics.push({
+                severity: "warning",
+                path: displayPath(ctx, join(agentDir, "agent.ts")),
+                message: "architecture is not supported on subagents; ignoring.",
+            });
+        }
+        const artifactsPath = yield findModuleFile(agentDir, "artifacts");
+        if (artifactsPath !== undefined) {
+            ctx.diagnostics.push({
+                severity: "warning",
+                path: displayPath(ctx, artifactsPath),
+                message: "artifacts are not supported on subagents; ignoring.",
+            });
+        }
+        const resultPath = yield findModuleFile(agentDir, "result");
+        if (resultPath !== undefined) {
+            ctx.diagnostics.push({
+                severity: "warning",
+                path: displayPath(ctx, resultPath),
+                message: "result is not supported on subagents; ignoring.",
+            });
+        }
+        return subagent((_a = config === null || config === void 0 ? void 0 : config.name) !== null && _a !== void 0 ? _a : name, {
+            description: config === null || config === void 0 ? void 0 : config.description,
+            model: config === null || config === void 0 ? void 0 : config.model,
+            prompt,
+        });
+    });
+}
+function warnUnsupportedSubagentSlots(ctx, subagentDir) {
+    return __awaiter(this, void 0, void 0, function* () {
+        const unsupported = [
+            ["tools", "tools"],
+            ["skills", "skills"],
+            ["extensions", "extensions"],
+            ["mcp-connections", "MCP connections"],
+            ["host-connections", "host MCP connections"],
+            ["subagents", "nested subagents"],
+            ["channels", "channels"],
+            ["schedules", "schedules"],
+            ["hooks", "hooks"],
+            ["sandbox", "sandbox files"],
+        ];
+        for (const [slot, label] of unsupported) {
+            if (yield isDirectory(join(subagentDir, slot))) {
+                ctx.diagnostics.push({
+                    severity: "warning",
+                    path: displayPath(ctx, join(subagentDir, slot)),
+                    message: `Subagent ${label} are not supported on the Cursor harness yet; the subagent runs with the parent's execution surface. Ignoring.`,
+                });
+            }
+        }
+    });
+}

package/dist/internal/discovery/tools.d.ts

@@ -0,0 +1,18 @@
+/**
+ * `agent/tools/*.ts`: typed tools and the built-in tools appended after them.
+ */
+import type { BuiltinToolsConfig, DiscoveredTool, ToolDefinition } from "../../types.js";
+import { type DiscoveryContext } from "./context.js";
+export declare function loadTools(ctx: DiscoveryContext, toolsDir: string): Promise<DiscoveredTool[]>;
+/**
+ * Validate one tool definition against the tool contract and convert its
+ * schemas. Diagnostics point at `entryPath` (the authored file, or the
+ * extension mount that contributed the tool).
+ */
+export declare function compileTool(ctx: DiscoveryContext, entryPath: string, name: string, tool: ToolDefinition): DiscoveredTool | undefined;
+/**
+ * Append enabled built-in tools after authored tools. Authored tools with
+ * the same name win.
+ */
+export declare function appendBuiltinTools(ctx: DiscoveryContext, agentDir: string, tools: DiscoveredTool[], config: BuiltinToolsConfig | undefined): void;
+//# sourceMappingURL=tools.d.ts.map

package/dist/internal/discovery/tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tools.d.ts","sourceRoot":"","sources":["../../../src/internal/discovery/tools.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,KAAK,EACV,kBAAkB,EAClB,cAAc,EACd,cAAc,EAEf,MAAM,gBAAgB,CAAC;AAGxB,OAAO,EACL,KAAK,gBAAgB,EAItB,MAAM,cAAc,CAAC;AAGtB,wBAAsB,SAAS,CAC7B,GAAG,EAAE,gBAAgB,EACrB,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,cAAc,EAAE,CAAC,CAa3B;AAED;;;;GAIG;AACH,wBAAgB,WAAW,CACzB,GAAG,EAAE,gBAAgB,EACrB,SAAS,EAAE,MAAM,EACjB,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,cAAc,GACnB,cAAc,GAAG,SAAS,CAkF5B;AAmBD;;;GAGG;AACH,wBAAgB,kBAAkB,CAChC,GAAG,EAAE,gBAAgB,EACrB,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,cAAc,EAAE,EACvB,MAAM,EAAE,kBAAkB,GAAG,SAAS,GACrC,IAAI,CAsBN"}