@secure-exec/core 0.0.0-agentos-dylib-base.edaa4a4

package/README.md

@@ -0,0 +1,7 @@
+# @secure-exec/core
+
+Raw Secure Exec protocol types and codecs.
+
+- `@secure-exec/core/protocol` exports the generated sidecar protocol.
+- `@secure-exec/core/binary` resolves the published `secure-exec-sidecar` binary and honors `SECURE_EXEC_SIDECAR_BIN`.
+- `@secure-exec/core/framing`, `@secure-exec/core/frame-stream`, `@secure-exec/core/frame-rpc`, `@secure-exec/core/frame-payload-codec`, `@secure-exec/core/correlation`, `@secure-exec/core/event-buffer`, `@secure-exec/core/ownership`, `@secure-exec/core/permissions`, `@secure-exec/core/state`, `@secure-exec/core/request-payloads`, `@secure-exec/core/response-payloads`, `@secure-exec/core/protocol-frames`, `@secure-exec/core/protocol-client`, `@secure-exec/core/native-client`, `@secure-exec/core/descriptors`, `@secure-exec/core/process`, `@secure-exec/core/protocol-schema`, `@secure-exec/core/protocol-maps`, `@secure-exec/core/callbacks`, `@secure-exec/core/filesystem`, `@secure-exec/core/json`, `@secure-exec/core/numbers`, `@secure-exec/core/bytes`, and `@secure-exec/core/ext` expose generic Node transport primitives.

package/dist/binary.d.ts

@@ -0,0 +1,4 @@
+/**
+ * Resolves the published secure-exec sidecar binary for Node.js clients.
+ */
+export declare function resolvePublishedSidecarBinary(): string;

package/dist/binary.js

@@ -0,0 +1,25 @@
+import { existsSync } from "node:fs";
+import { createRequire } from "node:module";
+/**
+ * Resolves the published secure-exec sidecar binary for Node.js clients.
+ */
+export function resolvePublishedSidecarBinary() {
+    const override = process.env.SECURE_EXEC_SIDECAR_BIN;
+    if (override) {
+        if (!existsSync(override)) {
+            throw new Error(`SECURE_EXEC_SIDECAR_BIN is set to ${override} but the file does not exist`);
+        }
+        return override;
+    }
+    const require = createRequire(import.meta.url);
+    let mod;
+    try {
+        mod = require("@secure-exec/sidecar");
+    }
+    catch (error) {
+        throw new Error("failed to resolve the secure-exec sidecar binary: the @secure-exec/sidecar " +
+            "package is not installed. Install it, or set SECURE_EXEC_SIDECAR_BIN to a local " +
+            `secure-exec-sidecar binary. (${error.message})`);
+    }
+    return mod.getSidecarPath();
+}

package/dist/bytes.d.ts

@@ -0,0 +1,2 @@
+export declare function toExactArrayBuffer(value: Uint8Array): ArrayBuffer;
+export declare function toExactUint8Array(value: Uint8Array): Uint8Array;

package/dist/bytes.js

@@ -0,0 +1,6 @@
+export function toExactArrayBuffer(value) {
+    return value.buffer.slice(value.byteOffset, value.byteOffset + value.byteLength);
+}
+export function toExactUint8Array(value) {
+    return Uint8Array.from(value);
+}

package/dist/callbacks.d.ts

@@ -0,0 +1,41 @@
+import type * as protocol from "./generated-protocol.js";
+export interface CallbackExtEnvelope {
+    namespace: string;
+    payload: Uint8Array;
+}
+export type CallbackSidecarRequestPayload = {
+    type: "host_callback";
+    invocation_id: string;
+    callback_key: string;
+    input: unknown;
+    timeout_ms: number;
+} | {
+    type: "js_bridge_call";
+    call_id: string;
+    mount_id: string;
+    operation: string;
+    args: unknown;
+} | {
+    type: "ext";
+    envelope: CallbackExtEnvelope;
+};
+export type CallbackSidecarResponsePayload = {
+    type: "host_callback_result";
+    invocation_id: string;
+    result?: unknown;
+    error?: string;
+} | {
+    type: "js_bridge_result";
+    call_id: string;
+    result?: unknown;
+    error?: string;
+} | {
+    type: "ext_result";
+    envelope: CallbackExtEnvelope;
+};
+export type LiveSidecarRequestPayload = CallbackSidecarRequestPayload;
+export type LiveSidecarResponsePayload = CallbackSidecarResponsePayload;
+export declare function isMatchingSidecarResponsePayload(request: CallbackSidecarRequestPayload, response: CallbackSidecarResponsePayload): boolean;
+export declare function errorSidecarResponsePayload(request: CallbackSidecarRequestPayload, error: unknown): CallbackSidecarResponsePayload;
+export declare function fromGeneratedSidecarRequestPayload(payload: protocol.SidecarRequestPayload): LiveSidecarRequestPayload;
+export declare function toGeneratedSidecarResponsePayload(payload: LiveSidecarResponsePayload): protocol.SidecarResponsePayload;

package/dist/callbacks.js

@@ -0,0 +1,94 @@
+import { fromGeneratedExtEnvelope, toGeneratedExtEnvelope, } from "./ext.js";
+import { parseJsonUtf8, stringifyJsonUtf8 } from "./json.js";
+import { bigIntToSafeNumber } from "./numbers.js";
+export function isMatchingSidecarResponsePayload(request, response) {
+    switch (request.type) {
+        case "host_callback":
+            return response.type === "host_callback_result";
+        case "js_bridge_call":
+            return response.type === "js_bridge_result";
+        case "ext":
+            return response.type === "ext_result";
+    }
+}
+export function errorSidecarResponsePayload(request, error) {
+    const message = error instanceof Error ? error.message : String(error);
+    switch (request.type) {
+        case "host_callback":
+            return {
+                type: "host_callback_result",
+                invocation_id: request.invocation_id,
+                error: message,
+            };
+        case "js_bridge_call":
+            return {
+                type: "js_bridge_result",
+                call_id: request.call_id,
+                error: message,
+            };
+        case "ext":
+            return {
+                type: "ext_result",
+                envelope: {
+                    namespace: request.envelope.namespace,
+                    payload: Buffer.from(message, "utf8"),
+                },
+            };
+    }
+}
+export function fromGeneratedSidecarRequestPayload(payload) {
+    switch (payload.tag) {
+        case "HostCallbackRequest":
+            return {
+                type: "host_callback",
+                invocation_id: payload.val.invocationId,
+                callback_key: payload.val.callbackKey,
+                input: parseJsonUtf8(payload.val.input, "host callback input"),
+                timeout_ms: bigIntToSafeNumber(payload.val.timeoutMs, "host callback timeout"),
+            };
+        case "JsBridgeCallRequest":
+            return {
+                type: "js_bridge_call",
+                call_id: payload.val.callId,
+                mount_id: payload.val.mountId,
+                operation: payload.val.operation,
+                args: parseJsonUtf8(payload.val.args, "js bridge call args"),
+            };
+        case "ExtEnvelope":
+            return {
+                type: "ext",
+                envelope: fromGeneratedExtEnvelope(payload.val),
+            };
+    }
+}
+export function toGeneratedSidecarResponsePayload(payload) {
+    switch (payload.type) {
+        case "host_callback_result":
+            return {
+                tag: "HostCallbackResultResponse",
+                val: {
+                    invocationId: payload.invocation_id,
+                    result: payload.result === undefined
+                        ? null
+                        : stringifyJsonUtf8(payload.result, "host_callback_result.result"),
+                    error: payload.error ?? null,
+                },
+            };
+        case "js_bridge_result":
+            return {
+                tag: "JsBridgeResultResponse",
+                val: {
+                    callId: payload.call_id,
+                    result: payload.result === undefined
+                        ? null
+                        : stringifyJsonUtf8(payload.result, "js_bridge_result.result"),
+                    error: payload.error ?? null,
+                },
+            };
+        case "ext_result":
+            return {
+                tag: "ExtEnvelope",
+                val: toGeneratedExtEnvelope(payload.envelope),
+            };
+    }
+}

package/dist/cargo.d.ts

@@ -0,0 +1,2 @@
+export declare function findCargoBinary(): string | null;
+export declare function resolveCargoBinary(): string;