@cursor/bdk 0.2.23 → 0.2.25

package/dist/internal/deploy-manifest.d.ts

@@ -29,6 +29,7 @@
  * union for control-plane consumers.
  */
 import { type CatchAuthDeclaration } from "../channels.js";
+import type { SecretAlternatives } from "./secret-alternatives.js";
 import type { AgentProject, AgentProjectInfo } from "../types.js";
 import { type ContinuationIdentity } from "./continuation-identity.js";
 export declare const DEPLOY_MANIFEST_VERSION: 1;
@@ -157,13 +158,19 @@ export declare function channelCatchDeclaration(definition: AgentProject["channe
  */
 export declare function channelCatchSecretNames(definition: AgentProject["channels"][number]["definition"]): string[];
 /**
- * Deployment secrets a channel's API credentials name (today the
- * `githubChannel` `{ secretName }` credentials). Nothing on the control
- * plane reads them — the guest does — but `deploy` folds them into the
+ * Deployment secrets a channel reads in the guest: `githubChannel`
+ * `{ secretName }` credentials and a named `pagerdutyChannel` user id.
+ * Nothing on the control plane reads them, but `deploy` folds them into the
  * declared secret names so an unset one is flagged at deploy time rather
- * than as a failed API call inside the guest.
+ * than as a failed call or a missed check inside the guest.
  */
 export declare function channelCredentialSecretNames(definition: AgentProject["channels"][number]["definition"]): string[];
+/**
+ * Sets of guest-read secrets a channel needs one of, such as
+ * `pagerdutyChannel`'s user id or a token to infer it from. `deploy`
+ * warns about a set only when none of its names is set.
+ */
+export declare function channelSecretAlternatives(definition: AgentProject["channels"][number]["definition"]): SecretAlternatives[];
 /**
  * Parse an untrusted manifest (round-trip check for the CLI's own output;
  * the CP re-validates server-side with its own copy of the contract).

package/dist/internal/deploy-manifest.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"deploy-manifest.d.ts","sourceRoot":"","sources":["../../src/internal/deploy-manifest.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"deploy-manifest.d.ts","sourceRoot":"","sources":["../../src/internal/deploy-manifest.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AAGH,OAAO,EACL,KAAK,oBAAoB,EAG1B,MAAM,gBAAgB,CAAC;AASxB,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AAEnE,OAAO,KAAK,EAAE,YAAY,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAQlE,OAAO,EAA0B,KAAK,oBAAoB,EAAE,MAAM,4BAA4B,CAAC;AAK/F,eAAO,MAAM,uBAAuB,EAAE,CAAK,CAAC;AA2G5C,MAAM,WAAW,+BAA+B;IAC9C,aAAa,EAAE,MAAM,EAAE,CAAC;IACxB,gBAAgB,EAAE,MAAM,EAAE,CAAC;IAC3B,4EAA4E;IAC5E,gBAAgB,CAAC,EAAE,eAAe,GAAG,OAAO,GAAG,MAAM,CAAC;IACtD;;;;OAIG;IACH,YAAY,CAAC,EAAE,IAAI,GAAG,IAAI,CAAC;IAC3B,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,4EAA4E;IAC5E,KAAK,CAAC,EAAE,MAAM,CAAC;IACf;;;;;;;OAOG;IACH,QAAQ,EAAE,KAAK,CAAC;QACd,EAAE,EAAE,MAAM,CAAC;QACX,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;QACtB,YAAY,EAAE,oBAAoB,CAAC;QACnC;;;WAGG;QACH,UAAU,CAAC,EAAE,wCAAwC,CAAC;QACtD;;;;;;WAMG;QACH,iBAAiB,CAAC,EAAE,MAAM,EAAE,CAAC;QAC7B;;;;;WAKG;QACH,KAAK,CAAC,EAAE,mCAAmC,CAAC;KAC7C,CAAC,CAAC;IACH;;;;;OAKG;IACH,SAAS,CAAC,EAAE,sCAAsC,EAAE,CAAC;IACrD;;;;OAIG;IACH,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;CAClB;AAED,MAAM,WAAW,sCAAsC;IACrD,uDAAuD;IACvD,EAAE,EAAE,MAAM,CAAC;IACX,yCAAyC;IACzC,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,UAAU,GAAG,KAAK,CAAC;CAC1B;AAED,MAAM,WAAW,mCAAmC;IAClD,MAAM,EAAE,KAAK,CAAC;QACZ,MAAM,EAAE,KAAK,GAAG,MAAM,GAAG,KAAK,GAAG,OAAO,GAAG,QAAQ,CAAC;QACpD,IAAI,EAAE,MAAM,CAAC;KACd,CAAC,CAAC;IACH,IAAI,EAAE,oBAAoB,EAAE,CAAC;CAC9B;AAED,MAAM,WAAW,wCAAwC;IACvD,IAAI,EAAE,SAAS,CAAC;IAChB,kDAAkD;IAClD,GAAG,EAAE,MAAM,CAAC;IACZ,2CAA2C;IAC3C,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,qBAAqB;IACpC,eAAe,EAAE,CAAC,CAAC;IACnB,6BAA6B;IAC7B,aAAa,EAAE,MAAM,CAAC;IACtB,wDAAwD;IACxD,UAAU,EAAE,MAAM,CAAC;IACnB,4EAA4E;IAC5E,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,+BAA+B,CAAC;IAC9C;;;OAGG;IACH,IAAI,EAAE,gBAAgB,CAAC;CACxB;AAED;;;GAGG;AACH,wBAAgB,wBAAwB,CACtC,OAAO,EAAE,YAAY,EACrB,OAAO,CAAC,EAAE;IAAE,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,CAAA;CAAE,GACpE,qBAAqB,CAuFvB;AAED;;;;;;GAMG;AACH,wBAAgB,uBAAuB,CACrC,UAAU,EAAE,YAAY,CAAC,UAAU,CAAC,CAAC,MAAM,CAAC,CAAC,YAAY,CAAC,GACzD,mCAAmC,GAAG,SAAS,CAoDjD;AAED;;;;;;;GAOG;AACH,wBAAgB,uBAAuB,CACrC,UAAU,EAAE,YAAY,CAAC,UAAU,CAAC,CAAC,MAAM,CAAC,CAAC,YAAY,CAAC,GACzD,MAAM,EAAE,CAUV;AAED;;;;;;GAMG;AACH,wBAAgB,4BAA4B,CAC1C,UAAU,EAAE,YAAY,CAAC,UAAU,CAAC,CAAC,MAAM,CAAC,CAAC,YAAY,CAAC,GACzD,MAAM,EAAE,CAKV;AAED;;;;GAIG;AACH,wBAAgB,yBAAyB,CACvC,UAAU,EAAE,YAAY,CAAC,UAAU,CAAC,CAAC,MAAM,CAAC,CAAC,YAAY,CAAC,GACzD,kBAAkB,EAAE,CAEtB;AAED;;;GAGG;AACH,wBAAgB,wBAAwB,CAAC,GAAG,EAAE,OAAO,GAAG,qBAAqB,GAAG,SAAS,CAKxF"}

package/dist/internal/deploy-manifest.js

@@ -28,9 +28,10 @@
  * Keep that capability per-channel: do not reintroduce a provider-wide event
  * union for control-plane consumers.
  */
-import { z } from "zod";
+import { z } from "zod/v3";
 import { catchAuthDeclaration, isPublicEndpointPolicy, } from "../channels.js";
 import { githubChannelCredentialSecretNames, isCursorAccountGitHubChannel, } from "../channels/github/github-channel.js";
+import { pagerDutyChannelCredentialSecretNames, pagerDutyChannelSecretAlternatives, } from "../channels/pagerduty/pagerduty-channel.js";
 import { isCursorHostedStorage } from "../storage-backends/cursor-hosted.js";
 import { channelArchitectureError } from "./channel-architecture.js";
 import { applyAgentContinuationDefaults, channelContinuationIdentity, channelDeclaredEventTypes, handshakeChannelContinuation, } from "./continuation-channel.js";
@@ -67,6 +68,7 @@ const catchDeclarationSchema = z.object({
             header: z.string().min(1).max(128),
             secret: z.string().min(1).max(64),
             prefix: z.string().max(32).optional(),
+            separator: z.string().min(1).max(8).optional(),
         }),
         z.object({ kind: z.literal("public") }),
     ]))
@@ -286,14 +288,25 @@ export function channelCatchSecretNames(definition) {
     ];
 }
 /**
- * Deployment secrets a channel's API credentials name (today the
- * `githubChannel` `{ secretName }` credentials). Nothing on the control
- * plane reads them — the guest does — but `deploy` folds them into the
+ * Deployment secrets a channel reads in the guest: `githubChannel`
+ * `{ secretName }` credentials and a named `pagerdutyChannel` user id.
+ * Nothing on the control plane reads them, but `deploy` folds them into the
  * declared secret names so an unset one is flagged at deploy time rather
- * than as a failed API call inside the guest.
+ * than as a failed call or a missed check inside the guest.
  */
 export function channelCredentialSecretNames(definition) {
-    return githubChannelCredentialSecretNames(definition);
+    return [
+        ...githubChannelCredentialSecretNames(definition),
+        ...pagerDutyChannelCredentialSecretNames(definition),
+    ];
+}
+/**
+ * Sets of guest-read secrets a channel needs one of, such as
+ * `pagerdutyChannel`'s user id or a token to infer it from. `deploy`
+ * warns about a set only when none of its names is set.
+ */
+export function channelSecretAlternatives(definition) {
+    return pagerDutyChannelSecretAlternatives(definition);
 }
 /**
  * Parse an untrusted manifest (round-trip check for the CLI's own output;

package/dist/internal/discovery/agent-config.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"agent-config.d.ts","sourceRoot":"","sources":["../../../src/internal/discovery/agent-config.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,EACL,KAAK,iBAAiB,EACtB,KAAK,uBAAuB,EAC5B,KAAK,qBAAqB,EAC1B,KAAK,mBAAmB,EACxB,KAAK,YAAY,EACjB,KAAK,mBAAmB,EAExB,KAAK,YAAY,EAClB,MAAM,gBAAgB,CAAC;AAIxB,OAAO,EAAE,KAAK,gBAAgB,EAAwB,MAAM,cAAc,CAAC;AAI3E,wBAAgB,qCAAqC,CAAC,KAAK,EAAE;IAC3D,OAAO,EAAE,YAAY,CAAC;IACtB,YAAY,CAAC,EAAE,iBAAiB,CAAC;CAClC,GAAG,MAAM,GAAG,SAAS,CAIrB;AAED,8EAA8E;AAC9E,eAAO,MAAM,0BAA0B,EAAE,iBAAwB,CAAC;AAElE,wBAAgB,mBAAmB,CACjC,GAAG,EAAE,gBAAgB,EACrB,QAAQ,EAAE,MAAM,EAChB,YAAY,EAAE,iBAAiB,GAAG,SAAS,GAC1C,iBAAiB,GAAG,SAAS,CAa/B;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAC/B,GAAG,EAAE,gBAAgB,EACrB,QAAQ,EAAE,MAAM,EAChB,UAAU,EAAE,OAAO,GAAG,SAAS,EAC/B,YAAY,EAAE,iBAAiB,GAAG,SAAS,GAC1C,IAAI,GAAG,SAAS,CAuBlB;AAED,oEAAoE;AACpE,wBAAgB,eAAe,CAC7B,GAAG,EAAE,gBAAgB,EACrB,QAAQ,EAAE,MAAM,GAAG,SAAS,GAC3B,MAAM,GAAG,SAAS,CASpB;AAED;;;;GAIG;AACH,wBAAsB,eAAe,CACnC,GAAG,EAAE,gBAAgB,EACrB,WAAW,EAAE,MAAM,GAAG,SAAS,EAC/B,oBAAoB,EAAE,MAAM,GAAG,SAAS,GACvC,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAY7B;AAED;;;;;;GAMG;AACH,wBAAgB,cAAc,CAC5B,GAAG,EAAE,gBAAgB,EACrB,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,mBAAmB,GAAG,SAAS,EACxC,UAAU,EAAE,SAAS,mBAAmB,EAAE,GACzC,mBAAmB,GAAG,SAAS,CAsCjC;AAED;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAChC,GAAG,EAAE,gBAAgB,EACrB,QAAQ,EAAE,MAAM,EAChB,WAAW,EAAE,uBAAuB,GAAG,SAAS,GAC/C,uBAAuB,GAAG,SAAS,CAmBrC;AAED,wBAAsB,eAAe,CACnC,GAAG,EAAE,gBAAgB,EACrB,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,OAAO,GACd,OAAO,CAAC,qBAAqB,GAAG,SAAS,CAAC,CA4B5C;AAED,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,YAAY,CAUzE;AAED;;;;GAIG;AACH,wBAAgB,qBAAqB,CACnC,GAAG,EAAE,gBAAgB,EACrB,UAAU,EAAE,MAAM,EAClB,SAAS,EAAE,OAAO,GACjB,SAAS,YAAY,EAAE,GAAG,SAAS,CAcrC;AAED;;;;GAIG;AACH,wBAAgB,0BAA0B,CACxC,GAAG,EAAE,gBAAgB,EACrB,UAAU,EAAE,MAAM,EAClB,mBAAmB,EAAE,OAAO,GAC3B,OAAO,GAAG,SAAS,CAarB"}
+{"version":3,"file":"agent-config.d.ts","sourceRoot":"","sources":["../../../src/internal/discovery/agent-config.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,EACL,KAAK,iBAAiB,EACtB,KAAK,uBAAuB,EAC5B,KAAK,qBAAqB,EAC1B,KAAK,mBAAmB,EACxB,KAAK,YAAY,EACjB,KAAK,mBAAmB,EAExB,KAAK,YAAY,EAClB,MAAM,gBAAgB,CAAC;AAIxB,OAAO,EAAE,KAAK,gBAAgB,EAA8C,MAAM,cAAc,CAAC;AAIjG,wBAAgB,qCAAqC,CAAC,KAAK,EAAE;IAC3D,OAAO,EAAE,YAAY,CAAC;IACtB,YAAY,CAAC,EAAE,iBAAiB,CAAC;CAClC,GAAG,MAAM,GAAG,SAAS,CAIrB;AAED,8EAA8E;AAC9E,eAAO,MAAM,0BAA0B,EAAE,iBAAwB,CAAC;AAElE,wBAAgB,mBAAmB,CACjC,GAAG,EAAE,gBAAgB,EACrB,QAAQ,EAAE,MAAM,EAChB,YAAY,EAAE,iBAAiB,GAAG,SAAS,GAC1C,iBAAiB,GAAG,SAAS,CAa/B;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAC/B,GAAG,EAAE,gBAAgB,EACrB,QAAQ,EAAE,MAAM,EAChB,UAAU,EAAE,OAAO,GAAG,SAAS,EAC/B,YAAY,EAAE,iBAAiB,GAAG,SAAS,GAC1C,IAAI,GAAG,SAAS,CAuBlB;AAED,oEAAoE;AACpE,wBAAgB,eAAe,CAC7B,GAAG,EAAE,gBAAgB,EACrB,QAAQ,EAAE,MAAM,GAAG,SAAS,GAC3B,MAAM,GAAG,SAAS,CASpB;AAED;;;;GAIG;AACH,wBAAsB,eAAe,CACnC,GAAG,EAAE,gBAAgB,EACrB,WAAW,EAAE,MAAM,GAAG,SAAS,EAC/B,oBAAoB,EAAE,MAAM,GAAG,SAAS,GACvC,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAY7B;AAED;;;;;;GAMG;AACH,wBAAgB,cAAc,CAC5B,GAAG,EAAE,gBAAgB,EACrB,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,mBAAmB,GAAG,SAAS,EACxC,UAAU,EAAE,SAAS,mBAAmB,EAAE,GACzC,mBAAmB,GAAG,SAAS,CAsCjC;AAED;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAChC,GAAG,EAAE,gBAAgB,EACrB,QAAQ,EAAE,MAAM,EAChB,WAAW,EAAE,uBAAuB,GAAG,SAAS,GAC/C,uBAAuB,GAAG,SAAS,CAmBrC;AAED,wBAAsB,eAAe,CACnC,GAAG,EAAE,gBAAgB,EACrB,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,OAAO,GACd,OAAO,CAAC,qBAAqB,GAAG,SAAS,CAAC,CA4B5C;AAED,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,YAAY,CAUzE;AAED;;;;GAIG;AACH,wBAAgB,qBAAqB,CACnC,GAAG,EAAE,gBAAgB,EACrB,UAAU,EAAE,MAAM,EAClB,SAAS,EAAE,OAAO,GACjB,SAAS,YAAY,EAAE,GAAG,SAAS,CAcrC;AAED;;;;GAIG;AACH,wBAAgB,0BAA0B,CACxC,GAAG,EAAE,gBAAgB,EACrB,UAAU,EAAE,MAAM,EAClB,mBAAmB,EAAE,OAAO,GAC3B,OAAO,GAAG,SAAS,CAarB"}

package/dist/internal/discovery/agent-config.js

@@ -6,7 +6,7 @@ import { MAX_RUNNING_TURNS_LIMIT, } from "../../types.js";
 import { normalizePositiveInt } from "../bounded-int.js";
 import { hostingEntryErrors, MAX_EGRESS_DOMAINS, validateContainerImageName } from "../hosting.js";
 import { defaultLocalHarnessCwd, isNestedInGitRepo } from "../workspace.js";
-import { displayPath, isBlank } from "./context.js";
+import { displayPath, isBlank, pushConfigDiagnostic } from "./context.js";
 import { findModuleFile } from "./fs.js";
 import { importDefault } from "./modules.js";
 export function runtimeArchitectureCompatibilityError(agent) {
@@ -23,7 +23,7 @@ export function resolveArchitecture(ctx, agentDir, architecture) {
     if (architecture === "v1" || architecture === "v2") {
         return architecture;
     }
-    ctx.diagnostics.push({
+    pushConfigDiagnostic(ctx, {
         severity: "error",
         path: displayPath(ctx, join(agentDir, "agent.ts")),
         message: `architecture must be "v1" or "v2"; got ${JSON.stringify(architecture)}.`,
@@ -40,7 +40,7 @@ export function resolvePersistent(ctx, agentDir, persistent, architecture) {
     }
     const path = displayPath(ctx, join(agentDir, "agent.ts"));
     if (persistent !== true) {
-        ctx.diagnostics.push({
+        pushConfigDiagnostic(ctx, {
             severity: "error",
             path,
             message: `persistent must be true or false; got ${JSON.stringify(persistent)}.`,
@@ -48,7 +48,7 @@ export function resolvePersistent(ctx, agentDir, persistent, architecture) {
         return undefined;
     }
     if (architecture !== "v2") {
-        ctx.diagnostics.push({
+        pushConfigDiagnostic(ctx, {
             severity: "error",
             path,
             message: 'persistent: true requires architecture: "v2"; persistent hosting is a v2 hosting mode.',
@@ -96,7 +96,7 @@ export async function resolveLocalCwd(ctx, authoredCwd, authoredWorkspaceDir) {
 export function resolveHosting(ctx, agentDir, hosting, extensions) {
     const agentPath = displayPath(ctx, join(agentDir, "agent.ts"));
     const warn = (message) => {
-        ctx.diagnostics.push({ severity: "warning", path: agentPath, message });
+        pushConfigDiagnostic(ctx, { severity: "warning", path: agentPath, message });
     };
     for (const error of hostingEntryErrors(hosting ?? {})) {
         warn(`hosting.${error}`);
@@ -147,7 +147,7 @@ export function resolveConcurrency(ctx, agentDir, concurrency) {
         };
     }
     catch (error) {
-        ctx.diagnostics.push({
+        pushConfigDiagnostic(ctx, {
             severity: "error",
             path: displayPath(ctx, join(agentDir, "agent.ts")),
             message: error instanceof Error ? error.message : String(error),
@@ -158,7 +158,7 @@ export function resolveConcurrency(ctx, agentDir, concurrency) {
 export async function loadAgentConfig(ctx, agentDir, isRoot) {
     const configPath = await findModuleFile(agentDir, "agent");
     if (configPath === undefined) {
-        ctx.diagnostics.push({
+        pushConfigDiagnostic(ctx, {
             severity: "error",
             path: displayPath(ctx, join(agentDir, "agent.ts")),
             message: isRoot
@@ -173,7 +173,7 @@ export async function loadAgentConfig(ctx, agentDir, isRoot) {
     }
     const config = definition;
     if (!isRoot && isBlank(config.description)) {
-        ctx.diagnostics.push({
+        pushConfigDiagnostic(ctx, {
             severity: "error",
             path: displayPath(ctx, configPath),
             message: "Subagents require a description; the parent model reads it to decide when to delegate.",
@@ -200,7 +200,7 @@ export function resolveModelFallbacks(ctx, configPath, fallbacks) {
         return undefined;
     }
     if (!Array.isArray(fallbacks) || !fallbacks.every(isValidModelSetting)) {
-        ctx.diagnostics.push({
+        pushConfigDiagnostic(ctx, {
             severity: "error",
             path: displayPath(ctx, configPath),
             message: "fallbacks must be an array of model ids or { id, params } selections, the same shape as model.",
@@ -219,7 +219,7 @@ export function resolveFallbackAfterStream(ctx, configPath, fallbackAfterStream)
         return undefined;
     }
     if (typeof fallbackAfterStream !== "boolean") {
-        ctx.diagnostics.push({
+        pushConfigDiagnostic(ctx, {
             severity: "error",
             path: displayPath(ctx, configPath),
             message: "fallbackAfterStream must be a boolean.",

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

@@ -1 +1 @@
-{"version":3,"file":"agent.d.ts","sourceRoot":"","sources":["../../../src/internal/discovery/agent.ts"],"names":[],"mappings":"AAAA;;GAEG;AASH,OAAO,EAOL,KAAK,aAAa,EACnB,MAAM,gBAAgB,CAAC;AAiBxB,OAAO,EAAE,KAAK,gBAAgB,EAAe,MAAM,cAAc,CAAC;AAClE,OAAO,EAAE,KAAK,sBAAsB,EAAoB,MAAM,iBAAiB,CAAC;AAahF,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAE,aAAa,CAAC;IACrB,YAAY,EAAE,IAAI,CAChB,sBAAsB,EACtB,OAAO,GAAG,UAAU,GAAG,WAAW,GAAG,WAAW,GAAG,WAAW,CAC/D,CAAC;CACH;AAED,wBAAsB,SAAS,CAC7B,GAAG,EAAE,gBAAgB,EACrB,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,OAAO,CAAA;CAAE,GACzC,OAAO,CAAC,eAAe,CAAC,CA+R1B;AAED,wBAAsB,gBAAgB,CAAC,GAAG,EAAE,gBAAgB,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CA0C7F"}
+{"version":3,"file":"agent.d.ts","sourceRoot":"","sources":["../../../src/internal/discovery/agent.ts"],"names":[],"mappings":"AAAA;;GAEG;AASH,OAAO,EAOL,KAAK,aAAa,EACnB,MAAM,gBAAgB,CAAC;AAiBxB,OAAO,EAAE,KAAK,gBAAgB,EAAqC,MAAM,cAAc,CAAC;AACxF,OAAO,EAAE,KAAK,sBAAsB,EAAoB,MAAM,iBAAiB,CAAC;AAahF,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAE,aAAa,CAAC;IACrB,YAAY,EAAE,IAAI,CAChB,sBAAsB,EACtB,OAAO,GAAG,UAAU,GAAG,WAAW,GAAG,WAAW,GAAG,WAAW,CAC/D,CAAC;CACH;AAED,wBAAsB,SAAS,CAC7B,GAAG,EAAE,gBAAgB,EACrB,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,OAAO,CAAA;CAAE,GACzC,OAAO,CAAC,eAAe,CAAC,CA+R1B;AAED,wBAAsB,gBAAgB,CAAC,GAAG,EAAE,gBAAgB,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CA0C7F"}

package/dist/internal/discovery/agent.js

@@ -8,7 +8,7 @@ import { synthesizedFileSystemToolNames } from "../filesystem/tools.js";
 import { withIdentityPreamble } from "../workspace.js";
 import { isValidModelSetting, loadAgentConfig, resolveAgentCwd, resolveArchitecture, resolveConcurrency, resolveFallbackAfterStream, resolveHosting, resolveLocalCwd, resolveModelFallbacks, resolvePersistent, runtimeArchitectureCompatibilityError, } from "./agent-config.js";
 import { loadConnections, loadHostConnections } from "./connections.js";
-import { displayPath } from "./context.js";
+import { displayPath, pushConfigDiagnostic } from "./context.js";
 import { appendExtensions } from "./extensions.js";
 import { sortedEntries } from "./fs.js";
 import { loadInstructions } from "./instructions.js";
@@ -89,14 +89,14 @@ export async function loadAgent(ctx, agentDir, options) {
         if (config?.local?.cwd !== undefined ||
             config?.local?.workspaceDir !== undefined ||
             config?.local?.sandbox === true) {
-            ctx.diagnostics.push({
+            pushConfigDiagnostic(ctx, {
                 severity: "error",
                 path: displayPath(ctx, join(agentDir, "agent.ts")),
                 message: "`root` cannot be combined with `local.cwd`, `local.workspaceDir`, or `local.sandbox`. Those fields configure the host tree the override replaced.",
             });
         }
         if (runtime === "cloud" || runtime === "grokbot") {
-            ctx.diagnostics.push({
+            pushConfigDiagnostic(ctx, {
                 severity: "error",
                 path: displayPath(ctx, join(agentDir, "agent.ts")),
                 message: `\`root\` cannot be combined with runtime: "${runtime}".`,
@@ -104,7 +104,7 @@ export async function loadAgent(ctx, agentDir, options) {
         }
         if (authoredAllowlist?.includes("shell") === true ||
             authoredAllowlist?.includes("Shell") === true) {
-            ctx.diagnostics.push({
+            pushConfigDiagnostic(ctx, {
                 severity: "error",
                 path: displayPath(ctx, join(agentDir, "agent.ts")),
                 message: '`root` cannot be combined with `tools` containing `"shell"`. Shell is not a FileSystem method and must not bind the host shell onto a virtual tree.',
@@ -146,7 +146,7 @@ export async function loadAgent(ctx, agentDir, options) {
             allowedTools = authoredAllowlist;
         }
         catch (error) {
-            ctx.diagnostics.push({
+            pushConfigDiagnostic(ctx, {
                 severity: "error",
                 path: displayPath(ctx, join(agentDir, "agent.ts")),
                 message: error instanceof FileSystemConfigError
@@ -164,7 +164,7 @@ export async function loadAgent(ctx, agentDir, options) {
     // unrestricted. (Hybrid per-send cloud sessions fail closed in the
     // session engine.)
     if (allowedTools !== undefined && runtime !== "local") {
-        ctx.diagnostics.push({
+        pushConfigDiagnostic(ctx, {
             severity: "error",
             path: displayPath(ctx, join(agentDir, "agent.ts")),
             message: `tools cannot be enforced on runtime: "${runtime}". Remove \`tools\` or run the agent on the local runtime.`,
@@ -178,7 +178,7 @@ export async function loadAgent(ctx, agentDir, options) {
     // cloud sessions fail closed in the session engine.)
     const perSessionConnection = connections.find((connection) => connection.advertiseTools === true || connection.auth !== undefined);
     if (perSessionConnection !== undefined && runtime !== "local") {
-        ctx.diagnostics.push({
+        pushConfigDiagnostic(ctx, {
             severity: "error",
             path: displayPath(ctx, join(agentDir, "agent.ts")),
             message: `MCP connection "${perSessionConnection.name}" uses advertiseTools/auth, which only run on runtime: "local". Remove them or run the agent on the local runtime.`,
@@ -190,14 +190,14 @@ export async function loadAgent(ctx, agentDir, options) {
     if (allowedTools !== undefined &&
         !allowedTools.includes("shell") &&
         tools.some((tool) => tool.execution === "agent")) {
-        ctx.diagnostics.push({
+        pushConfigDiagnostic(ctx, {
             severity: "warning",
             path: displayPath(ctx, join(agentDir, "agent.ts")),
             message: '`tools` omits "shell" but this agent has execution: "agent" tools, which run as shell scripts; the model will not be able to run them.',
         });
     }
     if (localCwd !== undefined && localWorkspaceDir !== undefined) {
-        ctx.diagnostics.push({
+        pushConfigDiagnostic(ctx, {
             severity: "warning",
             path: displayPath(ctx, join(agentDir, "agent.ts")),
             message: "local.workspaceDir pins every session to one directory, so local.cwd is unused. Drop one of them.",
@@ -219,7 +219,7 @@ export async function loadAgent(ctx, agentDir, options) {
         architecture,
     });
     if (runtimeArchitectureError !== undefined) {
-        ctx.diagnostics.push({
+        pushConfigDiagnostic(ctx, {
             severity: "error",
             path: displayPath(ctx, join(agentDir, "agent.ts")),
             message: runtimeArchitectureError,

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

@@ -1 +1 @@
-{"version":3,"file":"channels.d.ts","sourceRoot":"","sources":["../../../src/internal/discovery/channels.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,KAAK,EAAqB,iBAAiB,EAAE,qBAAqB,EAAE,MAAM,gBAAgB,CAAC;AAElG,OAAO,EAAE,KAAK,gBAAgB,EAA6B,MAAM,cAAc,CAAC;AAIhF,wBAAsB,YAAY,CAChC,GAAG,EAAE,gBAAgB,EACrB,WAAW,EAAE,MAAM,EACnB,IAAI,GAAE,OAAO,GAAG,WAAqB,EACrC,SAAS,CAAC,EAAE,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,KAAK,IAAI,GAC7C,OAAO,CAAC;IACT,QAAQ,EAAE,iBAAiB,EAAE,CAAC;IAC9B,qBAAqB,EAAE,qBAAqB,GAAG,SAAS,CAAC;CAC1D,CAAC,CAgFD"}
+{"version":3,"file":"channels.d.ts","sourceRoot":"","sources":["../../../src/internal/discovery/channels.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,KAAK,EAAqB,iBAAiB,EAAE,qBAAqB,EAAE,MAAM,gBAAgB,CAAC;AAElG,OAAO,EACL,KAAK,gBAAgB,EAItB,MAAM,cAAc,CAAC;AAItB,wBAAsB,YAAY,CAChC,GAAG,EAAE,gBAAgB,EACrB,WAAW,EAAE,MAAM,EACnB,IAAI,GAAE,OAAO,GAAG,WAAqB,EACrC,SAAS,CAAC,EAAE,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,KAAK,IAAI,GAC7C,OAAO,CAAC;IACT,QAAQ,EAAE,iBAAiB,EAAE,CAAC;IAC9B,qBAAqB,EAAE,qBAAqB,GAAG,SAAS,CAAC;CAC1D,CAAC,CAkFD"}

package/dist/internal/discovery/channels.js

@@ -3,7 +3,7 @@
  */
 import { join } from "node:path";
 import { getDefinitionKind } from "../brand.js";
-import { displayPath, errorMessage } from "./context.js";
+import { displayPath, pushConfigDiagnostic, pushModuleLoadDiagnostic, } from "./context.js";
 import { isDirectory, isModuleFile, moduleStem, sortedEntries } from "./fs.js";
 import { validateName } from "./names.js";
 export async function loadChannels(ctx, channelsDir, mode = "agent", onDisable) {
@@ -26,11 +26,7 @@ export async function loadChannels(ctx, channelsDir, mode = "agent", onDisable)
             mod = await ctx.importModule(entryPath);
         }
         catch (error) {
-            ctx.diagnostics.push({
-                severity: "error",
-                path: displayPath(ctx, entryPath),
-                message: `Failed to load module: ${errorMessage(error)}`,
-            });
+            pushModuleLoadDiagnostic(ctx, entryPath, error);
             continue;
         }
         const kind = getDefinitionKind(mod.default);
@@ -40,7 +36,7 @@ export async function loadChannels(ctx, channelsDir, mode = "agent", onDisable)
         }
         if (kind === "http-channel") {
             if (mode === "extension" || id !== "http") {
-                ctx.diagnostics.push({
+                pushConfigDiagnostic(ctx, {
                     severity: "error",
                     path: displayPath(ctx, entryPath),
                     message: mode === "extension"
@@ -53,17 +49,25 @@ export async function loadChannels(ctx, channelsDir, mode = "agent", onDisable)
             continue;
         }
         if (kind !== "channel") {
-            ctx.diagnostics.push({
-                severity: "error",
-                path: displayPath(ctx, entryPath),
-                message: id === "http" && mode === "agent"
-                    ? "The channel id `http` is reserved for the built-in HTTP session channel."
-                    : "Channel modules must default-export defineChannel({ ... }).",
-            });
+            if (id === "http" && mode === "agent") {
+                pushConfigDiagnostic(ctx, {
+                    severity: "error",
+                    path: displayPath(ctx, entryPath),
+                    message: "The channel id `http` is reserved for the built-in HTTP session channel.",
+                });
+            }
+            else {
+                ctx.diagnostics.push({
+                    severity: "error",
+                    code: "invalid_definition",
+                    path: displayPath(ctx, entryPath),
+                    message: "Channel modules must default-export defineChannel({ ... }).",
+                });
+            }
             continue;
         }
         if (id === "http" && mode === "agent") {
-            ctx.diagnostics.push({
+            pushConfigDiagnostic(ctx, {
                 severity: "error",
                 path: displayPath(ctx, entryPath),
                 message: "The channel id `http` is reserved for the built-in HTTP session channel.",
@@ -72,7 +76,7 @@ export async function loadChannels(ctx, channelsDir, mode = "agent", onDisable)
         }
         const definition = mod.default;
         for (const notice of definition.meta?.deprecations ?? []) {
-            ctx.diagnostics.push({
+            pushConfigDiagnostic(ctx, {
                 severity: "warning",
                 path: displayPath(ctx, entryPath),
                 message: notice,

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

@@ -8,6 +8,22 @@ export interface LoadAgentProjectOptions {
 }
 type ImportModule = (absolutePath: string) => Promise<Record<string, unknown>>;
 export declare function defaultImportModule(absolutePath: string): Promise<Record<string, unknown>>;
+/**
+ * Classify a throw from `defaultImportModule`.
+ * `ERR_MODULE_NOT_FOUND` and `MODULE_NOT_FOUND` come from `error.code`.
+ * The missing specifier is only in the message. Ignore relative and absolute paths.
+ */
+export declare function moduleLoadFailure(error: unknown): {
+    code: "module_not_found" | "module_load_failed";
+    package?: string;
+};
+export declare function missingNpmPackage(message: string): string | undefined;
+export declare function pushModuleLoadDiagnostic(ctx: DiscoveryContext, modulePath: string, error: unknown): void;
+export declare function pushConfigDiagnostic(ctx: DiscoveryContext, diagnostic: {
+    severity: Diagnostic["severity"];
+    path?: string;
+    message: string;
+}): void;
 export interface DiscoveryContext {
     rootDir: string;
     diagnostics: Diagnostic[];

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

@@ -1 +1 @@
-{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../../../src/internal/discovery/context.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAGjD,MAAM,WAAW,uBAAuB;IACtC,sDAAsD;IACtD,YAAY,CAAC,EAAE,CAAC,YAAY,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;CAC3E;AAED,KAAK,YAAY,GAAG,CAAC,YAAY,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;AAE/E,wBAAsB,mBAAmB,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAEhG;AAED,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,UAAU,EAAE,CAAC;IAC1B,YAAY,EAAE,YAAY,CAAC;CAC5B;AAED,wBAAgB,WAAW,CAAC,GAAG,EAAE,gBAAgB,EAAE,YAAY,EAAE,MAAM,GAAG,MAAM,CAG/E;AAED,wBAAgB,YAAY,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAEnD;AAED,wBAAgB,OAAO,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAE/C"}
+{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../../../src/internal/discovery/context.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAGjD,MAAM,WAAW,uBAAuB;IACtC,sDAAsD;IACtD,YAAY,CAAC,EAAE,CAAC,YAAY,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;CAC3E;AAED,KAAK,YAAY,GAAG,CAAC,YAAY,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;AAE/E,wBAAsB,mBAAmB,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAEhG;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,OAAO,GAAG;IACjD,IAAI,EAAE,kBAAkB,GAAG,oBAAoB,CAAC;IAChD,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB,CAUA;AAED,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAUrE;AAgCD,wBAAgB,wBAAwB,CACtC,GAAG,EAAE,gBAAgB,EACrB,UAAU,EAAE,MAAM,EAClB,KAAK,EAAE,OAAO,GACb,IAAI,CASN;AAED,wBAAgB,oBAAoB,CAClC,GAAG,EAAE,gBAAgB,EACrB,UAAU,EAAE;IACV,QAAQ,EAAE,UAAU,CAAC,UAAU,CAAC,CAAC;IACjC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;CACjB,GACA,IAAI,CAEN;AAED,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,UAAU,EAAE,CAAC;IAC1B,YAAY,EAAE,YAAY,CAAC;CAC5B;AAED,wBAAgB,WAAW,CAAC,GAAG,EAAE,gBAAgB,EAAE,YAAY,EAAE,MAAM,GAAG,MAAM,CAG/E;AAED,wBAAgB,YAAY,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAEnD;AAED,wBAAgB,OAAO,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAE/C"}

package/dist/internal/discovery/context.js

@@ -7,6 +7,72 @@ import { toPosix } from "./fs.js";
 export async function defaultImportModule(absolutePath) {
     return (await import(pathToFileURL(absolutePath).href));
 }
+/**
+ * Classify a throw from `defaultImportModule`.
+ * `ERR_MODULE_NOT_FOUND` and `MODULE_NOT_FOUND` come from `error.code`.
+ * The missing specifier is only in the message. Ignore relative and absolute paths.
+ */
+export function moduleLoadFailure(error) {
+    const code = thrownCode(error);
+    if (code !== "ERR_MODULE_NOT_FOUND" && code !== "MODULE_NOT_FOUND") {
+        return { code: "module_load_failed" };
+    }
+    const packageName = missingNpmPackage(errorMessage(error));
+    if (packageName === undefined) {
+        return { code: "module_not_found" };
+    }
+    return { code: "module_not_found", package: packageName };
+}
+export function missingNpmPackage(message) {
+    const namedPackage = /Cannot find package '([^'\n]+)'/.exec(message)?.[1];
+    if (namedPackage !== undefined) {
+        return barePackageName(namedPackage);
+    }
+    const specifier = /Cannot find module '([^'\n]+)'/.exec(message)?.[1];
+    if (specifier === undefined) {
+        return undefined;
+    }
+    return barePackageName(specifier);
+}
+function barePackageName(specifier) {
+    if (specifier.startsWith("./") ||
+        specifier.startsWith("../") ||
+        specifier.startsWith("/") ||
+        specifier.startsWith("\\\\") ||
+        specifier.startsWith("node:") ||
+        specifier.includes("://") ||
+        /^[A-Za-z]:[\\/]/.test(specifier)) {
+        return undefined;
+    }
+    const scoped = /^(@[^/]+\/[^/]+)(?:\/.*)?$/.exec(specifier);
+    if (scoped?.[1] !== undefined) {
+        return scoped[1];
+    }
+    const name = /^([^/]+)/.exec(specifier)?.[1];
+    if (name === undefined || name === "" || name.startsWith(".")) {
+        return undefined;
+    }
+    return name;
+}
+function thrownCode(error) {
+    if (typeof error !== "object" || error === null || !("code" in error)) {
+        return undefined;
+    }
+    return typeof error.code === "string" ? error.code : undefined;
+}
+export function pushModuleLoadDiagnostic(ctx, modulePath, error) {
+    const failure = moduleLoadFailure(error);
+    ctx.diagnostics.push({
+        severity: "error",
+        code: failure.code,
+        path: displayPath(ctx, modulePath),
+        package: failure.package,
+        message: `Failed to load module: ${errorMessage(error)}`,
+    });
+}
+export function pushConfigDiagnostic(ctx, diagnostic) {
+    ctx.diagnostics.push({ ...diagnostic, code: "config_error" });
+}
 export function displayPath(ctx, absolutePath) {
     const rel = relative(ctx.rootDir, absolutePath);
     return rel.startsWith("..") ? absolutePath : toPosix(rel);

package/dist/internal/discovery/cursor-plugin.js

@@ -3,7 +3,7 @@
  */
 import { readFile } from "node:fs/promises";
 import { basename, dirname, extname, isAbsolute, join } from "node:path";
-import { z } from "zod";
+import { z } from "zod/v3";
 import { parseYamlFrontmatter } from "../frontmatter.js";
 import { isRecord } from "../is-record.js";
 import { displayPath, errorMessage, isBlank } from "./context.js";

package/dist/internal/discovery/extension-overlay.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"extension-overlay.d.ts","sourceRoot":"","sources":["../../../src/internal/discovery/extension-overlay.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,KAAK,EACV,mBAAmB,EACnB,iBAAiB,EACjB,cAAc,EACd,kBAAkB,EAClB,eAAe,EACf,aAAa,EACd,MAAM,gBAAgB,CAAC;AAGxB,OAAO,EAAE,KAAK,gBAAgB,EAA6B,MAAM,cAAc,CAAC;AAgBhF,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,MAAM,CAAC;CACZ;AAED,UAAU,WAAW,CAAC,CAAC;IACrB,IAAI,EAAE,MAAM,GAAG,YAAY,CAAC;IAC5B,YAAY,EAAE,eAAe,GAAG,qBAAqB,CAAC;IACtD,aAAa,EAAE,MAAM,CAAC;IACtB,QAAQ,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;IAC9B,OAAO,EAAE,CACP,GAAG,EAAE,gBAAgB,EACrB,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,EACZ,UAAU,EAAE,OAAO,KAChB,OAAO,CAAC,CAAC,GAAG,SAAS,CAAC,GAAG,CAAC,GAAG,SAAS,CAAC;CAC7C;AAED,wBAAsB,WAAW,CAAC,CAAC,SAAS;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,EAC1D,GAAG,EAAE,gBAAgB,EACrB,IAAI,EAAE,WAAW,EACjB,WAAW,EAAE,GAAG,CAAC,MAAM,EAAE,CAAC,CAAC,EAC3B,OAAO,EAAE,KAAK,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC,EAC9C,IAAI,EAAE,WAAW,CAAC,CAAC,CAAC,GACnB,OAAO,CAAC,IAAI,CAAC,CAmBf;AAED,wBAAsB,aAAa,CACjC,GAAG,EAAE,gBAAgB,EACrB,IAAI,EAAE,WAAW,EACjB,WAAW,EAAE,GAAG,CAAC,MAAM,EAAE,eAAe,CAAC,EACzC,GAAG,EAAE,MAAM,GACV,OAAO,CAAC,IAAI,CAAC,CAIf;AAED,wBAAsB,YAAY,CAChC,GAAG,EAAE,gBAAgB,EACrB,IAAI,EAAE,WAAW,EACjB,WAAW,EAAE,GAAG,CAAC,MAAM,EAAE,cAAc,CAAC,EACxC,GAAG,EAAE,MAAM,GACV,OAAO,CAAC,IAAI,CAAC,CAIf;AAED,wBAAsB,gBAAgB,CACpC,GAAG,EAAE,gBAAgB,EACrB,IAAI,EAAE,WAAW,EACjB,WAAW,EAAE,GAAG,CAAC,MAAM,EAAE,kBAAkB,CAAC,EAC5C,GAAG,EAAE,MAAM,GACV,OAAO,CAAC,IAAI,CAAC,CAIf;AAED,wBAAsB,eAAe,CACnC,GAAG,EAAE,gBAAgB,EACrB,IAAI,EAAE,WAAW,EACjB,WAAW,EAAE,GAAG,CAAC,MAAM,EAAE,iBAAiB,CAAC,EAC3C,GAAG,EAAE,MAAM,GACV,OAAO,CAAC,IAAI,CAAC,CAcf;AAED,wBAAsB,gBAAgB,CACpC,GAAG,EAAE,gBAAgB,EACrB,IAAI,EAAE,WAAW,EACjB,WAAW,EAAE,GAAG,CAAC,MAAM,EAAE,aAAa,CAAC,EACvC,GAAG,EAAE,MAAM,GACV,OAAO,CAAC,IAAI,CAAC,CAuBf;AAED,wBAAsB,2BAA2B,CAC/C,GAAG,EAAE,gBAAgB,EACrB,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC,MAAM,GAAG,SAAS,GAAG,MAAM,CAAC,CA4BtC;AAED,wBAAsB,gBAAgB,CACpC,GAAG,EAAE,gBAAgB,EACrB,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,mBAAmB,GAAG,SAAS,GACvC,OAAO,CAAC,mBAAmB,GAAG,SAAS,CAAC,CAa1C"}
+{"version":3,"file":"extension-overlay.d.ts","sourceRoot":"","sources":["../../../src/internal/discovery/extension-overlay.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,KAAK,EACV,mBAAmB,EACnB,iBAAiB,EACjB,cAAc,EACd,kBAAkB,EAClB,eAAe,EACf,aAAa,EACd,MAAM,gBAAgB,CAAC;AAGxB,OAAO,EAAE,KAAK,gBAAgB,EAAyC,MAAM,cAAc,CAAC;AAgB5F,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,MAAM,CAAC;CACZ;AAED,UAAU,WAAW,CAAC,CAAC;IACrB,IAAI,EAAE,MAAM,GAAG,YAAY,CAAC;IAC5B,YAAY,EAAE,eAAe,GAAG,qBAAqB,CAAC;IACtD,aAAa,EAAE,MAAM,CAAC;IACtB,QAAQ,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;IAC9B,OAAO,EAAE,CACP,GAAG,EAAE,gBAAgB,EACrB,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,EACZ,UAAU,EAAE,OAAO,KAChB,OAAO,CAAC,CAAC,GAAG,SAAS,CAAC,GAAG,CAAC,GAAG,SAAS,CAAC;CAC7C;AAED,wBAAsB,WAAW,CAAC,CAAC,SAAS;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,EAC1D,GAAG,EAAE,gBAAgB,EACrB,IAAI,EAAE,WAAW,EACjB,WAAW,EAAE,GAAG,CAAC,MAAM,EAAE,CAAC,CAAC,EAC3B,OAAO,EAAE,KAAK,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC,EAC9C,IAAI,EAAE,WAAW,CAAC,CAAC,CAAC,GACnB,OAAO,CAAC,IAAI,CAAC,CAmBf;AAED,wBAAsB,aAAa,CACjC,GAAG,EAAE,gBAAgB,EACrB,IAAI,EAAE,WAAW,EACjB,WAAW,EAAE,GAAG,CAAC,MAAM,EAAE,eAAe,CAAC,EACzC,GAAG,EAAE,MAAM,GACV,OAAO,CAAC,IAAI,CAAC,CAIf;AAED,wBAAsB,YAAY,CAChC,GAAG,EAAE,gBAAgB,EACrB,IAAI,EAAE,WAAW,EACjB,WAAW,EAAE,GAAG,CAAC,MAAM,EAAE,cAAc,CAAC,EACxC,GAAG,EAAE,MAAM,GACV,OAAO,CAAC,IAAI,CAAC,CAIf;AAED,wBAAsB,gBAAgB,CACpC,GAAG,EAAE,gBAAgB,EACrB,IAAI,EAAE,WAAW,EACjB,WAAW,EAAE,GAAG,CAAC,MAAM,EAAE,kBAAkB,CAAC,EAC5C,GAAG,EAAE,MAAM,GACV,OAAO,CAAC,IAAI,CAAC,CAIf;AAED,wBAAsB,eAAe,CACnC,GAAG,EAAE,gBAAgB,EACrB,IAAI,EAAE,WAAW,EACjB,WAAW,EAAE,GAAG,CAAC,MAAM,EAAE,iBAAiB,CAAC,EAC3C,GAAG,EAAE,MAAM,GACV,OAAO,CAAC,IAAI,CAAC,CAcf;AAED,wBAAsB,gBAAgB,CACpC,GAAG,EAAE,gBAAgB,EACrB,IAAI,EAAE,WAAW,EACjB,WAAW,EAAE,GAAG,CAAC,MAAM,EAAE,aAAa,CAAC,EACvC,GAAG,EAAE,MAAM,GACV,OAAO,CAAC,IAAI,CAAC,CAuBf;AAED,wBAAsB,2BAA2B,CAC/C,GAAG,EAAE,gBAAgB,EACrB,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC,MAAM,GAAG,SAAS,GAAG,MAAM,CAAC,CAwBtC;AAED,wBAAsB,gBAAgB,CACpC,GAAG,EAAE,gBAAgB,EACrB,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,mBAAmB,GAAG,SAAS,GACvC,OAAO,CAAC,mBAAmB,GAAG,SAAS,CAAC,CAa1C"}

package/dist/internal/discovery/extension-overlay.js

@@ -5,7 +5,7 @@
 import { join } from "node:path";
 import { getDefinitionKind } from "../brand.js";
 import { loadChannels } from "./channels.js";
-import { displayPath, errorMessage } from "./context.js";
+import { displayPath, pushModuleLoadDiagnostic } from "./context.js";
 import { findModuleFile, isDirectory, isFile, isModuleFile, moduleStem, sortedEntries, } from "./fs.js";
 import { loadHooks } from "./hooks.js";
 import { loadInstructions } from "./instructions.js";
@@ -96,11 +96,7 @@ export async function overlayInstructionsFragment(ctx, overlayDir) {
             mod = await ctx.importModule(modulePath);
         }
         catch (error) {
-            ctx.diagnostics.push({
-                severity: "error",
-                path: displayPath(ctx, modulePath),
-                message: `Failed to load module: ${errorMessage(error)}`,
-            });
+            pushModuleLoadDiagnostic(ctx, modulePath, error);
             return "keep";
         }
         if (getDefinitionKind(mod.default) === "disabled") {

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

@@ -1 +1 @@
-{"version":3,"file":"info.d.ts","sourceRoot":"","sources":["../../../src/internal/discovery/info.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,EAAE,KAAK,YAAY,EAAE,KAAK,gBAAgB,EAAqB,MAAM,gBAAgB,CAAC;AAK7F,wBAAgB,WAAW,CAAC,OAAO,EAAE,YAAY,GAAG,gBAAgB,CAmKnE"}
+{"version":3,"file":"info.d.ts","sourceRoot":"","sources":["../../../src/internal/discovery/info.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,EAAE,KAAK,YAAY,EAAE,KAAK,gBAAgB,EAAqB,MAAM,gBAAgB,CAAC;AAK7F,wBAAgB,WAAW,CAAC,OAAO,EAAE,YAAY,GAAG,gBAAgB,CAsKnE"}

package/dist/internal/discovery/info.js

@@ -121,6 +121,9 @@ export function projectInfo(project) {
                 if (meta?.bitbucketWebhookEvents !== undefined) {
                     info.bitbucketWebhookEvents = meta.bitbucketWebhookEvents;
                 }
+                if (meta?.pagerdutyWebhookEvents !== undefined) {
+                    info.pagerdutyWebhookEvents = meta.pagerdutyWebhookEvents;
+                }
                 if (meta?.deploymentEventTypes !== undefined) {
                     info.deploymentEventTypes = meta.deploymentEventTypes;
                 }

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

@@ -1 +1 @@
-{"version":3,"file":"instructions.d.ts","sourceRoot":"","sources":["../../../src/internal/discovery/instructions.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH,OAAO,KAAK,EAAE,qBAAqB,EAA0B,MAAM,gBAAgB,CAAC;AAEpF,OAAO,EAAE,KAAK,gBAAgB,EAAsC,MAAM,cAAc,CAAC;AAGzF,wBAAsB,gBAAgB,CACpC,GAAG,EAAE,gBAAgB,EACrB,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,qBAAqB,GAAG,SAAS,EACzC,MAAM,EAAE,OAAO,GACd,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAkD7B"}
+{"version":3,"file":"instructions.d.ts","sourceRoot":"","sources":["../../../src/internal/discovery/instructions.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH,OAAO,KAAK,EAAE,qBAAqB,EAA0B,MAAM,gBAAgB,CAAC;AAEpF,OAAO,EACL,KAAK,gBAAgB,EAItB,MAAM,cAAc,CAAC;AAGtB,wBAAsB,gBAAgB,CACpC,GAAG,EAAE,gBAAgB,EACrB,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,qBAAqB,GAAG,SAAS,EACzC,MAAM,EAAE,OAAO,GACd,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAkD7B"}

package/dist/internal/discovery/instructions.js

@@ -4,7 +4,7 @@
 import { readFile } from "node:fs/promises";
 import { join } from "node:path";
 import { getDefinitionKind } from "../brand.js";
-import { displayPath, errorMessage, isBlank } from "./context.js";
+import { displayPath, isBlank, pushModuleLoadDiagnostic, } from "./context.js";
 import { findModuleFile, isDirectory, isFile, isModuleFile, sortedEntries } from "./fs.js";
 export async function loadInstructions(ctx, agentDir, config, isRoot) {
     const parts = [];
@@ -59,11 +59,7 @@ async function loadInstructionsModule(ctx, modulePath) {
         mod = await ctx.importModule(modulePath);
     }
     catch (error) {
-        ctx.diagnostics.push({
-            severity: "error",
-            path: displayPath(ctx, modulePath),
-            message: `Failed to load module: ${errorMessage(error)}`,
-        });
+        pushModuleLoadDiagnostic(ctx, modulePath, error);
         return undefined;
     }
     const value = mod.default;
@@ -75,6 +71,7 @@ async function loadInstructionsModule(ctx, modulePath) {
     }
     ctx.diagnostics.push({
         severity: "error",
+        code: "invalid_definition",
         path: displayPath(ctx, modulePath),
         message: "Instructions modules must default-export a string or defineInstructions({ markdown }).",
     });

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

@@ -1 +1 @@
-{"version":3,"file":"modules.d.ts","sourceRoot":"","sources":["../../../src/internal/discovery/modules.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAErD,OAAO,EAAE,KAAK,gBAAgB,EAA6B,MAAM,cAAc,CAAC;AAIhF,KAAK,cAAc,GAAG,OAAO,CAAC,cAAc,EAAE,cAAc,GAAG,MAAM,CAAC,CAAC;AAEvE,4EAA4E;AAC5E,wBAAsB,aAAa,CACjC,GAAG,EAAE,gBAAgB,EACrB,GAAG,EAAE,MAAM,EACX,IAAI,EAAE,MAAM,GAAG,YAAY,GAC1B,OAAO,CAAC,KAAK,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC,CAAC,CAwBhD;AAED;;;GAGG;AACH,wBAAsB,aAAa,CACjC,GAAG,EAAE,gBAAgB,EACrB,UAAU,EAAE,MAAM,EAClB,QAAQ,EAAE,cAAc,GAAG,SAAS,cAAc,EAAE,GACnD,OAAO,CAAC,OAAO,CAAC,CA6BlB;AAED,sFAAsF;AACtF,wBAAgB,UAAU,CAAC,IAAI,EAAE,cAAc,GAAG,MAAM,CAGvD"}
+{"version":3,"file":"modules.d.ts","sourceRoot":"","sources":["../../../src/internal/discovery/modules.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAErD,OAAO,EAAE,KAAK,gBAAgB,EAAyC,MAAM,cAAc,CAAC;AAI5F,KAAK,cAAc,GAAG,OAAO,CAAC,cAAc,EAAE,cAAc,GAAG,MAAM,CAAC,CAAC;AAEvE,4EAA4E;AAC5E,wBAAsB,aAAa,CACjC,GAAG,EAAE,gBAAgB,EACrB,GAAG,EAAE,MAAM,EACX,IAAI,EAAE,MAAM,GAAG,YAAY,GAC1B,OAAO,CAAC,KAAK,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC,CAAC,CAwBhD;AAED;;;GAGG;AACH,wBAAsB,aAAa,CACjC,GAAG,EAAE,gBAAgB,EACrB,UAAU,EAAE,MAAM,EAClB,QAAQ,EAAE,cAAc,GAAG,SAAS,cAAc,EAAE,GACnD,OAAO,CAAC,OAAO,CAAC,CA0BlB;AAED,sFAAsF;AACtF,wBAAgB,UAAU,CAAC,IAAI,EAAE,cAAc,GAAG,MAAM,CAGvD"}

package/dist/internal/discovery/modules.js

@@ -3,7 +3,7 @@
  */
 import { join } from "node:path";
 import { getDefinitionKind } from "../brand.js";
-import { displayPath, errorMessage } from "./context.js";
+import { displayPath, pushModuleLoadDiagnostic } from "./context.js";
 import { isDirectory, isModuleFile, moduleStem, sortedEntries } from "./fs.js";
 import { validateName } from "./names.js";
 /** The module files of a slot directory whose filenames are valid names. */
@@ -42,11 +42,7 @@ export async function importDefault(ctx, modulePath, expected) {
         mod = await ctx.importModule(modulePath);
     }
     catch (error) {
-        ctx.diagnostics.push({
-            severity: "error",
-            path: displayPath(ctx, modulePath),
-            message: `Failed to load module: ${errorMessage(error)}`,
-        });
+        pushModuleLoadDiagnostic(ctx, modulePath, error);
         return undefined;
     }
     const kinds = typeof expected === "string" ? [expected] : expected;
@@ -59,6 +55,7 @@ export async function importDefault(ctx, modulePath, expected) {
     const article = /^[aeiou]/.test(expectedKinds) ? "an" : "a";
     ctx.diagnostics.push({
         severity: "error",
+        code: "invalid_definition",
         path: displayPath(ctx, modulePath),
         message: kind === undefined
             ? `Module must default-export ${helpers}.`

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

@@ -48,4 +48,10 @@ export declare function loadAgentProject(dir: string, options?: LoadAgentProject
 /** True when the project has diagnostics that must block serving. */
 export declare function hasErrorDiagnostics(project: AgentProject): boolean;
 export declare function formatDiagnostics(diagnostics: Diagnostic[]): string;
+export declare function formatValidateJson(mounts: ReadonlyArray<{
+    slug: string;
+    project: {
+        diagnostics: readonly Diagnostic[];
+    };
+}>): string;
 //# sourceMappingURL=project.d.ts.map