@nextclaw/ncp 0.2.0 → 0.3.0

package/dist/index.d.ts

@@ -222,6 +222,7 @@ type NcpSessionSummary = {
     messageCount: number;
     updatedAt: string;
     status?: NcpSessionStatus;
+    metadata?: Record<string, unknown>;
 };
 type ListSessionsOptions = {
     limit?: number;
@@ -668,6 +669,7 @@ type NcpAgentRunInput = {
     sessionId: string;
     messages: ReadonlyArray<NcpMessage>;
     correlationId?: string;
+    metadata?: Record<string, unknown>;
 };
 type NcpAgentRunOptions = {
     signal?: AbortSignal;
@@ -703,6 +705,7 @@ type OpenAIChatMessage = {
 } | {
     role: "assistant";
     content?: string | null;
+    reasoning_content?: string;
     tool_calls?: OpenAIToolCall[];
 } | {
     role: "tool";
@@ -748,6 +751,7 @@ type NcpLLMApiInput = {
     messages: OpenAIChatMessage[];
     tools?: OpenAITool[];
     model?: string;
+    thinkingLevel?: string | null;
     max_tokens?: number;
 };
 type NcpLLMApiOptions = {
@@ -781,9 +785,21 @@ interface NcpTool {
 type NcpToolCallResult = {
     toolCallId: string;
     toolName: string;
-    args: unknown;
+    args: Record<string, unknown> | null;
+    rawArgsText: string;
     result: unknown;
 };
+type NcpInvalidToolArgumentsResult = {
+    ok: false;
+    error: {
+        code: "invalid_tool_arguments";
+        message: string;
+        toolCallId: string;
+        toolName: string;
+        rawArgumentsText: string;
+        issues: string[];
+    };
+};
 interface NcpToolRegistry {
     listTools(): ReadonlyArray<NcpTool>;
     getTool(name: string): NcpTool | undefined;
@@ -916,4 +932,11 @@ interface NcpAgentConversationStateManager extends NcpConversationStateManager {
     handleEndpointError(payload: NcpError): void;
 }
 
-export { type ListMessagesOptions, type ListSessionsOptions, type NcpActionPart, type NcpAgentClientEndpoint, type NcpAgentConversationHydrationParams, type NcpAgentConversationSnapshot, type NcpAgentConversationStateManager, type NcpAgentRunApi, type NcpAgentRunInput, type NcpAgentRunOptions, type NcpAgentRunSendOptions, type NcpAgentRunStreamOptions, type NcpAgentRuntime, type NcpAgentServerEndpoint, type NcpAgentStreamProvider, type NcpCardPart, type NcpCompletedEnvelope, type NcpContextBuilder, type NcpContextPrepareOptions, type NcpConversationSnapshot, type NcpConversationStateManager, type NcpEncodeContext, type NcpEndpoint, type NcpEndpointEvent, type NcpEndpointKind, type NcpEndpointLatency, type NcpEndpointManifest, type NcpEndpointSubscriber, type NcpError, type NcpErrorCode, NcpEventType, type NcpExtensionPart, type NcpFailedEnvelope, type NcpFilePart, type NcpLLMApi, type NcpLLMApiInput, type NcpLLMApiOptions, type NcpMessage, type NcpMessageAbortPayload, type NcpMessageAcceptedPayload, type NcpMessageDeliveredPayload, type NcpMessagePart, type NcpMessageReactionPayload, type NcpMessageReadPayload, type NcpMessageRecalledPayload, type NcpMessageRole, type NcpMessageSentPayload, type NcpMessageStatus, type NcpPendingToolCall, type NcpPresenceUpdatedPayload, type NcpReasoningDeltaPayload, type NcpReasoningEndPayload, type NcpReasoningPart, type NcpReasoningStartPayload, type NcpRequestEnvelope, type NcpResponseEnvelope, type NcpRichTextPart, type NcpRoundBuffer, type NcpRunContext, type NcpRunErrorPayload, type NcpRunFinalMetadata, type NcpRunFinishedPayload, type NcpRunMetadataPayload, type NcpRunReadyMetadata, type NcpRunStartedPayload, type NcpSessionApi, type NcpSessionStatus, type NcpSessionSummary, type NcpSourcePart, type NcpStepStartPart, type NcpStreamEncoder, type NcpStreamRequestPayload, type NcpTextDeltaPayload, type NcpTextEndPayload, type NcpTextPart, type NcpTextStartPayload, type NcpTool, type NcpToolCallArgsDeltaPayload, type NcpToolCallArgsPayload, type NcpToolCallEndPayload, type NcpToolCallResult, type NcpToolCallResultPayload, type NcpToolCallStartPayload, type NcpToolDefinition, type NcpToolInvocationPart, type NcpToolRegistry, type NcpTypingEndPayload, type NcpTypingStartPayload, type OpenAIChatChunk, type OpenAIChatMessage, type OpenAIContentPart, type OpenAITool, type OpenAIToolCall, type OpenAIToolCallDelta };
+type NcpReplyTagParseResult = {
+    content: string;
+    replyTo?: string;
+};
+declare function stripReplyTagsFromText(content: string, currentMessageId?: string): NcpReplyTagParseResult;
+declare function sanitizeAssistantReplyTags(message: NcpMessage, currentMessageId?: string): NcpMessage;
+
+export { type ListMessagesOptions, type ListSessionsOptions, type NcpActionPart, type NcpAgentClientEndpoint, type NcpAgentConversationHydrationParams, type NcpAgentConversationSnapshot, type NcpAgentConversationStateManager, type NcpAgentRunApi, type NcpAgentRunInput, type NcpAgentRunOptions, type NcpAgentRunSendOptions, type NcpAgentRunStreamOptions, type NcpAgentRuntime, type NcpAgentServerEndpoint, type NcpAgentStreamProvider, type NcpCardPart, type NcpCompletedEnvelope, type NcpContextBuilder, type NcpContextPrepareOptions, type NcpConversationSnapshot, type NcpConversationStateManager, type NcpEncodeContext, type NcpEndpoint, type NcpEndpointEvent, type NcpEndpointKind, type NcpEndpointLatency, type NcpEndpointManifest, type NcpEndpointSubscriber, type NcpError, type NcpErrorCode, NcpEventType, type NcpExtensionPart, type NcpFailedEnvelope, type NcpFilePart, type NcpInvalidToolArgumentsResult, type NcpLLMApi, type NcpLLMApiInput, type NcpLLMApiOptions, type NcpMessage, type NcpMessageAbortPayload, type NcpMessageAcceptedPayload, type NcpMessageDeliveredPayload, type NcpMessagePart, type NcpMessageReactionPayload, type NcpMessageReadPayload, type NcpMessageRecalledPayload, type NcpMessageRole, type NcpMessageSentPayload, type NcpMessageStatus, type NcpPendingToolCall, type NcpPresenceUpdatedPayload, type NcpReasoningDeltaPayload, type NcpReasoningEndPayload, type NcpReasoningPart, type NcpReasoningStartPayload, type NcpReplyTagParseResult, type NcpRequestEnvelope, type NcpResponseEnvelope, type NcpRichTextPart, type NcpRoundBuffer, type NcpRunContext, type NcpRunErrorPayload, type NcpRunFinalMetadata, type NcpRunFinishedPayload, type NcpRunMetadataPayload, type NcpRunReadyMetadata, type NcpRunStartedPayload, type NcpSessionApi, type NcpSessionStatus, type NcpSessionSummary, type NcpSourcePart, type NcpStepStartPart, type NcpStreamEncoder, type NcpStreamRequestPayload, type NcpTextDeltaPayload, type NcpTextEndPayload, type NcpTextPart, type NcpTextStartPayload, type NcpTool, type NcpToolCallArgsDeltaPayload, type NcpToolCallArgsPayload, type NcpToolCallEndPayload, type NcpToolCallResult, type NcpToolCallResultPayload, type NcpToolCallStartPayload, type NcpToolDefinition, type NcpToolInvocationPart, type NcpToolRegistry, type NcpTypingEndPayload, type NcpTypingStartPayload, type OpenAIChatChunk, type OpenAIChatMessage, type OpenAIContentPart, type OpenAITool, type OpenAIToolCall, type OpenAIToolCallDelta, sanitizeAssistantReplyTags, stripReplyTagsFromText };

package/dist/index.js

@@ -34,6 +34,86 @@ var NcpEventType = /* @__PURE__ */ ((NcpEventType2) => {
   NcpEventType2["PresenceUpdated"] = "presence.updated";
   return NcpEventType2;
 })(NcpEventType || {});
+
+// src/toolkit/reply-tags.ts
+var REPLY_TO_CURRENT_PATTERN = /\[\[\s*reply_to_current\s*\]\]/gi;
+var REPLY_TO_ID_PATTERN = /\[\[\s*reply_to\s*:\s*([^\]]+?)\s*\]\]/i;
+function normalizeReplyTarget(value) {
+  if (typeof value !== "string") {
+    return void 0;
+  }
+  const trimmed = value.trim();
+  return trimmed.length > 0 ? trimmed : void 0;
+}
+function stripReplyTagsFromText(content, currentMessageId) {
+  let nextContent = content;
+  let replyTo;
+  if (REPLY_TO_CURRENT_PATTERN.test(nextContent)) {
+    replyTo = normalizeReplyTarget(currentMessageId);
+    nextContent = nextContent.replace(REPLY_TO_CURRENT_PATTERN, "").trim();
+  }
+  const explicitReplyTarget = nextContent.match(REPLY_TO_ID_PATTERN)?.[1];
+  if (explicitReplyTarget) {
+    replyTo = normalizeReplyTarget(explicitReplyTarget);
+    nextContent = nextContent.replace(REPLY_TO_ID_PATTERN, "").trim();
+  }
+  return replyTo ? { content: nextContent, replyTo } : { content: nextContent };
+}
+function sanitizeAssistantReplyTags(message, currentMessageId = message.id) {
+  if (message.role !== "assistant") {
+    return {
+      ...message,
+      parts: [...message.parts],
+      metadata: message.metadata ? { ...message.metadata } : void 0
+    };
+  }
+  const firstTextIndex = message.parts.findIndex((part) => part.type === "text");
+  const nextMetadata = message.metadata ? { ...message.metadata } : void 0;
+  const existingReplyTo = normalizeReplyTarget(nextMetadata?.reply_to);
+  if (firstTextIndex < 0) {
+    return {
+      ...message,
+      parts: [...message.parts],
+      metadata: nextMetadata
+    };
+  }
+  const firstTextPart = message.parts[firstTextIndex];
+  if (!firstTextPart || firstTextPart.type !== "text") {
+    return {
+      ...message,
+      parts: [...message.parts],
+      metadata: nextMetadata
+    };
+  }
+  const { content, replyTo } = stripReplyTagsFromText(firstTextPart.text, currentMessageId);
+  const effectiveReplyTo = replyTo ?? existingReplyTo;
+  const nextParts = message.parts.flatMap((part, index) => {
+    if (index !== firstTextIndex || part.type !== "text") {
+      return [part];
+    }
+    if (content.length === 0) {
+      return [];
+    }
+    return [{ ...part, text: content }];
+  });
+  if (effectiveReplyTo) {
+    return {
+      ...message,
+      parts: nextParts,
+      metadata: {
+        ...nextMetadata,
+        reply_to: effectiveReplyTo
+      }
+    };
+  }
+  return {
+    ...message,
+    parts: nextParts,
+    metadata: nextMetadata
+  };
+}
 export {
-  NcpEventType
+  NcpEventType,
+  sanitizeAssistantReplyTags,
+  stripReplyTagsFromText
 };

package/package.json

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