@rose42/t3-feedback 0.1.0 → 0.1.2

package/README.md

@@ -101,6 +101,7 @@ export default defineConfig({
       // // or { key: "f", mod: true, shift: true } for Ctrl/⌘+Shift+F
       // threadReuse: "ask", // or "session-route" | "never"
       // threadTitle: "Checkout", // optional title prefix
+      // modelSelection: { instanceId: "cursor", model: "auto" },
       // origin: "http://localhost:3773",
     }),
   ],
@@ -398,25 +399,26 @@ only clear the local activity list.
 
 ## Options
 
-| Option               | Default                                      | Notes                                                                                                                                                                                                                                           |
-| -------------------- | -------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
-| `origin`             | `http://localhost:3773`                      | Overridable via `T3_FEEDBACK_ORIGIN` / `T3_ORIGIN`                                                                                                                                                                                              |
-| `openOrigin`         | same as `origin`                             | Host-browser URL for Open-in-T3 (`T3_FEEDBACK_OPEN_ORIGIN`). Set explicitly in multi-container setups; do not point at another project's T3.                                                                                                    |
-| `threadReuse`        | `"ask"`                                      | `"ask"` replaces Send with New / ▶ {title} ▾: **Ctrl/⌘+Enter** soft-default, **Ctrl/⌘+Shift+Enter** New, **Alt+Enter** Continue; chevron lists project threads (search); `"session-route"` always reuses per pathname; `"never"` always creates |
-| `threadTitle`        | _(none)_                                     | Optional prefix for new thread titles (`Bug: path · comment`)                                                                                                                                                                                   |
-| `workspaceRootHints` | `[cwd]` (+ `T3_FEEDBACK_WORKSPACE_HINT`)     | Match T3 project by workspace path                                                                                                                                                                                                              |
-| `shortcut`           | _(omit for Ctrl/⌘+Shift+F)_                  | When set, omitted `mod`/`shift`/`alt` are `false` (e.g. `{ key: "f" }` = bare F). Bare keys skip editable fields; Ctrl/⌘+Shift+key still opens while typing                                                                                     |
-| `shortcutKey`        | _(deprecated)_                               | Key-only alias; prefer `shortcut.key`                                                                                                                                                                                                           |
-| `pick`               | Ctrl/⌘+Shift+E, `afterPick: "crop"`          | Pick shortcut (`false` to disable), after-pick capture/crop, padding; `openInEditor` (default on) makes resolved file paths clickable via Vite `/__open-in-editor` or a `urlTemplate`                                                           |
-| `screenshot`         | Ctrl/⌘+Shift+S, `crop: "ui"`, `maxImages: 5` | Capture shortcut (`false` to disable); crop `"ui"` (on-demand from thumbs) \| `"auto"` \| `"none"`; gallery cap                                                                                                                                 |
-| `record`             | Ctrl/⌘+Shift+R                               | Record / frame-burst shortcut (`false` to disable); gated with `screenshot` in `activePlugins`                                                                                                                                                  |
-| `activePlugins`      | all four built-ins                           | `pageContext` \| `consoleLogs` \| `screenshot` \| `elementTarget` — omit for defaults                                                                                                                                                           |
-| `pluginOptions`      | `consoleLogs.maxEntries: 200`                | Serializable options for selected built-ins                                                                                                                                                                                                     |
-| `customPlugins`      | `[]`                                         | Vite-resolved module paths/ids imported into the injected client                                                                                                                                                                                |
-| `injectClient`       | `true`                                       | HTML inject of the overlay                                                                                                                                                                                                                      |
-| `fab`                | mobile-only, bottom-right                    | FAB visibility / position / size                                                                                                                                                                                                                |
-| `reportTypeGlyph`    | `"icon"`                                     | `"icon"` (SVG + textual titles), `"emoji"`, or a map `{ Bug, Feedback, Suggestion }` — emoji/map also prefix new chat names                                                                                                                     |
-| `version`            | _(none)_                                     | App version on bug/feedback reports; DEV also attaches HMR `#n`                                                                                                                                                                                 |
+| Option               | Default                                      | Notes                                                                                                                                                                                                                                                                                                                                                                  |
+| -------------------- | -------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `origin`             | `http://localhost:3773`                      | Overridable via `T3_FEEDBACK_ORIGIN` / `T3_ORIGIN`                                                                                                                                                                                                                                                                                                                     |
+| `openOrigin`         | same as `origin`                             | Host-browser URL for Open-in-T3 (`T3_FEEDBACK_OPEN_ORIGIN`). Set explicitly in multi-container setups; do not point at another project's T3.                                                                                                                                                                                                                           |
+| `threadReuse`        | `"ask"`                                      | `"ask"` replaces Send with New / ▶ {title} ▾: **Ctrl/⌘+Enter** soft-default, **Ctrl/⌘+Shift+Enter** New, **Alt+Enter** Continue; chevron lists project threads (search); `"session-route"` always reuses per pathname; `"never"` always creates                                                                                                                        |
+| `threadTitle`        | _(none)_                                     | Optional prefix for new thread titles (`Bug: path · comment`)                                                                                                                                                                                                                                                                                                          |
+| `modelSelection`     | `{ instanceId: "cursor", model: "default" }` | Provider/model for **new** threads. When omitted, prefers an existing same-project Cursor thread (e.g. Auto) instead of copying the first thread. Env: `T3_FEEDBACK_INSTANCE_ID` / `T3_FEEDBACK_MODEL`                                                                                                                                                                 |
+| `workspaceRootHints` | `[cwd]` (+ `T3_FEEDBACK_WORKSPACE_HINT`)     | Match T3 project by workspace path                                                                                                                                                                                                                                                                                                                                     |
+| `shortcut`           | _(omit for Ctrl/⌘+Shift+F)_                  | When set, omitted `mod`/`shift`/`alt` are `false` (e.g. `{ key: "f" }` = bare F). Bare keys skip editable fields; Ctrl/⌘+Shift+key still opens while typing                                                                                                                                                                                                            |
+| `shortcutKey`        | _(deprecated)_                               | Key-only alias; prefer `shortcut.key`                                                                                                                                                                                                                                                                                                                                  |
+| `pick`               | Ctrl/⌘+Shift+E, `afterPick: "crop"`          | Pick shortcut (`false` to disable), after-pick capture/crop, padding; `openInEditor` (default on) makes resolved file paths clickable via Vite `/__open-in-editor` or a `urlTemplate`; `sourcePathPrefix` makes paths workspace-relative (e.g. `examples/vite-react`) — also auto-derived by the Vite plugin when `workspaceRootHints` is an ancestor of the Vite root |
+| `screenshot`         | Ctrl/⌘+Shift+S, `crop: "ui"`, `maxImages: 5` | Capture shortcut (`false` to disable); crop `"ui"` (on-demand from thumbs) \| `"auto"` \| `"none"`; gallery cap                                                                                                                                                                                                                                                        |
+| `record`             | Ctrl/⌘+Shift+R                               | Record / frame-burst shortcut (`false` to disable); gated with `screenshot` in `activePlugins`                                                                                                                                                                                                                                                                         |
+| `activePlugins`      | all four built-ins                           | `pageContext` \| `consoleLogs` \| `screenshot` \| `elementTarget` — omit for defaults                                                                                                                                                                                                                                                                                  |
+| `pluginOptions`      | `consoleLogs.maxEntries: 200`                | Serializable options for selected built-ins                                                                                                                                                                                                                                                                                                                            |
+| `customPlugins`      | `[]`                                         | Vite-resolved module paths/ids imported into the injected client                                                                                                                                                                                                                                                                                                       |
+| `injectClient`       | `true`                                       | HTML inject of the overlay                                                                                                                                                                                                                                                                                                                                             |
+| `fab`                | mobile-only, bottom-right                    | FAB visibility / position / size                                                                                                                                                                                                                                                                                                                                       |
+| `reportTypeGlyph`    | `"icon"`                                     | `"icon"` (SVG + textual titles), `"emoji"`, or a map `{ Bug, Feedback, Suggestion }` — emoji/map also prefix new chat names                                                                                                                                                                                                                                            |
+| `version`            | _(none)_                                     | App version on bug/feedback reports; DEV also attaches HMR `#n`                                                                                                                                                                                                                                                                                                        |
 
 ## Environment
 
@@ -424,6 +426,8 @@ only clear the local activity list.
 | ---------------------------------- | ----------------------------------------------------------------------------------------- |
 | `T3_FEEDBACK_ORIGIN` / `T3_ORIGIN` | T3 HTTP origin                                                                            |
 | `T3_FEEDBACK_OPEN_ORIGIN`          | Browser origin for Open-in-T3 (default: same as `T3_FEEDBACK_ORIGIN`)                     |
+| `T3_FEEDBACK_INSTANCE_ID`          | Default provider instance for new threads (e.g. `cursor`)                                 |
+| `T3_FEEDBACK_MODEL`                | Default model id for new threads (e.g. `auto`, `default`)                                 |
 | `T3_FEEDBACK_TOKEN`                | Pre-issued bearer (skips `t3 auth session issue`)                                         |
 | `T3_FEEDBACK_WORKSPACE_HINT`       | Extra workspace path hint                                                                 |
 | `LAUNCH_EDITOR`                    | Editor binary for Vite `/__open-in-editor` (e.g. `cursor`, `code`) when auto-detect fails |
@@ -439,28 +443,58 @@ container avoid opening the wrong environment (check the Vite log line
 `T3_FEEDBACK_TOKEN` set. Browser needs `getDisplayMedia` (paste image works as fallback).
 
 When element pick resolves a component file, the ELEMENT chip path is a link that
-opens the IDE. Default is Vite’s `/__open-in-editor` (same as the error overlay) —
-that only works when the browser and Vite share a machine that can launch an
-editor (`LAUNCH_EDITOR=cursor` or `code` if auto-detect fails).
+opens the IDE. Default is the bridge `GET {api}/open-editor?file=…` (same origin
+as feedback posts), which launches the Cursor/VS Code **remote CLI** so
+container `/workspaces/…` paths remap to the host. Vite’s `/__open-in-editor`
+still works if you set `pick.openInEditor.endpoint` explicitly
+(`LAUNCH_EDITOR=cursor` or `code` if auto-detect fails).
 
-When the **browser is on the host** and Vite runs in a **container/remote**, use a
-protocol URL instead so the OS / Cursor handles the open:
+When the Vite/Next app lives in a **subfolder** of the T3 / IDE workspace (e.g.
+`examples/vite-react`), set `workspaceRootHints` to the workspace root so the
+plugin prefixes chip + agent paths (`examples/vite-react/src/App.tsx`). Or set
+`pick.sourcePathPrefix` explicitly.
+
+```ts
+t3FeedbackPlugin({
+  workspaceRootHints: [path.resolve(import.meta.dirname, "../..")],
+  pick: { sourceFramework: "react" },
+});
+```
+
+When the **browser is on the host** and the remote CLI is unavailable, use a
+protocol URL with a **host** filesystem root — not the container `/workspaces/…`
+path:
 
 ```ts
 t3FeedbackPlugin({
   pick: {
     openInEditor: {
-      // `{file}` is whatever the sourcemap returns (often relative). Prefix with
-      // an absolute project root when your scheme requires absolute paths.
-      urlTemplate: `cursor://file${process.cwd()}/{file}:{line}:{column}`,
+      // Prefer the host checkout path (e.g. from your bind-mount source).
+      urlTemplate: `cursor://file${process.env.HOST_WORKSPACE_ROOT}/{file}:{line}:{column}`,
     },
   },
 });
 ```
 
-With `urlTemplate`, the chip renders a real `<a href>` (not a fetch to Vite).
+With `urlTemplate`, the chip renders a real `<a href>` (not a fetch to the bridge).
 `vscode://file/…` also works if that scheme is bound to your editor.
 
+## Examples
+
+Minimal demos for each host connector live under [`examples/`](examples/) and run
+in this same Dev Container against the existing T3 (`T3CODE_PORT`). Each example
+declares `@rose42/t3-feedback` from npm and overrides it to `link:../..` so local
+`dist/` is used.
+
+```bash
+pnpm build
+pnpm examples:install
+pnpm examples:vite-react   # also: vite-vue / vite-svelte / vite-qwik / next / node
+pnpm examples:all          # every example in parallel
+```
+
+See [examples/README.md](examples/README.md) for ports and the dependency model.
+
 ## Package scripts
 
 ```bash
@@ -480,37 +514,18 @@ pnpm dev
 
 ## Release
 
-Releases are driven by **version tags** (`vX.Y.Z`). Pushing a tag runs CI: verify → GitLab Release (dist tarball in the package registry) → publish to public npm.
+Releases are driven by **version tags** (`vX.Y.Z`). Pushing a tag runs CI: verify → GitLab Release (dist tarball in the package registry) → publish to public npm via **OIDC trusted publishing** (no `NPM_TOKEN`).
 
 CI installs `@rose42/feedback-capture@0.1.0` from npm. Local/devcontainer work
 symlinks a sibling [`feedback-capture`](https://gitlab.com/rose42/feedback-capture) clone
 into `node_modules` without changing the declared dependency.
 
-### One-time npm + GitLab setup
-
-1. Create or join the **`rose42`** org on [npmjs.com](https://www.npmjs.com) with permission to publish `@rose42/*`.
-2. Create an npm **Automation** (or granular) access token with publish rights for `@rose42/t3-feedback` (or the whole `@rose42` org).
-3. In GitLab: **Settings → CI/CD → Variables** → add:
-   - Key: `NPM_TOKEN`
-   - Value: the token
-   - Flags: **Masked**; use **Protected** only if `v*` tags are protected (otherwise leave Protected off so tag pipelines can read it).
-4. Optional local check: `pnpm login` then `pnpm publish --dry-run --access public`.
-
-### Cut a release
-
-Requires a clean git worktree. Bumps `package.json`, commits, tags `vX.Y.Z`, and pushes (with `--follow-tags`) so the tag pipeline runs. Ensure `NPM_TOKEN` is set in GitLab before the first publish.
+See [docs/release.md](docs/release.md) for trusted-publisher setup, post-publish hardening, and cutting a release:
 
 ```bash
-pnpm release -- 0.1.0    # first release
-# later:
-pnpm release -- patch    # or: minor | major
+pnpm release -- patch    # or 0.1.1 / minor / major
 ```
 
-After the pipeline succeeds:
-
-- npm: [`@rose42/t3-feedback`](https://www.npmjs.com/package/@rose42/t3-feedback)
-- GitLab: **Deploy → Releases** (asset links to the generic package tarball)
-
 ## License
 
 MIT © Rose42

package/dist/bridge/http.d.ts

@@ -1,5 +1,5 @@
-import type { T3FeedbackReportTypeGlyphResolved } from "../types.js";
-export type T3FeedbackBridgeRoute = "feedback" | "threads" | "settle" | "open" | "source" | null;
+import type { T3FeedbackModelSelection, T3FeedbackReportTypeGlyphResolved } from "../types.js";
+export type T3FeedbackBridgeRoute = "feedback" | "threads" | "settle" | "open" | "open-editor" | "source" | null;
 /**
  * Options for the host-agnostic Fetch handler (Vite middleware, Next Route Handler, …).
  * Env vars (`T3_FEEDBACK_*`) apply when fields are omitted — same as the Vite plugin.
@@ -14,6 +14,11 @@ export type T3FeedbackBridgeServerOptions = {
     openOrigin?: string;
     workspaceRootHints?: string[];
     threadTitlePrefix?: string;
+    /**
+     * Provider/model for newly created threads.
+     * Env fallback: `T3_FEEDBACK_INSTANCE_ID` + `T3_FEEDBACK_MODEL`.
+     */
+    modelSelection?: T3FeedbackModelSelection;
     reportTypeGlyph?: T3FeedbackReportTypeGlyphResolved;
     token?: string;
 };

package/dist/bridge/http.js

@@ -1,8 +1,10 @@
 import { resolveOpenOrigin } from "./format.js";
-import { T3_FEEDBACK_API_PATH, T3_FEEDBACK_OPEN_SUFFIX, T3_FEEDBACK_SETTLE_SUFFIX, T3_FEEDBACK_SOURCE_SUFFIX, T3_FEEDBACK_THREADS_SUFFIX, } from "./paths.js";
+import { launchEditorAt, parseEditorFileParam, resolveEditorFilePath } from "./launchEditor.js";
+import { T3_FEEDBACK_API_PATH, T3_FEEDBACK_OPEN_EDITOR_SUFFIX, T3_FEEDBACK_OPEN_SUFFIX, T3_FEEDBACK_SETTLE_SUFFIX, T3_FEEDBACK_SOURCE_SUFFIX, T3_FEEDBACK_THREADS_SUFFIX, } from "./paths.js";
 import { parseFeedbackPost, parseOpenHandoffRequest, parseSettlePost, parseThreadProbeIds, } from "./parse.js";
 import { readWorkspaceSourceFile } from "./readSource.js";
 import { createOpenHandoff, listThreadsInT3, probeThreadsInT3, sendFeedbackToT3, settleThreadsInT3, } from "./sendFeedback.js";
+import { normalizeModelSelection } from "../types.js";
 import path from "node:path";
 const DEFAULT_ORIGIN = "http://localhost:3773";
 function pathResolveUp(from, levels) {
@@ -22,6 +24,8 @@ export function matchT3FeedbackRoute(pathname, basePath = T3_FEEDBACK_API_PATH)
         return "threads";
     if (pathname === `${base}${T3_FEEDBACK_SETTLE_SUFFIX}`)
         return "settle";
+    if (pathname === `${base}${T3_FEEDBACK_OPEN_EDITOR_SUFFIX}`)
+        return "open-editor";
     if (pathname === `${base}${T3_FEEDBACK_OPEN_SUFFIX}`)
         return "open";
     if (pathname === `${base}${T3_FEEDBACK_SOURCE_SUFFIX}`)
@@ -42,12 +46,20 @@ function resolveBridgeEnv(options) {
     const workspaceRootHints = options.workspaceRootHints ??
         [process.env.T3_FEEDBACK_WORKSPACE_HINT, process.cwd()].filter((value) => Boolean(value));
     const threadTitlePrefix = options.threadTitlePrefix?.trim() || undefined;
+    const modelSelection = normalizeModelSelection(options.modelSelection) ??
+        normalizeModelSelection({
+            ...(process.env.T3_FEEDBACK_INSTANCE_ID
+                ? { instanceId: process.env.T3_FEEDBACK_INSTANCE_ID }
+                : {}),
+            ...(process.env.T3_FEEDBACK_MODEL ? { model: process.env.T3_FEEDBACK_MODEL } : {}),
+        });
     const token = options.token ?? process.env.T3_FEEDBACK_TOKEN;
     return {
         origin,
         openOrigin,
         workspaceRootHints,
         ...(threadTitlePrefix ? { threadTitlePrefix } : {}),
+        ...(modelSelection ? { modelSelection } : {}),
         ...(options.reportTypeGlyph ? { reportTypeGlyph: options.reportTypeGlyph } : {}),
         ...(token ? { token } : {}),
         basePath: normalizeBasePath(options.basePath ?? T3_FEEDBACK_API_PATH),
@@ -116,6 +128,33 @@ export async function handleT3FeedbackRequest(request, options = {}) {
             });
             return jsonResponse(200, handoff);
         }
+        if (route === "open-editor" && request.method === "GET") {
+            const fileParam = url.searchParams.get("file")?.trim() ?? "";
+            const parsed = parseEditorFileParam(fileParam);
+            if (!parsed) {
+                return jsonResponse(400, {
+                    error: "Missing or invalid file query param (expected path:line:column)",
+                });
+            }
+            const hints = [
+                ...resolved.workspaceRootHints,
+                process.cwd(),
+                pathResolveUp(process.cwd(), 1),
+                pathResolveUp(process.cwd(), 2),
+            ].filter((value, index, all) => {
+                return Boolean(value) && all.indexOf(value) === index;
+            });
+            const absolutePath = resolveEditorFilePath(parsed.fileName, hints);
+            if (!absolutePath) {
+                return jsonResponse(404, { error: `File not found: ${parsed.fileName}` });
+            }
+            if (!launchEditorAt(absolutePath, parsed.line, parsed.column)) {
+                return jsonResponse(503, {
+                    error: "No editor CLI found (set LAUNCH_EDITOR, or install Cursor/VS Code remote CLI)",
+                });
+            }
+            return new Response(null, { status: 204 });
+        }
         if (route === "source" && request.method === "GET") {
             const file = url.searchParams.get("file")?.trim() ?? "";
             if (!file) {
@@ -154,6 +193,7 @@ export async function handleT3FeedbackRequest(request, options = {}) {
                 workspaceRootHints: resolved.workspaceRootHints,
                 ...(resolved.reportTypeGlyph ? { reportTypeGlyph: resolved.reportTypeGlyph } : {}),
                 ...(resolved.threadTitlePrefix ? { threadTitlePrefix: resolved.threadTitlePrefix } : {}),
+                ...(resolved.modelSelection ? { modelSelection: resolved.modelSelection } : {}),
                 ...(parsed.threadId ? { threadId: parsed.threadId } : {}),
                 ...(resolved.token ? { token: resolved.token } : {}),
             });

package/dist/bridge/index.d.ts

@@ -5,9 +5,11 @@
  */
 export { handleT3FeedbackRequest, matchT3FeedbackRoute, type T3FeedbackBridgeRoute, type T3FeedbackBridgeServerOptions, } from "./http.js";
 export { parseFeedbackPost, parseOpenHandoffRequest, parseSettlePost, parseThreadProbeIds, } from "./parse.js";
-export { T3_FEEDBACK_API_PATH, T3_FEEDBACK_OPEN_PATH, T3_FEEDBACK_OPEN_SUFFIX, T3_FEEDBACK_SETTLE_PATH, T3_FEEDBACK_SETTLE_SUFFIX, T3_FEEDBACK_SOURCE_SUFFIX, T3_FEEDBACK_THREADS_PATH, T3_FEEDBACK_THREADS_SUFFIX, } from "./paths.js";
+export { T3_FEEDBACK_API_PATH, T3_FEEDBACK_OPEN_PATH, T3_FEEDBACK_OPEN_SUFFIX, T3_FEEDBACK_OPEN_EDITOR_PATH, T3_FEEDBACK_OPEN_EDITOR_SUFFIX, T3_FEEDBACK_SETTLE_PATH, T3_FEEDBACK_SETTLE_SUFFIX, T3_FEEDBACK_SOURCE_SUFFIX, T3_FEEDBACK_THREADS_PATH, T3_FEEDBACK_THREADS_SUFFIX, } from "./paths.js";
 export { readWorkspaceSourceFile } from "./readSource.js";
-export { clearT3EnvironmentIdCache, createOpenHandoff, issuePairingCredential, listThreadsInT3, parseT3JsonStdout, pickProject, probeThreadsInT3, resolveT3Environment, resolveT3EnvironmentId, sendFeedbackToT3, settleThreadsInT3, type ProbeThreadsOptions, type ShellSnapshot, type T3BridgeOptions, type T3EnvironmentDescriptor, } from "./sendFeedback.js";
+export { launchEditorAt, parseEditorFileParam, resolveEditorBinary, resolveEditorFilePath, } from "./launchEditor.js";
+export { clearT3EnvironmentIdCache, createOpenHandoff, issuePairingCredential, listThreadsInT3, parseT3JsonStdout, pickProject, probeThreadsInT3, resolveModelSelection, resolveT3Environment, resolveT3EnvironmentId, sendFeedbackToT3, settleThreadsInT3, type ProbeThreadsOptions, type ShellSnapshot, type T3BridgeOptions, type T3EnvironmentDescriptor, } from "./sendFeedback.js";
 export { buildPairOpenUrl, buildThreadOpenUrl, deriveThreadTitle, formatCustomPluginSection, formatFeedbackMessage, normalizeOrigin, resolveOpenOrigin, type T3FeedbackFormatHeadingBody, type T3FeedbackFormatLabelValue, type T3FeedbackFormatMarkdown, } from "./format.js";
 export { dataUrlSizeBytes, envelopeImageAttachments, isT3FeedbackAttachmentsValue, type T3FeedbackAttachmentsValue, type T3FeedbackImageAttachment, } from "./attachments.js";
-export type { FeedbackSendResult, ThreadListItem, ThreadProbeResult, ThreadProbeState, ThreadSettleResult, ThreadsListResponse, ThreadsProbeResponse, ThreadsSettleResponse, T3FeedbackOpenHandoff, T3FeedbackReportTypeGlyphResolved, } from "../types.js";
+export type { FeedbackSendResult, ThreadListItem, ThreadProbeResult, ThreadProbeState, ThreadSettleResult, ThreadsListResponse, ThreadsProbeResponse, ThreadsSettleResponse, T3FeedbackModelSelection, T3FeedbackOpenHandoff, T3FeedbackReportTypeGlyphResolved, } from "../types.js";
+export { DEFAULT_MODEL_SELECTION, normalizeModelSelection } from "../types.js";

package/dist/bridge/index.js

@@ -5,8 +5,10 @@
  */
 export { handleT3FeedbackRequest, matchT3FeedbackRoute, } from "./http.js";
 export { parseFeedbackPost, parseOpenHandoffRequest, parseSettlePost, parseThreadProbeIds, } from "./parse.js";
-export { T3_FEEDBACK_API_PATH, T3_FEEDBACK_OPEN_PATH, T3_FEEDBACK_OPEN_SUFFIX, T3_FEEDBACK_SETTLE_PATH, T3_FEEDBACK_SETTLE_SUFFIX, T3_FEEDBACK_SOURCE_SUFFIX, T3_FEEDBACK_THREADS_PATH, T3_FEEDBACK_THREADS_SUFFIX, } from "./paths.js";
+export { T3_FEEDBACK_API_PATH, T3_FEEDBACK_OPEN_PATH, T3_FEEDBACK_OPEN_SUFFIX, T3_FEEDBACK_OPEN_EDITOR_PATH, T3_FEEDBACK_OPEN_EDITOR_SUFFIX, T3_FEEDBACK_SETTLE_PATH, T3_FEEDBACK_SETTLE_SUFFIX, T3_FEEDBACK_SOURCE_SUFFIX, T3_FEEDBACK_THREADS_PATH, T3_FEEDBACK_THREADS_SUFFIX, } from "./paths.js";
 export { readWorkspaceSourceFile } from "./readSource.js";
-export { clearT3EnvironmentIdCache, createOpenHandoff, issuePairingCredential, listThreadsInT3, parseT3JsonStdout, pickProject, probeThreadsInT3, resolveT3Environment, resolveT3EnvironmentId, sendFeedbackToT3, settleThreadsInT3, } from "./sendFeedback.js";
+export { launchEditorAt, parseEditorFileParam, resolveEditorBinary, resolveEditorFilePath, } from "./launchEditor.js";
+export { clearT3EnvironmentIdCache, createOpenHandoff, issuePairingCredential, listThreadsInT3, parseT3JsonStdout, pickProject, probeThreadsInT3, resolveModelSelection, resolveT3Environment, resolveT3EnvironmentId, sendFeedbackToT3, settleThreadsInT3, } from "./sendFeedback.js";
 export { buildPairOpenUrl, buildThreadOpenUrl, deriveThreadTitle, formatCustomPluginSection, formatFeedbackMessage, normalizeOrigin, resolveOpenOrigin, } from "./format.js";
 export { dataUrlSizeBytes, envelopeImageAttachments, isT3FeedbackAttachmentsValue, } from "./attachments.js";
+export { DEFAULT_MODEL_SELECTION, normalizeModelSelection } from "../types.js";

package/dist/bridge/launchEditor.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Locate a Cursor / VS Code remote CLI binary (or honor `LAUNCH_EDITOR`).
+ * Returns an absolute path, or `null` when nothing usable is found.
+ */
+export declare function resolveEditorBinary(): string | null;
+/** Parse Vite-style `path:line:column` (column optional). */
+export declare function parseEditorFileParam(fileParam: string): {
+    fileName: string;
+    line: number;
+    column: number;
+} | null;
+/**
+ * Resolve a workspace- or app-relative source path under one of the hint roots.
+ * Rejects path traversal.
+ */
+export declare function resolveEditorFilePath(fileName: string, workspaceRootHints: readonly string[]): string | null;
+/**
+ * Open a file in the IDE via the remote CLI / LAUNCH_EDITOR.
+ * Returns true when a spawn was started (does not wait for the editor).
+ */
+export declare function launchEditorAt(absolutePath: string, line?: number, column?: number): boolean;

package/dist/bridge/launchEditor.js

@@ -0,0 +1,139 @@
+import { spawn } from "node:child_process";
+import fs from "node:fs";
+import path from "node:path";
+const REMOTE_CLI_NAMES = ["cursor", "code"];
+/**
+ * Locate a Cursor / VS Code remote CLI binary (or honor `LAUNCH_EDITOR`).
+ * Returns an absolute path, or `null` when nothing usable is found.
+ */
+export function resolveEditorBinary() {
+    const fromEnv = process.env.LAUNCH_EDITOR?.trim();
+    if (fromEnv && fs.existsSync(fromEnv))
+        return fromEnv;
+    const home = process.env.HOME?.trim();
+    if (home) {
+        for (const product of ["cursor-server", "vscode-server"]) {
+            const binRoot = path.join(home, `.${product}`, "bin");
+            if (!fs.existsSync(binRoot))
+                continue;
+            let versions = [];
+            try {
+                versions = fs.readdirSync(binRoot);
+            }
+            catch {
+                continue;
+            }
+            // Prefer newest install dir name (Cursor hashes are not strictly sortable;
+            // mtime is a better signal).
+            const ranked = versions
+                .map((name) => {
+                const cliDir = path.join(binRoot, name, "bin", "remote-cli");
+                try {
+                    return { cliDir, mtime: fs.statSync(path.join(binRoot, name)).mtimeMs };
+                }
+                catch {
+                    return null;
+                }
+            })
+                .filter((entry) => Boolean(entry))
+                .sort((a, b) => b.mtime - a.mtime);
+            for (const { cliDir } of ranked) {
+                for (const name of REMOTE_CLI_NAMES) {
+                    const candidate = path.join(cliDir, name);
+                    if (fs.existsSync(candidate))
+                        return candidate;
+                }
+            }
+        }
+    }
+    for (const name of REMOTE_CLI_NAMES) {
+        const fromPath = lookupOnPath(name);
+        if (fromPath)
+            return fromPath;
+    }
+    return null;
+}
+function lookupOnPath(command) {
+    const pathEnv = process.env.PATH ?? "";
+    for (const dir of pathEnv.split(path.delimiter)) {
+        if (!dir)
+            continue;
+        const candidate = path.join(dir, command);
+        try {
+            if (fs.existsSync(candidate) && fs.statSync(candidate).isFile())
+                return candidate;
+        }
+        catch {
+            // continue
+        }
+    }
+    return null;
+}
+/** Parse Vite-style `path:line:column` (column optional). */
+export function parseEditorFileParam(fileParam) {
+    const trimmed = fileParam.trim();
+    if (!trimmed)
+        return null;
+    // Split from the right so Windows drive letters / absolute paths stay intact.
+    const match = /^(.+?):(\d+)(?::(\d+))?$/.exec(trimmed);
+    if (!match?.[1] || !match[2]) {
+        return { fileName: trimmed, line: 1, column: 1 };
+    }
+    const line = Math.max(1, Number(match[2]));
+    const column = match[3] ? Math.max(1, Number(match[3])) : 1;
+    if (!Number.isFinite(line) || !Number.isFinite(column))
+        return null;
+    return { fileName: match[1], line, column };
+}
+/**
+ * Resolve a workspace- or app-relative source path under one of the hint roots.
+ * Rejects path traversal.
+ */
+export function resolveEditorFilePath(fileName, workspaceRootHints) {
+    const cleaned = fileName.replace(/\\/g, "/").trim();
+    if (!cleaned || cleaned.includes("\0") || cleaned.includes(".."))
+        return null;
+    if (path.isAbsolute(cleaned)) {
+        if (!fs.existsSync(cleaned))
+            return null;
+        const abs = path.resolve(cleaned);
+        const allowed = workspaceRootHints.some((root) => {
+            const rootResolved = path.resolve(root);
+            return abs === rootResolved || abs.startsWith(rootResolved + path.sep);
+        });
+        return allowed || workspaceRootHints.length === 0 ? abs : null;
+    }
+    for (const root of workspaceRootHints) {
+        const absolutePath = path.resolve(root, cleaned);
+        const rootResolved = path.resolve(root);
+        if (absolutePath !== rootResolved && !absolutePath.startsWith(rootResolved + path.sep)) {
+            continue;
+        }
+        if (fs.existsSync(absolutePath))
+            return absolutePath;
+    }
+    return null;
+}
+/**
+ * Open a file in the IDE via the remote CLI / LAUNCH_EDITOR.
+ * Returns true when a spawn was started (does not wait for the editor).
+ */
+export function launchEditorAt(absolutePath, line = 1, column = 1) {
+    const editor = resolveEditorBinary();
+    if (!editor)
+        return false;
+    const target = `${absolutePath}:${Math.max(1, line)}:${Math.max(1, column)}`;
+    try {
+        // Cursor / VS Code remote CLI: `cursor -g file:line:column`
+        const child = spawn(editor, ["-g", target], {
+            detached: true,
+            stdio: "ignore",
+            env: process.env,
+        });
+        child.unref();
+        return true;
+    }
+    catch {
+        return false;
+    }
+}

package/dist/bridge/paths.d.ts

@@ -3,8 +3,10 @@ export declare const T3_FEEDBACK_API_PATH = "/__t3-feedback";
 export declare const T3_FEEDBACK_THREADS_PATH = "/__t3-feedback/threads";
 export declare const T3_FEEDBACK_SETTLE_PATH = "/__t3-feedback/settle";
 export declare const T3_FEEDBACK_OPEN_PATH = "/__t3-feedback/open";
+export declare const T3_FEEDBACK_OPEN_EDITOR_PATH = "/__t3-feedback/open-editor";
 /** Suffixes under a host-chosen base path (e.g. `/api/t3-feedback`). */
 export declare const T3_FEEDBACK_THREADS_SUFFIX = "/threads";
 export declare const T3_FEEDBACK_SETTLE_SUFFIX = "/settle";
 export declare const T3_FEEDBACK_OPEN_SUFFIX = "/open";
+export declare const T3_FEEDBACK_OPEN_EDITOR_SUFFIX = "/open-editor";
 export declare const T3_FEEDBACK_SOURCE_SUFFIX = "/source";

package/dist/bridge/paths.js

@@ -3,8 +3,10 @@ export const T3_FEEDBACK_API_PATH = "/__t3-feedback";
 export const T3_FEEDBACK_THREADS_PATH = "/__t3-feedback/threads";
 export const T3_FEEDBACK_SETTLE_PATH = "/__t3-feedback/settle";
 export const T3_FEEDBACK_OPEN_PATH = "/__t3-feedback/open";
+export const T3_FEEDBACK_OPEN_EDITOR_PATH = "/__t3-feedback/open-editor";
 /** Suffixes under a host-chosen base path (e.g. `/api/t3-feedback`). */
 export const T3_FEEDBACK_THREADS_SUFFIX = "/threads";
 export const T3_FEEDBACK_SETTLE_SUFFIX = "/settle";
 export const T3_FEEDBACK_OPEN_SUFFIX = "/open";
+export const T3_FEEDBACK_OPEN_EDITOR_SUFFIX = "/open-editor";
 export const T3_FEEDBACK_SOURCE_SUFFIX = "/source";

package/dist/bridge/readSource.js

@@ -15,9 +15,11 @@ export async function readWorkspaceSourceFile(fileParam, workspaceRootHints) {
     if (!ALLOWED_EXT.has(ext))
         return null;
     // Prefer app/package sources; allow either apps/<pkg>/… or app/… (Next app cwd).
+    // `examples/<name>/…` covers monorepo demo apps whose IDE workspace is the repo root.
     if (!cleaned.startsWith("app/") &&
         !cleaned.startsWith("apps/") &&
         !cleaned.startsWith("packages/") &&
+        !cleaned.startsWith("examples/") &&
         !cleaned.startsWith("src/")) {
         return null;
     }

package/dist/bridge/sendFeedback.d.ts

@@ -1,5 +1,5 @@
 import type { FeedbackEnvelope } from "@rose42/feedback-capture";
-import type { FeedbackSendResult, T3FeedbackReportTypeGlyphResolved, ThreadListItem, ThreadProbeResult, ThreadSettleResult } from "../types.js";
+import type { FeedbackSendResult, T3FeedbackModelSelection, T3FeedbackReportTypeGlyphResolved, ThreadListItem, ThreadProbeResult, ThreadSettleResult } from "../types.js";
 import type { T3FeedbackOpenHandoff } from "../types.js";
 export type ShellSnapshot = {
     snapshotSequence: number;
@@ -34,6 +34,12 @@ export type T3BridgeOptions = {
      * instead of `Bug` / `Feedback` / `Suggestion`.
      */
     reportTypeGlyph?: T3FeedbackReportTypeGlyphResolved;
+    /**
+     * Provider/model for newly created threads. When set, used as-is.
+     * When omitted, {@link resolveModelSelection} prefers a same-project thread
+     * matching {@link DEFAULT_MODEL_SELECTION}.instanceId.
+     */
+    modelSelection?: T3FeedbackModelSelection;
     /**
      * Reuse this thread when it still exists in the project snapshot.
      * Stale / missing ids create a new thread instead.
@@ -86,6 +92,16 @@ export declare function pickProject(projects: Array<{
     title: string;
     workspaceRoot: string;
 };
+/**
+ * Pick provider/model for a new thread.
+ *
+ * 1. Explicit `configured` (plugin / env) wins.
+ * 2. Else reuse a same-project thread whose `instanceId` matches the preferred
+ *    default (`cursor`) so settings like Cursor Auto are preserved.
+ * 3. Else {@link DEFAULT_MODEL_SELECTION} — never copy an arbitrary first thread
+ *    (that previously inherited disabled providers such as Codex).
+ */
+export declare function resolveModelSelection(threads: ShellSnapshot["threads"], projectId: string, configured?: T3FeedbackModelSelection): T3FeedbackModelSelection;
 /** Authenticate to T3 and start a turn with the feedback envelope. */
 export declare function sendFeedbackToT3(envelope: FeedbackEnvelope, options: T3BridgeOptions): Promise<FeedbackSendResult>;
 /** List non-archived threads for the matched T3 project (continue picker). */

package/dist/bridge/sendFeedback.js

@@ -1,5 +1,6 @@
 import { spawnSync } from "node:child_process";
 import WebSocket from "ws";
+import { DEFAULT_MODEL_SELECTION, normalizeModelSelection } from "../types.js";
 import { dataUrlSizeBytes, envelopeImageAttachments } from "./attachments.js";
 import { buildPairOpenUrl, buildThreadOpenUrl, deriveThreadTitle, formatFeedbackMessage, normalizeOrigin, resolveOpenOrigin, } from "./format.js";
 import { isShellThreadArchived, listItemStateFromShellThread } from "./probeThreads.js";
@@ -251,16 +252,32 @@ export function pickProject(projects, hints) {
         return projects[0];
     throw new Error("No T3 projects available");
 }
+/**
+ * Pick provider/model for a new thread.
+ *
+ * 1. Explicit `configured` (plugin / env) wins.
+ * 2. Else reuse a same-project thread whose `instanceId` matches the preferred
+ *    default (`cursor`) so settings like Cursor Auto are preserved.
+ * 3. Else {@link DEFAULT_MODEL_SELECTION} — never copy an arbitrary first thread
+ *    (that previously inherited disabled providers such as Codex).
+ */
+export function resolveModelSelection(threads, projectId, configured) {
+    const explicit = normalizeModelSelection(configured);
+    if (explicit)
+        return explicit;
+    const preferredInstance = DEFAULT_MODEL_SELECTION.instanceId;
+    const projectThreads = threads.filter((t) => t.projectId === projectId);
+    const matching = projectThreads.find((t) => t.modelSelection?.instanceId?.trim() === preferredInstance);
+    const inherited = normalizeModelSelection(matching?.modelSelection);
+    if (inherited)
+        return inherited;
+    return { ...DEFAULT_MODEL_SELECTION };
+}
 /** Authenticate to T3 and start a turn with the feedback envelope. */
 export async function sendFeedbackToT3(envelope, options) {
     return withShellClient(options, async (client, snapshot) => {
         const project = pickProject(snapshot.projects, options.workspaceRootHints);
-        const modelSelection = snapshot.threads.find((t) => t.projectId === project.id)
-            ?.modelSelection ??
-            snapshot.threads[0]?.modelSelection ?? {
-            instanceId: "cursor",
-            model: "default",
-        };
+        const modelSelection = resolveModelSelection(snapshot.threads, project.id, options.modelSelection);
         const branch = snapshot.threads.find((t) => t.projectId === project.id)?.branch ?? null;
         const existing = options.threadId
             ? snapshot.threads.find((t) => t.id === options.threadId && t.projectId === project.id)

package/dist/client/index.d.ts

@@ -21,4 +21,4 @@ export { SESSION_THREAD_TTL_MS, defaultThreadDestination, readSessionThreadId, r
 export { createT3FeedbackHttpTransport, type T3FeedbackHttpTransportOptions } from "./transport.js";
 export { T3_OPEN_WINDOW_NAME, T3_PAIR_THEN_THREAD_DELAY_MS, fetchOpenHandoff, openInT3Seamless, shouldBypassSeamlessOpen, type OpenInT3SeamlessOptions, } from "./openInT3.js";
 export type { FeedbackSendResult, ThreadListItem, ThreadProbeResult, ThreadProbeState, ThreadsListResponse, ThreadsProbeResponse, T3BuiltinPluginId, T3FeedbackAfterPick, T3FeedbackBuiltinPluginOptions, T3FeedbackFabConfig, T3FeedbackFabOptions, T3FeedbackFabPosition, T3FeedbackFabVisibility, T3FeedbackOpenHandoff, T3FeedbackOpenInEditorConfig, T3FeedbackOpenInEditorOptions, T3FeedbackPickConfig, T3FeedbackPickOptions, T3FeedbackRecordConfig, T3FeedbackRecordOptions, T3FeedbackReportTypeGlyph, T3FeedbackReportTypeGlyphCustom, T3FeedbackReportTypeGlyphMap, T3FeedbackReportTypeGlyphResolved, T3FeedbackScreenshotConfig, T3FeedbackScreenshotCrop, T3FeedbackScreenshotOptions, T3FeedbackShortcutConfig, T3FeedbackShortcutOptions, T3FeedbackThreadReuse, } from "../types.js";
-export { DEFAULT_OPEN_IN_EDITOR_ENDPOINT, DEFAULT_PICK_SHORTCUT, DEFAULT_RECORD_SHORTCUT, DEFAULT_REPORT_TYPE_EMOJIS, DEFAULT_REPORT_TYPE_GLYPH, DEFAULT_SCREENSHOT_SHORTCUT, DEFAULT_SHORTCUT, T3_BUILTIN_PLUGIN_IDS, formatShortcutLabel, isEditableKeyboardTarget, matchesBareKeyOverride, matchesShortcut, resolveActivePluginList, resolveActivePlugins, resolveOpenInEditorConfig, resolvePickConfig, resolveRecordConfig, resolveReportTypeGlyph, resolveScreenshotConfig, resolveShortcut, shortcutRequiresModifier, shouldOpenFromShortcut, } from "../types.js";
+export { DEFAULT_OPEN_IN_EDITOR_ENDPOINT, DEFAULT_PICK_SHORTCUT, DEFAULT_RECORD_SHORTCUT, DEFAULT_REPORT_TYPE_EMOJIS, DEFAULT_REPORT_TYPE_GLYPH, DEFAULT_SCREENSHOT_SHORTCUT, DEFAULT_SHORTCUT, T3_BUILTIN_PLUGIN_IDS, formatShortcutLabel, isEditableKeyboardTarget, matchesBareKeyOverride, matchesShortcut, resolveActivePluginList, resolveActivePlugins, resolveOpenInEditorConfig, resolveOpenInEditorEndpointForApi, resolvePickConfig, resolveRecordConfig, resolveReportTypeGlyph, resolveScreenshotConfig, resolveShortcut, shortcutRequiresModifier, shouldOpenFromShortcut, } from "../types.js";