@weirgate/cli 0.1.0 → 0.2.0

package/dist/cli/browser-session-grant.js

@@ -74,10 +74,10 @@ async function exchangeSessionGrantCode(apiUrl, code, fetchImpl) {
     const apiVersion = response.headers.get("Weirgate-Api-Version") ?? "unknown";
     const payload = await response.json().catch(() => ({}));
     if (apiVersion !== API_VERSION) {
-        throw new WeirgateApiError({ message: `API version mismatch: expected ${API_VERSION}, received ${apiVersion}`, errorType: "api_version_mismatch", status: 502, requestId, apiVersion, details: payload });
+        throw new WeirgateApiError({ message: `API version mismatch: expected ${API_VERSION}, received ${apiVersion}`, errorType: "api_version_mismatch", status: 502, requestId, apiVersion, detail: { expected: API_VERSION, received: apiVersion } });
     }
     if (!response.ok || typeof payload.value !== "string") {
-        throw new WeirgateApiError({ message: payload.error?.message ?? `Weirgate API returned HTTP ${response.status}`, errorType: response.headers.get("X-Weirgate-Error-Type") ?? payload.error?.type ?? "remote_error", status: response.status, requestId, apiVersion, details: payload.error?.details ?? payload });
+        throw new WeirgateApiError({ message: payload.error?.message ?? `Weirgate API returned HTTP ${response.status}`, errorType: response.headers.get("X-Weirgate-Error-Type") ?? payload.error?.type ?? "remote_error", status: response.status, requestId, apiVersion, ...(payload.error?.detail ? { detail: payload.error.detail } : {}) });
     }
     return payload.value;
 }

package/dist/cli/index.js

@@ -147,14 +147,15 @@ async function commandToTool(client, noun, verb, flags) {
         "audit:list": ["weirgate_list_audit_events", { ...common, since: stringFlag(flags, "since"), until: stringFlag(flags, "until"), action: stringFlag(flags, "action") }],
         "provider-keys:list": ["weirgate_list_provider_key_slots", common],
         "provider-keys:test": ["weirgate_test_provider_key", { ...common, provider: requiredFlag(flags, "provider") }],
-        "grants:create": ["weirgate_grant_allowance", { ...common, external_id: requiredFlag(flags, "user"), units: numberRequired(flags, "units"), reason: stringFlag(flags, "reason") }],
+        "grants:create": ["weirgate_grant_allowance", { ...common, external_id: requiredFlag(flags, "user"), units: numberRequired(flags, "units"), source: stringFlag(flags, "source") }],
         "grants:reverse": ["weirgate_reverse_grant", { ...common, grant_id: requiredFlag(flags, "grant") }],
         "user-tiers:assign": ["weirgate_assign_user_tier", { ...common, external_id: requiredFlag(flags, "user"), tier: requiredFlag(flags, "tier"), top_up_now: booleanFlag(flags, "top-up-now") }],
         "user-tiers:revert": ["weirgate_revert_user_tier", { ...common, external_id: requiredFlag(flags, "user"), top_up_now: booleanFlag(flags, "top-up-now") }],
-        "doctor:all": ["weirgate_run_config_doctor", { ...common, checks: ["auth", "provider", "webhook"] }],
+        "doctor:all": ["weirgate_run_config_doctor", { ...common, checks: ["auth", "provider", "webhook", "payments"] }],
         "doctor:auth": ["weirgate_run_config_doctor", { ...common, checks: ["auth"] }],
         "doctor:provider": ["weirgate_run_config_doctor", { ...common, checks: ["provider"] }],
         "doctor:webhook": ["weirgate_run_config_doctor", { ...common, checks: ["webhook"] }],
+        "doctor:payments": ["weirgate_run_config_doctor", { ...common, checks: ["payments"] }],
         "sandbox:call": ["weirgate_run_mock_call", { ...common, fixture: stringFlag(flags, "fixture") ?? "success", session_name: stringFlag(flags, "session-name") }],
         "docs:search": ["weirgate_search_docs", { query: requiredFlag(flags, "query"), section: stringFlag(flags, "section"), limit: numberFlag(flags, "limit") }],
         "docs:get": ["weirgate_get_doc", { page_id: requiredFlag(flags, "page") }],
@@ -303,7 +304,7 @@ function printSuccess(result, flags) {
 }
 function printError(error, flags) {
     const typed = error instanceof WeirgateApiError ? error : new WeirgateApiError({ message: error instanceof Error ? error.message : String(error), errorType: "internal", status: 500, requestId: "local", apiVersion: API_VERSION });
-    const envelope = { ok: false, error: { type: typed.errorType, message: typed.message, details: typed.details }, request_id: typed.requestId, api_version: typed.apiVersion };
+    const envelope = { ok: false, error: { type: typed.errorType, message: typed.message, request_id: typed.requestId, ...(typed.detail ? { detail: typed.detail } : {}) }, api_version: typed.apiVersion };
     if (flags.json || !process.stderr.isTTY)
         process.stderr.write(`${JSON.stringify(envelope)}\n`);
     else

package/dist/mcp/server.js

@@ -60,7 +60,7 @@ export function createMcpServer(auth) {
         }
         catch (error) {
             if (error instanceof WeirgateApiError)
-                return errorResult(error.errorType, error.message, error.requestId, error.details, error.apiVersion);
+                return errorResult(error.errorType, error.message, error.requestId, error.detail, error.apiVersion);
             return errorResult("invalid_request", error instanceof Error ? error.message : String(error), "local");
         }
     });
@@ -75,8 +75,9 @@ function removeSecretValues(value) {
         ? []
         : [[key, removeSecretValues(item)]]));
 }
-function errorResult(type, message, requestId, details, apiVersion = API_VERSION) {
-    const body = { error: { type, message, ...(details === undefined ? {} : { details }) }, request_id: requestId, api_version: apiVersion };
+/** Mirrors the HTTP error envelope (`error.type`, `message`, `request_id`, `detail`), plus `api_version`. */
+function errorResult(type, message, requestId, detail, apiVersion = API_VERSION) {
+    const body = { error: { type, message, request_id: requestId, ...(detail === undefined ? {} : { detail }) }, api_version: apiVersion };
     return {
         isError: true,
         content: [{ type: "text", text: JSON.stringify(body) }],

package/dist/shared/api-client.js

@@ -5,7 +5,8 @@ export class WeirgateApiError extends Error {
     status;
     requestId;
     apiVersion;
-    details;
+    /** The API error's `detail` (for example `detail.reason`), as the HTTP envelope carries it. */
+    detail;
     constructor(input) {
         super(input.message);
         this.name = "WeirgateApiError";
@@ -13,7 +14,7 @@ export class WeirgateApiError extends Error {
         this.status = input.status;
         this.requestId = input.requestId;
         this.apiVersion = input.apiVersion;
-        this.details = input.details;
+        this.detail = input.detail;
     }
 }
 export class AgentApiClient {
@@ -73,7 +74,7 @@ export class AgentApiClient {
                 status: 502,
                 requestId,
                 apiVersion,
-                details: payload,
+                detail: { expected: API_VERSION, received: apiVersion },
             });
         }
         if (!response.ok) {
@@ -84,7 +85,7 @@ export class AgentApiClient {
                 status: response.status,
                 requestId,
                 apiVersion,
-                details: body?.error?.details ?? payload,
+                ...(body?.error?.detail ? { detail: body.error.detail } : {}),
             });
         }
         return { data: payload, request_id: requestId, api_version: API_VERSION };

package/dist/shared/tools.js

@@ -19,7 +19,7 @@ export const TOOL_DEFINITIONS = [
     { name: "weirgate_search_docs", title: "Search docs", description: "Search the authenticated canonical Markdown corpus.", scope: "read", group: "docs", inputSchema: objectSchema({ query: str(), section: str(), limit: integer() }, ["query"]) },
     { name: "weirgate_get_doc", title: "Get doc", description: "Read one canonical Markdown document.", scope: "read", group: "docs", inputSchema: objectSchema({ page_id: str() }, ["page_id"]) },
     { name: "weirgate_get_onboarding_state", title: "Get onboarding state", description: "Read durable onboarding readiness evidence.", scope: "read", group: "setup", inputSchema: objectSchema(app, appRequired) },
-    { name: "weirgate_run_config_doctor", title: "Run config doctor", description: "Run non-billable configuration checks.", scope: "read", group: "setup", inputSchema: objectSchema({ ...app, checks: { type: "array", items: { enum: ["auth", "provider", "webhook"] } } }, appRequired) },
+    { name: "weirgate_run_config_doctor", title: "Run config doctor", description: "Run non-billable configuration checks.", scope: "read", group: "setup", inputSchema: objectSchema({ ...app, checks: { type: "array", items: { enum: ["auth", "provider", "webhook", "payments"] } } }, appRequired) },
     { name: "weirgate_list_provider_key_slots", title: "List provider key slots", description: "List write-only provider slot metadata. No key values are returned.", scope: "read", group: "provider_keys", inputSchema: objectSchema(app) },
     { name: "weirgate_test_provider_key", title: "Test provider key", description: "Run a non-billable metadata probe for an existing provider slot.", scope: "read", group: "provider_keys", inputSchema: objectSchema({ ...app, provider: str() }, ["app_id", "provider"]) },
     { name: "weirgate_get_integration_snippet", title: "Get integration snippet", description: "Generate an HTTP/curl integration snippet.", scope: "read", group: "setup", inputSchema: objectSchema({ ...app, mode: { enum: ["http", "curl"] }, feature_id: str() }, appRequired) },
@@ -44,7 +44,7 @@ export const TOOL_DEFINITIONS = [
     { name: "weirgate_preview_rules", title: "Preview rules", description: "Preview rules against recent traffic and bind a content hash.", scope: "propose", group: "rules", inputSchema: objectSchema({ ...app, ruleset: document(), since: str(), until: str() }, ["app_id", "ruleset", "since", "until"]) },
     { name: "weirgate_propose_rules", title: "Propose rules", description: "Create a preview-hash-bound rules proposal.", scope: "propose", group: "rules", inputSchema: objectSchema({ ...app, ruleset: document(), preview_id: str() }, ["app_id", "ruleset", "preview_id"]) },
     { name: "weirgate_propose_user_override", title: "Propose user override", description: "Preview and propose a per-user velocity override.", scope: "propose", group: "rules", inputSchema: objectSchema({ ...app, external_id: str(), override: document(), since: str(), until: str() }, ["app_id", "external_id", "override"]) },
-    { name: "weirgate_grant_allowance", title: "Grant allowance", description: "Grant units idempotently to a user.", scope: "apply", group: "credits", inputSchema: objectSchema({ ...app, external_id: str(), units: integer(), reason: str(), idempotency_key: str() }, ["app_id", "external_id", "units", "idempotency_key"]) },
+    { name: "weirgate_grant_allowance", title: "Grant allowance", description: "Grant units idempotently to a user.", scope: "apply", group: "credits", inputSchema: objectSchema({ ...app, external_id: str(), units: { type: "number", exclusiveMinimum: 0 }, source: str(), idempotency_key: str() }, ["app_id", "external_id", "units", "idempotency_key"]) },
     { name: "weirgate_reverse_grant", title: "Reverse grant", description: "Reverse an allowance grant idempotently.", scope: "apply", group: "credits", inputSchema: objectSchema({ ...app, grant_id: str(), idempotency_key: str() }, ["app_id", "grant_id", "idempotency_key"]) },
     { name: "weirgate_assign_user_tier", title: "Assign user tier", description: "Schedule a configured user tier for the next monthly grant, with an optional current-period delta top-up.", scope: "apply", group: "plans", inputSchema: objectSchema({ ...app, external_id: str(), tier: str(), top_up_now: { type: "boolean" }, idempotency_key: str() }, ["app_id", "external_id", "tier", "idempotency_key"]) },
     { name: "weirgate_revert_user_tier", title: "Revert user tier", description: "Schedule a user to return to the app default tier, with an optional current-period delta top-up.", scope: "apply", group: "plans", inputSchema: objectSchema({ ...app, external_id: str(), top_up_now: { type: "boolean" }, idempotency_key: str() }, ["app_id", "external_id", "idempotency_key"]) },
@@ -109,7 +109,7 @@ export async function invokeTool(client, name, rawInput) {
         case "weirgate_search_docs": return client.request("/v1/admin/docs/search", { query: q(input, ["query", "section", "limit"]) });
         case "weirgate_get_doc": return client.request(`/v1/admin/docs/${pathPart(input.page_id)}`);
         case "weirgate_get_onboarding_state": return client.request(`/v1/admin/apps/${a()}/readiness`);
-        case "weirgate_run_config_doctor": return client.request(`/v1/admin/apps/${a()}/doctor`, { method: "POST", body: { checks: input.checks ?? ["auth", "provider", "webhook"] } });
+        case "weirgate_run_config_doctor": return client.request(`/v1/admin/apps/${a()}/doctor`, { method: "POST", body: { checks: input.checks ?? ["auth", "provider", "webhook", "payments"] } });
         case "weirgate_list_provider_key_slots": return client.request("/v1/admin/provider-keys", { query: q(input, ["app_id"]) });
         case "weirgate_test_provider_key": return client.request(`/v1/admin/provider-keys/${pathPart(input.provider)}/health`, { method: "POST", query: { app_id: String(input.app_id) } });
         case "weirgate_get_integration_snippet": return client.request(`/v1/admin/apps/${a()}/integration-snippet`, { query: q(input, ["mode", "feature_id"]) });
@@ -154,7 +154,7 @@ export async function invokeTool(client, name, rawInput) {
             const preview = await client.request(`/v1/admin/apps/${a()}/rules:preview`, { method: "POST", body: { ruleset, since: input.since, until: input.until } });
             return client.request(`/v1/admin/apps/${a()}/rules/proposals`, { method: "POST", body: { ruleset, preview_id: preview.data.preview_id } });
         }
-        case "weirgate_grant_allowance": return client.request(`/v1/admin/apps/${a()}/users/${pathPart(input.external_id)}/grants`, { method: "POST", idempotencyKey: String(input.idempotency_key), body: { units: input.units, reason: input.reason ?? "agent grant" } });
+        case "weirgate_grant_allowance": return client.request(`/v1/admin/apps/${a()}/users/${pathPart(input.external_id)}/grants`, { method: "POST", idempotencyKey: String(input.idempotency_key), body: { units: input.units, ...(input.source === undefined ? {} : { source: input.source }) } });
         case "weirgate_reverse_grant": return client.request(`/v1/admin/apps/${a()}/grants/${pathPart(input.grant_id)}/reverse`, { method: "POST", idempotencyKey: String(input.idempotency_key) });
         case "weirgate_assign_user_tier": return client.request(`/v1/admin/apps/${a()}/users/${pathPart(input.external_id)}/tier`, { method: "PUT", idempotencyKey: String(input.idempotency_key), body: { tier: input.tier, top_up_now: input.top_up_now ?? false } });
         case "weirgate_revert_user_tier": return client.request(`/v1/admin/apps/${a()}/users/${pathPart(input.external_id)}/tier`, { method: "DELETE", idempotencyKey: String(input.idempotency_key), body: { top_up_now: input.top_up_now ?? false } });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@weirgate/cli",
-  "version": "0.1.0",
+  "version": "0.2.0",
   "description": "Weirgate CLI and local stdio MCP server: scoped, proposal-first management of Weirgate apps.",
   "license": "MIT",
   "author": "Astraen Labs LLC",