@nextclaw/ui 0.15.25 → 0.15.27

package/src/features/chat/features/input/utils/chat-inline-token-composer.utils.ts

@@ -0,0 +1,148 @@
+import type { ChatComposerNode } from '@nextclaw/agent-chat-ui';
+import {
+  CHAT_CONVERSATION_EXCERPT_TOKEN_KIND,
+  CHAT_PROJECT_TOKEN_KIND,
+  CHAT_SYSTEM_OBJECT_TOKEN_KIND,
+  CHAT_UI_RESOURCE_TOKEN_KIND,
+  CHAT_WORKSPACE_DIRECTORY_TOKEN_KIND,
+  CHAT_WORKSPACE_EXCERPT_TOKEN_KIND,
+  CHAT_WORKSPACE_FILE_TOKEN_KIND,
+  type ChatInlineTokenMetadata,
+  type ChatSkillSource,
+  readChatUiResourceReference,
+} from '@nextclaw/shared';
+
+import { serializeChatComposerTokenText } from './chat-composer-token-protocol.utils';
+import { buildConversationExcerptInlineToken } from './chat-conversation-excerpt-token.utils';
+import { readSystemObjectResolvedReference } from './chat-system-object-reference.utils';
+
+export type ChatSkillReferenceSnapshot = {
+  ref: string;
+  name: string;
+  source: ChatSkillSource;
+  path: string;
+};
+
+function readOptionalString(value: unknown): string | null {
+  return typeof value === 'string' && value.trim() ? value.trim() : null;
+}
+
+function readOptionalLine(value: unknown): number | null {
+  return typeof value === 'number' && Number.isInteger(value) && value > 0
+    ? value
+    : null;
+}
+
+function dedupeInlineTokens(tokens: readonly ChatInlineTokenMetadata[]): ChatInlineTokenMetadata[] {
+  const seen = new Set<string>();
+  return tokens.filter((token) => {
+    const identity = 'ref' in token ? token.ref : token.key;
+    const dedupeKey = `${token.kind}:${identity}:${token.rawText}`;
+    if (seen.has(dedupeKey)) return false;
+    seen.add(dedupeKey);
+    return true;
+  });
+}
+
+function buildWorkspaceExcerptToken(
+  node: Extract<ChatComposerNode, { type: 'token' }>,
+  rawText: string,
+): ChatInlineTokenMetadata | null {
+  const path = readOptionalString(node.data?.path);
+  const excerpt = readOptionalString(node.data?.excerpt);
+  if (!path || !excerpt) return null;
+  return {
+    kind: CHAT_WORKSPACE_EXCERPT_TOKEN_KIND,
+    key: node.tokenKey,
+    path,
+    label: node.label,
+    excerpt,
+    startLine: readOptionalLine(node.data?.startLine),
+    endLine: readOptionalLine(node.data?.endLine),
+    rawText,
+  };
+}
+
+function buildStructuredReferenceToken(
+  node: Extract<ChatComposerNode, { type: 'token' }>,
+  rawText: string,
+): ChatInlineTokenMetadata | null | undefined {
+  if (node.tokenKind === CHAT_WORKSPACE_EXCERPT_TOKEN_KIND) {
+    return buildWorkspaceExcerptToken(node, rawText);
+  }
+  if (node.tokenKind === CHAT_CONVERSATION_EXCERPT_TOKEN_KIND) {
+    return buildConversationExcerptInlineToken(node, rawText);
+  }
+  if (node.tokenKind === CHAT_SYSTEM_OBJECT_TOKEN_KIND) {
+    const reference = readSystemObjectResolvedReference(node.data?.reference);
+    return reference?.uri === node.tokenKey
+      ? {
+        kind: CHAT_SYSTEM_OBJECT_TOKEN_KIND,
+        key: node.tokenKey,
+        label: node.label,
+        rawText,
+        reference,
+      }
+      : null;
+  }
+  if (node.tokenKind === CHAT_UI_RESOURCE_TOKEN_KIND) {
+    const reference = readChatUiResourceReference(node.data?.reference);
+    return reference?.uri === node.tokenKey
+      ? {
+          kind: CHAT_UI_RESOURCE_TOKEN_KIND,
+          key: node.tokenKey,
+          label: node.label,
+          rawText,
+          reference,
+        }
+      : null;
+  }
+  return undefined;
+}
+
+export function buildInlineTokensFromComposer(
+  nodes: readonly ChatComposerNode[],
+  skillRecords: readonly ChatSkillReferenceSnapshot[] = [],
+): ChatInlineTokenMetadata[] {
+  const skillByRef = new Map(skillRecords.map((record) => [record.ref, record]));
+  const tokens: ChatInlineTokenMetadata[] = [];
+  for (const node of nodes) {
+    if (node.type !== 'token') continue;
+    const rawText = serializeChatComposerTokenText(node);
+    if (!rawText) continue;
+    if (node.tokenKind === 'skill') {
+      const skill = skillByRef.get(node.tokenKey);
+      if (skill?.path.trim()) {
+        tokens.push({
+          kind: 'skill',
+          ref: skill.ref,
+          name: skill.name,
+          source: skill.source,
+          path: skill.path,
+          label: node.label,
+          rawText,
+        });
+      }
+      continue;
+    }
+    if (node.tokenKind === CHAT_PROJECT_TOKEN_KIND) {
+      tokens.push({ kind: CHAT_PROJECT_TOKEN_KIND, key: node.tokenKey, label: node.label, rawText });
+      continue;
+    }
+    const structuredReference = buildStructuredReferenceToken(node, rawText);
+    if (structuredReference !== undefined) {
+      if (structuredReference) tokens.push(structuredReference);
+      continue;
+    }
+    if (
+      node.tokenKind === CHAT_WORKSPACE_FILE_TOKEN_KIND ||
+      node.tokenKind === CHAT_WORKSPACE_DIRECTORY_TOKEN_KIND
+    ) {
+      const workspaceKind = node.tokenKind === CHAT_WORKSPACE_FILE_TOKEN_KIND
+        ? CHAT_WORKSPACE_FILE_TOKEN_KIND
+        : CHAT_WORKSPACE_DIRECTORY_TOKEN_KIND;
+      tokens.push({ kind: workspaceKind, key: node.tokenKey, label: node.label, rawText });
+    }
+  }
+  return dedupeInlineTokens(tokens);
+}

package/src/features/chat/features/input/utils/chat-inline-token.utils.ts

@@ -1,18 +1,26 @@
-import type { ChatComposerNode } from '@nextclaw/agent-chat-ui';
 import {
   CHAT_CONVERSATION_EXCERPT_TOKEN_KIND,
   CHAT_INLINE_TOKENS_METADATA_KEY,
   CHAT_INLINE_TOKENS_SCHEMA_VERSION,
   CHAT_PROJECT_TOKEN_KIND,
+  CHAT_SYSTEM_OBJECT_TOKEN_KIND,
+  CHAT_UI_RESOURCE_TOKEN_KIND,
   CHAT_WORKSPACE_DIRECTORY_TOKEN_KIND,
   CHAT_WORKSPACE_EXCERPT_TOKEN_KIND,
   CHAT_WORKSPACE_FILE_TOKEN_KIND,
   type ChatInlineTokenMetadata,
   type ChatInlineTokensMetadata,
   type ChatSkillSource,
+  type SystemObjectResolvedReference,
+  type ChatUiResourceReference,
+  readChatUiResourceReference,
 } from '@nextclaw/shared';
-import { serializeChatComposerTokenText } from './chat-composer-token-protocol.utils';
-import { buildConversationExcerptInlineToken, readConversationExcerptInlineToken } from './chat-conversation-excerpt-token.utils';
+import { readConversationExcerptInlineToken } from './chat-conversation-excerpt-token.utils';
+import { readSystemObjectResolvedReference } from './chat-system-object-reference.utils';
+export {
+  buildInlineTokensFromComposer,
+  type ChatSkillReferenceSnapshot,
+} from './chat-inline-token-composer.utils';
 
 export { CHAT_INLINE_TOKENS_METADATA_KEY };
 const CHAT_PANEL_APP_TOKEN_PREFIX = '@panel-app:';
@@ -20,13 +28,8 @@ const CHAT_PANEL_APP_TOKEN_PATTERN = /@panel-app:([A-Za-z0-9_-]+)/g;
 const CHAT_PROJECT_TOKEN_PATTERN = /@project:([^\s]+)/g;
 const CHAT_WORKSPACE_FILE_TOKEN_PATTERN = /@file:([^\s]+)/g;
 const CHAT_WORKSPACE_DIRECTORY_TOKEN_PATTERN = /@folder:([^\s]+)/g;
-
-export type ChatSkillReferenceSnapshot = {
-  ref: string;
-  name: string;
-  source: ChatSkillSource;
-  path: string;
-};
+const CHAT_SYSTEM_OBJECT_TOKEN_PATTERN = /@object:([^\s]+)/g;
+const CHAT_UI_RESOURCE_TOKEN_PATTERN = /@resource:([^\s]+)/g;
 
 export type ChatInlineTokenSource =
   | {
@@ -62,6 +65,20 @@ export type ChatInlineTokenSource =
       key: string;
       label: string;
       rawText: string;
+    }
+  | {
+      kind: typeof CHAT_SYSTEM_OBJECT_TOKEN_KIND;
+      key: string;
+      label: string;
+      rawText: string;
+      reference: SystemObjectResolvedReference;
+    }
+  | {
+      kind: typeof CHAT_UI_RESOURCE_TOKEN_KIND;
+      key: string;
+      label: string;
+      rawText: string;
+      reference: ChatUiResourceReference;
     };
 
 export function resolveWorkspaceReferencePath(params: {
@@ -114,100 +131,11 @@ function dedupeInlineTokens<T extends ChatInlineTokenSource>(tokens: readonly T[
   return output;
 }
 
-function appendWorkspaceExcerptToken(
-  tokens: ChatInlineTokenMetadata[],
-  node: Extract<ChatComposerNode, { type: 'token' }>,
-  rawText: string,
-): void {
-  const path = readOptionalString(node.data?.path);
-  const excerpt = readOptionalString(node.data?.excerpt);
-  if (!path || !excerpt) return;
-  tokens.push({
-    kind: CHAT_WORKSPACE_EXCERPT_TOKEN_KIND,
-    key: node.tokenKey,
-    path,
-    label: node.label,
-    excerpt,
-    startLine: readOptionalLine(node.data?.startLine),
-    endLine: readOptionalLine(node.data?.endLine),
-    rawText,
-  });
-}
-
-export function buildInlineTokensFromComposer(
-  nodes: readonly ChatComposerNode[],
-  skillRecords: readonly ChatSkillReferenceSnapshot[] = [],
-): ChatInlineTokenMetadata[] {
-  const skillByRef = new Map(skillRecords.map((record) => [record.ref, record]));
-  const tokens: ChatInlineTokenMetadata[] = [];
-  for (const node of nodes) {
-    if (node.type !== 'token') {
-      continue;
-    }
-    if (
-      node.tokenKind !== 'skill' &&
-      node.tokenKind !== CHAT_PROJECT_TOKEN_KIND &&
-      node.tokenKind !== CHAT_WORKSPACE_FILE_TOKEN_KIND &&
-      node.tokenKind !== CHAT_WORKSPACE_DIRECTORY_TOKEN_KIND &&
-      node.tokenKind !== CHAT_WORKSPACE_EXCERPT_TOKEN_KIND &&
-      node.tokenKind !== CHAT_CONVERSATION_EXCERPT_TOKEN_KIND
-    ) {
-      continue;
-    }
-    const rawText = serializeChatComposerTokenText(node);
-    if (!rawText) {
-      continue;
-    }
-    if (node.tokenKind === 'skill') {
-      const skill = skillByRef.get(node.tokenKey);
-      if (!skill?.path.trim()) {
-        continue;
-      }
-      tokens.push({
-        kind: 'skill',
-        ref: skill.ref,
-        name: skill.name,
-        source: skill.source,
-        path: skill.path,
-        label: node.label,
-        rawText,
-      });
-      continue;
-    }
-    if (node.tokenKind === CHAT_PROJECT_TOKEN_KIND) {
-      tokens.push({
-        kind: CHAT_PROJECT_TOKEN_KIND,
-        key: node.tokenKey,
-        label: node.label,
-        rawText,
-      });
-      continue;
-    }
-    if (node.tokenKind === CHAT_WORKSPACE_EXCERPT_TOKEN_KIND) {
-      appendWorkspaceExcerptToken(tokens, node, rawText);
-      continue;
-    }
-    if (node.tokenKind === CHAT_CONVERSATION_EXCERPT_TOKEN_KIND) {
-      const token = buildConversationExcerptInlineToken(node, rawText);
-      if (token) tokens.push(token);
-      continue;
-    }
-    const workspaceKind = node.tokenKind === CHAT_WORKSPACE_FILE_TOKEN_KIND
-      ? CHAT_WORKSPACE_FILE_TOKEN_KIND
-      : CHAT_WORKSPACE_DIRECTORY_TOKEN_KIND;
-    tokens.push({
-      kind: workspaceKind,
-      key: node.tokenKey,
-      label: node.label,
-      rawText,
-    });
-  }
-  return dedupeInlineTokens(tokens);
-}
-
 function appendEncodedKeyTokens(params: {
   kind:
     | typeof CHAT_PROJECT_TOKEN_KIND
+    | typeof CHAT_SYSTEM_OBJECT_TOKEN_KIND
+    | typeof CHAT_UI_RESOURCE_TOKEN_KIND
     | typeof CHAT_WORKSPACE_FILE_TOKEN_KIND
     | typeof CHAT_WORKSPACE_DIRECTORY_TOKEN_KIND;
   pattern: RegExp;
@@ -255,6 +183,18 @@ export function buildInlineTokensFromTextProtocol(text: string): ChatInlineToken
     text,
     tokens,
   });
+  appendEncodedKeyTokens({
+    kind: CHAT_SYSTEM_OBJECT_TOKEN_KIND,
+    pattern: CHAT_SYSTEM_OBJECT_TOKEN_PATTERN,
+    text,
+    tokens,
+  });
+  appendEncodedKeyTokens({
+    kind: CHAT_UI_RESOURCE_TOKEN_KIND,
+    pattern: CHAT_UI_RESOURCE_TOKEN_PATTERN,
+    text,
+    tokens,
+  });
   appendEncodedKeyTokens({
     kind: CHAT_WORKSPACE_FILE_TOKEN_KIND,
     pattern: CHAT_WORKSPACE_FILE_TOKEN_PATTERN,
@@ -340,6 +280,20 @@ function readInlineTokenEntry(entry: unknown): ChatInlineTokenSource | null {
   if (kind === CHAT_CONVERSATION_EXCERPT_TOKEN_KIND) {
     return readConversationExcerptInlineToken({ entry, label, rawText });
   }
+  if (kind === CHAT_SYSTEM_OBJECT_TOKEN_KIND) {
+    const key = readOptionalString(entry.key);
+    const reference = readSystemObjectResolvedReference(entry.reference);
+    return key && reference && reference.uri === key
+      ? { kind, key, label, rawText, reference }
+      : null;
+  }
+  if (kind === CHAT_UI_RESOURCE_TOKEN_KIND) {
+    const key = readOptionalString(entry.key);
+    const reference = readChatUiResourceReference(entry.reference);
+    return key && reference && reference.uri === key
+      ? { kind, key, label, rawText, reference }
+      : null;
+  }
   const key = readOptionalString(entry.key);
   return key ? { kind, key, rawText, label } : null;
 }

package/src/features/chat/features/input/utils/chat-system-object-reference.utils.test.ts

@@ -0,0 +1,44 @@
+import { describe, expect, it } from 'vitest';
+import { CHAT_SYSTEM_OBJECT_TOKEN_KIND, type SystemObjectResolvedReference } from '@nextclaw/shared';
+import {
+  appendSystemObjectReferenceToken,
+  readSystemObjectReferenceFromToken,
+} from './chat-system-object-reference.utils';
+
+const reference: SystemObjectResolvedReference = {
+  uri: 'nextclaw://objects/cron-job/cron-1',
+  objectType: 'cron-job',
+  objectId: 'cron-1',
+  label: 'Daily review',
+  description: 'Review reports',
+  updatedAt: '2026-08-11T00:00:00.000Z',
+  version: 'a'.repeat(64),
+  assetUri: 'asset://store/cron-1',
+  fileName: 'daily-review.md',
+  mimeType: 'text/markdown',
+  sizeBytes: 42,
+};
+
+describe('system object reference composer utilities', () => {
+  it('creates one visible generic token and deduplicates the same snapshot', () => {
+    const first = appendSystemObjectReferenceToken([], reference);
+    const second = appendSystemObjectReferenceToken(first, reference);
+
+    expect(second).toHaveLength(first.length);
+    expect(second.find((node) => node.type === 'token')).toMatchObject({
+      tokenKind: CHAT_SYSTEM_OBJECT_TOKEN_KIND,
+      tokenKey: reference.uri,
+      label: reference.label,
+    });
+    expect(readSystemObjectReferenceFromToken(second[0]!)).toEqual(reference);
+  });
+
+  it('rejects metadata whose URI identity disagrees with its object fields', () => {
+    const [node] = appendSystemObjectReferenceToken([], {
+      ...reference,
+      objectId: 'different-cron',
+    });
+
+    expect(readSystemObjectReferenceFromToken(node!)).toBeNull();
+  });
+});

package/src/features/chat/features/input/utils/chat-system-object-reference.utils.ts

@@ -0,0 +1,46 @@
+import {
+  createChatComposerTokenNode,
+  normalizeChatComposerNodes,
+  type ChatComposerNode,
+} from '@nextclaw/agent-chat-ui';
+import {
+  CHAT_SYSTEM_OBJECT_TOKEN_KIND,
+  readSystemObjectResolvedReference,
+  type SystemObjectResolvedReference,
+} from '@nextclaw/shared';
+
+export { readSystemObjectResolvedReference } from '@nextclaw/shared';
+
+export function createSystemObjectReferenceTokenNode(
+  reference: SystemObjectResolvedReference,
+): ChatComposerNode {
+  return createChatComposerTokenNode({
+    tokenKind: CHAT_SYSTEM_OBJECT_TOKEN_KIND,
+    tokenKey: reference.uri,
+    label: reference.label,
+    data: { reference },
+  });
+}
+
+export function appendSystemObjectReferenceToken(
+  nodes: readonly ChatComposerNode[],
+  reference: SystemObjectResolvedReference,
+): ChatComposerNode[] {
+  const exists = nodes.some((node) =>
+    node.type === 'token' &&
+    node.tokenKind === CHAT_SYSTEM_OBJECT_TOKEN_KIND &&
+    node.tokenKey === reference.uri &&
+    readSystemObjectResolvedReference(node.data?.reference)?.version === reference.version
+  );
+  return exists
+    ? normalizeChatComposerNodes([...nodes])
+    : normalizeChatComposerNodes([...nodes, createSystemObjectReferenceTokenNode(reference)]);
+}
+
+export function readSystemObjectReferenceFromToken(
+  node: ChatComposerNode,
+): SystemObjectResolvedReference | null {
+  return node.type === 'token' && node.tokenKind === CHAT_SYSTEM_OBJECT_TOKEN_KIND
+    ? readSystemObjectResolvedReference(node.data?.reference)
+    : null;
+}

package/src/features/chat/features/message/hooks/use-chat-inline-token-actions.ts

@@ -2,10 +2,12 @@ import { useCallback } from "react";
 import type { ChatInlineTokenViewModel } from "@nextclaw/agent-chat-ui";
 import {
   CHAT_PROJECT_TOKEN_KIND,
+  CHAT_UI_RESOURCE_TOKEN_KIND,
   CHAT_WORKSPACE_EXCERPT_TOKEN_KIND,
 } from "@nextclaw/shared";
 import { toast } from "sonner";
 import { usePresenter } from "@/features/chat/components/providers/chat-presenter.provider";
+import { useAppPresenter } from "@/app/components/app-presenter-provider";
 import { resolveWorkspaceReferencePath } from "@/features/chat/features/input/utils/chat-inline-token.utils";
 import { fetchNcpSessionSkills } from "@/shared/lib/api";
 import { t } from "@/shared/lib/i18n";
@@ -21,9 +23,14 @@ export function useChatInlineTokenActions(params: {
 }) {
   const { selectedSession, sessionKey } = params;
   const presenter = usePresenter();
+  const appPresenter = useAppPresenter();
   const projectRoot = selectedSession?.projectRoot ?? selectedSession?.workingDir;
 
   const handleInlineTokenClick = useCallback((token: ChatInlineTokenViewModel) => {
+    if (token.kind === CHAT_UI_RESOURCE_TOKEN_KIND && "key" in token) {
+      appPresenter.docBrowserManager.open(token.key);
+      return;
+    }
     if (token.kind === "panel_app" && "key" in token) {
       void presenter.chatUiManager.showContent({
         target: { type: "panel_app", payload: { appId: token.key } },
@@ -98,7 +105,7 @@ export function useChatInlineTokenActions(params: {
         previewViewer: "rendered",
       });
     }).catch(() => toast.error(t("chatSkillPreviewUnavailable")));
-  }, [presenter, projectRoot, selectedSession?.projectRoot, sessionKey]);
+  }, [appPresenter.docBrowserManager, presenter, projectRoot, selectedSession?.projectRoot, sessionKey]);
 
   const handleAttachmentOpen = useCallback((file: {
     label: string;