@melara/sdk 0.0.0-stage → 0.1.0

package/esm/lib/conversation-state.js

@@ -0,0 +1,212 @@
+// Modified by Melara for the Melara SDK fork.
+import { en } from "../locales/en.js";
+import { normalizeInputToArray } from './turn-context.js';
+/**
+ * Type guard to verify an object is a valid UnsentToolResult
+ */
+function isValidUnsentToolResult(obj) {
+    if (typeof obj !== 'object' || obj === null)
+        return false;
+    return ('callId' in obj &&
+        typeof obj.callId === 'string' &&
+        'name' in obj &&
+        typeof obj.name === 'string' &&
+        'output' in obj);
+}
+/**
+ * Type guard to verify an object is a valid ParsedToolCall
+ */
+function isValidParsedToolCall(obj) {
+    if (typeof obj !== 'object' || obj === null)
+        return false;
+    return ('id' in obj &&
+        typeof obj.id === 'string' &&
+        'name' in obj &&
+        typeof obj.name === 'string' &&
+        'arguments' in obj);
+}
+/**
+ * Generate a unique ID for a conversation
+ * Uses crypto.randomUUID if available, falls back to timestamp + random
+ */
+export function generateConversationId() {
+    if (typeof crypto !== 'undefined' && crypto.randomUUID) {
+        return `conv_${crypto.randomUUID()}`;
+    }
+    // Fallback for environments without crypto.randomUUID
+    return `conv_${Date.now()}_${Math.random().toString(36).substring(2, 15)}`;
+}
+/**
+ * Create an initial conversation state
+ * @param id - Optional custom ID, generates one if not provided
+ */
+export function createInitialState(id) {
+    const now = Date.now();
+    return {
+        id: id ?? generateConversationId(),
+        messages: [],
+        status: 'in_progress',
+        createdAt: now,
+        updatedAt: now,
+    };
+}
+/**
+ * Update a conversation state with new values
+ * Automatically updates the updatedAt timestamp
+ */
+export function updateState(state, updates) {
+    return {
+        ...state,
+        ...updates,
+        updatedAt: Date.now(),
+    };
+}
+/**
+ * Append new items to the message history
+ */
+export function appendToMessages(current, newItems) {
+    const currentArray = normalizeInputToArray(current);
+    return [...currentArray, ...newItems];
+}
+/**
+ * Check if a tool call requires approval
+ * @param toolCall - The tool call to check
+ * @param tools - Available tools
+ * @param context - Turn context for the approval check
+ * @param callLevelCheck - Optional call-level approval function (overrides tool-level), can be async
+ */
+export async function toolRequiresApproval(toolCall, tools, context, callLevelCheck) {
+    // Call-level check takes precedence
+    if (callLevelCheck) {
+        return callLevelCheck(toolCall, context);
+    }
+    // Fall back to tool-level setting
+    const tool = tools.find(t => t.function.name === toolCall.name);
+    if (!tool)
+        return false;
+    const requireApproval = tool.function.requireApproval;
+    // If it's a function, call it with the tool's arguments and context
+    if (typeof requireApproval === 'function') {
+        return requireApproval(toolCall.arguments, context);
+    }
+    // Otherwise treat as boolean
+    return requireApproval ?? false;
+}
+/**
+ * Partition tool calls into those requiring approval and those that can auto-execute
+ * @param toolCalls - Tool calls to partition
+ * @param tools - Available tools
+ * @param context - Turn context for the approval check
+ * @param callLevelCheck - Optional call-level approval function (overrides tool-level), can be async
+ */
+export async function partitionToolCalls(toolCalls, tools, context, callLevelCheck) {
+    const requiresApproval = [];
+    const autoExecute = [];
+    for (const tc of toolCalls) {
+        if (await toolRequiresApproval(tc, tools, context, callLevelCheck)) {
+            requiresApproval.push(tc);
+        }
+        else {
+            autoExecute.push(tc);
+        }
+    }
+    return { requiresApproval, autoExecute };
+}
+/**
+ * Create an unsent tool result from a successful execution
+ */
+export function createUnsentResult(callId, name, output) {
+    const result = { callId, name, output };
+    if (!isValidUnsentToolResult(result)) {
+        throw new Error(en.invalidUnsenttoolresultStructure);
+    }
+    return result;
+}
+/**
+ * Create an unsent tool result from a rejection
+ */
+export function createRejectedResult(callId, name, reason) {
+    const result = {
+        callId,
+        name,
+        output: null,
+        error: reason ?? en.toolCallRejectedByUser,
+    };
+    if (!isValidUnsentToolResult(result)) {
+        throw new Error(en.invalidUnsenttoolresultStructure);
+    }
+    return result;
+}
+/**
+ * Convert unsent tool results to API format for sending to the model
+ */
+export function unsentResultsToAPIFormat(results) {
+    return results.map(r => ({
+        type: 'function_call_output',
+        id: `output_${r.callId}`,
+        callId: r.callId,
+        output: r.error
+            ? JSON.stringify({ error: r.error })
+            : JSON.stringify(r.output),
+    }));
+}
+/**
+ * Extract text content from a response
+ */
+export function extractTextFromResponse(response) {
+    if (!response.output) {
+        return '';
+    }
+    const outputs = Array.isArray(response.output) ? response.output : [response.output];
+    const textParts = [];
+    for (const item of outputs) {
+        if (item.type === 'message' && 'content' in item && item.content) {
+            for (const content of item.content) {
+                if (content.type === 'output_text' && 'text' in content && content.text) {
+                    textParts.push(content.text);
+                }
+            }
+        }
+    }
+    return textParts.join('');
+}
+/**
+ * Extract tool calls from a response
+ */
+export function extractToolCallsFromResponse(response) {
+    if (!response.output) {
+        return [];
+    }
+    const outputs = Array.isArray(response.output) ? response.output : [response.output];
+    const toolCalls = [];
+    for (const item of outputs) {
+        if (item.type !== 'function_call' || !('arguments' in item)) {
+            continue;
+        }
+        let parsedArguments;
+        if (typeof item.arguments === 'string') {
+            try {
+                parsedArguments = JSON.parse(item.arguments);
+            }
+            catch (error) {
+                // Log warning and skip malformed tool call, similar to stream-transformers.ts
+                console.warn(en.failedToParseArgumentsForToolCall('name' in item ? item.name : 'unknown', error instanceof Error ? error.message : String(error)));
+                continue;
+            }
+        }
+        else {
+            parsedArguments = item.arguments;
+        }
+        const toolCall = {
+            id: ('callId' in item ? item.callId : undefined) ?? item.id ?? '',
+            name: ('name' in item ? item.name : undefined) ?? '',
+            arguments: parsedArguments,
+        };
+        if (!isValidParsedToolCall(toolCall)) {
+            throw new Error(en.invalidToolCallStructureForTool(toolCall.name));
+        }
+        toolCalls.push(toolCall);
+    }
+    return toolCalls;
+}
+//# sourceMappingURL=conversation-state.js.map

package/esm/lib/conversation-state.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"conversation-state.js","sourceRoot":"","sources":["../../src/lib/conversation-state.ts"],"names":[],"mappings":"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"}

package/esm/lib/encodings.d.ts

@@ -0,0 +1,54 @@
+export declare class EncodingError extends Error {
+    constructor(message: string);
+}
+export declare function encodeMatrix(key: string, value: unknown, options?: {
+    explode?: boolean;
+    charEncoding?: "percent" | "none";
+}): string | undefined;
+export declare function encodeLabel(key: string, value: unknown, options?: {
+    explode?: boolean;
+    charEncoding?: "percent" | "none";
+}): string | undefined;
+type FormEncoder = (key: string, value: unknown, options?: {
+    explode?: boolean;
+    charEncoding?: "percent" | "none";
+}) => string | undefined;
+export declare const encodeForm: FormEncoder;
+export declare const encodeSpaceDelimited: FormEncoder;
+export declare const encodePipeDelimited: FormEncoder;
+export declare function encodeBodyForm(key: string, value: unknown, options?: {
+    explode?: boolean;
+    charEncoding?: "percent" | "none";
+}): string;
+export declare function encodeDeepObject(key: string, value: unknown, options?: {
+    charEncoding?: "percent" | "none";
+}): string | undefined;
+export declare function encodeDeepObjectObject(key: string, value: unknown, options?: {
+    charEncoding?: "percent" | "none";
+}): string | undefined;
+export declare function encodeJSON(key: string, value: unknown, options?: {
+    explode?: boolean;
+    charEncoding?: "percent" | "none";
+}): string | undefined;
+export declare const encodeSimple: (key: string, value: unknown, options?: {
+    explode?: boolean;
+    charEncoding?: "percent" | "none";
+}) => string | undefined;
+export declare function queryJoin(...args: (string | undefined)[]): string;
+type QueryEncoderOptions = {
+    explode?: boolean;
+    charEncoding?: "percent" | "none";
+    allowEmptyValue?: string[];
+};
+type QueryEncoder = (key: string, value: unknown, options?: QueryEncoderOptions) => string | undefined;
+type BulkQueryEncoder = (values: Record<string, unknown>, options?: QueryEncoderOptions) => string;
+export declare function queryEncoder(f: QueryEncoder): BulkQueryEncoder;
+export declare const encodeJSONQuery: BulkQueryEncoder;
+export declare const encodeFormQuery: BulkQueryEncoder;
+export declare const encodeSpaceDelimitedQuery: BulkQueryEncoder;
+export declare const encodePipeDelimitedQuery: BulkQueryEncoder;
+export declare const encodeDeepObjectQuery: BulkQueryEncoder;
+export declare function appendForm(fd: FormData, key: string, value: unknown, fileName?: string): void;
+export declare function normalizeBlob(value: Pick<Blob, "arrayBuffer" | "type">): Promise<Blob>;
+export {};
+//# sourceMappingURL=encodings.d.ts.map

package/esm/lib/encodings.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"encodings.d.ts","sourceRoot":"","sources":["../../src/lib/encodings.ts"],"names":[],"mappings":"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"}

package/esm/lib/encodings.js

@@ -0,0 +1,389 @@
+// Modified by Melara for the Melara SDK fork.
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ * @generated-id: 3bd8ead98afd
+ */
+import { en } from "../locales/en.js";
+import { bytesToBase64 } from "./base64.js";
+import { isPlainObject } from "./primitives.js";
+export class EncodingError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = "EncodingError";
+    }
+}
+export function encodeMatrix(key, value, options) {
+    let out = "";
+    const pairs = options?.explode
+        ? explode(key, value)
+        : [[key, value]];
+    if (pairs.every(([_, v]) => v == null)) {
+        return;
+    }
+    const encodeString = (v) => {
+        return options?.charEncoding === "percent" ? encodeURIComponent(v) : v;
+    };
+    const encodeValue = (v) => encodeString(serializeValue(v));
+    pairs.forEach(([pk, pv]) => {
+        let tmp = "";
+        let encValue = null;
+        if (pv == null) {
+            return;
+        }
+        else if (Array.isArray(pv)) {
+            encValue = mapDefined(pv, (v) => `${encodeValue(v)}`)?.join(",");
+        }
+        else if (isPlainObject(pv)) {
+            const mapped = mapDefinedEntries(Object.entries(pv), ([k, v]) => {
+                return `,${encodeString(k)},${encodeValue(v)}`;
+            });
+            encValue = mapped?.join("").slice(1);
+        }
+        else {
+            encValue = `${encodeValue(pv)}`;
+        }
+        if (encValue == null) {
+            return;
+        }
+        const keyPrefix = encodeString(pk);
+        tmp = `${keyPrefix}=${encValue}`;
+        // trim trailing '=' if value was empty
+        if (tmp === `${keyPrefix}=`) {
+            tmp = tmp.slice(0, -1);
+        }
+        // If we end up with the nothing then skip forward
+        if (!tmp) {
+            return;
+        }
+        out += `;${tmp}`;
+    });
+    return out;
+}
+export function encodeLabel(key, value, options) {
+    let out = "";
+    const pairs = options?.explode
+        ? explode(key, value)
+        : [[key, value]];
+    if (pairs.every(([_, v]) => v == null)) {
+        return;
+    }
+    const encodeString = (v) => {
+        return options?.charEncoding === "percent" ? encodeURIComponent(v) : v;
+    };
+    const encodeValue = (v) => encodeString(serializeValue(v));
+    pairs.forEach(([pk, pv]) => {
+        let encValue = "";
+        if (pv == null) {
+            return;
+        }
+        else if (Array.isArray(pv)) {
+            encValue = mapDefined(pv, (v) => `${encodeValue(v)}`)?.join(".");
+        }
+        else if (isPlainObject(pv)) {
+            const mapped = mapDefinedEntries(Object.entries(pv), ([k, v]) => {
+                return `.${encodeString(k)}.${encodeValue(v)}`;
+            });
+            encValue = mapped?.join("").slice(1);
+        }
+        else {
+            const k = options?.explode && isPlainObject(value)
+                ? `${encodeString(pk)}=`
+                : "";
+            encValue = `${k}${encodeValue(pv)}`;
+        }
+        out += encValue == null ? "" : `.${encValue}`;
+    });
+    return out;
+}
+function formEncoder(sep) {
+    return (key, value, options) => {
+        let out = "";
+        const pairs = options?.explode
+            ? explode(key, value)
+            : [[key, value]];
+        if (pairs.every(([_, v]) => v == null)) {
+            return;
+        }
+        const encodeString = (v) => {
+            return options?.charEncoding === "percent" ? encodeURIComponent(v) : v;
+        };
+        const encodeValue = (v) => encodeString(serializeValue(v));
+        const encodedSep = encodeString(sep);
+        pairs.forEach(([pk, pv]) => {
+            let tmp = "";
+            let encValue = null;
+            if (pv == null) {
+                return;
+            }
+            else if (Array.isArray(pv)) {
+                encValue = mapDefined(pv, (v) => `${encodeValue(v)}`)?.join(encodedSep);
+            }
+            else if (isPlainObject(pv)) {
+                encValue = mapDefinedEntries(Object.entries(pv), ([k, v]) => {
+                    return `${encodeString(k)}${encodedSep}${encodeValue(v)}`;
+                })?.join(encodedSep);
+            }
+            else {
+                encValue = `${encodeValue(pv)}`;
+            }
+            if (encValue == null) {
+                return;
+            }
+            tmp = `${encodeString(pk)}=${encValue}`;
+            // If we end up with the nothing then skip forward
+            if (!tmp || tmp === "=") {
+                return;
+            }
+            out += `&${tmp}`;
+        });
+        return out.slice(1);
+    };
+}
+export const encodeForm = formEncoder(",");
+export const encodeSpaceDelimited = formEncoder(" ");
+export const encodePipeDelimited = formEncoder("|");
+export function encodeBodyForm(key, value, options) {
+    let out = "";
+    const pairs = options?.explode
+        ? explode(key, value)
+        : [[key, value]];
+    const encodeString = (v) => {
+        return options?.charEncoding === "percent" ? encodeURIComponent(v) : v;
+    };
+    const encodeValue = (v) => encodeString(serializeValue(v));
+    pairs.forEach(([pk, pv]) => {
+        let tmp = "";
+        let encValue = "";
+        if (pv == null) {
+            return;
+        }
+        else if (Array.isArray(pv)) {
+            encValue = JSON.stringify(pv, jsonReplacer);
+        }
+        else if (isPlainObject(pv)) {
+            encValue = JSON.stringify(pv, jsonReplacer);
+        }
+        else {
+            encValue = `${encodeValue(pv)}`;
+        }
+        tmp = `${encodeString(pk)}=${encValue}`;
+        // If we end up with the nothing then skip forward
+        if (!tmp || tmp === "=") {
+            return;
+        }
+        out += `&${tmp}`;
+    });
+    return out.slice(1);
+}
+export function encodeDeepObject(key, value, options) {
+    if (value == null) {
+        return;
+    }
+    if (!isPlainObject(value)) {
+        throw new EncodingError(en.valueOfParameterWhichUsesDeepobjectEncodingMustBe(key));
+    }
+    return encodeDeepObjectObject(key, value, options);
+}
+export function encodeDeepObjectObject(key, value, options) {
+    if (value == null) {
+        return;
+    }
+    let out = "";
+    const encodeString = (v) => {
+        return options?.charEncoding === "percent" ? encodeURIComponent(v) : v;
+    };
+    if (!isPlainObject(value)) {
+        throw new EncodingError(en.expectedParameterToBeAnObject(key));
+    }
+    Object.entries(value).forEach(([ck, cv]) => {
+        if (cv == null) {
+            return;
+        }
+        const pk = `${key}[${ck}]`;
+        if (isPlainObject(cv)) {
+            const objOut = encodeDeepObjectObject(pk, cv, options);
+            out += objOut == null ? "" : `&${objOut}`;
+            return;
+        }
+        const pairs = Array.isArray(cv) ? cv : [cv];
+        const encoded = mapDefined(pairs, (v) => {
+            return `${encodeString(pk)}=${encodeString(serializeValue(v))}`;
+        })?.join("&");
+        out += encoded == null ? "" : `&${encoded}`;
+    });
+    return out.slice(1);
+}
+export function encodeJSON(key, value, options) {
+    if (typeof value === "undefined") {
+        return;
+    }
+    const encodeString = (v) => {
+        return options?.charEncoding === "percent" ? encodeURIComponent(v) : v;
+    };
+    const encVal = encodeString(JSON.stringify(value, jsonReplacer));
+    return options?.explode ? encVal : `${encodeString(key)}=${encVal}`;
+}
+export const encodeSimple = (key, value, options) => {
+    let out = "";
+    const pairs = options?.explode
+        ? explode(key, value)
+        : [[key, value]];
+    if (pairs.every(([_, v]) => v == null)) {
+        return;
+    }
+    const encodeString = (v) => {
+        return options?.charEncoding === "percent" ? encodeURIComponent(v) : v;
+    };
+    const encodeValue = (v) => encodeString(serializeValue(v));
+    pairs.forEach(([pk, pv]) => {
+        let tmp = "";
+        if (pv == null) {
+            return;
+        }
+        else if (Array.isArray(pv)) {
+            tmp = mapDefined(pv, (v) => `${encodeValue(v)}`)?.join(",");
+        }
+        else if (isPlainObject(pv)) {
+            const mapped = mapDefinedEntries(Object.entries(pv), ([k, v]) => {
+                return `,${encodeString(k)},${encodeValue(v)}`;
+            });
+            tmp = mapped?.join("").slice(1);
+        }
+        else {
+            const k = options?.explode && isPlainObject(value) ? `${pk}=` : "";
+            tmp = `${k}${encodeValue(pv)}`;
+        }
+        out += tmp ? `,${tmp}` : "";
+    });
+    return out.slice(1);
+};
+function explode(key, value) {
+    if (Array.isArray(value)) {
+        return value.map((v) => [key, v]);
+    }
+    else if (isPlainObject(value)) {
+        const o = value ?? {};
+        return Object.entries(o).map(([k, v]) => [k, v]);
+    }
+    else {
+        return [[key, value]];
+    }
+}
+function serializeValue(value) {
+    if (value == null) {
+        return "";
+    }
+    else if (value instanceof Date) {
+        return value.toISOString();
+    }
+    else if (value instanceof Uint8Array) {
+        return bytesToBase64(value);
+    }
+    else if (typeof value === "object") {
+        return JSON.stringify(value, jsonReplacer);
+    }
+    return `${value}`;
+}
+function jsonReplacer(_, value) {
+    if (value instanceof Uint8Array) {
+        return bytesToBase64(value);
+    }
+    else {
+        return value;
+    }
+}
+function mapDefined(inp, mapper) {
+    const res = inp.reduce((acc, v) => {
+        if (v == null) {
+            return acc;
+        }
+        const m = mapper(v);
+        if (m == null) {
+            return acc;
+        }
+        acc.push(m);
+        return acc;
+    }, []);
+    return res.length ? res : null;
+}
+function mapDefinedEntries(inp, mapper) {
+    const acc = [];
+    for (const [k, v] of inp) {
+        if (v == null) {
+            continue;
+        }
+        const m = mapper([k, v]);
+        if (m == null) {
+            continue;
+        }
+        acc.push(m);
+    }
+    return acc.length ? acc : null;
+}
+export function queryJoin(...args) {
+    return args.filter(Boolean).join("&");
+}
+export function queryEncoder(f) {
+    const bulkEncode = function (values, options) {
+        const opts = {
+            ...options,
+            explode: options?.explode ?? true,
+            charEncoding: options?.charEncoding ?? "percent",
+        };
+        const allowEmptySet = new Set(options?.allowEmptyValue ?? []);
+        const encoded = Object.entries(values).map(([key, value]) => {
+            if (allowEmptySet.has(key)) {
+                if (value === undefined
+                    || value === null
+                    || value === ""
+                    || (Array.isArray(value) && value.length === 0)) {
+                    return `${encodeURIComponent(key)}=`;
+                }
+            }
+            return f(key, value, opts);
+        });
+        return queryJoin(...encoded);
+    };
+    return bulkEncode;
+}
+export const encodeJSONQuery = queryEncoder(encodeJSON);
+export const encodeFormQuery = queryEncoder(encodeForm);
+export const encodeSpaceDelimitedQuery = queryEncoder(encodeSpaceDelimited);
+export const encodePipeDelimitedQuery = queryEncoder(encodePipeDelimited);
+export const encodeDeepObjectQuery = queryEncoder(encodeDeepObject);
+function isBlobLike(val) {
+    if (val instanceof Blob) {
+        return true;
+    }
+    if (typeof val !== "object" || val == null || !(Symbol.toStringTag in val)) {
+        return false;
+    }
+    const tag = val[Symbol.toStringTag];
+    if (tag !== "Blob" && tag !== "File") {
+        return false;
+    }
+    return "stream" in val && typeof val.stream === "function";
+}
+export function appendForm(fd, key, value, fileName) {
+    if (value == null) {
+        return;
+    }
+    else if (isBlobLike(value)) {
+        if (fileName) {
+            fd.append(key, value, fileName);
+        }
+        else {
+            fd.append(key, value);
+        }
+    }
+    else {
+        fd.append(key, String(value));
+    }
+}
+export async function normalizeBlob(value) {
+    if (value instanceof Blob) {
+        return value;
+    }
+    return new Blob([await value.arrayBuffer()], { type: value.type });
+}
+//# sourceMappingURL=encodings.js.map