@somacheck/vibecheck 0.6.11 → 0.6.12

package/README.md

@@ -9,13 +9,14 @@ Your agent has your context. It does not have your gut. This is the bridge.
 
 Fair. Here is what you need, without executing anything.
 
-**What the `link` command does.** `npx -y @somacheck/vibecheck@0.6.11 link <CODE> --client <CLIENT>`
+**What the `link` command does.** `npx -y @somacheck/vibecheck@0.6.12 link <CODE> --client <CLIENT>`
 exchanges a short-lived pairing code, generated inside the SomaCheck iOS app, for
 a bearer token. It writes that token to `~/.sensie/config.json` with mode `0600`,
 offers to configure supported agent clients found on the computer, and checks the
 connection without printing the token. For Claude Code it also installs an
-inspectable user-scoped SomaCheck plugin that can wake the same open session when
-the phone result arrives. Setup is not reported ready until the
+inspectable user-scoped SomaCheck plugin and registers the local MCP server as
+a Channel so a phone result can enter the same open conversation as a new
+event. Setup is not reported ready until the
 selected client has the exact pinned `vibecheck` MCP registration, the backend
 accepts protocol `5` / toolset `vibecheck-0.6`, and both status and context
 probes succeed. It contacts exactly one network host: the Supabase project below.
@@ -97,9 +98,9 @@ before the pairing code is redeemed.
 To configure or repair a client later:
 
 ```text
-npx -y @somacheck/vibecheck@0.6.11 setup codex
-npx -y @somacheck/vibecheck@0.6.11 setup claude
-npx -y @somacheck/vibecheck@0.6.11 doctor
+npx -y @somacheck/vibecheck@0.6.12 setup codex
+npx -y @somacheck/vibecheck@0.6.12 setup claude
+npx -y @somacheck/vibecheck@0.6.12 doctor
 ```
 
 Manual registration remains available:
@@ -109,13 +110,25 @@ Manual registration remains available:
      "mcpServers": {
        "vibecheck": {
          "command": "npx",
-        "args": ["-y", "@somacheck/vibecheck@0.6.11", "serve", "--client", "codex"]
+        "args": ["-y", "@somacheck/vibecheck@0.6.12", "serve", "--client", "codex"]
        }
      }
    }
    ```
 
-   For Claude Code: `claude mcp add --scope user vibecheck -- npx -y @somacheck/vibecheck@0.6.11 serve --client claude`
+   For Claude Code: `claude mcp add --scope user vibecheck -- npx -y @somacheck/vibecheck@0.6.12 serve --client claude --channel`
+
+Claude Channels are currently an Anthropic research preview. Until Anthropic
+approves SomaCheck on its channel allowlist, start Claude Code with:
+
+```text
+claude --dangerously-load-development-channels server:vibecheck
+```
+
+Keep that Claude Code session open. Channel events are queued while Claude is
+busy, but a closed session cannot receive them. Claude does not acknowledge
+channel notifications, so retain the stable `live:<uuid>` request handle as a
+manual recovery path.
 
 The link step writes only the bearer token in `~/.sensie/config.json`. The client
 setup step asks Codex or Claude to add the pinned MCP command to that client's own
@@ -275,14 +288,22 @@ cancellation stops result reads and preserves the backend request and
 idempotency key, but the cancelled MCP transport may suppress that pending
 response.
 
-Standard MCP cannot start a new agent turn after a tool call has ended. The
-Claude setup therefore installs a normal user-scoped plugin with an async
-`PostToolUse` hook. When `request_vibecheck` returns pending, that hook follows
-only the exact request and wakes the same open Claude Code session when the
-answer, expiry, or cancellation arrives. It passes the constrained result and
-opaque handle, never the statement or link token, and cannot create another
-phone request. No experimental launch flag is required. Restart Claude Code
-once after setup so it loads the plugin.
+Claude Code is the primary local experience. Its registered stdio server
+advertises Anthropic's experimental Channel capability. When
+`request_vibecheck` returns pending, the same local server follows only that
+exact request and emits one `notifications/claude/channel` event when the
+answer, expiry, or cancellation arrives. Claude receives the constrained
+result as conversation input and can continue without another user message.
+The event contains the binary reading, confidence, lifecycle, and opaque
+handle—never the statement, link token, raw motion, or an instruction that
+turns the result into authorization.
+
+The installed `PostToolUse` hook remains a compatibility fallback for an
+ordinary non-channel registration. A channel-armed response marks its
+continuation transport explicitly, and the hook abstains, so two watchers
+cannot wake the same turn. During Anthropic's research preview, the channel
+session must be launched with the command above; a closed or non-enabled
+session may silently drop the event.
 
 Other standard MCP hosts retain the bounded tool response and stable-handle
 fallback until they provide an equivalent supported wake mechanism. This

package/claude-marketplace/.claude-plugin/marketplace.json

@@ -10,7 +10,7 @@
       "name": "vibecheck",
       "source": "./plugins/vibecheck",
       "description": "Let Claude offer a vibecheck and continue when the phone result arrives.",
-      "version": "0.6.11",
+      "version": "0.6.12",
       "author": {
         "name": "Sensie",
         "email": "agents@joinsensie.com"

package/claude-marketplace/plugins/vibecheck/.claude-plugin/plugin.json

@@ -1,7 +1,7 @@
 {
   "name": "vibecheck",
   "description": "Let Claude offer a SomaCheck vibecheck and continue when the phone result arrives.",
-  "version": "0.6.11",
+  "version": "0.6.12",
   "author": {
     "name": "Sensie",
     "email": "agents@joinsensie.com"

package/claude-marketplace/plugins/vibecheck/hooks/hooks.json

@@ -7,7 +7,7 @@
         "hooks": [
           {
             "type": "command",
-            "command": "npx -y @somacheck/vibecheck@0.6.11 claude-hook await-result",
+            "command": "npx -y @somacheck/vibecheck@0.6.12 claude-hook await-result",
             "asyncRewake": true,
             "timeout": 900
           }

package/dist/claude-hook.js

@@ -21,6 +21,10 @@ export function parsePendingClaudeAsk(input) {
     const structured = record(response.structuredContent ?? response.structured_content ?? response);
     if (structured.state !== "pending" || typeof structured.request_id !== "string")
         return null;
+    // The channel-enabled local server already owns this exact result watch.
+    // Abstaining prevents the PostToolUse fallback from waking Claude twice.
+    if (structured.continuation_transport === "claude_channel")
+        return null;
     if (structured.delivery_state === "failed" || structured.delivery_state === "skipped")
         return null;
     const requestId = parseHandle(structured.request_id);

package/dist/cli.js

@@ -3,7 +3,7 @@ import { homedir } from "node:os";
 import { createInterface } from "node:readline/promises";
 import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
 import { SupabaseAgentApi } from "./api.js";
-import { clientDisplayName, detectInstalledClients, detectLegacyHostedRegistration, LocalCommandRunner, manualLegacyHostedRemoveCommand, manualRemoveCommand, manualSetupCommand, parseClientChoice, preflightClientPersistence, registerClient, singleNonInteractiveClientSelection, } from "./client-setup.js";
+import { claudeChannelLaunchCommand, clientDisplayName, detectInstalledClients, detectLegacyHostedRegistration, LocalCommandRunner, manualLegacyHostedRemoveCommand, manualRemoveCommand, manualSetupCommand, parseClientChoice, preflightClientPersistence, registerClient, singleNonInteractiveClientSelection, } from "./client-setup.js";
 import { configureClaudeContinuationPlugin } from "./claude-plugin-setup.js";
 import { readConfig } from "./config.js";
 import { awaitClaudeVibecheckResult } from "./claude-hook.js";
@@ -11,6 +11,7 @@ import { PACKAGE_SPEC, SUPABASE_PUBLISHABLE_KEY, SUPABASE_URL } from "./constant
 import { LinkPersistenceError, NonInteractiveLinkError, linkAgent } from "./link.js";
 import { checkReadiness } from "./readiness.js";
 import { formatRecipeDetail, formatRecipeList, formatRecipePrompt, getRecipeExperience } from "./recipes.js";
+import { parseRuntimeMode } from "./runtime-mode.js";
 import { createVibecheckServer } from "./server.js";
 const api = new SupabaseAgentApi(SUPABASE_URL, SUPABASE_PUBLISHABLE_KEY);
 const runner = new LocalCommandRunner();
@@ -30,6 +31,7 @@ function usage() {
         "  npx -y @somacheck/vibecheck recipes",
         "  npx -y @somacheck/vibecheck recipes --id <id> --format prompt",
         "  npx -y @somacheck/vibecheck recipe <id>",
+        "  npx -y @somacheck/vibecheck serve --client claude --channel",
     ].join("\n");
 }
 function parseLinkClient(args) {
@@ -46,11 +48,6 @@ function parseLinkClient(args) {
         return [];
     throw new Error(usage());
 }
-function parseServeClient(args) {
-    if (args.length !== 3 || args[0] !== "serve" || args[1] !== "--client")
-        return null;
-    return args[2] === "codex" || args[2] === "claude" ? args[2] : null;
-}
 async function promptForClients(installed) {
     if (installed.length === 0)
         return [];
@@ -105,6 +102,7 @@ async function configureClients(clients) {
                 throw new ClientPreflightError("Could not configure automatic SomaCheck results for Claude Code. No pairing code was used.");
             }
             output(`✓ Automatic Claude result continuation ${plugin.status === "installed" ? "was configured" : "is ready"}.`);
+            output(`  Start Claude Code with SomaCheck Channels: ${claudeChannelLaunchCommand()}`);
         }
     }
 }
@@ -180,6 +178,7 @@ async function preflightLinkClients(clients, interactive) {
                 ].join("\n"));
             }
             output("✓ Automatic Claude result continuation is ready before redeeming the pairing code.");
+            output(`  Start Claude Code with SomaCheck Channels: ${claudeChannelLaunchCommand()}`);
         }
     }
     return selectedClients;
@@ -201,13 +200,15 @@ async function refreshRuntimeHealth(client) {
         context_probe_ok: true,
     });
 }
-async function startServer(runtimeClient) {
+async function startServer(runtime) {
+    const runtimeClient = runtime?.client ?? null;
     const server = createVibecheckServer({
         api,
         loadToken: async () => (await readConfig(homedir(), runtimeClient ?? undefined)).token,
         identity: runtimeClient === null
             ? { kind: "legacy" }
             : { kind: "local", client_key: runtimeClient },
+        ...(runtime?.claudeChannel ? { claudeChannelWatch: {} } : {}),
     });
     await server.connect(new StdioServerTransport());
     if (runtimeClient !== null) {
@@ -299,9 +300,9 @@ async function main() {
             throw new Error(usage());
         return (await runDoctor()) ? 0 : 2;
     }
-    const runtimeClient = parseServeClient(args);
-    if (runtimeClient !== null) {
-        await startServer(runtimeClient);
+    const runtime = parseRuntimeMode(args);
+    if (runtime !== null) {
+        await startServer(runtime);
         return 0;
     }
     if (args.length !== 0)

package/dist/client-setup.js

@@ -26,7 +26,11 @@ export function clientDisplayName(client) {
     return client === "codex" ? "Codex / ChatGPT desktop" : "Claude Code";
 }
 function mcpServerArgs(client) {
-    return ["-y", PACKAGE_SPEC, "serve", "--client", client];
+    const args = ["-y", PACKAGE_SPEC, "serve", "--client", client];
+    return client === "claude" ? [...args, "--channel"] : args;
+}
+export function claudeChannelLaunchCommand() {
+    return `claude --dangerously-load-development-channels server:${MCP_SERVER_NAME}`;
 }
 export function manualSetupCommand(client) {
     if (client === "codex") {
@@ -149,7 +153,9 @@ function isManagedSomaCheckRegistration(client, stdout) {
         || packageArg === "@somacheck/vibecheck@0.6.6"
         || packageArg === "@somacheck/vibecheck@0.6.7"
         || packageArg === "@somacheck/vibecheck@0.6.8"
-        || packageArg === "@somacheck/vibecheck@0.6.9")
+        || packageArg === "@somacheck/vibecheck@0.6.9"
+        || packageArg === "@somacheck/vibecheck@0.6.10"
+        || packageArg === "@somacheck/vibecheck@0.6.11")
         && args.length === 5
         && args[0] === "-y"
         && args[1] === packageArg

package/dist/constants.js

@@ -2,7 +2,7 @@
 export const SUPABASE_URL = "https://pbldcmniommltbdwuykk.supabase.co";
 export const SUPABASE_PUBLISHABLE_KEY = "sb_publishable_af-lUNI2FqEcb-oGy-4uxQ_cnm6kY85";
 export const PACKAGE_NAME = "@somacheck/vibecheck";
-export const PACKAGE_VERSION = "0.6.11";
+export const PACKAGE_VERSION = "0.6.12";
 export const PACKAGE_SPEC = `${PACKAGE_NAME}@${PACKAGE_VERSION}`;
 export const SOMACHECK_SETUP_URL = "https://testflight.apple.com/join/C4mAH3zz";
 export const MCP_SERVER_NAME = "vibecheck";

package/dist/runtime-mode.js

@@ -0,0 +1,14 @@
+/** Parse only the exact stdio runtime forms installed by this package.
+ * Claude Channels are local-only and must never be enabled for Codex. */
+export function parseRuntimeMode(args) {
+    if (args[0] !== "serve" || args[1] !== "--client")
+        return null;
+    if (args.length === 3 && (args[2] === "codex" || args[2] === "claude")) {
+        return { client: args[2], claudeChannel: false };
+    }
+    if (args.length === 4 && args[2] === "claude" && args[3] === "--channel") {
+        return { client: "claude", claudeChannel: true };
+    }
+    return null;
+}
+//# sourceMappingURL=runtime-mode.js.map

package/dist/server.js

@@ -105,6 +105,7 @@ const liveAskSchema = {
     delivery_state: z.enum(["queued", "processing", "sent", "failed", "skipped"]).nullable(),
     cooldown_until: z.string().datetime({ offset: true }).nullable(),
     error_code: liveAskErrorCodeSchema.nullable(),
+    continuation_transport: z.enum(["poll", "claude_channel"]).nullable().optional(),
 };
 const agentContextTypeSchema = z.enum([
     "goal", "project", "decision", "commitment", "tension", "question",
@@ -381,7 +382,15 @@ export function createVibecheckServer(dependencies) {
                 });
             });
             startClaudeChannelWatch(result, token, identity);
-            const structuredContent = { ...result, error_code: null };
+            const channelArmed = supportsClaudeChannel
+                && result.state === "pending"
+                && result.delivery_state !== "failed"
+                && result.delivery_state !== "skipped";
+            const structuredContent = {
+                ...result,
+                error_code: null,
+                ...(channelArmed ? { continuation_transport: "claude_channel" } : {}),
+            };
             const text = result.state === "completed"
                 ? `Vibecheck completed: ${result.verdict}, confidence ${formatChannelConfidence(result.confidence)}${formatUserFeedback(result.user_feedback)}.`
                 : result.state === "pending"
@@ -390,7 +399,7 @@ export function createVibecheckServer(dependencies) {
                             + `Open SomaCheck on your phone, signed into the same account, and check Home. `
                             + `If you do not have the app, install it at ${SOMACHECK_SETUP_URL} and finish phone setup. `
                             + `Keep this request ID; do not create a duplicate or claim the phone received it. It expires at ${result.expires_at}.`
-                        : pendingWaitText(result.request_id, result.expires_at, supportsClaudeChannel)
+                        : pendingWaitText(result.request_id, result.expires_at, channelArmed)
                     : `This vibecheck is ${result.state}.`;
             return { content: [{ type: "text", text }], structuredContent };
         }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@somacheck/vibecheck",
-  "version": "0.6.11",
+  "version": "0.6.12",
   "mcpName": "io.github.Sensie-agents/vibecheck",
   "description": "Send a consented vibecheck to SomaCheck and use the result as a signal.",
   "repository": {