@holokai/neuron-sdk 0.5.1 → 0.7.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] } : {}
   };
 }
 
@@ -543,13 +572,16 @@ var TransportError = class extends Error {
 };
 
 // src/lease-runner.ts
-var TerminalFailure = class extends Error {
-  constructor(reason, code) {
+var HandlerFailure = class extends Error {
+  constructor(reason, code, details, kind = "terminal") {
     super(reason);
     this.reason = reason;
     this.code = code;
-    this.name = "TerminalFailure";
+    this.details = details;
+    this.name = "HandlerFailure";
+    this.kind = kind;
   }
+  kind;
 };
 var DEFAULT_PROGRESS_TIMEOUT_MS = 5e3;
 function validateInput(zod, validator, jsonSchema, data) {
@@ -557,10 +589,7 @@ function validateInput(zod, validator, jsonSchema, data) {
     const result = zod.safeParse(data);
     return result.success ? { ok: true, value: result.data } : { ok: false, errors: result.error.issues };
   }
-  const errors = validator.validate(
-    jsonSchema,
-    data
-  );
+  const errors = validator.validate(jsonSchema, data);
   return errors === null ? { ok: true, value: data } : { ok: false, errors };
 }
 async function runLease(opts) {
@@ -590,7 +619,13 @@ async function runLease(opts) {
     return;
   }
   const parsedInput = inputCheck.value;
-  const reporter = makeProgressReporter(transport, lease.leaseId, logger, signal, progressTimeoutMs);
+  const reporter = makeProgressReporter(
+    transport,
+    lease.leaseId,
+    logger,
+    signal,
+    progressTimeoutMs
+  );
   const ctx = {
     task: lease.task,
     leaseId: lease.leaseId,
@@ -598,7 +633,7 @@ async function runLease(opts) {
     log: scopedLogger(logger, lease),
     progress: reporter.progress,
     fail: (reason, opts2) => {
-      throw new TerminalFailure(reason, opts2?.code);
+      throw new HandlerFailure(reason, opts2?.code, opts2?.details, opts2?.kind);
     }
   };
   let output;
@@ -618,13 +653,16 @@ async function runLease(opts) {
       );
       return;
     }
-    if (err instanceof TerminalFailure) {
+    if (err instanceof HandlerFailure) {
       await sendNack(
         transport,
         lease.leaseId,
-        "terminal",
+        err.kind,
         err.reason,
-        { code: err.code ?? "HANDLER_TERMINAL" },
+        {
+          code: err.code ?? (err.kind === "terminal" ? "HANDLER_TERMINAL" : "HANDLER_RETRYABLE"),
+          ...err.details !== void 0 ? { details: err.details } : {}
+        },
         logger
       );
       return;
@@ -972,7 +1010,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;
@@ -1214,6 +1253,6 @@ var Neuron = class extends EventEmitter {
 };
 var SSE_EVENT_NAMES = SSE_EVENT;
 
-export { HttpTransport, Neuron, SSE_EVENT_NAMES, SchemaValidator, ShutdownError, TransportError, WorkerPool, defineCapability, toPlanShape, toRegistrationCapability };
+export { HandlerFailure, HttpTransport, Neuron, SSE_EVENT_NAMES, SchemaValidator, ShutdownError, TransportError, WorkerPool, defineCapability, toPlanShape, toRegistrationCapability };
 //# sourceMappingURL=index.mjs.map
 //# sourceMappingURL=index.mjs.map