@nextclaw/ncp-agent-runtime 0.3.7 → 0.3.9

package/dist/index.d.ts

@@ -1,164 +1,175 @@
-import { NcpContextBuilder, NcpToolRegistry, NcpAgentRunInput, NcpContextPrepareOptions, NcpLLMApiInput, NcpMessagePart, OpenAIContentPart, NcpRoundBuffer, NcpToolCallResult, NcpStreamEncoder, NcpAssistantReasoningNormalizationMode, OpenAIChatChunk, NcpEncodeContext, NcpEndpointEvent, NcpTool, NcpToolDefinition, NcpLLMApi, NcpLLMApiOptions, NcpAgentRuntime, NcpAgentConversationStateManager, NcpAgentRunOptions } from '@nextclaw/ncp';
+import { NcpAgentConversationStateManager, NcpAgentRunInput, NcpAgentRunOptions, NcpAgentRuntime, NcpAssistantReasoningNormalizationMode, NcpContextBuilder, NcpContextPrepareOptions, NcpEncodeContext, NcpEndpointEvent, NcpLLMApi, NcpLLMApiInput, NcpLLMApiOptions, NcpMessagePart, NcpRoundBuffer, NcpStreamEncoder, NcpTool, NcpToolCallResult, NcpToolDefinition, NcpToolRegistry, OpenAIChatChunk, OpenAIContentPart } from "@nextclaw/ncp";
 
+//#region src/asset-store.d.ts
 type StoredAssetRecord = {
-    id: string;
-    uri: string;
-    storageKey: string;
-    fileName: string;
-    storedName: string;
-    mimeType: string;
-    sizeBytes: number;
-    createdAt: string;
-    sha256: string;
+  id: string;
+  uri: string;
+  storageKey: string;
+  fileName: string;
+  storedName: string;
+  mimeType: string;
+  sizeBytes: number;
+  createdAt: string;
+  sha256: string;
 };
 type AssetRef = {
-    uri: string;
+  uri: string;
 };
 type AssetMeta = {
-    uri: string;
-    fileName: string;
-    mimeType: string;
-    sizeBytes: number;
-    createdAt: string;
+  uri: string;
+  fileName: string;
+  mimeType: string;
+  sizeBytes: number;
+  createdAt: string;
 };
 type AssetPutInput = {
-    kind: "path";
-    path: string;
-    fileName?: string;
-    mimeType?: string | null;
-    createdAt?: Date;
+  kind: "path";
+  path: string;
+  fileName?: string;
+  mimeType?: string | null;
+  createdAt?: Date;
 } | {
-    kind: "bytes";
-    bytes: Uint8Array;
-    fileName: string;
-    mimeType?: string | null;
-    createdAt?: Date;
+  kind: "bytes";
+  bytes: Uint8Array;
+  fileName: string;
+  mimeType?: string | null;
+  createdAt?: Date;
 };
 declare function isTextLikeAsset(params: {
-    mimeType?: string | null;
-    fileName?: string | null;
+  mimeType?: string | null;
+  fileName?: string | null;
 }): boolean;
 declare class LocalAssetStore {
-    readonly rootDir: string;
-    constructor(options: {
-        rootDir: string;
-    });
-    put(input: AssetPutInput): Promise<AssetRef>;
-    putBytes(params: {
-        fileName: string;
-        mimeType?: string | null;
-        bytes: Uint8Array;
-        createdAt?: Date;
-    }): Promise<StoredAssetRecord>;
-    putPath(params: {
-        path: string;
-        fileName?: string;
-        mimeType?: string | null;
-        createdAt?: Date;
-    }): Promise<StoredAssetRecord>;
-    export(ref: AssetRef, targetPath: string): Promise<string>;
-    stat(ref: AssetRef): Promise<AssetMeta | null>;
-    getByUri(uri: string): StoredAssetRecord | null;
-    statRecord(uri: string): Promise<StoredAssetRecord | null>;
-    readAssetBytes(uri: string): Promise<Buffer | null>;
-    resolveContentPath(uri: string): string | null;
-    private putFromPath;
-    private putFromBytes;
-    private buildRecord;
-    private writeMeta;
-    private resolveContentPathOrThrow;
-    private resolveStorageKeyDirectory;
+  readonly rootDir: string;
+  constructor(options: {
+    rootDir: string;
+  });
+  put(input: AssetPutInput): Promise<AssetRef>;
+  putBytes(params: {
+    fileName: string;
+    mimeType?: string | null;
+    bytes: Uint8Array;
+    createdAt?: Date;
+  }): Promise<StoredAssetRecord>;
+  putPath(params: {
+    path: string;
+    fileName?: string;
+    mimeType?: string | null;
+    createdAt?: Date;
+  }): Promise<StoredAssetRecord>;
+  export(ref: AssetRef, targetPath: string): Promise<string>;
+  stat(ref: AssetRef): Promise<AssetMeta | null>;
+  getByUri(uri: string): StoredAssetRecord | null;
+  statRecord(uri: string): Promise<StoredAssetRecord | null>;
+  readAssetBytes(uri: string): Promise<Buffer | null>;
+  resolveContentPath(uri: string): string | null;
+  private putFromPath;
+  private putFromBytes;
+  private buildRecord;
+  private writeMeta;
+  private resolveContentPathOrThrow;
+  private resolveStorageKeyDirectory;
 }
 declare function buildAssetContentPath(params: {
-    basePath: string;
-    assetUri: string;
+  basePath: string;
+  assetUri: string;
 }): string;
-
+//#endregion
+//#region src/context-builder.d.ts
 type DefaultNcpContextBuilderOptions = {
-    toolRegistry?: NcpToolRegistry;
-    assetStore?: LocalAssetStore | null;
+  toolRegistry?: NcpToolRegistry;
+  assetStore?: LocalAssetStore | null;
 };
 declare class DefaultNcpContextBuilder implements NcpContextBuilder {
-    private readonly toolRegistry?;
-    private readonly assetStore?;
-    constructor(toolRegistry?: NcpToolRegistry);
-    constructor(options?: DefaultNcpContextBuilderOptions);
-    prepare: (input: NcpAgentRunInput, options?: NcpContextPrepareOptions) => NcpLLMApiInput;
+  private readonly toolRegistry?;
+  private readonly assetStore?;
+  constructor(toolRegistry?: NcpToolRegistry);
+  constructor(options?: DefaultNcpContextBuilderOptions);
+  prepare: (input: NcpAgentRunInput, options?: NcpContextPrepareOptions) => NcpLLMApiInput;
 }
-
+//#endregion
+//#region src/user-content.d.ts
 declare function buildNcpUserContent(parts: NcpMessagePart[], options?: {
-    assetStore?: LocalAssetStore | null;
+  assetStore?: LocalAssetStore | null;
 }): string | OpenAIContentPart[];
-
+//#endregion
+//#region src/round-buffer.d.ts
 declare class DefaultNcpRoundBuffer implements NcpRoundBuffer {
-    private text;
-    private readonly toolCalls;
-    private pending;
-    appendText: (delta: string) => void;
-    getText: () => string;
-    appendToolCall: (result: NcpToolCallResult) => void;
-    getToolCalls: () => ReadonlyArray<NcpToolCallResult>;
-    startToolCall: (toolCallId: string, toolName: string) => void;
-    appendToolCallArgs: (args: unknown) => void;
-    consumePendingToolCall: () => {
-        toolCallId: string;
-        toolName: string;
-        args: unknown;
-    } | null;
-    clear: () => void;
+  private text;
+  private readonly toolCalls;
+  private pending;
+  appendText: (delta: string) => void;
+  getText: () => string;
+  appendToolCall: (result: NcpToolCallResult) => void;
+  getToolCalls: () => ReadonlyArray<NcpToolCallResult>;
+  startToolCall: (toolCallId: string, toolName: string) => void;
+  appendToolCallArgs: (args: unknown) => void;
+  consumePendingToolCall: () => {
+    toolCallId: string;
+    toolName: string;
+    args: unknown;
+  } | null;
+  clear: () => void;
 }
-
+//#endregion
+//#region src/stream-encoder.d.ts
 type DefaultNcpStreamEncoderConfig = {
-    reasoningNormalizationMode?: NcpAssistantReasoningNormalizationMode;
+  reasoningNormalizationMode?: NcpAssistantReasoningNormalizationMode;
 };
 /**
  * Converts LLM stream chunks to NCP events (text, reasoning, tool calls).
  * Does not emit RunFinished; that is the runtime's responsibility after the loop completes.
  */
 declare class DefaultNcpStreamEncoder implements NcpStreamEncoder {
-    private readonly reasoningNormalizationMode;
-    constructor(config?: DefaultNcpStreamEncoderConfig);
-    encode(stream: AsyncIterable<OpenAIChatChunk>, context: NcpEncodeContext): AsyncGenerator<NcpEndpointEvent>;
+  private readonly reasoningNormalizationMode;
+  constructor(config?: DefaultNcpStreamEncoderConfig);
+  encode(stream: AsyncIterable<OpenAIChatChunk>, context: NcpEncodeContext): AsyncGenerator<NcpEndpointEvent>;
 }
-
+//#endregion
+//#region src/tool-registry.d.ts
 declare class DefaultNcpToolRegistry implements NcpToolRegistry {
-    private readonly tools;
-    constructor(tools?: ReadonlyArray<NcpTool>);
-    register: (tool: NcpTool) => void;
-    listTools: () => ReadonlyArray<NcpTool>;
-    getTool: (name: string) => NcpTool | undefined;
-    getToolDefinitions: () => ReadonlyArray<NcpToolDefinition>;
-    execute: (_toolCallId: string, toolName: string, args: unknown) => Promise<unknown>;
+  private readonly tools;
+  constructor(tools?: ReadonlyArray<NcpTool>);
+  register: (tool: NcpTool) => void;
+  listTools: () => ReadonlyArray<NcpTool>;
+  getTool: (name: string) => NcpTool | undefined;
+  getToolDefinitions: () => ReadonlyArray<NcpToolDefinition>;
+  execute: (_toolCallId: string, toolName: string, args: unknown) => Promise<unknown>;
 }
-
+//#endregion
+//#region src/llm-api-echo.d.ts
 declare class EchoNcpLLMApi implements NcpLLMApi {
-    generate: (input: NcpLLMApiInput, options?: NcpLLMApiOptions) => AsyncGenerator<OpenAIChatChunk>;
+  generate: (input: NcpLLMApiInput, options?: NcpLLMApiOptions) => AsyncGenerator<OpenAIChatChunk>;
 }
-
+//#endregion
+//#region src/runtime.d.ts
 type DefaultNcpAgentRuntimeConfig = {
-    contextBuilder: NcpContextBuilder;
-    llmApi: NcpLLMApi;
-    toolRegistry: NcpToolRegistry;
-    stateManager: NcpAgentConversationStateManager;
-    streamEncoder?: NcpStreamEncoder;
-    reasoningNormalizationMode?: NcpAssistantReasoningNormalizationMode;
+  contextBuilder: NcpContextBuilder;
+  llmApi: NcpLLMApi;
+  toolRegistry: NcpToolRegistry;
+  stateManager: NcpAgentConversationStateManager;
+  streamEncoder?: NcpStreamEncoder;
+  reasoningNormalizationMode?: NcpAssistantReasoningNormalizationMode;
 };
 declare class DefaultNcpAgentRuntime implements NcpAgentRuntime {
-    private readonly contextBuilder;
-    private readonly llmApi;
-    private readonly toolRegistry;
-    private readonly stateManager;
-    private readonly streamEncoder;
-    private readonly reasoningNormalizationMode;
-    constructor(config: DefaultNcpAgentRuntimeConfig);
-    run: (this: DefaultNcpAgentRuntime, input: NcpAgentRunInput, options?: NcpAgentRunOptions) => AsyncGenerator<NcpEndpointEvent>;
-    /**
-     * Agent loop: LLM stream → encoder events → tool execution (if any) → next round or finish.
-     * RunFinished is emitted only when the entire loop completes (no more tool calls).
-     * The stream encoder does not emit RunFinished; it only converts chunks to NCP events.
-     */
-    private runLoop;
-    private tapStream;
+  private readonly contextBuilder;
+  private readonly llmApi;
+  private readonly toolRegistry;
+  private readonly stateManager;
+  private readonly streamEncoder;
+  private readonly reasoningNormalizationMode;
+  constructor(config: DefaultNcpAgentRuntimeConfig);
+  run: (this: DefaultNcpAgentRuntime, input: NcpAgentRunInput, options?: NcpAgentRunOptions) => AsyncGenerator<NcpEndpointEvent>;
+  /**
+   * Agent loop: LLM stream → encoder events → tool execution (if any) → next round or finish.
+   * RunFinished is emitted only when the entire loop completes (no more tool calls).
+   * The stream encoder does not emit RunFinished; it only converts chunks to NCP events.
+   */
+  private runLoop;
+  private executeToolCall;
+  private resolveValidationIssues;
+  private executeValidatedToolCall;
+  private tapStream;
 }
-
-export { type AssetMeta, type AssetPutInput, type AssetRef, DefaultNcpAgentRuntime, type DefaultNcpAgentRuntimeConfig, DefaultNcpContextBuilder, DefaultNcpRoundBuffer, DefaultNcpStreamEncoder, DefaultNcpToolRegistry, EchoNcpLLMApi, LocalAssetStore, type StoredAssetRecord, buildAssetContentPath, buildNcpUserContent, isTextLikeAsset };
+//#endregion
+export { type AssetMeta, type AssetPutInput, type AssetRef, DefaultNcpAgentRuntime, type DefaultNcpAgentRuntimeConfig, DefaultNcpContextBuilder, DefaultNcpRoundBuffer, DefaultNcpStreamEncoder, DefaultNcpToolRegistry, EchoNcpLLMApi, LocalAssetStore, type StoredAssetRecord, buildAssetContentPath, buildNcpUserContent, isTextLikeAsset };