@builder.io/ai-utils 0.0.73 → 0.0.74

package/src/events.d.ts

@@ -1,402 +0,0 @@
-import type { BuilderContent, BuilderElement } from "@builder.io/sdk";
-import type { AssistantMessage } from "./messages.js";
-import type { AssistantSettings } from "./settings.js";
-export type BuilderAssistantEventHandler = (ev: BuilderAssistantEvent) => void;
-export type BuilderAssistantEvent = AssistantCompletionResultEvent | AssistantErrorEvent | AssistantStreamErrorEvent | AppCloseEvent | AppMessagesClickEvent | AppMessagesGenerationEvent | AppMessageEditCustomInstructionsEvent | AppPromptAbortEvent | AppPromptFocusEvent | AppPromptTextEvent | AppReadyEvent | AppSettingsResetEvent | AppSettingsSetEvent | AppThreadNewEvent | AssistantStatsEvent | BuilderEditorAuthEvent | BuilderEditorStateEvent | ContentUpdateEvent | ContentApplySnapshotEvent | ModelCreateEvent | ModelUpdateEvent | ModelUndoEvent | ModelRedoEvent | ResultEvent | ThreadCreatedEvent | ThreadMessageCompletedEvent | ThreadMessageCreatedEvent | ThreadMessageDeltaEvent | ThreadMessageFeedbackEvent | ThreadRunRequiresActionEvent | ThreadRunStepCreatedEvent | ThreadRunStepDeltaEvent | AppAcceptChangeEvent | AppAcceptRejectEvent | AssistantTrackEvent | AssistantEditorAuthMessage | AppAttachmentTemplateEvent;
-export interface AssistantCompletionResultEvent {
-    type: "assistant.result";
-    data: {
-        content?: BuilderContent;
-        stats?: AssistantStats;
-    };
-    resolveId?: string;
-}
-export interface AssistantError {
-    message: string;
-    status?: number;
-}
-export interface AssistantErrorEvent {
-    type: "assistant.error";
-    data: AssistantError;
-}
-export interface AssistantStreamErrorEvent {
-    type: "assistant.stream.error";
-    data: AssistantError;
-}
-export interface AssistantTrackEvent {
-    type: "assistant.track";
-    data: {
-        name: string;
-        properties: Record<string, any>;
-    };
-}
-export interface AppCloseEvent {
-    type: "assistant.app.close";
-}
-export interface AppMessagesClickEvent {
-    type: "assistant.app.messages.click";
-}
-export interface AppAcceptChangeEvent {
-    type: "assistant.app.change.accept";
-}
-export interface AppAcceptRejectEvent {
-    type: "assistant.app.change.reject";
-}
-export interface AppMessageEditCustomInstructionsEvent {
-    type: "assistant.app.messages.editCustomInstructions";
-}
-export interface AppAttachmentTemplateEvent {
-    type: "assistant.app.attachment.template";
-    data: {
-        id: number;
-        name: string;
-    };
-}
-export interface AppMessagesGenerationEvent {
-    type: "assistant.app.messages.generation";
-    data: {
-        state: GenerationState;
-    };
-}
-/**
- * idle: no messages are being generated or queued to be generated
- *
- * queued: messages have been sent to the LLM, but no response has been received yet
- *
- * generating: messages are actively being generated and streaming back to the UI
- */
-export type GenerationState = "idle" | "queued" | "generating";
-export interface AppPromptAbortEvent {
-    type: "assistant.app.prompt.abort";
-}
-export interface AppPromptFocusEvent {
-    type: "assistant.app.prompt.focus";
-}
-export interface AppPromptTextEvent {
-    type: "assistant.app.prompt.text";
-    data: {
-        text: string;
-    };
-}
-export interface AppReadyEvent {
-    type: "assistant.app.ready";
-}
-export interface AppSettingsResetEvent {
-    type: "assistant.app.settings.reset";
-}
-export interface AppSettingsSetEvent {
-    type: "assistant.app.settings.set";
-    data: Partial<AssistantSettings>;
-}
-export interface AppThreadNewEvent {
-    type: "assistant.app.thread.new";
-}
-export interface AssistantEditorAuthMessage {
-    type: "assistant.editor.auth.update";
-}
-export interface BuilderEditorAuthEvent extends AwaitResultEvent {
-    type: "assistant.editor.auth";
-}
-export interface BuilderEditorStateEvent extends AwaitResultEvent {
-    type: "assistant.editor.state";
-}
-export interface AwaitResultEvent {
-    resolveId?: string;
-}
-export interface ResultEvent {
-    type: "assistant.result";
-    resolveId: string;
-    data: any;
-}
-export interface ContentCreatePatch {
-    parentId: string;
-    insertBeforeId: string;
-    element: BuilderElement;
-}
-export interface ContentApplySnapshot {
-    /**
-     * The id of the BuilderContent to apply the snapshot to
-     */
-    id: string;
-    /**
-     * Each snapshot can be either a full BuilderContent or individual BuilderElements.
-     * Order matters, as the snapshots will be applied in the order they are listed.
-     * The builder app will handle the logic of applying the snapshots in the correct order
-     * and to the right content/elements.
-     */
-    snapshots: (BuilderElement | BuilderContent)[];
-}
-export interface ContentApplySnapshotEvent {
-    type: "assistant.content.applysnapshot";
-    data: ContentApplySnapshot;
-}
-export interface ContentUpdateEvent {
-    type: "assistant.content.update";
-    data: ContentUpdatePatch[];
-}
-export type ContentUpdatePatch = ContentTsCodePatch | ContentInsertBeforePatch | ContentInsertAfterPatch | ContentPropsUpdatePatch | ContentSetChildrenPatch | ContentStyleUpdatePatch | ContentDeletePatch | ContentSetStorePatch | ContentSetMountPatch | ContentMovePatch | ContentMoveAfterPatch | ContentMoveBeforePatch | ContentSetTagNamePatch | ContentTsUpdateComponentPatch;
-interface ContentPatchBase {
-    id: string;
-    nodeId?: string;
-    builderId?: string;
-    description?: string;
-    value: string;
-    displayValue?: string;
-    ts: number;
-    /**
-     * A change value is considered incomplete until we also parsed it's closing xml tag.
-     */
-    incomplete?: boolean;
-    /**
-     * If there was an error applying the patch, this will contain the error message.
-     */
-    error?: string;
-}
-export interface ContentTsUpdateComponentPatch extends ContentPatchBase {
-    type: "update_component";
-}
-export interface ContentTsCodePatch extends ContentPatchBase {
-    type: "ts_code";
-}
-export interface ContentSetTagNamePatch extends ContentPatchBase {
-    type: "set_tag_name";
-}
-export interface ContentInsertBeforePatch extends ContentPatchBase {
-    type: "insert_before";
-    snapshotBuilderId?: string;
-}
-export interface ContentInsertAfterPatch extends ContentPatchBase {
-    type: "insert_after";
-    snapshotBuilderId?: string;
-}
-export interface ContentPropsUpdatePatch extends ContentPatchBase {
-    type: "props";
-}
-export interface ContentStyleUpdatePatch extends ContentPatchBase {
-    type: "style";
-}
-export interface ContentSetChildrenPatch extends ContentPatchBase {
-    type: "children";
-    snapshotBuilderId?: string;
-}
-export interface ContentDeletePatch extends ContentPatchBase {
-    type: "delete";
-}
-export interface ContentSetStorePatch extends ContentPatchBase {
-    type: "store";
-}
-export interface ContentSetMountPatch extends ContentPatchBase {
-    type: "mount";
-}
-export interface ContentMovePatch extends ContentPatchBase {
-    type: "move";
-}
-export interface ContentMoveAfterPatch extends ContentPatchBase {
-    type: "move_after";
-}
-export interface ContentMoveBeforePatch extends ContentPatchBase {
-    type: "move_before";
-}
-export interface AssistantStatsEvent {
-    type: "assistant.stats";
-    data: AssistantStats;
-}
-export interface AssistantStats {
-    /**
-     * The unique id of the thread (not the openai threadId)
-     */
-    threadId: string;
-    /**
-     * The unique id of the completion, which is a combination of the user's prompt and assistant's response.
-     */
-    completionId: string;
-    /**
-     * The model id used to generate this completion.
-     */
-    modelId: string;
-    /**
-     * The assistant's response message.
-     */
-    assistantMessage: string;
-    /**
-     * The user's prompt message.
-     */
-    userMessage: string;
-    /**
-     * The index within the thread the assistant message is.
-     * For a first assistant message, the index will be 1 (the user message is index 0).
-     * For a second assistant message, the index will be 3 (the user message is index 2), and so on.
-     */
-    assistantMessageIndex: number;
-    /**
-     * The timestamp (Date.now()) of when the user first submitted their prompt.
-     */
-    userPromptMs: number;
-    /**
-     * The timestamp of the first assistant chunk in the response.
-     */
-    firstChunkMs: number;
-    /**
-     * The timestamp of the last assistant chunk in the response.
-     */
-    lastChunkMs: number;
-    /**
-     * The total number of chunks in the assistant's streamed response.
-     */
-    chunkCount: number;
-    /**
-     * The total number of characters in the generated prompt sent to the LLM.
-     */
-    promptLength: number;
-    /**
-     * The total number of characters in the assistant's response.
-     */
-    completionLength: number;
-    /**
-     * If the user provided custom instructions for the prompt.
-     */
-    hasCustomInstructions: boolean;
-    /**
-     * The deployed version.
-     */
-    version: string;
-    /**
-     * Error message if there was one.
-     */
-    errorMessage?: string;
-    /**
-     * Input tokens
-     */
-    inputTokens?: number;
-    /**
-     * Output tokens
-     */
-    outputTokens?: number;
-    /**
-     * Output tokens
-     */
-    completionCost?: number;
-    /**
-     * Number of streamed snapshots
-     */
-    streamedSnapshots?: number;
-    /**
-     * Number of cached input tokens
-     */
-    cacheInputTokens?: number;
-    /**
-     * Number of cached created tokens
-     */
-    cacheCreatedTokens?: number;
-}
-export interface ModelCreateEvent {
-    type: "assistant.model.create";
-    data: BuilderModel;
-}
-export interface ModelUpdateEvent {
-    type: "assistant.model.update";
-    data: ModelUpdate;
-}
-export interface ModelUndoEvent {
-    type: "assistant.model.undo";
-}
-export interface ModelRedoEvent {
-    type: "assistant.model.redo";
-}
-export interface ModelUpdate {
-    patches: ModelPatch[];
-}
-export interface BuilderModel {
-    name?: string;
-    friendlyName?: string;
-    description?: string;
-    type?: string;
-    fields?: BuilderModelField[];
-}
-export interface BuilderModelField {
-    name?: string;
-    type?: string;
-    description?: string;
-}
-export type ModelPatch = {
-    op: "add" | "remove" | "replace";
-    path: string;
-    value?: any;
-};
-export interface ThreadMessageFeedbackEvent {
-    type: "assistant.thread.message.feedback";
-    data: CompletionResponseFeedback;
-}
-export interface CompletionResponseFeedback {
-    userId: string;
-    builderUserId?: string;
-    builderEmail?: string;
-    responseId?: string;
-    frontendUrl: string | undefined;
-    frontendCommitId: string | undefined;
-    backendDomain?: string;
-    backendCommitId: string | undefined;
-    feedbackText: string;
-    sentiment?: "positive" | "negative";
-}
-export interface ThreadCreatedEvent {
-    type: "assistant.thread.created";
-    data: ThreadCreated;
-}
-export interface ThreadCreated {
-    platformId: string;
-    threadId: string;
-    vectorStoreId: string;
-}
-export interface ThreadMessageCreatedEvent {
-    type: "assistant.thread.message.created";
-    data: ThreadMessageCreated;
-}
-export interface ThreadMessageCreated {
-    id: string;
-    responseId: string;
-    threadId: string;
-}
-export interface ThreadMessageDeltaEvent {
-    type: "assistant.thread.message.delta";
-    data: ThreadMessageDelta;
-}
-export interface ThreadMessageDelta {
-    id: string;
-    text: string;
-}
-export interface ThreadMessageCompletedEvent {
-    type: "assistant.thread.message.completed";
-    data: ThreadMessageCompleted;
-}
-export interface ThreadMessageCompleted extends AssistantMessage {
-    platformId: string;
-    threadId: string;
-    commitId?: string;
-}
-export interface ThreadRunRequiresActionEvent {
-    type: "assistant.thread.run.requires_action";
-    data: ThreadRunRequiredAction;
-}
-export interface ThreadRunRequiredAction {
-    platformId: string;
-    threadId: string;
-    action: {
-        name: string;
-        arguments: string;
-    };
-}
-export interface ThreadRunStepDeltaEvent {
-    type: "assistant.thread.run.step.delta";
-    data: ThreadMessageStepDelta;
-}
-export interface ThreadMessageStepDelta {
-    delta: any;
-}
-export interface ThreadRunStepCreatedEvent {
-    type: "assistant.thread.run.step.created";
-}
-export type DeepPartial<T> = T extends object ? {
-    [P in keyof T]?: DeepPartial<T[P]>;
-} : T;
-export {};

package/src/events.js

@@ -1 +0,0 @@
-export {};

package/src/fetch.d.ts

@@ -1 +0,0 @@
-export declare function fetchJsonl<T>(input: string | URL, init: RequestInit, onData: (ev: T) => void): Promise<Response>;

package/src/fetch.js

@@ -1,83 +0,0 @@
-export async function fetchJsonl(input, init, onData) {
-    return new Promise(async (resolve, reject) => {
-        try {
-            init = {
-                ...init,
-                headers: {
-                    accept: "application/jsonl",
-                    "content-type": "application/json",
-                    ...init.headers,
-                },
-            };
-            const rsp = await (async () => {
-                try {
-                    return await fetch(input, init);
-                }
-                catch (err) {
-                    reject(new NetworkError(`${input}, status: network failure`));
-                }
-            })();
-            if (!rsp) {
-                return;
-            }
-            if (!rsp.ok) {
-                reject(new APIError(`${input}, status: ${rsp.status}`));
-                return;
-            }
-            if (!rsp.body) {
-                reject(new APIError(`${input}, missing body`));
-                return;
-            }
-            const reader = rsp.body.getReader();
-            const decoder = new TextDecoder();
-            let data = "";
-            const processStream = async () => {
-                const { done, value } = await reader.read();
-                data += decoder.decode(value, { stream: !done });
-                if (!done) {
-                    let lines = data.split("\n");
-                    if (!done) {
-                        data = lines.pop() || "";
-                    }
-                    for (let line of lines) {
-                        if (line) {
-                            try {
-                                line = line.trim();
-                                if (line.startsWith("{") && line.endsWith("}")) {
-                                    onData(JSON.parse(line));
-                                }
-                                else {
-                                    reject(`Invalid JSONL line: ${line}`);
-                                    return;
-                                }
-                            }
-                            catch (e) {
-                                console.error(`Failed to parse JSONL: ${line}`);
-                                reject(e);
-                                return;
-                            }
-                        }
-                    }
-                    await processStream();
-                }
-            };
-            await processStream();
-            resolve(rsp);
-        }
-        catch (e) {
-            reject(e);
-        }
-    });
-}
-class NetworkError extends Error {
-    constructor(message) {
-        super(message);
-        this.name = "NetworkError";
-    }
-}
-class APIError extends Error {
-    constructor(message) {
-        super(message);
-        this.name = "APIError";
-    }
-}

package/src/index.js

@@ -1,7 +0,0 @@
-export * from "./complete-json.js";
-export * from "./completion.js";
-export * from "./events.js";
-export * from "./fetch.js";
-export * from "./messages.js";
-export * from "./settings.js";
-export * from "./thread.js";

package/src/messages.d.ts

@@ -1,130 +0,0 @@
-import type { ContentUpdatePatch } from "./events.js";
-/**
- * Message param does not know the id of the message.
- * This is an input message.
- */
-export type MessageParam = SystemMessageParam | UserMessageParam | AssistantMessageParam;
-export interface ContentMessageItemText {
-    type: "text";
-    text: string;
-    cache?: boolean;
-}
-export interface ContentMessageItemImage {
-    type: "image";
-    source: ImageSource;
-    cache?: boolean;
-}
-export interface ImageSource {
-    type: "base64";
-    media_type: "image/webp" | "image/png" | "image/jpeg";
-    data: string;
-}
-export interface ContentMessageItemThinking {
-    type: "thinking";
-    thinking: string;
-    signature: string;
-}
-export interface ContentMessageItemRedactedThinking {
-    type: "redacted_thinking";
-    data: string;
-}
-export interface ContentMessageItemToolUse {
-    type: "tool_use";
-    id: string;
-    input: unknown;
-    name: string;
-}
-export type ContentMessageItem = ContentMessageItemText | ContentMessageItemImage | ContentMessageItemThinking | ContentMessageItemRedactedThinking | ContentMessageItemToolUse;
-export type ContentMessage = ContentMessageItem[];
-export interface SystemMessageParam {
-    /**
-     * The contents of the system message.
-     */
-    content: string | ContentMessageItemText[];
-    responseId?: string;
-    /**
-     * The role of the messages author, in this case `system`.
-     */
-    role: "system";
-    id?: string;
-}
-export interface UserMessageParam {
-    /**
-     * The contents of the user message.
-     */
-    content: string | (ContentMessageItemText | ContentMessageItemImage)[];
-    responseId?: string;
-    /**
-     * The role of the messages author, in this case `user`.
-     */
-    role: "user";
-    id?: string;
-}
-export interface AssistantMessageParam {
-    /**
-     * The contents of the assistant message.
-     */
-    content: string | (ContentMessageItemThinking | ContentMessageItemRedactedThinking | ContentMessageItemText | ContentMessageItemToolUse)[];
-    /**
-     * The role of the messages author, in this case `assistant`.
-     */
-    role: "assistant";
-    responseId?: string;
-    /**
-     * The function call name and arguments
-     */
-    action?: {
-        /**
-         * The specific function name
-         */
-        name: string;
-        /** This is arbitrary JSON */
-        arguments: any;
-    };
-    id?: string;
-    skipDelta?: boolean;
-    /**
-     * A summary of the patches which the assistant has made.
-     * Useful for genai.
-     */
-    patches?: ContentUpdatePatch[];
-    state?: "error";
-}
-export interface SystemMessage extends SystemMessageParam {
-    id: string;
-}
-export interface UserMessage extends UserMessageParam {
-    id: string;
-}
-export interface AssistantMessage extends AssistantMessageParam {
-    id: string;
-    status?: "accepted" | "rejected" | "aborted";
-}
-export interface AssistantActionMessage {
-    /**
-     * The role of the messages author, in this case `assistant`.
-     */
-    role: "assistant";
-    id: string;
-}
-/**
- * Message DOES know the id of the message.
- * This message is after an id has been assigned
- * and is the output message.
- */
-export type Message = SystemMessage | UserMessage | AssistantMessage;
-export type GeneratingMessage = null | Partial<AssistantActionMessage | AssistantMessage>;
-export declare function getContentText(message: string | ContentMessage): string;
-export type Attachment = FileUpload | Template;
-export interface FileUpload {
-    type: string;
-    name: string;
-    dataUrl: string;
-    size: number;
-    id: number;
-}
-export interface Template {
-    type: "template";
-    name: string;
-    id: number;
-}

package/src/messages.js

@@ -1,8 +0,0 @@
-export function getContentText(message) {
-    if (typeof message === "string") {
-        return message;
-    }
-    return message
-        .map((item) => (item.type === "text" ? item.text : ""))
-        .join("");
-}

package/src/settings.d.ts

@@ -1,23 +0,0 @@
-export interface AssistantSettings {
-    assistantType?: string;
-    viewId?: string;
-    cssOverrides?: string;
-    messagePlaceholder: string;
-    showPrompt?: boolean;
-    theme?: "dark" | "light";
-}
-interface IframeSettings extends Partial<AssistantSettings> {
-    local?: boolean;
-    /**
-     * The URL of the assistant.
-     */
-    baseUrl?: string;
-}
-export declare function getAssistantUrl(opts?: IframeSettings): string;
-export declare function parseAssistantUrlSettings(url: string): Partial<AssistantSettings>;
-export interface BuilderEditorAuth {
-    spaceId: string;
-    userId: string;
-    authToken: string;
-}
-export {};

package/src/settings.js

@@ -1,31 +0,0 @@
-const urlParamSettings = [
-    "assistantType",
-    "showPrompt",
-    "theme",
-    "viewId",
-];
-export function getAssistantUrl(opts = {}) {
-    var _a;
-    const url = new URL((_a = opts.baseUrl) !== null && _a !== void 0 ? _a : (opts.local ? "http://localhost:7242" : "https://assistant.builder.io"));
-    urlParamSettings.forEach((key) => {
-        const value = opts[key];
-        if (typeof value === "string" || typeof value === "boolean") {
-            url.searchParams.set(key, String(value));
-        }
-    });
-    return url.href;
-}
-export function parseAssistantUrlSettings(url) {
-    const parsed = new URL(url);
-    const settings = {};
-    urlParamSettings.forEach((key) => {
-        const value = parsed.searchParams.get(key);
-        if (value === "true" || value === "false") {
-            settings[key] = value === "true";
-        }
-        else if (value) {
-            settings[key] = value;
-        }
-    });
-    return settings;
-}