@aigne/ash 0.0.1

package/dist/ai-dev-loop/structured-runner.cjs

@@ -0,0 +1,154 @@
+const require_compiler = require('../compiler.cjs');
+const require_ash_typed_error = require('./ash-typed-error.cjs');
+
+//#region src/ai-dev-loop/structured-runner.ts
+/**
+* Structured Runner — Wraps ASH compileSource() + execute() with step tracking.
+*
+* Produces AshRunResult from raw ASH execution.
+*/
+/**
+* Wraps a WorldInterface to intercept all writes in dry-run mode.
+* Reads pass through normally; write/publish are silently absorbed.
+*/
+function createDryRunWorld(real) {
+	return {
+		read: (path, query) => real.read(path, query),
+		write: (_path, _data) => {},
+		publish: (_topic, _data) => {}
+	};
+}
+/**
+* Wraps a WorldInterface to check an AbortSignal before every operation.
+* Once aborted, all operations throw immediately — preventing side effects
+* from continuing after a timeout.
+*/
+function createCancellableWorld(real, signal) {
+	function checkAborted() {
+		if (signal.aborted) throw new Error("Execution cancelled: timeout");
+	}
+	return {
+		read(path, query) {
+			checkAborted();
+			return real.read(path, query);
+		},
+		write(path, data) {
+			checkAborted();
+			real.write(path, data);
+		},
+		publish(topic, data) {
+			checkAborted();
+			real.publish(topic, data);
+		},
+		...real.exec ? { exec(path, input, params) {
+			checkAborted();
+			return real.exec(path, input, params);
+		} } : {},
+		...real.input ? { input(prompt) {
+			checkAborted();
+			return real.input(prompt);
+		} } : {}
+	};
+}
+async function runStructured(source, ctx, options) {
+	const startTime = performance.now();
+	if (!source.trim()) return {
+		status: "ok",
+		steps: [],
+		output: [],
+		duration_ms: Math.round(performance.now() - startTime)
+	};
+	const compileResult = require_compiler.compileSource(source);
+	const errors = compileResult.diagnostics.filter((d) => d.severity !== "warning");
+	if (errors.length > 0 || !compileResult.program) {
+		const firstError = errors[0] ?? compileResult.diagnostics[0];
+		return {
+			status: "error",
+			steps: [],
+			failedAt: {
+				kind: "ParseError",
+				line: firstError?.line,
+				message: firstError?.message ?? "Compilation failed"
+			},
+			duration_ms: Math.round(performance.now() - startTime)
+		};
+	}
+	const program = compileResult.program;
+	const allSteps = [];
+	let execCtx = (options?.mode ?? "live") === "dry-run" ? {
+		...ctx,
+		world: createDryRunWorld(ctx.world)
+	} : ctx;
+	const timeoutMs = options?.timeout_ms;
+	if (timeoutMs != null && timeoutMs > 0) {
+		const controller = new AbortController();
+		execCtx = {
+			...execCtx,
+			world: createCancellableWorld(execCtx.world, controller.signal)
+		};
+		const timer = setTimeout(() => controller.abort(), timeoutMs);
+		return Promise.race([executeUnits(program, execCtx, allSteps, startTime), new Promise((_, reject) => {
+			controller.signal.addEventListener("abort", () => reject(/* @__PURE__ */ new Error(`Timeout: execution exceeded ${timeoutMs}ms`)));
+		})]).catch((err) => ({
+			status: "error",
+			steps: allSteps,
+			failedAt: require_ash_typed_error.fromJobError(err.message ?? String(err)),
+			duration_ms: Math.round(performance.now() - startTime)
+		})).finally(() => clearTimeout(timer));
+	}
+	return executeUnits(program, execCtx, allSteps, startTime);
+}
+async function executeUnits(program, execCtx, allSteps, startTime) {
+	for (const unit of program.units) {
+		if (unit.kind === "output") {
+			await unit.execute(execCtx);
+			continue;
+		}
+		if (program.routeTargets?.has(unit.name)) continue;
+		try {
+			const jobResult = await unit.execute(execCtx);
+			const report = jobResult;
+			if (report.stages && Array.isArray(report.stages)) for (const stage of report.stages) allSteps.push({
+				step: stage.index ?? allSteps.length,
+				command: stage.name ?? "unknown",
+				status: stage.error ? "error" : "ok",
+				duration_ms: stage.durationMs ?? 0,
+				output: []
+			});
+			else allSteps.push({
+				step: allSteps.length,
+				command: unit.name ?? "job",
+				status: jobResult.status === "ok" ? "ok" : "error",
+				duration_ms: 0
+			});
+			if (jobResult.status === "error" && jobResult.errors.length > 0) return {
+				status: "error",
+				steps: allSteps,
+				failedAt: require_ash_typed_error.fromJobError(jobResult.errors[0]),
+				duration_ms: Math.round(performance.now() - startTime)
+			};
+		} catch (err) {
+			allSteps.push({
+				step: allSteps.length,
+				command: unit.name ?? "job",
+				status: "error",
+				duration_ms: 0
+			});
+			return {
+				status: "error",
+				steps: allSteps,
+				failedAt: require_ash_typed_error.fromJobError(err.message ?? String(err)),
+				duration_ms: Math.round(performance.now() - startTime)
+			};
+		}
+	}
+	return {
+		status: "ok",
+		steps: allSteps,
+		output: [],
+		duration_ms: Math.round(performance.now() - startTime)
+	};
+}
+
+//#endregion
+exports.runStructured = runStructured;

package/dist/ai-dev-loop/structured-runner.d.cts

@@ -0,0 +1,12 @@
+import { AshRunResult } from "./ash-run-result.cjs";
+import { JobContext } from "../compiler.cjs";
+
+//#region src/ai-dev-loop/structured-runner.d.ts
+interface RunOptions {
+  mode?: "dry-run" | "live";
+  timeout_ms?: number;
+}
+declare function runStructured(source: string, ctx: JobContext, options?: RunOptions): Promise<AshRunResult>;
+//#endregion
+export { runStructured };
+//# sourceMappingURL=structured-runner.d.cts.map

package/dist/ai-dev-loop/structured-runner.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"structured-runner.d.cts","names":[],"sources":["../../src/ai-dev-loop/structured-runner.ts"],"mappings":";;;;UA2DiB,UAAA;EACf,IAAA;EACA,UAAA;AAAA;AAAA,iBAGoB,aAAA,CACpB,MAAA,UACA,GAAA,EAAK,UAAA,EACL,OAAA,GAAU,UAAA,GACT,OAAA,CAAQ,YAAA"}

package/dist/ai-dev-loop/structured-runner.d.mts

@@ -0,0 +1,12 @@
+import { AshRunResult } from "./ash-run-result.mjs";
+import { JobContext } from "../compiler.mjs";
+
+//#region src/ai-dev-loop/structured-runner.d.ts
+interface RunOptions {
+  mode?: "dry-run" | "live";
+  timeout_ms?: number;
+}
+declare function runStructured(source: string, ctx: JobContext, options?: RunOptions): Promise<AshRunResult>;
+//#endregion
+export { runStructured };
+//# sourceMappingURL=structured-runner.d.mts.map

package/dist/ai-dev-loop/structured-runner.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"structured-runner.d.mts","names":[],"sources":["../../src/ai-dev-loop/structured-runner.ts"],"mappings":";;;;UA2DiB,UAAA;EACf,IAAA;EACA,UAAA;AAAA;AAAA,iBAGoB,aAAA,CACpB,MAAA,UACA,GAAA,EAAK,UAAA,EACL,OAAA,GAAU,UAAA,GACT,OAAA,CAAQ,YAAA"}

package/dist/ai-dev-loop/structured-runner.mjs

@@ -0,0 +1,155 @@
+import { compileSource } from "../compiler.mjs";
+import { fromJobError } from "./ash-typed-error.mjs";
+
+//#region src/ai-dev-loop/structured-runner.ts
+/**
+* Structured Runner — Wraps ASH compileSource() + execute() with step tracking.
+*
+* Produces AshRunResult from raw ASH execution.
+*/
+/**
+* Wraps a WorldInterface to intercept all writes in dry-run mode.
+* Reads pass through normally; write/publish are silently absorbed.
+*/
+function createDryRunWorld(real) {
+	return {
+		read: (path, query) => real.read(path, query),
+		write: (_path, _data) => {},
+		publish: (_topic, _data) => {}
+	};
+}
+/**
+* Wraps a WorldInterface to check an AbortSignal before every operation.
+* Once aborted, all operations throw immediately — preventing side effects
+* from continuing after a timeout.
+*/
+function createCancellableWorld(real, signal) {
+	function checkAborted() {
+		if (signal.aborted) throw new Error("Execution cancelled: timeout");
+	}
+	return {
+		read(path, query) {
+			checkAborted();
+			return real.read(path, query);
+		},
+		write(path, data) {
+			checkAborted();
+			real.write(path, data);
+		},
+		publish(topic, data) {
+			checkAborted();
+			real.publish(topic, data);
+		},
+		...real.exec ? { exec(path, input, params) {
+			checkAborted();
+			return real.exec(path, input, params);
+		} } : {},
+		...real.input ? { input(prompt) {
+			checkAborted();
+			return real.input(prompt);
+		} } : {}
+	};
+}
+async function runStructured(source, ctx, options) {
+	const startTime = performance.now();
+	if (!source.trim()) return {
+		status: "ok",
+		steps: [],
+		output: [],
+		duration_ms: Math.round(performance.now() - startTime)
+	};
+	const compileResult = compileSource(source);
+	const errors = compileResult.diagnostics.filter((d) => d.severity !== "warning");
+	if (errors.length > 0 || !compileResult.program) {
+		const firstError = errors[0] ?? compileResult.diagnostics[0];
+		return {
+			status: "error",
+			steps: [],
+			failedAt: {
+				kind: "ParseError",
+				line: firstError?.line,
+				message: firstError?.message ?? "Compilation failed"
+			},
+			duration_ms: Math.round(performance.now() - startTime)
+		};
+	}
+	const program = compileResult.program;
+	const allSteps = [];
+	let execCtx = (options?.mode ?? "live") === "dry-run" ? {
+		...ctx,
+		world: createDryRunWorld(ctx.world)
+	} : ctx;
+	const timeoutMs = options?.timeout_ms;
+	if (timeoutMs != null && timeoutMs > 0) {
+		const controller = new AbortController();
+		execCtx = {
+			...execCtx,
+			world: createCancellableWorld(execCtx.world, controller.signal)
+		};
+		const timer = setTimeout(() => controller.abort(), timeoutMs);
+		return Promise.race([executeUnits(program, execCtx, allSteps, startTime), new Promise((_, reject) => {
+			controller.signal.addEventListener("abort", () => reject(/* @__PURE__ */ new Error(`Timeout: execution exceeded ${timeoutMs}ms`)));
+		})]).catch((err) => ({
+			status: "error",
+			steps: allSteps,
+			failedAt: fromJobError(err.message ?? String(err)),
+			duration_ms: Math.round(performance.now() - startTime)
+		})).finally(() => clearTimeout(timer));
+	}
+	return executeUnits(program, execCtx, allSteps, startTime);
+}
+async function executeUnits(program, execCtx, allSteps, startTime) {
+	for (const unit of program.units) {
+		if (unit.kind === "output") {
+			await unit.execute(execCtx);
+			continue;
+		}
+		if (program.routeTargets?.has(unit.name)) continue;
+		try {
+			const jobResult = await unit.execute(execCtx);
+			const report = jobResult;
+			if (report.stages && Array.isArray(report.stages)) for (const stage of report.stages) allSteps.push({
+				step: stage.index ?? allSteps.length,
+				command: stage.name ?? "unknown",
+				status: stage.error ? "error" : "ok",
+				duration_ms: stage.durationMs ?? 0,
+				output: []
+			});
+			else allSteps.push({
+				step: allSteps.length,
+				command: unit.name ?? "job",
+				status: jobResult.status === "ok" ? "ok" : "error",
+				duration_ms: 0
+			});
+			if (jobResult.status === "error" && jobResult.errors.length > 0) return {
+				status: "error",
+				steps: allSteps,
+				failedAt: fromJobError(jobResult.errors[0]),
+				duration_ms: Math.round(performance.now() - startTime)
+			};
+		} catch (err) {
+			allSteps.push({
+				step: allSteps.length,
+				command: unit.name ?? "job",
+				status: "error",
+				duration_ms: 0
+			});
+			return {
+				status: "error",
+				steps: allSteps,
+				failedAt: fromJobError(err.message ?? String(err)),
+				duration_ms: Math.round(performance.now() - startTime)
+			};
+		}
+	}
+	return {
+		status: "ok",
+		steps: allSteps,
+		output: [],
+		duration_ms: Math.round(performance.now() - startTime)
+	};
+}
+
+//#endregion
+export { runStructured };
+//# sourceMappingURL=structured-runner.mjs.map

package/dist/ai-dev-loop/structured-runner.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"structured-runner.mjs","names":[],"sources":["../../src/ai-dev-loop/structured-runner.ts"],"sourcesContent":["/**\n * Structured Runner — Wraps ASH compileSource() + execute() with step tracking.\n *\n * Produces AshRunResult from raw ASH execution.\n */\n\nimport { compileSource, type JobContext, type WorldInterface } from \"../compiler.js\";\nimport type { AshRunResult, AshStepResult } from \"./ash-run-result.js\";\nimport { fromJobError } from \"./ash-typed-error.js\";\n\n/**\n * Wraps a WorldInterface to intercept all writes in dry-run mode.\n * Reads pass through normally; write/publish are silently absorbed.\n */\nfunction createDryRunWorld(real: WorldInterface): WorldInterface {\n  return {\n    read: (path, query) => real.read(path, query),\n    write: (_path, _data) => { /* no-op in dry-run */ },\n    publish: (_topic, _data) => { /* no-op in dry-run */ },\n  };\n}\n\n/**\n * Wraps a WorldInterface to check an AbortSignal before every operation.\n * Once aborted, all operations throw immediately — preventing side effects\n * from continuing after a timeout.\n */\nfunction createCancellableWorld(real: WorldInterface, signal: AbortSignal): WorldInterface {\n  function checkAborted() {\n    if (signal.aborted) throw new Error(\"Execution cancelled: timeout\");\n  }\n  return {\n    read(path, query) {\n      checkAborted();\n      return real.read(path, query);\n    },\n    write(path, data) {\n      checkAborted();\n      real.write(path, data);\n    },\n    publish(topic, data) {\n      checkAborted();\n      real.publish(topic, data);\n    },\n    ...(real.exec ? {\n      exec(path: string, input: unknown[], params?: Record<string, unknown>) {\n        checkAborted();\n        return real.exec!(path, input, params);\n      },\n    } : {}),\n    ...(real.input ? {\n      input(prompt: string) {\n        checkAborted();\n        return real.input!(prompt);\n      },\n    } : {}),\n  };\n}\n\nexport interface RunOptions {\n  mode?: \"dry-run\" | \"live\";\n  timeout_ms?: number;\n}\n\nexport async function runStructured(\n  source: string,\n  ctx: JobContext,\n  options?: RunOptions,\n): Promise<AshRunResult> {\n  const startTime = performance.now();\n\n  // Empty source → success with no steps\n  if (!source.trim()) {\n    return {\n      status: \"ok\",\n      steps: [],\n      output: [],\n      duration_ms: Math.round(performance.now() - startTime),\n    };\n  }\n\n  // Compile\n  const compileResult = compileSource(source);\n\n  // Check for compile errors\n  const errors = compileResult.diagnostics.filter((d) => d.severity !== \"warning\");\n  if (errors.length > 0 || !compileResult.program) {\n    const firstError = errors[0] ?? compileResult.diagnostics[0];\n    return {\n      status: \"error\",\n      steps: [],\n      failedAt: {\n        kind: \"ParseError\",\n        line: firstError?.line,\n        message: firstError?.message ?? \"Compilation failed\",\n      },\n      duration_ms: Math.round(performance.now() - startTime),\n    };\n  }\n\n  const program = compileResult.program;\n  const allSteps: AshStepResult[] = [];\n\n  // Apply dry-run world wrapper if in dry-run mode\n  const mode = options?.mode ?? \"live\";\n  let execCtx: JobContext = mode === \"dry-run\"\n    ? { ...ctx, world: createDryRunWorld(ctx.world) }\n    : ctx;\n\n  // Wrap execution with timeout if specified\n  const timeoutMs = options?.timeout_ms;\n  if (timeoutMs != null && timeoutMs > 0) {\n    const controller = new AbortController();\n    // Wrap world with cancellation guard so operations throw after abort\n    execCtx = { ...execCtx, world: createCancellableWorld(execCtx.world, controller.signal) };\n\n    const timer = setTimeout(() => controller.abort(), timeoutMs);\n    return Promise.race([\n      executeUnits(program, execCtx, allSteps, startTime),\n      new Promise<AshRunResult>((_, reject) => {\n        controller.signal.addEventListener(\"abort\", () =>\n          reject(new Error(`Timeout: execution exceeded ${timeoutMs}ms`)),\n        );\n      }),\n    ]).catch((err: any) => ({\n      status: \"error\" as const,\n      steps: allSteps,\n      failedAt: fromJobError(err.message ?? String(err)),\n      duration_ms: Math.round(performance.now() - startTime),\n    })).finally(() => clearTimeout(timer));\n  }\n\n  return executeUnits(program, execCtx, allSteps, startTime);\n}\n\nasync function executeUnits(\n  program: NonNullable<ReturnType<typeof compileSource>[\"program\"]>,\n  execCtx: JobContext,\n  allSteps: AshStepResult[],\n  startTime: number,\n): Promise<AshRunResult> {\n  // Execute all units (skip route-target-only jobs)\n  for (const unit of program.units) {\n    if (unit.kind === \"output\") {\n      await unit.execute(execCtx);\n      continue;\n    }\n\n    // Skip route-target-only jobs — they execute only when dispatched by route\n    if (program.routeTargets?.has(unit.name)) continue;\n\n    // Job execution\n    try {\n      const jobResult = await unit.execute(execCtx);\n\n      // Extract step metrics from JobReport if available\n      const report = jobResult as any;\n      if (report.stages && Array.isArray(report.stages)) {\n        for (const stage of report.stages) {\n          allSteps.push({\n            step: stage.index ?? allSteps.length,\n            command: stage.name ?? \"unknown\",\n            status: stage.error ? \"error\" : \"ok\",\n            duration_ms: stage.durationMs ?? 0,\n            output: [],\n          });\n        }\n      } else {\n        // Fallback: single step from job\n        allSteps.push({\n          step: allSteps.length,\n          command: unit.name ?? \"job\",\n          status: jobResult.status === \"ok\" ? \"ok\" : \"error\",\n          duration_ms: 0,\n        });\n      }\n\n      if (jobResult.status === \"error\" && jobResult.errors.length > 0) {\n        return {\n          status: \"error\",\n          steps: allSteps,\n          failedAt: fromJobError(jobResult.errors[0]),\n          duration_ms: Math.round(performance.now() - startTime),\n        };\n      }\n    } catch (err: any) {\n      allSteps.push({\n        step: allSteps.length,\n        command: unit.name ?? \"job\",\n        status: \"error\",\n        duration_ms: 0,\n      });\n\n      return {\n        status: \"error\",\n        steps: allSteps,\n        failedAt: fromJobError(err.message ?? String(err)),\n        duration_ms: Math.round(performance.now() - startTime),\n      };\n    }\n  }\n\n  return {\n    status: \"ok\",\n    steps: allSteps,\n    output: [],\n    duration_ms: Math.round(performance.now() - startTime),\n  };\n}\n"],"mappings":"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"}

package/dist/ai-dev-loop/system-prompt.cjs

@@ -0,0 +1,55 @@
+
+//#region src/ai-dev-loop/system-prompt.ts
+/**
+* Build the initial system prompt for the AI dev loop (INTENT §5.1).
+*/
+function buildSystemPrompt(config) {
+	if (config.max_iterations < 1) throw new Error("max_iterations must be at least 1");
+	const plural = config.max_iterations === 1 ? "attempt" : "attempts";
+	return `You are an AOS agent. You operate inside AOS by writing and running ASH scripts.
+
+Rules:
+1. Write ASH scripts to accomplish the user's intent.
+2. Use ash.validate before ash.run.
+3. If ash.run fails, read the structured error carefully.
+4. Fix only the failing step. Do not rewrite unrelated steps.
+5. You have at most ${config.max_iterations} ${plural}.
+
+Available tools:
+- ash.validate(script) → ParseError[]
+- ash.run(script, mode="dry-run") → AshRunResult
+- ash.explain_error(error) → explanation + suggestions
+
+ASH quick reference:
+- discover intent="..." → find tools
+- pick [n] → select from results
+- exec <tool> [args] → run tool (goes through Intent Gate)
+- read/write/edit → AFS operations
+- pipe with | → chain steps`;
+}
+/**
+* Build the correction prompt for a failed iteration (INTENT §5.2).
+*
+* Only includes the error info and previous script — never leaks
+* step output data to avoid world data exposure.
+*/
+function buildCorrectionPrompt(failure, script) {
+	const err = failure.failedAt;
+	const failedStep = failure.steps.length > 0 ? failure.steps[failure.steps.length - 1] : void 0;
+	const lines = [
+		"The previous ASH script failed.",
+		"",
+		"Failure:",
+		`- Step: ${failedStep ? `${failedStep.step} (${failedStep.command})` : "unknown"}`,
+		`- Error: ${err.kind}`,
+		`- Detail: ${err.message}`
+	];
+	const suggestion = err.suggestion;
+	if (suggestion) lines.push(`- Suggestion: ${suggestion}`);
+	lines.push("", "Previous script:", "---", script, "---", "", "Fix the script. Only change the failing step unless the fix requires structural changes.");
+	return lines.join("\n");
+}
+
+//#endregion
+exports.buildCorrectionPrompt = buildCorrectionPrompt;
+exports.buildSystemPrompt = buildSystemPrompt;

package/dist/ai-dev-loop/system-prompt.d.cts

@@ -0,0 +1,20 @@
+import { AshRunFailure } from "./ash-run-result.cjs";
+
+//#region src/ai-dev-loop/system-prompt.d.ts
+interface LoopConfig {
+  max_iterations: number;
+}
+/**
+ * Build the initial system prompt for the AI dev loop (INTENT §5.1).
+ */
+declare function buildSystemPrompt(config: LoopConfig): string;
+/**
+ * Build the correction prompt for a failed iteration (INTENT §5.2).
+ *
+ * Only includes the error info and previous script — never leaks
+ * step output data to avoid world data exposure.
+ */
+declare function buildCorrectionPrompt(failure: AshRunFailure, script: string): string;
+//#endregion
+export { buildCorrectionPrompt, buildSystemPrompt };
+//# sourceMappingURL=system-prompt.d.cts.map

package/dist/ai-dev-loop/system-prompt.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"system-prompt.d.cts","names":[],"sources":["../../src/ai-dev-loop/system-prompt.ts"],"mappings":";;;UASiB,UAAA;EACf,cAAA;AAAA;;;;iBAMc,iBAAA,CAAkB,MAAA,EAAQ,UAAA;AAiC1C;;;;;;AAAA,iBAAgB,qBAAA,CAAsB,OAAA,EAAS,aAAA,EAAe,MAAA"}

package/dist/ai-dev-loop/system-prompt.d.mts

@@ -0,0 +1,20 @@
+import { AshRunFailure } from "./ash-run-result.mjs";
+
+//#region src/ai-dev-loop/system-prompt.d.ts
+interface LoopConfig {
+  max_iterations: number;
+}
+/**
+ * Build the initial system prompt for the AI dev loop (INTENT §5.1).
+ */
+declare function buildSystemPrompt(config: LoopConfig): string;
+/**
+ * Build the correction prompt for a failed iteration (INTENT §5.2).
+ *
+ * Only includes the error info and previous script — never leaks
+ * step output data to avoid world data exposure.
+ */
+declare function buildCorrectionPrompt(failure: AshRunFailure, script: string): string;
+//#endregion
+export { buildCorrectionPrompt, buildSystemPrompt };
+//# sourceMappingURL=system-prompt.d.mts.map

package/dist/ai-dev-loop/system-prompt.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"system-prompt.d.mts","names":[],"sources":["../../src/ai-dev-loop/system-prompt.ts"],"mappings":";;;UASiB,UAAA;EACf,cAAA;AAAA;;;;iBAMc,iBAAA,CAAkB,MAAA,EAAQ,UAAA;AAiC1C;;;;;;AAAA,iBAAgB,qBAAA,CAAsB,OAAA,EAAS,aAAA,EAAe,MAAA"}

package/dist/ai-dev-loop/system-prompt.mjs

@@ -0,0 +1,54 @@
+//#region src/ai-dev-loop/system-prompt.ts
+/**
+* Build the initial system prompt for the AI dev loop (INTENT §5.1).
+*/
+function buildSystemPrompt(config) {
+	if (config.max_iterations < 1) throw new Error("max_iterations must be at least 1");
+	const plural = config.max_iterations === 1 ? "attempt" : "attempts";
+	return `You are an AOS agent. You operate inside AOS by writing and running ASH scripts.
+
+Rules:
+1. Write ASH scripts to accomplish the user's intent.
+2. Use ash.validate before ash.run.
+3. If ash.run fails, read the structured error carefully.
+4. Fix only the failing step. Do not rewrite unrelated steps.
+5. You have at most ${config.max_iterations} ${plural}.
+
+Available tools:
+- ash.validate(script) → ParseError[]
+- ash.run(script, mode="dry-run") → AshRunResult
+- ash.explain_error(error) → explanation + suggestions
+
+ASH quick reference:
+- discover intent="..." → find tools
+- pick [n] → select from results
+- exec <tool> [args] → run tool (goes through Intent Gate)
+- read/write/edit → AFS operations
+- pipe with | → chain steps`;
+}
+/**
+* Build the correction prompt for a failed iteration (INTENT §5.2).
+*
+* Only includes the error info and previous script — never leaks
+* step output data to avoid world data exposure.
+*/
+function buildCorrectionPrompt(failure, script) {
+	const err = failure.failedAt;
+	const failedStep = failure.steps.length > 0 ? failure.steps[failure.steps.length - 1] : void 0;
+	const lines = [
+		"The previous ASH script failed.",
+		"",
+		"Failure:",
+		`- Step: ${failedStep ? `${failedStep.step} (${failedStep.command})` : "unknown"}`,
+		`- Error: ${err.kind}`,
+		`- Detail: ${err.message}`
+	];
+	const suggestion = err.suggestion;
+	if (suggestion) lines.push(`- Suggestion: ${suggestion}`);
+	lines.push("", "Previous script:", "---", script, "---", "", "Fix the script. Only change the failing step unless the fix requires structural changes.");
+	return lines.join("\n");
+}
+
+//#endregion
+export { buildCorrectionPrompt, buildSystemPrompt };
+//# sourceMappingURL=system-prompt.mjs.map

package/dist/ai-dev-loop/system-prompt.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"system-prompt.mjs","names":[],"sources":["../../src/ai-dev-loop/system-prompt.ts"],"sourcesContent":["/**\n * System Prompt Assembly for ASH AI Dev Loop.\n *\n * Implements the prompt contracts from INTENT §5.1 and §5.2.\n */\n\nimport type { AshRunFailure } from \"./ash-run-result.js\";\nimport type { AshTypedError } from \"./ash-typed-error.js\";\n\nexport interface LoopConfig {\n  max_iterations: number;\n}\n\n/**\n * Build the initial system prompt for the AI dev loop (INTENT §5.1).\n */\nexport function buildSystemPrompt(config: LoopConfig): string {\n  if (config.max_iterations < 1) {\n    throw new Error(\"max_iterations must be at least 1\");\n  }\n  const plural = config.max_iterations === 1 ? \"attempt\" : \"attempts\";\n  return `You are an AOS agent. You operate inside AOS by writing and running ASH scripts.\n\nRules:\n1. Write ASH scripts to accomplish the user's intent.\n2. Use ash.validate before ash.run.\n3. If ash.run fails, read the structured error carefully.\n4. Fix only the failing step. Do not rewrite unrelated steps.\n5. You have at most ${config.max_iterations} ${plural}.\n\nAvailable tools:\n- ash.validate(script) → ParseError[]\n- ash.run(script, mode=\"dry-run\") → AshRunResult\n- ash.explain_error(error) → explanation + suggestions\n\nASH quick reference:\n- discover intent=\"...\" → find tools\n- pick [n] → select from results\n- exec <tool> [args] → run tool (goes through Intent Gate)\n- read/write/edit → AFS operations\n- pipe with | → chain steps`;\n}\n\n/**\n * Build the correction prompt for a failed iteration (INTENT §5.2).\n *\n * Only includes the error info and previous script — never leaks\n * step output data to avoid world data exposure.\n */\nexport function buildCorrectionPrompt(failure: AshRunFailure, script: string): string {\n  const err = failure.failedAt as AshTypedError;\n  const failedStep = failure.steps.length > 0\n    ? failure.steps[failure.steps.length - 1]\n    : undefined;\n\n  const lines = [\n    \"The previous ASH script failed.\",\n    \"\",\n    \"Failure:\",\n    `- Step: ${failedStep ? `${failedStep.step} (${failedStep.command})` : \"unknown\"}`,\n    `- Error: ${err.kind}`,\n    `- Detail: ${err.message}`,\n  ];\n\n  const suggestion = (err as any).suggestion;\n  if (suggestion) {\n    lines.push(`- Suggestion: ${suggestion}`);\n  }\n\n  lines.push(\n    \"\",\n    \"Previous script:\",\n    \"---\",\n    script,\n    \"---\",\n    \"\",\n    \"Fix the script. Only change the failing step unless the fix requires structural changes.\",\n  );\n\n  return lines.join(\"\\n\");\n}\n"],"mappings":";;;;AAgBA,SAAgB,kBAAkB,QAA4B;AAC5D,KAAI,OAAO,iBAAiB,EAC1B,OAAM,IAAI,MAAM,oCAAoC;CAEtD,MAAM,SAAS,OAAO,mBAAmB,IAAI,YAAY;AACzD,QAAO;;;;;;;sBAOa,OAAO,eAAe,GAAG,OAAO;;;;;;;;;;;;;;;;;;;;AAqBtD,SAAgB,sBAAsB,SAAwB,QAAwB;CACpF,MAAM,MAAM,QAAQ;CACpB,MAAM,aAAa,QAAQ,MAAM,SAAS,IACtC,QAAQ,MAAM,QAAQ,MAAM,SAAS,KACrC;CAEJ,MAAM,QAAQ;EACZ;EACA;EACA;EACA,WAAW,aAAa,GAAG,WAAW,KAAK,IAAI,WAAW,QAAQ,KAAK;EACvE,YAAY,IAAI;EAChB,aAAa,IAAI;EAClB;CAED,MAAM,aAAc,IAAY;AAChC,KAAI,WACF,OAAM,KAAK,iBAAiB,aAAa;AAG3C,OAAM,KACJ,IACA,oBACA,OACA,QACA,OACA,IACA,2FACD;AAED,QAAO,MAAM,KAAK,KAAK"}

package/dist/ast.d.cts

@@ -0,0 +1,140 @@
+//#region src/ast.d.ts
+interface Annotation {
+  name: string;
+  args: string[];
+  line: number;
+  column: number;
+}
+interface QueryCondition {
+  field: string;
+  op: "==" | "!=" | ">" | "<" | ">=" | "<=";
+  value: string | number;
+}
+interface FindExpression {
+  kind: "find";
+  path: string;
+  query?: QueryCondition;
+}
+interface WhereClause {
+  kind: "where";
+  left: string;
+  op: "==" | "!=" | ">" | "<" | ">=" | "<=";
+  right: string | number;
+}
+interface BinaryExpression {
+  kind: "binary";
+  op: "+" | "-" | "*" | "/";
+  left: Expression;
+  right: Expression;
+}
+interface FieldAccessExpression {
+  kind: "field_access";
+  path: string;
+}
+interface LiteralExpression {
+  kind: "literal";
+  value: string | number;
+}
+interface VarRefExpression {
+  kind: "var_ref";
+  name: string;
+}
+type Expression = BinaryExpression | FieldAccessExpression | LiteralExpression | VarRefExpression;
+interface MapExpression {
+  kind: "map";
+  field: string;
+  mappings?: Record<string, string>;
+  expression?: Expression;
+  exprMappings?: Record<string, Expression>;
+}
+interface SaveExpression {
+  kind: "save";
+  path: string;
+}
+interface PublishExpression {
+  kind: "publish";
+  path: string;
+}
+interface TeeExpression {
+  kind: "tee";
+  path: string;
+}
+interface FanoutExpression {
+  kind: "fanout";
+  branches: PipelineStage[][];
+}
+interface OutputExpression {
+  kind: "output";
+  message: string;
+  expression?: Expression;
+}
+interface InputExpression {
+  kind: "input";
+  prompt: string;
+}
+interface CountExpression {
+  kind: "count";
+}
+interface GroupByExpression {
+  kind: "group-by";
+  field: string;
+}
+interface ActionExpression {
+  kind: "action";
+  path: string;
+  relative?: boolean;
+  params?: Record<string, unknown>;
+}
+interface RouteBranch {
+  value: string;
+  targetJob: string;
+}
+interface RouteExpression {
+  kind: "route";
+  field: string;
+  branches: RouteBranch[];
+  fallback?: string;
+}
+interface LookupExpression {
+  kind: "lookup";
+  path: string;
+  joinKey: string;
+}
+type PipelineStage = FindExpression | WhereClause | MapExpression | SaveExpression | PublishExpression | TeeExpression | FanoutExpression | OutputExpression | InputExpression | CountExpression | GroupByExpression | ActionExpression | RouteExpression | LookupExpression;
+interface EventTrigger {
+  kind: "event";
+  path: string;
+  event: string;
+}
+interface CronTrigger {
+  kind: "cron";
+  expression: string;
+}
+type TriggerDeclaration = EventTrigger | CronTrigger;
+interface JobDeclaration {
+  kind: "job";
+  name: string;
+  annotations: Annotation[];
+  pipeline: PipelineStage[];
+  trigger?: TriggerDeclaration;
+}
+interface LetStatement {
+  kind: "let";
+  name: string;
+  value: string | number;
+  pipeline?: PipelineStage[];
+}
+interface ParamDeclaration {
+  kind: "param";
+  name: string;
+  defaultValue: string | number;
+}
+type TopLevelStatement = JobDeclaration | OutputExpression | LetStatement | ParamDeclaration;
+interface Program {
+  statements: TopLevelStatement[];
+  /** Backward-compatible accessor: returns only job declarations */
+  jobs: JobDeclaration[];
+}
+//#endregion
+export { ActionExpression, BinaryExpression, CountExpression, CronTrigger, EventTrigger, Expression, FieldAccessExpression, FindExpression, GroupByExpression, InputExpression, JobDeclaration, LetStatement, LiteralExpression, LookupExpression, MapExpression, ParamDeclaration, PipelineStage, Program, QueryCondition, RouteBranch, RouteExpression, TopLevelStatement, TriggerDeclaration, VarRefExpression };
+//# sourceMappingURL=ast.d.cts.map