@aragon-agent/cli 0.6.46 → 0.6.48

package/dist/ui/overlays/model-profile-state.js

@@ -1,301 +0,0 @@
-import { randomUUID } from 'node:crypto';
-import { emptyModelProfiles, duplicateModelProfile, normalizeModelProfiles, validateModelProfiles } from '../../config/model-profiles.js';
-import { parseContextWindowInput } from '../../config/schema.js';
-import { stepFanoutValue, teamFanoutValues } from './team-fanout-state.js';
-import { draftGovernance, stepGovernanceSetting } from './governance-settings.js';
-/** The picker's built-in `Fast tier model` row; never a profile id on disk. */
-export const SUBAGENT_FAST_ROW_ID = '__fast__';
-/** Keep the original secret separate from the empty replacement field. */
-export function createProfileEditor(profile) {
-    return { original: { ...profile }, name: profile.name, provider: profile.provider,
-        model: profile.model, baseUrl: profile.baseUrl ?? '', apiKey: '',
-        contextWindow: profile.contextWindow === null ? '' : String(profile.contextWindow),
-        credentialMode: profile.apiKey ? 'keep' : 'shared', endpointChanged: false };
-}
-/** Validate locally before merging the child form into the root transaction. */
-export function finishProfileEditor(editor) {
-    // STRICT IN THE UI, TOLERANT ON DISK (§6.5 / invariant 4): a typo is refused
-    // here with an inline error and the focus jump its `field` enables; it never
-    // reaches the draft. The message prefix matches the editor's LABELS row.
-    const window = parseContextWindowInput(editor.contextWindow);
-    if (window.kind === 'invalid') {
-        return { error: 'Context window: use a number or auto.', field: 'contextWindow' };
-    }
-    const profile = { id: editor.original.id, name: editor.name.trim(),
-        provider: editor.provider, model: editor.model.trim(), baseUrl: editor.baseUrl.trim() || null,
-        apiKey: editor.credentialMode === 'keep' ? editor.original.apiKey
-            : editor.credentialMode === 'replace' ? editor.apiKey.trim() : null,
-        contextWindow: window.kind === 'auto' ? null : window.value };
-    const library = { ...emptyModelProfiles(), entries: [profile] };
-    const issue = validateModelProfiles(library)[0];
-    if (issue)
-        return { error: issue.message, field: issue.path.split('.').at(-1) };
-    return { profile: normalizeModelProfiles(library).entries[0] };
-}
-/** Make an isolated root draft; opening the screen never mutates live config. */
-export function createModelProfileState(draft) {
-    const copy = structuredClone(draft);
-    if (validateModelProfiles(copy.profiles).length
-        || validateModelProfiles(copy.baseline.modelProfiles).length) {
-        copy.profiles = undefined;
-        copy.readError = 'invalid_profiles';
-    }
-    return { draft: copy, page: 'root', role: 'main', returnPage: 'manager',
-        bindNew: false, dirty: false };
-}
-/** The kits whose three slots name `id`, for the delete confirmation (D-9). */
-export function kitsUsingProfile(profiles, id) {
-    return (profiles?.kits ?? []).filter((kit) => kit.mainProfileId === id
-        || kit.fastProfileId === id
-        || (kit.subagent.model === 'profile' && kit.subagent.modelProfileId === id));
-}
-/**
- * Drop `slot` from the session kit (§4.3 row 2 / AC-38).
- *
- * THE DRAFT IS NARROWED HERE, NOT ONLY AT SAVE TIME. `releasedSlots` already
- * strips the same slot from the transaction before it commits, but the ROOT PAGE
- * paints the kit's effective value for every HELD slot - so without this line a
- * user picks a profile and the row keeps showing the one they just replaced,
- * which is the most confusing thing a settings screen can do. Releasing the last
- * slot ends the kit: `held: []` is not a state any surface can render.
- */
-function releaseHeldSlot(draft, slot) {
-    const current = draft.sessionKit;
-    if (!current || !current.held.includes(slot))
-        return draft;
-    const held = current.held.filter((item) => item !== slot);
-    return { ...draft, sessionKit: held.length ? { id: current.id, held } : null };
-}
-/** Describe references using text so ASCII and no-color modes remain usable. */
-export function profileUsers(profiles, id, subagentProfileId) {
-    // THE KITS ARE REFERENCES TOO (D-9 / RV-P2-6): "Main + kit "Deep work"" is what
-    // makes the confirmation honest, because deleting this entry also deletes that
-    // kit. The empty case must stay empty - a leading ` + ` is what a naive
-    // `join` after an unconditional push produces.
-    return [profiles?.mainId === id ? 'Main' : '', profiles?.fastId === id ? 'Fast' : '',
-        subagentProfileId === id ? 'Subagent' : '',
-        ...kitsUsingProfile(profiles, id).map((kit) => `kit "${kit.name}"`)]
-        .filter(Boolean).join(' + ');
-}
-/**
- * The team section a draft would save: the patch first, then the disk baseline
- * (subagent-model §3.6). The explicit-`undefined` test is what makes an
- * explicit `null` in the patch win over the baseline - `??` would fold it away.
- */
-export function draftTeam(draft) {
-    const patch = draft.patch.team;
-    const baseline = draft.baseline.team;
-    return {
-        model: patch?.model !== undefined ? patch.model : baseline?.model ?? 'main',
-        modelProfileId: patch?.modelProfileId !== undefined ? patch.modelProfileId
-            : baseline?.modelProfileId ?? null,
-    };
-}
-/** The profile id the draft's team section binds, for reference checks (3.7). */
-export function draftSubagentProfileId(draft) {
-    return draftTeam(draft).model === 'profile' ? draftTeam(draft).modelProfileId : null;
-}
-/** The projected picker selection for the subagent role (6.2). */
-export function subagentSelectedId(draft) {
-    const team = draftTeam(draft);
-    if (team.model === 'profile')
-        return team.modelProfileId;
-    return team.model === 'fast' ? SUBAGENT_FAST_ROW_ID : null;
-}
-export function subagentModelSummary(input) {
-    if (input.mode === 'main')
-        return `Same as main (${input.mainConnection})`;
-    if (input.mode === 'fast') {
-        return input.fastConnection
-            ? `Fast tier (${input.fastConnection})`
-            : 'Fast tier (off - falls back to main)';
-    }
-    const entry = input.modelProfileId
-        ? input.profiles?.entries.find((candidate) => candidate.id === input.modelProfileId)
-        : undefined;
-    if (!entry)
-        return 'Profile missing - falls back to main';
-    const missing = !entry.apiKey && !input.hasKey(entry.provider);
-    return `${entry.name}  ${entry.provider}:${entry.model}${missing ? ' [Missing API key]' : ''}`;
-}
-/** Adopt persisted fields only, resolving the old fast inheritance once. */
-export function createCustomProfile(draft, role) {
-    const file = draft.baseline;
-    const provider = (role === 'fast' ? file.fast?.provider : undefined)
-        || file.provider || 'anthropic';
-    const model = role === 'fast' ? file.fast?.model ?? '' : file.model ?? '';
-    const baseUrl = role === 'fast' && !model ? null
-        : (role === 'fast' ? file.fast?.baseUrl
-            || (provider === (file.provider || 'anthropic') ? file.baseUrl : null)
-            : file.baseUrl) || null;
-    return { id: randomUUID(), name: '', provider, model, baseUrl,
-        apiKey: role === 'fast' && !model ? null : file.apiKeys?.[provider] || null,
-        // Carry the user's existing top-level correction into the first profile
-        // (§6.5): binding an AUTO profile would otherwise silently retire it
-        // (tradeoff B's migration risk, mitigated exactly here).
-        contextWindow: file.contextWindow ?? null };
-}
-function editField(state, action) {
-    if (!state.editor)
-        return state;
-    const editor = { ...state.editor, [action.field]: action.value };
-    if (action.field === 'provider' || action.field === 'baseUrl') {
-        editor.apiKey = '';
-        editor.credentialMode = 'shared';
-        editor.endpointChanged = true;
-    }
-    if (action.field === 'credentialMode' && action.value !== 'replace')
-        editor.apiKey = '';
-    return { ...state, editor, error: undefined };
-}
-function mergeEditor(state) {
-    if (!state.editor)
-        return state;
-    const result = finishProfileEditor(state.editor);
-    if (!result.profile)
-        return { ...state, error: result.error };
-    const library = state.draft.profiles ?? emptyModelProfiles();
-    const exists = library.entries.some((entry) => entry.id === result.profile.id);
-    if (!exists && library.entries.length >= 200)
-        return { ...state,
-            error: 'Maximum 200 profiles. Delete an unused profile first.' };
-    const profiles = { ...library, entries: exists
-            ? library.entries.map((entry) => entry.id === result.profile.id ? result.profile : entry)
-            : [...library.entries, result.profile] };
-    const merged = { ...state, draft: { ...state.draft, profiles }, dirty: true,
-        editor: undefined, page: state.returnPage, error: undefined };
-    return state.bindNew ? modelProfileReducer(merged, { type: 'select', role: state.role, id: result.profile.id }) : merged;
-}
-/** All child actions modify only the root draft; persistence belongs to Save. */
-export function modelProfileReducer(state, action) {
-    const library = state.draft.profiles ?? emptyModelProfiles();
-    switch (action.type) {
-        case 'reload': return createModelProfileState(action.draft);
-        case 'page': return { ...state, page: action.page, role: action.role ?? state.role,
-            error: undefined };
-        case 'select': {
-            // THE SUBAGENT BRANCH (D-5): selection writes the DRAFT's team patch -
-            // `profiles` and `activateRoles` are untouched, because 'subagent' is a
-            // picker-only role with no `${role}Id` library key (6.2). Save is the
-            // one place the patch ever reaches disk (I-5).
-            if (action.role === 'subagent') {
-                const team = action.id === null
-                    ? { model: 'main', modelProfileId: null }
-                    : action.id === SUBAGENT_FAST_ROW_ID
-                        ? { model: 'fast', modelProfileId: null }
-                        : { model: 'profile', modelProfileId: action.id };
-                return { ...state, page: 'root', dirty: true, error: undefined,
-                    draft: releaseHeldSlot({ ...state.draft,
-                        patch: { ...state.draft.patch, team } }, 'subagent') };
-            }
-            // `'binding'` NEVER REACHES THIS REDUCER: a kit slot's choice is applied
-            // by `kitReducer` (`kit-main` / `kit-fast`), because the value belongs to
-            // an editor draft rather than to a `${role}Id` library key. Returning the
-            // state unchanged is the honest answer to an impossible action.
-            if (action.role === 'binding')
-                return state;
-            return { ...state, page: 'root', dirty: true, error: undefined,
-                draft: releaseHeldSlot({ ...state.draft,
-                    profiles: { ...library, [`${action.role}Id`]: action.id },
-                    activateRoles: [...new Set([...state.draft.activateRoles, action.role])] }, action.role) };
-        }
-        case 'edit': return { ...state, editor: createProfileEditor(action.profile), page: 'editor',
-            // A PROFILE BORN IN A KIT SLOT RETURNS TO THAT SLOT (§4.5): the picker's
-            // `Create profile` action is the only way to invent one and it is offered on
-            // the kit's slot chooser - landing in the profile MANAGER there would
-            // abandon the half-built kit behind a page the user never asked for.
-            returnPage: state.page === 'picker' || state.page === 'kit-slot'
-                ? state.page : 'manager',
-            bindNew: action.bindNew ?? false, error: undefined };
-        case 'editor-field': return editField(state, action);
-        case 'retain-key': return state.editor?.original.apiKey ? { ...state,
-            editor: { ...state.editor, credentialMode: 'keep', apiKey: '' } } : state;
-        case 'merge-editor': return mergeEditor(state);
-        case 'choose-model': {
-            // Legal ONLY from the list page (§7). `editor-field` would do the same thing,
-            // but routing the list page through the generic field action would also let a
-            // future `editField` side effect (key reset, endpoint flag) fire on a choice
-            // that never touched the endpoint.
-            if (!state.editor || state.page !== 'models')
-                return state;
-            return { ...state, page: 'editor', error: undefined,
-                editor: { ...state.editor, model: action.model } };
-        }
-        case 'cancel-editor': return { ...state, editor: undefined, page: state.returnPage,
-            error: undefined };
-        case 'team-fanout': {
-            // THE FRAGMENT IS THE ONLY THING WRITTEN (D-17 / R-P0-1). `stepFanoutValue`
-            // returns `Partial<TeamFanoutPatch>`, so `model` and `modelProfileId` - the
-            // two keys `releasedSlots` reads as "the user re-decided the subagent slot" -
-            // cannot enter the patch from here. `teamFanoutValues` is the CLAMPED view
-            // (R-P0-2), so a step starts from the number the user is looking at.
-            const step = stepFanoutValue(teamFanoutValues(state.draft), action.field, action.delta);
-            return { ...state, dirty: true, error: undefined,
-                draft: { ...state.draft,
-                    patch: { ...state.draft.patch, team: { ...state.draft.patch.team, ...step } } } };
-        }
-        case 'governance-step': {
-            // THE FRAGMENT IS THE ONLY THING WRITTEN, as for `team-fanout`: `stepGovernanceSetting`
-            // returns exactly one key, clamped, from the value the screen is showing
-            // (`draftGovernance`), so a step can never drag a second key into the patch.
-            const step = stepGovernanceSetting(draftGovernance(state.draft), action.key, action.delta);
-            return { ...state, dirty: true, error: undefined,
-                draft: { ...state.draft, patch: { ...state.draft.patch,
-                        governance: { ...state.draft.patch.governance, ...step } } } };
-        }
-        case 'duplicate': {
-            if (library.entries.length >= 200)
-                return { ...state,
-                    error: 'Maximum 200 profiles. Delete an unused profile first.' };
-            const original = library.entries.find((entry) => entry.id === action.id);
-            return original ? { ...state, dirty: true, draft: { ...state.draft,
-                    profiles: { ...library, entries: [...library.entries, duplicateModelProfile(original)] } } }
-                : state;
-        }
-        case 'delete': {
-            // UNBIND-AND-DELETE (D-6): being referenced no longer refuses the flow.
-            // The references - subagent included - are computed here, shown on the
-            // confirm page, and cleared by `confirm-delete` inside the draft.
-            const users = profileUsers(library, action.id, draftSubagentProfileId(state.draft));
-            return { ...state, page: 'delete-confirm', deleteId: action.id,
-                deleteUsers: users, error: undefined };
-        }
-        case 'confirm-delete': {
-            const id = state.deleteId;
-            if (!id)
-                return state;
-            // THE DRAFT-SIDE UNBIND: Main/Fast bindings pointing at the entry are
-            // nulled here (not refused) and the subagent binding resets to main
-            // when it named THIS entry. `removeModelProfile`'s throw stays as the
-            // bottom-line defense - the UI has already unbound, so it cannot fire
-            // on this path.
-            //
-            // AND THE KITS GO WITH IT (agent-model-kits D-9 / I-8): a kit naming a
-            // deleted profile can neither be applied nor repaired from any screen, so
-            // leaving it behind would be leaving a permanent error. The confirmation
-            // page has already named them, so this is the action the user agreed to.
-            const doomed = kitsUsingProfile(library, id);
-            const defaultKitKept = doomed.some((kit) => kit.id === (library.defaultKitId ?? null))
-                ? null : library.defaultKitId;
-            const sessionReleased = doomed.some((kit) => kit.id === state.draft.sessionKit?.id)
-                ? null : state.draft.sessionKit;
-            const profiles = {
-                ...library,
-                mainId: library.mainId === id ? null : library.mainId,
-                fastId: library.fastId === id ? null : library.fastId,
-                entries: library.entries.filter((entry) => entry.id !== id),
-                kits: (library.kits ?? []).filter((kit) => !doomed.includes(kit)),
-                defaultKitId: defaultKitKept,
-            };
-            const teamReset = draftSubagentProfileId(state.draft) === id
-                ? { team: { model: 'main', modelProfileId: null } }
-                : {};
-            return { ...state, page: 'manager', dirty: true,
-                draft: { ...state.draft, profiles, sessionKit: sessionReleased,
-                    patch: { ...state.draft.patch, ...teamReset } },
-                deleteId: undefined, deleteUsers: undefined,
-                // No orphan editor for a deleted entry (3.7).
-                editor: state.editor?.original.id === id ? undefined : state.editor };
-        }
-    }
-}

package/dist/ui/overlays/prompt-library-state.d.ts

@@ -1,162 +0,0 @@
-/**
- * The prompt manager's state machine and view models (quick-prompt-library §4.4).
- *
- * ASCII ONLY - `src/ui/**` is inside `glyphs.test.ts::inScope`. Every sentence the
- * user reads comes from `prompts/copy.ts`; nothing in this file may hold a literal
- * non-ASCII byte.
- *
- * WHY A PURE REDUCER AND NOT `useState` INSIDE THE COMPONENT: the page stack has two
- * transitions that are easy to get wrong and impossible to see on screen - "the
- * second Esc discards, the first does not" and "the intent is consumed exactly
- * once" - and both are assertions, not screenshots. Everything below can be driven
- * from a test with no Ink mounted.
- */
-import type { PromptDraftInput, PromptDraftVerdict, PromptEditorDraft, PromptLibrary, PromptLibraryEntry, PromptWriteError, QuickPrompt } from '../../prompts/types.js';
-export type PromptLibraryPage = 'list' | 'editor' | 'delete';
-/** The six rows `Tab` cycles on the editor page, in visual order. */
-export declare const PROMPT_EDITOR_FIELDS: readonly ["title", "content", "description", "tags", "save", "cancel"];
-export type PromptEditorField = (typeof PROMPT_EDITOR_FIELDS)[number];
-export interface PromptLibraryState {
-    page: PromptLibraryPage;
-    /** Focus index on the list page (clamped by the view). */
-    index: number;
-    /**
-     * Id the focus should land on when the list is next drawn.
-     *
-     * BY ID, NEVER BY POSITION: a create appends and an edit does not move the entry,
-     * but a delete shifts every row after it, and "focus row 3" would then point at a
-     * different prompt than the one the user was working on.
-     */
-    focusId: string | null;
-    draft: PromptEditorDraft;
-    /** The entry the draft was seeded from, so `dirty` is a comparison, not a guess. */
-    baseline: PromptEditorDraft | null;
-    /** The first Esc on a dirty editor arms the discard; any edit disarms it. */
-    escArmed: boolean;
-    pendingDeleteId: string | null;
-    error: PromptWriteError | null;
-    /** The row that should own focus after a refusal (D-12). */
-    errorField: PromptEditorField | null;
-    /** Highest intent nonce this overlay has acted on (I-8). */
-    consumedIntentNonce: number;
-}
-export type PromptLibraryAction = {
-    type: 'init';
-    entry: PromptLibraryEntry;
-    library: PromptLibrary;
-    nonce: number;
-} | {
-    type: 'list';
-    focusId?: string;
-} | {
-    type: 'focus';
-    index: number;
-} | {
-    type: 'create';
-    seed?: {
-        title?: string;
-        content?: string;
-    };
-} | {
-    type: 'edit';
-    id: string;
-    library: PromptLibrary;
-} | {
-    type: 'delete';
-    id: string;
-} | {
-    type: 'draft';
-    patch: Partial<PromptEditorDraft>;
-} | {
-    type: 'commit';
-    id: string | null;
-} | {
-    type: 'failed';
-    code: PromptWriteError;
-    field?: PromptEditorField;
-} | {
-    type: 'esc';
-} | {
-    type: 'cancelled';
-};
-/** A new, empty draft. `id: null` is what makes `Save` a create rather than an update. */
-export declare const EMPTY_PROMPT_DRAFT: PromptEditorDraft;
-export declare const INITIAL_PROMPT_LIBRARY_STATE: PromptLibraryState;
-/** The editable projection of a stored entry. */
-export declare function draftFromEntry(entry: QuickPrompt): PromptEditorDraft;
-/** A create draft seeded from a command (`/prompts add title :: body`). */
-export declare function seededDraft(seed?: {
-    title?: string;
-    content?: string;
-}): PromptEditorDraft;
-/** Structural equality is enough: every field is a string or a boolean. */
-export declare function draftIsDirty(draft: PromptEditorDraft, baseline: PromptEditorDraft | null): boolean;
-/**
- * Validate a draft and turn it into what the store accepts (D-12).
- *
- * THE VALIDATOR IS `store.ts`'S, not a second copy here: the sentence the editor
- * shows and the rule the write applies have to be the same rule, or a user can be
- * told a title is fine by the form and refused by the store.
- */
-export declare function finishPromptEditor(draft: PromptEditorDraft): PromptDraftVerdict;
-/** Index of the first focusable row, for a refusal that named a field. */
-export declare function fieldIndex(field: PromptEditorField | null): number;
-/**
- * The reducer.
- *
- * `init` is the ONLY action that can jump straight to the editor or the delete page:
- * that is what makes `/prompts edit 2` land where it should (D-21). The intent's
- * nonce is stored as `consumedIntentNonce` by the component before dispatching, so a
- * replayed intent is a no-op at the component, not a second edit here.
- */
-export declare function promptLibraryReducer(state: PromptLibraryState, action: PromptLibraryAction, library: PromptLibrary): PromptLibraryState;
-export interface PromptLibraryRow {
-    id: string;
-    /** One-line render text: the title plus its markers. The caret is the component's. */
-    label: string;
-    markers: {
-        favorite: boolean;
-        hasTags: boolean;
-        uses: number;
-    };
-    /** Body length in code points; the detail block and the delete page share it. */
-    chars: number;
-}
-/** `1.2k` for anything a fixed-width column cannot show in full. */
-export declare function formatCount(count: number): string;
-/** `3d ago` / `2h ago` / `just now`. Deliberately coarse: it is a hint, not a clock. */
-export declare function formatAgo(timestamp: number | undefined, now: number): string;
-/**
- * The list, one row per entry, in the library's own order.
- *
- * DUPLICATE TITLES GET AN ID PREFIX (I-2), exactly as `kit-picker-state.ts` does for
- * duplicate kit names: two rows reading the same words make `Enter` a coin flip.
- */
-export declare function libraryRows(library: PromptLibrary): PromptLibraryRow[];
-/**
- * The detail block under the list: at most `detailMaxLines` rows, fixed shape.
- *
- * FIXED, because `OverlayFrame`'s window is shared with the list (D-16): a body that
- * participated in row height would squeeze six prompts into two visible rows. The
- * full text has exactly one home, and it is the editor.
- */
-export declare function libraryDetail(row: PromptLibraryRow | undefined, library: PromptLibrary, cols: number, now?: number): string[];
-/**
- * The list page's footer.
- *
- * THE LAST CLAUSE IS ALWAYS THE WAY OUT (§9.5): a narrow terminal clips from the
- * left, so the reader always keeps `Esc close`. The reorder keys are named here
- * rather than in the row above it because they are the one affordance a user cannot
- * discover by pressing a key they already know.
- */
-export declare function libraryHint(state: PromptLibraryState, count: number): string;
-/** The delete page's four lines: what it is, how big, and what it costs. */
-export declare function deleteDetail(library: PromptLibrary, id: string | null): string[];
-/**
- * The draft as the store accepts it.
- *
- * THE TAGS FIELD IS PARSED HERE, ONCE, and nowhere else: the editor edits a raw
- * string, the store validates a `string[]`, and a second parser between them is how
- * `a,b` and `a b` come to mean different things depending on which surface saved it.
- */
-export declare function draftToInput(draft: PromptEditorDraft): PromptDraftInput;