@sovara/sdk 0.0.0-stage → 0.9.1

package/dist/payload/filterDict.js

@@ -0,0 +1,26 @@
+import { readFileSync } from "node:fs";
+import { fileURLToPath } from "node:url";
+import { flatten, flattenKeepList, orderedUnflattenList } from "./flatten.js";
+const patternSpec = JSON.parse(readFileSync(fileURLToPath(new URL("./editIoExcludePatterns.json", import.meta.url)), "utf8"));
+const EDIT_IO_EXCLUDE_PATTERNS = patternSpec.map((entry) => new RegExp(entry.pattern, entry.flags ?? ""));
+export function shouldExcludeKey(key) {
+    return EDIT_IO_EXCLUDE_PATTERNS.some((pattern) => pattern.test(key));
+}
+export function filterDict(input) {
+    const flat = flatten(input, ".");
+    const filteredEntries = Object.entries(flat).filter(([key, value]) => {
+        if (shouldExcludeKey(key)) {
+            return false;
+        }
+        if (Array.isArray(value) && value.length === 0) {
+            return false;
+        }
+        if (value && typeof value === "object" && !Array.isArray(value) && Object.keys(value).length === 0) {
+            return false;
+        }
+        return true;
+    });
+    const unflattened = orderedUnflattenList(Object.fromEntries(filteredEntries), ".");
+    return flattenKeepList(unflattened);
+}
+//# sourceMappingURL=filterDict.js.map

package/dist/payload/filterDict.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"filterDict.js","sourceRoot":"","sources":["../../src/payload/filterDict.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACvC,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AACzC,OAAO,EAAE,OAAO,EAAE,eAAe,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAC;AAI9E,MAAM,WAAW,GAAG,IAAI,CAAC,KAAK,CAC5B,YAAY,CACV,aAAa,CAAC,IAAI,GAAG,CAAC,8BAA8B,EAAE,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EACvE,MAAM,CACP,CACgB,CAAC;AAEpB,MAAM,wBAAwB,GAAa,WAAW,CAAC,GAAG,CACxD,CAAC,KAAK,EAAE,EAAE,CAAC,IAAI,MAAM,CAAC,KAAK,CAAC,OAAO,EAAE,KAAK,CAAC,KAAK,IAAI,EAAE,CAAC,CACxD,CAAC;AAEF,MAAM,UAAU,gBAAgB,CAAC,GAAW;IAC1C,OAAO,wBAAwB,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;AACvE,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,KAAc;IACvC,MAAM,IAAI,GAAG,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;IACjC,MAAM,eAAe,GAAG,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,GAAG,EAAE,KAAK,CAAC,EAAE,EAAE;QACnE,IAAI,gBAAgB,CAAC,GAAG,CAAC,EAAE,CAAC;YAC1B,OAAO,KAAK,CAAC;QACf,CAAC;QACD,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC/C,OAAO,KAAK,CAAC;QACf,CAAC;QACD,IAAI,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACnG,OAAO,KAAK,CAAC;QACf,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC,CAAC,CAAC;IAEH,MAAM,WAAW,GAAG,oBAAoB,CAAC,MAAM,CAAC,WAAW,CAAC,eAAe,CAAC,EAAE,GAAG,CAAC,CAAC;IACnF,OAAO,eAAe,CAAC,WAAW,CAAC,CAAC;AACtC,CAAC"}

package/dist/payload/flatten.d.ts

@@ -0,0 +1,6 @@
+export declare function flatten(input: unknown, separator?: string): Record<string, unknown>;
+export declare function unflatten(flat: Record<string, unknown>, separator?: string): Record<string, unknown>;
+export declare function flattenKeepList(input: unknown): Record<string, unknown>;
+export declare function convertDenseNumericDictsToLists(value: unknown): unknown;
+export declare function orderedUnflattenList(flatDict: Record<string, unknown>, separator?: string): unknown;
+//# sourceMappingURL=flatten.d.ts.map

package/dist/payload/flatten.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"flatten.d.ts","sourceRoot":"","sources":["../../src/payload/flatten.ts"],"names":[],"mappings":"AAMA,wBAAgB,OAAO,CAAC,KAAK,EAAE,OAAO,EAAE,SAAS,SAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAKhF;AAED,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,SAAS,SAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAEjG;AAED,wBAAgB,eAAe,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CA6BvE;AAED,wBAAgB,+BAA+B,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAmCvE;AAED,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,SAAS,SAAM,GAAG,OAAO,CAKhG"}

package/dist/payload/flatten.js

@@ -0,0 +1,79 @@
+import { flatten as flatFlatten, unflatten as flatUnflatten } from "flat";
+function isPlainObject(value) {
+    return value !== null && typeof value === "object" && !Array.isArray(value);
+}
+export function flatten(input, separator = ".") {
+    if (isPlainObject(input) || Array.isArray(input)) {
+        return flatFlatten(input, { delimiter: separator });
+    }
+    return {};
+}
+export function unflatten(flat, separator = ".") {
+    return flatUnflatten(flat, { delimiter: separator });
+}
+export function flattenKeepList(input) {
+    function recurse(value) {
+        if (isPlainObject(value)) {
+            const out = {};
+            const walk = (node, prefix) => {
+                for (const [key, child] of Object.entries(node)) {
+                    const path = prefix ? `${prefix}.${key}` : key;
+                    if (Array.isArray(child)) {
+                        out[path] = child.map((item) => recurse(item));
+                    }
+                    else if (isPlainObject(child)) {
+                        walk(child, path);
+                    }
+                    else {
+                        out[path] = child;
+                    }
+                }
+            };
+            walk(value, "");
+            return out;
+        }
+        if (Array.isArray(value)) {
+            return value.map((item) => recurse(item));
+        }
+        return value;
+    }
+    const result = recurse(input);
+    return isPlainObject(result) ? result : {};
+}
+export function convertDenseNumericDictsToLists(value) {
+    if (Array.isArray(value)) {
+        return value.map((item) => convertDenseNumericDictsToLists(item));
+    }
+    if (!isPlainObject(value)) {
+        return value;
+    }
+    const converted = {};
+    for (const [key, child] of Object.entries(value)) {
+        converted[key] = convertDenseNumericDictsToLists(child);
+    }
+    const keys = Object.keys(converted);
+    if (keys.length === 0) {
+        return converted;
+    }
+    const numericIndexes = [];
+    for (const key of keys) {
+        if (!/^\d+$/.test(key)) {
+            return converted;
+        }
+        numericIndexes.push(Number(key));
+    }
+    numericIndexes.sort((a, b) => a - b);
+    for (let i = 0; i < numericIndexes.length; i += 1) {
+        if (numericIndexes[i] !== i) {
+            return converted;
+        }
+    }
+    return numericIndexes.map((index) => converted[String(index)]);
+}
+export function orderedUnflattenList(flatDict, separator = ".") {
+    if (Object.keys(flatDict).length === 0) {
+        return {};
+    }
+    return convertDenseNumericDictsToLists(unflatten(flatDict, separator));
+}
+//# sourceMappingURL=flatten.js.map

package/dist/payload/flatten.js.map

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

package/dist/payload/wrap.d.ts

@@ -0,0 +1,10 @@
+export type StorageEnvelope<T = unknown> = {
+    raw: T;
+    to_show: Record<string, unknown>;
+};
+export type StorageEnvelopeOptions = {
+    apiType?: string;
+    direction?: "input" | "output";
+};
+export declare function wrapForStorage<T>(raw: T, options?: StorageEnvelopeOptions): StorageEnvelope<T>;
+//# sourceMappingURL=wrap.d.ts.map

package/dist/payload/wrap.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"wrap.d.ts","sourceRoot":"","sources":["../../src/payload/wrap.ts"],"names":[],"mappings":"AAIA,MAAM,MAAM,eAAe,CAAC,CAAC,GAAG,OAAO,IAAI;IACzC,GAAG,EAAE,CAAC,CAAC;IACP,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAClC,CAAC;AAEF,MAAM,MAAM,sBAAsB,GAAG;IACnC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,OAAO,GAAG,QAAQ,CAAC;CAChC,CAAC;AAkGF,wBAAgB,cAAc,CAAC,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,OAAO,CAAC,EAAE,sBAAsB,GAAG,eAAe,CAAC,CAAC,CAAC,CAK9F"}

package/dist/payload/wrap.js

@@ -0,0 +1,82 @@
+import { filterDict, shouldExcludeKey } from "./filterDict.js";
+import { flattenKeepList } from "./flatten.js";
+import { API_TYPE_OPENAI_AGENTS_FUNCTION_TOOL_RUN } from "../apiTypes.js";
+function isRecord(value) {
+    return Boolean(value) && typeof value === "object" && !Array.isArray(value);
+}
+function filterTraceNested(value) {
+    if (Array.isArray(value)) {
+        return value.map((item) => filterTraceNested(item));
+    }
+    if (!isRecord(value)) {
+        return value;
+    }
+    return Object.fromEntries(Object.entries(value)
+        .filter(([key]) => !shouldExcludeKey(key))
+        .filter(([, item]) => !(Array.isArray(item) && item.length === 0))
+        .filter(([, item]) => !(isRecord(item) && Object.keys(item).length === 0))
+        .map(([key, item]) => [key, filterTraceNested(item)]));
+}
+function flattenTraceValue(value) {
+    const filtered = filterTraceNested(value);
+    if (Array.isArray(filtered)) {
+        return filtered.map((item) => flattenTraceValue(item));
+    }
+    if (!isRecord(filtered)) {
+        return filtered;
+    }
+    const flattened = flattenKeepList(filtered);
+    if (!isRecord(flattened)) {
+        return flattened;
+    }
+    return Object.fromEntries(Object.entries(flattened)
+        .filter(([key, item]) => !shouldExcludeKey(key) && item !== undefined)
+        .filter(([, item]) => !(Array.isArray(item) && item.length === 0))
+        .filter(([, item]) => !(isRecord(item) && Object.keys(item).length === 0)));
+}
+function buildTraceInputToShow(raw) {
+    if (!isRecord(raw)) {
+        return filterDict(raw);
+    }
+    const toolInput = raw.tool_input;
+    if (!isRecord(toolInput)) {
+        return { tool_input: flattenTraceValue(toolInput) };
+    }
+    return Object.fromEntries(Object.entries(toolInput)
+        .filter(([key, item]) => !shouldExcludeKey(key) && item !== undefined)
+        .filter(([, item]) => !(Array.isArray(item) && item.length === 0))
+        .filter(([, item]) => !(isRecord(item) && Object.keys(item).length === 0))
+        .map(([key, item]) => [key, flattenTraceValue(item)]));
+}
+function buildTraceOutputToShow(raw) {
+    if (!isRecord(raw)) {
+        return filterDict(raw);
+    }
+    if (raw.status === "error") {
+        return Object.fromEntries(["status", "error_type", "error_message"]
+            .filter((key) => key in raw)
+            .map((key) => [key, raw[key]]));
+    }
+    const toolOutput = flattenTraceValue(raw.tool_output);
+    if (isRecord(toolOutput)) {
+        return toolOutput;
+    }
+    return { tool_output: toolOutput };
+}
+function buildToShow(raw, options) {
+    if (options?.apiType !== "sovara.trace" &&
+        options?.apiType !== API_TYPE_OPENAI_AGENTS_FUNCTION_TOOL_RUN) {
+        return filterDict(raw);
+    }
+    if (options.direction === "output") {
+        return buildTraceOutputToShow(raw);
+    }
+    return buildTraceInputToShow(raw);
+}
+export function wrapForStorage(raw, options) {
+    return {
+        raw,
+        to_show: buildToShow(raw, options),
+    };
+}
+//# sourceMappingURL=wrap.js.map

package/dist/payload/wrap.js.map

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

package/dist/platformSession.d.ts

@@ -0,0 +1,3 @@
+export declare function desktopPlatformSessionPath(home?: string): string;
+export declare function readDesktopPlatformSessionToken(home?: string): string | null;
+//# sourceMappingURL=platformSession.d.ts.map

package/dist/platformSession.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"platformSession.d.ts","sourceRoot":"","sources":["../src/platformSession.ts"],"names":[],"mappings":"AAUA,wBAAgB,0BAA0B,CAAC,IAAI,GAAE,MAAkB,GAAG,MAAM,CAE3E;AAED,wBAAgB,+BAA+B,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAc5E"}

package/dist/platformSession.js

@@ -0,0 +1,21 @@
+import { readFileSync } from "node:fs";
+import { homedir } from "node:os";
+import { join } from "node:path";
+export function desktopPlatformSessionPath(home = homedir()) {
+    return join(home, ".sovara", "app_session.json");
+}
+export function readDesktopPlatformSessionToken(home) {
+    try {
+        const session = JSON.parse(readFileSync(desktopPlatformSessionPath(home), "utf8"));
+        const token = typeof session.session_token === "string" ? session.session_token.trim() : "";
+        const expiresAt = typeof session.expires_at === "string" ? Date.parse(session.expires_at) : NaN;
+        if (session.version !== 1 || !token || !Number.isFinite(expiresAt) || expiresAt <= Date.now()) {
+            return null;
+        }
+        return token;
+    }
+    catch {
+        return null;
+    }
+}
+//# sourceMappingURL=platformSession.js.map

package/dist/platformSession.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"platformSession.js","sourceRoot":"","sources":["../src/platformSession.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACvC,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAClC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAQjC,MAAM,UAAU,0BAA0B,CAAC,OAAe,OAAO,EAAE;IACjE,OAAO,IAAI,CAAC,IAAI,EAAE,SAAS,EAAE,kBAAkB,CAAC,CAAC;AACnD,CAAC;AAED,MAAM,UAAU,+BAA+B,CAAC,IAAa;IAC3D,IAAI,CAAC;QACH,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CACxB,YAAY,CAAC,0BAA0B,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC,CACpB,CAAC;QACrC,MAAM,KAAK,GAAG,OAAO,OAAO,CAAC,aAAa,KAAK,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC,aAAa,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC5F,MAAM,SAAS,GAAG,OAAO,OAAO,CAAC,UAAU,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC;QAChG,IAAI,OAAO,CAAC,OAAO,KAAK,CAAC,IAAI,CAAC,KAAK,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,SAAS,CAAC,IAAI,SAAS,IAAI,IAAI,CAAC,GAAG,EAAE,EAAE,CAAC;YAC9F,OAAO,IAAI,CAAC;QACd,CAAC;QACD,OAAO,KAAK,CAAC;IACf,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC"}

package/dist/runtimeClient.d.ts

@@ -0,0 +1,117 @@
+import type { CodeVersion } from "./codeVersion.js";
+export declare class RuntimeClientError extends Error {
+    readonly status: number;
+    readonly body: unknown;
+    readonly detail: string | undefined;
+    constructor(status: number, body: unknown);
+}
+/** Internal immutable identity for writes to one registered recording. */
+export declare class TraceWriteCredentials {
+    #private;
+    readonly traceId: string;
+    readonly recordingId: string;
+    constructor(traceId: string, recordingId: string, traceWriteToken: string);
+    authorizationHeaders(): Record<string, string>;
+}
+export type RegisterTraceRequest = {
+    name: string;
+    traceId?: string;
+    evalRunId?: string;
+    projectId?: string;
+    projectName?: string;
+    projectRoot?: string;
+    codeVersion: CodeVersion;
+};
+export type RegisterTraceResponse = {
+    credentials: TraceWriteCredentials;
+    projectId?: string;
+    appended?: boolean;
+};
+export type RegisterSubtraceRequest = {
+    credentials: TraceWriteCredentials;
+    turnId: string | null;
+    name: string;
+    lessonScopePaths?: readonly string[] | null;
+};
+export type RegisterSubtraceResponse = {
+    credentials: TraceWriteCredentials;
+};
+export type PrepareCallRequest = {
+    credentials: TraceWriteCredentials;
+    turnId: string | null;
+    inputJson: string;
+    apiType: string;
+    stackTrace: string | null;
+    promptBearingSuffixJson: string;
+    prepareRuntimeLessons?: boolean;
+    lessonScopePaths?: readonly string[] | null;
+};
+export type PrepareCallResponse = {
+    stepUuid: string;
+    stepKind: string | null;
+    preparedInputJson?: string;
+    suffixKeysJson?: string;
+    promptBearingSuffixJson?: string;
+    preparedRawInput?: unknown | null;
+};
+export type FinalizeCallRequest = {
+    credentials: TraceWriteCredentials;
+    turnId: string | null;
+    stepUuid: string;
+    apiType: string;
+    inputJson: string;
+    outputJson?: string;
+    errorJson?: string;
+    status?: "ok" | "error";
+    clearOutput?: boolean;
+    latencySeconds?: number | null;
+    stackTrace?: string | null;
+    stepKind?: string | null;
+    suffixKeysJson?: string;
+    promptBearingSuffixJson?: string;
+    lessonMetadata?: Record<string, unknown> | null;
+};
+export type MetricValue = boolean | number;
+export declare class RuntimeClient {
+    readonly baseUrl: string;
+    private readonly fetchFn;
+    private readonly agentToken?;
+    private readonly inputRefsByStep;
+    constructor(baseUrl: string, fetchFn?: typeof fetch, agentToken?: string);
+    registerTrace(request: RegisterTraceRequest): Promise<RegisterTraceResponse>;
+    registerSubtrace(request: RegisterSubtraceRequest): Promise<RegisterSubtraceResponse>;
+    declareTurn(credentials: TraceWriteCredentials, turnInput?: string): Promise<string>;
+    deregisterTrace(credentials: TraceWriteCredentials): Promise<void>;
+    updateTraceLog(request: {
+        credentials: TraceWriteCredentials;
+        turnId: string | null;
+        logText: string;
+        replace: boolean;
+    }): Promise<void>;
+    logMetrics(request: {
+        credentials: TraceWriteCredentials;
+        turnId: string | null;
+        metrics: Record<string, MetricValue>;
+    }): Promise<void>;
+    logInput(request: {
+        credentials: TraceWriteCredentials;
+        turnId: string | null;
+        value: unknown;
+    }): Promise<void>;
+    logOutput(request: {
+        credentials: TraceWriteCredentials;
+        turnId: string | null;
+        value: unknown;
+    }): Promise<void>;
+    private logTraceIo;
+    /** Upload bytes for one step as a chunked capture upload and return its upload ID. */
+    private uploadCapture;
+    /** Return the `<name>_ref` or `<name>_json` body field for a serialized payload. */
+    private payloadField;
+    prepareCall(request: PrepareCallRequest): Promise<PrepareCallResponse>;
+    recordOutput(request: FinalizeCallRequest): Promise<void>;
+    recordException(request: FinalizeCallRequest): Promise<void>;
+    private finalize;
+    private request;
+}
+//# sourceMappingURL=runtimeClient.d.ts.map

package/dist/runtimeClient.d.ts.map

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