@aigne/ash 0.0.1

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

@@ -0,0 +1,135 @@
+import { buildCorrectionPrompt, buildSystemPrompt } from "./system-prompt.mjs";
+
+//#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: buildSystemPrompt({ max_iterations: config.max_iterations })
+				});
+				messages.push({
+					role: "user",
+					content: config.intent
+				});
+			} else messages.push({
+				role: "user",
+				content: 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
+export { runDevLoop };
+//# sourceMappingURL=dev-loop.mjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"dev-loop.mjs","names":["obs"],"sources":["../../src/ai-dev-loop/dev-loop.ts"],"sourcesContent":["/**\n * AI Dev Loop Core — bounded generate → validate → run → observe → correct loop.\n *\n * Invariants enforced:\n * - INV-1: Default mode is dry-run\n * - INV-3: Observe only, never commit to long-term memory\n * - INV-4: Bounded by max_iterations\n */\n\nimport type { AshRunResult, AshRunFailure } from \"./ash-run-result.js\";\nimport type { AshTypedError } from \"./ash-typed-error.js\";\nimport { buildSystemPrompt, buildCorrectionPrompt } from \"./system-prompt.js\";\n\nexport interface DevLoopConfig {\n  intent: string;\n  max_iterations: number;\n  mode?: \"dry-run\" | \"live\";\n  think: (request: any) => Promise<any>;\n  runner: (source: string) => Promise<AshRunResult>;\n  validate: (source: string) => Promise<AshTypedError[]>;\n  observe: (data: any) => Promise<void>;\n}\n\nexport interface DevLoopResult {\n  status: \"ok\" | \"error\";\n  iterations: number;\n  mode: \"dry-run\" | \"live\";\n  finalResult?: AshRunResult;\n  observations: any[];\n  error?: string;\n}\n\n/**\n * Run the AI dev loop: think → extract ASH → validate → run → observe → correct or return.\n */\nexport async function runDevLoop(config: DevLoopConfig): Promise<DevLoopResult> {\n  const mode = config.mode ?? \"dry-run\";\n  const observations: any[] = [];\n  let lastFailure: AshRunFailure | undefined;\n  let lastScript: string | undefined;\n\n  for (let i = 0; i < config.max_iterations; i++) {\n    // 1. Think — ask LLM for ASH script\n    let thinkResult: any;\n    try {\n      const messages: any[] = [];\n      if (i === 0) {\n        messages.push({ role: \"system\", content: buildSystemPrompt({ max_iterations: config.max_iterations }) });\n        messages.push({ role: \"user\", content: config.intent });\n      } else {\n        messages.push({ role: \"user\", content: buildCorrectionPrompt(lastFailure!, lastScript!) });\n      }\n      thinkResult = await config.think({ messages });\n    } catch (err: any) {\n      return { status: \"error\", iterations: i + 1, mode, observations, error: err.message };\n    }\n\n    // 2. Extract script from tool call or content\n    const script = extractScript(thinkResult);\n    if (!script) {\n      const obs = { iteration: i + 1, error: \"empty_response\" };\n      observations.push(obs);\n      await config.observe(obs);\n      // If no script, treat as failure for this iteration\n      if (i === config.max_iterations - 1) {\n        return { status: \"error\", iterations: i + 1, mode, observations, error: \"LLM returned no script\" };\n      }\n      // Create a synthetic failure for correction\n      lastFailure = {\n        status: \"error\",\n        steps: [],\n        failedAt: { kind: \"RuntimeError\", message: \"LLM returned no ASH script\" } as AshTypedError,\n        duration_ms: 0,\n      };\n      lastScript = \"\";\n      continue;\n    }\n\n    lastScript = script;\n\n    // 3. Validate\n    const errors = await config.validate(script);\n    if (errors.length > 0) {\n      const obs = { iteration: i + 1, script, validation_errors: errors };\n      observations.push(obs);\n      await config.observe(obs);\n\n      if (i === config.max_iterations - 1) {\n        return {\n          status: \"error\",\n          iterations: i + 1,\n          mode,\n          observations,\n          finalResult: {\n            status: \"error\",\n            steps: [],\n            failedAt: errors[0],\n            duration_ms: 0,\n          },\n        };\n      }\n\n      lastFailure = {\n        status: \"error\",\n        steps: [],\n        failedAt: errors[0] as AshTypedError,\n        duration_ms: 0,\n      };\n      continue;\n    }\n\n    // 4. Run\n    const result = await config.runner(script);\n\n    // 5. Observe\n    const obs = { iteration: i + 1, script, result };\n    observations.push(obs);\n    await config.observe(obs);\n\n    // 6. Check result\n    if (result.status === \"ok\") {\n      return { status: \"ok\", iterations: i + 1, mode, finalResult: result, observations };\n    }\n\n    // Failed — prepare for correction\n    lastFailure = result as AshRunFailure;\n  }\n\n  // Exhausted all iterations\n  return {\n    status: \"error\",\n    iterations: config.max_iterations,\n    mode,\n    finalResult: lastFailure,\n    observations,\n  };\n}\n\nfunction extractScript(thinkResult: any): string | undefined {\n  // Try tool_calls first (ash_run call)\n  const toolCalls = thinkResult?.response?.tool_calls;\n  if (Array.isArray(toolCalls)) {\n    for (const tc of toolCalls) {\n      if (tc.name === \"ash_run\") {\n        try {\n          const args = typeof tc.arguments === \"string\" ? JSON.parse(tc.arguments) : tc.arguments;\n          if (args?.script) return args.script;\n        } catch { /* ignore parse error */ }\n      }\n    }\n  }\n  // Fall back to content\n  const content = thinkResult?.response?.content;\n  if (typeof content === \"string\" && content.trim()) return content.trim();\n  return undefined;\n}\n"],"mappings":";;;;;;AAmCA,eAAsB,WAAW,QAA+C;CAC9E,MAAM,OAAO,OAAO,QAAQ;CAC5B,MAAM,eAAsB,EAAE;CAC9B,IAAI;CACJ,IAAI;AAEJ,MAAK,IAAI,IAAI,GAAG,IAAI,OAAO,gBAAgB,KAAK;EAE9C,IAAI;AACJ,MAAI;GACF,MAAM,WAAkB,EAAE;AAC1B,OAAI,MAAM,GAAG;AACX,aAAS,KAAK;KAAE,MAAM;KAAU,SAAS,kBAAkB,EAAE,gBAAgB,OAAO,gBAAgB,CAAC;KAAE,CAAC;AACxG,aAAS,KAAK;KAAE,MAAM;KAAQ,SAAS,OAAO;KAAQ,CAAC;SAEvD,UAAS,KAAK;IAAE,MAAM;IAAQ,SAAS,sBAAsB,aAAc,WAAY;IAAE,CAAC;AAE5F,iBAAc,MAAM,OAAO,MAAM,EAAE,UAAU,CAAC;WACvC,KAAU;AACjB,UAAO;IAAE,QAAQ;IAAS,YAAY,IAAI;IAAG;IAAM;IAAc,OAAO,IAAI;IAAS;;EAIvF,MAAM,SAAS,cAAc,YAAY;AACzC,MAAI,CAAC,QAAQ;GACX,MAAMA,QAAM;IAAE,WAAW,IAAI;IAAG,OAAO;IAAkB;AACzD,gBAAa,KAAKA,MAAI;AACtB,SAAM,OAAO,QAAQA,MAAI;AAEzB,OAAI,MAAM,OAAO,iBAAiB,EAChC,QAAO;IAAE,QAAQ;IAAS,YAAY,IAAI;IAAG;IAAM;IAAc,OAAO;IAA0B;AAGpG,iBAAc;IACZ,QAAQ;IACR,OAAO,EAAE;IACT,UAAU;KAAE,MAAM;KAAgB,SAAS;KAA8B;IACzE,aAAa;IACd;AACD,gBAAa;AACb;;AAGF,eAAa;EAGb,MAAM,SAAS,MAAM,OAAO,SAAS,OAAO;AAC5C,MAAI,OAAO,SAAS,GAAG;GACrB,MAAMA,QAAM;IAAE,WAAW,IAAI;IAAG;IAAQ,mBAAmB;IAAQ;AACnE,gBAAa,KAAKA,MAAI;AACtB,SAAM,OAAO,QAAQA,MAAI;AAEzB,OAAI,MAAM,OAAO,iBAAiB,EAChC,QAAO;IACL,QAAQ;IACR,YAAY,IAAI;IAChB;IACA;IACA,aAAa;KACX,QAAQ;KACR,OAAO,EAAE;KACT,UAAU,OAAO;KACjB,aAAa;KACd;IACF;AAGH,iBAAc;IACZ,QAAQ;IACR,OAAO,EAAE;IACT,UAAU,OAAO;IACjB,aAAa;IACd;AACD;;EAIF,MAAM,SAAS,MAAM,OAAO,OAAO,OAAO;EAG1C,MAAM,MAAM;GAAE,WAAW,IAAI;GAAG;GAAQ;GAAQ;AAChD,eAAa,KAAK,IAAI;AACtB,QAAM,OAAO,QAAQ,IAAI;AAGzB,MAAI,OAAO,WAAW,KACpB,QAAO;GAAE,QAAQ;GAAM,YAAY,IAAI;GAAG;GAAM,aAAa;GAAQ;GAAc;AAIrF,gBAAc;;AAIhB,QAAO;EACL,QAAQ;EACR,YAAY,OAAO;EACnB;EACA,aAAa;EACb;EACD;;AAGH,SAAS,cAAc,aAAsC;CAE3D,MAAM,YAAY,aAAa,UAAU;AACzC,KAAI,MAAM,QAAQ,UAAU,EAC1B;OAAK,MAAM,MAAM,UACf,KAAI,GAAG,SAAS,UACd,KAAI;GACF,MAAM,OAAO,OAAO,GAAG,cAAc,WAAW,KAAK,MAAM,GAAG,UAAU,GAAG,GAAG;AAC9E,OAAI,MAAM,OAAQ,QAAO,KAAK;UACxB;;CAKd,MAAM,UAAU,aAAa,UAAU;AACvC,KAAI,OAAO,YAAY,YAAY,QAAQ,MAAM,CAAE,QAAO,QAAQ,MAAM"}

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

@@ -0,0 +1,24 @@
+const require_system_prompt = require('./system-prompt.cjs');
+const require_dev_loop = require('./dev-loop.cjs');
+const require_ash_typed_error = require('./ash-typed-error.cjs');
+const require_structured_runner = require('./structured-runner.cjs');
+const require_ash_validate = require('./ash-validate.cjs');
+const require_ash_run_result = require('./ash-run-result.cjs');
+const require_live_mode = require('./live-mode.cjs');
+const require_meta_tools = require('./meta-tools.cjs');
+
+exports.META_TOOL_DEFS = require_meta_tools.META_TOOL_DEFS;
+exports.ashExplainErrorToolDef = require_meta_tools.ashExplainErrorToolDef;
+exports.ashRunToolDef = require_meta_tools.ashRunToolDef;
+exports.ashValidate = require_ash_validate.ashValidate;
+exports.ashValidateToolDef = require_meta_tools.ashValidateToolDef;
+exports.buildCorrectionPrompt = require_system_prompt.buildCorrectionPrompt;
+exports.buildSystemPrompt = require_system_prompt.buildSystemPrompt;
+exports.checkLivePermission = require_live_mode.checkLivePermission;
+exports.executeMetaTool = require_meta_tools.executeMetaTool;
+exports.fromJobError = require_ash_typed_error.fromJobError;
+exports.isAshRunFailure = require_ash_run_result.isAshRunFailure;
+exports.isAshRunSuccess = require_ash_run_result.isAshRunSuccess;
+exports.isAshTypedError = require_ash_typed_error.isAshTypedError;
+exports.runDevLoop = require_dev_loop.runDevLoop;
+exports.runStructured = require_structured_runner.runStructured;

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

@@ -0,0 +1,9 @@
+import { AshTypedError, fromJobError, isAshTypedError } from "./ash-typed-error.cjs";
+import { AshRunFailure, AshRunResult, AshRunSuccess, AshStepResult, isAshRunFailure, isAshRunSuccess } from "./ash-run-result.cjs";
+import { DevLoopConfig, DevLoopResult, runDevLoop } from "./dev-loop.cjs";
+import { runStructured } from "./structured-runner.cjs";
+import { ashValidate } from "./ash-validate.cjs";
+import { LiveModePolicy, checkLivePermission } from "./live-mode.cjs";
+import { buildCorrectionPrompt, buildSystemPrompt } from "./system-prompt.cjs";
+import { META_TOOL_DEFS, ashExplainErrorToolDef, ashRunToolDef, ashValidateToolDef, executeMetaTool } from "./meta-tools.cjs";
+export { type AshRunFailure, type AshRunResult, type AshRunSuccess, type AshStepResult, type AshTypedError, type DevLoopConfig, type DevLoopResult, type LiveModePolicy, META_TOOL_DEFS, ashExplainErrorToolDef, ashRunToolDef, ashValidate, ashValidateToolDef, buildCorrectionPrompt, buildSystemPrompt, checkLivePermission, executeMetaTool, fromJobError, isAshRunFailure, isAshRunSuccess, isAshTypedError, runDevLoop, runStructured };

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

@@ -0,0 +1,9 @@
+import { AshTypedError, fromJobError, isAshTypedError } from "./ash-typed-error.mjs";
+import { AshRunFailure, AshRunResult, AshRunSuccess, AshStepResult, isAshRunFailure, isAshRunSuccess } from "./ash-run-result.mjs";
+import { DevLoopConfig, DevLoopResult, runDevLoop } from "./dev-loop.mjs";
+import { runStructured } from "./structured-runner.mjs";
+import { ashValidate } from "./ash-validate.mjs";
+import { LiveModePolicy, checkLivePermission } from "./live-mode.mjs";
+import { buildCorrectionPrompt, buildSystemPrompt } from "./system-prompt.mjs";
+import { META_TOOL_DEFS, ashExplainErrorToolDef, ashRunToolDef, ashValidateToolDef, executeMetaTool } from "./meta-tools.mjs";
+export { type AshRunFailure, type AshRunResult, type AshRunSuccess, type AshStepResult, type AshTypedError, type DevLoopConfig, type DevLoopResult, type LiveModePolicy, META_TOOL_DEFS, ashExplainErrorToolDef, ashRunToolDef, ashValidate, ashValidateToolDef, buildCorrectionPrompt, buildSystemPrompt, checkLivePermission, executeMetaTool, fromJobError, isAshRunFailure, isAshRunSuccess, isAshTypedError, runDevLoop, runStructured };

package/dist/ai-dev-loop/index.mjs

@@ -0,0 +1,10 @@
+import { buildCorrectionPrompt, buildSystemPrompt } from "./system-prompt.mjs";
+import { runDevLoop } from "./dev-loop.mjs";
+import { fromJobError, isAshTypedError } from "./ash-typed-error.mjs";
+import { runStructured } from "./structured-runner.mjs";
+import { ashValidate } from "./ash-validate.mjs";
+import { isAshRunFailure, isAshRunSuccess } from "./ash-run-result.mjs";
+import { checkLivePermission } from "./live-mode.mjs";
+import { META_TOOL_DEFS, ashExplainErrorToolDef, ashRunToolDef, ashValidateToolDef, executeMetaTool } from "./meta-tools.mjs";
+
+export { META_TOOL_DEFS, ashExplainErrorToolDef, ashRunToolDef, ashValidate, ashValidateToolDef, buildCorrectionPrompt, buildSystemPrompt, checkLivePermission, executeMetaTool, fromJobError, isAshRunFailure, isAshRunSuccess, isAshTypedError, runDevLoop, runStructured };

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

@@ -0,0 +1,17 @@
+
+//#region src/ai-dev-loop/live-mode.ts
+/**
+* Check if live mode is permitted. Checks in priority order:
+* 1. Capability (ash.live)
+* 2. Debug flag
+* 3. User confirmation
+*/
+async function checkLivePermission(policy) {
+	if (policy.capabilities.has("ash.live")) return true;
+	if (policy.debug) return true;
+	if (policy.confirm) return policy.confirm();
+	return false;
+}
+
+//#endregion
+exports.checkLivePermission = checkLivePermission;

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

@@ -0,0 +1,24 @@
+//#region src/ai-dev-loop/live-mode.d.ts
+/**
+ * Live Mode Permission — gates upgrade from dry-run to live execution.
+ *
+ * Per INTENT §6.1, live mode requires one of:
+ * a) ash.live capability in proc caps
+ * b) User confirmation callback
+ * c) Debug profile flag
+ */
+interface LiveModePolicy {
+  capabilities: Set<string>;
+  confirm?: () => Promise<boolean>;
+  debug?: boolean;
+}
+/**
+ * Check if live mode is permitted. Checks in priority order:
+ * 1. Capability (ash.live)
+ * 2. Debug flag
+ * 3. User confirmation
+ */
+declare function checkLivePermission(policy: LiveModePolicy): Promise<boolean>;
+//#endregion
+export { LiveModePolicy, checkLivePermission };
+//# sourceMappingURL=live-mode.d.cts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"live-mode.d.cts","names":[],"sources":["../../src/ai-dev-loop/live-mode.ts"],"mappings":";;AASA;;;;;;;UAAiB,cAAA;EACf,YAAA,EAAc,GAAA;EACd,OAAA,SAAgB,OAAA;EAChB,KAAA;AAAA;;;;;;;iBASoB,mBAAA,CAAoB,MAAA,EAAQ,cAAA,GAAiB,OAAA"}

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

@@ -0,0 +1,24 @@
+//#region src/ai-dev-loop/live-mode.d.ts
+/**
+ * Live Mode Permission — gates upgrade from dry-run to live execution.
+ *
+ * Per INTENT §6.1, live mode requires one of:
+ * a) ash.live capability in proc caps
+ * b) User confirmation callback
+ * c) Debug profile flag
+ */
+interface LiveModePolicy {
+  capabilities: Set<string>;
+  confirm?: () => Promise<boolean>;
+  debug?: boolean;
+}
+/**
+ * Check if live mode is permitted. Checks in priority order:
+ * 1. Capability (ash.live)
+ * 2. Debug flag
+ * 3. User confirmation
+ */
+declare function checkLivePermission(policy: LiveModePolicy): Promise<boolean>;
+//#endregion
+export { LiveModePolicy, checkLivePermission };
+//# sourceMappingURL=live-mode.d.mts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"live-mode.d.mts","names":[],"sources":["../../src/ai-dev-loop/live-mode.ts"],"mappings":";;AASA;;;;;;;UAAiB,cAAA;EACf,YAAA,EAAc,GAAA;EACd,OAAA,SAAgB,OAAA;EAChB,KAAA;AAAA;;;;;;;iBASoB,mBAAA,CAAoB,MAAA,EAAQ,cAAA,GAAiB,OAAA"}

package/dist/ai-dev-loop/live-mode.mjs

@@ -0,0 +1,17 @@
+//#region src/ai-dev-loop/live-mode.ts
+/**
+* Check if live mode is permitted. Checks in priority order:
+* 1. Capability (ash.live)
+* 2. Debug flag
+* 3. User confirmation
+*/
+async function checkLivePermission(policy) {
+	if (policy.capabilities.has("ash.live")) return true;
+	if (policy.debug) return true;
+	if (policy.confirm) return policy.confirm();
+	return false;
+}
+
+//#endregion
+export { checkLivePermission };
+//# sourceMappingURL=live-mode.mjs.map

package/dist/ai-dev-loop/live-mode.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"live-mode.mjs","names":[],"sources":["../../src/ai-dev-loop/live-mode.ts"],"sourcesContent":["/**\n * Live Mode Permission — gates upgrade from dry-run to live execution.\n *\n * Per INTENT §6.1, live mode requires one of:\n * a) ash.live capability in proc caps\n * b) User confirmation callback\n * c) Debug profile flag\n */\n\nexport interface LiveModePolicy {\n  capabilities: Set<string>;\n  confirm?: () => Promise<boolean>;\n  debug?: boolean;\n}\n\n/**\n * Check if live mode is permitted. Checks in priority order:\n * 1. Capability (ash.live)\n * 2. Debug flag\n * 3. User confirmation\n */\nexport async function checkLivePermission(policy: LiveModePolicy): Promise<boolean> {\n  // 1. Capability takes priority\n  if (policy.capabilities.has(\"ash.live\")) return true;\n\n  // 2. Debug profile\n  if (policy.debug) return true;\n\n  // 3. User confirmation\n  if (policy.confirm) return policy.confirm();\n\n  return false;\n}\n"],"mappings":";;;;;;;AAqBA,eAAsB,oBAAoB,QAA0C;AAElF,KAAI,OAAO,aAAa,IAAI,WAAW,CAAE,QAAO;AAGhD,KAAI,OAAO,MAAO,QAAO;AAGzB,KAAI,OAAO,QAAS,QAAO,OAAO,SAAS;AAE3C,QAAO"}

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

@@ -0,0 +1,123 @@
+const require_ash_typed_error = require('./ash-typed-error.cjs');
+const require_structured_runner = require('./structured-runner.cjs');
+const require_ash_validate = require('./ash-validate.cjs');
+
+//#region src/ai-dev-loop/meta-tools.ts
+const ashRunToolDef = {
+	name: "ash_run",
+	description: "Execute an ASH script. Default mode is dry-run (no side effects).",
+	parameters: {
+		type: "object",
+		properties: {
+			script: {
+				type: "string",
+				description: "ASH script source code"
+			},
+			mode: {
+				type: "string",
+				enum: ["dry-run", "live"],
+				description: "Execution mode. Default: dry-run"
+			},
+			timeout_ms: {
+				type: "number",
+				description: "Timeout in milliseconds. Default: 30000"
+			}
+		},
+		required: ["script"]
+	}
+};
+const ashValidateToolDef = {
+	name: "ash_validate",
+	description: "Validate an ASH script for syntax and type errors without executing it.",
+	parameters: {
+		type: "object",
+		properties: { script: {
+			type: "string",
+			description: "ASH script source code to validate"
+		} },
+		required: ["script"]
+	}
+};
+const ashExplainErrorToolDef = {
+	name: "ash_explain_error",
+	description: "Get a human-readable explanation of an ASH error with repair suggestions.",
+	parameters: {
+		type: "object",
+		properties: { error: { description: "The AshTypedError object to explain" } },
+		required: ["error"]
+	}
+};
+const META_TOOL_DEFS = [
+	ashRunToolDef,
+	ashValidateToolDef,
+	ashExplainErrorToolDef
+];
+/**
+* Execute a meta tool by name.
+*/
+async function executeMetaTool(name, args, ctx) {
+	switch (name) {
+		case "ash_run":
+			if (!args.script || typeof args.script !== "string") throw new Error("ash_run: script field is required and must be a string");
+			return require_structured_runner.runStructured(args.script, ctx, {
+				mode: args.mode ?? "dry-run",
+				timeout_ms: args.timeout_ms ?? 3e4
+			});
+		case "ash_validate":
+			if (!args.script || typeof args.script !== "string") throw new Error("ash_validate: script field is required and must be a string");
+			return require_ash_validate.ashValidate(args.script);
+		case "ash_explain_error": {
+			const error = args.error;
+			if (require_ash_typed_error.isAshTypedError(error)) return explainTypedError(error);
+			return {
+				explanation: `Unknown error: ${JSON.stringify(error)}`,
+				suggestion: "Check the error details."
+			};
+		}
+		default: throw new Error(`Unknown meta tool: ${name}`);
+	}
+}
+function explainTypedError(error) {
+	switch (error.kind) {
+		case "IntentDenied": return {
+			explanation: `IntentDenied: ${error.message}. Violated invariant: ${error.invariant}.`,
+			suggestion: error.suggestion ?? "Check the action permissions."
+		};
+		case "CapabilityMissing": return {
+			explanation: `CapabilityMissing: Required capability "${error.capability}" is not available.`,
+			suggestion: "Request the capability or use a different approach."
+		};
+		case "ToolNotFound": return {
+			explanation: `ToolNotFound: Tool "${error.name}" not found. Available: [${error.available?.join(", ")}].`,
+			suggestion: "Use one of the available tools."
+		};
+		case "ValidationFailed": return {
+			explanation: `ValidationFailed: Field "${error.field}" expected ${error.expected}, got ${error.got}.`,
+			suggestion: "Fix the field value to match the expected type."
+		};
+		case "BudgetExceeded": return {
+			explanation: `BudgetExceeded: Device "${error.device}" used ${error.used}/${error.limit}.`,
+			suggestion: "Reduce token usage or wait for budget reset."
+		};
+		case "Timeout": return {
+			explanation: `Timeout: Step "${error.step}" exceeded ${error.limit_ms}ms limit.`,
+			suggestion: "Simplify the query or increase the timeout."
+		};
+		case "ParseError": return {
+			explanation: `ParseError: ${error.message}${error.line ? ` at line ${error.line}` : ""}.`,
+			suggestion: "Fix the syntax error in the ASH script."
+		};
+		case "RuntimeError": return {
+			explanation: `RuntimeError: ${error.message}.`,
+			suggestion: "Check the runtime context and data."
+		};
+		default: return { explanation: `Error: ${error.message ?? JSON.stringify(error)}` };
+	}
+}
+
+//#endregion
+exports.META_TOOL_DEFS = META_TOOL_DEFS;
+exports.ashExplainErrorToolDef = ashExplainErrorToolDef;
+exports.ashRunToolDef = ashRunToolDef;
+exports.ashValidateToolDef = ashValidateToolDef;
+exports.executeMetaTool = executeMetaTool;

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

@@ -0,0 +1,24 @@
+import { JobContext } from "../compiler.cjs";
+
+//#region src/ai-dev-loop/meta-tools.d.ts
+/**
+ * Meta Tools — LLM-callable tool definitions for ASH AI Dev Loop.
+ *
+ * These tools are Proc-internal, not registered in Discovery.
+ */
+interface LLMToolDef {
+  name: string;
+  description?: string;
+  parameters?: unknown;
+}
+declare const ashRunToolDef: LLMToolDef;
+declare const ashValidateToolDef: LLMToolDef;
+declare const ashExplainErrorToolDef: LLMToolDef;
+declare const META_TOOL_DEFS: LLMToolDef[];
+/**
+ * Execute a meta tool by name.
+ */
+declare function executeMetaTool(name: string, args: Record<string, unknown>, ctx: JobContext): Promise<any>;
+//#endregion
+export { META_TOOL_DEFS, ashExplainErrorToolDef, ashRunToolDef, ashValidateToolDef, executeMetaTool };
+//# sourceMappingURL=meta-tools.d.cts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"meta-tools.d.cts","names":[],"sources":["../../src/ai-dev-loop/meta-tools.ts"],"mappings":";;;;;;;;UAOU,UAAA;EACR,IAAA;EACA,WAAA;EACA,UAAA;AAAA;AAAA,cAOW,aAAA,EAAe,UAAA;AAAA,cAcf,kBAAA,EAAoB,UAAA;AAAA,cAYpB,sBAAA,EAAwB,UAAA;AAAA,cAYxB,cAAA,EAAc,UAAA;;;AAxB3B;iBA6BsB,eAAA,CACpB,IAAA,UACA,IAAA,EAAM,MAAA,mBACN,GAAA,EAAK,UAAA,GACJ,OAAA"}

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

@@ -0,0 +1,24 @@
+import { JobContext } from "../compiler.mjs";
+
+//#region src/ai-dev-loop/meta-tools.d.ts
+/**
+ * Meta Tools — LLM-callable tool definitions for ASH AI Dev Loop.
+ *
+ * These tools are Proc-internal, not registered in Discovery.
+ */
+interface LLMToolDef {
+  name: string;
+  description?: string;
+  parameters?: unknown;
+}
+declare const ashRunToolDef: LLMToolDef;
+declare const ashValidateToolDef: LLMToolDef;
+declare const ashExplainErrorToolDef: LLMToolDef;
+declare const META_TOOL_DEFS: LLMToolDef[];
+/**
+ * Execute a meta tool by name.
+ */
+declare function executeMetaTool(name: string, args: Record<string, unknown>, ctx: JobContext): Promise<any>;
+//#endregion
+export { META_TOOL_DEFS, ashExplainErrorToolDef, ashRunToolDef, ashValidateToolDef, executeMetaTool };
+//# sourceMappingURL=meta-tools.d.mts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"meta-tools.d.mts","names":[],"sources":["../../src/ai-dev-loop/meta-tools.ts"],"mappings":";;;;;;;;UAOU,UAAA;EACR,IAAA;EACA,WAAA;EACA,UAAA;AAAA;AAAA,cAOW,aAAA,EAAe,UAAA;AAAA,cAcf,kBAAA,EAAoB,UAAA;AAAA,cAYpB,sBAAA,EAAwB,UAAA;AAAA,cAYxB,cAAA,EAAc,UAAA;;;AAxB3B;iBA6BsB,eAAA,CACpB,IAAA,UACA,IAAA,EAAM,MAAA,mBACN,GAAA,EAAK,UAAA,GACJ,OAAA"}

package/dist/ai-dev-loop/meta-tools.mjs

@@ -0,0 +1,120 @@
+import { isAshTypedError } from "./ash-typed-error.mjs";
+import { runStructured } from "./structured-runner.mjs";
+import { ashValidate } from "./ash-validate.mjs";
+
+//#region src/ai-dev-loop/meta-tools.ts
+const ashRunToolDef = {
+	name: "ash_run",
+	description: "Execute an ASH script. Default mode is dry-run (no side effects).",
+	parameters: {
+		type: "object",
+		properties: {
+			script: {
+				type: "string",
+				description: "ASH script source code"
+			},
+			mode: {
+				type: "string",
+				enum: ["dry-run", "live"],
+				description: "Execution mode. Default: dry-run"
+			},
+			timeout_ms: {
+				type: "number",
+				description: "Timeout in milliseconds. Default: 30000"
+			}
+		},
+		required: ["script"]
+	}
+};
+const ashValidateToolDef = {
+	name: "ash_validate",
+	description: "Validate an ASH script for syntax and type errors without executing it.",
+	parameters: {
+		type: "object",
+		properties: { script: {
+			type: "string",
+			description: "ASH script source code to validate"
+		} },
+		required: ["script"]
+	}
+};
+const ashExplainErrorToolDef = {
+	name: "ash_explain_error",
+	description: "Get a human-readable explanation of an ASH error with repair suggestions.",
+	parameters: {
+		type: "object",
+		properties: { error: { description: "The AshTypedError object to explain" } },
+		required: ["error"]
+	}
+};
+const META_TOOL_DEFS = [
+	ashRunToolDef,
+	ashValidateToolDef,
+	ashExplainErrorToolDef
+];
+/**
+* Execute a meta tool by name.
+*/
+async function executeMetaTool(name, args, ctx) {
+	switch (name) {
+		case "ash_run":
+			if (!args.script || typeof args.script !== "string") throw new Error("ash_run: script field is required and must be a string");
+			return runStructured(args.script, ctx, {
+				mode: args.mode ?? "dry-run",
+				timeout_ms: args.timeout_ms ?? 3e4
+			});
+		case "ash_validate":
+			if (!args.script || typeof args.script !== "string") throw new Error("ash_validate: script field is required and must be a string");
+			return ashValidate(args.script);
+		case "ash_explain_error": {
+			const error = args.error;
+			if (isAshTypedError(error)) return explainTypedError(error);
+			return {
+				explanation: `Unknown error: ${JSON.stringify(error)}`,
+				suggestion: "Check the error details."
+			};
+		}
+		default: throw new Error(`Unknown meta tool: ${name}`);
+	}
+}
+function explainTypedError(error) {
+	switch (error.kind) {
+		case "IntentDenied": return {
+			explanation: `IntentDenied: ${error.message}. Violated invariant: ${error.invariant}.`,
+			suggestion: error.suggestion ?? "Check the action permissions."
+		};
+		case "CapabilityMissing": return {
+			explanation: `CapabilityMissing: Required capability "${error.capability}" is not available.`,
+			suggestion: "Request the capability or use a different approach."
+		};
+		case "ToolNotFound": return {
+			explanation: `ToolNotFound: Tool "${error.name}" not found. Available: [${error.available?.join(", ")}].`,
+			suggestion: "Use one of the available tools."
+		};
+		case "ValidationFailed": return {
+			explanation: `ValidationFailed: Field "${error.field}" expected ${error.expected}, got ${error.got}.`,
+			suggestion: "Fix the field value to match the expected type."
+		};
+		case "BudgetExceeded": return {
+			explanation: `BudgetExceeded: Device "${error.device}" used ${error.used}/${error.limit}.`,
+			suggestion: "Reduce token usage or wait for budget reset."
+		};
+		case "Timeout": return {
+			explanation: `Timeout: Step "${error.step}" exceeded ${error.limit_ms}ms limit.`,
+			suggestion: "Simplify the query or increase the timeout."
+		};
+		case "ParseError": return {
+			explanation: `ParseError: ${error.message}${error.line ? ` at line ${error.line}` : ""}.`,
+			suggestion: "Fix the syntax error in the ASH script."
+		};
+		case "RuntimeError": return {
+			explanation: `RuntimeError: ${error.message}.`,
+			suggestion: "Check the runtime context and data."
+		};
+		default: return { explanation: `Error: ${error.message ?? JSON.stringify(error)}` };
+	}
+}
+
+//#endregion
+export { META_TOOL_DEFS, ashExplainErrorToolDef, ashRunToolDef, ashValidateToolDef, executeMetaTool };
+//# sourceMappingURL=meta-tools.mjs.map

package/dist/ai-dev-loop/meta-tools.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"meta-tools.mjs","names":[],"sources":["../../src/ai-dev-loop/meta-tools.ts"],"sourcesContent":["/**\n * Meta Tools — LLM-callable tool definitions for ASH AI Dev Loop.\n *\n * These tools are Proc-internal, not registered in Discovery.\n */\n\n// Tool definition type inline (avoid circular dependency with kernel)\ninterface LLMToolDef {\n  name: string;\n  description?: string;\n  parameters?: unknown;\n}\nimport type { JobContext } from \"../compiler.js\";\nimport { runStructured } from \"./structured-runner.js\";\nimport { ashValidate } from \"./ash-validate.js\";\nimport { isAshTypedError } from \"./ash-typed-error.js\";\n\nexport const ashRunToolDef: LLMToolDef = {\n  name: \"ash_run\",\n  description: \"Execute an ASH script. Default mode is dry-run (no side effects).\",\n  parameters: {\n    type: \"object\",\n    properties: {\n      script: { type: \"string\", description: \"ASH script source code\" },\n      mode: { type: \"string\", enum: [\"dry-run\", \"live\"], description: \"Execution mode. Default: dry-run\" },\n      timeout_ms: { type: \"number\", description: \"Timeout in milliseconds. Default: 30000\" },\n    },\n    required: [\"script\"],\n  },\n};\n\nexport const ashValidateToolDef: LLMToolDef = {\n  name: \"ash_validate\",\n  description: \"Validate an ASH script for syntax and type errors without executing it.\",\n  parameters: {\n    type: \"object\",\n    properties: {\n      script: { type: \"string\", description: \"ASH script source code to validate\" },\n    },\n    required: [\"script\"],\n  },\n};\n\nexport const ashExplainErrorToolDef: LLMToolDef = {\n  name: \"ash_explain_error\",\n  description: \"Get a human-readable explanation of an ASH error with repair suggestions.\",\n  parameters: {\n    type: \"object\",\n    properties: {\n      error: { description: \"The AshTypedError object to explain\" },\n    },\n    required: [\"error\"],\n  },\n};\n\nexport const META_TOOL_DEFS = [ashRunToolDef, ashValidateToolDef, ashExplainErrorToolDef];\n\n/**\n * Execute a meta tool by name.\n */\nexport async function executeMetaTool(\n  name: string,\n  args: Record<string, unknown>,\n  ctx: JobContext,\n): Promise<any> {\n  switch (name) {\n    case \"ash_run\": {\n      if (!args.script || typeof args.script !== \"string\") {\n        throw new Error(\"ash_run: script field is required and must be a string\");\n      }\n      return runStructured(args.script as string, ctx, {\n        mode: (args.mode as \"dry-run\" | \"live\") ?? \"dry-run\",\n        timeout_ms: (args.timeout_ms as number) ?? 30000,\n      });\n    }\n\n    case \"ash_validate\": {\n      if (!args.script || typeof args.script !== \"string\") {\n        throw new Error(\"ash_validate: script field is required and must be a string\");\n      }\n      return ashValidate(args.script as string);\n    }\n\n    case \"ash_explain_error\": {\n      const error = args.error;\n      if (isAshTypedError(error)) {\n        return explainTypedError(error);\n      }\n      return { explanation: `Unknown error: ${JSON.stringify(error)}`, suggestion: \"Check the error details.\" };\n    }\n\n    default:\n      throw new Error(`Unknown meta tool: ${name}`);\n  }\n}\n\nfunction explainTypedError(error: any): { explanation: string; suggestion?: string } {\n  switch (error.kind) {\n    case \"IntentDenied\":\n      return {\n        explanation: `IntentDenied: ${error.message}. Violated invariant: ${error.invariant}.`,\n        suggestion: error.suggestion ?? \"Check the action permissions.\",\n      };\n    case \"CapabilityMissing\":\n      return {\n        explanation: `CapabilityMissing: Required capability \"${error.capability}\" is not available.`,\n        suggestion: \"Request the capability or use a different approach.\",\n      };\n    case \"ToolNotFound\":\n      return {\n        explanation: `ToolNotFound: Tool \"${error.name}\" not found. Available: [${error.available?.join(\", \")}].`,\n        suggestion: \"Use one of the available tools.\",\n      };\n    case \"ValidationFailed\":\n      return {\n        explanation: `ValidationFailed: Field \"${error.field}\" expected ${error.expected}, got ${error.got}.`,\n        suggestion: \"Fix the field value to match the expected type.\",\n      };\n    case \"BudgetExceeded\":\n      return {\n        explanation: `BudgetExceeded: Device \"${error.device}\" used ${error.used}/${error.limit}.`,\n        suggestion: \"Reduce token usage or wait for budget reset.\",\n      };\n    case \"Timeout\":\n      return {\n        explanation: `Timeout: Step \"${error.step}\" exceeded ${error.limit_ms}ms limit.`,\n        suggestion: \"Simplify the query or increase the timeout.\",\n      };\n    case \"ParseError\":\n      return {\n        explanation: `ParseError: ${error.message}${error.line ? ` at line ${error.line}` : \"\"}.`,\n        suggestion: \"Fix the syntax error in the ASH script.\",\n      };\n    case \"RuntimeError\":\n      return {\n        explanation: `RuntimeError: ${error.message}.`,\n        suggestion: \"Check the runtime context and data.\",\n      };\n    default:\n      return { explanation: `Error: ${error.message ?? JSON.stringify(error)}` };\n  }\n}\n"],"mappings":";;;;;AAiBA,MAAa,gBAA4B;CACvC,MAAM;CACN,aAAa;CACb,YAAY;EACV,MAAM;EACN,YAAY;GACV,QAAQ;IAAE,MAAM;IAAU,aAAa;IAA0B;GACjE,MAAM;IAAE,MAAM;IAAU,MAAM,CAAC,WAAW,OAAO;IAAE,aAAa;IAAoC;GACpG,YAAY;IAAE,MAAM;IAAU,aAAa;IAA2C;GACvF;EACD,UAAU,CAAC,SAAS;EACrB;CACF;AAED,MAAa,qBAAiC;CAC5C,MAAM;CACN,aAAa;CACb,YAAY;EACV,MAAM;EACN,YAAY,EACV,QAAQ;GAAE,MAAM;GAAU,aAAa;GAAsC,EAC9E;EACD,UAAU,CAAC,SAAS;EACrB;CACF;AAED,MAAa,yBAAqC;CAChD,MAAM;CACN,aAAa;CACb,YAAY;EACV,MAAM;EACN,YAAY,EACV,OAAO,EAAE,aAAa,uCAAuC,EAC9D;EACD,UAAU,CAAC,QAAQ;EACpB;CACF;AAED,MAAa,iBAAiB;CAAC;CAAe;CAAoB;CAAuB;;;;AAKzF,eAAsB,gBACpB,MACA,MACA,KACc;AACd,SAAQ,MAAR;EACE,KAAK;AACH,OAAI,CAAC,KAAK,UAAU,OAAO,KAAK,WAAW,SACzC,OAAM,IAAI,MAAM,yDAAyD;AAE3E,UAAO,cAAc,KAAK,QAAkB,KAAK;IAC/C,MAAO,KAAK,QAA+B;IAC3C,YAAa,KAAK,cAAyB;IAC5C,CAAC;EAGJ,KAAK;AACH,OAAI,CAAC,KAAK,UAAU,OAAO,KAAK,WAAW,SACzC,OAAM,IAAI,MAAM,8DAA8D;AAEhF,UAAO,YAAY,KAAK,OAAiB;EAG3C,KAAK,qBAAqB;GACxB,MAAM,QAAQ,KAAK;AACnB,OAAI,gBAAgB,MAAM,CACxB,QAAO,kBAAkB,MAAM;AAEjC,UAAO;IAAE,aAAa,kBAAkB,KAAK,UAAU,MAAM;IAAI,YAAY;IAA4B;;EAG3G,QACE,OAAM,IAAI,MAAM,sBAAsB,OAAO;;;AAInD,SAAS,kBAAkB,OAA0D;AACnF,SAAQ,MAAM,MAAd;EACE,KAAK,eACH,QAAO;GACL,aAAa,iBAAiB,MAAM,QAAQ,wBAAwB,MAAM,UAAU;GACpF,YAAY,MAAM,cAAc;GACjC;EACH,KAAK,oBACH,QAAO;GACL,aAAa,2CAA2C,MAAM,WAAW;GACzE,YAAY;GACb;EACH,KAAK,eACH,QAAO;GACL,aAAa,uBAAuB,MAAM,KAAK,2BAA2B,MAAM,WAAW,KAAK,KAAK,CAAC;GACtG,YAAY;GACb;EACH,KAAK,mBACH,QAAO;GACL,aAAa,4BAA4B,MAAM,MAAM,aAAa,MAAM,SAAS,QAAQ,MAAM,IAAI;GACnG,YAAY;GACb;EACH,KAAK,iBACH,QAAO;GACL,aAAa,2BAA2B,MAAM,OAAO,SAAS,MAAM,KAAK,GAAG,MAAM,MAAM;GACxF,YAAY;GACb;EACH,KAAK,UACH,QAAO;GACL,aAAa,kBAAkB,MAAM,KAAK,aAAa,MAAM,SAAS;GACtE,YAAY;GACb;EACH,KAAK,aACH,QAAO;GACL,aAAa,eAAe,MAAM,UAAU,MAAM,OAAO,YAAY,MAAM,SAAS,GAAG;GACvF,YAAY;GACb;EACH,KAAK,eACH,QAAO;GACL,aAAa,iBAAiB,MAAM,QAAQ;GAC5C,YAAY;GACb;EACH,QACE,QAAO,EAAE,aAAa,UAAU,MAAM,WAAW,KAAK,UAAU,MAAM,IAAI"}