browser-debugger-cli 0.6.4 → 0.6.5

package/dist/ui/formatters/sessionFormatters.js

@@ -0,0 +1,116 @@
+/**
+ * Session-related formatting helpers for landing page sections.
+ *
+ * Provides well-structured, TSDoc'd helpers for building each section
+ * of the landing page, organized by priority (high-level commands first).
+ */
+import { section } from '../../ui/formatting.js';
+/**
+ * Builds the common tasks section showing task-to-command mappings.
+ *
+ * Provides agents with clear intent-to-command examples.
+ *
+ * @returns Formatted common tasks section
+ */
+export function buildCommonTasksSection() {
+    return section('Common Tasks:', [
+        'Screenshot    bdg dom screenshot output.png',
+        'Fill forms    bdg dom fill "#email" "test@test.com"',
+        'Click button  bdg dom click "button.submit"',
+        'Query DOM     bdg dom query "article h2"',
+        'Get cookies   bdg network getCookies',
+        'Export HAR    bdg network har output.har',
+    ]);
+}
+/**
+ * Builds the domain commands section with expanded command coverage.
+ *
+ * Shows all 12+ high-level commands organized by domain (DOM, Network, Console).
+ * Previously showed only 2 commands, now provides comprehensive coverage.
+ *
+ * @returns Formatted domain commands section
+ */
+export function buildDomainCommandsSection() {
+    return section('Domain Commands:', [
+        'DOM:',
+        '  bdg dom query <selector>          Query elements (returns JSON)',
+        '  bdg dom get <selector|index>      Get element details',
+        '  bdg dom eval <javascript>         Execute JavaScript in page context',
+        '  bdg dom screenshot [path]         Capture full page screenshot',
+        '  bdg dom fill <selector> <value>   Fill form input',
+        '  bdg dom click <selector>          Click element',
+        '  bdg dom a11y [selector]           Accessibility tree',
+        '',
+        'Network:',
+        '  bdg network har [path]            Export HTTP Archive (HAR)',
+        '  bdg network getCookies            List all cookies',
+        '  bdg network headers <id>          HTTP headers for request',
+        '',
+        'Console:',
+        '  bdg console [options]             Query console logs',
+    ]);
+}
+/**
+ * Builds the live monitoring section.
+ *
+ * Shows commands for real-time data inspection during active sessions.
+ *
+ * @returns Formatted live monitoring section
+ */
+export function buildLiveMonitoringSection() {
+    return section('Live Monitoring:', [
+        'bdg peek                  Preview collected data (last 10 items)',
+        'bdg peek --follow         Live updates every second',
+        'bdg tail                  Continuous monitoring (like tail -f)',
+        'bdg details network <id>  Full request/response details',
+        'bdg details console <id>  Full console message details',
+    ]);
+}
+/**
+ * Builds the session management section.
+ *
+ * Shows commands for controlling the daemon and session lifecycle.
+ *
+ * @returns Formatted session management section
+ */
+export function buildSessionManagementSection() {
+    return section('Session Management:', [
+        'bdg status        Check session state',
+        'bdg status --verbose     Include Chrome diagnostics',
+        'bdg stop          End session & save output',
+        'bdg cleanup       Clean stale sessions',
+    ]);
+}
+/**
+ * Builds the CDP access section positioned as advanced fallback.
+ *
+ * Provides raw CDP protocol access for advanced use cases not covered
+ * by high-level commands. Intentionally positioned after domain commands
+ * to guide agents toward wrapper commands first.
+ *
+ * @returns Formatted CDP section
+ */
+export function buildCdpSection() {
+    return section('Advanced: Raw CDP Access (53 domains, 300+ methods):', [
+        'bdg cdp --list                      List all domains',
+        'bdg cdp Network --list              List Network methods (39 methods)',
+        'bdg cdp --search cookie             Search methods by keyword',
+        'bdg cdp Runtime.evaluate --params \'{"expression":"document.title"}\'',
+        '',
+        'Use high-level commands above when possible for better efficiency.',
+    ]);
+}
+/**
+ * Builds the discovery section for AI agents.
+ *
+ * Points agents to machine-readable schemas and documentation resources.
+ *
+ * @returns Formatted discovery section
+ */
+export function buildDiscoverySection() {
+    return section('Discovery (for AI agents):', [
+        'bdg --help --json          Machine-readable schema (commands, options, exit codes)',
+        '.claude/skills/bdg/        Claude skill with 15+ recipes & patterns',
+    ]);
+}
+//# sourceMappingURL=sessionFormatters.js.map

package/dist/ui/formatters/sessionFormatters.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sessionFormatters.js","sourceRoot":"","sources":["../../../src/ui/formatters/sessionFormatters.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAE7C;;;;;;GAMG;AACH,MAAM,UAAU,uBAAuB;IACrC,OAAO,OAAO,CAAC,eAAe,EAAE;QAC9B,6CAA6C;QAC7C,qDAAqD;QACrD,6CAA6C;QAC7C,0CAA0C;QAC1C,sCAAsC;QACtC,0CAA0C;KAC3C,CAAC,CAAC;AACL,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,0BAA0B;IACxC,OAAO,OAAO,CAAC,kBAAkB,EAAE;QACjC,MAAM;QACN,mEAAmE;QACnE,yDAAyD;QACzD,wEAAwE;QACxE,kEAAkE;QAClE,qDAAqD;QACrD,mDAAmD;QACnD,wDAAwD;QACxD,EAAE;QACF,UAAU;QACV,+DAA+D;QAC/D,sDAAsD;QACtD,8DAA8D;QAC9D,EAAE;QACF,UAAU;QACV,wDAAwD;KACzD,CAAC,CAAC;AACL,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,0BAA0B;IACxC,OAAO,OAAO,CAAC,kBAAkB,EAAE;QACjC,kEAAkE;QAClE,qDAAqD;QACrD,gEAAgE;QAChE,yDAAyD;QACzD,wDAAwD;KACzD,CAAC,CAAC;AACL,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,6BAA6B;IAC3C,OAAO,OAAO,CAAC,qBAAqB,EAAE;QACpC,uCAAuC;QACvC,qDAAqD;QACrD,6CAA6C;QAC7C,wCAAwC;KACzC,CAAC,CAAC;AACL,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,eAAe;IAC7B,OAAO,OAAO,CAAC,sDAAsD,EAAE;QACrE,sDAAsD;QACtD,uEAAuE;QACvE,+DAA+D;QAC/D,uEAAuE;QACvE,EAAE;QACF,oEAAoE;KACrE,CAAC,CAAC;AACL,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,qBAAqB;IACnC,OAAO,OAAO,CAAC,4BAA4B,EAAE;QAC3C,oFAAoF;QACpF,qEAAqE;KACtE,CAAC,CAAC;AACL,CAAC"}

package/dist/ui/messages/commands.d.ts

@@ -73,6 +73,15 @@ export declare function sessionStillActiveError(pid: number): string;
 /**
  * Generate help message when no URL is provided to start command.
  *
+ * Displays comprehensive guidance optimized for agent discovery:
+ * - Agent-specific resources (machine-readable schema, CDP discovery)
+ * - Complete task workflow examples
+ * - URL format guidance
+ * - Session management commands
+ *
+ * Organized to prioritize agent needs (discovery first) while maintaining
+ * human readability with clear task-oriented examples.
+ *
  * @returns Multi-line help message with examples
  * */
 export declare function startCommandHelpMessage(): string;

package/dist/ui/messages/commands.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"commands.d.ts","sourceRoot":"","sources":["../../../src/ui/messages/commands.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,GAAG,CAAC,EAAE,MAAM,GAAG,MAAM,CAExD;AAED;;;;;GAKG;AACH,wBAAgB,6BAA6B,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAEnE;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAEtD;AAED;;;;GAIG;AACH,wBAAgB,0BAA0B,IAAI,MAAM,CAEnD;AAED;;;;GAIG;AACH,wBAAgB,2BAA2B,IAAI,MAAM,CAEpD;AAED;;;;GAIG;AACH,wBAAgB,4BAA4B,IAAI,MAAM,CAErD;AAED;;;;GAIG;AACH,wBAAgB,qBAAqB,IAAI,MAAM,CAE9C;AAED;;;;;GAKG;AACH,wBAAgB,wBAAwB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAE5D;AACD;;;;;KAKK;AACL,wBAAgB,0BAA0B,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAM9D;AAED;;;;;GAKG;AACH,wBAAgB,uBAAuB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAE3D;AAED;;;;KAIK;AACL,wBAAgB,uBAAuB,IAAI,MAAM,CAgBhD"}
+{"version":3,"file":"commands.d.ts","sourceRoot":"","sources":["../../../src/ui/messages/commands.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAUH;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,GAAG,CAAC,EAAE,MAAM,GAAG,MAAM,CAExD;AAED;;;;;GAKG;AACH,wBAAgB,6BAA6B,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAEnE;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAEtD;AAED;;;;GAIG;AACH,wBAAgB,0BAA0B,IAAI,MAAM,CAEnD;AAED;;;;GAIG;AACH,wBAAgB,2BAA2B,IAAI,MAAM,CAEpD;AAED;;;;GAIG;AACH,wBAAgB,4BAA4B,IAAI,MAAM,CAErD;AAED;;;;GAIG;AACH,wBAAgB,qBAAqB,IAAI,MAAM,CAE9C;AAED;;;;;GAKG;AACH,wBAAgB,wBAAwB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAE5D;AACD;;;;;KAKK;AACL,wBAAgB,0BAA0B,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAM9D;AAED;;;;;GAKG;AACH,wBAAgB,uBAAuB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAE3D;AAED;;;;;;;;;;;;;KAaK;AACL,wBAAgB,uBAAuB,IAAI,MAAM,CAehD"}

package/dist/ui/messages/commands.js

@@ -4,6 +4,7 @@
  * User-facing messages for command-specific operations like stopping sessions,
  * cleaning up stale files, and validating command arguments.
  */
+import { buildAgentDiscoveryHelp, buildCommonTaskExamples, buildUrlExamples, buildSessionManagementReminder, } from '../../ui/formatters/helpFormatters.js';
 import { joinLines } from '../../ui/formatting.js';
 /**
  * Generate Chrome killed message.
@@ -94,9 +95,18 @@ export function sessionStillActiveError(pid) {
 /**
  * Generate help message when no URL is provided to start command.
  *
+ * Displays comprehensive guidance optimized for agent discovery:
+ * - Agent-specific resources (machine-readable schema, CDP discovery)
+ * - Complete task workflow examples
+ * - URL format guidance
+ * - Session management commands
+ *
+ * Organized to prioritize agent needs (discovery first) while maintaining
+ * human readability with clear task-oriented examples.
+ *
  * @returns Multi-line help message with examples
  * */
 export function startCommandHelpMessage() {
-    return joinLines('', 'Start a new session by providing a URL:', '', '  bdg example.com', '  bdg localhost:3000', '  bdg https://github.com', '', 'Or manage existing session:', '', '  bdg status      Check session state', '  bdg stop        End session', '  bdg --help      Show all commands', '');
+    return joinLines('', buildAgentDiscoveryHelp(), '', buildCommonTaskExamples(), '', buildUrlExamples(), '', buildSessionManagementReminder(), '', 'Not sure which command? Start a session to see all available commands:', '  bdg <url>', '');
 }
 //# sourceMappingURL=commands.js.map

package/dist/ui/messages/commands.js.map

@@ -1 +1 @@
-{"version":3,"file":"commands.js","sourceRoot":"","sources":["../../../src/ui/messages/commands.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAE/C;;;;;GAKG;AACH,MAAM,UAAU,mBAAmB,CAAC,GAAY;IAC9C,OAAO,GAAG,CAAC,CAAC,CAAC,sBAAsB,GAAG,GAAG,CAAC,CAAC,CAAC,eAAe,CAAC;AAC9D,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,6BAA6B,CAAC,KAAa;IACzD,OAAO,cAAc,KAAK,2BAA2B,KAAK,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;AACjF,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,cAAc,CAAC,OAAe;IAC5C,OAAO,YAAY,OAAO,EAAE,CAAC;AAC/B,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,0BAA0B;IACxC,OAAO,0BAA0B,CAAC;AACpC,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,2BAA2B;IACzC,OAAO,6BAA6B,CAAC;AACvC,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,4BAA4B;IAC1C,OAAO,gCAAgC,CAAC;AAC1C,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,qBAAqB;IACnC,OAAO,4DAA4D,CAAC;AACtE,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,wBAAwB,CAAC,GAAW;IAClD,OAAO,4BAA4B,GAAG,eAAe,CAAC;AACxD,CAAC;AACD;;;;;KAKK;AACL,MAAM,UAAU,0BAA0B,CAAC,GAAW;IACpD,OAAO,SAAS,CACd,oBAAoB,GAAG,oBAAoB,EAC3C,2BAA2B,EAC3B,+DAA+D,CAChE,CAAC;AACJ,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,uBAAuB,CAAC,GAAW;IACjD,OAAO,gCAAgC,GAAG,GAAG,CAAC;AAChD,CAAC;AAED;;;;KAIK;AACL,MAAM,UAAU,uBAAuB;IACrC,OAAO,SAAS,CACd,EAAE,EACF,yCAAyC,EACzC,EAAE,EACF,mBAAmB,EACnB,sBAAsB,EACtB,0BAA0B,EAC1B,EAAE,EACF,6BAA6B,EAC7B,EAAE,EACF,uCAAuC,EACvC,+BAA+B,EAC/B,qCAAqC,EACrC,EAAE,CACH,CAAC;AACJ,CAAC"}
+{"version":3,"file":"commands.js","sourceRoot":"","sources":["../../../src/ui/messages/commands.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EACL,uBAAuB,EACvB,uBAAuB,EACvB,gBAAgB,EAChB,8BAA8B,GAC/B,MAAM,mCAAmC,CAAC;AAC3C,OAAO,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAE/C;;;;;GAKG;AACH,MAAM,UAAU,mBAAmB,CAAC,GAAY;IAC9C,OAAO,GAAG,CAAC,CAAC,CAAC,sBAAsB,GAAG,GAAG,CAAC,CAAC,CAAC,eAAe,CAAC;AAC9D,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,6BAA6B,CAAC,KAAa;IACzD,OAAO,cAAc,KAAK,2BAA2B,KAAK,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;AACjF,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,cAAc,CAAC,OAAe;IAC5C,OAAO,YAAY,OAAO,EAAE,CAAC;AAC/B,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,0BAA0B;IACxC,OAAO,0BAA0B,CAAC;AACpC,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,2BAA2B;IACzC,OAAO,6BAA6B,CAAC;AACvC,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,4BAA4B;IAC1C,OAAO,gCAAgC,CAAC;AAC1C,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,qBAAqB;IACnC,OAAO,4DAA4D,CAAC;AACtE,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,wBAAwB,CAAC,GAAW;IAClD,OAAO,4BAA4B,GAAG,eAAe,CAAC;AACxD,CAAC;AACD;;;;;KAKK;AACL,MAAM,UAAU,0BAA0B,CAAC,GAAW;IACpD,OAAO,SAAS,CACd,oBAAoB,GAAG,oBAAoB,EAC3C,2BAA2B,EAC3B,+DAA+D,CAChE,CAAC;AACJ,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,uBAAuB,CAAC,GAAW;IACjD,OAAO,gCAAgC,GAAG,GAAG,CAAC;AAChD,CAAC;AAED;;;;;;;;;;;;;KAaK;AACL,MAAM,UAAU,uBAAuB;IACrC,OAAO,SAAS,CACd,EAAE,EACF,uBAAuB,EAAE,EACzB,EAAE,EACF,uBAAuB,EAAE,EACzB,EAAE,EACF,gBAAgB,EAAE,EAClB,EAAE,EACF,8BAA8B,EAAE,EAChC,EAAE,EACF,wEAAwE,EACxE,aAAa,EACb,EAAE,CACH,CAAC;AACJ,CAAC"}

package/dist/ui/messages/errors.d.ts

@@ -81,4 +81,57 @@ export declare function unknownError(): string;
  * @returns Formatted error message
  */
 export declare function invalidResponseError(reason: string): string;
+/**
+ * Generate session not active error with state-aware suggestion.
+ *
+ * Provides context-appropriate guidance based on what operation was attempted.
+ *
+ * @param operation - Operation that was attempted (e.g., "peek", "dom query")
+ * @returns Formatted error message with suggestions
+ *
+ * @example
+ * ```typescript
+ * throw new CommandError(
+ *   sessionNotActiveError('peek'),
+ *   {},
+ *   EXIT_CODES.RESOURCE_NOT_FOUND
+ * );
+ * ```
+ */
+export declare function sessionNotActiveError(operation: string): string;
+/**
+ * Generate element not found error with CDP fallback.
+ *
+ * Provides guidance for when high-level DOM commands fail to find elements,
+ * including CDP alternatives for complex queries.
+ *
+ * @param selector - CSS selector that failed
+ * @returns Formatted error message with fallback suggestions
+ *
+ * @example
+ * ```typescript
+ * throw new CommandError(
+ *   elementNotFoundError('#missing-element'),
+ *   { cdpAlternative: 'Use Runtime.evaluate for complex queries' },
+ *   EXIT_CODES.RESOURCE_NOT_FOUND
+ * );
+ * ```
+ */
+export declare function elementNotFoundError(selector: string): string;
+/**
+ * Generate command requires session error.
+ *
+ * Generic error for commands that require an active session but one is not found.
+ * Provides clear guidance on starting a session.
+ *
+ * @param commandName - Name of command that was attempted
+ * @returns Formatted error message
+ *
+ * @example
+ * ```typescript
+ * const error = commandRequiresSessionError('dom query');
+ * console.error(error);
+ * ```
+ */
+export declare function commandRequiresSessionError(commandName: string): string;
 //# sourceMappingURL=errors.d.ts.map

package/dist/ui/messages/errors.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../../src/ui/messages/errors.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH;;;;;;;;;;;;;GAaG;AACH,wBAAgB,0BAA0B,CACxC,GAAG,EAAE,MAAM,EACX,QAAQ,EAAE,MAAM,EAChB,SAAS,CAAC,EAAE,MAAM,GACjB,MAAM,CAcR;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,4CAA4C;IAC5C,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,2EAA2E;IAC3E,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,yDAAyD;IACzD,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,sCAAsC;IACtC,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAgB,qBAAqB,CAAC,OAAO,CAAC,EAAE,kBAAkB,GAAG,MAAM,CAc1E;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,YAAY,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM,CAKtE;AAED;;;;GAIG;AACH,wBAAgB,YAAY,IAAI,MAAM,CAErC;AAED;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAE3D"}
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../../src/ui/messages/errors.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH;;;;;;;;;;;;;GAaG;AACH,wBAAgB,0BAA0B,CACxC,GAAG,EAAE,MAAM,EACX,QAAQ,EAAE,MAAM,EAChB,SAAS,CAAC,EAAE,MAAM,GACjB,MAAM,CAcR;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,4CAA4C;IAC5C,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,2EAA2E;IAC3E,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,yDAAyD;IACzD,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,sCAAsC;IACtC,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAgB,qBAAqB,CAAC,OAAO,CAAC,EAAE,kBAAkB,GAAG,MAAM,CAc1E;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,YAAY,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM,CAKtE;AAED;;;;GAIG;AACH,wBAAgB,YAAY,IAAI,MAAM,CAErC;AAED;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAE3D;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,qBAAqB,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAW/D;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAY7D;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,2BAA2B,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CAUvE"}

package/dist/ui/messages/errors.js

@@ -82,4 +82,63 @@ export function unknownError() {
 export function invalidResponseError(reason) {
     return `[bdg] Invalid response from daemon: ${reason}`;
 }
+/**
+ * Generate session not active error with state-aware suggestion.
+ *
+ * Provides context-appropriate guidance based on what operation was attempted.
+ *
+ * @param operation - Operation that was attempted (e.g., "peek", "dom query")
+ * @returns Formatted error message with suggestions
+ *
+ * @example
+ * ```typescript
+ * throw new CommandError(
+ *   sessionNotActiveError('peek'),
+ *   {},
+ *   EXIT_CODES.RESOURCE_NOT_FOUND
+ * );
+ * ```
+ */
+export function sessionNotActiveError(operation) {
+    return joinLines(`Error: Cannot ${operation} - no active session`, '', 'Start a session first:', '  bdg <url>', '', 'Example:', '  bdg https://example.com', `  bdg ${operation}`);
+}
+/**
+ * Generate element not found error with CDP fallback.
+ *
+ * Provides guidance for when high-level DOM commands fail to find elements,
+ * including CDP alternatives for complex queries.
+ *
+ * @param selector - CSS selector that failed
+ * @returns Formatted error message with fallback suggestions
+ *
+ * @example
+ * ```typescript
+ * throw new CommandError(
+ *   elementNotFoundError('#missing-element'),
+ *   { cdpAlternative: 'Use Runtime.evaluate for complex queries' },
+ *   EXIT_CODES.RESOURCE_NOT_FOUND
+ * );
+ * ```
+ */
+export function elementNotFoundError(selector) {
+    return joinLines(`Error: Element not found: ${selector}`, '', 'Suggestions:', '  - Check the selector syntax', '  - Wait for the element to load (page might still be loading)', '  - Use bdg peek to see if page loaded correctly', '', 'Advanced: Use CDP for complex queries:', `  bdg cdp Runtime.evaluate --params '{"expression":"document.querySelector('${selector}')"}'`);
+}
+/**
+ * Generate command requires session error.
+ *
+ * Generic error for commands that require an active session but one is not found.
+ * Provides clear guidance on starting a session.
+ *
+ * @param commandName - Name of command that was attempted
+ * @returns Formatted error message
+ *
+ * @example
+ * ```typescript
+ * const error = commandRequiresSessionError('dom query');
+ * console.error(error);
+ * ```
+ */
+export function commandRequiresSessionError(commandName) {
+    return joinLines(`Error: '${commandName}' requires an active session`, '', 'Start a session:', '  bdg <url>', '', 'Check session status:', '  bdg status');
+}
 //# sourceMappingURL=errors.js.map

package/dist/ui/messages/errors.js.map

@@ -1 +1 @@
-{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../../src/ui/messages/errors.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,cAAc,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAE/D;;;;;;;;;;;;;GAaG;AACH,MAAM,UAAU,0BAA0B,CACxC,GAAW,EACX,QAAgB,EAChB,SAAkB;IAElB,OAAO,SAAS,CACd,EAAE,EACF,gCAAgC,EAChC,EAAE,EACF,eAAe,GAAG,EAAE,EACpB,SAAS,IAAI,eAAe,SAAS,EAAE,EACvC,eAAe,cAAc,CAAC,QAAQ,CAAC,EAAE,EACzC,EAAE,EACF,cAAc,EACd,gCAAgC,EAChC,2CAA2C,EAC3C,EAAE,CACH,CAAC;AACJ,CAAC;AAgBD;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,MAAM,UAAU,qBAAqB,CAAC,OAA4B;IAChE,OAAO,SAAS,CACd,2BAA2B,EAC3B,OAAO,EAAE,cAAc,IAAI,iCAAiC,EAC5D,OAAO,EAAE,SAAS,IAAI,eAAe,OAAO,CAAC,SAAS,EAAE,EACxD,EAAE,EACF,sBAAsB,EACtB,aAAa,EACb,OAAO,EAAE,aAAa,IAAI,EAAE,EAC5B,OAAO,EAAE,aAAa,IAAI,yBAAyB,EACnD,OAAO,EAAE,aAAa,IAAI,cAAc,EACxC,OAAO,EAAE,YAAY,IAAI,EAAE,EAC3B,OAAO,EAAE,YAAY,IAAI,gDAAgD,CAC1E,CAAC;AACJ,CAAC;AAED;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,YAAY,CAAC,OAAe,EAAE,OAAgB;IAC5D,IAAI,OAAO,EAAE,CAAC;QACZ,OAAO,UAAU,OAAO,KAAK,OAAO,EAAE,CAAC;IACzC,CAAC;IACD,OAAO,UAAU,OAAO,EAAE,CAAC;AAC7B,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,YAAY;IAC1B,OAAO,sBAAsB,CAAC;AAChC,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,oBAAoB,CAAC,MAAc;IACjD,OAAO,uCAAuC,MAAM,EAAE,CAAC;AACzD,CAAC"}
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../../src/ui/messages/errors.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,cAAc,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAE/D;;;;;;;;;;;;;GAaG;AACH,MAAM,UAAU,0BAA0B,CACxC,GAAW,EACX,QAAgB,EAChB,SAAkB;IAElB,OAAO,SAAS,CACd,EAAE,EACF,gCAAgC,EAChC,EAAE,EACF,eAAe,GAAG,EAAE,EACpB,SAAS,IAAI,eAAe,SAAS,EAAE,EACvC,eAAe,cAAc,CAAC,QAAQ,CAAC,EAAE,EACzC,EAAE,EACF,cAAc,EACd,gCAAgC,EAChC,2CAA2C,EAC3C,EAAE,CACH,CAAC;AACJ,CAAC;AAgBD;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,MAAM,UAAU,qBAAqB,CAAC,OAA4B;IAChE,OAAO,SAAS,CACd,2BAA2B,EAC3B,OAAO,EAAE,cAAc,IAAI,iCAAiC,EAC5D,OAAO,EAAE,SAAS,IAAI,eAAe,OAAO,CAAC,SAAS,EAAE,EACxD,EAAE,EACF,sBAAsB,EACtB,aAAa,EACb,OAAO,EAAE,aAAa,IAAI,EAAE,EAC5B,OAAO,EAAE,aAAa,IAAI,yBAAyB,EACnD,OAAO,EAAE,aAAa,IAAI,cAAc,EACxC,OAAO,EAAE,YAAY,IAAI,EAAE,EAC3B,OAAO,EAAE,YAAY,IAAI,gDAAgD,CAC1E,CAAC;AACJ,CAAC;AAED;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,YAAY,CAAC,OAAe,EAAE,OAAgB;IAC5D,IAAI,OAAO,EAAE,CAAC;QACZ,OAAO,UAAU,OAAO,KAAK,OAAO,EAAE,CAAC;IACzC,CAAC;IACD,OAAO,UAAU,OAAO,EAAE,CAAC;AAC7B,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,YAAY;IAC1B,OAAO,sBAAsB,CAAC;AAChC,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,oBAAoB,CAAC,MAAc;IACjD,OAAO,uCAAuC,MAAM,EAAE,CAAC;AACzD,CAAC;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,UAAU,qBAAqB,CAAC,SAAiB;IACrD,OAAO,SAAS,CACd,iBAAiB,SAAS,sBAAsB,EAChD,EAAE,EACF,wBAAwB,EACxB,aAAa,EACb,EAAE,EACF,UAAU,EACV,2BAA2B,EAC3B,SAAS,SAAS,EAAE,CACrB,CAAC;AACJ,CAAC;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,UAAU,oBAAoB,CAAC,QAAgB;IACnD,OAAO,SAAS,CACd,6BAA6B,QAAQ,EAAE,EACvC,EAAE,EACF,cAAc,EACd,+BAA+B,EAC/B,gEAAgE,EAChE,kDAAkD,EAClD,EAAE,EACF,wCAAwC,EACxC,+EAA+E,QAAQ,OAAO,CAC/F,CAAC;AACJ,CAAC;AAED;;;;;;;;;;;;;;GAcG;AACH,MAAM,UAAU,2BAA2B,CAAC,WAAmB;IAC7D,OAAO,SAAS,CACd,WAAW,WAAW,8BAA8B,EACpD,EAAE,EACF,kBAAkB,EAClB,aAAa,EACb,EAAE,EACF,uBAAuB,EACvB,cAAc,CACf,CAAC;AACJ,CAAC"}

package/dist/ui/messages/hints.d.ts

@@ -0,0 +1,33 @@
+/**
+ * Runtime hint message generators.
+ *
+ * Provides formatted hint messages that guide agents toward more
+ * efficient command patterns during active sessions.
+ */
+import type { PatternDefinition } from '../../daemon/patternDefinitions.js';
+/**
+ * Generate runtime pattern hint message.
+ *
+ * Creates a formatted hint suggesting a more efficient command alternative.
+ *
+ * @param pattern - Detected pattern with alternative suggestion
+ * @returns Formatted hint message
+ *
+ * @example
+ * ```typescript
+ * const hint = generatePatternHint(pattern);
+ * console.error(hint);
+ * ```
+ */
+export declare function generatePatternHint(pattern: PatternDefinition): string;
+/**
+ * Generate hint for multiple Runtime.evaluate calls.
+ *
+ * Specialized hint for the common pattern of multiple evaluate calls
+ * that could be consolidated.
+ *
+ * @param count - Number of Runtime.evaluate calls detected
+ * @returns Formatted hint message
+ */
+export declare function generateMultipleEvaluateHint(count: number): string;
+//# sourceMappingURL=hints.d.ts.map

package/dist/ui/messages/hints.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hints.d.ts","sourceRoot":"","sources":["../../../src/ui/messages/hints.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,gCAAgC,CAAC;AAGxE;;;;;;;;;;;;;GAaG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,iBAAiB,GAAG,MAAM,CAMtE;AAED;;;;;;;;GAQG;AACH,wBAAgB,4BAA4B,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAQlE"}

package/dist/ui/messages/hints.js

@@ -0,0 +1,37 @@
+/**
+ * Runtime hint message generators.
+ *
+ * Provides formatted hint messages that guide agents toward more
+ * efficient command patterns during active sessions.
+ */
+import { joinLines } from '../../ui/formatting.js';
+/**
+ * Generate runtime pattern hint message.
+ *
+ * Creates a formatted hint suggesting a more efficient command alternative.
+ *
+ * @param pattern - Detected pattern with alternative suggestion
+ * @returns Formatted hint message
+ *
+ * @example
+ * ```typescript
+ * const hint = generatePatternHint(pattern);
+ * console.error(hint);
+ * ```
+ */
+export function generatePatternHint(pattern) {
+    return joinLines('', `Hint: Consider using '${pattern.alternative}' instead of ${pattern.cdpMethods.join(' or ')}`, '');
+}
+/**
+ * Generate hint for multiple Runtime.evaluate calls.
+ *
+ * Specialized hint for the common pattern of multiple evaluate calls
+ * that could be consolidated.
+ *
+ * @param count - Number of Runtime.evaluate calls detected
+ * @returns Formatted hint message
+ */
+export function generateMultipleEvaluateHint(count) {
+    return joinLines('', `Hint: Detected ${count} Runtime.evaluate calls`, `   Consider using 'bdg dom eval' for JavaScript execution`, `   Or 'bdg dom query' for DOM queries`, '');
+}
+//# sourceMappingURL=hints.js.map

package/dist/ui/messages/hints.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hints.js","sourceRoot":"","sources":["../../../src/ui/messages/hints.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAE/C;;;;;;;;;;;;;GAaG;AACH,MAAM,UAAU,mBAAmB,CAAC,OAA0B;IAC5D,OAAO,SAAS,CACd,EAAE,EACF,yBAAyB,OAAO,CAAC,WAAW,gBAAgB,OAAO,CAAC,UAAU,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,EAC7F,EAAE,CACH,CAAC;AACJ,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,4BAA4B,CAAC,KAAa;IACxD,OAAO,SAAS,CACd,EAAE,EACF,kBAAkB,KAAK,yBAAyB,EAChD,2DAA2D,EAC3D,uCAAuC,EACvC,EAAE,CACH,CAAC;AACJ,CAAC"}

package/dist/ui/messages/session.d.ts

@@ -14,7 +14,17 @@ export interface LandingPageOptions {
 /**
  * Generate the landing page display for session start.
  *
- * Shows a clean, organized overview of available commands grouped by domain.
+ * Shows a clean, organized overview of available commands grouped by priority.
+ * High-level commands are presented first to guide agents toward token-efficient
+ * wrappers before falling back to verbose CDP commands.
+ *
+ * Section order optimized for agent discoverability:
+ * 1. Common tasks with token savings estimates
+ * 2. Comprehensive domain command coverage (12+ commands)
+ * 3. Live monitoring capabilities
+ * 4. Session management
+ * 5. Advanced CDP access (positioned as fallback)
+ * 6. Discovery resources for agents
  *
  * @param options - Landing page options
  * @returns Formatted landing page string

package/dist/ui/messages/session.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"session.d.ts","sourceRoot":"","sources":["../../../src/ui/messages/session.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,iCAAiC;IACjC,GAAG,EAAE,MAAM,CAAC;CACb;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,WAAW,CAAC,OAAO,EAAE,kBAAkB,GAAG,MAAM,CAsC/D;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,CAEzD;AAED;;GAEG;AACH,eAAO,MAAM,aAAa;;;;;CAKhB,CAAC;AAEX;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAEtD"}
+{"version":3,"file":"session.d.ts","sourceRoot":"","sources":["../../../src/ui/messages/session.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAYH;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,iCAAiC;IACjC,GAAG,EAAE,MAAM,CAAC;CACb;AAED;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,wBAAgB,WAAW,CAAC,OAAO,EAAE,kBAAkB,GAAG,MAAM,CAsB/D;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,CAEzD;AAED;;GAEG;AACH,eAAO,MAAM,aAAa;;;;;CAKhB,CAAC;AAEX;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAEtD"}

package/dist/ui/messages/session.js

@@ -4,11 +4,22 @@
  * Centralized location for all session UI text including landing pages,
  * status displays, and session management messages.
  */
-import { section, joinLines } from '../../ui/formatting.js';
+import { buildCommonTasksSection, buildDomainCommandsSection, buildLiveMonitoringSection, buildSessionManagementSection, buildCdpSection, buildDiscoverySection, } from '../../ui/formatters/sessionFormatters.js';
+import { joinLines } from '../../ui/formatting.js';
 /**
  * Generate the landing page display for session start.
  *
- * Shows a clean, organized overview of available commands grouped by domain.
+ * Shows a clean, organized overview of available commands grouped by priority.
+ * High-level commands are presented first to guide agents toward token-efficient
+ * wrappers before falling back to verbose CDP commands.
+ *
+ * Section order optimized for agent discoverability:
+ * 1. Common tasks with token savings estimates
+ * 2. Comprehensive domain command coverage (12+ commands)
+ * 3. Live monitoring capabilities
+ * 4. Session management
+ * 5. Advanced CDP access (positioned as fallback)
+ * 6. Discovery resources for agents
  *
  * @param options - Landing page options
  * @returns Formatted landing page string
@@ -23,25 +34,7 @@ import { section, joinLines } from '../../ui/formatting.js';
  */
 export function landingPage(options) {
     const { url } = options;
-    return joinLines('', '◆ Session Started', '', `Target: ${url}`, '', section('Raw CDP Access (53 domains, 300+ methods):', [
-        'bdg cdp --list             List all domains',
-        'bdg cdp Network --list     List Network methods',
-        'bdg cdp --search cookie    Search methods',
-        'bdg cdp runtime.evaluate --params \'{"expression":"document.title"}\'',
-    ]), '', section('Live Monitoring:', [
-        'bdg peek        Preview collected data (last 10 items)',
-        'bdg tail        Continuous monitoring (live updates)',
-        'bdg details <type> <id>    Full request/console details',
-    ]), '', section('Domain Wrappers:', [
-        'bdg dom query <selector>   Query DOM elements',
-        'bdg dom eval <js>          Execute JavaScript',
-    ]), '', section('Session:', [
-        'bdg status      Check session state',
-        'bdg stop        End session & save output',
-    ]), '', section('Discovery (for AI agents):', [
-        'bdg --help --json          Machine-readable schema (commands, options, exit codes)',
-        '.claude/skills/bdg/        Claude skill with 15+ recipes & patterns',
-    ]), '');
+    return joinLines('', 'Session Started', '', `Target: ${url}`, '', buildCommonTasksSection(), '', buildDomainCommandsSection(), '', buildLiveMonitoringSection(), '', buildSessionManagementSection(), '', buildCdpSection(), '', buildDiscoverySection(), '');
 }
 /**
  * Generate "session stopped" success message.

package/dist/ui/messages/session.js.map

@@ -1 +1 @@
-{"version":3,"file":"session.js","sourceRoot":"","sources":["../../../src/ui/messages/session.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAUxD;;;;;;;;;;;;;;;GAeG;AACH,MAAM,UAAU,WAAW,CAAC,OAA2B;IACrD,MAAM,EAAE,GAAG,EAAE,GAAG,OAAO,CAAC;IAExB,OAAO,SAAS,CACd,EAAE,EACF,mBAAmB,EACnB,EAAE,EACF,WAAW,GAAG,EAAE,EAChB,EAAE,EACF,OAAO,CAAC,4CAA4C,EAAE;QACpD,6CAA6C;QAC7C,iDAAiD;QACjD,2CAA2C;QAC3C,uEAAuE;KACxE,CAAC,EACF,EAAE,EACF,OAAO,CAAC,kBAAkB,EAAE;QAC1B,wDAAwD;QACxD,sDAAsD;QACtD,yDAAyD;KAC1D,CAAC,EACF,EAAE,EACF,OAAO,CAAC,kBAAkB,EAAE;QAC1B,+CAA+C;QAC/C,+CAA+C;KAChD,CAAC,EACF,EAAE,EACF,OAAO,CAAC,UAAU,EAAE;QAClB,qCAAqC;QACrC,2CAA2C;KAC5C,CAAC,EACF,EAAE,EACF,OAAO,CAAC,4BAA4B,EAAE;QACpC,oFAAoF;QACpF,qEAAqE;KACtE,CAAC,EACF,EAAE,CACH,CAAC;AACJ,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,cAAc,CAAC,UAAkB;IAC/C,OAAO,qCAAqC,UAAU,EAAE,CAAC;AAC3D,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,MAAM,aAAa,GAAG;IAC3B,OAAO,EAAE,8BAA8B;IACvC,UAAU,EAAE,yBAAyB;IACrC,MAAM,EAAE,wBAAwB;IAChC,kBAAkB,EAAE,oBAAoB;CAChC,CAAC;AAEX;;;;;GAKG;AACH,MAAM,UAAU,eAAe,CAAC,MAAc;IAC5C,OAAO,wBAAwB,MAAM,EAAE,CAAC;AAC1C,CAAC"}
+{"version":3,"file":"session.js","sourceRoot":"","sources":["../../../src/ui/messages/session.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EACL,uBAAuB,EACvB,0BAA0B,EAC1B,0BAA0B,EAC1B,6BAA6B,EAC7B,eAAe,EACf,qBAAqB,GACtB,MAAM,sCAAsC,CAAC;AAC9C,OAAO,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAU/C;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,MAAM,UAAU,WAAW,CAAC,OAA2B;IACrD,MAAM,EAAE,GAAG,EAAE,GAAG,OAAO,CAAC;IAExB,OAAO,SAAS,CACd,EAAE,EACF,iBAAiB,EACjB,EAAE,EACF,WAAW,GAAG,EAAE,EAChB,EAAE,EACF,uBAAuB,EAAE,EACzB,EAAE,EACF,0BAA0B,EAAE,EAC5B,EAAE,EACF,0BAA0B,EAAE,EAC5B,EAAE,EACF,6BAA6B,EAAE,EAC/B,EAAE,EACF,eAAe,EAAE,EACjB,EAAE,EACF,qBAAqB,EAAE,EACvB,EAAE,CACH,CAAC;AACJ,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,cAAc,CAAC,UAAkB;IAC/C,OAAO,qCAAqC,UAAU,EAAE,CAAC;AAC3D,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,MAAM,aAAa,GAAG;IAC3B,OAAO,EAAE,8BAA8B;IACvC,UAAU,EAAE,yBAAyB;IACrC,MAAM,EAAE,wBAAwB;IAChC,kBAAkB,EAAE,oBAAoB;CAChC,CAAC;AAEX;;;;;GAKG;AACH,MAAM,UAAU,eAAe,CAAC,MAAc;IAC5C,OAAO,wBAAwB,MAAM,EAAE,CAAC;AAC1C,CAAC"}

package/dist/utils/decisionTrees.d.ts

@@ -0,0 +1,54 @@
+/**
+ * Decision tree definitions for intent-based command discovery.
+ *
+ * Provides structured guidance trees that help agents navigate
+ * from high-level intents to specific commands through question-based flow.
+ */
+/**
+ * Decision tree node representing a question and actions.
+ */
+export interface DecisionTreeNode {
+    /** Question to determine next action */
+    question: string;
+    /** Command to execute if answer is yes */
+    yesCommand: string;
+    /** Next action if answer is no (command name or "next" to continue) */
+    noAction: string;
+}
+/**
+ * Complete decision tree for a specific intent domain.
+ */
+export interface DecisionTree {
+    /** High-level intent this tree addresses */
+    intent: string;
+    /** Ordered sequence of decision nodes */
+    steps: DecisionTreeNode[];
+}
+/**
+ * Decision tree registry mapping intent domains to guidance flows.
+ */
+export declare const DECISION_TREES: Record<string, DecisionTree>;
+/**
+ * Get decision tree by domain key.
+ *
+ * @param treeKey - Decision tree identifier
+ * @returns Decision tree if found, undefined otherwise
+ */
+export declare function getDecisionTree(treeKey: string): DecisionTree | undefined;
+/**
+ * Get all decision trees.
+ *
+ * @returns Complete decision tree registry
+ */
+export declare function getAllDecisionTrees(): Record<string, DecisionTree>;
+/**
+ * Search decision trees by intent keyword.
+ *
+ * @param keyword - Search term (case-insensitive)
+ * @returns Matching decision trees with keys
+ */
+export declare function searchDecisionTrees(keyword: string): Array<{
+    key: string;
+    tree: DecisionTree;
+}>;
+//# sourceMappingURL=decisionTrees.d.ts.map

package/dist/utils/decisionTrees.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"decisionTrees.d.ts","sourceRoot":"","sources":["../../src/utils/decisionTrees.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,wCAAwC;IACxC,QAAQ,EAAE,MAAM,CAAC;IACjB,0CAA0C;IAC1C,UAAU,EAAE,MAAM,CAAC;IACnB,uEAAuE;IACvE,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,4CAA4C;IAC5C,MAAM,EAAE,MAAM,CAAC;IACf,yCAAyC;IACzC,KAAK,EAAE,gBAAgB,EAAE,CAAC;CAC3B;AAED;;GAEG;AACH,eAAO,MAAM,cAAc,EAAE,MAAM,CAAC,MAAM,EAAE,YAAY,CAuIvD,CAAC;AAEF;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,YAAY,GAAG,SAAS,CAEzE;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,IAAI,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC,CAElE;AAED;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,MAAM,GAAG,KAAK,CAAC;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,YAAY,CAAA;CAAE,CAAC,CAK/F"}