@noetic-tools/context 1.0.0

package/dist/context/scope.d.ts

@@ -0,0 +1,3 @@
+import type { ContextScope, ExecutionContext, ScopedStorage, StorageAdapter } from '@noetic-tools/types';
+export declare function resolveScopeKey(scope: ContextScope, ctx: ExecutionContext): string;
+export declare function createScopedStorage(storage: StorageAdapter, layerId: string, scopeKey: string): ScopedStorage;

package/dist/context/scope.js

@@ -0,0 +1,42 @@
+import { storageGetMany } from './storage-batch.js';
+export function resolveScopeKey(scope, ctx) {
+    switch (scope) {
+        case 'thread':
+            return ctx.threadId;
+        case 'resource':
+            return ctx.resourceId ?? ctx.threadId;
+        case 'global':
+            return '__global__';
+        case 'execution':
+            return ctx.executionId;
+    }
+}
+export function createScopedStorage(storage, layerId, scopeKey) {
+    const prefix = `layers/${layerId}/${scopeKey}/`;
+    return {
+        async get(key) {
+            return storage.get(`${prefix}${key}`);
+        },
+        async set(key, value) {
+            return storage.set(`${prefix}${key}`, value);
+        },
+        async delete(key) {
+            return storage.delete(`${prefix}${key}`);
+        },
+        async list(keyPrefix) {
+            const fullPrefix = keyPrefix ? `${prefix}${keyPrefix}` : prefix;
+            const keys = await storage.list(fullPrefix);
+            return keys.map((k) => (k.startsWith(prefix) ? k.slice(prefix.length) : k));
+        },
+        async getMany(keys) {
+            const scoped = await storageGetMany(storage, keys.map((k) => `${prefix}${k}`));
+            // Hand back the keys the caller passed in, not the namespaced ones —
+            // `list` already strips the prefix and a layer never sees it otherwise.
+            const unscoped = new Map();
+            for (const [key, value] of scoped) {
+                unscoped.set(key.startsWith(prefix) ? key.slice(prefix.length) : key, value);
+            }
+            return unscoped;
+        },
+    };
+}

package/dist/context/storage-batch.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Batch reads over a `StorageAdapter`, with the fallback every caller would
+ * otherwise write itself.
+ *
+ * `StorageAdapter.getMany` is optional — an adapter published before it existed
+ * is still valid — so no consumer may call it directly. They call this instead:
+ * one round trip where the backend supports it, a parallel `get` sweep where it
+ * does not. The sweep is deliberately parallel, since the loops this replaces
+ * were serial and paid full latency per key.
+ */
+import type { StorageAdapter } from '@noetic-tools/types';
+/**
+ * @public
+ * Read many keys at once. Keys with no stored value are absent from the result,
+ * so both paths agree: `null` never appears as a value, and `map.size` counts
+ * only what was actually there.
+ */
+export declare function storageGetMany<T>(storage: Pick<StorageAdapter, 'get' | 'getMany'>, keys: string[]): Promise<Map<string, T>>;

package/dist/context/storage-batch.js

@@ -0,0 +1,35 @@
+/**
+ * Batch reads over a `StorageAdapter`, with the fallback every caller would
+ * otherwise write itself.
+ *
+ * `StorageAdapter.getMany` is optional — an adapter published before it existed
+ * is still valid — so no consumer may call it directly. They call this instead:
+ * one round trip where the backend supports it, a parallel `get` sweep where it
+ * does not. The sweep is deliberately parallel, since the loops this replaces
+ * were serial and paid full latency per key.
+ */
+/**
+ * @public
+ * Read many keys at once. Keys with no stored value are absent from the result,
+ * so both paths agree: `null` never appears as a value, and `map.size` counts
+ * only what was actually there.
+ */
+export async function storageGetMany(storage, keys) {
+    if (keys.length === 0) {
+        /* Touch storage for nothing and a D1-backed adapter still pays a query. */
+        return new Map();
+    }
+    if (storage.getMany) {
+        return storage.getMany(keys);
+    }
+    const values = await Promise.all(keys.map((key) => storage.get(key)));
+    const found = new Map();
+    for (let i = 0; i < keys.length; i++) {
+        const value = values[i];
+        if (value === null || value === undefined) {
+            continue;
+        }
+        found.set(keys[i], value);
+    }
+    return found;
+}

package/dist/context/strip-unresolved.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Drop dangling tool-call state from an item list. A `function_call` without a
+ * matching `function_call_output` (or vice-versa) wedges the model on the next
+ * round (it typically fabricates an output), so we filter both sides of any
+ * incomplete pair. Order-preserving and pure — safe to run after a slice.
+ *
+ * Mirrors Claude Code's `filterUnresolvedToolUses`. Used by the CLI's
+ * session-resume path to drop dangling pairs left by a crash, and by the
+ * `historyWindow` context layer to clean orphans at the slice boundary.
+ */
+import type { Item } from '@noetic-tools/types';
+/** @public */
+export declare function stripUnresolvedToolCalls(items: ReadonlyArray<Item>): Item[];

package/dist/context/strip-unresolved.js

@@ -0,0 +1,35 @@
+/**
+ * Drop dangling tool-call state from an item list. A `function_call` without a
+ * matching `function_call_output` (or vice-versa) wedges the model on the next
+ * round (it typically fabricates an output), so we filter both sides of any
+ * incomplete pair. Order-preserving and pure — safe to run after a slice.
+ *
+ * Mirrors Claude Code's `filterUnresolvedToolUses`. Used by the CLI's
+ * session-resume path to drop dangling pairs left by a crash, and by the
+ * `historyWindow` context layer to clean orphans at the slice boundary.
+ */
+/** @public */
+export function stripUnresolvedToolCalls(items) {
+    const outputCallIds = new Set();
+    const callCallIds = new Set();
+    for (const item of items) {
+        if (item.type === 'function_call_output') {
+            outputCallIds.add(item.callId);
+            continue;
+        }
+        if (item.type === 'function_call') {
+            callCallIds.add(item.callId);
+        }
+    }
+    const keep = [];
+    for (const item of items) {
+        if (item.type === 'function_call' && !outputCallIds.has(item.callId)) {
+            continue;
+        }
+        if (item.type === 'function_call_output' && !callCallIds.has(item.callId)) {
+            continue;
+        }
+        keep.push(item);
+    }
+    return keep;
+}

package/dist/deprecated.d.ts

@@ -0,0 +1,43 @@
+/**
+ * Deprecated aliases from the "memory layer" era of the framework.
+ *
+ * The layer system assembles the model's *context window* — recall, budget
+ * allocation, history projection, the item-append pipeline — so it is named
+ * after context, not memory. Every name below still resolves to its
+ * replacement; nothing here changes behaviour.
+ *
+ * These are scheduled for removal in the next major of `@noetic-tools/context`.
+ */
+export type { ContextMemory, InferMemory, InferMemoryShape, MemoryCallModelRequest, MemoryConfig, MemoryHooks, MemoryLayer, MemoryScope, ToolMemory, ToolMemoryDeclaration, } from '@noetic-tools/types';
+export { 
+/** @deprecated Renamed to `buildContextData`. */
+buildContextData as buildContextMemory, } from './context/layer-api.js';
+export { 
+/** @deprecated Renamed to `observationalContext`. */
+observationalContext as observationalMemory, } from './context/layers/observational-context.js';
+export { 
+/** @deprecated Renamed to `planContext`. */
+planContext as planMemory, } from './context/layers/plan-context.js';
+export { 
+/** @deprecated Renamed to `temporalContext`. */
+temporalContext as temporalMemory, } from './context/layers/temporal-context.js';
+export { 
+/** @deprecated Renamed to `toolContextLayer`. */
+toolContextLayer as toolMemoryLayer, } from './context/layers/tool-context-layer.js';
+export { 
+/** @deprecated Renamed to `workingMemoryContext`. */
+workingMemoryContext as workingMemory, } from './context/layers/working-memory-context.js';
+import type { ObservationalContextConfig } from './context/layers/observational-context.js';
+import type { PlanContextConfig } from './context/layers/plan-context.js';
+import type { TemporalContextConfig } from './context/layers/temporal-context.js';
+import type { WorkingMemoryContextConfig, WorkingMemoryContextState } from './context/layers/working-memory-context.js';
+/** @deprecated Renamed to {@link WorkingMemoryContextConfig}. */
+export type WorkingMemoryConfig = WorkingMemoryContextConfig;
+/** @deprecated Renamed to {@link WorkingMemoryContextState}. */
+export type WorkingMemoryState = WorkingMemoryContextState;
+/** @deprecated Renamed to {@link ObservationalContextConfig}. */
+export type ObservationalMemoryConfig = ObservationalContextConfig;
+/** @deprecated Renamed to {@link TemporalContextConfig}. */
+export type TemporalMemoryConfig = TemporalContextConfig;
+/** @deprecated Renamed to {@link PlanContextConfig}. */
+export type PlanMemoryConfig = PlanContextConfig;

package/dist/deprecated.js

@@ -0,0 +1,28 @@
+/**
+ * Deprecated aliases from the "memory layer" era of the framework.
+ *
+ * The layer system assembles the model's *context window* — recall, budget
+ * allocation, history projection, the item-append pipeline — so it is named
+ * after context, not memory. Every name below still resolves to its
+ * replacement; nothing here changes behaviour.
+ *
+ * These are scheduled for removal in the next major of `@noetic-tools/context`.
+ */
+export { 
+/** @deprecated Renamed to `buildContextData`. */
+buildContextData as buildContextMemory, } from './context/layer-api.js';
+export { 
+/** @deprecated Renamed to `observationalContext`. */
+observationalContext as observationalMemory, } from './context/layers/observational-context.js';
+export { 
+/** @deprecated Renamed to `planContext`. */
+planContext as planMemory, } from './context/layers/plan-context.js';
+export { 
+/** @deprecated Renamed to `temporalContext`. */
+temporalContext as temporalMemory, } from './context/layers/temporal-context.js';
+export { 
+/** @deprecated Renamed to `toolContextLayer`. */
+toolContextLayer as toolMemoryLayer, } from './context/layers/tool-context-layer.js';
+export { 
+/** @deprecated Renamed to `workingMemoryContext`. */
+workingMemoryContext as workingMemory, } from './context/layers/working-memory-context.js';

package/dist/index.d.ts

@@ -0,0 +1,29 @@
+/**
+ * @noetic-tools/context — the context layer system for Noetic agents: the
+ * ContextLayer contract, lifecycle/budget/projection machinery, and built-in
+ * layer implementations.
+ */
+export type { ContextScope, ExecutionContext, ExecutionOutcome, LayerCallModelRequest, } from '@noetic-tools/types';
+export * from '@noetic-tools/types/contract';
+export * from './context/budget.js';
+export * from './context/exec-context-factory.js';
+export * from './context/function-call-utils.js';
+export * from './context/layer-api.js';
+export * from './context/layer-lifecycle.js';
+export * from './context/layer-provides.js';
+export * from './context/layer-usage.js';
+export * from './context/layers/durable-task-state.js';
+export * from './context/layers/file-reference.js';
+export * from './context/layers/history-window.js';
+export * from './context/layers/observational-context.js';
+export * from './context/layers/plan-context.js';
+export * from './context/layers/static-content.js';
+export * from './context/layers/steering.js';
+export * from './context/layers/temporal-context.js';
+export * from './context/layers/tool-context-layer.js';
+export * from './context/layers/working-memory-context.js';
+export * from './context/projector.js';
+export * from './context/scope.js';
+export * from './context/storage-batch.js';
+export * from './context/strip-unresolved.js';
+export * from './deprecated.js';

package/dist/index.js

@@ -0,0 +1,31 @@
+/**
+ * @noetic-tools/context — the context layer system for Noetic agents: the
+ * ContextLayer contract, lifecycle/budget/projection machinery, and built-in
+ * layer implementations.
+ */
+// The ContextLayer contract is foundational (referenced by Context/Step/runtime
+// types), so it physically lives in @noetic-tools/types. Re-export it here so
+// @noetic-tools/context remains the one-stop import for context-layer authoring.
+export * from '@noetic-tools/types/contract';
+export * from './context/budget.js';
+export * from './context/exec-context-factory.js';
+export * from './context/function-call-utils.js';
+export * from './context/layer-api.js';
+export * from './context/layer-lifecycle.js';
+export * from './context/layer-provides.js';
+export * from './context/layer-usage.js';
+export * from './context/layers/durable-task-state.js';
+export * from './context/layers/file-reference.js';
+export * from './context/layers/history-window.js';
+export * from './context/layers/observational-context.js';
+export * from './context/layers/plan-context.js';
+export * from './context/layers/static-content.js';
+export * from './context/layers/steering.js';
+export * from './context/layers/temporal-context.js';
+export * from './context/layers/tool-context-layer.js';
+export * from './context/layers/working-memory-context.js';
+export * from './context/projector.js';
+export * from './context/scope.js';
+export * from './context/storage-batch.js';
+export * from './context/strip-unresolved.js';
+export * from './deprecated.js';

package/package.json

@@ -0,0 +1,63 @@
+{
+  "name": "@noetic-tools/context",
+  "version": "1.0.0",
+  "type": "module",
+  "description": "Context layer system for Noetic agents: the ContextLayer contract, lifecycle, budget/projection machinery, and built-in layer implementations.",
+  "license": "Apache-2.0",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/mattapperson/noetic.git",
+    "directory": "packages/context"
+  },
+  "homepage": "https://github.com/mattapperson/noetic#readme",
+  "bugs": {
+    "url": "https://github.com/mattapperson/noetic/issues"
+  },
+  "keywords": [
+    "noetic",
+    "agents",
+    "context",
+    "llm",
+    "memory"
+  ],
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    },
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "devDependencies": {
+    "bun-types": "latest"
+  },
+  "peerDependencies": {
+    "zod": "^4.0.0"
+  },
+  "dependencies": {
+    "@noetic-tools/types": "^2.3.0",
+    "zod": "^4.0.0"
+  },
+  "scripts": {
+    "build": "bunx tsc -p tsconfig.build.json && bun scripts/add-js-extensions.ts",
+    "verify:esm": "bun scripts/verify-node-esm.ts",
+    "prepublishOnly": "rm -rf dist && bun run build && bun run verify:esm && bun scripts/pin-workspace-deps.ts && bun scripts/strip-dev-conditions.ts",
+    "test": "bun test",
+    "test:coverage": "bun test --coverage --coverage-reporter=text --coverage-reporter=lcov",
+    "test:ci": "bun test --coverage --coverage-reporter=lcov",
+    "typecheck": "bunx tsc --noEmit",
+    "lint": "bunx biome check .",
+    "lint:fix": "bunx biome check --fix .",
+    "format": "bunx biome format --write .",
+    "format:check": "bunx biome format ."
+  }
+}