@nextclaw/ncp 0.5.5 → 0.5.6-beta.1

package/dist/index.d.ts

@@ -221,6 +221,7 @@ type NcpSessionSummary = {
   lastMessageAt?: string;
   status?: NcpSessionStatus;
   metadata?: Record<string, unknown>;
+  contextWindow?: Record<string, unknown> | null;
 };
 type ListSessionsOptions = {
   limit?: number;
@@ -458,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;
@@ -541,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"
@@ -586,6 +592,9 @@ type NcpEndpointEvent = {
 } | {
   type: NcpEventType.RunMetadata;
   payload: NcpRunMetadataPayload;
+} | {
+  type: NcpEventType.ContextWindowUpdated;
+  payload: NcpContextWindowUpdatedPayload;
 } | {
   type: NcpEventType.MessageTextStart;
   payload: NcpTextStartPayload;
@@ -888,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.
@@ -927,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
@@ -957,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
@@ -993,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, NcpToolOutputContentItem, NcpToolOutputImageItem, NcpToolOutputTextItem, 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.5",
+  "version": "0.5.6-beta.1",
   "private": false,
   "description": "NextClaw Communication Protocol core abstractions and types.",
   "type": "module",