@promptbook/cli 0.103.0-9 → 0.103.0

package/README.md

@@ -9,8 +9,8 @@ Turn your company's scattered knowledge into AI ready Books
 
 
 
-[![NPM Version of ![Promptbook logo - cube with letters P and B](./design/logo-h1.png) Promptbook](https://badge.fury.io/js/promptbook.svg)](https://www.npmjs.com/package/promptbook)
-[![Quality of package ![Promptbook logo - cube with letters P and B](./design/logo-h1.png) Promptbook](https://packagequality.com/shield/promptbook.svg)](https://packagequality.com/#?package=promptbook)
+[![NPM Version of ![Promptbook logo](./design/logo-h1.png) Promptbook](https://badge.fury.io/js/promptbook.svg)](https://www.npmjs.com/package/promptbook)
+[![Quality of package ![Promptbook logo](./design/logo-h1.png) Promptbook](https://packagequality.com/shield/promptbook.svg)](https://packagequality.com/#?package=promptbook)
 [![Known Vulnerabilities](https://snyk.io/test/github/webgptorg/promptbook/badge.svg)](https://snyk.io/test/github/webgptorg/promptbook)
 [![🧪 Test Books](https://github.com/webgptorg/promptbook/actions/workflows/test-books.yml/badge.svg)](https://github.com/webgptorg/promptbook/actions/workflows/test-books.yml)
 [![🧪 Test build](https://github.com/webgptorg/promptbook/actions/workflows/test-build.yml/badge.svg)](https://github.com/webgptorg/promptbook/actions/workflows/test-build.yml)
@@ -23,18 +23,10 @@ Turn your company's scattered knowledge into AI ready Books
 
 ## 🌟 New Features
 
--   🚀 **GPT-5 Support** - Now includes OpenAI's most advanced language model with unprecedented reasoning capabilities and 200K context window
--   💡 VS Code support for `.book` files with syntax highlighting and IntelliSense
--   🐳 Official Docker image (`hejny/promptbook`) for seamless containerized usage
--   🔥 Native support for OpenAI `o3-mini`, GPT-4 and other leading LLMs
--   🔍 DeepSeek integration for advanced knowledge search
+-   **Gemini 3 Support**
 
 
 
-<blockquote style="color: #ff8811">
-    <b>⚠ Warning:</b> This is a pre-release version of the library. It is not yet ready for production use. Please look at <a href="https://www.npmjs.com/package/@promptbook/core?activeTab=versions">latest stable release</a>.
-</blockquote>
-
 ## 📦 Package `@promptbook/cli`
 
 - Promptbooks are [divided into several](#-packages) packages, all are published from [single monorepo](https://github.com/webgptorg/promptbook).
@@ -189,11 +181,15 @@ The main challenge is to narrow it down, constrain it, set the proper **context,
 
 Promptbook takes the best from both worlds. You are defining your AI behavior by simple **books**, which are very explicit. They are automatically enforced, but they are very easy to understand, very easy to write, and very reliable and portable.
 
+<table style="border: 1px solid #777; border-radius: 10px;"><tr><td>
+
+**<ins>Paul Smith & Associés</ins>**<br/>
+<br/>
+**PERSONA** You are a company lawyer.<br/>
+Your job is to provide legal advice and support to the company and its employees.<br/>
+You are knowledgeable, professional, and detail-oriented.<br/>
 
-<img
-    alt="Paul Smith & Associés Book"
-    src="https://promptbook.studio/embed/book-preview.png?book=Paul%20Smith%20%26%20Associ%C3%A9s%0A%20%20%20%20%20%20%7C%20PERSONA%20You%20are%20a%20company%20lawyer.%0A%20%20%20%20%20%20%7C%20Your%20job%20is%20to%20provide%20legal%20advice%20and%20support%20to%20the%20company%20and%20its%20employees.%0A%20%20%20%20%20%20%7C%20You%20are%20knowledgeable%2C%20professional%2C%20and%20detail-oriented.&width=800&height=450&nonce=0"
-/>
+</td></tr></table>
 
 <div style="page-break-after: always;"></div>
 
@@ -207,11 +203,15 @@ You can look at it as prompting (or writing a system message), but decorated by
 
 Personas define the character of your AI persona, its role, and how it should interact with users. It sets the tone and style of communication.
 
+<table style="border: 1px solid #777; border-radius: 10px;"><tr><td>
 
-<img
-    alt="Paul Smith & Associés Book"
-    src="https://promptbook.studio/embed/book-preview.png?book=Paul%20Smith%20%26%20Associ%C3%A9s%0A%20%20%20%20%20%20%7C%20PERSONA%20You%20are%20a%20company%20lawyer.%0A%20%20%20%20%20%20%7C%20Your%20job%20is%20to%20provide%20legal%20advice%20and%20support%20to%20the%20company%20and%20its%20employees.%0A%20%20%20%20%20%20%7C%20You%20are%20knowledgeable%2C%20professional%2C%20and%20detail-oriented.&width=800&height=450&nonce=0"
-/>
+**<ins>Paul Smith & Associés</ins>**<br/>
+<br/>
+**PERSONA** You are a company lawyer.<br/>
+Your job is to provide legal advice and support to the company and its employees.<br/>
+You are knowledgeable, professional, and detail-oriented.<br/>
+
+</td></tr></table>
 
 #### `Knowledge` commitment
 
@@ -221,11 +221,18 @@ This can include domain-specific knowledge, company policies, or any other relev
 
 Promptbook Engine will automatically enforce this knowledge during interactions. When the knowledge is short enough, it will be included in the prompt. When it is too long, it will be stored in vector databases and RAG retrieved when needed. But you don't need to care about it.
 
+<table style="border: 1px solid #777; border-radius: 10px;"><tr><td>
+
+**<ins>Paul Smith & Associés</ins>**<br/>
+<br/>
+**PERSONA** You are a company lawyer.<br/>
+Your job is to provide legal advice and support to the company and its employees.<br/>
+You are knowledgeable, professional, and detail-oriented.<br/>
+<br/>
+**KNOWLEDGE** https://company.com/company-policies.pdf<br/>
+**KNOWLEDGE** https://company.com/internal-documents/employee-handbook.docx<br/>
 
-<img
-    alt="Paul Smith & Associés Book"
-    src="https://promptbook.studio/embed/book-preview.png?book=Paul%20Smith%20%26%20Associ%C3%A9s%0A%20%20%20%20%20%20%7C%20PERSONA%20You%20are%20a%20company%20lawyer.%0A%20%20%20%20%20%20%7C%20Your%20job%20is%20to%20provide%20legal%20advice%20and%20support%20to%20the%20company%20and%20its%20employees.%0A%20%20%20%20%20%20%7C%20You%20are%20knowledgeable%2C%20professional%2C%20and%20detail-oriented.%0A%20%20%20%20%20%20%7C%20KNOWLEDGE%20%20https%3A%2F%2Fcompany.com%2Fcompany-policies.pdf%0A%20%20%20%20%20%20%7C%20KNOWLEDGE%20https%3A%2F%2Fcompany.com%2Finternal-documents%2Femployee-handbook.docx&width=800&height=450&nonce=0"
-/>
+</td></tr></table>
 
 #### `Rule` commitment
 
@@ -233,21 +240,42 @@ Rules will enforce specific behaviors or constraints on the AI's responses. This
 
 Depending on rule strictness, Promptbook will either propagate it to the prompt or use other techniques, like adversary agent, to enforce it.
 
+<table style="border: 1px solid #777; border-radius: 10px;"><tr><td>
 
-<img
-    alt="Paul Smith & Associés Book"
-    src="https://promptbook.studio/embed/book-preview.png?book=Paul%20Smith%20%26%20Associ%C3%A9s%0A%20%20%20%20%20%20%7C%20PERSONA%20You%20are%20a%20company%20lawyer.%0A%20%20%20%20%20%20%7C%20Your%20job%20is%20to%20provide%20legal%20advice%20and%20support%20to%20the%20company%20and%20its%20employees.%0A%20%20%20%20%20%20%7C%20You%20are%20knowledgeable%2C%20professional%2C%20and%20detail-oriented.%0A%20%20%20%20%20%20%7C%20RULE%20Always%20ensure%20compliance%20with%20laws%20and%20regulations.%0A%20%20%20%20%20%20%7C%20RULE%20Never%20provide%20legal%20advice%20outside%20your%20area%20of%20expertise.%0A%20%20%20%20%20%20%7C%20RULE%20Never%20provide%20legal%20advice%20about%20criminal%20law.%0A%20%20%20%20%20%20%7C%20KNOWLEDGE%20%20https%3A%2F%2Fcompany.com%2Fcompany-policies.pdf%0A%20%20%20%20%20%20%7C%20KNOWLEDGE%20https%3A%2F%2Fcompany.com%2Finternal-documents%2Femployee-handbook.docx&width=800&height=450&nonce=0"
-/>
+**<ins>Paul Smith & Associés</ins>**<br/>
+<br/>
+**PERSONA** You are a company lawyer.<br/>
+Your job is to provide legal advice and support to the company and its employees.<br/>
+You are knowledgeable, professional, and detail-oriented.<br/>
+<br/>
+**RULE** Always ensure compliance with laws and regulations.<br/>
+**RULE** Never provide legal advice outside your area of expertise.<br/>
+**RULE** Never provide legal advice about criminal law.<br/>
+**KNOWLEDGE** https://company.com/company-policies.pdf<br/>
+**KNOWLEDGE** https://company.com/internal-documents/employee-handbook.docx<br/>
+
+</td></tr></table>
 
 #### `Action` commitment
 
 Action Commitment allows you to define specific actions that the AI can take during interactions. This can include things like posting on a social media platform, sending emails, creating calendar events, or interacting with your internal systems.
 
+<table style="border: 1px solid #777; border-radius: 10px;"><tr><td>
+
+**<ins>Paul Smith & Associés</ins>**<br/>
+<br/>
+**PERSONA** You are a company lawyer.<br/>
+Your job is to provide legal advice and support to the company and its employees.<br/>
+You are knowledgeable, professional, and detail-oriented.<br/>
+<br/>
+**RULE** Always ensure compliance with laws and regulations.<br/>
+**RULE** Never provide legal advice outside your area of expertise.<br/>
+**RULE** Never provide legal advice about criminal law.<br/>
+**KNOWLEDGE** https://company.com/company-policies.pdf<br/>
+**KNOWLEDGE** https://company.com/internal-documents/employee-handbook.docx<br/>
+**ACTION** When a user asks about an issue that could be treated as a crime, notify legal@company.com.<br/>
 
-<img
-    alt="Paul Smith & Associés Book"
-    src="https://promptbook.studio/embed/book-preview.png?book=Paul%20Smith%20%26%20Associ%C3%A9s%0A%20%20%20%20%20%20%7C%20PERSONA%20You%20are%20a%20company%20lawyer.%0A%20%20%20%20%20%20%7C%20Your%20job%20is%20to%20provide%20legal%20advice%20and%20support%20to%20the%20company%20and%20its%20employees.%0A%20%20%20%20%20%20%7C%20You%20are%20knowledgeable%2C%20professional%2C%20and%20detail-oriented.%0A%20%20%20%20%20%20%7C%20RULE%20Always%20ensure%20compliance%20with%20laws%20and%20regulations.%0A%20%20%20%20%20%20%7C%20RULE%20Never%20provide%20legal%20advice%20outside%20your%20area%20of%20expertise.%0A%20%20%20%20%20%20%7C%20RULE%20Never%20provide%20legal%20advice%20about%20criminal%20law.%0A%20%20%20%20%20%20%7C%20KNOWLEDGE%20%20https%3A%2F%2Fcompany.com%2Fcompany-policies.pdf%0A%20%20%20%20%20%20%7C%20KNOWLEDGE%20https%3A%2F%2Fcompany.com%2Finternal-documents%2Femployee-handbook.docx%0A%20%20%20%20%20%20%7C%20ACTION%20When%20a%20user%20asks%20about%20an%20issue%20that%20could%20be%20treated%20as%20a%20crime%2C%20notify%20legal%40company.com.&width=800&height=450&nonce=0"
-/>
+</td></tr></table>
 
 [Read more about the language](./BLUEPRINT.md)
 
@@ -294,14 +322,10 @@ Now you want to use it. There are several ways how to write your first book:
 
 We have written ai asistant in book who can help you with writing your first book.
 
-
-
 #### Your AI twin
 
 Copy your own behavior, personality, and knowledge into book and create your AI twin. It can help you with your work, personal life, or any other task.
 
-
-
 #### AI persona workpool
 
 Or you can pick from our library of pre-written books for various roles and tasks. You can find books for customer support, coding, marketing, sales, HR, legal, and many other roles.
@@ -421,8 +445,6 @@ Join our growing community of developers and users:
 
 
 
-
-
 ## 📚 Documentation
 
 See detailed guides and API reference in the [docs](https://github.com/webgptorg/promptbook/discussions/categories/concepts) or [online](https://discord.gg/x3QWNaa89N).
@@ -499,8 +521,6 @@ The following glossary is used to clarify certain concepts:
 
 _Note: This section is not a complete dictionary, more list of general AI / LLM terms that has connection with Promptbook_
 
-
-
 ### 💯 Core concepts
 
 -   [📚 Collection of pipelines](https://github.com/webgptorg/promptbook/discussions/65)

package/apps/agents-server/README.md

@@ -0,0 +1,3 @@
+# 🔠 Promptbook Agents server
+
+Agents Server is the main web application where Promptbook agents live

package/apps/agents-server/TODO.txt

@@ -0,0 +1,7 @@
+TODO: [🐱‍🚀] Theese are TODOs connected with the agents and Agents server
+TODO: [🐱‍🚀] Tests of the agents server should be in main testing pipeline
+TODO: [🐱‍🚀] Make the agents live here and act here
+TODO: [🐱‍🚀] Publish `agents-server` this as Docker container
+TODO: [🐱‍🚀] Publish `@promptbook/agents-server` to npm
+TODO: [🐱‍🚀] Work `ptbk start-pipelines-server` / `ptbk start-agents-server` CLI command to start this server
+TODO: [🧠][🚙] `AgentXxx` vs `AgentsXxx` naming convention

package/apps/agents-server/config.ts

@@ -0,0 +1,130 @@
+import { ConfigChecker } from 'configchecker';
+
+const config = ConfigChecker.from({
+    ...process.env,
+
+    // Note: To expose env variables to the browser, using this seemingly strange syntax:
+    //       @see https://nextjs.org/docs/pages/building-your-application/configuring/environment-variables#exposing-environment-variables-to-the-browser
+    NEXT_PUBLIC_SITE_URL: process.env.NEXT_PUBLIC_SITE_URL,
+    NEXT_PUBLIC_VERCEL_ENV: process.env.NEXT_PUBLIC_VERCEL_ENV,
+    NEXT_PUBLIC_VERCEL_TARGET_ENV: process.env.NEXT_PUBLIC_VERCEL_TARGET_ENV,
+    NEXT_PUBLIC_VERCEL_URL: process.env.NEXT_PUBLIC_VERCEL_URL,
+    NEXT_PUBLIC_VERCEL_BRANCH_URL: process.env.NEXT_PUBLIC_VERCEL_BRANCH_URL,
+    NEXT_PUBLIC_VERCEL_PROJECT_PRODUCTION_URL: process.env.NEXT_PUBLIC_VERCEL_PROJECT_PRODUCTION_URL,
+    NEXT_PUBLIC_VERCEL_GIT_PROVIDER: process.env.NEXT_PUBLIC_VERCEL_GIT_PROVIDER,
+    NEXT_PUBLIC_VERCEL_GIT_REPO_OWNER: process.env.NEXT_PUBLIC_VERCEL_GIT_REPO_OWNER,
+    NEXT_PUBLIC_VERCEL_GIT_REPO_SLUG: process.env.NEXT_PUBLIC_VERCEL_GIT_REPO_SLUG,
+    NEXT_PUBLIC_VERCEL_GIT_REPO_ID: process.env.NEXT_PUBLIC_VERCEL_GIT_REPO_ID,
+    NEXT_PUBLIC_VERCEL_GIT_COMMIT_SHA: process.env.NEXT_PUBLIC_VERCEL_GIT_COMMIT_SHA,
+    NEXT_PUBLIC_VERCEL_GIT_COMMIT_MESSAGE: process.env.NEXT_PUBLIC_VERCEL_GIT_COMMIT_MESSAGE,
+    NEXT_PUBLIC_VERCEL_GIT_COMMIT_REF: process.env.NEXT_PUBLIC_VERCEL_GIT_COMMIT_REF,
+    NEXT_PUBLIC_VERCEL_GIT_COMMIT_AUTHOR_NAME: process.env.NEXT_PUBLIC_VERCEL_GIT_COMMIT_AUTHOR_NAME,
+    NEXT_PUBLIC_VERCEL_GIT_COMMIT_AUTHOR_LOGIN: process.env.NEXT_PUBLIC_VERCEL_GIT_COMMIT_AUTHOR_LOGIN,
+    NEXT_PUBLIC_VERCEL_GIT_PREVIOUS_SHA: process.env.NEXT_PUBLIC_VERCEL_GIT_PREVIOUS_SHA,
+    NEXT_PUBLIC_VERCEL_GIT_PULL_REQUEST_ID: process.env.NEXT_PUBLIC_VERCEL_GIT_PULL_REQUEST_ID,
+});
+
+/**
+ * Public URL of the deployment, e.g. "https://my-app.vercel.app"
+ *
+ * Note: When `SERVERS` are used, this URL will be overridden by the server URL.
+ */
+export const NEXT_PUBLIC_SITE_URL = config
+    .get('NEXT_PUBLIC_SITE_URL')
+    .url()./* <- TODO: !!!! Is it ok not to be required().*/ value;
+
+/**
+ * [♐️] Vercel environment: "development" | "preview" | "production"
+ */
+export const NEXT_PUBLIC_VERCEL_ENV = config.get('NEXT_PUBLIC_VERCEL_ENV').value;
+
+/**
+ * [♐️] Target environment – can be system or custom
+ */
+export const NEXT_PUBLIC_VERCEL_TARGET_ENV = config.get('NEXT_PUBLIC_VERCEL_TARGET_ENV').value;
+
+/**
+ * [♐️] Deployment URL (without https://), e.g. "my-app-abc123.vercel.app"
+ */
+export const NEXT_PUBLIC_VERCEL_URL = config.get('NEXT_PUBLIC_VERCEL_URL').value;
+
+/**
+ * [♐️] Branch URL (without https://), only for branch deployments
+ */
+export const NEXT_PUBLIC_VERCEL_BRANCH_URL = config.get('NEXT_PUBLIC_VERCEL_BRANCH_URL').value;
+
+/**
+ * [♐️] Production domain of the project
+ */
+export const NEXT_PUBLIC_VERCEL_PROJECT_PRODUCTION_URL = config.get('NEXT_PUBLIC_VERCEL_PROJECT_PRODUCTION_URL').value;
+
+/**
+ * [♐️] Git provider (github | gitlab | bitbucket)
+ */
+export const NEXT_PUBLIC_VERCEL_GIT_PROVIDER = config.get('NEXT_PUBLIC_VERCEL_GIT_PROVIDER').value;
+
+/**
+ * [♐️] Repository owner (e.g. "hejny")
+ */
+export const NEXT_PUBLIC_VERCEL_GIT_REPO_OWNER = config.get('NEXT_PUBLIC_VERCEL_GIT_REPO_OWNER').value;
+
+/**
+ * [♐️] Repository slug (e.g. "my-project")
+ */
+export const NEXT_PUBLIC_VERCEL_GIT_REPO_SLUG = config.get('NEXT_PUBLIC_VERCEL_GIT_REPO_SLUG').value;
+
+/**
+ * [♐️] Repository internal ID
+ */
+export const NEXT_PUBLIC_VERCEL_GIT_REPO_ID = config.get('NEXT_PUBLIC_VERCEL_GIT_REPO_ID').value;
+
+/**
+ * [♐️] Git commit SHA (short or long)
+ */
+export const NEXT_PUBLIC_VERCEL_GIT_COMMIT_SHA = config.get('NEXT_PUBLIC_VERCEL_GIT_COMMIT_SHA').value;
+
+/**
+ * [♐️] Commit message used for this deployment
+ */
+export const NEXT_PUBLIC_VERCEL_GIT_COMMIT_MESSAGE = config.get('NEXT_PUBLIC_VERCEL_GIT_COMMIT_MESSAGE').value;
+
+/**
+ * [♐️] Branch name (ref), e.g. "main"
+ */
+export const NEXT_PUBLIC_VERCEL_GIT_COMMIT_REF = config.get('NEXT_PUBLIC_VERCEL_GIT_COMMIT_REF').value;
+
+/**
+ * Author name of the commit
+ */
+export const NEXT_PUBLIC_VERCEL_GIT_COMMIT_AUTHOR_NAME = config.get('NEXT_PUBLIC_VERCEL_GIT_COMMIT_AUTHOR_NAME').value;
+
+/**
+ * [♐️] Author login/username
+ */
+export const NEXT_PUBLIC_VERCEL_GIT_COMMIT_AUTHOR_LOGIN = config.get(
+    'NEXT_PUBLIC_VERCEL_GIT_COMMIT_AUTHOR_LOGIN',
+).value;
+
+/**
+ * [♐️] Previous deployment commit SHA (if exists)
+ */
+export const NEXT_PUBLIC_VERCEL_GIT_PREVIOUS_SHA = config.get('NEXT_PUBLIC_VERCEL_GIT_PREVIOUS_SHA').value;
+
+/**
+ * [♐️] Pull Request ID for PR-based deployments
+ */
+export const NEXT_PUBLIC_VERCEL_GIT_PULL_REQUEST_ID = config.get('NEXT_PUBLIC_VERCEL_GIT_PULL_REQUEST_ID').value;
+
+/**
+ * List of servers where agents can be hosted
+ *
+ * List of domains where the agents-server is deployed, this overrides the `NEXT_PUBLIC_SITE_URL` and `SUPABASE_TABLE_PREFIX` for each server.
+ */
+export const SERVERS = config.get('SERVERS').list().value;
+
+/**
+ * Supabase table prefix
+ *
+ * Note: When `SERVERS` are used, this prefix will be overridden by the server `server_<server_id>_`.
+ */
+export const SUPABASE_TABLE_PREFIX = config.get('SUPABASE_TABLE_PREFIX').default('').value;

package/apps/agents-server/next.config.ts

@@ -0,0 +1,45 @@
+import type { NextConfig } from 'next';
+import path from 'path';
+
+const nextConfig: NextConfig = {
+    output: 'standalone',
+    // <- TODO: [🐱‍🚀][🧠] How to propperly build Next.js app
+
+    experimental: {
+        externalDir: true,
+    },
+
+    turbopack: {
+        // Note: Set this to your monorepo root (where the shared folder lives)
+        root: path.join(__dirname, '..', '..'),
+
+        resolveAlias: {
+            '@': path.resolve(__dirname),
+            '@common': path.resolve(__dirname, '../common'),
+            '@promptbook-local': path.resolve(__dirname, '../../src/_packages'),
+        },
+    },
+
+    /*/
+    // Note: In case you need to use Webpack instead of Turbopack
+    webpack(config) {
+        // Use TsconfigPathsPlugin for all path alias resolution
+        config.resolve.plugins = config.resolve.plugins || [];
+        config.resolve.plugins.push(
+            new TsconfigPathsPlugin({
+                configFile: path.resolve(__dirname, 'tsconfig.json'),
+                extensions: config.resolve.extensions,
+            }),
+        );
+
+        config.module.rules.push({
+            test: /\.txt$/,
+            use: 'raw-loader',
+        });
+
+        return config;
+    },
+    /**/
+};
+
+export default nextConfig;

package/apps/agents-server/package-lock.json

@@ -0,0 +1,27 @@
+{
+    "name": "promptbook-agents-server",
+    "lockfileVersion": 3,
+    "requires": true,
+    "packages": {
+        "": {
+            "name": "promptbook-agents-server",
+            "devDependencies": {
+                "typescript": "5.9.3"
+            }
+        },
+        "node_modules/typescript": {
+            "version": "5.9.3",
+            "resolved": "https://registry.npmjs.org/typescript/-/typescript-5.9.3.tgz",
+            "integrity": "sha512-jl1vZzPDinLr9eUt3J/t7V6FgNEw9QjvBPdysz9KfQDD41fQrC2Y4vKQdiaUpFT4bXlb1RHhLpp8wtm6M5TgSw==",
+            "dev": true,
+            "license": "Apache-2.0",
+            "bin": {
+                "tsc": "bin/tsc",
+                "tsserver": "bin/tsserver"
+            },
+            "engines": {
+                "node": ">=14.17"
+            }
+        }
+    }
+}

package/apps/agents-server/package.json

@@ -0,0 +1,12 @@
+{
+    "name": "promptbook-agents-server",
+    "scripts": {
+        "migrate-database": "npx tsx src/database/migrate.ts",
+        "dev": "(npx kill-port 4440 || true) && next dev -p 4440",
+        "test-build": "npm run build",
+        "build": "(npx kill-port 4440 || true) && next build",
+        "start": "next start -p 4440",
+        "lint": "next lint",
+        "postinstall": "cd ../../ && npm ci"
+    }
+}

package/apps/agents-server/postcss.config.mjs

@@ -0,0 +1,8 @@
+const config = {
+  plugins: {
+    tailwindcss: {},
+    autoprefixer: {},
+  },
+};
+
+export default config;

package/apps/agents-server/public/fonts/download-font.js

@@ -0,0 +1,22 @@
+const fs = require('fs');
+const path = require('path');
+const https = require('https');
+
+const dir = path.join('apps', 'agents-server', 'public', 'fonts');
+const filePath = path.join(dir, 'OpenMoji-black-glyf.woff2');
+
+if (!fs.existsSync(dir)){
+    fs.mkdirSync(dir, { recursive: true });
+}
+
+const file = fs.createWriteStream(filePath);
+https.get('https://raw.githubusercontent.com/hfg-gmuend/openmoji/master/font/OpenMoji-black-glyf/OpenMoji-black-glyf.woff2', function(response) {
+  response.pipe(file);
+  file.on('finish', function() {
+    file.close();
+    console.log('Download completed');
+  });
+}).on('error', function(err) { 
+  fs.unlink(filePath); 
+  console.error('Error downloading file:', err.message);
+});

package/apps/agents-server/public/sw.js

@@ -0,0 +1,16 @@
+self.addEventListener('install', (event) => {
+    // console.log('Service Worker installing.');
+    // Perform install steps
+    self.skipWaiting();
+});
+
+self.addEventListener('activate', (event) => {
+    // console.log('Service Worker activating.');
+    self.clients.claim();
+});
+
+self.addEventListener('fetch', (event) => {
+    // console.log('Service Worker fetching.', event.request.url);
+    // Simple pass-through fetch
+    event.respondWith(fetch(event.request));
+});

package/apps/agents-server/src/app/AddAgentButton.tsx

@@ -0,0 +1,41 @@
+'use client';
+
+import { useRouter } from 'next/navigation';
+import { useState } from 'react';
+import { Card } from '../components/Homepage/Card';
+import { $createAgentAction } from './actions';
+
+export function AddAgentButton() {
+    const router = useRouter();
+    const [isLoading, setIsLoading] = useState(false);
+
+    const handleAddAgent = async () => {
+        setIsLoading(true);
+        const agentName = await $createAgentAction();
+        // TODO: Add proper error handling and UI feedback
+        if (agentName) {
+            router.push(`/agents/${agentName}`);
+        } else {
+            router.refresh();
+            setIsLoading(false);
+        }
+    };
+
+    return (
+        <div
+            onClick={isLoading ? undefined : handleAddAgent}
+            className={`cursor-pointer h-full group ${isLoading ? 'pointer-events-none' : ''}`}
+        >
+            <Card className="flex items-center justify-center text-lg font-medium text-gray-500 group-hover:text-blue-500 group-hover:border-blue-400 border-dashed border-2">
+                {isLoading ? (
+                    <>
+                        <span className="mr-2 inline-block h-4 w-4 animate-spin rounded-full border-2 border-blue-500 border-t-transparent" />
+                        Creating agent...
+                    </>
+                ) : (
+                    '+ Add New Agent'
+                )}
+            </Card>
+        </div>
+    );
+}

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

@@ -0,0 +1,11 @@
+import { notFound, redirect } from 'next/navigation';
+
+export default async function RedirectPage({ params }: { params: Promise<{ agentName: string; rest: string[] }> }) {
+    const { agentName, rest } = await params;
+
+    if (agentName === 'agents' || agentName === 'api' || agentName.startsWith('.')) {
+        notFound();
+    }
+
+    redirect(`/agents/${agentName}/${rest.join('/')}`);
+}

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

@@ -0,0 +1 @@
+export { generateMetadata, default } from '../agents/[agentName]/page';

package/apps/agents-server/src/app/actions.ts

@@ -0,0 +1,53 @@
+'use server';
+
+import { $generateBookBoilerplate } from '@promptbook-local/core';
+import { string_agent_name } from '@promptbook-local/types';
+import { revalidatePath } from 'next/cache';
+import { cookies } from 'next/headers';
+import { getMetadata } from '../database/getMetadata';
+import { $provideAgentCollectionForServer } from '../tools/$provideAgentCollectionForServer';
+import { authenticateUser } from '../utils/authenticateUser';
+import { isUserAdmin } from '../utils/isUserAdmin';
+import { clearSession, setSession } from '../utils/session';
+
+export async function $createAgentAction(): Promise<string_agent_name> {
+    // TODO: [👹] Check permissions here
+    if (!(await isUserAdmin())) {
+        throw new Error('You are not authorized to create agents');
+    }
+
+    const collection = await $provideAgentCollectionForServer();
+    const namePool = (await getMetadata('NAME_POOL')) || 'ENGLISH';
+    const agentSource = $generateBookBoilerplate({ namePool });
+
+    const { agentName } = await collection.createAgent(agentSource);
+
+    return agentName;
+}
+
+export async function loginAction(formData: FormData) {
+    const username = formData.get('username') as string;
+    const password = formData.get('password') as string;
+
+    console.info(`Login attempt for user: ${username}`);
+
+    const user = await authenticateUser(username, password);
+
+    if (user) {
+        await setSession(user);
+        revalidatePath('/', 'layout');
+        return { success: true };
+    } else {
+        return { success: false, message: 'Invalid credentials' };
+    }
+}
+
+export async function logoutAction() {
+    await clearSession();
+    revalidatePath('/', 'layout');
+}
+
+/**
+ * TODO: [🐱‍🚀] Reorganize actions.ts files
+ * TODO: [🐱‍🚀] [🧠] Study how Next.js actions work
+ */