@telorun/sdk 0.38.0 → 0.41.0

package/dist/dispatch-invoke-ref.d.ts

@@ -1,8 +1,9 @@
+import type { InvokeContext } from "./cancellation.js";
 import type { ModuleContext } from "./module-context.js";
 import { type ResourceInstance } from "./resource-instance.js";
 /** The context a decorator kind composes to dispatch its wrapped target. */
 export interface DispatchContext {
-    invokeResolved<TInputs>(kind: string, name: string, instance: ResourceInstance, inputs: TInputs): Promise<unknown>;
+    invokeResolved<TInputs>(kind: string, name: string, instance: ResourceInstance, inputs: TInputs, ctx?: InvokeContext): Promise<unknown>;
     readonly moduleContext: ModuleContext;
 }
 /**
@@ -12,6 +13,9 @@ export interface DispatchContext {
  * against the module context. Resolution is eager (fail-fast on a bad ref);
  * dispatch is deferred, so a caller can run it synchronously (Cache.View) or
  * detached (Run.Detach). `describe` labels the error with the owning resource.
+ * The thunk's optional second argument seeds the dispatch's {@link InvokeContext}
+ * (e.g. a decorator-owned cancellation scope); when omitted the ambient
+ * invocation context applies unchanged.
  */
-export declare function resolveInvocableDispatcher(field: unknown, ctx: DispatchContext, describe: () => string): (inputs: Record<string, unknown>) => Promise<unknown>;
+export declare function resolveInvocableDispatcher(field: unknown, ctx: DispatchContext, describe: () => string): (inputs: Record<string, unknown>, invokeCtx?: InvokeContext) => Promise<unknown>;
 //# sourceMappingURL=dispatch-invoke-ref.d.ts.map

package/dist/dispatch-invoke-ref.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"dispatch-invoke-ref.d.ts","sourceRoot":"","sources":["../src/dispatch-invoke-ref.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACzD,OAAO,EAAkB,KAAK,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAE/E,4EAA4E;AAC5E,MAAM,WAAW,eAAe;IAC9B,cAAc,CAAC,OAAO,EACpB,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,EACZ,QAAQ,EAAE,gBAAgB,EAC1B,MAAM,EAAE,OAAO,GACd,OAAO,CAAC,OAAO,CAAC,CAAC;IACpB,QAAQ,CAAC,aAAa,EAAE,aAAa,CAAC;CACvC;AAED;;;;;;;GAOG;AACH,wBAAgB,0BAA0B,CACxC,KAAK,EAAE,OAAO,EACd,GAAG,EAAE,eAAe,EACpB,QAAQ,EAAE,MAAM,MAAM,GACrB,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,OAAO,CAAC,OAAO,CAAC,CAoBvD"}
+{"version":3,"file":"dispatch-invoke-ref.d.ts","sourceRoot":"","sources":["../src/dispatch-invoke-ref.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAEvD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACzD,OAAO,EAAkB,KAAK,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAE/E,4EAA4E;AAC5E,MAAM,WAAW,eAAe;IAC9B,cAAc,CAAC,OAAO,EACpB,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,EACZ,QAAQ,EAAE,gBAAgB,EAC1B,MAAM,EAAE,OAAO,EACf,GAAG,CAAC,EAAE,aAAa,GAClB,OAAO,CAAC,OAAO,CAAC,CAAC;IACpB,QAAQ,CAAC,aAAa,EAAE,aAAa,CAAC;CACvC;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,0BAA0B,CACxC,KAAK,EAAE,OAAO,EACd,GAAG,EAAE,eAAe,EACpB,QAAQ,EAAE,MAAM,MAAM,GACrB,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,SAAS,CAAC,EAAE,aAAa,KAAK,OAAO,CAAC,OAAO,CAAC,CAsBlF"}

package/dist/dispatch-invoke-ref.js

@@ -6,12 +6,17 @@ import { getRefIdentity } from "./resource-instance.js";
  * against the module context. Resolution is eager (fail-fast on a bad ref);
  * dispatch is deferred, so a caller can run it synchronously (Cache.View) or
  * detached (Run.Detach). `describe` labels the error with the owning resource.
+ * The thunk's optional second argument seeds the dispatch's {@link InvokeContext}
+ * (e.g. a decorator-owned cancellation scope); when omitted the ambient
+ * invocation context applies unchanged.
  */
 export function resolveInvocableDispatcher(field, ctx, describe) {
     if (field && typeof field.invoke === "function") {
         const instance = field;
         const id = getRefIdentity(field);
-        return (inputs) => id ? ctx.invokeResolved(id.kind, id.name, instance, inputs) : instance.invoke(inputs);
+        return (inputs, invokeCtx) => id
+            ? ctx.invokeResolved(id.kind, id.name, instance, inputs, invokeCtx)
+            : instance.invoke(inputs, invokeCtx);
     }
     const ref = field;
     if (!ref || typeof ref.name !== "string") {
@@ -23,5 +28,5 @@ export function resolveInvocableDispatcher(field, ctx, describe) {
     if (!resolved || typeof resolved.invoke !== "function") {
         throw new Error(`${describe()}: 'invoke' reference '${ref.name}' did not resolve to an invocable.`);
     }
-    return (inputs) => ctx.invokeResolved(ref.kind, ref.name, resolved, inputs);
+    return (inputs, invokeCtx) => ctx.invokeResolved(ref.kind, ref.name, resolved, inputs, invokeCtx);
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@telorun/sdk",
-  "version": "0.38.0",
+  "version": "0.41.0",
   "description": "Telo SDK - Public API for Telo module authors.",
   "keywords": [
     "telo",

package/src/dispatch-invoke-ref.ts

@@ -1,3 +1,4 @@
+import type { InvokeContext } from "./cancellation.js";
 import type { Invocable } from "./capabilities/invokable.js";
 import type { ModuleContext } from "./module-context.js";
 import { getRefIdentity, type ResourceInstance } from "./resource-instance.js";
@@ -9,6 +10,7 @@ export interface DispatchContext {
     name: string,
     instance: ResourceInstance,
     inputs: TInputs,
+    ctx?: InvokeContext,
   ): Promise<unknown>;
   readonly moduleContext: ModuleContext;
 }
@@ -20,17 +22,22 @@ export interface DispatchContext {
  * against the module context. Resolution is eager (fail-fast on a bad ref);
  * dispatch is deferred, so a caller can run it synchronously (Cache.View) or
  * detached (Run.Detach). `describe` labels the error with the owning resource.
+ * The thunk's optional second argument seeds the dispatch's {@link InvokeContext}
+ * (e.g. a decorator-owned cancellation scope); when omitted the ambient
+ * invocation context applies unchanged.
  */
 export function resolveInvocableDispatcher(
   field: unknown,
   ctx: DispatchContext,
   describe: () => string,
-): (inputs: Record<string, unknown>) => Promise<unknown> {
+): (inputs: Record<string, unknown>, invokeCtx?: InvokeContext) => Promise<unknown> {
   if (field && typeof (field as Invocable).invoke === "function") {
     const instance = field as ResourceInstance & Invocable;
     const id = getRefIdentity(field as object);
-    return (inputs) =>
-      id ? ctx.invokeResolved(id.kind, id.name, instance, inputs) : instance.invoke(inputs);
+    return (inputs, invokeCtx) =>
+      id
+        ? ctx.invokeResolved(id.kind, id.name, instance, inputs, invokeCtx)
+        : instance.invoke(inputs, invokeCtx);
   }
   const ref = field as { kind: string; name: string; alias?: string } | undefined;
   if (!ref || typeof ref.name !== "string") {
@@ -44,5 +51,5 @@ export function resolveInvocableDispatcher(
   if (!resolved || typeof resolved.invoke !== "function") {
     throw new Error(`${describe()}: 'invoke' reference '${ref.name}' did not resolve to an invocable.`);
   }
-  return (inputs) => ctx.invokeResolved(ref.kind, ref.name, resolved, inputs);
+  return (inputs, invokeCtx) => ctx.invokeResolved(ref.kind, ref.name, resolved, inputs, invokeCtx);
 }