browser-debugger-cli 0.6.4 → 0.6.5
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.
- package/dist/commands/__tests__/machineReadableHelp.contract.test.d.ts +12 -0
- package/dist/commands/__tests__/machineReadableHelp.contract.test.d.ts.map +1 -0
- package/dist/commands/__tests__/machineReadableHelp.contract.test.js +102 -0
- package/dist/commands/__tests__/machineReadableHelp.contract.test.js.map +1 -0
- package/dist/commands/cdp.js +8 -4
- package/dist/commands/cdp.js.map +1 -1
- package/dist/commands/console.d.ts.map +1 -1
- package/dist/commands/console.js +22 -2
- package/dist/commands/console.js.map +1 -1
- package/dist/commands/dom/a11y.d.ts.map +1 -1
- package/dist/commands/dom/a11y.js +51 -15
- package/dist/commands/dom/a11y.js.map +1 -1
- package/dist/commands/dom/evalHelpers.d.ts +1 -1
- package/dist/commands/dom/evalHelpers.d.ts.map +1 -1
- package/dist/commands/dom/evalHelpers.js +3 -2
- package/dist/commands/dom/evalHelpers.js.map +1 -1
- package/dist/commands/dom/formFillHelpers.d.ts.map +1 -1
- package/dist/commands/dom/formFillHelpers.js +30 -2
- package/dist/commands/dom/formFillHelpers.js.map +1 -1
- package/dist/commands/dom/index.d.ts.map +1 -1
- package/dist/commands/dom/index.js +85 -13
- package/dist/commands/dom/index.js.map +1 -1
- package/dist/commands/dom/reactEventHelpers.d.ts +1 -1
- package/dist/commands/dom/reactEventHelpers.d.ts.map +1 -1
- package/dist/commands/dom/reactEventHelpers.js +3 -3
- package/dist/commands/machineReadableHelp.d.ts +48 -0
- package/dist/commands/machineReadableHelp.d.ts.map +1 -1
- package/dist/commands/machineReadableHelp.js +80 -0
- package/dist/commands/machineReadableHelp.js.map +1 -1
- package/dist/commands/network.d.ts.map +1 -1
- package/dist/commands/network.js +28 -2
- package/dist/commands/network.js.map +1 -1
- package/dist/commands/peek.js +2 -2
- package/dist/commands/peek.js.map +1 -1
- package/dist/commands/shared/CommandRunner.d.ts +2 -0
- package/dist/commands/shared/CommandRunner.d.ts.map +1 -1
- package/dist/commands/shared/CommandRunner.js +3 -0
- package/dist/commands/shared/CommandRunner.js.map +1 -1
- package/dist/commands/shared/validation.d.ts +2 -0
- package/dist/commands/shared/validation.d.ts.map +1 -1
- package/dist/commands/shared/validation.js +5 -2
- package/dist/commands/shared/validation.js.map +1 -1
- package/dist/commands/stop.d.ts.map +1 -1
- package/dist/commands/stop.js +2 -1
- package/dist/commands/stop.js.map +1 -1
- package/dist/commands/tail.d.ts.map +1 -1
- package/dist/commands/tail.js +6 -0
- package/dist/commands/tail.js.map +1 -1
- package/dist/connection/cdp.js +9 -9
- package/dist/constants.d.ts.map +1 -1
- package/dist/constants.js +3 -1
- package/dist/constants.js.map +1 -1
- package/dist/daemon/patternDefinitions.d.ts +47 -0
- package/dist/daemon/patternDefinitions.d.ts.map +1 -0
- package/dist/daemon/patternDefinitions.js +71 -0
- package/dist/daemon/patternDefinitions.js.map +1 -0
- package/dist/daemon/patternDetector.d.ts +60 -0
- package/dist/daemon/patternDetector.d.ts.map +1 -0
- package/dist/daemon/patternDetector.js +74 -0
- package/dist/daemon/patternDetector.js.map +1 -0
- package/dist/daemon/worker/__tests__/PatternDetector.unit.test.d.ts +11 -0
- package/dist/daemon/worker/__tests__/PatternDetector.unit.test.d.ts.map +1 -0
- package/dist/daemon/worker/__tests__/PatternDetector.unit.test.js +136 -0
- package/dist/daemon/worker/__tests__/PatternDetector.unit.test.js.map +1 -0
- package/dist/daemon/worker/commandRegistry.d.ts.map +1 -1
- package/dist/daemon/worker/commandRegistry.js +13 -2
- package/dist/daemon/worker/commandRegistry.js.map +1 -1
- package/dist/ipc/protocol/commands.d.ts +2 -0
- package/dist/ipc/protocol/commands.d.ts.map +1 -1
- package/dist/ipc/protocol/commands.js.map +1 -1
- package/dist/session/cleanup.d.ts.map +1 -1
- package/dist/session/cleanup.js +2 -0
- package/dist/session/cleanup.js.map +1 -1
- package/dist/session/queryCache.d.ts +35 -0
- package/dist/session/queryCache.d.ts.map +1 -0
- package/dist/session/queryCache.js +83 -0
- package/dist/session/queryCache.js.map +1 -0
- package/dist/telemetry/a11y.d.ts +8 -5
- package/dist/telemetry/a11y.d.ts.map +1 -1
- package/dist/telemetry/a11y.js +34 -19
- package/dist/telemetry/a11y.js.map +1 -1
- package/dist/ui/errors/CommandError.d.ts +5 -1
- package/dist/ui/errors/CommandError.d.ts.map +1 -1
- package/dist/ui/errors/CommandError.js.map +1 -1
- package/dist/ui/formatters/__tests__/preview.unit.test.d.ts +13 -0
- package/dist/ui/formatters/__tests__/preview.unit.test.d.ts.map +1 -0
- package/dist/ui/formatters/__tests__/preview.unit.test.js +180 -0
- package/dist/ui/formatters/__tests__/preview.unit.test.js.map +1 -0
- package/dist/ui/formatters/dom.d.ts.map +1 -1
- package/dist/ui/formatters/dom.js +5 -2
- package/dist/ui/formatters/dom.js.map +1 -1
- package/dist/ui/formatters/helpFormatters.d.ts +41 -0
- package/dist/ui/formatters/helpFormatters.d.ts.map +1 -0
- package/dist/ui/formatters/helpFormatters.js +80 -0
- package/dist/ui/formatters/helpFormatters.js.map +1 -0
- package/dist/ui/formatters/preview.d.ts.map +1 -1
- package/dist/ui/formatters/preview.js +67 -19
- package/dist/ui/formatters/preview.js.map +1 -1
- package/dist/ui/formatters/sessionFormatters.d.ts +58 -0
- package/dist/ui/formatters/sessionFormatters.d.ts.map +1 -0
- package/dist/ui/formatters/sessionFormatters.js +116 -0
- package/dist/ui/formatters/sessionFormatters.js.map +1 -0
- package/dist/ui/messages/commands.d.ts +9 -0
- package/dist/ui/messages/commands.d.ts.map +1 -1
- package/dist/ui/messages/commands.js +11 -1
- package/dist/ui/messages/commands.js.map +1 -1
- package/dist/ui/messages/errors.d.ts +53 -0
- package/dist/ui/messages/errors.d.ts.map +1 -1
- package/dist/ui/messages/errors.js +59 -0
- package/dist/ui/messages/errors.js.map +1 -1
- package/dist/ui/messages/hints.d.ts +33 -0
- package/dist/ui/messages/hints.d.ts.map +1 -0
- package/dist/ui/messages/hints.js +37 -0
- package/dist/ui/messages/hints.js.map +1 -0
- package/dist/ui/messages/session.d.ts +11 -1
- package/dist/ui/messages/session.d.ts.map +1 -1
- package/dist/ui/messages/session.js +14 -21
- package/dist/ui/messages/session.js.map +1 -1
- package/dist/utils/decisionTrees.d.ts +54 -0
- package/dist/utils/decisionTrees.d.ts.map +1 -0
- package/dist/utils/decisionTrees.js +171 -0
- package/dist/utils/decisionTrees.js.map +1 -0
- package/dist/utils/taskMappings.d.ts +47 -0
- package/dist/utils/taskMappings.d.ts.map +1 -0
- package/dist/utils/taskMappings.js +118 -0
- package/dist/utils/taskMappings.js.map +1 -0
- package/package.json +3 -3
|
@@ -0,0 +1,171 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Decision tree definitions for intent-based command discovery.
|
|
3
|
+
*
|
|
4
|
+
* Provides structured guidance trees that help agents navigate
|
|
5
|
+
* from high-level intents to specific commands through question-based flow.
|
|
6
|
+
*/
|
|
7
|
+
/**
|
|
8
|
+
* Decision tree registry mapping intent domains to guidance flows.
|
|
9
|
+
*/
|
|
10
|
+
export const DECISION_TREES = {
|
|
11
|
+
dom_interaction: {
|
|
12
|
+
intent: 'Interact with page elements and DOM',
|
|
13
|
+
steps: [
|
|
14
|
+
{
|
|
15
|
+
question: 'Need to capture a screenshot?',
|
|
16
|
+
yesCommand: 'dom screenshot',
|
|
17
|
+
noAction: 'next',
|
|
18
|
+
},
|
|
19
|
+
{
|
|
20
|
+
question: 'Need to query/find elements?',
|
|
21
|
+
yesCommand: 'dom query',
|
|
22
|
+
noAction: 'next',
|
|
23
|
+
},
|
|
24
|
+
{
|
|
25
|
+
question: 'Need to get detailed element information?',
|
|
26
|
+
yesCommand: 'dom get',
|
|
27
|
+
noAction: 'next',
|
|
28
|
+
},
|
|
29
|
+
{
|
|
30
|
+
question: 'Need to fill form input?',
|
|
31
|
+
yesCommand: 'dom fill',
|
|
32
|
+
noAction: 'next',
|
|
33
|
+
},
|
|
34
|
+
{
|
|
35
|
+
question: 'Need to click an element?',
|
|
36
|
+
yesCommand: 'dom click',
|
|
37
|
+
noAction: 'next',
|
|
38
|
+
},
|
|
39
|
+
{
|
|
40
|
+
question: 'Need to execute custom JavaScript?',
|
|
41
|
+
yesCommand: 'dom eval',
|
|
42
|
+
noAction: 'next',
|
|
43
|
+
},
|
|
44
|
+
{
|
|
45
|
+
question: 'Need accessibility tree?',
|
|
46
|
+
yesCommand: 'dom a11y',
|
|
47
|
+
noAction: 'cdp',
|
|
48
|
+
},
|
|
49
|
+
],
|
|
50
|
+
},
|
|
51
|
+
network_inspection: {
|
|
52
|
+
intent: 'Inspect network traffic and requests',
|
|
53
|
+
steps: [
|
|
54
|
+
{
|
|
55
|
+
question: 'Need to export all traffic as HAR file?',
|
|
56
|
+
yesCommand: 'network har',
|
|
57
|
+
noAction: 'next',
|
|
58
|
+
},
|
|
59
|
+
{
|
|
60
|
+
question: 'Need to get cookies?',
|
|
61
|
+
yesCommand: 'network getCookies',
|
|
62
|
+
noAction: 'next',
|
|
63
|
+
},
|
|
64
|
+
{
|
|
65
|
+
question: 'Need HTTP headers for specific request?',
|
|
66
|
+
yesCommand: 'network headers',
|
|
67
|
+
noAction: 'next',
|
|
68
|
+
},
|
|
69
|
+
{
|
|
70
|
+
question: 'Need full request/response details?',
|
|
71
|
+
yesCommand: 'details network',
|
|
72
|
+
noAction: 'cdp',
|
|
73
|
+
},
|
|
74
|
+
],
|
|
75
|
+
},
|
|
76
|
+
console_inspection: {
|
|
77
|
+
intent: 'Inspect console logs and messages',
|
|
78
|
+
steps: [
|
|
79
|
+
{
|
|
80
|
+
question: 'Need to query/filter console logs?',
|
|
81
|
+
yesCommand: 'console query',
|
|
82
|
+
noAction: 'next',
|
|
83
|
+
},
|
|
84
|
+
{
|
|
85
|
+
question: 'Need full console message details?',
|
|
86
|
+
yesCommand: 'details console',
|
|
87
|
+
noAction: 'cdp',
|
|
88
|
+
},
|
|
89
|
+
],
|
|
90
|
+
},
|
|
91
|
+
data_monitoring: {
|
|
92
|
+
intent: 'Monitor and preview collected data',
|
|
93
|
+
steps: [
|
|
94
|
+
{
|
|
95
|
+
question: 'Need real-time live updates?',
|
|
96
|
+
yesCommand: 'peek --follow',
|
|
97
|
+
noAction: 'next',
|
|
98
|
+
},
|
|
99
|
+
{
|
|
100
|
+
question: 'Need continuous monitoring (like tail -f)?',
|
|
101
|
+
yesCommand: 'tail',
|
|
102
|
+
noAction: 'next',
|
|
103
|
+
},
|
|
104
|
+
{
|
|
105
|
+
question: 'Need quick preview of recent data?',
|
|
106
|
+
yesCommand: 'peek',
|
|
107
|
+
noAction: 'next',
|
|
108
|
+
},
|
|
109
|
+
{
|
|
110
|
+
question: 'Need detailed item inspection?',
|
|
111
|
+
yesCommand: 'details',
|
|
112
|
+
noAction: 'status',
|
|
113
|
+
},
|
|
114
|
+
],
|
|
115
|
+
},
|
|
116
|
+
session_management: {
|
|
117
|
+
intent: 'Manage browser session lifecycle',
|
|
118
|
+
steps: [
|
|
119
|
+
{
|
|
120
|
+
question: 'Starting a new session?',
|
|
121
|
+
yesCommand: 'bdg <url>',
|
|
122
|
+
noAction: 'next',
|
|
123
|
+
},
|
|
124
|
+
{
|
|
125
|
+
question: 'Need to check session status?',
|
|
126
|
+
yesCommand: 'status',
|
|
127
|
+
noAction: 'next',
|
|
128
|
+
},
|
|
129
|
+
{
|
|
130
|
+
question: 'Ready to end session and save output?',
|
|
131
|
+
yesCommand: 'stop',
|
|
132
|
+
noAction: 'next',
|
|
133
|
+
},
|
|
134
|
+
{
|
|
135
|
+
question: 'Need to clean up stale sessions?',
|
|
136
|
+
yesCommand: 'cleanup',
|
|
137
|
+
noAction: 'help',
|
|
138
|
+
},
|
|
139
|
+
],
|
|
140
|
+
},
|
|
141
|
+
};
|
|
142
|
+
/**
|
|
143
|
+
* Get decision tree by domain key.
|
|
144
|
+
*
|
|
145
|
+
* @param treeKey - Decision tree identifier
|
|
146
|
+
* @returns Decision tree if found, undefined otherwise
|
|
147
|
+
*/
|
|
148
|
+
export function getDecisionTree(treeKey) {
|
|
149
|
+
return DECISION_TREES[treeKey];
|
|
150
|
+
}
|
|
151
|
+
/**
|
|
152
|
+
* Get all decision trees.
|
|
153
|
+
*
|
|
154
|
+
* @returns Complete decision tree registry
|
|
155
|
+
*/
|
|
156
|
+
export function getAllDecisionTrees() {
|
|
157
|
+
return DECISION_TREES;
|
|
158
|
+
}
|
|
159
|
+
/**
|
|
160
|
+
* Search decision trees by intent keyword.
|
|
161
|
+
*
|
|
162
|
+
* @param keyword - Search term (case-insensitive)
|
|
163
|
+
* @returns Matching decision trees with keys
|
|
164
|
+
*/
|
|
165
|
+
export function searchDecisionTrees(keyword) {
|
|
166
|
+
const lowerKeyword = keyword.toLowerCase();
|
|
167
|
+
return Object.entries(DECISION_TREES)
|
|
168
|
+
.filter(([, tree]) => tree.intent.toLowerCase().includes(lowerKeyword))
|
|
169
|
+
.map(([key, tree]) => ({ key, tree }));
|
|
170
|
+
}
|
|
171
|
+
//# sourceMappingURL=decisionTrees.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"decisionTrees.js","sourceRoot":"","sources":["../../src/utils/decisionTrees.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,47 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Task-to-command mapping definitions for agent discovery.
|
|
3
|
+
*
|
|
4
|
+
* Provides intent-based guidance mapping common automation tasks
|
|
5
|
+
* to efficient high-level commands with CDP alternatives.
|
|
6
|
+
*/
|
|
7
|
+
/**
|
|
8
|
+
* Task mapping from intent to command.
|
|
9
|
+
*/
|
|
10
|
+
export interface TaskMapping {
|
|
11
|
+
/** High-level commands that accomplish this task */
|
|
12
|
+
commands: string[];
|
|
13
|
+
/** Human-readable task description */
|
|
14
|
+
description: string;
|
|
15
|
+
/** CDP alternative method(s) */
|
|
16
|
+
cdpAlternative: string;
|
|
17
|
+
}
|
|
18
|
+
/**
|
|
19
|
+
* Complete task mapping registry.
|
|
20
|
+
*
|
|
21
|
+
* Maps common automation intents to optimal command patterns.
|
|
22
|
+
*/
|
|
23
|
+
export declare const TASK_MAPPINGS: Record<string, TaskMapping>;
|
|
24
|
+
/**
|
|
25
|
+
* Get task mapping by key.
|
|
26
|
+
*
|
|
27
|
+
* @param taskKey - Task identifier
|
|
28
|
+
* @returns Task mapping if found, undefined otherwise
|
|
29
|
+
*/
|
|
30
|
+
export declare function getTaskMapping(taskKey: string): TaskMapping | undefined;
|
|
31
|
+
/**
|
|
32
|
+
* Get all task mappings.
|
|
33
|
+
*
|
|
34
|
+
* @returns Complete task mapping registry
|
|
35
|
+
*/
|
|
36
|
+
export declare function getAllTaskMappings(): Record<string, TaskMapping>;
|
|
37
|
+
/**
|
|
38
|
+
* Search task mappings by description keyword.
|
|
39
|
+
*
|
|
40
|
+
* @param keyword - Search term (case-insensitive)
|
|
41
|
+
* @returns Matching task mappings with keys
|
|
42
|
+
*/
|
|
43
|
+
export declare function searchTaskMappings(keyword: string): Array<{
|
|
44
|
+
key: string;
|
|
45
|
+
mapping: TaskMapping;
|
|
46
|
+
}>;
|
|
47
|
+
//# sourceMappingURL=taskMappings.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"taskMappings.d.ts","sourceRoot":"","sources":["../../src/utils/taskMappings.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,oDAAoD;IACpD,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,sCAAsC;IACtC,WAAW,EAAE,MAAM,CAAC;IACpB,gCAAgC;IAChC,cAAc,EAAE,MAAM,CAAC;CACxB;AAED;;;;GAIG;AACH,eAAO,MAAM,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE,WAAW,CA0FrD,CAAC;AAEF;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,WAAW,GAAG,SAAS,CAEvE;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,IAAI,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,CAEhE;AAED;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,MAAM,GAAG,KAAK,CAAC;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,WAAW,CAAA;CAAE,CAAC,CAKhG"}
|
|
@@ -0,0 +1,118 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Task-to-command mapping definitions for agent discovery.
|
|
3
|
+
*
|
|
4
|
+
* Provides intent-based guidance mapping common automation tasks
|
|
5
|
+
* to efficient high-level commands with CDP alternatives.
|
|
6
|
+
*/
|
|
7
|
+
/**
|
|
8
|
+
* Complete task mapping registry.
|
|
9
|
+
*
|
|
10
|
+
* Maps common automation intents to optimal command patterns.
|
|
11
|
+
*/
|
|
12
|
+
export const TASK_MAPPINGS = {
|
|
13
|
+
capture_screenshot: {
|
|
14
|
+
commands: ['dom screenshot'],
|
|
15
|
+
description: 'Capture full page screenshot to file',
|
|
16
|
+
cdpAlternative: 'Page.captureScreenshot',
|
|
17
|
+
},
|
|
18
|
+
query_dom_elements: {
|
|
19
|
+
commands: ['dom query'],
|
|
20
|
+
description: 'Query DOM elements by CSS selector',
|
|
21
|
+
cdpAlternative: 'Runtime.evaluate with querySelector',
|
|
22
|
+
},
|
|
23
|
+
execute_javascript: {
|
|
24
|
+
commands: ['dom eval'],
|
|
25
|
+
description: 'Execute arbitrary JavaScript in page context',
|
|
26
|
+
cdpAlternative: 'Runtime.evaluate',
|
|
27
|
+
},
|
|
28
|
+
fill_form_input: {
|
|
29
|
+
commands: ['dom fill'],
|
|
30
|
+
description: 'Fill form input field by selector',
|
|
31
|
+
cdpAlternative: 'Runtime.evaluate with value assignment',
|
|
32
|
+
},
|
|
33
|
+
click_element: {
|
|
34
|
+
commands: ['dom click'],
|
|
35
|
+
description: 'Click element by selector',
|
|
36
|
+
cdpAlternative: 'Runtime.evaluate with click()',
|
|
37
|
+
},
|
|
38
|
+
get_element_details: {
|
|
39
|
+
commands: ['dom get'],
|
|
40
|
+
description: 'Get detailed element information',
|
|
41
|
+
cdpAlternative: 'Runtime.evaluate with property extraction',
|
|
42
|
+
},
|
|
43
|
+
accessibility_tree: {
|
|
44
|
+
commands: ['dom a11y'],
|
|
45
|
+
description: 'Get accessibility tree for page or element',
|
|
46
|
+
cdpAlternative: 'Accessibility.getFullAXTree',
|
|
47
|
+
},
|
|
48
|
+
export_har: {
|
|
49
|
+
commands: ['network har'],
|
|
50
|
+
description: 'Export network traffic as HAR file',
|
|
51
|
+
cdpAlternative: 'Network domain events collection',
|
|
52
|
+
},
|
|
53
|
+
get_cookies: {
|
|
54
|
+
commands: ['network getCookies'],
|
|
55
|
+
description: 'Get all cookies for current page',
|
|
56
|
+
cdpAlternative: 'Network.getAllCookies',
|
|
57
|
+
},
|
|
58
|
+
get_request_headers: {
|
|
59
|
+
commands: ['network headers'],
|
|
60
|
+
description: 'Get HTTP headers for specific request',
|
|
61
|
+
cdpAlternative: 'Network.getResponseBody + event data',
|
|
62
|
+
},
|
|
63
|
+
query_console_logs: {
|
|
64
|
+
commands: ['console query'],
|
|
65
|
+
description: 'Query and filter console log messages',
|
|
66
|
+
cdpAlternative: 'Runtime.consoleAPICalled events',
|
|
67
|
+
},
|
|
68
|
+
preview_data: {
|
|
69
|
+
commands: ['peek'],
|
|
70
|
+
description: 'Preview collected network and console data',
|
|
71
|
+
cdpAlternative: 'Multiple IPC queries to worker state',
|
|
72
|
+
},
|
|
73
|
+
live_monitoring: {
|
|
74
|
+
commands: ['peek --follow', 'tail'],
|
|
75
|
+
description: 'Monitor data collection in real-time',
|
|
76
|
+
cdpAlternative: 'CDP event subscriptions with custom handler',
|
|
77
|
+
},
|
|
78
|
+
get_full_details: {
|
|
79
|
+
commands: ['details network', 'details console'],
|
|
80
|
+
description: 'Get complete request/response or console message details',
|
|
81
|
+
cdpAlternative: 'Worker state query + response body fetch',
|
|
82
|
+
},
|
|
83
|
+
check_session_status: {
|
|
84
|
+
commands: ['status'],
|
|
85
|
+
description: 'Check current session and daemon status',
|
|
86
|
+
cdpAlternative: 'IPC ping + process checks',
|
|
87
|
+
},
|
|
88
|
+
};
|
|
89
|
+
/**
|
|
90
|
+
* Get task mapping by key.
|
|
91
|
+
*
|
|
92
|
+
* @param taskKey - Task identifier
|
|
93
|
+
* @returns Task mapping if found, undefined otherwise
|
|
94
|
+
*/
|
|
95
|
+
export function getTaskMapping(taskKey) {
|
|
96
|
+
return TASK_MAPPINGS[taskKey];
|
|
97
|
+
}
|
|
98
|
+
/**
|
|
99
|
+
* Get all task mappings.
|
|
100
|
+
*
|
|
101
|
+
* @returns Complete task mapping registry
|
|
102
|
+
*/
|
|
103
|
+
export function getAllTaskMappings() {
|
|
104
|
+
return TASK_MAPPINGS;
|
|
105
|
+
}
|
|
106
|
+
/**
|
|
107
|
+
* Search task mappings by description keyword.
|
|
108
|
+
*
|
|
109
|
+
* @param keyword - Search term (case-insensitive)
|
|
110
|
+
* @returns Matching task mappings with keys
|
|
111
|
+
*/
|
|
112
|
+
export function searchTaskMappings(keyword) {
|
|
113
|
+
const lowerKeyword = keyword.toLowerCase();
|
|
114
|
+
return Object.entries(TASK_MAPPINGS)
|
|
115
|
+
.filter(([, mapping]) => mapping.description.toLowerCase().includes(lowerKeyword))
|
|
116
|
+
.map(([key, mapping]) => ({ key, mapping }));
|
|
117
|
+
}
|
|
118
|
+
//# sourceMappingURL=taskMappings.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"taskMappings.js","sourceRoot":"","sources":["../../src/utils/taskMappings.ts"],"names":[],"mappings":"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"}
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "browser-debugger-cli",
|
|
3
|
-
"version": "0.6.
|
|
3
|
+
"version": "0.6.5",
|
|
4
4
|
"description": "DevTools telemetry in your terminal. For humans and agents. Direct WebSocket to Chrome's debugging port.",
|
|
5
5
|
"type": "module",
|
|
6
6
|
"bin": {
|
|
@@ -27,8 +27,8 @@
|
|
|
27
27
|
"validate:ts-version": "node -e \"const ts = require('typescript'); const v = ts.version.split('.'); if (parseInt(v[0]) < 5 || (parseInt(v[0]) === 5 && parseInt(v[1]) < 6)) { console.error('Requires TypeScript 5.6+, found:', ts.version); process.exit(1); } else { console.log('✅ TypeScript version:', ts.version); }\"",
|
|
28
28
|
"check": "npm run format:check && npm run type-check && npm run lint",
|
|
29
29
|
"check:enhanced": "npm run format:check && npm run type-check && npm run lint && npm run validate:module-type && npm run validate:ts-version",
|
|
30
|
-
"test": "tsx --test src/**/__tests__/*.test.ts src/**/__tests__/*.contract.test.ts src/__tests__/integration/*.test.ts",
|
|
31
|
-
"test:watch": "tsx --test --watch src/**/__tests__/*.test.ts src/**/__tests__/*.contract.test.ts src/__tests__/integration/*.test.ts",
|
|
30
|
+
"test": "tsx --test src/**/__tests__/*.test.ts src/**/__tests__/*.unit.test.ts src/**/__tests__/*.contract.test.ts src/__tests__/integration/*.test.ts",
|
|
31
|
+
"test:watch": "tsx --test --watch src/**/__tests__/*.test.ts src/**/__tests__/*.unit.test.ts src/**/__tests__/*.contract.test.ts src/__tests__/integration/*.test.ts",
|
|
32
32
|
"test:coverage": "c8 npm test",
|
|
33
33
|
"test:smoke": "tsx --test --test-concurrency=1 src/__tests__/smoke/*.test.ts",
|
|
34
34
|
"prepublishOnly": "npm run build",
|