@melara/sdk 0.0.0-stage → 0.1.0

package/esm/lib/security.js

@@ -0,0 +1,150 @@
+// Modified by Melara for the Melara SDK fork.
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ * @generated-id: 0502afa7922e
+ */
+import { en } from "../locales/en.js";
+import { env } from "./env.js";
+export var SecurityErrorCode;
+(function (SecurityErrorCode) {
+    SecurityErrorCode["Incomplete"] = "incomplete";
+    SecurityErrorCode["UnrecognisedSecurityType"] = "unrecognized_security_type";
+})(SecurityErrorCode || (SecurityErrorCode = {}));
+export class SecurityError extends Error {
+    constructor(code, message) {
+        super(message);
+        this.code = code;
+        this.name = "SecurityError";
+    }
+    static incomplete() {
+        return new SecurityError(SecurityErrorCode.Incomplete, en.securityRequirementsNotMetInOrderToPerformThe);
+    }
+    static unrecognizedType(type) {
+        return new SecurityError(SecurityErrorCode.UnrecognisedSecurityType, en.unrecognisedSecurityType(type));
+    }
+}
+function resolveSecurity(...options) {
+    const state = {
+        basic: {},
+        headers: {},
+        queryParams: {},
+        cookies: {},
+        oauth2: { type: "none" },
+    };
+    const option = options.find((opts) => {
+        return opts.every((o) => {
+            if (o.value == null) {
+                return false;
+            }
+            else if (o.type === "http:basic") {
+                return o.value.username != null || o.value.password != null;
+            }
+            else if (o.type === "http:custom") {
+                return null;
+            }
+            else if (o.type === "oauth2:password") {
+                return (typeof o.value === "string" && !!o.value);
+            }
+            else if (o.type === "oauth2:client_credentials") {
+                if (typeof o.value == "string") {
+                    return !!o.value;
+                }
+                return o.value.clientID != null || o.value.clientSecret != null;
+            }
+            else if (typeof o.value === "string") {
+                return !!o.value;
+            }
+            else {
+                throw new Error(en.unrecognizedSecurityTypeValueType(o.type, typeof o
+                    .value));
+            }
+        });
+    });
+    if (option == null) {
+        return null;
+    }
+    option.forEach((spec) => {
+        if (spec.value == null) {
+            return;
+        }
+        const { type } = spec;
+        switch (type) {
+            case "apiKey:header":
+                state.headers[spec.fieldName] = spec.value;
+                break;
+            case "apiKey:query":
+                state.queryParams[spec.fieldName] = spec.value;
+                break;
+            case "apiKey:cookie":
+                state.cookies[spec.fieldName] = spec.value;
+                break;
+            case "http:basic":
+                applyBasic(state, spec);
+                break;
+            case "http:custom":
+                break;
+            case "http:bearer":
+                applyBearer(state, spec);
+                break;
+            case "oauth2":
+                applyBearer(state, spec);
+                break;
+            case "oauth2:password":
+                applyBearer(state, spec);
+                break;
+            case "oauth2:client_credentials":
+                break;
+            case "openIdConnect":
+                applyBearer(state, spec);
+                break;
+            default:
+                throw SecurityError.unrecognizedType((spec, type));
+        }
+    });
+    return state;
+}
+function applyBasic(state, spec) {
+    if (spec.value == null) {
+        return;
+    }
+    state.basic = spec.value;
+}
+function applyBearer(state, spec) {
+    if (typeof spec.value !== "string" || !spec.value) {
+        return;
+    }
+    let value = spec.value;
+    if (value.slice(0, 7).toLowerCase() !== "bearer ") {
+        value = `Bearer ${value}`;
+    }
+    if (spec.fieldName !== undefined) {
+        state.headers[spec.fieldName] = value;
+    }
+}
+export function resolveGlobalSecurity(security, allowedFields) {
+    let inputs = [
+        [
+            {
+                fieldName: "Authorization",
+                type: "http:bearer",
+                value: security?.apiKey ?? env().MELARA_API_KEY,
+            },
+        ],
+    ];
+    if (allowedFields) {
+        inputs = allowedFields.map((i) => {
+            if (i < 0 || i >= inputs.length) {
+                throw new RangeError(en.invalidAllowedfieldsIndex(i));
+            }
+            return inputs[i];
+        });
+    }
+    return resolveSecurity(...inputs);
+}
+export async function extractSecurity(sec) {
+    if (sec == null) {
+        return;
+    }
+    return typeof sec === "function" ? sec() : sec;
+}
+//# sourceMappingURL=security.js.map

package/esm/lib/security.js.map

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

package/esm/lib/stop-conditions.d.ts

@@ -0,0 +1,80 @@
+import type { StepResult, StopCondition, Tool } from './tool-types.js';
+/**
+ * Stop condition that checks if step count equals or exceeds a specific number
+ * @param stepCount - The number of steps to allow before stopping
+ * @returns StopCondition that returns true when steps.length >= stepCount
+ *
+ * @example
+ * ```typescript
+ * stopWhen: stepCountIs(5) // Stop after 5 steps
+ * ```
+ */
+export declare function stepCountIs(stepCount: number): StopCondition;
+/**
+ * Stop condition that checks if any step contains a tool call with the given name
+ * @param toolName - The name of the tool to check for
+ * @returns StopCondition that returns true if the tool was called in any step
+ *
+ * @example
+ * ```typescript
+ * stopWhen: hasToolCall('search') // Stop when search tool is called
+ * ```
+ */
+export declare function hasToolCall(toolName: string): StopCondition;
+/**
+ * Evaluates an array of stop conditions
+ * Returns true if ANY condition returns true (OR logic)
+ * @param options - Object containing stopConditions and steps
+ * @returns Promise<boolean> indicating if execution should stop
+ *
+ * @example
+ * ```typescript
+ * const shouldStop = await isStopConditionMet({
+ *   stopConditions: [stepCountIs(5), hasToolCall('search')],
+ *   steps: allSteps
+ * });
+ * ```
+ */
+export declare function isStopConditionMet<TTools extends readonly Tool[]>(options: {
+    readonly stopConditions: ReadonlyArray<StopCondition<TTools>>;
+    readonly steps: ReadonlyArray<StepResult<TTools>>;
+}): Promise<boolean>;
+/**
+ * Stop when total token usage exceeds a threshold
+ * Melara-specific helper using usage data
+ *
+ * @param maxTokens - Maximum total tokens to allow
+ * @returns StopCondition that returns true when token usage exceeds threshold
+ *
+ * @example
+ * ```typescript
+ * stopWhen: maxTokensUsed(10000) // Stop when total tokens exceed 10,000
+ * ```
+ */
+export declare function maxTokensUsed(maxTokens: number): StopCondition;
+/**
+ * Stop when total cost exceeds a threshold
+ * Melara-specific helper using cost data
+ *
+ * @param maxCostInDollars - Maximum cost in dollars to allow
+ * @returns StopCondition that returns true when cost exceeds threshold
+ *
+ * @example
+ * ```typescript
+ * stopWhen: maxCost(0.50) // Stop when total cost exceeds $0.50
+ * ```
+ */
+export declare function maxCost(maxCostInDollars: number): StopCondition;
+/**
+ * Stop when a specific finish reason is encountered
+ *
+ * @param reason - The finish reason to check for
+ * @returns StopCondition that returns true when finish reason matches
+ *
+ * @example
+ * ```typescript
+ * stopWhen: finishReasonIs('length') // Stop when context length limit is hit
+ * ```
+ */
+export declare function finishReasonIs(reason: string): StopCondition;
+//# sourceMappingURL=stop-conditions.d.ts.map

package/esm/lib/stop-conditions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stop-conditions.d.ts","sourceRoot":"","sources":["../../src/lib/stop-conditions.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,UAAU,EAAE,aAAa,EAAE,IAAI,EAAE,MAAM,iBAAiB,CAAC;AAEvE;;;;;;;;;GASG;AACH,wBAAgB,WAAW,CAAC,SAAS,EAAE,MAAM,GAAG,aAAa,CAE5D;AAED;;;;;;;;;GASG;AACH,wBAAgB,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,aAAa,CAM3D;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAsB,kBAAkB,CAAC,MAAM,SAAS,SAAS,IAAI,EAAE,EAAE,OAAO,EAAE;IAChF,QAAQ,CAAC,cAAc,EAAE,aAAa,CAAC,aAAa,CAAC,MAAM,CAAC,CAAC,CAAC;IAC9D,QAAQ,CAAC,KAAK,EAAE,aAAa,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC;CACnD,GAAG,OAAO,CAAC,OAAO,CAAC,CAgBnB;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,aAAa,CAAC,SAAS,EAAE,MAAM,GAAG,aAAa,CAQ9D;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,OAAO,CAAC,gBAAgB,EAAE,MAAM,GAAG,aAAa,CAQ/D;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,MAAM,GAAG,aAAa,CAI5D"}

package/esm/lib/stop-conditions.js

@@ -0,0 +1,104 @@
+/**
+ * Stop condition that checks if step count equals or exceeds a specific number
+ * @param stepCount - The number of steps to allow before stopping
+ * @returns StopCondition that returns true when steps.length >= stepCount
+ *
+ * @example
+ * ```typescript
+ * stopWhen: stepCountIs(5) // Stop after 5 steps
+ * ```
+ */
+export function stepCountIs(stepCount) {
+    return ({ steps }) => steps.length >= stepCount;
+}
+/**
+ * Stop condition that checks if any step contains a tool call with the given name
+ * @param toolName - The name of the tool to check for
+ * @returns StopCondition that returns true if the tool was called in any step
+ *
+ * @example
+ * ```typescript
+ * stopWhen: hasToolCall('search') // Stop when search tool is called
+ * ```
+ */
+export function hasToolCall(toolName) {
+    return ({ steps }) => {
+        return steps.some((step) => step.toolCalls.some((call) => call.name === toolName));
+    };
+}
+/**
+ * Evaluates an array of stop conditions
+ * Returns true if ANY condition returns true (OR logic)
+ * @param options - Object containing stopConditions and steps
+ * @returns Promise<boolean> indicating if execution should stop
+ *
+ * @example
+ * ```typescript
+ * const shouldStop = await isStopConditionMet({
+ *   stopConditions: [stepCountIs(5), hasToolCall('search')],
+ *   steps: allSteps
+ * });
+ * ```
+ */
+export async function isStopConditionMet(options) {
+    const { stopConditions, steps } = options;
+    // Evaluate all conditions in parallel
+    const results = await Promise.all(stopConditions.map((condition) => Promise.resolve(condition({
+        steps,
+    }))));
+    // Return true if ANY condition is true (OR logic)
+    return results.some((result) => result === true);
+}
+/**
+ * Stop when total token usage exceeds a threshold
+ * Melara-specific helper using usage data
+ *
+ * @param maxTokens - Maximum total tokens to allow
+ * @returns StopCondition that returns true when token usage exceeds threshold
+ *
+ * @example
+ * ```typescript
+ * stopWhen: maxTokensUsed(10000) // Stop when total tokens exceed 10,000
+ * ```
+ */
+export function maxTokensUsed(maxTokens) {
+    return ({ steps }) => {
+        const totalTokens = steps.reduce((sum, step) => sum + (step.usage?.totalTokens ?? 0), 0);
+        return totalTokens >= maxTokens;
+    };
+}
+/**
+ * Stop when total cost exceeds a threshold
+ * Melara-specific helper using cost data
+ *
+ * @param maxCostInDollars - Maximum cost in dollars to allow
+ * @returns StopCondition that returns true when cost exceeds threshold
+ *
+ * @example
+ * ```typescript
+ * stopWhen: maxCost(0.50) // Stop when total cost exceeds $0.50
+ * ```
+ */
+export function maxCost(maxCostInDollars) {
+    return ({ steps }) => {
+        const totalCost = steps.reduce((sum, step) => sum + (step.usage?.cost ?? 0), 0);
+        return totalCost >= maxCostInDollars;
+    };
+}
+/**
+ * Stop when a specific finish reason is encountered
+ *
+ * @param reason - The finish reason to check for
+ * @returns StopCondition that returns true when finish reason matches
+ *
+ * @example
+ * ```typescript
+ * stopWhen: finishReasonIs('length') // Stop when context length limit is hit
+ * ```
+ */
+export function finishReasonIs(reason) {
+    return ({ steps }) => {
+        return steps.some((step) => step.finishReason === reason);
+    };
+}
+//# sourceMappingURL=stop-conditions.js.map

package/esm/lib/stop-conditions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"stop-conditions.js","sourceRoot":"","sources":["../../src/lib/stop-conditions.ts"],"names":[],"mappings":"AAGA;;;;;;;;;GASG;AACH,MAAM,UAAU,WAAW,CAAC,SAAiB;IAC3C,OAAO,CAAC,EAAE,KAAK,EAAiD,EAAE,EAAE,CAAC,KAAK,CAAC,MAAM,IAAI,SAAS,CAAC;AACjG,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,UAAU,WAAW,CAAC,QAAgB;IAC1C,OAAO,CAAC,EAAE,KAAK,EAAiD,EAAE,EAAE;QAClE,OAAO,KAAK,CAAC,IAAI,CAAC,CAAC,IAAgB,EAAE,EAAE,CACrC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,IAAsB,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,KAAK,QAAQ,CAAC,CACxE,CAAC;IACJ,CAAC,CAAC;AACJ,CAAC;AAED;;;;;;;;;;;;;GAaG;AACH,MAAM,CAAC,KAAK,UAAU,kBAAkB,CAAiC,OAGxE;IACC,MAAM,EAAE,cAAc,EAAE,KAAK,EAAE,GAAG,OAAO,CAAC;IAE1C,sCAAsC;IACtC,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,GAAG,CAC/B,cAAc,CAAC,GAAG,CAAC,CAAC,SAAgC,EAAE,EAAE,CACtD,OAAO,CAAC,OAAO,CACb,SAAS,CAAC;QACR,KAAK;KACN,CAAC,CACH,CACF,CACF,CAAC;IAEF,kDAAkD;IAClD,OAAO,OAAO,CAAC,IAAI,CAAC,CAAC,MAA2B,EAAE,EAAE,CAAC,MAAM,KAAK,IAAI,CAAC,CAAC;AACxE,CAAC;AAED;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,aAAa,CAAC,SAAiB;IAC7C,OAAO,CAAC,EAAE,KAAK,EAAiD,EAAE,EAAE;QAClE,MAAM,WAAW,GAAG,KAAK,CAAC,MAAM,CAC9B,CAAC,GAAW,EAAE,IAAgB,EAAE,EAAE,CAAC,GAAG,GAAG,CAAC,IAAI,CAAC,KAAK,EAAE,WAAW,IAAI,CAAC,CAAC,EACvE,CAAC,CACF,CAAC;QACF,OAAO,WAAW,IAAI,SAAS,CAAC;IAClC,CAAC,CAAC;AACJ,CAAC;AAED;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,OAAO,CAAC,gBAAwB;IAC9C,OAAO,CAAC,EAAE,KAAK,EAAiD,EAAE,EAAE;QAClE,MAAM,SAAS,GAAG,KAAK,CAAC,MAAM,CAC5B,CAAC,GAAW,EAAE,IAAgB,EAAE,EAAE,CAAC,GAAG,GAAG,CAAC,IAAI,CAAC,KAAK,EAAE,IAAI,IAAI,CAAC,CAAC,EAChE,CAAC,CACF,CAAC;QACF,OAAO,SAAS,IAAI,gBAAgB,CAAC;IACvC,CAAC,CAAC;AACJ,CAAC;AAED;;;;;;;;;;GAUG;AACH,MAAM,UAAU,cAAc,CAAC,MAAc;IAC3C,OAAO,CAAC,EAAE,KAAK,EAAiD,EAAE,EAAE;QAClE,OAAO,KAAK,CAAC,IAAI,CAAC,CAAC,IAAgB,EAAE,EAAE,CAAC,IAAI,CAAC,YAAY,KAAK,MAAM,CAAC,CAAC;IACxE,CAAC,CAAC;AACJ,CAAC"}

package/esm/lib/stream-transformers.d.ts

@@ -0,0 +1,118 @@
+import type { ChatAssistantMessage } from '../models/chatassistantmessage.js';
+import type { FunctionCallOutputItem } from '../models/functioncalloutputitem.js';
+import type { OpenResponsesResult } from '../models/openresponsesresult.js';
+import type { OutputFileSearchCallItem } from '../models/outputfilesearchcallitem.js';
+import type { OutputFunctionCallItem } from '../models/outputfunctioncallitem.js';
+import type { OutputImageGenerationCallItem } from '../models/outputimagegenerationcallitem.js';
+import type { OutputMessage } from '../models/outputmessage.js';
+import type { OutputReasoningItem } from '../models/outputreasoningitem.js';
+import type { OutputWebSearchCallItem } from '../models/outputwebsearchcallitem.js';
+import type { StreamEvents } from '../models/streamevents.js';
+import type { ClaudeMessage, UnsupportedContent } from '../models/claude-message.js';
+import type { ReusableReadableStream } from './reusable-stream.js';
+import type { ParsedToolCall, Tool } from './tool-types.js';
+/**
+ * Extract text deltas from responses stream events
+ */
+export declare function extractTextDeltas(stream: ReusableReadableStream<StreamEvents>): AsyncIterableIterator<string>;
+/**
+ * Extract reasoning deltas from responses stream events
+ */
+export declare function extractReasoningDeltas(stream: ReusableReadableStream<StreamEvents>): AsyncIterableIterator<string>;
+/**
+ * Extract tool call argument deltas from responses stream events
+ */
+export declare function extractToolDeltas(stream: ReusableReadableStream<StreamEvents>): AsyncIterableIterator<string>;
+/**
+ * Build incremental message updates from responses stream events
+ * Returns OutputMessage (assistant/responses format)
+ */
+export declare function buildResponsesMessageStream(stream: ReusableReadableStream<StreamEvents>): AsyncIterableIterator<OutputMessage>;
+/**
+ * Output item types that can be streamed from a response.
+ * This is the union of all item types that appear in response output,
+ * plus function_call_output for tool results.
+ */
+export type StreamableOutputItem = OutputMessage | OutputFunctionCallItem | OutputReasoningItem | OutputWebSearchCallItem | OutputFileSearchCallItem | OutputImageGenerationCallItem | FunctionCallOutputItem;
+/**
+ * Discriminated union for tracking items in progress.
+ * Each variant has only the fields relevant to that item type.
+ */
+export type ItemInProgress = {
+    type: 'message';
+    id: string;
+    textContent: string;
+} | {
+    type: 'function_call';
+    id: string;
+    name: string;
+    callId: string;
+    argumentsAccumulated: string;
+} | {
+    type: 'reasoning';
+    id: string;
+    reasoningContent: string;
+};
+type ItemsStreamHandler = (event: StreamEvents, itemsInProgress: Map<string, ItemInProgress>) => StreamableOutputItem | undefined;
+export declare const itemsStreamHandlers: Record<string, ItemsStreamHandler>;
+export declare const streamTerminationEvents: Set<string>;
+/**
+ * Build incremental output item updates from responses stream events.
+ * Yields all item types cumulatively - same item may be emitted multiple times
+ * with the same ID but progressively updated content as streaming progresses.
+ */
+export declare function buildItemsStream(stream: ReusableReadableStream<StreamEvents>): AsyncIterableIterator<StreamableOutputItem>;
+/**
+ * Build incremental message updates from responses stream events
+ * Returns ChatAssistantMessage (chat format) instead of OutputMessage
+ */
+export declare function buildMessageStream(stream: ReusableReadableStream<StreamEvents>): AsyncIterableIterator<ChatAssistantMessage>;
+/**
+ * Consume stream until completion and return the complete response
+ */
+export declare function consumeStreamForCompletion(stream: ReusableReadableStream<StreamEvents>): Promise<OpenResponsesResult>;
+/**
+ * Extract the first message from a completed response (chat format)
+ */
+export declare function extractMessageFromResponse(response: OpenResponsesResult): ChatAssistantMessage;
+/**
+ * Extract the first message from a completed response (responses format)
+ */
+export declare function extractResponsesMessageFromResponse(response: OpenResponsesResult): OutputMessage;
+/**
+ * Extract text from a response, either from outputText or by concatenating message content
+ */
+export declare function extractTextFromResponse(response: OpenResponsesResult): string;
+/**
+ * Extract all tool calls from a completed response
+ * Returns parsed tool calls with arguments as objects (not JSON strings)
+ */
+export declare function extractToolCallsFromResponse(response: OpenResponsesResult): ParsedToolCall<Tool>[];
+/**
+ * Build incremental tool call updates from responses stream events
+ * Yields structured tool call objects as they're built from deltas
+ */
+export declare function buildToolCallStream(stream: ReusableReadableStream<StreamEvents>): AsyncIterableIterator<ParsedToolCall<Tool>>;
+/**
+ * Check if a response contains any tool calls
+ */
+export declare function responseHasToolCalls(response: OpenResponsesResult): boolean;
+/**
+ * Convert OpenResponsesResult to ClaudeMessage format
+ * Compatible with the Anthropic SDK BetaMessage type
+ */
+export declare function convertToClaudeMessage(response: OpenResponsesResult): ClaudeMessage;
+/**
+ * Extract unsupported content by original type
+ */
+export declare function extractUnsupportedContent(message: ClaudeMessage, originalType: string): UnsupportedContent[];
+/**
+ * Check if message has any unsupported content
+ */
+export declare function hasUnsupportedContent(message: ClaudeMessage): boolean;
+/**
+ * Get summary of unsupported content types
+ */
+export declare function getUnsupportedContentSummary(message: ClaudeMessage): Record<string, number>;
+export {};
+//# sourceMappingURL=stream-transformers.d.ts.map

package/esm/lib/stream-transformers.d.ts.map

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