experimental-ash 0.6.2 → 0.7.0

package/dist/src/cli/commands/info.js

@@ -1,2 +1,2 @@
-import{D as e,b as t,t as n,v as r,y as i}from"../../chunks/paths-D1gMcyWw.js";import{d as a,f as o,g as s}from"../../chunks/types-D9Uv7nU4.js";import{createCliTheme as c,renderCliBanner as l,renderCliSection as u}from"../ui/output.js";async function d(e){let t=await f(e);return{application:n(t?.project.appRoot??e),compiledState:t,messaging:{createSessionRoutePath:o,continueSessionRoutePattern:a,streamRoutePattern:s}}}async function f(n){try{return await i({startPath:n})}catch(n){if(n instanceof r)return n.result;if(n instanceof e||n instanceof t)return null;throw n}}function p(e,t){return`${e} ${t}${e===1?``:`s`}`}function m(e,t){return`${`${e} error${e===1?``:`s`}`}, ${`${t} warning${t===1?``:`s`}`}`}function h(e){switch(e){case`ready`:return`success`;case`failed`:return`danger`;default:return`warning`}}async function g(e,t){let n=await d(t),r=n.compiledState,i=n.application,a=c(),o=[{label:`App Root`,value:i.appRoot}],s=[{label:`Workflow Build`,value:i.workflowBuildDir},{label:`Output`,value:i.outputDir}],f=[];r===null?o.push({label:`Compile`,tone:`warning`,value:`unavailable`}):(o.push({label:`Agent Root`,value:r.project.agentRoot},{label:`Layout`,value:r.project.layout},{label:`Compile`,tone:h(r.metadata.status),value:r.metadata.status},{label:`Diagnostics`,tone:r.metadata.discovery.summary.errors>0?`danger`:r.metadata.discovery.summary.warnings>0?`warning`:`success`,value:m(r.metadata.discovery.summary.errors,r.metadata.discovery.summary.warnings)},{label:`System Prompt`,value:r.manifest.system?.logicalPath??`none`},{label:`Skills`,value:p(r.manifest.skills.length,`skill`)}),s.unshift({label:`Compiled Manifest`,value:r.paths.compiledManifestPath},{label:`Discovery Manifest`,value:r.paths.discoveryManifestPath},{label:`Diagnostics`,value:r.paths.diagnosticsPath},{label:`Module Map`,value:r.paths.moduleMapPath},{label:`Metadata`,value:r.paths.compileMetadataPath}),f.push(r.manifest.system===void 0?{label:`System`,value:`No system prompt discovered.`}:{label:`System`,value:r.manifest.system.logicalPath})),e.log([l(a,{subtitle:`Resolved application paths and the active message contract.`,title:`Ash Info`}),``,u(a,{rows:o,title:`Application`}),``,u(a,{rows:s,title:`Artifacts`}),...r===null?[]:[``,u(a,{rows:f,title:`System`})],``,u(a,{rows:[{label:`Workflow ID`,value:i.workflowId},{label:`Source Dir`,value:i.workflowSourceDir},{label:`Create`,tone:`info`,value:`POST ${n.messaging.createSessionRoutePath}`},{label:`Continue`,tone:`info`,value:`POST ${n.messaging.continueSessionRoutePattern}`},{label:`Stream`,tone:`info`,value:`GET ${n.messaging.streamRoutePattern}`}],title:`Messaging`})].join(`
+import{D as e,b as t,t as n,v as r,y as i}from"../../chunks/paths-BiY7uVwD.js";import{d as a,f as o,g as s}from"../../chunks/types-D9Uv7nU4.js";import{createCliTheme as c,renderCliBanner as l,renderCliSection as u}from"../ui/output.js";async function d(e){let t=await f(e);return{application:n(t?.project.appRoot??e),compiledState:t,messaging:{createSessionRoutePath:o,continueSessionRoutePattern:a,streamRoutePattern:s}}}async function f(n){try{return await i({startPath:n})}catch(n){if(n instanceof r)return n.result;if(n instanceof e||n instanceof t)return null;throw n}}function p(e,t){return`${e} ${t}${e===1?``:`s`}`}function m(e,t){return`${`${e} error${e===1?``:`s`}`}, ${`${t} warning${t===1?``:`s`}`}`}function h(e){switch(e){case`ready`:return`success`;case`failed`:return`danger`;default:return`warning`}}async function g(e,t){let n=await d(t),r=n.compiledState,i=n.application,a=c(),o=[{label:`App Root`,value:i.appRoot}],s=[{label:`Workflow Build`,value:i.workflowBuildDir},{label:`Output`,value:i.outputDir}],f=[];r===null?o.push({label:`Compile`,tone:`warning`,value:`unavailable`}):(o.push({label:`Agent Root`,value:r.project.agentRoot},{label:`Layout`,value:r.project.layout},{label:`Compile`,tone:h(r.metadata.status),value:r.metadata.status},{label:`Diagnostics`,tone:r.metadata.discovery.summary.errors>0?`danger`:r.metadata.discovery.summary.warnings>0?`warning`:`success`,value:m(r.metadata.discovery.summary.errors,r.metadata.discovery.summary.warnings)},{label:`Instructions`,value:r.manifest.instructions?.logicalPath??`none`},{label:`Skills`,value:p(r.manifest.skills.length,`skill`)}),s.unshift({label:`Compiled Manifest`,value:r.paths.compiledManifestPath},{label:`Discovery Manifest`,value:r.paths.discoveryManifestPath},{label:`Diagnostics`,value:r.paths.diagnosticsPath},{label:`Module Map`,value:r.paths.moduleMapPath},{label:`Metadata`,value:r.paths.compileMetadataPath}),f.push(r.manifest.instructions===void 0?{label:`Instructions`,value:`No instructions prompt discovered.`}:{label:`Instructions`,value:r.manifest.instructions.logicalPath})),e.log([l(a,{subtitle:`Resolved application paths and the active message contract.`,title:`Ash Info`}),``,u(a,{rows:o,title:`Application`}),``,u(a,{rows:s,title:`Artifacts`}),...r===null?[]:[``,u(a,{rows:f,title:`Instructions`})],``,u(a,{rows:[{label:`Workflow ID`,value:i.workflowId},{label:`Source Dir`,value:i.workflowSourceDir},{label:`Create`,tone:`info`,value:`POST ${n.messaging.createSessionRoutePath}`},{label:`Continue`,tone:`info`,value:`POST ${n.messaging.continueSessionRoutePattern}`},{label:`Stream`,tone:`info`,value:`GET ${n.messaging.streamRoutePattern}`}],title:`Messaging`})].join(`
 `))}export{g as printApplicationInfo};

package/dist/src/cli/run.js

@@ -1,3 +1,3 @@
-import{t as e}from"../chunks/package-DmsQgn4v.js";import{createCliTheme as t,renderCliTaggedLine as n}from"./ui/output.js";import{i as r,n as i,r as a,t as o}from"../chunks/url-BVRhVE2O.js";import{resolve as s}from"node:path";async function c(){return(await import(`../chunks/host-CDvE1sV_.js`).then(e=>e.t)).buildHost}async function l(){return(await import(`./commands/init.js`)).initializeApplication}async function u(){return(await import(`./commands/info.js`)).printApplicationInfo}async function d(){return(await import(`./dev/repl.js`)).runDevelopmentRepl}async function f(){return(await import(`../evals/cli/eval.js`)).runEvalCommand}async function p(){return(await import(`../chunks/host-CDvE1sV_.js`).then(e=>e.t)).startHost}function m(e=process.cwd()){return s(e)}function h(e){return`Ash (v${e})`}function g(e){return e.name()===`info`||e.name()===`dev`}async function _(e){await new Promise((t,n)=>{let r=!1,i=()=>{process.off(`SIGINT`,a),process.off(`SIGTERM`,a)},a=()=>{r||(r=!0,i(),e.close().then(t,n))};process.once(`SIGINT`,a),process.once(`SIGTERM`,a)})}function v(e){if(!/^-?\d+$/.test(e))throw new r(`Expected a numeric port, received "${e}".`);let t=Number(e);if(!Number.isInteger(t))throw new r(`Expected a numeric port, received "${e}".`);if(t<0||t>65535)throw new r(`Expected a port between 0 and 65535, received "${e}".`);return t}function y(){return!!(process.stdin.isTTY&&process.stdout.isTTY)}function b(e){let t=e[1];return e[0]!==`dev`||e.length!==2||t===void 0||t.startsWith(`-`)?[...e]:[`dev`,`--url`,t]}function x(e){if(e.url){if(e.host!==void 0)throw new r(`The --host option cannot be used with --url.`);if(e.port!==void 0)throw new r(`The --port option cannot be used with --url.`);if(e.repl===!1)throw new r(`The --no-repl option cannot be used with --url.`);return e.url}}function S(r,a){let s=m(),b=e().version,S=new i,C=t();return S.name(`ash`).description(`Build and run an Ash application.`).version(b).showHelpAfterError().exitOverride().hook(`preAction`,(e,t)=>{g(t)&&r.log(h(b))}).configureOutput({writeErr:e=>{r.error(e.trimEnd())},writeOut:e=>{r.log(e.trimEnd())}}),S.command(`build`).description(`Build the current Ash application.`).action(async()=>{let e=await(a.buildHost??await c())(s);r.log(n(C,{message:`built output at ${e}`,tag:`build`,tone:`success`}))}),S.command(`init`).description(`Scaffold a new Ash application.`).argument(`<name>`,`Directory name for the new Ash application`).action(async e=>{await(a.initializeApplication??await l())({logger:r,parentDirectoryPath:s,targetName:e})}),S.command(`dev`).description(`Start the Ash development server or connect the REPL to an existing URL.`).option(`--host <host>`,`Host interface to bind`).option(`--no-repl`,`Start the server without the interactive REPL`).option(`--port <port>`,`Port to listen on (defaults to $PORT, then 3000)`,v).option(`--schedules`,`Run scheduled tasks during development (off by default)`).option(`-u, --url <url>`,`Connect the REPL to an existing server URL`,o).addHelpText(`after`,`
+import{t as e}from"../chunks/package-DmsQgn4v.js";import{createCliTheme as t,renderCliTaggedLine as n}from"./ui/output.js";import{i as r,n as i,r as a,t as o}from"../chunks/url-BVRhVE2O.js";import{resolve as s}from"node:path";async function c(){return(await import(`../chunks/host-Ca8xvEQ1.js`).then(e=>e.t)).buildHost}async function l(){return(await import(`./commands/init.js`)).initializeApplication}async function u(){return(await import(`./commands/info.js`)).printApplicationInfo}async function d(){return(await import(`./dev/repl.js`)).runDevelopmentRepl}async function f(){return(await import(`../evals/cli/eval.js`)).runEvalCommand}async function p(){return(await import(`../chunks/host-Ca8xvEQ1.js`).then(e=>e.t)).startHost}function m(e=process.cwd()){return s(e)}function h(e){return`Ash (v${e})`}function g(e){return e.name()===`info`||e.name()===`dev`}async function _(e){await new Promise((t,n)=>{let r=!1,i=()=>{process.off(`SIGINT`,a),process.off(`SIGTERM`,a)},a=()=>{r||(r=!0,i(),e.close().then(t,n))};process.once(`SIGINT`,a),process.once(`SIGTERM`,a)})}function v(e){if(!/^-?\d+$/.test(e))throw new r(`Expected a numeric port, received "${e}".`);let t=Number(e);if(!Number.isInteger(t))throw new r(`Expected a numeric port, received "${e}".`);if(t<0||t>65535)throw new r(`Expected a port between 0 and 65535, received "${e}".`);return t}function y(){return!!(process.stdin.isTTY&&process.stdout.isTTY)}function b(e){let t=e[1];return e[0]!==`dev`||e.length!==2||t===void 0||t.startsWith(`-`)?[...e]:[`dev`,`--url`,t]}function x(e){if(e.url){if(e.host!==void 0)throw new r(`The --host option cannot be used with --url.`);if(e.port!==void 0)throw new r(`The --port option cannot be used with --url.`);if(e.repl===!1)throw new r(`The --no-repl option cannot be used with --url.`);return e.url}}function S(r,a){let s=m(),b=e().version,S=new i,C=t();return S.name(`ash`).description(`Build and run an Ash application.`).version(b).showHelpAfterError().exitOverride().hook(`preAction`,(e,t)=>{g(t)&&r.log(h(b))}).configureOutput({writeErr:e=>{r.error(e.trimEnd())},writeOut:e=>{r.log(e.trimEnd())}}),S.command(`build`).description(`Build the current Ash application.`).action(async()=>{let e=await(a.buildHost??await c())(s);r.log(n(C,{message:`built output at ${e}`,tag:`build`,tone:`success`}))}),S.command(`init`).description(`Scaffold a new Ash application.`).argument(`<name>`,`Directory name for the new Ash application`).action(async e=>{await(a.initializeApplication??await l())({logger:r,parentDirectoryPath:s,targetName:e})}),S.command(`dev`).description(`Start the Ash development server or connect the REPL to an existing URL.`).option(`--host <host>`,`Host interface to bind`).option(`--no-repl`,`Start the server without the interactive REPL`).option(`--port <port>`,`Port to listen on (defaults to $PORT, then 3000)`,v).option(`--schedules`,`Run scheduled tasks during development (off by default)`).option(`-u, --url <url>`,`Connect the REPL to an existing server URL`,o).addHelpText(`after`,`
 You can also pass a bare URL as the only argument, for example: ash dev https://example.com
 `).action(async e=>{let t=x(e),{loadDevelopmentEnvironmentFiles:i}=await import(`./dev/environment.js`);if(i(s),t){if(r.log(n(C,{message:`REPL connecting to ${t}`,tag:`dev`,tone:`info`})),!y()){r.log(n(C,{message:`Interactive REPL disabled because the current terminal is not a TTY.`,tag:`dev`,tone:`warning`}));return}r.log(``),await(a.runDevelopmentRepl??await d())({serverUrl:t});return}let o=await(a.startHost??await p())(s,{host:e.host,port:e.port,schedules:e.schedules===!0}),c=!1,l=async()=>{c||(c=!0,await o.close())};try{if(r.log(n(C,{message:`server listening at ${o.url}`,tag:`dev`,tone:`success`})),e.repl===!1)return await _({close:l});if(!y())return r.log(n(C,{message:`Interactive REPL disabled because the current terminal is not a TTY.`,tag:`dev`,tone:`warning`})),await _({close:l});r.log(``),await(a.runDevelopmentRepl??await d())({serverUrl:o.url})}finally{await l()}}),S.command(`info`).description(`Print resolved application information.`).action(async()=>{await(a.printApplicationInfo??await u())(r,s)}),S.command(`eval`).description(`Run eval suites against an Ash agent.`).option(`--suite <id...>`,`Suite IDs to run (repeatable)`).option(`--all`,`Run all discovered suites`).option(`--url <url>`,`Remote agent URL (skip local host startup)`).option(`--timeout <ms>`,`Per-case timeout in milliseconds`).option(`--max-concurrency <n>`,`Max concurrent case executions per suite`).option(`--json`,`Output results as JSON`).option(`--list-suites`,`List discovered suites and exit`).option(`--skip-report`,`Skip suite-defined reporters (e.g. Braintrust)`).action(async e=>{await(a.runEvalCommand??await f())(e,r)}),S}async function C(e=process.argv.slice(2),t=console,n={}){let r=S(t,n),i=e.length===0?[`info`]:b(e);try{await r.parseAsync(i,{from:`user`})}catch(e){if(e instanceof a){if(e.exitCode===0)return;throw Error(e.message)}throw e}}export{C as runCli};

package/dist/src/compiler/compile-agent.js

@@ -41,8 +41,18 @@ export async function compileAgent(input = {}) {
     if (hasDiscoverErrors(discoveryResult.diagnostics)) {
         throw new CompileAgentError(result);
     }
+    reportDiscoverWarnings(discoveryResult.diagnostics);
     return result;
 }
+function reportDiscoverWarnings(diagnostics) {
+    const warnings = diagnostics.filter((diagnostic) => diagnostic.severity === "warning");
+    if (warnings.length === 0) {
+        return;
+    }
+    for (const warning of warnings) {
+        console.warn(`Warning [${warning.code}]: ${warning.message}\n  source: ${warning.sourcePath}`);
+    }
+}
 function formatCompileAgentErrorMessage(input) {
     const summary = summarizeDiscoverDiagnostics(input.diagnostics);
     const lines = [

package/dist/src/compiler/manifest.d.ts

@@ -62,9 +62,10 @@ export type CompiledAgentCompactionDefinition = InternalAgentCompactionDefinitio
  */
 export type CompiledAgentDefinition = InternalAgentDefinition;
 /**
- * Normalized authored system prompt preserved in the compiled manifest.
+ * Normalized authored instructions prompt preserved in the compiled
+ * manifest.
  */
-export type CompiledSystem = z.infer<typeof compiledSystemSchema>;
+export type CompiledInstructions = z.infer<typeof compiledInstructionsSchema>;
 /**
  * Normalized authored skill preserved in the compiled manifest.
  */
@@ -144,7 +145,7 @@ export interface CompiledSubagentEdge {
  * Versioned compiled manifest emitted by the compiler and loaded by runtime.
  */
 export type CompiledAgentManifest = z.infer<typeof compiledAgentManifestSchema>;
-declare const compiledSystemSchema: z.ZodObject<{
+declare const compiledInstructionsSchema: z.ZodObject<{
     name: z.ZodString;
     logicalPath: z.ZodString;
     markdown: z.ZodString;
@@ -242,7 +243,7 @@ export declare const compiledAgentNodeManifestSchema: z.ZodObject<{
         sourceKind: z.ZodUnion<readonly [z.ZodLiteral<"markdown">, z.ZodLiteral<"module">]>;
     }, z.core.$strict>>;
     skills: z.ZodReadonly<z.ZodArray<z.ZodType<CompiledSkillDefinition, unknown, z.core.$ZodTypeInternals<CompiledSkillDefinition, unknown>>>>;
-    system: z.ZodOptional<z.ZodObject<{
+    instructions: z.ZodOptional<z.ZodObject<{
         name: z.ZodString;
         logicalPath: z.ZodString;
         markdown: z.ZodString;
@@ -327,7 +328,7 @@ export declare const compiledAgentManifestSchema: z.ZodObject<{
         name: string;
         rootPath: string;
     }>, unknown>>>;
-    system: z.ZodOptional<z.ZodObject<{
+    instructions: z.ZodOptional<z.ZodObject<{
         name: z.ZodString;
         logicalPath: z.ZodString;
         markdown: z.ZodString;
@@ -365,7 +366,7 @@ export declare function createCompiledAgentNodeManifest(input: {
     readonly sandboxWorkspaces?: readonly CompiledSandboxWorkspace[];
     readonly schedules?: readonly CompiledScheduleDefinition[];
     readonly skills?: readonly CompiledSkillDefinition[];
-    readonly system?: CompiledSystem;
+    readonly instructions?: CompiledInstructions;
     readonly tools?: readonly CompiledToolDefinition[];
     readonly workspaceResourceRoot?: CompiledWorkspaceResourceRoot;
 }): CompiledAgentNodeManifest;
@@ -404,7 +405,7 @@ export declare function createCompiledAgentManifest(input: {
     readonly skills?: readonly CompiledSkillDefinition[];
     readonly subagentEdges?: readonly CompiledSubagentEdge[];
     readonly subagents?: readonly CompiledSubagentNode[];
-    readonly system?: CompiledSystem;
+    readonly instructions?: CompiledInstructions;
     readonly tools?: readonly CompiledToolDefinition[];
 }): CompiledAgentManifest;
 export {};

package/dist/src/compiler/manifest.js

@@ -81,7 +81,7 @@ const compiledAgentConfigSchema = z
     source: moduleSourceRefSchema.optional(),
 })
     .strict();
-const compiledSystemSchema = z
+const compiledInstructionsSchema = z
     .object({
     name: z.string(),
     logicalPath: z.string(),
@@ -214,7 +214,7 @@ export const compiledAgentNodeManifestSchema = z
     sandboxWorkspaces: z.array(compiledSandboxWorkspaceSchema),
     schedules: z.array(compiledScheduleDefinitionSchema),
     skills: z.array(compiledSkillSourceSchema).readonly(),
-    system: compiledSystemSchema.optional(),
+    instructions: compiledInstructionsSchema.optional(),
     tools: z.array(compiledToolDefinitionSchema),
     workspaceResourceRoot: compiledWorkspaceResourceRootSchema,
 })
@@ -259,7 +259,7 @@ export const compiledAgentManifestSchema = z
     skills: z.array(compiledSkillSourceSchema).readonly(),
     subagentEdges: z.array(compiledSubagentEdgeSchema),
     subagents: z.array(compiledSubagentNodeSchema),
-    system: compiledSystemSchema.optional(),
+    instructions: compiledInstructionsSchema.optional(),
     tools: z.array(compiledToolDefinitionSchema),
     version: z.literal(COMPILED_AGENT_MANIFEST_VERSION),
     workspaceResourceRoot: compiledWorkspaceResourceRootSchema,
@@ -319,8 +319,8 @@ export function createCompiledAgentNodeManifest(input) {
             }),
         },
     };
-    if (input.system !== undefined) {
-        node.system = input.system;
+    if (input.instructions !== undefined) {
+        node.instructions = input.instructions;
     }
     return node;
 }

package/dist/src/compiler/normalize-instructions.d.ts

@@ -0,0 +1,12 @@
+import type { InstructionsSourceRef } from "#discover/manifest.js";
+import type { CompiledInstructions } from "#compiler/manifest.js";
+/**
+ * Compiles one authored instructions prompt source (markdown or
+ * module-backed `defineInstructions`) into the normalized shape consumed
+ * by the runtime.
+ *
+ * Module-backed instructions sources execute once at build time — the
+ * resulting markdown is captured into the compiled manifest. There is no
+ * per-session re-evaluation at runtime.
+ */
+export declare function compileInstructions(agentRoot: string, source: InstructionsSourceRef): Promise<CompiledInstructions>;

package/dist/src/compiler/normalize-instructions.js

@@ -0,0 +1,28 @@
+import { stripLogicalPathExtension } from "#discover/filesystem.js";
+import { normalizeInstructionsDefinition } from "#internal/authored-definition/core.js";
+import { loadModuleBackedDefinition } from "#compiler/normalize-helpers.js";
+/**
+ * Compiles one authored instructions prompt source (markdown or
+ * module-backed `defineInstructions`) into the normalized shape consumed
+ * by the runtime.
+ *
+ * Module-backed instructions sources execute once at build time — the
+ * resulting markdown is captured into the compiled manifest. There is no
+ * per-session re-evaluation at runtime.
+ */
+export async function compileInstructions(agentRoot, source) {
+    const definition = source.sourceKind === "markdown"
+        ? normalizeInstructionsDefinition(source.definition, `Expected the compiled instructions definition at "${source.logicalPath}" to match the public Ash shape.`)
+        : normalizeInstructionsDefinition(await loadModuleBackedDefinition({
+            agentRoot,
+            kind: "instructions",
+            source,
+        }), `Expected the instructions export "${source.exportName ?? "default"}" from "${source.logicalPath}" to match the public Ash shape.`);
+    return {
+        name: stripLogicalPathExtension(source.logicalPath),
+        logicalPath: source.logicalPath,
+        markdown: definition.markdown,
+        sourceId: source.sourceId,
+        sourceKind: source.sourceKind,
+    };
+}

package/dist/src/compiler/normalize-manifest.js

@@ -5,7 +5,7 @@ import { compileChannelDefinition } from "#compiler/normalize-channel.js";
 import { compileConnectionDefinition } from "#compiler/normalize-connection.js";
 import { compileHookEntry } from "#compiler/normalize-hook.js";
 import { compileSandboxDefinition } from "#compiler/normalize-sandbox.js";
-import { compileSystem } from "#compiler/normalize-system.js";
+import { compileInstructions } from "#compiler/normalize-instructions.js";
 import { compileScheduleDefinition } from "#compiler/normalize-schedule.js";
 import { buildChannelRouteIdentityMap } from "#compiler/normalize-channel.js";
 import { compileSkillSource } from "#compiler/normalize-skill.js";
@@ -77,9 +77,9 @@ async function compileAgentNodeManifest(manifest, context) {
         })),
         schedules: await Promise.all(manifest.schedules.map((scheduleSource) => compileScheduleDefinition(manifest.agentRoot, scheduleSource, channelRouteIdentityMap))),
         skills: await Promise.all(manifest.skills.map((skillSource) => compileSkillSource(manifest.agentRoot, skillSource))),
-        system: manifest.system === undefined
+        instructions: manifest.instructions === undefined
             ? undefined
-            : await compileSystem(manifest.agentRoot, manifest.system),
+            : await compileInstructions(manifest.agentRoot, manifest.instructions),
         tools,
     });
 }

package/dist/src/discover/discover-agent.d.ts

@@ -1,5 +1,5 @@
 import type { DiscoverDiagnostic } from "#discover/diagnostics.js";
-import { DISCOVER_CHANNEL_NAME_INVALID, DISCOVER_HOOK_NAME_INVALID, DISCOVER_MODULE_SLOT_COLLISION, DISCOVER_REQUIRED_SYSTEM_MISSING, DISCOVER_SANDBOX_NAME_INVALID, DISCOVER_SANDBOX_DIRECTORY_INVALID, DISCOVER_SLOT_COLLISION, DISCOVER_TOOL_NAME_INVALID, DISCOVER_TOOLS_DIRECTORY_INVALID, DISCOVER_UNSUPPORTED_DIRECTORY } from "#discover/grammar.js";
+import { DISCOVER_CHANNEL_NAME_INVALID, DISCOVER_HOOK_NAME_INVALID, DISCOVER_DEPRECATED_SYSTEM_SLOT, DISCOVER_MODULE_SLOT_COLLISION, DISCOVER_REQUIRED_INSTRUCTIONS_MISSING, DISCOVER_SANDBOX_NAME_INVALID, DISCOVER_SANDBOX_DIRECTORY_INVALID, DISCOVER_SLOT_COLLISION, DISCOVER_TOOL_NAME_INVALID, DISCOVER_TOOLS_DIRECTORY_INVALID, DISCOVER_UNSUPPORTED_DIRECTORY } from "#discover/grammar.js";
 import { type AgentSourceManifest } from "#discover/manifest.js";
 import { type ProjectSource } from "#discover/project-source.js";
 export { DISCOVER_CONNECTION_FILE_FOLDER_COLLISION, DISCOVER_CONNECTION_FOLDER_EMPTY, DISCOVER_CONNECTIONS_DIRECTORY_INVALID, } from "#discover/connections.js";
@@ -8,7 +8,7 @@ export { DISCOVER_SANDBOX_FOLDER_EMPTY, DISCOVER_SANDBOX_WORKSPACE_SKILLS_RESERV
  * Diagnostics emitted while discovering the non-skill core authored agent
  * grammar.
  */
-export { DISCOVER_CHANNEL_NAME_INVALID, DISCOVER_HOOK_NAME_INVALID, DISCOVER_MODULE_SLOT_COLLISION, DISCOVER_REQUIRED_SYSTEM_MISSING, DISCOVER_SANDBOX_NAME_INVALID, DISCOVER_SANDBOX_DIRECTORY_INVALID, DISCOVER_SLOT_COLLISION, DISCOVER_TOOL_NAME_INVALID, DISCOVER_TOOLS_DIRECTORY_INVALID, DISCOVER_UNSUPPORTED_DIRECTORY, };
+export { DISCOVER_CHANNEL_NAME_INVALID, DISCOVER_DEPRECATED_SYSTEM_SLOT, DISCOVER_HOOK_NAME_INVALID, DISCOVER_MODULE_SLOT_COLLISION, DISCOVER_REQUIRED_INSTRUCTIONS_MISSING, DISCOVER_SANDBOX_NAME_INVALID, DISCOVER_SANDBOX_DIRECTORY_INVALID, DISCOVER_SLOT_COLLISION, DISCOVER_TOOL_NAME_INVALID, DISCOVER_TOOLS_DIRECTORY_INVALID, DISCOVER_UNSUPPORTED_DIRECTORY, };
 export declare const DISCOVER_CHANNELS_DIRECTORY_INVALID = "discover/channels-directory-invalid";
 export declare const DISCOVER_HOOKS_DIRECTORY_INVALID = "discover/hooks-directory-invalid";
 export { DISCOVER_SCHEDULE_FILE_UNSUPPORTED, DISCOVER_SCHEDULES_DIRECTORY_INVALID, } from "#discover/schedules.js";

package/dist/src/discover/discover-agent.js

@@ -2,7 +2,7 @@ import { join, resolve } from "node:path";
 import { discoverConnectionSources } from "#discover/connections.js";
 import { discoverSubagents } from "#discover/discover-subagent.js";
 import { classifyAgentRootEntry } from "#discover/filesystem.js";
-import { createChannelNameDiagnostic, createHookNameDiagnostic, createToolNameDiagnostic, createUnsupportedRootDirectoryDiagnostics, DISCOVER_CHANNEL_NAME_INVALID, DISCOVER_HOOK_NAME_INVALID, DISCOVER_MODULE_SLOT_COLLISION, DISCOVER_REQUIRED_SYSTEM_MISSING, DISCOVER_SANDBOX_NAME_INVALID, DISCOVER_SANDBOX_DIRECTORY_INVALID, DISCOVER_SLOT_COLLISION, DISCOVER_TOOL_NAME_INVALID, DISCOVER_TOOLS_DIRECTORY_INVALID, DISCOVER_UNSUPPORTED_DIRECTORY, discoverFlatModuleSource, discoverNamedSourceDirectory, discoverSystemSource, readSortedDirectoryEntries, } from "#discover/grammar.js";
+import { createChannelNameDiagnostic, createHookNameDiagnostic, createToolNameDiagnostic, createUnsupportedRootDirectoryDiagnostics, DISCOVER_CHANNEL_NAME_INVALID, DISCOVER_HOOK_NAME_INVALID, DISCOVER_DEPRECATED_SYSTEM_SLOT, DISCOVER_MODULE_SLOT_COLLISION, DISCOVER_REQUIRED_INSTRUCTIONS_MISSING, DISCOVER_SANDBOX_NAME_INVALID, DISCOVER_SANDBOX_DIRECTORY_INVALID, DISCOVER_SLOT_COLLISION, DISCOVER_TOOL_NAME_INVALID, DISCOVER_TOOLS_DIRECTORY_INVALID, DISCOVER_UNSUPPORTED_DIRECTORY, discoverFlatModuleSource, discoverInstructionsSource, discoverNamedSourceDirectory, readSortedDirectoryEntries, } from "#discover/grammar.js";
 import { discoverLibSources } from "#discover/lib.js";
 import { createAgentSourceManifest, } from "#discover/manifest.js";
 import { createDiskProjectSource } from "#discover/project-source.js";
@@ -15,7 +15,7 @@ export { DISCOVER_SANDBOX_FOLDER_EMPTY, DISCOVER_SANDBOX_WORKSPACE_SKILLS_RESERV
  * Diagnostics emitted while discovering the non-skill core authored agent
  * grammar.
  */
-export { DISCOVER_CHANNEL_NAME_INVALID, DISCOVER_HOOK_NAME_INVALID, DISCOVER_MODULE_SLOT_COLLISION, DISCOVER_REQUIRED_SYSTEM_MISSING, DISCOVER_SANDBOX_NAME_INVALID, DISCOVER_SANDBOX_DIRECTORY_INVALID, DISCOVER_SLOT_COLLISION, DISCOVER_TOOL_NAME_INVALID, DISCOVER_TOOLS_DIRECTORY_INVALID, DISCOVER_UNSUPPORTED_DIRECTORY, };
+export { DISCOVER_CHANNEL_NAME_INVALID, DISCOVER_DEPRECATED_SYSTEM_SLOT, DISCOVER_HOOK_NAME_INVALID, DISCOVER_MODULE_SLOT_COLLISION, DISCOVER_REQUIRED_INSTRUCTIONS_MISSING, DISCOVER_SANDBOX_NAME_INVALID, DISCOVER_SANDBOX_DIRECTORY_INVALID, DISCOVER_SLOT_COLLISION, DISCOVER_TOOL_NAME_INVALID, DISCOVER_TOOLS_DIRECTORY_INVALID, DISCOVER_UNSUPPORTED_DIRECTORY, };
 export const DISCOVER_CHANNELS_DIRECTORY_INVALID = "discover/channels-directory-invalid";
 export const DISCOVER_HOOKS_DIRECTORY_INVALID = "discover/hooks-directory-invalid";
 export { DISCOVER_SCHEDULE_FILE_UNSUPPORTED, DISCOVER_SCHEDULES_DIRECTORY_INVALID, } from "#discover/schedules.js";
@@ -38,12 +38,12 @@ export async function discoverAgent(input) {
         rootEntries,
         rootPath: agentRoot,
     }));
-    const systemResult = await discoverSystemSource({
+    const instructionsResult = await discoverInstructionsSource({
         rootEntries,
         rootPath: agentRoot,
         source,
     });
-    diagnostics.push(...systemResult.diagnostics);
+    diagnostics.push(...instructionsResult.diagnostics);
     const configModuleResult = discoverFlatModuleSource({
         rootEntries,
         rootPath: agentRoot,
@@ -127,7 +127,7 @@ export async function discoverAgent(input) {
         diagnostics,
         hooks: hooksResult.sources,
         lib: libResult.lib,
-        system: systemResult.system,
+        instructions: instructionsResult.instructions,
         sandbox: sandboxResult.sandbox,
         sandboxWorkspaces: sandboxResult.sandboxWorkspace === null ? [] : [sandboxResult.sandboxWorkspace],
         schedules: schedulesResult.schedules,

package/dist/src/discover/discover-subagent.js

@@ -2,7 +2,7 @@ import { join, relative, resolve } from "node:path";
 import { discoverConnectionSources } from "#discover/connections.js";
 import { createDiscoverErrorDiagnostic } from "#discover/diagnostics.js";
 import { classifyLocalSubagentEntry, getDirectoryEntryType, normalizeLogicalPath, } from "#discover/filesystem.js";
-import { createHookNameDiagnostic, createToolNameDiagnostic, createUnsupportedRootDirectoryDiagnostics, DISCOVER_TOOLS_DIRECTORY_INVALID, discoverFlatModuleSource, discoverNamedSourceDirectory, discoverSystemSource, readSortedDirectoryEntries, } from "#discover/grammar.js";
+import { createHookNameDiagnostic, createToolNameDiagnostic, createUnsupportedRootDirectoryDiagnostics, DISCOVER_TOOLS_DIRECTORY_INVALID, discoverFlatModuleSource, discoverInstructionsSource, discoverNamedSourceDirectory, readSortedDirectoryEntries, } from "#discover/grammar.js";
 import { DISCOVER_HOOKS_DIRECTORY_INVALID } from "#discover/discover-agent.js";
 import { discoverLibSources } from "#discover/lib.js";
 import { createAgentSourceManifest, createLocalSubagentSourceRef, } from "#discover/manifest.js";
@@ -76,12 +76,12 @@ async function discoverLocalSubagentPackage(input) {
         rootEntries,
         rootPath: input.subagentRoot,
     }));
-    const systemResult = await discoverSystemSource({
+    const instructionsResult = await discoverInstructionsSource({
         rootEntries,
         rootPath: input.subagentRoot,
         source: input.source,
     });
-    diagnostics.push(...systemResult.diagnostics);
+    diagnostics.push(...instructionsResult.diagnostics);
     const configModuleResult = discoverFlatModuleSource({
         missingDiagnostic: {
             code: DISCOVER_REQUIRED_SUBAGENT_CONFIG_MODULE_MISSING,
@@ -151,7 +151,7 @@ async function discoverLocalSubagentPackage(input) {
         diagnostics,
         hooks: hooksResult.sources,
         lib: libResult.lib,
-        system: systemResult.system,
+        instructions: instructionsResult.instructions,
         sandbox: sandboxResult.sandbox,
         sandboxWorkspaces: sandboxResult.sandboxWorkspace === null ? [] : [sandboxResult.sandboxWorkspace],
         skills: skillsResult.skills,

package/dist/src/discover/filesystem.d.ts

@@ -11,7 +11,7 @@ export declare const PROJECT_MARKER_FILE_NAMES: readonly ["package.json", "verce
 /**
  * Supported root-level files inside an agent package.
  */
-export declare const AGENT_ROOT_FILE_NAMES: readonly ["agent.ts", "agent.cts", "agent.mts", "agent.js", "agent.cjs", "agent.mjs", "system.md", "system.ts", "system.cts", "system.mts", "system.js", "system.cjs", "system.mjs"];
+export declare const AGENT_ROOT_FILE_NAMES: readonly ["agent.ts", "agent.cts", "agent.mts", "agent.js", "agent.cjs", "agent.mjs", "instructions.md", "instructions.ts", "instructions.cts", "instructions.mts", "instructions.js", "instructions.cjs", "instructions.mjs", "system.md", "system.ts", "system.cts", "system.mts", "system.js", "system.cjs", "system.mjs"];
 /**
  * Supported root-level directories inside an agent package.
  */
@@ -20,7 +20,7 @@ export declare const AGENT_ROOT_DIRECTORY_NAMES: readonly ["channels", "connecti
  * Supported local-subagent entry file names. Subagents reuse the root
  * agent's `agent.{ts,...}` config slot.
  */
-export declare const LOCAL_SUBAGENT_FILE_NAMES: readonly ["agent.ts", "agent.cts", "agent.mts", "agent.js", "agent.cjs", "agent.mjs", "system.md", "system.ts", "system.cts", "system.mts", "system.js", "system.cjs", "system.mjs"];
+export declare const LOCAL_SUBAGENT_FILE_NAMES: readonly ["agent.ts", "agent.cts", "agent.mts", "agent.js", "agent.cjs", "agent.mjs", "instructions.md", "instructions.ts", "instructions.cts", "instructions.mts", "instructions.js", "instructions.cjs", "instructions.mjs", "system.md", "system.ts", "system.cts", "system.mts", "system.js", "system.cjs", "system.mjs"];
 /**
  * Supported local-subagent subdirectories.
  */
@@ -40,11 +40,11 @@ export type DirectoryEntryType = "directory" | "file" | "other";
 /**
  * Classified root-level agent entry.
  */
-export type AgentRootEntryKind = "agent-config-module" | "channels-directory" | "connections-directory" | "hooks-directory" | "lib-directory" | "sandbox-directory" | "schedules-directory" | "skills-directory" | "system-markdown" | "system-module" | "tools-directory" | "unknown" | "subagents-directory";
+export type AgentRootEntryKind = "agent-config-module" | "channels-directory" | "connections-directory" | "hooks-directory" | "instructions-markdown" | "instructions-module" | "lib-directory" | "sandbox-directory" | "schedules-directory" | "skills-directory" | "system-markdown" | "system-module" | "tools-directory" | "unknown" | "subagents-directory";
 /**
  * Classified local-subagent root entry.
  */
-export type LocalSubagentEntryKind = "agent-config-module" | "connections-directory" | "hooks-directory" | "invalid-schedules-directory" | "lib-directory" | "sandbox-directory" | "skills-directory" | "system-markdown" | "system-module" | "tools-directory" | "unknown" | "subagents-directory";
+export type LocalSubagentEntryKind = "agent-config-module" | "connections-directory" | "hooks-directory" | "instructions-markdown" | "instructions-module" | "invalid-schedules-directory" | "lib-directory" | "sandbox-directory" | "skills-directory" | "system-markdown" | "system-module" | "tools-directory" | "unknown" | "subagents-directory";
 /**
  * Classified Agent Skills package entry.
  */

package/dist/src/discover/filesystem.js

@@ -25,6 +25,15 @@ export const AGENT_ROOT_FILE_NAMES = [
     "agent.js",
     "agent.cjs",
     "agent.mjs",
+    "instructions.md",
+    "instructions.ts",
+    "instructions.cts",
+    "instructions.mts",
+    "instructions.js",
+    "instructions.cjs",
+    "instructions.mjs",
+    // The `system` files are deprecated and will be removed soon.
+    // TODO: Clean up in the near future.
     "system.md",
     "system.ts",
     "system.cts",
@@ -58,6 +67,15 @@ export const LOCAL_SUBAGENT_FILE_NAMES = [
     "agent.js",
     "agent.cjs",
     "agent.mjs",
+    "instructions.md",
+    "instructions.ts",
+    "instructions.cts",
+    "instructions.mts",
+    "instructions.js",
+    "instructions.cjs",
+    "instructions.mjs",
+    // The `system` files are deprecated and will be removed soon.
+    // TODO: Clean up in the near future.
     "system.md",
     "system.ts",
     "system.cts",
@@ -118,6 +136,12 @@ export function classifyAgentRootEntry(name, entryType) {
         if (matchesSupportedModuleBaseName(name, "agent")) {
             return "agent-config-module";
         }
+        if (name === "instructions.md") {
+            return "instructions-markdown";
+        }
+        if (matchesSupportedModuleBaseName(name, "instructions")) {
+            return "instructions-module";
+        }
         if (name === "system.md") {
             return "system-markdown";
         }
@@ -165,6 +189,12 @@ export function classifyLocalSubagentEntry(name, entryType) {
         if (matchesSupportedModuleBaseName(name, "agent")) {
             return "agent-config-module";
         }
+        if (name === "instructions.md") {
+            return "instructions-markdown";
+        }
+        if (matchesSupportedModuleBaseName(name, "instructions")) {
+            return "instructions-module";
+        }
         if (name === "system.md") {
             return "system-markdown";
         }

package/dist/src/discover/grammar.d.ts

@@ -1,6 +1,6 @@
 import type { Dirent } from "node:fs";
 import type { MarkdownSourceRef, ModuleSourceRef } from "#shared/source-ref.js";
-import type { SystemDefinition } from "#public/definitions/system.js";
+import type { InstructionsDefinition } from "#public/definitions/instructions.js";
 import { type DiscoverDiagnostic } from "#discover/diagnostics.js";
 import { type DirectoryEntryType } from "#discover/filesystem.js";
 import type { ProjectSource, ProjectSourceEntry } from "#discover/project-source.js";
@@ -9,9 +9,17 @@ import type { ProjectSource, ProjectSourceEntry } from "#discover/project-source
  */
 export declare const DISCOVER_MODULE_SLOT_COLLISION = "discover/module-slot-collision";
 /**
- * Shared diagnostic emitted when the required system prompt source is missing.
+ * Shared diagnostic emitted when the required instructions prompt source
+ * is missing.
  */
-export declare const DISCOVER_REQUIRED_SYSTEM_MISSING = "discover/required-system-missing";
+export declare const DISCOVER_REQUIRED_INSTRUCTIONS_MISSING = "discover/required-instructions-missing";
+/**
+ * Shared diagnostic emitted when discovery falls back to the deprecated
+ * `system.{md,ts,...}` slot because no `instructions.{md,ts,...}` source
+ * was found. The fallback resolves successfully; the warning prompts the
+ * author to rename the file.
+ */
+export declare const DISCOVER_DEPRECATED_SYSTEM_SLOT = "discover/deprecated-system-slot";
 /**
  * Shared diagnostic emitted when a slot has both markdown and module sources.
  */
@@ -100,7 +108,7 @@ export declare const DISCOVER_UNSUPPORTED_DIRECTORY = "discover/unsupported-dire
  * {@link createDiskProjectSource} returns them directly.
  */
 export type StringDirent = Dirent<string>;
-type SystemSourceRef = MarkdownSourceRef<SystemDefinition> | ModuleSourceRef;
+type InstructionsSourceRef = MarkdownSourceRef<InstructionsDefinition> | ModuleSourceRef;
 /**
  * Reads one directory through `source` and returns its entries sorted by name.
  */
@@ -110,15 +118,21 @@ export declare function readSortedDirectoryEntries(source: ProjectSource, direct
  */
 export declare function getPathType(source: ProjectSource, targetPath: string): Promise<"directory" | "file" | "missing" | "other">;
 /**
- * Discovers one required `system.md|ts|cts|mts|js|cjs|mjs` source from a root directory.
+ * Discovers one required `instructions.md|ts|cts|mts|js|cjs|mjs` source
+ * from a root directory.
+ *
+ * For backwards compatibility, falls back to the deprecated
+ * `system.{md,ts,...}` slot when no `instructions.*` source is present —
+ * with a {@link DISCOVER_DEPRECATED_SYSTEM_SLOT} warning prompting the
+ * author to rename the file.
  */
-export declare function discoverSystemSource(input: {
+export declare function discoverInstructionsSource(input: {
     rootEntries: readonly ProjectSourceEntry[];
     rootPath: string;
     source: ProjectSource;
 }): Promise<{
     diagnostics: DiscoverDiagnostic[];
-    system?: SystemSourceRef;
+    instructions?: InstructionsSourceRef;
 }>;
 /**
  * Discovers one flat module slot such as `agent.ts` or `subagent.cjs`.

package/dist/src/discover/grammar.js

@@ -1,5 +1,5 @@
 import { join } from "node:path";
-import { lowerSystemMarkdown } from "#public/helpers/markdown.js";
+import { lowerInstructionsMarkdown } from "#public/helpers/markdown.js";
 import { createDiscoverErrorDiagnostic, createDiscoverWarningDiagnostic, } from "#discover/diagnostics.js";
 import { getDirectoryEntryType } from "#discover/filesystem.js";
 import { createModuleSourceRef } from "#discover/manifest.js";
@@ -10,9 +10,17 @@ import { collectFlatSlotCandidates } from "#discover/slots.js";
  */
 export const DISCOVER_MODULE_SLOT_COLLISION = "discover/module-slot-collision";
 /**
- * Shared diagnostic emitted when the required system prompt source is missing.
+ * Shared diagnostic emitted when the required instructions prompt source
+ * is missing.
  */
-export const DISCOVER_REQUIRED_SYSTEM_MISSING = "discover/required-system-missing";
+export const DISCOVER_REQUIRED_INSTRUCTIONS_MISSING = "discover/required-instructions-missing";
+/**
+ * Shared diagnostic emitted when discovery falls back to the deprecated
+ * `system.{md,ts,...}` slot because no `instructions.{md,ts,...}` source
+ * was found. The fallback resolves successfully; the warning prompts the
+ * author to rename the file.
+ */
+export const DISCOVER_DEPRECATED_SYSTEM_SLOT = "discover/deprecated-system-slot";
 /**
  * Shared diagnostic emitted when a slot has both markdown and module sources.
  */
@@ -106,17 +114,75 @@ export async function getPathType(source, targetPath) {
     return await source.stat(targetPath);
 }
 /**
- * Discovers one required `system.md|ts|cts|mts|js|cjs|mjs` source from a root directory.
+ * Discovers one required `instructions.md|ts|cts|mts|js|cjs|mjs` source
+ * from a root directory.
+ *
+ * For backwards compatibility, falls back to the deprecated
+ * `system.{md,ts,...}` slot when no `instructions.*` source is present —
+ * with a {@link DISCOVER_DEPRECATED_SYSTEM_SLOT} warning prompting the
+ * author to rename the file.
  */
-export async function discoverSystemSource(input) {
-    const candidates = collectFlatSlotCandidates(input.rootEntries, {
+export async function discoverInstructionsSource(input) {
+    const result = await discoverSlotSource({
+        markdownFileName: "instructions.md",
+        moduleBaseName: "instructions",
+        rootEntries: input.rootEntries,
+        rootPath: input.rootPath,
+        slotLabel: "instructions",
+        source: input.source,
+    });
+    if (result.diagnostics.length > 0 || result.source !== undefined) {
+        return {
+            diagnostics: result.diagnostics,
+            instructions: result.source,
+        };
+    }
+    const legacyResult = await discoverSlotSource({
         markdownFileName: "system.md",
         moduleBaseName: "system",
+        rootEntries: input.rootEntries,
+        rootPath: input.rootPath,
+        slotLabel: "system",
+        source: input.source,
+    });
+    if (legacyResult.source !== undefined) {
+        const fileName = legacyResult.source.sourceKind === "markdown" ? "system.md" : legacyResult.source.logicalPath;
+        return {
+            diagnostics: [
+                createDiscoverWarningDiagnostic({
+                    code: DISCOVER_DEPRECATED_SYSTEM_SLOT,
+                    message: `The "${fileName}" slot is deprecated. Rename it to "${fileName.replace(/^system/, "instructions")}" — the runtime still loads the legacy slot for now, but support will be removed in a future release.`,
+                    sourcePath: join(input.rootPath, fileName),
+                }),
+                ...legacyResult.diagnostics,
+            ],
+            instructions: legacyResult.source,
+        };
+    }
+    if (legacyResult.diagnostics.length > 0) {
+        return {
+            diagnostics: legacyResult.diagnostics,
+        };
+    }
+    return {
+        diagnostics: [
+            createDiscoverErrorDiagnostic({
+                code: DISCOVER_REQUIRED_INSTRUCTIONS_MISSING,
+                message: 'Expected one authored instructions prompt source at "instructions.md", "instructions.ts", "instructions.cts", "instructions.mts", "instructions.js", "instructions.cjs", or "instructions.mjs".',
+                sourcePath: input.rootPath,
+            }),
+        ],
+    };
+}
+async function discoverSlotSource(input) {
+    const candidates = collectFlatSlotCandidates(input.rootEntries, {
+        markdownFileName: input.markdownFileName,
+        moduleBaseName: input.moduleBaseName,
     });
     if (candidates.markdownFileName !== undefined && candidates.moduleFileNames.length > 0) {
         return {
             diagnostics: [
-                createSlotCollisionDiagnostic(input.rootPath, "system", [
+                createSlotCollisionDiagnostic(input.rootPath, input.slotLabel, [
                     candidates.markdownFileName,
                     ...candidates.moduleFileNames,
                 ]),
@@ -126,16 +192,16 @@ export async function discoverSystemSource(input) {
     if (candidates.moduleFileNames.length > 1) {
         return {
             diagnostics: [
-                createModuleSlotCollisionDiagnostic(input.rootPath, "system", candidates.moduleFileNames),
+                createModuleSlotCollisionDiagnostic(input.rootPath, input.slotLabel, candidates.moduleFileNames),
             ],
         };
     }
     if (candidates.markdownFileName !== undefined) {
         return {
             diagnostics: [],
-            system: await discoverMarkdownSource({
-                logicalPath: "system.md",
-                lower: lowerSystemMarkdown,
+            source: await discoverMarkdownSource({
+                logicalPath: input.markdownFileName,
+                lower: lowerInstructionsMarkdown,
                 source: input.source,
                 sourcePath: join(input.rootPath, candidates.markdownFileName),
             }),
@@ -145,20 +211,12 @@ export async function discoverSystemSource(input) {
     if (logicalPath !== undefined) {
         return {
             diagnostics: [],
-            system: createModuleSourceRef({
+            source: createModuleSourceRef({
                 logicalPath,
             }),
         };
     }
-    return {
-        diagnostics: [
-            createDiscoverErrorDiagnostic({
-                code: DISCOVER_REQUIRED_SYSTEM_MISSING,
-                message: 'Expected one authored system prompt source at "system.md", "system.ts", "system.cts", "system.mts", "system.js", "system.cjs", or "system.mjs".',
-                sourcePath: input.rootPath,
-            }),
-        ],
-    };
+    return { diagnostics: [] };
 }
 /**
  * Discovers one flat module slot such as `agent.ts` or `subagent.cjs`.