@compilr-dev/cli 0.5.17 → 0.6.1

package/dist/handlers/permission-handler.js

@@ -27,10 +27,17 @@ export function createPermissionHandler(deps) {
         if (permissionMode === 'auto-accept') {
             return true;
         }
-        // "Plan" mode: always prompt (no auto-approval based on rules)
+        // "Plan" mode: block write/execute tools, allow read/plan tools
+        if (permissionMode === 'plan') {
+            const { isToolAllowedInPlanMode } = await import('@compilr-dev/sdk');
+            if (!isToolAllowedInPlanMode(request.toolName)) {
+                return false; // Blocked — agent gets denial in tool result
+            }
+            // Read/plan tools pass through without prompting
+            return true;
+        }
         // "Default" mode: use rule-based checking
-        // Check custom permission rules (for non-plan mode)
-        if (permissionMode !== 'plan') {
+        {
             const rule = findMatchingRule(request.toolName);
             if (rule) {
                 if (rule.level === 'always') {

package/dist/index.js

@@ -560,6 +560,19 @@ async function main() {
         // MCP tools injected later via agent.registerTools() when background init completes
         // Episode recorder for work history tracking
         episodeRecorder: defaultEpisodeRecorder,
+        // Plan mode callbacks — wired to ReplV2's handlePlanApproval
+        planModeCallbacks: {
+            onPlanSubmit: async (info) => {
+                // Delegate to ReplV2's existing plan approval flow
+                if (sharedState.onPlanSubmit)
+                    return sharedState.onPlanSubmit(info);
+                return { action: 'reject' }; // Fallback if repl not ready
+            },
+            onPlanModeExit: async (info) => {
+                if (sharedState.onPlanModeExit)
+                    return sharedState.onPlanModeExit(info);
+            },
+        },
     });
     perf('create-agent-done');
     // Mutable ref so grantSession and onDefaultAgentSwapped closures track the current default agent
@@ -731,6 +744,11 @@ async function main() {
         onBackgroundDelegationReady: (runDelegation) => {
             sharedState.runBackgroundDelegation = runDelegation;
         },
+        // Plan mode: wire approval and exit callbacks to ReplV2
+        onPlanModeReady: (callbacks) => {
+            sharedState.onPlanSubmit = callbacks.onPlanSubmit;
+            sharedState.onPlanModeExit = callbacks.onPlanModeExit;
+        },
         // Update sharedState.team when session restore replaces the team object
         // (so delegation handlers see restored agents, not just 'default')
         onTeamReplaced: (newTeam) => {

package/dist/repl-v2.d.ts

@@ -149,6 +149,21 @@ export interface ReplV2Options {
      * Phase 3d-beta: Coordinator Mode
      */
     onBackgroundDelegationReady?: (runDelegation: (agentId: string, message: string) => 'running' | 'queued' | null) => void;
+    /**
+     * Plan mode: wire plan_submit and plan_mode_exit callbacks to the approval overlay.
+     */
+    onPlanModeReady?: (callbacks: {
+        onPlanSubmit: (info: {
+            planId: number;
+            summary?: string;
+        }) => Promise<{
+            action: 'approve-auto' | 'approve' | 'revise' | 'reject';
+            feedback?: string;
+        }>;
+        onPlanModeExit: (info: {
+            reason: string;
+        }) => Promise<void>;
+    }) => void;
     /**
      * Callback invoked when terminal session is registered.
      * Passes the session ID so index.ts can set sessionPrefix for IPC.
@@ -234,6 +249,7 @@ export declare class ReplV2 {
     private readonly onPendingDelegation?;
     private readonly onBackgroundAgentReady?;
     private readonly onBackgroundDelegationReady?;
+    private readonly onPlanModeReady?;
     private readonly onSessionRegistered?;
     private readonly onTeamReplaced?;
     private readonly onProjectStateUpdate?;

package/dist/repl-v2.js

@@ -31,7 +31,7 @@ import { renderMascotWithLogo } from './ui/mascot/renderer.js';
 import { getStartupHighlights } from './changelog/index.js';
 import { registerCommands, executeCommand, allCommands, getAutocompleteCommands, saveCurrentSession, saveCurrentTeam, loadProjectSession, archiveCurrentSession, convertMessagesToItems, } from './commands-v2/index.js';
 import { getCustomCommandRegistry } from './commands/custom-registry.js';
-import { getPlanModePrompt } from './prompts/plan-mode-prompt.js';
+import { getPlanModePrompt } from '@compilr-dev/sdk';
 import { planRepository } from './db/repositories/index.js';
 import { PlanApprovalOverlayV2, } from './ui/overlay/impl/plan-approval-overlay-v2.js';
 import { PermissionOverlayV2, } from './ui/overlay/impl/permission-overlay-v2.js';
@@ -197,6 +197,7 @@ export class ReplV2 {
     onPendingDelegation;
     onBackgroundAgentReady;
     onBackgroundDelegationReady;
+    onPlanModeReady;
     onSessionRegistered;
     onTeamReplaced;
     onProjectStateUpdate;
@@ -245,6 +246,7 @@ export class ReplV2 {
         this.onPendingDelegation = options.onPendingDelegation;
         this.onBackgroundAgentReady = options.onBackgroundAgentReady;
         this.onBackgroundDelegationReady = options.onBackgroundDelegationReady;
+        this.onPlanModeReady = options.onPlanModeReady;
         this.onSessionRegistered = options.onSessionRegistered;
         this.onTeamReplaced = options.onTeamReplaced;
         this.onProjectStateUpdate = options.onProjectStateUpdate;
@@ -987,6 +989,26 @@ export class ReplV2 {
                 return 'running';
             });
         }
+        // Plan mode: wire plan_submit and plan_mode_exit to handlePlanApproval
+        if (this.onPlanModeReady) {
+            this.onPlanModeReady({
+                onPlanSubmit: async (info) => {
+                    await this.handlePlanApproval(info.planId, info.summary ?? 'Plan');
+                    // Map the internal action to PlanSubmitResult
+                    // handlePlanApproval already updates DB and mode — return a simplified result
+                    const mode = this.ui.getMode();
+                    if (mode === 'auto-accept')
+                        return { action: 'approve-auto' };
+                    return { action: 'approve' };
+                },
+                onPlanModeExit: (info) => {
+                    this.ui.setMode('normal');
+                    this.ui.clearActivePlan();
+                    this.ui.print({ type: 'info', message: `Agent exited plan mode: ${info.reason}` });
+                    return Promise.resolve();
+                },
+            });
+        }
         // Event handlers
         this.ui.on('submit', (input) => {
             void this.processInput(input);
@@ -1547,6 +1569,12 @@ export class ReplV2 {
         // Start session heartbeat in background (don't block UI)
         const auth = getAuthManager();
         void auth.startSession();
+        // Warm entitlement cache in background (non-blocking)
+        if (await auth.isAuthenticated()) {
+            import('./entitlements/index.js').then(({ warmEntitlementCache }) => {
+                void warmEntitlementCache(() => auth.getAccessToken());
+            }).catch(() => { });
+        }
         const startupMode = getStartupMode();
         if (startupMode === 'menu') {
             await this.handleCommand('menu', '');
@@ -2209,6 +2237,25 @@ export class ReplV2 {
     async runAgentReal(userMessage) {
         if (!this.agent)
             return;
+        // Entitlement check: daily message limit
+        try {
+            const { dailyMessageCounter, getEntitlementCache } = await import('./entitlements/index.js');
+            const auth = (await import('./auth/index.js')).getAuthManager();
+            if (await auth.isAuthenticated()) {
+                const cache = getEntitlementCache(() => auth.getAccessToken());
+                const msgCount = dailyMessageCounter.increment();
+                const check = cache.checkLimit('maxAgentMessagesPerDay', msgCount);
+                if (!check.allowed) {
+                    const { formatTimeUntilReset } = await import('@compilr-dev/sdk');
+                    this.ui.print({
+                        type: 'warning',
+                        message: `Daily message limit reached (${String(check.current)}/${String(check.limit)}). ${formatTimeUntilReset()}.`,
+                    });
+                    return;
+                }
+            }
+        }
+        catch { /* allow if entitlements unavailable */ }
         const abortController = new AbortController();
         const signal = abortController.signal;
         const setAction = (action) => {
@@ -2252,7 +2299,7 @@ export class ReplV2 {
                     let messageToSend = userMessage;
                     if (this.ui.getMode() === 'plan') {
                         const activePlan = this.ui.getActivePlan();
-                        const planModePrompt = getPlanModePrompt(activePlan.id ?? undefined, activePlan.name ?? undefined);
+                        const planModePrompt = getPlanModePrompt(activePlan.id && activePlan.name ? { id: activePlan.id, name: activePlan.name } : undefined);
                         messageToSend = `${planModePrompt}\n\n---\n\nUser request: ${userMessage}`;
                     }
                     // Inject delegation completion notifications (deferred delivery)
@@ -2687,22 +2734,9 @@ export class ReplV2 {
                             });
                         }
                     }
-                    // Flush remaining text and check for PLAN_READY marker
+                    // Flush remaining text (PLAN_READY marker detection removed — plan_submit tool handles approval)
                     if (this.textAccumulator.trim()) {
-                        const text = this.textAccumulator.trim();
-                        // Check for PLAN_READY marker
-                        const planReadyInfo = this.detectPlanReady(text);
-                        // Print the text (remove the marker from display if present)
-                        const displayText = planReadyInfo
-                            ? text.replace(ReplV2.PLAN_READY_REGEX, '').trim()
-                            : text;
-                        if (displayText) {
-                            this.ui.print({ type: 'agent-text', text: displayText, expression: this.getActiveAgentMascot(), agentId: activeAgentId });
-                        }
-                        // If PLAN_READY marker found, show approval overlay
-                        if (planReadyInfo) {
-                            await this.handlePlanApproval(planReadyInfo.planId, planReadyInfo.planName);
-                        }
+                        this.ui.print({ type: 'agent-text', text: this.textAccumulator.trim(), expression: this.getActiveAgentMascot(), agentId: activeAgentId });
                     }
                     // Print per-turn summary before stopping agent
                     this.printTurnSummary();

package/dist/tools/db-tools.d.ts

@@ -10,7 +10,7 @@ export { getActiveProject, setActiveProject } from './project-db.js';
 /**
  * All database tools combined (32 tools from SDK)
  */
-export declare const allDbTools: import("@compilr-dev/sdk").Tool<never>[];
+export declare const allDbTools: import("@compilr-dev/agents").Tool<never>[];
 /**
  * All factory tools (5 tools from @compilr-dev/factory)
  */

package/dist/tools/platform-adapter.d.ts

@@ -22,4 +22,4 @@ export declare const allPlatformTools: import("@compilr-dev/sdk").Tool<never>[];
  * - 3 model tools (app_model_get, app_model_update, app_model_validate)
  * - 2 factory tools (factory_scaffold, factory_list_toolkits)
  */
-export declare const allFactoryTools: import("@compilr-dev/agents").Tool<never>[];
+export declare const allFactoryTools: import('@compilr-dev/agents').Tool<never>[];

package/dist/tools/platform-adapter.js

@@ -9,6 +9,7 @@ import { createPlatformTools, createSQLiteRepositories, ProjectAnchorStore, } fr
 import { createFactoryTools } from '@compilr-dev/factory';
 import { getDb } from '../db/index.js';
 import { getDataPath, getSessionsPath } from '../settings/paths.js';
+import { getPermissionMode } from '../settings/index.js';
 import { existsSync, rmSync } from 'fs';
 import { join } from 'path';
 import { getCurrentProject, setCurrentProject } from './project-db.js';
@@ -273,7 +274,11 @@ const config = {
  * - 4 artifact tools (artifact_save, artifact_get, artifact_list, artifact_delete)
  * - 1 episode tool (recall_work)
  */
-export const allPlatformTools = createPlatformTools(config);
+export const allPlatformTools = createPlatformTools(config, {
+    planModeCallbacks: {
+        isPlanModeActive: () => getPermissionMode() === 'plan',
+    },
+});
 /**
  * All 5 factory tools from @compilr-dev/factory:
  * - 3 model tools (app_model_get, app_model_update, app_model_validate)

package/dist/tools.js

@@ -125,7 +125,12 @@ import { delegateTool } from './tools/delegate.js';
 import { delegateBackgroundTool } from './tools/delegate-background.js';
 import { delegationStatusTool } from './tools/delegation-status.js';
 import { handoffTool } from './tools/handoff.js';
-import { guideTool } from './tools/guide-tool.js';
+import { createGuideTool } from '@compilr-dev/sdk';
+import { CLI_GUIDE_ENTRIES } from './guide/cli-guide-entries.js';
+const guideTool = createGuideTool({
+    environment: 'cli',
+    additionalEntries: CLI_GUIDE_ENTRIES,
+});
 // DB tools for project, work item, document, plan, backlog, anchor, artifact, and episode management
 import { allDbTools, allFactoryTools } from './tools/db-tools.js';
 // Meta-tools for dynamic tool loading

package/dist/ui/overlay/impl/app-model-overlay-v2.d.ts

@@ -0,0 +1,57 @@
+/**
+ * App Model Overlay V2
+ *
+ * Terminal visualization of the ApplicationModel (from @compilr-dev/factory).
+ * Three tabs: Entities (list with detail), Relationships (map), Summary (stats).
+ *
+ * Not a replacement for the desktop SVG viewer — text-based tables and lists
+ * for CLI users who want to inspect the model structure.
+ */
+import { TabbedListOverlayV2, BaseScreen } from '../../base/index.js';
+interface ModelField {
+    name: string;
+    label: string;
+    type: string;
+    required: boolean;
+    enumValues?: readonly string[];
+    defaultValue?: string | number | boolean;
+}
+interface ModelRelationship {
+    type: 'belongsTo' | 'hasMany';
+    target: string;
+    fieldName?: string;
+}
+interface ModelEntity {
+    name: string;
+    pluralName: string;
+    description?: string;
+    icon: string;
+    fields: readonly ModelField[];
+    views: readonly string[];
+    relationships: readonly ModelRelationship[];
+}
+export interface AppModelOverlayV2Options {
+    /** Raw JSON content from the document store */
+    modelJson: string;
+    /** Project display name */
+    projectName: string;
+}
+export interface AppModelOverlayV2Result {
+    dismissed: boolean;
+}
+interface ModelListItem {
+    id: string;
+    tab: string;
+    label: string;
+    detail: string;
+    entity?: ModelEntity;
+}
+export declare class AppModelOverlayV2 extends TabbedListOverlayV2<ModelListItem, AppModelOverlayV2Result> {
+    readonly type: "inline";
+    readonly id = "app-model-viewer";
+    private readonly model;
+    private readonly parseError;
+    constructor(options: AppModelOverlayV2Options);
+    protected createDetailScreen(item: ModelListItem): BaseScreen | null;
+}
+export {};

package/dist/ui/overlay/impl/app-model-overlay-v2.js

@@ -0,0 +1,232 @@
+/**
+ * App Model Overlay V2
+ *
+ * Terminal visualization of the ApplicationModel (from @compilr-dev/factory).
+ * Three tabs: Entities (list with detail), Relationships (map), Summary (stats).
+ *
+ * Not a replacement for the desktop SVG viewer — text-based tables and lists
+ * for CLI users who want to inspect the model structure.
+ */
+import * as terminal from '../../terminal.js';
+import { TabbedListOverlayV2, BaseScreen, stay, popScreen, isEscape, isCtrlC, isClose, renderBorder, wrapText, truncate, } from '../../base/index.js';
+import { parseKeyEvent } from '../key-utils.js';
+// =============================================================================
+// Tab Definitions
+// =============================================================================
+const MODEL_TABS = [
+    { id: 'entities', label: 'Entities' },
+    { id: 'relationships', label: 'Relationships' },
+    { id: 'summary', label: 'Summary' },
+];
+// =============================================================================
+// Main Overlay
+// =============================================================================
+export class AppModelOverlayV2 extends TabbedListOverlayV2 {
+    type = 'inline';
+    id = 'app-model-viewer';
+    model = null;
+    parseError = null;
+    constructor(options) {
+        // Parse model and build list items
+        let model = null;
+        let parseError = null;
+        let items = [];
+        try {
+            model = JSON.parse(options.modelJson);
+            items = buildListItems(model);
+        }
+        catch (e) {
+            parseError = `Failed to parse model: ${e instanceof Error ? e.message : String(e)}`;
+        }
+        // Compute column widths for aligned rendering
+        const maxEntityName = model
+            ? Math.max(8, ...model.entities.map((e) => e.name.length))
+            : 12;
+        const maxRelLabel = items
+            .filter((i) => i.tab === 'relationships')
+            .reduce((max, i) => Math.max(max, i.label.length), 12);
+        const maxSummaryLabel = items
+            .filter((i) => i.tab === 'summary')
+            .reduce((max, i) => Math.max(max, i.label.length), 12);
+        super({
+            title: `Application Model — ${options.projectName}`,
+            tabs: MODEL_TABS,
+            items,
+            pageSize: 15,
+            filterByTab: (item, tabId) => tabId === 'all' || item.tab === tabId,
+            getSearchText: (item) => `${item.label} ${item.detail}`,
+            renderItem: (item, isSelected, s) => {
+                const prefix = isSelected ? s.primary('›') : ' ';
+                if (item.tab === 'entities') {
+                    const entity = item.entity;
+                    const fields = entity ? String(entity.fields.length).padStart(2) : ' 0';
+                    const rels = entity ? String(entity.relationships.length) : '0';
+                    const name = item.label.padEnd(maxEntityName + 2);
+                    const desc = entity?.description ? s.muted(truncate(entity.description, 30)) : '';
+                    return `${prefix} ${isSelected ? s.primary(name) : name} ${s.secondary(`${fields} fields · ${rels} rels`)}  ${desc}`;
+                }
+                if (item.tab === 'relationships') {
+                    const label = item.label.padEnd(maxRelLabel + 2);
+                    return `${prefix} ${isSelected ? s.primary(label) : label} ${s.secondary(item.detail)}`;
+                }
+                // summary
+                const label = (item.label + ':').padEnd(maxSummaryLabel + 3);
+                return `${prefix} ${s.secondary(label)} ${isSelected ? s.primary(item.detail) : item.detail}`;
+            },
+            footerHints: () => '↑↓ Navigate · Enter Detail · Tab/← → Tabs · / Search · q Close',
+        });
+        this.model = model;
+        this.parseError = parseError;
+    }
+    createDetailScreen(item) {
+        if (item.entity) {
+            return new EntityDetailScreen(item.entity, this.getStyles());
+        }
+        return null;
+    }
+}
+// =============================================================================
+// Entity Detail Screen
+// =============================================================================
+class EntityDetailScreen extends BaseScreen {
+    entity;
+    styles;
+    scrollOffset = 0;
+    constructor(entity, styles) {
+        super();
+        this.entity = entity;
+        this.styles = styles;
+    }
+    render() {
+        const s = this.styles;
+        const cols = terminal.getTerminalWidth();
+        const e = this.entity;
+        const lines = [];
+        // Header
+        lines.push(renderBorder(cols, s));
+        lines.push(`  ${s.primaryBold(e.name)}`);
+        lines.push('');
+        if (e.description) {
+            for (const wrapped of wrapText(e.description, cols - 6)) {
+                lines.push(`    ${s.secondary(wrapped)}`);
+            }
+            lines.push('');
+        }
+        // Info line
+        lines.push(`  ${s.muted('Plural:')} ${e.pluralName}   ${s.muted('Views:')} ${e.views.join(', ')}`);
+        lines.push('');
+        // Fields table
+        lines.push(`  ${s.primaryBold('Fields')} ${s.muted(`(${String(e.fields.length)})`)}`);
+        lines.push(`  ${s.muted('─'.repeat(Math.min(cols - 4, 60)))}`);
+        const nameWidth = Math.max(12, ...e.fields.map((f) => f.name.length)) + 1;
+        for (const field of e.fields) {
+            const name = field.name.padEnd(nameWidth);
+            const type = field.type.padEnd(10);
+            const req = field.required ? s.primary('*') : ' ';
+            const enums = field.enumValues ? s.muted(` [${field.enumValues.join(', ')}]`) : '';
+            const def = field.defaultValue !== undefined ? s.muted(` = ${String(field.defaultValue)}`) : '';
+            lines.push(`  ${req} ${name} ${s.secondary(type)}${enums}${def}`);
+        }
+        // Relationships
+        if (e.relationships.length > 0) {
+            lines.push('');
+            lines.push(`  ${s.primaryBold('Relationships')} ${s.muted(`(${String(e.relationships.length)})`)}`);
+            lines.push(`  ${s.muted('─'.repeat(Math.min(cols - 4, 60)))}`);
+            for (const rel of e.relationships) {
+                const arrow = rel.type === 'hasMany' ? '──▸' : '◂──';
+                const label = rel.type === 'hasMany' ? 'has many' : 'belongs to';
+                const via = rel.fieldName ? s.muted(` via ${rel.fieldName}`) : '';
+                lines.push(`  ${e.name} ${arrow} ${s.primary(rel.target)}  ${s.muted(label)}${via}`);
+            }
+        }
+        lines.push('');
+        lines.push(`  ${s.muted('↑↓ Scroll · Esc Back')}`);
+        lines.push(renderBorder(cols, s));
+        return lines;
+    }
+    handleKey(data) {
+        if (isEscape(data) || isCtrlC(data) || isClose(data)) {
+            return popScreen();
+        }
+        const key = parseKeyEvent(data);
+        if (key.name === 'up' && this.scrollOffset > 0) {
+            this.scrollOffset--;
+            return stay();
+        }
+        if (key.name === 'down') {
+            this.scrollOffset++;
+            return stay();
+        }
+        return stay();
+    }
+    getMinHeight() {
+        return 15;
+    }
+}
+// =============================================================================
+// Build list items from model
+// =============================================================================
+function buildListItems(model) {
+    const items = [];
+    // Entity items
+    for (const entity of model.entities) {
+        items.push({
+            id: `entity-${entity.name}`,
+            tab: 'entities',
+            label: entity.name,
+            detail: `${String(entity.fields.length)} fields, ${String(entity.relationships.length)} relationships`,
+            entity,
+        });
+    }
+    // Relationship items (flattened from all entities)
+    for (const entity of model.entities) {
+        for (const rel of entity.relationships) {
+            const arrow = rel.type === 'hasMany' ? '→' : '←';
+            items.push({
+                id: `rel-${entity.name}-${rel.target}-${rel.type}`,
+                tab: 'relationships',
+                label: `${entity.name} ${arrow} ${rel.target}`,
+                detail: rel.type === 'hasMany' ? `has many ${rel.target}` : `belongs to ${rel.target}`,
+            });
+        }
+    }
+    // Summary items
+    const totalFields = model.entities.reduce((sum, e) => sum + e.fields.length, 0);
+    const totalRels = model.entities.reduce((sum, e) => sum + e.relationships.length, 0);
+    const requiredFields = model.entities.reduce((sum, e) => sum + e.fields.filter((f) => f.required).length, 0);
+    const enumFields = model.entities.reduce((sum, e) => sum + e.fields.filter((f) => f.type === 'enum').length, 0);
+    // Identity
+    items.push({ id: 'sum-name', tab: 'summary', label: 'Application', detail: model.identity.name }, { id: 'sum-desc', tab: 'summary', label: 'Description', detail: truncate(model.identity.description, 60) }, { id: 'sum-version', tab: 'summary', label: 'Version', detail: model.identity.version });
+    // Data model stats
+    items.push({ id: 'sum-sep1', tab: 'summary', label: '── Data Model', detail: '' }, { id: 'sum-entities', tab: 'summary', label: 'Entities', detail: String(model.entities.length) }, { id: 'sum-fields', tab: 'summary', label: 'Total Fields', detail: `${String(totalFields)} (${String(requiredFields)} required, ${String(enumFields)} enums)` }, { id: 'sum-rels', tab: 'summary', label: 'Relationships', detail: String(totalRels) });
+    // Configuration
+    const configItems = [];
+    if (model.layout?.shell) {
+        configItems.push({ id: 'sum-layout', tab: 'summary', label: 'Layout', detail: model.layout.shell });
+    }
+    if (model.techStack?.toolkit) {
+        configItems.push({ id: 'sum-toolkit', tab: 'summary', label: 'Toolkit', detail: model.techStack.toolkit });
+    }
+    if (model.theme?.primaryColor) {
+        configItems.push({ id: 'sum-color', tab: 'summary', label: 'Primary Color', detail: model.theme.primaryColor });
+    }
+    const featureList = [];
+    if (model.features?.dashboard)
+        featureList.push('Dashboard');
+    if (model.features?.auth)
+        featureList.push('Auth');
+    if (model.features?.userProfiles)
+        featureList.push('Profiles');
+    if (model.features?.settings)
+        featureList.push('Settings');
+    if (model.features?.darkMode)
+        featureList.push('Dark Mode');
+    if (featureList.length > 0) {
+        configItems.push({ id: 'sum-features', tab: 'summary', label: 'Features', detail: featureList.join(', ') });
+    }
+    if (configItems.length > 0) {
+        items.push({ id: 'sum-sep2', tab: 'summary', label: '── Configuration', detail: '' });
+        items.push(...configItems);
+    }
+    return items;
+}

package/dist/ui/overlay/impl/custom-agent-form-overlay-v2.d.ts

@@ -20,7 +20,7 @@ interface FormField {
     value: string;
     error?: string;
 }
-type WizardStep = 'basic' | 'tools' | 'skills' | 'tier';
+type WizardStep = 'template-select' | 'basic' | 'tools' | 'skills' | 'tier' | 'prompt';
 interface FormState {
     fields: FormField[];
     activeFieldIndex: number;
@@ -35,20 +35,37 @@ interface FormState {
     skillListIndex: number;
     selectedModelTier: ModelTier;
     tierListIndex: number;
+    systemPromptAddition: string;
+    templateListIndex: number;
+    saveAsTemplate: boolean;
+    templateName: string;
+}
+export interface TemplateOption {
+    id: string;
+    name: string;
+    displayName: string;
+    specialty: string;
+    personality?: string;
+    systemPromptAddition?: string;
 }
 export interface CustomAgentFormOptions {
     /** Existing custom agents (for duplicate check) */
     existingCustomAgents: CustomAgentDefinition[];
     /** Current team agent IDs (for duplicate check) */
     teamAgentIds: string[];
+    /** Available templates to load from */
+    templates?: TemplateOption[];
 }
 export interface CustomAgentFormResult {
     cancelled: boolean;
+    /** Template name to save as (if user requested) */
+    saveAsTemplate?: string;
     agent?: {
         id: string;
         displayName: string;
         specialty: string;
         personality?: string;
+        systemPromptAddition?: string;
         toolConfig: ToolConfig;
         enabledSkills: string[];
         modelTier: ModelTier;
@@ -59,8 +76,11 @@ export declare class CustomAgentFormOverlayV2 extends BaseOverlayV2<FormState, C
     readonly id = "custom-agent-form-overlay-v2";
     private readonly existingCustomAgents;
     private readonly teamAgentIds;
+    private readonly templates;
     constructor(options: CustomAgentFormOptions);
     protected renderContent(context: RenderContext): string[];
+    private renderTemplateSelectStep;
+    private handleTemplateSelectKey;
     private renderBasicStep;
     private renderToolsStep;
     private renderGroupItem;
@@ -72,6 +92,8 @@ export declare class CustomAgentFormOverlayV2 extends BaseOverlayV2<FormState, C
     private handleSkillsStepKey;
     private renderTierStep;
     private handleTierStepKey;
+    private renderPromptStep;
+    private handlePromptStepKey;
     private nextField;
     private prevField;
     private validateBasicInfo;