axexec 1.0.0

package/dist/validate-agent.js

@@ -0,0 +1,50 @@
+/**
+ * Agent validation utilities.
+ */
+import { AGENT_CLIS, isValidAgentCli } from "axshared";
+import { getAdapter, listAdapters } from "./agents/registry.js";
+/**
+ * Validate that an agent ID is valid and the adapter is available.
+ */
+function validateAgent(agentId) {
+    if (!agentId) {
+        return {
+            ok: false,
+            exitCode: 2,
+            message: [
+                "Error: --agent is required",
+                "Usage: axexec --agent <id> <prompt>",
+                "Try 'axexec --help' for more information.",
+            ].join("\n"),
+        };
+    }
+    if (!isValidAgentCli(agentId)) {
+        return {
+            ok: false,
+            exitCode: 2,
+            message: [
+                `Error: Unknown agent '${agentId}'`,
+                `Supported agents: ${AGENT_CLIS.join(", ")}`,
+            ].join("\n"),
+        };
+    }
+    const adapter = getAdapter(agentId);
+    if (!adapter) {
+        const available = listAdapters();
+        const availableMessage = available.length > 0
+            ? `Available agents: ${available.map((a) => a.id).join(", ")}`
+            : "";
+        return {
+            ok: false,
+            exitCode: 1,
+            message: [
+                `Error: Agent '${agentId}' is not yet implemented`,
+                availableMessage,
+            ]
+                .filter(Boolean)
+                .join("\n"),
+        };
+    }
+    return { ok: true, agentId, adapter };
+}
+export { validateAgent };

package/dist/write-event.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Unified event writer for CLI output.
+ *
+ * Creates a writer function that formats and outputs events
+ * based on the resolved output mode. Uses line-buffered output
+ * for real-time streaming.
+ */
+import type { OutputMode } from "./resolve-output-mode.js";
+import type { AxexecEvent } from "./types/events.js";
+/**
+ * Creates an event writer function for the specified output mode.
+ *
+ * @param mode - The output mode (jsonl, tsv, or tsv-truncated)
+ * @returns A function that writes a single event to stdout
+ *
+ * @example
+ * const writeEvent = createEventWriter("jsonl");
+ * for await (const event of streamAgent(adapter, options)) {
+ *   writeEvent(event);
+ * }
+ */
+declare function createEventWriter(mode: OutputMode): (event: AxexecEvent) => void;
+export { createEventWriter };

package/dist/write-event.js

@@ -0,0 +1,43 @@
+/**
+ * Unified event writer for CLI output.
+ *
+ * Creates a writer function that formats and outputs events
+ * based on the resolved output mode. Uses line-buffered output
+ * for real-time streaming.
+ */
+import { formatEventTsv } from "./format-event-tsv.js";
+/**
+ * Creates an event writer function for the specified output mode.
+ *
+ * @param mode - The output mode (jsonl, tsv, or tsv-truncated)
+ * @returns A function that writes a single event to stdout
+ *
+ * @example
+ * const writeEvent = createEventWriter("jsonl");
+ * for await (const event of streamAgent(adapter, options)) {
+ *   writeEvent(event);
+ * }
+ */
+function createEventWriter(mode) {
+    switch (mode) {
+        case "jsonl": {
+            return (event) => {
+                const line = JSON.stringify(event);
+                process.stdout.write(line + "\n");
+            };
+        }
+        case "tsv": {
+            return (event) => {
+                const line = formatEventTsv(event, { truncate: false });
+                process.stdout.write(line + "\n");
+            };
+        }
+        case "tsv-truncated": {
+            return (event) => {
+                const line = formatEventTsv(event, { truncate: true });
+                process.stdout.write(line + "\n");
+            };
+        }
+    }
+}
+export { createEventWriter };

package/package.json

@@ -0,0 +1,79 @@
+{
+  "name": "axexec",
+  "author": "Łukasz Jerciński",
+  "license": "MIT",
+  "version": "1.0.0",
+  "description": "Unified CLI runner for AI coding agents with normalized event streaming",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/Jercik/axexec.git"
+  },
+  "homepage": "https://github.com/Jercik/axexec#readme",
+  "bugs": {
+    "url": "https://github.com/Jercik/axexec/issues"
+  },
+  "type": "module",
+  "bin": {
+    "axexec": "bin/axexec"
+  },
+  "files": [
+    "bin/",
+    "dist/",
+    "README.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "prepare": "git config core.hooksPath .githooks",
+    "prepublishOnly": "pnpm run rebuild",
+    "build": "tsc -p tsconfig.app.json",
+    "clean": "rm -rf dist *.tsbuildinfo",
+    "format": "prettier --write .",
+    "format:check": "prettier --check .",
+    "fta": "fta-check",
+    "knip": "knip",
+    "lint": "eslint",
+    "rebuild": "pnpm run clean && pnpm run build",
+    "start": "pnpm -s run rebuild && node bin/axexec",
+    "test": "vitest run",
+    "test:coverage": "vitest run --coverage",
+    "test:watch": "vitest",
+    "typecheck": "tsc -b --noEmit"
+  },
+  "keywords": [
+    "ai",
+    "agent",
+    "cli",
+    "runner",
+    "claude-code",
+    "codex",
+    "gemini",
+    "llm",
+    "automation",
+    "coding-assistant"
+  ],
+  "packageManager": "pnpm@10.27.0",
+  "engines": {
+    "node": ">=22.14.0"
+  },
+  "dependencies": {
+    "@commander-js/extra-typings": "^14.0.0",
+    "axconfig": "^3.6.0",
+    "axshared": "^1.9.0",
+    "commander": "^14.0.2",
+    "zod": "^4.3.5"
+  },
+  "devDependencies": {
+    "@total-typescript/ts-reset": "^0.6.1",
+    "@types/node": "^25.0.7",
+    "@vitest/coverage-v8": "^4.0.17",
+    "eslint": "^9.39.2",
+    "eslint-config-axkit": "^1.0.0",
+    "fta-check": "^1.5.1",
+    "fta-cli": "^3.0.0",
+    "knip": "^5.80.2",
+    "prettier": "3.7.4",
+    "semantic-release": "^25.0.2",
+    "typescript": "^5.9.3",
+    "vitest": "^4.0.17"
+  }
+}