archal 0.9.13 → 0.9.15

package/dist/cli.d.cts

@@ -0,0 +1 @@
+#!/usr/bin/env node

package/dist/harness.cjs

@@ -0,0 +1,62 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/harness.ts
+var harness_exports = {};
+__export(harness_exports, {
+  reportAgentMetrics: () => reportAgentMetrics
+});
+module.exports = __toCommonJS(harness_exports);
+var import_promises = require("fs/promises");
+var import_node_path = require("path");
+async function reportAgentMetrics(metrics, options = {}) {
+  assertNonNegativeInteger("inputTokens", metrics.inputTokens);
+  assertNonNegativeInteger("outputTokens", metrics.outputTokens);
+  assertNonNegativeInteger("llmCallCount", metrics.llmCallCount);
+  const metricsFile = options.metricsFile ?? process.env["AGENT_METRICS_FILE"] ?? process.env["ARCHAL_METRICS_FILE"];
+  if (!metricsFile) {
+    return false;
+  }
+  await (0, import_promises.mkdir)((0, import_node_path.dirname)(metricsFile), { recursive: true });
+  await (0, import_promises.writeFile)(
+    metricsFile,
+    JSON.stringify({
+      version: 1,
+      inputTokens: metrics.inputTokens,
+      outputTokens: metrics.outputTokens,
+      llmCallCount: metrics.llmCallCount,
+      ...nonEmptyString(metrics.provider) ? { provider: metrics.provider.trim() } : {},
+      ...nonEmptyString(metrics.model) ? { model: metrics.model.trim() } : {}
+    }),
+    "utf8"
+  );
+  return true;
+}
+function nonEmptyString(value) {
+  return typeof value === "string" && value.trim().length > 0;
+}
+function assertNonNegativeInteger(name, value) {
+  if (!Number.isSafeInteger(value) || value < 0) {
+    throw new TypeError(`${name} must be a non-negative safe integer`);
+  }
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  reportAgentMetrics
+});

package/dist/harness.d.cts

@@ -0,0 +1,20 @@
+interface AgentMetrics {
+    inputTokens: number;
+    outputTokens: number;
+    llmCallCount: number;
+    provider?: string;
+    model?: string;
+}
+interface ReportAgentMetricsOptions {
+    metricsFile?: string;
+}
+/**
+ * Write agent-side token usage for `archal run`.
+ *
+ * Archal sets AGENT_METRICS_FILE when it launches a harness. Calling this
+ * helper before the harness exits lets the dashboard show agent input/output
+ * token counts without exposing the artifact wire format to user code.
+ */
+declare function reportAgentMetrics(metrics: AgentMetrics, options?: ReportAgentMetricsOptions): Promise<boolean>;
+
+export { type AgentMetrics, type ReportAgentMetricsOptions, reportAgentMetrics };