@aexol/spectral 0.9.221 → 0.9.222

package/dist/sdk/agent-core/harness/utils/shell-output.js

@@ -1,125 +0,0 @@
-import { ExecutionError, err, ok, toError, } from "../types.js";
-import { DEFAULT_MAX_BYTES, truncateTail } from "./truncate.js";
-function toExecutionError(error) {
-    if (error instanceof ExecutionError)
-        return error;
-    const cause = toError(error);
-    return new ExecutionError("unknown", cause.message, cause);
-}
-export function sanitizeBinaryOutput(str) {
-    return Array.from(str)
-        .filter((char) => {
-        const code = char.codePointAt(0);
-        if (code === undefined)
-            return false;
-        if (code === 0x09 || code === 0x0a || code === 0x0d)
-            return true;
-        if (code <= 0x1f)
-            return false;
-        if (code >= 0xfff9 && code <= 0xfffb)
-            return false;
-        return true;
-    })
-        .join("");
-}
-export async function executeShellWithCapture(env, command, options) {
-    const outputChunks = [];
-    let outputBytes = 0;
-    const maxOutputBytes = DEFAULT_MAX_BYTES * 2;
-    const encoder = new TextEncoder();
-    let totalBytes = 0;
-    let fullOutputPath;
-    let writeChain = Promise.resolve(ok(undefined));
-    let captureError;
-    const appendFullOutput = (text) => {
-        if (!fullOutputPath || captureError)
-            return;
-        const path = fullOutputPath;
-        writeChain = writeChain.then(async (previous) => {
-            if (!previous.ok)
-                return previous;
-            const appendResult = await env.appendFile(path, text, options?.abortSignal);
-            return appendResult.ok ? ok(undefined) : err(toExecutionError(appendResult.error));
-        });
-    };
-    const ensureFullOutputFile = (initialContent) => {
-        if (fullOutputPath || captureError)
-            return;
-        writeChain = writeChain.then(async (previous) => {
-            if (!previous.ok)
-                return previous;
-            const tempFile = await env.createTempFile({
-                prefix: "bash-",
-                suffix: ".log",
-                abortSignal: options?.abortSignal,
-            });
-            if (!tempFile.ok)
-                return err(toExecutionError(tempFile.error));
-            fullOutputPath = tempFile.value;
-            const appendResult = await env.appendFile(tempFile.value, initialContent, options?.abortSignal);
-            return appendResult.ok ? ok(undefined) : err(toExecutionError(appendResult.error));
-        });
-    };
-    const onChunk = (chunk) => {
-        try {
-            totalBytes += encoder.encode(chunk).byteLength;
-            const text = sanitizeBinaryOutput(chunk).replace(/\r/g, "");
-            if (totalBytes > DEFAULT_MAX_BYTES && !fullOutputPath) {
-                ensureFullOutputFile(outputChunks.join("") + text);
-            }
-            else {
-                appendFullOutput(text);
-            }
-            outputChunks.push(text);
-            outputBytes += text.length;
-            while (outputBytes > maxOutputBytes && outputChunks.length > 1) {
-                const removed = outputChunks.shift();
-                outputBytes -= removed.length;
-            }
-            options?.onChunk?.(text);
-        }
-        catch (error) {
-            captureError = toExecutionError(error);
-        }
-    };
-    try {
-        const result = await env.exec(command, {
-            ...(options ?? {}),
-            onStdout: onChunk,
-            onStderr: onChunk,
-        });
-        const tailOutput = outputChunks.join("");
-        const truncationResult = truncateTail(tailOutput);
-        if (truncationResult.truncated && !fullOutputPath) {
-            ensureFullOutputFile(tailOutput);
-        }
-        const writeResult = await writeChain;
-        if (!writeResult.ok)
-            return err(writeResult.error);
-        if (captureError)
-            return err(captureError);
-        if (!result.ok) {
-            if (result.error.code === "aborted" || options?.abortSignal?.aborted) {
-                return ok({
-                    output: truncationResult.truncated ? truncationResult.content : tailOutput,
-                    exitCode: undefined,
-                    cancelled: true,
-                    truncated: truncationResult.truncated,
-                    fullOutputPath,
-                });
-            }
-            return err(result.error);
-        }
-        const cancelled = options?.abortSignal?.aborted ?? false;
-        return ok({
-            output: truncationResult.truncated ? truncationResult.content : tailOutput,
-            exitCode: cancelled ? undefined : result.value.exitCode,
-            cancelled,
-            truncated: truncationResult.truncated,
-            fullOutputPath,
-        });
-    }
-    catch (error) {
-        return err(toExecutionError(error));
-    }
-}

package/dist/sdk/agent-core/node.d.ts

@@ -1,3 +0,0 @@
-export { NodeExecutionEnv } from "./harness/env/nodejs.js";
-export * from "./index.js";
-//# sourceMappingURL=node.d.ts.map

package/dist/sdk/agent-core/node.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"node.d.ts","sourceRoot":"","sources":["../../../src/sdk/agent-core/node.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAC3D,cAAc,YAAY,CAAC"}

package/dist/sdk/agent-core/node.js

@@ -1,2 +0,0 @@
-export { NodeExecutionEnv } from "./harness/env/nodejs.js";
-export * from "./index.js";

package/dist/sdk/agent-core/proxy.d.ts

@@ -1,69 +0,0 @@
-/**
- * Proxy stream function for apps that route LLM calls through a server.
- * The server manages auth and proxies requests to LLM providers.
- */
-import { type AssistantMessage, type AssistantMessageEvent, type Context, EventStream, type Model, type SimpleStreamOptions, type StopReason } from "../ai/index.js";
-declare class ProxyMessageEventStream extends EventStream<AssistantMessageEvent, AssistantMessage> {
-    constructor();
-}
-/**
- * Proxy event types - server sends these with partial field stripped to reduce bandwidth.
- */
-export type ProxyAssistantMessageEvent = {
-    type: "start";
-} | {
-    type: "text_start";
-    contentIndex: number;
-} | {
-    type: "text_delta";
-    contentIndex: number;
-    delta: string;
-} | {
-    type: "text_end";
-    contentIndex: number;
-    contentSignature?: string;
-} | {
-    type: "thinking_start";
-    contentIndex: number;
-} | {
-    type: "thinking_delta";
-    contentIndex: number;
-    delta: string;
-} | {
-    type: "thinking_end";
-    contentIndex: number;
-    contentSignature?: string;
-} | {
-    type: "toolcall_start";
-    contentIndex: number;
-    id: string;
-    toolName: string;
-} | {
-    type: "toolcall_delta";
-    contentIndex: number;
-    delta: string;
-} | {
-    type: "toolcall_end";
-    contentIndex: number;
-} | {
-    type: "done";
-    reason: Extract<StopReason, "stop" | "length" | "toolUse">;
-    usage: AssistantMessage["usage"];
-} | {
-    type: "error";
-    reason: Extract<StopReason, "aborted" | "error">;
-    errorMessage?: string;
-    usage: AssistantMessage["usage"];
-};
-type ProxySerializableStreamOptions = Pick<SimpleStreamOptions, "temperature" | "maxTokens" | "reasoning" | "cacheRetention" | "sessionId" | "headers" | "metadata" | "transport" | "thinkingBudgets" | "maxRetryDelayMs">;
-export interface ProxyStreamOptions extends ProxySerializableStreamOptions {
-    /** Local abort signal for the proxy request */
-    signal?: AbortSignal;
-    /** Auth token for the proxy server */
-    authToken: string;
-    /** Proxy server URL (e.g., "https://genai.example.com") */
-    proxyUrl: string;
-}
-export declare function streamProxy(model: Model<any>, context: Context, options: ProxyStreamOptions): ProxyMessageEventStream;
-export {};
-//# sourceMappingURL=proxy.d.ts.map

package/dist/sdk/agent-core/proxy.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"proxy.d.ts","sourceRoot":"","sources":["../../../src/sdk/agent-core/proxy.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,EACN,KAAK,gBAAgB,EACrB,KAAK,qBAAqB,EAC1B,KAAK,OAAO,EACZ,WAAW,EACX,KAAK,KAAK,EAEV,KAAK,mBAAmB,EACxB,KAAK,UAAU,EAEf,MAAM,gBAAgB,CAAC;AAGxB,cAAM,uBAAwB,SAAQ,WAAW,CAAC,qBAAqB,EAAE,gBAAgB,CAAC;;CAWzF;AAED;;GAEG;AACH,MAAM,MAAM,0BAA0B,GACnC;IAAE,IAAI,EAAE,OAAO,CAAA;CAAE,GACjB;IAAE,IAAI,EAAE,YAAY,CAAC;IAAC,YAAY,EAAE,MAAM,CAAA;CAAE,GAC5C;IAAE,IAAI,EAAE,YAAY,CAAC;IAAC,YAAY,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GAC3D;IAAE,IAAI,EAAE,UAAU,CAAC;IAAC,YAAY,EAAE,MAAM,CAAC;IAAC,gBAAgB,CAAC,EAAE,MAAM,CAAA;CAAE,GACrE;IAAE,IAAI,EAAE,gBAAgB,CAAC;IAAC,YAAY,EAAE,MAAM,CAAA;CAAE,GAChD;IAAE,IAAI,EAAE,gBAAgB,CAAC;IAAC,YAAY,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GAC/D;IAAE,IAAI,EAAE,cAAc,CAAC;IAAC,YAAY,EAAE,MAAM,CAAC;IAAC,gBAAgB,CAAC,EAAE,MAAM,CAAA;CAAE,GACzE;IAAE,IAAI,EAAE,gBAAgB,CAAC;IAAC,YAAY,EAAE,MAAM,CAAC;IAAC,EAAE,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,GAC9E;IAAE,IAAI,EAAE,gBAAgB,CAAC;IAAC,YAAY,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GAC/D;IAAE,IAAI,EAAE,cAAc,CAAC;IAAC,YAAY,EAAE,MAAM,CAAA;CAAE,GAC9C;IACA,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,OAAO,CAAC,UAAU,EAAE,MAAM,GAAG,QAAQ,GAAG,SAAS,CAAC,CAAC;IAC3D,KAAK,EAAE,gBAAgB,CAAC,OAAO,CAAC,CAAC;CAChC,GACD;IACA,IAAI,EAAE,OAAO,CAAC;IACd,MAAM,EAAE,OAAO,CAAC,UAAU,EAAE,SAAS,GAAG,OAAO,CAAC,CAAC;IACjD,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,KAAK,EAAE,gBAAgB,CAAC,OAAO,CAAC,CAAC;CAChC,CAAC;AAEL,KAAK,8BAA8B,GAAG,IAAI,CACzC,mBAAmB,EACjB,aAAa,GACb,WAAW,GACX,WAAW,GACX,gBAAgB,GAChB,WAAW,GACX,SAAS,GACT,UAAU,GACV,WAAW,GACX,iBAAiB,GACjB,iBAAiB,CACnB,CAAC;AAEF,MAAM,WAAW,kBAAmB,SAAQ,8BAA8B;IACzE,+CAA+C;IAC/C,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,sCAAsC;IACtC,SAAS,EAAE,MAAM,CAAC;IAClB,2DAA2D;IAC3D,QAAQ,EAAE,MAAM,CAAC;CACjB;AAoCD,wBAAgB,WAAW,CAAC,KAAK,EAAE,KAAK,CAAC,GAAG,CAAC,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,kBAAkB,GAAG,uBAAuB,CAqHrH"}

package/dist/sdk/agent-core/proxy.js

@@ -1,297 +0,0 @@
-/**
- * Proxy stream function for apps that route LLM calls through a server.
- * The server manages auth and proxies requests to LLM providers.
- */
-// Internal import for JSON parsing utility
-import { EventStream, parseStreamingJsonResult, } from "../ai/index.js";
-// Create stream class matching ProxyMessageEventStream
-class ProxyMessageEventStream extends EventStream {
-    constructor() {
-        super((event) => event.type === "done" || event.type === "error", (event) => {
-            if (event.type === "done")
-                return event.message;
-            if (event.type === "error")
-                return event.error;
-            throw new Error("Unexpected event type");
-        });
-    }
-}
-/**
- * Stream function that proxies through a server instead of calling LLM providers directly.
- * The server strips the partial field from delta events to reduce bandwidth.
- * We reconstruct the partial message client-side.
- *
- * Use this as the `streamFn` option when creating an Agent that needs to go through a proxy.
- *
- * @example
- * ```typescript
- * const agent = new Agent({
- *   streamFn: (model, context, options) =>
- *     streamProxy(model, context, {
- *       ...options,
- *       authToken: await getAuthToken(),
- *       proxyUrl: "https://genai.example.com",
- *     }),
- * });
- * ```
- */
-function buildProxyRequestOptions(options) {
-    return {
-        temperature: options.temperature,
-        maxTokens: options.maxTokens,
-        reasoning: options.reasoning,
-        cacheRetention: options.cacheRetention,
-        sessionId: options.sessionId,
-        headers: options.headers,
-        metadata: options.metadata,
-        transport: options.transport,
-        thinkingBudgets: options.thinkingBudgets,
-        maxRetryDelayMs: options.maxRetryDelayMs,
-    };
-}
-export function streamProxy(model, context, options) {
-    const stream = new ProxyMessageEventStream();
-    (async () => {
-        // Initialize the partial message that we'll build up from events
-        const partial = {
-            role: "assistant",
-            stopReason: "stop",
-            content: [],
-            api: model.api,
-            provider: model.provider,
-            model: model.id,
-            usage: {
-                input: 0,
-                output: 0,
-                cacheRead: 0,
-                cacheWrite: 0,
-                totalTokens: 0,
-                cost: { input: 0, output: 0, cacheRead: 0, cacheWrite: 0, total: 0 },
-            },
-            timestamp: Date.now(),
-        };
-        let reader;
-        const abortHandler = () => {
-            if (reader) {
-                reader.cancel("Request aborted by user").catch(() => { });
-            }
-        };
-        if (options.signal) {
-            options.signal.addEventListener("abort", abortHandler);
-        }
-        try {
-            const response = await fetch(`${options.proxyUrl}/api/stream`, {
-                method: "POST",
-                headers: {
-                    Authorization: `Bearer ${options.authToken}`,
-                    "Content-Type": "application/json",
-                },
-                body: JSON.stringify({
-                    model,
-                    context,
-                    options: buildProxyRequestOptions(options),
-                }),
-                signal: options.signal,
-            });
-            if (!response.ok) {
-                let errorMessage = `Proxy error: ${response.status} ${response.statusText}`;
-                try {
-                    const errorData = (await response.json());
-                    if (errorData.error) {
-                        errorMessage = `Proxy error: ${errorData.error}`;
-                    }
-                }
-                catch {
-                    // Couldn't parse error response
-                }
-                throw new Error(errorMessage);
-            }
-            reader = response.body.getReader();
-            const decoder = new TextDecoder();
-            let buffer = "";
-            while (true) {
-                const { done, value } = await reader.read();
-                if (done)
-                    break;
-                if (options.signal?.aborted) {
-                    throw new Error("Request aborted by user");
-                }
-                buffer += decoder.decode(value, { stream: true });
-                const lines = buffer.split("\n");
-                buffer = lines.pop() || "";
-                for (const line of lines) {
-                    if (line.startsWith("data: ")) {
-                        const data = line.slice(6).trim();
-                        if (data) {
-                            const proxyEvent = JSON.parse(data);
-                            const event = processProxyEvent(proxyEvent, partial);
-                            if (event) {
-                                stream.push(event);
-                            }
-                        }
-                    }
-                }
-            }
-            if (options.signal?.aborted) {
-                throw new Error("Request aborted by user");
-            }
-            stream.end();
-        }
-        catch (error) {
-            const errorMessage = error instanceof Error ? error.message : String(error);
-            const reason = options.signal?.aborted ? "aborted" : "error";
-            partial.stopReason = reason;
-            partial.errorMessage = errorMessage;
-            stream.push({
-                type: "error",
-                reason,
-                error: partial,
-            });
-            stream.end();
-        }
-        finally {
-            if (options.signal) {
-                options.signal.removeEventListener("abort", abortHandler);
-            }
-        }
-    })();
-    return stream;
-}
-/**
- * Process a proxy event and update the partial message.
- */
-function processProxyEvent(proxyEvent, partial) {
-    switch (proxyEvent.type) {
-        case "start":
-            return { type: "start", partial };
-        case "text_start":
-            partial.content[proxyEvent.contentIndex] = { type: "text", text: "" };
-            return { type: "text_start", contentIndex: proxyEvent.contentIndex, partial };
-        case "text_delta": {
-            const content = partial.content[proxyEvent.contentIndex];
-            if (content?.type === "text") {
-                content.text += proxyEvent.delta;
-                return {
-                    type: "text_delta",
-                    contentIndex: proxyEvent.contentIndex,
-                    delta: proxyEvent.delta,
-                    partial,
-                };
-            }
-            throw new Error("Received text_delta for non-text content");
-        }
-        case "text_end": {
-            const content = partial.content[proxyEvent.contentIndex];
-            if (content?.type === "text") {
-                content.textSignature = proxyEvent.contentSignature;
-                return {
-                    type: "text_end",
-                    contentIndex: proxyEvent.contentIndex,
-                    content: content.text,
-                    partial,
-                };
-            }
-            throw new Error("Received text_end for non-text content");
-        }
-        case "thinking_start":
-            partial.content[proxyEvent.contentIndex] = { type: "thinking", thinking: "" };
-            return { type: "thinking_start", contentIndex: proxyEvent.contentIndex, partial };
-        case "thinking_delta": {
-            const content = partial.content[proxyEvent.contentIndex];
-            if (content?.type === "thinking") {
-                content.thinking += proxyEvent.delta;
-                return {
-                    type: "thinking_delta",
-                    contentIndex: proxyEvent.contentIndex,
-                    delta: proxyEvent.delta,
-                    partial,
-                };
-            }
-            throw new Error("Received thinking_delta for non-thinking content");
-        }
-        case "thinking_end": {
-            const content = partial.content[proxyEvent.contentIndex];
-            if (content?.type === "thinking") {
-                content.thinkingSignature = proxyEvent.contentSignature;
-                return {
-                    type: "thinking_end",
-                    contentIndex: proxyEvent.contentIndex,
-                    content: content.thinking,
-                    partial,
-                };
-            }
-            throw new Error("Received thinking_end for non-thinking content");
-        }
-        case "toolcall_start":
-            partial.content[proxyEvent.contentIndex] = {
-                type: "toolCall",
-                id: proxyEvent.id,
-                name: proxyEvent.toolName,
-                arguments: {},
-                partialJson: "",
-            };
-            return { type: "toolcall_start", contentIndex: proxyEvent.contentIndex, partial };
-        case "toolcall_delta": {
-            const content = partial.content[proxyEvent.contentIndex];
-            if (content?.type === "toolCall") {
-                content.partialJson += proxyEvent.delta;
-                // A provider is allowed to split a JSON token across arbitrary chunks.
-                // In particular, the first chunk may be `{"p`, which is not useful to
-                // the strict streaming parser yet.  Never turn that transient state into
-                // a stream error: doing so aborts the whole agent loop before `done` (and
-                // before the loop can apply its truncated-tool-call recovery).
-                try {
-                    content.arguments = parseStreamingJsonResult(content.partialJson).value;
-                }
-                catch {
-                    // Keep the last observable arguments.  toolcall_end still receives the
-                    // complete accumulated JSON and can update this value when possible.
-                }
-                partial.content[proxyEvent.contentIndex] = { ...content }; // Trigger reactivity
-                return {
-                    type: "toolcall_delta",
-                    contentIndex: proxyEvent.contentIndex,
-                    delta: proxyEvent.delta,
-                    partial,
-                };
-            }
-            throw new Error("Received toolcall_delta for non-toolCall content");
-        }
-        case "toolcall_end": {
-            const content = partial.content[proxyEvent.contentIndex];
-            if (content?.type === "toolCall") {
-                try {
-                    const parsed = parseStreamingJsonResult(content.partialJson);
-                    content.arguments = parsed.value;
-                }
-                catch {
-                    // Preserve the last partial value rather than failing the response
-                    // stream. The agent loop will validate required arguments and return
-                    // a retryable tool error if the provider really truncated the call.
-                }
-                delete content.partialJson;
-                return {
-                    type: "toolcall_end",
-                    contentIndex: proxyEvent.contentIndex,
-                    toolCall: content,
-                    partial,
-                };
-            }
-            return undefined;
-        }
-        case "done":
-            partial.stopReason = proxyEvent.reason;
-            partial.usage = proxyEvent.usage;
-            return { type: "done", reason: proxyEvent.reason, message: partial };
-        case "error":
-            partial.stopReason = proxyEvent.reason;
-            partial.errorMessage = proxyEvent.errorMessage;
-            partial.usage = proxyEvent.usage;
-            return { type: "error", reason: proxyEvent.reason, error: partial };
-        default: {
-            const _exhaustiveCheck = proxyEvent;
-            console.warn(`Unhandled proxy event type: ${proxyEvent.type}`);
-            return undefined;
-        }
-    }
-}