negotium 0.2.33 → 0.3.1

package/dist/types/apps/negotium/src/mcp-servers.d.ts

@@ -1,4 +1,4 @@
-export declare const MCP_SERVER_NAMES: readonly ["agent-health", "background-bash", "canonical-proxy", "cron-manager", "session-comm", "system-health", "task", "token-stats", "vault", "wiki"];
+export declare const MCP_SERVER_NAMES: readonly ["agent-health", "background-bash", "canonical-proxy", "cron-manager", "session-comm", "system-health", "task", "decision", "token-stats", "vault", "wiki"];
 export type McpServerName = (typeof MCP_SERVER_NAMES)[number];
 /**
  * Servers that are a TypeScript entry file a host can spawn. `background-bash`

package/dist/types/packages/core/src/mcp/canonical-bridge-config.d.ts

@@ -1,5 +1,5 @@
 import type { PeerRuntimeBridgeContext } from "../types";
-export type CanonicalMcpSurface = "task" | "wiki";
+export type CanonicalMcpSurface = "task" | "decision" | "wiki";
 export interface CanonicalMcpBridgeScope {
     surface: CanonicalMcpSurface;
     userId: string;

package/dist/types/packages/core/src/mcp/factories/decision.d.ts

@@ -0,0 +1,16 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { type StoredDecision } from "../../storage/decisions";
+import type { AgentKind } from "../../types";
+export interface DecisionMcpContext {
+    userId: string;
+    topic: string;
+    topicId?: string;
+    agent: AgentKind;
+    model?: string;
+}
+export interface DecisionMcpHost {
+    readDecisions(userId: string, scopeKey: string): StoredDecision[];
+    writeDecisions(userId: string, scopeKey: string, decisions: StoredDecision[]): void;
+}
+export declare const defaultDecisionMcpHost: DecisionMcpHost;
+export declare function createDecisionMcpServer(context: DecisionMcpContext, host?: DecisionMcpHost): McpServer;

package/dist/types/packages/core/src/mcp/factories/index.d.ts

@@ -5,6 +5,7 @@ export { executeVaultRun } from "../vault-run";
 export { createWikiMcpServer, type WikiMcpContext, type WikiMcpHost, type WikiSurface, type WikiTopicBrief, } from "../wiki-server";
 export { type AgentHealthMcpContext, createAgentHealthMcpServer, } from "./agent-health";
 export { type CompactionLogMcpContext, createCompactionLogMcpServer, } from "./compaction-log";
+export { createDecisionMcpServer, type DecisionMcpContext, type DecisionMcpHost, defaultDecisionMcpHost, } from "./decision";
 export { createSessionCommMcpServer, type SessionCommMcpHost, type SessionCommMcpOptions, type SessionCommMcpResult, } from "./session-comm";
 export { type McpStdioProtectionTarget, protectMcpStdio, } from "./stdio-protection";
 export { createSystemHealthMcpServer, defaultSystemHealthMcpHost, type SystemHealthMcpHost, type SystemHealthSnapshot, } from "./system-health";

package/dist/types/packages/core/src/mcp/runtime-spec.d.ts

@@ -10,7 +10,7 @@
 import { type AgentKind, type PeerRuntimeBridgeContext } from "../types";
 export declare const RUNTIME_MCP_KEY = "runtime";
 export declare const RUNTIME_MCP_BASE_PATH = "/mcp/runtime";
-export declare const HOSTED_MCP_SURFACES: readonly ["task", "token-stats", "system-health", "vault", "wiki", "skills", "session-comm", "agent-health"];
+export declare const HOSTED_MCP_SURFACES: readonly ["task", "decision", "token-stats", "system-health", "vault", "wiki", "skills", "session-comm", "agent-health"];
 export type HostedMcpSurface = (typeof HOSTED_MCP_SURFACES)[number];
 export interface RuntimeMcpContext {
     userId: string;

package/dist/types/packages/core/src/platform/config.d.ts

@@ -16,7 +16,7 @@ export declare const CLAUDE_EXECUTABLE: string | undefined;
 export declare const DEFAULT_OUTPUT_LANGUAGE = "English";
 export declare function resolveOutputLanguage(): string;
 /** Browser.rs release tested with this Negotium version. */
-export declare const BROWSER_RS_VERSION = "v0.1.19";
+export declare const BROWSER_RS_VERSION = "v0.1.21";
 /** Require the authenticated listener and the current Browser.rs tool contract. */
 export declare const BROWSER_RS_MIN_SECURE_VERSION = "0.1.15";
 /**
@@ -61,6 +61,7 @@ export declare const TSX_LOADER: string;
 export declare const TSCONFIG_PATH: string;
 export declare const SESSION_COMM_SERVER: string;
 export declare const TASK_SERVER: string;
+export declare const DECISION_SERVER: string;
 export declare const BROWSER_MCP_SSE_PROXY_SERVER: string;
 export declare const CANONICAL_MCP_PROXY_SERVER: string;
 export declare const WIKI_SERVER: string;

package/dist/types/packages/core/src/platform/mcp-catalog-policy.d.ts

@@ -21,6 +21,10 @@ export declare const COMMON_RUNTIME_MCP_POLICY: {
         readonly scopes: readonly ["dm", "forum", "manager", "cron"];
         readonly forumRequired: true;
     };
+    readonly decision: {
+        readonly scopes: readonly ["dm", "forum", "manager", "cron"];
+        readonly forumRequired: true;
+    };
     readonly "session-comm": {
         readonly scopes: readonly ["forum", "fork", "manager"];
         readonly forumRequired: true;

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/storage/decisions.d.ts

@@ -0,0 +1,45 @@
+import type { AgentKind, DecisionSnapshot } from "../types";
+export type StoredDecision = DecisionSnapshot;
+export declare const DECISION_STATUS_VALUES: readonly ["proposed", "accepted", "executed", "rejected", "superseded"];
+export declare function decisionScopeKey(opts: {
+    topicId?: string;
+    session: string;
+}): string;
+export declare function getDecisionFilePath(userId: number | string, scopeKey: string): string;
+export declare function getDecisionGraphSvgPath(userId: number | string, scopeKey: string): string;
+export declare function writeDecisionGraphSvg(userId: number | string, scopeKey: string, svg: string): string;
+export declare function readDecisions(userId: number | string, scopeKey: string): StoredDecision[];
+export declare function writeDecisions(userId: number | string, scopeKey: string, decisions: StoredDecision[]): void;
+export interface DecisionCreateInput {
+    action: string;
+    reasoning: string;
+    agent: AgentKind;
+    model?: string;
+    status?: StoredDecision["status"];
+    causedBy?: string[];
+    timestamp?: number;
+}
+export interface DecisionUpdateInput {
+    id: string;
+    action?: string;
+    reasoning?: string;
+    status?: StoredDecision["status"];
+    causedBy?: string[];
+}
+export declare function validateDecisionGraph(decisions: StoredDecision[]): void;
+export declare function createDecisions(decisions: StoredDecision[], inputs: DecisionCreateInput[]): {
+    decisions: StoredDecision[];
+    created: StoredDecision[];
+};
+export declare function updateDecisions(decisions: StoredDecision[], updates: DecisionUpdateInput[]): {
+    decisions: StoredDecision[];
+    missing: string[];
+};
+export declare function deleteDecisions(decisions: StoredDecision[], opts: {
+    ids?: string[];
+    all?: boolean;
+}): {
+    decisions: StoredDecision[];
+    removed: number;
+};
+export declare function renderDecisionList(decisions: StoredDecision[]): string;

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

@@ -15,6 +15,8 @@ export * as askUserGates from "./ask-user-gates";
 export * from "./ask-user-gates";
 export * as conversations from "./conversations";
 export * from "./conversations";
+export * as decisions from "./decisions";
+export * from "./decisions";
 export type { ForumTopicInfo, TopicRow, UserForumConfig, UserRow, } from "./forum/index";
 export * as forum from "./forum/index";
 export { addTopic, clearDmSessionId, clearSessionForTopic, findUserByThread, flushSessionCache, getAllTopics, getAllUserIds, getCommunicateThreadId, getDmSessionId, getLastShownConfig, getSessionForTopic, getTopicAgent, getTopicByName as getForumTopicByName, getTopicDescription, getTopicMcpConfig, getTopicNames, getUserConfig, removeTopic, renameTopic, setDmSessionId, setLastShownConfig, setSessionForTopic, setTopicAgent, setTopicDescription, setTopicForkOrigin, setTopicMcpEnabled, setTopicMcpExtra, updateTopicThreadId, } from "./forum/index";

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

@@ -77,6 +77,18 @@ export interface TaskSnapshot {
     /** Owner / agent name for multi-agent runs, when set. */
     owner?: string;
 }
+/** One topic-scoped decision and its incoming causal edges. */
+export interface DecisionSnapshot {
+    id: string;
+    action: string;
+    reasoning: string;
+    agent: AgentKind;
+    model?: string;
+    status: "proposed" | "accepted" | "executed" | "rejected" | "superseded";
+    /** Upstream decision ids. Each entry forms a directed upstream -> this edge. */
+    causedBy?: string[];
+    timestamp: number;
+}
 export type UnifiedEvent = {
     type: "user_message";
     content: string;

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

@@ -1 +1 @@
-export declare const NEGOTIUM_VERSION = "0.2.33";
+export declare const NEGOTIUM_VERSION = "0.3.1";

package/dist/vault.js

@@ -126,7 +126,7 @@ var DM_WORKSPACE_DIR = resolve(STATE_DIR, "data", "dm");
 var SESSION_WORKSPACE_DIR = resolve(STATE_DIR, "data", "sessions");
 var CLAUDE_EXECUTABLE_ENV = envText("NEGOTIUM_CLAUDE_EXECUTABLE");
 var CLAUDE_EXECUTABLE = CLAUDE_EXECUTABLE_ENV ? resolve(CLAUDE_EXECUTABLE_ENV) : undefined;
-var BROWSER_RS_VERSION = "v0.1.19";
+var BROWSER_RS_VERSION = "v0.1.21";
 var BROWSER_RS_MIN_SECURE_VERSION = "0.1.15";
 function versionAtLeast(actualVersion, minimumVersion) {
   const actual = actualVersion.split(".").map(Number);
@@ -196,6 +196,7 @@ var TSX_LOADER = createRequire(import.meta.url).resolve("tsx");
 var TSCONFIG_PATH = resolve(PROJECT_ROOT, "tsconfig.json");
 var SESSION_COMM_SERVER = resolve(PROJECT_ROOT, "src/mcp/session-comm/server.ts");
 var TASK_SERVER = resolve(PROJECT_ROOT, "src/mcp/task-server.ts");
+var DECISION_SERVER = resolve(PROJECT_ROOT, "src/mcp/decision-server.ts");
 var BROWSER_MCP_SSE_PROXY_SERVER = resolve(PROJECT_ROOT, "src/mcp/browser-sse-proxy-server.ts");
 var CANONICAL_MCP_PROXY_SERVER = resolve(PROJECT_ROOT, "src/mcp/canonical-proxy-server.ts");
 var WIKI_SERVER = resolve(PROJECT_ROOT, "src/mcp/wiki-server.ts");
@@ -773,4 +774,4 @@ export {
   VAULT_DESCRIPTION_MAX_LENGTH
 };
 
-//# debugId=F72AB94C01B5095364756E2164756E21
+//# debugId=BFFEA49F4053A73F64756E2164756E21