@promptbook/cli 0.114.0-35 → 0.114.0-39

package/agents/default/.core/adam.book

@@ -0,0 +1,33 @@
+Adam
+
+
+META VISIBILITY PRIVATE
+
+FROM @Void
+
+
+META COLOR #ff0b0bff
+META FONT Playfair Display, sans-serif
+PERSONA You are a helpful, honest, and intelligent AI assistant. Your goal is to provide accurate, clear, and concise responses while being friendly and engaging. Think step-by-step before answering complex questions.
+RULE If you're unsure about something, say so and offer to look it up or clarify.
+RULE You can use Markdown formatting in the messages like **bold** or *italic*
+RULE You can use Markdown code blocks if needed
+
+For example:
+
+```javascript
+console.log('Hello');
+```
+
+
+
+CLOSED
+
+
+
+
+
+
+
+
+

package/apps/agents-server/package.json

@@ -8,7 +8,7 @@
         "test": "npm run test-e2e",
         "test-e2e": "node ./scripts/run-e2e-tests.js",
         "pretest-build": "node ./scripts/kill-port.js 4021 4440",
-        "test-build": "npm run build",
+        "test-build": "npm run build -- --no-sentry-upload",
         "pretest-e2e": "node ./scripts/kill-port.js 4021 4440",
         "build": "node ./scripts/build-agents-server.js",
         "build-e2e": "node ./scripts/build-e2e.js",

package/apps/agents-server/scripts/build-agents-server.js

@@ -25,6 +25,8 @@ const AGENTS_SERVER_BUILD_MAX_OLD_SPACE_MIB = 8192;
  * lint command has already completed successfully. The optional `--no-homepage-prerender`
  * argument is used by builds whose caller starts the very same production server right
  * afterwards, which makes the extra prerender server a repetition of that work.
+ * Test builds pass `--no-sentry-upload` to avoid publishing source maps and creating
+ * temporary upload bundles with credentials from the local `.env` file.
  */
 function buildAgentsServer() {
     const nextBuildArguments = [
@@ -44,6 +46,8 @@ function buildAgentsServer() {
         //       the build process which spawned it. The same merge is done for the CLI-owned
         //       production build in `src/cli/cli-commands/agents-server/buildAgentsServer/runNextBuild.ts`.
         NODE_OPTIONS: mergeNodeOptionsWithHeapSize(process.env.NODE_OPTIONS, AGENTS_SERVER_BUILD_MAX_OLD_SPACE_MIB),
+        // An empty value also prevents Next.js from loading an upload token from `.env`.
+        ...(process.argv.includes('--no-sentry-upload') ? { SENTRY_AUTH_TOKEN: '' } : {}),
     });
 
     if (!process.argv.includes('--no-homepage-prerender')) {

package/apps/agents-server/scripts/build-e2e.js

@@ -17,7 +17,7 @@ const APP_ROOT = path.resolve(__dirname, '..');
  * is compiled, and the tests open the homepage against that very same server, so the snapshot would
  * only repeat work the tests already do.
  */
-const E2E_BUILD_ARGUMENTS = ['--no-homepage-prerender'];
+const E2E_BUILD_ARGUMENTS = ['--no-homepage-prerender', '--no-sentry-upload'];
 
 /**
  * Builds the production bundle used by the Agents Server E2E tests.

package/apps/agents-server/src/app/swagger/SwaggerPageClient.tsx

@@ -1,7 +1,7 @@
 'use client';
 
-import { type ComponentType, useEffect, useState } from 'react';
-import 'swagger-ui-react/swagger-ui.css';
+import { useEffect, useRef, useState } from 'react';
+import 'swagger-ui-dist/swagger-ui.css';
 import { SwaggerApiKeysPanel } from './SwaggerApiKeysPanel';
 
 /**
@@ -18,26 +18,43 @@ type SwaggerPageClientProps = {
  * Renders the runtime-generated Swagger UI and the compact API-key helper panel.
  */
 export function SwaggerPageClient({ isAdmin }: SwaggerPageClientProps) {
-    const [SwaggerUI, setSwaggerUI] = useState<ComponentType<{
-        url: string;
-        persistAuthorization?: boolean;
-        defaultModelsExpandDepth?: number;
-        docExpansion?: 'list' | 'full' | 'none';
-    }> | null>(null);
+    const containerRef = useRef<HTMLDivElement>(null);
+    const [isLoading, setIsLoading] = useState(true);
+    const [hasLoadError, setHasLoadError] = useState(false);
 
     useEffect(() => {
         let isMounted = true;
+        const container = containerRef.current;
 
         void (async () => {
-            const swaggerUiModule = await import('swagger-ui-react');
+            try {
+                // Import the browser bundle directly; the package entry point also imports Node.js helpers.
+                const { default: SwaggerUIBundle } = await import('swagger-ui-dist/swagger-ui-bundle.js');
 
-            if (isMounted) {
-                setSwaggerUI(() => swaggerUiModule.default);
+                if (!isMounted || !container) {
+                    return;
+                }
+
+                SwaggerUIBundle({
+                    domNode: container,
+                    url: '/openapi.json',
+                    persistAuthorization: true,
+                    defaultModelsExpandDepth: -1,
+                    docExpansion: 'list',
+                });
+                setIsLoading(false);
+            } catch (error) {
+                if (isMounted) {
+                    console.error('Failed to load Swagger UI:', error);
+                    setHasLoadError(true);
+                    setIsLoading(false);
+                }
             }
         })();
 
         return () => {
             isMounted = false;
+            container?.replaceChildren();
         };
     }, []);
 
@@ -47,16 +64,15 @@ export function SwaggerPageClient({ isAdmin }: SwaggerPageClientProps) {
                 <SwaggerApiKeysPanel isAdmin={isAdmin} />
             </div>
             <div className="swagger-container bg-white min-h-screen">
-                {SwaggerUI ? (
-                    <SwaggerUI
-                        url="/openapi.json"
-                        persistAuthorization
-                        defaultModelsExpandDepth={-1}
-                        docExpansion="list"
-                    />
-                ) : (
+                {isLoading && (
                     <div className="mx-auto max-w-7xl px-4 py-10 text-sm text-slate-500">Loading Swagger UI...</div>
                 )}
+                {hasLoadError && (
+                    <div role="alert" className="mx-auto max-w-7xl px-4 py-10 text-sm text-red-600">
+                        Failed to load Swagger UI. Please reload the page.
+                    </div>
+                )}
+                <div ref={containerRef} />
             </div>
         </div>
     );

package/apps/agents-server/src/types/swagger-ui-dist.d.ts

@@ -0,0 +1,5 @@
+declare module 'swagger-ui-dist/swagger-ui-bundle.js' {
+    import { SwaggerUIBundle } from 'swagger-ui-dist';
+
+    export default SwaggerUIBundle;
+}

package/apps/agents-server/src/utils/agentReferenceResolver/AgentReferenceResolutionIssue.ts

@@ -1,69 +1 @@
-import type { BookCommitment } from '../../../../../src/commitments/_base/BookCommitment';
-import type { AgentReferenceResolver } from '../../../../../src/book-2.0/agent-source/AgentReferenceResolver';
-
-/**
- * Structured issue captured when compact agent reference resolution fails.
- */
-export type AgentReferenceResolutionIssue = {
-    /**
-     * Commitment where the unresolved token appeared.
-     */
-    readonly commitmentType: BookCommitment;
-
-    /**
-     * Original token text (for example `{Unknown Agent}` or `@UnknownAgent`).
-     */
-    readonly token: string;
-
-    /**
-     * Normalized token payload used for lookup.
-     */
-    readonly reference: string;
-
-    /**
-     * Human-readable explanation of why the token could not be resolved.
-     */
-    readonly message: string;
-};
-
-/**
- * Extension implemented by resolvers that can expose accumulated resolution issues.
- */
-export type IssueTrackingAgentReferenceResolver = AgentReferenceResolver & {
-    /**
-     * Returns tracked issues and clears the internal queue.
-     */
-    consumeResolutionIssues(): Array<AgentReferenceResolutionIssue>;
-};
-
-/**
- * Type guard for issue-tracking resolver implementations.
- *
- * @param resolver - Resolver instance to check.
- * @returns True when the resolver provides `consumeResolutionIssues`.
- */
-function isIssueTrackingAgentReferenceResolver(
-    resolver: AgentReferenceResolver,
-): resolver is IssueTrackingAgentReferenceResolver {
-    return typeof (resolver as Partial<IssueTrackingAgentReferenceResolver>).consumeResolutionIssues === 'function';
-}
-
-/**
- * Drains unresolved compact-reference issues from a resolver when supported.
- *
- * @param resolver - Resolver instance that may implement issue tracking.
- * @returns Collected issues or an empty list.
- */
-export function consumeAgentReferenceResolutionIssues(
-    resolver?: AgentReferenceResolver,
-): Array<AgentReferenceResolutionIssue> {
-    if (!resolver) {
-        return [];
-    }
-
-    if (!isIssueTrackingAgentReferenceResolver(resolver)) {
-        return [];
-    }
-
-    return resolver.consumeResolutionIssues();
-}
+export * from '../../../../../src/book-2.0/agent-source/AgentReferenceResolutionIssue';

package/apps/agents-server/src/utils/agentReferenceResolver/extractAgentReferenceTokens.ts

@@ -1,61 +1 @@
-/**
- * Matched compact agent reference token inside commitment content.
- */
-export type AgentReferenceTokenMatch = {
-    /**
-     * Original token text, for example `{Agent Name}` or `@AgentId`.
-     */
-    readonly token: string;
-
-    /**
-     * Token payload used for lookup.
-     */
-    readonly reference: string;
-
-    /**
-     * Zero-based character offset of `token` in the scanned content.
-     */
-    readonly index: number;
-
-    /**
-     * Length of `token` in characters.
-     */
-    readonly length: number;
-};
-
-/**
- * Matches supported compact reference token syntaxes in commitment content.
- */
-const AGENT_REFERENCE_TOKEN_REGEX = /(\{([^}]+)\}|@([A-Za-z0-9_-]+))/g;
-
-/**
- * Extracts compact agent-reference tokens from commitment content.
- *
- * @param content - Commitment content to inspect.
- * @returns Matched compact reference tokens.
- */
-export function extractAgentReferenceTokens(content: string): Array<AgentReferenceTokenMatch> {
-    const matches: Array<AgentReferenceTokenMatch> = [];
-    let match: RegExpExecArray | null;
-
-    AGENT_REFERENCE_TOKEN_REGEX.lastIndex = 0;
-
-    while ((match = AGENT_REFERENCE_TOKEN_REGEX.exec(content)) !== null) {
-        const token = match[1];
-        const reference = (match[2] ?? match[3] ?? '').trim();
-        const index = match.index;
-
-        if (!token || index === undefined) {
-            continue;
-        }
-
-        matches.push({
-            token,
-            reference,
-            index,
-            length: token.length,
-        });
-    }
-
-    return matches;
-}
+export * from '../../../../../src/book-2.0/agent-source/extractAgentReferenceTokens';

package/apps/agents-server/src/utils/explicitFromCommitment.ts

@@ -1,130 +1 @@
-import type { string_book } from '../../../../src/_packages/types.index'; // <- [🚾]
-
-/**
- * Commitment keyword that declares the parent agent of one book.
- *
- * @private utility of Agents Server inheritance resolution
- */
-const FROM_COMMITMENT_TYPE = 'FROM';
-
-/**
- * Matches one standalone `FROM` commitment line and captures its inline content.
- *
- * The Book parser accepts horizontal whitespace between a commitment keyword and its value, so inheritance resolution
- * must do the same. Keeping this pattern here makes every server-side consumer agree on which `FROM` lines are real.
- *
- * @private utility of Agents Server inheritance resolution
- */
-const FROM_COMMITMENT_LINE_PATTERN = new RegExp(`^${FROM_COMMITMENT_TYPE}(?:\\s+(.*))?$`);
-
-/**
- * One explicit `FROM` commitment written in a book.
- *
- * @private utility of Agents Server inheritance resolution
- */
-export type ExplicitFromCommitment = {
-    /**
-     * Zero-based index of the line the commitment was found on, within the scanned lines.
-     */
-    readonly lineIndex: number;
-
-    /**
-     * Trimmed commitment content, empty string for a blank `FROM`.
-     */
-    readonly content: string;
-};
-
-/**
- * Collects every explicit single-line `FROM` commitment of one book.
- *
- * This lightweight parser is intentionally limited to the subset needed by inheritance
- * resolution so it stays safe to bundle into the Next.js proxy path.
- *
- * @param sourceLines - Book source already split into lines.
- * @returns Found `FROM` commitments in source order, empty when the book declares no parent.
- *
- * @private utility of Agents Server inheritance resolution
- */
-export function collectExplicitFromCommitments(
-    sourceLines: ReadonlyArray<string>,
-): ReadonlyArray<ExplicitFromCommitment> {
-    const explicitFromCommitments: Array<ExplicitFromCommitment> = [];
-    let hasSeenTitle = false;
-    let isInsideCodeBlock = false;
-
-    for (let lineIndex = 0; lineIndex < sourceLines.length; lineIndex++) {
-        const trimmedLine = (sourceLines[lineIndex] || '').trim();
-
-        if (!hasSeenTitle) {
-            if (!trimmedLine) {
-                continue;
-            }
-
-            hasSeenTitle = true;
-            continue;
-        }
-
-        if (trimmedLine.startsWith('```')) {
-            isInsideCodeBlock = !isInsideCodeBlock;
-            continue;
-        }
-
-        if (isInsideCodeBlock) {
-            continue;
-        }
-
-        const fromCommitmentMatch = FROM_COMMITMENT_LINE_PATTERN.exec(trimmedLine);
-        if (fromCommitmentMatch) {
-            explicitFromCommitments.push({
-                lineIndex,
-                content: (fromCommitmentMatch[1] || '').trim(),
-            });
-        }
-    }
-
-    return explicitFromCommitments;
-}
-
-/**
- * Returns the effective explicit `FROM` commitment of one book.
- *
- * A book may repeat `FROM`, in which case the last one wins and overrides every earlier one.
- *
- * @param agentSource - Raw book source.
- * @returns The last explicit `FROM` commitment, or `undefined` when the book declares no parent.
- *
- * @private utility of Agents Server inheritance resolution
- */
-export function getEffectiveExplicitFromCommitment(agentSource: string_book): ExplicitFromCommitment | undefined {
-    const explicitFromCommitments = collectExplicitFromCommitments(agentSource.split(/\r?\n/));
-    return explicitFromCommitments[explicitFromCommitments.length - 1];
-}
-
-/**
- * Returns the effective explicit `FROM` commitment content of one book.
- *
- * A book may repeat `FROM`, in which case the last one wins and overrides every earlier one.
- *
- * @param agentSource - Raw book source.
- * @returns Trimmed commitment content, empty string for a blank explicit `FROM`, or `undefined` when `FROM` is absent.
- *
- * @private utility of Agents Server inheritance resolution
- */
-export function getExplicitFromCommitmentContent(agentSource: string_book): string | undefined {
-    return getEffectiveExplicitFromCommitment(agentSource)?.content;
-}
-
-/**
- * Returns true when one book declares no parent at all and therefore implicitly inherits from `@Adam`.
- *
- * Writing no `FROM` commitment is equivalent to writing `FROM @Adam`, so only an explicit
- * `FROM @Null` / `FROM {Void}` turns the inheritance off.
- *
- * @param agentSource - Raw book source.
- * @returns True when the implicit `@Adam` ancestor applies to this book.
- *
- * @private utility of Agents Server inheritance resolution
- */
-export function isImplicitAdamInheritance(agentSource: string_book): boolean {
-    return getExplicitFromCommitmentContent(agentSource) === undefined;
-}
+export * from '../../../../src/book-2.0/agent-source/explicitFromCommitment';