@noetic-tools/core 0.0.1 → 0.1.0

package/dist/memory/layer-lifecycle.d.ts

@@ -1,6 +1,6 @@
 import type { ItemSchemaRegistry } from '../schemas/item';
 import type { LLMResponse } from '../types/common';
-import type { ItemLog } from '../types/context';
+import type { ItemLog } from '../types/context-parts/item-log';
 import type { Item } from '../types/items';
 import type { ExecutionContext, MemoryLayer, StorageAdapter } from '../types/memory';
 import type { SteeringDecision } from '../types/steering';

package/dist/memory/layer-lifecycle.js

@@ -1,8 +1,8 @@
 import { NoeticConfigError } from '../errors/noetic-config-error';
-import { frameworkCast } from '../interpreter/framework-cast';
-import { createMessage, estimateTokens } from '../interpreter/message-helpers';
 import { defaultItemSchemaRegistry } from '../schemas/item';
 import { SteeringAction } from '../types/steering';
+import { frameworkCast } from '../util/framework-cast';
+import { createMessage, estimateTokens } from '../util/message-helpers';
 import { createScopedStorage, resolveScopeKey } from './scope';
 /** Maximum allowed re-render depth to prevent infinite loops */
 const MAX_RERENDER_DEPTH = 3;

package/dist/memory/layer-provides.d.ts

@@ -0,0 +1,32 @@
+import type { ZodType } from 'zod';
+import type { ExecutionContext, LayerDataDecl, LayerFunctionDecl } from '../types/memory';
+/**
+ * Creates a read-only data declaration for a memory layer's `provides` map.
+ *
+ * @public
+ * @param opts.read - Function that projects a value from the layer's current state.
+ * @returns A `LayerDataDecl` to include in a layer's `provides`.
+ */
+export declare function layerData<T, TState>(opts: {
+    read: (state: TState) => T;
+}): LayerDataDecl<T, TState>;
+/**
+ * Creates a callable function declaration for a memory layer's `provides` map.
+ * Functions are accessible via `ctx.memory['layerId'].fn()` and automatically exposed as LLM tools.
+ *
+ * @public
+ * @param opts.description - Human-readable description used as tool description for LLM.
+ * @param opts.input - Zod schema validating input arguments.
+ * @param opts.output - Zod schema validating the return value.
+ * @param opts.execute - Async function receiving args, current state, and execution context.
+ * @returns A `LayerFunctionDecl` to include in a layer's `provides`.
+ */
+export declare function layerFn<TInput, TOutput, TState>(opts: {
+    description: string;
+    input: ZodType<TInput>;
+    output: ZodType<TOutput>;
+    execute: (args: TInput, state: TState, ctx: ExecutionContext) => Promise<{
+        result: TOutput;
+        state?: TState;
+    }>;
+}): LayerFunctionDecl<TInput, TOutput, TState>;

package/dist/memory/layer-provides.js

@@ -0,0 +1,33 @@
+/**
+ * Creates a read-only data declaration for a memory layer's `provides` map.
+ *
+ * @public
+ * @param opts.read - Function that projects a value from the layer's current state.
+ * @returns A `LayerDataDecl` to include in a layer's `provides`.
+ */
+export function layerData(opts) {
+    return {
+        kind: 'data',
+        read: opts.read,
+    };
+}
+/**
+ * Creates a callable function declaration for a memory layer's `provides` map.
+ * Functions are accessible via `ctx.memory['layerId'].fn()` and automatically exposed as LLM tools.
+ *
+ * @public
+ * @param opts.description - Human-readable description used as tool description for LLM.
+ * @param opts.input - Zod schema validating input arguments.
+ * @param opts.output - Zod schema validating the return value.
+ * @param opts.execute - Async function receiving args, current state, and execution context.
+ * @returns A `LayerFunctionDecl` to include in a layer's `provides`.
+ */
+export function layerFn(opts) {
+    return {
+        kind: 'function',
+        description: opts.description,
+        input: opts.input,
+        output: opts.output,
+        execute: opts.execute,
+    };
+}

package/dist/memory/layer-usage.d.ts

@@ -1,6 +1,7 @@
-import type { Tool } from '../types/common';
-import type { Context, LastLayerUsage } from '../types/context';
+import type { Context } from '../types/context';
+import type { LastLayerUsage } from '../types/context-parts/layer-usage';
 import type { RecallLayerOutput } from '../types/runtime';
+import type { Tool } from '../types/tool';
 interface ComputeLayerUsageParams {
     ctx: Context;
     modelId: string;

package/dist/memory/layer-usage.js

@@ -1,5 +1,11 @@
-import { estimateTokens } from '../interpreter/message-helpers';
-import { isContextImpl } from '../interpreter/typeguards';
+import { estimateTokens } from '../util/message-helpers';
+function canWriteLayerUsage(ctx) {
+    const desc = Object.getOwnPropertyDescriptor(ctx, 'lastLayerUsage');
+    if (desc === undefined) {
+        return false;
+    }
+    return desc.writable !== false;
+}
 //#endregion
 //#region Helpers
 function estimateJsonTokens(value) {
@@ -40,7 +46,7 @@ export function computeLayerUsage({ ctx, modelId, instructions, tools, recallRes
 }
 /** Commit computed usage to the Context, replacing any prior snapshot. */
 export function commitLayerUsage(ctx, usage) {
-    if (!isContextImpl(ctx)) {
+    if (!canWriteLayerUsage(ctx)) {
         return;
     }
     ctx.lastLayerUsage = usage;

package/dist/memory/layers/durable-task-state.js

@@ -1,5 +1,5 @@
-import { createMessage, estimateTokens } from '../../interpreter/message-helpers';
 import { Slot } from '../../types/memory';
+import { createMessage, estimateTokens } from '../../util/message-helpers';
 /**
  * Creates a memory layer that persists task checkpoints, files, and arbitrary data across iterations.
  *