@promptbook/cli 0.112.0-110 → 0.112.0-112

package/umd/src/cli/cli-commands/agents-server/startAgentsServer.d.ts

@@ -29,7 +29,8 @@ export type StartAgentsServerOptions = {
  */
 export declare function startAgentsServer(options: StartAgentsServerOptions): Promise<void>;
 /**
- * Loads launch-directory `.env` values without overriding explicit process environment.
+ * Loads Agents Server runtime environment from the installed `.env` file when explicitly configured and falls back
+ * to the launch-directory `.env`.
  *
  * @private internal utility of `ptbk agents-server`
  */

package/umd/src/cli/cli-commands/agents-server/startAgentsServer.test.d.ts

@@ -0,0 +1 @@
+export {};

package/umd/src/collection/agent-collection/constructors/agent-collection-in-supabase/AgentCollectionInSupabase.d.ts

@@ -60,6 +60,28 @@ export declare class AgentCollectionInSupabase {
      * Gets all agents in the collection
      */
     listAgents(): Promise<ReadonlyArray<AgentBasicInformation>>;
+    /**
+     * Finds one active agent profile by its human-readable name or permanent id.
+     *
+     * This keeps route-level lookups from loading the whole agent collection when only
+     * one canonical route identifier is needed.
+     *
+     * @param agentNameOrPermanentId - Agent name or stable permanent identifier.
+     * @returns Matching active agent profile or `null` when not found.
+     *
+     * @public exported from `@promptbook/core`
+     */
+    findAgentBasicInformation(agentNameOrPermanentId: string_agent_name | string_agent_permanent_id): Promise<AgentBasicInformation | null>;
+    /**
+     * Converts one database row into public agent information.
+     *
+     * @param row - Database row carrying the persisted profile snapshot.
+     * @param isVerbose - Whether profile-name mismatches should be logged.
+     * @returns Agent profile with canonical database name and permanent id.
+     *
+     * @private internal helper of `AgentCollectionInSupabase`
+     */
+    private mapAgentBasicInformationRow;
     /**
      * Retrieves the permanent ID of an agent by its name or permanent ID.
      */

package/umd/src/version.d.ts

@@ -15,7 +15,7 @@ export declare const BOOK_LANGUAGE_VERSION: string_semantic_version;
 export declare const PROMPTBOOK_ENGINE_VERSION: string_promptbook_version;
 /**
  * Represents the version string of the Promptbook engine.
- * It follows semantic versioning (e.g., `0.112.0-109`).
+ * It follows semantic versioning (e.g., `0.112.0-111`).
  *
  * @generated
  */

package/apps/agents-server/src/utils/userChat/getUserChatRevision.ts

@@ -1,145 +0,0 @@
-import type { UserChatRow } from './UserChatRow';
-import { provideUserChatTable } from './provideUserChatTable';
-import type { UserChatJobRow } from './UserChatJobRow';
-import { provideUserChatJobTable } from './provideUserChatJobTable';
-import { ACTIVE_USER_CHAT_TIMEOUT_STATUSES } from '../userChatTimeout/userChatTimeoutStore/ACTIVE_USER_CHAT_TIMEOUT_STATUSES';
-import { isMissingUserChatTimeoutRelationError } from '../userChatTimeout/userChatTimeoutStore/isMissingUserChatTimeoutRelationError';
-import { provideUserChatTimeoutTable } from '../userChatTimeout/userChatTimeoutStore/provideUserChatTimeoutTable';
-import type { UserChatTimeoutRow } from '../userChatTimeout/UserChatTimeoutRecord';
-import { USER_CHAT_SOURCES } from './UserChatSource';
-
-/**
- * Active user-chat job statuses that keep the live chat stream in a faster polling mode.
- */
-const ACTIVE_USER_CHAT_JOB_STATUSES = ['QUEUED', 'RUNNING'] as const;
-
-/**
- * Compact active-job shape used only for revision comparison.
- */
-export type UserChatRevisionJob = Pick<UserChatJobRow, 'id' | 'status' | 'cancelRequestedAt'>;
-
-/**
- * Compact active-timeout shape used only for revision comparison.
- */
-export type UserChatRevisionTimeout = Pick<
-    UserChatTimeoutRow,
-    'id' | 'status' | 'message' | 'dueAt' | 'cancelRequestedAt'
->;
-
-/**
- * Lightweight revision metadata for detecting whether a chat detail payload changed.
- */
-export type UserChatRevision = {
-    id: string;
-    updatedAt: string;
-    draftMessage: string | null;
-    source: UserChatRow['source'];
-    activeJobs: Array<UserChatRevisionJob>;
-    activeTimeouts: Array<UserChatRevisionTimeout>;
-};
-
-/**
- * Loads one scoped chat revision without hydrating the full `messages` JSON payload.
- */
-export async function getUserChatRevision(options: {
-    userId: number;
-    viewerIsAdmin?: boolean;
-    agentPermanentId: string;
-    chatId: string;
-}): Promise<UserChatRevision | null> {
-    const { userId, viewerIsAdmin = false, agentPermanentId, chatId } = options;
-    const userChatTable = await provideUserChatTable();
-
-    const { data, error } = await userChatTable
-        .select('id, userId, updatedAt, draftMessage, source')
-        .eq('id', chatId)
-        .eq('agentPermanentId', agentPermanentId)
-        .maybeSingle();
-
-    if (error) {
-        throw new Error(`Failed to load user chat revision "${chatId}": ${error.message}`);
-    }
-
-    if (!data) {
-        return null;
-    }
-
-    const row = data as Pick<UserChatRow, 'id' | 'userId' | 'updatedAt' | 'draftMessage' | 'source'>;
-    if (row.source === USER_CHAT_SOURCES.WEB_UI) {
-        if (row.userId !== userId) {
-            return null;
-        }
-    } else if (!viewerIsAdmin) {
-        return null;
-    }
-
-    const [activeJobs, activeTimeouts] = await Promise.all([
-        listUserChatRevisionActiveJobs({ userId: row.userId, agentPermanentId, chatId }),
-        listUserChatRevisionActiveTimeouts({ userId: row.userId, agentPermanentId, chatId }),
-    ]);
-
-    return {
-        id: row.id,
-        updatedAt: row.updatedAt,
-        draftMessage: row.draftMessage,
-        source: row.source,
-        activeJobs,
-        activeTimeouts,
-    };
-}
-
-/**
- * Lists only active job fields that affect the canonical chat surface.
- */
-async function listUserChatRevisionActiveJobs(options: {
-    userId: number;
-    agentPermanentId: string;
-    chatId: string;
-}): Promise<Array<UserChatRevisionJob>> {
-    const userChatJobTable = await provideUserChatJobTable();
-    const { data, error } = await userChatJobTable
-        .select('id, status, cancelRequestedAt')
-        .eq('chatId', options.chatId)
-        .eq('userId', options.userId)
-        .eq('agentPermanentId', options.agentPermanentId)
-        .in('status', ACTIVE_USER_CHAT_JOB_STATUSES)
-        .order('createdAt', { ascending: true });
-
-    if (error) {
-        throw new Error(`Failed to load active user chat job revisions for chat "${options.chatId}": ${error.message}`);
-    }
-
-    return (data || []) as Array<UserChatRevisionJob>;
-}
-
-/**
- * Lists only active timeout fields that affect the canonical chat surface.
- */
-async function listUserChatRevisionActiveTimeouts(options: {
-    userId: number;
-    agentPermanentId: string;
-    chatId: string;
-}): Promise<Array<UserChatRevisionTimeout>> {
-    const userChatTimeoutTable = await provideUserChatTimeoutTable();
-    const { data, error } = await userChatTimeoutTable
-        .select('id, status, message, dueAt, cancelRequestedAt')
-        .eq('chatId', options.chatId)
-        .eq('userId', options.userId)
-        .eq('agentPermanentId', options.agentPermanentId)
-        .in('status', ACTIVE_USER_CHAT_TIMEOUT_STATUSES)
-        .is('pausedAt', null)
-        .order('dueAt', { ascending: true })
-        .order('createdAt', { ascending: true });
-
-    if (error) {
-        if (isMissingUserChatTimeoutRelationError(error)) {
-            return [];
-        }
-
-        throw new Error(
-            `Failed to load active user chat timeout revisions for chat "${options.chatId}": ${error.message}`,
-        );
-    }
-
-    return (data || []) as Array<UserChatRevisionTimeout>;
-}