@noetic-tools/types 2.1.0 → 2.1.1

package/dist/types/context.d.ts

@@ -177,6 +177,11 @@ export interface ContextHarness {
     disposeLayers(layers: MemoryLayer[], ctx: Context): Promise<void>;
     checkpoint(ctx: Context): Promise<void>;
     restore(executionId: string, opts?: RestoreContextOptions): Promise<Context | null>;
+    /**
+     * Cancel an execution: abort `ctx` and every live descendant context, then
+     * run memory-layer teardown (`onComplete` with `outcome: 'aborted'`, then
+     * `dispose`) bottom-up. A no-op on an already-cancelled context.
+     */
     cancel(ctx: Context, reason?: string): Promise<void>;
     /** Trace exporter spans are flushed to. Defaults to a no-op exporter. */
     readonly traceExporter: TraceExporter;
@@ -242,6 +247,18 @@ export interface Context<TMemory = ContextMemory, TState = unknown> {
     readonly completionValue: unknown;
     readonly aborted: boolean;
     readonly abortReason?: string;
+    /**
+     * Cancel this context and everything running beneath it. The first call wins
+     * (later calls are no-ops, so `abortReason` is stable), and it cascades
+     * *down* the execution tree: every live fork path and spawn child is aborted
+     * too. It never travels up — aborting a child leaves the parent running.
+     *
+     * Aborting rejects operations blocked on the context (channel `recv` waiters,
+     * parked back-pressure senders) with `cancelled`, cuts short the in-flight
+     * model call or sub-harness turn, and makes the next step boundary throw
+     * `cancelled`. Memory-layer teardown is NOT run — use
+     * `harness.cancel(ctx, reason)` for that.
+     */
     abort(reason?: string): void;
 }
 export {};

package/dist/types/runtime.d.ts

@@ -251,6 +251,16 @@ export interface AgentHarnessContract<TParams extends Record<string, unknown> =
      * decorated context is silently replaced by a bare one on resume.
      */
     restore(executionId: string, opts?: RestoreContextOptions): Promise<Context | null>;
+    /**
+     * Cancel an execution. Aborts `ctx` and — cascading down the execution tree —
+     * every live fork path and spawn child, then runs memory-layer teardown
+     * (`onComplete` with `outcome: 'aborted'`, then `dispose`) bottom-up.
+     *
+     * Blocked channel operations reject with `cancelled`, the in-flight model
+     * call and sub-harness turn are cut short, and the next step boundary throws
+     * `cancelled`. Idempotent: cancelling an already-cancelled context is a
+     * no-op. Use `ctx.abort()` when you want the signal without layer teardown.
+     */
     cancel(ctx: Context, reason?: string): Promise<void>;
     /** Trace exporter spans are flushed to. Defaults to a no-op exporter. */
     readonly traceExporter: TraceExporter;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@noetic-tools/types",
-  "version": "2.1.0",
+  "version": "2.1.1",
   "type": "module",
   "description": "Foundational type contracts and primitives shared across the Noetic framework (items, LLM config, adapters, steering, errors).",
   "license": "Apache-2.0",