experimental-ash 0.1.0-alpha.1

package/bin/ash.d.ts

@@ -0,0 +1,59 @@
+export interface BootstrapOptions {
+  /**
+   * Absolute path to the compiled CLI module.
+   */
+  cliEntrypointPath?: string;
+
+  /**
+   * Absolute path to the script that copies static assets after compilation.
+   */
+  copyAssetsScriptPath?: string;
+
+  /**
+   * Absolute path to the ash package root.
+   */
+  packageRoot?: string;
+
+  /**
+   * Absolute path to the TypeScript CLI entrypoint used for bootstrap builds.
+   */
+  tscCliPath?: string;
+}
+
+export interface BootstrapCommandOptions {
+  cwd: string;
+}
+
+export interface BootstrapBuildDependencies {
+  exists?: (path: string) => Promise<boolean>;
+  runCommand?: (
+    command: string,
+    args: readonly string[],
+    options: BootstrapCommandOptions,
+  ) => Promise<void>;
+}
+
+export interface BootstrapCliModule {
+  runCli(argv?: string[]): Promise<void>;
+}
+
+export interface BootstrapDependencies extends BootstrapBuildDependencies {
+  importModule?: (specifier: string) => Promise<BootstrapCliModule>;
+}
+
+/**
+ * Ensures the compiled CLI entrypoint exists before the workspace bin is executed.
+ */
+export function ensureBuiltCli(
+  overrides?: BootstrapOptions,
+  dependencies?: BootstrapBuildDependencies,
+): Promise<string>;
+
+/**
+ * Runs the compiled Ash CLI, building the workspace package on demand when needed.
+ */
+export function runAshCli(
+  argv?: string[],
+  overrides?: BootstrapOptions,
+  dependencies?: BootstrapDependencies,
+): Promise<void>;

package/bin/ash.js

@@ -0,0 +1,124 @@
+#!/usr/bin/env node
+
+import { spawn } from "node:child_process";
+import { access, realpath } from "node:fs/promises";
+import { createRequire } from "node:module";
+import { dirname, resolve } from "node:path";
+import { fileURLToPath, pathToFileURL } from "node:url";
+
+const require = createRequire(import.meta.url);
+
+function createBootstrapOptions(overrides = {}) {
+  const packageRoot =
+    overrides.packageRoot ?? resolve(dirname(fileURLToPath(import.meta.url)), "..");
+
+  return {
+    cliEntrypointPath:
+      overrides.cliEntrypointPath ?? resolve(packageRoot, "dist", "src", "cli", "run.js"),
+    copyAssetsScriptPath:
+      overrides.copyAssetsScriptPath ?? resolve(packageRoot, "scripts", "copy-static-assets.mjs"),
+    packageRoot,
+    tscCliPath: overrides.tscCliPath ?? require.resolve("typescript/bin/tsc"),
+  };
+}
+
+async function fileExists(path) {
+  try {
+    await access(path);
+    return true;
+  } catch {
+    return false;
+  }
+}
+
+async function runCommand(command, args, options) {
+  await new Promise((resolveCommand, rejectCommand) => {
+    const child = spawn(command, args, {
+      cwd: options.cwd,
+      stdio: "inherit",
+    });
+
+    child.once("error", rejectCommand);
+    child.once("exit", (code, signal) => {
+      if (code === 0) {
+        resolveCommand();
+        return;
+      }
+
+      if (signal) {
+        rejectCommand(new Error(`Command "${command}" exited due to signal ${signal}.`));
+        return;
+      }
+
+      rejectCommand(new Error(`Command "${command}" exited with code ${code ?? "unknown"}.`));
+    });
+  });
+}
+
+/**
+ * Ensures the compiled CLI entrypoint exists before the workspace bin is executed.
+ */
+export async function ensureBuiltCli(overrides = {}, dependencies = {}) {
+  const options = createBootstrapOptions(overrides);
+  const exists = dependencies.exists ?? fileExists;
+  const executeCommand = dependencies.runCommand ?? runCommand;
+
+  if (await exists(options.cliEntrypointPath)) {
+    return options.cliEntrypointPath;
+  }
+
+  await executeCommand(process.execPath, [options.tscCliPath, "-p", "tsconfig.json"], {
+    cwd: options.packageRoot,
+  });
+  await executeCommand(process.execPath, [options.copyAssetsScriptPath], {
+    cwd: options.packageRoot,
+  });
+
+  if (!(await exists(options.cliEntrypointPath))) {
+    throw new Error(`Building ash did not produce ${options.cliEntrypointPath}.`);
+  }
+
+  return options.cliEntrypointPath;
+}
+
+/**
+ * Runs the compiled Ash CLI, building the workspace package on demand when needed.
+ */
+export async function runAshCli(argv = process.argv.slice(2), overrides = {}, dependencies = {}) {
+  const cliEntrypointPath = await ensureBuiltCli(overrides, dependencies);
+  const importModule = dependencies.importModule ?? ((specifier) => import(specifier));
+  const cliModule = await importModule(pathToFileURL(cliEntrypointPath).href);
+
+  if (typeof cliModule.runCli !== "function") {
+    throw new Error(`The Ash CLI module at ${cliEntrypointPath} does not export runCli().`);
+  }
+
+  await cliModule.runCli(argv);
+}
+
+async function isDirectExecution() {
+  if (!process.argv[1]) {
+    return false;
+  }
+
+  try {
+    const [currentPath, invokedPath] = await Promise.all([
+      realpath(fileURLToPath(import.meta.url)),
+      realpath(process.argv[1]),
+    ]);
+
+    return currentPath === invokedPath;
+  } catch {
+    return false;
+  }
+}
+
+if (await isDirectExecution()) {
+  try {
+    await runAshCli();
+  } catch (error) {
+    const message = error instanceof Error ? error.message : String(error);
+    console.error(message);
+    process.exitCode = 1;
+  }
+}

package/dist/src/cli/commands/info.d.ts

@@ -0,0 +1,9 @@
+interface CliInfoLogger {
+    log(message: string): void;
+}
+/**
+ * Writes resolved application details and the active message-route contract.
+ */
+export declare function printApplicationInfo(logger: CliInfoLogger, appRoot: string): Promise<void>;
+export {};
+//# sourceMappingURL=info.d.ts.map

package/dist/src/cli/commands/info.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"info.d.ts","sourceRoot":"","sources":["../../../../src/cli/commands/info.ts"],"names":[],"mappings":"AAGA,UAAU,aAAa;IACrB,GAAG,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;CAC5B;AAuCD;;GAEG;AACH,wBAAsB,oBAAoB,CAAC,MAAM,EAAE,aAAa,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CA+LhG"}

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

@@ -0,0 +1,200 @@
+import { inspectApplication } from "../../services/inspect-application.js";
+import { createCliTheme, renderCliBanner, renderCliSection } from "../ui/output.js";
+function pluralize(count, noun) {
+    return `${count} ${noun}${count === 1 ? "" : "s"}`;
+}
+function formatContextEntryLabel(entry) {
+    if (entry.kind === "context-file") {
+        return entry.mediaType === undefined ? "Context File" : `Context File (${entry.mediaType})`;
+    }
+    return "Context Module";
+}
+function formatWorkspaceEntryLabel() {
+    return "Workspace File";
+}
+function formatDiscoverySummary(errors, warnings) {
+    const errorLabel = `${errors} error${errors === 1 ? "" : "s"}`;
+    const warningLabel = `${warnings} warning${warnings === 1 ? "" : "s"}`;
+    return `${errorLabel}, ${warningLabel}`;
+}
+function resolveCompileTone(status) {
+    switch (status) {
+        case "ready":
+            return "success";
+        case "failed":
+            return "danger";
+        default:
+            return "warning";
+    }
+}
+/**
+ * Writes resolved application details and the active message-route contract.
+ */
+export async function printApplicationInfo(logger, appRoot) {
+    const inspection = await inspectApplication(appRoot);
+    const compiledState = inspection.compiledState;
+    const info = inspection.application;
+    const theme = createCliTheme();
+    const applicationRows = [
+        {
+            label: "App Root",
+            value: info.appRoot,
+        },
+    ];
+    const artifactRows = [
+        {
+            label: "Workflow Build",
+            value: info.workflowBuildDir,
+        },
+        {
+            label: "Output",
+            value: info.outputDir,
+        },
+    ];
+    const contextRows = [];
+    const workspaceRows = [];
+    if (compiledState !== null) {
+        applicationRows.push({
+            label: "Agent Root",
+            value: compiledState.project.agentRoot,
+        }, {
+            label: "Layout",
+            value: compiledState.project.layout,
+        }, {
+            label: "Compile",
+            tone: resolveCompileTone(compiledState.metadata.status),
+            value: compiledState.metadata.status,
+        }, {
+            label: "Diagnostics",
+            tone: compiledState.metadata.discovery.summary.errors > 0
+                ? "danger"
+                : compiledState.metadata.discovery.summary.warnings > 0
+                    ? "warning"
+                    : "success",
+            value: formatDiscoverySummary(compiledState.metadata.discovery.summary.errors, compiledState.metadata.discovery.summary.warnings),
+        }, {
+            label: "Context",
+            value: pluralize(compiledState.manifest.context.length, "context resource"),
+        }, {
+            label: "Workspace",
+            value: pluralize(compiledState.manifest.workspace.length, "workspace file"),
+        });
+        artifactRows.unshift({
+            label: "Compiled Manifest",
+            value: compiledState.paths.compiledManifestPath,
+        }, {
+            label: "Discovery Manifest",
+            value: compiledState.paths.discoveryManifestPath,
+        }, {
+            label: "Diagnostics",
+            value: compiledState.paths.diagnosticsPath,
+        }, {
+            label: "Module Map",
+            value: compiledState.paths.moduleMapPath,
+        }, {
+            label: "Metadata",
+            value: compiledState.paths.compileMetadataPath,
+        }, {
+            label: "Workspace",
+            value: compiledState.paths.workspaceResourcesPath,
+        });
+        contextRows.push(...(compiledState.manifest.context.length === 0
+            ? [
+                {
+                    label: "Context",
+                    value: "No context resources discovered.",
+                },
+            ]
+            : compiledState.manifest.context.map((entry) => ({
+                label: formatContextEntryLabel(entry),
+                value: entry.logicalPath,
+            }))));
+        workspaceRows.push(...(compiledState.manifest.workspace.length === 0
+            ? [
+                {
+                    label: "Workspace",
+                    value: "No workspace seed files discovered.",
+                },
+            ]
+            : compiledState.manifest.workspace.map((entry) => ({
+                label: formatWorkspaceEntryLabel(),
+                value: entry.logicalPath,
+            }))));
+    }
+    else {
+        applicationRows.push({
+            label: "Compile",
+            tone: "warning",
+            value: "unavailable",
+        });
+    }
+    logger.log([
+        renderCliBanner(theme, {
+            subtitle: "Resolved application paths and the active message contract.",
+            title: "Ash Info",
+        }),
+        "",
+        renderCliSection(theme, {
+            rows: applicationRows,
+            title: "Application",
+        }),
+        "",
+        renderCliSection(theme, {
+            rows: artifactRows,
+            title: "Artifacts",
+        }),
+        ...(compiledState === null
+            ? []
+            : [
+                "",
+                renderCliSection(theme, {
+                    rows: contextRows,
+                    title: "Context",
+                }),
+                "",
+                renderCliSection(theme, {
+                    rows: workspaceRows,
+                    title: "Workspace",
+                }),
+            ]),
+        "",
+        renderCliSection(theme, {
+            rows: [
+                {
+                    label: "Workflow ID",
+                    value: info.messageWorkflowId,
+                },
+                {
+                    label: "Source Dir",
+                    value: info.messageWorkflowSourceDir,
+                },
+                {
+                    label: "Message Route",
+                    tone: "info",
+                    value: `POST ${inspection.messaging.messageRoutePath}`,
+                },
+                {
+                    label: "Start Body",
+                    tone: "muted",
+                    value: '{"message":"<text>"}',
+                },
+                {
+                    label: "Resume Body",
+                    tone: "muted",
+                    value: `{"message":"<text>","runId":"<run-id>","action":"${inspection.messaging.nextMessageAction}"}`,
+                },
+                {
+                    label: "Stream Route",
+                    tone: "info",
+                    value: `GET ${inspection.messaging.streamRoutePattern}`,
+                },
+                {
+                    label: "Session",
+                    value: "Follow-up messages resume the same run via the message route.",
+                },
+            ],
+            title: "Messaging",
+        }),
+    ].join("\n"));
+}
+//# sourceMappingURL=info.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"info.js","sourceRoot":"","sources":["../../../../src/cli/commands/info.ts"],"names":[],"mappings":"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"}

package/dist/src/cli/dev/environment.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Development environment files loaded by `ash dev`, ordered from highest to
+ * lowest precedence.
+ */
+export declare const DEVELOPMENT_ENV_FILE_NAMES: readonly [".env.development.local", ".env.local", ".env.development", ".env"];
+/**
+ * Loads local development environment files from the application root without
+ * overriding variables that were already provided by the parent process.
+ */
+export declare function loadDevelopmentEnvironmentFiles(appRoot: string): void;
+//# sourceMappingURL=environment.d.ts.map

package/dist/src/cli/dev/environment.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"environment.d.ts","sourceRoot":"","sources":["../../../../src/cli/dev/environment.ts"],"names":[],"mappings":"AAEA;;;GAGG;AACH,eAAO,MAAM,0BAA0B,+EAK7B,CAAC;AAMX;;;GAGG;AACH,wBAAgB,+BAA+B,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAUrE"}

package/dist/src/cli/dev/environment.js

@@ -0,0 +1,31 @@
+import { join } from "node:path";
+/**
+ * Development environment files loaded by `ash dev`, ordered from highest to
+ * lowest precedence.
+ */
+export const DEVELOPMENT_ENV_FILE_NAMES = [
+    ".env.development.local",
+    ".env.local",
+    ".env.development",
+    ".env",
+];
+function isMissingEnvironmentFileError(error) {
+    return typeof error === "object" && error !== null && "code" in error && error.code === "ENOENT";
+}
+/**
+ * Loads local development environment files from the application root without
+ * overriding variables that were already provided by the parent process.
+ */
+export function loadDevelopmentEnvironmentFiles(appRoot) {
+    for (const fileName of DEVELOPMENT_ENV_FILE_NAMES) {
+        try {
+            process.loadEnvFile(join(appRoot, fileName));
+        }
+        catch (error) {
+            if (!isMissingEnvironmentFileError(error)) {
+                throw error;
+            }
+        }
+    }
+}
+//# sourceMappingURL=environment.js.map

package/dist/src/cli/dev/environment.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"environment.js","sourceRoot":"","sources":["../../../../src/cli/dev/environment.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEjC;;;GAGG;AACH,MAAM,CAAC,MAAM,0BAA0B,GAAG;IACxC,wBAAwB;IACxB,YAAY;IACZ,kBAAkB;IAClB,MAAM;CACE,CAAC;AAEX,SAAS,6BAA6B,CAAC,KAAc;IACnD,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,IAAI,MAAM,IAAI,KAAK,IAAI,KAAK,CAAC,IAAI,KAAK,QAAQ,CAAC;AACnG,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,+BAA+B,CAAC,OAAe;IAC7D,KAAK,MAAM,QAAQ,IAAI,0BAA0B,EAAE,CAAC;QAClD,IAAI,CAAC;YACH,OAAO,CAAC,WAAW,CAAC,IAAI,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC,CAAC;QAC/C,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAI,CAAC,6BAA6B,CAAC,KAAK,CAAC,EAAE,CAAC;gBAC1C,MAAM,KAAK,CAAC;YACd,CAAC;QACH,CAAC;IACH,CAAC;AACH,CAAC"}

package/dist/src/cli/dev/input.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Parsed result for one line of interactive `ash dev` input.
+ */
+export type DevReplInput = {
+    kind: "empty";
+} | {
+    kind: "exit";
+} | {
+    kind: "help";
+} | {
+    kind: "new";
+} | {
+    kind: "message";
+    message: string;
+};
+/**
+ * Parse one line of input for the minimal development REPL.
+ */
+export declare function parseDevReplInput(value: string): DevReplInput;
+//# sourceMappingURL=input.d.ts.map

package/dist/src/cli/dev/input.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"input.d.ts","sourceRoot":"","sources":["../../../../src/cli/dev/input.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,MAAM,YAAY,GACpB;IACE,IAAI,EAAE,OAAO,CAAC;CACf,GACD;IACE,IAAI,EAAE,MAAM,CAAC;CACd,GACD;IACE,IAAI,EAAE,MAAM,CAAC;CACd,GACD;IACE,IAAI,EAAE,KAAK,CAAC;CACb,GACD;IACE,IAAI,EAAE,SAAS,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;CACjB,CAAC;AAEN;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,MAAM,GAAG,YAAY,CA+B7D"}

package/dist/src/cli/dev/input.js

@@ -0,0 +1,31 @@
+/**
+ * Parse one line of input for the minimal development REPL.
+ */
+export function parseDevReplInput(value) {
+    const trimmed = value.trim();
+    if (trimmed.length === 0) {
+        return {
+            kind: "empty",
+        };
+    }
+    if (trimmed === "/exit" || trimmed === "/quit") {
+        return {
+            kind: "exit",
+        };
+    }
+    if (trimmed === "/help") {
+        return {
+            kind: "help",
+        };
+    }
+    if (trimmed === "/new") {
+        return {
+            kind: "new",
+        };
+    }
+    return {
+        kind: "message",
+        message: trimmed,
+    };
+}
+//# sourceMappingURL=input.js.map

package/dist/src/cli/dev/input.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"input.js","sourceRoot":"","sources":["../../../../src/cli/dev/input.ts"],"names":[],"mappings":"AAqBA;;GAEG;AACH,MAAM,UAAU,iBAAiB,CAAC,KAAa;IAC7C,MAAM,OAAO,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC;IAE7B,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACzB,OAAO;YACL,IAAI,EAAE,OAAO;SACd,CAAC;IACJ,CAAC;IAED,IAAI,OAAO,KAAK,OAAO,IAAI,OAAO,KAAK,OAAO,EAAE,CAAC;QAC/C,OAAO;YACL,IAAI,EAAE,MAAM;SACb,CAAC;IACJ,CAAC;IAED,IAAI,OAAO,KAAK,OAAO,EAAE,CAAC;QACxB,OAAO;YACL,IAAI,EAAE,MAAM;SACb,CAAC;IACJ,CAAC;IAED,IAAI,OAAO,KAAK,MAAM,EAAE,CAAC;QACvB,OAAO;YACL,IAAI,EAAE,KAAK;SACZ,CAAC;IACJ,CAAC;IAED,OAAO;QACL,IAAI,EAAE,SAAS;QACf,OAAO,EAAE,OAAO;KACjB,CAAC;AACJ,CAAC"}

package/dist/src/cli/dev/live-stream.d.ts

@@ -0,0 +1,2 @@
+export * from "../../services/dev-client/live-stream.js";
+//# sourceMappingURL=live-stream.d.ts.map

package/dist/src/cli/dev/live-stream.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"live-stream.d.ts","sourceRoot":"","sources":["../../../../src/cli/dev/live-stream.ts"],"names":[],"mappings":"AAAA,cAAc,0CAA0C,CAAC"}

package/dist/src/cli/dev/live-stream.js

@@ -0,0 +1,2 @@
+export * from "../../services/dev-client/live-stream.js";
+//# sourceMappingURL=live-stream.js.map

package/dist/src/cli/dev/live-stream.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"live-stream.js","sourceRoot":"","sources":["../../../../src/cli/dev/live-stream.ts"],"names":[],"mappings":"AAAA,cAAc,0CAA0C,CAAC"}

package/dist/src/cli/dev/repl.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Run the minimal interactive `ash dev` REPL against an Ash server.
+ */
+export declare function runDevelopmentRepl(input: {
+    initialRunId?: string;
+    serverUrl: string;
+}): Promise<void>;
+//# sourceMappingURL=repl.d.ts.map

package/dist/src/cli/dev/repl.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"repl.d.ts","sourceRoot":"","sources":["../../../../src/cli/dev/repl.ts"],"names":[],"mappings":"AA8PA;;GAEG;AACH,wBAAsB,kBAAkB,CAAC,KAAK,EAAE;IAC9C,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,SAAS,EAAE,MAAM,CAAC;CACnB,GAAG,OAAO,CAAC,IAAI,CAAC,CAgIhB"}