@easynet-run/node 0.36.9 → 0.39.29

package/src/dendrite_bridge/ffi.js

@@ -2,29 +2,28 @@
 // =========================
 //
 // File: sdk/node/src/dendrite_bridge/ffi.ts
-// Description: FFI loading and JSON calling layer for the Dendrite native bridge; resolves the shared library, binds koffi function pointers, and provides the callJson helper.
+// Description: Node FFI loader and raw JSON-call bindings for the native Axon dendrite bridge.
 //
 // Protocol Responsibility:
-// - Loads the native dendrite bridge shared library and exposes typed function bindings.
-// - Provides the low-level callJson helper that handles JSON serialization/error mapping.
+// - Loads the native dendrite shared library and exposes the raw JSON-call symbol set to Node code.
+// - Normalizes low-level FFI failures into stable Node-side error contracts.
 //
 // Implementation Approach:
-// - Uses koffi for native FFI binding.
-// - Keeps library resolution and error handling explicit.
+// - Keeps library path resolution, symbol binding, and JSON marshalling isolated from higher-level SDK classes.
+// - Defines timeout and transport constants close to the native boundary for consistent reuse.
 //
 // Usage Contract:
-// - Callers should use loadDendriteLib to obtain function bindings, then callJson to invoke them.
-// - Errors are surfaced as DendriteError instances.
+// - Treat this module as the lowest-level Node native binding layer and avoid embedding application logic here.
+// - Regenerate or update bindings here before adding new native bridge capabilities to higher layers.
 //
 // Architectural Position:
-// - Part of the Node SDK dendrite_bridge submodule layer.
-// - Should not embed class or interface logic outside FFI concerns.
+// - Native binding boundary underneath the Node SDK bridge facade.
 //
 // Author: Silan.Hu
 // Email: silan.hu@u.nus.edu
 // Copyright (c) 2026-2027 easynet. All rights reserved.
 import { createRequire } from "node:module";
-import { existsSync } from "node:fs";
+import { existsSync, readFileSync } from "node:fs";
 import { dirname, resolve } from "node:path";
 import { fileURLToPath } from "node:url";
 import { DendriteError } from "../capability_request.js";
@@ -34,22 +33,196 @@ export const DEFAULT_TIMEOUT_MS = 30000;
 export const DEFAULT_CONNECT_TIMEOUT_MS = 5000;
 export const DEFAULT_MCP_TOOL_STREAM_TIMEOUT_MS = 60_000;
 export { DendriteError };
+function bridgeDebugLog(tried) {
+    if ((process.env.EASYNET_DENDRITE_BRIDGE_DEBUG || "").trim() === "1") {
+        process.stderr.write(`[dendrite-bridge] tried ${tried.length} candidate(s):\n`);
+        for (const p of tried) {
+            process.stderr.write(`  - ${p}\n`);
+        }
+    }
+}
 export function resolveLibraryPath(explicitPath) {
     if (explicitPath)
         return explicitPath;
     if (process.env.EASYNET_DENDRITE_BRIDGE_LIB)
         return process.env.EASYNET_DENDRITE_BRIDGE_LIB;
-    const here = dirname(fileURLToPath(import.meta.url));
-    const candidates = [
-        resolve(here, "../../native/libaxon_dendrite_bridge.dylib"),
-        resolve(here, "../../native/libaxon_dendrite_bridge.so"),
-        resolve(here, "../../native/axon_dendrite_bridge.dll"),
-    ];
-    for (const c of candidates) {
+    const names = libraryFileNames();
+    const versions = sdkVersionCandidates();
+    const tried = [];
+    for (const c of homeLibraryCandidates(names, versions)) {
+        tried.push(c);
+        if (existsSync(c))
+            return c;
+    }
+    if (useLocalSource()) {
+        for (const c of sourceLibraryCandidates(names, versions)) {
+            tried.push(c);
+            if (existsSync(c))
+                return c;
+        }
+    }
+    for (const c of packageLibraryCandidates(names, versions)) {
+        tried.push(c);
         if (existsSync(c))
             return c;
     }
-    throw new DendriteError("dendrite bridge library not found; set EASYNET_DENDRITE_BRIDGE_LIB or ensure package contains native/libaxon_dendrite_bridge.*");
+    bridgeDebugLog(tried);
+    throw new DendriteError("dendrite bridge library not found; set EASYNET_DENDRITE_BRIDGE_LIB or EASYNET_DENDRITE_BRIDGE_HOME — run with EASYNET_DENDRITE_BRIDGE_DEBUG=1 for candidate details");
+}
+function dedupeCandidates(values) {
+    const seen = new Set();
+    const out = [];
+    for (const value of values) {
+        if (seen.has(value)) {
+            continue;
+        }
+        seen.add(value);
+        out.push(value);
+    }
+    return out;
+}
+function libraryFileNames() {
+    const rawHint = (process.env.EASYNET_DENDRITE_BRIDGE_PLATFORM || "").trim().toLowerCase();
+    if (rawHint === "ios") {
+        return [
+            "libaxon_dendrite_bridge.dylib",
+            "libaxon_dendrite_bridge.so",
+            "axon_dendrite_bridge.dll",
+        ];
+    }
+    if (["android", "linux", "linux-gnu"].includes(rawHint)) {
+        return [
+            "libaxon_dendrite_bridge.so",
+            "libaxon_dendrite_bridge.dylib",
+            "axon_dendrite_bridge.dll",
+        ];
+    }
+    if (["macos", "darwin", "mac"].includes(rawHint)) {
+        return [
+            "libaxon_dendrite_bridge.dylib",
+            "libaxon_dendrite_bridge.so",
+            "axon_dendrite_bridge.dll",
+        ];
+    }
+    if (["windows", "win", "win32", "win64"].includes(rawHint)) {
+        return [
+            "axon_dendrite_bridge.dll",
+            "libaxon_dendrite_bridge.dylib",
+            "libaxon_dendrite_bridge.so",
+        ];
+    }
+    const primary = process.platform === "win32"
+        ? "axon_dendrite_bridge.dll"
+        : process.platform === "darwin"
+            ? "libaxon_dendrite_bridge.dylib"
+            : "libaxon_dendrite_bridge.so";
+    const all = [
+        "libaxon_dendrite_bridge.dylib",
+        "libaxon_dendrite_bridge.so",
+        "axon_dendrite_bridge.dll",
+    ];
+    return [primary, ...all.filter((n) => n !== primary)];
+}
+function projectRoot() {
+    let cursor = process.cwd();
+    for (let depth = 0; depth < 12; depth += 1) {
+        if (existsSync(resolve(cursor, "core/runtime-rs"))) {
+            return cursor;
+        }
+        const parent = dirname(cursor);
+        if (parent === cursor)
+            break;
+        cursor = parent;
+    }
+    return undefined;
+}
+function sdkVersionCandidates() {
+    const versions = [];
+    const envVersion = (process.env.SDK_VERSION || "").trim();
+    if (envVersion) {
+        versions.push(envVersion);
+    }
+    const root = projectRoot();
+    if (root) {
+        try {
+            const raw = readFileSync(resolve(root, "VERSION"), "utf8").trim();
+            if (raw) {
+                versions.push(raw.split("\n")[0].trim());
+            }
+        }
+        catch {
+            // no-op
+        }
+    }
+    if (versions.length === 0) {
+        if ((process.env.EASYNET_DENDRITE_BRIDGE_DEBUG || "").trim() === "1") {
+            console.error("warning: no SDK version detected, falling back to 0.1.0");
+        }
+    }
+    versions.push("0.1.0");
+    return dedupeCandidates(versions).filter(Boolean);
+}
+function addLibraryCandidates(targets, names, roots) {
+    for (const root of roots) {
+        for (const name of names) {
+            targets.push(resolve(root, name));
+        }
+    }
+}
+function homeLibraryCandidates(names, versions) {
+    const raw = (process.env.EASYNET_DENDRITE_BRIDGE_HOME || "").trim();
+    if (!raw)
+        return [];
+    const homeRoot = resolve(raw);
+    const candidateRoots = [
+        homeRoot,
+        resolve(homeRoot, "native"),
+        ...versions.map((version) => resolve(homeRoot, "dist", "sdk-packs", version, "native")),
+    ];
+    const candidates = [];
+    addLibraryCandidates(candidates, names, candidateRoots);
+    return dedupeCandidates(candidates);
+}
+function useLocalSource() {
+    const raw = (process.env.EASYNET_DENDRITE_BRIDGE_SOURCE || "").trim().toLowerCase();
+    return new Set(["1", "true", "yes", "on", "local", "source"]).has(raw);
+}
+function sourceLibraryCandidates(names, versions) {
+    const root = projectRoot();
+    if (!root)
+        return [];
+    const candidates = [];
+    // Versioned dist paths
+    for (const version of versions) {
+        addLibraryCandidates(candidates, names, [resolve(root, "dist", "sdk-packs", version, "native")]);
+    }
+    // Build artifacts
+    const bridgeTarget = resolve(root, "core/runtime-rs/dendrite-bridge/target");
+    const roots = [
+        resolve(bridgeTarget, "release"),
+        resolve(bridgeTarget, "debug"),
+    ];
+    const sdkTarget = (process.env.SDK_TARGET || "").trim();
+    if (sdkTarget) {
+        roots.push(resolve(bridgeTarget, sdkTarget, "release"));
+        roots.push(resolve(bridgeTarget, sdkTarget, "debug"));
+    }
+    addLibraryCandidates(candidates, names, roots);
+    return dedupeCandidates(candidates);
+}
+function packageLibraryCandidates(names, versions) {
+    const here = dirname(fileURLToPath(import.meta.url));
+    const pkgBase = resolve(here, "../..");
+    const roots = [
+        pkgBase,
+        resolve(pkgBase, "native"),
+    ];
+    for (const version of versions) {
+        roots.push(resolve(pkgBase, "dist", "sdk-packs", version, "native"));
+    }
+    const candidates = [];
+    addLibraryCandidates(candidates, names, roots);
+    return dedupeCandidates(candidates);
 }
 export function loadDendriteLib(libraryPath) {
     const lib = koffi.load(libraryPath);
@@ -79,6 +252,7 @@ export function loadDendriteLib(libraryPath) {
         axon_dendrite_list_nodes_json: lib.func("axon_dendrite_list_nodes_json", bridgeString, ["uint64_t", "str"]),
         axon_dendrite_register_node_json: lib.func("axon_dendrite_register_node_json", bridgeString, ["uint64_t", "str"]),
         axon_dendrite_deregister_node_json: optionalJsonFn("axon_dendrite_deregister_node_json", ["uint64_t", "str"]),
+        axon_dendrite_drain_node_json: optionalJsonFn("axon_dendrite_drain_node_json", ["uint64_t", "str"]),
         axon_dendrite_heartbeat_json: lib.func("axon_dendrite_heartbeat_json", bridgeString, ["uint64_t", "str"]),
         axon_dendrite_publish_capability_json: lib.func("axon_dendrite_publish_capability_json", bridgeString, ["uint64_t", "str"]),
         axon_dendrite_install_capability_json: lib.func("axon_dendrite_install_capability_json", bridgeString, ["uint64_t", "str"]),

package/src/index.d.ts

@@ -48,7 +48,7 @@ export declare class Client {
     callRaw(payload: JsonValue): Promise<Record<string, unknown>>;
 }
 export declare function client(transport?: Transport): Client;
-export { createAbility, exportAbility, deployToNode, listAbilities, invokeAbility, uninstallAbility, discoverNodes, executeCommand, forgetAll, disconnectDevice, drainDevice, listRemoteTools, buildDeployPackage, deployPackage, startServer, toToolSpec, type AbilityDescriptor, type AbilityTarget, type AbilityExportResult, type ServerHandle, type BridgeInterface, type ForgetAllResult, type ForgetAllFailure, type DeployResult, } from "./ability_lifecycle.js";
+export { buildAbilityDescriptor, exportAbility, deployToNode, listAbilities, invokeAbility, uninstallAbility, discoverNodes, executeCommand, forgetAll, disconnectDevice, drainDevice, listRemoteTools, buildDeployPackage, deployPackage, startServer, toToolSpec, type AbilityDescriptor, type AbilityTarget, type AbilityExportResult, type ServerHandle, type BridgeInterface, type ForgetAllResult, type ForgetAllFailure, type DeployResult, } from "./ability_lifecycle.js";
 export { AxonError, AxonConfigError, AxonBridgeError, AxonNotInstalledError, AxonNotActivatedError, AxonInvocationError, AxonStreamError, AxonPolicyDeniedError, AxonMcpError, AxonPartialSuccessError, AxonJsonError, AxonIoError, AxonSymbolNotFoundError, } from "./errors.js";
 export { beginPhase, skippedReceipt, buildDeployTrace, phaseFromTrace, PhaseReceiptBuilder, type Phase, type PhaseStatus, type PhaseReceipt, type DeployTrace, } from "./receipt.js";
 export { AbilityToolAdapter, type ToolSpec as AdapterToolSpec, type OpenAITool, type OpenAIChatTool, type AnthropicTool, type ToolParameters, type LocalHandler, type RegisterOptions, type AbilityToolAdapterOptions, } from "./tool_adapter.js";

package/src/index.js

@@ -2,23 +2,22 @@
 // =========================
 //
 // File: sdk/node/src/index.ts
-// Description: Source file for Node SDK facade and Dendrite integration; keeps behavior explicit and interoperable across language/runtime boundaries with tenant/principal fluent context.
+// Description: Node SDK package-root facade for tenant-aware clients, sidecar transport, MCP helpers, and bridge exports.
 //
 // Protocol Responsibility:
-// - Implements Node SDK facade and Dendrite integration contracts required by current Axon service and SDK surfaces.
-// - Preserves stable request/response semantics and error mapping for index.ts call paths.
+// - Defines the package-root SDK facade and re-export surface consumed by application code.
+// - Keeps tenant-aware client, bridge, and tool APIs reachable through one stable import boundary.
 //
 // Implementation Approach:
-// - Uses small typed helpers and explicit control flow to avoid hidden side effects.
-// - Keeps protocol translation and transport details close to this module boundary.
+// - Composes smaller modules rather than re-implementing transport or protocol logic at the package root.
+// - Uses explicit exports so public surface changes remain auditable.
 //
 // Usage Contract:
-// - Callers should provide valid tenant/resource/runtime context before invoking exported APIs; principal context is optional and, when provided, is mapped to EasyNet subject context.
-// - Errors should be treated as typed protocol/runtime outcomes rather than silently ignored.
+// - Prefer importing from this boundary when consuming the SDK from application code.
+// - Public export changes here should be synchronized with language-specific packaging and documentation.
 //
 // Architectural Position:
-// - Part of the Node SDK facade and Dendrite integration layer.
-// - Should not embed unrelated orchestration logic outside this file's responsibility.
+// - Top-level SDK package boundary for application-facing imports.
 //
 // Author: Silan.Hu
 // Email: silan.hu@u.nus.edu
@@ -157,7 +156,7 @@ export class Client {
 export function client(transport) {
     return new Client(transport);
 }
-export { createAbility, exportAbility, deployToNode, listAbilities, invokeAbility, uninstallAbility, discoverNodes, executeCommand, forgetAll, disconnectDevice, drainDevice, listRemoteTools, buildDeployPackage, deployPackage, startServer, toToolSpec, } from "./ability_lifecycle.js";
+export { buildAbilityDescriptor, exportAbility, deployToNode, listAbilities, invokeAbility, uninstallAbility, discoverNodes, executeCommand, forgetAll, disconnectDevice, drainDevice, listRemoteTools, buildDeployPackage, deployPackage, startServer, toToolSpec, } from "./ability_lifecycle.js";
 export { AxonError, AxonConfigError, AxonBridgeError, AxonNotInstalledError, AxonNotActivatedError, AxonInvocationError, AxonStreamError, AxonPolicyDeniedError, AxonMcpError, AxonPartialSuccessError, AxonJsonError, AxonIoError, AxonSymbolNotFoundError, } from "./errors.js";
 export { beginPhase, skippedReceipt, buildDeployTrace, phaseFromTrace, PhaseReceiptBuilder, } from "./receipt.js";
 export { AbilityToolAdapter, } from "./tool_adapter.js";

package/src/mcp/server.test.js

@@ -1,3 +1,28 @@
+// EasyNet Axon for AgentNet
+// =========================
+//
+// File: sdk/node/src/mcp/server.test.js
+// Description: JavaScript runtime mirror for `sdk/node/src/mcp/server.test.js` in the published Node SDK artifact set.
+//
+// Protocol Responsibility:
+// - Preserves the exported API surface generated from the canonical TypeScript source module.
+// - Keeps the distributable Node package consistent for consumers that import built artifacts directly.
+//
+// Implementation Approach:
+// - Mirrors the canonical `.ts` module output and should not diverge semantically from source.
+// - Exists as a distribution artifact so package consumers do not need the TypeScript authoring tree at runtime.
+//
+// Usage Contract:
+// - Update this file through the Node SDK build pipeline when the corresponding TypeScript source changes.
+// - Treat manual edits here as temporary at most; source-of-truth behavior lives in the `.ts` module.
+//
+// Architectural Position:
+// - Published artifact boundary for the Node SDK distribution.
+//
+// Author: Silan.Hu
+// Email: silan.hu@u.nus.edu
+// Copyright (c) 2026-2027 easynet. All rights reserved.
+
 import assert from "node:assert/strict";
 import { describe, it } from "node:test";
 import { PassThrough } from "node:stream";
@@ -6,34 +31,47 @@ import { StdioMcpServer } from "./server.js";
 
 describe("StdioMcpServer", () => {
   it("keeps buffered stream responses intact when close throws", async () => {
+    const originalConsoleError = console.error;
+    const consoleErrors = [];
+    console.error = (...args) => {
+      consoleErrors.push(args);
+    };
+
     const server = new StdioMcpServer({
       toolSpecs: () => [],
       handleToolCall: () => ({ payload: { ok: true }, isError: false }),
       handleToolCallStream: () => ({
+        stream: {
+          async *[Symbol.asyncIterator]() {
+            yield Buffer.from("chunk-1");
+          },
+        },
         close() {
           throw new Error("close failed");
         },
-        async *[Symbol.asyncIterator]() {
-          yield Buffer.from("chunk-1");
-        },
       }),
     });
 
-    const response = await server.handleRequest({
-      jsonrpc: "2.0",
-      id: 1,
-      method: "tools/call",
-      params: {
-        name: "streamed_tool",
-        arguments: {},
-      },
-    });
+    try {
+      const response = await server.handleRequest({
+        jsonrpc: "2.0",
+        id: 1,
+        method: "tools/call",
+        params: {
+          name: "streamed_tool",
+          arguments: {},
+        },
+      });
 
-    assert.equal(response.jsonrpc, "2.0");
-    const payload = JSON.parse(response.result.content[0].text);
-    assert.equal(payload.ok, true);
-    assert.deepEqual(payload.chunks, ["chunk-1"]);
-    assert.equal(response.result.isError, undefined);
+      assert.equal(response.jsonrpc, "2.0");
+      const payload = JSON.parse(response.result.content[0].text);
+      assert.equal(payload.ok, true);
+      assert.deepEqual(payload.chunks, ["chunk-1"]);
+      assert.equal(response.result.isError, undefined);
+      assert.equal(consoleErrors.length, 1);
+    } finally {
+      console.error = originalConsoleError;
+    }
   });
 
   it("serializes writes through drain backpressure", async () => {

package/src/presets/ability_dispatch/workflow.js

@@ -24,9 +24,9 @@
 // Copyright (c) 2026-2027 easynet. All rights reserved.
 // Node server flow: publish/install/activate media capability on selected client and invoke tasks.
 import { Orchestrator } from "./orchestrator.js";
-import { existsSync, mkdirSync, readFileSync } from "node:fs";
-import { dirname, resolve } from "node:path";
-import { fileURLToPath } from "node:url";
+import { resolveLibraryPath } from "../../dendrite_bridge/ffi.js";
+import { mkdirSync, readFileSync } from "node:fs";
+import { resolve } from "node:path";
 import { parseArgs, parsePositiveInt } from "./args.js";
 import { readBundleVersion, resolveBundlePath, sha256Prefixed } from "./bundle.js";
 import { decodeMediaBase64, defaultOutputDir, persistMediaFile } from "./media.js";
@@ -53,36 +53,14 @@ function resolveConfig(cfg) {
         taskPayloadBuilder: cfg?.taskPayloadBuilder ?? mediaCaptureTaskPayload,
     };
 }
-function defaultBridgeLibName() {
-    if (process.platform === "darwin")
-        return "libaxon_dendrite_bridge.dylib";
-    if (process.platform === "win32")
-        return "axon_dendrite_bridge.dll";
-    return "libaxon_dendrite_bridge.so";
-}
-function findRepoRootForBridge(startDir) {
-    let current = resolve(startDir);
-    for (let steps = 0; steps < 10; steps += 1) {
-        const candidate = resolve(current, "core/runtime-rs/dendrite-bridge/target/release", defaultBridgeLibName());
-        if (existsSync(candidate)) {
-            return current;
-        }
-        const parent = dirname(current);
-        if (parent === current) {
-            break;
-        }
-        current = parent;
-    }
-    return "";
-}
 function ensureBridgeLibEnv() {
     if (process.env.EASYNET_DENDRITE_BRIDGE_LIB)
         return;
-    const here = dirname(fileURLToPath(import.meta.url));
-    const repoRoot = findRepoRootForBridge(here) || process.cwd();
-    const candidate = resolve(repoRoot, "core/runtime-rs/dendrite-bridge/target/release", defaultBridgeLibName());
-    if (existsSync(candidate)) {
-        process.env.EASYNET_DENDRITE_BRIDGE_LIB = candidate;
+    try {
+        process.env.EASYNET_DENDRITE_BRIDGE_LIB = resolveLibraryPath();
+    }
+    catch {
+        // Non-fatal: library may be resolved later by the bridge constructor.
     }
 }
 function extractInstallId(lifecycle) {

package/src/presets/remote_control/config.js

@@ -7,9 +7,7 @@
 // Author: Silan.Hu
 // Email: silan.hu@u.nus.edu
 // Copyright (c) 2026-2027 easynet. All rights reserved.
-import { existsSync } from "node:fs";
-import { dirname, resolve } from "node:path";
-import { fileURLToPath } from "node:url";
+import { resolveLibraryPath } from "../../dendrite_bridge/ffi.js";
 export const DEFAULT_SIGNATURE = "__AXON_EPHEMERAL_DO_NOT_USE_IN_PROD__";
 export const DEFAULT_VERSION = "1.0.0";
 export const DEFAULT_INSTALL_TIMEOUT_SECONDS = 45;
@@ -30,16 +28,11 @@ export function ensureRemoteControlNativeLibEnv() {
     if (process.env.EASYNET_DENDRITE_BRIDGE_LIB) {
         return;
     }
-    const moduleDir = dirname(fileURLToPath(import.meta.url));
-    const candidates = [
-        resolve(moduleDir, "..", "..", "core", "runtime-rs", "dendrite-bridge", "target", "release", defaultNativeLibName()),
-        resolve(moduleDir, "..", "..", "core", "runtime-rs", "dendrite-bridge", "target", "debug", defaultNativeLibName()),
-    ];
-    for (const candidate of candidates) {
-        if (existsSync(candidate)) {
-            process.env.EASYNET_DENDRITE_BRIDGE_LIB = candidate;
-            return;
-        }
+    try {
+        process.env.EASYNET_DENDRITE_BRIDGE_LIB = resolveLibraryPath();
+    }
+    catch {
+        // Non-fatal: library may be resolved later by the bridge constructor.
     }
 }
 export function ensureNativeLibEnv() {
@@ -66,12 +59,3 @@ export function asNumber(raw) {
     const value = Number.parseInt(String(raw ?? "0"), 10);
     return Number.isFinite(value) ? value : 0;
 }
-function defaultNativeLibName() {
-    if (process.platform === "darwin") {
-        return "libaxon_dendrite_bridge.dylib";
-    }
-    if (process.platform === "win32") {
-        return "axon_dendrite_bridge.dll";
-    }
-    return "libaxon_dendrite_bridge.so";
-}

package/src/presets/remote_control/descriptor.d.ts

@@ -1,3 +1,25 @@
+export type AbilityTarget = "claude" | "codex" | "openclaw" | "agent_skills";
+export interface AbilityDescriptorLite {
+    name: string;
+    toolName: string;
+    description: string;
+    commandTemplate: string;
+    inputSchema: JsonRecord;
+    outputSchema: JsonRecord;
+    version: string;
+    tags: string[];
+    resourceUri: string;
+    instructions: string;
+    inputExamples: JsonRecord[];
+    prerequisites: string[];
+    contextBindings: Record<string, string>;
+    category: string;
+}
+export interface AbilityExportResult {
+    abilityName: string;
+    abilityMd: string;
+    invokeScript: string;
+}
 export interface JsonRecord {
     [key: string]: unknown;
 }
@@ -31,4 +53,18 @@ export declare function defaultOutputSchema(): JsonRecord;
 export declare function serializeDescriptor(descriptor: AbilityPackageDescriptor): JsonRecord;
 export declare function requireString(payload: JsonRecord, key: string): string;
 export declare function parseDescriptor(raw: unknown): AbilityPackageDescriptor;
+/**
+ * Build an `AbilityPackageDescriptor` from handler arguments.
+ *
+ * Normalises names, generates a package ID, encodes the command template
+ * into Base64 package bytes, and serialises agent extension properties
+ * (instructions, input_examples, prerequisites, context_bindings, category)
+ * into the metadata map under the `mcp.*` prefix.
+ *
+ * @throws {Error} If `ability_name`, `command_template`, or `signature_base64` is missing.
+ */
 export declare function buildDescriptor(args: JsonRecord, defaultSignature: string): AbilityPackageDescriptor;
+export declare function createAbilityDescriptor(args: JsonRecord): AbilityDescriptorLite;
+declare function parseAbilityTarget(raw: string): AbilityTarget;
+export declare function exportAbilitySkill(descriptor: AbilityDescriptorLite, target?: AbilityTarget, axonEndpoint?: string): AbilityExportResult;
+export { parseAbilityTarget };