negotium 0.2.32 → 0.3.0

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

@@ -147,11 +147,36 @@ export declare function findTopicTitleConflict(title: string, kind: TopicKind, o
  * lives in that adapter's database, not this one).
  */
 export declare function setTopicSurfaces(topicIds: readonly string[], surface: TopicSurface): number;
-/** Look up a topic by title, restricted to topics where `userId` participates. */
-export declare function getTopicByNameForUser(title: string, userId: string, opts?: {
-    surface?: TopicSurface;
+/**
+ * How wide a title lookup is allowed to reach.
+ *
+ * `surface` is required rather than optional. It used to default to "search
+ * every surface", which contradicted S-6's promise that a missed call site
+ * "cannot leak a topic across surfaces" — the guarantee only held where a
+ * caller remembered to opt in, and four did not: Telegram's `/load` and `/del`
+ * (the latter could delete a terminal room), the runtime MCP id path, the cron
+ * id path, and the session inbox. Every one of those was a silent leak with a
+ * correct-looking call. Making the parameter explicit turns each future
+ * omission into a compile error instead.
+ *
+ * `{ scope: "all" }` is the deliberate way to search every surface. It exists
+ * for operator tooling — the CLI manages jobs across surfaces on purpose — and
+ * reads as a decision at the call site rather than as an oversight.
+ */
+export type TopicNameLookupScope = {
+    surface: TopicSurface;
     surfaceScope?: string | null;
-}): TopicDto | null;
+} | {
+    scope: "all";
+};
+/**
+ * Look up a topic by title, restricted to topics where `userId` participates.
+ *
+ * Answers only on a single match: a title is unique per surface (S-3), so an
+ * `{ scope: "all" }` lookup of a name used on two surfaces resolves to null
+ * rather than picking one.
+ */
+export declare function getTopicByNameForUser(title: string, userId: string, lookupScope: TopicNameLookupScope): 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;
 /** Clear the session ID (e.g. on topic reset). */

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

@@ -1 +1 @@
-export declare const NEGOTIUM_VERSION = "0.2.32";
+export declare const NEGOTIUM_VERSION = "0.3.0";

package/package.json

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