@neta-art/cohub 2.7.1 → 2.8.0

package/docs/work-runtime-guide.md

@@ -97,9 +97,11 @@ a direct static-asset URL not wrapped in the Cohub iframe. The SDK opens a
   `${brokerOrigin}/work-auth?work=${workId}`.
 
 > **Broker mode requires configuration.** You must pass `work: { brokerOrigin,
-> workId }` to `createCohubClient` for broker mode to activate. Without it, a
-> standalone page gets `ParentBridgeTransport` which has no parent to talk to,
-> so `context()` returns `null`. See [Initialization recipe](#4-initialization-recipe).
+> workId }` — or `work: { brokerOrigin, ownerUsername, spaceSlug, workSlug }`
+> when the workId isn't known yet — to `createCohubClient` for broker mode to
+> activate. Without it, a standalone page gets `ParentBridgeTransport` which
+> has no parent to talk to, so `context()` returns `null`. See
+> [Initialization recipe](#4-initialization-recipe).
 
 ### Detecting the mode at runtime
 
@@ -308,6 +310,36 @@ When inside the Cohub iframe, the SDK auto-detects bridge mode and ignores
 broker config. When standalone, it uses broker mode. **One codebase, both
 deployments.**
 
+#### Broker mode without a pre-known workId
+
+The `workId` is only generated at publish time, so you often cannot hardcode
+it while writing the Work. In standalone deployments you can omit `workId` and
+instead pass the Work's public **slug triple**. The SDK resolves the workId at
+runtime via the public `works.getBySlug` API (anonymous, no auth required),
+caches it, and starts broker mode with it.
+
+All three values are known before publishing:
+
+- `workSlug` — the slug you chose when creating the Work.
+- `ownerUsername` — the space owner's username (`cohub auth whoami`).
+- `spaceSlug` — the space's slug (`cohub spaces get <spaceId>`).
+
+```js
+const client = createCohubClient({
+  env: isDevWork ? "dev" : "prod",
+  work: {
+    brokerOrigin: isDevWork ? "https://dev.cohub.run" : "https://cohub.run",
+    ownerUsername,
+    spaceSlug,
+    workSlug,
+  },
+});
+```
+
+Either `workId` or the full slug triple is enough to activate broker mode. If
+you pass both, the explicit `workId` wins and no lookup is performed. Inside
+the Cohub iframe both are ignored (bridge mode).
+
 ### Standard initialization sequence
 
 ```js

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@neta-art/cohub",
-  "version": "2.7.1",
+  "version": "2.8.0",
   "description": "Cohub SDK for spaces, sessions, checkpoints, and realtime agent collaboration.",
   "license": "UNLICENSED",
   "private": false,

package/dist/chunks/types.js

@@ -1,37 +0,0 @@
-//#region ../protocol/src/realtime/types.ts
-const WS_COMPACT_STREAM_CAPABILITY = "session.compact_stream.v1";
-const WS_ROOM_SUBSCRIPTION_CAPABILITY = "realtime.rooms.v1";
-const getRealtimeSpaceRoom = (spaceId) => `space:${spaceId}`;
-const parseRealtimeRoom = (room) => {
-	const trimmed = room.trim();
-	const separatorIndex = trimmed.indexOf(":");
-	if (separatorIndex <= 0) return null;
-	const kind = trimmed.slice(0, separatorIndex);
-	const id = trimmed.slice(separatorIndex + 1).trim();
-	if (!id) return null;
-	if (kind !== "space" && kind !== "user") return null;
-	return {
-		kind,
-		id
-	};
-};
-const normalizeRealtimeRooms = (rooms) => {
-	const normalized = /* @__PURE__ */ new Set();
-	for (const room of rooms) {
-		const parsed = typeof room === "string" ? parseRealtimeRoom(room) : null;
-		if (!parsed) continue;
-		normalized.add(`${parsed.kind}:${parsed.id}`);
-	}
-	return [...normalized];
-};
-const getNonEmptyString = (value) => typeof value === "string" && value.trim() ? value : null;
-const getSessionTurnPatchStreamKey = (input, options = {}) => {
-	const turnId = getNonEmptyString(input.turnId);
-	const messageKey = getNonEmptyString(input.messageId) ?? getNonEmptyString(input.sourceMessageId) ?? getNonEmptyString(input.anchorUserMessageId) ?? (typeof input.messageOrdinal === "number" && Number.isFinite(input.messageOrdinal) ? `ordinal:${input.messageOrdinal}` : null);
-	if (turnId && messageKey) return `${turnId}:${messageKey}`;
-	const streamKey = messageKey ?? turnId;
-	if (streamKey) return streamKey;
-	return options.includeSessionFallback ? getNonEmptyString(input.sessionId) : null;
-};
-//#endregion
-export { normalizeRealtimeRooms as a, getSessionTurnPatchStreamKey as i, WS_ROOM_SUBSCRIPTION_CAPABILITY as n, getRealtimeSpaceRoom as r, WS_COMPACT_STREAM_CAPABILITY as t };