akm-cli 0.7.5 → 0.8.0-rc.6

package/dist/commands/agent-dispatch.js

@@ -0,0 +1,110 @@
+// This Source Code Form is subject to the terms of the Mozilla Public
+// License, v. 2.0. If a copy of the MPL was not distributed with this
+// file, You can obtain one at https://mozilla.org/MPL/2.0/.
+/**
+ * `akm agent <profile> [--prompt <text>] [--command <ref>] [--workflow <ref>] [args...]`
+ *
+ * Dispatch an agent by named profile, optionally injecting a prompt from
+ * inline text, a stash command: asset, or a stash workflow: asset.
+ *
+ * When none of --prompt, --command, or --workflow are given, the agent is
+ * launched interactively (no injected prompt).
+ *
+ * Template placeholders (`{{0}}`, `{{1}}`, ...) in the loaded asset body are
+ * filled from the extra positional args in order.
+ */
+import fs from "node:fs";
+import { parseAssetRef } from "../core/asset-ref";
+import { NotFoundError, UsageError } from "../core/errors";
+import { requireAgentProfile } from "../integrations/agent/config";
+import { runAgentSdk } from "../integrations/agent/sdk-runner";
+import { runAgent } from "../integrations/agent/spawn";
+/**
+ * Fill `{{0}}`, `{{1}}`, ... placeholders in `template` with the
+ * corresponding entries in `args`. Any placeholder index that exceeds the
+ * args array is left as-is.
+ */
+function fillPlaceholders(template, args) {
+    return template.replace(/\{\{(\d+)\}\}/g, (match, idx) => {
+        const i = Number.parseInt(idx, 10);
+        return i < args.length ? args[i] : match;
+    });
+}
+/**
+ * Resolve the body of an asset by ref string. The ref must parse as a
+ * valid asset ref (e.g. `command:my-cmd`, `workflow:my-flow`). The file
+ * must exist on disk (the index provides the file path).
+ *
+ * Throws `NotFoundError` when the ref cannot be resolved.
+ */
+async function resolveAssetBody(ref) {
+    let parsed;
+    try {
+        parsed = parseAssetRef(ref);
+    }
+    catch (err) {
+        throw new UsageError(`Invalid asset ref "${ref}": ${err instanceof Error ? err.message : String(err)}`, "INVALID_FLAG_VALUE");
+    }
+    // Lazy import to avoid pulling the full indexer at startup.
+    const { lookup } = await import("../indexer/indexer.js");
+    const entry = await lookup(parsed);
+    if (!entry) {
+        throw new NotFoundError(`Asset "${ref}" not found in the index. Run \`akm index\` to rebuild the index.`);
+    }
+    try {
+        return fs.readFileSync(entry.filePath, "utf8");
+    }
+    catch (err) {
+        throw new NotFoundError(`Asset "${ref}" is indexed but the file could not be read (${entry.filePath}): ${err instanceof Error ? err.message : String(err)}`);
+    }
+}
+export async function akmAgentDispatch(options) {
+    if (!options.profileName?.trim()) {
+        throw new UsageError("agent: <profile> is required.", "MISSING_REQUIRED_ARGUMENT");
+    }
+    // Resolve the profile — throws ConfigError with an actionable hint when
+    // agent config is absent or the profile is not found.
+    const profile = requireAgentProfile(options.agentConfig, options.profileName.trim());
+    // Resolve the prompt text from whichever source was provided.
+    let prompt;
+    if (options.commandRef) {
+        const body = await resolveAssetBody(options.commandRef);
+        prompt = options.args?.length ? fillPlaceholders(body, options.args) : body;
+    }
+    else if (options.workflowRef) {
+        const body = await resolveAssetBody(options.workflowRef);
+        prompt = options.args?.length ? fillPlaceholders(body, options.args) : body;
+    }
+    else if (options.prompt !== undefined) {
+        prompt = options.prompt;
+    }
+    // When prompt is undefined, the agent is launched interactively.
+    const stdio = prompt === undefined && profile.sdkMode !== true ? "interactive" : profile.stdio;
+    // Build the final dispatch request: merge the caller-supplied dispatch with
+    // the resolved prompt so the builder has all context in one place.
+    const dispatchRequest = options.dispatch
+        ? { ...options.dispatch, prompt: prompt ?? options.dispatch.prompt }
+        : undefined;
+    const runOptions = {
+        stdio,
+        parseOutput: "text",
+        ...(options.args?.length && !options.commandRef && !options.workflowRef ? { args: options.args } : {}),
+        ...(options.timeoutMs !== undefined ? { timeoutMs: options.timeoutMs } : {}),
+        ...(dispatchRequest !== undefined ? { dispatch: dispatchRequest } : {}),
+    };
+    const result = profile.sdkMode
+        ? await runAgentSdk(profile, prompt ?? "", runOptions, options.llmConfig)
+        : await runAgent(profile, prompt, runOptions);
+    return {
+        schemaVersion: 1,
+        ok: result.ok,
+        shape: "agent-result",
+        profileName: profile.name,
+        exitCode: result.exitCode,
+        stdout: result.stdout ?? "",
+        stderr: result.stderr ?? "",
+        durationMs: result.durationMs,
+        ...(result.error !== undefined ? { error: result.error } : {}),
+        ...(result.reason !== undefined ? { reason: result.reason } : {}),
+    };
+}

package/dist/commands/agent-support.js

@@ -0,0 +1,68 @@
+// This Source Code Form is subject to the terms of the Mozilla Public
+// License, v. 2.0. If a copy of the MPL was not distributed with this
+// file, You can obtain one at https://mozilla.org/MPL/2.0/.
+/**
+ * Shared helpers for agent-based commands (reflect, propose, etc.).
+ *
+ * Consolidates utility functions that were duplicated byte-for-byte across
+ * `reflect.ts` and `propose.ts`. Any command that shells out to an agent
+ * profile can import from here rather than copy-pasting.
+ */
+import { loadConfig } from "../core/config";
+import { requireAgentProfile, } from "../integrations/agent";
+// ── Config helpers ───────────────────────────────────────────────────────────
+/**
+ * Load the loaded AkmConfig from disk.
+ *
+ * After 0.8.0, the legacy `agent` top-level block was removed — the agent
+ * profile data now lives on the unified `AkmConfig` (via `profiles.agent` and
+ * `defaults.agent`). This helper remains for source-compat with callers that
+ * still expect an "AgentConfig"; it now returns the loaded `AkmConfig`.
+ */
+export function loadAgentConfigFromDisk() {
+    return loadConfig();
+}
+/**
+ * Resolve the agent profile for a command's options.
+ * Prefers an injected `agentProfile` (test seam) over the on-disk config.
+ */
+export function resolveAgentProfile(options) {
+    if (options.agentProfile)
+        return options.agentProfile;
+    const agent = options.agentConfig ?? loadAgentConfigFromDisk();
+    return requireAgentProfile(agent, options.profile);
+}
+// ── Failure helpers ──────────────────────────────────────────────────────────
+/**
+ * Base failure envelope shared by all agent command failures.
+ * Each command returns its own typed failure shape — this helper builds the
+ * common fields so per-command wrappers only need to add their own fields.
+ */
+export function baseFailureFields(result, fallbackReason = "non_zero_exit") {
+    const reason = result.reason ?? fallbackReason;
+    return {
+        schemaVersion: 1,
+        ok: false,
+        reason,
+        error: result.error ?? `agent failure (${reason})`,
+        exitCode: result.exitCode,
+        ...(result.stdout ? { stdout: result.stdout } : {}),
+        ...(result.stderr ? { stderr: result.stderr } : {}),
+    };
+}
+// ── ENOENT hint ──────────────────────────────────────────────────────────────
+/**
+ * Return `true` when a failed agent result looks like the binary was not found
+ * on PATH. Used to surface a better error message pointing the user at
+ * `akm setup`.
+ */
+export function isEnoentFailure(result) {
+    return (result.reason === "spawn_failed" &&
+        (!!result.error?.includes("ENOENT") || !!result.error?.toLowerCase().includes("not found")));
+}
+/**
+ * Build an actionable error message for a spawn-ENOENT failure.
+ */
+export function enoentHintMessage(binName) {
+    return `The agent binary '${binName}' was not found on PATH. Run \`akm setup\` to configure an agent CLI, or install ${binName} and retry.`;
+}

package/dist/commands/completions.js

@@ -1,3 +1,6 @@
+// This Source Code Form is subject to the terms of the Mozilla Public
+// License, v. 2.0. If a copy of the MPL was not distributed with this
+// file, You can obtain one at https://mozilla.org/MPL/2.0/.
 import fs from "node:fs";
 import os from "node:os";
 import path from "node:path";