@kody-ade/kody-engine 0.4.416 → 0.4.418

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.416",
+      version: "0.4.418",
       description: "kody \u2014 autonomous development engine. Single-session Claude Code agent behind a generic executor + declarative implementation profiles.",
       license: "MIT",
       type: "module",
@@ -52,7 +52,7 @@ var init_package = __esm({
       dependencies: {
         "@actions/cache": "^6.0.0",
         "@anthropic-ai/claude-agent-sdk": "0.2.119",
-        "@kody-ade/agency-domain": "0.4.0",
+        "@kody-ade/agency-domain": "0.5.0",
         "@modelcontextprotocol/sdk": "^1.29.0",
         convex: "^1.17.0",
         zod: "^4.0.0"
@@ -3415,6 +3415,7 @@ async function runAgent(opts) {
   let outcomeKind = "generic_failed";
   let errorMessage2;
   let tokens = { input: 0, output: 0, cacheRead: 0, cacheCreate: 0 };
+  let costUsd = 0;
   let messageCount = 0;
   let finalText = "";
   let getSubmitted;
@@ -3431,6 +3432,7 @@ async function runAgent(opts) {
     outcomeKind = "generic_failed";
     errorMessage2 = void 0;
     tokens = { input: 0, output: 0, cacheRead: 0, cacheCreate: 0 };
+    costUsd = 0;
     messageCount = 0;
     let sawMutatingTool = false;
     let sawTerminalSuccess = false;
@@ -3555,6 +3557,7 @@ async function runAgent(opts) {
         };
       }
       queryOptions.settingSources = opts.settingSources ?? ["project", "local"];
+      if (opts.abortController) queryOptions.abortController = opts.abortController;
       const stableBinary = ensureStableClaudeBinary();
       if (stableBinary) {
         const sdkBinaryPathOption = ["pathToClaudeCode", "Exec", "utable"].join("");
@@ -3683,6 +3686,8 @@ async function runAgent(opts) {
           }
         }
         if (m.type === "result") {
+          const reportedCost = Number(m.total_cost_usd ?? 0);
+          if (Number.isFinite(reportedCost) && reportedCost >= 0) costUsd = reportedCost;
           if (m.subtype === "success") {
             outcome = "completed";
             outcomeKind = "ok";
@@ -3760,6 +3765,7 @@ async function runAgent(opts) {
     ndjsonPath,
     durationMs: Date.now() - startedAt,
     tokens,
+    costUsd,
     messageCount
   };
 }
@@ -13038,7 +13044,6 @@ function addDefinition(catalog, document) {
 }
 function add(collection, definition, revision) {
   const mutable = collection;
-  if (mutable.has(definition.id)) throw new Error(`Duplicate Agency Definition: ${definition.id}`);
   mutable.set(definition.id, { definition, revision });
 }
 function validateRelationships(catalog) {
@@ -13098,7 +13103,10 @@ var init_agencyModelRepository = __esm({
       async loadCatalog() {
         const documents = await this.backend.listAgencyDefinitions(this.tenantId);
         const catalog = emptyCatalog();
-        for (const document of documents) addDefinition(catalog, document);
+        const ordered = [...documents].sort(
+          (left, right) => left.createdAt.localeCompare(right.createdAt) || left.recordId.localeCompare(right.recordId)
+        );
+        for (const document of ordered) addDefinition(catalog, document);
         validateRelationships(catalog);
         return catalog;
       }
@@ -13325,7 +13333,19 @@ async function dispatchAgencyLoopsWith(input) {
       results.push({ loopId: record2.definition.id, decision: "skipped", reason });
       continue;
     }
-    const leaseUntil = new Date(input.now.getTime() + 15 * 6e4).toISOString();
+    const failurePolicy = record2.definition.reconciliationPolicy.failure;
+    const budget = policy.snapshot.policy.budget;
+    const maxAttempts = Math.min(failurePolicy.maxAttempts, budget.maxRuns);
+    const timeoutSeconds = Math.min(failurePolicy.timeoutSeconds, budget.maxDurationSeconds);
+    const backoffBudgetSeconds = Array.from(
+      { length: Math.max(0, maxAttempts - 1) },
+      (_, index) => failurePolicy.backoffSeconds * 2 ** index
+    ).reduce((sum, seconds) => sum + seconds, 0);
+    const leaseSeconds = Math.min(
+      budget.maxDurationSeconds,
+      maxAttempts * timeoutSeconds + backoffBudgetSeconds
+    );
+    const leaseUntil = new Date(input.now.getTime() + leaseSeconds * 1e3).toISOString();
     const reservationId = `reservation-${randomUUID()}`;
     const correlationId = `corr-${randomUUID()}`;
     const trace = [policy.trace[0], ...target.intermediate, target.reference];
@@ -13365,40 +13385,97 @@ async function dispatchAgencyLoopsWith(input) {
       updatedAt: now
     });
     await repository.saveState(runningState, "loop", now);
-    const runId = `run-${randomUUID()}`;
-    const activeRun = createRun({
-      id: runId,
-      status: "running",
-      origin: { kind: "loop", id: record2.definition.id, revision: record2.revision },
-      target: target.reference,
-      trace,
-      effectivePolicy: policy.snapshot,
-      correlationId,
-      startedAt: now
-    });
     try {
-      await input.backend.createAgencyModelRun(
-        input.tenantId,
-        target.reference.kind,
-        target.reference.id,
-        activeRun,
-        now
-      );
-      const output = await input.run(target.job);
-      const succeeded = output.exitCode === 0;
+      let attempts = 0;
+      let tokens = 0;
+      let costUsd = 0;
+      let succeeded = false;
+      let reason = "target failed";
+      let finalRunId;
+      let finalCapabilityResults = [];
+      const budgetDeadline = Date.now() + budget.maxDurationSeconds * 1e3;
+      for (let attempt = 1; attempt <= maxAttempts; attempt += 1) {
+        const remainingMilliseconds = budgetDeadline - Date.now();
+        if (remainingMilliseconds <= 0) {
+          reason = "policy duration budget exhausted";
+          break;
+        }
+        attempts = attempt;
+        const startedAt = (/* @__PURE__ */ new Date()).toISOString();
+        const runId = `run-${randomUUID()}`;
+        finalRunId = runId;
+        const activeRun = createRun({
+          id: runId,
+          status: "running",
+          origin: { kind: "loop", id: record2.definition.id, revision: record2.revision },
+          target: target.reference,
+          trace,
+          effectivePolicy: policy.snapshot,
+          correlationId,
+          startedAt
+        });
+        await input.backend.createAgencyModelRun(
+          input.tenantId,
+          target.reference.kind,
+          target.reference.id,
+          activeRun,
+          startedAt
+        );
+        const attemptResult = await runAttempt(
+          input.run,
+          target.job,
+          Math.min(timeoutSeconds, remainingMilliseconds / 1e3)
+        );
+        tokens += attemptResult.usage?.tokens ?? 0;
+        costUsd += attemptResult.usage?.costUsd ?? 0;
+        const finishedAt2 = (/* @__PURE__ */ new Date()).toISOString();
+        succeeded = attemptResult.exitCode === 0;
+        finalCapabilityResults = attemptResult.capabilityResults ?? [];
+        reason = attemptResult.reason ?? (succeeded ? "target dispatched" : "target failed");
+        const usage = {
+          tokens: attemptResult.usage?.tokens ?? 0,
+          costUsd: attemptResult.usage?.costUsd ?? 0,
+          durationSeconds: Math.max(0, (Date.parse(finishedAt2) - Date.parse(startedAt)) / 1e3)
+        };
+        if (tokens > budget.maxTokens || costUsd > budget.maxCostUsd) {
+          succeeded = false;
+          reason = tokens > budget.maxTokens ? "policy token budget exhausted" : "policy cost budget exhausted";
+        }
+        await input.backend.finishAgencyModelRun(
+          input.tenantId,
+          terminalRun(activeRun, succeeded ? "succeeded" : "failed", finishedAt2, usage),
+          finishedAt2
+        );
+        if (tokens > budget.maxTokens || costUsd > budget.maxCostUsd) break;
+        if (succeeded || attempt === maxAttempts) break;
+        const backoffMilliseconds = failurePolicy.backoffSeconds * 2 ** (attempt - 1) * 1e3;
+        if (Date.now() + backoffMilliseconds >= budgetDeadline) {
+          reason = "policy duration budget exhausted during retry backoff";
+          break;
+        }
+        await wait(backoffMilliseconds);
+      }
       const finishedAt = (/* @__PURE__ */ new Date()).toISOString();
-      await input.backend.finishAgencyModelRun(
-        input.tenantId,
-        terminalRun(activeRun, succeeded ? "succeeded" : "failed", finishedAt),
-        finishedAt
-      );
+      const goalRecord = record2.definition.targetRef.kind === "goal" ? records.find(
+        (candidate) => "executionRef" in candidate.definition && candidate.definition.id === record2.definition.targetRef.id
+      ) : void 0;
+      if (succeeded && goalRecord && finalRunId) {
+        await appendCapabilityOutputs(
+          repository,
+          finalRunId,
+          target.reference,
+          finalCapabilityResults,
+          finishedAt
+        );
+        await repository.refreshGoalProgress(goalRecord, finishedAt);
+      }
       await input.backend.finishAgencyDispatch(
         input.tenantId,
         decision.idempotencyKey,
         reservationId,
-        succeeded ? "dispatched" : "failed",
+        succeeded ? "dispatched" : "dead-letter",
         finishedAt,
-        runId
+        finalRunId
       );
       await repository.saveState(
         createLoopState2({
@@ -13413,19 +13490,17 @@ async function dispatchAgencyLoopsWith(input) {
       results.push({
         loopId: record2.definition.id,
         decision: succeeded ? "dispatched" : "failed",
-        reason: output.reason ?? (succeeded ? "target dispatched" : "target failed")
+        reason: succeeded ? reason : `${reason}; dead-lettered after ${attempts} attempt${attempts === 1 ? "" : "s"}`
       });
     } catch (error) {
       const reason = error instanceof Error ? error.message : String(error);
       const finishedAt = (/* @__PURE__ */ new Date()).toISOString();
-      await input.backend.finishAgencyModelRun(input.tenantId, terminalRun(activeRun, "failed", finishedAt), finishedAt).catch(() => void 0);
       await input.backend.finishAgencyDispatch(
         input.tenantId,
         decision.idempotencyKey,
         reservationId,
-        "failed",
-        finishedAt,
-        runId
+        "dead-letter",
+        finishedAt
       );
       results.push({ loopId: record2.definition.id, decision: "failed", reason });
     }
@@ -13449,8 +13524,58 @@ function resolveTarget(loop, catalog) {
     job: target.kind === "workflow" ? { workflow: target.id, cliArgs: {}, flavor: "scheduled" } : { capability: target.id, cliArgs: {}, flavor: "scheduled" }
   };
 }
-function terminalRun(active, status, finishedAt) {
-  return createRun({ ...active, status, finishedAt });
+function terminalRun(active, status, finishedAt, usage) {
+  return createRun({ ...active, status, finishedAt, usage });
+}
+async function runAttempt(run, job, timeoutSeconds) {
+  const abortController = new AbortController();
+  let timer;
+  try {
+    return await Promise.race([
+      run(job, abortController),
+      new Promise((resolve17) => {
+        timer = setTimeout(() => {
+          abortController.abort();
+          resolve17({ exitCode: 124, reason: `target timed out after ${formatSeconds(timeoutSeconds)}s` });
+        }, timeoutSeconds * 1e3);
+      })
+    ]);
+  } finally {
+    if (timer) clearTimeout(timer);
+  }
+}
+async function appendCapabilityOutputs(repository, runId, producer, results, createdAt) {
+  for (const result of results) {
+    const outputs = [
+      ...Object.entries(result.facts).map(([key, value]) => ({ kind: "fact", key, value })),
+      ...Object.entries(result.evidence ?? {}).map(([key, value]) => ({
+        kind: "evidence",
+        key,
+        value
+      })),
+      ...result.artifacts.map((artifact, index) => ({
+        kind: "artifact",
+        key: artifact.label || `artifact-${index + 1}`,
+        value: artifact
+      }))
+    ];
+    for (const output of outputs) {
+      await repository.appendOutput(`output-${randomUUID()}`, {
+        ...output,
+        runId,
+        producer: { kind: producer.kind, id: producer.id },
+        contract: "capability-result/v1",
+        createdAt
+      });
+    }
+  }
+}
+function formatSeconds(seconds) {
+  return Number.isInteger(seconds) ? String(seconds) : seconds.toFixed(3).replace(/0+$/, "").replace(/\.$/, "");
+}
+async function wait(milliseconds) {
+  if (milliseconds <= 0) return;
+  await new Promise((resolve17) => setTimeout(resolve17, milliseconds));
 }
 function repositoryTenant(config) {
   const owner = config.github?.owner?.trim() || process.env.GITHUB_REPOSITORY?.split("/")[0]?.trim();
@@ -13474,7 +13599,14 @@ var init_dispatchAgencyLoops = __esm({
         tenantId: tenantId2,
         backend,
         now: /* @__PURE__ */ new Date(),
-        run: (job) => runJob(job, { cwd: ctx.cwd, config: ctx.config, verbose: ctx.verbose, quiet: ctx.quiet, chain: false })
+        run: (job, abortController) => runJob(job, {
+          cwd: ctx.cwd,
+          config: ctx.config,
+          verbose: ctx.verbose,
+          quiet: ctx.quiet,
+          chain: false,
+          abortController
+        })
       });
       ctx.data.agencyLoopDispatchResults = results;
     };
@@ -20686,6 +20818,7 @@ async function runImplementation(profileName, input) {
       isBackendHealthy: lm ? () => lm.isHealthy() : void 0,
       verbose: input.verbose,
       quiet: input.quiet,
+      abortController: input.abortController,
       ndjsonDir,
       additionalDirectories: agentTaskArtifacts ? [agentTaskArtifacts.absDir] : void 0,
       allowedToolsOverride: profile.claudeCode.tools,
@@ -20795,6 +20928,10 @@ async function runImplementation(profileName, input) {
           reason: err instanceof Error ? err.message : String(err)
         });
       }
+      ctx.output.usage = {
+        tokens: agentResult.tokens ? agentResult.tokens.input + agentResult.tokens.output + agentResult.tokens.cacheRead + agentResult.tokens.cacheCreate : 0,
+        costUsd: agentResult.costUsd ?? 0
+      };
       emitEvent(input.cwd, {
         implementation: profileName,
         kind: "agent_end",
@@ -21637,6 +21774,7 @@ async function runCapabilityImplementationStep(valid, profileName, capabilityIde
     skipConfig: base.skipConfig,
     verbose: base.verbose,
     quiet: base.quiet,
+    abortController: base.abortController,
     preloadedData: Object.keys(preloadedData).length > 0 ? preloadedData : void 0
   };
   const shouldApplyResolvedCapabilityArgs = valid.implementation === void 0 && resolvedCapability && profileName === resolvedCapability.implementation;

package/dist/implementations/types.ts

@@ -453,6 +453,7 @@ export interface Context {
     exitCode: number
     prUrl?: string
     reason?: string
+    usage?: { tokens: number; costUsd: number }
     /**
      * In-process hand-off to the next stage. A stage (e.g. `classify`) sets
      * this so the orchestrator runs the chosen sub-orchestrator

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kody-ade/kody-engine",
-  "version": "0.4.416",
+  "version": "0.4.418",
   "description": "kody — autonomous development engine. Single-session Claude Code agent behind a generic executor + declarative implementation profiles.",
   "license": "MIT",
   "type": "module",
@@ -15,7 +15,7 @@
   "dependencies": {
     "@actions/cache": "^6.0.0",
     "@anthropic-ai/claude-agent-sdk": "0.2.119",
-    "@kody-ade/agency-domain": "0.4.0",
+    "@kody-ade/agency-domain": "0.5.0",
     "@modelcontextprotocol/sdk": "^1.29.0",
     "convex": "^1.17.0",
     "zod": "^4.0.0"