@amigo-ai/sdk 0.1.1

package/dist/types/index.d.ts

@@ -0,0 +1,29 @@
+import { OrganizationResource } from './resources/organization';
+import { ConversationResource } from './resources/conversation';
+import { ServiceResource } from './resources/services';
+import { UserResource } from './resources/user';
+import type { RetryOptions } from './core/retry';
+export interface AmigoSdkConfig {
+    /** API key from Amigo dashboard */
+    apiKey: string;
+    /** API-key ID from Amigo dashboard */
+    apiKeyId: string;
+    /** User ID on whose behalf the request is made */
+    userId: string;
+    /** The Organization ID */
+    orgId: string;
+    /** Base URL of the Amigo API */
+    baseUrl?: string;
+    /** Retry configuration for HTTP requests */
+    retry?: RetryOptions;
+}
+export declare class AmigoClient {
+    readonly organizations: OrganizationResource;
+    readonly conversations: ConversationResource;
+    readonly services: ServiceResource;
+    readonly users: UserResource;
+    readonly config: AmigoSdkConfig;
+    constructor(config: AmigoSdkConfig);
+}
+export * as errors from './core/errors';
+export type { components, operations, paths } from './generated/api-types';

package/dist/types/resources/conversation.d.ts

@@ -0,0 +1,94 @@
+import type { AmigoFetch } from '../core/openapi-client';
+import type { components, operations } from '../generated/api-types';
+type VoiceData = Blob | Uint8Array | ReadableStream<Uint8Array>;
+export type InteractionInput = string | VoiceData;
+export declare class ConversationResource {
+    private c;
+    private orgId;
+    constructor(c: AmigoFetch, orgId: string);
+    createConversation(body: components['schemas']['conversation__create_conversation__Request'], queryParams: operations['create-conversation']['parameters']['query'], headers?: operations['create-conversation']['parameters']['header'], options?: {
+        signal?: AbortSignal;
+    }): Promise<AsyncGenerator<{
+        type: "conversation-created";
+        conversation_id: string;
+    } | {
+        type: "interaction-complete";
+        message_id: string;
+        interaction_id: string;
+        full_message: string;
+        conversation_completed: boolean;
+    } | {
+        type: "new-message";
+        message: string;
+        message_metadata: string[];
+        transcript_alignment: [number, string][] | null;
+        stop: boolean;
+        sequence_number: number;
+        message_id: string;
+    } | {
+        type: "current-agent-action";
+        action: components["schemas"]["src__app__amigo__service__conversation__Action"];
+    } | {
+        type: "error";
+        http_error_code: number;
+        error_description: string;
+    }, any, any>>;
+    interactWithConversation(conversationId: string, input: InteractionInput, queryParams: operations['interact-with-conversation']['parameters']['query'], headers?: operations['interact-with-conversation']['parameters']['header'], options?: {
+        signal?: AbortSignal;
+    }): Promise<AsyncGenerator<{
+        type: "interaction-complete";
+        message_id: string;
+        interaction_id: string;
+        full_message: string;
+        conversation_completed: boolean;
+    } | {
+        type?: "end-session";
+    } | {
+        type: "new-message";
+        message: string;
+        message_metadata: string[];
+        transcript_alignment: [number, string][] | null;
+        stop: boolean;
+        sequence_number: number;
+        message_id: string;
+    } | {
+        type: "current-agent-action";
+        action: components["schemas"]["src__app__amigo__service__conversation__Action"];
+    } | {
+        type: "error";
+        http_error_code: number;
+        error_description: string;
+    } | {
+        type?: "user-message-available";
+        message_id: string;
+        user_message: string;
+    }, any, any>>;
+    getConversations(queryParams?: operations['get-conversations']['parameters']['query'], headers?: operations['get-conversations']['parameters']['header']): Promise<{
+        conversations: components["schemas"]["Conversation"][];
+        has_more: boolean;
+        continuation_token: number | null;
+    }>;
+    getConversationMessages(conversationId: string, queryParams?: operations['get-conversation-messages']['parameters']['query'], headers?: operations['get-conversation-messages']['parameters']['header']): Promise<{
+        messages: components["schemas"]["MessageInstance"][];
+        has_more: boolean;
+        continuation_token: number | null;
+    }>;
+    finishConversation(conversationId: string, headers?: operations['finish-conversation']['parameters']['header']): Promise<void>;
+    recommendResponsesForInteraction(conversationId: string, interactionId: string, headers?: operations['recommend-responses-for-interaction']['parameters']['header']): Promise<{
+        recommended_responses: string[];
+    }>;
+    getInteractionInsights(conversationId: string, interactionId: string, headers?: operations['get-interaction-insights']['parameters']['header']): Promise<{
+        current_state_name: string;
+        current_state_action: string;
+        current_state_objective: string;
+        state_transition_logs: components["schemas"]["StateTransitionLog"][];
+        working_memory: components["schemas"]["WorkingMemory"][];
+        reflections: string[];
+        triggered_dynamic_behavior_set_version_info: [string, number] | null;
+    }>;
+    getMessageSource(conversationId: string, messageId: string, headers?: operations['retrieve-message-source']['parameters']['header']): Promise<{}>;
+    generateConversationStarters(body: components['schemas']['conversation__generate_conversation_starter__Request'], headers?: operations['generate-conversation-starter']['parameters']['header']): Promise<{
+        prompts: components["schemas"]["Prompt"][];
+    }>;
+}
+export {};

package/dist/types/resources/organization.d.ts

@@ -0,0 +1,21 @@
+import type { AmigoFetch } from '../core/openapi-client';
+import type { operations } from '../generated/api-types';
+export declare class OrganizationResource {
+    private c;
+    private orgId;
+    constructor(c: AmigoFetch, orgId: string);
+    /**
+     * Get organization details
+     * @param headers - The headers
+     * @returns The organization details
+     */
+    getOrganization(headers?: operations['get-organization']['parameters']['header']): Promise<{
+        org_id: string;
+        org_name: string;
+        title: string;
+        main_description: string;
+        sub_description: string;
+        onboarding_instructions: string[];
+        default_user_preferences: import("..").components["schemas"]["Preferences-Output"] | null;
+    }>;
+}

package/dist/types/resources/services.d.ts

@@ -0,0 +1,18 @@
+import type { AmigoFetch } from '../core/openapi-client';
+import type { operations } from '../generated/api-types';
+export declare class ServiceResource {
+    private c;
+    private orgId;
+    constructor(c: AmigoFetch, orgId: string);
+    /**
+     * Get services
+     * @param headers - The headers
+     * @returns The services
+     */
+    getServices(queryParams?: operations['get-services']['parameters']['query'], headers?: operations['get-services']['parameters']['header']): Promise<{
+        services: import("..").components["schemas"]["ServiceInstance"][];
+        has_more: boolean;
+        continuation_token: number | null;
+        filter_values: import("..").components["schemas"]["service__get_services__Response__FilterValues"] | null;
+    }>;
+}

package/dist/types/resources/user.d.ts

@@ -0,0 +1,18 @@
+import type { AmigoFetch } from '../core/openapi-client';
+import type { components, operations } from '../generated/api-types';
+export declare class UserResource {
+    private c;
+    private orgId;
+    constructor(c: AmigoFetch, orgId: string);
+    getUsers(queryParams?: operations['get-users']['parameters']['query'], headers?: operations['get-users']['parameters']['header']): Promise<{
+        users: components["schemas"]["UserInstance"][];
+        has_more: boolean;
+        continuation_token: number | null;
+    }>;
+    createUser(body: components['schemas']['user__create_invited_user__Request'], headers?: operations['create-invited-user']['parameters']['header']): Promise<{
+        user_id: string;
+        verify_link: string | null;
+    }>;
+    deleteUser(userId: string, headers?: operations['delete-user']['parameters']['header']): Promise<void>;
+    updateUser(userId: string, body: components['schemas']['user__update_user_info__Request'], headers?: operations['update-user-info']['parameters']['header']): Promise<void>;
+}

package/package.json

@@ -0,0 +1,64 @@
+{
+  "name": "@amigo-ai/sdk",
+  "version": "0.1.1",
+  "description": "Amigo TypeScript SDK",
+  "publishConfig": {
+    "access": "public"
+  },
+  "main": "./dist/index.js",
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "gen-types": "node scripts/gen.mjs",
+    "test": "vitest run --project unit",
+    "test:integration": "vitest run --project integration",
+    "test:watch": "vitest",
+    "test:coverage": "vitest run --coverage --project unit",
+    "build": "node scripts/gen.mjs && node scripts/build.mjs && tsc --project tsconfig.build.json",
+    "dev": "node scripts/gen.mjs && node scripts/build.mjs --watch",
+    "format": "prettier --check .",
+    "format:write": "prettier --write .",
+    "lint": "eslint 'src/**/*.{ts,tsx}' --max-warnings 0",
+    "lint:fix": "eslint 'src/**/*.{ts,tsx}' --fix",
+    "pack:local": "npm run build && rm -rf artifacts && mkdir -p artifacts && TARBALL=$(npm pack) && mv \"$TARBALL\" artifacts/ && echo Packed: artifacts/$TARBALL"
+  },
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/types/index.d.ts"
+    },
+    "./package.json": "./package.json"
+  },
+  "type": "module",
+  "sideEffects": false,
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/amigo-ai/amigo-typescript-sdk.git"
+  },
+  "author": "Amigo AI",
+  "license": "MIT",
+  "bugs": {
+    "url": "https://github.com/amigo-ai/amigo-typescript-sdk/issues"
+  },
+  "homepage": "https://github.com/amigo-ai/amigo-typescript-sdk#readme",
+  "devDependencies": {
+    "@types/node": "^24.2.0",
+    "@typescript-eslint/eslint-plugin": "^8.39.0",
+    "@typescript-eslint/parser": "^8.39.0",
+    "@vitest/coverage-v8": "^3.2.4",
+    "dotenv": "^17.2.1",
+    "esbuild": "^0.25.8",
+    "eslint": "^9.32.0",
+    "eslint-config-prettier": "^10.1.8",
+    "globals": "^16.3.0",
+    "msw": "^2.10.4",
+    "openapi-typescript": "^7.8.0",
+    "prettier": "^3.6.2",
+    "typescript": "^5.9.2",
+    "vitest": "^3.2.4"
+  },
+  "dependencies": {
+    "openapi-fetch": "^0.14.0"
+  }
+}