@happyrobot-ai/sdk 0.1.0

package/index.js

@@ -0,0 +1,90 @@
+"use strict";
+/**
+ * @happyrobot/sdk — TypeScript SDK for the HappyRobot Public API.
+ *
+ * @example
+ * ```ts
+ * import { HappyRobotClient } from "@happyrobot/sdk";
+ *
+ * const client = new HappyRobotClient({ apiKey: "sk_live_..." });
+ *
+ * // List all workflows
+ * const { data } = await client.workflows.list();
+ *
+ * // Iterate all workflows across pages
+ * for await (const wf of client.workflows.listAll()) {
+ *   console.log(wf.name);
+ * }
+ *
+ * // Trigger a run
+ * const { run_id } = await client.workflows.triggerRun("my-workflow", {
+ *   payload: { phone: "+1234567890" },
+ * });
+ * ```
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AuditRemarksResource = exports.IssuesResource = exports.CustomEvalsResource = exports.NorthstarsResource = exports.AdversarialTestsResource = exports.AdversarialSuitesResource = exports.ApiKeyResource = exports.BillingResource = exports.UsageResource = exports.MCPResource = exports.WorkflowFoldersResource = exports.KnowledgeBasesResource = exports.ContactsResource = exports.IntegrationsResource = exports.SipTrunksResource = exports.PhoneNumbersResource = exports.VariablesResource = exports.MessagesResource = exports.SessionsResource = exports.RunsResource = exports.NodesResource = exports.VersionsResource = exports.WorkflowsResource = exports.iterateSSE = exports.paginate = exports.NetworkError = exports.TimeoutError = exports.RateLimitError = exports.ValidationError = exports.NotFoundError = exports.AuthenticationError = exports.ApiError = exports.HappyRobotError = exports.HappyRobotClient = void 0;
+// ── Client ──
+var client_1 = require("./client");
+Object.defineProperty(exports, "HappyRobotClient", { enumerable: true, get: function () { return client_1.HappyRobotClient; } });
+var errors_1 = require("./core/errors");
+Object.defineProperty(exports, "HappyRobotError", { enumerable: true, get: function () { return errors_1.HappyRobotError; } });
+Object.defineProperty(exports, "ApiError", { enumerable: true, get: function () { return errors_1.ApiError; } });
+Object.defineProperty(exports, "AuthenticationError", { enumerable: true, get: function () { return errors_1.AuthenticationError; } });
+Object.defineProperty(exports, "NotFoundError", { enumerable: true, get: function () { return errors_1.NotFoundError; } });
+Object.defineProperty(exports, "ValidationError", { enumerable: true, get: function () { return errors_1.ValidationError; } });
+Object.defineProperty(exports, "RateLimitError", { enumerable: true, get: function () { return errors_1.RateLimitError; } });
+Object.defineProperty(exports, "TimeoutError", { enumerable: true, get: function () { return errors_1.TimeoutError; } });
+Object.defineProperty(exports, "NetworkError", { enumerable: true, get: function () { return errors_1.NetworkError; } });
+var pagination_1 = require("./core/pagination");
+Object.defineProperty(exports, "paginate", { enumerable: true, get: function () { return pagination_1.paginate; } });
+var sse_1 = require("./core/sse");
+Object.defineProperty(exports, "iterateSSE", { enumerable: true, get: function () { return sse_1.iterateSSE; } });
+// ── Resource classes (for advanced use / extension) ──
+var workflows_1 = require("./resources/workflows");
+Object.defineProperty(exports, "WorkflowsResource", { enumerable: true, get: function () { return workflows_1.WorkflowsResource; } });
+var versions_1 = require("./resources/versions");
+Object.defineProperty(exports, "VersionsResource", { enumerable: true, get: function () { return versions_1.VersionsResource; } });
+var nodes_1 = require("./resources/nodes");
+Object.defineProperty(exports, "NodesResource", { enumerable: true, get: function () { return nodes_1.NodesResource; } });
+var runs_1 = require("./resources/runs");
+Object.defineProperty(exports, "RunsResource", { enumerable: true, get: function () { return runs_1.RunsResource; } });
+var sessions_1 = require("./resources/sessions");
+Object.defineProperty(exports, "SessionsResource", { enumerable: true, get: function () { return sessions_1.SessionsResource; } });
+var messages_1 = require("./resources/messages");
+Object.defineProperty(exports, "MessagesResource", { enumerable: true, get: function () { return messages_1.MessagesResource; } });
+var variables_1 = require("./resources/variables");
+Object.defineProperty(exports, "VariablesResource", { enumerable: true, get: function () { return variables_1.VariablesResource; } });
+var phone_numbers_1 = require("./resources/phone-numbers");
+Object.defineProperty(exports, "PhoneNumbersResource", { enumerable: true, get: function () { return phone_numbers_1.PhoneNumbersResource; } });
+var sip_trunks_1 = require("./resources/sip-trunks");
+Object.defineProperty(exports, "SipTrunksResource", { enumerable: true, get: function () { return sip_trunks_1.SipTrunksResource; } });
+var integrations_1 = require("./resources/integrations");
+Object.defineProperty(exports, "IntegrationsResource", { enumerable: true, get: function () { return integrations_1.IntegrationsResource; } });
+var contacts_1 = require("./resources/contacts");
+Object.defineProperty(exports, "ContactsResource", { enumerable: true, get: function () { return contacts_1.ContactsResource; } });
+var knowledge_bases_1 = require("./resources/knowledge-bases");
+Object.defineProperty(exports, "KnowledgeBasesResource", { enumerable: true, get: function () { return knowledge_bases_1.KnowledgeBasesResource; } });
+var workflow_folders_1 = require("./resources/workflow-folders");
+Object.defineProperty(exports, "WorkflowFoldersResource", { enumerable: true, get: function () { return workflow_folders_1.WorkflowFoldersResource; } });
+var mcp_1 = require("./resources/mcp");
+Object.defineProperty(exports, "MCPResource", { enumerable: true, get: function () { return mcp_1.MCPResource; } });
+var usage_1 = require("./resources/usage");
+Object.defineProperty(exports, "UsageResource", { enumerable: true, get: function () { return usage_1.UsageResource; } });
+var billing_1 = require("./resources/billing");
+Object.defineProperty(exports, "BillingResource", { enumerable: true, get: function () { return billing_1.BillingResource; } });
+var api_key_1 = require("./resources/api-key");
+Object.defineProperty(exports, "ApiKeyResource", { enumerable: true, get: function () { return api_key_1.ApiKeyResource; } });
+var adversarial_suites_1 = require("./resources/adversarial-suites");
+Object.defineProperty(exports, "AdversarialSuitesResource", { enumerable: true, get: function () { return adversarial_suites_1.AdversarialSuitesResource; } });
+var adversarial_tests_1 = require("./resources/adversarial-tests");
+Object.defineProperty(exports, "AdversarialTestsResource", { enumerable: true, get: function () { return adversarial_tests_1.AdversarialTestsResource; } });
+var northstars_1 = require("./resources/northstars");
+Object.defineProperty(exports, "NorthstarsResource", { enumerable: true, get: function () { return northstars_1.NorthstarsResource; } });
+var custom_evals_1 = require("./resources/custom-evals");
+Object.defineProperty(exports, "CustomEvalsResource", { enumerable: true, get: function () { return custom_evals_1.CustomEvalsResource; } });
+var issues_1 = require("./resources/issues");
+Object.defineProperty(exports, "IssuesResource", { enumerable: true, get: function () { return issues_1.IssuesResource; } });
+var audit_remarks_1 = require("./resources/audit-remarks");
+Object.defineProperty(exports, "AuditRemarksResource", { enumerable: true, get: function () { return audit_remarks_1.AuditRemarksResource; } });
+//# sourceMappingURL=index.js.map

package/index.mjs

@@ -0,0 +1,3 @@
+// ESM wrapper — re-exports CJS module
+export { default } from "./index.js";
+export * from "./index.js";

package/package.json

@@ -0,0 +1,42 @@
+{
+  "name": "@happyrobot-ai/sdk",
+  "version": "0.1.0",
+  "description": "TypeScript SDK for the HappyRobot Public API",
+  "main": "./index.js",
+  "module": "./index.mjs",
+  "types": "./index.d.ts",
+  "exports": {
+    ".": {
+      "require": "./index.js",
+      "import": "./index.mjs",
+      "types": "./index.d.ts"
+    },
+    "./helpers": {
+      "require": "./helpers/index.js",
+      "import": "./helpers/index.mjs",
+      "types": "./helpers/index.d.ts"
+    }
+  },
+  "files": [
+    "**/*.js",
+    "**/*.mjs",
+    "**/*.d.ts",
+    "**/*.d.ts.map"
+  ],
+  "engines": {
+    "node": ">=18"
+  },
+  "keywords": [
+    "happyrobot",
+    "sdk",
+    "api",
+    "voice-ai",
+    "workflows"
+  ],
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/happyrobot-ai/app-v2"
+  },
+  "dependencies": {}
+}

package/resources/adversarial-suites.d.ts

@@ -0,0 +1,42 @@
+/**
+ * Adversarial suite resource — client.adversarialSuites.*
+ *
+ * Maps to:
+ *   GET    /adversarial-suites/:suite_id
+ *   PATCH  /adversarial-suites/:suite_id
+ *   DELETE /adversarial-suites/:suite_id
+ *   POST   /adversarial-suites/:suite_id/generate
+ *   POST   /adversarial-suites/:suite_id/generate-graph
+ *   POST   /adversarial-suites/:suite_id/run
+ *   GET    /adversarial-suites/:suite_id/runs
+ *   GET    /adversarial-suites/runs/:suite_run_id
+ *   GET    /adversarial-suites/runs/:suite_run_id/test-runs
+ */
+import type { HttpClient } from "../core/http";
+import type { GetAdversarialSuiteResponse, PatchAdversarialSuiteBody, PatchAdversarialSuiteResponse, RunAdversarialSuiteBody, RunAdversarialSuiteResponse, ListAdversarialSuiteRunsResponse, ListAdversarialSuiteRunTestRunsResponse, GenerateAdversarialSuiteTestsBody, GenerateAdversarialSuiteTestsResponse, GenerateAdversarialSuiteGraphBody, GenerateAdversarialSuiteGraphResponse } from "../types/adversarial-suites.types";
+export declare class AdversarialSuitesResource {
+    private readonly http;
+    constructor(http: HttpClient);
+    /** Get an adversarial suite by ID. */
+    get(suiteId: string): Promise<GetAdversarialSuiteResponse>;
+    /** Update an adversarial suite. */
+    update(suiteId: string, body: PatchAdversarialSuiteBody): Promise<PatchAdversarialSuiteResponse>;
+    /** Delete an adversarial suite. */
+    delete(suiteId: string): Promise<void>;
+    /** Auto-generate individual adversarial tests from the suite's generation_prompt. */
+    generate(suiteId: string, body?: GenerateAdversarialSuiteTestsBody): Promise<GenerateAdversarialSuiteTestsResponse>;
+    /** Generate a mermaid workflow graph for the suite. */
+    generateGraph(suiteId: string, body: GenerateAdversarialSuiteGraphBody): Promise<GenerateAdversarialSuiteGraphResponse>;
+    /** Run all tests in an adversarial suite asynchronously. */
+    run(suiteId: string, body: RunAdversarialSuiteBody): Promise<RunAdversarialSuiteResponse>;
+    /** List runs for an adversarial suite. */
+    listRuns(suiteId: string, query?: {
+        limit?: number;
+    }): Promise<ListAdversarialSuiteRunsResponse>;
+    /** Get an adversarial suite run by ID. */
+    getRun(suiteRunId: string): Promise<{
+        run: ListAdversarialSuiteRunsResponse["runs"][number];
+    }>;
+    /** List all individual test runs within a suite run. */
+    getRunTestRuns(suiteRunId: string): Promise<ListAdversarialSuiteRunTestRunsResponse>;
+}

package/resources/adversarial-suites.js

@@ -0,0 +1,96 @@
+"use strict";
+/**
+ * Adversarial suite resource — client.adversarialSuites.*
+ *
+ * Maps to:
+ *   GET    /adversarial-suites/:suite_id
+ *   PATCH  /adversarial-suites/:suite_id
+ *   DELETE /adversarial-suites/:suite_id
+ *   POST   /adversarial-suites/:suite_id/generate
+ *   POST   /adversarial-suites/:suite_id/generate-graph
+ *   POST   /adversarial-suites/:suite_id/run
+ *   GET    /adversarial-suites/:suite_id/runs
+ *   GET    /adversarial-suites/runs/:suite_run_id
+ *   GET    /adversarial-suites/runs/:suite_run_id/test-runs
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AdversarialSuitesResource = void 0;
+class AdversarialSuitesResource {
+    http;
+    constructor(http) {
+        this.http = http;
+    }
+    /** Get an adversarial suite by ID. */
+    async get(suiteId) {
+        return this.http.request({
+            method: "GET",
+            path: `/adversarial-suites/${enc(suiteId)}`,
+        });
+    }
+    /** Update an adversarial suite. */
+    async update(suiteId, body) {
+        return this.http.request({
+            method: "PATCH",
+            path: `/adversarial-suites/${enc(suiteId)}`,
+            body,
+        });
+    }
+    /** Delete an adversarial suite. */
+    async delete(suiteId) {
+        return this.http.request({
+            method: "DELETE",
+            path: `/adversarial-suites/${enc(suiteId)}`,
+        });
+    }
+    /** Auto-generate individual adversarial tests from the suite's generation_prompt. */
+    async generate(suiteId, body) {
+        return this.http.request({
+            method: "POST",
+            path: `/adversarial-suites/${enc(suiteId)}/generate`,
+            body: body ?? {},
+        });
+    }
+    /** Generate a mermaid workflow graph for the suite. */
+    async generateGraph(suiteId, body) {
+        return this.http.request({
+            method: "POST",
+            path: `/adversarial-suites/${enc(suiteId)}/generate-graph`,
+            body,
+        });
+    }
+    /** Run all tests in an adversarial suite asynchronously. */
+    async run(suiteId, body) {
+        return this.http.request({
+            method: "POST",
+            path: `/adversarial-suites/${enc(suiteId)}/run`,
+            body,
+        });
+    }
+    /** List runs for an adversarial suite. */
+    async listRuns(suiteId, query) {
+        return this.http.request({
+            method: "GET",
+            path: `/adversarial-suites/${enc(suiteId)}/runs`,
+            query: query,
+        });
+    }
+    /** Get an adversarial suite run by ID. */
+    async getRun(suiteRunId) {
+        return this.http.request({
+            method: "GET",
+            path: `/adversarial-suites/runs/${enc(suiteRunId)}`,
+        });
+    }
+    /** List all individual test runs within a suite run. */
+    async getRunTestRuns(suiteRunId) {
+        return this.http.request({
+            method: "GET",
+            path: `/adversarial-suites/runs/${enc(suiteRunId)}/test-runs`,
+        });
+    }
+}
+exports.AdversarialSuitesResource = AdversarialSuitesResource;
+function enc(s) {
+    return encodeURIComponent(s);
+}
+//# sourceMappingURL=adversarial-suites.js.map

package/resources/adversarial-suites.mjs

@@ -0,0 +1,3 @@
+// ESM wrapper — re-exports CJS module
+export { default } from "./adversarial-suites.js";
+export * from "./adversarial-suites.js";

package/resources/adversarial-tests.d.ts

@@ -0,0 +1,36 @@
+/**
+ * Adversarial test resource — client.adversarialTests.*
+ *
+ * Maps to:
+ *   GET    /adversarial-tests/:test_id
+ *   PATCH  /adversarial-tests/:test_id
+ *   DELETE /adversarial-tests/:test_id
+ *   POST   /adversarial-tests/:test_id/run
+ *   GET    /adversarial-tests/:test_id/runs
+ *   GET    /adversarial-tests/runs/:run_id
+ *   GET    /adversarial-tests/runs/:run_id/messages
+ */
+import type { HttpClient } from "../core/http";
+import type { GetAdversarialTestResponse, PatchAdversarialTestBody, PatchAdversarialTestResponse, RunAdversarialTestBody, RunAdversarialTestResponse, ListAdversarialTestRunsResponse, ListAdversarialTestRunMessagesResponse } from "../types/adversarial-tests.types";
+export declare class AdversarialTestsResource {
+    private readonly http;
+    constructor(http: HttpClient);
+    /** Get an adversarial test by ID. */
+    get(testId: string): Promise<GetAdversarialTestResponse>;
+    /** Update an adversarial test. */
+    update(testId: string, body: PatchAdversarialTestBody): Promise<PatchAdversarialTestResponse>;
+    /** Delete an adversarial test. */
+    delete(testId: string): Promise<void>;
+    /** Run an adversarial test asynchronously. */
+    run(testId: string, body: RunAdversarialTestBody): Promise<RunAdversarialTestResponse>;
+    /** List runs for an adversarial test. */
+    listRuns(testId: string, query?: {
+        limit?: number;
+    }): Promise<ListAdversarialTestRunsResponse>;
+    /** Get an adversarial test run by ID. */
+    getRun(runId: string): Promise<{
+        run: ListAdversarialTestRunsResponse["runs"][number];
+    }>;
+    /** Get the conversation messages from a test run. */
+    getRunMessages(runId: string): Promise<ListAdversarialTestRunMessagesResponse>;
+}

package/resources/adversarial-tests.js

@@ -0,0 +1,78 @@
+"use strict";
+/**
+ * Adversarial test resource — client.adversarialTests.*
+ *
+ * Maps to:
+ *   GET    /adversarial-tests/:test_id
+ *   PATCH  /adversarial-tests/:test_id
+ *   DELETE /adversarial-tests/:test_id
+ *   POST   /adversarial-tests/:test_id/run
+ *   GET    /adversarial-tests/:test_id/runs
+ *   GET    /adversarial-tests/runs/:run_id
+ *   GET    /adversarial-tests/runs/:run_id/messages
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AdversarialTestsResource = void 0;
+class AdversarialTestsResource {
+    http;
+    constructor(http) {
+        this.http = http;
+    }
+    /** Get an adversarial test by ID. */
+    async get(testId) {
+        return this.http.request({
+            method: "GET",
+            path: `/adversarial-tests/${enc(testId)}`,
+        });
+    }
+    /** Update an adversarial test. */
+    async update(testId, body) {
+        return this.http.request({
+            method: "PATCH",
+            path: `/adversarial-tests/${enc(testId)}`,
+            body,
+        });
+    }
+    /** Delete an adversarial test. */
+    async delete(testId) {
+        return this.http.request({
+            method: "DELETE",
+            path: `/adversarial-tests/${enc(testId)}`,
+        });
+    }
+    /** Run an adversarial test asynchronously. */
+    async run(testId, body) {
+        return this.http.request({
+            method: "POST",
+            path: `/adversarial-tests/${enc(testId)}/run`,
+            body,
+        });
+    }
+    /** List runs for an adversarial test. */
+    async listRuns(testId, query) {
+        return this.http.request({
+            method: "GET",
+            path: `/adversarial-tests/${enc(testId)}/runs`,
+            query: query,
+        });
+    }
+    /** Get an adversarial test run by ID. */
+    async getRun(runId) {
+        return this.http.request({
+            method: "GET",
+            path: `/adversarial-tests/runs/${enc(runId)}`,
+        });
+    }
+    /** Get the conversation messages from a test run. */
+    async getRunMessages(runId) {
+        return this.http.request({
+            method: "GET",
+            path: `/adversarial-tests/runs/${enc(runId)}/messages`,
+        });
+    }
+}
+exports.AdversarialTestsResource = AdversarialTestsResource;
+function enc(s) {
+    return encodeURIComponent(s);
+}
+//# sourceMappingURL=adversarial-tests.js.map

package/resources/adversarial-tests.mjs

@@ -0,0 +1,3 @@
+// ESM wrapper — re-exports CJS module
+export { default } from "./adversarial-tests.js";
+export * from "./adversarial-tests.js";

package/resources/api-key.d.ts

@@ -0,0 +1,23 @@
+/**
+ * API key resource — client.apiKey.*
+ *
+ * Maps to:
+ *   GET /api-key/describe
+ */
+import type { HttpClient } from "../core/http";
+export interface ApiKeyInfo {
+    id: string;
+    orgId: string;
+    name: string;
+    prefix: string;
+    lastFour: string;
+    createdAt: string;
+    lastUsedAt: string | null;
+    revokedAt: string | null;
+}
+export declare class ApiKeyResource {
+    private readonly http;
+    constructor(http: HttpClient);
+    /** Describe the current API key (introspection). */
+    describe(): Promise<ApiKeyInfo>;
+}

package/resources/api-key.js

@@ -0,0 +1,24 @@
+"use strict";
+/**
+ * API key resource — client.apiKey.*
+ *
+ * Maps to:
+ *   GET /api-key/describe
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ApiKeyResource = void 0;
+class ApiKeyResource {
+    http;
+    constructor(http) {
+        this.http = http;
+    }
+    /** Describe the current API key (introspection). */
+    async describe() {
+        return this.http.request({
+            method: "GET",
+            path: "/api-key/describe",
+        });
+    }
+}
+exports.ApiKeyResource = ApiKeyResource;
+//# sourceMappingURL=api-key.js.map

package/resources/api-key.mjs

@@ -0,0 +1,3 @@
+// ESM wrapper — re-exports CJS module
+export { default } from "./api-key.js";
+export * from "./api-key.js";

package/resources/audit-remarks.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Audit remark resource — client.auditRemarks.*
+ *
+ * Maps to:
+ *   GET    /audit-remarks/:audit_remark_id/feedback
+ *   POST   /audit-remarks/:audit_remark_id/feedback
+ *   DELETE /audit-remarks/:audit_remark_id/feedback
+ */
+import type { HttpClient } from "../core/http";
+import type { AuditRemarkFeedback, SubmitAuditRemarkFeedbackBody } from "../types/audit-remarks.types";
+export declare class AuditRemarksResource {
+    private readonly http;
+    constructor(http: HttpClient);
+    /** Get the current user's feedback for an audit remark, or null if none exists. */
+    getFeedback(auditRemarkId: string): Promise<AuditRemarkFeedback | null>;
+    /** Submit a thumbs up/down for an audit remark. */
+    submitFeedback(auditRemarkId: string, body: SubmitAuditRemarkFeedbackBody): Promise<AuditRemarkFeedback>;
+    /** Delete the current user's feedback for an audit remark. */
+    deleteFeedback(auditRemarkId: string): Promise<{
+        success: true;
+    }>;
+}

package/resources/audit-remarks.js

@@ -0,0 +1,44 @@
+"use strict";
+/**
+ * Audit remark resource — client.auditRemarks.*
+ *
+ * Maps to:
+ *   GET    /audit-remarks/:audit_remark_id/feedback
+ *   POST   /audit-remarks/:audit_remark_id/feedback
+ *   DELETE /audit-remarks/:audit_remark_id/feedback
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AuditRemarksResource = void 0;
+class AuditRemarksResource {
+    http;
+    constructor(http) {
+        this.http = http;
+    }
+    /** Get the current user's feedback for an audit remark, or null if none exists. */
+    async getFeedback(auditRemarkId) {
+        return this.http.request({
+            method: "GET",
+            path: `/audit-remarks/${enc(auditRemarkId)}/feedback`,
+        });
+    }
+    /** Submit a thumbs up/down for an audit remark. */
+    async submitFeedback(auditRemarkId, body) {
+        return this.http.request({
+            method: "POST",
+            path: `/audit-remarks/${enc(auditRemarkId)}/feedback`,
+            body,
+        });
+    }
+    /** Delete the current user's feedback for an audit remark. */
+    async deleteFeedback(auditRemarkId) {
+        return this.http.request({
+            method: "DELETE",
+            path: `/audit-remarks/${enc(auditRemarkId)}/feedback`,
+        });
+    }
+}
+exports.AuditRemarksResource = AuditRemarksResource;
+function enc(s) {
+    return encodeURIComponent(s);
+}
+//# sourceMappingURL=audit-remarks.js.map

package/resources/audit-remarks.mjs

@@ -0,0 +1,3 @@
+// ESM wrapper — re-exports CJS module
+export { default } from "./audit-remarks.js";
+export * from "./audit-remarks.js";

package/resources/billing.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Billing resource — client.billing.*
+ *
+ * Maps to:
+ *   GET /billing/usage/details
+ *   GET /billing/usage/totals
+ */
+import type { HttpClient } from "../core/http";
+export interface BillingDetailsQuery {
+    start: string;
+    end: string;
+    use_case_id?: string;
+}
+export interface BillingTotalsQuery {
+    start: string;
+    end: string;
+}
+export declare class BillingResource {
+    private readonly http;
+    constructor(http: HttpClient);
+    /** Get detailed billing usage. */
+    getDetails(query: BillingDetailsQuery): Promise<unknown>;
+    /** Get billing usage totals. */
+    getTotals(query: BillingTotalsQuery): Promise<unknown>;
+}

package/resources/billing.js

@@ -0,0 +1,34 @@
+"use strict";
+/**
+ * Billing resource — client.billing.*
+ *
+ * Maps to:
+ *   GET /billing/usage/details
+ *   GET /billing/usage/totals
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BillingResource = void 0;
+class BillingResource {
+    http;
+    constructor(http) {
+        this.http = http;
+    }
+    /** Get detailed billing usage. */
+    async getDetails(query) {
+        return this.http.request({
+            method: "GET",
+            path: "/billing/usage/details",
+            query: query,
+        });
+    }
+    /** Get billing usage totals. */
+    async getTotals(query) {
+        return this.http.request({
+            method: "GET",
+            path: "/billing/usage/totals",
+            query: query,
+        });
+    }
+}
+exports.BillingResource = BillingResource;
+//# sourceMappingURL=billing.js.map

package/resources/billing.mjs

@@ -0,0 +1,3 @@
+// ESM wrapper — re-exports CJS module
+export { default } from "./billing.js";
+export * from "./billing.js";

package/resources/contacts.d.ts

@@ -0,0 +1,40 @@
+/**
+ * Contacts resource — client.contacts.*
+ *
+ * Maps to:
+ *   GET /contacts
+ *   GET /contacts/resolve
+ *   GET /contacts/:contact_id
+ *   GET /contacts/:contact_id/interactions
+ *   GET /contacts/:contact_id/memories
+ */
+import type { HttpClient } from "../core/http";
+import type { Contact } from "../types/contacts.types";
+export interface ListContactsQuery {
+    limit?: number;
+    cursor?: string;
+    search?: string;
+}
+export interface CursorPaginatedContacts {
+    data: Contact[];
+    next_cursor: string | null;
+    has_more: boolean;
+}
+export interface ResolveContactQuery {
+    phone_number?: string;
+    email?: string;
+}
+export declare class ContactsResource {
+    private readonly http;
+    constructor(http: HttpClient);
+    /** List contacts (cursor-paginated). */
+    list(query?: ListContactsQuery): Promise<CursorPaginatedContacts>;
+    /** Resolve a contact by phone number or email. */
+    resolve(query: ResolveContactQuery): Promise<Contact>;
+    /** Get a contact by ID. */
+    get(contactId: string): Promise<Contact>;
+    /** Get interactions for a contact. */
+    getInteractions(contactId: string): Promise<unknown>;
+    /** Get memories for a contact. */
+    getMemories(contactId: string): Promise<unknown>;
+}