space-data-module-sdk 0.2.7 → 0.2.8

package/README.md

@@ -143,6 +143,20 @@ The detailed edge cases and the current WASI-vs-host portability boundary are
 documented in
 [`docs/testing-harness.md`](./docs/testing-harness.md).
 
+If a manifest declares `runtimeTargets: ["wasi"]`, this SDK now treats that as
+"standalone WASI, no host wrapper required." In practice that currently means:
+
+- the artifact must declare the `command` invoke surface
+- declared capabilities must stay within the pure WASI subset:
+  `logging`, `clock`, `random`, `filesystem`, `pipe`
+- hosted protocols may only use `wasi-pipe` transport
+
+For maximum server-side portability with guest-owned network services, use
+`runtimeTargets: ["wasmedge"]`. That target is intended for WasmEdge
+environments with socket/TLS extensions, while plain `wasi` remains the strict
+no-wrapper baseline. The Node-RED-oriented parity map lives in
+[`docs/node-red-default-node-parity.md`](./docs/node-red-default-node-parity.md).
+
 ## Install
 
 ```bash

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "space-data-module-sdk",
-  "version": "0.2.7",
+  "version": "0.2.8",
   "description": "Module SDK for building, validating, signing, and deploying WebAssembly modules on the Space Data Network.",
   "type": "module",
   "types": "./src/index.d.ts",

package/schemas/PluginManifest.fbs

@@ -179,6 +179,7 @@ table PluginManifest {
   build_artifacts: [BuildArtifact];
   abi_version: uint32 = 1;
   invoke_surfaces: [InvokeSurface];
+  runtime_targets: [string];
 }
 
 root_type PluginManifest;

package/src/compliance/index.js

@@ -5,6 +5,7 @@ import {
   loadManifestFromFile,
   loadComplianceConfig,
   RecommendedCapabilityIds,
+  StandaloneWasiCapabilityIds,
   resolveManifestFiles,
   validatePluginArtifact,
   validatePluginManifest,
@@ -49,8 +50,8 @@ export {
   loadManifestFromFile,
   loadComplianceConfig,
   RecommendedCapabilityIds,
+  StandaloneWasiCapabilityIds,
   resolveManifestFiles,
   validatePluginArtifact,
   validatePluginManifest,
 };
-

package/src/compliance/pluginCompliance.js

@@ -52,7 +52,16 @@ export const RecommendedCapabilityIds = Object.freeze([
   "render_hooks",
 ]);
 
+export const StandaloneWasiCapabilityIds = Object.freeze([
+  "logging",
+  "clock",
+  "random",
+  "filesystem",
+  "pipe",
+]);
+
 const RecommendedCapabilitySet = new Set(RecommendedCapabilityIds);
+const StandaloneWasiCapabilitySet = new Set(StandaloneWasiCapabilityIds);
 const RecommendedRuntimeTargets = Object.freeze(Object.values(RuntimeTarget));
 const RecommendedRuntimeTargetSet = new Set(RecommendedRuntimeTargets);
 const DrainPolicySet = new Set(Object.values(DrainPolicy));
@@ -83,6 +92,9 @@ const BrowserIncompatibleCapabilitySet = new Set([
   "entity_access",
   "render_hooks",
 ]);
+const StandaloneWasiProtocolTransportKindSet = new Set([
+  ProtocolTransportKind.WASI_PIPE,
+]);
 const IgnoredDirectoryNames = new Set([
   ".git",
   ".hg",
@@ -963,6 +975,66 @@ function validateRuntimeTargets(runtimeTargets, declaredCapabilities, issues, so
   }
 }
 
+function validateStandaloneWasiTarget(
+  manifest,
+  normalizedInvokeSurfaces,
+  declaredCapabilities,
+  issues,
+  sourceName,
+) {
+  const runtimeTargets = Array.isArray(manifest?.runtimeTargets)
+    ? manifest.runtimeTargets
+    : [];
+  if (!runtimeTargets.includes(RuntimeTarget.WASI)) {
+    return;
+  }
+
+  if (!normalizedInvokeSurfaces.includes(InvokeSurface.COMMAND)) {
+    pushIssue(
+      issues,
+      "error",
+      "missing-wasi-command-surface",
+      'Artifacts targeting the canonical "wasi" runtime must declare the "command" invoke surface so they can run as standalone WASI programs without host wrappers.',
+      `${sourceName}.invokeSurfaces`,
+    );
+  }
+
+  if (Array.isArray(declaredCapabilities)) {
+    for (const capability of declaredCapabilities) {
+      if (!StandaloneWasiCapabilitySet.has(capability)) {
+        pushIssue(
+          issues,
+          "error",
+          "capability-wasi-standalone-conflict",
+          `Capability "${capability}" is not available to a standalone WASI artifact without host wrappers.`,
+          `${sourceName}.capabilities`,
+        );
+      }
+    }
+  }
+
+  if (!Array.isArray(manifest?.protocols)) {
+    return;
+  }
+  manifest.protocols.forEach((protocol, index) => {
+    const normalizedTransportKind = normalizeProtocolTransportKind(
+      protocol?.transportKind,
+    );
+    if (
+      normalizedTransportKind &&
+      !StandaloneWasiProtocolTransportKindSet.has(normalizedTransportKind)
+    ) {
+      pushIssue(
+        issues,
+        "error",
+        "protocol-wasi-standalone-conflict",
+        `Protocol "${protocol?.protocolId ?? "protocol"}" uses transportKind "${protocol?.transportKind}", which requires a host wrapper rather than a standalone WASI runtime.`,
+        `${sourceName}.protocols[${index}].transportKind`,
+      );
+    }
+  });
+}
+
 function validateInvokeSurfaces(invokeSurfaces, issues, sourceName) {
   if (invokeSurfaces === undefined) {
     return [];
@@ -1086,7 +1158,11 @@ export function validatePluginManifest(manifest, options = {}) {
     issues,
     sourceName,
   );
-  validateInvokeSurfaces(manifest.invokeSurfaces, issues, sourceName);
+  const normalizedInvokeSurfaces = validateInvokeSurfaces(
+    manifest.invokeSurfaces,
+    issues,
+    sourceName,
+  );
 
   if (!Array.isArray(manifest.externalInterfaces)) {
     pushIssue(
@@ -1227,6 +1303,14 @@ export function validatePluginManifest(manifest, options = {}) {
     }
   }
 
+  validateStandaloneWasiTarget(
+    manifest,
+    normalizedInvokeSurfaces,
+    declaredCapabilities,
+    issues,
+    sourceName,
+  );
+
   if (manifest.schemasUsed !== undefined && !Array.isArray(manifest.schemasUsed)) {
     pushIssue(
       issues,

package/src/generated/orbpro/manifest/plugin-manifest.d.ts

@@ -40,6 +40,9 @@ export declare class PluginManifest implements flatbuffers.IUnpackableObject<Plu
     invokeSurfaces(index: number): InvokeSurface | null;
     invokeSurfacesLength(): number;
     invokeSurfacesArray(): Uint8Array | null;
+    runtimeTargets(index: number): string | null;
+    runtimeTargets(index: number, optionalEncoding: flatbuffers.Encoding): string | Uint8Array | null;
+    runtimeTargetsLength(): number;
     static startPluginManifest(builder: flatbuffers.Builder): void;
     static addPluginId(builder: flatbuffers.Builder, pluginIdOffset: flatbuffers.Offset): void;
     static addName(builder: flatbuffers.Builder, nameOffset: flatbuffers.Offset): void;
@@ -67,10 +70,13 @@ export declare class PluginManifest implements flatbuffers.IUnpackableObject<Plu
     static addInvokeSurfaces(builder: flatbuffers.Builder, invokeSurfacesOffset: flatbuffers.Offset): void;
     static createInvokeSurfacesVector(builder: flatbuffers.Builder, data: InvokeSurface[]): flatbuffers.Offset;
     static startInvokeSurfacesVector(builder: flatbuffers.Builder, numElems: number): void;
+    static addRuntimeTargets(builder: flatbuffers.Builder, runtimeTargetsOffset: flatbuffers.Offset): void;
+    static createRuntimeTargetsVector(builder: flatbuffers.Builder, data: flatbuffers.Offset[]): flatbuffers.Offset;
+    static startRuntimeTargetsVector(builder: flatbuffers.Builder, numElems: number): void;
     static endPluginManifest(builder: flatbuffers.Builder): flatbuffers.Offset;
     static finishPluginManifestBuffer(builder: flatbuffers.Builder, offset: flatbuffers.Offset): void;
     static finishSizePrefixedPluginManifestBuffer(builder: flatbuffers.Builder, offset: flatbuffers.Offset): void;
-    static createPluginManifest(builder: flatbuffers.Builder, pluginIdOffset: flatbuffers.Offset, nameOffset: flatbuffers.Offset, versionOffset: flatbuffers.Offset, pluginFamily: PluginFamily, methodsOffset: flatbuffers.Offset, capabilitiesOffset: flatbuffers.Offset, timersOffset: flatbuffers.Offset, protocolsOffset: flatbuffers.Offset, schemasUsedOffset: flatbuffers.Offset, buildArtifactsOffset: flatbuffers.Offset, abiVersion: number, invokeSurfacesOffset: flatbuffers.Offset): flatbuffers.Offset;
+    static createPluginManifest(builder: flatbuffers.Builder, pluginIdOffset: flatbuffers.Offset, nameOffset: flatbuffers.Offset, versionOffset: flatbuffers.Offset, pluginFamily: PluginFamily, methodsOffset: flatbuffers.Offset, capabilitiesOffset: flatbuffers.Offset, timersOffset: flatbuffers.Offset, protocolsOffset: flatbuffers.Offset, schemasUsedOffset: flatbuffers.Offset, buildArtifactsOffset: flatbuffers.Offset, abiVersion: number, invokeSurfacesOffset: flatbuffers.Offset, runtimeTargetsOffset: flatbuffers.Offset): flatbuffers.Offset;
     unpack(): PluginManifestT;
     unpackTo(_o: PluginManifestT): void;
 }
@@ -87,7 +93,8 @@ export declare class PluginManifestT implements flatbuffers.IGeneratedObject {
     buildArtifacts: (BuildArtifactT)[];
     abiVersion: number;
     invokeSurfaces: (InvokeSurface)[];
-    constructor(pluginId?: string | Uint8Array | null, name?: string | Uint8Array | null, version?: string | Uint8Array | null, pluginFamily?: PluginFamily, methods?: (MethodManifestT)[], capabilities?: (HostCapabilityT)[], timers?: (TimerSpecT)[], protocols?: (ProtocolSpecT)[], schemasUsed?: (FlatBufferTypeRefT)[], buildArtifacts?: (BuildArtifactT)[], abiVersion?: number, invokeSurfaces?: (InvokeSurface)[]);
+    runtimeTargets: string[];
+    constructor(pluginId?: string | Uint8Array | null, name?: string | Uint8Array | null, version?: string | Uint8Array | null, pluginFamily?: PluginFamily, methods?: (MethodManifestT)[], capabilities?: (HostCapabilityT)[], timers?: (TimerSpecT)[], protocols?: (ProtocolSpecT)[], schemasUsed?: (FlatBufferTypeRefT)[], buildArtifacts?: (BuildArtifactT)[], abiVersion?: number, invokeSurfaces?: (InvokeSurface)[], runtimeTargets?: string[]);
     pack(builder: flatbuffers.Builder): flatbuffers.Offset;
 }
-//# sourceMappingURL=plugin-manifest.d.ts.map
+//# sourceMappingURL=plugin-manifest.d.ts.map

package/src/generated/orbpro/manifest/plugin-manifest.js

@@ -109,8 +109,16 @@ export class PluginManifest {
         const offset = this.bb.__offset(this.bb_pos, 26);
         return offset ? new Uint8Array(this.bb.bytes().buffer, this.bb.bytes().byteOffset + this.bb.__vector(this.bb_pos + offset), this.bb.__vector_len(this.bb_pos + offset)) : null;
     }
+    runtimeTargets(index, optionalEncoding) {
+        const offset = this.bb.__offset(this.bb_pos, 28);
+        return offset ? this.bb.__string(this.bb.__vector(this.bb_pos + offset) + index * 4, optionalEncoding) : null;
+    }
+    runtimeTargetsLength() {
+        const offset = this.bb.__offset(this.bb_pos, 28);
+        return offset ? this.bb.__vector_len(this.bb_pos + offset) : 0;
+    }
     static startPluginManifest(builder) {
-        builder.startObject(12);
+        builder.startObject(13);
     }
     static addPluginId(builder, pluginIdOffset) {
         builder.addFieldOffset(0, pluginIdOffset, 0);
@@ -218,6 +226,19 @@ export class PluginManifest {
     static startInvokeSurfacesVector(builder, numElems) {
         builder.startVector(1, numElems, 1);
     }
+    static addRuntimeTargets(builder, runtimeTargetsOffset) {
+        builder.addFieldOffset(12, runtimeTargetsOffset, 0);
+    }
+    static createRuntimeTargetsVector(builder, data) {
+        builder.startVector(4, data.length, 4);
+        for (let i = data.length - 1; i >= 0; i--) {
+            builder.addOffset(data[i]);
+        }
+        return builder.endVector();
+    }
+    static startRuntimeTargetsVector(builder, numElems) {
+        builder.startVector(4, numElems, 4);
+    }
     static endPluginManifest(builder) {
         const offset = builder.endObject();
         builder.requiredField(offset, 4); // plugin_id
@@ -229,7 +250,7 @@ export class PluginManifest {
     static finishSizePrefixedPluginManifestBuffer(builder, offset) {
         builder.finish(offset, 'PMAN', true);
     }
-    static createPluginManifest(builder, pluginIdOffset, nameOffset, versionOffset, pluginFamily, methodsOffset, capabilitiesOffset, timersOffset, protocolsOffset, schemasUsedOffset, buildArtifactsOffset, abiVersion, invokeSurfacesOffset) {
+    static createPluginManifest(builder, pluginIdOffset, nameOffset, versionOffset, pluginFamily, methodsOffset, capabilitiesOffset, timersOffset, protocolsOffset, schemasUsedOffset, buildArtifactsOffset, abiVersion, invokeSurfacesOffset, runtimeTargetsOffset) {
         PluginManifest.startPluginManifest(builder);
         PluginManifest.addPluginId(builder, pluginIdOffset);
         PluginManifest.addName(builder, nameOffset);
@@ -243,10 +264,11 @@ export class PluginManifest {
         PluginManifest.addBuildArtifacts(builder, buildArtifactsOffset);
         PluginManifest.addAbiVersion(builder, abiVersion);
         PluginManifest.addInvokeSurfaces(builder, invokeSurfacesOffset);
+        PluginManifest.addRuntimeTargets(builder, runtimeTargetsOffset);
         return PluginManifest.endPluginManifest(builder);
     }
     unpack() {
-        return new PluginManifestT(this.pluginId(), this.name(), this.version(), this.pluginFamily(), this.bb.createObjList(this.methods.bind(this), this.methodsLength()), this.bb.createObjList(this.capabilities.bind(this), this.capabilitiesLength()), this.bb.createObjList(this.timers.bind(this), this.timersLength()), this.bb.createObjList(this.protocols.bind(this), this.protocolsLength()), this.bb.createObjList(this.schemasUsed.bind(this), this.schemasUsedLength()), this.bb.createObjList(this.buildArtifacts.bind(this), this.buildArtifactsLength()), this.abiVersion(), this.bb.createScalarList(this.invokeSurfaces.bind(this), this.invokeSurfacesLength()));
+        return new PluginManifestT(this.pluginId(), this.name(), this.version(), this.pluginFamily(), this.bb.createObjList(this.methods.bind(this), this.methodsLength()), this.bb.createObjList(this.capabilities.bind(this), this.capabilitiesLength()), this.bb.createObjList(this.timers.bind(this), this.timersLength()), this.bb.createObjList(this.protocols.bind(this), this.protocolsLength()), this.bb.createObjList(this.schemasUsed.bind(this), this.schemasUsedLength()), this.bb.createObjList(this.buildArtifacts.bind(this), this.buildArtifactsLength()), this.abiVersion(), this.bb.createScalarList(this.invokeSurfaces.bind(this), this.invokeSurfacesLength()), this.bb.createScalarList(this.runtimeTargets.bind(this), this.runtimeTargetsLength()));
     }
     unpackTo(_o) {
         _o.pluginId = this.pluginId();
@@ -261,6 +283,7 @@ export class PluginManifest {
         _o.buildArtifacts = this.bb.createObjList(this.buildArtifacts.bind(this), this.buildArtifactsLength());
         _o.abiVersion = this.abiVersion();
         _o.invokeSurfaces = this.bb.createScalarList(this.invokeSurfaces.bind(this), this.invokeSurfacesLength());
+        _o.runtimeTargets = this.bb.createScalarList(this.runtimeTargets.bind(this), this.runtimeTargetsLength());
     }
 }
 export class PluginManifestT {
@@ -276,7 +299,8 @@ export class PluginManifestT {
     buildArtifacts;
     abiVersion;
     invokeSurfaces;
-    constructor(pluginId = null, name = null, version = null, pluginFamily = PluginFamily.ANALYSIS, methods = [], capabilities = [], timers = [], protocols = [], schemasUsed = [], buildArtifacts = [], abiVersion = 1, invokeSurfaces = []) {
+    runtimeTargets;
+    constructor(pluginId = null, name = null, version = null, pluginFamily = PluginFamily.ANALYSIS, methods = [], capabilities = [], timers = [], protocols = [], schemasUsed = [], buildArtifacts = [], abiVersion = 1, invokeSurfaces = [], runtimeTargets = []) {
         this.pluginId = pluginId;
         this.name = name;
         this.version = version;
@@ -289,6 +313,7 @@ export class PluginManifestT {
         this.buildArtifacts = buildArtifacts;
         this.abiVersion = abiVersion;
         this.invokeSurfaces = invokeSurfaces;
+        this.runtimeTargets = runtimeTargets;
     }
     pack(builder) {
         const pluginId = (this.pluginId !== null ? builder.createString(this.pluginId) : 0);
@@ -301,7 +326,8 @@ export class PluginManifestT {
         const schemasUsed = PluginManifest.createSchemasUsedVector(builder, builder.createObjectOffsetList(this.schemasUsed));
         const buildArtifacts = PluginManifest.createBuildArtifactsVector(builder, builder.createObjectOffsetList(this.buildArtifacts));
         const invokeSurfaces = PluginManifest.createInvokeSurfacesVector(builder, this.invokeSurfaces);
-        return PluginManifest.createPluginManifest(builder, pluginId, name, version, this.pluginFamily, methods, capabilities, timers, protocols, schemasUsed, buildArtifacts, this.abiVersion, invokeSurfaces);
+        const runtimeTargets = PluginManifest.createRuntimeTargetsVector(builder, builder.createObjectOffsetList(this.runtimeTargets));
+        return PluginManifest.createPluginManifest(builder, pluginId, name, version, this.pluginFamily, methods, capabilities, timers, protocols, schemasUsed, buildArtifacts, this.abiVersion, invokeSurfaces, runtimeTargets);
     }
 }
-//# sourceMappingURL=plugin-manifest.js.map
+//# sourceMappingURL=plugin-manifest.js.map

package/src/generated/orbpro/manifest/plugin-manifest.ts

@@ -145,8 +145,20 @@ invokeSurfacesArray():Uint8Array|null {
   return offset ? new Uint8Array(this.bb!.bytes().buffer, this.bb!.bytes().byteOffset + this.bb!.__vector(this.bb_pos + offset), this.bb!.__vector_len(this.bb_pos + offset)) : null;
 }
 
+runtimeTargets(index: number):string|null
+runtimeTargets(index: number, optionalEncoding:flatbuffers.Encoding):string|Uint8Array|null
+runtimeTargets(index: number, optionalEncoding?:any):string|Uint8Array|null {
+  const offset = this.bb!.__offset(this.bb_pos, 28);
+  return offset ? this.bb!.__string(this.bb!.__vector(this.bb_pos + offset) + index * 4, optionalEncoding) : null;
+}
+
+runtimeTargetsLength():number {
+  const offset = this.bb!.__offset(this.bb_pos, 28);
+  return offset ? this.bb!.__vector_len(this.bb_pos + offset) : 0;
+}
+
 static startPluginManifest(builder:flatbuffers.Builder) {
-  builder.startObject(12);
+  builder.startObject(13);
 }
 
 static addPluginId(builder:flatbuffers.Builder, pluginIdOffset:flatbuffers.Offset) {
@@ -281,6 +293,22 @@ static startInvokeSurfacesVector(builder:flatbuffers.Builder, numElems:number) {
   builder.startVector(1, numElems, 1);
 }
 
+static addRuntimeTargets(builder:flatbuffers.Builder, runtimeTargetsOffset:flatbuffers.Offset) {
+  builder.addFieldOffset(12, runtimeTargetsOffset, 0);
+}
+
+static createRuntimeTargetsVector(builder:flatbuffers.Builder, data:flatbuffers.Offset[]):flatbuffers.Offset {
+  builder.startVector(4, data.length, 4);
+  for (let i = data.length - 1; i >= 0; i--) {
+    builder.addOffset(data[i]!);
+  }
+  return builder.endVector();
+}
+
+static startRuntimeTargetsVector(builder:flatbuffers.Builder, numElems:number) {
+  builder.startVector(4, numElems, 4);
+}
+
 static endPluginManifest(builder:flatbuffers.Builder):flatbuffers.Offset {
   const offset = builder.endObject();
   builder.requiredField(offset, 4) // plugin_id
@@ -295,7 +323,7 @@ static finishSizePrefixedPluginManifestBuffer(builder:flatbuffers.Builder, offse
   builder.finish(offset, 'PMAN', true);
 }
 
-static createPluginManifest(builder:flatbuffers.Builder, pluginIdOffset:flatbuffers.Offset, nameOffset:flatbuffers.Offset, versionOffset:flatbuffers.Offset, pluginFamily:PluginFamily, methodsOffset:flatbuffers.Offset, capabilitiesOffset:flatbuffers.Offset, timersOffset:flatbuffers.Offset, protocolsOffset:flatbuffers.Offset, schemasUsedOffset:flatbuffers.Offset, buildArtifactsOffset:flatbuffers.Offset, abiVersion:number, invokeSurfacesOffset:flatbuffers.Offset):flatbuffers.Offset {
+static createPluginManifest(builder:flatbuffers.Builder, pluginIdOffset:flatbuffers.Offset, nameOffset:flatbuffers.Offset, versionOffset:flatbuffers.Offset, pluginFamily:PluginFamily, methodsOffset:flatbuffers.Offset, capabilitiesOffset:flatbuffers.Offset, timersOffset:flatbuffers.Offset, protocolsOffset:flatbuffers.Offset, schemasUsedOffset:flatbuffers.Offset, buildArtifactsOffset:flatbuffers.Offset, abiVersion:number, invokeSurfacesOffset:flatbuffers.Offset, runtimeTargetsOffset:flatbuffers.Offset):flatbuffers.Offset {
   PluginManifest.startPluginManifest(builder);
   PluginManifest.addPluginId(builder, pluginIdOffset);
   PluginManifest.addName(builder, nameOffset);
@@ -309,6 +337,7 @@ static createPluginManifest(builder:flatbuffers.Builder, pluginIdOffset:flatbuff
   PluginManifest.addBuildArtifacts(builder, buildArtifactsOffset);
   PluginManifest.addAbiVersion(builder, abiVersion);
   PluginManifest.addInvokeSurfaces(builder, invokeSurfacesOffset);
+  PluginManifest.addRuntimeTargets(builder, runtimeTargetsOffset);
   return PluginManifest.endPluginManifest(builder);
 }
 
@@ -325,7 +354,8 @@ unpack(): PluginManifestT {
     this.bb!.createObjList<FlatBufferTypeRef, FlatBufferTypeRefT>(this.schemasUsed.bind(this), this.schemasUsedLength()),
     this.bb!.createObjList<BuildArtifact, BuildArtifactT>(this.buildArtifacts.bind(this), this.buildArtifactsLength()),
     this.abiVersion(),
-    this.bb!.createScalarList<InvokeSurface>(this.invokeSurfaces.bind(this), this.invokeSurfacesLength())
+    this.bb!.createScalarList<InvokeSurface>(this.invokeSurfaces.bind(this), this.invokeSurfacesLength()),
+    this.bb!.createScalarList<string>(this.runtimeTargets.bind(this), this.runtimeTargetsLength())
   );
 }
 
@@ -343,6 +373,7 @@ unpackTo(_o: PluginManifestT): void {
   _o.buildArtifacts = this.bb!.createObjList<BuildArtifact, BuildArtifactT>(this.buildArtifacts.bind(this), this.buildArtifactsLength());
   _o.abiVersion = this.abiVersion();
   _o.invokeSurfaces = this.bb!.createScalarList<InvokeSurface>(this.invokeSurfaces.bind(this), this.invokeSurfacesLength());
+  _o.runtimeTargets = this.bb!.createScalarList<string>(this.runtimeTargets.bind(this), this.runtimeTargetsLength());
 }
 }
 
@@ -359,7 +390,8 @@ constructor(
   public schemasUsed: (FlatBufferTypeRefT)[] = [],
   public buildArtifacts: (BuildArtifactT)[] = [],
   public abiVersion: number = 1,
-  public invokeSurfaces: (InvokeSurface)[] = []
+  public invokeSurfaces: (InvokeSurface)[] = [],
+  public runtimeTargets: string[] = []
 ){}
 
 
@@ -374,6 +406,10 @@ pack(builder:flatbuffers.Builder): flatbuffers.Offset {
   const schemasUsed = PluginManifest.createSchemasUsedVector(builder, builder.createObjectOffsetList(this.schemasUsed));
   const buildArtifacts = PluginManifest.createBuildArtifactsVector(builder, builder.createObjectOffsetList(this.buildArtifacts));
   const invokeSurfaces = PluginManifest.createInvokeSurfacesVector(builder, this.invokeSurfaces);
+  const runtimeTargets = PluginManifest.createRuntimeTargetsVector(
+    builder,
+    builder.createObjectOffsetList(this.runtimeTargets),
+  );
 
   return PluginManifest.createPluginManifest(builder,
     pluginId,
@@ -387,7 +423,8 @@ pack(builder:flatbuffers.Builder): flatbuffers.Offset {
     schemasUsed,
     buildArtifacts,
     this.abiVersion,
-    invokeSurfaces
+    invokeSurfaces,
+    runtimeTargets
   );
 }
 }

package/src/index.d.ts

@@ -223,6 +223,7 @@ export interface ComplianceReport {
 }
 
 export const RecommendedCapabilityIds: readonly string[];
+export const StandaloneWasiCapabilityIds: readonly string[];
 
 export function validatePluginManifest(
   manifest: unknown,
@@ -1098,6 +1099,7 @@ export const RuntimeTarget: {
   NODE: string;
   BROWSER: string;
   WASI: string;
+  WASMEDGE: string;
   SERVER: string;
   DESKTOP: string;
   EDGE: string;

package/src/manifest/normalize.js

@@ -392,12 +392,6 @@ export function toEmbeddedPluginManifest(input = {}) {
       "externalInterfaces are not yet representable in the embedded FlatBuffer manifest schema and were omitted from the compiled artifact.",
     );
   }
-  if (Array.isArray(input.runtimeTargets) && input.runtimeTargets.length > 0) {
-    warnings.push(
-      "runtimeTargets are not yet representable in the embedded FlatBuffer manifest schema and were omitted from the compiled artifact.",
-    );
-  }
-
   const capabilities = Array.isArray(input.capabilities)
     ? input.capabilities
         .map((entry) => toHostCapabilityT(entry, warnings))
@@ -428,6 +422,13 @@ export function toEmbeddedPluginManifest(input = {}) {
         : [],
       Number(input.abiVersion ?? 1),
       normalizeInvokeSurfaces(input.invokeSurfaces),
+      Array.isArray(input.runtimeTargets)
+        ? input.runtimeTargets
+            .map((value) =>
+              typeof value === "string" ? value.trim() : String(value ?? "").trim(),
+            )
+            .filter(Boolean)
+        : [],
     ),
     warnings,
   };

package/src/runtime/constants.js

@@ -38,6 +38,7 @@ export const RuntimeTarget = Object.freeze({
   NODE: "node",
   BROWSER: "browser",
   WASI: "wasi",
+  WASMEDGE: "wasmedge",
   SERVER: "server",
   DESKTOP: "desktop",
   EDGE: "edge",

package/src/testing/index.d.ts

@@ -33,6 +33,8 @@ export interface HarnessRawScenario {
 export interface CapabilityRuntimeSurface {
   capability: string;
   wasi: boolean;
+  standaloneWasi: boolean;
+  wasmedge: boolean;
   syncHostcall: boolean;
   nodeHostApi: boolean;
   notes: string[];

package/src/testing/index.js

@@ -6,6 +6,8 @@ const CapabilitySurfaceMatrix = Object.freeze({
   logging: Object.freeze({
     capability: "logging",
     wasi: true,
+    standaloneWasi: true,
+    wasmedge: true,
     syncHostcall: false,
     nodeHostApi: true,
     notes: [
@@ -16,6 +18,8 @@ const CapabilitySurfaceMatrix = Object.freeze({
   clock: Object.freeze({
     capability: "clock",
     wasi: true,
+    standaloneWasi: true,
+    wasmedge: true,
     syncHostcall: true,
     nodeHostApi: true,
     notes: [
@@ -26,6 +30,8 @@ const CapabilitySurfaceMatrix = Object.freeze({
   random: Object.freeze({
     capability: "random",
     wasi: true,
+    standaloneWasi: true,
+    wasmedge: true,
     syncHostcall: false,
     nodeHostApi: true,
     notes: [
@@ -36,6 +42,8 @@ const CapabilitySurfaceMatrix = Object.freeze({
   timers: Object.freeze({
     capability: "timers",
     wasi: false,
+    standaloneWasi: false,
+    wasmedge: false,
     syncHostcall: false,
     nodeHostApi: true,
     notes: [
@@ -46,6 +54,8 @@ const CapabilitySurfaceMatrix = Object.freeze({
   schedule_cron: Object.freeze({
     capability: "schedule_cron",
     wasi: false,
+    standaloneWasi: false,
+    wasmedge: false,
     syncHostcall: true,
     nodeHostApi: true,
     notes: [
@@ -55,6 +65,8 @@ const CapabilitySurfaceMatrix = Object.freeze({
   filesystem: Object.freeze({
     capability: "filesystem",
     wasi: true,
+    standaloneWasi: true,
+    wasmedge: true,
     syncHostcall: true,
     nodeHostApi: true,
     notes: [
@@ -65,6 +77,8 @@ const CapabilitySurfaceMatrix = Object.freeze({
   pipe: Object.freeze({
     capability: "pipe",
     wasi: true,
+    standaloneWasi: true,
+    wasmedge: true,
     syncHostcall: false,
     nodeHostApi: false,
     notes: [
@@ -75,71 +89,94 @@ const CapabilitySurfaceMatrix = Object.freeze({
   network: Object.freeze({
     capability: "network",
     wasi: false,
+    standaloneWasi: false,
+    wasmedge: true,
     syncHostcall: false,
     nodeHostApi: true,
     notes: [
       "The coarse network capability maps to host-side HTTP/TCP/UDP/TLS/WebSocket services today.",
       "Pure WASI guests cannot reach that surface through the current sync hostcall ABI.",
+      "WasmEdge provides non-blocking socket-oriented extensions that can serve as the standard server-side max-WASI target.",
     ],
   }),
   http: Object.freeze({
     capability: "http",
     wasi: false,
+    standaloneWasi: false,
+    wasmedge: true,
     syncHostcall: false,
     nodeHostApi: true,
     notes: [
       "HTTP is currently available from the Node host API only.",
       "Pure WASM guests cannot reach it through the current sync hostcall ABI.",
+      "Treat WasmEdge socket and TLS extensions as the no-wrapper server-side target for guest HTTP implementations.",
     ],
   }),
   websocket: Object.freeze({
     capability: "websocket",
     wasi: false,
+    standaloneWasi: false,
+    wasmedge: false,
     syncHostcall: false,
     nodeHostApi: true,
     notes: [
       "WebSocket exchange is async and host-only today.",
+      "For no-wrapper parity, target guest WebSocket libraries built on WasmEdge sockets/TLS instead of a host API.",
     ],
   }),
   mqtt: Object.freeze({
     capability: "mqtt",
     wasi: false,
+    standaloneWasi: false,
+    wasmedge: false,
     syncHostcall: false,
     nodeHostApi: true,
     notes: [
       "MQTT publish/subscribe is async and host-only today.",
+      "For no-wrapper parity, target guest MQTT libraries built on WasmEdge sockets/TLS instead of a host API.",
     ],
   }),
   tcp: Object.freeze({
     capability: "tcp",
     wasi: false,
+    standaloneWasi: false,
+    wasmedge: true,
     syncHostcall: false,
     nodeHostApi: true,
     notes: [
       "TCP request support exists in the Node host API only today.",
+      "WasmEdge socket extensions provide a viable no-wrapper server-side target for guest TCP logic.",
     ],
   }),
   udp: Object.freeze({
     capability: "udp",
     wasi: false,
+    standaloneWasi: false,
+    wasmedge: true,
     syncHostcall: false,
     nodeHostApi: true,
     notes: [
       "UDP request support exists in the Node host API only today.",
+      "WasmEdge socket extensions provide a viable no-wrapper server-side target for guest UDP logic.",
     ],
   }),
   tls: Object.freeze({
     capability: "tls",
     wasi: false,
+    standaloneWasi: false,
+    wasmedge: true,
     syncHostcall: false,
     nodeHostApi: true,
     notes: [
       "TLS request support exists in the Node host API only today.",
+      "WasmEdge TLS support provides a practical no-wrapper server-side target for guest HTTPS/TLS logic.",
     ],
   }),
   context_read: Object.freeze({
     capability: "context_read",
     wasi: false,
+    standaloneWasi: false,
+    wasmedge: false,
     syncHostcall: false,
     nodeHostApi: true,
     notes: [
@@ -149,6 +186,8 @@ const CapabilitySurfaceMatrix = Object.freeze({
   context_write: Object.freeze({
     capability: "context_write",
     wasi: false,
+    standaloneWasi: false,
+    wasmedge: false,
     syncHostcall: false,
     nodeHostApi: true,
     notes: [
@@ -158,6 +197,8 @@ const CapabilitySurfaceMatrix = Object.freeze({
   crypto_hash: Object.freeze({
     capability: "crypto_hash",
     wasi: false,
+    standaloneWasi: false,
+    wasmedge: false,
     syncHostcall: false,
     nodeHostApi: true,
     notes: [
@@ -167,6 +208,8 @@ const CapabilitySurfaceMatrix = Object.freeze({
   crypto_sign: Object.freeze({
     capability: "crypto_sign",
     wasi: false,
+    standaloneWasi: false,
+    wasmedge: false,
     syncHostcall: false,
     nodeHostApi: true,
     notes: [
@@ -176,6 +219,8 @@ const CapabilitySurfaceMatrix = Object.freeze({
   crypto_verify: Object.freeze({
     capability: "crypto_verify",
     wasi: false,
+    standaloneWasi: false,
+    wasmedge: false,
     syncHostcall: false,
     nodeHostApi: true,
     notes: [
@@ -185,6 +230,8 @@ const CapabilitySurfaceMatrix = Object.freeze({
   crypto_encrypt: Object.freeze({
     capability: "crypto_encrypt",
     wasi: false,
+    standaloneWasi: false,
+    wasmedge: false,
     syncHostcall: false,
     nodeHostApi: true,
     notes: [
@@ -194,6 +241,8 @@ const CapabilitySurfaceMatrix = Object.freeze({
   crypto_decrypt: Object.freeze({
     capability: "crypto_decrypt",
     wasi: false,
+    standaloneWasi: false,
+    wasmedge: false,
     syncHostcall: false,
     nodeHostApi: true,
     notes: [
@@ -203,6 +252,8 @@ const CapabilitySurfaceMatrix = Object.freeze({
   crypto_key_agreement: Object.freeze({
     capability: "crypto_key_agreement",
     wasi: false,
+    standaloneWasi: false,
+    wasmedge: false,
     syncHostcall: false,
     nodeHostApi: true,
     notes: [
@@ -212,6 +263,8 @@ const CapabilitySurfaceMatrix = Object.freeze({
   crypto_kdf: Object.freeze({
     capability: "crypto_kdf",
     wasi: false,
+    standaloneWasi: false,
+    wasmedge: false,
     syncHostcall: false,
     nodeHostApi: true,
     notes: [
@@ -221,6 +274,8 @@ const CapabilitySurfaceMatrix = Object.freeze({
   process_exec: Object.freeze({
     capability: "process_exec",
     wasi: false,
+    standaloneWasi: false,
+    wasmedge: false,
     syncHostcall: false,
     nodeHostApi: true,
     notes: [
@@ -324,6 +379,8 @@ export function describeCapabilityRuntimeSurface(capability) {
     return {
       capability: known.capability,
       wasi: known.wasi,
+      standaloneWasi: known.standaloneWasi,
+      wasmedge: known.wasmedge,
       syncHostcall: known.syncHostcall,
       nodeHostApi: known.nodeHostApi,
       notes: [...known.notes],
@@ -332,6 +389,8 @@ export function describeCapabilityRuntimeSurface(capability) {
   return {
     capability: normalized,
     wasi: false,
+    standaloneWasi: false,
+    wasmedge: false,
     syncHostcall: false,
     nodeHostApi: false,
     notes: [