@nextclaw/ncp 0.5.4 → 0.5.6-beta.0

package/dist/index.d.ts

@@ -62,6 +62,19 @@ type NcpReasoningPart = {
   type: "reasoning";
   text: string;
 };
+type NcpToolOutputTextItem = {
+  type: "input_text";
+  text: string;
+};
+type NcpToolOutputImageItem = {
+  type: "input_image";
+  imageUrl: string;
+  mimeType?: string;
+  detail?: "low" | "high" | "auto" | "original";
+  originalDataChars?: number;
+  dataOmitted?: boolean;
+};
+type NcpToolOutputContentItem = NcpToolOutputTextItem | NcpToolOutputImageItem;
 /**
  * Represents a tool call and its lifecycle.
  *
@@ -77,7 +90,8 @@ type NcpToolInvocationPart = {
   toolCallId?: string;
   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;
+  result?: unknown; /** Model-visible structured output items. Text is bounded; images remain image items. */
+  resultContentItems?: NcpToolOutputContentItem[];
 };
 /**
  * A rich card with arbitrary structured data.
@@ -207,6 +221,7 @@ type NcpSessionSummary = {
   lastMessageAt?: string;
   status?: NcpSessionStatus;
   metadata?: Record<string, unknown>;
+  contextWindow?: Record<string, unknown> | null;
 };
 type ListSessionsOptions = {
   limit?: number;
@@ -444,6 +459,10 @@ type NcpRunMetadataPayload = {
   runId?: string;
   metadata: Record<string, unknown>;
 };
+type NcpContextWindowUpdatedPayload = {
+  sessionId: string;
+  contextWindow: Record<string, unknown>;
+};
 type NcpTextStartPayload = {
   sessionId: string;
   messageId: string;
@@ -495,6 +514,7 @@ type NcpToolCallResultPayload = {
   sessionId: string;
   toolCallId: string;
   content: unknown;
+  contentItems?: NcpToolOutputContentItem[];
 };
 declare enum NcpEventType {
   EndpointReady = "endpoint.ready",
@@ -526,6 +546,7 @@ declare enum NcpEventType {
   RunFinished = "run.finished",
   RunError = "run.error",
   RunMetadata = "run.metadata",
+  ContextWindowUpdated = "context-window.updated",
   TypingStart = "typing.start",
   TypingEnd = "typing.end",
   PresenceUpdated = "presence.updated"
@@ -571,6 +592,9 @@ type NcpEndpointEvent = {
 } | {
   type: NcpEventType.RunMetadata;
   payload: NcpRunMetadataPayload;
+} | {
+  type: NcpEventType.ContextWindowUpdated;
+  payload: NcpContextWindowUpdatedPayload;
 } | {
   type: NcpEventType.MessageTextStart;
   payload: NcpTextStartPayload;
@@ -790,6 +814,7 @@ type NcpToolCallResult = {
   args: Record<string, unknown> | null;
   rawArgsText: string;
   result: unknown;
+  contentItems?: NcpToolOutputContentItem[];
 };
 type NcpInvalidToolArgumentsResult = {
   ok: false;
@@ -872,6 +897,8 @@ interface NcpConversationSnapshot {
   readonly streamingMessage: NcpMessage | null;
   /** Latest error, if any (e.g. from message.failed or endpoint.error). */
   readonly error: NcpError | null;
+  /** Latest context-window usage snapshot for this conversation, if known. */
+  readonly contextWindow: Record<string, unknown> | null;
 }
 /**
  * Agent snapshot: extends base snapshot with active run state.
@@ -911,6 +938,7 @@ type NcpAgentConversationHydrationParams = {
   sessionId: string;
   messages: ReadonlyArray<NcpMessage>;
   activeRun?: NcpRunContext | null;
+  contextWindow?: Record<string, unknown> | null;
 };
 /**
  * Agent-scenario state manager: extends the generic conversation state manager
@@ -941,6 +969,7 @@ interface NcpAgentConversationStateManager extends NcpConversationStateManager {
   handleRunFinished(payload: NcpRunFinishedPayload): void;
   handleRunError(payload: NcpRunErrorPayload): void;
   handleRunMetadata(payload: NcpRunMetadataPayload): void;
+  handleContextWindowUpdated(payload: NcpContextWindowUpdatedPayload): void;
   handleEndpointError(payload: NcpError): void;
 }
 //#endregion
@@ -977,4 +1006,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, 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 };
+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, NcpContextWindowUpdatedPayload, 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, NcpToolOutputContentItem, NcpToolOutputImageItem, NcpToolOutputTextItem, NcpToolRegistry, NcpTypingEndPayload, NcpTypingStartPayload, OpenAIChatChunk, OpenAIChatMessage, OpenAIContentPart, OpenAITool, OpenAIToolCall, OpenAIToolCallDelta, isHiddenNcpMessage, normalizeAssistantText, readAssistantReasoningNormalizationMode, readAssistantReasoningNormalizationModeFromMetadata, sanitizeAssistantReplyTags, stripReplyTagsFromText, writeAssistantReasoningNormalizationModeToMetadata };

package/dist/index.js

@@ -35,6 +35,7 @@ let NcpEventType = /* @__PURE__ */ function(NcpEventType) {
 	NcpEventType["RunFinished"] = "run.finished";
 	NcpEventType["RunError"] = "run.error";
 	NcpEventType["RunMetadata"] = "run.metadata";
+	NcpEventType["ContextWindowUpdated"] = "context-window.updated";
 	NcpEventType["TypingStart"] = "typing.start";
 	NcpEventType["TypingEnd"] = "typing.end";
 	NcpEventType["PresenceUpdated"] = "presence.updated";

package/package.json

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