cc-peer 1.3.5 → 1.5.0

package/dist/bin/cc-peer.cjs

@@ -1,35 +1,15 @@
 #!/usr/bin/env node
-//#region \0rolldown/runtime.js
-var __create = Object.create;
-var __defProp = Object.defineProperty;
-var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
-var __getOwnPropNames = Object.getOwnPropertyNames;
-var __getProtoOf = Object.getPrototypeOf;
-var __hasOwnProp = Object.prototype.hasOwnProperty;
-var __copyProps = (to, from, except, desc) => {
-	if (from && typeof from === "object" || typeof from === "function") for (var keys = __getOwnPropNames(from), i = 0, n = keys.length, key; i < n; i++) {
-		key = keys[i];
-		if (!__hasOwnProp.call(to, key) && key !== except) __defProp(to, key, {
-			get: ((k) => from[k]).bind(null, key),
-			enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable
-		});
-	}
-	return to;
-};
-var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(isNodeMode || !mod || !mod.__esModule || !__hasOwnProp.call(mod, "default") ? __defProp(target, "default", {
-	value: mod,
-	enumerable: true
-}) : target, mod));
-//#endregion
-const require_cc_peer = require("../cc-peer-CXzxAUE4.cjs");
+const require_rolldown_runtime = require("../rolldown-runtime-VH7oDXx4.cjs");
+const require_cc_peer = require("../cc-peer-ClYIGdRf.cjs");
+const require_errors = require("../errors-Dl_lSq1N.cjs");
 let node_crypto = require("node:crypto");
 let zod = require("zod");
 let node_process = require("node:process");
-node_process = __toESM(node_process, 1);
+node_process = require_rolldown_runtime.__toESM(node_process, 1);
 let node_http = require("node:http");
 //#region src/api/schemas.ts
 /** Address a REST target by session pid, roster name, or raw address. */
-const PeerTargetSchema = require_cc_peer.defineSchema(zod.z.object({
+const PeerTargetSchema = require_errors.defineSchema(zod.z.object({
 	pid: zod.z.number().int().positive().optional(),
 	name: zod.z.string().min(1).optional(),
 	address: zod.z.string().min(1).optional()
@@ -37,7 +17,7 @@ const PeerTargetSchema = require_cc_peer.defineSchema(zod.z.object({
 	id: "PeerTarget",
 	title: "Peer target"
 }));
-const SendMessageRequestSchema = require_cc_peer.defineSchema(zod.z.object({
+const SendMessageRequestSchema = require_errors.defineSchema(zod.z.object({
 	to: PeerTargetSchema,
 	body: zod.z.string().min(1),
 	priority: require_cc_peer.PrioritySchema.optional(),
@@ -47,19 +27,19 @@ const SendMessageRequestSchema = require_cc_peer.defineSchema(zod.z.object({
 	id: "SendMessageRequest",
 	title: "Send message request"
 }));
-const IdleSubscriptionRequestSchema = require_cc_peer.defineSchema(zod.z.object({ to: PeerTargetSchema }).meta({
+const IdleSubscriptionRequestSchema = require_errors.defineSchema(zod.z.object({ to: PeerTargetSchema }).meta({
 	id: "IdleSubscriptionRequest",
 	title: "Idle subscription request"
 }));
-const SendAcceptedSchema = require_cc_peer.defineSchema(zod.z.object({ msgId: zod.z.string() }).meta({
+const SendAcceptedSchema = require_errors.defineSchema(zod.z.object({ msgId: zod.z.string() }).meta({
 	id: "SendAccepted",
 	title: "Send accepted"
 }));
-const RosterResponseSchema = require_cc_peer.defineSchema(zod.z.object({ sessions: zod.z.array(require_cc_peer.RegistryEntrySchema) }).meta({
+const RosterResponseSchema = require_errors.defineSchema(zod.z.object({ sessions: zod.z.array(require_cc_peer.RegistryEntrySchema) }).meta({
 	id: "RosterResponse",
 	title: "Roster response"
 }));
-const ErrorResponseSchema = require_cc_peer.defineSchema(zod.z.object({ error: zod.z.string() }).meta({
+const ErrorResponseSchema = require_errors.defineSchema(zod.z.object({ error: zod.z.string() }).meta({
 	id: "ErrorResponse",
 	title: "Error response"
 }));

package/dist/bin/cc-peer.mjs

@@ -1,5 +1,6 @@
 #!/usr/bin/env node
-import { a as defineSchema, i as RegistryEntrySchema, n as CcPeer, r as PrioritySchema } from "../cc-peer-CJqStHIL.mjs";
+import { i as RegistryEntrySchema, n as CcPeer, r as PrioritySchema } from "../cc-peer-BduoSupO.mjs";
+import { o as defineSchema } from "../errors-Dcqq2MIW.mjs";
 import { randomBytes } from "node:crypto";
 import { z } from "zod";
 import process from "node:process";

package/dist/cc-peer-B3i4ZlKV.d.cts

@@ -0,0 +1,312 @@
+import { EventEmitter } from "node:events";
+import { z } from "zod";
+//#region src/adapters/node/paths.d.ts
+interface PathConfig {
+  homeDir?: string;
+  socketDir?: string;
+}
+//#endregion
+//#region src/ports/transport.d.ts
+/** Transport port: per-exchange connections and the listening inbox. */
+interface Transport {
+  /**
+   * One connection, one write of the given lines (each newline-terminated), then close after a short linger. Mirrors the reference client's `Pe`.
+   */
+  connectWrite: (socketPath: string, lines: readonly string[], lingerMs?: number) => Promise<void>;
+  /** Probe whether a socket accepts connections (roster admission uses this). */
+  probe: (socketPath: string) => Promise<boolean>;
+  listen: (socketPath: string, onConnection: (conn: Readonly<InboundConnection>) => void) => Promise<ListeningSocket>;
+}
+interface InboundConnection {
+  /** Resolves once the kernel reports the connecting process's pid (macOS). */
+  peerPid: () => number | undefined;
+  readLines: () => AsyncIterable<string>;
+  close: () => void;
+}
+interface ListeningSocket {
+  socketPath: string;
+  close: () => Promise<void>;
+}
+//#endregion
+//#region src/schemas/registry.d.ts
+/** One entry of the ~/.claude/sessions/<pid>.json registry. */
+declare const RegistryEntrySchema: z.ZodObject<{
+  pid: z.ZodNumber;
+  sessionId: z.ZodString;
+  cwd: z.ZodString;
+  startedAt: z.ZodNumber;
+  procStart: z.ZodString;
+  version: z.ZodString;
+  ccPeerVersion: z.ZodOptional<z.ZodString>;
+  peerProtocol: z.ZodNumber;
+  peerFeatures: z.ZodArray<z.ZodEnum<{
+    notify_idle: "notify_idle";
+    reply_across_default_dirs: "reply_across_default_dirs";
+    artifact_yield: "artifact_yield";
+  }> & {
+    is(value: unknown): value is "notify_idle" | "reply_across_default_dirs" | "artifact_yield";
+  }>;
+  kind: z.ZodEnum<{
+    interactive: "interactive";
+    bg: "bg";
+    daemon: "daemon";
+    "daemon-worker": "daemon-worker";
+  }> & {
+    is(value: unknown): value is "interactive" | "bg" | "daemon" | "daemon-worker";
+  };
+  entrypoint: z.ZodString;
+  pidDomain: z.ZodString;
+  messagingSocketPath: z.ZodString;
+  name: z.ZodOptional<z.ZodString>;
+  nameSource: z.ZodOptional<z.ZodEnum<{
+    user: "user";
+    peer: "peer";
+    derived: "derived";
+    collision: "collision";
+    auto: "auto";
+    hook: "hook";
+  }> & {
+    is(value: unknown): value is "user" | "peer" | "derived" | "collision" | "auto" | "hook";
+  }>;
+  nameSince: z.ZodOptional<z.ZodNumber>;
+  updatedAt: z.ZodNumber;
+  status: z.ZodOptional<z.ZodEnum<{
+    idle: "idle";
+    busy: "busy";
+    shell: "shell";
+    waiting: "waiting";
+  }> & {
+    is(value: unknown): value is "idle" | "busy" | "shell" | "waiting";
+  }>;
+  statusUpdatedAt: z.ZodOptional<z.ZodNumber>;
+  bridgeSessionId: z.ZodOptional<z.ZodString>;
+}, z.core.$strip> & {
+  is(value: unknown): value is {
+    pid: number;
+    sessionId: string;
+    cwd: string;
+    startedAt: number;
+    procStart: string;
+    version: string;
+    peerProtocol: number;
+    peerFeatures: ("notify_idle" | "reply_across_default_dirs" | "artifact_yield")[];
+    kind: "interactive" | "bg" | "daemon" | "daemon-worker";
+    entrypoint: string;
+    pidDomain: string;
+    messagingSocketPath: string;
+    updatedAt: number;
+    ccPeerVersion?: string | undefined;
+    name?: string | undefined;
+    nameSource?: "user" | "peer" | "derived" | "collision" | "auto" | "hook" | undefined;
+    nameSince?: number | undefined;
+    status?: "idle" | "busy" | "shell" | "waiting" | undefined;
+    statusUpdatedAt?: number | undefined;
+    bridgeSessionId?: string | undefined;
+  };
+};
+type RegistryEntry = z.infer<typeof RegistryEntrySchema>;
+//#endregion
+//#region src/ports/registry-store.d.ts
+/** Registry port: the ~/.claude/sessions/<pid>.json store. */
+interface RegistryStore {
+  list: () => Promise<RegistryEntry[]>;
+  read: (pid: number) => Promise<RegistryEntry | undefined>;
+  write: (entry: RegistryEntry) => Promise<void>;
+  /** Heartbeat: bump updatedAt/statusUpdatedAt without rewriting the rest. */
+  touch: (pid: number) => Promise<void>;
+  remove: (pid: number) => Promise<void>;
+}
+//#endregion
+//#region src/schemas/keyfile.d.ts
+/** The auth key a session publishes next to its socket. */
+declare const PeerKeyFileSchema: z.ZodObject<{
+  peerToken: z.ZodString;
+  procStart: z.ZodString;
+  pidDomain: z.ZodString;
+}, z.core.$strip> & {
+  is(value: unknown): value is {
+    peerToken: string;
+    procStart: string;
+    pidDomain: string;
+  };
+};
+type PeerKeyFile = z.infer<typeof PeerKeyFileSchema>;
+//#endregion
+//#region src/ports/key-store.d.ts
+/** Key-store port: auth keys published next to each session socket. */
+interface KeyStore {
+  readForSocket: (socketPath: string) => Promise<PeerKeyFile | undefined>;
+  /** Write our own key file for the socket we own. */
+  writeForSocket: (socketPath: string, keyFile: Readonly<PeerKeyFile>) => Promise<void>;
+  removeForSocket: (socketPath: string) => Promise<void>;
+}
+//#endregion
+//#region src/ports/proc-info.d.ts
+/** Process-info port: the liveness and proc-start facts the roster needs. */
+interface ProcInfo {
+  alive: (pid: number) => Promise<boolean>;
+  /**
+   * The process start string, byte-equal to `LC_ALL=C TZ=UTC ps -o lstart=` output — the exact value the receiver's registry byte-compares against.
+   */
+  lstart: (pid: number) => Promise<string | undefined>;
+}
+//#endregion
+//#region src/ports/clock.d.ts
+/** Clock port: injectable time for pacer/refill and freshness windows. */
+interface Clock {
+  nowMs: () => number;
+}
+//#endregion
+//#region src/schemas/wire.d.ts
+declare const PeerMessageStatusSchema: z.ZodObject<{
+  type: z.ZodLiteral<"control">;
+  action: z.ZodLiteral<"peer_message_status">;
+  status: z.ZodEnum<{
+    held: "held";
+    delivered: "delivered";
+    denied: "denied";
+    expired: "expired";
+    dropped: "dropped";
+  }>;
+  reason: z.ZodString;
+  from: z.ZodString;
+  orig_msg_id: z.ZodString;
+  status_detail: z.ZodOptional<z.ZodString>;
+  drop_reason: z.ZodOptional<z.ZodEnum<{
+    "rate-limited": "rate-limited";
+    duplicate: "duplicate";
+    "hop-loop": "hop-loop";
+    "hop-runaway": "hop-runaway";
+    "queue-full": "queue-full";
+  }> & {
+    is(value: unknown): value is "rate-limited" | "duplicate" | "hop-loop" | "hop-runaway" | "queue-full";
+  }>;
+  dropped_msg_ids: z.ZodOptional<z.ZodArray<z.ZodString>>;
+  msgV: z.ZodNumber;
+  msg_id: z.ZodString;
+}, z.core.$strip> & {
+  is(value: unknown): value is {
+    type: "control";
+    action: "peer_message_status";
+    status: "held" | "delivered" | "denied" | "expired" | "dropped";
+    reason: string;
+    from: string;
+    orig_msg_id: string;
+    msgV: number;
+    msg_id: string;
+    status_detail?: string | undefined;
+    drop_reason?: "rate-limited" | "duplicate" | "hop-loop" | "hop-runaway" | "queue-full" | undefined;
+    dropped_msg_ids?: string[] | undefined;
+  };
+};
+type PeerMessageStatus = z.infer<typeof PeerMessageStatusSchema>;
+declare const PeerIdleNoticeSchema: z.ZodObject<{
+  type: z.ZodLiteral<"control">;
+  action: z.ZodLiteral<"peer_idle_notice">;
+  orig_msg_id: z.ZodString;
+  state: z.ZodEnum<{
+    idle: "idle";
+    exited: "exited";
+  }>;
+  finished_at: z.ZodNumber;
+  detail: z.ZodOptional<z.ZodString>;
+  from: z.ZodString;
+  from_mode: z.ZodOptional<z.ZodEnum<{
+    bypass: "bypass";
+    prompting: "prompting";
+  }>>;
+  msgV: z.ZodNumber;
+  msg_id: z.ZodString;
+}, z.core.$strip> & {
+  is(value: unknown): value is {
+    type: "control";
+    action: "peer_idle_notice";
+    orig_msg_id: string;
+    state: "idle" | "exited";
+    finished_at: number;
+    from: string;
+    msgV: number;
+    msg_id: string;
+    detail?: string | undefined;
+    from_mode?: "bypass" | "prompting" | undefined;
+  };
+};
+type PeerIdleNotice = z.infer<typeof PeerIdleNoticeSchema>;
+//#endregion
+//#region src/cc-peer.d.ts
+/** cc-peer's own package version, read from package.json and inlined at bundle time so it needs no filesystem access at runtime (the SEA build ships as a single file with no package.json alongside it). */
+declare const CC_PEER_VERSION: string;
+/** How a target can be addressed. */
+type PeerRef = {
+  pid: number;
+} | {
+  name: string;
+} | {
+  address: string;
+};
+interface CcPeerOptions extends PathConfig {
+  name?: string;
+  sessionId?: string;
+  heartbeatMs?: number;
+  logger?: (message: string) => void;
+}
+interface SendOptions {
+  priority?: "next" | "later";
+  /** Attaches from-mode attestation; false deliberately sends unattested (recipient holds it). */
+  fromMode?: "bypass" | "prompting" | false;
+  /** When set, must match the receiver's sessionId or the frame is silently dropped. */
+  sessionId?: string;
+}
+interface InboundMessage {
+  from?: string;
+  fromSession?: string;
+  fromName?: string;
+  fromMode?: "bypass" | "prompting";
+  hopChain?: string[];
+  body: string;
+  msgId: string;
+}
+type Receipt = PeerMessageStatus;
+type IdleNotice = PeerIdleNotice;
+interface Deps {
+  transport: Transport;
+  registry: RegistryStore;
+  keys: KeyStore;
+  procInfo: ProcInfo;
+  clock: Clock;
+}
+/**
+ * A registered peer on Claude Code's cross-session mesh. Receipts and idle notices only reach the process that owns the listening socket (the protocol verifies return addresses via kernel peer pids), so do not split sending and listening across differently-owned processes.
+ */
+declare class CcPeer extends EventEmitter {
+  private readonly options;
+  private readonly deps;
+  private listening;
+  private heartbeatTimer;
+  private ownKey;
+  private readonly pacer;
+  private readonly log;
+  private stopped;
+  constructor(options: Readonly<CcPeerOptions>, deps: Deps);
+  static create(options?: Readonly<CcPeerOptions>): Promise<CcPeer>;
+  /**
+   * Bind, publish key and registry, and begin listening. Public rather than private because dependency-injected construction (this constructor takes the full Deps) needs to trigger it explicitly; everyday callers use the static create(), which wires the real node adapters.
+   */
+  start(): Promise<void>;
+  /** procStart is a required parameter, not read from this.ownKey: start() already guarantees a non-empty value before this is called, so the type checker enforces it rather than a runtime fallback that can never actually fire. */
+  private buildRegistryEntry;
+  roster(): Promise<RegistryEntry[]>;
+  send(target: PeerRef, body: string, options?: Readonly<SendOptions>): Promise<{
+    msgId: string;
+  }>;
+  private pacedSend;
+  subscribeIdle(target: PeerRef): Promise<{
+    msgId: string;
+  }>;
+  private resolveTarget;
+  /** ownToken is passed explicitly rather than read from this.ownKey: the listener callback that invokes this is only ever registered after start() has set ownKey, so the parameter records that guarantee at the type level instead of a runtime guard that can never actually be false. */
+  private handleConnection;
+  stop(): Promise<void>;
+}
+//#endregion
+export { InboundMessage as a, SendOptions as c, IdleNotice as i, PathConfig as l, CcPeer as n, PeerRef as o, CcPeerOptions as r, Receipt as s, CC_PEER_VERSION as t };