mavenagi 0.0.0-alpha.2

package/core/schemas/utils/partition.js

@@ -0,0 +1,12 @@
+export function partition(items, predicate) {
+    const trueItems = [], falseItems = [];
+    for (const item of items) {
+        if (predicate(item)) {
+            trueItems.push(item);
+        }
+        else {
+            falseItems.push(item);
+        }
+    }
+    return [trueItems, falseItems];
+}

package/core/streaming-fetcher/Stream.d.ts

@@ -0,0 +1,48 @@
+/// <reference types="node" />
+import { Readable } from "stream";
+export declare namespace Stream {
+    interface Args {
+        /**
+         * The HTTP response stream to read from.
+         */
+        stream: Readable | ReadableStream;
+        /**
+         * The event shape to use for parsing the stream data.
+         */
+        eventShape: JsonEvent | SseEvent;
+        /**
+         * An abort signal to stop the stream.
+         */
+        signal?: AbortSignal;
+    }
+    interface JsonEvent {
+        type: "json";
+        messageTerminator: string;
+    }
+    interface SseEvent {
+        type: "sse";
+        streamTerminator?: string;
+    }
+}
+export declare class Stream<T> implements AsyncIterable<T> {
+    private stream;
+    private parse;
+    /**
+     * The prefix to use for each message. For example,
+     * for SSE, the prefix is "data: ".
+     */
+    private prefix;
+    private messageTerminator;
+    private streamTerminator;
+    private controller;
+    constructor({ stream, parse, eventShape, signal }: Stream.Args & {
+        parse: (val: unknown) => Promise<T>;
+    });
+    private iterMessages;
+    [Symbol.asyncIterator](): AsyncIterator<T, void, unknown>;
+    private decodeChunk;
+}
+/**
+ * Browser polyfill for ReadableStream
+ */
+export declare function readableStreamAsyncIterable<T>(stream: any): AsyncIterableIterator<T>;

package/core/streaming-fetcher/Stream.js

@@ -0,0 +1,165 @@
+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());
+    });
+};
+var __asyncValues = (this && this.__asyncValues) || function (o) {
+    if (!Symbol.asyncIterator) throw new TypeError("Symbol.asyncIterator is not defined.");
+    var m = o[Symbol.asyncIterator], i;
+    return m ? m.call(o) : (o = typeof __values === "function" ? __values(o) : o[Symbol.iterator](), i = {}, verb("next"), verb("throw"), verb("return"), i[Symbol.asyncIterator] = function () { return this; }, i);
+    function verb(n) { i[n] = o[n] && function (v) { return new Promise(function (resolve, reject) { v = o[n](v), settle(resolve, reject, v.done, v.value); }); }; }
+    function settle(resolve, reject, d, v) { Promise.resolve(v).then(function(v) { resolve({ value: v, done: d }); }, reject); }
+};
+var __await = (this && this.__await) || function (v) { return this instanceof __await ? (this.v = v, this) : new __await(v); }
+var __asyncGenerator = (this && this.__asyncGenerator) || function (thisArg, _arguments, generator) {
+    if (!Symbol.asyncIterator) throw new TypeError("Symbol.asyncIterator is not defined.");
+    var g = generator.apply(thisArg, _arguments || []), i, q = [];
+    return i = {}, verb("next"), verb("throw"), verb("return"), i[Symbol.asyncIterator] = function () { return this; }, i;
+    function verb(n) { if (g[n]) i[n] = function (v) { return new Promise(function (a, b) { q.push([n, v, a, b]) > 1 || resume(n, v); }); }; }
+    function resume(n, v) { try { step(g[n](v)); } catch (e) { settle(q[0][3], e); } }
+    function step(r) { r.value instanceof __await ? Promise.resolve(r.value.v).then(fulfill, reject) : settle(q[0][2], r); }
+    function fulfill(value) { resume("next", value); }
+    function reject(value) { resume("throw", value); }
+    function settle(f, v) { if (f(v), q.shift(), q.length) resume(q[0][0], q[0][1]); }
+};
+import { RUNTIME } from "../runtime";
+const DATA_PREFIX = "data:";
+export class Stream {
+    constructor({ stream, parse, eventShape, signal }) {
+        this.controller = new AbortController();
+        this.stream = stream;
+        this.parse = parse;
+        if (eventShape.type === "sse") {
+            this.prefix = DATA_PREFIX;
+            this.messageTerminator = "\n";
+            this.streamTerminator = eventShape.streamTerminator;
+        }
+        else {
+            this.messageTerminator = eventShape.messageTerminator;
+        }
+        signal === null || signal === void 0 ? void 0 : signal.addEventListener("abort", () => this.controller.abort());
+    }
+    iterMessages() {
+        return __asyncGenerator(this, arguments, function* iterMessages_1() {
+            var e_1, _a;
+            this.controller.signal;
+            const stream = readableStreamAsyncIterable(this.stream);
+            let buf = "";
+            let prefixSeen = false;
+            try {
+                for (var stream_1 = __asyncValues(stream), stream_1_1; stream_1_1 = yield __await(stream_1.next()), !stream_1_1.done;) {
+                    const chunk = stream_1_1.value;
+                    buf += this.decodeChunk(chunk);
+                    let terminatorIndex;
+                    // Parse the chunk into as many messages as possible
+                    while ((terminatorIndex = buf.indexOf(this.messageTerminator)) >= 0) {
+                        // Extract the line from the buffer
+                        let line = buf.slice(0, terminatorIndex + 1);
+                        buf = buf.slice(terminatorIndex + 1);
+                        // Skip empty lines
+                        if (line.length === 0) {
+                            continue;
+                        }
+                        // Skip the chunk until the prefix is found
+                        if (!prefixSeen && this.prefix != null) {
+                            const prefixIndex = line.indexOf(this.prefix);
+                            if (prefixIndex === -1) {
+                                continue;
+                            }
+                            prefixSeen = true;
+                            line = line.slice(prefixIndex + this.prefix.length);
+                        }
+                        // If the stream terminator is present, return
+                        if (this.streamTerminator != null && line.includes(this.streamTerminator)) {
+                            return yield __await(void 0);
+                        }
+                        // Otherwise, yield message from the prefix to the terminator
+                        const message = yield __await(this.parse(JSON.parse(line)));
+                        yield yield __await(message);
+                        prefixSeen = false;
+                    }
+                }
+            }
+            catch (e_1_1) { e_1 = { error: e_1_1 }; }
+            finally {
+                try {
+                    if (stream_1_1 && !stream_1_1.done && (_a = stream_1.return)) yield __await(_a.call(stream_1));
+                }
+                finally { if (e_1) throw e_1.error; }
+            }
+        });
+    }
+    [Symbol.asyncIterator]() {
+        return __asyncGenerator(this, arguments, function* _a() {
+            var e_2, _b;
+            try {
+                for (var _c = __asyncValues(this.iterMessages()), _d; _d = yield __await(_c.next()), !_d.done;) {
+                    const message = _d.value;
+                    yield yield __await(message);
+                }
+            }
+            catch (e_2_1) { e_2 = { error: e_2_1 }; }
+            finally {
+                try {
+                    if (_d && !_d.done && (_b = _c.return)) yield __await(_b.call(_c));
+                }
+                finally { if (e_2) throw e_2.error; }
+            }
+        });
+    }
+    decodeChunk(chunk) {
+        let decoded = "";
+        // If TextDecoder is present, use it
+        if (typeof TextDecoder !== "undefined") {
+            const decoder = new TextDecoder("utf8");
+            decoded += decoder.decode(chunk);
+        }
+        // Buffer is present in Node.js environment
+        else if (RUNTIME.type === "node" && typeof chunk != "undefined") {
+            decoded += Buffer.isBuffer(chunk) ? chunk : Buffer.from(chunk);
+        }
+        return decoded;
+    }
+}
+/**
+ * Browser polyfill for ReadableStream
+ */
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+export function readableStreamAsyncIterable(stream) {
+    if (stream[Symbol.asyncIterator]) {
+        return stream;
+    }
+    const reader = stream.getReader();
+    return {
+        next() {
+            return __awaiter(this, void 0, void 0, function* () {
+                try {
+                    const result = yield reader.read();
+                    if (result === null || result === void 0 ? void 0 : result.done) {
+                        reader.releaseLock();
+                    } // release lock when stream becomes closed
+                    return result;
+                }
+                catch (e) {
+                    reader.releaseLock(); // release lock when stream becomes errored
+                    throw e;
+                }
+            });
+        },
+        return() {
+            return __awaiter(this, void 0, void 0, function* () {
+                const cancelPromise = reader.cancel();
+                reader.releaseLock();
+                yield cancelPromise;
+                return { done: true, value: undefined };
+            });
+        },
+        [Symbol.asyncIterator]() {
+            return this;
+        },
+    };
+}

package/core/streaming-fetcher/index.d.ts

@@ -0,0 +1 @@
+export { Stream } from "./Stream";

package/core/streaming-fetcher/index.js

@@ -0,0 +1 @@
+export { Stream } from "./Stream";

package/dist/Client.d.ts

@@ -0,0 +1,30 @@
+/**
+ * This file was auto-generated by Fern from our API Definition.
+ */
+import * as environments from "./environments";
+import * as core from "./core";
+import { Conversation } from "./api/resources/conversation/client/Client";
+import { Knowledge } from "./api/resources/knowledge/client/Client";
+export declare namespace MavenAGIClient {
+    interface Options {
+        environment?: core.Supplier<environments.MavenAGIEnvironment | string>;
+        appId?: core.Supplier<string | undefined>;
+        appSecret?: core.Supplier<string | undefined>;
+        organizationId: core.Supplier<string>;
+        agentId: core.Supplier<string>;
+        fetcher?: core.FetchFunction;
+    }
+    interface RequestOptions {
+        timeoutInSeconds?: number;
+        maxRetries?: number;
+        abortSignal?: AbortSignal;
+    }
+}
+export declare class MavenAGIClient {
+    protected readonly _options: MavenAGIClient.Options;
+    constructor(_options: MavenAGIClient.Options);
+    protected _conversation: Conversation | undefined;
+    get conversation(): Conversation;
+    protected _knowledge: Knowledge | undefined;
+    get knowledge(): Knowledge;
+}

package/dist/Client.js

@@ -0,0 +1,18 @@
+/**
+ * This file was auto-generated by Fern from our API Definition.
+ */
+import { Conversation } from "./api/resources/conversation/client/Client";
+import { Knowledge } from "./api/resources/knowledge/client/Client";
+export class MavenAGIClient {
+    constructor(_options) {
+        this._options = _options;
+    }
+    get conversation() {
+        var _a;
+        return ((_a = this._conversation) !== null && _a !== void 0 ? _a : (this._conversation = new Conversation(this._options)));
+    }
+    get knowledge() {
+        var _a;
+        return ((_a = this._knowledge) !== null && _a !== void 0 ? _a : (this._knowledge = new Knowledge(this._options)));
+    }
+}

package/dist/api/index.d.ts

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

package/dist/api/index.js

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

package/dist/api/resources/commons/errors/AgentNotFoundError.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 MavenAGI from "../../../index";
+export declare class AgentNotFoundError extends errors.MavenAGIError {
+    constructor(body: MavenAGI.ErrorMessage);
+}

package/dist/api/resources/commons/errors/AgentNotFoundError.js

@@ -0,0 +1,14 @@
+/**
+ * This file was auto-generated by Fern from our API Definition.
+ */
+import * as errors from "../../../../errors/index";
+export class AgentNotFoundError extends errors.MavenAGIError {
+    constructor(body) {
+        super({
+            message: "AgentNotFoundError",
+            statusCode: 404,
+            body: body,
+        });
+        Object.setPrototypeOf(this, AgentNotFoundError.prototype);
+    }
+}

package/dist/api/resources/commons/errors/index.d.ts

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

package/dist/api/resources/commons/errors/index.js

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

package/dist/api/resources/commons/index.d.ts

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

package/dist/api/resources/commons/index.js

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

package/dist/api/resources/commons/types/ErrorMessage.d.ts

@@ -0,0 +1,6 @@
+/**
+ * This file was auto-generated by Fern from our API Definition.
+ */
+export interface ErrorMessage {
+    message?: string;
+}

package/dist/api/resources/commons/types/ErrorMessage.js

@@ -0,0 +1,4 @@
+/**
+ * This file was auto-generated by Fern from our API Definition.
+ */
+export {};

package/dist/api/resources/commons/types/User.d.ts

@@ -0,0 +1,9 @@
+/**
+ * This file was auto-generated by Fern from our API Definition.
+ */
+export interface User {
+    name?: string;
+    /** The unique ID of the user */
+    id?: Record<string, string>;
+    email?: string;
+}

package/dist/api/resources/commons/types/User.js

@@ -0,0 +1,4 @@
+/**
+ * This file was auto-generated by Fern from our API Definition.
+ */
+export {};

package/dist/api/resources/commons/types/index.d.ts

@@ -0,0 +1,2 @@
+export * from "./ErrorMessage";
+export * from "./User";

package/dist/api/resources/commons/types/index.js

@@ -0,0 +1,2 @@
+export * from "./ErrorMessage";
+export * from "./User";

package/dist/api/resources/conversation/client/Client.d.ts

@@ -0,0 +1,138 @@
+/**
+ * This file was auto-generated by Fern from our API Definition.
+ */
+import * as environments from "../../../../environments";
+import * as core from "../../../../core";
+import * as MavenAGI from "../../../index";
+export declare namespace Conversation {
+    interface Options {
+        environment?: core.Supplier<environments.MavenAGIEnvironment | string>;
+        appId?: core.Supplier<string | undefined>;
+        appSecret?: core.Supplier<string | undefined>;
+        organizationId: core.Supplier<string>;
+        agentId: core.Supplier<string>;
+        fetcher?: core.FetchFunction;
+    }
+    interface RequestOptions {
+        timeoutInSeconds?: number;
+        maxRetries?: number;
+        abortSignal?: AbortSignal;
+    }
+}
+export declare class Conversation {
+    protected readonly _options: Conversation.Options;
+    constructor(_options: Conversation.Options);
+    /**
+     * Pre-populate a new conversation with messages
+     *
+     * @param {MavenAGI.ConversationRequest} request
+     * @param {Conversation.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link MavenAGI.ConversationAlreadyExistsError}
+     * @throws {@link MavenAGI.InvalidConversationIdError}
+     * @throws {@link MavenAGI.InvalidConversationMessageIdError}
+     * @throws {@link MavenAGI.EmptyConversationError}
+     * @throws {@link MavenAGI.AgentNotFoundError}
+     *
+     * @example
+     *     await mavenAgi.conversation.initialize({
+     *         messages: [{}],
+     *         id: "string",
+     *         context: {}
+     *     })
+     */
+    initialize(request: MavenAGI.ConversationRequest, requestOptions?: Conversation.RequestOptions): Promise<MavenAGI.ConversationResponse>;
+    /**
+     * Get a conversation
+     *
+     * @param {string} conversationId - The ID of a conversation to get
+     * @param {Conversation.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link MavenAGI.ConversationNotFoundError}
+     * @throws {@link MavenAGI.AgentNotFoundError}
+     *
+     * @example
+     *     await mavenAgi.conversation.get("string")
+     */
+    get(conversationId: string, requestOptions?: Conversation.RequestOptions): Promise<MavenAGI.ConversationResponse>;
+    /**
+     * Append messages to an existing conversation. The conversation must be initialized first. If a message with the same id already exists, it will be ignored.
+     *
+     * @param {string} conversationId - The ID of the conversation to append messages to
+     * @param {MavenAGI.ConversationMessageRequest[]} request
+     * @param {Conversation.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link MavenAGI.ConversationNotFoundError}
+     * @throws {@link MavenAGI.InvalidConversationMessageIdError}
+     * @throws {@link MavenAGI.AgentNotFoundError}
+     *
+     * @example
+     *     await mavenAgi.conversation.appendNewMessages("string", [{
+     *             text: "string",
+     *             userMessageType: MavenAGI.UserConversationMessageType.User,
+     *             id: "string",
+     *             context: {}
+     *         }])
+     */
+    appendNewMessages(conversationId: string, request: MavenAGI.ConversationMessageRequest[], requestOptions?: Conversation.RequestOptions): Promise<MavenAGI.ConversationResponse>;
+    /**
+     * Ask a question in a conversation
+     *
+     * @param {string} conversationId - The ID of a new or existing conversation to use as context for the question
+     * @param {MavenAGI.AskRequest} request
+     * @param {Conversation.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link MavenAGI.InvalidConversationIdError}
+     * @throws {@link MavenAGI.AgentNotFoundError}
+     *
+     * @example
+     *     await mavenAgi.conversation.ask("string", {
+     *         id: "string",
+     *         text: "string",
+     *         context: {}
+     *     })
+     */
+    ask(conversationId: string, request: MavenAGI.AskRequest, requestOptions?: Conversation.RequestOptions): Promise<MavenAGI.ConversationResponse>;
+    /**
+     * Ask a question
+     */
+    askStream(conversationId: string, request: MavenAGI.AskRequest, requestOptions?: Conversation.RequestOptions): Promise<core.Stream<MavenAGI.StreamResponse>>;
+    /**
+     * Generate a response suggestion for each requested message id in a conversation
+     *
+     * @param {string} conversationId - The ID of a conversation the messages belong to
+     * @param {MavenAGI.GenerateMavenSuggestionsRequest} request
+     * @param {Conversation.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link MavenAGI.InvalidConversationIdError}
+     * @throws {@link MavenAGI.ConversationNotFoundError}
+     * @throws {@link MavenAGI.ConversationMessageNotFoundError}
+     * @throws {@link MavenAGI.InvalidConversationMessageIdError}
+     * @throws {@link MavenAGI.AgentNotFoundError}
+     *
+     * @example
+     *     await mavenAgi.conversation.generateMavenSuggestions("string", {
+     *         messageIds: ["string"]
+     *     })
+     */
+    generateMavenSuggestions(conversationId: string, request: MavenAGI.GenerateMavenSuggestionsRequest, requestOptions?: Conversation.RequestOptions): Promise<MavenAGI.ConversationResponse>;
+    /**
+     * Create feedback
+     *
+     * @param {MavenAGI.FeedbackRequest} request
+     * @param {Conversation.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link MavenAGI.InvalidFeedbackTypeError}
+     * @throws {@link MavenAGI.ConversationMessageNotFoundError}
+     * @throws {@link MavenAGI.AgentNotFoundError}
+     *
+     * @example
+     *     await mavenAgi.conversation.createFeedback({
+     *         conversationMessageId: "string",
+     *         text: "string",
+     *         type: MavenAGI.FeedbackType.ThumbsUp
+     *     })
+     */
+    createFeedback(request: MavenAGI.FeedbackRequest, requestOptions?: Conversation.RequestOptions): Promise<void>;
+    protected _getAuthorizationHeader(): Promise<string | undefined>;
+}