@cursor/july 0.1.102 → 0.1.104

package/dist/internal/discovery/project.js

@@ -24,16 +24,16 @@ var __rest = (this && this.__rest) || function (s, e) {
 import { basename, join, resolve } from "node:path";
 import { httpChannel } from "../../channels.js";
 import { registerAuthoredModuleLoaders } from "../authored-loaders.js";
-import { applyAgentContinuationDefaults } from "../continuation-channel.js";
+import { applyAgentContinuationDefaults, warnOmittedContinuationDowngrades, } from "../continuation-channel.js";
 import { loadABConfig, loadABs } from "./ab.js";
 import { loadAgent, warnUnknownSlots } from "./agent.js";
 import { loadChannels } from "./channels.js";
-import { defaultImportModule, } from "./context.js";
+import { defaultImportModule, displayPath, } from "./context.js";
 import { hasFlatLayoutMarkers, isDirectory, readPackageName, sortedEntries, } from "./fs.js";
 import { loadHooks } from "./hooks.js";
 import { NAME_PATTERN } from "./names.js";
 import { loadSchedules } from "./schedules.js";
-import { appendArtifactTool, loadArtifacts, loadOtel, loadStorage, } from "./services.js";
+import { appendArtifactTool, loadArtifacts, loadOtel, loadResult, loadStorage, mergeArtifacts, } from "./services.js";
 /**
  * True when `dir` looks like an agent project root: it has a nested `agent/`
  * directory, or flat-layout markers (`agent.ts` / `instructions.md`) directly
@@ -152,11 +152,7 @@ function assertSlug(name, parentDir) {
     return name;
 }
 /** URL path segments reserved by the server; agents cannot use them as slugs. */
-export const RESERVED_SLUGS = new Set([
-    "v1",
-    "playground",
-    "docs",
-]);
+const RESERVED_SLUGS = new Set(["v1", "playground", "docs"]);
 export function loadAgentProject(dir_1) {
     return __awaiter(this, arguments, void 0, function* (dir, options = {}) {
         var _a, _b;
@@ -185,23 +181,59 @@ export function loadAgentProject(dir_1) {
             importModule: (_a = options.importModule) !== null && _a !== void 0 ? _a : defaultImportModule,
         };
         const name = (_b = (yield readPackageName(rootDir))) !== null && _b !== void 0 ? _b : basename(rootDir);
-        const agent = yield loadAgent(ctx, agentDir, {
+        const { agent, projectSlots } = yield loadAgent(ctx, agentDir, {
             name,
             isRoot: true,
         });
         const { channels, httpChannelDefinition } = yield loadChannels(ctx, join(agentDir, "channels"));
+        for (const channel of projectSlots.channels) {
+            if (channel.id === "http" || channels.some((c) => c.id === channel.id)) {
+                ctx.diagnostics.push({
+                    severity: "error",
+                    path: displayPath(ctx, join(agentDir, "extensions")),
+                    message: `Extension channel "${channel.id}" collides with an agent channel.`,
+                });
+                continue;
+            }
+            channels.push(channel);
+        }
         const schedules = yield loadSchedules(ctx, join(agentDir, "schedules"));
+        schedules.push(...projectSlots.schedules);
         const hooks = yield loadHooks(ctx, join(agentDir, "hooks"));
+        hooks.push(...projectSlots.hooks);
         const abs = yield loadABs(ctx, agentDir);
+        for (const experiment of projectSlots.abs) {
+            if (abs.some((existing) => existing.name === experiment.name)) {
+                ctx.diagnostics.push({
+                    severity: "error",
+                    path: displayPath(ctx, join(agentDir, "extensions")),
+                    message: `Extension A/B experiment "${experiment.name}" collides with an agent experiment.`,
+                });
+                continue;
+            }
+            abs.push(experiment);
+        }
         const abConfig = yield loadABConfig(ctx, agentDir);
         const storage = yield loadStorage(ctx, agentDir, agent.architecture);
-        const artifacts = yield loadArtifacts(ctx, agentDir);
+        const artifacts = yield mergeProjectArtifacts(ctx, agentDir, projectSlots.artifacts);
         const otel = yield loadOtel(ctx, agentDir);
+        const result = yield loadResult(ctx, agentDir);
         yield appendArtifactTool(ctx, agentDir, agent, artifacts);
         if (agentDir !== rootDir) {
             yield warnUnknownSlots(ctx, agentDir);
         }
         const resolvedHttpChannel = httpChannelDefinition !== null && httpChannelDefinition !== void 0 ? httpChannelDefinition : httpChannel();
+        warnOmittedContinuationDowngrades({
+            architecture: agent.architecture,
+            channels,
+            warn: (id, message) => {
+                ctx.diagnostics.push({
+                    severity: "warning",
+                    path: displayPath(ctx, join(agentDir, "channels", `${id}.ts`)),
+                    message,
+                });
+            },
+        });
         applyAgentContinuationDefaults({
             agent,
             channels,
@@ -220,11 +252,33 @@ export function loadAgentProject(dir_1) {
             abConfig,
             storage,
             artifacts,
+            result,
             otel,
             diagnostics,
         };
     });
 }
+function mergeProjectArtifacts(ctx, agentDir, extra) {
+    return __awaiter(this, void 0, void 0, function* () {
+        const agent = yield loadArtifacts(ctx, agentDir);
+        if (extra === undefined) {
+            return agent;
+        }
+        const kinds = Object.assign({}, extra.kinds);
+        const agentKinds = agent === null || agent === void 0 ? void 0 : agent.kinds;
+        for (const kind of Object.keys(kinds)) {
+            if (agentKinds !== undefined && kind in agentKinds) {
+                ctx.diagnostics.push({
+                    severity: "error",
+                    path: displayPath(ctx, join(agentDir, "extensions")),
+                    message: `Extension artifact kind "${kind}" collides with an agent kind.`,
+                });
+                delete kinds[kind];
+            }
+        }
+        return mergeArtifacts(agent, Object.assign(Object.assign({}, extra), { kinds }));
+    });
+}
 /** True when the project has diagnostics that must block serving. */
 export function hasErrorDiagnostics(project) {
     return project.diagnostics.some((d) => d.severity === "error");

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

@@ -1 +1 @@
-{"version":3,"file":"runtime.d.ts","sourceRoot":"","sources":["../../../src/internal/discovery/runtime.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAEnD,OAAO,EAAE,KAAK,gBAAgB,EAAe,MAAM,cAAc,CAAC;AAElE;;;;GAIG;AACH,wBAAgB,cAAc,CAC5B,GAAG,EAAE,gBAAgB,EACrB,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,YAAY,GAAG,SAAS,GAChC,YAAY,CAed;AAED;;;;;GAKG;AACH,wBAAgB,8BAA8B,CAC5C,GAAG,EAAE,gBAAgB,EACrB,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE;IACN,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,eAAe,EAAE,OAAO,CAAC;IACzB,eAAe,EAAE,OAAO,CAAC;CAC1B,GACA,IAAI,CA2DN;AAED,wBAAgB,2BAA2B,CACzC,GAAG,EAAE,gBAAgB,EACrB,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE;IACN,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,eAAe,EAAE,OAAO,CAAC;CAC1B,GACA,IAAI,CAkCN"}
+{"version":3,"file":"runtime.d.ts","sourceRoot":"","sources":["../../../src/internal/discovery/runtime.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AACnD,OAAO,EAAE,KAAK,gBAAgB,EAAe,MAAM,cAAc,CAAC;AAElE;;;;GAIG;AACH,wBAAgB,cAAc,CAC5B,GAAG,EAAE,gBAAgB,EACrB,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,YAAY,GAAG,SAAS,GAChC,YAAY,CAed;AAED;;;;;GAKG;AACH,wBAAgB,8BAA8B,CAC5C,GAAG,EAAE,gBAAgB,EACrB,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE;IACN,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,eAAe,EAAE,OAAO,CAAC;IACzB,eAAe,EAAE,OAAO,CAAC;CAC1B,GACA,IAAI,CA2DN;AAED,wBAAgB,2BAA2B,CACzC,GAAG,EAAE,gBAAgB,EACrB,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE;IACN,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,eAAe,EAAE,OAAO,CAAC;CAC1B,GACA,IAAI,CAkCN"}

package/dist/internal/discovery/runtime.js

@@ -2,7 +2,6 @@
  * Runtime resolution and the limitations each runtime imposes on the authored surface.
  */
 import { join } from "node:path";
-import { builtinTools } from "../builtin-tools/index.js";
 import { displayPath } from "./context.js";
 /**
  * Validate the authored runtime. An unrecognized value is an error
@@ -92,7 +91,7 @@ export function warnCloudRuntimeLimitations(ctx, agentDir, counts) {
         ctx.diagnostics.push({
             severity: "warning",
             path: displayPath(ctx, join(agentDir, "sandbox")),
-            message: "sandbox/workspace seed files apply to the local session workspace only; cloud agents use the configured cloud repos.",
+            message: "sandbox/workspace seed files reach cloud agents through the Agent Store, not the checkout: hosted deployments write the deployment store's workspace/ directory; local serve/run with a personal API key writes agent-serve/<agent>/workspace/ on the USER store. The first cloud prompt names the mounted directory. Without a reachable store, cloud turns do not see them.",
         });
     }
 }

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

@@ -3,5 +3,5 @@
  */
 import type { DiscoveredSchedule } from "../../types.js";
 import { type DiscoveryContext } from "./context.js";
-export declare function loadSchedules(ctx: DiscoveryContext, schedulesDir: string): Promise<DiscoveredSchedule[]>;
+export declare function loadSchedules(ctx: DiscoveryContext, schedulesDir: string, onDisable?: (name: string, path: string) => void): Promise<DiscoveredSchedule[]>;
 //# sourceMappingURL=schedules.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"schedules.d.ts","sourceRoot":"","sources":["../../../src/internal/discovery/schedules.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH,OAAO,KAAK,EAAE,kBAAkB,EAAsB,MAAM,gBAAgB,CAAC;AAG7E,OAAO,EAAE,KAAK,gBAAgB,EAAe,MAAM,cAAc,CAAC;AAIlE,wBAAsB,aAAa,CACjC,GAAG,EAAE,gBAAgB,EACrB,YAAY,EAAE,MAAM,GACnB,OAAO,CAAC,kBAAkB,EAAE,CAAC,CA6E/B"}
+{"version":3,"file":"schedules.d.ts","sourceRoot":"","sources":["../../../src/internal/discovery/schedules.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH,OAAO,KAAK,EAAE,kBAAkB,EAAsB,MAAM,gBAAgB,CAAC;AAI7E,OAAO,EAAE,KAAK,gBAAgB,EAAe,MAAM,cAAc,CAAC;AAIlE,wBAAsB,aAAa,CACjC,GAAG,EAAE,gBAAgB,EACrB,YAAY,EAAE,MAAM,EACpB,SAAS,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,KAAK,IAAI,GAC/C,OAAO,CAAC,kBAAkB,EAAE,CAAC,CAqG/B"}

package/dist/internal/discovery/schedules.js

@@ -12,12 +12,13 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
 };
 import { readFile } from "node:fs/promises";
 import { basename, extname, relative } from "node:path";
+import { getDefinitionKind } from "../brand.js";
 import { isValidCron } from "../cron.js";
 import { parseFrontmatter } from "../frontmatter.js";
 import { displayPath } from "./context.js";
 import { isDirectory, isModuleFile, toPosix, walkFiles } from "./fs.js";
 import { importDefault } from "./modules.js";
-export function loadSchedules(ctx, schedulesDir) {
+export function loadSchedules(ctx, schedulesDir, onDisable) {
     return __awaiter(this, void 0, void 0, function* () {
         if (!(yield isDirectory(schedulesDir))) {
             return [];
@@ -27,6 +28,14 @@ export function loadSchedules(ctx, schedulesDir) {
             const rel = toPosix(relative(schedulesDir, filePath));
             if (rel.endsWith(".md")) {
                 const name = rel.slice(0, -".md".length);
+                if (name.includes("__")) {
+                    ctx.diagnostics.push({
+                        severity: "error",
+                        path: displayPath(ctx, filePath),
+                        message: `Schedule name "${name}" may not contain "__"; it is reserved for extension contributions (\`<ns>__<name>\`).`,
+                    });
+                    continue;
+                }
                 const { data, body } = parseFrontmatter(yield readFile(filePath, "utf8"));
                 const cron = data.cron;
                 if (cron === undefined || !isValidCron(cron)) {
@@ -64,10 +73,22 @@ export function loadSchedules(ctx, schedulesDir) {
                 continue;
             }
             const name = rel.slice(0, -extname(rel).length);
-            const definition = yield importDefault(ctx, filePath, "schedule");
+            if (name.includes("__")) {
+                ctx.diagnostics.push({
+                    severity: "error",
+                    path: displayPath(ctx, filePath),
+                    message: `Schedule name "${name}" may not contain "__"; it is reserved for extension contributions (\`<ns>__<name>\`).`,
+                });
+                continue;
+            }
+            const definition = yield importDefault(ctx, filePath, onDisable === undefined ? "schedule" : ["schedule", "disabled"]);
             if (definition === undefined) {
                 continue;
             }
+            if (getDefinitionKind(definition) === "disabled") {
+                onDisable === null || onDisable === void 0 ? void 0 : onDisable(name, filePath);
+                continue;
+            }
             const schedule = definition;
             if ((schedule.markdown === undefined) === (schedule.run === undefined)) {
                 ctx.diagnostics.push({

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

@@ -1,13 +1,17 @@
 /**
- * `agent/storage.ts`, `agent/otel.ts`, `agent/artifacts.ts`: host services the agent configures.
+ * `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 } from "../../types.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

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

@@ -1 +1 @@
-{"version":3,"file":"services.d.ts","sourceRoot":"","sources":["../../../src/internal/discovery/services.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,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,EACd,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;;;;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"}
+{"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

@@ -1,5 +1,6 @@
 /**
- * `agent/storage.ts`, `agent/otel.ts`, `agent/artifacts.ts`: host services the agent configures.
+ * `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); }); }
@@ -11,6 +12,7 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
     });
 };
 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";
@@ -78,6 +80,34 @@ export function loadArtifacts(ctx, agentDir) {
         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

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

@@ -7,10 +7,5 @@ import { type DiscoveryContext } from "./context.js";
 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): Promise<DiscoveredSkill[]>;
-/**
- * Advertise the first non-empty, non-code-fence line of the body, with any
- * leading `#`, `>`, `*`, or `-` markers stripped.
- */
-export declare function deriveSkillDescription(markdown: string): string | undefined;
+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

@@ -1 +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;AAExB,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,GAChB,OAAO,CAAC,eAAe,EAAE,CAAC,CA8C5B;AAoDD;;;GAGG;AACH,wBAAgB,sBAAsB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAiB3E"}
+{"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

@@ -12,6 +12,7 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
 };
 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";
@@ -35,7 +36,7 @@ export function skillFiles(skillDir) {
         return files;
     });
 }
-export function loadSkills(ctx, skillsDir) {
+export function loadSkills(ctx, skillsDir, onDisable) {
     return __awaiter(this, void 0, void 0, function* () {
         if (!(yield isDirectory(skillsDir))) {
             return [];
@@ -72,10 +73,14 @@ export function loadSkills(ctx, skillsDir) {
                 if (!validateName(ctx, "skill", name, entryPath)) {
                     continue;
                 }
-                const definition = yield importDefault(ctx, entryPath, "skill");
+                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));
             }
         }
@@ -131,7 +136,7 @@ function loadPackagedSkill(ctx, skillDir, name) {
  * Advertise the first non-empty, non-code-fence line of the body, with any
  * leading `#`, `>`, `*`, or `-` markers stripped.
  */
-export function deriveSkillDescription(markdown) {
+function deriveSkillDescription(markdown) {
     let inFence = false;
     for (const rawLine of markdown.split(/\r?\n/)) {
         const line = rawLine.trim();

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

@@ -2,6 +2,7 @@
  * 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;
@@ -9,5 +10,7 @@ interface SubagentFields {
     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

@@ -1 +1 @@
-{"version":3,"file":"subagent.d.ts","sourceRoot":"","sources":["../../../src/internal/discovery/subagent.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAGlE,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"}
+{"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

@@ -1,7 +1,22 @@
 /**
  * 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,
@@ -17,3 +32,97 @@ export function subagent(name, fields) {
         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.d.ts

@@ -11,6 +11,5 @@
 export { runtimeArchitectureCompatibilityError } from "./discovery/agent-config.js";
 export type { LoadAgentProjectOptions } from "./discovery/context.js";
 export { projectInfo } from "./discovery/info.js";
-export { type ChildAgentDir, formatDiagnostics, hasErrorDiagnostics, isAgentProjectDir, listChildAgentDirs, loadAgentProject, loadAgentProjects, RESERVED_SLUGS, resolveAgentMounts, } from "./discovery/project.js";
-export { deriveSkillDescription } from "./discovery/skills.js";
+export { type ChildAgentDir, formatDiagnostics, hasErrorDiagnostics, isAgentProjectDir, listChildAgentDirs, loadAgentProject, loadAgentProjects, resolveAgentMounts, } from "./discovery/project.js";
 //# sourceMappingURL=discovery.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"discovery.d.ts","sourceRoot":"","sources":["../../src/internal/discovery.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,qCAAqC,EAAE,MAAM,6BAA6B,CAAC;AACpF,YAAY,EAAE,uBAAuB,EAAE,MAAM,wBAAwB,CAAC;AACtE,OAAO,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAClD,OAAO,EACL,KAAK,aAAa,EAClB,iBAAiB,EACjB,mBAAmB,EACnB,iBAAiB,EACjB,kBAAkB,EAClB,gBAAgB,EAChB,iBAAiB,EACjB,cAAc,EACd,kBAAkB,GACnB,MAAM,wBAAwB,CAAC;AAChC,OAAO,EAAE,sBAAsB,EAAE,MAAM,uBAAuB,CAAC"}
+{"version":3,"file":"discovery.d.ts","sourceRoot":"","sources":["../../src/internal/discovery.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,qCAAqC,EAAE,MAAM,6BAA6B,CAAC;AACpF,YAAY,EAAE,uBAAuB,EAAE,MAAM,wBAAwB,CAAC;AACtE,OAAO,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAClD,OAAO,EACL,KAAK,aAAa,EAClB,iBAAiB,EACjB,mBAAmB,EACnB,iBAAiB,EACjB,kBAAkB,EAClB,gBAAgB,EAChB,iBAAiB,EACjB,kBAAkB,GACnB,MAAM,wBAAwB,CAAC"}

package/dist/internal/discovery.js

@@ -10,5 +10,4 @@
  */
 export { runtimeArchitectureCompatibilityError } from "./discovery/agent-config.js";
 export { projectInfo } from "./discovery/info.js";
-export { formatDiagnostics, hasErrorDiagnostics, isAgentProjectDir, listChildAgentDirs, loadAgentProject, loadAgentProjects, RESERVED_SLUGS, resolveAgentMounts, } from "./discovery/project.js";
-export { deriveSkillDescription } from "./discovery/skills.js";
+export { formatDiagnostics, hasErrorDiagnostics, isAgentProjectDir, listChildAgentDirs, loadAgentProject, loadAgentProjects, resolveAgentMounts, } from "./discovery/project.js";

package/dist/internal/distribution.d.ts

@@ -2,23 +2,12 @@
  * Distribution facts for the running copy of the framework.
  *
  * The package publishes to npm as `@cursor/july` (the pre-launch codename
- * for Agent SDK; bins: `july` for `npx @cursor/july`, `agent-sdk`, the
- * older `agentkit`, and the legacy `agent-serve` alias) but
- * the monorepo keeps its historical `@anysphere/agent-serve` import name
- * working via tsconfig paths (source runs) and the runtime alias hooks
- * (compiled runs). Everything that needs to print a package name, print a
- * CLI command, or locate the package root goes through this module.
+ * for Agent SDK) with one bin, `agent-sdk`. Everything that needs to print
+ * a package name, print a CLI command, locate the package root, or pin
+ * `@cursor/july[/x]` to this copy goes through this module.
  */
 /** Published npm package name (pre-launch codename for Agent SDK). */
 export declare const PACKAGE_NAME = "@cursor/july";
-/** Historical monorepo package name; never published, aliased at runtime. */
-export declare const LEGACY_PACKAGE_NAME = "@anysphere/agent-serve";
-/**
- * Future public package name; aliased with the same direct-to-running-dist
- * semantics as PACKAGE_NAME so the eventual rename keeps authored imports
- * on the CLI's module identity.
- */
-export declare const AGENTKIT_PACKAGE_NAME = "@cursor/agentkit";
 /**
  * Bracketed product tag for stderr / ServeOptions.logger lines
  * (`[agent-sdk] …`, `[agent-sdk/slack] …`).
@@ -26,11 +15,8 @@ export declare const AGENTKIT_PACKAGE_NAME = "@cursor/agentkit";
 export declare const LOG_PRODUCT = "agent-sdk";
 export declare const LOG_PREFIX: string;
 export declare const SLACK_LOG_PREFIX: string;
-/**
- * Command name this CLI was invoked as. Both bins point at the same entry;
- * keep help text and hints copy-pasteable for whichever the user typed.
- */
-export declare const CLI_COMMAND_NAME: string;
+/** The bin name, for help text and copy-pasteable hints. */
+export declare const CLI_COMMAND_NAME = "agent-sdk";
 /**
  * True when this module runs from compiled `dist/` output (a published
  * install, or `node dist/bin/agent-serve.js`). False when running from
@@ -51,8 +37,6 @@ export interface CliVersionInfo {
     name: string;
     /** `package.json` version of this install. */
     version: string;
-    /** Bin the process was invoked as (`agent-sdk` / `agent-serve`). */
-    cli: string;
 }
 export declare function cliVersionInfo(): CliVersionInfo;
 /**
@@ -64,11 +48,10 @@ export declare function formatCliVersion(options?: {
     json?: boolean;
 }): string;
 /**
- * Authoring entry subpaths and their dist-relative output files — the
- * runtime mirror of the package `exports` map (the source of truth;
- * `authored-loaders.test.ts` asserts they stay identical). The alias hooks
- * derive `@anysphere/agent-serve[/x]`, `@cursor/july[/x]`, and
- * `@cursor/agentkit[/x]` direct targets from this list.
+ * `@cursor/july[/subpath]` → `file:` URL of this copy's `import` target,
+ * for every subpath in the package `exports` map. The published manifest
+ * points at `dist/`; Bazel's staged copy points at the in-place `src/`
+ * emit, and the aliases follow whichever the manifest says.
  */
-export declare const AUTHORING_ENTRY_FILES: ReadonlyArray<readonly [subpath: string, file: string]>;
+export declare function frameworkAliases(): Record<string, string>;
 //# sourceMappingURL=distribution.d.ts.map

package/dist/internal/distribution.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"distribution.d.ts","sourceRoot":"","sources":["../../src/internal/distribution.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAMH,sEAAsE;AACtE,eAAO,MAAM,YAAY,iBAAiB,CAAC;AAE3C,6EAA6E;AAC7E,eAAO,MAAM,mBAAmB,2BAA2B,CAAC;AAE5D;;;;GAIG;AACH,eAAO,MAAM,qBAAqB,qBAAqB,CAAC;AAExD;;;GAGG;AACH,eAAO,MAAM,WAAW,cAAc,CAAC;AACvC,eAAO,MAAM,UAAU,EAAE,MAA2B,CAAC;AACrD,eAAO,MAAM,gBAAgB,EAAE,MAAiC,CAAC;AAEjE;;;GAGG;AACH,eAAO,MAAM,gBAAgB,EAAE,MAA+B,CAAC;AAc/D;;;;;GAKG;AACH,wBAAgB,sBAAsB,IAAI,OAAO,CAGhD;AAED;;;GAGG;AACH,wBAAgB,cAAc,IAAI,MAAM,CAEvC;AAED,kEAAkE;AAClE,wBAAgB,cAAc,IAAI,MAAM,CAOvC;AAED,qDAAqD;AACrD,MAAM,WAAW,cAAc;IAC7B,2CAA2C;IAC3C,IAAI,EAAE,MAAM,CAAC;IACb,8CAA8C;IAC9C,OAAO,EAAE,MAAM,CAAC;IAChB,oEAAoE;IACpE,GAAG,EAAE,MAAM,CAAC;CACb;AAED,wBAAgB,cAAc,IAAI,cAAc,CAM/C;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,CAAC,EAAE;IAAE,IAAI,CAAC,EAAE,OAAO,CAAA;CAAE,GAAG,MAAM,CAMrE;AAED;;;;;;GAMG;AACH,eAAO,MAAM,qBAAqB,EAAE,aAAa,CAC/C,SAAS,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,CAgCzC,CAAC"}
+{"version":3,"file":"distribution.d.ts","sourceRoot":"","sources":["../../src/internal/distribution.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAMH,sEAAsE;AACtE,eAAO,MAAM,YAAY,iBAAiB,CAAC;AAE3C;;;GAGG;AACH,eAAO,MAAM,WAAW,cAAc,CAAC;AACvC,eAAO,MAAM,UAAU,EAAE,MAA2B,CAAC;AACrD,eAAO,MAAM,gBAAgB,EAAE,MAAiC,CAAC;AAEjE,4DAA4D;AAC5D,eAAO,MAAM,gBAAgB,cAAc,CAAC;AAE5C;;;;;GAKG;AACH,wBAAgB,sBAAsB,IAAI,OAAO,CAGhD;AAED;;;GAGG;AACH,wBAAgB,cAAc,IAAI,MAAM,CAEvC;AAYD,kEAAkE;AAClE,wBAAgB,cAAc,IAAI,MAAM,CAEvC;AAED,qDAAqD;AACrD,MAAM,WAAW,cAAc;IAC7B,2CAA2C;IAC3C,IAAI,EAAE,MAAM,CAAC;IACb,8CAA8C;IAC9C,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,wBAAgB,cAAc,IAAI,cAAc,CAK/C;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,CAAC,EAAE;IAAE,IAAI,CAAC,EAAE,OAAO,CAAA;CAAE,GAAG,MAAM,CAMrE;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,IAAI,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAYzD"}