experimental-ash 0.6.2 → 0.7.0

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

@@ -2,7 +2,7 @@ import type { MarkdownSourceRef, ModuleSourceRef, SkillPackageSourceRef } from "
 import type { InternalSkillDefinition } from "#shared/skill-definition.js";
 import type { ScheduleDefinition } from "#public/definitions/schedule.js";
 import type { SkillDefinition } from "#public/definitions/skill.js";
-import type { SystemDefinition } from "#public/definitions/system.js";
+import type { InstructionsDefinition } from "#public/definitions/instructions.js";
 import type { DiscoverDiagnostic, DiscoverDiagnosticsSummary } from "#discover/diagnostics.js";
 /**
  * Stable manifest kind emitted by discovery.
@@ -31,9 +31,10 @@ export interface ConnectionSourceRef extends ModuleSourceRef {
     readonly connectionName: string;
 }
 /**
- * System source reference preserved by discovery for compiler normalization.
+ * Instructions source reference preserved by discovery for compiler
+ * normalization.
  */
-export type SystemSourceRef = MarkdownSourceRef<SystemDefinition> | ModuleSourceRef;
+export type InstructionsSourceRef = MarkdownSourceRef<InstructionsDefinition> | ModuleSourceRef;
 /**
  * Skill source reference preserved by the discovery manifest.
  */
@@ -122,11 +123,13 @@ export interface AgentSourceManifest {
     lib: LibSourceRef[];
     kind: typeof AGENT_SOURCE_MANIFEST_KIND;
     /**
-     * Authored system prompt source discovered at the agent root
-     * (`system.md` or `system.{ts,cts,mts,js,cjs,mjs}`). Optional — agents
-     * without an authored system prompt fall back to the framework default.
+     * Authored instructions prompt source discovered at the agent root
+     * (`instructions.md` or `instructions.{ts,cts,mts,js,cjs,mjs}`).
+     * Optional — agents without an authored instructions prompt fall back
+     * to the framework default. The deprecated `system.{md,ts,...}` slot is
+     * still discovered as a fallback (with a deprecation warning).
      */
-    system?: SystemSourceRef;
+    instructions?: InstructionsSourceRef;
     /**
      * Authored sandbox module discovered for this agent, or `null` when
      * the agent does not declare one. Every agent owns at most one
@@ -165,7 +168,7 @@ export interface CreateAgentSourceManifestInput {
      * `/vercel/path0`) produce a meaningful agent id.
      */
     packageName?: string;
-    system?: SystemSourceRef;
+    instructions?: InstructionsSourceRef;
     sandbox?: SandboxSourceRef | null;
     sandboxWorkspaces?: readonly SandboxWorkspaceFolderSourceRef[];
     schedules?: readonly ScheduleSourceRef[];

package/dist/src/discover/manifest.js

@@ -36,8 +36,8 @@ export function createAgentSourceManifest(input) {
     if (input.configModule !== undefined) {
         manifest.configModule = input.configModule;
     }
-    if (input.system !== undefined) {
-        manifest.system = input.system;
+    if (input.instructions !== undefined) {
+        manifest.instructions = input.instructions;
     }
     return manifest;
 }

package/dist/src/evals/cli/eval.js

@@ -1 +1 @@
-import{n as e}from"../../chunks/paths-D1gMcyWw.js";import{loadDevelopmentEnvironmentFiles as t}from"../../cli/dev/environment.js";import{a as n,n as r,t as i}from"../../chunks/client-DBMG7iuf.js";import{n as a}from"../../chunks/host-CDvE1sV_.js";import{discoverAndImportSuites as o,discoverSuiteFiles as s,importSuiteFile as c}from"../runner/discover.js";import{executeSuite as l}from"../runner/execute-suite.js";import{ConsoleReporter as u}from"../runner/reporters/console.js";var d=n();function f(e,t){e.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 p(e,t)})}async function p(n,r){let i=e();if(t(i),n.listSuites){await y(i,r);return}let s=n.suite,c=await o(i,s);if(c.length===0){s&&s.length>0?r.error(`No suites found matching: ${s.join(`, `)}`):r.error(`No eval suites found. Create suite files under evals/ with the *.eval.ts extension.`),process.exitCode=1;return}let u,d;n.url?d={kind:`remote`,url:n.url}:(u=await a(i,{host:`127.0.0.1`,port:0}),d={kind:`local`,url:u.url});let f=m(d);try{let e=[];for(let t of c){let r=_(t,n),a=v(r,{json:n.json===!0,skipReport:n.skipReport===!0}),o=await l({suite:r,target:d,reporters:a,appRoot:i,client:f});e.push(o)}n.json&&r.log(JSON.stringify(e,null,2)),e.some(e=>e.errored>0)&&(process.exitCode=1)}finally{u&&await u.close()}process.exit(process.exitCode??0)}function m(e){if(e.kind===`local`)return new i({host:e.url});let t={},n=process.env.VERCEL_AUTOMATION_BYPASS_SECRET?.trim();return n&&(t[r]=n),new i({auth:h(),headers:Object.keys(t).length>0?t:void 0,host:e.url})}function h(){let e=process.env.ASH_EVAL_AUTH_TOKEN?.trim();return e?{bearer:e}:{bearer:g}}async function g(){try{let e=(await(0,d.getVercelOidcToken)()).trim();if(e.length>0)return e}catch{}return process.env.VERCEL_OIDC_TOKEN?.trim()??``}function _(e,t){let n=t.maxConcurrency?Number.parseInt(t.maxConcurrency,10):void 0,r=t.timeout?Number.parseInt(t.timeout,10):void 0;if(n===void 0&&r===void 0)return e;let i={...e};return n!==void 0&&(i.maxConcurrency=n),r!==void 0&&(i.timeoutMs=r),i}function v(e,t){let n=t.json?[]:[new u];return!t.skipReport&&e.reporters&&n.push(...e.reporters),n}async function y(e,t){let n=await s(e);if(n.length===0){t.log(`No eval suites found.`);return}t.log(`Found ${n.length} eval suite file(s):\n`);for(let r of n){let n=await c(e,r);t.log(`  ${n.id}${n.description?`  - ${n.description}`:``}`)}}export{f as registerEvalCommand,p as runEvalCommand};
+import{n as e}from"../../chunks/paths-BiY7uVwD.js";import{loadDevelopmentEnvironmentFiles as t}from"../../cli/dev/environment.js";import{a as n,n as r,t as i}from"../../chunks/client-DBMG7iuf.js";import{n as a}from"../../chunks/host-Ca8xvEQ1.js";import{discoverAndImportSuites as o,discoverSuiteFiles as s,importSuiteFile as c}from"../runner/discover.js";import{executeSuite as l}from"../runner/execute-suite.js";import{ConsoleReporter as u}from"../runner/reporters/console.js";var d=n();function f(e,t){e.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 p(e,t)})}async function p(n,r){let i=e();if(t(i),n.listSuites){await y(i,r);return}let s=n.suite,c=await o(i,s);if(c.length===0){s&&s.length>0?r.error(`No suites found matching: ${s.join(`, `)}`):r.error(`No eval suites found. Create suite files under evals/ with the *.eval.ts extension.`),process.exitCode=1;return}let u,d;n.url?d={kind:`remote`,url:n.url}:(u=await a(i,{host:`127.0.0.1`,port:0}),d={kind:`local`,url:u.url});let f=m(d);try{let e=[];for(let t of c){let r=_(t,n),a=v(r,{json:n.json===!0,skipReport:n.skipReport===!0}),o=await l({suite:r,target:d,reporters:a,appRoot:i,client:f});e.push(o)}n.json&&r.log(JSON.stringify(e,null,2)),e.some(e=>e.errored>0)&&(process.exitCode=1)}finally{u&&await u.close()}process.exit(process.exitCode??0)}function m(e){if(e.kind===`local`)return new i({host:e.url});let t={},n=process.env.VERCEL_AUTOMATION_BYPASS_SECRET?.trim();return n&&(t[r]=n),new i({auth:h(),headers:Object.keys(t).length>0?t:void 0,host:e.url})}function h(){let e=process.env.ASH_EVAL_AUTH_TOKEN?.trim();return e?{bearer:e}:{bearer:g}}async function g(){try{let e=(await(0,d.getVercelOidcToken)()).trim();if(e.length>0)return e}catch{}return process.env.VERCEL_OIDC_TOKEN?.trim()??``}function _(e,t){let n=t.maxConcurrency?Number.parseInt(t.maxConcurrency,10):void 0,r=t.timeout?Number.parseInt(t.timeout,10):void 0;if(n===void 0&&r===void 0)return e;let i={...e};return n!==void 0&&(i.maxConcurrency=n),r!==void 0&&(i.timeoutMs=r),i}function v(e,t){let n=t.json?[]:[new u];return!t.skipReport&&e.reporters&&n.push(...e.reporters),n}async function y(e,t){let n=await s(e);if(n.length===0){t.log(`No eval suites found.`);return}t.log(`Found ${n.length} eval suite file(s):\n`);for(let r of n){let n=await c(e,r);t.log(`  ${n.id}${n.description?`  - ${n.description}`:``}`)}}export{f as registerEvalCommand,p as runEvalCommand};

package/dist/src/internal/application/package.js

@@ -6,7 +6,7 @@ import { ASH_PACKAGE_NAME } from "#package-name.js";
 let cachedPackageInfo;
 // The package build stamps the published version into `dist` so bundled
 // deployments can still report package metadata without resolving package.json.
-const BUNDLED_FALLBACK_PACKAGE_VERSION = "0.6.2";
+const BUNDLED_FALLBACK_PACKAGE_VERSION = "0.7.0";
 const BUNDLED_FALLBACK_PACKAGE_VERSION_PLACEHOLDER = "__ASH_PACKAGE_VERSION_PLACEHOLDER__";
 const WORKFLOW_MODULE_ALIASES = {
     "workflow/api": "src/compiled/@workflow/core/runtime.js",

package/dist/src/internal/authored-definition/core.d.ts

@@ -1,7 +1,7 @@
 import type { AgentDefinition, AgentBuildDefinition } from "#public/definitions/agent.js";
 import type { ScheduleDefinition } from "#public/definitions/schedule.js";
 import type { SkillDefinition } from "#public/definitions/skill.js";
-import type { SystemDefinition } from "#public/definitions/system.js";
+import type { InstructionsDefinition } from "#public/definitions/instructions.js";
 type NormalizedAgentDefinition = Omit<AgentDefinition, "build"> & {
     build?: {
         externalDependencies?: Readonly<AgentBuildDefinition["externalDependencies"]>;
@@ -15,13 +15,14 @@ type NormalizedAgentDefinition = Omit<AgentDefinition, "build"> & {
  */
 export declare function normalizeAgentDefinition(value: unknown, message: string): Readonly<NormalizedAgentDefinition>;
 /**
- * Normalizes one authored system definition into the canonical internal
- * shape.
+ * Normalizes one authored instructions definition into the canonical
+ * internal shape.
  *
- * Authored `name` fields are rejected — system prompt identity is derived
- * from the file path (`system.md` or `system.{ts,...}`).
+ * Authored `name` fields are rejected — instructions prompt identity is
+ * derived from the file path (`instructions.md` or
+ * `instructions.{ts,...}`).
  */
-export declare function normalizeSystemDefinition(value: unknown, message: string): SystemDefinition;
+export declare function normalizeInstructionsDefinition(value: unknown, message: string): InstructionsDefinition;
 /**
  * Normalizes one authored skill definition into the canonical internal
  * shape.

package/dist/src/internal/authored-definition/core.js

@@ -95,13 +95,14 @@ function normalizeAgentCompactionDefinition(value, message) {
     return normalizedDefinition;
 }
 /**
- * Normalizes one authored system definition into the canonical internal
- * shape.
+ * Normalizes one authored instructions definition into the canonical
+ * internal shape.
  *
- * Authored `name` fields are rejected — system prompt identity is derived
- * from the file path (`system.md` or `system.{ts,...}`).
+ * Authored `name` fields are rejected — instructions prompt identity is
+ * derived from the file path (`instructions.md` or
+ * `instructions.{ts,...}`).
  */
-export function normalizeSystemDefinition(value, message) {
+export function normalizeInstructionsDefinition(value, message) {
     const record = expectObjectRecord(value, message);
     expectOnlyKnownKeys(record, ["markdown"], message);
     return {

package/dist/src/internal/nitro/routes/home-page/build-home-page-response.d.ts

@@ -52,12 +52,12 @@ export interface HomePageOverview {
     readonly discoveryWarnings: number;
     readonly modelId: string;
     readonly subagentCount: number;
-    readonly systemPromptSource: string;
+    readonly instructionsPromptSource: string;
 }
 /**
- * System prompt section returned by the home-page JSON route.
+ * Instructions prompt section returned by the home-page JSON route.
  */
-export interface HomePageSystemPrompt {
+export interface HomePageInstructionsPrompt {
     readonly logicalPath: string;
     readonly markdownPreview: string;
 }
@@ -77,8 +77,8 @@ export interface HomePageResponse {
     readonly skills: readonly HomePageSourceRow[];
     readonly subagents: readonly HomePageSubagentRow[];
     readonly summaryCounts: readonly HomePageSummaryCount[];
-    readonly system: HomePageSourceRow | null;
-    readonly systemPrompt: HomePageSystemPrompt;
+    readonly instructions: HomePageSourceRow | null;
+    readonly instructionsPrompt: HomePageInstructionsPrompt;
     readonly tools: readonly HomePageSourceRow[];
 }
 /**

package/dist/src/internal/nitro/routes/home-page/build-home-page-response.js

@@ -10,20 +10,20 @@ function truncateCopy(value, maxLength) {
 }
 function createHeroSummary(data) {
     const { agent, manifest, schedules } = data;
-    return `Compiled inspection surface for the current runtime. Runs on ${agent.config.model.id} with ${agent.system === undefined ? "no system prompt" : "a system prompt"}, ${pluralize(agent.skills.length, "skill")}, ${pluralize(agent.tools.length, "tool")}, ${pluralize(agent.sandbox === null ? 0 : 1, "sandbox")}, ${pluralize(schedules.length, "schedule")}, and ${pluralize(manifest.subagents.length, "subagent")}.`;
+    return `Compiled inspection surface for the current runtime. Runs on ${agent.config.model.id} with ${agent.instructions === undefined ? "no instructions prompt" : "an instructions prompt"}, ${pluralize(agent.skills.length, "skill")}, ${pluralize(agent.tools.length, "tool")}, ${pluralize(agent.sandbox === null ? 0 : 1, "sandbox")}, ${pluralize(schedules.length, "schedule")}, and ${pluralize(manifest.subagents.length, "subagent")}.`;
 }
 function createPageDescription(data) {
     return truncateCopy(createHeroSummary(data), 155);
 }
-function renderSystemRow(agent) {
-    if (agent.system === undefined) {
+function renderInstructionsRow(agent) {
+    if (agent.instructions === undefined) {
         return null;
     }
     return {
-        details: truncateCopy(agent.system.markdown.trim(), 420),
-        logicalPath: agent.system.logicalPath,
-        name: agent.system.name,
-        sourceKind: agent.system.sourceKind === "module" ? "Module" : agent.system.sourceKind,
+        details: truncateCopy(agent.instructions.markdown.trim(), 420),
+        logicalPath: agent.instructions.logicalPath,
+        name: agent.instructions.name,
+        sourceKind: agent.instructions.sourceKind === "module" ? "Module" : agent.instructions.sourceKind,
     };
 }
 function renderSkillRows(skills) {
@@ -118,7 +118,7 @@ function renderEndpointRows() {
  * Builds the JSON payload served to Ash's static Nitro home page.
  */
 export function buildHomePageResponse(data) {
-    const system = data.agent.system;
+    const instructions = data.agent.instructions;
     const requestExample = `POST ${ASH_CREATE_SESSION_ROUTE_PATH}
 content-type: application/json
 
@@ -137,7 +137,7 @@ content-type: application/json
             discoveryWarnings: data.agent.metadata.diagnosticsSummary.warnings,
             modelId: data.agent.config.model.id,
             subagentCount: data.manifest.subagents.length,
-            systemPromptSource: system?.logicalPath ?? "No system prompt discovered",
+            instructionsPromptSource: instructions?.logicalPath ?? "No instructions prompt discovered",
         },
         pageDescription: createPageDescription(data),
         pageTitle: `${data.agent.config.name} | Ash`,
@@ -147,8 +147,8 @@ content-type: application/json
         subagents: renderSubagentRows(data.manifest),
         summaryCounts: [
             {
-                label: "system prompt",
-                value: system === undefined ? 0 : 1,
+                label: "instructions prompt",
+                value: instructions === undefined ? 0 : 1,
             },
             {
                 label: "skill",
@@ -171,10 +171,11 @@ content-type: application/json
                 value: data.manifest.subagents.length,
             },
         ],
-        system: renderSystemRow(data.agent),
-        systemPrompt: {
-            logicalPath: system?.logicalPath ?? "No system prompt discovered",
-            markdownPreview: truncateCopy(system?.markdown.trim() ?? "This agent does not currently define a system prompt.", 420),
+        instructions: renderInstructionsRow(data.agent),
+        instructionsPrompt: {
+            logicalPath: instructions?.logicalPath ?? "No instructions prompt discovered",
+            markdownPreview: truncateCopy(instructions?.markdown.trim() ??
+                "This agent does not currently define an instructions prompt.", 420),
         },
         tools: renderToolRows(data.agent),
     };

package/dist/src/internal/nitro/routes/home-page/load-home-page-data.d.ts

@@ -1,6 +1,6 @@
 import type { CompiledAgentManifest, CompiledSubagentNode } from "#compiler/manifest.js";
 import { type RuntimeCompiledArtifactsSource } from "#runtime/compiled-artifacts-source.js";
-import type { ResolvedAgent, ResolvedSandboxDefinition, ResolvedSchedule, ResolvedSkillDefinition, ResolvedSystem } from "#runtime/types.js";
+import type { ResolvedAgent, ResolvedSandboxDefinition, ResolvedSchedule, ResolvedSkillDefinition, ResolvedInstructions } from "#runtime/types.js";
 /**
  * Runtime data needed to build the package-owned Nitro homepage.
  */
@@ -23,4 +23,4 @@ export declare function loadHomePageData(input: {
 export declare function resolveHomePageCompiledArtifactsSource(input?: {
     readonly appRoot?: string;
 }): RuntimeCompiledArtifactsSource;
-export type { CompiledAgentManifest, CompiledSubagentNode, ResolvedSandboxDefinition, ResolvedSchedule, ResolvedSkillDefinition, ResolvedSystem, };
+export type { CompiledAgentManifest, CompiledSubagentNode, ResolvedSandboxDefinition, ResolvedSchedule, ResolvedSkillDefinition, ResolvedInstructions, };