@odla-ai/cli 0.25.7 → 0.25.8

package/dist/bin.js

@@ -3,7 +3,7 @@ import {
   exitCodeFor,
   redactSecrets,
   runCli
-} from "./chunk-5U3EXWCR.js";
+} from "./chunk-PM5FBL3S.js";
 
 // src/bin.ts
 runCli().catch((err) => {

package/dist/{chunk-5U3EXWCR.js → chunk-PM5FBL3S.js}

@@ -1617,6 +1617,7 @@ var CAPABILITIES = {
     "apply Google Calendar booking config, then drive state-bound consent, status, discovery, and disconnect flows (bookings run live through the platform proxy)",
     "validate integration contracts offline and smoke-test a provisioned db environment plus anonymous capability routes",
     "read one versioned o11y status envelope spanning application RED, current live-sync freshness/load, the protected commit-to-visible canary, collector ingest/scheduler trust, provider-owned runtime metrics, and a bounded machine verdict",
+    "inspect durable agent wakeups as a versioned JSON envelope and explicitly requeue one dead-lettered job with a scoped environment credential",
     "run app-attributed hosted security discovery and independent validation without provider keys",
     "connect/revoke source-read-only GitHub sources and drive commit-pinned hosted security jobs without PATs or provider keys",
     "let admins manage system AI policy and credentials, inspect attributed usage, and read immutable admin changes through separate short-lived capability-only approvals"
@@ -5995,6 +5996,8 @@ Usage:
   odla-ai discuss resolve <topic> [--reopen] [--mutation-id <id>]
   odla-ai discuss who --q <text> [--app <id>] [--kinds user,pm:task] [--json]
   odla-ai discuss watch [<topic>] [--by <authorId>] [--self <authorId>] [--interval <s>] [--timeout <s>] [--json]
+  odla-ai agent jobs [--env dev] [--state pending|running|succeeded|dead_letter] [--limit 50] [--email <email>] [--json]
+  odla-ai agent retry <job-id> [--env dev] [--email <email>] [--json]
   odla-ai o11y status [--app <id>] [--env prod] [--minutes 60] [--json]
   odla-ai whoami [--json]
   odla-ai runbook ask "<question>" [--app <id>] [--all] [--json]
@@ -6042,6 +6045,8 @@ Usage:
   odla-ai version
 
 Commands:
+  agent        Inspect durable agent wakeups and explicitly requeue a
+               dead-lettered job; JSON output is stable for remote operators.
   runbook      odla's operational procedures, stored in the database and read at
                the moment they are followed. "ask" gives a written, cited answer;
                "search" the passages behind it; "get" the whole document.
@@ -6817,6 +6822,7 @@ var PM_ENTITIES = Object.fromEntries(
   ["goal", "conformance", "task", "kanban", "decision", "bug"].map((entity) => [entity, PM_ACTIONS])
 );
 var COMMAND_SURFACE = {
+  agent: { jobs: {}, retry: {} },
   admin: {
     ai: {
       show: {},
@@ -7353,11 +7359,6 @@ async function adminCommand(parsed) {
   });
 }
 
-// src/app-export.ts
-import { createWriteStream } from "fs";
-import { Readable } from "stream";
-import { pipeline } from "stream/promises";
-
 // src/tenant.ts
 import { tenantIdFor as tenantIdFor5 } from "@odla-ai/apps";
 function resolveEnv(cfg, requested) {
@@ -7382,7 +7383,90 @@ function bothTenants(cfg) {
   return { sandbox: tenantIdFor5(cfg.app.id, "dev"), live: tenantIdFor5(cfg.app.id, "prod") };
 }
 
+// src/agent-command.ts
+async function agentCommand(parsed, deps = {}) {
+  const action = parsed.positionals[1];
+  if (action !== "jobs" && action !== "retry") {
+    throw new Error(`unknown agent action "${action ?? ""}". Try "odla-ai agent jobs --json".`);
+  }
+  assertArgs(parsed, ["config", "env", "state", "limit", "json", "token", "email"], action === "jobs" ? 2 : 3);
+  if (action === "retry" && (parsed.options.state !== void 0 || parsed.options.limit !== void 0)) {
+    throw new Error('--state and --limit are supported only by "agent jobs"');
+  }
+  const cfg = await loadProjectConfig(stringOpt(parsed.options.config) ?? "odla.config.mjs");
+  const { env, tenant } = resolveTenant(cfg, stringOpt(parsed.options.env));
+  const doFetch = deps.fetch ?? fetch;
+  const out = deps.stdout ?? console;
+  const credential2 = await getDeveloperToken(
+    cfg,
+    {
+      configPath: cfg.configPath,
+      token: stringOpt(parsed.options.token),
+      email: stringOpt(parsed.options.email),
+      open: false
+    },
+    doFetch,
+    out
+  );
+  const base = `${cfg.dbEndpoint}/app/${encodeURIComponent(tenant)}/admin/agent-jobs`;
+  const headers = { authorization: `Bearer ${credential2}` };
+  if (action === "retry") {
+    const id = parsed.positionals[2];
+    const res2 = await doFetch(`${base}/${encodeURIComponent(id)}/retry`, { method: "POST", headers });
+    const body2 = await readJson(res2);
+    if (!res2.ok) throw new Error(`agent retry failed (${res2.status}): ${errorMessage(body2)}`);
+    const result2 = { v: 1, appId: cfg.app.id, env, tenant, ...body2 };
+    if (parsed.options.json === true) out.log(JSON.stringify(result2, null, 2));
+    else out.log(`${tenant}: requeued ${id}`);
+    return;
+  }
+  const state2 = stringOpt(parsed.options.state);
+  const allowed = ["pending", "running", "succeeded", "dead_letter"];
+  if (state2 && !allowed.includes(state2)) {
+    throw new Error(`--state must be one of ${allowed.join(", ")}`);
+  }
+  const url = new URL(base);
+  if (state2) url.searchParams.set("state", state2);
+  const limit = numberOpt(parsed.options.limit, "--limit");
+  if (limit) url.searchParams.set("limit", String(limit));
+  const res = await doFetch(url, { headers });
+  const body = await readJson(res);
+  if (!res.ok) throw new Error(`agent jobs failed (${res.status}): ${errorMessage(body)}`);
+  const result = { v: 1, appId: cfg.app.id, env, tenant, jobs: body.jobs ?? [], summary: body.summary };
+  if (parsed.options.json === true) {
+    out.log(JSON.stringify(result, null, 2));
+    return;
+  }
+  const summary = body.summary;
+  out.log(
+    `${tenant}: ${summary?.pending ?? 0} pending, ${summary?.running ?? 0} running, ${summary?.deadLetter ?? 0} dead-letter, ${summary?.succeeded ?? 0} succeeded`
+  );
+  for (const job of body.jobs ?? []) {
+    out.log(
+      [job.state, job.id, job.triggerId, `${job.entityNs}/${job.entityId}`, `attempts=${job.attempts}`, job.lastErrorCode ?? ""].filter(Boolean).join("	")
+    );
+  }
+}
+async function readJson(res) {
+  try {
+    return await res.json();
+  } catch {
+    return {};
+  }
+}
+function errorMessage(body) {
+  const error = body.error;
+  if (typeof error === "string") return error;
+  if (error && typeof error === "object" && typeof error.message === "string") {
+    return error.message;
+  }
+  return "request failed";
+}
+
 // src/app-export.ts
+import { createWriteStream } from "fs";
+import { Readable } from "stream";
+import { pipeline } from "stream/promises";
 async function appExport(options) {
   const cfg = await loadProjectConfig(options.configPath);
   const out = options.stdout ?? console;
@@ -10333,6 +10417,10 @@ async function runCli(argv = process.argv.slice(2), dependencies = {}) {
     await adminCommand(parsed);
     return;
   }
+  if (command === "agent") {
+    await agentCommand(parsed, runtime);
+    return;
+  }
   if (command === "app") {
     await appCommand(parsed, runtime);
     return;
@@ -10472,4 +10560,4 @@ export {
   exitCodeFor,
   runCli
 };
-//# sourceMappingURL=chunk-5U3EXWCR.js.map
+//# sourceMappingURL=chunk-PM5FBL3S.js.map