@noetic-tools/types 1.3.0 → 2.0.0

package/dist/types/detached.d.ts

@@ -1,8 +1,8 @@
 /** @public Lifecycle states for a detached (background) execution. */
 declare const DetachedStatus: {
-    readonly Running: "running";
-    readonly Completed: "completed";
-    readonly Failed: "failed";
+    readonly Running: 'running';
+    readonly Completed: 'completed';
+    readonly Failed: 'failed';
 };
 type DetachedStatus = (typeof DetachedStatus)[keyof typeof DetachedStatus];
 /** @public Handle returned by `detachedSpawn`, used to poll or await a background execution. */

package/dist/types/memory.d.ts

@@ -113,6 +113,21 @@ export interface StorageAdapter {
     set<T>(key: string, value: T): Promise<void>;
     delete(key: string): Promise<void>;
     list(prefix: string): Promise<string[]>;
+    /**
+     * Batch read. Anything that lists a prefix and then reads each key is an N+1 —
+     * one round trip per key on a network- or database-backed adapter, which is
+     * exactly what a resume path cannot afford. Implement this and the round trips
+     * collapse to one.
+     *
+     * Optional so existing adapters keep working: callers MUST NOT depend on it
+     * directly — go through `storageGetMany`, which falls back to a parallel
+     * `get` sweep when a backend has not implemented it.
+     *
+     * Keys with no stored value are ABSENT from the returned map. The map is never
+     * sparse-with-nulls, so `map.size < keys.length` is the normal way to see that
+     * something was missing.
+     */
+    getMany?<T>(keys: string[]): Promise<Map<string, T>>;
 }
 /** @public Scope-namespaced storage interface provided to memory layer init hooks. */
 export interface ScopedStorage {
@@ -120,6 +135,13 @@ export interface ScopedStorage {
     set<T>(key: string, value: T): Promise<void>;
     delete(key: string): Promise<void>;
     list(prefix?: string): Promise<string[]>;
+    /**
+     * Batch read, always available — the scoped wrapper supplies the fallback so a
+     * layer never has to check. Returned keys are scope-relative (the namespace
+     * prefix is stripped, as with `list`), and missing keys are absent rather than
+     * null.
+     */
+    getMany<T>(keys: string[]): Promise<Map<string, T>>;
 }
 /** @public Parameters passed to a memory layer's `init` hook. */
 export interface InitParams {
@@ -173,6 +195,13 @@ export interface ReturnParams<TState> {
     childLog: ItemLog;
     parentState: TState;
     result: unknown;
+    /**
+     * The child's execution context — the same one passed to `onSpawn`. Layers
+     * that merge artifacts from several concurrent children (fan-out) use
+     * `childCtx.executionId` to namespace the child's contribution instead of
+     * letting the last child to return silently overwrite its siblings.
+     */
+    childCtx: ExecutionContext;
 }
 /** @public Value returned by a memory layer's `onReturn` hook with the merged parent state. */
 export interface ReturnResult<TState> {

package/dist/types/sub-harness.d.ts

@@ -28,10 +28,10 @@ import type { SubprocessAdapter } from './subprocess-adapter.js';
  * @public
  */
 export declare const SubHarnessKind: {
-    readonly ClaudeCode: "claude-code";
-    readonly Codex: "codex";
-    readonly Opencode: "opencode";
-    readonly Pi: "pi";
+    readonly ClaudeCode: 'claude-code';
+    readonly Codex: 'codex';
+    readonly Opencode: 'opencode';
+    readonly Pi: 'pi';
 };
 /** @public Union of all harness step kinds. */
 export type SubHarnessKind = (typeof SubHarnessKind)[keyof typeof SubHarnessKind];
@@ -107,9 +107,9 @@ export declare const SubHarnessStreamPartSchema: z.ZodDiscriminatedUnion<[z.ZodO
 }, z.core.$strip>, z.ZodObject<{
     type: z.ZodLiteral<"finish">;
     finishReason: z.ZodEnum<{
+        aborted: "aborted";
         error: "error";
         length: "length";
-        aborted: "aborted";
         stop: "stop";
         "tool-calls": "tool-calls";
     }>;

package/package.json

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