@aigne/ash 0.0.1

package/DESIGN.md

@@ -0,0 +1,41 @@
+# ASH — Design
+
+## What ASH Is
+
+ASH (Agentic Shell) is a **pipeline intermediate representation** designed for
+agents and agentic workflows. It compiles declarative multi-stage pipelines
+into executable jobs that run against any world interface (AFS, AOS namespace,
+or custom implementations).
+
+```
+find /world/users | where active == true | map { name, role } | save /world/active
+```
+
+## What ASH Is Not
+
+ASH is **not** an interactive shell for humans. It does not handle:
+
+- Prompts or REPL
+- Command history
+- Current working directory (cwd)
+- Session management
+- TUI / interactive UI
+- Tab completion
+
+## Consumers
+
+| Consumer | Interface |
+|----------|-----------|
+| AFS exec | `afs exec script.ash` — runs against AFS world |
+| AOS runtime | Loads `.ash` as program entrypoint |
+| Agent runtime | Calls `compileSource()` / `CompiledProgram.run()` directly |
+| Console | Detects `|` in input → sends full line to ASH compiler |
+
+## Relationship to AFS
+
+```
+ASH  = Pipeline DSL (Agent / Advanced User)
+AFS  = World (read/write/publish interface)
+```
+
+ASH operates on any `WorldInterface` — AFS is the primary but not sole target.

package/dist/ai-dev-loop/ash-run-result.cjs

@@ -0,0 +1,12 @@
+
+//#region src/ai-dev-loop/ash-run-result.ts
+function isAshRunSuccess(result) {
+	return result.status === "ok";
+}
+function isAshRunFailure(result) {
+	return result.status === "error";
+}
+
+//#endregion
+exports.isAshRunFailure = isAshRunFailure;
+exports.isAshRunSuccess = isAshRunSuccess;

package/dist/ai-dev-loop/ash-run-result.d.cts

@@ -0,0 +1,28 @@
+import { AshTypedError } from "./ash-typed-error.cjs";
+
+//#region src/ai-dev-loop/ash-run-result.d.ts
+interface AshStepResult {
+  step: number;
+  command: string;
+  status: "ok" | "error" | "skipped";
+  duration_ms: number;
+  output?: unknown[];
+}
+interface AshRunSuccess {
+  status: "ok";
+  steps: AshStepResult[];
+  output: unknown[];
+  duration_ms: number;
+}
+interface AshRunFailure {
+  status: "error";
+  steps: AshStepResult[];
+  failedAt: AshTypedError;
+  duration_ms: number;
+}
+type AshRunResult = AshRunSuccess | AshRunFailure;
+declare function isAshRunSuccess(result: AshRunResult): result is AshRunSuccess;
+declare function isAshRunFailure(result: AshRunResult): result is AshRunFailure;
+//#endregion
+export { AshRunFailure, AshRunResult, AshRunSuccess, AshStepResult, isAshRunFailure, isAshRunSuccess };
+//# sourceMappingURL=ash-run-result.d.cts.map

package/dist/ai-dev-loop/ash-run-result.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ash-run-result.d.cts","names":[],"sources":["../../src/ai-dev-loop/ash-run-result.ts"],"mappings":";;;UAMiB,aAAA;EACf,IAAA;EACA,OAAA;EACA,MAAA;EACA,WAAA;EACA,MAAA;AAAA;AAAA,UAGe,aAAA;EACf,MAAA;EACA,KAAA,EAAO,aAAA;EACP,MAAA;EACA,WAAA;AAAA;AAAA,UAGe,aAAA;EACf,MAAA;EACA,KAAA,EAAO,aAAA;EACP,QAAA,EAAU,aAAA;EACV,WAAA;AAAA;AAAA,KAGU,YAAA,GAAe,aAAA,GAAgB,aAAA;AAAA,iBAE3B,eAAA,CAAgB,MAAA,EAAQ,YAAA,GAAe,MAAA,IAAU,aAAA;AAAA,iBAIjD,eAAA,CAAgB,MAAA,EAAQ,YAAA,GAAe,MAAA,IAAU,aAAA"}

package/dist/ai-dev-loop/ash-run-result.d.mts

@@ -0,0 +1,28 @@
+import { AshTypedError } from "./ash-typed-error.mjs";
+
+//#region src/ai-dev-loop/ash-run-result.d.ts
+interface AshStepResult {
+  step: number;
+  command: string;
+  status: "ok" | "error" | "skipped";
+  duration_ms: number;
+  output?: unknown[];
+}
+interface AshRunSuccess {
+  status: "ok";
+  steps: AshStepResult[];
+  output: unknown[];
+  duration_ms: number;
+}
+interface AshRunFailure {
+  status: "error";
+  steps: AshStepResult[];
+  failedAt: AshTypedError;
+  duration_ms: number;
+}
+type AshRunResult = AshRunSuccess | AshRunFailure;
+declare function isAshRunSuccess(result: AshRunResult): result is AshRunSuccess;
+declare function isAshRunFailure(result: AshRunResult): result is AshRunFailure;
+//#endregion
+export { AshRunFailure, AshRunResult, AshRunSuccess, AshStepResult, isAshRunFailure, isAshRunSuccess };
+//# sourceMappingURL=ash-run-result.d.mts.map

package/dist/ai-dev-loop/ash-run-result.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ash-run-result.d.mts","names":[],"sources":["../../src/ai-dev-loop/ash-run-result.ts"],"mappings":";;;UAMiB,aAAA;EACf,IAAA;EACA,OAAA;EACA,MAAA;EACA,WAAA;EACA,MAAA;AAAA;AAAA,UAGe,aAAA;EACf,MAAA;EACA,KAAA,EAAO,aAAA;EACP,MAAA;EACA,WAAA;AAAA;AAAA,UAGe,aAAA;EACf,MAAA;EACA,KAAA,EAAO,aAAA;EACP,QAAA,EAAU,aAAA;EACV,WAAA;AAAA;AAAA,KAGU,YAAA,GAAe,aAAA,GAAgB,aAAA;AAAA,iBAE3B,eAAA,CAAgB,MAAA,EAAQ,YAAA,GAAe,MAAA,IAAU,aAAA;AAAA,iBAIjD,eAAA,CAAgB,MAAA,EAAQ,YAAA,GAAe,MAAA,IAAU,aAAA"}

package/dist/ai-dev-loop/ash-run-result.mjs

@@ -0,0 +1,11 @@
+//#region src/ai-dev-loop/ash-run-result.ts
+function isAshRunSuccess(result) {
+	return result.status === "ok";
+}
+function isAshRunFailure(result) {
+	return result.status === "error";
+}
+
+//#endregion
+export { isAshRunFailure, isAshRunSuccess };
+//# sourceMappingURL=ash-run-result.mjs.map

package/dist/ai-dev-loop/ash-run-result.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"ash-run-result.mjs","names":[],"sources":["../../src/ai-dev-loop/ash-run-result.ts"],"sourcesContent":["/**\n * AshRunResult — Structured execution result for ASH scripts.\n */\n\nimport type { AshTypedError } from \"./ash-typed-error.js\";\n\nexport interface AshStepResult {\n  step: number;\n  command: string;\n  status: \"ok\" | \"error\" | \"skipped\";\n  duration_ms: number;\n  output?: unknown[];\n}\n\nexport interface AshRunSuccess {\n  status: \"ok\";\n  steps: AshStepResult[];\n  output: unknown[];\n  duration_ms: number;\n}\n\nexport interface AshRunFailure {\n  status: \"error\";\n  steps: AshStepResult[];\n  failedAt: AshTypedError;\n  duration_ms: number;\n}\n\nexport type AshRunResult = AshRunSuccess | AshRunFailure;\n\nexport function isAshRunSuccess(result: AshRunResult): result is AshRunSuccess {\n  return result.status === \"ok\";\n}\n\nexport function isAshRunFailure(result: AshRunResult): result is AshRunFailure {\n  return result.status === \"error\";\n}\n\nexport function validateRunResult(result: unknown): void {\n  const r = result as any;\n  if (!r || typeof r !== \"object\") throw new Error(\"AshRunResult: must be an object\");\n  if (!Array.isArray(r.steps)) throw new Error(\"AshRunResult: missing steps array\");\n  if (r.status === \"error\" && !r.failedAt) {\n    throw new Error(\"AshRunFailure: missing failedAt field\");\n  }\n}\n"],"mappings":";AA8BA,SAAgB,gBAAgB,QAA+C;AAC7E,QAAO,OAAO,WAAW;;AAG3B,SAAgB,gBAAgB,QAA+C;AAC7E,QAAO,OAAO,WAAW"}

package/dist/ai-dev-loop/ash-typed-error.cjs

@@ -0,0 +1,51 @@
+
+//#region src/ai-dev-loop/ash-typed-error.ts
+const VALID_KINDS = new Set([
+	"IntentDenied",
+	"CapabilityMissing",
+	"ToolNotFound",
+	"ValidationFailed",
+	"BudgetExceeded",
+	"Timeout",
+	"ParseError",
+	"RuntimeError"
+]);
+function isAshTypedError(value) {
+	if (!value || typeof value !== "object") return false;
+	const obj = value;
+	return typeof obj.kind === "string" && VALID_KINDS.has(obj.kind) && typeof obj.message === "string";
+}
+/**
+* Best-effort conversion from raw ASH error string → AshTypedError.
+*/
+function fromJobError(errorStr) {
+	if (errorStr.startsWith("Capability denied:")) return {
+		kind: "CapabilityMissing",
+		capability: errorStr.replace("Capability denied:", "").trim(),
+		message: errorStr
+	};
+	if (errorStr.includes("not found") || errorStr.includes("unknown command")) return {
+		kind: "ToolNotFound",
+		name: errorStr,
+		available: [],
+		message: errorStr
+	};
+	if (errorStr.includes("timeout") || errorStr.includes("Timeout")) return {
+		kind: "Timeout",
+		step: "",
+		limit_ms: 0,
+		message: errorStr
+	};
+	if (errorStr.includes("parse") || errorStr.includes("syntax") || errorStr.includes("Unexpected")) return {
+		kind: "ParseError",
+		message: errorStr
+	};
+	return {
+		kind: "RuntimeError",
+		message: errorStr
+	};
+}
+
+//#endregion
+exports.fromJobError = fromJobError;
+exports.isAshTypedError = isAshTypedError;

package/dist/ai-dev-loop/ash-typed-error.d.cts

@@ -0,0 +1,54 @@
+//#region src/ai-dev-loop/ash-typed-error.d.ts
+/**
+ * AshTypedError — Discriminated union of all ASH error types.
+ *
+ * Each kind carries enough structured information for AI self-repair.
+ */
+type AshTypedError = {
+  kind: "IntentDenied";
+  invariant: string;
+  message: string;
+  suggestion?: string;
+} | {
+  kind: "CapabilityMissing";
+  capability: string;
+  message: string;
+} | {
+  kind: "ToolNotFound";
+  name: string;
+  available: string[];
+  message: string;
+} | {
+  kind: "ValidationFailed";
+  field: string;
+  expected: string;
+  got: string;
+  message: string;
+} | {
+  kind: "BudgetExceeded";
+  device: string;
+  limit: number;
+  used: number;
+  message: string;
+} | {
+  kind: "Timeout";
+  step: string;
+  limit_ms: number;
+  message: string;
+} | {
+  kind: "ParseError";
+  line?: number;
+  message: string;
+} | {
+  kind: "RuntimeError";
+  message: string;
+  context?: Record<string, unknown>;
+};
+declare function isAshTypedError(value: unknown): value is AshTypedError;
+/**
+ * Best-effort conversion from raw ASH error string → AshTypedError.
+ */
+declare function fromJobError(errorStr: string): AshTypedError;
+//#endregion
+export { AshTypedError, fromJobError, isAshTypedError };
+//# sourceMappingURL=ash-typed-error.d.cts.map

package/dist/ai-dev-loop/ash-typed-error.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ash-typed-error.d.cts","names":[],"sources":["../../src/ai-dev-loop/ash-typed-error.ts"],"mappings":";;AAMA;;;;KAAY,aAAA;EACN,IAAA;EAAsB,SAAA;EAAmB,OAAA;EAAiB,UAAA;AAAA;EAC1D,IAAA;EAA2B,UAAA;EAAoB,OAAA;AAAA;EAC/C,IAAA;EAAsB,IAAA;EAAc,SAAA;EAAqB,OAAA;AAAA;EACzD,IAAA;EAA0B,KAAA;EAAe,QAAA;EAAkB,GAAA;EAAa,OAAA;AAAA;EACxE,IAAA;EAAwB,MAAA;EAAgB,KAAA;EAAe,IAAA;EAAc,OAAA;AAAA;EACrE,IAAA;EAAiB,IAAA;EAAc,QAAA;EAAkB,OAAA;AAAA;EACjD,IAAA;EAAoB,IAAA;EAAe,OAAA;AAAA;EACnC,IAAA;EAAsB,OAAA;EAAiB,OAAA,GAAU,MAAA;AAAA;AAAA,iBAOvC,eAAA,CAAgB,KAAA,YAAiB,KAAA,IAAS,aAAA;;;AAS1D;iBAAgB,YAAA,CAAa,QAAA,WAAmB,aAAA"}

package/dist/ai-dev-loop/ash-typed-error.d.mts

@@ -0,0 +1,54 @@
+//#region src/ai-dev-loop/ash-typed-error.d.ts
+/**
+ * AshTypedError — Discriminated union of all ASH error types.
+ *
+ * Each kind carries enough structured information for AI self-repair.
+ */
+type AshTypedError = {
+  kind: "IntentDenied";
+  invariant: string;
+  message: string;
+  suggestion?: string;
+} | {
+  kind: "CapabilityMissing";
+  capability: string;
+  message: string;
+} | {
+  kind: "ToolNotFound";
+  name: string;
+  available: string[];
+  message: string;
+} | {
+  kind: "ValidationFailed";
+  field: string;
+  expected: string;
+  got: string;
+  message: string;
+} | {
+  kind: "BudgetExceeded";
+  device: string;
+  limit: number;
+  used: number;
+  message: string;
+} | {
+  kind: "Timeout";
+  step: string;
+  limit_ms: number;
+  message: string;
+} | {
+  kind: "ParseError";
+  line?: number;
+  message: string;
+} | {
+  kind: "RuntimeError";
+  message: string;
+  context?: Record<string, unknown>;
+};
+declare function isAshTypedError(value: unknown): value is AshTypedError;
+/**
+ * Best-effort conversion from raw ASH error string → AshTypedError.
+ */
+declare function fromJobError(errorStr: string): AshTypedError;
+//#endregion
+export { AshTypedError, fromJobError, isAshTypedError };
+//# sourceMappingURL=ash-typed-error.d.mts.map

package/dist/ai-dev-loop/ash-typed-error.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ash-typed-error.d.mts","names":[],"sources":["../../src/ai-dev-loop/ash-typed-error.ts"],"mappings":";;AAMA;;;;KAAY,aAAA;EACN,IAAA;EAAsB,SAAA;EAAmB,OAAA;EAAiB,UAAA;AAAA;EAC1D,IAAA;EAA2B,UAAA;EAAoB,OAAA;AAAA;EAC/C,IAAA;EAAsB,IAAA;EAAc,SAAA;EAAqB,OAAA;AAAA;EACzD,IAAA;EAA0B,KAAA;EAAe,QAAA;EAAkB,GAAA;EAAa,OAAA;AAAA;EACxE,IAAA;EAAwB,MAAA;EAAgB,KAAA;EAAe,IAAA;EAAc,OAAA;AAAA;EACrE,IAAA;EAAiB,IAAA;EAAc,QAAA;EAAkB,OAAA;AAAA;EACjD,IAAA;EAAoB,IAAA;EAAe,OAAA;AAAA;EACnC,IAAA;EAAsB,OAAA;EAAiB,OAAA,GAAU,MAAA;AAAA;AAAA,iBAOvC,eAAA,CAAgB,KAAA,YAAiB,KAAA,IAAS,aAAA;;;AAS1D;iBAAgB,YAAA,CAAa,QAAA,WAAmB,aAAA"}

package/dist/ai-dev-loop/ash-typed-error.mjs

@@ -0,0 +1,50 @@
+//#region src/ai-dev-loop/ash-typed-error.ts
+const VALID_KINDS = new Set([
+	"IntentDenied",
+	"CapabilityMissing",
+	"ToolNotFound",
+	"ValidationFailed",
+	"BudgetExceeded",
+	"Timeout",
+	"ParseError",
+	"RuntimeError"
+]);
+function isAshTypedError(value) {
+	if (!value || typeof value !== "object") return false;
+	const obj = value;
+	return typeof obj.kind === "string" && VALID_KINDS.has(obj.kind) && typeof obj.message === "string";
+}
+/**
+* Best-effort conversion from raw ASH error string → AshTypedError.
+*/
+function fromJobError(errorStr) {
+	if (errorStr.startsWith("Capability denied:")) return {
+		kind: "CapabilityMissing",
+		capability: errorStr.replace("Capability denied:", "").trim(),
+		message: errorStr
+	};
+	if (errorStr.includes("not found") || errorStr.includes("unknown command")) return {
+		kind: "ToolNotFound",
+		name: errorStr,
+		available: [],
+		message: errorStr
+	};
+	if (errorStr.includes("timeout") || errorStr.includes("Timeout")) return {
+		kind: "Timeout",
+		step: "",
+		limit_ms: 0,
+		message: errorStr
+	};
+	if (errorStr.includes("parse") || errorStr.includes("syntax") || errorStr.includes("Unexpected")) return {
+		kind: "ParseError",
+		message: errorStr
+	};
+	return {
+		kind: "RuntimeError",
+		message: errorStr
+	};
+}
+
+//#endregion
+export { fromJobError, isAshTypedError };
+//# sourceMappingURL=ash-typed-error.mjs.map

package/dist/ai-dev-loop/ash-typed-error.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"ash-typed-error.mjs","names":[],"sources":["../../src/ai-dev-loop/ash-typed-error.ts"],"sourcesContent":["/**\n * AshTypedError — Discriminated union of all ASH error types.\n *\n * Each kind carries enough structured information for AI self-repair.\n */\n\nexport type AshTypedError =\n  | { kind: \"IntentDenied\"; invariant: string; message: string; suggestion?: string }\n  | { kind: \"CapabilityMissing\"; capability: string; message: string }\n  | { kind: \"ToolNotFound\"; name: string; available: string[]; message: string }\n  | { kind: \"ValidationFailed\"; field: string; expected: string; got: string; message: string }\n  | { kind: \"BudgetExceeded\"; device: string; limit: number; used: number; message: string }\n  | { kind: \"Timeout\"; step: string; limit_ms: number; message: string }\n  | { kind: \"ParseError\"; line?: number; message: string }\n  | { kind: \"RuntimeError\"; message: string; context?: Record<string, unknown> };\n\nconst VALID_KINDS = new Set([\n  \"IntentDenied\", \"CapabilityMissing\", \"ToolNotFound\", \"ValidationFailed\",\n  \"BudgetExceeded\", \"Timeout\", \"ParseError\", \"RuntimeError\",\n]);\n\nexport function isAshTypedError(value: unknown): value is AshTypedError {\n  if (!value || typeof value !== \"object\") return false;\n  const obj = value as Record<string, unknown>;\n  return typeof obj.kind === \"string\" && VALID_KINDS.has(obj.kind) && typeof obj.message === \"string\";\n}\n\n/**\n * Best-effort conversion from raw ASH error string → AshTypedError.\n */\nexport function fromJobError(errorStr: string): AshTypedError {\n  if (errorStr.startsWith(\"Capability denied:\")) {\n    const capability = errorStr.replace(\"Capability denied:\", \"\").trim();\n    return { kind: \"CapabilityMissing\", capability, message: errorStr };\n  }\n\n  if (errorStr.includes(\"not found\") || errorStr.includes(\"unknown command\")) {\n    return { kind: \"ToolNotFound\", name: errorStr, available: [], message: errorStr };\n  }\n\n  if (errorStr.includes(\"timeout\") || errorStr.includes(\"Timeout\")) {\n    return { kind: \"Timeout\", step: \"\", limit_ms: 0, message: errorStr };\n  }\n\n  if (errorStr.includes(\"parse\") || errorStr.includes(\"syntax\") || errorStr.includes(\"Unexpected\")) {\n    return { kind: \"ParseError\", message: errorStr };\n  }\n\n  return { kind: \"RuntimeError\", message: errorStr };\n}\n"],"mappings":";AAgBA,MAAM,cAAc,IAAI,IAAI;CAC1B;CAAgB;CAAqB;CAAgB;CACrD;CAAkB;CAAW;CAAc;CAC5C,CAAC;AAEF,SAAgB,gBAAgB,OAAwC;AACtE,KAAI,CAAC,SAAS,OAAO,UAAU,SAAU,QAAO;CAChD,MAAM,MAAM;AACZ,QAAO,OAAO,IAAI,SAAS,YAAY,YAAY,IAAI,IAAI,KAAK,IAAI,OAAO,IAAI,YAAY;;;;;AAM7F,SAAgB,aAAa,UAAiC;AAC5D,KAAI,SAAS,WAAW,qBAAqB,CAE3C,QAAO;EAAE,MAAM;EAAqB,YADjB,SAAS,QAAQ,sBAAsB,GAAG,CAAC,MAAM;EACpB,SAAS;EAAU;AAGrE,KAAI,SAAS,SAAS,YAAY,IAAI,SAAS,SAAS,kBAAkB,CACxE,QAAO;EAAE,MAAM;EAAgB,MAAM;EAAU,WAAW,EAAE;EAAE,SAAS;EAAU;AAGnF,KAAI,SAAS,SAAS,UAAU,IAAI,SAAS,SAAS,UAAU,CAC9D,QAAO;EAAE,MAAM;EAAW,MAAM;EAAI,UAAU;EAAG,SAAS;EAAU;AAGtE,KAAI,SAAS,SAAS,QAAQ,IAAI,SAAS,SAAS,SAAS,IAAI,SAAS,SAAS,aAAa,CAC9F,QAAO;EAAE,MAAM;EAAc,SAAS;EAAU;AAGlD,QAAO;EAAE,MAAM;EAAgB,SAAS;EAAU"}

package/dist/ai-dev-loop/ash-validate.cjs

@@ -0,0 +1,27 @@
+const require_compiler = require('../compiler.cjs');
+
+//#region src/ai-dev-loop/ash-validate.ts
+/**
+* ash.validate — Static analysis for ASH scripts.
+*
+* Reuses existing compileSource() diagnostics to catch syntax + type errors
+* without executing.
+*/
+function ashValidate(source) {
+	if (source == null) throw new Error("ash.validate: source must be a string, got " + typeof source);
+	if (!source.trim()) return [];
+	const result = require_compiler.compileSource(source);
+	const errors = [];
+	for (const diag of result.diagnostics) {
+		if (diag.severity === "warning") continue;
+		errors.push({
+			kind: "ParseError",
+			line: diag.line,
+			message: diag.message
+		});
+	}
+	return errors;
+}
+
+//#endregion
+exports.ashValidate = ashValidate;

package/dist/ai-dev-loop/ash-validate.d.cts

@@ -0,0 +1,7 @@
+import { AshTypedError } from "./ash-typed-error.cjs";
+
+//#region src/ai-dev-loop/ash-validate.d.ts
+declare function ashValidate(source: string): AshTypedError[];
+//#endregion
+export { ashValidate };
+//# sourceMappingURL=ash-validate.d.cts.map

package/dist/ai-dev-loop/ash-validate.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ash-validate.d.cts","names":[],"sources":["../../src/ai-dev-loop/ash-validate.ts"],"mappings":";;;iBAUgB,WAAA,CAAY,MAAA,WAAiB,aAAA"}

package/dist/ai-dev-loop/ash-validate.d.mts

@@ -0,0 +1,7 @@
+import { AshTypedError } from "./ash-typed-error.mjs";
+
+//#region src/ai-dev-loop/ash-validate.d.ts
+declare function ashValidate(source: string): AshTypedError[];
+//#endregion
+export { ashValidate };
+//# sourceMappingURL=ash-validate.d.mts.map

package/dist/ai-dev-loop/ash-validate.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ash-validate.d.mts","names":[],"sources":["../../src/ai-dev-loop/ash-validate.ts"],"mappings":";;;iBAUgB,WAAA,CAAY,MAAA,WAAiB,aAAA"}

package/dist/ai-dev-loop/ash-validate.mjs

@@ -0,0 +1,28 @@
+import { compileSource } from "../compiler.mjs";
+
+//#region src/ai-dev-loop/ash-validate.ts
+/**
+* ash.validate — Static analysis for ASH scripts.
+*
+* Reuses existing compileSource() diagnostics to catch syntax + type errors
+* without executing.
+*/
+function ashValidate(source) {
+	if (source == null) throw new Error("ash.validate: source must be a string, got " + typeof source);
+	if (!source.trim()) return [];
+	const result = compileSource(source);
+	const errors = [];
+	for (const diag of result.diagnostics) {
+		if (diag.severity === "warning") continue;
+		errors.push({
+			kind: "ParseError",
+			line: diag.line,
+			message: diag.message
+		});
+	}
+	return errors;
+}
+
+//#endregion
+export { ashValidate };
+//# sourceMappingURL=ash-validate.mjs.map

package/dist/ai-dev-loop/ash-validate.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"ash-validate.mjs","names":[],"sources":["../../src/ai-dev-loop/ash-validate.ts"],"sourcesContent":["/**\n * ash.validate — Static analysis for ASH scripts.\n *\n * Reuses existing compileSource() diagnostics to catch syntax + type errors\n * without executing.\n */\n\nimport { compileSource } from \"../compiler.js\";\nimport type { AshTypedError } from \"./ash-typed-error.js\";\n\nexport function ashValidate(source: string): AshTypedError[] {\n  if (source == null) {\n    throw new Error(\"ash.validate: source must be a string, got \" + typeof source);\n  }\n\n  if (!source.trim()) {\n    return [];\n  }\n\n  const result = compileSource(source);\n  const errors: AshTypedError[] = [];\n\n  for (const diag of result.diagnostics) {\n    if (diag.severity === \"warning\") continue;\n\n    errors.push({\n      kind: \"ParseError\",\n      line: diag.line,\n      message: diag.message,\n    });\n  }\n\n  return errors;\n}\n"],"mappings":";;;;;;;;;AAUA,SAAgB,YAAY,QAAiC;AAC3D,KAAI,UAAU,KACZ,OAAM,IAAI,MAAM,gDAAgD,OAAO,OAAO;AAGhF,KAAI,CAAC,OAAO,MAAM,CAChB,QAAO,EAAE;CAGX,MAAM,SAAS,cAAc,OAAO;CACpC,MAAM,SAA0B,EAAE;AAElC,MAAK,MAAM,QAAQ,OAAO,aAAa;AACrC,MAAI,KAAK,aAAa,UAAW;AAEjC,SAAO,KAAK;GACV,MAAM;GACN,MAAM,KAAK;GACX,SAAS,KAAK;GACf,CAAC;;AAGJ,QAAO"}

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

@@ -0,0 +1,134 @@
+const require_system_prompt = require('./system-prompt.cjs');
+
+//#region src/ai-dev-loop/dev-loop.ts
+/**
+* Run the AI dev loop: think → extract ASH → validate → run → observe → correct or return.
+*/
+async function runDevLoop(config) {
+	const mode = config.mode ?? "dry-run";
+	const observations = [];
+	let lastFailure;
+	let lastScript;
+	for (let i = 0; i < config.max_iterations; i++) {
+		let thinkResult;
+		try {
+			const messages = [];
+			if (i === 0) {
+				messages.push({
+					role: "system",
+					content: require_system_prompt.buildSystemPrompt({ max_iterations: config.max_iterations })
+				});
+				messages.push({
+					role: "user",
+					content: config.intent
+				});
+			} else messages.push({
+				role: "user",
+				content: require_system_prompt.buildCorrectionPrompt(lastFailure, lastScript)
+			});
+			thinkResult = await config.think({ messages });
+		} catch (err) {
+			return {
+				status: "error",
+				iterations: i + 1,
+				mode,
+				observations,
+				error: err.message
+			};
+		}
+		const script = extractScript(thinkResult);
+		if (!script) {
+			const obs$1 = {
+				iteration: i + 1,
+				error: "empty_response"
+			};
+			observations.push(obs$1);
+			await config.observe(obs$1);
+			if (i === config.max_iterations - 1) return {
+				status: "error",
+				iterations: i + 1,
+				mode,
+				observations,
+				error: "LLM returned no script"
+			};
+			lastFailure = {
+				status: "error",
+				steps: [],
+				failedAt: {
+					kind: "RuntimeError",
+					message: "LLM returned no ASH script"
+				},
+				duration_ms: 0
+			};
+			lastScript = "";
+			continue;
+		}
+		lastScript = script;
+		const errors = await config.validate(script);
+		if (errors.length > 0) {
+			const obs$1 = {
+				iteration: i + 1,
+				script,
+				validation_errors: errors
+			};
+			observations.push(obs$1);
+			await config.observe(obs$1);
+			if (i === config.max_iterations - 1) return {
+				status: "error",
+				iterations: i + 1,
+				mode,
+				observations,
+				finalResult: {
+					status: "error",
+					steps: [],
+					failedAt: errors[0],
+					duration_ms: 0
+				}
+			};
+			lastFailure = {
+				status: "error",
+				steps: [],
+				failedAt: errors[0],
+				duration_ms: 0
+			};
+			continue;
+		}
+		const result = await config.runner(script);
+		const obs = {
+			iteration: i + 1,
+			script,
+			result
+		};
+		observations.push(obs);
+		await config.observe(obs);
+		if (result.status === "ok") return {
+			status: "ok",
+			iterations: i + 1,
+			mode,
+			finalResult: result,
+			observations
+		};
+		lastFailure = result;
+	}
+	return {
+		status: "error",
+		iterations: config.max_iterations,
+		mode,
+		finalResult: lastFailure,
+		observations
+	};
+}
+function extractScript(thinkResult) {
+	const toolCalls = thinkResult?.response?.tool_calls;
+	if (Array.isArray(toolCalls)) {
+		for (const tc of toolCalls) if (tc.name === "ash_run") try {
+			const args = typeof tc.arguments === "string" ? JSON.parse(tc.arguments) : tc.arguments;
+			if (args?.script) return args.script;
+		} catch {}
+	}
+	const content = thinkResult?.response?.content;
+	if (typeof content === "string" && content.trim()) return content.trim();
+}
+
+//#endregion
+exports.runDevLoop = runDevLoop;

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

@@ -0,0 +1,28 @@
+import { AshTypedError } from "./ash-typed-error.cjs";
+import { AshRunResult } from "./ash-run-result.cjs";
+
+//#region src/ai-dev-loop/dev-loop.d.ts
+interface DevLoopConfig {
+  intent: string;
+  max_iterations: number;
+  mode?: "dry-run" | "live";
+  think: (request: any) => Promise<any>;
+  runner: (source: string) => Promise<AshRunResult>;
+  validate: (source: string) => Promise<AshTypedError[]>;
+  observe: (data: any) => Promise<void>;
+}
+interface DevLoopResult {
+  status: "ok" | "error";
+  iterations: number;
+  mode: "dry-run" | "live";
+  finalResult?: AshRunResult;
+  observations: any[];
+  error?: string;
+}
+/**
+ * Run the AI dev loop: think → extract ASH → validate → run → observe → correct or return.
+ */
+declare function runDevLoop(config: DevLoopConfig): Promise<DevLoopResult>;
+//#endregion
+export { DevLoopConfig, DevLoopResult, runDevLoop };
+//# sourceMappingURL=dev-loop.d.cts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"dev-loop.d.cts","names":[],"sources":["../../src/ai-dev-loop/dev-loop.ts"],"mappings":";;;;UAaiB,aAAA;EACf,MAAA;EACA,cAAA;EACA,IAAA;EACA,KAAA,GAAQ,OAAA,UAAiB,OAAA;EACzB,MAAA,GAAS,MAAA,aAAmB,OAAA,CAAQ,YAAA;EACpC,QAAA,GAAW,MAAA,aAAmB,OAAA,CAAQ,aAAA;EACtC,OAAA,GAAU,IAAA,UAAc,OAAA;AAAA;AAAA,UAGT,aAAA;EACf,MAAA;EACA,UAAA;EACA,IAAA;EACA,WAAA,GAAc,YAAA;EACd,YAAA;EACA,KAAA;AAAA;;;;iBAMoB,UAAA,CAAW,MAAA,EAAQ,aAAA,GAAgB,OAAA,CAAQ,aAAA"}

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

@@ -0,0 +1,28 @@
+import { AshTypedError } from "./ash-typed-error.mjs";
+import { AshRunResult } from "./ash-run-result.mjs";
+
+//#region src/ai-dev-loop/dev-loop.d.ts
+interface DevLoopConfig {
+  intent: string;
+  max_iterations: number;
+  mode?: "dry-run" | "live";
+  think: (request: any) => Promise<any>;
+  runner: (source: string) => Promise<AshRunResult>;
+  validate: (source: string) => Promise<AshTypedError[]>;
+  observe: (data: any) => Promise<void>;
+}
+interface DevLoopResult {
+  status: "ok" | "error";
+  iterations: number;
+  mode: "dry-run" | "live";
+  finalResult?: AshRunResult;
+  observations: any[];
+  error?: string;
+}
+/**
+ * Run the AI dev loop: think → extract ASH → validate → run → observe → correct or return.
+ */
+declare function runDevLoop(config: DevLoopConfig): Promise<DevLoopResult>;
+//#endregion
+export { DevLoopConfig, DevLoopResult, runDevLoop };
+//# sourceMappingURL=dev-loop.d.mts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"dev-loop.d.mts","names":[],"sources":["../../src/ai-dev-loop/dev-loop.ts"],"mappings":";;;;UAaiB,aAAA;EACf,MAAA;EACA,cAAA;EACA,IAAA;EACA,KAAA,GAAQ,OAAA,UAAiB,OAAA;EACzB,MAAA,GAAS,MAAA,aAAmB,OAAA,CAAQ,YAAA;EACpC,QAAA,GAAW,MAAA,aAAmB,OAAA,CAAQ,aAAA;EACtC,OAAA,GAAU,IAAA,UAAc,OAAA;AAAA;AAAA,UAGT,aAAA;EACf,MAAA;EACA,UAAA;EACA,IAAA;EACA,WAAA,GAAc,YAAA;EACd,YAAA;EACA,KAAA;AAAA;;;;iBAMoB,UAAA,CAAW,MAAA,EAAQ,aAAA,GAAgB,OAAA,CAAQ,aAAA"}