@easynet-run/node 0.27.14

package/package.json

@@ -0,0 +1,67 @@
+{
+  "name": "@easynet-run/node",
+  "version": "0.27.14",
+  "description": "EasyNet Axon Node.js SDK (sidecar-first with Dendrite bridge payload).",
+  "license": "Apache-2.0",
+  "homepage": "https://easynet.run",
+  "author": "Silan Hu <silan.hu@u.nus.edu>",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/EasyRemote/EasyNet-Axon.git",
+    "directory": "sdk/node"
+  },
+  "bugs": {
+    "url": "https://github.com/EasyRemote/EasyNet-Axon/issues"
+  },
+  "type": "module",
+  "scripts": {
+    "build": "tsc",
+    "check": "tsc --noEmit",
+    "types:check": "tsc -p tsconfig.types.json --noEmit",
+    "types:build": "tsc -p tsconfig.types.json",
+    "types:verify": "npm run types:build && test -f dist/types/index.d.ts && test -f dist/types/dendrite_bridge.d.ts",
+    "types": "npm run types:check && npm run types:verify"
+  },
+  "main": "src/index.js",
+  "types": "src/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./src/index.d.ts",
+      "default": "./src/index.js"
+    },
+    "./presets/remote-control": {
+      "types": "./src/presets/remote_control_case.d.ts",
+      "default": "./src/presets/remote_control_case.js"
+    },
+    "./presets/ability-dispatch": {
+      "types": "./src/presets/ability_dispatch.d.ts",
+      "default": "./src/presets/ability_dispatch.js"
+    },
+    "./mcp": {
+      "types": "./src/mcp/server.d.ts",
+      "default": "./src/mcp/server.js"
+    },
+    "./tool-adapter": {
+      "types": "./src/tool_adapter.d.ts",
+      "default": "./src/tool_adapter.js"
+    }
+  },
+  "files": [
+    "src/**/*.js",
+    "src/**/*.d.ts",
+    "runtime",
+    "native",
+    "README.md"
+  ],
+  "dependencies": {
+    "koffi": "^2.15.1"
+  },
+  "devDependencies": {
+    "@types/node": "^20.19.17",
+    "typescript": "^5.9.2"
+  },
+  "sideEffects": false,
+  "publishConfig": {
+    "access": "public"
+  }
+}

package/runtime/runtime-bridge-manifest.json

@@ -0,0 +1,20 @@
+{
+  "runtime_version": "0.27.14",
+  "target": "x86_64-unknown-linux-gnu",
+  "os": "linux",
+  "arch": "x86_64",
+  "artifact": {
+    "path": "runtime/easynet-runtime-rs-0.27.14-x86_64-unknown-linux-gnu.tar.gz",
+    "sha256": "382b54020ba9caa97e175fdec8e99a45f52209e40d36214f33efc741482e2072",
+    "binary_name": "axon-runtime"
+  },
+  "language_bridge_descriptors": [
+    "python/runtime-bridge.json",
+    "node/runtime-bridge.json",
+    "react/runtime-bridge.json",
+    "go/runtime-bridge.json",
+    "java/runtime-bridge.json",
+    "swift/runtime-bridge.json"
+  ],
+  "generated_at_utc": "2026-03-19T17:45:33Z"
+}

package/runtime/runtime-bridge.json

@@ -0,0 +1,9 @@
+{
+  "language": "node",
+  "runtime_version": "0.27.14",
+  "target": "x86_64-unknown-linux-gnu",
+  "runtime_artifact_path": "runtime/easynet-runtime-rs-0.27.14-x86_64-unknown-linux-gnu.tar.gz",
+  "binary_relative_path": "axon-runtime",
+  "recommended_extract": "tar -xzf runtime/easynet-runtime-rs-0.27.14-x86_64-unknown-linux-gnu.tar.gz -C <runtime_dir>",
+  "recommended_launch": "AXON_ENFORCE_MTLS=false <runtime_dir>/axon-runtime"
+}

package/src/ability_lifecycle.d.ts

@@ -0,0 +1,140 @@
+import { type ChildProcess } from "node:child_process";
+import { type DeployTrace } from "./receipt.js";
+import type { ToolSpec } from "./tool_adapter.js";
+export interface AbilityDescriptor {
+    name: string;
+    description: string;
+    commandTemplate: string;
+    inputSchema: Record<string, unknown>;
+    outputSchema: Record<string, unknown>;
+    version: string;
+    tags: string[];
+    resourceUri: string;
+}
+export type AbilityTarget = "claude" | "codex" | "openclaw" | "agent_skills";
+export interface AbilityExportResult {
+    abilityMd: string;
+    invokeScript: string;
+    abilityName: string;
+}
+export type { ToolSpec };
+export interface BridgeInterface {
+    deployAbilityPackage(tenant: string, nodeId: string, args: Record<string, unknown>): Promise<Record<string, unknown>>;
+    listMcpTools(tenant: string, namePattern: string, nodeId: string): Promise<Record<string, unknown>[]>;
+    callMcpToolWithArgs(tenant: string, toolName: string, nodeId: string, args: Record<string, unknown>): Promise<Record<string, unknown>>;
+    uninstallAbilityWithReason(tenant: string, nodeId: string, installId: string, reason: string): Promise<Record<string, unknown>>;
+    listNodes(tenant: string, ownerId: string | null): Promise<Record<string, unknown>[]>;
+    deregisterNode(tenant: string, nodeId: string, reason: string): Promise<Record<string, unknown>>;
+    drainNode(tenant: string, nodeId: string, reason: string): Promise<Record<string, unknown>>;
+}
+/** Bridge subset for read-only operations. */
+export type ReadBridge = Pick<BridgeInterface, "listMcpTools" | "listNodes">;
+/** Bridge subset for deployment and uninstall operations. */
+export type WriteBridge = Pick<BridgeInterface, "deployAbilityPackage" | "uninstallAbilityWithReason" | "callMcpToolWithArgs">;
+/** Bridge subset for full lifecycle operations (read + write + device management). */
+export type FullBridge = BridgeInterface;
+export interface ServerHandle {
+    /** The EasyNet connection URL. */
+    endpoint: string;
+    /** The server child process (null if connecting to existing). */
+    process: ChildProcess | null;
+    /** Path to the runtime log file (null if connecting to existing). */
+    logFile: string | null;
+    /** Stop the server (only if this handle spawned it). */
+    stop(): void;
+}
+/**
+ * Start or connect to an Axon runtime.
+ *
+ * @example
+ * // Auto-start a local server (zero config):
+ * const srv = await startServer();
+ *
+ * // Connect via axon:// transport URI:
+ * const srv = await startServer("axon://localhost");
+ * const srv = await startServer("axon://10.0.0.5:50084");
+ *
+ * // Federation mode — connect the local runtime to a Hub:
+ * const srv = await startServer(undefined, { hub: "axon://hub.easynet.run:50084" });
+ */
+export declare function startServer(endpoint?: string, options?: {
+    logFile?: string;
+    timeoutMs?: number;
+    /** If true, disables mTLS enforcement. Defaults to true for local auto-start. */
+    insecure?: boolean;
+    /** Hub Runtime endpoint for federation mode. */
+    hub?: string;
+    /** Tenant used for federation RPCs. Defaults to "default". */
+    hubTenant?: string;
+    /** Human-readable label for this runtime in federation membership. */
+    hubLabel?: string;
+    /** Pre-shared join token used for outbound federation authentication. */
+    hubJoinToken?: string;
+}): Promise<ServerHandle>;
+export declare function createAbility(opts: {
+    name: string;
+    description: string;
+    commandTemplate: string;
+    inputSchema?: Record<string, unknown>;
+    outputSchema?: Record<string, unknown>;
+    version?: string;
+    tags?: string[];
+    resourceUri?: string;
+}): AbilityDescriptor;
+export declare function toToolSpec(descriptor: AbilityDescriptor): ToolSpec;
+export declare function exportAbility(descriptor: AbilityDescriptor, target?: AbilityTarget, axonEndpoint?: string): AbilityExportResult;
+export interface DeployResult {
+    result: Record<string, unknown>;
+    trace: DeployTrace;
+}
+/**
+ * Deploy an AbilityDescriptor to a node via the MCP deploy pipeline.
+ *
+ * The underlying bridge call executes a three-phase pipeline
+ * (Publish → Install → Activate).  This function wraps the entire
+ * pipeline in a single {@link DeployTrace} receipt so callers get
+ * wall-clock timing and error codes even on failure.
+ *
+ * On failure an {@link AxonInvocationError} is thrown with its `trace`
+ * field set to the collected {@link DeployTrace}:
+ *
+ * ```ts
+ * try { await deployToNode(bridge, tenant, nodeId, desc, sig); }
+ * catch (e) { if (e instanceof AxonInvocationError) console.log(e.trace); }
+ * ```
+ */
+export declare function deployToNode(bridge: Pick<BridgeInterface, "deployAbilityPackage">, tenant: string, nodeId: string, descriptor: AbilityDescriptor, signature: string): Promise<DeployResult>;
+export declare function listAbilities(bridge: Pick<BridgeInterface, "listMcpTools">, tenant: string, nodeId: string): Promise<Record<string, unknown>[]>;
+export declare function invokeAbility(bridge: Pick<BridgeInterface, "callMcpToolWithArgs">, tenant: string, nodeId: string, toolName: string, args?: Record<string, unknown>): Promise<Record<string, unknown>>;
+export declare function uninstallAbility(bridge: Pick<BridgeInterface, "uninstallAbilityWithReason">, tenant: string, nodeId: string, installId: string, reason?: string): Promise<Record<string, unknown>>;
+export declare function discoverNodes(bridge: Pick<BridgeInterface, "listNodes">, tenant: string): Promise<Record<string, unknown>[]>;
+export declare function executeCommand(bridge: Pick<BridgeInterface, "callMcpToolWithArgs" | "deployAbilityPackage" | "uninstallAbilityWithReason">, tenant: string, nodeId: string, command: string): Promise<Record<string, unknown>>;
+export interface ForgetAllFailure {
+    tool_name: string;
+    error: string;
+}
+export interface ForgetAllResult {
+    removed: string[];
+    removed_count: number;
+    failed: ForgetAllFailure[];
+    failed_count: number;
+}
+/**
+ * Remove all deployed abilities from a device.
+ * Requires `confirm = true` as a safety gate (destructive operation).
+ *
+ * When `options.dryRun` is `true`, the function lists all abilities that would
+ * be removed without performing any uninstalls.  The `confirm` parameter is
+ * ignored for dry-run calls since no data is modified.
+ *
+ * @throws {AxonPartialSuccessError} When any uninstall fails (partial or total failure).
+ * @throws {AxonConfigError} When `confirm` is not `true` and `dryRun` is not set.
+ */
+export declare function forgetAll(bridge: Pick<BridgeInterface, "listMcpTools" | "uninstallAbilityWithReason">, tenant: string, nodeId: string, confirm?: boolean, options?: {
+    dryRun?: boolean;
+}): Promise<ForgetAllResult>;
+export declare function disconnectDevice(bridge: Pick<BridgeInterface, "deregisterNode">, tenant: string, nodeId: string, reason?: string): Promise<Record<string, unknown>>;
+export declare function drainDevice(bridge: Pick<BridgeInterface, "drainNode">, tenant: string, nodeId: string, reason?: string): Promise<Record<string, unknown>>;
+export declare function listRemoteTools(bridge: Pick<BridgeInterface, "listMcpTools">, tenant: string, namePattern?: string, nodeId?: string): Promise<Record<string, unknown>[]>;
+export declare function buildDeployPackage(args: Record<string, unknown>, signature: string): Record<string, unknown>;
+export declare function deployPackage(bridge: Pick<BridgeInterface, "deployAbilityPackage">, tenant: string, nodeId: string, packageDescriptor: Record<string, unknown>): Promise<Record<string, unknown>>;