@nextclaw/ncp 0.5.1 → 0.5.3

package/dist/index.d.ts

@@ -69,12 +69,13 @@ type NcpReasoningPart = {
  * - `"call"`         — The model has emitted a complete tool call; `args` is populated.
  * - `"partial-call"` — Arguments are still being streamed; `args` may be incomplete.
  * - `"result"`       — The tool has returned; `result` is populated.
+ * - `"cancelled"`    — The tool was interrupted before a result was delivered.
  */
 type NcpToolInvocationPart = {
   type: "tool-invocation";
   toolName: string;
   toolCallId?: string;
-  state?: "call" | "partial-call" | "result"; /** Tool input arguments. May be partial when `state === "partial-call"`. */
+  state?: "call" | "partial-call" | "result" | "cancelled"; /** Tool input arguments. May be partial when `state === "partial-call"`. */
   args?: unknown; /** Tool output. Populated when `state === "result"`. */
   result?: unknown;
 };
@@ -230,6 +231,91 @@ interface NcpSessionApi {
   deleteSession(sessionId: string): Promise<void>;
 }
 //#endregion
+//#region src/agent-runtime/llm-api.d.ts
+type OpenAIContentPart = {
+  type: "text";
+  text: string;
+} | {
+  type: "image_url";
+  image_url: {
+    url: string;
+    detail?: "low" | "high" | "auto";
+  };
+};
+type OpenAIToolCall = {
+  id: string;
+  type: "function";
+  function: {
+    name: string;
+    arguments: string;
+  };
+};
+type OpenAIChatMessage = {
+  role: "system";
+  content: string;
+} | {
+  role: "user";
+  content: string | OpenAIContentPart[];
+} | {
+  role: "assistant";
+  content?: string | null;
+  reasoning_content?: string;
+  tool_calls?: OpenAIToolCall[];
+} | {
+  role: "tool";
+  content: string;
+  tool_call_id: string;
+};
+type OpenAITool = {
+  type: "function";
+  function: {
+    name: string;
+    description?: string;
+    parameters?: Record<string, unknown>;
+  };
+};
+type OpenAIToolCallDelta = {
+  index?: number;
+  id?: string;
+  type?: "function";
+  function?: {
+    name?: string;
+    arguments?: string;
+  };
+};
+type OpenAIChatChunk = {
+  id?: string;
+  choices?: Array<{
+    index?: number;
+    delta?: {
+      content?: string | null;
+      tool_calls?: OpenAIToolCallDelta[];
+      reasoning_content?: string;
+      reasoning?: string;
+    };
+    finish_reason?: string | null;
+  }>;
+  usage?: {
+    prompt_tokens?: number;
+    completion_tokens?: number;
+    total_tokens?: number;
+  };
+};
+type NcpLLMApiInput = {
+  messages: OpenAIChatMessage[];
+  tools?: OpenAITool[];
+  model?: string;
+  thinkingLevel?: string | null;
+  max_tokens?: number;
+};
+type NcpLLMApiOptions = {
+  signal?: AbortSignal;
+  temperature?: number;
+};
+interface NcpLLMApi {
+  generate(input: NcpLLMApiInput, options?: NcpLLMApiOptions): AsyncIterable<OpenAIChatChunk>;
+}
+//#endregion
 //#region src/types/events.d.ts
 /**
  * NCP event and payload definitions.
@@ -243,6 +329,14 @@ type NcpRequestEnvelope = {
   message: NcpMessage;
   correlationId?: string;
   metadata?: Record<string, unknown>;
+  providerRoute?: NcpProviderRuntimeRoute;
+  tools?: ReadonlyArray<OpenAITool>;
+};
+type NcpProviderRuntimeRoute = {
+  model: string;
+  apiKey?: string | null;
+  apiBase?: string | null;
+  headers: Record<string, string>;
 };
 /** Payload for message.incoming: message content from the other peer (partial or full). */
 type NcpResponseEnvelope = {
@@ -667,91 +761,6 @@ interface NcpAgentRuntime {
   run(input: NcpAgentRunInput, options?: NcpAgentRunOptions): AsyncIterable<NcpEndpointEvent>;
 }
 //#endregion
-//#region src/agent-runtime/llm-api.d.ts
-type OpenAIContentPart = {
-  type: "text";
-  text: string;
-} | {
-  type: "image_url";
-  image_url: {
-    url: string;
-    detail?: "low" | "high" | "auto";
-  };
-};
-type OpenAIToolCall = {
-  id: string;
-  type: "function";
-  function: {
-    name: string;
-    arguments: string;
-  };
-};
-type OpenAIChatMessage = {
-  role: "system";
-  content: string;
-} | {
-  role: "user";
-  content: string | OpenAIContentPart[];
-} | {
-  role: "assistant";
-  content?: string | null;
-  reasoning_content?: string;
-  tool_calls?: OpenAIToolCall[];
-} | {
-  role: "tool";
-  content: string;
-  tool_call_id: string;
-};
-type OpenAITool = {
-  type: "function";
-  function: {
-    name: string;
-    description?: string;
-    parameters?: Record<string, unknown>;
-  };
-};
-type OpenAIToolCallDelta = {
-  index?: number;
-  id?: string;
-  type?: "function";
-  function?: {
-    name?: string;
-    arguments?: string;
-  };
-};
-type OpenAIChatChunk = {
-  id?: string;
-  choices?: Array<{
-    index?: number;
-    delta?: {
-      content?: string | null;
-      tool_calls?: OpenAIToolCallDelta[];
-      reasoning_content?: string;
-      reasoning?: string;
-    };
-    finish_reason?: string | null;
-  }>;
-  usage?: {
-    prompt_tokens?: number;
-    completion_tokens?: number;
-    total_tokens?: number;
-  };
-};
-type NcpLLMApiInput = {
-  messages: OpenAIChatMessage[];
-  tools?: OpenAITool[];
-  model?: string;
-  thinkingLevel?: string | null;
-  max_tokens?: number;
-};
-type NcpLLMApiOptions = {
-  signal?: AbortSignal;
-  temperature?: number;
-};
-interface NcpLLMApi {
-  generate(input: NcpLLMApiInput, options?: NcpLLMApiOptions): AsyncIterable<OpenAIChatChunk>;
-}
-//#endregion
 //#region src/agent-runtime/context-builder.d.ts
 type NcpContextPrepareOptions = {
   sessionMessages?: ReadonlyArray<NcpMessage>;
@@ -968,4 +977,4 @@ declare function normalizeAssistantText(text: string, mode: NcpAssistantReasonin
   parts: NcpAssistantReasoningSegment[];
 };
 //#endregion
-export { ListMessagesOptions, ListSessionsOptions, NCP_INTERNAL_VISIBILITY_METADATA_KEY, NcpActionPart, NcpAgentClientEndpoint, NcpAgentConversationHydrationParams, NcpAgentConversationSnapshot, NcpAgentConversationStateManager, NcpAgentRunApi, NcpAgentRunInput, NcpAgentRunOptions, NcpAgentRunSendOptions, NcpAgentRunStreamOptions, NcpAgentRuntime, NcpAgentServerEndpoint, NcpAgentStreamProvider, NcpAssistantReasoningNormalizationMode, NcpAssistantReasoningSegment, NcpAssistantTextStreamNormalizer, NcpCardPart, NcpCompletedEnvelope, NcpContextBuilder, NcpContextPrepareOptions, NcpConversationSnapshot, NcpConversationStateManager, NcpEncodeContext, NcpEndpoint, NcpEndpointEvent, NcpEndpointKind, NcpEndpointLatency, NcpEndpointManifest, NcpEndpointSubscriber, NcpError, NcpErrorCode, NcpEventType, NcpExtensionPart, NcpFailedEnvelope, NcpFilePart, NcpInvalidToolArgumentsResult, NcpLLMApi, NcpLLMApiInput, NcpLLMApiOptions, NcpMessage, NcpMessageAbortPayload, NcpMessageAcceptedPayload, NcpMessageDeliveredPayload, NcpMessagePart, NcpMessageReactionPayload, NcpMessageReadPayload, NcpMessageRecalledPayload, NcpMessageRole, NcpMessageSentPayload, NcpMessageStatus, NcpPendingToolCall, NcpPresenceUpdatedPayload, NcpReasoningDeltaPayload, NcpReasoningEndPayload, NcpReasoningPart, NcpReasoningStartPayload, NcpReplyTagParseResult, NcpRequestEnvelope, NcpResponseEnvelope, NcpRichTextPart, NcpRoundBuffer, NcpRunContext, NcpRunErrorPayload, NcpRunFinalMetadata, NcpRunFinishedPayload, NcpRunMetadataPayload, NcpRunReadyMetadata, NcpRunStartedPayload, NcpSessionApi, NcpSessionPatch, NcpSessionStatus, NcpSessionSummary, NcpSourcePart, NcpStepStartPart, NcpStreamEncoder, NcpStreamRequestPayload, NcpTextDeltaPayload, NcpTextEndPayload, NcpTextPart, NcpTextStartPayload, NcpTool, NcpToolCallArgsDeltaPayload, NcpToolCallArgsPayload, NcpToolCallEndPayload, NcpToolCallResult, NcpToolCallResultPayload, NcpToolCallStartPayload, NcpToolDefinition, NcpToolInvocationPart, NcpToolRegistry, NcpTypingEndPayload, NcpTypingStartPayload, OpenAIChatChunk, OpenAIChatMessage, OpenAIContentPart, OpenAITool, OpenAIToolCall, OpenAIToolCallDelta, isHiddenNcpMessage, normalizeAssistantText, readAssistantReasoningNormalizationMode, readAssistantReasoningNormalizationModeFromMetadata, sanitizeAssistantReplyTags, stripReplyTagsFromText, writeAssistantReasoningNormalizationModeToMetadata };
+export { ListMessagesOptions, ListSessionsOptions, NCP_INTERNAL_VISIBILITY_METADATA_KEY, NcpActionPart, NcpAgentClientEndpoint, NcpAgentConversationHydrationParams, NcpAgentConversationSnapshot, NcpAgentConversationStateManager, NcpAgentRunApi, NcpAgentRunInput, NcpAgentRunOptions, NcpAgentRunSendOptions, NcpAgentRunStreamOptions, NcpAgentRuntime, NcpAgentServerEndpoint, NcpAgentStreamProvider, NcpAssistantReasoningNormalizationMode, NcpAssistantReasoningSegment, NcpAssistantTextStreamNormalizer, NcpCardPart, NcpCompletedEnvelope, NcpContextBuilder, NcpContextPrepareOptions, NcpConversationSnapshot, NcpConversationStateManager, NcpEncodeContext, NcpEndpoint, NcpEndpointEvent, NcpEndpointKind, NcpEndpointLatency, NcpEndpointManifest, NcpEndpointSubscriber, NcpError, NcpErrorCode, NcpEventType, NcpExtensionPart, NcpFailedEnvelope, NcpFilePart, NcpInvalidToolArgumentsResult, NcpLLMApi, NcpLLMApiInput, NcpLLMApiOptions, NcpMessage, NcpMessageAbortPayload, NcpMessageAcceptedPayload, NcpMessageDeliveredPayload, NcpMessagePart, NcpMessageReactionPayload, NcpMessageReadPayload, NcpMessageRecalledPayload, NcpMessageRole, NcpMessageSentPayload, NcpMessageStatus, NcpPendingToolCall, NcpPresenceUpdatedPayload, NcpProviderRuntimeRoute, NcpReasoningDeltaPayload, NcpReasoningEndPayload, NcpReasoningPart, NcpReasoningStartPayload, NcpReplyTagParseResult, NcpRequestEnvelope, NcpResponseEnvelope, NcpRichTextPart, NcpRoundBuffer, NcpRunContext, NcpRunErrorPayload, NcpRunFinalMetadata, NcpRunFinishedPayload, NcpRunMetadataPayload, NcpRunReadyMetadata, NcpRunStartedPayload, NcpSessionApi, NcpSessionPatch, NcpSessionStatus, NcpSessionSummary, NcpSourcePart, NcpStepStartPart, NcpStreamEncoder, NcpStreamRequestPayload, NcpTextDeltaPayload, NcpTextEndPayload, NcpTextPart, NcpTextStartPayload, NcpTool, NcpToolCallArgsDeltaPayload, NcpToolCallArgsPayload, NcpToolCallEndPayload, NcpToolCallResult, NcpToolCallResultPayload, NcpToolCallStartPayload, NcpToolDefinition, NcpToolInvocationPart, NcpToolRegistry, NcpTypingEndPayload, NcpTypingStartPayload, OpenAIChatChunk, OpenAIChatMessage, OpenAIContentPart, OpenAITool, OpenAIToolCall, OpenAIToolCallDelta, isHiddenNcpMessage, normalizeAssistantText, readAssistantReasoningNormalizationMode, readAssistantReasoningNormalizationModeFromMetadata, sanitizeAssistantReplyTags, stripReplyTagsFromText, writeAssistantReasoningNormalizationModeToMetadata };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nextclaw/ncp",
-  "version": "0.5.1",
+  "version": "0.5.3",
   "private": false,
   "description": "NextClaw Communication Protocol core abstractions and types.",
   "type": "module",