@deeprelay/mcp 0.1.1 → 0.2.0

package/README.md

@@ -4,10 +4,11 @@ This server connects Claude Code, Claude Desktop, Cursor, or any other
 [MCP](https://modelcontextprotocol.io) client straight to the deeprelay
 serverless inference API. The agent can browse models and their prices, run
 chat, embeddings, image and video generation inside a budget you approve, read
-your balance and usage, manage webhook endpoints, lower or clear your spending
-limit, and create checkout or billing links, all without leaving the editor.
+your balance, usage and request log, manage webhook endpoints, lower or clear
+your spending limit, change alert settings, and create checkout or billing
+links, all without leaving the editor.
 
-**29 tools in three tiers: reads are free, writes confirm once, money tools
+**33 tools in three tiers: reads are free, writes confirm once, money tools
 quote a price and require explicit confirmation.** The server enforces these
 rules, so they do not depend on the agent behaving well.
 
@@ -89,7 +90,7 @@ clear error on the first tool call. The key is never echoed in a result, an
 error or a confirmation prompt.
 
 **Use a dedicated key** for agent work, so you can revoke it on its own and see
-its usage separately. A `read_only` key covers all 17 free tools and cannot
+its usage separately. A `read_only` key covers all 20 free tools and cannot
 write or spend. Checkout, the billing portal and spending-limit changes also
 need the org-admin role. **No key scope limits how much a key can spend.** Your
 organization's spending limit and the session budget below do.
@@ -98,8 +99,8 @@ organization's spending limit and the session budget below do.
 
 | Tier | Tools | What happens before it runs |
 | --- | --- | --- |
-| Free, read-only | 17 | Nothing. No confirmation, no charge, no change. |
-| Writes: single confirmation | 8 | One confirmation. The first call describes the change and returns a `confirmation_token`. The second call, with the same arguments plus the token, runs it. |
+| Free, read-only | 20 | Nothing. No confirmation, no charge, no change. |
+| Writes: single confirmation | 9 | One confirmation. The first call describes the change and returns a `confirmation_token`. The second call, with the same arguments plus the token, runs it. |
 | Money tools | 4 | A price. Priced from the catalog, then checked against the per-call ceiling and the session budget. |
 
 Tokens are single-use, expire after five minutes, and are bound to the exact
@@ -124,8 +125,9 @@ one server process.
 Estimates are reserved before each call and replaced by the actual cost
 afterwards. A failed call releases its reservation.
 
-**Video is quoted as a floor, not a cap.** `deeprelay_videos_create` reserves
-the floor price. When `deeprelay_videos_get` or `deeprelay_videos_list` sees the
+**Video is quoted as a floor, not a cap.** `deeprelay_videos_create` prices the
+clip the way the platform bills it, per second of the requested `seconds` (the
+model's default length when omitted), and reserves that floor. When `deeprelay_videos_get` or `deeprelay_videos_list` sees the
 job completed, the reservation settles at the actual `cost_cents`. Failed,
 cancelled or expired jobs are not billed. If the server exits before the job
 finishes, the reservation is dropped and the real charge appears in
@@ -149,26 +151,30 @@ finishes, the reservation is dropped and the real charge appears in
 - `deeprelay_subscription_checkout`, `deeprelay_billing_portal` and
   `deeprelay_deposits_create_crypto` **only create links** (or a deposit
   address). They never charge. Nothing is paid until you complete the step
-  yourself.
+  yourself. For the same reason there is **no upgrade tool**: moving to the
+  Plus plan charges the card on file immediately, so it happens only from the
+  billing page or `deeprelay billing upgrade`, never from inside a tool call.
 - `deeprelay_deposits_create_crypto` is listed only on accounts with crypto
   deposits enabled. It stays hidden at startup and appears once the account is
   shown to have the feature.
 
 ## Tools
 
-**Free, read-only (17):** `deeprelay_auth_status`, `deeprelay_health`,
+**Free, read-only (20):** `deeprelay_auth_status`, `deeprelay_health`,
 `deeprelay_models_list`, `deeprelay_models_get`,
 `deeprelay_inference_preflight`, `deeprelay_usage_get`,
 `deeprelay_balance_get`, `deeprelay_spending_limit_get`,
 `deeprelay_subscription_get`, `deeprelay_deposits_list`,
 `deeprelay_deposits_get`, `deeprelay_referrals_get`,
 `deeprelay_webhooks_list`, `deeprelay_webhooks_get`, `deeprelay_videos_list`,
-`deeprelay_videos_get`, `deeprelay_videos_content`.
+`deeprelay_videos_get`, `deeprelay_videos_content`,
+`deeprelay_requests_list`, `deeprelay_requests_get`, `deeprelay_alerts_get`.
 
-**Writes: single confirmation (8):** `deeprelay_webhooks_create`,
+**Writes: single confirmation (9):** `deeprelay_webhooks_create`,
 `deeprelay_webhooks_delete`, `deeprelay_spending_limit_update`,
 `deeprelay_spending_limit_clear`, `deeprelay_subscription_checkout`, `deeprelay_billing_portal`,
-`deeprelay_deposits_create_crypto`, `deeprelay_videos_cancel`.
+`deeprelay_deposits_create_crypto`, `deeprelay_videos_cancel`,
+`deeprelay_alerts_set`.
 
 **Money (4):** `deeprelay_chat_completion`, `deeprelay_embeddings_create`,
 `deeprelay_images_generate`, `deeprelay_videos_create`.
@@ -179,9 +185,30 @@ even when the key is wrong or revoked; the server itself still needs
 inference usage: optional `modality` (`chat`, `image`, `video`, `embedding`),
 `model`, `bucket`, `start` and `end`; with no `modality` or `model` it covers
 all four modalities and returns `total_cost_cents` plus per-modality subtotals.
+It follows pages itself and never counts a row twice; `truncated: true` means
+the totals cover only the rows returned, so narrow `start`/`end`.
 `deeprelay_videos_content` saves the MP4
 to a local file (under the system temp directory by default, or an absolute
-`output_path`) instead of returning it inline.
+`output_path`) instead of returning it inline. Because it writes a file it
+advertises `readOnlyHint: false` and `idempotentHint: false`; it still costs
+nothing and needs no confirmation.
+
+Results use the API's own snake_case field names. `deeprelay_models_list` and
+`deeprelay_models_get` return each model exactly as the API does, including
+`name`, `tier`, `max_completion_tokens`, `reasoning_efforts` and the observed
+`metrics` (median time to first token, tokens per second, success rate).
+
+`deeprelay_chat_completion` takes `model`, `messages` and optional
+`max_tokens` (or `max_completion_tokens`), `temperature`, `tools`,
+`tool_choice`, `parallel_tool_calls`, `response_format` (JSON mode or a strict
+JSON schema), `reasoning_effort` and `seed`. A reply that calls tools comes back
+with `finish_reason: "tool_calls"`, `message.tool_calls` and `content: null`;
+send the assistant message back with one `tool` message per call
+(`tool_call_id` plus `content`) to continue. Tool definitions count toward the
+quoted price. `deeprelay_requests_list` / `deeprelay_requests_get` read the
+request log (90 days, never prompt or completion content), and
+`deeprelay_alerts_get` / `deeprelay_alerts_set` read and change the alert
+settings.
 
 Per-tool arguments and the full guide are at <https://deeprelay.ai/docs/mcp>.
 

package/dist/auth.d.ts

@@ -28,6 +28,12 @@ export declare function requireApiKey(env?: Env): string;
  * never produce `//`.
  */
 export declare function resolveBaseUrl(env?: Env): string;
+/**
+ * The API base as it may be shown to the agent: resolveBaseUrl with any
+ * userinfo (`user:pass@`) removed (WR-07). A proxy basic-auth base must never
+ * land in a transcript; errors.ts strips it from messages the same way.
+ */
+export declare function displayBaseUrl(env?: Env): string;
 /**
  * Build the single SDK Configuration every tool uses.
  *

package/dist/auth.js

@@ -3,6 +3,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.StartupConfigError = exports.PROD_API_BASE = exports.API_BASE_ENV = exports.API_KEY_ENV = void 0;
 exports.requireApiKey = requireApiKey;
 exports.resolveBaseUrl = resolveBaseUrl;
+exports.displayBaseUrl = displayBaseUrl;
 exports.buildConfiguration = buildConfiguration;
 exports.describeStartupError = describeStartupError;
 // Startup configuration and the one API-client construction site
@@ -87,6 +88,21 @@ function resolveBaseUrl(env = process.env) {
     }
     return raw.replace(/\/+$/, "");
 }
+/**
+ * The API base as it may be shown to the agent: resolveBaseUrl with any
+ * userinfo (`user:pass@`) removed (WR-07). A proxy basic-auth base must never
+ * land in a transcript; errors.ts strips it from messages the same way.
+ */
+function displayBaseUrl(env = process.env) {
+    const base = resolveBaseUrl(env);
+    const url = new URL(base);
+    if (url.username === "" && url.password === "") {
+        return base;
+    }
+    url.username = "";
+    url.password = "";
+    return url.toString().replace(/\/+$/, "");
+}
 /**
  * Build the single SDK Configuration every tool uses.
  *

package/dist/auth.js.map

@@ -1 +1 @@
-{"version":3,"file":"auth.js","sourceRoot":"","sources":["../src/auth.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"auth.js","sourceRoot":"","sources":["../src/auth.ts"],"names":[],"mappings":"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"}

package/dist/guardrail/estimate.d.ts

@@ -12,13 +12,27 @@ export interface PricingLike {
     perMpxlMicrocents?: number;
     perVideoMicrocents?: number;
     perVideoSecondMicrocents?: number;
+    /**
+     * Not a rate: the model's default clip length from its catalog `seconds`
+     * parameter descriptor. The server bills an omitted `seconds` at this value.
+     */
+    defaultVideoSeconds?: number;
 }
 /** Agent-supplied request parameters that the estimate depends on. */
 export interface EstimateParams {
-    /** Chat: messages. Content may be a string or an array of `{ text }` parts. */
+    /**
+     * Chat: messages. Content may be a string, null, or an array of `{ text }`
+     * parts; an assistant message's tool_calls count as prompt text too.
+     */
     messages?: ReadonlyArray<{
         content?: unknown;
+        tool_calls?: unknown;
     } | string>;
+    /**
+     * Chat: request parts the model reads as prompt besides the messages (tool
+     * definitions, a response_format JSON schema). Counted by their JSON length.
+     */
+    promptExtras?: ReadonlyArray<unknown>;
     /** Chat: the completion bound. Defaults to DEFAULT_MAX_TOKENS. */
     maxTokens?: number;
     /** Embeddings: input string(s). */
@@ -27,7 +41,7 @@ export interface EstimateParams {
     n?: number;
     /** Image: "WxH". Defaults to 1024x1024. */
     size?: string;
-    /** Video: clip length in seconds. Defaults to 5. */
+    /** Video: clip length in seconds. Defaults to the model's catalog default, then 5. */
     seconds?: number;
 }
 export interface Estimate {
@@ -46,6 +60,11 @@ export declare const DEFAULT_VIDEO_SECONDS = 5;
 export declare function estimatePromptTokens(texts: ReadonlyArray<string>): number;
 /** Megapixels for a "WxH" size. Anything unparseable uses the default size. */
 export declare function megapixels(size: string | undefined): number;
+/**
+ * The clip length the server will bill: the requested seconds, else the
+ * model's catalog default, else DEFAULT_VIDEO_SECONDS.
+ */
+export declare function videoSeconds(requested: number | undefined, pricing: PricingLike): number;
 /** Estimate one invocation's billed cost before it runs. */
 export declare function estimateMicroCents(modality: Modality, params: EstimateParams, pricing: PricingLike): Estimate;
 /** Usage fields the API returns, per modality (camelCase SDK shapes). */
@@ -58,6 +77,8 @@ export interface UsageLike {
     imageCount?: number;
     /** Video (VideoJob, populated on completed). */
     costCents?: number;
+    /** Video: the clip length the job reports, used when costCents is absent. */
+    seconds?: number;
 }
 /**
  * The billed actual cost of one completed invocation, from the API's usage

package/dist/guardrail/estimate.js

@@ -3,6 +3,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.DEFAULT_VIDEO_SECONDS = exports.DEFAULT_IMAGE_SIZE = exports.DEFAULT_MAX_TOKENS = exports.CHARS_PER_TOKEN = void 0;
 exports.estimatePromptTokens = estimatePromptTokens;
 exports.megapixels = megapixels;
+exports.videoSeconds = videoSeconds;
 exports.estimateMicroCents = estimateMicroCents;
 exports.actualMicroCents = actualMicroCents;
 // Per-modality cost estimator for the unified session budget (Phase 104 D-06).
@@ -19,8 +20,14 @@ exports.actualMicroCents = actualMicroCents;
 // Inputs from the agent (messages, n, size, seconds, max_tokens) are untrusted.
 // Non-finite or non-positive counts fall back to the defaults. For chat the
 // estimate is bounded by max_tokens. For video it is a FLOOR (isFloor: true),
-// because the catalog publishes a "from" price and the real cost arrives later
-// on VideoJob.costCents.
+// because the real cost arrives later on VideoJob.costCents.
+//
+// Video is priced the way the server bills it (CR-01): per second of output x
+// the requested seconds, where an omitted `seconds` resolves to the model's own
+// catalog default (its `seconds` parameter descriptor), then DEFAULT_VIDEO_SECONDS.
+// The per-clip price is only a representative "from" price for an example clip
+// length, so it never stands in for a known per-second rate; when both are
+// published the estimate is the larger of the two.
 const budget_js_1 = require("./budget.js");
 exports.CHARS_PER_TOKEN = 4;
 exports.DEFAULT_MAX_TOKENS = 1024;
@@ -62,10 +69,20 @@ function textOf(content) {
     }
     return "";
 }
+function jsonText(v) {
+    if (v === undefined || v === null)
+        return "";
+    try {
+        return JSON.stringify(v) ?? "";
+    }
+    catch {
+        return "";
+    }
+}
 function messageTexts(messages) {
     if (!messages)
         return [];
-    return messages.map((m) => (typeof m === "string" ? m : textOf(m?.content)));
+    return messages.map((m) => typeof m === "string" ? m : textOf(m?.content) + (m?.tool_calls === undefined ? "" : jsonText(m.tool_calls)));
 }
 function inputTexts(input) {
     if (input === undefined)
@@ -94,11 +111,33 @@ function imageRaw(count, size, pricing) {
         return count * per;
     return count * rate(pricing.perMpxlMicrocents) * megapixels(size);
 }
+/**
+ * The clip length the server will bill: the requested seconds, else the
+ * model's catalog default, else DEFAULT_VIDEO_SECONDS.
+ */
+function videoSeconds(requested, pricing) {
+    return positiveCount(requested, positiveCount(pricing.defaultVideoSeconds, exports.DEFAULT_VIDEO_SECONDS));
+}
+/**
+ * Raw micro-cents for one clip, priced exactly the way the server bills it:
+ * per-second rate x seconds (internal/mediajob/poller.go costCents). The
+ * per-clip "from" price is only a representative figure for an example
+ * length and is never charged, so it is used solely as a fallback when a
+ * model publishes no per-second rate.
+ */
+function videoRaw(seconds, pricing) {
+    return known(pricing.perVideoSecondMicrocents)
+        ? rate(pricing.perVideoSecondMicrocents) * seconds
+        : rate(pricing.perVideoMicrocents);
+}
 /** Estimate one invocation's billed cost before it runs. */
 function estimateMicroCents(modality, params, pricing) {
     switch (modality) {
         case "chat": {
-            const promptTokens = estimatePromptTokens(messageTexts(params.messages));
+            const promptTokens = estimatePromptTokens([
+                ...messageTexts(params.messages),
+                ...(params.promptExtras ?? []).map(jsonText),
+            ]);
             const maxTokens = positiveCount(params.maxTokens, exports.DEFAULT_MAX_TOKENS);
             return {
                 microCents: (0, budget_js_1.billedMicroCents)(tokenMicroCents(promptTokens, pricing.inputPer1mTokensCents) +
@@ -124,12 +163,8 @@ function estimateMicroCents(modality, params, pricing) {
             };
         }
         case "video": {
-            const seconds = positiveCount(params.seconds, exports.DEFAULT_VIDEO_SECONDS);
-            const raw = known(pricing.perVideoMicrocents)
-                ? rate(pricing.perVideoMicrocents)
-                : rate(pricing.perVideoSecondMicrocents) * seconds;
             return {
-                microCents: (0, budget_js_1.billedMicroCents)(raw),
+                microCents: (0, budget_js_1.billedMicroCents)(videoRaw(videoSeconds(params.seconds, pricing), pricing)),
                 isFloor: true,
                 pricingKnown: known(pricing.perVideoMicrocents) || known(pricing.perVideoSecondMicrocents),
             };
@@ -163,9 +198,16 @@ function actualMicroCents(modality, usage, pricing, fallbackEstimateMicroCents,
                 return fallback;
             return (0, budget_js_1.billedMicroCents)(imageRaw(usage.imageCount, params?.size, pricing));
         case "video":
-            if (!num(usage.costCents))
-                return fallback;
-            return (0, budget_js_1.billedMicroCents)(usage.costCents * budget_js_1.MICRO_CENTS_PER_CENT);
+            if (num(usage.costCents))
+                return (0, budget_js_1.billedMicroCents)(usage.costCents * budget_js_1.MICRO_CENTS_PER_CENT);
+            // No cost on the job: price it on the same basis as the estimate, at the
+            // job's own seconds when it reports them.
+            if (num(usage.seconds) && usage.seconds > 0) {
+                const raw = videoRaw(videoSeconds(usage.seconds, pricing), pricing);
+                if (raw > 0)
+                    return (0, budget_js_1.billedMicroCents)(raw);
+            }
+            return fallback;
     }
 }
 //# sourceMappingURL=estimate.js.map

package/dist/guardrail/estimate.js.map

@@ -1 +1 @@
-{"version":3,"file":"estimate.js","sourceRoot":"","sources":["../../src/guardrail/estimate.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"estimate.js","sourceRoot":"","sources":["../../src/guardrail/estimate.ts"],"names":[],"mappings":"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"}

package/dist/roster.d.ts

@@ -1,15 +1,15 @@
 export declare const TOOL_PREFIX = "deeprelay_";
 /** Free, non-mutating reads. No confirmation. Every route is a GET. */
-export declare const READ_TOOLS: readonly ["deeprelay_auth_status", "deeprelay_health", "deeprelay_models_list", "deeprelay_models_get", "deeprelay_inference_preflight", "deeprelay_usage_get", "deeprelay_balance_get", "deeprelay_spending_limit_get", "deeprelay_subscription_get", "deeprelay_deposits_list", "deeprelay_deposits_get", "deeprelay_referrals_get", "deeprelay_webhooks_list", "deeprelay_webhooks_get", "deeprelay_videos_list", "deeprelay_videos_get", "deeprelay_videos_content"];
+export declare const READ_TOOLS: readonly ["deeprelay_auth_status", "deeprelay_health", "deeprelay_models_list", "deeprelay_models_get", "deeprelay_inference_preflight", "deeprelay_usage_get", "deeprelay_balance_get", "deeprelay_spending_limit_get", "deeprelay_subscription_get", "deeprelay_deposits_list", "deeprelay_deposits_get", "deeprelay_referrals_get", "deeprelay_webhooks_list", "deeprelay_webhooks_get", "deeprelay_videos_list", "deeprelay_videos_get", "deeprelay_videos_content", "deeprelay_requests_list", "deeprelay_requests_get", "deeprelay_alerts_get"];
 /**
  * Mutations that do not charge the account directly. Each one asks for
  * confirmation once. Payment-link tools are here with no quote (D-09), because
  * nothing is charged until the user acts on the link.
  */
-export declare const WRITE_TOOLS: readonly ["deeprelay_webhooks_create", "deeprelay_webhooks_delete", "deeprelay_spending_limit_update", "deeprelay_spending_limit_clear", "deeprelay_subscription_checkout", "deeprelay_billing_portal", "deeprelay_deposits_create_crypto", "deeprelay_videos_cancel"];
+export declare const WRITE_TOOLS: readonly ["deeprelay_webhooks_create", "deeprelay_webhooks_delete", "deeprelay_spending_limit_update", "deeprelay_spending_limit_clear", "deeprelay_subscription_checkout", "deeprelay_billing_portal", "deeprelay_deposits_create_crypto", "deeprelay_videos_cancel", "deeprelay_alerts_set"];
 /** Billable inference. Each call goes quote → session budget → confirm (D-06..D-08, D-10). */
 export declare const SPEND_TOOLS: readonly ["deeprelay_chat_completion", "deeprelay_embeddings_create", "deeprelay_images_generate", "deeprelay_videos_create"];
-export declare const ALL_TOOLS: readonly ["deeprelay_auth_status", "deeprelay_health", "deeprelay_models_list", "deeprelay_models_get", "deeprelay_inference_preflight", "deeprelay_usage_get", "deeprelay_balance_get", "deeprelay_spending_limit_get", "deeprelay_subscription_get", "deeprelay_deposits_list", "deeprelay_deposits_get", "deeprelay_referrals_get", "deeprelay_webhooks_list", "deeprelay_webhooks_get", "deeprelay_videos_list", "deeprelay_videos_get", "deeprelay_videos_content", "deeprelay_webhooks_create", "deeprelay_webhooks_delete", "deeprelay_spending_limit_update", "deeprelay_spending_limit_clear", "deeprelay_subscription_checkout", "deeprelay_billing_portal", "deeprelay_deposits_create_crypto", "deeprelay_videos_cancel", "deeprelay_chat_completion", "deeprelay_embeddings_create", "deeprelay_images_generate", "deeprelay_videos_create"];
+export declare const ALL_TOOLS: readonly ["deeprelay_auth_status", "deeprelay_health", "deeprelay_models_list", "deeprelay_models_get", "deeprelay_inference_preflight", "deeprelay_usage_get", "deeprelay_balance_get", "deeprelay_spending_limit_get", "deeprelay_subscription_get", "deeprelay_deposits_list", "deeprelay_deposits_get", "deeprelay_referrals_get", "deeprelay_webhooks_list", "deeprelay_webhooks_get", "deeprelay_videos_list", "deeprelay_videos_get", "deeprelay_videos_content", "deeprelay_requests_list", "deeprelay_requests_get", "deeprelay_alerts_get", "deeprelay_webhooks_create", "deeprelay_webhooks_delete", "deeprelay_spending_limit_update", "deeprelay_spending_limit_clear", "deeprelay_subscription_checkout", "deeprelay_billing_portal", "deeprelay_deposits_create_crypto", "deeprelay_videos_cancel", "deeprelay_alerts_set", "deeprelay_chat_completion", "deeprelay_embeddings_create", "deeprelay_images_generate", "deeprelay_videos_create"];
 export type ReadToolName = (typeof READ_TOOLS)[number];
 export type WriteToolName = (typeof WRITE_TOOLS)[number];
 export type SpendToolName = (typeof SPEND_TOOLS)[number];

package/dist/roster.js

@@ -29,6 +29,11 @@
 // @deeprelay/sdk@0.2.0, exposes BillingApi.deleteSpendingLimit
 // (DELETE /billing/spending-limit). It is a WRITE because it removes a safety
 // cap: it confirms once, and requires the org-admin role server-side.
+// Phase 111 (R-08, D-15) adds tools 30-33: deeprelay_requests_list,
+// deeprelay_requests_get and deeprelay_alerts_get (READ) and
+// deeprelay_alerts_set (WRITE, confirms once, org-admin server-side), served
+// by @deeprelay/sdk RequestsApi / AlertsApi since the 0.3.0 pin.
+// /api-keys* is excluded on purpose.
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.EXCLUDED_PATHS = exports.TOOL_ROUTES = exports.ALL_TOOLS = exports.SPEND_TOOLS = exports.WRITE_TOOLS = exports.READ_TOOLS = exports.TOOL_PREFIX = void 0;
 exports.TOOL_PREFIX = "deeprelay_";
@@ -51,6 +56,10 @@ exports.READ_TOOLS = [
     "deeprelay_videos_list",
     "deeprelay_videos_get",
     "deeprelay_videos_content",
+    // Phase 111 (R-08): the request log and the alert settings.
+    "deeprelay_requests_list",
+    "deeprelay_requests_get",
+    "deeprelay_alerts_get",
 ];
 /**
  * Mutations that do not charge the account directly. Each one asks for
@@ -66,6 +75,7 @@ exports.WRITE_TOOLS = [
     "deeprelay_billing_portal",
     "deeprelay_deposits_create_crypto",
     "deeprelay_videos_cancel",
+    "deeprelay_alerts_set",
 ];
 /** Billable inference. Each call goes quote → session budget → confirm (D-06..D-08, D-10). */
 exports.SPEND_TOOLS = [
@@ -99,6 +109,9 @@ exports.TOOL_ROUTES = {
     deeprelay_videos_list: { method: "GET", path: "/videos" },
     deeprelay_videos_get: { method: "GET", path: "/videos/{id}" },
     deeprelay_videos_content: { method: "GET", path: "/videos/{id}/content" },
+    deeprelay_requests_list: { method: "GET", path: "/requests" },
+    deeprelay_requests_get: { method: "GET", path: "/requests/{id}" },
+    deeprelay_alerts_get: { method: "GET", path: "/alerts/settings" },
     // WRITE
     deeprelay_webhooks_create: { method: "POST", path: "/webhook-endpoints" },
     deeprelay_webhooks_delete: { method: "DELETE", path: "/webhook-endpoints/{id}" },
@@ -108,6 +121,7 @@ exports.TOOL_ROUTES = {
     deeprelay_billing_portal: { method: "POST", path: "/billing/subscription/portal" },
     deeprelay_deposits_create_crypto: { method: "POST", path: "/billing/deposits/crypto" },
     deeprelay_videos_cancel: { method: "POST", path: "/videos/{id}/cancel" },
+    deeprelay_alerts_set: { method: "PUT", path: "/alerts/settings" },
     // SPEND
     deeprelay_chat_completion: { method: "POST", path: "/chat/completions" },
     deeprelay_embeddings_create: { method: "POST", path: "/embeddings" },
@@ -121,6 +135,63 @@ exports.TOOL_ROUTES = {
  */
 exports.EXCLUDED_PATHS = {
     "/openapi.json": "spec download, not an agent capability (D-05)",
+    // Phase 105: the Anthropic Messages protocol for Claude Code and Anthropic
+    // SDK clients. chat_completion already covers inference for an agent; these
+    // are a wire-protocol twin, not a new capability.
+    "/messages": "Anthropic Messages protocol twin of chat completions, for Claude Code and Anthropic SDK clients (Phase 105)",
+    "/messages/count_tokens": "local, unbilled token estimate for Anthropic Messages clients (Phase 105)",
+    // Phase 106: the OpenAI Responses protocol for the Codex CLI. Same reasoning
+    // as /messages: a wire-protocol twin of chat completions, not a new agent
+    // capability. The four sub-routes and /responses/compact only ever return a
+    // documented stateless/compaction error.
+    "/responses": "OpenAI Responses protocol twin of chat completions, for the Codex CLI (Phase 106)",
+    "/responses/{id}": "stateless: always 404 `stateless`, deeprelay stores no responses (Phase 106)",
+    "/responses/{id}/cancel": "stateless: always 404 `stateless`, deeprelay stores no responses (Phase 106)",
+    "/responses/{id}/input_items": "stateless: always 404 `stateless`, deeprelay stores no responses (Phase 106)",
+    "/responses/compact": "always 400 `compaction_unsupported`; Codex compacts client-side (Phase 106)",
+    // Plus tier (2026-10-07): the upgrade endpoint CHARGES THE CARD ON FILE
+    // directly (full new price now, new period now). The MCP's payment surface
+    // is link-only (D-09): checkout and the portal mint a page the human
+    // completes, and nothing is paid from inside a tool call. An agent that
+    // wants a bigger plan sends the human to the billing page or
+    // `deeprelay billing upgrade`.
+    "/billing/subscription/upgrade": "charges the card on file directly; the MCP payment surface is link-only (D-09) — upgrade from the console or `deeprelay billing upgrade`",
+    // Payment methods and in-app plan management (dark-launched on demo):
+    // payment instruments and money/plan actions stay out of agent reach, like
+    // upgrade (D-09). Console Billing → Payment methods, or the CLI.
+    "/billing/payment-methods": "lists the org's payment instruments; admin-only and out of agent reach (D-09) — console or `deeprelay billing payment-methods`",
+    "/billing/payment-methods/setup": "adds a payment method; the MCP payment surface is link-only (D-09) — console or `deeprelay billing payment-methods add`",
+    "/billing/payment-methods/default": "changes which method auto-pay charges (D-09) — console or `deeprelay billing payment-methods set --auto-pay`",
+    "/billing/payment-methods/{id}": "removes a payment method and can cancel the plan (D-09) — console or `deeprelay billing payment-methods remove`",
+    "/billing/subscription/payment-method": "changes the plan's renewal method and retries a failed renewal, a charge (D-09) — console or `deeprelay billing payment-methods set --plan`",
+    "/billing/subscription/cancel": "cancels the plan (D-09) — console or `deeprelay billing cancel`",
+    "/billing/subscription/resume": "resumes a cancelling plan (D-09) — console or `deeprelay billing resume`",
+    // Phase 111 (R-08). The CSV export is a file download; an agent reads the
+    // same rows through deeprelay_requests_list. Key management stays out of
+    // agent reach entirely: an agent that can mint, widen or revoke keys is
+    // exactly what the keys:manage capability guards against.
+    "/requests/export": "file download; agents use deeprelay_requests_list (Phase 111)",
+    "/api-keys": "agent key management is what keys:manage guards against (R-08)",
+    "/api-keys/{id}": "agent key management is what keys:manage guards against (R-08)",
+    // Dedicated endpoints. These are marked `x-dark-launch: true` rather than
+    // `x-gpu-supply-paused`, and this audit's scanner only treats the latter as
+    // leaving its domain, so a dark path arrives here as an UNPAUSED path with
+    // no tool and has to be declined explicitly. That is the right shape: the
+    // routes exist only when DEDICATED_ENDPOINTS_ENABLED is on, which is
+    // nowhere, so a tool for them would be a tool whose every call 404s, and
+    // the replicas they provision are hourly GPU instances an agent must not be
+    // able to rent unattended. When the flag flips, whoever removes the marker
+    // meets these two entries and decides deliberately whether a tool is
+    // wanted, which is exactly what the mapped-or-excluded contract is for.
+    "/endpoints": "dark-launched (DEDICATED_ENDPOINTS_ENABLED is off everywhere); creating one rents hourly GPU replicas, which is not agent-unattended spend authority",
+    "/endpoints/{id}": "dark-launched (DEDICATED_ENDPOINTS_ENABLED is off everywhere); read, scale and delete follow the create exclusion above",
+    "/deployments": "dark-launched (the product is unpublished); creating one rents dedicated GPUs billed per second, which is not agent-unattended spend authority",
+    "/deployments/hardware": "dark-launched; the hardware list only feeds the create above",
+    "/deployments/{id}": "dark-launched; read, scale and delete follow the create exclusion above",
+    "/deployments/{id}/stop": "dark-launched; follows the create exclusion above",
+    "/deployments/{id}/start": "dark-launched; starting resumes paid GPUs, which follows the create exclusion above",
+    "/deployments/{id}/events": "dark-launched; follows the create exclusion above",
+    "/deployments/{id}/metrics": "dark-launched; follows the create exclusion above",
     // /operations/{id} was listed here while it was still an UNPAUSED path with
     // no tool. Phase 103 D-08 landed the x-gpu-supply-paused marker, so it is no
     // longer unpaused and an exclusion entry for it would now fail the audit's

package/dist/roster.js.map

@@ -1 +1 @@
-{"version":3,"file":"roster.js","sourceRoot":"","sources":["../src/roster.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"roster.js","sourceRoot":"","sources":["../src/roster.ts"],"names":[],"mappings":"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"}

package/dist/tools/api-json.d.ts

@@ -0,0 +1,5 @@
+import type { ApiResponse } from "@deeprelay/sdk";
+/** Await a *Raw SDK call and decode its JSON body without the SDK's model mapping. */
+export declare function apiJson(call: Promise<ApiResponse<unknown>>): Promise<unknown>;
+/** apiJson for an endpoint that answers with a JSON object (for spreading into a view). */
+export declare function apiObject(call: Promise<ApiResponse<unknown>>): Promise<Record<string, unknown>>;

package/dist/tools/api-json.js

@@ -0,0 +1,15 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.apiJson = apiJson;
+exports.apiObject = apiObject;
+/** Await a *Raw SDK call and decode its JSON body without the SDK's model mapping. */
+async function apiJson(call) {
+    const response = await call;
+    return (await response.raw.json());
+}
+/** apiJson for an endpoint that answers with a JSON object (for spreading into a view). */
+async function apiObject(call) {
+    const body = await apiJson(call);
+    return typeof body === "object" && body !== null && !Array.isArray(body) ? body : {};
+}
+//# sourceMappingURL=api-json.js.map

package/dist/tools/api-json.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"api-json.js","sourceRoot":"","sources":["../../src/tools/api-json.ts"],"names":[],"mappings":";;AAuBA,0BAGC;AAGD,8BAGC;AAVD,sFAAsF;AAC/E,KAAK,UAAU,OAAO,CAAC,IAAmC;IAC/D,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC;IAC5B,OAAO,CAAC,MAAM,QAAQ,CAAC,GAAG,CAAC,IAAI,EAAE,CAAY,CAAC;AAChD,CAAC;AAED,2FAA2F;AACpF,KAAK,UAAU,SAAS,CAAC,IAAmC;IACjE,MAAM,IAAI,GAAG,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IACjC,OAAO,OAAO,IAAI,KAAK,QAAQ,IAAI,IAAI,KAAK,IAAI,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAE,IAAgC,CAAC,CAAC,CAAC,EAAE,CAAC;AACpH,CAAC"}

package/dist/tools/readonly/alerts.d.ts

@@ -0,0 +1,26 @@
+import { type Configuration } from "@deeprelay/sdk";
+import { z } from "zod";
+export declare const alertEmailTogglesSchema: z.ZodObject<{
+    balance_low: z.ZodBoolean;
+    subscription_quota: z.ZodBoolean;
+    api_key_budget: z.ZodBoolean;
+    member_spend: z.ZodBoolean;
+}, z.core.$strip>;
+/** The settings view. Closed: unknown fields are dropped. */
+export declare const alertSettingsSchema: z.ZodObject<{
+    balance_threshold_cents: z.ZodNumber;
+    email: z.ZodObject<{
+        balance_low: z.ZodBoolean;
+        subscription_quota: z.ZodBoolean;
+        api_key_budget: z.ZodBoolean;
+        member_spend: z.ZodBoolean;
+    }, z.core.$strip>;
+    updated_at: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    note: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export type AlertSettings = z.infer<typeof alertSettingsSchema>;
+/** GET /alerts/settings, parsed. */
+export declare function getAlertSettings(config: Configuration): Promise<AlertSettings>;
+/** The view the agent sees: the API fields plus the threshold in dollars. */
+export declare function alertSettingsView(s: AlertSettings): Record<string, unknown>;
+export declare const alertReadTools: import("../types.js").ToolDefinition[];