@comecaramelos/dsh-chrome-mcp 0.0.1 → 2.0.0

package/lib/index.d.ts

@@ -0,0 +1,102 @@
+/**
+ * @comecaramelos/dsh-chrome-mcp — host half, public surface.
+ *
+ * A **component** of the `dsh-mcp-manager` bundle: this package registers the
+ * `chrome` and `chrome-windows` kinds of MCP connection with the manager's
+ * `mcpConnections` service — the first runs `chrome-devtools-mcp` as a local
+ * stdio connection (`npx -y chrome-devtools-mcp@latest [extraFlags]`, wrapped
+ * for its stderr), the second drives the Windows-side Chrome through the WSL
+ * interop mount and connects to its debugging port. Whether a connection runs
+ * is the manager pool's decision, not this package's; the row itself starts
+ * nothing.
+ *
+ * Identity is the row's **profile entry id** (`mcp-chrome`), read off the
+ * plugin's own fiber — not a namespace of its own, and `serverName` is no longer
+ * part of it (a connection's tool namespace is its own `entry.id`).
+ *
+ * What stays in the row is machine state — the saved executable rows, the
+ * seeded selection, the defaults the connections follow when they carry no own
+ * answer — and the card surface that edits it: the extra-flags rows, the
+ * Chrome executable picker, and error reporting.
+ *
+ * Persistence boundary: only the user-authored fields land in the profile's own
+ * patch layer — `extraFlags` (the default flags list),
+ * `chromePath` (the default executable: the picker's pick or the host's seed),
+ * `executables` (the saved-executable rows: `{ id: path, name: label }`),
+ * `droppedExecutables`, `chromeCustomPaths` (**legacy** MRU, folded once),
+ * `refreshExecutablesNonce` (**Fetch executables** trigger),
+ * `openWindowsChromeNonce` (**Prelaunch Windows Chrome** trigger),
+ * `stderrMode` (the default console-output mode) and `migrationDismissed`
+ * (whether the standalone-config translation was turned down; see D4).
+ *
+ * Status state (`lastError`, `executableDiscoveryRevision`, `chromeVersion`,
+ * `executableStatus`, `chromeMissing`, `effectiveChromePath`, `effectiveSource`,
+ * `stderrEffective`, `wslWindowsExecutable`, the static `defaultExtraFlags`
+ * mirror, the static `wslExtraFlags` mirror, `windowsChromeStatus`,
+ * `carriesConnectionMode`, `runningFlags` and `runningNote`) is the **live
+ * mirror**: every one of them is a `.volatile()` field of the same `Config` the
+ * form edits, published by committing that mirror onto this fiber's entry — a
+ * purely volatile commit persists nothing, never remounts the fiber, and is what
+ * the card settles its snapshot on. The controller reads the two layers the
+ * distinction needs (`user` = what the patch carries, `base` = what the row
+ * config carries under it) off the described form row, never off a document of
+ * its own.
+ *
+ * Everything behind this surface lives in ./host/*:
+ *
+ *   ./host/apply.ts       the wiring (controller + kinds + form + tool + commands)
+ *   ./host/manager.ts     the `mcpConnections` seam (register, notify, propose)
+ *   ./host/kind.ts        the two kinds: fields, choices, `resolve`
+ *   ./host/migration.ts   the standalone-config translation (D4)
+ *   ./host/controller/  live state: the mirror + its publish, runs, captures
+ *   ./host/settings.ts    form attach, entry-id rule, commit routing
+ *   ./host/catalog.ts     the saved-executable rows the picker edits
+ *   ./host/discovery/   the candidate paths + `--version` probes + check run
+ *   ./host/bridge.ts      the bridge argv + spawn wrapper, stderr log
+ *   ./host/flags.ts       extra-flags validation + flag predicates
+ *   ./host/platform.ts    WSL detection + the Windows-executable predicate
+ *   ./host/values.ts      precedence resolution + the form's layer reads
+ *   ./host/status.ts      error classification + tool-result notes
+ *   ./host/schema.ts      the single `Config`
+ *   ./host/constants.ts   fixed identifiers, budgets, patterns
+ *
+ * Config (the single `Config`, cordis row + form):
+ *   serverName          legacy tool namespace (ignored by connections; the
+ *                       standalone translation reads it as the entry `id`)
+ *   command             launcher executable        (default "npx")
+ *   package             npm spec to npx            (default "chrome-devtools-mcp@latest")
+ *   extraFlags          default flags appended after the spec  (.volatile())
+ *                       (default ["--no-usage-statistics", "--no-performance-crux"])
+ *   chromePath          the default executable selection  (.volatile())
+ *   chromePaths         scan candidate list when nothing is picked
+ *                       (default defaultChromePaths(), mirroring upstream's
+ *                       stable-channel locations)
+ *   env / cwd / toolCallTimeoutMs / maxInstructionBytes / failOnStartupError /
+ *                       reconnect defaults every connection config carries with
+ *                       whatever its own fields answer instead
+ *
+ * One plugin instance per dsh host: the entry id is fixed.
+ */
+export { inject, name } from "./host/plugin-meta.js";
+export { CONFIGURATION_DOCS_URL, DEFAULT_EXTRA_FLAGS, ENTRY_ID, FLAGS_ENV_VAR, WINDOWS_CHROME_CANDIDATES, WINDOWS_CHROME_PORT, WINDOWS_CHROME_PORT_POOL, WINDOWS_CHROME_PREREQ_PORTS, WSL_EXTRA_FLAGS } from "./host/constants.js";
+export { Config } from "./host/schema.js";
+export { apply } from "./host/apply.js";
+export { createChromeKinds, createChromeKind, createChromeWindowsKind, entryExecutable, entryExtraFlags, entryStderrMode, executableChoices, joinFlagLines, parseFlagLines } from "./host/kind.js";
+export { carriesStandaloneConfig, migrationDismissed, standaloneProposal } from "./host/migration.js";
+export { attachToManager, isOwnedKind } from "./host/manager.js";
+export { chromeMcpEntryId } from "./host/settings.js";
+export { bridgeConfig, bridgeStderrLogPath, buildBridgeSpawn, buildServerArgs, captureLogger, pinnedServerCli, serverCommand, usesPinnedServer } from "./host/bridge.js";
+export { checkChrome, chromeExecutableCandidates, DEFAULT_CHROME_PATHS, defaultChromePaths, discoverChrome, probeExecutable, readWindowsInstallVersion, scanChromeExecutables } from "./host/discovery/index.js";
+export { isChromeMissing, toolResultNote } from "./host/status.js";
+export { WINDOWS_VERSION_UNKNOWN } from "./host/constants.js";
+export { isWindowsExecutablePath, isWindowsExecutableUnderWsl, isWindowsSubsystemForLinux } from "./host/platform.js";
+export { browserUrlFlagPort, findWindowsChromeExecutable, findWindowsChromeExecutables, linkWindowsChromeProfile, runWindowsChromeConnect, windowsChromeLandingHtml, windowsChromeLandingPath, windowsChromeLandingUrl, windowsChromeLocalAppData, windowsChromeProfileDir, windowsChromeUrl, windowsChromeProjectDir, windowsFileUrl, windowsPathToMount, withBrowserUrlFlag } from "./host/windows/index.js";
+export { PRELAUNCH_WINDOWS_CHROME_NAME, installPrelaunchWindowsChromeTool, prelaunchWindowsChromeDefinition } from "./host/tool.js";
+export { carriesConfigFile, carriesConnectionMode, carriesExecutablePath, carriesOtherChannel, extractExecutablePathFlag, flagsSkipCheck, flagsSkipProbe, sameFlags, stripExecutablePathFlags, validateExtraFlags } from "./host/flags.js";
+export { createLiveMirror, liveMirrorKeys, normalizeCustomPaths, readConfigField, readConfigForm, readConfigLayers, readPersistedChromePath, readPersistedCustomPaths, readPersistedFlags, readPersistedStderrMode, readSavedExecutables, resolveEffectiveChromePath, resolveEnvFlags, resolveLaunchFlags, resolveSelection, resolveStderrMode } from "./host/values.js";
+export { entryIds, entryLabel, findEntry, isValidEntryId, mergeEntries, normalizeEntries } from "./host/catalog.js";
+export type { BridgeStderrMode, ChromeMcpConfig, ConfigField, ConfigLayers, ConfigLayerFields, ConfigLiveFields, ConfigUserFields, EffectiveChromeSource, ReconnectConfig } from "./host/types/index.js";
+export type { ChromeExecutableEntry, ChromeExecutableStatus } from "./host/types/index.js";
+export type { ChromeMcpForm, McpBridge, PluginContext, SettingsFormRow, SettingsForms, ToolCallExecution, ToolCallResult, WindowsChromeRun, WindowsChromeState, WindowsChromeStatus } from "./host/types/index.js";
+export type { ConfigFormValues } from "./host/schema.js";
+//# sourceMappingURL=index.d.ts.map

package/lib/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8EG;AAGH,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,uBAAuB,CAAC;AAGrD,OAAO,EACH,sBAAsB,EACtB,mBAAmB,EACnB,QAAQ,EACR,aAAa,EACb,yBAAyB,EACzB,mBAAmB,EACnB,wBAAwB,EACxB,2BAA2B,EAC3B,eAAe,EAClB,MAAM,qBAAqB,CAAC;AAG7B,OAAO,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AAG1C,OAAO,EAAE,KAAK,EAAE,MAAM,iBAAiB,CAAC;AAGxC,OAAO,EACH,iBAAiB,EACjB,gBAAgB,EAChB,uBAAuB,EACvB,eAAe,EACf,eAAe,EACf,eAAe,EACf,iBAAiB,EACjB,aAAa,EACb,cAAc,EACjB,MAAM,gBAAgB,CAAC;AAExB,OAAO,EAAE,uBAAuB,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AAEtG,OAAO,EAAE,eAAe,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAGjE,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAGtD,OAAO,EAAE,YAAY,EAAE,mBAAmB,EAAE,gBAAgB,EAAE,eAAe,EAAE,aAAa,EAAE,eAAe,EAAE,aAAa,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AACzK,OAAO,EACH,WAAW,EACX,0BAA0B,EAC1B,oBAAoB,EACpB,kBAAkB,EAClB,cAAc,EACd,eAAe,EACf,yBAAyB,EACzB,qBAAqB,EACxB,MAAM,2BAA2B,CAAC;AACnC,OAAO,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AACnE,OAAO,EAAE,uBAAuB,EAAE,MAAM,qBAAqB,CAAC;AAC9D,OAAO,EAAE,uBAAuB,EAAE,2BAA2B,EAAE,0BAA0B,EAAE,MAAM,oBAAoB,CAAC;AAGtH,OAAO,EACH,kBAAkB,EAClB,2BAA2B,EAC3B,4BAA4B,EAC5B,wBAAwB,EACxB,uBAAuB,EACvB,wBAAwB,EACxB,wBAAwB,EACxB,uBAAuB,EACvB,yBAAyB,EACzB,uBAAuB,EACvB,gBAAgB,EAChB,uBAAuB,EACvB,cAAc,EACd,kBAAkB,EAClB,kBAAkB,EACrB,MAAM,yBAAyB,CAAC;AAGjC,OAAO,EAAE,6BAA6B,EAAE,iCAAiC,EAAE,gCAAgC,EAAE,MAAM,gBAAgB,CAAC;AACpI,OAAO,EACH,iBAAiB,EACjB,qBAAqB,EACrB,qBAAqB,EACrB,mBAAmB,EACnB,yBAAyB,EACzB,cAAc,EACd,cAAc,EACd,SAAS,EACT,wBAAwB,EACxB,kBAAkB,EACrB,MAAM,iBAAiB,CAAC;AACzB,OAAO,EACH,gBAAgB,EAChB,cAAc,EACd,oBAAoB,EACpB,eAAe,EACf,cAAc,EACd,gBAAgB,EAChB,uBAAuB,EACvB,wBAAwB,EACxB,kBAAkB,EAClB,uBAAuB,EACvB,oBAAoB,EACpB,0BAA0B,EAC1B,eAAe,EACf,kBAAkB,EAClB,gBAAgB,EAChB,iBAAiB,EACpB,MAAM,kBAAkB,CAAC;AAG1B,OAAO,EAAE,QAAQ,EAAE,UAAU,EAAE,SAAS,EAAE,cAAc,EAAE,YAAY,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAMpH,YAAY,EACR,gBAAgB,EAChB,eAAe,EACf,WAAW,EACX,YAAY,EACZ,iBAAiB,EACjB,gBAAgB,EAChB,gBAAgB,EAChB,qBAAqB,EACrB,eAAe,EAClB,MAAM,uBAAuB,CAAC;AAC/B,YAAY,EAAE,qBAAqB,EAAE,sBAAsB,EAAE,MAAM,uBAAuB,CAAC;AAC3F,YAAY,EACR,aAAa,EACb,SAAS,EACT,aAAa,EACb,eAAe,EACf,aAAa,EACb,iBAAiB,EACjB,cAAc,EACd,gBAAgB,EAChB,kBAAkB,EAClB,mBAAmB,EACtB,MAAM,uBAAuB,CAAC;AAC/B,YAAY,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC"}