@madewithremy/admin 0.1.52 → 0.1.54

package/dist/prod.js

@@ -1034,7 +1034,7 @@ async function primaryUrl(ctx) {
   return dashboard.primaryUrl;
 }
 function summarizeRelease(release) {
-  const summary2 = {
+  const summary4 = {
     releaseId: release.id,
     commitSha: release.commitSha,
     branch: release.branch ?? null,
@@ -1046,16 +1046,16 @@ function summarizeRelease(release) {
   };
   const readers = (release.dataSources ?? []).filter((d) => d.reader);
   if (readers.length > 0 && release.status === "live") {
-    summary2.readers = readers.map((d) => ({
+    summary4.readers = readers.map((d) => ({
       slug: d.slug,
       unread: d.readerUnread ?? 0
     }));
   }
   if (release.status !== "failed") {
-    return summary2;
+    return summary4;
   }
   return {
-    ...summary2,
+    ...summary4,
     error: release.failureReason ?? "Build failed (no error entry in the build log)",
     ...release.failureKind ? { failureKind: release.failureKind } : {},
     ...release.failurePhase ? { failurePhase: release.failurePhase } : {}
@@ -4476,10 +4476,10 @@ function failOnWait(result) {
     );
   }
 }
-async function waitAndReport(ctx, a, id, mode, summary2) {
+async function waitAndReport(ctx, a, id, mode, summary4) {
   const wait = mode === "plan" ? waitForPlan : waitForJob;
   const result = await wait(ctx, { id, ...timeoutOf(a), onProgress: progress });
-  out({ ...summary2, ...result });
+  out({ ...summary4, ...result });
   failOnWait(result);
 }
 
@@ -7611,7 +7611,7 @@ Subcommands:
   numbers list      The app's dedicated phone number(s) and their status
   numbers search    Search available US numbers by area code / locality
   numbers buy       Buy + attach a dedicated number ($1/month \u2014 confirm with the user first)
-  numbers release   Release the number (permanent \u2014 the rental stops, no refund, ~15-day carrier quarantine)
+  numbers release   Release a number (permanent \u2014 the rental stops, no refund, ~15-day carrier quarantine)
   numbers set-name  Set/clear the outbound caller-ID display name (CNAM)
   sessions list     Call log (web, phone-out, phone-in), newest first
   sessions get      One session with full transcript and cost breakdown
@@ -7635,9 +7635,11 @@ Examples:
 
 Notes:
   Buying a number starts a recurring $1/month workspace charge \u2014 never run
-  'numbers buy' without the user's explicit confirmation. The dedicated number
-  is both the outbound caller ID for voice.call() and the app's inbound line
-  (inbound calls answer the LIVE release's voice agent). A 'pending' number
+  'numbers buy' without the user's explicit confirmation. An app can hold
+  several numbers (one per tenant, say), up to its workspace's limit
+  (phone_number_limit_reached past it; support raises it). Each is an inbound
+  line (answered by the LIVE release's voice agent) and a caller ID for
+  voice.call(), which takes 'from' once there are several. A 'pending' number
   usually activates within seconds \u2014 poll 'numbers list'. The display name
   (CNAM) is 1-15 letters/numbers/spaces and takes 12-72h to propagate.
   'settings set' merges \u2014 settings you don't pass keep their current values.
@@ -7805,6 +7807,59 @@ Examples:
   remy-admin tasks list --limit 10
   remy-admin tasks get 0b9e\u2026`;
 
+// src/ops/usage.ts
+function summary2(ctx, params) {
+  return call(
+    ctx,
+    "GET",
+    `/_internal/v2/apps/${ctx.appId}/usage/summary${qs(params)}`
+  );
+}
+
+// src/commands/usage.ts
+var DEFAULT_WINDOW_MS = 30 * 24 * 60 * 60 * 1e3;
+var usageSpecs = {
+  "usage summary": {
+    usage: "Usage: remy-admin usage summary [--start <iso>] [--end <iso>] [--by method|model|step]",
+    flags: {
+      ...WINDOW,
+      by: { type: "string", choices: ["method", "model", "step"] }
+    }
+  }
+};
+async function summary3(ctx, a) {
+  const end = a.str("end") ?? (/* @__PURE__ */ new Date()).toISOString();
+  const start2 = a.str("start") ?? new Date(new Date(end).getTime() - DEFAULT_WINDOW_MS).toISOString();
+  out(
+    await summary2(ctx, {
+      startTime: start2,
+      endTime: end,
+      groupBy: a.str("by")
+    })
+  );
+}
+var usageHandlers = {
+  "usage summary": summary3
+};
+var usageHelp = `remy-admin usage \u2014 What the app costs to run.
+
+Subcommands:
+  summary  The app's runtime spend over a window, broken down one way
+
+Usage:
+  remy-admin usage summary [--start <iso>] [--end <iso>] [--by method|model|step]
+
+Notes:
+  Costs are in dollars. Builds (your own work on the app) aren't counted.
+  --by method (the default) is the spend each method drove, model the models'
+  share, step the whole spend by action, models and everything else. The window
+  defaults to the 30 days before --end, and --end to now. An app's own method
+  can read this with the 'usage.view' admin permission.
+
+Examples:
+  remy-admin usage summary
+  remy-admin usage summary --by model --start 2026-10-01T00:00:00Z`;
+
 // src/ops/events.ts
 function channelsList(ctx, params = {}) {
   return call(
@@ -9455,7 +9510,7 @@ var infraSpecs = {
     }
   }
 };
-async function waitAndReport2(ctx, a, id, phases, summary2, until) {
+async function waitAndReport2(ctx, a, id, phases, summary4, until) {
   const timeoutSec = a.str("timeout");
   const result = await waitForPhase(ctx, {
     id,
@@ -9464,7 +9519,7 @@ async function waitAndReport2(ctx, a, id, phases, summary2, until) {
     ...timeoutSec ? { timeoutMs: Number(timeoutSec) * 1e3 } : {},
     onProgress: progress
   });
-  out({ ...summary2, ...result });
+  out({ ...summary4, ...result });
   if (result.status === "failed") {
     throw new CliError(result.error, EXIT.buildFailed);
   }
@@ -9978,6 +10033,7 @@ var SPECS = {
   ...voiceSpecs,
   ...agentSpecs,
   ...tasksSpecs,
+  ...usageSpecs,
   ...eventsSpecs,
   ...jewelsSpecs,
   ...settingsSpecs,
@@ -10014,6 +10070,7 @@ var HANDLERS = {
   ...voiceHandlers,
   ...agentHandlers,
   ...tasksHandlers,
+  ...usageHandlers,
   ...eventsHandlers,
   ...jewelsHandlers,
   ...settingsHandlers,
@@ -10044,6 +10101,7 @@ var GROUP_HELP = {
   voice: voiceHelp,
   agent: agentHelp,
   tasks: tasksHelp,
+  usage: usageHelp,
   events: eventsHelp,
   jewels: jewelsHelp,
   settings: settingsHelp,
@@ -10131,6 +10189,7 @@ Commands:
   voice         Phone numbers, voice call log + transcripts, voice policy settings
   agent         Agent (chat) conversation log + transcripts
   tasks         Task agent (runTask) log + transcripts
+  usage         What the app costs to run, by method, model or step
   events        Realtime events \u2014 live tail, test publish, channel activity
   jewels        Monitor jewel shadowing; review + approve the proposal queue
   settings      App settings \u2014 signup allowlist, test accounts, embed origins, toggles
@@ -10147,7 +10206,18 @@ with a dash, use --name=value; to pass a positional beginning with a dash, put
 -- before it.
 
 All output is JSON. Configuration is read from environment variables
-(MINDSTUDIO_API_KEY, MINDSTUDIO_BASE_URL) and mindstudio.json (appId).`;
+(MINDSTUDIO_API_KEY, MINDSTUDIO_BASE_URL) and mindstudio.json (appId).
+
+From an app's own method, the same operations run through the import layer
+with no key: createAdminClient() in the method acts on its own app, as the
+method's run, for what the method's "adminPermissions" in mindstudio.json
+allow. analytics.view, usage.view, requests.view (requests, crashes),
+agent.view, tasks.view, voice.view|manage, users.view|manage (live runs only),
+settings.manage, email.view|manage, domains.manage (custom domains, the
+subdomain), issues.view|manage, datasources.manage, cron.view|manage,
+releases.view. A .manage includes its .view. A call the method doesn't hold is
+admin_permission_required:<name>; another app is app_credential_wrong_app and
+needs a key. The full list and rules are createAdminClient's docs.`;
 var GROUPS = [
   "requests",
   "crashes",
@@ -10169,6 +10239,7 @@ var GROUPS = [
   "voice",
   "agent",
   "tasks",
+  "usage",
   "events",
   "jewels",
   "settings",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@madewithremy/admin",
-  "version": "0.1.52",
+  "version": "0.1.54",
   "description": "Admin SDK + CLI for managing production Remy apps",
   "type": "module",
   "main": "./dist/index.js",
@@ -53,6 +53,14 @@
   "dependencies": {
     "json5": "^2.2.3"
   },
+  "peerDependencies": {
+    "@mindstudio-ai/agent": ">=0.1.46"
+  },
+  "peerDependenciesMeta": {
+    "@mindstudio-ai/agent": {
+      "optional": true
+    }
+  },
   "devDependencies": {
     "@types/node": "^26.6.5",
     "@typescript/native": "npm:typescript@^7.0.2",