@noetic-tools/core 0.0.1 → 0.1.1

package/dist/index.js

@@ -1,112 +1,136 @@
 //#region Adapters
 /** @public */
-export { createInMemoryFsAdapter } from './adapters/in-memory-fs-adapter';
+export { createInMemoryFsAdapter } from './adapters/in-memory-fs-adapter.js';
 /** @public */
-export { createInMemoryShellAdapter } from './adapters/in-memory-shell-adapter';
+export { createInMemoryShellAdapter } from './adapters/in-memory-shell-adapter.js';
 /** @public */
-export { createInMemorySubprocessAdapter } from './adapters/in-memory-subprocess-adapter';
+export { createInMemorySubprocessAdapter } from './adapters/in-memory-subprocess-adapter.js';
 /** @public */
-export { createLocalFsAdapter } from './adapters/local-fs-adapter';
-/** @public */
-export { createLocalShellAdapter, } from './adapters/local-shell-adapter';
-/** @public */
-export { createLocalSubprocessAdapter, defaultProcessSignaller, } from './adapters/local-subprocess-adapter';
-/** @public */
-export { createOpenRouterEmbed } from './adapters/openrouter';
+export { createOpenRouterEmbed } from './adapters/openrouter.js';
 //#endregion
 //#region Builders
 /** @public */
-export { channel } from './builders/channel-builder';
+export { channel } from './builders/channel-builder.js';
+/** @public */
+export { branch, fork } from './builders/control-flow-builders.js';
+/** @public */
+export { every } from './builders/every.js';
 /** @public */
-export { branch, fork } from './builders/control-flow-builders';
+export { layerData, layerFn } from './builders/layer-provides-builders.js';
 /** @public */
-export { every } from './builders/every';
+export { loop } from './builders/loop-builder.js';
 /** @public */
-export { layerData, layerFn } from './builders/layer-provides-builders';
+export { memory } from './builders/memory-builder.js';
 /** @public */
-export { loop } from './builders/loop-builder';
+export { provide } from './builders/provide-builder.js';
 /** @public */
-export { memory } from './builders/memory-builder';
+export { spawn } from './builders/spawn-builder.js';
 /** @public */
-export { provide } from './builders/provide-builder';
+export { step } from './builders/step-builders.js';
 /** @public */
-export { spawn } from './builders/spawn-builder';
+export { tool, toolWithGenerator } from './builders/tool-builder.js';
 /** @public */
-export { step } from './builders/step-builders';
+export { hydrateNode, hydrateWorkflow } from './builders/workflow-hydrator.js';
 /** @public */
-export { tool, toolWithGenerator } from './builders/tool-builder';
+export { aiCondition, allCondition, anyCondition, embeddingMatch, otherwise, semanticRoute, semanticSwitch, when, } from './conditions/conditions.js';
 /** @public */
-export { aiCondition, allCondition, anyCondition, cosineSimilarity, embeddingMatch, otherwise, semanticRoute, semanticSwitch, when, } from './conditions';
+export { cosineSimilarity } from './conditions/cosine-similarity.js';
 //#endregion
 //#region Errors
 /** @public */
-export { isNoeticConfigError, NoeticConfigError } from './errors/noetic-config-error';
+export { isNoeticConfigError, NoeticConfigError } from './errors/noetic-config-error.js';
 /** @public */
-export { isNoeticError, NoeticErrorImpl } from './errors/noetic-error';
+export { isNoeticError, NoeticErrorImpl } from './errors/noetic-error.js';
+/** @public */
+export { AskUserAnnotationSchema, AskUserInputSchema, AskUserOptionSchema, AskUserOutputSchema, AskUserQuestionSchema, } from './types/ask-user-types.js';
 //#endregion
 //#region Execution
 /** @public */
-export { execute } from './interpreter/execute';
+export { execute } from './interpreter/execute.js';
+//#endregion
+//#region Memory Layers
+/** @public */
+export { findFunctionCall } from './memory/function-call-utils.js';
 /** @public */
-export { durableTaskState } from './memory/layers/durable-task-state';
+export { durableTaskState } from './memory/layers/durable-task-state.js';
 /** @public */
-export { fileReference } from './memory/layers/file-reference';
+export { fileReference } from './memory/layers/file-reference.js';
 /** @public */
-export { historyWindow } from './memory/layers/history-window';
+export { historyWindow } from './memory/layers/history-window.js';
 /** @public */
-export { observationalMemory } from './memory/layers/observational-memory';
+export { observationalMemory } from './memory/layers/observational-memory.js';
 /** @public */
-export { PlanPhase, planMemory } from './memory/layers/plan';
+export { PlanPhase, planMemory } from './memory/layers/plan.js';
 /** @public */
-export { staticContent } from './memory/layers/static-content';
+export { staticContent } from './memory/layers/static-content.js';
 /** @public */
-export { steering } from './memory/layers/steering';
+export { steering } from './memory/layers/steering.js';
 /** @public */
-export { toolMemoryLayer } from './memory/layers/tool-memory-layer';
+export { toolMemoryLayer } from './memory/layers/tool-memory-layer.js';
 /** @public */
-export { workingMemory } from './memory/layers/working-memory';
+export { workingMemory } from './memory/layers/working-memory.js';
 /** @public */
-export { stripUnresolvedToolCalls } from './memory/strip-unresolved';
+export { stripUnresolvedToolCalls } from './memory/strip-unresolved.js';
+//#endregion
+//#region Message Utilities
+/** @public */
+export { createMessage, estimateTokens } from './util/message-helpers.js';
 //#endregion
 //#region Observability
 /** @public */
-export { InMemoryExporter, NoopExporter } from './observability/trace-exporter';
+export { GenAI, ToolAttr } from './observability/genai-attributes.js';
+/** @public */
+export { InMemoryExporter, NoopExporter } from './observability/trace-exporter.js';
 /** @public */
-export { createInMemoryStorage } from './runtime/in-memory-storage';
+export { createInMemoryStorage } from './runtime/in-memory-storage.js';
 /** @public */
-export { FlowSchema, flowDepth, validateFlow, walkFlow } from './patterns/flow';
+export { dynamicWorkflow, parseAndRunWorkflow } from './patterns/dynamic-workflow.js';
 /** @public */
-export { interview } from './patterns/interview';
+export { FlowSchema, flowDepth, validateFlow, walkFlow } from './patterns/flow.js';
 /** @public */
-export { adaptivePlan, compilePlan, PlanNodeSchema } from './patterns/plans';
+export { interview } from './patterns/interview.js';
 /** @public */
-export { ralphWiggum } from './patterns/ralph-wiggum';
+export { adaptivePlan, compilePlan, PlanNodeSchema } from './patterns/plans.js';
 /** @public */
-export { react } from './patterns/react';
+export { ralphWiggum } from './patterns/ralph-wiggum.js';
+/** @public */
+export { react } from './patterns/react.js';
 //#endregion
 //#region Runtime
 /** @public */
-export { AgentHarness } from './runtime/agent-harness';
+export { AgentHarness } from './harness/agent-harness.js';
+/** @public */
+export { CheckpointKeys, createCheckpointStore, createDetachedSignal, createNudgeMessage, createStallNudgeHook, DEFAULT_NUDGE_MESSAGE_TEXT, runnableLoop, seedFromItems, } from './runtime/durable/index.js';
+/** @public */
+export { getRegistry, lookupStep, registerStep } from './runtime/step-registry.js';
 //#endregion
 //#region Schemas
 /** @public */
-export { defaultItemSchemaRegistry, ItemSchema, ItemSchemaRegistry } from './schemas/item';
+export { defaultItemSchemaRegistry, ItemSchema, ItemSchemaRegistry } from './schemas/item.js';
+/** @public */
+export { MergeStrategySchema, UntilPredicateSchema, validateWorkflow, WorkflowDocumentSchema, WorkflowNodeSchema, walkWorkflow, workflowDepth, } from './schemas/workflow.js';
 //#endregion
 //#region Types — Context
 /** @public */
-export { getToolCwd, setToolCwd, snapshotCwdState } from './runtime/cwd-helpers';
+export { getToolCwd, setToolCwd, snapshotCwdState } from './runtime/cwd-helpers.js';
 /** @public */
-export { DetachedStatus } from './types/detached';
+export { DetachedStatus } from './types/detached.js';
 /** @public */
-export { Slot } from './types/memory';
+export { CheckpointSchemaVersion, CheckpointSnapshotSchema, CwdSnapshotSchema, FrontierFrameSchema, ItemLogSnapshotSchema, PendingAskUserSnapshotSchema, } from './types/checkpoint.js';
 /** @public */
-export { LedgerEntryKind, SteeringAction } from './types/steering';
+export { Slot } from './types/memory.js';
+/** @public */
+export { LedgerEntryKind, SteeringAction } from './types/steering.js';
+//#endregion
+//#region Types — Shell
+/** @public Reusable error-serialiser used by custom SubprocessAdapter implementations. */
+export { serializeError } from './adapters/in-memory-subprocess/metadata.js';
 /** @public */
-export { TIMEOUT_ERROR_PREFIX } from './types/shell-adapter';
+export { TIMEOUT_ERROR_PREFIX } from './types/shell-adapter.js';
 //#endregion
 //#region Until
 /** @public */
-export { all, any } from './until/combinators';
+export { all, any } from './until/combinators.js';
 /** @public */
-export { until } from './until/predicates';
+export { until } from './until/predicates.js';
 //#endregion

package/dist/internal-test.d.ts

@@ -5,7 +5,7 @@
  * These are implementation classes that tests need to construct mock instances.
  * Application code should NEVER import from this path.
  */
-export { SpanImpl } from './observability/span-impl';
-export { ChannelStore } from './runtime/channel-store';
-export { ContextImpl } from './runtime/context-impl';
-export { ItemLogImpl } from './runtime/item-log-impl';
+export { SpanImpl } from './observability/span-impl.js';
+export { ChannelStore } from './runtime/channel-store.js';
+export { ContextImpl } from './runtime/context-impl.js';
+export { ItemLogImpl } from './runtime/item-log-impl.js';

package/dist/internal-test.js

@@ -5,7 +5,7 @@
  * These are implementation classes that tests need to construct mock instances.
  * Application code should NEVER import from this path.
  */
-export { SpanImpl } from './observability/span-impl';
-export { ChannelStore } from './runtime/channel-store';
-export { ContextImpl } from './runtime/context-impl';
-export { ItemLogImpl } from './runtime/item-log-impl';
+export { SpanImpl } from './observability/span-impl.js';
+export { ChannelStore } from './runtime/channel-store.js';
+export { ContextImpl } from './runtime/context-impl.js';
+export { ItemLogImpl } from './runtime/item-log-impl.js';

package/dist/interpreter/action-deps.d.ts

@@ -0,0 +1,12 @@
+export { contextToExecCtx } from '../memory/exec-context-factory.js';
+export { resolveLayerTools } from '../memory/layer-api.js';
+export type { LayerStateStore } from '../memory/layer-lifecycle.js';
+export { returnLayers, spawnLayers } from '../memory/layer-lifecycle.js';
+export { commitLayerUsage, computeLayerUsage } from '../memory/layer-usage.js';
+export { assembleView } from '../memory/projector.js';
+export { emitFrameworkEvent, getBroadcaster } from '../runtime/broadcaster-utils.js';
+export { ContextImpl } from '../runtime/context-impl.js';
+export { snapshotCwdState } from '../runtime/cwd-helpers.js';
+export { buildToolExecutionContext } from '../runtime/tool-memory.js';
+export type { ItemSchemaRegistry } from '../schemas/item.js';
+export { defaultItemSchemaRegistry } from '../schemas/item.js';

package/dist/interpreter/action-deps.js

@@ -0,0 +1,10 @@
+export { contextToExecCtx } from '../memory/exec-context-factory.js';
+export { resolveLayerTools } from '../memory/layer-api.js';
+export { returnLayers, spawnLayers } from '../memory/layer-lifecycle.js';
+export { commitLayerUsage, computeLayerUsage } from '../memory/layer-usage.js';
+export { assembleView } from '../memory/projector.js';
+export { emitFrameworkEvent, getBroadcaster } from '../runtime/broadcaster-utils.js';
+export { ContextImpl } from '../runtime/context-impl.js';
+export { snapshotCwdState } from '../runtime/cwd-helpers.js';
+export { buildToolExecutionContext } from '../runtime/tool-memory.js';
+export { defaultItemSchemaRegistry } from '../schemas/item.js';

package/dist/interpreter/action-types.d.ts

@@ -0,0 +1,8 @@
+export type { RetryPolicy, StepMeta } from '../types/common.js';
+export type { Context } from '../types/context.js';
+export type { FunctionCallItem, Item } from '../types/items.js';
+export type { ContextMemory, ExecutionContext, MemoryConfig, MemoryLayer } from '../types/memory.js';
+export type { AgentHarnessContract, RecallLayerOutput } from '../types/runtime.js';
+export { SteeringAction } from '../types/steering.js';
+export type { ExecuteStepFn, StepLLM, StepProvide, StepRun, StepSpawn, StepTool, } from '../types/step.js';
+export type { Tool } from '../types/tool.js';

package/dist/interpreter/action-types.js

@@ -0,0 +1 @@
+export { SteeringAction } from '../types/steering.js';

package/dist/interpreter/collect-tools.d.ts

@@ -1,5 +1,5 @@
-import type { Tool } from '../types/common';
-import type { Step } from '../types/step';
+import type { Step } from '../types/step.js';
+import type { Tool } from '../types/tool.js';
 /**
  * Recursively walks a step tree and collects all Tool instances
  * declared on LLM steps. Used to build the unified tool set

package/dist/interpreter/collect-tools.js

@@ -1,4 +1,4 @@
-import { frameworkCast } from './framework-cast';
+import { frameworkCast } from '../util/framework-cast.js';
 /**
  * Recursively walks a step tree and collects all Tool instances
  * declared on LLM steps. Used to build the unified tool set
@@ -28,7 +28,11 @@ export function deduplicateTools(tools) {
 function walkStep(step, out) {
     switch (step.kind) {
         case 'llm':
-            if (step.tools) {
+            // Skip function-form tools: they're resolved per execution from `ctx`
+            // and cannot contribute to the pre-computed unified set. Consumers that
+            // need those tools in the pool should register them via
+            // `AgentHarness.tools` instead.
+            if (Array.isArray(step.tools)) {
                 out.push(...step.tools);
             }
             return;

package/dist/interpreter/execute-action.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Action step handlers: run, llm, spawn, provide, tool.
+ */
+import type { ItemSchemaRegistry, LayerStateStore } from './action-deps.js';
+import type { AgentHarnessContract, Context, ExecuteStepFn, MemoryLayer, StepLLM, StepProvide, StepRun, StepSpawn, StepTool } from './action-types.js';
+export declare function executeRun<TMemory, I, O>(step: StepRun<TMemory, I, O>, input: I, ctx: Context<TMemory>): Promise<O>;
+export declare function executeLLM<TMemory, I, O>(step: StepLLM<TMemory, I, O>, input: I, ctx: Context<TMemory>, layers?: MemoryLayer[]): Promise<O>;
+export interface ExecuteSpawnOpts {
+    layerStore?: LayerStateStore;
+    parentLayers?: MemoryLayer[];
+    itemSchemas?: ItemSchemaRegistry;
+}
+export declare function executeSpawn<TMemory, I, O>(step: StepSpawn<TMemory, I, O>, input: I, ctx: Context<TMemory>, executeStep: ExecuteStepFn, opts?: ExecuteSpawnOpts): Promise<O>;
+/**
+ * Executes a provide step by attaching memory layers to the current context
+ * without creating an isolated child context.
+ *
+ * Unlike spawn, provide does not create a new itemLog or clone state.
+ * Events flow through to the parent in real-time.
+ */
+export declare function executeProvide<TMemory, I, O>(step: StepProvide<TMemory, I, O>, input: I, ctx: Context<TMemory>, executeStep: ExecuteStepFn): Promise<O>;
+export declare function executeTool<TMemory, I, O>(step: StepTool<TMemory, I, O>, input: I, ctx: Context<TMemory>, harness: AgentHarnessContract, layers?: MemoryLayer[]): Promise<O>;