npm - @promptbook/cli - Versions diffs - 0.112.0-99 → 0.113.0-0 - Mend

@promptbook/cli 0.112.0-99 → 0.113.0-0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (850) hide show

package/apps/agents-server/src/components/NewAgentDialog/ManGoNewAgentWizard/components/ui/IconButton.tsx ADDED Viewed

@@ -0,0 +1,40 @@
+import type { ButtonHTMLAttributes, ReactNode } from 'react';
+import { cn } from '../../lib/cn';
+import { FOCUS_RING } from './tokens';
+export type IconButtonSize = 'md' | 'sm';
+type IconButtonProps = ButtonHTMLAttributes<HTMLButtonElement> & {
+    /** Required for accessibility — icon-only buttons need a label. */
+    readonly label: string;
+    readonly size?: IconButtonSize;
+    readonly children: ReactNode;
+};
+const SIZES: Record<IconButtonSize, string> = {
+    md: 'h-9 w-9 text-lg',
+    sm: 'h-7 w-7 text-base',
+};
+/** Square, icon-only button with an accessible label and consistent hover/focus. */
+export function IconButton({ label, size = 'md', className, type = 'button', children, ...props }: IconButtonProps) {
+    return (
+        <button
+            type={type}
+            aria-label={label}
+            title={label}
+            className={cn(
+                'inline-flex shrink-0 items-center justify-center rounded-lg leading-none text-zinc-400',
+                'transition-colors duration-150 hover:bg-zinc-100 hover:text-zinc-700',
+                'disabled:pointer-events-none disabled:opacity-45',
+                SIZES[size],
+                FOCUS_RING,
+                className,
+            )}
+            {...props}
+        >
+            {children}
+        </button>
+    );
+}

package/apps/agents-server/src/components/NewAgentDialog/ManGoNewAgentWizard/components/ui/Spinner.tsx ADDED Viewed

@@ -0,0 +1,14 @@
+import { cn } from '../../lib/cn';
+export function Spinner({ className }: { readonly className?: string }) {
+    return (
+        <span
+            role="status"
+            aria-label="Načítání"
+            className={cn(
+                'inline-block animate-spin rounded-full border-2 border-zinc-200 border-t-[color:var(--ob-accent-600)]',
+                className ?? 'h-5 w-5',
+            )}
+        />
+    );
+}

package/apps/agents-server/src/components/NewAgentDialog/ManGoNewAgentWizard/components/ui/tokens.ts ADDED Viewed

@@ -0,0 +1,37 @@
+/**
+ * Design-system tokens for the onboarding wizard, expressed as reusable Tailwind class
+ * strings backed by the CSS variables in `globals.css`. The `[data-onboarding-ui]` token scope is set on the
+ * `WizardShell` root (present in SSR markup, inherits to every step) — every primitive in
+ * this module renders inside the shell, so no client-side <html> stamping is needed (and
+ * stamping <html> on the client would cause a server/client hydration mismatch).
+ *
+ * Centralising these strings keeps the accent hue, focus ring, radii and shadows
+ * consistent across every component (DRY) — change a token here and the whole module
+ * follows.
+ */
+/** Accent-tinted focus ring shared by every interactive control. */
+export const FOCUS_RING =
+    'focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-[color:var(--ob-ring)] focus-visible:ring-offset-2 focus-visible:ring-offset-white';
+/** Same ring, for controls that use `:focus` (inputs) rather than `:focus-visible`. */
+export const FOCUS_RING_INPUT =
+    'focus:outline-none focus:border-[color:var(--ob-accent-400)] focus:ring-4 focus:ring-[color:var(--ob-accent-500)]/15';
+/** Soft layered shadows. */
+export const SHADOW = {
+    sm: 'shadow-[var(--ob-shadow-sm)]',
+    md: 'shadow-[var(--ob-shadow-md)]',
+    lg: 'shadow-[var(--ob-shadow-lg)]',
+    accent: 'shadow-[var(--ob-shadow-accent)]',
+} as const;
+/** Accent surface utilities — kept as bracketed CSS-var classes so the palette is single-sourced. */
+export const ACCENT = {
+    text: 'text-[color:var(--ob-accent-600)]',
+    bg: 'bg-[color:var(--ob-accent-600)]',
+    bgHover: 'hover:bg-[color:var(--ob-accent-700)]',
+    bgActive: 'active:bg-[color:var(--ob-accent-800)]',
+    border: 'border-[color:var(--ob-accent-200)]',
+    softBg: 'bg-[color:var(--ob-accent-50)]',
+} as const;

package/apps/agents-server/src/components/NewAgentDialog/ManGoNewAgentWizard/config/bookSections.ts ADDED Viewed

@@ -0,0 +1,62 @@
+import { spaceTrim } from 'spacetrim';
+/**
+ * Predefined markdown sections offered as "Přidat sekci" chips in the book editor.
+ * Mirrors the wireframe's section presets; users append and then freely edit them.
+ */
+export type BookSectionPreset = {
+    readonly key: string;
+    readonly label: string;
+    readonly markdown: string;
+};
+export const BOOK_SECTION_PRESETS: readonly BookSectionPreset[] = [
+    {
+        key: 'priklady',
+        label: 'Příklady odpovědí',
+        markdown: spaceTrim(`
+            ## Příklady odpovědí
+            **Dotaz:** Kde je moje objednávka?
+            **Odpověď:** Dobrý den, děkujeme za zprávu. Vaši objednávku jsme ověřili — …
+        `),
+    },
+    {
+        key: 'eskalace',
+        label: 'Eskalace',
+        markdown: spaceTrim(`
+            ## Eskalace
+            Kdy předat člověku:
+            - Reklamace nad 10 000 Kč
+            - Rozzlobený zákazník (2. a další urgence)
+            - Právní dotazy
+        `),
+    },
+    {
+        key: 'podpis',
+        label: 'Podpis / šablona',
+        markdown: spaceTrim(`
+            ## Podpis / šablona
+            S pozdravem,
+            Zákaznická podpora
+            kontakt@firma.cz
+        `),
+    },
+    {
+        key: 'zakazana',
+        label: 'Zakázaná témata',
+        markdown: spaceTrim(`
+            ## Zakázaná témata
+            - Interní procesy a ceny dodavatelů
+            - Srovnávání s konkurencí
+            - Právní stanoviska
+        `),
+    },
+    {
+        key: 'vlastni',
+        label: 'Vlastní sekce',
+        markdown: spaceTrim(`
+            ## Nová sekce
+            Sem napište cokoli dalšího…
+        `),
+    },
+];

package/apps/agents-server/src/components/NewAgentDialog/ManGoNewAgentWizard/config/emailScenarios.ts ADDED Viewed

@@ -0,0 +1,22 @@
+/** Sample customer emails for the Test step's email run — clicking one prefills the input. */
+export type EmailScenario = {
+    readonly id: string;
+    readonly label: string;
+    readonly icon: string;
+    readonly email: string;
+};
+export const EMAIL_SCENARIOS: readonly EmailScenario[] = [
+    {
+        id: 'reklamace',
+        label: 'Reklamace poškozeného zboží',
+        icon: '📦',
+        email: 'Dobrý den, objednané zboží (obj. č. 2206114521) mi dorazilo poškozené — rozbitý displej. Chci ho reklamovat, jak mám postupovat? Děkuji, Nováková',
+    },
+    {
+        id: 'nedorucena',
+        label: 'Nedoručená zásilka',
+        icon: '🚚',
+        email: 'Dobrý den, před 3 dny jsem objednal zboží (obj. č. 2206114521) a stále mi nedorazilo. Kdy ho mohu čekat? Děkuji, Novák',
+    },
+];

package/apps/agents-server/src/components/NewAgentDialog/ManGoNewAgentWizard/config/steps.ts ADDED Viewed

@@ -0,0 +1,46 @@
+/**
+ * The wizard steps shown in the stepper. "Zadání" (the entry screen at `/onboarding`)
+ * is intentionally NOT a stepper step — it is the way in, before the book exists.
+ */
+export type OnboardingStepId = 'book' | 'knowledge' | 'test' | 'done';
+export type OnboardingStep = {
+    readonly id: OnboardingStepId;
+    readonly label: string;
+    readonly path: string;
+};
+export const ONBOARDING_STEPS: readonly OnboardingStep[] = [
+    { id: 'book', label: 'Book', path: '/onboarding/book' },
+    { id: 'knowledge', label: 'Znalosti', path: '/onboarding/knowledge' },
+    { id: 'test', label: 'Test', path: '/onboarding/test' },
+    { id: 'done', label: 'Hotovo', path: '/onboarding/done' },
+];
+export const ONBOARDING_ENTRY_PATH = '/onboarding';
+export function getStepIndexByPath(pathname: string): number {
+    return ONBOARDING_STEPS.findIndex((step) => step.path === pathname);
+}
+/**
+ * The full flow including the entry "Zadání" screen — used by the rail's vertical stepper
+ * and progress so the wizard chrome is consistent on every screen (including the entry).
+ */
+export type OnboardingFlowStep = {
+    readonly id: string;
+    readonly label: string;
+    readonly path: string;
+};
+export const ONBOARDING_FLOW: readonly OnboardingFlowStep[] = [
+    { id: 'intro', label: 'Zadání', path: ONBOARDING_ENTRY_PATH },
+    ...ONBOARDING_STEPS,
+];
+/** Index of the active flow step for a pathname, or 0 (intro) when nothing matches. */
+export function getFlowIndexByPath(pathname: string): number {
+    const index = ONBOARDING_FLOW.findIndex((step) => step.path === pathname);
+    return index === -1 ? 0 : index;
+}

package/apps/agents-server/src/components/NewAgentDialog/ManGoNewAgentWizard/index.ts ADDED Viewed

@@ -0,0 +1,11 @@
+/**
+ * Public surface of the onboarding module. Route files import only from here, keeping
+ * `src/routes/onboarding/*` as thin wrappers around the module.
+ */
+export { OnboardingProvider } from './state/OnboardingProvider';
+export { WizardShell } from './components/WizardShell';
+export { ZadaniStep } from './components/steps/ZadaniStep';
+export { BookStep } from './components/steps/BookStep';
+export { KnowledgeStep } from './components/steps/KnowledgeStep';
+export { TestStep } from './components/steps/TestStep';
+export { DoneStep } from './components/steps/DoneStep';

package/apps/agents-server/src/components/NewAgentDialog/ManGoNewAgentWizard/lib/cn.ts ADDED Viewed

@@ -0,0 +1,4 @@
+/** Joins truthy class names into a single string. Tiny local helper, no dependency. */
+export function cn(...classes: ReadonlyArray<string | false | null | undefined>): string {
+    return classes.filter(Boolean).join(' ');
+}

package/apps/agents-server/src/components/NewAgentDialog/ManGoNewAgentWizard/lib/format.ts ADDED Viewed

@@ -0,0 +1,9 @@
+export function formatFileSize(size: number): string {
+    if (size < 1024) {
+        return `${size} B`;
+    }
+    if (size < 1024 * 1024) {
+        return `${(size / 1024).toFixed(1)} KB`;
+    }
+    return `${(size / 1024 / 1024).toFixed(1)} MB`;
+}

package/apps/agents-server/src/components/NewAgentDialog/ManGoNewAgentWizard/lib/id.ts ADDED Viewed

@@ -0,0 +1,11 @@
+/**
+ * Small client-side id generator for in-memory list keys (knowledge items, chat messages).
+ * Not security-sensitive; falls back gracefully where `crypto.randomUUID` is unavailable.
+ */
+export function createId(): string {
+    if (typeof crypto !== 'undefined' && typeof crypto.randomUUID === 'function') {
+        return crypto.randomUUID();
+    }
+    return `id-${Math.random().toString(36).slice(2)}-${Date.now().toString(36)}`;
+}

package/apps/agents-server/src/components/NewAgentDialog/ManGoNewAgentWizard/services/agentEvalService.ts ADDED Viewed

@@ -0,0 +1,30 @@
+export type ReplyCheck = {
+    readonly status: 'ok' | 'warn';
+    readonly text: string;
+};
+/**
+ * Boundary to the `evaluateAgentReply` server function — judges a proposed reply against
+ * the book and returns pass/warn checks for the Test step's result panel.
+ *
+ * @param input - Current Book source, customer input, and generated preview reply.
+ * @returns Lightweight local checks for the preview result.
+ */
+export async function evaluateReply(input: {
+    readonly bookSource: string;
+    readonly customerEmail: string;
+    readonly reply: string;
+}): Promise<ReplyCheck[]> {
+    return [
+        {
+            status: input.bookSource.trim() && input.reply.trim() ? 'ok' : 'warn',
+            text: input.bookSource.trim()
+                ? 'Book je pro testovací běh vyplněný.'
+                : 'Book je prázdný, odpověď je pouze obecný náhled.',
+        },
+        {
+            status: input.customerEmail.trim() ? 'ok' : 'warn',
+            text: input.customerEmail.trim() ? 'Testovací vstup je vyplněný.' : 'Doplňte testovací vstup.',
+        },
+    ];
+}

package/apps/agents-server/src/components/NewAgentDialog/ManGoNewAgentWizard/services/agentTestService.ts ADDED Viewed

@@ -0,0 +1,69 @@
+import { spaceTrim } from 'spacetrim';
+import type { ChatMessage, KnowledgeItem } from '../types';
+export type AgentTestRequest = {
+    readonly bookSource: string;
+    readonly knowledge: readonly KnowledgeItem[];
+    readonly messages: readonly ChatMessage[];
+};
+export type AgentTestReply = {
+    readonly role: 'agent';
+    readonly content: string;
+};
+/**
+ * Boundary for "run the agent against a test message". Backed by the `runAgentTest`
+ * server function (Promptbook `LiteAgent`). The UI depends only on this interface — see
+ * the wizard Test step.
+ */
+export type AgentTestService = {
+    send(request: AgentTestRequest): Promise<AgentTestReply>;
+}
+/** Public URLs of knowledge sources that finished uploading (files → S3 URL, links → URL). */
+function knowledgeUrls(knowledge: readonly KnowledgeItem[]): string[] {
+    return knowledge
+        .filter((item) => item.status === 'ready')
+        .map((item) => (item.kind === 'url' ? item.url : item.publicUrl))
+        .filter((url) => url.length > 0);
+}
+/**
+ * Resolves the last user message sent to the preview responder.
+ *
+ * @param messages - Chat history collected in the test step.
+ * @returns Most recent user message content.
+ */
+function getLastUserMessage(messages: readonly ChatMessage[]): string {
+    for (let index = messages.length - 1; index >= 0; index -= 1) {
+        const message = messages[index];
+        if (message.role === 'user') {
+            return message.content;
+        }
+    }
+    return '';
+}
+export const agentTestService: AgentTestService = {
+    async send(request) {
+        const lastUserMessage = getLastUserMessage(request.messages);
+        const readyKnowledgeUrls = knowledgeUrls(request.knowledge);
+        const reply = spaceTrim(`
+            Návrh odpovědi podle aktuálního booku:
+            Rozumím požadavku: "${lastUserMessage || 'bez zadání'}"
+            Doporučený postup:
+            1. Odpovědět věcně a stručně podle pravidel v booku.
+            2. Zmínit dostupný kontext ze znalostní báze${
+                readyKnowledgeUrls.length > 0 ? ` (${readyKnowledgeUrls.length} zdrojů)` : ''
+            }.
+            3. Pokud chybí jistota, požádat o doplnění nebo předat člověku.
+        `);
+        return { role: 'agent', content: reply };
+    },
+};

package/apps/agents-server/src/components/NewAgentDialog/ManGoNewAgentWizard/services/bookService.ts ADDED Viewed

@@ -0,0 +1,21 @@
+import { validateBook } from '../../../../../../../src/book-2.0/agent-source/string_book';
+/**
+ * Boundary used by the imported Book language panel.
+ *
+ * The Agents Server draft is already Book language, so conversion means validating the
+ * current editable source and returning it unchanged.
+ *
+ * @param input - Current Book editor content.
+ * @returns Validated Book source and validation flag for the panel badge.
+ */
+export async function convertToBook(input: string): Promise<{ book: string; isValid: boolean }> {
+    let isValid = true;
+    try {
+        validateBook(input);
+    } catch {
+        isValid = false;
+    }
+    return { book: input, isValid };
+}

package/apps/agents-server/src/components/NewAgentDialog/ManGoNewAgentWizard/services/createManGoAgentSource.ts ADDED Viewed

@@ -0,0 +1,107 @@
+import { spaceTrim } from 'spacetrim';
+import { validateBook, type string_book } from '../../../../../../../src/book-2.0/agent-source/string_book';
+import type { KnowledgeItem, OnboardingState } from '../types';
+/**
+ * Fallback name used when the imported wizard state has no explicit agent name.
+ */
+const FALLBACK_AGENT_NAME = 'Nový agent';
+/**
+ * Returns the source URL for one ready knowledge item.
+ *
+ * @param item - Knowledge item collected in the wizard.
+ * @returns Source URL or an empty string when the item is not ready.
+ */
+function getKnowledgeSource(item: KnowledgeItem): string {
+    if (item.status !== 'ready') {
+        return '';
+    }
+    return item.kind === 'url' ? item.url : item.publicUrl;
+}
+/**
+ * Creates a minimal Book source when the editable draft is empty.
+ *
+ * @param state - Current wizard state.
+ * @returns Book source fallback.
+ */
+function createFallbackBookSource(state: OnboardingState): string {
+    const agentName = state.agentName.trim() || FALLBACK_AGENT_NAME;
+    const agentBrief = state.agentBrief.trim() || 'Help users with the assigned business workflow.';
+    return spaceTrim(`
+        ${agentName}
+        NOTE This agent was created via the NEW_AGENT_WIZARD manGo wizard flow
+        GOAL ${agentBrief}
+        CLOSED
+    `);
+}
+/**
+ * Ensures the source begins with an agent title line.
+ *
+ * @param source - Editable Book source from the wizard.
+ * @param agentName - Agent name captured on the first step.
+ * @returns Source with a first-line title.
+ */
+function ensureBookTitle(source: string, agentName: string): string {
+    if (source.trim() !== '') {
+        return source;
+    }
+    return agentName.trim() || FALLBACK_AGENT_NAME;
+}
+/**
+ * Inserts extra commitments before a final `OPEN` or `CLOSED` marker when present.
+ *
+ * @param source - Current Book source.
+ * @param commitments - Commitment lines to insert.
+ * @returns Source with inserted commitments.
+ */
+function insertCommitmentsBeforeLearningMarker(source: string, commitments: ReadonlyArray<string>): string {
+    if (commitments.length === 0) {
+        return source;
+    }
+    const lines = source.replace(/\r\n/g, '\n').split('\n');
+    let markerIndex = -1;
+    for (let lineIndex = lines.length - 1; lineIndex >= 0; lineIndex -= 1) {
+        const normalizedLine = lines[lineIndex].trim().toUpperCase();
+        if (normalizedLine === 'OPEN' || normalizedLine === 'CLOSED') {
+            markerIndex = lineIndex;
+            break;
+        }
+    }
+    const insertionLines = ['', ...commitments];
+    if (markerIndex === -1) {
+        return [...lines, ...insertionLines].join('\n');
+    }
+    return [...lines.slice(0, markerIndex), ...insertionLines, '', ...lines.slice(markerIndex)].join('\n');
+}
+/**
+ * Builds the final Book source submitted from the manGo wizard.
+ *
+ * @param state - Current imported wizard state.
+ * @returns Validated Book source ready for the existing create-agent action.
+ */
+export function createManGoAgentSource(state: OnboardingState): string_book {
+    const editableSource = state.bookSource.trim() || createFallbackBookSource(state);
+    const titledSource = ensureBookTitle(editableSource, state.agentName);
+    const knowledgeCommitments = state.knowledge
+        .map(getKnowledgeSource)
+        .map((source) => source.trim())
+        .filter((source) => source !== '')
+        .filter((source) => !titledSource.includes(`KNOWLEDGE ${source}`))
+        .map((source) => `KNOWLEDGE ${source}`);
+    return validateBook(insertCommitmentsBeforeLearningMarker(titledSource, knowledgeCommitments));
+}

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

@@ -0,0 +1,45 @@
+import { spaceTrim } from 'spacetrim';
+/**
+ * Normalizes one user-entered single-line wizard value.
+ *
+ * @param value - Raw user-entered value.
+ * @returns Trimmed single-line text.
+ *
+ * @private internal helper of the manGo wizard draft service.
+ */
+function normalizeSingleLineInput(value: string): string {
+    return value.replace(/\s+/g, ' ').trim();
+}
+/**
+ * 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 agentName = normalizeSingleLineInput(input.agentName) || 'Nový agent';
+    const agentBrief = normalizeSingleLineInput(input.agentBrief);
+    return spaceTrim(`
+        ${agentName}
+        NOTE This agent was created via the NEW_AGENT_WIZARD manGo wizard flow
+        GOAL ${agentBrief || 'Help users with the assigned business workflow.'}
+        RULE Answer clearly and practically.
+        RULE Ask a clarifying question when the request is ambiguous.
+        RULE Escalate risky, unclear, or out-of-scope requests to a human.
+        CLOSED
+    `);
+}

package/apps/agents-server/src/components/NewAgentDialog/ManGoNewAgentWizard/services/uploadService.ts ADDED Viewed

@@ -0,0 +1,27 @@
+import { bookEditorUploadHandler } from '../../../../utils/upload/createBookEditorUploadHandler';
+/**
+ * Uploaded knowledge file returned to the imported manGo wizard.
+ */
+export type UploadedFile = {
+    /**
+     * Public URL inserted into the generated `KNOWLEDGE` commitment.
+     */
+    readonly publicUrl: string;
+    /**
+     * Original experiment field retained for the imported UI state shape.
+     */
+    readonly objectKey: string;
+};
+/**
+ * Uploads one knowledge file through the Agents Server upload endpoint.
+ *
+ * @param file - Browser file selected in the knowledge step.
+ * @returns Public URL consumed by `KNOWLEDGE` commitments.
+ */
+export async function uploadKnowledgeFile(file: File): Promise<UploadedFile> {
+    const publicUrl = await bookEditorUploadHandler(file);
+    return { publicUrl, objectKey: '' };
+}