@promptbook/cli 0.103.0-45 → 0.103.0-46

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

@@ -0,0 +1,86 @@
+import { $provideAgentCollectionForServer } from '@/src/tools/$provideAgentCollectionForServer';
+import { padBook, validateBook } from '@promptbook-local/core';
+import { serializeError } from '@promptbook-local/utils';
+import spaceTrim from 'spacetrim';
+import { assertsError } from '../../../../../../../../src/errors/assertsError';
+import { keepUnused } from '../../../../../../../../src/utils/organization/keepUnused';
+
+export async function GET(request: Request, { params }: { params: Promise<{ agentName: string }> }) {
+    keepUnused(request /* <- Note: We dont need `request` parameter */);
+    let { agentName } = await params;
+    agentName = decodeURIComponent(agentName);
+
+    try {
+        const collection = await $provideAgentCollectionForServer();
+        const agentSource = await collection.getAgentSource(agentName);
+
+        return new Response(agentSource.getValue(), {
+            status: 200,
+            headers: { 'Content-Type': 'text/plain' /* <- TODO: [🎳] Mime type of book */ },
+        });
+    } catch (error) {
+        assertsError(error);
+
+        console.error(error);
+
+        return new Response(
+            JSON.stringify(
+                serializeError(error),
+                // <- TODO: !!! Rename `serializeError` to `errorToJson`
+                null,
+                4,
+                // <- TODO: !!! Allow to configure pretty print for agent server
+            ),
+            {
+                status: 400, // <- TODO: !!! Make `errorToHttpStatusCode`
+                headers: { 'Content-Type': 'application/json' },
+            },
+        );
+    }
+}
+
+export async function PUT(request: Request, { params }: { params: Promise<{ agentName: string }> }) {
+    let { agentName } = await params;
+    agentName = decodeURIComponent(agentName);
+
+    try {
+        const collection = await $provideAgentCollectionForServer();
+        let agentSourceUnchecked = await request.text();
+        agentSourceUnchecked = spaceTrim(agentSourceUnchecked);
+        let agentSource = validateBook(agentSourceUnchecked);
+        agentSource = padBook(agentSource);
+
+        await collection.updateAgentSource(agentName, agentSource);
+        // <- TODO: !!! Properly type as string_book
+
+        return new Response(
+            JSON.stringify({
+                isSuccessful: true,
+                message: `Agent "${agentName}" updated successfully`,
+                agentSource, // <- TODO: !!! Remove from response
+            }),
+            {
+                status: 200,
+                headers: { 'Content-Type': 'application/json' },
+            },
+        );
+    } catch (error) {
+        assertsError(error);
+
+        console.error(error);
+
+        return new Response(
+            JSON.stringify(
+                serializeError(error),
+                // <- TODO: !!! Rename `serializeError` to `errorToJson`
+                null,
+                4,
+                // <- TODO: !!! Allow to configure pretty print for agent server
+            ),
+            {
+                status: 400, // <- TODO: !!! Make `errorToHttpStatusCode`
+                headers: { 'Content-Type': 'application/json' },
+            },
+        );
+    }
+}

package/apps/agents-server/src/app/agents/[agentName]/api/book/test.http

@@ -0,0 +1,37 @@
+### Get the book
+
+GET http://localhost:4440/agents/Gabriel%20Gray/api/book
+
+
+
+# _______________________________________
+### Update the book 1
+
+
+PUT http://localhost:4440/agents/Gabriel%20Gray/api/book
+Content-Type: text/plain
+# <- TODO: [🎳] Mime type of book
+
+
+Gabriel Gray
+
+META COLOR #c9c9c9ff
+PERSONA Friendly and helpful AI agent.
+RULE Be kind and respectful.
+
+
+
+
+# _______________________________________
+### Update the book 2
+
+
+PUT http://localhost:4440/agents/Gabriel%20Gray/api/book
+Content-Type: text/plain
+# <- TODO: [🎳] Mime type of book
+
+Gabriel Gray
+
+META COLOR #242424ff
+PERSONA Strict and professional AI agent.
+RULE Be strict and professional.

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

@@ -0,0 +1,74 @@
+'use client';
+
+import { BookEditor } from '@promptbook-local/components';
+import { string_book } from '@promptbook-local/types';
+import { useState } from 'react';
+
+type BookEditorWrapperProps = {
+    agentName: string;
+    initialAgentSource: string_book;
+};
+
+// TODO: !!!! Rename to BookEditorSavingWrapper
+
+export function BookEditorWrapper({ agentName, initialAgentSource }: BookEditorWrapperProps) {
+    const [agentSource, setAgentSource] = useState<string_book>(initialAgentSource);
+    const [saveStatus, setSaveStatus] = useState<'idle' | 'saving' | 'saved' | 'error'>('idle');
+
+    const handleChange = async (newSource: string_book) => {
+        setAgentSource(newSource);
+        setSaveStatus('saving');
+
+        try {
+            const response = await fetch(`/agents/${encodeURIComponent(agentName)}/api/book`, {
+                method: 'PUT',
+                headers: {
+                    'Content-Type': 'text/plain',
+                },
+                body: newSource,
+            });
+
+            if (!response.ok) {
+                throw new Error(`Failed to save: ${response.statusText}`);
+            }
+
+            setSaveStatus('saved');
+            setTimeout(() => setSaveStatus('idle'), 2000); // Reset status after 2 seconds
+        } catch (error) {
+            console.error('Error saving agent source:', error);
+            setSaveStatus('error');
+            setTimeout(() => setSaveStatus('idle'), 3000);
+        }
+    };
+
+    return (
+        <div className="w-full h-screen flex flex-col">
+            {saveStatus !== 'idle' && (
+                <div
+                    className={`px-4 py-2 text-sm ${
+                        saveStatus === 'saving'
+                            ? 'bg-blue-100 text-blue-800'
+                            : saveStatus === 'saved'
+                            ? 'bg-green-100 text-green-800'
+                            : 'bg-red-100 text-red-800'
+                    }`}
+                >
+                    {saveStatus === 'saving' && '💾 Saving...'}
+                    {saveStatus === 'saved' && '✅ Saved successfully'}
+                    {saveStatus === 'error' && '❌ Failed to save'}
+                </div>
+            )}
+            <div className="flex-1">
+                <BookEditor value={agentSource} onChange={handleChange} />
+            </div>
+        </div>
+    );
+}
+
+/**
+ * TODO: [🚗] Transfer the saving logic to `<BookEditor/>` be aware of CRDT / yjs approach to be implementable in future
+ * TODO: !!! Implement debouncing for auto-save
+ * TODO: !!! Add error handling and retry logic
+ * TODO: !!! Show save status indicator
+ * TODO: !!!!! Add file upload capability
+ */

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

@@ -0,0 +1,21 @@
+'use server';
+
+import { $provideAgentCollectionForServer } from '@/src/tools/$provideAgentCollectionForServer';
+import { headers } from 'next/headers';
+import { $sideEffect } from '../../../../../../../src/utils/organization/$sideEffect';
+import { BookEditorWrapper } from './BookEditorWrapper';
+
+export default async function AgentPage({ params }: { params: Promise<{ agentName: string }> }) {
+    $sideEffect(headers());
+
+    const { agentName } = await params;
+    const collection = await $provideAgentCollectionForServer();
+    const agentSourceSubject = await collection.getAgentSource(decodeURIComponent(agentName));
+    const agentSource = agentSourceSubject.getValue();
+
+    return <BookEditorWrapper agentName={agentName} initialAgentSource={agentSource} />;
+}
+
+/**
+ * TODO: [🚗] Components and pages here should be just tiny UI wrapper around proper agent logic and components
+ */

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

@@ -26,6 +26,7 @@ export default async function AgentPage({ params }: { params: Promise<{ agentNam
 
     // Build agent page URL for QR and copy
     const pageUrl = `https://s6.ptbk.io/agents/${encodeURIComponent(agentName)}`;
+    // <- TODO: !!! Better
 
     // Extract brand color from meta
     const brandColor = agentProfile.meta.color || '#3b82f6'; // Default to blue-600
@@ -124,13 +125,15 @@ export default async function AgentPage({ params }: { params: Promise<{ agentNam
                     </div>
                     <div className="flex gap-4 mt-6">
                         <a
-                            href="#"
+                            href={`${pageUrl}/chat`}
+                            // <- !!!! Can I append path like this on current browser URL in href?
                             className="bg-blue-600 hover:bg-blue-700 text-white px-4 py-2 rounded shadow font-semibold transition"
                         >
                             💬 Chat
                         </a>
                         <a
-                            href="#"
+                            href={`${pageUrl}/book`}
+                            // <- !!!! Can I append path like this on current browser URL in href?
                             className="bg-gray-200 hover:bg-gray-300 text-gray-800 px-4 py-2 rounded shadow font-semibold transition"
                         >
                             ✏️ Edit Agent Book
@@ -151,5 +154,7 @@ export default async function AgentPage({ params }: { params: Promise<{ agentNam
 }
 
 /**
+ * TODO: !!! Make this page look nice - 🃏
+ * TODO: !!! Show usage of LLM
  * TODO: [🚗] Components and pages here should be just tiny UI wraper around proper agent logic and conponents
  */

package/esm/index.es.js

@@ -47,7 +47,7 @@ const BOOK_LANGUAGE_VERSION = '2.0.0';
  * @generated
  * @see https://github.com/webgptorg/promptbook
  */
-const PROMPTBOOK_ENGINE_VERSION = '0.103.0-45';
+const PROMPTBOOK_ENGINE_VERSION = '0.103.0-46';
 /**
  * TODO: string_promptbook_version should be constrained to the all versions of Promptbook engine
  * Note: [💞] Ignore a discrepancy between file name and entity name
@@ -3947,6 +3947,8 @@ function checkExpectations(expectations, value) {
  * This function provides a common abstraction for result validation that can be used
  * by both execution logic and caching logic to ensure consistency.
  *
+ * Note: [🔂] This function is idempotent.
+ *
  * @param options - The validation options including result string, expectations, and format
  * @returns Validation result with processed string and validity status
  * @private internal function of `createPipelineExecutor` and `cacheLlmTools`
@@ -5714,6 +5716,8 @@ function isValidPipelineUrl(url) {
  * -   if it is valid json
  * -   if it is meaningful
  *
+ * Note: [🔂] This function is idempotent.
+ *
  * @param pipeline valid or invalid PipelineJson
  * @returns the same pipeline if it is logically valid
  * @throws {PipelineLogicError} on logical error in the pipeline
@@ -6030,6 +6034,8 @@ var PipelineCollection = [{title:"Prepare Knowledge from Markdown",pipelineUrl:"
  * Function `validatePipelineString` will validate the if the string is a valid pipeline string
  * It does not check if the string is fully logically correct, but if it is a string that can be a pipeline string or the string looks completely different.
  *
+ * Note: [🔂] This function is idempotent.
+ *
  * @param {string} pipelineString the candidate for a pipeline string
  * @returns {PipelineString} the same string as input, but validated as valid
  * @throws {ParseError} if the string is not a valid pipeline string
@@ -10086,6 +10092,8 @@ function removeQuotes(text) {
  * Function `validateParameterName` will normalize and validate a parameter name for use in pipelines.
  * It removes diacritics, emojis, and quotes, normalizes to camelCase, and checks for reserved names and invalid characters.
  *
+ * Note: [🔂] This function is idempotent.
+ *
  * @param parameterName The parameter name to validate and normalize.
  * @returns The validated and normalized parameter name.
  * @throws {ParseError} If the parameter name is empty, reserved, or contains invalid characters.
@@ -12066,6 +12074,8 @@ const PADDING_LINES = 11;
 /**
  * A function that adds padding to the book content
  *
+ * Note: [🔂] This function is idempotent.
+ *
  * @public exported from `@promptbook/core`
  */
 function padBook(content) {
@@ -15061,6 +15071,33 @@ function $initializeRunCommand(program) {
  * TODO: [🖇] What about symlinks? Maybe flag --follow-symlinks
  */
 
+/**
+ * !!!!!
+ * Remote server is a proxy server that uses its execution tools internally and exposes the executor interface externally.
+ *
+ * You can simply use `RemoteExecutionTools` on client-side javascript and connect to your remote server.
+ * This is useful to make all logic on browser side but not expose your API keys or no need to use customer's GPU.
+ *
+ * @see https://github.com/webgptorg/promptbook#remote-server
+ * @public exported from `@promptbook/remote-server`
+ * <- TODO: !!!! Maybe change to `@promptbook/agent-server`
+ */
+async function startAgentServer(options) {
+    const { port = 4440 } = options;
+    // TODO: !!!! [🌕]
+    console.trace(`!!! Starting agents server on port ${port}...`);
+    console.log(`!!! cwd`, process.cwd());
+    console.log(`!!! __dirname`, __dirname);
+    await $execCommand({
+        cwd: './apps/agents-server',
+        command: `next dev --port ${port} `,
+        isVerbose: true,
+    });
+}
+/**
+ * Note: [🟢] Code in this file should never be never released in packages that could be imported into browser environment
+ */
+
 /**
  * Initializes `start-agents-server` command for Promptbook CLI utilities
  *
@@ -15140,11 +15177,7 @@ function $initializeStartAgentsServerCommand(program) {
             isVerbose: true,
         });
         */
-        await $execCommand({
-            cwd: './apps/agents-server',
-            command: `next dev --port ${port} `,
-            isVerbose: true,
-        });
+        await startAgentServer({ port });
     }));
 }
 /**