@promptbook/cli 0.113.0-1 → 0.113.0-11

package/README.md

@@ -23,13 +23,7 @@ Create persistent AI agents that turn your company's scattered knowledge into ac
 
 
 
-[![Vercel](https://img.shields.io/badge/Vercel-Deploy%20Agents%20Server-black?logo=vercel)](https://vercel.com/new/clone?project-name=promptbook-agents-server&repository-name=promptbook-agents-server&repository-url=https%3A%2F%2Fgithub.com%2Fwebgptorg%2Fpromptbook&root-directory=apps%2Fagents-server&demo-title=Promptbook+Agents+Server&demo-description=Persistent+AI+agents+with+a+built-in+admin+UI.+This+deploy+creates+a+Supabase+project+automatically%2C+injects+the+required+database+credentials%2C+and+Promptbook+runs+the+SQL+migrations+on+first+startup.&demo-url=https%3A%2F%2Fgallery.ptbk.io%2F&external-id=https%3A%2F%2Fgithub.com%2Fwebgptorg%2Fpromptbook%2Ftree%2Fmain%2Fapps%2Fagents-server&env=OPENAI_API_KEY%2CADMIN_PASSWORD%2CSUPABASE_AUTO_MIGRATE&envDescription=Supabase+is+created+automatically+by+the+required+Vercel+integration.+Add+OPENAI_API_KEY+from+https%3A%2F%2Fplatform.openai.com%2Fapi-keys%2C+choose+ADMIN_PASSWORD+for+your+first+admin+login%2C+and+leave+SUPABASE_AUTO_MIGRATE+enabled.&envLink=https%3A%2F%2Fgithub.com%2Fwebgptorg%2Fpromptbook%2Fblob%2Fmain%2FREADME.md%23vercel-form-fields&envDefaults=%7B%22SUPABASE_AUTO_MIGRATE%22%3A%22true%22%7D&stores=%5B%7B%22type%22%3A%22integration%22%2C%22integrationSlug%22%3A%22supabase%22%2C%22productSlug%22%3A%22supabase%22%7D%5D)
-
-
-
-### Standalone VPS
-
-Run the standalone VPS installer only on a fresh server. Interactive mode asks for the installation values:
+Run the standalone VPS installer _(for example on DigitalOcean)_ only on a fresh server. Interactive mode asks for the installation values:
 
 ```bash
 sudo curl -fsSL https://raw.githubusercontent.com/webgptorg/promptbook/refs/heads/main/other/vps/install.sh | bash
@@ -357,8 +351,6 @@ TEAM You are part of the legal team of Paul Smith & Associés, you discuss with
 
 </td></tr></table>
 
-
-
 ### Promptbook Ecosystem
 
 Promptbook is an ecosystem of tools centered around the **Agents Server** - a production-ready platform for running persistent AI agents.
@@ -381,8 +373,6 @@ The [Promptbook Engine](https://github.com/webgptorg/promptbook) is the open-sou
 
 
 
-
-
 ## 💜 The Promptbook Project
 
 Promptbook project is an ecosystem centered around the **Agents Server** - a platform for creating, deploying, and running persistent AI agents. Following is a list of the most important pieces of the project:
@@ -420,8 +410,6 @@ Promptbook project is an ecosystem centered around the **Agents Server** - a pla
   </tbody>
 </table>
 
-
-
 ### 🌐 Community & Social Media
 
 Join our growing community of developers and users:
@@ -478,8 +466,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).
@@ -687,8 +673,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/agents/default/developer.book

@@ -1,4 +1,7 @@
 Developer
+
+
+
 META VISIBILITY PRIVATE
 
 RULE

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

@@ -78,7 +78,7 @@ const nextConfig: NextConfig = {
         },
     },
 
-    webpack(config, { isServer }) {
+    webpack(config, { isServer, nextRuntime }) {
         config.resolve.alias = {
             ...config.resolve.alias,
             '@': path.resolve(__dirname),
@@ -92,11 +92,14 @@ const nextConfig: NextConfig = {
             );
         }
 
-        // Exclude Node.js-only modules from client bundle
-        if (!isServer) {
+        // Exclude Node.js-only modules from client and edge bundles
+        if (!isServer || nextRuntime === 'edge') {
             config.resolve.fallback = {
                 ...config.resolve.fallback,
                 fs: false,
+                'fs/promises': false,
+                path: false,
+                util: false,
                 net: false,
                 tls: false,
                 dns: false,

package/apps/agents-server/src/app/admin/{code-runners/CodeRunnersClient.tsx → harness-auth/HarnessAuthClient.tsx}

@@ -3,15 +3,15 @@
 import { Loader2, Save, ServerCog } from 'lucide-react';
 import { useCallback, useEffect, useState } from 'react';
 import { AdminTerminalCard } from '../../../components/AdminTerminal/AdminTerminalCard';
-import { AdminXtermTerminal } from '../../../components/AdminTerminal/AdminXtermTerminal';
 import { useAdminTerminalSession } from '../../../components/AdminTerminal/useAdminTerminalSession';
 import { Card } from '../../../components/Homepage/Card';
+import { HARNESS_AUTH_API_PATH, HARNESS_AUTHENTICATION_API_PATH } from '../../../constants/harnessAuthRoutes';
 
 /**
- * Code-runner API response.
+ * Harness Auth API response.
  */
-type CodeRunnersResponse = {
-    readonly agent?: string;
+type HarnessAuthResponse = {
+    readonly harness?: string;
     readonly model?: string;
     readonly thinkingLevel?: string;
     readonly status?: string;
@@ -25,9 +25,9 @@ type CodeRunnersResponse = {
 /**
  * Browser-safe snapshot of one authentication terminal session.
  */
-type CodeRunnerAuthenticationSession = {
+type HarnessAuthenticationSession = {
     readonly id: string;
-    readonly agent: string;
+    readonly harness: string;
     readonly isRunning: boolean;
     readonly output: string;
     readonly startedAt: string;
@@ -37,9 +37,9 @@ type CodeRunnerAuthenticationSession = {
 };
 
 /**
- * Supported runner options shown by the standalone UI.
+ * Supported harness options shown by the standalone UI.
  */
-const RUNNER_OPTIONS = [
+const HARNESS_OPTIONS = [
     { value: 'github-copilot', label: 'GitHub Copilot' },
     { value: 'openai-codex', label: 'OpenAI Codex' },
     { value: 'claude-code', label: 'Claude Code' },
@@ -48,7 +48,7 @@ const RUNNER_OPTIONS = [
 ] as const;
 
 /**
- * Contextual UI copy for the runner authentication terminal.
+ * Contextual UI copy for the harness authentication terminal.
  */
 const AUTHENTICATION_HINTS: Record<string, string> = {
     'github-copilot':
@@ -60,20 +60,58 @@ const AUTHENTICATION_HINTS: Record<string, string> = {
     opencode:
         'Start the terminal and complete the Opencode authentication flow directly there, including any browser/device confirmation, then exit the CLI.',
     gemini:
-        'Start the terminal and complete the Gemini CLI authentication prompts there, then exit the CLI after it confirms that the runner is ready.',
+        'Start the terminal and complete the Gemini CLI authentication prompts there, then exit the CLI after it confirms that the harness is ready.',
 };
 
 /**
- * Shared input styling for code-runner controls.
+ * Shared input styling for harness controls.
  */
 const INPUT_CLASS_NAME =
     'w-full rounded-md border border-gray-300 px-3 py-2 text-sm text-gray-900 shadow-sm focus:border-blue-500 focus:outline-none focus:ring-2 focus:ring-blue-200 disabled:bg-gray-50 disabled:text-gray-500';
 
 /**
- * Client UI for configuring the local coding runner used by durable chats.
+ * Shared plain-output text styling for non-interactive harness command results.
  */
-export function CodeRunnersClient() {
-    const [agent, setAgent] = useState('github-copilot');
+const HARNESS_PLAIN_OUTPUT_TEXT_CLASS_NAME =
+    'whitespace-pre-wrap break-words font-mono text-xs leading-5 text-slate-600';
+
+/**
+ * Props for the non-terminal harness output block.
+ */
+type HarnessPlainOutputBlockProps = {
+    /**
+     * Visible output heading.
+     */
+    readonly title: string;
+
+    /**
+     * Plain output text to show.
+     */
+    readonly output: string;
+
+    /**
+     * Optional max-height and overflow classes for longer output.
+     */
+    readonly outputSizeClassName?: string;
+};
+
+/**
+ * Plain text command output block used when an interactive terminal would be misleading.
+ */
+function HarnessPlainOutputBlock({ title, output, outputSizeClassName = '' }: HarnessPlainOutputBlockProps) {
+    return (
+        <div className="rounded-lg border border-slate-200 bg-slate-50 px-4 py-3">
+            <p className="text-sm font-semibold text-slate-700">{title}</p>
+            <pre className={`mt-2 ${outputSizeClassName} ${HARNESS_PLAIN_OUTPUT_TEXT_CLASS_NAME}`}>{output}</pre>
+        </div>
+    );
+}
+
+/**
+ * Client UI for configuring the local harness used by durable chats.
+ */
+export function HarnessAuthClient() {
+    const [harness, setHarness] = useState('github-copilot');
     const [model, setModel] = useState('gpt-5.4');
     const [thinkingLevel, setThinkingLevel] = useState('xhigh');
     const [status, setStatus] = useState('');
@@ -82,15 +120,15 @@ export function CodeRunnersClient() {
     const [configurationErrorMessage, setConfigurationErrorMessage] = useState<string | null>(null);
     const [configurationSuccessMessage, setConfigurationSuccessMessage] = useState<string | null>(null);
     const [applyOutput, setApplyOutput] = useState<string | null>(null);
-    const authenticationTerminal = useAdminTerminalSession<CodeRunnerAuthenticationSession>({
-        basePath: '/api/admin/code-runners/authentication',
+    const authenticationTerminal = useAdminTerminalSession<HarnessAuthenticationSession>({
+        basePath: HARNESS_AUTHENTICATION_API_PATH,
         loadErrorMessage: 'Failed to load the authentication session.',
         startErrorMessage: 'Failed to start the authentication session.',
         sendErrorMessage: 'Failed to send authentication input.',
         stopErrorMessage: 'Failed to stop the authentication session.',
-        startSuccessMessage: 'Runner authentication terminal started.',
-        finishSuccessMessage: 'Runner authentication finished.',
-        finishErrorMessage: 'Runner authentication session ended with an error.',
+        startSuccessMessage: 'Harness authentication terminal started.',
+        finishSuccessMessage: 'Harness authentication finished.',
+        finishErrorMessage: 'Harness authentication session ended with an error.',
     });
     const {
         session: authenticationSession,
@@ -106,27 +144,27 @@ export function CodeRunnersClient() {
         stopSession: stopAuthenticationSession,
     } = authenticationTerminal;
     const authenticationHint =
-        AUTHENTICATION_HINTS[agent] ||
-        'Start the terminal, complete the runner authentication flow there, and exit the CLI when the runner is ready.';
+        AUTHENTICATION_HINTS[harness] ||
+        'Start the terminal, complete the harness authentication flow there, and exit the CLI when the harness is ready.';
     const errorMessage = configurationErrorMessage ?? authenticationErrorMessage;
     const successMessage = configurationSuccessMessage ?? authenticationSuccessMessage;
 
     /**
-     * Loads current code-runner settings.
+     * Loads current harness settings.
      */
     const loadConfiguration = useCallback(async (): Promise<void> => {
         try {
             setIsLoading(true);
             setConfigurationErrorMessage(null);
 
-            const response = await fetch('/api/admin/code-runners', { cache: 'no-store' });
-            const payload = (await response.json()) as CodeRunnersResponse;
+            const response = await fetch(HARNESS_AUTH_API_PATH, { cache: 'no-store' });
+            const payload = (await response.json()) as HarnessAuthResponse;
 
             if (!response.ok) {
-                throw new Error(payload.error || 'Failed to load code-runner configuration.');
+                throw new Error(payload.error || 'Failed to load harness configuration.');
             }
 
-            setAgent(payload.agent || 'github-copilot');
+            setHarness(payload.harness || 'github-copilot');
             setModel(payload.model || 'gpt-5.4');
             setThinkingLevel(payload.thinkingLevel || 'xhigh');
             setStatus(payload.status || '');
@@ -134,7 +172,7 @@ export function CodeRunnersClient() {
             await loadAuthenticationSession();
         } catch (error) {
             setConfigurationErrorMessage(
-                error instanceof Error ? error.message : 'Failed to load code-runner configuration.',
+                error instanceof Error ? error.message : 'Failed to load harness configuration.',
             );
         } finally {
             setIsLoading(false);
@@ -154,7 +192,7 @@ export function CodeRunnersClient() {
     }, [authenticationSession?.finishedAt, loadConfiguration]);
 
     /**
-     * Saves code-runner settings into `.env`.
+     * Saves harness settings into `.env`.
      */
     async function saveConfiguration(applyRuntimeConfiguration: boolean): Promise<void> {
         try {
@@ -164,32 +202,32 @@ export function CodeRunnersClient() {
             clearAuthenticationMessages();
             setApplyOutput(null);
 
-            const response = await fetch('/api/admin/code-runners', {
+            const response = await fetch(HARNESS_AUTH_API_PATH, {
                 method: 'PATCH',
                 headers: {
                     'Content-Type': 'application/json',
                 },
-                body: JSON.stringify({ agent, model, thinkingLevel, applyRuntimeConfiguration }),
+                body: JSON.stringify({ harness, model, thinkingLevel, applyRuntimeConfiguration }),
             });
-            const payload = (await response.json()) as CodeRunnersResponse;
+            const payload = (await response.json()) as HarnessAuthResponse;
 
             if (!response.ok) {
-                throw new Error(payload.error || 'Failed to save code-runner configuration.');
+                throw new Error(payload.error || 'Failed to save harness configuration.');
             }
 
-            setAgent(payload.agent || agent);
+            setHarness(payload.harness || harness);
             setModel(payload.model || model);
             setThinkingLevel(payload.thinkingLevel || thinkingLevel);
             setStatus(payload.status || '');
             setApplyOutput(payload.applyResult?.output || null);
             setConfigurationSuccessMessage(
                 applyRuntimeConfiguration
-                    ? 'Code-runner configuration was saved and applied.'
-                    : 'Code-runner configuration was saved.',
+                    ? 'Harness configuration was saved and applied.'
+                    : 'Harness configuration was saved.',
             );
         } catch (error) {
             setConfigurationErrorMessage(
-                error instanceof Error ? error.message : 'Failed to save code-runner configuration.',
+                error instanceof Error ? error.message : 'Failed to save harness configuration.',
             );
         } finally {
             setIsSaving(false);
@@ -199,9 +237,10 @@ export function CodeRunnersClient() {
     return (
         <div className="container mx-auto space-y-6 px-4 py-8">
             <div className="mt-20">
-                <h1 className="text-3xl font-light text-gray-900">Code runners</h1>
+                <h1 className="text-3xl font-light text-gray-900">Harness Auth</h1>
                 <p className="mt-1 text-sm text-gray-500">
-                    Configure the local runner used by the standalone Agents Server durable chat worker.
+                    Configure the harness used by the standalone Agents Server durable chat worker and sign in to
+                    subscription-backed CLIs such as OpenAI Codex.
                 </p>
             </div>
 
@@ -219,14 +258,14 @@ export function CodeRunnersClient() {
             <Card className="hover:border-gray-200 hover:shadow-md">
                 <div className="grid gap-5 md:grid-cols-3">
                     <label className="space-y-2">
-                        <span className="text-sm font-semibold text-slate-700">Runner</span>
+                        <span className="text-sm font-semibold text-slate-700">Harness</span>
                         <select
-                            value={agent}
-                            onChange={(event) => setAgent(event.target.value)}
+                            value={harness}
+                            onChange={(event) => setHarness(event.target.value)}
                             disabled={isLoading || isSaving || isStartingAuthentication}
                             className={INPUT_CLASS_NAME}
                         >
-                            {RUNNER_OPTIONS.map((option) => (
+                            {HARNESS_OPTIONS.map((option) => (
                                 <option key={option.value} value={option.value}>
                                     {option.label}
                                 </option>
@@ -263,7 +302,7 @@ export function CodeRunnersClient() {
                         className="inline-flex items-center gap-2 rounded-md bg-blue-600 px-4 py-2 text-sm font-semibold text-white hover:bg-blue-700 disabled:cursor-not-allowed disabled:opacity-60"
                     >
                         {isSaving ? <Loader2 className="h-4 w-4 animate-spin" /> : <Save className="h-4 w-4" />}
-                        Save runner
+                        Save harness
                     </button>
                     <button
                         type="button"
@@ -272,26 +311,29 @@ export function CodeRunnersClient() {
                         className="inline-flex items-center gap-2 rounded-md border border-slate-300 bg-white px-4 py-2 text-sm font-semibold text-slate-700 hover:bg-slate-50 disabled:cursor-not-allowed disabled:opacity-60"
                     >
                         {isSaving ? <Loader2 className="h-4 w-4 animate-spin" /> : <ServerCog className="h-4 w-4" />}
-                        Save and apply runner
+                        Save and apply harness
                     </button>
                 </div>
+
+                <div className="mt-6">
+                    <HarnessPlainOutputBlock
+                        title="Harness status"
+                        output={status || 'Harness status was not available.'}
+                    />
+                </div>
             </Card>
 
             {applyOutput ? (
-                <AdminXtermTerminal
-                    terminalId="code-runner-apply-output"
+                <HarnessPlainOutputBlock
+                    title="Harness apply output"
                     output={applyOutput}
-                    emptyState="No apply output returned."
-                    isReadOnly
-                    isPlainTextOutput
-                    heightClassName="h-72"
-                    ariaLabel="Code-runner apply output"
+                    outputSizeClassName="max-h-72 overflow-auto"
                 />
             ) : null}
 
             <AdminTerminalCard
                 title="Authentication"
-                description="Save runner changes first if you want to authenticate a different CLI, then start the saved-runner terminal here instead of SSHing into the VPS."
+                description="Save harness changes first if you want to authenticate a different CLI, then start the saved-harness terminal here instead of SSHing into the VPS."
                 hint={authenticationHint}
                 session={authenticationSession}
                 onStart={() => void startAuthenticationSession()}
@@ -301,23 +343,14 @@ export function CodeRunnersClient() {
                 isStarting={isStartingAuthentication}
                 isSending={isSendingAuthenticationInput}
                 isStopping={isStoppingAuthentication}
-                startLabel="Authenticate saved runner"
+                startLabel="Authenticate saved harness"
                 runningLabel="Authentication running"
                 stopLabel="Stop terminal"
                 outputLabel="Live authentication terminal"
-                outputEmptyState="No authentication session output yet. Start the saved-runner terminal to see the live authentication log here."
+                outputEmptyState="No authentication session output yet. Start the saved-harness terminal to see the live authentication log here."
+                isOutputVisible={Boolean(authenticationSession?.isRunning)}
                 quickActions={[{ label: 'Send Enter', input: '\n' }]}
-            >
-                <AdminXtermTerminal
-                    terminalId="code-runner-status"
-                    output={status || 'Runner status was not available.'}
-                    emptyState="Runner status was not available."
-                    isReadOnly
-                    isPlainTextOutput
-                    heightClassName="h-64"
-                    ariaLabel="Runner status"
-                />
-            </AdminTerminalCard>
+            />
         </div>
     );
 }

package/apps/agents-server/src/app/admin/{code-runners → harness-auth}/page.tsx

@@ -1,14 +1,14 @@
 import { ForbiddenPage } from '../../../components/ForbiddenPage/ForbiddenPage';
 import { isUserGlobalAdmin } from '../../../utils/isUserGlobalAdmin';
-import { CodeRunnersClient } from './CodeRunnersClient';
+import { HarnessAuthClient } from './HarnessAuthClient';
 
 /**
- * Super-admin page for configuring standalone code runners.
+ * Super-admin page for configuring standalone harness authentication.
  */
-export default async function CodeRunnersPage() {
+export default async function HarnessAuthPage() {
     if (!(await isUserGlobalAdmin())) {
         return <ForbiddenPage />;
     }
 
-    return <CodeRunnersClient />;
+    return <HarnessAuthClient />;
 }