samuel-integrations-sdk 0.0.1

package/README.md

@@ -0,0 +1,69 @@
+# Samuel Agent Types SDK
+
+A TypeScript SDK for Agent Builder types, providing type-safe interfaces and utilities.
+
+## Features
+
+- 🎯 **TypeScript First**: Built with TypeScript for excellent developer experience
+- 🔧 **Modern Tooling**: ESLint and Prettier for code quality and formatting
+- 📦 **Ready to Publish**: Configured for npm package distribution
+- 🚀 **Zero Config**: Minimal setup required
+
+## Installation
+
+```bash
+npm install samuel-agent-types-sdk
+# or
+yarn add samuel-agent-types-sdk
+```
+
+## Development
+
+### Prerequisites
+
+- Node.js (v16 or higher)
+- Yarn
+
+### Setup
+
+1. Clone the repository
+2. Install dependencies:
+   ```bash
+   yarn install
+   ```
+
+### Available Scripts
+
+- `yarn build` - Build the TypeScript code
+- `yarn dev` - Watch mode for development
+- `yarn lint` - Run ESLint
+- `yarn lint:fix` - Fix ESLint issues automatically
+- `yarn format` - Format code with Prettier
+- `yarn format:check` - Check code formatting
+- `yarn clean` - Clean build artifacts
+
+### Project Structure
+
+```
+samuel-agent-types-sdk/
+├── src/
+│   └── index.ts          # Main SDK entry point
+├── dist/                 # Compiled output (generated)
+├── eslint.config.js      # ESLint configuration
+├── .prettierrc          # Prettier configuration
+├── tsconfig.json        # TypeScript configuration
+├── package.json         # Package configuration
+└── README.md           # This file
+```
+
+## Contributing
+
+1. Fork the repository
+2. Create a feature branch
+3. Make your changes
+4. Run linting and formatting: `yarn lint && yarn format`
+5. Submit a pull request
+
+## License
+
+MIT License - see LICENSE file for details.

package/dist/generated-api.d.ts

@@ -0,0 +1,76 @@
+/**
+ * Role of the message sender
+ */
+export type GenerateBodyMessagesItemRole = typeof GenerateBodyMessagesItemRole[keyof typeof GenerateBodyMessagesItemRole];
+export declare const GenerateBodyMessagesItemRole: {
+    readonly user: "user";
+    readonly assistant: "assistant";
+    readonly system: "system";
+};
+export type GenerateBodyMessagesItem = {
+    /** Role of the message sender */
+    role: GenerateBodyMessagesItemRole;
+    /** Content of the message */
+    content: string;
+};
+/**
+ * LLM provider to use
+ */
+export type GenerateBodyProvider = typeof GenerateBodyProvider[keyof typeof GenerateBodyProvider];
+export declare const GenerateBodyProvider: {
+    readonly anthropic: "anthropic";
+    readonly openai: "openai";
+    readonly gemini: "gemini";
+};
+export type GenerateBodyOptions = {
+    /**
+     * Sampling temperature (0-2)
+     * @minimum 0
+     * @maximum 2
+     */
+    temperature?: number;
+    /**
+     * Maximum tokens to generate
+     * @minimum 0
+     * @exclusiveMinimum
+     */
+    maxTokens?: number;
+    /**
+     * Top-p sampling parameter
+     * @minimum 0
+     * @maximum 1
+     */
+    topP?: number;
+};
+export type GenerateBody = {
+    /**
+     * Array of chat messages
+     * @minItems 1
+     */
+    messages: GenerateBodyMessagesItem[];
+    /** LLM provider to use */
+    provider: GenerateBodyProvider;
+    /** Specific model to use (defaults to provider default) */
+    model?: string;
+    options?: GenerateBodyOptions;
+    /** Custom API key (uses environment variable if not provided) */
+    apiKey?: string;
+};
+export type Generate200Data = {
+    /** Generated text content */
+    content: string;
+    /** Provider used */
+    provider: string;
+    /** Model used */
+    model: string;
+};
+export type Generate200 = {
+    /** Status message */
+    message: string;
+    data: Generate200Data;
+};
+export declare const getIntegrationsAPI: () => {
+    generate: (generateBody: GenerateBody) => Promise<Generate200>;
+};
+export type GenerateResult = NonNullable<Awaited<ReturnType<ReturnType<typeof getIntegrationsAPI>['generate']>>>;
+//# sourceMappingURL=generated-api.d.ts.map

package/dist/generated-api.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"generated-api.d.ts","sourceRoot":"","sources":["../src/generated-api.ts"],"names":[],"mappings":"AAQA;;GAEG;AACH,MAAM,MAAM,4BAA4B,GAAG,OAAO,4BAA4B,CAAC,MAAM,OAAO,4BAA4B,CAAC,CAAC;AAI1H,eAAO,MAAM,4BAA4B;;;;CAI/B,CAAC;AAEX,MAAM,MAAM,wBAAwB,GAAG;IACrC,iCAAiC;IACjC,IAAI,EAAE,4BAA4B,CAAC;IACnC,6BAA6B;IAC7B,OAAO,EAAE,MAAM,CAAC;CACjB,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,oBAAoB,GAAG,OAAO,oBAAoB,CAAC,MAAM,OAAO,oBAAoB,CAAC,CAAC;AAIlG,eAAO,MAAM,oBAAoB;;;;CAIvB,CAAC;AAEX,MAAM,MAAM,mBAAmB,GAAG;IAChC;;;;OAIG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB;;;;OAIG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;;;;OAIG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;CACf,CAAC;AAEF,MAAM,MAAM,YAAY,GAAG;IACzB;;;OAGG;IACH,QAAQ,EAAE,wBAAwB,EAAE,CAAC;IACrC,0BAA0B;IAC1B,QAAQ,EAAE,oBAAoB,CAAC;IAC/B,2DAA2D;IAC3D,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,mBAAmB,CAAC;IAC9B,iEAAiE;IACjE,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB,CAAC;AAEF,MAAM,MAAM,eAAe,GAAG;IAC5B,6BAA6B;IAC7B,OAAO,EAAE,MAAM,CAAC;IAChB,oBAAoB;IACpB,QAAQ,EAAE,MAAM,CAAC;IACjB,iBAAiB;IACjB,KAAK,EAAE,MAAM,CAAC;CACf,CAAC;AAEF,MAAM,MAAM,WAAW,GAAG;IACxB,qBAAqB;IACrB,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,eAAe,CAAC;CACvB,CAAC;AAEF,eAAO,MAAM,kBAAkB;6BAKb,YAAY;CAUZ,CAAC;AACnB,MAAM,MAAM,cAAc,GAAG,WAAW,CAAC,OAAO,CAAC,UAAU,CAAC,UAAU,CAAC,OAAO,kBAAkB,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,CAAA"}

package/dist/generated-api.js

@@ -0,0 +1,37 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getIntegrationsAPI = exports.GenerateBodyProvider = exports.GenerateBodyMessagesItemRole = void 0;
+/**
+ * Generated by orval v7.21.0 🍺
+ * Do not edit manually.
+ * Integrations API
+ * API for integrating with external services like LLMs, Stripe, etc.
+ * OpenAPI spec version: 1.0.0
+ */
+const http_client_1 = require("./http-client");
+// eslint-disable-next-line @typescript-eslint/no-redeclare
+exports.GenerateBodyMessagesItemRole = {
+    user: 'user',
+    assistant: 'assistant',
+    system: 'system',
+};
+// eslint-disable-next-line @typescript-eslint/no-redeclare
+exports.GenerateBodyProvider = {
+    anthropic: 'anthropic',
+    openai: 'openai',
+    gemini: 'gemini',
+};
+const getIntegrationsAPI = () => {
+    /**
+     * @summary Chat with LLM
+     */
+    const generate = (generateBody) => {
+        return (0, http_client_1.customAxios)({ url: `/llm/generate`, method: 'POST',
+            headers: { 'Content-Type': 'application/json', },
+            data: generateBody
+        });
+    };
+    return { generate };
+};
+exports.getIntegrationsAPI = getIntegrationsAPI;
+//# sourceMappingURL=generated-api.js.map

package/dist/generated-api.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"generated-api.js","sourceRoot":"","sources":["../src/generated-api.ts"],"names":[],"mappings":";;;AAAA;;;;;;GAMG;AACH,+CAA4C;AAO5C,2DAA2D;AAC9C,QAAA,4BAA4B,GAAG;IAC1C,IAAI,EAAE,MAAM;IACZ,SAAS,EAAE,WAAW;IACtB,MAAM,EAAE,QAAQ;CACR,CAAC;AAeX,2DAA2D;AAC9C,QAAA,oBAAoB,GAAG;IAClC,SAAS,EAAE,WAAW;IACtB,MAAM,EAAE,QAAQ;IAChB,MAAM,EAAE,QAAQ;CACR,CAAC;AAqDJ,MAAM,kBAAkB,GAAG,GAAG,EAAE;IACvC;;OAEG;IACH,MAAM,QAAQ,GAAG,CACb,YAA0B,EAC3B,EAAE;QACC,OAAO,IAAA,yBAAW,EAClB,EAAC,GAAG,EAAE,eAAe,EAAE,MAAM,EAAE,MAAM;YACrC,OAAO,EAAE,EAAC,cAAc,EAAE,kBAAkB,GAAG;YAC/C,IAAI,EAAE,YAAY;SACnB,CACE,CAAC;IACJ,CAAC,CAAA;IAEL,OAAO,EAAC,QAAQ,EAAC,CAAA;AAAA,CAAC,CAAC;AAfN,QAAA,kBAAkB,sBAeZ"}

package/dist/http-client.d.ts

@@ -0,0 +1,10 @@
+import { AxiosRequestConfig } from 'axios';
+import { AsyncLocalStorage } from 'async_hooks';
+interface SDKContext {
+    accessKey?: string;
+    baseUrl?: string;
+}
+export declare const sdkContext: AsyncLocalStorage<SDKContext>;
+export declare const customAxios: <T>(config: AxiosRequestConfig) => Promise<T>;
+export {};
+//# sourceMappingURL=http-client.d.ts.map

package/dist/http-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"http-client.d.ts","sourceRoot":"","sources":["../src/http-client.ts"],"names":[],"mappings":"AAAA,OAAc,EAAE,kBAAkB,EAAE,MAAM,OAAO,CAAC;AAClD,OAAO,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAEhD,UAAU,UAAU;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,eAAO,MAAM,UAAU,+BAAsC,CAAC;AA2B9D,eAAO,MAAM,WAAW,GAAU,CAAC,EAAE,QAAQ,kBAAkB,KAAG,OAAO,CAAC,CAAC,CAG1E,CAAC"}

package/dist/http-client.js

@@ -0,0 +1,33 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.customAxios = exports.sdkContext = void 0;
+const axios_1 = __importDefault(require("axios"));
+const async_hooks_1 = require("async_hooks");
+exports.sdkContext = new async_hooks_1.AsyncLocalStorage();
+const axiosInstance = axios_1.default.create();
+axiosInstance.interceptors.request.use((config) => {
+    const context = exports.sdkContext.getStore();
+    const baseURL = context?.baseUrl || process.env["INTEGRATION_BASE_URL"];
+    if (baseURL) {
+        config.baseURL = baseURL;
+    }
+    const accessKey = context?.accessKey || process.env["PROJECT_ACCESS_KEY"];
+    const tenantId = process.env["TENANT_ID"];
+    if (accessKey) {
+        config.headers = config.headers || {};
+        config.headers['x-project-access-key'] = accessKey;
+        if (tenantId) {
+            config.headers['x-tenant-id'] = tenantId;
+        }
+    }
+    return config;
+});
+const customAxios = async (config) => {
+    const { data } = await axiosInstance(config);
+    return data;
+};
+exports.customAxios = customAxios;
+//# sourceMappingURL=http-client.js.map

package/dist/http-client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"http-client.js","sourceRoot":"","sources":["../src/http-client.ts"],"names":[],"mappings":";;;;;;AAAA,kDAAkD;AAClD,6CAAgD;AAOnC,QAAA,UAAU,GAAG,IAAI,+BAAiB,EAAc,CAAC;AAE9D,MAAM,aAAa,GAAG,eAAK,CAAC,MAAM,EAAE,CAAC;AAErC,aAAa,CAAC,YAAY,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE;IAChD,MAAM,OAAO,GAAG,kBAAU,CAAC,QAAQ,EAAE,CAAC;IAEtC,MAAM,OAAO,GAAG,OAAO,EAAE,OAAO,IAAI,OAAO,CAAC,GAAG,CAAC,sBAAsB,CAAC,CAAC;IACxE,IAAI,OAAO,EAAE,CAAC;QACZ,MAAM,CAAC,OAAO,GAAG,OAAO,CAAC;IAC3B,CAAC;IAED,MAAM,SAAS,GAAG,OAAO,EAAE,SAAS,IAAI,OAAO,CAAC,GAAG,CAAC,oBAAoB,CAAC,CAAC;IAC1E,MAAM,QAAQ,GAAG,OAAO,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC;IAE1C,IAAI,SAAS,EAAE,CAAC;QACd,MAAM,CAAC,OAAO,GAAG,MAAM,CAAC,OAAO,IAAI,EAAE,CAAC;QACtC,MAAM,CAAC,OAAO,CAAC,sBAAsB,CAAC,GAAG,SAAS,CAAC;QACnD,IAAI,QAAQ,EAAE,CAAC;YACb,MAAM,CAAC,OAAO,CAAC,aAAa,CAAC,GAAG,QAAQ,CAAC;QAC3C,CAAC;IACH,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC,CAAC,CAAC;AAGI,MAAM,WAAW,GAAG,KAAK,EAAK,MAA0B,EAAc,EAAE;IAC7E,MAAM,EAAE,IAAI,EAAE,GAAG,MAAM,aAAa,CAAC,MAAM,CAAC,CAAC;IAC7C,OAAO,IAAI,CAAC;AACd,CAAC,CAAC;AAHW,QAAA,WAAW,eAGtB"}

package/dist/index.d.ts

@@ -0,0 +1,28 @@
+/**
+ * UPTIQ Integrations SDK
+ *
+ * Auto-generated from OpenAPI specification.
+ * Do not edit this file manually - it will be overwritten on next generation.
+ */
+/**
+ * Llm integration module
+ */
+export declare class Llm {
+    private config;
+    private api;
+    constructor(options?: {
+        accessKey?: string;
+        baseUrl?: string;
+    });
+    private withContext;
+    generate: (...args: Parameters<typeof this.api.generate>) => Promise<import("./generated-api").Generate200>;
+}
+/**
+ * Default llm instance - ready to use with env vars
+ * @example
+ * import { llm } from 'uptiq-integration';
+ * await llm.generate({ ... });
+ */
+export declare const llm: Llm;
+export * from './generated-api';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAGA;;;;;GAKG;AAEH;;GAEG;AACH,qBAAa,GAAG;IACd,OAAO,CAAC,MAAM,CAA2C;IACzD,OAAO,CAAC,GAAG,CAAwC;gBAEvC,OAAO,CAAC,EAAE;QACpB,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,OAAO,CAAC,EAAE,MAAM,CAAC;KAClB;IAQD,OAAO,CAAC,WAAW;IAInB,QAAQ,GAAI,GAAG,MAAM,UAAU,CAAC,OAAO,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,oDACJ;CACtD;AAED;;;;;GAKG;AACH,eAAO,MAAM,GAAG,KAAY,CAAC;AAG7B,cAAc,iBAAiB,CAAC"}

package/dist/index.js

@@ -0,0 +1,52 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.llm = exports.Llm = void 0;
+const generated_api_1 = require("./generated-api");
+const http_client_1 = require("./http-client");
+/**
+ * UPTIQ Integrations SDK
+ *
+ * Auto-generated from OpenAPI specification.
+ * Do not edit this file manually - it will be overwritten on next generation.
+ */
+/**
+ * Llm integration module
+ */
+class Llm {
+    constructor(options) {
+        this.generate = (...args) => this.withContext(() => this.api.generate(...args));
+        // Store config for this instance (uses env vars if not provided)
+        this.config = options || {};
+        // Get the generated API methods
+        this.api = (0, generated_api_1.getIntegrationsAPI)();
+    }
+    // Helper to wrap API calls with context
+    withContext(fn) {
+        return http_client_1.sdkContext.run(this.config, fn);
+    }
+}
+exports.Llm = Llm;
+/**
+ * Default llm instance - ready to use with env vars
+ * @example
+ * import { llm } from 'uptiq-integration';
+ * await llm.generate({ ... });
+ */
+exports.llm = new Llm();
+// Re-export all types from generated API
+__exportStar(require("./generated-api"), exports);
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;AAAA,mDAAqD;AACrD,+CAA2C;AAE3C;;;;;GAKG;AAEH;;GAEG;AACH,MAAa,GAAG;IAId,YAAY,OAGX;QAYD,aAAQ,GAAG,CAAC,GAAG,IAA0C,EAAE,EAAE,CAC3D,IAAI,CAAC,WAAW,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC;QAZnD,iEAAiE;QACjE,IAAI,CAAC,MAAM,GAAG,OAAO,IAAI,EAAE,CAAC;QAC5B,gCAAgC;QAChC,IAAI,CAAC,GAAG,GAAG,IAAA,kCAAkB,GAAE,CAAC;IAClC,CAAC;IAED,wCAAwC;IAChC,WAAW,CAAI,EAAoB;QACzC,OAAO,wBAAU,CAAC,GAAG,CAAC,IAAI,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;IACzC,CAAC;CAIF;AArBD,kBAqBC;AAED;;;;;GAKG;AACU,QAAA,GAAG,GAAG,IAAI,GAAG,EAAE,CAAC;AAE7B,yCAAyC;AACzC,kDAAgC"}

package/package.json

@@ -0,0 +1,51 @@
+{
+  "name": "samuel-integrations-sdk",
+  "version": "0.0.1",
+  "description": "SDK for UPTIQ integrations",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "download:swagger": "bash scripts/download-swagger.sh",
+    "generate:api": "orval",
+    "generate:wrapper": "node scripts/generate-wrapper.ts",
+    "generate": "yarn download:swagger && yarn generate:api && yarn generate:wrapper",
+    "build": "tsc",
+    "prepublishOnly": "yarn generate && yarn build",
+    "dev": "tsc --watch",
+    "lint": "eslint src/**/*.ts",
+    "lint:fix": "eslint src/**/*.ts --fix",
+    "format": "prettier --write src/**/*.ts",
+    "format:check": "prettier --check src/**/*.ts",
+    "clean": "rm -rf dist",
+    "prebuild": "yarn clean"
+  },
+  "keywords": [
+    "samuel",
+    "integrations",
+    "sdk"
+  ],
+  "author": "UPTIQ",
+  "license": "MIT",
+  "devDependencies": {
+    "orval": "^7.1.0",
+    "@types/node": "^24.0.3",
+    "@typescript-eslint/eslint-plugin": "^8.35.0",
+    "@typescript-eslint/parser": "^8.35.0",
+    "eslint": "^9.29.0",
+    "eslint-config-prettier": "^10.1.5",
+    "eslint-plugin-prettier": "^5.5.0",
+    "prettier": "^3.6.0",
+    "typescript": "^5.8.3"
+  },
+  "dependencies": {
+    "axios": "^1.6.0",
+    "zod": "^4.0.10"
+  },
+  "publishConfig": {
+    "registry": "https://registry.npmjs.org/",
+    "access": "public"
+  }
+}