parlant-client 0.5.0

package/README.md

@@ -0,0 +1,2 @@
+# Parlant Client (Typescript)
+

package/package.json

@@ -0,0 +1,31 @@
+{
+  "name": "parlant-client",
+  "version": "0.5.0",
+  "main": "src/index.js",
+  "types": "src/index.d.ts",
+  "files": [
+    "src",
+    "README.md"
+  ],
+  "scripts": {
+    "test": "jest --detectOpenHandles"
+  },
+  "keywords": [],
+  "author": "yam@emcie.co",
+  "license": "MIT",
+  "description": "",
+  "devDependencies": {
+    "@types/jest": "^29.5.14",
+    "@types/qs": "^6.9.17",
+    "@types/readable-stream": "^4.0.18",
+    "jest": "^29.7.0",
+    "readable-stream": "^4.5.2",
+    "ts-jest": "^29.2.5",
+    "typescript": "^5.6.3"
+  },
+  "dependencies": {
+    "qs": "^6.13.1",
+    "url-join": "4.0.1",
+    "node-fetch": "^3.3.2"
+  }
+}

package/src/Client.d.ts

@@ -0,0 +1,55 @@
+/**
+ * This file was auto-generated by Fern from our API Definition.
+ */
+import * as core from "./core";
+import { Agents } from "./api/resources/agents/client/Client";
+import { Guidelines } from "./api/resources/guidelines/client/Client";
+import { Glossary } from "./api/resources/glossary/client/Client";
+import { ContextVariables } from "./api/resources/contextVariables/client/Client";
+import { Sessions } from "./api/resources/sessions/client/Client";
+import { Evaluations } from "./api/resources/evaluations/client/Client";
+import { Services } from "./api/resources/services/client/Client";
+import { Tags } from "./api/resources/tags/client/Client";
+import { Customers } from "./api/resources/customers/client/Client";
+export declare namespace ParlantClient {
+    interface Options {
+        environment: core.Supplier<string>;
+    }
+    interface RequestOptions {
+        /** The maximum time to wait for a response in seconds. */
+        timeoutInSeconds?: number;
+        /** The number of times to retry the request. Defaults to 2. */
+        maxRetries?: number;
+        /** A hook to abort the request. */
+        abortSignal?: AbortSignal;
+    }
+}
+export declare class ParlantClient {
+    protected readonly _options: ParlantClient.Options;
+    constructor(_options: ParlantClient.Options);
+    /**
+     * @param {ParlantClient.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @example
+     *     await client.rootGet()
+     */
+    rootGet(requestOptions?: ParlantClient.RequestOptions): Promise<unknown>;
+    protected _agents: Agents | undefined;
+    get agents(): Agents;
+    protected _guidelines: Guidelines | undefined;
+    get guidelines(): Guidelines;
+    protected _glossary: Glossary | undefined;
+    get glossary(): Glossary;
+    protected _contextVariables: ContextVariables | undefined;
+    get contextVariables(): ContextVariables;
+    protected _sessions: Sessions | undefined;
+    get sessions(): Sessions;
+    protected _evaluations: Evaluations | undefined;
+    get evaluations(): Evaluations;
+    protected _services: Services | undefined;
+    get services(): Services;
+    protected _tags: Tags | undefined;
+    get tags(): Tags;
+    protected _customers: Customers | undefined;
+    get customers(): Customers;
+}

package/src/Client.js

@@ -0,0 +1,137 @@
+"use strict";
+/**
+ * This file was auto-generated by Fern from our API Definition.
+ */
+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 __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || function (mod) {
+    if (mod && mod.__esModule) return mod;
+    var result = {};
+    if (mod != null) for (var k in mod) if (k !== "default" && Object.prototype.hasOwnProperty.call(mod, k)) __createBinding(result, mod, k);
+    __setModuleDefault(result, mod);
+    return result;
+};
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ParlantClient = void 0;
+const core = __importStar(require("./core"));
+const errors = __importStar(require("./errors/index"));
+const Client_1 = require("./api/resources/agents/client/Client");
+const Client_2 = require("./api/resources/guidelines/client/Client");
+const Client_3 = require("./api/resources/glossary/client/Client");
+const Client_4 = require("./api/resources/contextVariables/client/Client");
+const Client_5 = require("./api/resources/sessions/client/Client");
+const Client_6 = require("./api/resources/evaluations/client/Client");
+const Client_7 = require("./api/resources/services/client/Client");
+const Client_8 = require("./api/resources/tags/client/Client");
+const Client_9 = require("./api/resources/customers/client/Client");
+class ParlantClient {
+    constructor(_options) {
+        this._options = _options;
+    }
+    /**
+     * @param {ParlantClient.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @example
+     *     await client.rootGet()
+     */
+    rootGet(requestOptions) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const _response = yield core.fetcher({
+                url: yield core.Supplier.get(this._options.environment),
+                method: "GET",
+                headers: {
+                    "X-Fern-Language": "JavaScript",
+                    "X-Fern-Runtime": core.RUNTIME.type,
+                    "X-Fern-Runtime-Version": core.RUNTIME.version,
+                },
+                contentType: "application/json",
+                requestType: "json",
+                timeoutMs: (requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.timeoutInSeconds) != null ? requestOptions.timeoutInSeconds * 1000 : 60000,
+                maxRetries: requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.maxRetries,
+                abortSignal: requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.abortSignal,
+            });
+            if (_response.ok) {
+                return _response.body;
+            }
+            if (_response.error.reason === "status-code") {
+                throw new errors.ParlantError({
+                    statusCode: _response.error.statusCode,
+                    body: _response.error.body,
+                });
+            }
+            switch (_response.error.reason) {
+                case "non-json":
+                    throw new errors.ParlantError({
+                        statusCode: _response.error.statusCode,
+                        body: _response.error.rawBody,
+                    });
+                case "timeout":
+                    throw new errors.ParlantTimeoutError();
+                case "unknown":
+                    throw new errors.ParlantError({
+                        message: _response.error.errorMessage,
+                    });
+            }
+        });
+    }
+    get agents() {
+        var _a;
+        return ((_a = this._agents) !== null && _a !== void 0 ? _a : (this._agents = new Client_1.Agents(this._options)));
+    }
+    get guidelines() {
+        var _a;
+        return ((_a = this._guidelines) !== null && _a !== void 0 ? _a : (this._guidelines = new Client_2.Guidelines(this._options)));
+    }
+    get glossary() {
+        var _a;
+        return ((_a = this._glossary) !== null && _a !== void 0 ? _a : (this._glossary = new Client_3.Glossary(this._options)));
+    }
+    get contextVariables() {
+        var _a;
+        return ((_a = this._contextVariables) !== null && _a !== void 0 ? _a : (this._contextVariables = new Client_4.ContextVariables(this._options)));
+    }
+    get sessions() {
+        var _a;
+        return ((_a = this._sessions) !== null && _a !== void 0 ? _a : (this._sessions = new Client_5.Sessions(this._options)));
+    }
+    get evaluations() {
+        var _a;
+        return ((_a = this._evaluations) !== null && _a !== void 0 ? _a : (this._evaluations = new Client_6.Evaluations(this._options)));
+    }
+    get services() {
+        var _a;
+        return ((_a = this._services) !== null && _a !== void 0 ? _a : (this._services = new Client_7.Services(this._options)));
+    }
+    get tags() {
+        var _a;
+        return ((_a = this._tags) !== null && _a !== void 0 ? _a : (this._tags = new Client_8.Tags(this._options)));
+    }
+    get customers() {
+        var _a;
+        return ((_a = this._customers) !== null && _a !== void 0 ? _a : (this._customers = new Client_9.Customers(this._options)));
+    }
+}
+exports.ParlantClient = ParlantClient;

package/src/api/errors/UnprocessableEntityError.d.ts

@@ -0,0 +1,8 @@
+/**
+ * This file was auto-generated by Fern from our API Definition.
+ */
+import * as errors from "../../errors/index";
+import * as Parlant from "../index";
+export declare class UnprocessableEntityError extends errors.ParlantError {
+    constructor(body: Parlant.HttpValidationError);
+}

package/src/api/errors/UnprocessableEntityError.js

@@ -0,0 +1,41 @@
+"use strict";
+/**
+ * This file was auto-generated by Fern from our API Definition.
+ */
+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 __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || function (mod) {
+    if (mod && mod.__esModule) return mod;
+    var result = {};
+    if (mod != null) for (var k in mod) if (k !== "default" && Object.prototype.hasOwnProperty.call(mod, k)) __createBinding(result, mod, k);
+    __setModuleDefault(result, mod);
+    return result;
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.UnprocessableEntityError = void 0;
+const errors = __importStar(require("../../errors/index"));
+class UnprocessableEntityError extends errors.ParlantError {
+    constructor(body) {
+        super({
+            message: "UnprocessableEntityError",
+            statusCode: 422,
+            body: body,
+        });
+        Object.setPrototypeOf(this, UnprocessableEntityError.prototype);
+    }
+}
+exports.UnprocessableEntityError = UnprocessableEntityError;

package/src/api/errors/index.d.ts

@@ -0,0 +1 @@
+export * from "./UnprocessableEntityError";

package/src/api/errors/index.js

@@ -0,0 +1,17 @@
+"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 });
+__exportStar(require("./UnprocessableEntityError"), exports);

package/src/api/index.d.ts

@@ -0,0 +1,3 @@
+export * from "./types";
+export * from "./errors";
+export * from "./resources";

package/src/api/index.js

@@ -0,0 +1,19 @@
+"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 });
+__exportStar(require("./types"), exports);
+__exportStar(require("./errors"), exports);
+__exportStar(require("./resources"), exports);

package/src/api/resources/agents/client/Client.d.ts

@@ -0,0 +1,72 @@
+/**
+ * This file was auto-generated by Fern from our API Definition.
+ */
+import * as core from "../../../../core";
+import * as Parlant from "../../../index";
+export declare namespace Agents {
+    interface Options {
+        environment: core.Supplier<string>;
+    }
+    interface RequestOptions {
+        /** The maximum time to wait for a response in seconds. */
+        timeoutInSeconds?: number;
+        /** The number of times to retry the request. Defaults to 2. */
+        maxRetries?: number;
+        /** A hook to abort the request. */
+        abortSignal?: AbortSignal;
+    }
+}
+export declare class Agents {
+    protected readonly _options: Agents.Options;
+    constructor(_options: Agents.Options);
+    /**
+     * @param {Agents.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @example
+     *     await client.agents.list()
+     */
+    list(requestOptions?: Agents.RequestOptions): Promise<Parlant.Agent[]>;
+    /**
+     * @param {Parlant.AgentCreationParams} request
+     * @param {Agents.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link Parlant.UnprocessableEntityError}
+     *
+     * @example
+     *     await client.agents.create({
+     *         name: "name"
+     *     })
+     */
+    create(request: Parlant.AgentCreationParams, requestOptions?: Agents.RequestOptions): Promise<Parlant.Agent>;
+    /**
+     * @param {string} agentId
+     * @param {Agents.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link Parlant.UnprocessableEntityError}
+     *
+     * @example
+     *     await client.agents.retrieve("agent_id")
+     */
+    retrieve(agentId: string, requestOptions?: Agents.RequestOptions): Promise<Parlant.Agent>;
+    /**
+     * @param {string} agentId
+     * @param {Agents.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link Parlant.UnprocessableEntityError}
+     *
+     * @example
+     *     await client.agents.delete("agent_id")
+     */
+    delete(agentId: string, requestOptions?: Agents.RequestOptions): Promise<void>;
+    /**
+     * @param {string} agentId
+     * @param {Parlant.AgentUpdateParams} request
+     * @param {Agents.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link Parlant.UnprocessableEntityError}
+     *
+     * @example
+     *     await client.agents.update("agent_id")
+     */
+    update(agentId: string, request?: Parlant.AgentUpdateParams, requestOptions?: Agents.RequestOptions): Promise<Parlant.Agent>;
+}