@happyrobot-ai/sdk 0.1.0

package/resources/contacts.js

@@ -0,0 +1,61 @@
+"use strict";
+/**
+ * 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
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ContactsResource = void 0;
+class ContactsResource {
+    http;
+    constructor(http) {
+        this.http = http;
+    }
+    /** List contacts (cursor-paginated). */
+    async list(query) {
+        return this.http.request({
+            method: "GET",
+            path: "/contacts",
+            query: query,
+        });
+    }
+    /** Resolve a contact by phone number or email. */
+    async resolve(query) {
+        return this.http.request({
+            method: "GET",
+            path: "/contacts/resolve",
+            query: query,
+        });
+    }
+    /** Get a contact by ID. */
+    async get(contactId) {
+        return this.http.request({
+            method: "GET",
+            path: `/contacts/${enc(contactId)}`,
+        });
+    }
+    /** Get interactions for a contact. */
+    async getInteractions(contactId) {
+        return this.http.request({
+            method: "GET",
+            path: `/contacts/${enc(contactId)}/interactions`,
+        });
+    }
+    /** Get memories for a contact. */
+    async getMemories(contactId) {
+        return this.http.request({
+            method: "GET",
+            path: `/contacts/${enc(contactId)}/memories`,
+        });
+    }
+}
+exports.ContactsResource = ContactsResource;
+function enc(s) {
+    return encodeURIComponent(s);
+}
+//# sourceMappingURL=contacts.js.map

package/resources/contacts.mjs

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

package/resources/custom-evals.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Custom eval resource — client.customEvals.*
+ *
+ * Maps to:
+ *   GET    /custom-evals/:eval_id
+ *   PATCH  /custom-evals/:eval_id
+ *   DELETE /custom-evals/:eval_id
+ *   POST   /custom-evals/:eval_id/run
+ *   GET    /custom-evals/:eval_id/runs
+ */
+import type { HttpClient } from "../core/http";
+import type { GetCustomEvalResponse, PatchCustomEvalBody, PatchCustomEvalResponse, RunCustomEvalBody, RunCustomEvalResponse, ListCustomEvalRunsResponse } from "../types/custom-evals.types";
+export declare class CustomEvalsResource {
+    private readonly http;
+    constructor(http: HttpClient);
+    /** Get a custom eval by ID. */
+    get(evalId: string): Promise<GetCustomEvalResponse>;
+    /** Update a custom eval. */
+    update(evalId: string, body: PatchCustomEvalBody): Promise<PatchCustomEvalResponse>;
+    /** Delete a custom eval. */
+    delete(evalId: string): Promise<void>;
+    /** Run a custom eval asynchronously. */
+    run(evalId: string, body: RunCustomEvalBody): Promise<RunCustomEvalResponse>;
+    /** List runs for a custom eval. */
+    listRuns(evalId: string, query?: {
+        limit?: number;
+    }): Promise<ListCustomEvalRunsResponse>;
+}

package/resources/custom-evals.js

@@ -0,0 +1,62 @@
+"use strict";
+/**
+ * Custom eval resource — client.customEvals.*
+ *
+ * Maps to:
+ *   GET    /custom-evals/:eval_id
+ *   PATCH  /custom-evals/:eval_id
+ *   DELETE /custom-evals/:eval_id
+ *   POST   /custom-evals/:eval_id/run
+ *   GET    /custom-evals/:eval_id/runs
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CustomEvalsResource = void 0;
+class CustomEvalsResource {
+    http;
+    constructor(http) {
+        this.http = http;
+    }
+    /** Get a custom eval by ID. */
+    async get(evalId) {
+        return this.http.request({
+            method: "GET",
+            path: `/custom-evals/${enc(evalId)}`,
+        });
+    }
+    /** Update a custom eval. */
+    async update(evalId, body) {
+        return this.http.request({
+            method: "PATCH",
+            path: `/custom-evals/${enc(evalId)}`,
+            body,
+        });
+    }
+    /** Delete a custom eval. */
+    async delete(evalId) {
+        return this.http.request({
+            method: "DELETE",
+            path: `/custom-evals/${enc(evalId)}`,
+        });
+    }
+    /** Run a custom eval asynchronously. */
+    async run(evalId, body) {
+        return this.http.request({
+            method: "POST",
+            path: `/custom-evals/${enc(evalId)}/run`,
+            body,
+        });
+    }
+    /** List runs for a custom eval. */
+    async listRuns(evalId, query) {
+        return this.http.request({
+            method: "GET",
+            path: `/custom-evals/${enc(evalId)}/runs`,
+            query: query,
+        });
+    }
+}
+exports.CustomEvalsResource = CustomEvalsResource;
+function enc(s) {
+    return encodeURIComponent(s);
+}
+//# sourceMappingURL=custom-evals.js.map

package/resources/custom-evals.mjs

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

package/resources/integrations.d.ts

@@ -0,0 +1,95 @@
+/**
+ * Integrations resource — client.integrations.*
+ *
+ * Maps to:
+ *   GET  /integrations
+ *   GET  /integrations/:integrationId
+ *   POST /integrations/:integrationId/create-credential
+ *
+ * Integration-specific resources:
+ *   GET /integrations/google-sheets/spreadsheets
+ *   GET /integrations/google-sheets/worksheets
+ *   GET /integrations/google-sheets/columns
+ *   GET /integrations/google-sheets/rows
+ *   GET /integrations/slack/channels
+ *   GET /integrations/slack/users
+ *   GET /integrations/teams/teams
+ *   GET /integrations/teams/channels
+ *   GET /integrations/teams/users
+ *   GET /integrations/twilio-sms/phone-numbers
+ *   GET /integrations/whatsapp/businesses
+ *   GET /integrations/whatsapp/business-accounts
+ *   GET /integrations/whatsapp/phone-numbers
+ *   GET /integrations/whatsapp/message-templates
+ */
+import type { HttpClient } from "../core/http";
+import type { ListIntegrationsQuery, ListIntegrationsResponse, Integration, CreateCredentialBody, CreateCredentialResponse, CredentialIdQuery, GoogleSheetsWorksheetsQuery, GoogleSheetsColumnsQuery, GoogleSheetsRowsQuery, TeamsChannelsQuery, WhatsAppCredentialQuery, WhatsAppBusinessAccountsQuery, WhatsAppPhoneNumbersQuery, WhatsAppMessageTemplatesQuery, ResourceListResponse, ResourceListWithDescriptionResponse, WhatsAppTemplateListResponse } from "../types/integrations.types";
+declare class GoogleSheetsResource {
+    private readonly http;
+    constructor(http: HttpClient);
+    /** List Google Sheets spreadsheets. */
+    spreadsheets(query?: CredentialIdQuery): Promise<ResourceListResponse>;
+    /** List worksheets in a spreadsheet. */
+    worksheets(query: GoogleSheetsWorksheetsQuery): Promise<ResourceListResponse>;
+    /** List columns in a worksheet. */
+    columns(query: GoogleSheetsColumnsQuery): Promise<ResourceListResponse>;
+    /** List rows in a worksheet. */
+    rows(query: GoogleSheetsRowsQuery): Promise<ResourceListResponse>;
+}
+declare class SlackResource {
+    private readonly http;
+    constructor(http: HttpClient);
+    /** List Slack channels. */
+    channels(query?: CredentialIdQuery): Promise<ResourceListWithDescriptionResponse>;
+    /** List Slack users. */
+    users(query?: CredentialIdQuery): Promise<ResourceListWithDescriptionResponse>;
+}
+declare class TeamsResource {
+    private readonly http;
+    constructor(http: HttpClient);
+    /** List Microsoft Teams teams. */
+    teams(query?: CredentialIdQuery): Promise<ResourceListResponse>;
+    /** List Microsoft Teams channels. */
+    channels(query?: TeamsChannelsQuery): Promise<ResourceListResponse>;
+    /** List Microsoft Teams users. */
+    users(query?: CredentialIdQuery): Promise<ResourceListResponse>;
+}
+declare class TwilioSmsResource {
+    private readonly http;
+    constructor(http: HttpClient);
+    /** List Twilio SMS phone numbers. */
+    phoneNumbers(query?: CredentialIdQuery): Promise<ResourceListWithDescriptionResponse>;
+}
+declare class WhatsAppResource {
+    private readonly http;
+    constructor(http: HttpClient);
+    /** List WhatsApp businesses. */
+    businesses(query: WhatsAppCredentialQuery): Promise<ResourceListResponse>;
+    /** List WhatsApp business accounts. */
+    businessAccounts(query: WhatsAppBusinessAccountsQuery): Promise<ResourceListResponse>;
+    /** List WhatsApp phone numbers. */
+    phoneNumbers(query: WhatsAppPhoneNumbersQuery): Promise<ResourceListResponse>;
+    /** List WhatsApp message templates. */
+    messageTemplates(query: WhatsAppMessageTemplatesQuery): Promise<WhatsAppTemplateListResponse>;
+}
+export declare class IntegrationsResource {
+    private readonly http;
+    /** Google Sheets resource fetching. */
+    readonly googleSheets: GoogleSheetsResource;
+    /** Slack resource fetching. */
+    readonly slack: SlackResource;
+    /** Microsoft Teams resource fetching. */
+    readonly teams: TeamsResource;
+    /** Twilio SMS resource fetching. */
+    readonly twilioSms: TwilioSmsResource;
+    /** WhatsApp resource fetching. */
+    readonly whatsApp: WhatsAppResource;
+    constructor(http: HttpClient);
+    /** List all integrations (optionally filtered). */
+    list(query?: ListIntegrationsQuery): Promise<ListIntegrationsResponse>;
+    /** Get an integration by ID. */
+    get(integrationId: string): Promise<Integration>;
+    /** Create a credential for a form-based integration. */
+    createCredential(integrationId: string, body: CreateCredentialBody): Promise<CreateCredentialResponse>;
+}
+export {};

package/resources/integrations.js

@@ -0,0 +1,220 @@
+"use strict";
+/**
+ * Integrations resource — client.integrations.*
+ *
+ * Maps to:
+ *   GET  /integrations
+ *   GET  /integrations/:integrationId
+ *   POST /integrations/:integrationId/create-credential
+ *
+ * Integration-specific resources:
+ *   GET /integrations/google-sheets/spreadsheets
+ *   GET /integrations/google-sheets/worksheets
+ *   GET /integrations/google-sheets/columns
+ *   GET /integrations/google-sheets/rows
+ *   GET /integrations/slack/channels
+ *   GET /integrations/slack/users
+ *   GET /integrations/teams/teams
+ *   GET /integrations/teams/channels
+ *   GET /integrations/teams/users
+ *   GET /integrations/twilio-sms/phone-numbers
+ *   GET /integrations/whatsapp/businesses
+ *   GET /integrations/whatsapp/business-accounts
+ *   GET /integrations/whatsapp/phone-numbers
+ *   GET /integrations/whatsapp/message-templates
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.IntegrationsResource = void 0;
+// ── Sub-resource classes ──
+class GoogleSheetsResource {
+    http;
+    constructor(http) {
+        this.http = http;
+    }
+    /** List Google Sheets spreadsheets. */
+    async spreadsheets(query) {
+        return this.http.request({
+            method: "GET",
+            path: "/integrations/google-sheets/spreadsheets",
+            query: query,
+        });
+    }
+    /** List worksheets in a spreadsheet. */
+    async worksheets(query) {
+        return this.http.request({
+            method: "GET",
+            path: "/integrations/google-sheets/worksheets",
+            query: { ...query },
+        });
+    }
+    /** List columns in a worksheet. */
+    async columns(query) {
+        return this.http.request({
+            method: "GET",
+            path: "/integrations/google-sheets/columns",
+            query: { ...query },
+        });
+    }
+    /** List rows in a worksheet. */
+    async rows(query) {
+        return this.http.request({
+            method: "GET",
+            path: "/integrations/google-sheets/rows",
+            query: { ...query },
+        });
+    }
+}
+class SlackResource {
+    http;
+    constructor(http) {
+        this.http = http;
+    }
+    /** List Slack channels. */
+    async channels(query) {
+        return this.http.request({
+            method: "GET",
+            path: "/integrations/slack/channels",
+            query: query,
+        });
+    }
+    /** List Slack users. */
+    async users(query) {
+        return this.http.request({
+            method: "GET",
+            path: "/integrations/slack/users",
+            query: query,
+        });
+    }
+}
+class TeamsResource {
+    http;
+    constructor(http) {
+        this.http = http;
+    }
+    /** List Microsoft Teams teams. */
+    async teams(query) {
+        return this.http.request({
+            method: "GET",
+            path: "/integrations/teams/teams",
+            query: query,
+        });
+    }
+    /** List Microsoft Teams channels. */
+    async channels(query) {
+        return this.http.request({
+            method: "GET",
+            path: "/integrations/teams/channels",
+            query: query,
+        });
+    }
+    /** List Microsoft Teams users. */
+    async users(query) {
+        return this.http.request({
+            method: "GET",
+            path: "/integrations/teams/users",
+            query: query,
+        });
+    }
+}
+class TwilioSmsResource {
+    http;
+    constructor(http) {
+        this.http = http;
+    }
+    /** List Twilio SMS phone numbers. */
+    async phoneNumbers(query) {
+        return this.http.request({
+            method: "GET",
+            path: "/integrations/twilio-sms/phone-numbers",
+            query: query,
+        });
+    }
+}
+class WhatsAppResource {
+    http;
+    constructor(http) {
+        this.http = http;
+    }
+    /** List WhatsApp businesses. */
+    async businesses(query) {
+        return this.http.request({
+            method: "GET",
+            path: "/integrations/whatsapp/businesses",
+            query: { ...query },
+        });
+    }
+    /** List WhatsApp business accounts. */
+    async businessAccounts(query) {
+        return this.http.request({
+            method: "GET",
+            path: "/integrations/whatsapp/business-accounts",
+            query: { ...query },
+        });
+    }
+    /** List WhatsApp phone numbers. */
+    async phoneNumbers(query) {
+        return this.http.request({
+            method: "GET",
+            path: "/integrations/whatsapp/phone-numbers",
+            query: { ...query },
+        });
+    }
+    /** List WhatsApp message templates. */
+    async messageTemplates(query) {
+        return this.http.request({
+            method: "GET",
+            path: "/integrations/whatsapp/message-templates",
+            query: { ...query },
+        });
+    }
+}
+// ── Main resource ──
+class IntegrationsResource {
+    http;
+    /** Google Sheets resource fetching. */
+    googleSheets;
+    /** Slack resource fetching. */
+    slack;
+    /** Microsoft Teams resource fetching. */
+    teams;
+    /** Twilio SMS resource fetching. */
+    twilioSms;
+    /** WhatsApp resource fetching. */
+    whatsApp;
+    constructor(http) {
+        this.http = http;
+        this.googleSheets = new GoogleSheetsResource(http);
+        this.slack = new SlackResource(http);
+        this.teams = new TeamsResource(http);
+        this.twilioSms = new TwilioSmsResource(http);
+        this.whatsApp = new WhatsAppResource(http);
+    }
+    /** List all integrations (optionally filtered). */
+    async list(query) {
+        return this.http.request({
+            method: "GET",
+            path: "/integrations",
+            query: query,
+        });
+    }
+    /** Get an integration by ID. */
+    async get(integrationId) {
+        return this.http.request({
+            method: "GET",
+            path: `/integrations/${enc(integrationId)}`,
+        });
+    }
+    /** Create a credential for a form-based integration. */
+    async createCredential(integrationId, body) {
+        return this.http.request({
+            method: "POST",
+            path: `/integrations/${enc(integrationId)}/create-credential`,
+            body,
+        });
+    }
+}
+exports.IntegrationsResource = IntegrationsResource;
+function enc(s) {
+    return encodeURIComponent(s);
+}
+//# sourceMappingURL=integrations.js.map

package/resources/integrations.mjs

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

package/resources/issues.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Issue resource — client.issues.*
+ *
+ * Maps to:
+ *   PATCH /issues/:issue_id
+ */
+import type { HttpClient } from "../core/http";
+import type { UpdateIssueBody, UpdateIssueResponse } from "../types/issues.types";
+export declare class IssuesResource {
+    private readonly http;
+    constructor(http: HttpClient);
+    /** Update the status of a quality issue (flag). */
+    update(issueId: string, body: UpdateIssueBody): Promise<UpdateIssueResponse>;
+}

package/resources/issues.js

@@ -0,0 +1,25 @@
+"use strict";
+/**
+ * Issue resource — client.issues.*
+ *
+ * Maps to:
+ *   PATCH /issues/:issue_id
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.IssuesResource = void 0;
+class IssuesResource {
+    http;
+    constructor(http) {
+        this.http = http;
+    }
+    /** Update the status of a quality issue (flag). */
+    async update(issueId, body) {
+        return this.http.request({
+            method: "PATCH",
+            path: `/issues/${encodeURIComponent(issueId)}`,
+            body,
+        });
+    }
+}
+exports.IssuesResource = IssuesResource;
+//# sourceMappingURL=issues.js.map

package/resources/issues.mjs

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

package/resources/knowledge-bases.d.ts

@@ -0,0 +1,35 @@
+/**
+ * Knowledge bases resource — client.knowledgeBases.*
+ *
+ * Maps to:
+ *   GET    /knowledge-bases
+ *   GET    /knowledge-bases/:kbId/files
+ *   POST   /knowledge-bases/:kbId/upload-urls
+ *   POST   /knowledge-bases/:kbId/trigger-chunking
+ *   DELETE /knowledge-bases/:kbId/files/:fileId
+ *   DELETE /knowledge-bases/:kbId
+ */
+import type { HttpClient } from "../core/http";
+import type { KnowledgeBase, KnowledgeBaseDocument } from "../types/knowledge-bases.types";
+export interface UploadUrlsBody {
+    files: Array<{
+        name: string;
+        content_type: string;
+    }>;
+}
+export declare class KnowledgeBasesResource {
+    private readonly http;
+    constructor(http: HttpClient);
+    /** List all knowledge bases. */
+    list(): Promise<KnowledgeBase[]>;
+    /** List files in a knowledge base. */
+    listFiles(kbId: string): Promise<KnowledgeBaseDocument[]>;
+    /** Get pre-signed upload URLs for files. */
+    getUploadUrls(kbId: string, body: UploadUrlsBody): Promise<unknown>;
+    /** Trigger document chunking/processing. */
+    triggerChunking(kbId: string): Promise<unknown>;
+    /** Delete a file from a knowledge base. */
+    deleteFile(kbId: string, fileId: string): Promise<void>;
+    /** Delete a knowledge base. */
+    delete(kbId: string): Promise<void>;
+}

package/resources/knowledge-bases.js

@@ -0,0 +1,68 @@
+"use strict";
+/**
+ * Knowledge bases resource — client.knowledgeBases.*
+ *
+ * Maps to:
+ *   GET    /knowledge-bases
+ *   GET    /knowledge-bases/:kbId/files
+ *   POST   /knowledge-bases/:kbId/upload-urls
+ *   POST   /knowledge-bases/:kbId/trigger-chunking
+ *   DELETE /knowledge-bases/:kbId/files/:fileId
+ *   DELETE /knowledge-bases/:kbId
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.KnowledgeBasesResource = void 0;
+class KnowledgeBasesResource {
+    http;
+    constructor(http) {
+        this.http = http;
+    }
+    /** List all knowledge bases. */
+    async list() {
+        return this.http.request({
+            method: "GET",
+            path: "/knowledge-bases",
+        });
+    }
+    /** List files in a knowledge base. */
+    async listFiles(kbId) {
+        return this.http.request({
+            method: "GET",
+            path: `/knowledge-bases/${enc(kbId)}/files`,
+        });
+    }
+    /** Get pre-signed upload URLs for files. */
+    async getUploadUrls(kbId, body) {
+        return this.http.request({
+            method: "POST",
+            path: `/knowledge-bases/${enc(kbId)}/upload-urls`,
+            body,
+        });
+    }
+    /** Trigger document chunking/processing. */
+    async triggerChunking(kbId) {
+        return this.http.request({
+            method: "POST",
+            path: `/knowledge-bases/${enc(kbId)}/trigger-chunking`,
+        });
+    }
+    /** Delete a file from a knowledge base. */
+    async deleteFile(kbId, fileId) {
+        return this.http.request({
+            method: "DELETE",
+            path: `/knowledge-bases/${enc(kbId)}/files/${enc(fileId)}`,
+        });
+    }
+    /** Delete a knowledge base. */
+    async delete(kbId) {
+        return this.http.request({
+            method: "DELETE",
+            path: `/knowledge-bases/${enc(kbId)}`,
+        });
+    }
+}
+exports.KnowledgeBasesResource = KnowledgeBasesResource;
+function enc(s) {
+    return encodeURIComponent(s);
+}
+//# sourceMappingURL=knowledge-bases.js.map

package/resources/knowledge-bases.mjs

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

package/resources/mcp.d.ts

@@ -0,0 +1,20 @@
+/**
+ * MCP resource — client.mcp.*
+ *
+ * Maps to:
+ *   GET  /mcp
+ *   POST /mcp
+ *   POST /mcp/:mcpId/refresh
+ */
+import type { HttpClient } from "../core/http";
+import type { ListMCPServersQuery, PaginatedMCPServersResponse, CreateMCPServerBody, MCPServerResponse } from "../types/mcp.types";
+export declare class MCPResource {
+    private readonly http;
+    constructor(http: HttpClient);
+    /** List MCP servers (paginated). */
+    list(query?: ListMCPServersQuery): Promise<PaginatedMCPServersResponse>;
+    /** Register a new MCP server. */
+    create(body: CreateMCPServerBody): Promise<MCPServerResponse>;
+    /** Refresh (re-discover tools for) an MCP server. */
+    refresh(mcpId: string): Promise<MCPServerResponse>;
+}