@agent-os-sdk/client 0.9.26 → 0.9.28

package/dist/modules/chatwoot.js

@@ -0,0 +1,200 @@
+/**
+ * Chatwoot Module
+ */
+export class ChatwootModule {
+    client;
+    headers;
+    constructor(client, headers) {
+        this.client = client;
+        this.headers = headers;
+    }
+    /**
+     * Internal helper to resolve Chatwoot configuration from AgentOS credentials
+     */
+    async _getChatwootConfig(credentialId) {
+        const { data: credential, error } = await this.client.GET("/v1/api/credentials/{id}", {
+            params: {
+                path: { id: credentialId },
+                query: { includeValues: true }
+            },
+            headers: this.headers(),
+        });
+        if (error || !credential) {
+            return { error: error || { message: "Credential not found", code: "CREDENTIAL_NOT_FOUND" }, data: undefined };
+        }
+        // Backend now returns 'values' when includeValues=true
+        const values = credential.values || credential.Values || {};
+        const publicConfig = credential.publicConfig || credential.PublicConfig || {};
+        const data = credential.data || {};
+        const url = publicConfig.url || data.url || values.url || publicConfig.endpoint || data.endpoint || values.endpoint || values.base_url;
+        let accountId = publicConfig.account_id || data.account_id || values.account_id || publicConfig.accountId || data.accountId || values.accountId;
+        const apiAccessToken = values.api_access_token || data.api_access_token || values.api_key || data.api_key || values.apiKey || data.apiKey || values.api_token;
+        if (!url || !apiAccessToken) {
+            return { error: { message: "Invalid Chatwoot credential: missing URL/Endpoint or API Access Token/Key", code: "INVALID_CREDENTIAL" }, data: undefined };
+        }
+        const baseUrl = url.endsWith("/") ? url.slice(0, -1) : url;
+        // Auto-discover accountId if missing
+        if (!accountId) {
+            try {
+                const profileRes = await fetch(`${baseUrl}/api/v1/profile`, {
+                    headers: { "api_access_token": apiAccessToken }
+                });
+                if (profileRes.ok) {
+                    const profile = await profileRes.json();
+                    // Use the first available account
+                    if (profile.accounts && profile.accounts.length > 0) {
+                        accountId = profile.accounts[0].id;
+                    }
+                }
+            }
+            catch (err) {
+                console.warn("Failed to auto-discover Chatwoot account ID:", err);
+            }
+        }
+        if (!accountId) {
+            return { error: { message: "Invalid Chatwoot credential: missing Account ID and auto-discovery failed.", code: "ACCOUNT_ID_MISSING" }, data: undefined };
+        }
+        return {
+            data: {
+                baseUrl,
+                accountId: String(accountId),
+                apiAccessToken
+            },
+            error: null
+        };
+    }
+    /**
+     * Direct call to Chatwoot API
+     */
+    async _chatwootRequest(config, method, path, body) {
+        const url = `${config.baseUrl}${path}`;
+        const headers = {
+            "api_access_token": config.apiAccessToken,
+            "Content-Type": "application/json",
+        };
+        try {
+            const response = await fetch(url, {
+                method,
+                headers,
+                body: body ? JSON.stringify(body) : undefined,
+            });
+            let data = null;
+            const contentType = response.headers.get("content-type");
+            if (contentType && contentType.includes("application/json")) {
+                try {
+                    const text = await response.text();
+                    if (text)
+                        data = JSON.parse(text);
+                }
+                catch (e) {
+                    // Ignore JSON parse errors for empty bodies
+                }
+            }
+            if (!response.ok) {
+                return { error: data || { message: `Chatwoot API error: ${response.statusText}`, code: "API_ERROR" }, data: undefined, response };
+            }
+            return { data, error: undefined, response };
+        }
+        catch (err) {
+            return { error: { message: err.message, code: "UNKNOWN_ERROR" }, data: undefined, response: new Response() };
+        }
+    }
+    /**
+     * Get the inbox URL for a specific credential.
+     * Use this to open the Chatwoot inbox directly.
+     */
+    async getInboxUrl(credentialId) {
+        const { data: config, error } = await this._getChatwootConfig(credentialId);
+        if (error || !config) {
+            return { error: error || { message: "Config not found", code: "CONFIG_MISSING" }, data: undefined, response: new Response() };
+        }
+        const inboxUrl = `${config.baseUrl}/app/accounts/${config.accountId}/inbox`;
+        return {
+            data: { url: inboxUrl },
+            error: undefined,
+            response: new Response(),
+        };
+    }
+    /**
+     * List all inboxes
+     */
+    async listInboxes(credentialId) {
+        const { data: config, error } = await this._getChatwootConfig(credentialId);
+        if (error || !config)
+            return { error: error || { message: "Config not found", code: "CONFIG_MISSING" }, data: undefined, response: new Response() };
+        const res = await this._chatwootRequest(config, "GET", `/api/v1/accounts/${config.accountId}/inboxes`);
+        // Chatwoot API returns { payload: [...] }
+        if (res.data && Array.isArray(res.data.payload)) {
+            return { data: res.data.payload, error: undefined, response: res.response };
+        }
+        return res;
+    }
+    /**
+     * Create a new inbox
+     */
+    async createInbox(credentialId, data) {
+        const { data: config, error } = await this._getChatwootConfig(credentialId);
+        if (error || !config)
+            return { error: error || { message: "Config not found", code: "CONFIG_MISSING" }, data: undefined, response: new Response() };
+        return this._chatwootRequest(config, "POST", `/api/v1/accounts/${config.accountId}/inboxes`, data);
+    }
+    /**
+     * Get a specific inbox
+     */
+    async getInbox(credentialId, inboxId) {
+        const { data: config, error } = await this._getChatwootConfig(credentialId);
+        if (error || !config)
+            return { error: error || { message: "Config not found", code: "CONFIG_MISSING" }, data: undefined, response: new Response() };
+        return this._chatwootRequest(config, "GET", `/api/v1/accounts/${config.accountId}/inboxes/${inboxId}`);
+    }
+    /**
+     * Update an inbox
+     */
+    async updateInbox(credentialId, inboxId, data) {
+        const { data: config, error } = await this._getChatwootConfig(credentialId);
+        if (error || !config)
+            return { error: error || { message: "Config not found", code: "CONFIG_MISSING" }, data: undefined, response: new Response() };
+        return this._chatwootRequest(config, "PATCH", `/api/v1/accounts/${config.accountId}/inboxes/${inboxId}`, data);
+    }
+    /**
+     * Delete an inbox
+     */
+    async deleteInbox(credentialId, inboxId) {
+        const { data: config, error } = await this._getChatwootConfig(credentialId);
+        if (error || !config)
+            return { error: error || { message: "Config not found", code: "CONFIG_MISSING" }, data: undefined, response: new Response() };
+        return this._chatwootRequest(config, "DELETE", `/api/v1/accounts/${config.accountId}/inboxes/${inboxId}`);
+    }
+    /**
+     * Get inbox metrics
+     */
+    async getInboxMetrics(credentialId, inboxId) {
+        const { data: config, error } = await this._getChatwootConfig(credentialId);
+        if (error || !config)
+            return { error: error || { message: "Config not found", code: "CONFIG_MISSING" }, data: undefined, response: new Response() };
+        return this._chatwootRequest(config, "GET", `/api/v1/accounts/${config.accountId}/inboxes/${inboxId}/metrics`);
+    }
+    /**
+     * Get the inbox URL for a specific agent.
+     */
+    async getAgentInboxUrl(agentId) {
+        const { data: triggers, error: triggerError } = await this.client.GET("/v1/api/triggers", {
+            params: { query: { agent_id: agentId } },
+            headers: this.headers(),
+        });
+        if (triggerError || !triggers) {
+            return { error: triggerError || { message: "Failed to fetch triggers", code: "TRIGGER_FETCH_FAILED" }, data: undefined, response: new Response() };
+        }
+        const chatwootTrigger = triggers.items?.find((t) => t.type === "chatwoot" ||
+            (t.type === "evolution_whatsapp" && t.config?.chat_platform === "chatwoot") ||
+            (t.config?.credential_id && (t.type === "chatwoot" || t.type.includes("whatsapp"))));
+        if (!chatwootTrigger) {
+            return { error: { message: "No compatible trigger found for this agent", code: "NO_TRIGGER" }, data: undefined, response: new Response() };
+        }
+        const credentialId = chatwootTrigger.config?.credential_id;
+        if (!credentialId) {
+            return { error: { message: "Trigger configuration missing credential_id", code: "MISSING_CREDENTIAL_ID" }, data: undefined, response: new Response() };
+        }
+        return this.getInboxUrl(credentialId);
+    }
+}

package/dist/modules/checkpoints.d.ts

@@ -0,0 +1,62 @@
+/**
+ * Checkpoints Module - Fully Typed
+ */
+import type { RawClient, APIResponse } from "../client/raw.js";
+export interface Checkpoint {
+    id: string;
+    run_id: string;
+    thread_id: string;
+    step_name: string;
+    checkpoint_id: string;
+    parent_checkpoint_id?: string;
+    has_state_snapshot: boolean;
+    created_at: string;
+}
+export interface CheckpointNode {
+    id: string;
+    step_name: string;
+    checkpoint_id: string;
+    parent_checkpoint_id?: string;
+    created_at: string;
+    children?: CheckpointNode[];
+}
+export interface CheckpointsResponse {
+    run_id: string;
+    total_checkpoints: number;
+    checkpoints: CheckpointNode[];
+}
+export interface ReplayResponse {
+    run_id: string;
+    status: string;
+    replayed_from_checkpoint_id: string;
+}
+export declare class CheckpointsModule {
+    private client;
+    private headers;
+    constructor(client: RawClient, headers: () => Record<string, string>);
+    /**
+     * List checkpoints for a run.
+     * @param workspaceId - Workspace ID
+     * @param runId - Run ID
+     */
+    list(workspaceId: string, runId: string): Promise<APIResponse<CheckpointsResponse>>;
+    /**
+     * Get a specific checkpoint.
+     * @param workspaceId - Workspace ID
+     * @param runId - Run ID
+     * @param checkpointId - Checkpoint ID
+     */
+    get(workspaceId: string, runId: string, checkpointId: string): Promise<APIResponse<Checkpoint>>;
+    /**
+     * Replay from a checkpoint.
+     * @param workspaceId - Workspace ID
+     * @param runId - Run ID
+     * @param checkpointId - Checkpoint ID
+     * @param options - Replay options
+     */
+    replay(workspaceId: string, runId: string, checkpointId: string, options?: {
+        create_new_thread?: boolean;
+        modified_input?: string;
+    }): Promise<APIResponse<ReplayResponse>>;
+}
+//# sourceMappingURL=checkpoints.d.ts.map

package/dist/modules/checkpoints.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"checkpoints.d.ts","sourceRoot":"","sources":["../../src/modules/checkpoints.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,WAAW,EAAc,MAAM,kBAAkB,CAAC;AAK3E,MAAM,WAAW,UAAU;IACvB,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,aAAa,EAAE,MAAM,CAAC;IACtB,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B,kBAAkB,EAAE,OAAO,CAAC;IAC5B,UAAU,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,cAAc;IAC3B,EAAE,EAAE,MAAM,CAAC;IACX,SAAS,EAAE,MAAM,CAAC;IAClB,aAAa,EAAE,MAAM,CAAC;IACtB,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,cAAc,EAAE,CAAC;CAC/B;AAED,MAAM,WAAW,mBAAmB;IAChC,MAAM,EAAE,MAAM,CAAC;IACf,iBAAiB,EAAE,MAAM,CAAC;IAC1B,WAAW,EAAE,cAAc,EAAE,CAAC;CACjC;AAED,MAAM,WAAW,cAAc;IAC3B,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,2BAA2B,EAAE,MAAM,CAAC;CACvC;AAED,qBAAa,iBAAiB;IACd,OAAO,CAAC,MAAM;IAAa,OAAO,CAAC,OAAO;gBAAlC,MAAM,EAAE,SAAS,EAAU,OAAO,EAAE,MAAM,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC;IAEpF;;;;OAIG;IACG,IAAI,CAAC,WAAW,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC,mBAAmB,CAAC,CAAC;IAOzF;;;;;OAKG;IACG,GAAG,CAAC,WAAW,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC,UAAU,CAAC,CAAC;IAOrG;;;;;;OAMG;IACG,MAAM,CAAC,WAAW,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;QAC7E,iBAAiB,CAAC,EAAE,OAAO,CAAC;QAC5B,cAAc,CAAC,EAAE,MAAM,CAAC;KAC3B,GAAG,OAAO,CAAC,WAAW,CAAC,cAAc,CAAC,CAAC;CAO3C"}

package/dist/modules/checkpoints.js

@@ -0,0 +1,48 @@
+/**
+ * Checkpoints Module - Fully Typed
+ */
+export class CheckpointsModule {
+    client;
+    headers;
+    constructor(client, headers) {
+        this.client = client;
+        this.headers = headers;
+    }
+    /**
+     * List checkpoints for a run.
+     * @param workspaceId - Workspace ID
+     * @param runId - Run ID
+     */
+    async list(workspaceId, runId) {
+        return this.client.GET("/v1/api/workspaces/{workspaceId}/runs/{runId}/checkpoints", {
+            params: { path: { workspaceId, runId } },
+            headers: this.headers(),
+        });
+    }
+    /**
+     * Get a specific checkpoint.
+     * @param workspaceId - Workspace ID
+     * @param runId - Run ID
+     * @param checkpointId - Checkpoint ID
+     */
+    async get(workspaceId, runId, checkpointId) {
+        return this.client.GET("/v1/api/workspaces/{workspaceId}/runs/{runId}/checkpoints/{checkpointId}", {
+            params: { path: { workspaceId, runId, checkpointId } },
+            headers: this.headers(),
+        });
+    }
+    /**
+     * Replay from a checkpoint.
+     * @param workspaceId - Workspace ID
+     * @param runId - Run ID
+     * @param checkpointId - Checkpoint ID
+     * @param options - Replay options
+     */
+    async replay(workspaceId, runId, checkpointId, options) {
+        return this.client.POST("/v1/api/workspaces/{workspaceId}/runs/{runId}/checkpoints/{checkpointId}/replay", {
+            params: { path: { workspaceId, runId, checkpointId } },
+            body: options ?? {},
+            headers: this.headers(),
+        });
+    }
+}

package/dist/modules/contracts.d.ts

@@ -0,0 +1,48 @@
+import type { APIResponse, RawClient } from "../client/raw.js";
+export interface ContractsValidationIssue {
+    code: string;
+    message: string;
+    path?: string;
+    severity?: string;
+}
+export type ContractsErrorCode = "CONTRACT_ID_INVALID" | "RUNTIME_PACKAGE_COMPILE_INVALID" | "INTERNAL_UNAUTHORIZED" | "KERNEL_UNAVAILABLE" | "KERNEL_ERROR" | "INTERNAL_ERROR" | "VALIDATION_ERROR";
+export interface ContractsErrorResponse {
+    code: ContractsErrorCode;
+    message: string;
+    errors?: ContractsValidationIssue[];
+    supported_contract_ids?: string[];
+}
+export interface ContractsSupportedResponse {
+    contract_ids: string[];
+}
+export interface ContractsValidateRequest {
+    contract_id: string;
+    spec: unknown;
+}
+export interface ContractsValidateResponse {
+    contract_id: string;
+    valid: boolean;
+    errors: ContractsValidationIssue[];
+    warnings: ContractsValidationIssue[];
+}
+export interface ContractsCompileRuntimePackageRequest {
+    ir_spec: unknown;
+    capability_registry_spec: unknown;
+    policy_refs?: Record<string, unknown>;
+    runtime_config_refs?: Record<string, unknown>;
+    package_id?: string;
+    metadata?: Record<string, unknown>;
+    compiled_at?: string;
+}
+export interface ContractsCompileRuntimePackageResponse {
+    package_spec: Record<string, unknown>;
+}
+export declare class ContractsModule {
+    private client;
+    private headers;
+    constructor(client: RawClient, headers: () => Record<string, string>);
+    supported(): Promise<APIResponse<ContractsSupportedResponse>>;
+    validate(body: ContractsValidateRequest): Promise<APIResponse<ContractsValidateResponse>>;
+    compileRuntimePackage(body: ContractsCompileRuntimePackageRequest): Promise<APIResponse<ContractsCompileRuntimePackageResponse>>;
+}
+//# sourceMappingURL=contracts.d.ts.map

package/dist/modules/contracts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"contracts.d.ts","sourceRoot":"","sources":["../../src/modules/contracts.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAE/D,MAAM,WAAW,wBAAwB;IACrC,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,MAAM,kBAAkB,GACxB,qBAAqB,GACrB,iCAAiC,GACjC,uBAAuB,GACvB,oBAAoB,GACpB,cAAc,GACd,gBAAgB,GAChB,kBAAkB,CAAC;AAEzB,MAAM,WAAW,sBAAsB;IACnC,IAAI,EAAE,kBAAkB,CAAC;IACzB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,wBAAwB,EAAE,CAAC;IACpC,sBAAsB,CAAC,EAAE,MAAM,EAAE,CAAC;CACrC;AAED,MAAM,WAAW,0BAA0B;IACvC,YAAY,EAAE,MAAM,EAAE,CAAC;CAC1B;AAED,MAAM,WAAW,wBAAwB;IACrC,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,OAAO,CAAC;CACjB;AAED,MAAM,WAAW,yBAAyB;IACtC,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,OAAO,CAAC;IACf,MAAM,EAAE,wBAAwB,EAAE,CAAC;IACnC,QAAQ,EAAE,wBAAwB,EAAE,CAAC;CACxC;AAED,MAAM,WAAW,qCAAqC;IAClD,OAAO,EAAE,OAAO,CAAC;IACjB,wBAAwB,EAAE,OAAO,CAAC;IAClC,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACtC,mBAAmB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC9C,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACnC,WAAW,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,sCAAsC;IACnD,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACzC;AAED,qBAAa,eAAe;IACZ,OAAO,CAAC,MAAM;IAAa,OAAO,CAAC,OAAO;gBAAlC,MAAM,EAAE,SAAS,EAAU,OAAO,EAAE,MAAM,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC;IAE9E,SAAS,IAAI,OAAO,CAAC,WAAW,CAAC,0BAA0B,CAAC,CAAC;IAM7D,QAAQ,CAAC,IAAI,EAAE,wBAAwB,GAAG,OAAO,CAAC,WAAW,CAAC,yBAAyB,CAAC,CAAC;IAOzF,qBAAqB,CACvB,IAAI,EAAE,qCAAqC,GAC5C,OAAO,CAAC,WAAW,CAAC,sCAAsC,CAAC,CAAC;CAMlE"}

package/dist/modules/contracts.js

@@ -0,0 +1,25 @@
+export class ContractsModule {
+    client;
+    headers;
+    constructor(client, headers) {
+        this.client = client;
+        this.headers = headers;
+    }
+    async supported() {
+        return this.client.GET("/v1/api/contracts/supported", {
+            headers: this.headers(),
+        });
+    }
+    async validate(body) {
+        return this.client.POST("/v1/api/contracts/validate", {
+            body,
+            headers: this.headers(),
+        });
+    }
+    async compileRuntimePackage(body) {
+        return this.client.POST("/v1/api/contracts/compile/runtime-package", {
+            body,
+            headers: this.headers(),
+        });
+    }
+}

package/dist/modules/credentials.d.ts

@@ -0,0 +1,105 @@
+/**
+ * Credentials Module - Fully Typed
+ */
+import type { APIResponse, RawClient } from "../client/raw.js";
+export interface Credential {
+    id: string;
+    credential_instance_ref?: string;
+    name: string;
+    scope: "workspace" | "tenant";
+    type_id?: string;
+    type?: string;
+    credential_type_ref?: string;
+    workspace_id?: string;
+    tenant_id: string;
+    sharing_mode: "private" | "shared";
+    status: "active" | "disabled" | "expired";
+    created_at: string;
+    updated_at: string;
+}
+export interface CredentialListResponse {
+    items: Credential[];
+    total: number;
+}
+export interface CredentialType {
+    id: string;
+    name: string;
+    credential_type_ref?: string;
+    display_name?: string;
+    description?: string;
+    provider_family?: string;
+    version?: string;
+    status?: string;
+    masking_policy?: string;
+    materialization_policy?: string;
+    schema_public_json?: Record<string, unknown> | null;
+    schema_secret_json?: Record<string, unknown> | null;
+}
+export interface CredentialTypesResponse {
+    items: CredentialType[];
+    count?: number;
+}
+export interface ValidateCredentialResponse {
+    valid: boolean;
+    error?: string;
+}
+export declare class CredentialsModule {
+    private client;
+    private getWorkspaceId;
+    private headers;
+    constructor(client: RawClient, getWorkspaceId: () => string, headers: () => Record<string, string>);
+    /**
+     * List all credentials.
+     */
+    list(params?: {
+        workspace_id?: string;
+        scope?: string;
+        type?: string;
+        limit?: number;
+        offset?: number;
+    }): Promise<APIResponse<CredentialListResponse>>;
+    /**
+     * Get a credential by ID.
+     */
+    get(credentialId: string, includeValues?: boolean): Promise<APIResponse<Credential>>;
+    /**
+     * Create a new credential.
+     */
+    create(body: {
+        name: string;
+        scope?: "workspace" | "tenant";
+        type_id?: string;
+        type?: string;
+        workspace_id?: string;
+        values?: Record<string, unknown>;
+        data?: Record<string, unknown>;
+        sharing_mode?: "private" | "shared";
+    }): Promise<APIResponse<Credential>>;
+    /**
+     * Update a credential.
+     * Uses PATCH per backend CredentialsController.
+     */
+    update(credentialId: string, body: {
+        name?: string;
+        values?: Record<string, unknown>;
+        status?: string;
+        sharing_mode?: string;
+    }): Promise<APIResponse<Credential>>;
+    /**
+     * Delete a credential.
+     */
+    delete(credentialId: string): Promise<APIResponse<void>>;
+    /**
+     * List available credential types.
+     */
+    listTypes(): Promise<APIResponse<CredentialTypesResponse>>;
+    /**
+     * Validate a credential.
+     */
+    validate(credentialId: string): Promise<APIResponse<ValidateCredentialResponse>>;
+    /**
+     * List available models for a credential provider.
+     */
+    listModels(credentialId: string): Promise<APIResponse<string[]>>;
+}
+//# sourceMappingURL=credentials.d.ts.map

package/dist/modules/credentials.d.ts.map

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

package/dist/modules/credentials.js

@@ -0,0 +1,135 @@
+/**
+ * Credentials Module - Fully Typed
+ */
+export class CredentialsModule {
+    client;
+    getWorkspaceId;
+    headers;
+    constructor(client, getWorkspaceId, headers) {
+        this.client = client;
+        this.getWorkspaceId = getWorkspaceId;
+        this.headers = headers;
+    }
+    /**
+     * List all credentials.
+     */
+    async list(params) {
+        return this.client.GET("/v1/api/credentials", {
+            params: { query: params },
+            headers: this.headers(),
+        });
+    }
+    /**
+     * Get a credential by ID.
+     */
+    async get(credentialId, includeValues = false) {
+        return this.client.GET("/v1/api/credentials/{id}", {
+            params: {
+                path: { id: credentialId },
+                query: { includeValues }
+            },
+            headers: this.headers(),
+        });
+    }
+    /**
+     * Create a new credential.
+     */
+    async create(body) {
+        return this.client.POST("/v1/api/credentials", {
+            body: {
+                ...body,
+                workspace_id: body.workspace_id || (this.getWorkspaceId() ? this.getWorkspaceId() : undefined),
+            },
+            headers: this.headers(),
+        });
+    }
+    /**
+     * Update a credential.
+     * Uses PATCH per backend CredentialsController.
+     */
+    async update(credentialId, body) {
+        return this.client.PATCH("/v1/api/credentials/{id}", {
+            params: { path: { id: credentialId } },
+            body,
+            headers: this.headers(),
+        });
+    }
+    /**
+     * Delete a credential.
+     */
+    async delete(credentialId) {
+        return this.client.DELETE("/v1/api/credentials/{id}", {
+            params: { path: { id: credentialId } },
+            headers: this.headers(),
+        });
+    }
+    /**
+     * List available credential types.
+     */
+    async listTypes() {
+        const response = await this.client.GET("/v1/api/credential-types", {
+            headers: this.headers(),
+        });
+        if (!response.data || response.error) {
+            return response;
+        }
+        const raw = response.data;
+        const rawItems = Array.isArray(raw)
+            ? raw
+            : Array.isArray(raw.items)
+                ? raw.items
+                : [];
+        const items = rawItems
+            .filter((item) => Boolean(item) && typeof item === "object")
+            .map((item) => ({
+            id: String(item.id ?? ""),
+            name: String(item.name ?? item.key ?? ""),
+            credential_type_ref: typeof item.credential_type_ref === "string"
+                ? item.credential_type_ref
+                : undefined,
+            display_name: typeof item.display_name === "string"
+                ? item.display_name
+                : typeof item.displayName === "string"
+                    ? item.displayName
+                    : undefined,
+            description: typeof item.description === "string" ? item.description : undefined,
+            provider_family: typeof item.provider_family === "string" ? item.provider_family : undefined,
+            version: typeof item.version === "string" ? item.version : undefined,
+            status: typeof item.status === "string" ? item.status : undefined,
+            masking_policy: typeof item.masking_policy === "string" ? item.masking_policy : undefined,
+            materialization_policy: typeof item.materialization_policy === "string" ? item.materialization_policy : undefined,
+            schema_public_json: item.schema_public_json && typeof item.schema_public_json === "object"
+                ? item.schema_public_json
+                : null,
+            schema_secret_json: item.schema_secret_json && typeof item.schema_secret_json === "object"
+                ? item.schema_secret_json
+                : null,
+        }))
+            .filter((item) => item.id && item.name);
+        return {
+            ...response,
+            data: {
+                items,
+                count: typeof raw.count === "number" ? raw.count : items.length,
+            },
+        };
+    }
+    /**
+     * Validate a credential.
+     */
+    async validate(credentialId) {
+        return this.client.POST("/v1/api/credentials/{id}/validate", {
+            params: { path: { id: credentialId } },
+            headers: this.headers(),
+        });
+    }
+    /**
+     * List available models for a credential provider.
+     */
+    async listModels(credentialId) {
+        return this.client.GET("/v1/api/credentials/{id}/models", {
+            params: { path: { id: credentialId } },
+            headers: this.headers(),
+        });
+    }
+}