@promptbook/cli 0.114.0-2 → 0.114.0-20

package/apps/agents-server/src/app/agents/[agentName]/book/BookEditorMissingReferences.tsx

@@ -1,6 +1,10 @@
 'use client';
 
+import Link from 'next/link';
+import { CORE_AGENTS_ADMIN_HREF } from '../../../../components/DefaultAgents/coreAgentsAdminRoute';
+import { ReinstateBundledAgentsButton } from '../../../../components/DefaultAgents/ReinstateBundledAgentsButton';
 import type { MissingAgentReference } from '../../../../utils/agentReferenceResolver/createUnresolvedAgentReferenceDiagnostics';
+import type { MissingCoreAgentRecovery } from '../../../../utils/agentReferenceResolver/MissingCoreAgentRecovery';
 
 /**
  * Props for `BookEditorMissingReferences`.
@@ -20,6 +24,10 @@ type BookEditorMissingReferencesProps = {
      * Handles creating one referenced agent.
      */
     readonly onCreateReferencedAgent: (reference: MissingAgentReference) => void;
+    /**
+     * Handles refreshing the panel once the missing core agents were reinstated.
+     */
+    readonly onCoreAgentsReinstated: () => void;
     /**
      * Additional classes applied to the root panel.
      */
@@ -35,6 +43,7 @@ export function BookEditorMissingReferences({
     missingAgentReferences,
     creatingReference,
     onCreateReferencedAgent,
+    onCoreAgentsReinstated,
     className,
 }: BookEditorMissingReferencesProps) {
     if (missingAgentReferences.length === 0) {
@@ -53,6 +62,7 @@ export function BookEditorMissingReferences({
                         member={reference}
                         isCreating={creatingReference === reference.reference}
                         onCreate={() => onCreateReferencedAgent(reference)}
+                        onCoreAgentsReinstated={onCoreAgentsReinstated}
                     />
                 ))}
             </div>
@@ -76,12 +86,24 @@ type MissingAgentReferenceCardProps = {
      * Invoked when the user wants to create the referenced agent.
      */
     readonly onCreate: () => void;
+    /**
+     * Invoked once the missing core agents were reinstated.
+     */
+    readonly onCoreAgentsReinstated: () => void;
 };
 
 /**
- * Renders one unresolved-agent card with a create action.
+ * Renders one unresolved-agent card with the action that can bring the agent back.
+ *
+ * An ordinary agent is created from scratch, while a bundled core agent is reinstated from its repository book, so
+ * the card offers whichever of the two actually applies.
  */
-function MissingAgentReferenceCard({ member, isCreating, onCreate }: MissingAgentReferenceCardProps) {
+function MissingAgentReferenceCard({
+    member,
+    isCreating,
+    onCreate,
+    onCoreAgentsReinstated,
+}: MissingAgentReferenceCardProps) {
     const displayToken = member.token || member.reference;
     const commitmentLabel = formatCommitmentLabel(member.commitmentType);
 
@@ -89,23 +111,95 @@ function MissingAgentReferenceCard({ member, isCreating, onCreate }: MissingAgen
         <div className="rounded-xl border border-slate-200 bg-slate-50/80 p-4 dark:border-slate-700 dark:bg-slate-900/88">
             <p className="text-sm text-slate-700 dark:text-slate-300">
                 Referenced agent <span className="font-semibold text-slate-900 dark:text-slate-100">{displayToken}</span>{' '}
-                is not found. Do you want to create it?
+                is not found.
+                {!member.coreAgentRecovery && ' Do you want to create it?'}
             </p>
             <p className="mt-1 text-xs uppercase tracking-wide text-slate-500 dark:text-slate-400">
-                Missing in the {commitmentLabel} commitment
+                {member.isImplicit
+                    ? `Implicitly inherited through ${commitmentLabel}`
+                    : `Missing in the ${commitmentLabel} commitment`}
             </p>
-            <button
-                type="button"
-                className="mt-3 inline-flex w-full items-center justify-center rounded-md bg-blue-600 px-3 py-2 text-sm font-semibold text-white transition hover:bg-blue-500 focus-visible:outline focus-visible:outline-2 focus-visible:outline-offset-2 focus-visible:outline-blue-600 disabled:cursor-not-allowed disabled:bg-slate-300 disabled:text-slate-100 disabled:opacity-70 dark:disabled:bg-slate-700 dark:disabled:text-slate-300"
-                onClick={onCreate}
-                disabled={isCreating}
-            >
-                {isCreating ? `Creating ${displayToken}...` : `Create ${displayToken}`}
-            </button>
+            {member.coreAgentRecovery ? (
+                <MissingCoreAgentRecoveryActions
+                    displayToken={displayToken}
+                    coreAgentRecovery={member.coreAgentRecovery}
+                    onCoreAgentsReinstated={onCoreAgentsReinstated}
+                />
+            ) : (
+                <button
+                    type="button"
+                    className="mt-3 inline-flex w-full items-center justify-center rounded-md bg-blue-600 px-3 py-2 text-sm font-semibold text-white transition hover:bg-blue-500 focus-visible:outline focus-visible:outline-2 focus-visible:outline-offset-2 focus-visible:outline-blue-600 disabled:cursor-not-allowed disabled:bg-slate-300 disabled:text-slate-100 disabled:opacity-70 dark:disabled:bg-slate-700 dark:disabled:text-slate-300"
+                    onClick={onCreate}
+                    disabled={isCreating}
+                >
+                    {isCreating ? `Creating ${displayToken}...` : `Create ${displayToken}`}
+                </button>
+            )}
         </div>
     );
 }
 
+/**
+ * Props for the core-agent recovery block of one missing-reference card.
+ */
+type MissingCoreAgentRecoveryActionsProps = {
+    /**
+     * Token of the missing core agent as shown in the card headline.
+     */
+    readonly displayToken: string;
+    /**
+     * Reinstatement offered for the missing core agents.
+     */
+    readonly coreAgentRecovery: MissingCoreAgentRecovery;
+    /**
+     * Invoked once the missing core agents were reinstated.
+     */
+    readonly onCoreAgentsReinstated: () => void;
+};
+
+/**
+ * Renders the reinstate action and the Core Agents page link for a missing bundled core agent.
+ *
+ * Reinstating always restores every missing core agent at once, so the block also names the other ones that are gone.
+ */
+function MissingCoreAgentRecoveryActions({
+    displayToken,
+    coreAgentRecovery,
+    onCoreAgentsReinstated,
+}: MissingCoreAgentRecoveryActionsProps) {
+    const { missingCoreAgentTitles, isReinstateAllowed } = coreAgentRecovery;
+
+    return (
+        <>
+            <p className="mt-2 text-sm text-slate-700 dark:text-slate-300">
+                {displayToken} is a core agent bundled with this server, so it is reinstated from its repository book
+                instead of being created from scratch.
+            </p>
+            {missingCoreAgentTitles.length > 1 && (
+                <p className="mt-1 text-sm text-slate-600 dark:text-slate-400">
+                    Missing core agents: {missingCoreAgentTitles.join(', ')}. Reinstating brings back all of them.
+                </p>
+            )}
+            {isReinstateAllowed && (
+                <ReinstateBundledAgentsButton
+                    scope="core"
+                    label="Reinstate core agents"
+                    pendingLabel="Reinstating…"
+                    confirmMessage="Recreate the missing core agents from the bundled repository books?"
+                    className="mt-3 inline-flex w-full items-center justify-center rounded-md bg-amber-600 px-3 py-2 text-sm font-semibold text-white transition hover:bg-amber-500 focus-visible:outline focus-visible:outline-2 focus-visible:outline-offset-2 focus-visible:outline-amber-600 disabled:cursor-not-allowed disabled:opacity-60"
+                    onReinstated={onCoreAgentsReinstated}
+                />
+            )}
+            <Link
+                href={CORE_AGENTS_ADMIN_HREF}
+                className="mt-3 inline-block text-sm font-medium text-blue-600 underline underline-offset-2 hover:text-blue-700 dark:text-blue-400"
+            >
+                Open Core Agents page
+            </Link>
+        </>
+    );
+}
+
 /**
  * Formats one commitment type into a human-readable label.
  */

package/apps/agents-server/src/app/agents/[agentName]/book/BookEditorWrapper.tsx

@@ -39,6 +39,7 @@ export function BookEditorWrapper({ agentName, initialAgentSource }: BookEditorW
         missingAgentReferences,
         creatingReference,
         handleCreateReferencedAgent,
+        handleCoreAgentsReinstated,
         historyPanelProps,
     } = useBookEditorWrapper({ agentName, initialAgentSource });
 
@@ -77,6 +78,7 @@ export function BookEditorWrapper({ agentName, initialAgentSource }: BookEditorW
                         missingAgentReferences={missingAgentReferences}
                         creatingReference={creatingReference}
                         onCreateReferencedAgent={handleCreateReferencedAgent}
+                        onCoreAgentsReinstated={handleCoreAgentsReinstated}
                     />
                 </div>
 
@@ -88,6 +90,7 @@ export function BookEditorWrapper({ agentName, initialAgentSource }: BookEditorW
                 missingAgentReferences={missingAgentReferences}
                 creatingReference={creatingReference}
                 onCreateReferencedAgent={handleCreateReferencedAgent}
+                onCoreAgentsReinstated={handleCoreAgentsReinstated}
             />
         </div>
     );

package/apps/agents-server/src/app/agents/[agentName]/book/useBookEditorDiagnostics.ts

@@ -234,6 +234,17 @@ export function useBookEditorDiagnostics({
         [agentName, agentSource, requestDiagnostics],
     );
 
+    /**
+     * Reloads diagnostics after the missing core agents were reinstated.
+     *
+     * The resolver is cached per server, so the refresh has to be forced for the reinstated agents to be visible.
+     *
+     * @private function of useBookEditorWrapper
+     */
+    const handleCoreAgentsReinstated = useCallback(() => {
+        void requestDiagnostics(agentSource, { forceRefresh: true });
+    }, [agentSource, requestDiagnostics]);
+
     useEffect(() => {
         void requestDiagnostics(initialAgentSource);
     }, [initialAgentSource, requestDiagnostics]);
@@ -257,5 +268,6 @@ export function useBookEditorDiagnostics({
         requestDiagnostics,
         scheduleDiagnostics,
         handleCreateReferencedAgent,
+        handleCoreAgentsReinstated,
     };
 }

package/apps/agents-server/src/app/agents/[agentName]/book/useBookEditorSaving.ts

@@ -1,5 +1,6 @@
 import type { string_book } from '@promptbook-local/types';
-import { useCallback, useEffect, useRef, useState } from 'react';
+import { debounce } from '@promptbook-local/utils';
+import { useCallback, useEffect, useMemo, useRef, useState } from 'react';
 import { resolveBookEditorApiErrorMessage } from './resolveBookEditorApiErrorMessage';
 
 /**
@@ -82,13 +83,6 @@ export function useBookEditorSaving({ agentName, initialAgentSource }: UseBookEd
     const [isSaveDebounced, setIsSaveDebounced] = useState(false);
     const [successfulSaveSequence, setSuccessfulSaveSequence] = useState(0);
 
-    /**
-     * Debounce timer ref so pending saves can be replaced before dispatch.
-     *
-     * @private function of useBookEditorWrapper
-     */
-    const debounceTimerRef = useRef<number | null>(null);
-
     /**
      * Stores the newest queued save request.
      *
@@ -175,6 +169,16 @@ export function useBookEditorSaving({ agentName, initialAgentSource }: UseBookEd
         [flushSaveQueue],
     );
 
+    /**
+     * Reuses the shared debounce utility while keeping source persistence separate from goal-chat notifications.
+     *
+     * @private function of useBookEditorWrapper
+     */
+    const debouncedEnqueueSave = useMemo(
+        () => debounce(enqueueSave, SAVE_DEBOUNCE_DELAY_MS),
+        [enqueueSave],
+    );
+
     /**
      * Schedules one autosave after the debounce delay.
      *
@@ -182,19 +186,12 @@ export function useBookEditorSaving({ agentName, initialAgentSource }: UseBookEd
      */
     const scheduleSave = useCallback(
         (nextSource: string_book, version: number) => {
-            if (debounceTimerRef.current) {
-                clearTimeout(debounceTimerRef.current);
-            }
-
             setIsSaveDebounced(true);
             setSaveStatus('pending');
 
-            debounceTimerRef.current = window.setTimeout(() => {
-                debounceTimerRef.current = null;
-                enqueueSave(nextSource, version, null);
-            }, SAVE_DEBOUNCE_DELAY_MS);
+            debouncedEnqueueSave(nextSource, version, null);
         },
-        [enqueueSave],
+        [debouncedEnqueueSave],
     );
 
     /**
@@ -218,14 +215,10 @@ export function useBookEditorSaving({ agentName, initialAgentSource }: UseBookEd
      * @private function of useBookEditorWrapper
      */
     const cancelPendingSave = useCallback(() => {
-        if (debounceTimerRef.current) {
-            clearTimeout(debounceTimerRef.current);
-            debounceTimerRef.current = null;
-        }
-
+        debouncedEnqueueSave.cancel();
         pendingSaveRef.current = null;
         setIsSaveDebounced(false);
-    }, []);
+    }, [debouncedEnqueueSave]);
 
     /**
      * Retries saving the current editor content immediately.
@@ -297,11 +290,9 @@ export function useBookEditorSaving({ agentName, initialAgentSource }: UseBookEd
      */
     useEffect(() => {
         return () => {
-            if (debounceTimerRef.current) {
-                clearTimeout(debounceTimerRef.current);
-            }
+            debouncedEnqueueSave.cancel();
         };
-    }, []);
+    }, [debouncedEnqueueSave]);
 
     /**
      * Indicates whether the latest local source revision is already confirmed on the server.
@@ -329,5 +320,4 @@ export function useBookEditorSaving({ agentName, initialAgentSource }: UseBookEd
     };
 }
 
-// TODO: Prompt: Use `import { debounce } from '@promptbook-local/utils';` instead of custom debounce implementation
 // TODO: [🚗] Transfer the saving logic to `<BookEditor/>` be aware of CRDT / yjs approach to be implementable in future

package/apps/agents-server/src/app/agents/[agentName]/book/useBookEditorWrapper.tsx

@@ -113,6 +113,7 @@ export function useBookEditorWrapper({ agentName, initialAgentSource }: UseBookE
         requestDiagnostics,
         scheduleDiagnostics,
         handleCreateReferencedAgent,
+        handleCoreAgentsReinstated,
     } = useBookEditorDiagnostics({
         agentName,
         initialAgentSource,
@@ -212,6 +213,7 @@ export function useBookEditorWrapper({ agentName, initialAgentSource }: UseBookE
         missingAgentReferences,
         creatingReference,
         handleCreateReferencedAgent,
+        handleCoreAgentsReinstated,
         historyPanelProps,
     };
 }

package/apps/agents-server/src/app/agents/[agentName]/chat/AgentChatHistoryClient.tsx

@@ -9,7 +9,10 @@ import { AgentChatPageLayout } from './AgentChatPageLayout';
 import { AgentChatSidebar } from './AgentChatSidebar';
 import { CanonicalAgentChatPanel } from './CanonicalAgentChatPanel';
 import { ExternalUserChatAdminActions } from './ExternalUserChatAdminActions';
+import { TeamMemberFrozenChatPrimaryAgentLink } from './TeamMemberFrozenChatPrimaryAgentLink';
 import { type AgentChatHistoryClientProps, useAgentChatHistoryClientState } from './useAgentChatHistoryClientState';
+import { getTeamMemberUserChatContext } from '../../../../utils/userChat/teamMemberUserChatContext';
+import { USER_CHAT_SOURCES } from '../../../../utils/userChat/UserChatSource';
 
 /**
  * One user-authored chat turn submitted from the canonical chat panel.
@@ -343,15 +346,29 @@ function AgentChatHistoryReadyView(props: AgentChatHistoryReadyViewProps) {
         onAutoExecuteMessageConsumed,
     } = props;
     const isActiveExternalUserChat = activeChatSummary?.isExternalUserChat === true;
+    const teamMemberUserChatContext =
+        activeChatSummary?.source === USER_CHAT_SOURCES.TEAM_MEMBER
+            ? getTeamMemberUserChatContext(renderedActiveMessages)
+            : null;
     const externalUserChatAdminActions =
         isCurrentUserSuperAdmin === true && isActiveExternalUserChat ? (
             <ExternalUserChatAdminActions
                 agentName={agentName}
                 chatId={activeChatId}
+                userId={activeChatSummary?.userId}
                 chatTitle={activeChatSummary?.title || 'Recorded chat'}
                 messages={renderedActiveMessages}
             />
         ) : undefined;
+    const readOnlyExtraActions =
+        teamMemberUserChatContext || externalUserChatAdminActions ? (
+            <>
+                {teamMemberUserChatContext && (
+                    <TeamMemberFrozenChatPrimaryAgentLink context={teamMemberUserChatContext} />
+                )}
+                {externalUserChatAdminActions}
+            </>
+        ) : undefined;
     const chatSurface = (
         <div className="relative flex min-h-0 flex-1 overflow-hidden">
             {isActiveChatLoading ? (
@@ -372,7 +389,8 @@ function AgentChatHistoryReadyView(props: AgentChatHistoryReadyViewProps) {
                     isReadOnly={isActiveChatReadOnly}
                     readOnlySource={activeChatSummary?.source}
                     isExternalUserChat={isActiveExternalUserChat}
-                    readOnlyExtraActions={externalUserChatAdminActions}
+                    isAgentGoalChat={activeChatSummary?.isAgentGoalChat === true}
+                    readOnlyExtraActions={readOnlyExtraActions}
                     projectReferences={projectReferences}
                     messages={renderedActiveMessages}
                     draftMessage={isActiveChatReadOnly ? '' : activeChatDraftMessage}

package/apps/agents-server/src/app/agents/[agentName]/chat/AgentChatSidebarDefault.tsx

@@ -1,4 +1,4 @@
-import { EyeIcon, EyeOffIcon, MessageSquarePlusIcon, Trash2Icon, XIcon } from 'lucide-react';
+import { EyeIcon, EyeOffIcon, MessageSquarePlusIcon, TargetIcon, Trash2Icon, XIcon } from 'lucide-react';
 import { SolidArrowButton } from '../../../../../../../src/book-components/icons/SolidArrowButton';
 import { ChatListLoadingSkeleton } from '../../../../components/Skeleton/ChatListLoadingSkeleton';
 import { AgentChatSidebarActivityIndicator } from './AgentChatSidebarActivityIndicator';
@@ -189,10 +189,16 @@ function AgentChatSidebarDefaultCollapsedRow({ item, onChatSelect }: AgentChatSi
             <span className="absolute left-1.5 top-1.5 z-[5]">
                 <AgentChatSidebarActivityIndicator indicator={item.content.activityIndicator} />
             </span>
-            {item.content.sourceChipLabel && (
-                <span className="absolute left-1.5 bottom-1.5 z-[5] inline-flex items-center rounded-full bg-slate-900/85 px-1.5 py-0.5 text-[8px] font-bold uppercase tracking-[0.18em] text-white shadow-sm">
-                    {item.content.sourceChipLabel}
+            {item.isAgentGoalChat ? (
+                <span className="absolute left-1.5 bottom-1.5 z-[5] inline-flex items-center justify-center rounded-full bg-indigo-600 p-1 text-white shadow-sm">
+                    <TargetIcon className="h-2.5 w-2.5" aria-hidden />
                 </span>
+            ) : (
+                item.content.sourceChipLabel && (
+                    <span className="absolute left-1.5 bottom-1.5 z-[5] inline-flex items-center rounded-full bg-slate-900/85 px-1.5 py-0.5 text-[8px] font-bold uppercase tracking-[0.18em] text-white shadow-sm">
+                        {item.content.sourceChipLabel}
+                    </span>
+                )
             )}
             <span
                 className={`absolute right-0.5 top-0.5 z-[5] inline-flex h-4 min-w-4 items-center justify-center rounded-full px-1 text-[9px] font-bold leading-none shadow-sm ${
@@ -255,10 +261,16 @@ function AgentChatSidebarDefaultExpandedRow({
                 title={item.content.accessibilityLabel}
             >
                 <div className="flex items-center gap-2">
+                    {item.isAgentGoalChat && (
+                        <TargetIcon
+                            className="h-4 w-4 flex-shrink-0 text-indigo-600 dark:text-indigo-300"
+                            aria-hidden
+                        />
+                    )}
                     <div className="agent-chat-sidebar-item-title min-w-0 flex-1 truncate text-sm font-medium text-slate-800 dark:text-slate-100">
                         {item.content.title}
                     </div>
-                    {item.content.sourceChipLabel && (
+                    {!item.isAgentGoalChat && item.content.sourceChipLabel && (
                         <span className="inline-flex flex-shrink-0 items-center rounded-full bg-slate-900 px-2 py-1 text-[10px] font-bold uppercase tracking-[0.18em] text-white">
                             {item.content.sourceChipLabel}
                         </span>

package/apps/agents-server/src/app/agents/[agentName]/chat/AgentGoalChatNotice.tsx

@@ -0,0 +1,23 @@
+'use client';
+
+import { TargetIcon } from 'lucide-react';
+import { useServerLanguage } from '../../../../components/ServerLanguage/ServerLanguageProvider';
+
+/**
+ * Explains what makes the agent goal chat different from a normal conversation.
+ *
+ * @private Agents Server presentation logic for the agent goal chat.
+ */
+export function AgentGoalChatNotice() {
+    const { t: translateText } = useServerLanguage();
+
+    return (
+        <div className="mx-4 mt-4 flex items-start gap-3 rounded-2xl border border-indigo-200 bg-indigo-50/95 px-4 py-3 text-sm text-indigo-900 shadow-sm dark:border-indigo-500/30 dark:bg-indigo-500/10 dark:text-indigo-100">
+            <TargetIcon className="mt-0.5 h-4 w-4 flex-shrink-0" aria-hidden />
+            <div>
+                <div className="font-semibold">{translateText('goalChat.noticeTitle')}</div>
+                <p className="mt-1">{translateText('goalChat.noticeDescription')}</p>
+            </div>
+        </div>
+    );
+}