@insitue/capture-core 0.1.0 → 0.2.0

package/dist/index.d.ts

@@ -47,7 +47,7 @@ declare const CAPTURE_SCHEMA_VERSION: 3;
 /** Bump when the WS envelope below changes; companion/SDK pin it.
  *  v2: agent edit-loop messages (M2). v3: session undo/commit (M3).
  *  v4: agent-activity (M6 — live "what it's doing" feedback). */
-declare const PROTOCOL_VERSION: 4;
+declare const PROTOCOL_VERSION: 5;
 interface SourceLoc {
     /** Repo-relative POSIX path, e.g. `components/MainBar.tsx`. */
     file: string;
@@ -343,9 +343,38 @@ interface AgentSessionCommittedMsg {
     commit: string;
     files: string[];
 }
+/** Browser → companion: user clicked Send in the overlay's ASK
+ *  textbox AND a CLI/MCP subscriber is attached. Companion
+ *  re-broadcasts as `broadcast-ask` to subscribers and does NOT
+ *  spawn its own headless agent. */
+interface AgentAskExternalMsg {
+    t: "agent-ask-external";
+    turnId: string;
+    bundleId: string;
+    text: string;
+}
+/** Companion → CLI/MCP subscribers: a browser just sent an external
+ *  ask. Joined with the matching `broadcast-capture` by `bundleId`
+ *  in the subscriber (the MCP bridge holds picks for a few seconds
+ *  so the ask catches up). */
+interface BroadcastAskMsg {
+    t: "broadcast-ask";
+    bundleId: string;
+    text: string;
+    at: string;
+}
+/** Companion → browser: how many CLI/MCP subscribers are currently
+ *  attached. Pushed on every connect + disconnect so the overlay
+ *  can show/hide the "→ claude in terminal" badge and route Send
+ *  accordingly. count=0 means "no external agent attached — Send
+ *  goes to the in-overlay headless agent (today's behavior)". */
+interface SubscribersAttachedMsg {
+    t: "subscribers-attached";
+    count: number;
+}
 /** Client→server messages. */
-type ClientMessage = HelloMsg | PingMsg | CaptureSubmitMsg | AgentTurnMsg | AgentDecisionMsg | AgentCancelMsg | AgentUndoMsg | AgentUndoSessionMsg | AgentCommitSessionMsg;
+type ClientMessage = HelloMsg | PingMsg | CaptureSubmitMsg | AgentTurnMsg | AgentAskExternalMsg | AgentDecisionMsg | AgentCancelMsg | AgentUndoMsg | AgentUndoSessionMsg | AgentCommitSessionMsg;
 /** Server→client messages. */
-type ServerMessage = HelloOkMsg | PongMsg | ErrorMsg | CaptureResolvedMsg | AgentStatusMsg | AgentStreamMsg | ChangesetProposedMsg | ChangesetAppliedMsg | AgentUndoneMsg | AgentSessionUndoneMsg | AgentSessionCommittedMsg;
+type ServerMessage = HelloOkMsg | PongMsg | ErrorMsg | CaptureResolvedMsg | AgentStatusMsg | AgentStreamMsg | ChangesetProposedMsg | ChangesetAppliedMsg | AgentUndoneMsg | AgentSessionUndoneMsg | AgentSessionCommittedMsg | SubscribersAttachedMsg;
 
-export { type AgentCancelMsg, type AgentCommitSessionMsg, type AgentDecisionMsg, type AgentErrorCode, type AgentEvent, type AgentSessionCommittedMsg, type AgentSessionUndoneMsg, type AgentStatusMsg, type AgentStreamMsg, type AgentTurnMsg, type AgentUndoMsg, type AgentUndoSessionMsg, type AgentUndoneMsg, CAPTURE_SCHEMA_VERSION, type CaptureBundle, type CaptureCore, type CaptureResolvedMsg, type CaptureSink, type CaptureSubmitMsg, type CaptureTarget, type ChangesetAppliedMsg, type ChangesetProposedMsg, type ClientMessage, type ConsoleEntry, type ErrorMsg, type HelloMsg, type HelloOkMsg, type IssueDraft, IssueTrackerSink, type NetworkEntry, PROTOCOL_VERSION, type PingMsg, type PongMsg, type ProposedEdit, type ResolvedSource, type RuntimeError, type SelectionInput, type SelectionMode, type SerializedNode, type ServerMessage, type SourceConfidence, type SourceLoc, breakpointFor, buildSelector, curateComputedStyles, extractTailwindClasses, resolveTarget, serializeNode, toIssueDraft };
+export { type AgentAskExternalMsg, type AgentCancelMsg, type AgentCommitSessionMsg, type AgentDecisionMsg, type AgentErrorCode, type AgentEvent, type AgentSessionCommittedMsg, type AgentSessionUndoneMsg, type AgentStatusMsg, type AgentStreamMsg, type AgentTurnMsg, type AgentUndoMsg, type AgentUndoSessionMsg, type AgentUndoneMsg, type BroadcastAskMsg, CAPTURE_SCHEMA_VERSION, type CaptureBundle, type CaptureCore, type CaptureResolvedMsg, type CaptureSink, type CaptureSubmitMsg, type CaptureTarget, type ChangesetAppliedMsg, type ChangesetProposedMsg, type ClientMessage, type ConsoleEntry, type ErrorMsg, type HelloMsg, type HelloOkMsg, type IssueDraft, IssueTrackerSink, type NetworkEntry, PROTOCOL_VERSION, type PingMsg, type PongMsg, type ProposedEdit, type ResolvedSource, type RuntimeError, type SelectionInput, type SelectionMode, type SerializedNode, type ServerMessage, type SourceConfidence, type SourceLoc, type SubscribersAttachedMsg, breakpointFor, buildSelector, curateComputedStyles, extractTailwindClasses, resolveTarget, serializeNode, toIssueDraft };

package/dist/index.js

@@ -188,7 +188,7 @@ function resolveTarget(el) {
 
 // src/index.ts
 var CAPTURE_SCHEMA_VERSION = 3;
-var PROTOCOL_VERSION = 4;
+var PROTOCOL_VERSION = 5;
 function toIssueDraft(bundle) {
   const t = bundle.target;
   const where = t?.source ? `\`${t.source.file}:${t.source.line}\` (${t.confidence})` : t ? `\`${t.selector}\` (selector-only \u2014 no source resolver)` : "(empty selection)";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@insitue/capture-core",
-  "version": "0.1.0",
+  "version": "0.2.0",
   "type": "module",
   "publishConfig": {
     "access": "public"