@dudousxd/nestjs-agent-react 0.1.0 → 0.3.0

package/dist/index.d.cts

@@ -1,6 +1,7 @@
 import * as ai from 'ai';
 import { ChatTransport, UIMessage, UIMessageChunk, ToolUIPart, DynamicToolUIPart } from 'ai';
-import { ThreadSummary, ThreadDetail, Persona } from '@dudousxd/nestjs-agent-core';
+import * as _dudousxd_nestjs_agent_core from '@dudousxd/nestjs-agent-core';
+import { ThreadSummary, ThreadDetail, QuotaView } from '@dudousxd/nestjs-agent-core';
 import * as react_jsx_runtime from 'react/jsx-runtime';
 import React from 'react';
 
@@ -28,9 +29,9 @@ interface AgentChatTransportOptions {
     /** Named agent to run the turn (backend `agent` field). */
     agent?: string;
     /**
-     * Extra body fields evaluated per send — the hook injects `threadId`,
-     * `persona`, and `pageContext` through this. Returned object is spread
-     * into the request body after the SDK's own `body`.
+     * Extra body fields evaluated per send — the hook injects `threadId`
+     * and `pageContext` through this. Returned object is spread into the
+     * request body after the SDK's own `body`.
      */
     getBody?: () => Record<string, unknown>;
     /**
@@ -81,8 +82,6 @@ declare class AgentChatTransport implements ChatTransport<UIMessage> {
     private toChunkStream;
 }
 
-/** The trimmed persona shape returned by `/agent/threads/personas/catalog`. */
-type PersonaCatalogEntry = Pick<Persona, 'id' | 'label'>;
 /**
  * Thrown by {@link AgentClient} on a non-2xx response. Carries the HTTP `status` so callers can
  * branch (e.g. 403 → "not your thread", 429 → quota) instead of string-matching a generic Error.
@@ -93,12 +92,14 @@ declare class AgentHttpError extends Error {
     readonly path: string;
     constructor(status: number, method: string, path: string, statusText: string);
 }
-interface QuotaToday {
-    usedTokens: number;
-}
+/** The quota-today read-model: usage, the configured limit (null → unlimited), and USD spend. */
+type QuotaToday = QuotaView;
 interface CancelResult {
     aborted: boolean;
 }
+interface OkResult {
+    ok: boolean;
+}
 interface AgentClientOptions {
     /** Origin + base path, e.g. `https://api.example.com`. Defaults to `''`. */
     baseUrl?: string;
@@ -122,7 +123,9 @@ declare class AgentClient {
     getThread(id: string): Promise<ThreadDetail>;
     deleteThread(id: string): Promise<void>;
     forkFromMessage(threadId: string, messageId: string): Promise<ThreadSummary>;
-    getPersonaCatalog(): Promise<PersonaCatalogEntry[]>;
+    renameThread(id: string, title: string): Promise<OkResult>;
+    promoteThread(id: string): Promise<OkResult>;
+    truncateFromMessage(threadId: string, messageId: string): Promise<OkResult>;
     getQuotaToday(): Promise<QuotaToday>;
     cancelStream(runId: string): Promise<CancelResult>;
     approveToolCall(input: {
@@ -160,8 +163,6 @@ interface UseAgentChatOptions {
      * mount (no id) never fires a doomed resume GET. Omitted → no resume.
      */
     resumeRunId?: string;
-    /** Active persona id sent on every turn. */
-    persona?: string;
     /** Read at every send to capture a page snapshot for the page-assistant. */
     getPageContext?: () => Record<string, unknown> | null;
     /** Fired after each streamed turn finishes (e.g. to refetch the sidebar). */
@@ -175,8 +176,8 @@ interface AddToolResultArgs {
 /**
  * Generalized `useChat` wiring for the nestjs-agent backend. Wraps the
  * AI SDK v7 hook with `AgentChatTransport`, plus thread list/load/delete/
- * fork, persona catalog, quota, cancel, and HITL approve/reject — all
- * driven through `AgentClient`. Mirrors flip's `useAdminChat`, generalized.
+ * fork, quota, cancel, and HITL approve/reject — all driven through
+ * `AgentClient`. Mirrors flip's `useAdminChat`, generalized.
  */
 declare function useAgentChat(options: UseAgentChatOptions): {
     addToolResult: ({ tool, toolCallId, output }: AddToolResultArgs) => void | PromiseLike<void>;
@@ -187,9 +188,10 @@ declare function useAgentChat(options: UseAgentChatOptions): {
     loadThread: (id: string) => Promise<ThreadDetail>;
     deleteThread: (id: string) => Promise<void>;
     forkThread: (threadId: string, messageId: string) => Promise<ThreadSummary>;
-    personaCatalog: PersonaCatalogEntry[];
-    loadPersonaCatalog: () => Promise<PersonaCatalogEntry[]>;
-    quota: QuotaToday | null;
+    renameThread: (id: string, title: string) => Promise<void>;
+    promoteThread: (id: string) => Promise<void>;
+    truncateFromMessage: (threadId: string, messageId: string) => Promise<void>;
+    quota: _dudousxd_nestjs_agent_core.QuotaView | null;
     loadQuota: () => Promise<QuotaToday>;
     cancel: () => Promise<void>;
     approve: ({ toolCallId }: {
@@ -416,4 +418,4 @@ interface SpeechRecognitionHook {
  */
 declare function useSpeechRecognition({ lang, onFinalTranscript, onInterimTranscript, }: UseSpeechRecognitionOptions): SpeechRecognitionHook;
 
-export { AgentChatTransport, type AgentChatTransportOptions, AgentClient, type AgentClientOptions, AgentHttpError, type AgentStreamMeta, type AnyToolUIPart, type CancelResult, ChatInput, type ChatInputProps, type ChatStatus, DEFAULT_SPEECH_LANG, MessageItem, type MessageItemClassNames, type MessageItemProps, MessageList, type MessageListClassNames, type MessageListProps, type MessageUsageInfo, type PersonaCatalogEntry, type QuotaToday, type RenderTextFn, type RenderToolGroupFn, type RenderToolPartFn, SPEECH_LANGUAGES, type SpeechLanguage, type SpeechRecognitionHook, type UseAgentChatOptions, type UseSpeechRecognitionOptions, formatRelativeTime, loadStoredSpeechLang, persistSpeechLang, useAgentChat, useSpeechRecognition };
+export { AgentChatTransport, type AgentChatTransportOptions, AgentClient, type AgentClientOptions, AgentHttpError, type AgentStreamMeta, type AnyToolUIPart, type CancelResult, ChatInput, type ChatInputProps, type ChatStatus, DEFAULT_SPEECH_LANG, MessageItem, type MessageItemClassNames, type MessageItemProps, MessageList, type MessageListClassNames, type MessageListProps, type MessageUsageInfo, type QuotaToday, type RenderTextFn, type RenderToolGroupFn, type RenderToolPartFn, SPEECH_LANGUAGES, type SpeechLanguage, type SpeechRecognitionHook, type UseAgentChatOptions, type UseSpeechRecognitionOptions, formatRelativeTime, loadStoredSpeechLang, persistSpeechLang, useAgentChat, useSpeechRecognition };

package/dist/index.d.ts

@@ -1,6 +1,7 @@
 import * as ai from 'ai';
 import { ChatTransport, UIMessage, UIMessageChunk, ToolUIPart, DynamicToolUIPart } from 'ai';
-import { ThreadSummary, ThreadDetail, Persona } from '@dudousxd/nestjs-agent-core';
+import * as _dudousxd_nestjs_agent_core from '@dudousxd/nestjs-agent-core';
+import { ThreadSummary, ThreadDetail, QuotaView } from '@dudousxd/nestjs-agent-core';
 import * as react_jsx_runtime from 'react/jsx-runtime';
 import React from 'react';
 
@@ -28,9 +29,9 @@ interface AgentChatTransportOptions {
     /** Named agent to run the turn (backend `agent` field). */
     agent?: string;
     /**
-     * Extra body fields evaluated per send — the hook injects `threadId`,
-     * `persona`, and `pageContext` through this. Returned object is spread
-     * into the request body after the SDK's own `body`.
+     * Extra body fields evaluated per send — the hook injects `threadId`
+     * and `pageContext` through this. Returned object is spread into the
+     * request body after the SDK's own `body`.
      */
     getBody?: () => Record<string, unknown>;
     /**
@@ -81,8 +82,6 @@ declare class AgentChatTransport implements ChatTransport<UIMessage> {
     private toChunkStream;
 }
 
-/** The trimmed persona shape returned by `/agent/threads/personas/catalog`. */
-type PersonaCatalogEntry = Pick<Persona, 'id' | 'label'>;
 /**
  * Thrown by {@link AgentClient} on a non-2xx response. Carries the HTTP `status` so callers can
  * branch (e.g. 403 → "not your thread", 429 → quota) instead of string-matching a generic Error.
@@ -93,12 +92,14 @@ declare class AgentHttpError extends Error {
     readonly path: string;
     constructor(status: number, method: string, path: string, statusText: string);
 }
-interface QuotaToday {
-    usedTokens: number;
-}
+/** The quota-today read-model: usage, the configured limit (null → unlimited), and USD spend. */
+type QuotaToday = QuotaView;
 interface CancelResult {
     aborted: boolean;
 }
+interface OkResult {
+    ok: boolean;
+}
 interface AgentClientOptions {
     /** Origin + base path, e.g. `https://api.example.com`. Defaults to `''`. */
     baseUrl?: string;
@@ -122,7 +123,9 @@ declare class AgentClient {
     getThread(id: string): Promise<ThreadDetail>;
     deleteThread(id: string): Promise<void>;
     forkFromMessage(threadId: string, messageId: string): Promise<ThreadSummary>;
-    getPersonaCatalog(): Promise<PersonaCatalogEntry[]>;
+    renameThread(id: string, title: string): Promise<OkResult>;
+    promoteThread(id: string): Promise<OkResult>;
+    truncateFromMessage(threadId: string, messageId: string): Promise<OkResult>;
     getQuotaToday(): Promise<QuotaToday>;
     cancelStream(runId: string): Promise<CancelResult>;
     approveToolCall(input: {
@@ -160,8 +163,6 @@ interface UseAgentChatOptions {
      * mount (no id) never fires a doomed resume GET. Omitted → no resume.
      */
     resumeRunId?: string;
-    /** Active persona id sent on every turn. */
-    persona?: string;
     /** Read at every send to capture a page snapshot for the page-assistant. */
     getPageContext?: () => Record<string, unknown> | null;
     /** Fired after each streamed turn finishes (e.g. to refetch the sidebar). */
@@ -175,8 +176,8 @@ interface AddToolResultArgs {
 /**
  * Generalized `useChat` wiring for the nestjs-agent backend. Wraps the
  * AI SDK v7 hook with `AgentChatTransport`, plus thread list/load/delete/
- * fork, persona catalog, quota, cancel, and HITL approve/reject — all
- * driven through `AgentClient`. Mirrors flip's `useAdminChat`, generalized.
+ * fork, quota, cancel, and HITL approve/reject — all driven through
+ * `AgentClient`. Mirrors flip's `useAdminChat`, generalized.
  */
 declare function useAgentChat(options: UseAgentChatOptions): {
     addToolResult: ({ tool, toolCallId, output }: AddToolResultArgs) => void | PromiseLike<void>;
@@ -187,9 +188,10 @@ declare function useAgentChat(options: UseAgentChatOptions): {
     loadThread: (id: string) => Promise<ThreadDetail>;
     deleteThread: (id: string) => Promise<void>;
     forkThread: (threadId: string, messageId: string) => Promise<ThreadSummary>;
-    personaCatalog: PersonaCatalogEntry[];
-    loadPersonaCatalog: () => Promise<PersonaCatalogEntry[]>;
-    quota: QuotaToday | null;
+    renameThread: (id: string, title: string) => Promise<void>;
+    promoteThread: (id: string) => Promise<void>;
+    truncateFromMessage: (threadId: string, messageId: string) => Promise<void>;
+    quota: _dudousxd_nestjs_agent_core.QuotaView | null;
     loadQuota: () => Promise<QuotaToday>;
     cancel: () => Promise<void>;
     approve: ({ toolCallId }: {
@@ -416,4 +418,4 @@ interface SpeechRecognitionHook {
  */
 declare function useSpeechRecognition({ lang, onFinalTranscript, onInterimTranscript, }: UseSpeechRecognitionOptions): SpeechRecognitionHook;
 
-export { AgentChatTransport, type AgentChatTransportOptions, AgentClient, type AgentClientOptions, AgentHttpError, type AgentStreamMeta, type AnyToolUIPart, type CancelResult, ChatInput, type ChatInputProps, type ChatStatus, DEFAULT_SPEECH_LANG, MessageItem, type MessageItemClassNames, type MessageItemProps, MessageList, type MessageListClassNames, type MessageListProps, type MessageUsageInfo, type PersonaCatalogEntry, type QuotaToday, type RenderTextFn, type RenderToolGroupFn, type RenderToolPartFn, SPEECH_LANGUAGES, type SpeechLanguage, type SpeechRecognitionHook, type UseAgentChatOptions, type UseSpeechRecognitionOptions, formatRelativeTime, loadStoredSpeechLang, persistSpeechLang, useAgentChat, useSpeechRecognition };
+export { AgentChatTransport, type AgentChatTransportOptions, AgentClient, type AgentClientOptions, AgentHttpError, type AgentStreamMeta, type AnyToolUIPart, type CancelResult, ChatInput, type ChatInputProps, type ChatStatus, DEFAULT_SPEECH_LANG, MessageItem, type MessageItemClassNames, type MessageItemProps, MessageList, type MessageListClassNames, type MessageListProps, type MessageUsageInfo, type QuotaToday, type RenderTextFn, type RenderToolGroupFn, type RenderToolPartFn, SPEECH_LANGUAGES, type SpeechLanguage, type SpeechRecognitionHook, type UseAgentChatOptions, type UseSpeechRecognitionOptions, formatRelativeTime, loadStoredSpeechLang, persistSpeechLang, useAgentChat, useSpeechRecognition };

package/dist/index.js

@@ -301,8 +301,16 @@ var AgentClient = class {
   forkFromMessage(threadId, messageId) {
     return this.request("POST", `/agent/threads/${encodeURIComponent(threadId)}/fork-from/${encodeURIComponent(messageId)}`);
   }
-  getPersonaCatalog() {
-    return this.request("GET", "/agent/threads/personas/catalog");
+  renameThread(id, title) {
+    return this.request("PATCH", `/agent/threads/${encodeURIComponent(id)}`, {
+      title
+    });
+  }
+  promoteThread(id) {
+    return this.request("POST", `/agent/threads/${encodeURIComponent(id)}/promote`);
+  }
+  truncateFromMessage(threadId, messageId) {
+    return this.request("DELETE", `/agent/threads/${encodeURIComponent(threadId)}/from/${encodeURIComponent(messageId)}`);
   }
   getQuotaToday() {
     return this.request("GET", "/agent/quota/today");
@@ -400,9 +408,6 @@ function useAgentChat(options) {
           ...current.threadId !== void 0 ? {
             threadId: current.threadId
           } : {},
-          ...current.persona !== void 0 ? {
-            persona: current.persona
-          } : {},
           ...pageContext ? {
             pageContext
           } : {},
@@ -436,7 +441,6 @@ function useAgentChat(options) {
     output
   }), []);
   const [threads, setThreads] = useState([]);
-  const [personaCatalog, setPersonaCatalog] = useState([]);
   const [quota, setQuota] = useState(null);
   const loadThreads = useCallback(async () => {
     const list = await client.listThreads();
@@ -457,13 +461,25 @@ function useAgentChat(options) {
   const forkThread = useCallback((threadId, messageId) => client.forkFromMessage(threadId, messageId), [
     client
   ]);
-  const loadPersonaCatalog = useCallback(async () => {
-    const catalog = await client.getPersonaCatalog();
-    setPersonaCatalog(catalog);
-    return catalog;
+  const renameThread = useCallback(async (id, title) => {
+    await client.renameThread(id, title);
+    setThreads((current) => current.map((thread) => thread.id === id ? {
+      ...thread,
+      title
+    } : thread));
   }, [
     client
   ]);
+  const promoteThread = useCallback(async (id) => {
+    await client.promoteThread(id);
+    await loadThreads();
+  }, [
+    client,
+    loadThreads
+  ]);
+  const truncateFromMessage = useCallback((threadId, messageId) => client.truncateFromMessage(threadId, messageId).then(() => void 0), [
+    client
+  ]);
   const loadQuota = useCallback(async () => {
     const today = await client.getQuotaToday();
     setQuota(today);
@@ -514,8 +530,9 @@ function useAgentChat(options) {
     loadThread,
     deleteThread,
     forkThread,
-    personaCatalog,
-    loadPersonaCatalog,
+    renameThread,
+    promoteThread,
+    truncateFromMessage,
     quota,
     loadQuota,
     cancel,