negotium 0.2.27 → 0.2.28

package/dist/types/packages/core/src/mcp/session-comm/peer-forward.d.ts

@@ -36,7 +36,12 @@ export interface RemoteReplyRoute {
 }
 export interface PeerSessionBridge {
     forward(args: PeerForwardArgs): Promise<PeerForwardResult>;
-    sessions(userId: string, sourceQueryId?: string): Promise<PeerSessionsResult>;
+    /**
+     * `fromTopicId` names the asking room so the bridge can answer within that
+     * room's workspace. Without it the answer is the union of every attached
+     * workspace's nodes, which leaks one workspace's topology into another.
+     */
+    sessions(userId: string, sourceQueryId?: string, fromTopicId?: string): Promise<PeerSessionsResult>;
     reply(route: RemoteReplyRoute, sourceTitle: string, replyText: string, kind: "reply" | "error"): Promise<boolean>;
 }
 export declare function registerPeerSessionBridge(bridge: PeerSessionBridge): () => void;
@@ -55,5 +60,5 @@ export interface PeerSessionsResult {
         sessions?: PeerSessionEntry[];
     }>;
 }
-export declare function peerSessionsForUser(userId: string, sourceQueryId?: string): Promise<PeerSessionsResult>;
+export declare function peerSessionsForUser(userId: string, sourceQueryId?: string, fromTopicId?: string): Promise<PeerSessionsResult>;
 export declare function deliverPeerReply(route: RemoteReplyRoute, sourceTitle: string, replyText: string, kind: "reply" | "error"): Promise<boolean>;

package/dist/types/packages/core/src/runtime/turn-event-stream.d.ts

@@ -23,4 +23,6 @@ export declare function runTurnEventStream(topicId: string, topicTitle: string,
     silent?: boolean;
     peerBridge?: PeerRuntimeBridgeContext;
     sourceNode?: string;
+    /** Answer inside this thread instead of the room's main flow (S-13). */
+    threadRootId?: string;
 }): Promise<StreamAgentOutcome>;

package/dist/types/packages/core/src/runtime/turn-runner.d.ts

@@ -30,6 +30,7 @@ export declare function streamAgentEvents(topicId: string, topicTitle: string, q
     silent?: boolean;
     peerBridge?: PeerRuntimeBridgeContext;
     sourceNode?: string;
+    threadRootId?: string;
 }): Promise<StreamAgentOutcome>;
 type AskPendingFileRef = {
     requestId?: string;
@@ -105,6 +106,8 @@ export interface AiTurnExecutionOptions {
     origin?: string;
     /** Origin node for transcript echo suppression. */
     sourceNode?: string;
+    /** Answer inside this thread instead of the room's main flow (S-13). */
+    threadRootId?: string;
     /** Fired when the turn is actually dispatched, including after a defer. */
     onDispatched?: (queryId: string) => void;
     /** Inter-session requestId for queue dedup (session-inject only). */

package/dist/types/packages/core/src/storage/api-topics.d.ts

@@ -11,11 +11,33 @@ import type { AiMode, TopicDto, TopicKind, TopicSurface, TopicVisibility } from
  */
 export declare function defaultTopicSurface(): TopicSurface;
 export declare function normalizeTopicSurface(value: unknown): TopicSurface;
+export declare function normalizeSurfaceScope(value: unknown): string | null;
+export declare function defaultSurfaceScope(): string | null;
+/** Install (or clear) the scope new rooms inherit. Returns the previous value. */
+export declare function setDefaultSurfaceScope(scope: string | null): string | null;
+export declare function setSurfaceScopeRequired(required: boolean): void;
+export declare function isSurfaceScopeRequired(): boolean;
 /** Persist the authoritative agent and, when supplied, its normalized base defaults. */
 export declare function setApiTopicAgent(topicId: string, agent: AgentKind, defaults?: {
     model: string;
     effort?: EffortLevel;
 }): void;
+/**
+ * M-9 — file every pre-existing Otium room under the workspace attached now.
+ *
+ * Deliberately *not* a schema-init step. The scope is only knowable after the
+ * first successful Central contact (M-3), which happens long after the store
+ * opens; a boot-time migration would see no scope, record itself as applied and
+ * leave every room unstamped forever. The Otium runtime calls this instead, once,
+ * as soon as it has resolved its workspace.
+ *
+ * Runs at most once per store: rooms created after this point are stamped at
+ * creation, and a second workspace joined later must not swallow the first
+ * one's rooms. Unlike the surface migration this can never rename anything —
+ * the scope enters the uniqueness key in the same release, so nothing can start
+ * colliding because of it.
+ */
+export declare function stampUnscopedOtiumTopics(scope: string): number;
 export interface TopicRow {
     id: string;
     title: string;
@@ -35,6 +57,7 @@ export interface TopicRow {
     subagent_report_mode: string | null;
     visibility: string | null;
     surface: string | null;
+    surface_scope: string | null;
     browser_profile_owner: string | null;
     session_id: string | null;
 }
@@ -80,10 +103,22 @@ export declare function upsertTopic(t: TopicDto): void;
  */
 export declare function listTopics(opts?: {
     surface?: TopicSurface;
+    surfaceScope?: string | null;
 }): TopicDto[];
 export declare function getTopic(id: string): TopicDto | null;
 /** Return the private manager room owned by a user, excluding the retired shared General row. */
-export declare function getManagerTopicForUser(userId: string): TopicDto | null;
+/**
+ * The user's own manager room, optionally on one surface.
+ *
+ * A manager room is one per user **per surface**: Terminal and Telegram each
+ * give the same person their own personal room, and returning one surface's
+ * room to the other adapter lets that adapter bind to — and reclassify — a room
+ * belonging to a different surface. Callers that represent an adapter pass
+ * theirs; unscoped lookups stay for maintenance paths that work by user alone.
+ */
+export declare function getManagerTopicForUser(userId: string, surface?: TopicSurface, opts?: {
+    surfaceScope?: string | null;
+}): TopicDto | null;
 /**
  * Resolve the topic whose wiki memory should be used for this topic.
  *
@@ -96,12 +131,15 @@ export declare function getTopicMemoryOrigin(id: string): TopicDto | null;
 export declare function getTopicByName(title: string): TopicDto | null;
 export declare function getTopicByNameAndKind(title: string, kind: TopicKind): TopicDto | null;
 /**
- * Titles are unique **per surface**, not per node: `otium` may exist once on
- * the terminal, once on telegram and once on the Otium hub.
+ * Titles are unique **per surface instance**, not per node: `otium` may exist
+ * once on the terminal, once on telegram, and once in *each* attached Otium
+ * workspace (M-1). Two workspaces are two namespaces that never see each other,
+ * so a name taken in one says nothing about the other.
  */
 export declare function findTopicTitleConflict(title: string, kind: TopicKind, opts?: {
     excludeTopicId?: string;
     surface?: TopicSurface;
+    surfaceScope?: string | null;
 }): TopicDto | null;
 /**
  * Move topics onto a surface. Used by adapters that own a classification the
@@ -112,6 +150,7 @@ export declare function setTopicSurfaces(topicIds: readonly string[], surface: T
 /** Look up a topic by title, restricted to topics where `userId` participates. */
 export declare function getTopicByNameForUser(title: string, userId: string, opts?: {
     surface?: TopicSurface;
+    surfaceScope?: string | null;
 }): TopicDto | null;
 /** Persist the agent session ID for a topic after a successful turn. */
 export declare function setTopicSessionId(topicId: string, sessionId: string, context?: TopicSessionLogContext): void;

package/dist/types/packages/core/src/storage/runtime-turn-requests.d.ts

@@ -29,6 +29,12 @@ export interface RuntimeUserTurnExecution {
     providerSessionId?: string;
     /** Request ids whose ordered messages were folded into this replacement. */
     supersededRequestIds?: string[];
+    /**
+     * Slack-style thread this turn belongs to, when it was asked in one. Carried
+     * on the request rather than the message because it decides both where the
+     * answer goes and which pending requests may merge with it (S-13).
+     */
+    threadRootId?: string;
 }
 export interface RuntimeUserTurnRequest {
     requestId: string;

package/dist/types/packages/core/src/storage/token-stats.d.ts

@@ -47,6 +47,7 @@ export declare function recordUsage(userId: number | string, session: string, us
     agent: AgentKind;
     model: string;
 }): void;
+export declare function deleteTopicStats(userId: number | string, topicId: string): void;
 export declare function getStats(userId: number | string, from?: string, to?: string): {
     total: Bucket;
     byHour: Record<string, Bucket>;
@@ -56,4 +57,4 @@ export declare function getStats(userId: number | string, from?: string, to?: st
     estimatedCostUsd: number;
 };
 /** Exact all-time usage for one topic, independent of transcript pagination. */
-export declare function getTopicStats(userId: number | string, topicId: string): TopicUsageSummary;
+export declare function getTopicStats(userId: number | string, topicId: string, activeProviderSessionId?: string | undefined): TopicUsageSummary;

package/dist/types/packages/core/src/topics/derive.d.ts

@@ -11,6 +11,7 @@ import type { AgentKind } from "../types";
 import type { TopicDto, TopicSurface } from "../types/api";
 export declare function getTopics(opts?: {
     surface?: TopicSurface;
+    surfaceScope?: string | null;
 }): TopicDto[];
 /**
  * Topics adapters may show in lists and selection UIs.
@@ -20,6 +21,7 @@ export declare function getTopics(opts?: {
  */
 export declare function getVisibleTopics(opts?: {
     surface?: TopicSurface;
+    surfaceScope?: string | null;
 }): TopicDto[];
 export declare function updateTopic(topicId: string, patch: Partial<TopicDto>): boolean;
 export declare function isParticipant(topic: TopicDto, userId: string): boolean;

package/dist/types/packages/core/src/topics/personal-general.d.ts

@@ -1,4 +1,4 @@
-import type { TopicDto } from "../types/api";
+import type { TopicDto, TopicSurface } from "../types/api";
 export declare const PERSONAL_GENERAL_DESCRIPTION = "Your private General. Messages and membership are visible only to you. Workspace memory, wiki, and skills are shared with your workspace.";
 /**
  * Return the caller's private General room, creating it on first use.
@@ -6,7 +6,9 @@ export declare const PERSONAL_GENERAL_DESCRIPTION = "Your private General. Messa
  * The legacy `general` row is deliberately excluded: it was shared by every
  * user and remains untouched for an explicit, operator-controlled migration.
  */
-export declare function ensurePersonalGeneral(userId: string): TopicDto;
+export declare function ensurePersonalGeneral(userId: string, surface?: TopicSurface, opts?: {
+    surfaceScope?: string | null;
+}): TopicDto;
 /** Resolve the retired fixed id for old clients without exposing the shared row. */
 export declare function resolvePersonalTopicId(topicId: string, userId: string): string;
 export declare function isManagerTopic(topicId: string): boolean;

package/dist/types/packages/core/src/types/api.d.ts

@@ -121,6 +121,13 @@ export interface TopicDto {
     visibility?: TopicVisibility;
     /** The product surface that owns this topic (terminal / telegram / otium). */
     surface?: TopicSurface;
+    /**
+     * Which instance of the surface owns this topic — for `otium`, the workspace
+     * (M-1/M-2). Fixed at creation, exactly like `surface`. Null/absent on
+     * `terminal` and `telegram`, which have exactly one instance each, and on
+     * Otium rooms created before the scope was known.
+     */
+    surfaceScope?: string | null;
     /** Stable execution placement. Absent means the hub runs this topic locally. */
     executionNode?: {
         nodeId: string;

package/dist/types/packages/core/src/version.d.ts

@@ -1 +1 @@
-export declare const NEGOTIUM_VERSION = "0.2.27";
+export declare const NEGOTIUM_VERSION = "0.2.28";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "negotium",
-  "version": "0.2.27",
+  "version": "0.2.28",
   "type": "module",
   "description": "Install the Negotium multi-agent runtime and CLI with one package",
   "license": "Apache-2.0",