vibeshare-live 0.1.0

package/dist/index.d.ts

@@ -0,0 +1,61 @@
+export { a as AccessGate, b as AccessGateOptions, A as AccessMode, C as ConsentError, c as ControlRequestResult, D as DEFAULT_ACCESS, d as DenialReason, E as ExpirySpec, H as HOST_PARTICIPANT_NAME, R as RevokeReason, S as SHARE_SESSION_SCOPE, e as ShareHandle, f as ShareOptions, V as Viewer, g as ViewerRole, h as ViewerRoster, i as createAccessGate, j as createShare, p as parseExpiry } from './share-CoX608sF.js';
+import 'vibelive-cli';
+import '@pooriaarab/vibe-core';
+
+/** vibeshare package version (single source of truth for CLI + MCP). */
+declare const VERSION = "0.1.0";
+
+/**
+ * The URL / capability-id layer of vibeshare.
+ *
+ * Pure logic — no IO — so every function here is directly unit-tested in
+ * `src/url.test.ts`. A share link is a **capability URL**: the id is the only
+ * thing that grants access, so it must be unguessable. The human-facing host is
+ * vibeshare's own domain (`vibeshare.stream`); the actual transport is the
+ * local/LAN ws relay owned by vibelive, which the URL only *represents*.
+ */
+/**
+ * The display origin for vibeshare share links. This is vibeshare's OWN domain —
+ * not vibe.live — so a shared link reads as vibeshare even though the bytes flow
+ * over a self-hostable e2e relay (see docs/spec.md · "its OWN domain, not
+ * vibe.live").
+ */
+declare const SHARE_ORIGIN = "https://vibeshare.stream";
+/** Path prefix for share links: `<origin>/s/<id>`. */
+declare const SHARE_PATH_PREFIX = "/s/";
+/**
+ * Mint an unguessable capability id. Uses the platform CSPRNG (`crypto.randomUUID`,
+ * 122 bits of entropy) so a link is a genuine capability — guessing it is
+ * infeasible, which is the whole basis of the access model.
+ */
+declare function newShareId(): string;
+/**
+ * Build the human-facing share URL for a capability id.
+ *
+ * The URL is for *display and parsing only* — opening it resolves to the
+ * vibeshare spectator view, which then connects to the host's local/LAN relay.
+ * The relay URL is carried out-of-band (printed next to the share URL by the CLI).
+ */
+declare function buildShareUrl(id: string, origin?: string): string;
+/** Error thrown when a string cannot be parsed as a vibeshare share URL. */
+declare class ShareUrlParseError extends Error {
+    constructor(message: string);
+}
+/**
+ * Parse a vibeshare share URL (or bare `/s/<id>` path) back into its capability id.
+ *
+ * Accepts:
+ *   - full URLs: `https://vibeshare.stream/s/<id>`, `http://...`, with or without
+ *     a trailing slash or query string;
+ *   - bare paths: `/s/<id>`;
+ *   - any origin host (we key off the `/s/` segment, not the host, so self-hosted
+ *     / vanity domains round-trip too).
+ *
+ * Pure and total: throws {@link ShareUrlParseError} on input with no `/s/` segment.
+ * Round-trips {@link buildShareUrl}: `parseShareUrl(buildShareUrl(id)).id === id`.
+ */
+declare function parseShareUrl(url: string): {
+    readonly id: string;
+};
+
+export { SHARE_ORIGIN, SHARE_PATH_PREFIX, ShareUrlParseError, VERSION, buildShareUrl, newShareId, parseShareUrl };

package/dist/index.js

@@ -0,0 +1,32 @@
+import {
+  ConsentError,
+  DEFAULT_ACCESS,
+  HOST_PARTICIPANT_NAME,
+  SHARE_ORIGIN,
+  SHARE_PATH_PREFIX,
+  SHARE_SESSION_SCOPE,
+  ShareUrlParseError,
+  VERSION,
+  buildShareUrl,
+  createAccessGate,
+  createShare,
+  newShareId,
+  parseExpiry,
+  parseShareUrl
+} from "./chunk-5OLI3WTU.js";
+export {
+  ConsentError,
+  DEFAULT_ACCESS,
+  HOST_PARTICIPANT_NAME,
+  SHARE_ORIGIN,
+  SHARE_PATH_PREFIX,
+  SHARE_SESSION_SCOPE,
+  ShareUrlParseError,
+  VERSION,
+  buildShareUrl,
+  createAccessGate,
+  createShare,
+  newShareId,
+  parseExpiry,
+  parseShareUrl
+};

package/dist/mcp.d.ts

@@ -0,0 +1,41 @@
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { RelayHandle } from 'vibelive-cli';
+import { e as ShareHandle } from './share-CoX608sF.js';
+import '@pooriaarab/vibe-core';
+
+/**
+ * vibeshare MCP server (stdio). Exposes two tools an agent can call:
+ *
+ *   - create_share  — host a vibelive session wrapping a command, mint a share URL
+ *                     with an access policy (+ optional expiry/passphrase), and
+ *                     return the capability URL + relay URL. Lives for the MCP
+ *                     process lifetime (or until the wrapped agent exits).
+ *   - viewers       — list active shares and their viewer rosters (connected
+ *                     spectators/participants + pending join requests).
+ *
+ * Uses the high-level `McpServer` API from `@modelcontextprotocol/sdk`. Input
+ * schemas are Zod raw shapes (the SDK's expected form); zod is a transitive
+ * dependency of the SDK and gets bundled into dist/mcp.js by tsup.
+ */
+
+interface ActiveShare {
+    readonly id: string;
+    readonly url: string;
+    readonly relayUrl: string;
+    readonly access: string;
+    readonly command: readonly string[];
+    readonly share: ShareHandle;
+    readonly relay: RelayHandle;
+}
+/**
+ * Build the vibeshare MCP server (tools registered, not yet connected).
+ *
+ * `sessions` defaults to a fresh module-level map so independent `createMcpServer`
+ * calls don't share state, but a single stdio process keeps one map for its
+ * lifetime (so `viewers` sees shares started via `create_share`).
+ */
+declare function createMcpServer(sessions?: Map<string, ActiveShare>): McpServer;
+/** Create the server, wire it to stdio, and run until the client disconnects. */
+declare function runMcpStdio(): Promise<void>;
+
+export { createMcpServer, runMcpStdio };