@promptbook/cli 0.112.0-111 → 0.112.0-113

package/README.md

@@ -561,11 +561,11 @@ npx ts-node ./src/cli/test/ptbk.ts coder generate-boilerplates --template prompt
 
 npx ts-node ./src/cli/test/ptbk.ts coder generate-boilerplates --template prompts/templates/agents-server.md
 
-npx ts-node ./src/cli/test/ptbk.ts coder run --agent github-copilot --model gpt-5.4 --thinking-level xhigh --context AGENTS.md
+npx ts-node ./src/cli/test/ptbk.ts coder run --harness github-copilot --model gpt-5.4 --thinking-level xhigh --context AGENTS.md
 
-npx ts-node ./src/cli/test/ptbk.ts coder run --agent github-copilot --model gpt-5.4 --thinking-level xhigh --context AGENTS.md --auto-push
+npx ts-node ./src/cli/test/ptbk.ts coder run --harness github-copilot --model gpt-5.4 --thinking-level xhigh --context AGENTS.md --auto-push
 
-npx ts-node ./src/cli/test/ptbk.ts coder run --agent github-copilot --model gpt-5.4 --thinking-level xhigh --context AGENTS.md --ignore-git-changes --no-wait
+npx ts-node ./src/cli/test/ptbk.ts coder run --harness github-copilot --model gpt-5.4 --thinking-level xhigh --context AGENTS.md --ignore-git-changes --no-wait
 
 npx ts-node ./src/cli/test/ptbk.ts coder find-refactor-candidates
 
@@ -587,11 +587,11 @@ ptbk coder generate-boilerplates
 
 ptbk coder generate-boilerplates --template prompts/templates/common.md
 
-ptbk coder run --agent github-copilot --model gpt-5.4 --thinking-level xhigh --context AGENTS.md --test npm run test
+ptbk coder run --harness github-copilot --model gpt-5.4 --thinking-level xhigh --context AGENTS.md --test npm run test
 
-ptbk coder run --agent github-copilot --model gpt-5.4 --thinking-level xhigh --context AGENTS.md --auto-push
+ptbk coder run --harness github-copilot --model gpt-5.4 --thinking-level xhigh --context AGENTS.md --auto-push
 
-ptbk coder run --agent github-copilot --model gpt-5.4 --thinking-level xhigh --context AGENTS.md --test npm run test --ignore-git-changes --no-wait
+ptbk coder run --harness github-copilot --model gpt-5.4 --thinking-level xhigh --context AGENTS.md --test npm run test --ignore-git-changes --no-wait
 
 ptbk coder find-refactor-candidates
 
@@ -616,7 +616,7 @@ ptbk coder verify
 
 | Flag                       | Purpose                                                                                            |
 | -------------------------- | -------------------------------------------------------------------------------------------------- |
-| `--agent <name>`           | Selects the coding backend.                                                                        |
+| `--harness <name>`         | Selects the coding harness.                                                                        |
 | `--model <model>`          | Chooses the runner model; required for `openai-codex` and `gemini`, optional for `github-copilot`. |
 | `--context <text-or-file>` | Appends extra instructions inline or from a file like `AGENTS.md`.                                 |
 | `--test <command>`         | Runs a verification command after each prompt attempt and feeds failing output back for retries.   |

package/apps/agents-server/README.md

@@ -9,7 +9,7 @@ The installed CLI can initialize a local Agents Server project before it starts
 ```bash
 npm install ptbk
 ptbk agents-server init
-ptbk agents-server start --agent github-copilot --model gpt-5.4 --thinking-level xhigh
+ptbk agents-server start --harness github-copilot --model gpt-5.4 --thinking-level xhigh
 ```
 
 `ptbk agents-server init` adds missing placeholders to `.env` and local runtime exclusions to `.gitignore` without deleting existing configuration. Use `PTBK_AGENTS_SERVER_DATABASE=supabase` for a Supabase-backed server or `PTBK_AGENTS_SERVER_DATABASE=sqlite` for a standalone local database in `.promptbook`. When using Supabase, fill the initialized values from your project before starting the server. The Supabase project URL and API keys are available in the [Supabase project API settings](https://supabase.com/docs/guides/api/api-keys), and the PostgreSQL connection string is available from the [Supabase database connection guide](https://supabase.com/docs/guides/database/connecting-to-postgres).

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

@@ -1,6 +1,8 @@
+import { withSentryConfig } from '@sentry/nextjs';
 import type { NextConfig } from 'next';
 import { readdirSync } from 'fs';
 import path from 'path';
+import { SENTRY_ORGANIZATION, SENTRY_PROJECT } from './src/utils/errorReporting/sentrySdkConfig';
 
 /**
  * Next.js build output directory.
@@ -20,6 +22,11 @@ const agentsServerNodeModulesPath = process.env.PTBK_AGENTS_SERVER_NODE_MODULES_
  */
 const isNextValidationIgnored = process.env.PTBK_AGENTS_SERVER_IGNORE_NEXT_VALIDATION === 'true';
 
+/**
+ * Whether Sentry source maps can be uploaded during production builds.
+ */
+const IS_SENTRY_SOURCE_MAP_UPLOAD_ENABLED = Boolean(process.env.SENTRY_AUTH_TOKEN);
+
 /**
  * Exact aliases for local generated Promptbook package entrypoints.
  */
@@ -122,7 +129,19 @@ const nextConfig: NextConfig = {
     },
 };
 
-export default nextConfig;
+export default withSentryConfig(nextConfig, {
+    org: SENTRY_ORGANIZATION,
+    project: SENTRY_PROJECT,
+    silent: true,
+    sourcemaps: {
+        disable: !IS_SENTRY_SOURCE_MAP_UPLOAD_ENABLED,
+    },
+    webpack: {
+        treeshake: {
+            removeDebugLogging: true,
+        },
+    },
+});
 
 /**
  * Creates webpack/Turbopack aliases from imports like `@promptbook-local/core` to generated local sources.

package/apps/agents-server/src/app/admin/servers/CreateServerDialog.tsx

@@ -203,6 +203,22 @@ function CreateServerForm(props: {
                 ) : null}
             </div>
 
+            <div className="rounded-lg border border-gray-200 bg-gray-50 p-4 text-sm text-gray-600">
+                <label htmlFor="create-server-default-agents" className="flex items-start gap-3">
+                    <input
+                        id="create-server-default-agents"
+                        type="checkbox"
+                        checked={wizardState.isDefaultAgentsInstalled}
+                        onChange={(event) => updateWizardField('isDefaultAgentsInstalled', event.target.checked)}
+                        className="mt-0.5 h-4 w-4 rounded border-gray-300 text-blue-600 focus:ring-blue-500"
+                    />
+                    <span>
+                        <span className="block font-semibold text-gray-900">Install default agents</span>
+                        <span className="mt-1 block">Create bundled starter agents from agents/default.</span>
+                    </span>
+                </label>
+            </div>
+
             <div className="rounded-lg border border-gray-200 bg-gray-50 p-4 text-sm text-gray-600">
                 <p className="font-semibold text-gray-900">Admin user exists</p>
                 <p className="mt-1">

package/apps/agents-server/src/app/admin/servers/useCreateServerWizard.ts

@@ -121,6 +121,11 @@ export type CreateServerWizardState = {
      */
     additionalUsers: WizardUser[];
 
+    /**
+     * Whether bundled default agents should be installed during server creation.
+     */
+    isDefaultAgentsInstalled: boolean;
+
     /**
      * Initial metadata values.
      */
@@ -155,7 +160,10 @@ export type CreateServerWizardError = {
  * @private function of <ServersClient/>
  */
 export type UpdateCreateServerWizardField = <
-    TFieldName extends keyof Pick<CreateServerWizardState, 'name' | 'domain' | 'iconUrl'>,
+    TFieldName extends keyof Pick<
+        CreateServerWizardState,
+        'name' | 'domain' | 'iconUrl' | 'isDefaultAgentsInstalled'
+    >,
 >(
     fieldName: TFieldName,
     value: CreateServerWizardState[TFieldName],
@@ -262,6 +270,7 @@ function createInitialWizardState(): CreateServerWizardState {
             password: '',
         },
         additionalUsers: [],
+        isDefaultAgentsInstalled: true,
         initialSettings: {
             language: 'en',
             homepageMessage: '',
@@ -345,7 +354,8 @@ function hasCreateServerWizardChanges(wizardState: CreateServerWizardState): boo
         wizardState.name !== initialWizardState.name ||
         wizardState.identifier !== initialWizardState.identifier ||
         wizardState.domain !== initialWizardState.domain ||
-        wizardState.iconUrl !== initialWizardState.iconUrl
+        wizardState.iconUrl !== initialWizardState.iconUrl ||
+        wizardState.isDefaultAgentsInstalled !== initialWizardState.isDefaultAgentsInstalled
     );
 }
 
@@ -402,16 +412,32 @@ export function useCreateServerWizard(options: UseCreateServerWizardOptions): Us
     const updateWizardField = useCallback<UpdateCreateServerWizardField>((fieldName, value) => {
         setWizardState((previous) => {
             if (fieldName === 'name') {
+                const name = value as CreateServerWizardState['name'];
+
+                return {
+                    ...previous,
+                    name,
+                    identifier: createServerIdentifierFromName(name),
+                };
+            }
+
+            if (fieldName === 'domain') {
+                return {
+                    ...previous,
+                    domain: value as CreateServerWizardState['domain'],
+                };
+            }
+
+            if (fieldName === 'iconUrl') {
                 return {
                     ...previous,
-                    name: value,
-                    identifier: createServerIdentifierFromName(value),
+                    iconUrl: value as CreateServerWizardState['iconUrl'],
                 };
             }
 
             return {
                 ...previous,
-                [fieldName]: value,
+                isDefaultAgentsInstalled: value as CreateServerWizardState['isDefaultAgentsInstalled'],
             };
         });
     }, []);

package/apps/agents-server/src/app/api/admin/code-runners/route.ts

@@ -52,7 +52,7 @@ export async function PATCH(request: Request) {
         }
 
         await updateVpsEnvironmentVariables({
-            PTBK_AGENT: body.agent || '',
+            PTBK_HARNESS: body.agent || '',
             PTBK_MODEL: body.model || '',
             PTBK_THINKING_LEVEL: body.thinkingLevel || '',
         });

package/apps/agents-server/src/app/api/admin/servers/route.ts

@@ -2,6 +2,7 @@ import { NextResponse } from 'next/server';
 import { spaceTrim } from 'spacetrim';
 import { DatabaseError } from '../../../../../../../src/errors/DatabaseError';
 import { isAgentsServerSqliteMode } from '../../../../database/agentsServerDatabaseMode';
+import { seedDefaultAgents } from '../../../../database/seedDefaultAgents';
 import { resolveCurrentServerRegistryContext } from '../../../../utils/currentServerRegistryContext';
 import { isUserAdmin } from '../../../../utils/isUserAdmin';
 import { isUserGlobalAdmin } from '../../../../utils/isUserGlobalAdmin';
@@ -97,6 +98,7 @@ export async function POST(request: Request) {
 
         const body = withEnvironmentAdminUser((await request.json()) as CreateServerInput);
         if (isAgentsServerSqliteMode()) {
+            const isDefaultAgentsInstalled = body.isDefaultAgentsInstalled !== false;
             const normalizedDomain = normalizeServerDomain(body.domain);
             if (!normalizedDomain) {
                 return NextResponse.json({ error: 'A valid domain is required.' }, { status: 400 });
@@ -114,6 +116,9 @@ export async function POST(request: Request) {
                     iconUrl: body.iconUrl,
                 });
             }
+            if (isDefaultAgentsInstalled) {
+                await seedDefaultAgents({ tablePrefix });
+            }
 
             return NextResponse.json(
                 {

package/apps/agents-server/src/app/api/internal/user-chat-jobs/run/route.ts

@@ -57,7 +57,7 @@ async function handleUserChatJobWorkerRequest(request: Request) {
 
         after(() =>
             triggerUserChatJobWorker({ origin }).catch((error) =>
-                console.error('[user-chat-job] requeue failed', error),
+                console.warn('[user-chat-job] requeue failed', error),
             ),
         );
 

package/apps/agents-server/src/app/api/metadata/route.ts

@@ -2,6 +2,7 @@ import { NextRequest, NextResponse } from 'next/server';
 import { keepUnused } from '../../../../../../src/utils/organization/keepUnused';
 import { $getTableName } from '../../../database/$getTableName';
 import { $provideSupabase } from '../../../database/$provideSupabase';
+import { invalidateMetadataCache } from '../../../database/getMetadata';
 import { validateMetadataValue } from '../../../database/metadataDefaults';
 import { isUserAdmin } from '../../../utils/isUserAdmin';
 
@@ -121,6 +122,7 @@ export async function POST(request: NextRequest) {
         return NextResponse.json({ error: error.message }, { status: 500 });
     }
 
+    invalidateMetadataCache();
     return NextResponse.json(data);
 }
 
@@ -152,6 +154,7 @@ export async function PUT(request: NextRequest) {
         return NextResponse.json({ error: error.message }, { status: 500 });
     }
 
+    invalidateMetadataCache();
     return NextResponse.json(data);
 }
 
@@ -179,5 +182,6 @@ export async function DELETE(request: NextRequest) {
         return NextResponse.json({ error: error.message }, { status: 500 });
     }
 
+    invalidateMetadataCache();
     return NextResponse.json({ success: true });
 }

package/apps/agents-server/src/database/customJavascript.ts

@@ -14,6 +14,13 @@ export const MAX_CUSTOM_JAVASCRIPT_LENGTH = 100_000;
  */
 const CUSTOM_JAVASCRIPT_TABLE_BASENAME = 'CustomJavascript';
 
+/**
+ * Process-level cache lifetime for custom JavaScript rows.
+ *
+ * @private
+ */
+const CUSTOM_JAVASCRIPT_CACHE_TTL_MS = 30_000;
+
 /**
  * Stored `CustomJavascript` row shape.
  *
@@ -90,6 +97,28 @@ type DynamicSupabaseClient = {
     from: (tableName: string) => DynamicCustomJavascriptTableQuery;
 };
 
+/**
+ * Cached custom JavaScript rows keyed by the resolved table name.
+ *
+ * @private
+ */
+const cachedCustomJavascriptByTableName = new Map<
+    string,
+    {
+        readonly loadedAt: number;
+        readonly rowsPromise: Promise<CustomJavascriptRow[]>;
+    }
+>();
+
+/**
+ * Clears process-level custom JavaScript cache after admin writes.
+ *
+ * @private
+ */
+export function invalidateCustomJavascriptCache(): void {
+    cachedCustomJavascriptByTableName.clear();
+}
+
 /**
  * Resolves the prefixed table name for `CustomJavascript`.
  *
@@ -137,8 +166,37 @@ function getCustomJavascriptClient() {
  */
 export async function getCustomJavascriptFiles(): Promise<CustomJavascriptRow[]> {
     const table = await getCustomJavascriptTableName();
-    const supabase = getCustomJavascriptClient();
+    const cachedJavascript = cachedCustomJavascriptByTableName.get(table);
+    if (cachedJavascript && Date.now() - cachedJavascript.loadedAt < CUSTOM_JAVASCRIPT_CACHE_TTL_MS) {
+        return cachedJavascript.rowsPromise;
+    }
+
+    const rowsPromise = loadCustomJavascriptFilesFromDatabase(table);
+    cachedCustomJavascriptByTableName.set(table, {
+        loadedAt: Date.now(),
+        rowsPromise,
+    });
+
+    try {
+        return await rowsPromise;
+    } catch (error) {
+        if (cachedCustomJavascriptByTableName.get(table)?.rowsPromise === rowsPromise) {
+            cachedCustomJavascriptByTableName.delete(table);
+        }
+        throw error;
+    }
+}
 
+/**
+ * Reads custom JavaScript rows from the database.
+ *
+ * @param table - Resolved CustomJavascript table name.
+ * @returns Stored JavaScript rows.
+ *
+ * @private
+ */
+async function loadCustomJavascriptFilesFromDatabase(table: string): Promise<CustomJavascriptRow[]> {
+    const supabase = getCustomJavascriptClient();
     const { data, error } = await supabase.from(table).select('*').order('scope', { ascending: true });
 
     if (error) {
@@ -234,6 +292,7 @@ export async function saveCustomJavascriptFile({
         throw new Error(`Failed to save custom JavaScript: ${error.message || String(error)}`);
     }
 
+    invalidateCustomJavascriptCache();
     return data as CustomJavascriptRow;
 }
 
@@ -255,4 +314,6 @@ export async function deleteCustomJavascriptFile(id: number): Promise<void> {
 
         throw new Error(`Failed to delete custom JavaScript: ${error.message || String(error)}`);
     }
+
+    invalidateCustomJavascriptCache();
 }

package/apps/agents-server/src/database/customStylesheet.ts

@@ -7,6 +7,11 @@ import { $provideSupabase } from './$provideSupabase';
  */
 const CUSTOM_STYLESHEET_TABLE_BASENAME = 'CustomStylesheet';
 
+/**
+ * Process-level cache lifetime for custom stylesheet rows.
+ */
+const CUSTOM_STYLESHEET_CACHE_TTL_MS = 30_000;
+
 /**
  * Stored CustomStylesheet row shape.
  *
@@ -82,6 +87,28 @@ type DynamicSupabaseClient = {
     from: (tableName: string) => DynamicCustomStylesheetTableQuery;
 };
 
+/**
+ * Cached custom stylesheet rows keyed by the resolved table name.
+ *
+ * @private
+ */
+const cachedCustomStylesheetsByTableName = new Map<
+    string,
+    {
+        readonly loadedAt: number;
+        readonly rowsPromise: Promise<CustomStylesheetRow[]>;
+    }
+>();
+
+/**
+ * Clears process-level stylesheet cache after admin writes.
+ *
+ * @public
+ */
+export function invalidateCustomStylesheetCache(): void {
+    cachedCustomStylesheetsByTableName.clear();
+}
+
 /**
  * Resolves the prefixed table name for CustomStylesheet.
  *
@@ -127,8 +154,37 @@ function getCustomStylesheetClient(): DynamicSupabaseClient {
  */
 export async function listCustomStylesheets(): Promise<CustomStylesheetRow[]> {
     const table = await getCustomStylesheetTableName();
-    const supabase = getCustomStylesheetClient();
+    const cachedStylesheets = cachedCustomStylesheetsByTableName.get(table);
+    if (cachedStylesheets && Date.now() - cachedStylesheets.loadedAt < CUSTOM_STYLESHEET_CACHE_TTL_MS) {
+        return cachedStylesheets.rowsPromise;
+    }
+
+    const rowsPromise = loadCustomStylesheetsFromDatabase(table);
+    cachedCustomStylesheetsByTableName.set(table, {
+        loadedAt: Date.now(),
+        rowsPromise,
+    });
+
+    try {
+        return await rowsPromise;
+    } catch (error) {
+        if (cachedCustomStylesheetsByTableName.get(table)?.rowsPromise === rowsPromise) {
+            cachedCustomStylesheetsByTableName.delete(table);
+        }
+        throw error;
+    }
+}
 
+/**
+ * Reads custom stylesheet rows from the database.
+ *
+ * @param table - Resolved CustomStylesheet table name.
+ * @returns Stored stylesheet rows.
+ *
+ * @private
+ */
+async function loadCustomStylesheetsFromDatabase(table: string): Promise<CustomStylesheetRow[]> {
+    const supabase = getCustomStylesheetClient();
     const { data, error } = await supabase.from(table).select('*').order('createdAt', { ascending: true });
 
     if (error) {
@@ -206,6 +262,7 @@ export async function saveCustomStylesheetFile({
         throw new Error(`Failed to save custom stylesheet: ${error.message || String(error)}`);
     }
 
+    invalidateCustomStylesheetCache();
     return data as CustomStylesheetRow;
 }
 
@@ -229,4 +286,6 @@ export async function deleteCustomStylesheetFile(id: number): Promise<void> {
 
         throw new Error(`Failed to delete custom stylesheet: ${error.message || String(error)}`);
     }
+
+    invalidateCustomStylesheetCache();
 }

package/apps/agents-server/src/database/getMetadata.ts

@@ -10,6 +10,45 @@ import { cache } from 'react';
  */
 const metadataDefaultsMap = new Map<string, string>(metadataDefaults.map((metadata) => [metadata.key, metadata.value]));
 
+/**
+ * Process-level cache lifetime for metadata reads.
+ *
+ * @private Internal helper for metadata lookups in `apps/agents-server`.
+ */
+const METADATA_CACHE_TTL_MS = 30_000;
+
+/**
+ * Cached metadata table payload keyed by the resolved table name.
+ *
+ * @private Internal helper for metadata lookups in `apps/agents-server`.
+ */
+const cachedMetadataValuesByTableName = new Map<
+    string,
+    {
+        readonly loadedAt: number;
+        readonly valuesPromise: Promise<Map<string, string | null>>;
+    }
+>();
+
+/**
+ * Metadata row shape loaded by the lightweight metadata select.
+ *
+ * @private Internal helper for metadata lookups in `apps/agents-server`.
+ */
+type MetadataValueRow = {
+    readonly key: string;
+    readonly value: string | null;
+};
+
+/**
+ * Clears process-level metadata cache after admin metadata writes.
+ *
+ * @public exported from `apps/agents-server`
+ */
+export function invalidateMetadataCache(): void {
+    cachedMetadataValuesByTableName.clear();
+}
+
 /**
  * Loads the full metadata table once per request so callers can cheaply project subsets.
  *
@@ -18,17 +57,59 @@ const metadataDefaultsMap = new Map<string, string>(metadataDefaults.map((metada
  * @private Internal helper for batched metadata lookups in `apps/agents-server`.
  */
 const loadAllMetadataValues = cache(async (): Promise<Map<string, string | null>> => {
-    const supabase = $provideSupabase();
     const table = await $getTableName('Metadata');
+    return loadCachedMetadataValues(table);
+});
+
+/**
+ * Loads metadata values using a short process-level cache shared by consecutive requests.
+ *
+ * @param table - Resolved metadata table name.
+ * @returns Metadata values keyed by metadata key.
+ *
+ * @private Internal helper for metadata lookups in `apps/agents-server`.
+ */
+async function loadCachedMetadataValues(table: string): Promise<Map<string, string | null>> {
+    const cachedMetadataValues = cachedMetadataValuesByTableName.get(table);
+    if (cachedMetadataValues && Date.now() - cachedMetadataValues.loadedAt < METADATA_CACHE_TTL_MS) {
+        return cachedMetadataValues.valuesPromise;
+    }
+
+    const valuesPromise = loadMetadataValuesFromDatabase(table);
+    cachedMetadataValuesByTableName.set(table, {
+        loadedAt: Date.now(),
+        valuesPromise,
+    });
+
+    try {
+        return await valuesPromise;
+    } catch (error) {
+        if (cachedMetadataValuesByTableName.get(table)?.valuesPromise === valuesPromise) {
+            cachedMetadataValuesByTableName.delete(table);
+        }
+        throw error;
+    }
+}
+
+/**
+ * Reads all persisted metadata values from the database.
+ *
+ * @param table - Resolved metadata table name.
+ * @returns Metadata values keyed by metadata key.
+ *
+ * @private Internal helper for metadata lookups in `apps/agents-server`.
+ */
+async function loadMetadataValuesFromDatabase(table: string): Promise<Map<string, string | null>> {
+    const supabase = $provideSupabase();
     const { data } = await supabase.from(table).select('key, value');
 
     const loadedMap = new Map<string, string | null>();
-    for (const row of data ?? []) {
+    for (const row of (data ?? []) as Array<MetadataValueRow>) {
         loadedMap.set(row.key, row.value);
     }
 
     return loadedMap;
-});
+}
 
 /**
  * Get metadata value by key

package/apps/agents-server/src/instrumentation-client.ts

@@ -0,0 +1,28 @@
+import * as Sentry from '@sentry/nextjs';
+import {
+    createSentrySdkTags,
+    resolveBrowserSentryDsn,
+    resolveSentrySdkEnvironment,
+    resolveSentrySdkRelease,
+    SENTRY_TRACE_PROPAGATION_TARGETS,
+    SENTRY_TRACES_SAMPLE_RATE,
+} from './utils/errorReporting/sentrySdkConfig';
+
+Sentry.init({
+    dsn: resolveBrowserSentryDsn(),
+    tracesSampleRate: SENTRY_TRACES_SAMPLE_RATE,
+    environment: resolveSentrySdkEnvironment(),
+    release: resolveSentrySdkRelease(),
+    integrations: [Sentry.browserTracingIntegration()],
+    tracePropagationTargets: SENTRY_TRACE_PROPAGATION_TARGETS,
+    initialScope: {
+        tags: createSentrySdkTags(),
+    },
+});
+
+/**
+ * Reports app-router navigation spans to Sentry.
+ *
+ * @private Sentry hook for Next.js client navigation instrumentation
+ */
+export const onRouterTransitionStart = Sentry.captureRouterTransitionStart;

package/apps/agents-server/src/instrumentation.ts

@@ -1,3 +1,5 @@
+import * as Sentry from '@sentry/nextjs';
+
 /**
  * Registers startup hooks for the Agents Server runtime.
  *
@@ -5,11 +7,21 @@
  * @private internal startup hook for Agents Server runtime
  */
 export async function register(): Promise<void> {
+    if (process.env.NEXT_RUNTIME === 'edge') {
+        await import('./sentry.edge.config');
+        return;
+    }
+
     if (process.env.NEXT_RUNTIME !== 'nodejs') {
         return;
     }
 
     try {
+        await import('./sentry.server.config');
+
+        const { registerServerErrorSentryLogging } = await import('./utils/errorReporting/registerServerErrorSentryLogging');
+        registerServerErrorSentryLogging();
+
         const { registerNodeRuntimeInstrumentation } = await import('./instrumentation-node');
         await registerNodeRuntimeInstrumentation();
     } catch (error) {
@@ -22,3 +34,10 @@ export async function register(): Promise<void> {
         });
     }
 }
+
+/**
+ * Reports request errors from the Next.js app router to Sentry.
+ *
+ * @private Sentry hook for Next.js request instrumentation
+ */
+export const onRequestError = Sentry.captureRequestError;

package/apps/agents-server/src/sentry.edge.config.ts

@@ -0,0 +1,18 @@
+import * as Sentry from '@sentry/nextjs';
+import {
+    createSentrySdkTags,
+    resolveBrowserSentryDsn,
+    resolveSentrySdkEnvironment,
+    resolveSentrySdkRelease,
+    SENTRY_TRACES_SAMPLE_RATE,
+} from './utils/errorReporting/sentrySdkConfig';
+
+Sentry.init({
+    dsn: resolveBrowserSentryDsn(),
+    tracesSampleRate: SENTRY_TRACES_SAMPLE_RATE,
+    environment: resolveSentrySdkEnvironment(),
+    release: resolveSentrySdkRelease(),
+    initialScope: {
+        tags: createSentrySdkTags(),
+    },
+});

package/apps/agents-server/src/sentry.server.config.ts

@@ -0,0 +1,19 @@
+import * as Sentry from '@sentry/nextjs';
+import { createAgentsServerSentryContext } from './utils/errorReporting/agentsServerSentryContext';
+import { resolveServerSentryDsn, SENTRY_TRACES_SAMPLE_RATE } from './utils/errorReporting/sentrySdkConfig';
+
+/**
+ * Shared diagnostic context applied to server-side SDK events at initialization time.
+ */
+const agentsServerSentryContext = createAgentsServerSentryContext();
+
+Sentry.init({
+    dsn: resolveServerSentryDsn(),
+    tracesSampleRate: SENTRY_TRACES_SAMPLE_RATE,
+    environment: agentsServerSentryContext.environment,
+    release: agentsServerSentryContext.release,
+    initialScope: {
+        tags: agentsServerSentryContext.tags,
+        extra: agentsServerSentryContext.extra,
+    },
+});