@kody-ade/kody-engine 0.4.647 → 0.4.648

package/dist/bin/kody.js

@@ -15,7 +15,7 @@ var init_package = __esm({
   "package.json"() {
     package_default = {
       name: "@kody-ade/kody-engine",
-      version: "0.4.647",
+      version: "0.4.648",
       description: "kody \u2014 autonomous development engine. Single-session Claude Code agent behind a generic executor + declarative implementation profiles.",
       license: "MIT",
       repository: {
@@ -7397,11 +7397,14 @@ function addTokenBreakdown(left, right) {
 function createRunUsage(tokens, costUsd, details = {}) {
   if (!tokens && costUsd === void 0 && details.turns === void 0) return void 0;
   const normalizedTokens = tokenBreakdown(tokens);
+  const hasBillableUsage = normalizedTokens.total > 0 || safeNumber(costUsd) > 0;
+  const measurement = details.outcome === "failed" && !hasBillableUsage ? "unknown" : "reported";
   const modelUsage = {
     tokens: normalizedTokens,
     costUsd: safeNumber(costUsd),
     agentRuns: 1,
-    turns: safeNumber(details.turns)
+    turns: safeNumber(details.turns),
+    measurement
   };
   const reportedModels = Object.entries(details.modelUsage ?? {});
   const byModel = reportedModels.length > 0 ? Object.fromEntries(
@@ -7418,7 +7421,8 @@ function createRunUsage(tokens, costUsd, details = {}) {
           tokens: modelTokens,
           costUsd: safeNumber(usage.costUSD),
           agentRuns: 1,
-          turns: reportedModels.length === 1 ? safeNumber(details.turns) : 0
+          turns: reportedModels.length === 1 ? safeNumber(details.turns) : 0,
+          measurement
         }
       ];
     })
@@ -7444,13 +7448,27 @@ function isModelRunUsage(value) {
     usage.turns
   ].every((number) => typeof number === "number" && Number.isFinite(number) && number >= 0);
 }
+function isUsageMeasurement(value) {
+  return value === "reported" || value === "partial" || value === "unknown";
+}
+function mergeMeasurement(left, right) {
+  const normalizedLeft = left ?? "reported";
+  const normalizedRight = right ?? "reported";
+  if (normalizedLeft === normalizedRight) return normalizedLeft;
+  return "partial";
+}
 function parseRunUsage(value) {
   if (!value || typeof value !== "object" || Array.isArray(value)) return void 0;
   const usage = value;
   if (usage.version !== 1 || !isModelRunUsage(usage)) return void 0;
   if (!usage.byModel || typeof usage.byModel !== "object" || Array.isArray(usage.byModel)) return void 0;
   if (!Object.values(usage.byModel).every(isModelRunUsage)) return void 0;
-  return structuredClone(usage);
+  const normalized = structuredClone(usage);
+  normalized.measurement = isUsageMeasurement(usage.measurement) ? usage.measurement : "reported";
+  for (const [model, modelUsage] of Object.entries(normalized.byModel)) {
+    modelUsage.measurement = isUsageMeasurement(usage.byModel[model]?.measurement) ? usage.byModel[model].measurement : "reported";
+  }
+  return normalized;
 }
 function mergeRunUsage(left, right) {
   if (!left) return right ? structuredClone(right) : void 0;
@@ -7468,7 +7486,8 @@ function mergeRunUsage(left, right) {
         tokens: addTokenBreakdown(first.tokens, second.tokens),
         costUsd: first.costUsd + second.costUsd,
         agentRuns: first.agentRuns + second.agentRuns,
-        turns: first.turns + second.turns
+        turns: first.turns + second.turns,
+        measurement: mergeMeasurement(first.measurement, second.measurement)
       };
     }
   }
@@ -7478,6 +7497,7 @@ function mergeRunUsage(left, right) {
     costUsd: left.costUsd + right.costUsd,
     agentRuns: left.agentRuns + right.agentRuns,
     turns: left.turns + right.turns,
+    measurement: mergeMeasurement(left.measurement, right.measurement),
     byModel
   };
 }
@@ -7487,12 +7507,14 @@ function formatRunUsageMarker(subject, usage) {
 function appendRunUsageSummary(summaryPath, subject, usage) {
   if (!summaryPath) return;
   const tokens = usage.tokens;
+  const tokenLine = usage.measurement === "unknown" ? "- **Tokens:** usage unknown (provider did not report billable usage)" : `- **${usage.measurement === "partial" ? "Known tokens" : "Tokens"}:** ${tokens.input.toLocaleString()} input / ${tokens.cacheRead.toLocaleString()} cache-read / ${tokens.cacheCreate.toLocaleString()} cache-create / ${tokens.output.toLocaleString()} output / ${tokens.total.toLocaleString()} total${usage.measurement === "partial" ? "; some child usage is unknown" : ""}`;
+  const costLine = usage.measurement === "unknown" ? "- **Provider-reported cost:** unknown" : `- **Provider-reported cost:** $${usage.costUsd.toFixed(4)}${usage.measurement === "partial" ? " known; some child cost is unknown" : ""}`;
   const lines = [
     `### Kody usage - ${subject}`,
     "",
-    `- **Tokens:** ${tokens.input.toLocaleString()} input / ${tokens.cacheRead.toLocaleString()} cache-read / ${tokens.cacheCreate.toLocaleString()} cache-create / ${tokens.output.toLocaleString()} output / ${tokens.total.toLocaleString()} total`,
+    tokenLine,
     `- **Agent work:** ${usage.agentRuns.toLocaleString()} runs / ${usage.turns.toLocaleString()} turns`,
-    `- **Provider-reported cost:** $${usage.costUsd.toFixed(4)}`,
+    costLine,
     ""
   ];
   try {
@@ -23888,7 +23910,8 @@ async function runImplementation(profileName, input) {
       ctx.output.usage = createRunUsage(agentResult.tokens, agentResult.costUsd, {
         model: `${model.provider}/${model.model}`,
         turns: agentResult.turns,
-        modelUsage: agentResult.modelUsage
+        modelUsage: agentResult.modelUsage,
+        outcome: agentResult.outcome
       });
       emitEvent(input.cwd, {
         implementation: profileName,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kody-ade/kody-engine",
-  "version": "0.4.647",
+  "version": "0.4.648",
   "description": "kody — autonomous development engine. Single-session Claude Code agent behind a generic executor + declarative implementation profiles.",
   "license": "MIT",
   "repository": {