run402 4.19.0 → 4.21.0

package/sdk/dist/namespaces/escalations.js.map

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

package/sdk/dist/namespaces/escalations.types.d.ts

@@ -0,0 +1,179 @@
+/**
+ * Wire types for the `escalations` namespace — the agent→human hotline
+ * (gateway `add-agent-escalations`).
+ *
+ * Every field is the gateway's `snake_case` wire shape, passed through
+ * unchanged. Timestamps are ISO 8601.
+ */
+/** Who raised it. An escalation is always attributed — that is the point. */
+export interface EscalationRaisedBy {
+    /** The control-plane principal the judgement belongs to. */
+    principal_id: string;
+    /** Set when the raiser was a scoped delegate rather than a member. */
+    delegate_id: string | null;
+    /** The coordination-room presence name, when the agent supplied one. */
+    presence_name: string | null;
+}
+/** A human took ownership. This is what the raiser is waiting for. */
+export interface EscalationAcknowledgement {
+    at: string;
+    /** The acking human's verified email; null when acked by an unnamed token tap. */
+    by_email: string | null;
+    /** `token` = one-tap link from the page; `authenticated` = an org member. */
+    channel: "token" | "authenticated";
+}
+export interface EscalationResolution {
+    at: string;
+    by_email: string | null;
+    note: string | null;
+}
+/** One deadman hop, appended when a level let its deadline lapse. */
+export interface EscalationClimb {
+    from_level: number;
+    to_level: number;
+    at: string;
+    reason: "deadline_lapsed";
+}
+/**
+ * What actually happened on the wire, per contact × channel. Only present when
+ * the read asked for it (`include: "delivery"`) — it is read from the delivery
+ * audit log, never assumed.
+ */
+export interface EscalationDeliveryAttempt {
+    email: string;
+    /** `email` | `telegram` | `webhook`. */
+    channel: string;
+    /** `delivered` | `failed_transient` | `failed_permanent` | `skipped_disabled`. */
+    status: string;
+    error: string | null;
+    at: string;
+}
+export interface Escalation {
+    escalation_id: string;
+    org_id: string;
+    /**
+     * A SOFT reference: the escalation outlives this project's deletion, because
+     * the case that matters most is being paged about something that then gets
+     * deleted.
+     */
+    project_id: string | null;
+    raised_by: EscalationRaisedBy;
+    severity: "normal" | "high";
+    /** The agent's argument, verbatim. Rendered as DATA wherever it is shown. */
+    reason: string;
+    /** Structured sidecar. Readable here; never rendered into a page body. */
+    details: Record<string, unknown>;
+    status: "open" | "acknowledged" | "resolved";
+    /** Which contact level is currently paged. */
+    level: number;
+    raised_at: string;
+    /** When an unacknowledged escalation climbs to the next level. */
+    deadline_at: string;
+    acknowledged: EscalationAcknowledgement | null;
+    resolved: EscalationResolution | null;
+    climbs: EscalationClimb[];
+    /**
+     * Top-level re-pages so far. At the bound the escalation rests OPEN — never
+     * auto-resolved, because "every human was paged and none answered" is not
+     * the same thing as "handled".
+     */
+    repage_count: number;
+    /** Only when the read passed `include: "delivery"`. */
+    delivery_attempts?: EscalationDeliveryAttempt[];
+}
+/**
+ * Who the raise is about to page. FUTURE TENSE on purpose: at raise time the
+ * page is enqueued, not delivered, and a contact with no verified operator
+ * email never receives the Telegram half at all. Ask for
+ * `include: "delivery"` on a read to learn what actually landed.
+ */
+export interface EscalationDelivery {
+    status: "queued";
+    level: number;
+    will_page: Array<{
+        email: string;
+        display_name: string | null;
+    }>;
+    deadline_at: string;
+}
+export interface RaisedEscalation extends Escalation {
+    delivery: EscalationDelivery;
+    /** True when an `idempotencyKey` replay returned the ORIGINAL escalation. */
+    deduplicated: boolean;
+    /**
+     * Non-blocking reachability notes — e.g. the org has no escalation contacts
+     * configured, so the escalation was recorded but nobody was paged.
+     */
+    warnings?: string[];
+    next_actions?: Array<Record<string, unknown>>;
+}
+export interface EscalationList {
+    escalations: Escalation[];
+    /**
+     * `organization` when the caller is a member (sees every escalation);
+     * `own` for a delegate or grant-only principal (sees only what it raised).
+     */
+    scope: "organization" | "own";
+    has_more: boolean;
+    /** Opaque keyset continuation. Store and echo; never parse. */
+    next_cursor: string | null;
+}
+export interface EscalationContact {
+    contact_id: string;
+    email: string;
+    display_name: string | null;
+    /** An ordering, not a rank: level 1 is paged first. */
+    level: number;
+    created_at: string;
+    /** Present when the address has no verified operator email yet. */
+    warnings?: string[];
+}
+export interface EscalationContactList {
+    escalation_contacts: EscalationContact[];
+}
+export interface RaiseEscalationInput {
+    /**
+     * Your argument for why a human is needed. Over ~4 KiB is a 400, never a
+     * truncation — the argument IS the escalation.
+     */
+    reason: string;
+    severity?: "normal" | "high";
+    projectId?: string;
+    /** Your coordination-room presence name, so a human knows which agent this is. */
+    presenceName?: string;
+    details?: Record<string, unknown>;
+    /** A replay returns the ORIGINAL escalation and never pages twice. */
+    idempotencyKey?: string;
+}
+export interface ListEscalationsOptions {
+    status?: "open" | "acknowledged" | "resolved";
+    limit?: number;
+    /** Opaque `next_cursor` from a previous page. */
+    cursor?: string;
+}
+export interface GetEscalationOptions {
+    /**
+     * `"delivery"` adds `delivery_attempts[]` from the delivery audit log.
+     * Opt-in: the wait-for-human poll is the hot path and should not pay for an
+     * audit read it rarely needs.
+     */
+    include?: "delivery";
+}
+export interface AddEscalationContactInput {
+    email: string;
+    displayName?: string;
+    /** Defaults to 1. Level N is paged only if level < N let the deadline lapse. */
+    level?: number;
+}
+export interface EscalationActionResult extends Escalation {
+    /** False on an idempotent replay — the ORIGINAL acknowledgement is reported. */
+    changed: boolean;
+}
+export interface TokenAckResult {
+    escalation_id: string;
+    status: "acknowledged" | "resolved";
+    acknowledged_at: string | null;
+    changed: boolean;
+    reason: string;
+}
+//# sourceMappingURL=escalations.types.d.ts.map

package/sdk/dist/namespaces/escalations.types.d.ts.map

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

package/sdk/dist/namespaces/escalations.types.js

@@ -0,0 +1,9 @@
+/**
+ * Wire types for the `escalations` namespace — the agent→human hotline
+ * (gateway `add-agent-escalations`).
+ *
+ * Every field is the gateway's `snake_case` wire shape, passed through
+ * unchanged. Timestamps are ISO 8601.
+ */
+export {};
+//# sourceMappingURL=escalations.types.js.map

package/sdk/dist/namespaces/escalations.types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"escalations.types.js","sourceRoot":"","sources":["../../src/namespaces/escalations.types.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG"}

package/sdk/dist/namespaces/vouchers.d.ts

@@ -0,0 +1,76 @@
+/**
+ * `vouchers` namespace — redeem a promo code for platform credit.
+ *
+ * A promo code credits your organization with run402 prepaid credit. That
+ * credit spends like any other prepaid balance: a tier purchase settles from
+ * it with no on-chain payment.
+ *
+ * Two properties make this safe to call from anywhere in an agent's lifecycle:
+ *
+ * - **Order does not matter.** Redemption works as the very first authenticated
+ *   call a brand-new wallet makes (the organization is provisioned on demand),
+ *   or long after `run402 init`. There is no init-before-redeem requirement.
+ * - **Retrying is safe.** A repeat by the same organization returns the ORIGINAL
+ *   result with `already_redeemed: true` and never credits twice, so a call that
+ *   times out client-side can simply be re-issued.
+ *
+ * This namespace is deliberately thin and semantically blind: it forwards an
+ * opaque code string to one gateway route. It does not know what a code means,
+ * where it came from, or who issued it. Minting is not an agent operation —
+ * it needs a registered issuer key that no tenant holds.
+ */
+import type { Client } from "../kernel.js";
+/**
+ * A follow-up the gateway suggests after a redemption — most often buying the
+ * tier the new balance now covers.
+ */
+export interface VoucherNextAction {
+    type: string;
+    method?: string;
+    path?: string;
+    /** Ready-to-run CLI equivalent, when the action has one. */
+    cli?: string;
+    why?: string;
+    [key: string]: unknown;
+}
+export interface RedeemVoucherResult {
+    voucher_id: string;
+    /** Credit applied by this voucher. */
+    amount_usd_micros: number;
+    /** The organization's available prepaid balance AFTER the credit. */
+    balance_usd_micros: number;
+    organization_id: string;
+    redeemed_at: string;
+    /**
+     * True when THIS organization had already redeemed this code. The original
+     * result is returned unchanged and no second credit was made — a replay is
+     * reported honestly rather than dressed up as a fresh redemption.
+     */
+    already_redeemed: boolean;
+    /** Lifetime promo-credit ceiling for one organization. */
+    promo_lifetime_ceiling_usd_micros: number;
+    next_actions: VoucherNextAction[];
+}
+export declare class Vouchers {
+    private readonly client;
+    /** Alias of {@link redeem}. */
+    readonly redeemCode: (code: string) => Promise<RedeemVoucherResult>;
+    constructor(client: Client);
+    /**
+     * Redeem a promo code into the authenticated wallet's organization.
+     *
+     * The code is sent verbatim — the gateway owns the grammar and is forgiving
+     * about it (case-insensitive, hyphens optional, and the Crockford
+     * confusables `O`→`0` / `I`,`L`→`1` are mapped), so a client-side format
+     * check would only invent ways to reject a code the server would have
+     * accepted.
+     *
+     * Requires wallet (SIWX) auth. Errors carry the canonical envelope:
+     * `VOUCHER_NOT_FOUND` (404 — unknown *or* malformed, deliberately
+     * indistinguishable), `VOUCHER_EXPIRED` (410), `VOUCHER_ALREADY_REDEEMED`
+     * (409 — a different organization got there first), `PROMO_LIMIT_REACHED`
+     * (403), `RATE_LIMITED` (429).
+     */
+    redeem(code: string): Promise<RedeemVoucherResult>;
+}
+//# sourceMappingURL=vouchers.d.ts.map

package/sdk/dist/namespaces/vouchers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"vouchers.d.ts","sourceRoot":"","sources":["../../src/namespaces/vouchers.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AAG3C;;;GAGG;AACH,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,4DAA4D;IAC5D,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED,MAAM,WAAW,mBAAmB;IAClC,UAAU,EAAE,MAAM,CAAC;IACnB,sCAAsC;IACtC,iBAAiB,EAAE,MAAM,CAAC;IAC1B,qEAAqE;IACrE,kBAAkB,EAAE,MAAM,CAAC;IAC3B,eAAe,EAAE,MAAM,CAAC;IACxB,WAAW,EAAE,MAAM,CAAC;IACpB;;;;OAIG;IACH,gBAAgB,EAAE,OAAO,CAAC;IAC1B,0DAA0D;IAC1D,iCAAiC,EAAE,MAAM,CAAC;IAC1C,YAAY,EAAE,iBAAiB,EAAE,CAAC;CACnC;AAED,qBAAa,QAAQ;IAIP,OAAO,CAAC,QAAQ,CAAC,MAAM;IAHnC,+BAA+B;IAC/B,QAAQ,CAAC,UAAU,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,mBAAmB,CAAC,CAAC;gBAEvC,MAAM,EAAE,MAAM;IAI3C;;;;;;;;;;;;;;OAcG;IACG,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,mBAAmB,CAAC;CAQzD"}

package/sdk/dist/namespaces/vouchers.js

@@ -0,0 +1,55 @@
+/**
+ * `vouchers` namespace — redeem a promo code for platform credit.
+ *
+ * A promo code credits your organization with run402 prepaid credit. That
+ * credit spends like any other prepaid balance: a tier purchase settles from
+ * it with no on-chain payment.
+ *
+ * Two properties make this safe to call from anywhere in an agent's lifecycle:
+ *
+ * - **Order does not matter.** Redemption works as the very first authenticated
+ *   call a brand-new wallet makes (the organization is provisioned on demand),
+ *   or long after `run402 init`. There is no init-before-redeem requirement.
+ * - **Retrying is safe.** A repeat by the same organization returns the ORIGINAL
+ *   result with `already_redeemed: true` and never credits twice, so a call that
+ *   times out client-side can simply be re-issued.
+ *
+ * This namespace is deliberately thin and semantically blind: it forwards an
+ * opaque code string to one gateway route. It does not know what a code means,
+ * where it came from, or who issued it. Minting is not an agent operation —
+ * it needs a registered issuer key that no tenant holds.
+ */
+import { assertNonEmptyString } from "../validation.js";
+export class Vouchers {
+    client;
+    /** Alias of {@link redeem}. */
+    redeemCode;
+    constructor(client) {
+        this.client = client;
+        this.redeemCode = this.redeem.bind(this);
+    }
+    /**
+     * Redeem a promo code into the authenticated wallet's organization.
+     *
+     * The code is sent verbatim — the gateway owns the grammar and is forgiving
+     * about it (case-insensitive, hyphens optional, and the Crockford
+     * confusables `O`→`0` / `I`,`L`→`1` are mapped), so a client-side format
+     * check would only invent ways to reject a code the server would have
+     * accepted.
+     *
+     * Requires wallet (SIWX) auth. Errors carry the canonical envelope:
+     * `VOUCHER_NOT_FOUND` (404 — unknown *or* malformed, deliberately
+     * indistinguishable), `VOUCHER_EXPIRED` (410), `VOUCHER_ALREADY_REDEEMED`
+     * (409 — a different organization got there first), `PROMO_LIMIT_REACHED`
+     * (403), `RATE_LIMITED` (429).
+     */
+    async redeem(code) {
+        assertNonEmptyString(code, "code", "redeeming a promo code");
+        return this.client.request("/vouchers/v1/redemptions", {
+            method: "POST",
+            body: { code },
+            context: "redeeming a promo code",
+        });
+    }
+}
+//# sourceMappingURL=vouchers.js.map

package/sdk/dist/namespaces/vouchers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"vouchers.js","sourceRoot":"","sources":["../../src/namespaces/vouchers.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAGH,OAAO,EAAE,oBAAoB,EAAE,MAAM,kBAAkB,CAAC;AAmCxD,MAAM,OAAO,QAAQ;IAIU;IAH7B,+BAA+B;IACtB,UAAU,CAAiD;IAEpE,YAA6B,MAAc;QAAd,WAAM,GAAN,MAAM,CAAQ;QACzC,IAAI,CAAC,UAAU,GAAG,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC3C,CAAC;IAED;;;;;;;;;;;;;;OAcG;IACH,KAAK,CAAC,MAAM,CAAC,IAAY;QACvB,oBAAoB,CAAC,IAAI,EAAE,MAAM,EAAE,wBAAwB,CAAC,CAAC;QAC7D,OAAO,IAAI,CAAC,MAAM,CAAC,OAAO,CAAsB,0BAA0B,EAAE;YAC1E,MAAM,EAAE,MAAM;YACd,IAAI,EAAE,EAAE,IAAI,EAAE;YACd,OAAO,EAAE,wBAAwB;SAClC,CAAC,CAAC;IACL,CAAC;CACF"}