@promptbook/cli 0.114.0-4 → 0.114.0-6

package/src/book-3.0/AgentTeamConversationWorkspace.ts

@@ -0,0 +1,172 @@
+import { basename, join } from 'path';
+import { AGENT_FINISHED_MESSAGES_DIRECTORY_PATH, AGENT_MESSAGES_DIRECTORY_PATH } from './agentFolderPaths';
+
+// Note: [💞] This file defines the shared TEAM workspace convention rather than one standalone entity.
+
+/**
+ * Relative directory for an active TEAM conversation workspace.
+ *
+ * @private internal convention shared by the Agents Server and agent-folder runner
+ */
+export const AGENT_TEAM_CONVERSATIONS_DIRECTORY_PATH = join(AGENT_MESSAGES_DIRECTORY_PATH, 'team');
+
+/**
+ * Relative directory where completed TEAM conversation transcripts are retained.
+ *
+ * @private internal convention shared by the Agents Server and agent-folder runner
+ */
+export const AGENT_FINISHED_TEAM_CONVERSATIONS_DIRECTORY_PATH = join(AGENT_FINISHED_MESSAGES_DIRECTORY_PATH, 'team');
+
+/**
+ * Name of the JSON manifest that describes one TEAM conversation workspace.
+ *
+ * @private internal convention shared by the Agents Server and agent-folder runner
+ */
+export const AGENT_TEAM_CONVERSATION_MANIFEST_FILE_NAME = 'team.json';
+
+/**
+ * Name of the read-only teammate-source directory inside one TEAM workspace.
+ *
+ * @private internal convention shared by the Agents Server and agent-folder runner
+ */
+export const AGENT_TEAMMATE_SOURCES_DIRECTORY_NAME = 'teammates';
+
+/**
+ * One primary agent represented in a TEAM workspace manifest.
+ *
+ * @private internal convention shared by the Agents Server and agent-folder runner
+ */
+export type AgentTeamConversationPrimaryAgent = {
+    readonly permanentId: string;
+    readonly agentName: string;
+};
+
+/**
+ * One local teammate made available to the coding harness for a single user turn.
+ *
+ * @private internal convention shared by the Agents Server and agent-folder runner
+ */
+export type AgentTeamConversationTeammate = {
+    readonly permanentId: string;
+    readonly agentName: string;
+    readonly url: string;
+    readonly instructions: string;
+    readonly sourceFileName: string;
+};
+
+/**
+ * Persisted roster snapshot for the optional TEAM workspace of one queued message.
+ *
+ * @private internal convention shared by the Agents Server and agent-folder runner
+ */
+export type AgentTeamConversationWorkspaceManifest = {
+    readonly version: 1;
+    readonly primaryAgent: AgentTeamConversationPrimaryAgent;
+    readonly teammates: ReadonlyArray<AgentTeamConversationTeammate>;
+};
+
+/**
+ * Creates the stable directory name that belongs to one queued `.book` message.
+ *
+ * @private internal convention shared by the Agents Server and agent-folder runner
+ */
+export function createAgentTeamConversationWorkspaceDirectoryName(messageFileName: string): string {
+    const rawBaseName = basename(messageFileName).replace(/\.book$/iu, '');
+    const normalizedBaseName = rawBaseName.replace(/[^A-Za-z0-9._-]+/gu, '-').replace(/^[._-]+|[._-]+$/gu, '');
+
+    return normalizedBaseName || 'message';
+}
+
+/**
+ * Creates the relative active workspace path for one queued message.
+ *
+ * @private internal convention shared by the Agents Server and agent-folder runner
+ */
+export function createAgentTeamConversationWorkspacePath(messageFileName: string): string {
+    return join(
+        AGENT_TEAM_CONVERSATIONS_DIRECTORY_PATH,
+        createAgentTeamConversationWorkspaceDirectoryName(messageFileName),
+    );
+}
+
+/**
+ * Creates the relative completed-workspace path for one queued message.
+ *
+ * @private internal convention shared by the Agents Server and agent-folder runner
+ */
+export function createFinishedAgentTeamConversationWorkspacePath(messageFileName: string): string {
+    return join(
+        AGENT_FINISHED_TEAM_CONVERSATIONS_DIRECTORY_PATH,
+        createAgentTeamConversationWorkspaceDirectoryName(messageFileName),
+    );
+}
+
+/**
+ * Creates the source-snapshot file name for one teammate.
+ *
+ * @private internal convention shared by the Agents Server and agent-folder runner
+ */
+export function createAgentTeamTeammateSourceFileName(teammatePermanentId: string): string {
+    const normalizedPermanentId = teammatePermanentId
+        .trim()
+        .replace(/[^A-Za-z0-9._-]+/gu, '-')
+        .replace(/^[._-]+|[._-]+$/gu, '');
+
+    return `${normalizedPermanentId || 'teammate'}.book`;
+}
+
+/**
+ * Checks whether unknown JSON has the minimum shape required for a TEAM workspace manifest.
+ *
+ * @private internal convention shared by the Agents Server and agent-folder runner
+ */
+export function isAgentTeamConversationWorkspaceManifest(
+    value: unknown,
+): value is AgentTeamConversationWorkspaceManifest {
+    if (!value || typeof value !== 'object') {
+        return false;
+    }
+
+    const manifest = value as Partial<AgentTeamConversationWorkspaceManifest>;
+    if (
+        manifest.version !== 1 ||
+        !isPrimaryAgent(manifest.primaryAgent) ||
+        !Array.isArray(manifest.teammates) ||
+        !manifest.teammates.every(isTeammate)
+    ) {
+        return false;
+    }
+
+    return true;
+}
+
+/**
+ * Checks the primary-agent part of an untrusted manifest.
+ *
+ * @private internal utility of `isAgentTeamConversationWorkspaceManifest`
+ */
+function isPrimaryAgent(value: unknown): value is AgentTeamConversationPrimaryAgent {
+    return Boolean(
+        value &&
+            typeof value === 'object' &&
+            typeof (value as AgentTeamConversationPrimaryAgent).permanentId === 'string' &&
+            typeof (value as AgentTeamConversationPrimaryAgent).agentName === 'string',
+    );
+}
+
+/**
+ * Checks one teammate part of an untrusted manifest.
+ *
+ * @private internal utility of `isAgentTeamConversationWorkspaceManifest`
+ */
+function isTeammate(value: unknown): value is AgentTeamConversationTeammate {
+    return Boolean(
+        value &&
+            typeof value === 'object' &&
+            typeof (value as AgentTeamConversationTeammate).permanentId === 'string' &&
+            typeof (value as AgentTeamConversationTeammate).agentName === 'string' &&
+            typeof (value as AgentTeamConversationTeammate).url === 'string' &&
+            typeof (value as AgentTeamConversationTeammate).instructions === 'string' &&
+            typeof (value as AgentTeamConversationTeammate).sourceFileName === 'string',
+    );
+}

package/src/book-components/BookEditor/useBookEditorMonacoStyles.ts

@@ -1,3 +1,4 @@
+import { spaceTrim } from 'spacetrim';
 import { useEffect } from 'react';
 import { PROMPTBOOK_SYNTAX_COLORS } from '../../config';
 import type { BookEditorTheme } from './BookEditorTheme';
@@ -48,66 +49,66 @@ export function useBookEditorMonacoStyles({
             document.head.appendChild(style);
         }
 
-        style.innerHTML = `
+        style.innerHTML = spaceTrim(`
 
-            @import url('https://fonts.googleapis.com/css2?family=Bitcount+Grid+Single:wght@100..900&family=Playfair+Display:ital,wght@0,400..900;1,400..900&display=swap');
-            /* <- [🚚] */
+                @import url('https://fonts.googleapis.com/css2?family=Bitcount+Grid+Single:wght@100..900&family=Playfair+Display:ital,wght@0,400..900;1,400..900&display=swap');
+                /* <- [🚚] */
 
-            .${instanceClass} .monaco-editor .view-lines {
-                background-image: linear-gradient(to bottom, transparent ${scaledLineHeight - 1}px, ${lineColor} ${
+                .${instanceClass} .monaco-editor .view-lines {
+                    background-image: linear-gradient(to bottom, transparent ${scaledLineHeight - 1}px, ${lineColor} ${
             scaledLineHeight - 1
         }px);
-                background-size: calc(100% + ${scaledContentPaddingLeft}px) ${scaledLineHeight}px;
-                background-position-x: -${scaledContentPaddingLeft}px;
-                background-position-y: ${scaledLineHeight * BACKGROUND_POSITION_Y_MULTIPLIER}px;
-            }
-            .${instanceClass} .monaco-editor .overflow-guard::before {
-                content: '';
-                position: absolute;
-                left: ${scaledVerticalLineLeft}px;
-                top: 0;
-                bottom: 0;
-                width: 1px;
-                background-color: ${lineColor};
-                z-index: 10;
-            }
+                    background-size: calc(100% + ${scaledContentPaddingLeft}px) ${scaledLineHeight}px;
+                    background-position-x: -${scaledContentPaddingLeft}px;
+                    background-position-y: ${scaledLineHeight * BACKGROUND_POSITION_Y_MULTIPLIER}px;
+                }
+                .${instanceClass} .monaco-editor .overflow-guard::before {
+                    content: '';
+                    position: absolute;
+                    left: ${scaledVerticalLineLeft}px;
+                    top: 0;
+                    bottom: 0;
+                    width: 1px;
+                    background-color: ${lineColor};
+                    z-index: 10;
+                }
 
-            .${instanceClass} .monaco-editor .separator-line {
-                background: linear-gradient(
-                    to bottom, 
-                    transparent ${scaledLineHeight * 0.9 - 2}px, 
-                    ${separatorColor} ${scaledLineHeight * 0.9 - 2}px, 
-                    ${separatorColor} ${scaledLineHeight * 0.9 + 1}px, 
-                    transparent ${scaledLineHeight * 0.9 + 1}px
-                );
-            }
-            
-            .${instanceClass} .monaco-editor .transparent-text {
-                color: transparent !important;
-            }
-            
-            .${instanceClass} .monaco-editor .code-block-box {
-                background-color: ${codeBlockBackground};
-                border-left: 1px solid ${codeBlockBorderColor};
-                border-right: 1px solid ${codeBlockBorderColor};
-                padding-left: ${Math.round(8 * zoomLevel)}px;
-                padding-right: ${Math.round(8 * zoomLevel)}px;
-            }
-            
-            .${instanceClass} .monaco-editor .code-block-top {
-                border-top: 1px solid ${codeBlockBorderColor};
-                border-top-left-radius: ${Math.round(10 * zoomLevel)}px;
-                border-top-right-radius: ${Math.round(10 * zoomLevel)}px;
-                overflow: hidden;
-            }
-            
-            .${instanceClass} .monaco-editor .code-block-bottom {
-                border-bottom: 1px solid ${codeBlockBorderColor};
-                border-bottom-left-radius: ${Math.round(10 * zoomLevel)}px;
-                border-bottom-right-radius: ${Math.round(10 * zoomLevel)}px;
-                overflow: hidden;
-            }
-        `;
+                .${instanceClass} .monaco-editor .separator-line {
+                    background: linear-gradient(
+                        to bottom,
+                        transparent ${scaledLineHeight * 0.9 - 2}px,
+                        ${separatorColor} ${scaledLineHeight * 0.9 - 2}px,
+                        ${separatorColor} ${scaledLineHeight * 0.9 + 1}px,
+                        transparent ${scaledLineHeight * 0.9 + 1}px
+                    );
+                }
+
+                .${instanceClass} .monaco-editor .transparent-text {
+                    color: transparent !important;
+                }
+
+                .${instanceClass} .monaco-editor .code-block-box {
+                    background-color: ${codeBlockBackground};
+                    border-left: 1px solid ${codeBlockBorderColor};
+                    border-right: 1px solid ${codeBlockBorderColor};
+                    padding-left: ${Math.round(8 * zoomLevel)}px;
+                    padding-right: ${Math.round(8 * zoomLevel)}px;
+                }
+
+                .${instanceClass} .monaco-editor .code-block-top {
+                    border-top: 1px solid ${codeBlockBorderColor};
+                    border-top-left-radius: ${Math.round(10 * zoomLevel)}px;
+                    border-top-right-radius: ${Math.round(10 * zoomLevel)}px;
+                    overflow: hidden;
+                }
+
+                .${instanceClass} .monaco-editor .code-block-bottom {
+                    border-bottom: 1px solid ${codeBlockBorderColor};
+                    border-bottom-left-radius: ${Math.round(10 * zoomLevel)}px;
+                    border-bottom-right-radius: ${Math.round(10 * zoomLevel)}px;
+                    overflow: hidden;
+                }
+        `);
 
         return () => {
             if (process.env.NODE_ENV === 'production') {

package/src/book-components/Chat/Chat/Chat.module.css

@@ -426,17 +426,10 @@
 }
 
 .chatMainFlow .chatChildren {
-    grid-area: 💬;
+    grid-area: 🟦;
     width: 100%;
-    height: 100%;
     min-width: 0;
-    min-height: 0;
     z-index: 300;
-    pointer-events: none;
-}
-
-.chatMainFlow .chatChildren > * {
-    pointer-events: auto;
 }
 
 /* Chat messages area */

package/src/book-components/Chat/Chat/ChatMessageMap.tsx

@@ -1,4 +1,6 @@
 'use client';
+import { spaceTrim } from 'spacetrim';
+
 
 import type { Feature, GeoJsonObject, GeoJsonProperties, Geometry } from 'geojson';
 import type { LatLng, Layer, Map as LeafletMap, Path, PathOptions } from 'leaflet';
@@ -253,10 +255,12 @@ function createPointOfInterestMarker(leaflet: LeafletNamespace, feature: ChatGeo
 
     const icon = leaflet.divIcon({
         className: styles.poiMarkerIcon,
-        html: `
-            <span class="${styles.poiMarkerPulse}" aria-hidden="true"></span>
-            ${initialHtml}
-        `.trim(),
+        html: spaceTrim(
+            (block) => `
+                <span class="${styles.poiMarkerPulse}" aria-hidden="true"></span>
+                ${block(initialHtml)}
+            `,
+        ).trim(),
         iconSize: [POI_MARKER_CONFIG.size, POI_MARKER_CONFIG.size],
         iconAnchor: POI_MARKER_CONFIG.anchor,
     });

package/src/book-components/Chat/Chat/ChatProps.tsx

@@ -681,8 +681,9 @@ export type ChatProps = {
     readonly tasksProgress?: Array<{ id: string; name: string; progress?: number }>; // Simplified task progress type
 
     /**
-     * Content to be shown inside the chat bar in head
-     * If not provided, the chat bar will not be rendered
+     * Optional content displayed in the chat header above the message list.
+     *
+     * If not provided, the header row is not rendered.
      */
     readonly children?: ReactNode;
 

package/src/book-components/Chat/save/react/exports/chat-preview-2025-10-13 (1).jsx

@@ -1,3 +1,4 @@
+import { spaceTrim } from 'spacetrim';
 import { Chat } from '@promptbook/components';
 
 export function ChatPreviewChatComponent() {
@@ -43,7 +44,47 @@ export function ChatPreviewChatComponent() {
                     createdAt: '2025-10-12T23:13:15.925Z',
                     sender: 'ASSISTANT_1',
                     content:
-                        "**Absolutely!** Here’s a quick overview:\n\n- **Bold**\n- _Italic_\n- __Underline__\n- ~~Strikethrough~~\n- `Inline code`\n- Code block:\n\n```js\nconsole.log('Hello, world!');\n```\n> Blockquote\n> With\n> Multiple lines\n\n\n- Some text with [Link](https://example.com)\n- ![image](https://img.youtube.com/vi/nD1v9dMvnLY/maxresdefault.jpg)\n- Lists:\n  - Item 1\n    - Nested item\n- Numbered list:\n  1. First\n     1. Nested\n- Table:\n\n| Syntax | Description |\n|--------|-------------|\n| Header | Title       |\n| Cell   | Data        |\n\n- Emoji: 😄 🎉\n- Mention: @user\n- Hashtag: #demo\n- Math: $E=mc^2$\n- Horizontal rule:\n\n---",
+                        spaceTrim(`
+                            **Absolutely!** Here’s a quick overview:
+
+                            - **Bold**
+                            - _Italic_
+                            - __Underline__
+                            - ~~Strikethrough~~
+                            - \`Inline code\`
+                            - Code block:
+
+                            \`\`\`js
+                            console.log('Hello, world!');
+                            \`\`\`
+                            > Blockquote
+                            > With
+                            > Multiple lines
+
+
+                            - Some text with [Link](https://example.com)
+                            - ![image](https://img.youtube.com/vi/nD1v9dMvnLY/maxresdefault.jpg)
+                            - Lists:
+                              - Item 1
+                                - Nested item
+                            - Numbered list:
+                              1. First
+                                 1. Nested
+                            - Table:
+
+                            | Syntax | Description |
+                            |--------|-------------|
+                            | Header | Title       |
+                            | Cell   | Data        |
+
+                            - Emoji: 😄 🎉
+                            - Mention: @user
+                            - Hashtag: #demo
+                            - Math: $E=mc^2$
+                            - Horizontal rule:
+
+                            ---
+                        `),
                     isComplete: true,
                 },
                 {
@@ -51,7 +92,22 @@ export function ChatPreviewChatComponent() {
                     createdAt: '2025-10-12T23:13:15.925Z',
                     sender: 'USER',
                     content:
-                        "Wow, that's a lot! Can you combine some of them?\n\n**Bold _italic_ and `inline code`**\n\nOr maybe:\n> _Blockquote with a [link](https://example.com)_\n\nAnd a table:\n\n| Name | Value |\n|------|-------|\n| Pi   | $\\pi$ |\n\n---",
+                        spaceTrim(`
+                            Wow, that's a lot! Can you combine some of them?
+
+                            **Bold _italic_ and \`inline code\`**
+
+                            Or maybe:
+                            > _Blockquote with a [link](https://example.com)_
+
+                            And a table:
+
+                            | Name | Value |
+                            |------|-------|
+                            | Pi   | $\\pi$ |
+
+                            ---
+                        `),
                     isComplete: true,
                 },
                 {
@@ -59,7 +115,19 @@ export function ChatPreviewChatComponent() {
                     createdAt: '2025-10-12T23:13:15.925Z',
                     sender: 'ASSISTANT_1',
                     content:
-                        'Of course! Here’s a creative mix:\n\n- ~~Strikethrough~~ and __underline__\n- 1. Numbered with *italic* and emoji 🚀\n- - Nested `inline code`\n\n> Blockquote with math: $a^2 + b^2 = c^2$\n\n---\n\nLet me know if you want to see more! #rich #features',
+                        spaceTrim(`
+                            Of course! Here’s a creative mix:
+
+                            - ~~Strikethrough~~ and __underline__
+                            - 1. Numbered with *italic* and emoji 🚀
+                            - - Nested \`inline code\`
+
+                            > Blockquote with math: $a^2 + b^2 = c^2$
+
+                            ---
+
+                            Let me know if you want to see more! #rich #features
+                        `),
                     isComplete: true,
                 },
                 {
@@ -67,7 +135,15 @@ export function ChatPreviewChatComponent() {
                     createdAt: '2025-10-12T23:13:15.925Z',
                     sender: 'ASSISTANT_1',
                     content:
-                        'And here are some more emojis:\n\n😄🎉🚀💡📊📝🔥🌟✅❌\n❤🧡💙💚💛🧡❤️🤎🖤💜\n🐱‍👤🐱‍💻🐱🚀🐱‍🏍💫🎞🎫🎠🎏\n😀😀😁😂🤣😃😄😆😅🤩\n➿🛂🛃🛄🛅♿📶🚻🚹🚾',
+                        spaceTrim(`
+                            And here are some more emojis:
+
+                            😄🎉🚀💡📊📝🔥🌟✅❌
+                            ❤🧡💙💚💛🧡❤️🤎🖤💜
+                            🐱‍👤🐱‍💻🐱🚀🐱‍🏍💫🎞🎫🎠🎏
+                            😀😀😁😂🤣😃😄😆😅🤩
+                            ➿🛂🛃🛄🛅♿📶🚻🚹🚾
+                        `),
                     isComplete: true,
                 },
                 {
@@ -75,7 +151,21 @@ export function ChatPreviewChatComponent() {
                     createdAt: '2025-10-12T23:13:15.925Z',
                     sender: 'ASSISTANT_1',
                     content:
-                        '## And lists:\n\n- Item 1\n- Item 2\n    - Nested Item 2a\n    - Nested Item 2b\n- Item 3\n\n1. First item\n2. Second item\n   1. Nested second item a\n   2. Nested second item b\n3. Third item',
+                        spaceTrim(`
+                            ## And lists:
+
+                            - Item 1
+                            - Item 2
+                                - Nested Item 2a
+                                - Nested Item 2b
+                            - Item 3
+
+                            1. First item
+                            2. Second item
+                               1. Nested second item a
+                               2. Nested second item b
+                            3. Third item
+                        `),
                     isComplete: true,
                 },
             ]}