@promptbook/cli 0.114.0-2 → 0.114.0-20

package/apps/agents-server/src/components/AgentProjectDnsInstructions/AgentProjectDnsInstructions.tsx

@@ -1,182 +0,0 @@
-'use client';
-
-import { useId, useState } from 'react';
-import { DnsProviderGuides } from '../DnsProviderGuides/DnsProviderGuides';
-import { createAgentProjectDnsRecord } from '../../utils/agentProjects/createAgentProjectDnsRecords';
-
-/**
- * Displays DNS setup instructions for generated agent project domains.
- *
- * The two tab groups intentionally represent independent choices: one domain
- * coverage and one record type. Exactly one record from the selected
- * combination should be configured at the DNS provider.
- */
-export function AgentProjectDnsInstructions({
-    isDnsIssue = false,
-    projectDomain,
-    publicIpAddress,
-    serverDomain,
-}: {
-    /**
-     * Whether at least one generated project domain currently fails DNS verification.
-     */
-    readonly isDnsIssue?: boolean;
-
-    /**
-     * Example generated project domain used by the single-project variant, when one already exists.
-     */
-    readonly projectDomain?: string | null;
-
-    /**
-     * Public VPS IP address, when known by the server.
-     */
-    readonly publicIpAddress: string | null | undefined;
-
-    /**
-     * Base server domain used by generated project domains.
-     */
-    readonly serverDomain: string;
-}) {
-    const [isWildcardDomain, setIsWildcardDomain] = useState(true);
-    const [isCnameRecord, setIsCnameRecord] = useState(true);
-    const instructionId = useId();
-    const selectedRecord = createAgentProjectDnsRecord({
-        isCnameRecord,
-        isWildcardDomain,
-        projectDomain,
-        publicIpAddress,
-        serverDomain,
-    });
-    const selectedDomainDescription = isWildcardDomain
-        ? `This covers all generated project domains under ${serverDomain}.`
-        : projectDomain
-        ? `This covers one project, for example ${projectDomain}. Repeat it for each project that needs a public URL.`
-        : 'This covers one generated project. Replace the project name placeholder above with its full hostname.';
-
-    return (
-        <section className="space-y-4 rounded-lg border border-indigo-200 bg-indigo-50 px-4 py-4 text-sm text-indigo-950">
-            <div className="space-y-1">
-                <h4 className="font-semibold">Project DNS setup</h4>
-                <p>
-                    Project URLs use a subdomain of <code>{serverDomain}</code>. Configure exactly one of the following
-                    setups; do not add both the single-project and wildcard records, or both A and CNAME records for the
-                    same hostname.
-                </p>
-            </div>
-
-            {isDnsIssue ? (
-                <p className="rounded-md border border-amber-200 bg-amber-50 px-3 py-2 text-amber-900">
-                    One or more generated project domains do not resolve to this VPS yet. The recommended wildcard CNAME
-                    setup is selected below.
-                </p>
-            ) : null}
-
-            <div className="grid gap-4 md:grid-cols-2">
-                <DnsInstructionTabGroup
-                    label="Domain coverage"
-                    tabs={[
-                        { label: 'Single project', value: false },
-                        { label: 'Wildcard (all projects, recommended)', value: true },
-                    ]}
-                    selectedValue={isWildcardDomain}
-                    onSelect={setIsWildcardDomain}
-                    idPrefix={`${instructionId}-domain`}
-                />
-                <DnsInstructionTabGroup
-                    label="Record type"
-                    tabs={[
-                        { label: 'A record (VPS IP)', value: false },
-                        { label: 'CNAME record (server domain, recommended)', value: true },
-                    ]}
-                    selectedValue={isCnameRecord}
-                    onSelect={setIsCnameRecord}
-                    idPrefix={`${instructionId}-record`}
-                />
-            </div>
-
-            <p className="text-indigo-900">{selectedDomainDescription}</p>
-
-            <div className="overflow-x-auto rounded-lg border border-indigo-200 bg-white">
-                <table className="min-w-full divide-y divide-indigo-100 text-xs">
-                    <thead className="bg-indigo-100/60 text-indigo-900">
-                        <tr>
-                            <th className="px-3 py-2 text-left font-semibold">Type</th>
-                            <th className="px-3 py-2 text-left font-semibold">Name</th>
-                            <th className="px-3 py-2 text-left font-semibold">Value</th>
-                            <th className="px-3 py-2 text-left font-semibold">When to use</th>
-                        </tr>
-                    </thead>
-                    <tbody>
-                        <tr>
-                            <td className="px-3 py-2 font-mono font-semibold text-indigo-950">{selectedRecord.type}</td>
-                            <td className="px-3 py-2 font-mono text-slate-800">{selectedRecord.name}</td>
-                            <td className="px-3 py-2 font-mono text-slate-800">{selectedRecord.value}</td>
-                            <td className="px-3 py-2 text-indigo-900">{selectedRecord.note}</td>
-                        </tr>
-                    </tbody>
-                </table>
-            </div>
-
-            <div className="space-y-2">
-                <p className="font-medium">How to set it up</p>
-                <ol className="list-decimal space-y-1 pl-5 text-indigo-900">
-                    <li>Open the DNS settings for the domain.</li>
-                    <li>Add the single record shown above.</li>
-                    <li>Remove conflicting A, AAAA, or CNAME records for the same hostname.</li>
-                    <li>Wait for DNS propagation, then open the project URL again.</li>
-                </ol>
-            </div>
-
-            <div className="space-y-2">
-                <p className="font-medium">Provider guides</p>
-                <DnsProviderGuides linkClassName="font-semibold text-indigo-700 underline decoration-indigo-400 underline-offset-2 hover:text-indigo-900" />
-            </div>
-        </section>
-    );
-}
-
-/**
- * Renders one accessible two-option tab group used by the DNS instruction panel.
- */
-function DnsInstructionTabGroup<TValue extends boolean>({
-    idPrefix,
-    label,
-    onSelect,
-    selectedValue,
-    tabs,
-}: {
-    readonly idPrefix: string;
-    readonly label: string;
-    readonly onSelect: (value: TValue) => void;
-    readonly selectedValue: TValue;
-    readonly tabs: ReadonlyArray<{ readonly label: string; readonly value: TValue }>;
-}) {
-    return (
-        <div>
-            <p className="mb-2 text-xs font-semibold uppercase tracking-wide text-indigo-700">{label}</p>
-            <div className="flex rounded-md border border-indigo-200 bg-white p-1" role="tablist" aria-label={label}>
-                {tabs.map((tab) => {
-                    const isSelected = tab.value === selectedValue;
-
-                    return (
-                        <button
-                            key={tab.label}
-                            id={`${idPrefix}-${tab.value ? 'alternative' : 'primary'}`}
-                            type="button"
-                            role="tab"
-                            aria-selected={isSelected}
-                            onClick={() => onSelect(tab.value)}
-                            className={`flex-1 rounded px-2 py-2 text-xs font-semibold transition ${
-                                isSelected
-                                    ? 'bg-indigo-600 text-white shadow-sm'
-                                    : 'text-indigo-700 hover:bg-indigo-50 hover:text-indigo-950'
-                            }`}
-                        >
-                            {tab.label}
-                        </button>
-                    );
-                })}
-            </div>
-        </div>
-    );
-}

package/apps/agents-server/src/tools/configureTimeoutToolRuntimeAdapterForServer.ts

@@ -1,381 +0,0 @@
-import {
-    setTimeoutToolRuntimeAdapter,
-    type TimeoutToolListItem,
-    type TimeoutToolRuntimeAdapter,
-    type TimeoutToolRuntimeContext,
-} from '../../../../src/commitments/USE_TIMEOUT/USE_TIMEOUT';
-import {
-    cancelAllActiveAgentScopedUserChatTimeouts,
-    cancelScheduledUserChatTimeout,
-    getAgentScopedUserChatTimeout,
-    listAgentUserChatTimeouts,
-    notifyUserChatTimeoutScheduleChanged,
-    pauseAllActiveAgentScopedUserChatTimeouts,
-    resumeAllPausedAgentScopedUserChatTimeouts,
-    scheduleThreadScopedUserChatTimeout,
-    updateAgentScopedUserChatTimeout,
-} from '../utils/userChatTimeout';
-
-/**
- * Maximum number of timeouts returned in one `list_timeouts` runtime call.
- *
- * @private internal timeout adapter constant
- */
-const MAX_LISTED_TIMEOUTS_LIMIT = 100;
-
-/**
- * Shared timeout runtime adapter bound to the Agents Server durable chat infrastructure.
- *
- * @private internal singleton for server tool providers
- */
-const timeoutToolRuntimeAdapter: TimeoutToolRuntimeAdapter = {
-    async scheduleTimeout(
-        args: {
-            milliseconds: number;
-            message?: string;
-        },
-        runtimeContext: TimeoutToolRuntimeContext,
-    ): Promise<{
-        timeoutId: string;
-        dueAt: string;
-    }> {
-        const chatId = requireTimeoutScopeField(runtimeContext.chatId, 'chat');
-        const userId = requireTimeoutScopeField(runtimeContext.userId, 'user');
-        const agentPermanentId = requireTimeoutScopeField(runtimeContext.agentId, 'agent');
-        const timeout = await scheduleThreadScopedUserChatTimeout({
-            userId,
-            agentPermanentId,
-            chatId,
-            durationMs: args.milliseconds,
-            message: normalizeTimeoutMessage(args.message),
-            parameters: runtimeContext.promptParameters,
-        });
-
-        return {
-            timeoutId: timeout.timeoutId,
-            dueAt: timeout.dueAt,
-        };
-    },
-    async cancelTimeout(
-        args:
-            | {
-                  timeoutId: string;
-              }
-            | {
-                  allActive: true;
-              },
-        runtimeContext: TimeoutToolRuntimeContext,
-    ): Promise<{
-        status: 'cancelled' | 'cancelled_all' | 'not_found';
-        timeoutId?: string;
-        dueAt?: string;
-        cancelledCount?: number;
-        cancelledTimeoutIds?: Array<string>;
-        hasMore?: boolean;
-    }> {
-        const userId = requireTimeoutScopeField(runtimeContext.userId, 'user');
-        const agentPermanentId = requireTimeoutScopeField(runtimeContext.agentId, 'agent');
-
-        if ('allActive' in args && args.allActive) {
-            const bulkCancellationSummary = await cancelAllActiveAgentScopedUserChatTimeouts({
-                userId,
-                agentPermanentId,
-            });
-
-            return {
-                status: 'cancelled_all',
-                cancelledCount: bulkCancellationSummary.updatedCount,
-                cancelledTimeoutIds: bulkCancellationSummary.timeoutIds,
-                hasMore: bulkCancellationSummary.hasMore,
-            };
-        }
-
-        if (!('timeoutId' in args)) {
-            return {
-                status: 'not_found',
-            };
-        }
-
-        const timeoutId = args.timeoutId;
-
-        const existingTimeout = await getAgentScopedUserChatTimeout({
-            userId,
-            agentPermanentId,
-            timeoutId,
-        });
-
-        if (!existingTimeout) {
-            return {
-                timeoutId,
-                status: 'not_found',
-            };
-        }
-
-        const cancelledTimeout = await cancelScheduledUserChatTimeout(timeoutId);
-
-        if (!cancelledTimeout) {
-            return {
-                timeoutId,
-                status: 'not_found',
-            };
-        }
-
-        return {
-            timeoutId: cancelledTimeout.timeoutId,
-            dueAt: cancelledTimeout.dueAt,
-            status: 'cancelled',
-        };
-    },
-    async listTimeouts(
-        args: {
-            includeFinished: boolean;
-            limit: number;
-        },
-        runtimeContext: TimeoutToolRuntimeContext,
-    ): Promise<{
-        items: Array<TimeoutToolListItem>;
-        total: number;
-    }> {
-        const userId = requireTimeoutScopeField(runtimeContext.userId, 'user');
-        const agentPermanentId = requireTimeoutScopeField(runtimeContext.agentId, 'agent');
-        const limit = normalizeTimeoutListLimit(args.limit);
-        const statuses = args.includeFinished ? undefined : (['QUEUED', 'RUNNING'] as const);
-        const listedTimeouts = await listAgentUserChatTimeouts({
-            userId,
-            agentPermanentId,
-            limit,
-            ...(statuses ? { statuses } : {}),
-        });
-
-        return {
-            items: listedTimeouts.map(mapTimeoutRecordToToolListItem),
-            total: listedTimeouts.length,
-        };
-    },
-    async updateTimeout(
-        args:
-            | {
-                  timeoutId: string;
-                  patch: {
-                      dueAt?: string;
-                      extendByMs?: number;
-                      recurrenceIntervalMs?: number | null;
-                      message?: string | null;
-                      parameters?: Record<string, unknown>;
-                      paused?: boolean;
-                  };
-              }
-            | {
-                  allActive: true;
-                  paused: boolean;
-              },
-        runtimeContext: TimeoutToolRuntimeContext,
-    ): Promise<
-        | {
-              status: 'updated';
-              timeout: TimeoutToolListItem;
-          }
-        | {
-              status: 'not_found';
-              timeoutId: string;
-          }
-        | {
-              status: 'conflict';
-              timeoutId: string;
-              reason: 'finished' | 'running';
-          }
-        | {
-              status: 'updated_all';
-              updatedCount: number;
-              matchedCount: number;
-              updatedTimeoutIds: Array<string>;
-              hasMore?: boolean;
-          }
-    > {
-        const userId = requireTimeoutScopeField(runtimeContext.userId, 'user');
-        const agentPermanentId = requireTimeoutScopeField(runtimeContext.agentId, 'agent');
-
-        if ('allActive' in args && args.allActive) {
-            const bulkSummary = args.paused
-                ? await pauseAllActiveAgentScopedUserChatTimeouts({
-                      userId,
-                      agentPermanentId,
-                  })
-                : await resumeAllPausedAgentScopedUserChatTimeouts({
-                      userId,
-                      agentPermanentId,
-                  });
-
-            return {
-                status: 'updated_all',
-                updatedCount: bulkSummary.updatedCount,
-                matchedCount: bulkSummary.matchedCount,
-                updatedTimeoutIds: bulkSummary.timeoutIds,
-                hasMore: bulkSummary.hasMore,
-            };
-        }
-
-        if (!('timeoutId' in args) || !('patch' in args)) {
-            return {
-                status: 'not_found',
-                timeoutId: '',
-            };
-        }
-
-        const timeoutId = args.timeoutId;
-        const timeoutPatch = args.patch;
-
-        const existingTimeout = await getAgentScopedUserChatTimeout({
-            userId,
-            agentPermanentId,
-            timeoutId,
-        });
-
-        if (!existingTimeout) {
-            return {
-                status: 'not_found',
-                timeoutId,
-            };
-        }
-
-        if (isFinishedTimeoutStatus(existingTimeout.status)) {
-            return {
-                status: 'conflict',
-                timeoutId,
-                reason: 'finished',
-            };
-        }
-
-        if (existingTimeout.status === 'RUNNING') {
-            return {
-                status: 'conflict',
-                timeoutId,
-                reason: 'running',
-            };
-        }
-
-        const updatedTimeout = await updateAgentScopedUserChatTimeout({
-            userId,
-            agentPermanentId,
-            timeoutId,
-            patch: {
-                ...(timeoutPatch.dueAt !== undefined ? { dueAt: timeoutPatch.dueAt } : {}),
-                ...(timeoutPatch.extendByMs !== undefined ? { extendByMs: timeoutPatch.extendByMs } : {}),
-                ...(timeoutPatch.recurrenceIntervalMs !== undefined
-                    ? { recurrenceIntervalMs: timeoutPatch.recurrenceIntervalMs }
-                    : {}),
-                ...(timeoutPatch.message !== undefined
-                    ? { message: normalizeTimeoutMessage(timeoutPatch.message) || null }
-                    : {}),
-                ...(timeoutPatch.parameters !== undefined ? { parameters: timeoutPatch.parameters } : {}),
-                ...(timeoutPatch.paused !== undefined
-                    ? { pausedAt: timeoutPatch.paused ? new Date().toISOString() : null }
-                    : {}),
-            },
-        });
-
-        if (!updatedTimeout) {
-            return {
-                status: 'not_found',
-                timeoutId,
-            };
-        }
-
-        notifyUserChatTimeoutScheduleChanged(updatedTimeout);
-
-        return {
-            status: 'updated',
-            timeout: mapTimeoutRecordToToolListItem(updatedTimeout),
-        };
-    },
-};
-
-/**
- * Installs the Agents Server timeout runtime adapter into the `USE TIMEOUT` commitment layer.
- *
- * @private internal utility for server tool providers
- */
-export function configureTimeoutToolRuntimeAdapterForServer(): void {
-    setTimeoutToolRuntimeAdapter(timeoutToolRuntimeAdapter);
-}
-
-/**
- * Trims optional timeout follow-up message text before persistence.
- *
- * @private internal utility for timeout tool adapters
- */
-function normalizeTimeoutMessage(value: unknown): string | undefined {
-    if (typeof value !== 'string') {
-        return undefined;
-    }
-
-    const normalizedValue = value.trim();
-    return normalizedValue || undefined;
-}
-
-/**
- * Ensures one required timeout scope field is available in runtime context.
- *
- * @private internal utility for timeout tool adapters
- */
-function requireTimeoutScopeField<TValue>(
-    value: TValue | undefined,
-    fieldName: 'chat' | 'user' | 'agent',
-): TValue {
-    if (value === undefined || value === null) {
-        throw new Error(`Timeouts are unavailable because ${fieldName} scope context is missing.`);
-    }
-
-    if (typeof value === 'string' && value.length === 0) {
-        throw new Error(`Timeouts are unavailable because ${fieldName} scope context is missing.`);
-    }
-
-    return value;
-}
-
-/**
- * Clamps requested timeout-list limits to the supported adapter range.
- *
- * @private internal utility for timeout tool adapters
- */
-function normalizeTimeoutListLimit(value: number): number {
-    if (!Number.isFinite(value)) {
-        return MAX_LISTED_TIMEOUTS_LIMIT;
-    }
-
-    return Math.max(1, Math.min(MAX_LISTED_TIMEOUTS_LIMIT, Math.floor(value)));
-}
-
-/**
- * Maps one stored timeout record into one `USE TIMEOUT` list item.
- *
- * @private internal utility for timeout tool adapters
- */
-function mapTimeoutRecordToToolListItem(timeout: {
-    timeoutId: string;
-    chatId: string;
-    status: TimeoutToolListItem['status'];
-    dueAt: string;
-    pausedAt: string | null;
-    message: string | null;
-    recurrenceIntervalMs: number | null;
-}): TimeoutToolListItem {
-    return {
-        timeoutId: timeout.timeoutId,
-        chatId: timeout.chatId,
-        status: timeout.status,
-        dueAt: timeout.dueAt,
-        paused: Boolean(timeout.pausedAt),
-        message: timeout.message,
-        recurrenceIntervalMs: timeout.recurrenceIntervalMs,
-    };
-}
-
-/**
- * Returns `true` when one timeout has reached a terminal state.
- *
- * @private internal utility for timeout tool adapters
- */
-function isFinishedTimeoutStatus(status: TimeoutToolListItem['status']): boolean {
-    return status === 'COMPLETED' || status === 'FAILED' || status === 'CANCELLED';
-}

package/apps/agents-server/src/utils/emails/extractUseEmailConfigurationFromAgentSource.ts

@@ -1,42 +0,0 @@
-import { parseAgentSourceWithCommitments } from '../../../../../src/book-2.0/agent-source/parseAgentSourceWithCommitments';
-import type { string_book } from '../../../../../src/book-2.0/agent-source/string_book';
-import { parseUseEmailCommitmentContent } from '../../../../../src/commitments/USE_EMAIL/parseUseEmailCommitmentContent';
-
-/**
- * USE EMAIL configuration extracted from an agent source.
- */
-export type UseEmailConfiguration = {
-    isEnabled: boolean;
-    senderEmail?: string;
-};
-
-/**
- * Extracts USE EMAIL settings from agent source.
- */
-export function extractUseEmailConfigurationFromAgentSource(agentSource: string_book): UseEmailConfiguration {
-    const parseResult = parseAgentSourceWithCommitments(agentSource);
-    let senderEmail: string | undefined;
-    let isEnabled = false;
-
-    for (const commitment of parseResult.commitments) {
-        if (commitment.type !== 'USE EMAIL') {
-            continue;
-        }
-
-        isEnabled = true;
-
-        if (senderEmail) {
-            continue;
-        }
-
-        const parsedCommitment = parseUseEmailCommitmentContent(commitment.content);
-        if (parsedCommitment.senderEmail) {
-            senderEmail = parsedCommitment.senderEmail;
-        }
-    }
-
-    return {
-        isEnabled,
-        ...(senderEmail ? { senderEmail } : {}),
-    };
-}

package/apps/agents-server/src/utils/userChatClient/runAgentUserTimeoutBulkAction.ts

@@ -1,24 +0,0 @@
-'use client';
-
-import type { AgentUserTimeoutBulkAction, AgentUserTimeoutBulkActionResponse } from '../userChatClient';
-import { requestUserChatApi } from './requestUserChatApi';
-
-/**
- * Executes one bulk timeout action in the agent-wide timeout manager.
- *
- * @private shared helper for the Agents Server browser client
- */
-export async function runAgentUserTimeoutBulkAction(
-    agentName: string,
-    action: AgentUserTimeoutBulkAction,
-): Promise<AgentUserTimeoutBulkActionResponse> {
-    return await requestUserChatApi<AgentUserTimeoutBulkActionResponse>(
-        `/agents/${encodeURIComponent(agentName)}/api/timeouts/actions`,
-        {
-            method: 'POST',
-            headers: { 'Content-Type': 'application/json' },
-            body: JSON.stringify({ action }),
-        },
-        'Failed to execute timeout bulk action.',
-    );
-}

package/apps/agents-server/src/utils/userChatClient/updateAgentUserTimeout.ts

@@ -1,25 +0,0 @@
-'use client';
-
-import type { AgentUserTimeoutUpdatePayload, UserChatTimeout } from '../userChatClient';
-import { requestUserChatApi } from './requestUserChatApi';
-
-/**
- * Updates one durable timeout in the agent-wide timeout manager.
- *
- * @private shared helper for the Agents Server browser client
- */
-export async function updateAgentUserTimeout(
-    agentName: string,
-    timeoutId: string,
-    payload: AgentUserTimeoutUpdatePayload,
-): Promise<UserChatTimeout> {
-    return await requestUserChatApi<UserChatTimeout>(
-        `/agents/${encodeURIComponent(agentName)}/api/timeouts/${encodeURIComponent(timeoutId)}`,
-        {
-            method: 'PATCH',
-            headers: { 'Content-Type': 'application/json' },
-            body: JSON.stringify(payload),
-        },
-        'Failed to update agent timeout.',
-    );
-}