@noetic-tools/core 0.2.1 → 0.3.0

package/dist/types/context.d.ts

@@ -1,202 +0,0 @@
-import type { ZodType } from 'zod';
-import type { ItemSchemaRegistry } from '../schemas/item.js';
-import type { Channel, ChannelHandle, ExternalChannel } from './channel.js';
-import type { LLMResponse, ModelParams, StepMeta, TokenUsage } from './common.js';
-import type { ItemLog } from './context-parts/item-log.js';
-import type { LastLayerUsage } from './context-parts/layer-usage.js';
-import type { DetachedHandle } from './detached.js';
-import type { FsAdapter } from './fs-adapter.js';
-import type { HarnessResponse, StreamEvent, StreamingItem } from './harness-result.js';
-import type { ExecuteInput } from './items.js';
-import type { ContextMemory, MemoryLayer, StorageAdapter } from './memory.js';
-import type { Span } from './observability.js';
-import type { ShellAdapter } from './shell-adapter.js';
-import type { SteeringDecision } from './steering.js';
-import type { SubprocessAdapter } from './subprocess-adapter.js';
-import type { Tool } from './tool.js';
-/**
- * @public Mutable working-directory state shared among the tools attached to a
- * single Context. The reference is fixed for the Context's lifetime; mutate
- * via `setToolCwd` so that all tools observe the new value at execution time.
- *
- * Spawned children receive a snapshot — child mutations do not affect the parent.
- */
-export interface CwdState {
-    cwd: string;
-    previousCwd?: string;
-}
-export type ContextHarnessStatus = {
-    readonly kind: 'idle';
-} | {
-    readonly kind: 'generating';
-    readonly startedAt: number;
-    readonly turnId: string;
-} | {
-    readonly kind: 'aborting';
-    readonly turnId: string;
-};
-interface ContextCallModelRequestBase {
-    model: string;
-    items: ReadonlyArray<import('./items.js').Item>;
-    instructions?: string;
-    params?: ModelParams;
-    outputSchema?: ZodType;
-    emit?: boolean | ((eventType: string, data: Record<string, unknown>) => boolean);
-    signal?: AbortSignal;
-}
-interface ContextCallModelRequestWithTools extends ContextCallModelRequestBase {
-    tools: Tool[];
-    ctx: Context;
-    layers?: MemoryLayer[];
-    allowedToolNames?: string[];
-}
-interface ContextCallModelRequestWithoutTools extends ContextCallModelRequestBase {
-    tools?: undefined;
-    ctx?: undefined;
-    layers?: undefined;
-}
-export type ContextCallModelRequest = ContextCallModelRequestWithTools | ContextCallModelRequestWithoutTools;
-export interface ContextDetachedSpawnOverrides {
-    threadId?: string;
-    resourceId?: string;
-    cwdInit?: string;
-}
-export interface ContextRerenderRequest {
-    layerId: string;
-    slot: number;
-    timing: 'immediate' | 'batched';
-    scope: 'self' | 'slot-after' | 'all';
-}
-export interface ContextAppendPipelineResult {
-    readonly items: import('./items.js').Item[];
-    readonly rerenderRequests: ContextRerenderRequest[];
-}
-export interface ContextRecallLayerOutput {
-    layerId: string;
-    items: import('./items.js').Item[];
-    tokenCount: number;
-}
-export type ContextStep<TMemory = ContextMemory, I = unknown, O = unknown> = {
-    readonly kind: 'run';
-    readonly id: string;
-    readonly execute: (input: I, ctx: Context<TMemory>) => Promise<O>;
-} | {
-    readonly kind: 'llm';
-    readonly id: string;
-    readonly output?: ZodType<O>;
-} | {
-    readonly kind: 'loop';
-    readonly id: string;
-    readonly steps: ReadonlyArray<ContextStep<TMemory, I, O>>;
-    readonly prepareNext?: (output: O, verdict: unknown, ctx: Context<TMemory>) => I;
-} | {
-    readonly kind: string;
-    readonly id: string;
-};
-/** @public Runtime surface exposed on Context without coupling Context's definition to the runtime type module. */
-export interface ContextHarness {
-    readonly config: {
-        readonly name: string;
-        readonly params: Record<string, unknown>;
-    };
-    readonly fs: FsAdapter;
-    readonly shell: ShellAdapter;
-    readonly subprocess: SubprocessAdapter;
-    readonly rootCwdState: CwdState;
-    callModel(request: ContextCallModelRequest): Promise<LLMResponse>;
-    execute(input: ExecuteInput, options?: unknown): Promise<void>;
-    getAgentResponse(scope?: unknown): Promise<HarnessResponse>;
-    getItemStream(scope?: unknown): AsyncIterable<StreamingItem>;
-    getTextStream(scope?: unknown): AsyncIterable<string>;
-    getReasoningStream(scope?: unknown): AsyncIterable<string>;
-    getFullStream(scope?: unknown): AsyncIterable<StreamEvent>;
-    run<I, O>(step: ContextStep<ContextMemory, I, O>, input: I, ctx: Context): Promise<O>;
-    detachedSpawn<I, O>(step: unknown, input: I, parentCtx: Context, overrides?: ContextDetachedSpawnOverrides): DetachedHandle<O>;
-    createContext(opts?: {
-        parent?: Context;
-        items?: import('./items.js').Item[];
-        state?: unknown;
-        threadId?: string;
-        resourceId?: string;
-        memory?: MemoryLayer[];
-        cwdInit?: string;
-    }): Context;
-    setRootCwd(nextCwd: string): void;
-    getLayerState<T>(executionId: string, layerId: string): T | undefined;
-    setLayerState<T>(executionId: string, layerId: string, state: T): void;
-    beforeToolCall(layers: MemoryLayer[], toolName: string, toolArgs: unknown, ctx: Context): Promise<SteeringDecision>;
-    afterModelCall(layers: MemoryLayer[], response: LLMResponse, ctx: Context): Promise<SteeringDecision>;
-    runAppendPipeline(layers: MemoryLayer[], items: import('./items.js').Item[], ctx: Context): Promise<ContextAppendPipelineResult>;
-    recallLayers(layers: MemoryLayer[], input: string, ctx: Context): Promise<ContextRecallLayerOutput[]>;
-    projectHistory(layers: MemoryLayer[], items: ReadonlyArray<import('./items.js').Item>, ctx: Context): Promise<ReadonlyArray<import('./items.js').Item>>;
-    storeLayers(layers: MemoryLayer[], response: LLMResponse, ctx: Context): Promise<void>;
-    previewRequestItems(scope?: unknown): Promise<ReadonlyArray<import('./items.js').Item>>;
-    send<T>(channel: Channel<T>, value: T, ctx: Context): void;
-    recv<T>(channel: Channel<T>, ctx: Context, opts?: {
-        timeout?: number;
-    }): Promise<T>;
-    tryRecv<T>(channel: Channel<T>, ctx: Context): T | null;
-    getChannelHandle<T>(channel: ExternalChannel<T>, executionId: string): ChannelHandle<T>;
-    initLayers(layers: MemoryLayer[], ctx: Context, storage: StorageAdapter): Promise<void>;
-    disposeLayers(layers: MemoryLayer[], ctx: Context): Promise<void>;
-    checkpoint(ctx: Context): Promise<void>;
-    restore(executionId: string): Promise<Context | null>;
-    cancel(ctx: Context, reason?: string): Promise<void>;
-    createSpan(name: string, parent: Span | null): Span;
-    abort(scope?: unknown): Promise<void>;
-    getStatus(scope?: unknown): ContextHarnessStatus;
-    getQueueSize(scope?: unknown): number;
-    seedSessionHistory(threadId: string, items: ReadonlyArray<import('./items.js').Item>): void;
-    executeRerender(requests: ContextRerenderRequest[], layers: MemoryLayer[], ctx: Context, budgets: Map<string, number>, query?: string): Promise<ContextRecallLayerOutput[]>;
-}
-/** @public Execution context threaded through every step, carrying state, metrics, and channels. */
-export interface Context<TMemory = ContextMemory, TState = unknown> {
-    readonly id: string;
-    readonly stepCount: number;
-    readonly tokens: TokenUsage;
-    readonly elapsed: number;
-    readonly cost: number;
-    state: TState;
-    readonly parent: Context<ContextMemory> | null;
-    readonly depth: number;
-    readonly span: Span;
-    readonly threadId: string;
-    readonly resourceId?: string;
-    readonly itemLog: ItemLog;
-    readonly lastStepMeta: StepMeta | null;
-    /** Per-layer breakdown of the context window as of the most recent callModel. Undefined until the first LLM call completes. */
-    readonly lastLayerUsage?: LastLayerUsage;
-    readonly harness: ContextHarness;
-    /** Filesystem adapter for virtual or real filesystem access. */
-    readonly fs: FsAdapter;
-    /** Shell adapter for virtual or real shell command execution. */
-    readonly shell: ShellAdapter;
-    /** Subprocess adapter for virtual, same-process, or host process execution. */
-    readonly subprocess: SubprocessAdapter;
-    /**
-     * Mutable cwd state shared with the tools bound to this context. Tools
-     * resolve relative paths from `cwdState.cwd` at execution time so that an
-     * agent `cd` propagates to subsequent tool calls.
-     */
-    readonly cwdState: CwdState;
-    readonly layers?: MemoryLayer[];
-    /** Layer provides keyed by layer ID. Access data/functions via `ctx.memory['layerId'].prop`. */
-    readonly memory: TMemory;
-    /** Unified tool set collected from all LLM steps in the step tree before execution. */
-    readonly unifiedTools?: ReadonlyArray<Tool>;
-    /** Runtime item schema registry active for this context. */
-    readonly itemSchemas?: ItemSchemaRegistry;
-    recv<T>(channel: Channel<T>, opts?: {
-        timeout?: number;
-    }): Promise<T>;
-    send<T>(channel: Channel<T>, value: T): void;
-    tryRecv<T>(channel: Channel<T>): T | null;
-    checkpoint(): Promise<void>;
-    complete<T>(value: T): void;
-    readonly completed: boolean;
-    readonly completionValue: unknown;
-    readonly aborted: boolean;
-    readonly abortReason?: string;
-    abort(reason?: string): void;
-}
-export {};

package/dist/types/context.js

@@ -1 +0,0 @@
-export {};

package/dist/types/detached.d.ts

@@ -1,17 +0,0 @@
-/** @public Lifecycle states for a detached (background) execution. */
-declare const DetachedStatus: {
-    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. */
-interface DetachedHandle<O> {
-    readonly id: string;
-    readonly status: DetachedStatus;
-    readonly result: O | undefined;
-    readonly error: string | undefined;
-    await(timeout?: number): Promise<O>;
-}
-export type { DetachedHandle };
-export { DetachedStatus };

package/dist/types/detached.js

@@ -1,7 +0,0 @@
-/** @public Lifecycle states for a detached (background) execution. */
-const DetachedStatus = {
-    Running: 'running',
-    Completed: 'completed',
-    Failed: 'failed',
-};
-export { DetachedStatus };

package/dist/types/error.d.ts

@@ -1,66 +0,0 @@
-import type { ZodError, ZodType } from 'zod';
-/** @public Discriminated union of all structured error kinds raised by the runtime. */
-export type NoeticError = {
-    kind: 'step_failed';
-    stepId: string;
-    cause: Error;
-    retriesExhausted: boolean;
-} | {
-    kind: 'llm_refused';
-    stepId: string;
-    refusal: string;
-} | {
-    kind: 'llm_parse_error';
-    stepId: string;
-    raw: string;
-    schema: ZodType;
-    zodError: ZodError;
-} | {
-    kind: 'llm_rate_limit';
-    stepId: string;
-    retryAfter?: number;
-} | {
-    kind: 'fork_partial';
-    stepId: string;
-    succeeded: Array<{
-        stepId: string;
-        value: unknown;
-    }>;
-    failed: Array<{
-        stepId: string;
-        error: NoeticError;
-    }>;
-} | {
-    kind: 'channel_timeout';
-    channelName: string;
-    timeout: number;
-} | {
-    kind: 'channel_closed';
-    channelName: string;
-} | {
-    kind: 'cancelled';
-    reason?: string;
-} | {
-    kind: 'budget_exceeded';
-    field: 'cost' | 'steps' | 'duration';
-    limit: number;
-    actual: number;
-} | {
-    kind: 'steering_denied';
-    guidance?: string;
-} | {
-    /**
-     * Raised by `DetachedHandle.await()` when the adapter persistently
-     * returns `null` for a handle that was previously spawned — the
-     * handle has been evicted from the adapter's registry, either by
-     * a restart-after-stop-without-restore flow or by a storage
-     * inconsistency. This guards against an otherwise-infinite poll
-     * loop that would hold the promise open forever. A short grace
-     * period tolerates transient nulls (e.g. the in-memory adapter
-     * briefly returning null between spawn and first microtask yield).
-     */
-    kind: 'handle_evicted';
-    handleId: string;
-    stepId: string;
-    gracePeriodMs: number;
-};

package/dist/types/error.js

@@ -1 +0,0 @@
-export {};

package/dist/types/fs-adapter.d.ts

@@ -1,51 +0,0 @@
-/** @public Minimal stat result returned by the filesystem adapter. */
-export interface FsStats {
-    size: number;
-    isDirectory(): boolean;
-    isSymbolicLink(): boolean;
-    isFile(): boolean;
-}
-/** @public Filesystem abstraction for agent runtime operations. */
-export interface FsAdapter {
-    /** Read file contents as a Buffer. */
-    readFile(path: string): Promise<Buffer>;
-    /** Read file contents as a UTF-8 string. */
-    readFileText(path: string): Promise<string>;
-    /** Write string content to a file (UTF-8). */
-    writeFile(path: string, content: string): Promise<void>;
-    /**
-     * Write raw bytes to a file. Use this when content may not be valid
-     * UTF-8 (binary attachments, images, etc.). Round-tripping through
-     * `writeFile` corrupts non-UTF-8 sequences.
-     */
-    writeFileBytes(path: string, content: Buffer): Promise<void>;
-    /**
-     * Append string content to a file (UTF-8). Creates the file if it does
-     * not exist. On POSIX, the underlying write uses `O_APPEND`, which is
-     * atomic for sub-`PIPE_BUF` writes — multiple concurrent writers can
-     * append without interleaving as long as each call's payload stays
-     * under that ceiling (4 KiB on Linux/macOS).
-     */
-    appendFile(path: string, content: string): Promise<void>;
-    /** Create directories recursively. */
-    mkdir(dir: string): Promise<void>;
-    /**
-     * Atomically rename a file or directory. On POSIX, this is the atomic
-     * swap used by write-temp + rename to publish a new file version
-     * without exposing readers to a half-written state.
-     */
-    rename(oldPath: string, newPath: string): Promise<void>;
-    /** Remove a file or directory. With `recursive: true`, removes a directory tree. */
-    rm(path: string, options?: {
-        recursive?: boolean;
-        force?: boolean;
-    }): Promise<void>;
-    /** Check file accessibility (throws on failure). */
-    access(path: string, mode?: number): Promise<void>;
-    /** Get file/directory stats (follows symlinks). */
-    stat(path: string): Promise<FsStats>;
-    /** Get file/directory stats (does NOT follow symlinks). */
-    lstat(path: string): Promise<FsStats>;
-    /** Read directory entries (file names). */
-    readdir(path: string): Promise<string[]>;
-}

package/dist/types/fs-adapter.js

@@ -1,3 +0,0 @@
-//#region Types
-export {};
-//#endregion

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

@@ -1,43 +0,0 @@
-import type { LastLayerUsage } from './context-parts/layer-usage.js';
-import type { Item } from './items.js';
-/** @public SDK-originated event from the OpenResponses streaming API. */
-export interface SdkStreamEvent {
-    readonly source: 'sdk';
-    /** OpenResponses SSE event type string (e.g., 'response.output_text.delta'). */
-    readonly type: string;
-    readonly data: Record<string, unknown>;
-    readonly outputIndex?: number;
-    readonly contentIndex?: number;
-}
-/** @public Framework-originated event, prefixed with the harness config.name. */
-export interface FrameworkStreamEvent {
-    readonly source: 'framework';
-    /** Prefixed event type (e.g., 'myagent:step_started'). */
-    readonly type: `${string}:${string}`;
-    readonly data: Record<string, unknown>;
-}
-/** @public Union of all stream event types emitted during execution. */
-export type StreamEvent = SdkStreamEvent | FrameworkStreamEvent;
-/** @public Final accumulated result of an execution, including all items, usage, cost, and extracted text.
- *
- *  Returned from `AgentHarness.getAgentResponse()`. Resolves once the session's
- *  message queue drains and the runner goes idle. When multiple turns run in a
- *  burst (e.g. queued inbox messages), the response covers the span from the
- *  last-idle point through the point at which idle is reached again.
- */
-export interface HarnessResponse {
-    readonly items: ReadonlyArray<Item>;
-    readonly usage: {
-        readonly inputTokens: number;
-        readonly outputTokens: number;
-        readonly cachedTokens?: number;
-    };
-    readonly cost?: number;
-    readonly text: string;
-    /** Per-memory-layer context window breakdown captured at the last callModel of this execution. */
-    readonly lastLayerUsage?: LastLayerUsage;
-}
-/** @public An Item snapshot with a completion flag, emitted from getItemStream(). */
-export type StreamingItem = Item & {
-    readonly isComplete: boolean;
-};

package/dist/types/harness-result.js

@@ -1,2 +0,0 @@
-export {};
-//#endregion

package/dist/types/items.d.ts

@@ -1,131 +0,0 @@
-import type * as OpenRouterAgent from '@openrouter/agent';
-import type { ZodTypeAny, z } from 'zod';
-type ResponseOutputText = OpenRouterAgent.ResponseOutputText;
-type ResponsesImageGenerationCall = OpenRouterAgent.OutputImageGenerationCallItem;
-type ResponsesOutputItemFileSearchCall = OpenRouterAgent.OutputFileSearchCallItem;
-type ResponsesOutputItemFunctionCall = OpenRouterAgent.OutputFunctionCallItem;
-type ResponsesOutputItemReasoning = OpenRouterAgent.OutputReasoningItem;
-type ResponsesOutputMessage = OpenRouterAgent.OutputMessage;
-type ResponsesWebSearchCallOutput = OpenRouterAgent.OutputWebSearchCallItem;
-type ResponsesServerToolOutput = Exclude<OpenRouterAgent.OpenResponsesResult['output'][number], OpenRouterAgent.OutputMessage | OpenRouterAgent.OutputFunctionCallItem | OpenRouterAgent.OutputReasoningItem | OpenRouterAgent.OutputWebSearchCallItem | OpenRouterAgent.OutputFileSearchCallItem | OpenRouterAgent.OutputImageGenerationCallItem>;
-type OutputMessageContentPart = OpenRouterAgent.OutputMessage['content'][number];
-type OpenAIResponsesRefusalContent = Extract<OutputMessageContentPart, {
-    type: 'refusal';
-}>;
-type ReasoningContentPart = NonNullable<OpenRouterAgent.OutputReasoningItem['content']>[number];
-type SummaryContentPart = NonNullable<OpenRouterAgent.OutputReasoningItem['summary']>[number];
-type ReasoningTextContent = Extract<ReasoningContentPart, {
-    type: 'reasoning_text';
-}>;
-type ReasoningSummaryText = Extract<SummaryContentPart, {
-    type: 'summary_text';
-}>;
-/** @public Model-generated text content with optional annotations and logprobs. */
-export type OutputTextPart = ResponseOutputText;
-/** @public Model refusal content. */
-export type RefusalPart = OpenAIResponsesRefusalContent;
-/** @public User/developer input text (framework-created, not from SDK). */
-export interface InputTextPart {
-    readonly type: 'input_text';
-    readonly text: string;
-}
-/** @public User image input content. */
-export interface InputImagePart {
-    readonly type: 'input_image';
-    readonly imageUrl: string;
-    readonly detail?: 'auto' | 'low' | 'high';
-}
-/** @public User file input content. */
-export interface InputFilePart {
-    readonly type: 'input_file';
-    readonly fileData?: string;
-    readonly fileId?: string | null;
-    readonly fileUrl?: string;
-    readonly filename?: string;
-}
-/** @public Reasoning trace content. */
-export type ReasoningTextPart = ReasoningTextContent;
-/** @public Reasoning summary content. */
-export type SummaryTextPart = ReasoningSummaryText;
-/** @public User/developer input content variants. */
-export type InputContentPart = InputTextPart | InputImagePart | InputFilePart;
-/** @public Content part variants for message items. */
-export type ContentPart = OutputTextPart | RefusalPart | InputContentPart;
-/** @public Assistant message output item. */
-export type MessageItem = ResponsesOutputMessage;
-/** @public Function call requested by the model. */
-export type FunctionCallItem = ResponsesOutputItemFunctionCall;
-/** @public Reasoning trace from the model. */
-export type ReasoningItem = ResponsesOutputItemReasoning;
-/** @public Web search call result. */
-export type WebSearchItem = ResponsesWebSearchCallOutput;
-/** @public File search call result. */
-export type FileSearchItem = ResponsesOutputItemFileSearchCall;
-/** @public Image generation call result. */
-export type ImageGenerationItem = ResponsesImageGenerationCall;
-/**
- * @public Server tool output (vendor-prefixed type like `openrouter:datetime`).
- * Constrains provider output items to the vendor-prefixed subset so discriminant narrowing works in Item unions.
- */
-export type ServerToolItem = Omit<ResponsesServerToolOutput, 'type'> & {
-    readonly type: `${string}:${string}`;
-};
-/** @public Base shape required for framework and extension items. */
-export interface ItemBase {
-    readonly type: string;
-}
-/**
- * @public Input message created by the framework (user, system, or developer role).
- * Status includes `failed` as a Noetic extension beyond the Open Responses spec
- * (which only defines `in_progress | completed | incomplete` for items).
- */
-export interface InputMessageItem {
-    readonly id: string;
-    readonly type: 'message';
-    readonly role: 'user' | 'system' | 'developer';
-    readonly status: 'in_progress' | 'completed' | 'incomplete' | 'failed';
-    readonly content: InputContentPart[];
-}
-/**
- * @public Tool execution output created by the harness during the tool loop.
- * This is an input-only item type in Open Responses (sent by the developer, not the model).
- */
-export interface FunctionCallOutputItem {
-    readonly id: string;
-    readonly type: 'function_call_output';
-    readonly status: 'in_progress' | 'completed' | 'incomplete' | 'failed';
-    readonly callId: string;
-    readonly output: string;
-}
-/** @public Item produced by an extension schema registered by a tool, memory layer, or harness. */
-export type ExtensionItem = ItemBase & Record<string, unknown>;
-/** @public Developer-role message item refined by a memory-layer extension schema. */
-export type DeveloperMessageExtensionItem = InputMessageItem & {
-    readonly role: 'developer';
-} & Record<string, unknown>;
-/** @public Function-call item refined by a tool extension schema. */
-export type ToolCallExtensionItem = FunctionCallItem & Record<string, unknown>;
-/** @public Function-call output item refined by a tool extension schema. */
-export type ToolResultExtensionItem = FunctionCallOutputItem & Record<string, unknown>;
-/** @public Zod schemas that extend the runtime `Item` union. */
-export interface ItemSchemaExtensions {
-    /** Harness-wide schemas. Any item matching one of these schemas is accepted. */
-    readonly items?: ReadonlyArray<ZodTypeAny>;
-    /** Schemas for memory-layer developer message items. */
-    readonly developerMessages?: ReadonlyArray<ZodTypeAny>;
-    /** Schemas for tool call items emitted by the model or a harness adapter. */
-    readonly toolCalls?: ReadonlyArray<ZodTypeAny>;
-    /** Schemas for tool result items emitted by the harness or a tool adapter. */
-    readonly toolResults?: ReadonlyArray<ZodTypeAny>;
-}
-/** @public Type inferred from an `ItemSchemaExtensions` declaration. */
-export type InferExtendedItem<TExtensions extends ItemSchemaExtensions | undefined> = TExtensions extends ItemSchemaExtensions ? (TExtensions['items'] extends ReadonlyArray<infer S extends ZodTypeAny> ? z.infer<S> : never) | (TExtensions['developerMessages'] extends ReadonlyArray<infer S extends ZodTypeAny> ? z.infer<S> : never) | (TExtensions['toolCalls'] extends ReadonlyArray<infer S extends ZodTypeAny> ? z.infer<S> : never) | (TExtensions['toolResults'] extends ReadonlyArray<infer S extends ZodTypeAny> ? z.infer<S> : never) : never;
-/** @public Item union extended by a concrete `ItemSchemaExtensions` declaration. */
-export type ExtendedItem<TExtensions extends ItemSchemaExtensions | undefined> = Item | InferExtendedItem<TExtensions>;
-/** @public All output item types from the model (Open Responses compliant). */
-export type OutputItem = MessageItem | FunctionCallItem | ReasoningItem | WebSearchItem | FileSearchItem | ImageGenerationItem | ServerToolItem;
-/** @public All item types that can appear in an ItemLog. */
-export type Item = OutputItem | InputMessageItem | FunctionCallOutputItem;
-/** @public Accepted input types for `AgentHarness.execute()`: a plain string, a single Item, or an array of Items. */
-export type ExecuteInput = string | Item | Item[];
-export {};

package/dist/types/items.js

@@ -1,2 +0,0 @@
-export {};
-//#endregion

package/dist/types/memory-context.d.ts

@@ -1,39 +0,0 @@
-import type { LLMResponse } from './common.js';
-import type { FsAdapter } from './fs-adapter.js';
-import type { Item } from './items.js';
-import type { ShellAdapter } from './shell-adapter.js';
-/** @public Isolation scope controlling how a memory layer's state is keyed and shared. */
-export type MemoryScope = 'thread' | 'resource' | 'global' | 'execution';
-/** @public Terminal outcome of an execution run, reported to memory layers on completion. */
-export type ExecutionOutcome = 'success' | 'failure' | 'aborted';
-/** @public Minimal model-call surface exposed to memory-layer hooks. */
-export interface MemoryCallModelRequest {
-    model: string;
-    items: ReadonlyArray<Item>;
-    instructions?: string;
-}
-/** @public Runtime metadata available to memory layer hooks during each lifecycle phase. */
-export interface ExecutionContext {
-    executionId: string;
-    threadId: string;
-    resourceId?: string;
-    depth: number;
-    stepNumber: number;
-    tokenUsage: {
-        input: number;
-        output: number;
-    };
-    cost: number;
-    /** Filesystem adapter for virtual or real filesystem access. */
-    fs: FsAdapter;
-    /** Shell adapter for virtual or real shell command execution. */
-    shell: ShellAdapter;
-    callModel?: (request: MemoryCallModelRequest) => Promise<LLMResponse>;
-    tokenize(text: string): number;
-    trace: {
-        setAttribute(key: string, value: string | number | boolean): void;
-        addEvent(name: string, attributes?: Record<string, string | number | boolean>): void;
-    };
-    /** Snapshot a sibling memory layer's state by its `layer.id`. */
-    readLayerState<T>(layerId: string): T | undefined;
-}

package/dist/types/memory-context.js

@@ -1 +0,0 @@
-export {};