@nextclaw/ncp-toolkit 0.5.9 → 0.5.11-beta.0

package/dist/index.d.ts

@@ -1,4 +1,4 @@
-import { NcpAgentClientEndpoint, NcpAgentConversationHydrationParams, NcpAgentConversationSnapshot, NcpAgentConversationStateManager, NcpAgentRunApi, NcpAgentRunInput, NcpAgentRunSendOptions, NcpAgentRunStreamOptions, NcpAgentRuntime, NcpAgentServerEndpoint, NcpAgentStreamProvider, NcpEndpointEvent, NcpEndpointManifest, NcpEndpointSubscriber, NcpError, NcpErrorCode, NcpMessage, NcpMessageAbortPayload, NcpMessagePart, NcpMessageSentPayload, NcpReasoningDeltaPayload, NcpReasoningEndPayload, NcpReasoningStartPayload, NcpRequestEnvelope, NcpRunErrorPayload, NcpRunFinishedPayload, NcpRunMetadataPayload, NcpRunStartedPayload, NcpSessionApi, NcpSessionPatch, NcpSessionSummary, NcpStreamRequestPayload, NcpTextDeltaPayload, NcpTextEndPayload, NcpTextStartPayload, NcpToolCallArgsDeltaPayload, NcpToolCallArgsPayload, NcpToolCallEndPayload, NcpToolCallResultPayload, NcpToolCallStartPayload, OpenAITool } from "@nextclaw/ncp";
+import { NcpAgentClientEndpoint, NcpAgentConversationHydrationParams, NcpAgentConversationSnapshot, NcpAgentConversationStateManager, NcpAgentRunApi, NcpAgentRunInput, NcpAgentRunSendOptions, NcpAgentRunStreamOptions, NcpAgentRuntime, NcpAgentServerEndpoint, NcpAgentStreamProvider, NcpContextWindowUpdatedPayload, NcpEndpointEvent, NcpEndpointManifest, NcpEndpointSubscriber, NcpError, NcpErrorCode, NcpMessage, NcpMessageAbortPayload, NcpMessagePart, NcpMessageSentPayload, NcpReasoningDeltaPayload, NcpReasoningEndPayload, NcpReasoningStartPayload, NcpRequestEnvelope, NcpRunErrorPayload, NcpRunFinishedPayload, NcpRunMetadataPayload, NcpRunStartedPayload, NcpSessionApi, NcpSessionPatch, NcpSessionSummary, NcpStreamRequestPayload, NcpTextDeltaPayload, NcpTextEndPayload, NcpTextStartPayload, NcpToolCallArgsDeltaPayload, NcpToolCallArgsPayload, NcpToolCallEndPayload, NcpToolCallResultPayload, NcpToolCallStartPayload, OpenAITool } from "@nextclaw/ncp";
 
 //#region src/agent/agent-conversation-state-manager.d.ts
 declare class DefaultNcpAgentConversationStateManager implements NcpAgentConversationStateManager {
@@ -6,6 +6,7 @@ declare class DefaultNcpAgentConversationStateManager implements NcpAgentConvers
   private streamingMessage;
   private error;
   private activeRun;
+  private contextWindow;
   private readonly listeners;
   private readonly toolCallMessageIdByCallId;
   private readonly toolCallArgsRawByCallId;
@@ -37,6 +38,7 @@ declare class DefaultNcpAgentConversationStateManager implements NcpAgentConvers
   handleRunFinished: (payload: NcpRunFinishedPayload) => void;
   handleRunError: (payload: NcpRunErrorPayload) => void;
   handleRunMetadata: (payload: NcpRunMetadataPayload) => void;
+  handleContextWindowUpdated: (payload: NcpContextWindowUpdatedPayload) => void;
   handleEndpointError: (payload: NcpError) => void;
   private applyToolCallArgs;
   private ensureStreamingMessage;
@@ -111,10 +113,18 @@ interface AgentSessionStore {
   deleteSession(sessionId: string): Promise<AgentSessionRecord | null>;
 }
 //#endregion
+//#region src/agent/agent-backend/agent-backend-session-utils.d.ts
+type SessionContextWindowResolver = (params: {
+  messages: readonly NcpMessage[];
+  metadata: Record<string, unknown>;
+  sessionId: string;
+}) => Record<string, unknown> | null;
+//#endregion
 //#region src/agent/agent-backend/agent-backend.d.ts
 type DefaultNcpAgentBackendConfig = {
   createRuntime: CreateRuntimeFn;
   sessionStore: AgentSessionStore;
+  resolveSessionContextWindow?: SessionContextWindowResolver;
   onSessionRunStatusChanged?: (payload: {
     sessionKey: string;
     status: "running" | "idle";
@@ -135,6 +145,7 @@ declare class DefaultNcpAgentBackend implements NcpAgentServerEndpoint, NcpSessi
   private readonly executor;
   private readonly publisher;
   private readonly sessionRealtime;
+  private readonly resolveSessionContextWindow;
   private started;
   constructor(config: DefaultNcpAgentBackendConfig);
   start: () => Promise<void>;

package/dist/index.js

@@ -91,6 +91,7 @@ var DefaultNcpAgentConversationStateManager = class {
 	streamingMessage = null;
 	error = null;
 	activeRun = null;
+	contextWindow = null;
 	listeners = /* @__PURE__ */ new Set();
 	toolCallMessageIdByCallId = /* @__PURE__ */ new Map();
 	toolCallArgsRawByCallId = /* @__PURE__ */ new Map();
@@ -107,7 +108,8 @@ var DefaultNcpAgentConversationStateManager = class {
 				...this.error,
 				details: this.error.details ? { ...this.error.details } : void 0
 			} : null,
-			activeRun: this.activeRun ? { ...this.activeRun } : null
+			activeRun: this.activeRun ? { ...this.activeRun } : null,
+			contextWindow: this.contextWindow ? { ...this.contextWindow } : null
 		};
 		this.snapshotCache = snapshot;
 		this.snapshotVersion = this.stateVersion;
@@ -118,11 +120,12 @@ var DefaultNcpAgentConversationStateManager = class {
 		return () => this.listeners.delete(listener);
 	};
 	reset = () => {
-		if (this.messages.length === 0 && !this.streamingMessage && !this.error && !this.activeRun && this.toolCallMessageIdByCallId.size === 0 && this.toolCallArgsRawByCallId.size === 0) return;
+		if (this.messages.length === 0 && !this.streamingMessage && !this.error && !this.activeRun && !this.contextWindow && this.toolCallMessageIdByCallId.size === 0 && this.toolCallArgsRawByCallId.size === 0) return;
 		this.messages = [];
 		this.streamingMessage = null;
 		this.error = null;
 		this.activeRun = null;
+		this.contextWindow = null;
 		this.toolCallMessageIdByCallId.clear();
 		this.toolCallArgsRawByCallId.clear();
 		this.lastSettledRunId = null;
@@ -133,6 +136,7 @@ var DefaultNcpAgentConversationStateManager = class {
 		this.messages = payload.messages.map((message) => normalizeConversationMessage(message));
 		this.streamingMessage = null;
 		this.error = null;
+		this.contextWindow = payload.contextWindow ? { ...payload.contextWindow } : null;
 		this.activeRun = payload.activeRun ? {
 			...payload.activeRun,
 			sessionId: payload.activeRun.sessionId ?? payload.sessionId,
@@ -204,6 +208,9 @@ var DefaultNcpAgentConversationStateManager = class {
 			case NcpEventType.RunMetadata:
 				this.handleRunMetadata(event.payload);
 				break;
+			case NcpEventType.ContextWindowUpdated:
+				this.handleContextWindowUpdated(event.payload);
+				break;
 			case NcpEventType.EndpointError:
 				this.handleEndpointError(event.payload);
 				break;
@@ -343,7 +350,8 @@ var DefaultNcpAgentConversationStateManager = class {
 				toolName: existingPart.toolName,
 				state: "result",
 				args: existingPart.args,
-				result: payload.content
+				result: payload.content,
+				resultContentItems: payload.contentItems
 			};
 			return upsertToolInvocationPart(targetMessage.parts, mergedPart);
 		})) {
@@ -353,7 +361,8 @@ var DefaultNcpAgentConversationStateManager = class {
 				toolCallId: payload.toolCallId,
 				toolName: "unknown",
 				state: "result",
-				result: payload.content
+				result: payload.content,
+				resultContentItems: payload.contentItems
 			});
 			this.replaceStreamingMessage({
 				...fallbackMessage,
@@ -399,6 +408,10 @@ var DefaultNcpAgentConversationStateManager = class {
 			this.clearActiveRun();
 		}
 	};
+	handleContextWindowUpdated = (payload) => {
+		this.contextWindow = { ...payload.contextWindow };
+		this.stateVersion += 1;
+	};
 	handleEndpointError = (payload) => {
 		if (payload.code === "abort-error") {
 			this.handleMessageAbort({
@@ -992,6 +1005,21 @@ function toLiveSessionSummary(session) {
 		...Object.keys(metadata).length > 0 ? { metadata } : {}
 	};
 }
+function withSessionContextWindow(summary, messages, resolver) {
+	const contextWindow = resolver?.({
+		messages,
+		metadata: summary.metadata ?? {},
+		sessionId: summary.sessionId
+	});
+	return contextWindow ? {
+		...summary,
+		contextWindow
+	} : summary;
+}
+function toLiveSessionSummaryWithContextWindow(session, resolver) {
+	const messages = readMessages(session.stateManager.getSnapshot());
+	return withSessionContextWindow(toLiveSessionSummary(session), messages, resolver);
+}
 function now() {
 	return (/* @__PURE__ */ new Date()).toISOString();
 }
@@ -1016,11 +1044,12 @@ function resolveAutoSessionLabelFromMessages(messages) {
 	return null;
 }
 function withAutoSessionLabel(params) {
-	if (readOptionalString$1(params.metadata.label)) return params.metadata;
-	const nextLabel = resolveAutoSessionLabelFromMessages(params.messages);
-	if (!nextLabel) return params.metadata;
+	const { metadata, messages } = params;
+	if (readOptionalString$1(metadata.label)) return metadata;
+	const nextLabel = resolveAutoSessionLabelFromMessages(messages);
+	if (!nextLabel) return metadata;
 	return {
-		...params.metadata,
+		...metadata,
 		label: nextLabel
 	};
 }
@@ -1140,9 +1169,11 @@ var DefaultNcpAgentBackend = class {
 	executor;
 	publisher;
 	sessionRealtime;
+	resolveSessionContextWindow;
 	started = false;
 	constructor(config) {
 		this.sessionStore = config.sessionStore;
+		this.resolveSessionContextWindow = config.resolveSessionContextWindow;
 		this.onSessionRunStatusChanged = config.onSessionRunStatusChanged;
 		this.sessionRegistry = new AgentLiveSessionRegistry(this.sessionStore, config.createRuntime);
 		this.executor = new AgentRunExecutor();
@@ -1258,7 +1289,8 @@ var DefaultNcpAgentBackend = class {
 	getSession = async (sessionId) => {
 		const liveSession = this.sessionRegistry.getSession(sessionId);
 		const storedSession = await this.sessionStore.getSession(sessionId);
-		return storedSession ? toSessionSummary(storedSession, liveSession) : liveSession ? toLiveSessionSummary(liveSession) : null;
+		const liveMessages = liveSession ? readMessages(liveSession.stateManager.getSnapshot()) : null;
+		return storedSession ? withSessionContextWindow(toSessionSummary(storedSession, liveSession), liveMessages ?? storedSession.messages, this.resolveSessionContextWindow) : liveSession ? toLiveSessionSummaryWithContextWindow(liveSession, this.resolveSessionContextWindow) : null;
 	};
 	appendMessage = async (sessionId, message) => {
 		await this.ensureStarted();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nextclaw/ncp-toolkit",
-  "version": "0.5.9",
+  "version": "0.5.11-beta.0",
   "private": false,
   "description": "Toolkit implementations built on top of the NextClaw Communication Protocol.",
   "type": "module",
@@ -15,14 +15,14 @@
     "dist"
   ],
   "dependencies": {
-    "@nextclaw/ncp": "0.5.4"
+    "@nextclaw/ncp": "0.5.6-beta.0"
   },
   "devDependencies": {
     "@types/node": "^20.17.6",
     "prettier": "^3.3.3",
     "typescript": "^5.6.3",
     "vitest": "^4.1.2",
-    "@nextclaw/ncp-agent-runtime": "0.3.14"
+    "@nextclaw/ncp-agent-runtime": "0.3.16-beta.0"
   },
   "scripts": {
     "build": "tsdown src/index.ts --dts --clean --target es2022 --no-fixedExtension",