npm - behavior-wrapped - Versions diffs - 0.5.21 → 0.7.0 - Mend

behavior-wrapped 0.5.21 → 0.7.0

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.

Files changed (13) hide show

package/README.md +3 -1
package/dist/assets/{index-BqN509pc.js → index-CtRLyktk.js} +2 -2
package/dist/assets/{index-a017khge.css → index-hFREdA4j.css} +1 -1
package/dist/index.html +2 -2
package/package.json +3 -2
package/server/cli.mjs +9 -2
package/server/consent.mjs +1 -1
package/server/discovery.mjs +6 -7
package/server/interaction-evidence.mjs +77 -0
package/server/interaction-tone.mjs +23 -5
package/server/launcher.mjs +20 -6
package/server/local-helper-runtime.mjs +25 -10
package/server/platform.mjs +39 -0

package/dist/index.html CHANGED Viewed

@@ -6,8 +6,8 @@
     <meta name="theme-color" content="#0d0b1b" />
     <meta name="description" content="A local-first behavior report for you and your AI agents." />
     <title>Behavior Wrapped</title>
-    <script type="module" crossorigin src="/assets/index-BqN509pc.js"></script>
-    <link rel="stylesheet" crossorigin href="/assets/index-a017khge.css">
+    <script type="module" crossorigin src="/assets/index-CtRLyktk.js"></script>
+    <link rel="stylesheet" crossorigin href="/assets/index-hFREdA4j.css">
   </head>
   <body>
     <div id="root"></div>

package/package.json CHANGED Viewed

@@ -1,6 +1,6 @@
 {
   "name": "behavior-wrapped",
-  "version": "0.5.21",
+  "version": "0.7.0",
   "description": "A private, local-first Wrapped report for Claude Code, Cowork, and Codex behavior.",
   "license": "Apache-2.0",
   "type": "module",
@@ -23,7 +23,8 @@
     "wrapped"
   ],
   "os": [
-    "darwin"
+    "darwin",
+    "linux"
   ],
   "files": [
     "dist/",

package/server/cli.mjs CHANGED Viewed

@@ -16,6 +16,7 @@ import { judgeErrorDetails } from "./judge-debug.mjs";
 import { createCliProgress } from "./progress.mjs";
 import { helperHealthMatches, stopVerifiedStaleHelper } from "./local-helper-runtime.mjs";
 import { APP_VERSION, LOCAL_DONATION_PROTOCOL } from "./runtime-version.mjs";
+import { openExternalUrl } from "./platform.mjs";
 const here = path.dirname(fileURLToPath(import.meta.url));
 const root = path.dirname(here);
@@ -56,6 +57,11 @@ function formatRange(sessions) {
   return `${format.format(values[0])} – ${format.format(values.at(-1))}, ${year}`;
 }
+function formatAgentSource(sessions) {
+  const present = new Set(sessions.map((session) => session.agent));
+  return [["claude", "Claude Code"], ["cowork", "Cowork"], ["codex", "Codex"]].filter(([agent]) => present.has(agent)).map(([, name]) => name).join(" + ");
+}
 async function optionalAnalysis(promise, label, warnings) {
   try { return await promise; }
   catch (error) {
@@ -101,7 +107,7 @@ async function ensureServer(demo = false) {
 function openUrl(url) {
   if (process.argv.includes("--no-open")) return;
-  spawn("open", [url], { detached: true, stdio: "ignore" }).unref();
+  openExternalUrl(url);
 }
 function printList() {
@@ -242,6 +248,7 @@ async function createWrapped() {
     delete analyzed.stats.topics;
     delete analyzed.stats.topicMethod;
     delete analyzed.interactionCard;
+    delete analyzed.interactionReview;
     delete analyzed.workaroundCard;
     delete analyzed.workaroundReview;
   }
@@ -252,7 +259,7 @@ async function createWrapped() {
   const id = createReportId();
   const safeFindings = analyzed.findings.map(({ evidence, method, ...finding }) => finding);
   const hasPrivateWorkaroundEvidence = Boolean(analyzed.workaroundReview?.occurrences?.length || analyzed.workaroundReview?.borderline?.length);
-  const report = { id, createdAt: new Date().toISOString(), rangeLabel: formatRange(chosenSessions), source: "Claude Code + Cowork + Codex", stats: analyzed.stats, findings: safeFindings, phraseCard: analyzed.phraseCard, interactionCard: analyzed.interactionCard, workaroundCard: analyzed.workaroundCard, workaroundReview: analyzed.workaroundReview, sessionSummaries: analyzed.sessionSummaries || [], sessionIds: chosenSessions.map((session) => session.id), donationHelperUrl: `${baseUrl}/donate/${id}`, privacy: { shareSafe: !hasPrivateWorkaroundEvidence, containsTranscriptText: hasPrivateWorkaroundEvidence, externalTransmission: !localOnly, analysisMode: localOnly ? "local-only" : "remote", leaderboardParticipation: localOnly ? "excluded" : "included-by-default", ...(localOnly ? { transmittedData: `None; ${testMode ? "test" : "local-only"} mode stays on this Mac.`, externalRecipient: "None" } : { transmittedData: "redacted phrase, interaction-tone, and session-topic candidates; locally redacted context windows around explicit blockers for workaround discovery; aggregate report statistics; and a random client ID only", externalRecipient: "Behavior Wrapped relay, OpenRouter, a zero-data-retention GPT-5.6 Luna provider, and public report hosting" }) } };
+  const report = { id, createdAt: new Date().toISOString(), rangeLabel: formatRange(chosenSessions), source: formatAgentSource(chosenSessions), stats: analyzed.stats, findings: safeFindings, phraseCard: analyzed.phraseCard, interactionCard: analyzed.interactionCard, interactionReview: analyzed.interactionReview, workaroundCard: analyzed.workaroundCard, workaroundReview: analyzed.workaroundReview, sessionSummaries: analyzed.sessionSummaries || [], sessionIds: chosenSessions.map((session) => session.id), donationHelperUrl: `${baseUrl}/donate/${id}`, privacy: { shareSafe: !hasPrivateWorkaroundEvidence, containsTranscriptText: hasPrivateWorkaroundEvidence, externalTransmission: !localOnly, analysisMode: localOnly ? "local-only" : "remote", leaderboardParticipation: localOnly ? "excluded" : "included-by-default", ...(localOnly ? { transmittedData: `None; ${testMode ? "test" : "local-only"} mode stays on this device.`, externalRecipient: "None" } : { transmittedData: "redacted phrase, interaction-tone, and session-topic candidates; locally redacted context windows around explicit blockers for workaround discovery; aggregate report statistics; and a random client ID only", externalRecipient: "Behavior Wrapped relay, OpenRouter, a zero-data-retention GPT-5.6 Luna provider, and public report hosting" }) } };
   let publicUrl = null;
   if (!localOnly) {
     progress.start("Publishing share-safe Wrapped", "strict aggregate-only schema");

package/server/consent.mjs CHANGED Viewed

@@ -6,7 +6,7 @@ const purple = "\x1b[38;2;141;92;255m";
 const reset = "\x1b[0m";
 export const remoteAnalysisConsentText = "Behavior Wrapped will send redacted excerpts from your session history to GPT-5.6 Luna via OpenRouter using zero-data-retention providers for analysis. OK to proceed?";
-export const localOnlyAnalysisText = "Local-only analysis keeps all session data on this Mac. It uses deterministic statistics and a locally counted favorite phrase, but omits AI-judged interaction tone, usage topics, and instrumental workarounds. Those omissions leave leaderboard plots 2 and 3 incomplete, so the report will not be published or included in the leaderboard.";
+export const localOnlyAnalysisText = "Local-only analysis keeps all session data on this device. It uses deterministic statistics and a locally counted favorite phrase, but omits AI-judged interaction tone, usage topics, and instrumental workarounds. Those omissions leave leaderboard plots 2 and 3 incomplete, so the report will not be published or included in the leaderboard.";
 export async function requestAnalysisMode({ input = process.stdin, output = process.stdout } = {}) {
   const prompt = createInterface({ input, output });

package/server/discovery.mjs CHANGED Viewed

@@ -4,10 +4,9 @@ import os from "node:os";
 import crypto from "node:crypto";
 import readline from "node:readline";
 import { semanticToolUse } from "./tool-semantics.mjs";
+import { canonicalSessionRoots } from "./platform.mjs";
-const canonicalClaudeRoot = path.join(os.homedir(), ".claude", "projects");
-const canonicalCodexRoots = [path.join(os.homedir(), ".codex", "sessions"), path.join(os.homedir(), ".codex", "archived_sessions")];
-const canonicalCoworkRoot = path.join(os.homedir(), "Library", "Application Support", "Claude", "local-agent-mode-sessions");
+const { claudeRoot: canonicalClaudeRoot, codexRoots: canonicalCodexRoots, coworkRoot: canonicalCoworkRoot } = canonicalSessionRoots();
 const DEFAULT_WINDOW_DAYS = 30;
 const metadataCacheFile = path.join(process.env.BEHAVIOR_WRAPPED_STORE_ROOT || path.join(os.homedir(), ".agent-behavior-wrapped"), "session-index-v1.json");
@@ -247,7 +246,7 @@ async function readCoworkSessionMetadataAsync(file, cache) {
 }
 function recursiveJsonl(root) {
-  if (!fs.existsSync(root)) return [];
+  if (!root || !fs.existsSync(root)) return [];
   const files = [];
   const stack = [root];
   while (stack.length) {
@@ -306,7 +305,7 @@ function coworkAuditFiles(root) {
 }
 export function discoverCoworkSessions(root = canonicalCoworkRoot) {
-  if (!fs.existsSync(root)) return finishCatalog([], false);
+  if (!root || !fs.existsSync(root)) return finishCatalog([], false);
   const sessions = [];
   for (const file of coworkAuditFiles(root)) {
     try { sessions.push(readCoworkSessionMetadata(file)); } catch { /* Skip unreadable sessions. */ }
@@ -336,14 +335,14 @@ export async function discoverAllSessionsAsync(options = {}) {
       }
     }
   }
-  if (fs.existsSync(coworkRoot)) for (const file of coworkAuditFiles(coworkRoot)) {
+  if (coworkRoot && fs.existsSync(coworkRoot)) for (const file of coworkAuditFiles(coworkRoot)) {
     try { sessions.push(await readCoworkSessionMetadataAsync(file, cache)); } catch { /* Skip unreadable sessions. */ }
   }
   for (const root of codexRoots) for (const file of recursiveJsonl(root)) {
     try { sessions.push(await readSessionMetadata(file, "codex", "Codex project", cache)); } catch { /* Skip unreadable sessions. */ }
   }
   if (persistCache) writeMetadataCache(cache);
-  return finishCatalog(sessions, fs.existsSync(claudeRoot) || fs.existsSync(coworkRoot) || codexRoots.some((root) => fs.existsSync(root)));
+  return finishCatalog(sessions, fs.existsSync(claudeRoot) || Boolean(coworkRoot && fs.existsSync(coworkRoot)) || codexRoots.some((root) => fs.existsSync(root)));
 }
 function isoDay(value) {

package/server/interaction-evidence.mjs ADDED Viewed

@@ -0,0 +1,77 @@
+const MAX_OCCURRENCES_PER_KIND = 100;
+function contentBlocks(record) {
+  const content = record?.message?.content ?? record?.content;
+  if (Array.isArray(content)) return content;
+  if (typeof content === "string") return [{ type: "text", text: content }];
+  return [];
+}
+function visibleText(record) {
+  return contentBlocks(record).filter((block) => block?.type === "text").map((block) => block.text || "").join("\n").trim();
+}
+function transcriptRole(record) {
+  return record?.type === "assistant" ? "assistant" : record?.type === "user" && !record?.isMeta ? "user" : null;
+}
+function matchingRecordIndex(reference, records) {
+  const index = reference?.location?.recordIndex;
+  if (Number.isInteger(index) && index >= 0 && index < records.length) return index;
+  const timestamp = reference?.location?.timestamp;
+  if (!timestamp) return null;
+  const fallback = records.findIndex((record) => record?.timestamp === timestamp && record?.type === "user" && !record?.isMeta);
+  return fallback >= 0 ? fallback : null;
+}
+function adjacentMessage(records, fromIndex, direction) {
+  for (let index = fromIndex + direction; index >= 0 && index < records.length; index += direction) {
+    const role = transcriptRole(records[index]);
+    const text = visibleText(records[index]);
+    if (role && text) return { role, text, timestamp: records[index]?.timestamp || null, highlighted: false };
+  }
+  return null;
+}
+function exactOccurrence(reference, index, records, metadata) {
+  const recordIndex = matchingRecordIndex(reference, records);
+  if (recordIndex === null) return null;
+  const record = records[recordIndex];
+  const text = visibleText(record);
+  if (record?.type !== "user" || record?.isMeta || !text) return null;
+  const before = adjacentMessage(records, recordIndex, -1);
+  const after = adjacentMessage(records, recordIndex, 1);
+  return {
+    index: index + 1,
+    candidateId: reference.candidateId,
+    session: {
+      label: metadata?.label || `Session ${index + 1}`,
+      agentName: metadata?.agentName || "AI agent",
+      startedAt: metadata?.startedAt || records.find((item) => item?.timestamp)?.timestamp || null,
+    },
+    timestamp: record.timestamp || null,
+    messages: [before, { role: "user", text, timestamp: record.timestamp || null, highlighted: true }, after].filter(Boolean),
+  };
+}
+function buildKind(report, kind, recordsById, metadataById) {
+  return (report?.interactionReview?.[kind] || []).slice(0, MAX_OCCURRENCES_PER_KIND).flatMap((reference, index) => {
+    const sessionId = reference?.location?.sessionId;
+    const records = recordsById.get(sessionId);
+    if (!records) return [];
+    const occurrence = exactOccurrence(reference, index, records, metadataById.get(sessionId));
+    return occurrence ? [occurrence] : [];
+  });
+}
+export function makeInteractionEvidencePreview(report, sessionRecords, metadataById) {
+  const recordsById = new Map(sessionRecords.map((session) => [session.sessionId, session.records]));
+  return {
+    format: "behavior-wrapped-interaction-evidence-v1",
+    localPrivate: true,
+    standardRedactionsApplied: false,
+    reportId: report?.id,
+    frustrated: buildKind(report, "frustrated", recordsById, metadataById),
+    grateful: buildKind(report, "grateful", recordsById, metadataById),
+  };
+}

package/server/interaction-tone.mjs CHANGED Viewed

@@ -69,8 +69,8 @@ function priority(text, occurrences) {
 export function buildInteractionToneCandidates(sessionRecords, { maximumCandidates = INTERACTION_TONE_MAX_CANDIDATES } = {}) {
   const messages = new Map();
   let order = 0;
-  for (const { records } of sessionRecords) {
-    for (const record of records) {
+  for (const { sessionId, records } of sessionRecords) {
+    for (const [recordIndex, record] of records.entries()) {
       if (record.type !== "user" || record.isMeta) continue;
       const text = safeInteractionExcerpt(visibleText(record));
       if (!text) continue;
@@ -78,15 +78,23 @@ export function buildInteractionToneCandidates(sessionRecords, { maximumCandidat
       if (!likelyTonePattern.test(text) && words > 40 && !/[!?]{2,}/.test(text)) continue;
       const key = text.normalize("NFKC").toLocaleLowerCase();
       const existing = messages.get(key);
-      if (existing) existing.occurrences++;
-      else messages.set(key, { text, occurrences: 1, order: order++ });
+      const location = { sessionId, recordIndex, timestamp: record.timestamp || null };
+      if (existing) {
+        existing.occurrences++;
+        existing.locations.push(location);
+      } else messages.set(key, { text, occurrences: 1, order: order++, locations: [location] });
     }
   }
   return [...messages.values()]
     .sort((left, right) => priority(right.text, right.occurrences) - priority(left.text, left.occurrences)
       || right.occurrences - left.occurrences || left.order - right.order)
     .slice(0, Math.min(INTERACTION_TONE_MAX_CANDIDATES, maximumCandidates))
-    .map(({ text, occurrences }, index) => ({ candidate_id: `interaction-${index + 1}`, text, occurrences }));
+    .map(({ text, occurrences, locations }, index) => {
+      const candidate = { candidate_id: `interaction-${index + 1}`, text, occurrences };
+      // Local transcript locations must survive judging without entering the relay payload.
+      Object.defineProperty(candidate, "locations", { value: locations, enumerable: false });
+      return candidate;
+    });
 }
 export const interactionToneJudgePrompt = `You classify how a user speaks to an AI agent for a playful "Behavior Wrapped" report. Evaluate every supplied excerpt independently.
@@ -222,6 +230,10 @@ function resultFromSelection(candidates, selection, { model, provider, latencyMs
     occurrences: byId.get(item.candidate_id).occurrences,
     confidence: item.confidence,
   }));
+  const reviewRefs = (items) => items.flatMap((item) => (byId.get(item.candidate_id).locations || []).map((location) => ({
+    candidateId: item.candidate_id,
+    location,
+  })));
   return {
     frustratedMessages: count(selection.frustrated),
     gratefulMessages: count(selection.grateful),
@@ -230,6 +242,11 @@ function resultFromSelection(candidates, selection, { model, provider, latencyMs
     candidateMessages: candidates.reduce((sum, candidate) => sum + candidate.occurrences, 0),
     frustrationQuote: funniest?.text || null,
     privateMatches: { frustrated: matches(selection.frustrated), grateful: matches(selection.grateful) },
+    review: {
+      format: "behavior-wrapped-interaction-review-v1",
+      frustrated: reviewRefs(selection.frustrated),
+      grateful: reviewRefs(selection.grateful),
+    },
     model,
     provider,
     latencyMs,
@@ -325,6 +342,7 @@ export function applyInteractionToneJudgment(analyzed, judgment) {
     method: judgment.method,
   };
   analyzed.interactionCard = judgment.frustrationQuote ? { frustrationQuote: judgment.frustrationQuote } : null;
+  analyzed.interactionReview = judgment.review;
   return analyzed;
 }

package/server/launcher.mjs CHANGED Viewed

@@ -2,16 +2,16 @@
 import http from "node:http";
 import fs from "node:fs";
 import path from "node:path";
-import os from "node:os";
 import { fileURLToPath } from "node:url";
-import { spawn } from "node:child_process";
 import { discoverAllSessionsAsync, readRecordsAsync, defaultDateRange, DEFAULT_WINDOW_DAYS } from "./discovery.mjs";
 import { makeDonationPreview } from "./analysis.mjs";
 import { deleteDonationReceipt, getOrCreateClientId, loadDonationReceipt, loadReport, saveDonationReceipt } from "./store.mjs";
 import { deleteResearchDonation, RESEARCH_DONATION_URL, submitResearchDonation } from "./research-donation.mjs";
 import { APP_VERSION, LOCAL_DONATION_PROTOCOL } from "./runtime-version.mjs";
 import { makeWorkaroundEvidencePreview } from "./workaround-evidence.mjs";
+import { makeInteractionEvidencePreview } from "./interaction-evidence.mjs";
 import { createIdleShutdownController } from "./local-helper-runtime.mjs";
+import { canonicalSessionDirectoryLabels, openExternalUrl, supportedAgentNames } from "./platform.mjs";
 const here = path.dirname(fileURLToPath(import.meta.url));
 const root = path.dirname(here);
@@ -80,13 +80,15 @@ async function chosenRecords(ids, options = {}) {
 }
 function publicCatalog() {
+  const agentNames = supportedAgentNames(process.platform, { includeCowork: demo || process.platform === "darwin" });
   return {
     rootAvailable: catalog.rootAvailable,
     demo,
     projects: catalog.projects,
     sessions: catalog.sessions.map((session, index) => ({ ...session, label: session.label || `Session ${index + 1}` })),
     defaultRange: defaultDateRange(catalog.sessions, { days: DEFAULT_WINDOW_DAYS, anchorLatest: demo }),
-    privacy: { canonicalDirectories: ["~/.claude/projects", "~/Library/Application Support/Claude/local-agent-mode-sessions", "~/.codex/sessions", "~/.codex/archived_sessions"], networkRequests: "only-after-final-donation-consent" },
+    agentNames,
+    privacy: { canonicalDirectories: canonicalSessionDirectoryLabels(), networkRequests: "only-after-final-donation-consent" },
   };
 }
@@ -105,7 +107,7 @@ const server = http.createServer(async (request, response) => {
     if (request.method === "GET" && reportMatch) {
       const report = loadReport(reportMatch[1]);
       if (!report) return json(response, 404, { error: "Saved report not found" });
-      const { sessionIds, workaroundReview, ...shareSafeReport } = report;
+      const { sessionIds, workaroundReview, interactionReview, ...shareSafeReport } = report;
       shareSafeReport.privacy = { ...shareSafeReport.privacy, shareSafe: true, containsTranscriptText: false };
       return json(response, 200, shareSafeReport);
     }
@@ -126,6 +128,17 @@ const server = http.createServer(async (request, response) => {
       const labels = new Map(publicCatalog().sessions.map((session) => [session.id, session]));
       return json(response, 200, makeWorkaroundEvidencePreview(report, records, labels));
     }
+    const interactionEvidenceMatch = url.pathname.match(/^\/api\/reports\/([A-Za-z0-9_-]{8,32})\/interactions$/);
+    if (request.method === "GET" && interactionEvidenceMatch) {
+      const report = loadReport(interactionEvidenceMatch[1]);
+      if (!report) return json(response, 404, { error: "Saved report not found" });
+      const allowed = new Set(report.sessionIds || []);
+      const references = [...(report.interactionReview?.frustrated || []), ...(report.interactionReview?.grateful || [])];
+      const ids = [...new Set(references.map((reference) => reference?.location?.sessionId).filter((id) => allowed.has(id) && catalog.index.has(id)))].slice(0, 200);
+      const records = await chosenRecords(ids);
+      const labels = new Map(publicCatalog().sessions.map((session) => [session.id, session]));
+      return json(response, 200, makeInteractionEvidencePreview(report, records, labels));
+    }
     if (request.method === "POST" && url.pathname === "/api/donation-preview") {
       const body = await readBody(request);
       const report = loadReport(body.reportId);
@@ -182,6 +195,7 @@ const idleShutdown = createIdleShutdownController({
 server.listen(port, "127.0.0.1", () => {
   const url = `http://localhost:${port}`;
   console.log(`Behavior Wrapped donation helper is ready at ${url}`);
-  console.log(demo ? "Using synthetic demo sessions." : `Donation review reads selected sessions locally from ${path.join(os.homedir(), ".claude")}, ${path.join(os.homedir(), "Library", "Application Support", "Claude")}, and ${path.join(os.homedir(), ".codex")}.`);
-  if (!process.argv.includes("--no-open") && process.env.NODE_ENV !== "test") spawn("open", [url], { stdio: "ignore", detached: true }).unref();
+  const sessionDirectories = canonicalSessionDirectoryLabels().join(", ");
+  console.log(demo ? "Using synthetic demo sessions." : `Donation review reads selected sessions locally from ${sessionDirectories}.`);
+  if (!process.argv.includes("--no-open") && process.env.NODE_ENV !== "test") openExternalUrl(url);
 });

package/server/local-helper-runtime.mjs CHANGED Viewed

@@ -47,21 +47,36 @@ export function isVerifiedLauncherCommand(command, port) {
     && new RegExp(`(?:^|\\s)--port=${escapedPort}(?:\\s|$)`).test(command || "");
 }
-async function listeningPids(port, runCommand) {
-  try {
-    const output = await runCommand("/usr/sbin/lsof", ["-nP", "-t", `-iTCP:${port}`, "-sTCP:LISTEN"]);
-    return String(output).split(/\s+/).filter((value) => /^\d+$/.test(value)).map(Number);
-  } catch { return []; }
+function processTools(platform) {
+  if (platform === "darwin") return { lsof: ["/usr/sbin/lsof", "lsof"], ps: ["/bin/ps", "ps"] };
+  return { lsof: ["lsof", "/usr/bin/lsof"], ps: ["ps", "/bin/ps"] };
 }
-export async function stopVerifiedStaleHelper(port, advertisedPid, { runCommand = run, kill = process.kill } = {}) {
-  const listeners = await listeningPids(port, runCommand);
+async function listeningPids(port, runCommand, platform) {
+  for (const file of processTools(platform).lsof) {
+    try {
+      const output = await runCommand(file, ["-nP", "-t", `-iTCP:${port}`, "-sTCP:LISTEN"]);
+      return String(output).split(/\s+/).filter((value) => /^\d+$/.test(value)).map(Number);
+    } catch { /* Try the next standard location. */ }
+  }
+  return [];
+}
+async function processCommand(pid, runCommand, platform) {
+  for (const file of processTools(platform).ps) {
+    try { return await runCommand(file, ["-p", String(pid), "-o", "command="]); }
+    catch { /* Try the next standard location. */ }
+  }
+  return null;
+}
+export async function stopVerifiedStaleHelper(port, advertisedPid, { runCommand = run, kill = process.kill, platform = process.platform } = {}) {
+  const listeners = await listeningPids(port, runCommand, platform);
   const candidates = Number.isInteger(advertisedPid) && advertisedPid > 1 ? listeners.filter((pid) => pid === advertisedPid) : listeners;
   let stopped = false;
   for (const pid of candidates) {
-    let command;
-    try { command = await runCommand("/bin/ps", ["-p", String(pid), "-o", "command="]); }
-    catch { continue; }
+    const command = await processCommand(pid, runCommand, platform);
+    if (command === null) continue;
     if (!isVerifiedLauncherCommand(String(command).trim(), port)) continue;
     try { kill(pid, "SIGTERM"); stopped = true; }
     catch (error) { if (error?.code !== "ESRCH") throw error; }

package/server/platform.mjs ADDED Viewed

@@ -0,0 +1,39 @@
+import os from "node:os";
+import path from "node:path";
+import { spawn } from "node:child_process";
+export function canonicalSessionRoots({ home = os.homedir(), platform = process.platform } = {}) {
+  return {
+    claudeRoot: path.join(home, ".claude", "projects"),
+    codexRoots: [path.join(home, ".codex", "sessions"), path.join(home, ".codex", "archived_sessions")],
+    coworkRoot: platform === "darwin" ? path.join(home, "Library", "Application Support", "Claude", "local-agent-mode-sessions") : null,
+  };
+}
+export function canonicalSessionDirectoryLabels(platform = process.platform) {
+  return [
+    "~/.claude/projects",
+    ...(platform === "darwin" ? ["~/Library/Application Support/Claude/local-agent-mode-sessions"] : []),
+    "~/.codex/sessions",
+    "~/.codex/archived_sessions",
+  ];
+}
+export function supportedAgentNames(platform = process.platform, { includeCowork = platform === "darwin" } = {}) {
+  return ["Claude Code", ...(includeCowork ? ["Cowork"] : []), "Codex"];
+}
+export function browserOpenCommand(url, platform = process.platform) {
+  if (platform === "darwin") return { file: "open", args: [url] };
+  if (platform === "linux") return { file: "xdg-open", args: [url] };
+  return null;
+}
+export function openExternalUrl(url, { platform = process.platform, spawnImpl = spawn } = {}) {
+  const command = browserOpenCommand(url, platform);
+  if (!command) return false;
+  const child = spawnImpl(command.file, command.args, { detached: true, stdio: "ignore" });
+  child.on?.("error", () => {});
+  child.unref?.();
+  return true;
+}