@rymi/node 1.0.1 → 2.1.0

package/dist/index.js

@@ -34,6 +34,9 @@ __export(index_exports, {
   AgentsResource: () => AgentsResource,
   BillingResource: () => BillingResource,
   CallsResource: () => CallsResource,
+  CampaignsResource: () => CampaignsResource,
+  ComplianceResource: () => ComplianceResource,
+  ContactsResource: () => ContactsResource,
   DncResource: () => DncResource,
   KeysResource: () => KeysResource,
   NumbersResource: () => NumbersResource,
@@ -42,6 +45,7 @@ __export(index_exports, {
   RymiError: () => RymiError,
   TelephonyResource: () => TelephonyResource,
   TemplatesResource: () => TemplatesResource,
+  ToolSecretsResource: () => ToolSecretsResource,
   WebhooksResource: () => WebhooksResource,
   default: () => index_default
 });
@@ -61,6 +65,7 @@ var RymiError = class extends Error {
 var RymiClient = class {
   apiKey;
   baseURL;
+  fetchImpl;
   constructor(options) {
     const key = options?.apiKey || (typeof process !== "undefined" ? process.env.RYMI_API_KEY : void 0);
     if (!key) {
@@ -68,6 +73,7 @@ var RymiClient = class {
     }
     this.apiKey = key;
     this.baseURL = options?.baseURL || "https://api.rymi.live/v1";
+    this.fetchImpl = options?.fetch ?? globalThis.fetch;
     if (this.baseURL.endsWith("/")) {
       this.baseURL = this.baseURL.slice(0, -1);
     }
@@ -88,7 +94,7 @@ var RymiClient = class {
       init.body = JSON.stringify(body);
     }
     try {
-      const response = await fetch(url, init);
+      const response = await this.fetchImpl(url, init);
       const isJson = response.headers.get("content-type")?.includes("application/json");
       const data = isJson ? await response.json() : await response.text();
       if (!response.ok) {
@@ -196,6 +202,15 @@ var AgentsResource = class {
   async validatePublish(params) {
     return this.client.post("/agents/validate-publish", params);
   }
+  /**
+   * Publish an agent: validate its persisted config and freeze it into the
+   * published snapshot the harness/review pipeline reads as the baseline.
+   * Returns `{ published: false, blockers }` (HTTP 200) when blockers remain —
+   * inspect `blockers` rather than relying on a thrown error.
+   */
+  async publish(agentId) {
+    return this.client.post(`/agents/${agentId}/publish`, {});
+  }
   /**
    * Validate and apply a flat-diff change-set against the AgentConfig field registry.
    * Does NOT persist — callers must follow up with update().
@@ -211,9 +226,8 @@ var AgentsResource = class {
   }
   /**
    * Preview the resolved per-language model stack (STT/LLM/TTS), blockers,
-   * warnings, model diffs, and any required role upgrades for a set of
-   * supported languages — without persisting anything. Note: the concierge
-   * (realtime) role is not supported by this endpoint.
+   * warnings, and model diffs for a set of supported languages — without
+   * persisting anything.
    */
   async previewStack(params) {
     return this.client.post("/agents/stack-preview", params);
@@ -236,6 +250,26 @@ var AgentsResource = class {
   async deleteKnowledgeSource(agentId, sourceId) {
     return this.client.delete(`/agents/${agentId}/knowledge-sources/${sourceId}`);
   }
+  /**
+   * Get the agent's public share link, or `link: null` if none exists.
+   * `link_feature: false` means share links are disabled on this deployment.
+   */
+  async getShareLink(agentId) {
+    const res = await this.client.get(`/agents/${agentId}/testers`);
+    return { link_feature: res.link_feature, link: res.link };
+  }
+  /**
+   * Create the agent's public share link, or update its settings if one exists.
+   */
+  async setShareLink(agentId, settings = {}) {
+    return this.client.put(`/agents/${agentId}/share-link`, settings);
+  }
+  /**
+   * Issue a new URL for the share link. The old URL stops working immediately.
+   */
+  async regenerateShareLink(agentId) {
+    return this.client.post(`/agents/${agentId}/share-link/regenerate`, {});
+  }
   /**
    * List the recorded configuration changes for an agent (most recent first).
    * Optionally pass an ISO timestamp to only return changes since then.
@@ -256,8 +290,20 @@ var AgentsResource = class {
    * the offline scorer; mode="live" runs the model-driven runner.
    */
   async runEvals(agentId, params = {}) {
-    const query = params.mode ? `?mode=${params.mode}` : "";
-    return this.client.post(`/agents/${agentId}/evals/run${query}`, {});
+    const query = new URLSearchParams();
+    if (params.mode) query.set("mode", params.mode);
+    if (params.judge) query.set("judge", "1");
+    const qs = query.toString();
+    return this.client.post(`/agents/${agentId}/evals/run${qs ? `?${qs}` : ""}`, {});
+  }
+  /**
+   * Run the eval SUITE across many agents at once (agents × seeded scenarios),
+   * bounded by the optional concurrency cap. One eval run is persisted per
+   * agent; the aggregate EvalSuiteReport is returned. Pass `judge: true` to
+   * supplement the heuristics with the opt-in LLM judge (needs a Gemini key).
+   */
+  async runEvalSuite(params) {
+    return this.client.post("/agents/evals/suite", params);
   }
   /**
    * List previous evaluation runs for an agent.
@@ -313,7 +359,16 @@ var CallsResource = class {
     return this.client.post("/calls", data);
   }
   /**
-   * Queue up to 500 outbound PSTN recipients in one request.
+   * Group call fanout: dial up to 500 PSTN participants into a single call room.
+   * Every recipient joins the same call. For independent per-recipient attempts,
+   * retries, and reports, use `campaigns` instead.
+   */
+  async fanout(data) {
+    return this.client.post("/calls/fanout", data);
+  }
+  /**
+   * Compatibility alias for {@link fanout}. Creates one call room with multiple
+   * PSTN participants. Queue up to 500 outbound PSTN recipients in one request.
    */
   async batch(data) {
     return this.client.post("/calls/batch", data);
@@ -399,6 +454,14 @@ var NumbersResource = class {
   async attach(number, agentId) {
     return this.client.post(`/numbers/${encodeURIComponent(number)}/attach`, { agent_id: agentId });
   }
+  /** Clear the agent association without deregistering the number. */
+  async detach(number) {
+    return this.client.post(`/numbers/${encodeURIComponent(number)}/detach`);
+  }
+  /** Re-run carrier inbound-webhook auto-provisioning for a number. */
+  async provisionWebhook(number) {
+    return this.client.post(`/numbers/${encodeURIComponent(number)}/webhook`);
+  }
   async remove(number) {
     return this.client.delete(`/numbers/${encodeURIComponent(number)}`);
   }
@@ -522,7 +585,7 @@ var BillingResource = class {
   async usageSummary() {
     return this.client.get("/billing/usage-summary");
   }
-  /** Estimate the cost of a call for a given tier and duration. */
+  /** Estimate the cost of a call for a custom model stack and duration. */
   async estimate(data = {}) {
     return this.client.post("/billing/estimate", data);
   }
@@ -550,6 +613,228 @@ var TemplatesResource = class {
   }
 };
 
+// src/resources/campaigns.ts
+function buildQuery4(params) {
+  const sp = new URLSearchParams();
+  for (const [k, v] of Object.entries(params)) {
+    if (v !== void 0 && v !== null) sp.set(k, String(v));
+  }
+  const q = sp.toString();
+  return q ? `?${q}` : "";
+}
+var CampaignMembersResource = class {
+  constructor(client) {
+    this.client = client;
+  }
+  /** List a campaign's members, paginated. */
+  async list(campaignId, params = {}) {
+    return this.client.get(`/campaigns/${campaignId}/members${buildQuery4(params)}`);
+  }
+  /** Attach existing contacts to a campaign as members. */
+  async add(campaignId, data) {
+    return this.client.post(`/campaigns/${campaignId}/members`, data);
+  }
+  /** Import inline contact rows (JSON or CSV): creates/merges contacts and attaches members in one call. */
+  async import(campaignId, data) {
+    return this.client.post(`/campaigns/${campaignId}/members/import`, data);
+  }
+  /** Update a campaign member (status, variables, next attempt time). */
+  async update(campaignId, memberId, data) {
+    return this.client.patch(`/campaigns/${campaignId}/members/${memberId}`, data);
+  }
+  /** Remove a member from a campaign. */
+  async remove(campaignId, memberId) {
+    return this.client.delete(`/campaigns/${campaignId}/members/${memberId}`);
+  }
+};
+var CampaignRoutesResource = class {
+  constructor(client) {
+    this.client = client;
+  }
+  /** List a campaign's inbound routing rules. */
+  async list(campaignId, params = {}) {
+    return this.client.get(`/campaigns/${campaignId}/routes${buildQuery4(params)}`);
+  }
+  /** Bind an owned phone number to this campaign for inbound routing. Only one active route per number is allowed. */
+  async create(campaignId, data) {
+    return this.client.post(`/campaigns/${campaignId}/routes`, data);
+  }
+  /** Update an inbound route's schedule or active flag. */
+  async update(campaignId, routeId, data) {
+    return this.client.patch(`/campaigns/${campaignId}/routes/${routeId}`, data);
+  }
+  /** Delete an inbound route. */
+  async delete(campaignId, routeId) {
+    return this.client.delete(`/campaigns/${campaignId}/routes/${routeId}`);
+  }
+};
+var CampaignsResource = class {
+  constructor(client) {
+    this.client = client;
+    this.members = new CampaignMembersResource(client);
+    this.routes = new CampaignRoutesResource(client);
+  }
+  members;
+  routes;
+  /** List campaigns for the authenticated tenant, paginated. */
+  async list(params = {}) {
+    return this.client.get(`/campaigns${buildQuery4(params)}`);
+  }
+  /** Create a new campaign in draft status against a published agent. */
+  async create(data) {
+    return this.client.post("/campaigns", data);
+  }
+  /** Retrieve a single campaign by id. */
+  async get(campaignId) {
+    return this.client.get(`/campaigns/${campaignId}`);
+  }
+  /** Update campaign policy/goal fields. Status and lifecycle fields are not writable here. */
+  async update(campaignId, data) {
+    return this.client.patch(`/campaigns/${campaignId}`, data);
+  }
+  /**
+   * Launch a campaign: validates launch blockers, then stamps
+   * `launched_at` + `agent_snapshot_id`, flips members to `ready`, and
+   * transitions status to `running`.
+   */
+  async launch(campaignId) {
+    return this.client.post(`/campaigns/${campaignId}/launch`);
+  }
+  /** Evaluate launch blockers without launching (dry run). Safe from any status. */
+  async launchBlockers(campaignId) {
+    return this.client.get(`/campaigns/${campaignId}/launch-blockers`);
+  }
+  /** Pause a running campaign. In-flight calls finish naturally. */
+  async pause(campaignId) {
+    return this.client.post(`/campaigns/${campaignId}/pause`);
+  }
+  /** Resume a paused campaign. */
+  async resume(campaignId) {
+    return this.client.post(`/campaigns/${campaignId}/resume`);
+  }
+  /** Archive a campaign. Terminal — the scheduler never selects work for it again. */
+  async archive(campaignId) {
+    return this.client.post(`/campaigns/${campaignId}/archive`);
+  }
+  /** Read the campaign report: `stat_*` summary counters + outcome/sentiment/hourly/snapshot distributions. */
+  async report(campaignId) {
+    return this.client.get(`/campaigns/${campaignId}/report`);
+  }
+  /** List a campaign's dial attempts, paginated. */
+  async attempts(campaignId, params = {}) {
+    return this.client.get(`/campaigns/${campaignId}/attempts${buildQuery4(params)}`);
+  }
+  /** List a campaign's sweep-claim batches, paginated. */
+  async batches(campaignId, params = {}) {
+    return this.client.get(`/campaigns/${campaignId}/batches${buildQuery4(params)}`);
+  }
+  /** List a campaign's follow-up jobs, paginated. */
+  async followups(campaignId, params = {}) {
+    return this.client.get(`/campaigns/${campaignId}/followups${buildQuery4(params)}`);
+  }
+  /** Run the improve engine: detectors gate an LLM proposal writer, persisting new `campaign_suggestions`. */
+  async improve(campaignId) {
+    return this.client.post(`/campaigns/${campaignId}/improve`);
+  }
+  /** List a campaign's improvement suggestions, paginated. */
+  async suggestions(campaignId, params = {}) {
+    return this.client.get(`/campaigns/${campaignId}/suggestions${buildQuery4(params)}`);
+  }
+  /** Accept a suggestion: agent-editing suggestions create an agent-changes draft; campaign-policy suggestions patch the campaign. */
+  async acceptSuggestion(campaignId, suggestionId) {
+    return this.client.post(`/campaigns/${campaignId}/suggestions/${suggestionId}/accept`);
+  }
+  /** Dismiss a suggestion without applying it. */
+  async dismissSuggestion(campaignId, suggestionId) {
+    return this.client.post(`/campaigns/${campaignId}/suggestions/${suggestionId}/dismiss`);
+  }
+};
+
+// src/resources/contacts.ts
+function buildQuery5(params) {
+  const sp = new URLSearchParams();
+  for (const [k, v] of Object.entries(params)) {
+    if (v !== void 0 && v !== null) sp.set(k, String(v));
+  }
+  const q = sp.toString();
+  return q ? `?${q}` : "";
+}
+var ContactsResource = class {
+  constructor(client) {
+    this.client = client;
+  }
+  /** List tenant-level contacts, paginated. */
+  async list(params = {}) {
+    return this.client.get(`/contacts${buildQuery5(params)}`);
+  }
+  /**
+   * Create a tenant-level contact. If a contact with the same
+   * (tenant, phone) already exists, the existing row is returned instead
+   * of creating a duplicate — check `deduped` in the response.
+   */
+  async create(data) {
+    return this.client.post("/contacts", data);
+  }
+  /** Retrieve a single tenant-scoped contact by id. */
+  async get(contactId) {
+    return this.client.get(`/contacts/${contactId}`);
+  }
+  /** Update an existing tenant-scoped contact. Only provided fields change. */
+  async update(contactId, data) {
+    return this.client.patch(`/contacts/${contactId}`, data);
+  }
+  /** Delete a tenant-scoped contact. */
+  async delete(contactId) {
+    return this.client.delete(`/contacts/${contactId}`);
+  }
+  /**
+   * Bulk import contacts from JSON rows or CSV text. Each row's phone is
+   * normalized to E.164 and upserted on (tenant_id, phone); rows with
+   * unparseable phones are skipped and reported in `invalid`.
+   */
+  async import(data) {
+    return this.client.post("/contacts/import", data);
+  }
+  /** Record a consent grant or revoke for one channel, with evidence. Also
+   *  appends an immutable row to the consent_events proof log. */
+  async setConsent(contactId, data) {
+    return this.client.patch(`/contacts/${contactId}/consent`, data);
+  }
+};
+
+// src/resources/compliance.ts
+var ComplianceResource = class {
+  constructor(client) {
+    this.client = client;
+  }
+  /** Record a compliance attestation (append-only). Campaign launch blockers
+   *  in `attested` mode read the most recent one of the matching `kind`. */
+  async attest(data) {
+    return this.client.post("/compliance/attestations", data);
+  }
+  /** List the tenant's 50 most recent compliance attestations, newest first. */
+  async listAttestations() {
+    return this.client.get("/compliance/attestations");
+  }
+};
+
+// src/resources/toolSecrets.ts
+var ToolSecretsResource = class {
+  constructor(client) {
+    this.client = client;
+  }
+  async list() {
+    return this.client.get("/tool-secrets");
+  }
+  /** Create or replace. `name` is UPPER_SNAKE_CASE; `host` is a public hostname. */
+  async set(name, data) {
+    return this.client.put(`/tool-secrets/${encodeURIComponent(name)}`, data);
+  }
+  async delete(name) {
+    return this.client.delete(`/tool-secrets/${encodeURIComponent(name)}`);
+  }
+};
+
 // src/index.ts
 __reExport(index_exports, require("@rymi/sdk-types"), module.exports);
 var Rymi = class {
@@ -563,6 +848,10 @@ var Rymi = class {
   telephony;
   billing;
   templates;
+  campaigns;
+  contacts;
+  compliance;
+  toolSecrets;
   constructor(options) {
     this.client = new RymiClient(options);
     this.agents = new AgentsResource(this.client);
@@ -574,6 +863,10 @@ var Rymi = class {
     this.telephony = new TelephonyResource(this.client);
     this.billing = new BillingResource(this.client);
     this.templates = new TemplatesResource(this.client);
+    this.campaigns = new CampaignsResource(this.client);
+    this.contacts = new ContactsResource(this.client);
+    this.compliance = new ComplianceResource(this.client);
+    this.toolSecrets = new ToolSecretsResource(this.client);
   }
 };
 var index_default = Rymi;
@@ -582,6 +875,9 @@ var index_default = Rymi;
   AgentsResource,
   BillingResource,
   CallsResource,
+  CampaignsResource,
+  ComplianceResource,
+  ContactsResource,
   DncResource,
   KeysResource,
   NumbersResource,
@@ -590,6 +886,7 @@ var index_default = Rymi;
   RymiError,
   TelephonyResource,
   TemplatesResource,
+  ToolSecretsResource,
   WebhooksResource,
   ...require("@rymi/sdk-types")
 });