@holokai/neuron-sdk 0.5.1 → 0.6.0

package/dist/index.mjs

@@ -10,6 +10,11 @@ var CapabilityTypeSchema = z.string().min(1).regex(
   "capability type must be namespaced: {owner}/{package}[/{name}][.{variant}]"
 );
 var UserIdSchema = z.string().min(1);
+var SKILL_CAPABILITY_PREFIX = "skill/";
+function isSkillCapabilityType(type) {
+  return type.startsWith(SKILL_CAPABILITY_PREFIX);
+}
+var MAX_COMPOSED_CAPABILITIES = 64;
 var JsonSchemaSchema = z.unknown();
 var CapabilityScopeSchema = z.union([
   z.literal("any"),
@@ -62,8 +67,29 @@ var CapabilitySchema = z.object({
    * heartbeat budget should be the limiter, not a single
    * capability).
    */
-  leaseTtlMs: z.number().int().min(1e3).max(60 * 60 * 1e3).optional()
-}).strict();
+  leaseTtlMs: z.number().int().min(1e3).max(60 * 60 * 1e3).optional(),
+  /**
+   * Capability types this `skill/*` capability composes (HOL-4326).
+   * Only valid on a `skill/*` type — enforced below, since a non-skill
+   * type carrying `composes` is a modeling error the gateway should
+   * reject rather than silently ignore.
+   */
+  composes: z.array(CapabilityTypeSchema).min(1).max(MAX_COMPOSED_CAPABILITIES).refine(
+    (types) => new Set(types).size === types.length,
+    "composes must not contain duplicate capability types"
+  ).refine(
+    (types) => types.every((t) => !isSkillCapabilityType(t)),
+    "composes must not contain skill/* capability types"
+  ).optional()
+}).strict().superRefine((cap, ctx) => {
+  if (cap.composes !== void 0 && !isSkillCapabilityType(cap.type)) {
+    ctx.addIssue({
+      code: z.ZodIssueCode.custom,
+      message: "composes is only valid on a skill/* capability type",
+      path: ["composes"]
+    });
+  }
+});
 var LeaseIdSchema = z.string().min(1);
 var TaskPayloadSchema = z.object({
   taskId: z.string().min(1),
@@ -202,7 +228,7 @@ z.discriminatedUnion("type", [
 ]);
 
 // ../neuron-protocol/src/transport.ts
-var PROTOCOL_VERSION = "1.1.0";
+var PROTOCOL_VERSION = "1.2.0";
 var SSE_PATH = "/neuron/events";
 var SSE_EVENT = {
   registered: "registered",
@@ -228,6 +254,7 @@ function defineCapability(init) {
     scope: init.scope,
     concurrency: init.concurrency,
     leaseTtlMs: init.leaseTtlMs,
+    composes: init.composes,
     _zod: { input: init.input, output: init.output }
   };
 }
@@ -253,6 +280,7 @@ function toRegistrationCapability(def, opts) {
     );
   }
   const leaseTtlMs = opts?.leaseTtlMs ?? def.leaseTtlMs;
+  const composes = opts?.composes ?? def.composes;
   return {
     type: def.type,
     scope,
@@ -263,7 +291,8 @@ function toRegistrationCapability(def, opts) {
     description: opts?.description ?? def.description,
     inputSchema: def.inputSchema,
     outputSchema: def.outputSchema,
-    ...typeof leaseTtlMs === "number" ? { leaseTtlMs } : {}
+    ...typeof leaseTtlMs === "number" ? { leaseTtlMs } : {},
+    ...composes !== void 0 ? { composes: [...composes] } : {}
   };
 }
 
@@ -972,7 +1001,8 @@ var Neuron = class extends EventEmitter {
         ...reg.description !== void 0 ? { description: reg.description } : {},
         ...reg.inputSchema !== void 0 ? { inputSchema: reg.inputSchema } : {},
         ...reg.outputSchema !== void 0 ? { outputSchema: reg.outputSchema } : {},
-        ...typeof reg.leaseTtlMs === "number" ? { leaseTtlMs: reg.leaseTtlMs } : {}
+        ...typeof reg.leaseTtlMs === "number" ? { leaseTtlMs: reg.leaseTtlMs } : {},
+        ...reg.composes !== void 0 ? { composes: reg.composes } : {}
       };
       inputSchema = reg.inputSchema;
       outputSchema = reg.outputSchema;