@promptbook/cli 0.114.0-0 → 0.114.0-10

package/apps/agents-server/src/components/NewAgentDialog/ManGoNewAgentWizard/services/draftService.ts

@@ -1,32 +0,0 @@
-import { postManGoOnboardingJson } from './postManGoOnboardingJson';
-
-/**
- * Response returned by the manGo Book draft endpoint.
- *
- * @private internal type of the manGo wizard draft service.
- */
-type GenerateBookDraftResponse = {
-    readonly draft: string;
-};
-
-/**
- * Builds the initial Book source for the imported manGo wizard.
- *
- * The external experiment generated a markdown draft through a separate API. The Agents
- * Server creates agents from Book language directly, so this boundary keeps the same
- * loading UX while returning a valid editable Book draft.
- *
- * @param input - Agent name and brief captured by the entry step.
- * @returns Editable Book source used by the following wizard steps.
- */
-export async function generateBookDraft(input: {
-    readonly agentName: string;
-    readonly agentBrief: string;
-}): Promise<string> {
-    const response = await postManGoOnboardingJson<GenerateBookDraftResponse>('/api/onboarding/draft', {
-        agentName: input.agentName,
-        agentBrief: input.agentBrief,
-    });
-
-    return response.draft;
-}

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.',
-    );
-}

package/esm/src/cli/cli-commands/common/harness/extractHarnessVersionFromOutput.d.ts

@@ -1,11 +0,0 @@
-/**
- * Extracts the version from the raw output of a harness `--version` command.
- *
- * Harness CLIs print their version in many shapes, for example `2.1.199 (Claude Code)`,
- * `codex-cli 0.144.4`, `GitHub Copilot CLI 1.0.61.` or after unrelated deprecation warning lines,
- * so the first version-looking token of the first matching line wins.
- *
- * @returns The parsed version or `null` when the output contains no version
- * @private internal utility of `promptbookCli`
- */
-export declare function extractHarnessVersionFromOutput(output: string): string | null;

package/esm/src/cli/cli-commands/common/harness/isHarnessVersionOutdated.d.ts

@@ -1,9 +0,0 @@
-/**
- * Compares the installed harness version with the newest version published to npm.
- *
- * Only the numeric `major.minor.patch` segments are compared and pre-release suffixes are ignored,
- * so a harness installed from a pre-release build of the newest version is not reported as outdated.
- *
- * @private internal utility of `promptbookCli`
- */
-export declare function isHarnessVersionOutdated(installedVersion: string, latestVersion: string): boolean;

package/esm/src/commitments/MEMORY/MEMORY.d.ts

@@ -1,48 +0,0 @@
-import type { AgentModelRequirements } from '../../book-2.0/agent-source/AgentModelRequirements';
-import type { ToolFunction } from '../../scripting/javascript/JavascriptExecutionToolsOptions';
-import type { string_javascript_name } from '../../types/string_person_fullname';
-import { BaseCommitmentDefinition } from '../_base/BaseCommitmentDefinition';
-export type { MemoryToolRecord, MemoryToolRuntimeAdapter, MemoryToolRuntimeContext } from './MemoryToolRuntimeAdapter';
-export { setMemoryToolRuntimeAdapter } from './setMemoryToolRuntimeAdapter';
-/**
- * MEMORY commitment definition
- *
- * The MEMORY commitment is similar to KNOWLEDGE but has a focus on remembering past
- * interactions and user preferences. It helps the agent maintain context about the
- * user's history, preferences, and previous conversations.
- *
- * Example usage in agent source:
- *
- * ```book
- * MEMORY User prefers detailed technical explanations
- * MEMORY Previously worked on React projects
- * MEMORY Timezone: UTC-5 (Eastern Time)
- * ```
- *
- * @private [🪔] Maybe export the commitments through some package
- */
-export declare class MemoryCommitmentDefinition extends BaseCommitmentDefinition<'MEMORY' | 'MEMORIES'> {
-    constructor(type?: 'MEMORY' | 'MEMORIES');
-    get requiresContent(): boolean;
-    /**
-     * Short one-line description of MEMORY.
-     */
-    get description(): string;
-    /**
-     * Icon for this commitment.
-     */
-    get icon(): string;
-    /**
-     * Markdown documentation for MEMORY commitment.
-     */
-    get documentation(): string;
-    applyToAgentModelRequirements(requirements: AgentModelRequirements, content: string): AgentModelRequirements;
-    /**
-     * Gets human-readable titles for MEMORY tool functions.
-     */
-    getToolTitles(): Record<string_javascript_name, string>;
-    /**
-     * Gets MEMORY tool function implementations.
-     */
-    getToolFunctions(): Record<string_javascript_name, ToolFunction>;
-}

package/esm/src/commitments/MEMORY/MemoryToolNames.d.ts

@@ -1,11 +0,0 @@
-/**
- * Names of tools used by the MEMORY commitment.
- *
- * @private function of MemoryCommitmentDefinition
- */
-export declare const MemoryToolNames: {
-    readonly retrieve: string;
-    readonly store: string;
-    readonly update: string;
-    readonly delete: string;
-};