@promptbook/cli 0.113.0-8 → 0.114.0-0

package/apps/agents-server/src/constants/defaultAgentAvatarVisual.ts

@@ -3,7 +3,8 @@ import { AVATAR_VISUALS, resolveAvatarVisualId } from '../../../../src/avatars/v
 import { DEFAULT_AGENT_AVATAR_VISUAL_ID as SHARED_DEFAULT_AGENT_AVATAR_VISUAL_ID } from '../../../../src/utils/agents/resolveAgentAvatarImageUrl';
 
 /**
- * Metadata key controlling the built-in avatar visual used for agents without `META IMAGE` or `META AVATAR`.
+ * Metadata key controlling the built-in avatar visual used for agents without `META IMAGE`, `META AVATAR`,
+ * or `META VISUAL`.
  */
 export const DEFAULT_AGENT_AVATAR_VISUAL_METADATA_KEY = 'DEFAULT_AGENT_AVATAR_VISUAL';
 
@@ -58,8 +59,8 @@ export const DEFAULT_AGENT_AVATAR_VISUAL_METADATA_VALUE =
 /**
  * Resolves one raw metadata value to a supported built-in avatar visual id.
  *
- * The same separator-insensitive lookup is shared with `META AVATAR`, so both
- * `PIXEL_ART` and `pixel art` resolve to the same built-in visual.
+ * The same separator-insensitive lookup is shared with `META AVATAR` / `META VISUAL`,
+ * so both `PIXEL_ART` and `pixel art` resolve to the same built-in visual.
  *
  * @param value - Raw metadata value stored in `Metadata`.
  * @returns Safe supported visual id.

package/apps/agents-server/src/constants/harnessAuthRoutes.ts

@@ -0,0 +1,20 @@
+/**
+ * Admin page path for configuring standalone harness authentication.
+ *
+ * @private internal route constant for Agents Server Harness Auth UI
+ */
+export const HARNESS_AUTH_ADMIN_PATH = '/superadmin/harness-auth';
+
+/**
+ * Admin API path for configuring standalone harness authentication.
+ *
+ * @private internal route constant for Agents Server Harness Auth UI
+ */
+export const HARNESS_AUTH_API_PATH = '/api/admin/harness-auth';
+
+/**
+ * Admin API path for the interactive harness authentication terminal.
+ *
+ * @private internal route constant for Agents Server Harness Auth UI
+ */
+export const HARNESS_AUTHENTICATION_API_PATH = `${HARNESS_AUTH_API_PATH}/authentication`;

package/apps/agents-server/src/constants/serverLimits.ts

@@ -37,7 +37,7 @@ export const DEFAULT_SPAWN_AGENT_RATE_LIMIT_WINDOW_MS = 10 * 60 * 1000;
  *
  * @private shared Agents Server constant
  */
-export const DEFAULT_LOCAL_AGENT_RUNNER_MAX_FAILED_ATTEMPTS = 3;
+export const DEFAULT_LOCAL_AGENT_RUNNER_MAX_FAILED_ATTEMPTS = 1;
 
 /**
  * Default maximum number of local runner harness instances allowed to answer queued messages at once.
@@ -182,7 +182,7 @@ export const SERVER_LIMIT_DEFINITIONS = [
         key: SERVER_LIMIT_KEYS.LOCAL_AGENT_RUNNER_MAX_FAILED_ATTEMPTS,
         category: 'Local agent runner',
         title: 'Max failed message attempts',
-        description: 'Stops the local coding-agent watcher from retrying the same queued chat message forever.',
+        description: 'Fails the chat completion task after this many failed local coding-agent attempts.',
         unit: 'count',
         defaultValue: DEFAULT_LOCAL_AGENT_RUNNER_MAX_FAILED_ATTEMPTS,
         minimumValue: 1,

package/apps/agents-server/src/constants/shibbolethAuth.ts

@@ -101,6 +101,19 @@ export type ShibbolethAuthenticationMenuStatus = {
     readonly isConfigured: boolean;
 };
 
+/**
+ * Shibboleth menu status shown to viewers who are not allowed to see login-method configuration.
+ *
+ * The Shibboleth menu entry and its misconfiguration warning are meant for administrators only, so
+ * non-admin viewers receive this inert status instead of the real activation/configuration values.
+ *
+ * @private internal Shibboleth menu default
+ */
+export const SHIBBOLETH_AUTHENTICATION_MENU_STATUS_HIDDEN: ShibbolethAuthenticationMenuStatus = {
+    isActive: false,
+    isConfigured: false,
+};
+
 /**
  * Parses a metadata boolean value.
  *

package/apps/agents-server/src/database/$provideDatabaseAdminExecutor.ts

@@ -2,10 +2,8 @@ import type { StudioBFFSqlLintDetails, StudioBFFSqlLintResult } from '@prisma/st
 import { Pool, type PoolClient } from 'pg';
 import { isAgentsServerSqliteMode } from './agentsServerDatabaseMode';
 import { resolvePostgresConnectionString } from './resolvePostgresConnectionString';
-import {
-    $provideAgentsServerSqliteDatabase,
-    type AgentsServerSqliteDatabase,
-} from './sqlite/$provideAgentsServerSqliteDatabase';
+import { $provideCurrentServerSqliteDatabase } from './sqlite/$provideCurrentServerSqliteDatabase';
+import type { AgentsServerSqliteDatabase } from './sqlite/$provideAgentsServerSqliteDatabase';
 
 /**
  * Query shape sent by Embedded Prisma Studio adapters.
@@ -65,19 +63,20 @@ function $providePostgresDatabaseAdminExecutor(): DatabaseAdminExecutor {
 /**
  * Provides the SQLite raw SQL executor used by Embedded Prisma Studio.
  *
+ * The executor targets the isolated database of the server handling the current
+ * request, so one server's admin can never inspect another server's data.
+ *
  * @returns SQLite-backed database admin executor.
  */
 function $provideSqliteDatabaseAdminExecutor(): DatabaseAdminExecutor {
-    const database = $provideAgentsServerSqliteDatabase();
-
     return {
-        execute: (query) => Promise.resolve(executeSqliteDatabaseAdminQuery(database, query)),
-        executeTransaction: (queries) =>
-            Promise.resolve(
-                database.transaction((transactionQueries: ReadonlyArray<DatabaseAdminQuery>) =>
-                    transactionQueries.map((query) => executeSqliteDatabaseAdminQuery(database, query)),
-                )(queries),
-            ),
+        execute: async (query) => executeSqliteDatabaseAdminQuery(await $provideCurrentServerSqliteDatabase(), query),
+        executeTransaction: async (queries) => {
+            const database = await $provideCurrentServerSqliteDatabase();
+            return database.transaction((transactionQueries: ReadonlyArray<DatabaseAdminQuery>) =>
+                transactionQueries.map((query) => executeSqliteDatabaseAdminQuery(database, query)),
+            )(queries);
+        },
         lintSql: (details) => Promise.resolve({ diagnostics: [], schemaVersion: details.schemaVersion }),
     };
 }

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

@@ -0,0 +1,77 @@
+import { parseAgentSource } from '../../../../src/book-2.0/agent-source/parseAgentSource';
+import type { string_book } from '../../../../src/book-2.0/agent-source/string_book';
+import type { AgentCollectionInSupabase } from '../../../../src/collection/agent-collection/constructors/agent-collection-in-supabase/AgentCollectionInSupabase';
+
+/**
+ * Logger surface used while creating missing agents.
+ *
+ * @private utility of Agents Server default-agent seeding
+ */
+type CreateMissingAgentsLogger = Pick<Console, 'info'>;
+
+/**
+ * Options for creating only the missing agents from a set of bundled books.
+ *
+ * @private utility of Agents Server default-agent seeding
+ */
+export type CreateMissingAgentsFromBooksOptions = {
+    /**
+     * Agent collection bound to the target server namespace.
+     */
+    readonly collection: AgentCollectionInSupabase;
+
+    /**
+     * Bundled agent books to reinstate, in deterministic order.
+     */
+    readonly agentBooks: ReadonlyArray<string_book>;
+
+    /**
+     * Names of the agents that already exist and must not be recreated.
+     */
+    readonly existingAgentNames: ReadonlySet<string>;
+
+    /**
+     * Optional folder the created agents should be placed in (for example the `.core` folder).
+     */
+    readonly folderId?: number | null;
+
+    /**
+     * Optional logger for installer output.
+     */
+    readonly logger?: CreateMissingAgentsLogger;
+};
+
+/**
+ * Creates only the agents whose name is not already present, reusing the shared persistence mechanism.
+ *
+ * This is the single place that turns a list of bundled books into persisted agents, so both the core-agent seeder and
+ * the default-agent reinstatement share exactly the same creation logic.
+ *
+ * @param options - Collection, books, and the set of already-present agent names.
+ * @returns Names of the agents created during this run.
+ *
+ * @private utility of Agents Server default-agent seeding
+ */
+export async function createMissingAgentsFromBooks(
+    options: CreateMissingAgentsFromBooksOptions,
+): Promise<ReadonlyArray<string>> {
+    const { collection, agentBooks, existingAgentNames, folderId, logger } = options;
+    const createdAgentNames: Array<string> = [];
+
+    for (const [index, agentBook] of agentBooks.entries()) {
+        const { agentName } = parseAgentSource(agentBook);
+
+        if (existingAgentNames.has(agentName)) {
+            continue;
+        }
+
+        const createdAgent = await collection.createAgent(agentBook, {
+            folderId: folderId ?? undefined,
+            sortOrder: index,
+        });
+        createdAgentNames.push(createdAgent.agentName);
+        logger?.info(`Created agent: ${createdAgent.agentName}`);
+    }
+
+    return createdAgentNames;
+}

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

@@ -47,7 +47,7 @@ import {
     SERVER_LANGUAGE_METADATA_KEY,
 } from '../languages/ServerLanguageRegistry';
 import { AGENT_VISIBILITY_OPTIONS, DEFAULT_VISIBILITY_METADATA_KEY } from '../utils/agentVisibility';
-import { CHAT_FEEDBACK_MODE_OPTIONS } from '../utils/chatFeedbackMode';
+import { CHAT_FEEDBACK_MODE_OPTIONS, DEFAULT_CHAT_FEEDBACK_MODE } from '../utils/chatFeedbackMode';
 import { SERVER_VISIBILITY_METADATA_KEY, SERVER_VISIBILITY_OPTIONS } from '../utils/serverVisibility';
 
 /**
@@ -301,7 +301,7 @@ export const metadataDefaults: ReadonlyArray<MetadataDefinition> = [
     },
     {
         key: 'CHAT_FEEDBACK_MODE',
-        value: 'stars',
+        value: DEFAULT_CHAT_FEEDBACK_MODE,
         note: `Controls post-response feedback UI mode. Allowed values: ${formatMetadataOptionValues(
             CHAT_FEEDBACK_MODE_OPTIONS,
         )}.`,
@@ -407,7 +407,7 @@ export const metadataDefaults: ReadonlyArray<MetadataDefinition> = [
     {
         key: DEFAULT_AGENT_AVATAR_VISUAL_METADATA_KEY,
         value: DEFAULT_AGENT_AVATAR_VISUAL_METADATA_VALUE,
-        note: `Default built-in avatar visual used for agents without \`META IMAGE\` or \`META AVATAR\`. Allowed values: ${formatMetadataOptionValues(
+        note: `Default built-in avatar visual used for agents without \`META IMAGE\`, \`META AVATAR\`, or \`META VISUAL\`. Allowed values: ${formatMetadataOptionValues(
             DEFAULT_AGENT_AVATAR_VISUAL_METADATA_OPTIONS.map(({ metadataValue, title }) => ({
                 value: metadataValue,
                 label: title,

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

@@ -1,14 +1,22 @@
+import { mkdir, writeFile } from 'fs/promises';
+import { dirname } from 'path';
 import colors from 'colors';
 import {
     DATABASE_MIGRATION_APPLIED_BY,
     resolveDatabaseMigrationRuntimeConfiguration,
     runDatabaseMigrations,
+    type RunDatabaseMigrationsResult,
 } from './runDatabaseMigrations';
 import { isAgentsServerSqliteMode } from './agentsServerDatabaseMode';
 import { loadAgentsServerEnvFile } from './loadAgentsServerEnvFile';
 
 loadAgentsServerEnvFile();
 
+/**
+ * Optional output path for a machine-readable migration summary used by standalone VPS self-update.
+ */
+const DATABASE_MIGRATION_SUMMARY_FILE_ENV_NAME = 'PTBK_DATABASE_MIGRATION_SUMMARY_FILE';
+
 /**
  * Runs manual migration command from CLI arguments.
  */
@@ -31,7 +39,7 @@ async function migrate(): Promise<void> {
     }
 
     try {
-        await runDatabaseMigrations({
+        const migrationResult = await runDatabaseMigrations({
             prefixes: runtimeConfiguration.prefixes,
             registeredServers: runtimeConfiguration.registeredServers,
             connectionString: runtimeConfiguration.connectionString,
@@ -40,6 +48,7 @@ async function migrate(): Promise<void> {
             logger: console,
             logSqlStatements: true,
         });
+        await writeDatabaseMigrationSummaryFile(migrationResult);
         console.info(colors.bgGreen('\n🎉 All migrations completed successfully'));
     } catch (error) {
         console.error(colors.bgRed('\n❌ Migration failed:'));
@@ -52,6 +61,21 @@ async function migrate(): Promise<void> {
     }
 }
 
+/**
+ * Writes machine-readable migration summary when the caller provides an output path.
+ *
+ * @param migrationResult - Result returned by the shared migration runner.
+ */
+async function writeDatabaseMigrationSummaryFile(migrationResult: RunDatabaseMigrationsResult): Promise<void> {
+    const summaryFilePath = process.env[DATABASE_MIGRATION_SUMMARY_FILE_ENV_NAME]?.trim();
+    if (!summaryFilePath) {
+        return;
+    }
+
+    await mkdir(dirname(summaryFilePath), { recursive: true });
+    await writeFile(summaryFilePath, `${JSON.stringify(migrationResult, null, 2)}\n`, 'utf-8');
+}
+
 /**
  * Parses optional `--only` flag from CLI arguments.
  *

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

@@ -44,6 +44,10 @@ export type MigratePrefixOptions = {
      * Optional observer notified about the current prefix migration sub-step.
      */
     readonly onProgress?: (progress: MigratePrefixProgress) => void;
+    /**
+     * Optional observer notified after one migration file has been applied and recorded.
+     */
+    readonly onMigrationApplied?: (appliedMigration: MigratePrefixAppliedMigration) => void;
 };
 
 /**
@@ -77,6 +81,22 @@ export type MigratePrefixProgress = {
     readonly migrationFile?: string;
 };
 
+/**
+ * Snapshot emitted after one migration file has been successfully applied for one prefix.
+ *
+ * @private function of runDatabaseMigrations
+ */
+export type MigratePrefixAppliedMigration = {
+    /**
+     * Prefix currently being migrated.
+     */
+    readonly prefix: string;
+    /**
+     * Migration file that has been applied and recorded.
+     */
+    readonly migrationFile: string;
+};
+
 /**
  * Context for migrations-table schema synchronization.
  *
@@ -159,6 +179,10 @@ export async function applyPendingMigrationsForPrefix(options: MigratePrefixOpti
             [migrationFile, options.appliedBy],
         );
         appliedCount++;
+        options.onMigrationApplied?.({
+            prefix: options.prefix,
+            migrationFile,
+        });
         options.logger.info(`  ✅ Applied ${migrationFile}`);
     }
 

package/apps/agents-server/src/database/migrations/2026-07-1400-wallet-browser-profile-record-type.sql

@@ -0,0 +1,16 @@
+-- Allow the new `BROWSER_PROFILE` wallet record type which links one agent to its persistent
+-- browser-profile directory on the filesystem.
+--
+-- Backwards compatible: older server versions keep reading and writing the existing record types,
+-- they only cannot create `BROWSER_PROFILE` records.
+
+ALTER TABLE "prefix_Wallet"
+    DROP CONSTRAINT IF EXISTS "prefix_Wallet_recordType_check";
+
+-- The constraint kept its original name when the table was renamed from `prefix_UserWallet`
+ALTER TABLE "prefix_Wallet"
+    DROP CONSTRAINT IF EXISTS "prefix_UserWallet_recordType_check";
+
+ALTER TABLE "prefix_Wallet"
+    ADD CONSTRAINT "prefix_Wallet_recordType_check"
+    CHECK ("recordType" IN ('USERNAME_PASSWORD', 'SESSION_COOKIE', 'ACCESS_TOKEN', 'BROWSER_PROFILE'));

package/apps/agents-server/src/database/migrations/2026-07-1700-chat-history-chat-task-links.sql

@@ -0,0 +1,10 @@
+-- Link recorded chat-history messages to canonical durable chats and their chat-completion tasks
+-- Backwards compatible: only adds new nullable columns, older servers keep working unchanged
+ALTER TABLE "prefix_ChatHistory" ADD COLUMN IF NOT EXISTS "chatId" TEXT NULL;
+ALTER TABLE "prefix_ChatHistory" ADD COLUMN IF NOT EXISTS "taskId" TEXT NULL;
+
+COMMENT ON COLUMN "prefix_ChatHistory"."chatId" IS 'The id of the canonical `UserChat` this message belongs to, `NULL` for legacy stateless chats';
+COMMENT ON COLUMN "prefix_ChatHistory"."taskId" IS 'The id of the durable `UserChatJob` (chat-completion task) which produced or was queued by this message';
+
+CREATE INDEX IF NOT EXISTS "prefix_ChatHistory_chatId_idx" ON "prefix_ChatHistory" ("chatId");
+CREATE INDEX IF NOT EXISTS "prefix_ChatHistory_taskId_idx" ON "prefix_ChatHistory" ("taskId");

package/apps/agents-server/src/database/migrations/2026-07-2500-user-chat-email-source.sql

@@ -0,0 +1,13 @@
+ALTER TABLE "prefix_UserChat"
+DROP CONSTRAINT IF EXISTS "prefix_UserChat_source_check";
+
+ALTER TABLE "prefix_UserChat"
+ADD CONSTRAINT "prefix_UserChat_source_check"
+CHECK ("source" IN ('WEB_UI', 'OPENAI_API', 'TEAM_MEMBER', 'EMAIL'));
+
+ALTER TABLE "prefix_ChatHistory"
+DROP CONSTRAINT IF EXISTS "prefix_ChatHistory_source_check";
+
+ALTER TABLE "prefix_ChatHistory"
+ADD CONSTRAINT "prefix_ChatHistory_source_check"
+CHECK ("source" IN ('AGENT_PAGE_CHAT', 'OPENAI_API_COMPATIBILITY', 'EMAIL'));

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

@@ -0,0 +1,111 @@
+import type { SupabaseClient } from '@supabase/supabase-js';
+import { AgentCollectionInSupabase } from '../../../../src/collection/agent-collection/constructors/agent-collection-in-supabase/AgentCollectionInSupabase';
+import type { AgentsDatabaseSchema } from '../../../../src/collection/agent-collection/constructors/agent-collection-in-supabase/AgentsDatabaseSchema';
+import { loadDefaultAgentBooks } from '../utils/defaultAgents/loadDefaultAgentBooks';
+import { createMissingAgentsFromBooks } from './createMissingAgentsFromBooks';
+import { $provideSupabaseForServer } from './$provideSupabaseForServer';
+
+/**
+ * Environment variable with an explicit default-agent source directory.
+ *
+ * @private utility of standalone default-agent reinstatement
+ */
+const DEFAULT_AGENTS_DIRECTORY_ENV_NAME = 'PTBK_DEFAULT_AGENTS_DIR';
+
+/**
+ * Environment variable carrying the current Agents Server table prefix.
+ *
+ * @private utility of standalone default-agent reinstatement
+ */
+const SUPABASE_TABLE_PREFIX_ENV_NAME = 'SUPABASE_TABLE_PREFIX';
+
+/**
+ * Logger surface used by the default-agent reinstatement.
+ *
+ * @private utility of standalone default-agent reinstatement
+ */
+type ReinstateDefaultAgentsLogger = Pick<Console, 'info' | 'warn'>;
+
+/**
+ * Options for reinstating any missing bundled normal default agents on the current server.
+ *
+ * @private utility of standalone default-agent reinstatement
+ */
+export type ReinstateDefaultAgentsOptions = {
+    /**
+     * Optional explicit directory containing default `*.book` files.
+     */
+    readonly defaultAgentDirectory?: string | null;
+
+    /**
+     * Optional table prefix for the server namespace being reinstated.
+     */
+    readonly tablePrefix?: string | null;
+
+    /**
+     * Optional logger for installer output.
+     */
+    readonly logger?: ReinstateDefaultAgentsLogger;
+};
+
+/**
+ * Result of one default-agent reinstatement run.
+ *
+ * @private utility of standalone default-agent reinstatement
+ */
+export type ReinstateDefaultAgentsResult = {
+    /**
+     * Names of the normal default agents created during this run.
+     */
+    readonly createdAgentNames: ReadonlyArray<string>;
+};
+
+/**
+ * Recreates only the normal default agents that are missing from the current server.
+ *
+ * Unlike `seedDefaultAgents` — which only seeds a brand-new empty server — this reinstatement recreates individually
+ * missing default agents while keeping every existing (possibly edited) agent untouched, so an admin can restore the
+ * showcase agents at any time. It reuses the exact same creation logic used when the server is first created.
+ *
+ * @param options - Optional reinstatement controls.
+ * @returns Reinstatement summary listing the created agents.
+ *
+ * @private utility of standalone default-agent reinstatement
+ */
+export async function reinstateDefaultAgents(
+    options: ReinstateDefaultAgentsOptions = {},
+): Promise<ReinstateDefaultAgentsResult> {
+    const logger = options.logger ?? console;
+    const tablePrefix = options.tablePrefix ?? process.env[SUPABASE_TABLE_PREFIX_ENV_NAME] ?? '';
+    const defaultAgentDirectory = options.defaultAgentDirectory ?? process.env[DEFAULT_AGENTS_DIRECTORY_ENV_NAME];
+    const collection = new AgentCollectionInSupabase(resolveAgentsDatabaseSupabaseClient(), { tablePrefix });
+
+    const defaultAgentBooks = await loadDefaultAgentBooks({ defaultAgentDirectory });
+
+    if (defaultAgentBooks.length === 0) {
+        logger.warn('Skipping default agents because no bundled *.book files were found.');
+        return { createdAgentNames: [] };
+    }
+
+    const activeAgents = await collection.listAgents();
+    const existingAgentNames = new Set(activeAgents.map((activeAgent) => activeAgent.agentName));
+    const createdAgentNames = await createMissingAgentsFromBooks({
+        collection,
+        agentBooks: defaultAgentBooks,
+        existingAgentNames,
+        logger,
+    });
+
+    return { createdAgentNames };
+}
+
+/**
+ * Resolves the Supabase-shaped client for the Agent collection subset.
+ *
+ * @returns Supabase client typed for agent collection persistence.
+ *
+ * @private utility of standalone default-agent reinstatement
+ */
+function resolveAgentsDatabaseSupabaseClient(): SupabaseClient<AgentsDatabaseSchema> {
+    return $provideSupabaseForServer() as unknown as SupabaseClient<AgentsDatabaseSchema>;
+}

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

@@ -109,6 +109,10 @@ export type DatabaseMigrationPrefixResult = {
      * Number of newly applied migration files.
      */
     readonly appliedCount: number;
+    /**
+     * Migration filenames newly applied for this prefix.
+     */
+    readonly appliedMigrationFiles: ReadonlyArray<string>;
 };
 
 /**
@@ -270,6 +274,7 @@ export async function runDatabaseMigrations(
         }
 
         for (const prefix of selectedPrefixes) {
+            const appliedMigrationFiles: Array<string> = [];
             failureContext.stage = 'migrate-prefix';
             failureContext.currentPrefix = prefix;
             failureContext.currentPrefixStage = undefined;
@@ -289,8 +294,11 @@ export async function runDatabaseMigrations(
                     failureContext.currentPrefixStage = stage;
                     failureContext.currentMigrationFile = migrationFile;
                 },
+                onMigrationApplied: ({ migrationFile }) => {
+                    appliedMigrationFiles.push(migrationFile);
+                },
             });
-            perPrefix.push({ prefix, appliedCount });
+            perPrefix.push({ prefix, appliedCount, appliedMigrationFiles });
         }
 
         return {

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

@@ -302,6 +302,8 @@ export type AgentsServerDatabase = {
                     actorType: 'ANONYMOUS' | 'TEAM_MEMBER' | 'API_KEY' | null;
                     usage: Json | null;
                     userId: number | null;
+                    chatId: string | null;
+                    taskId: string | null;
                 };
                 Insert: {
                     id?: number;
@@ -322,6 +324,8 @@ export type AgentsServerDatabase = {
                     actorType?: 'ANONYMOUS' | 'TEAM_MEMBER' | 'API_KEY' | null;
                     usage?: Json | null;
                     userId?: number | null;
+                    chatId?: string | null;
+                    taskId?: string | null;
                 };
                 Update: {
                     id?: number;
@@ -342,6 +346,8 @@ export type AgentsServerDatabase = {
                     actorType?: 'ANONYMOUS' | 'TEAM_MEMBER' | 'API_KEY' | null;
                     usage?: Json | null;
                     userId?: number | null;
+                    chatId?: string | null;
+                    taskId?: string | null;
                 };
                 Relationships: [
                     {
@@ -913,7 +919,7 @@ export type AgentsServerDatabase = {
                     userId: number;
                     isUserScoped: boolean;
                     agentPermanentId: string | null;
-                    recordType: 'USERNAME_PASSWORD' | 'SESSION_COOKIE' | 'ACCESS_TOKEN';
+                    recordType: 'USERNAME_PASSWORD' | 'SESSION_COOKIE' | 'ACCESS_TOKEN' | 'BROWSER_PROFILE';
                     service: string;
                     key: string;
                     jsonSchema: Json | null;
@@ -931,7 +937,7 @@ export type AgentsServerDatabase = {
                     userId: number;
                     isUserScoped?: boolean;
                     agentPermanentId?: string | null;
-                    recordType: 'USERNAME_PASSWORD' | 'SESSION_COOKIE' | 'ACCESS_TOKEN';
+                    recordType: 'USERNAME_PASSWORD' | 'SESSION_COOKIE' | 'ACCESS_TOKEN' | 'BROWSER_PROFILE';
                     service: string;
                     key?: string;
                     jsonSchema?: Json | null;
@@ -949,7 +955,7 @@ export type AgentsServerDatabase = {
                     userId?: number;
                     isUserScoped?: boolean;
                     agentPermanentId?: string | null;
-                    recordType?: 'USERNAME_PASSWORD' | 'SESSION_COOKIE' | 'ACCESS_TOKEN';
+                    recordType?: 'USERNAME_PASSWORD' | 'SESSION_COOKIE' | 'ACCESS_TOKEN' | 'BROWSER_PROFILE';
                     service?: string;
                     key?: string;
                     jsonSchema?: Json | null;

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

@@ -2,10 +2,9 @@ import type { SupabaseClient } from '@supabase/supabase-js';
 import { spaceTrim } from 'spacetrim';
 import { AgentCollectionInSupabase } from '../../../../src/collection/agent-collection/constructors/agent-collection-in-supabase/AgentCollectionInSupabase';
 import type { AgentsDatabaseSchema } from '../../../../src/collection/agent-collection/constructors/agent-collection-in-supabase/AgentsDatabaseSchema';
-import { parseAgentSource } from '../../../../src/book-2.0/agent-source/parseAgentSource';
-import type { string_book } from '../../../../src/book-2.0/agent-source/string_book';
 import { DatabaseError } from '../../../../src/errors/DatabaseError';
 import { CORE_AGENT_DIRECTORY_NAME, loadCoreAgentBooks } from '../utils/defaultAgents/loadDefaultAgentBooks';
+import { createMissingAgentsFromBooks } from './createMissingAgentsFromBooks';
 import { $provideSupabaseForServer } from './$provideSupabaseForServer';
 
 /**
@@ -87,38 +86,17 @@ export async function seedCoreAgents(options: SeedCoreAgentsOptions = {}): Promi
 
     const coreFolderId = await ensureCoreFolderExists(tablePrefix);
     const existingAgentNames = await loadExistingActiveAgentNames(tablePrefix);
-    const createdAgentNames: Array<string> = [];
-
-    for (const [index, coreAgentBook] of coreAgentBooks.entries()) {
-        const agentName = parseCoreAgentName(coreAgentBook);
-
-        if (existingAgentNames.has(agentName)) {
-            continue;
-        }
-
-        const createdAgent = await collection.createAgent(coreAgentBook, {
-            folderId: coreFolderId,
-            sortOrder: index,
-        });
-        createdAgentNames.push(createdAgent.agentName);
-        logger.info(`Created \`.core\` agent: ${createdAgent.agentName}`);
-    }
+    const createdAgentNames = await createMissingAgentsFromBooks({
+        collection,
+        agentBooks: coreAgentBooks,
+        existingAgentNames,
+        folderId: coreFolderId,
+        logger,
+    });
 
     return { coreFolderId, createdAgentNames };
 }
 
-/**
- * Reads the agent name from one bundled `.core` book source.
- *
- * @param coreAgentBook - Raw `.core` agent book source.
- * @returns Persisted agent name parsed from the book.
- *
- * @private utility of `.core` folder seeding
- */
-function parseCoreAgentName(coreAgentBook: string_book): string {
-    return parseAgentSource(coreAgentBook).agentName;
-}
-
 /**
  * Reads the set of active agent names already persisted on the current server.
  *