negotium 0.18.0 → 0.18.2

package/dist/runtime/src/agents/mcp-tools/spawn-subagent.ts

@@ -55,6 +55,11 @@ export interface SpawnSubagentToolContext {
 
 export type SubagentToolContext = Pick<SpawnSubagentToolContext, "userId" | "topicId">;
 
+export interface SubagentToolDefinitionOptions {
+  /** Otium owns provider routing, so its public tools inherit execution and omit overrides. */
+  executionOverrides?: boolean;
+}
+
 export interface SubagentWatch {
   parentTopicId: string;
   childTopicId: string;
@@ -157,8 +162,14 @@ export interface SubagentLifecycle<
   sweepStaleSubagentCards(): void;
   subagentReportMode(childTopicId: string): SubagentReportMode;
   createSubagentManagementToolDefinitions(ctx: SubagentToolContext): SharedMcpTool[];
-  createSpawnSubagentToolDefinition(ctx: TContext): SharedMcpTool;
-  createPrepareSubagentToolDefinition(ctx: TContext): SharedMcpTool;
+  createSpawnSubagentToolDefinition(
+    ctx: TContext,
+    options?: SubagentToolDefinitionOptions,
+  ): SharedMcpTool;
+  createPrepareSubagentToolDefinition(
+    ctx: TContext,
+    options?: SubagentToolDefinitionOptions,
+  ): SharedMcpTool;
 }
 
 export function createSubagentLifecycle<TContext extends SpawnSubagentToolContext>(
@@ -982,7 +993,25 @@ export function createSubagentLifecycle<TContext extends SpawnSubagentToolContex
     ];
   }
 
-  function createSpawnSubagentToolDefinition(ctx: TContext): SharedMcpTool {
+  function createSpawnSubagentToolDefinition(
+    ctx: TContext,
+    options: SubagentToolDefinitionOptions = {},
+  ): SharedMcpTool {
+    const executionOverrideSchema =
+      options.executionOverrides === false
+        ? {}
+        : {
+            agent: z
+              .enum(["claude", "codex", "maestro"])
+              .optional()
+              .describe("Agent backend override. Defaults to this room's agent."),
+            model: z
+              .string()
+              .optional()
+              .describe(
+                `Best-fit model override from the system prompt catalog. Omit agent+model to inherit ${ctx.agent}/${ctx.model ?? "default"}; overriding agent without model uses that agent's default.`,
+              ),
+          };
     return {
       name: "spawn_subagent",
       description:
@@ -1000,16 +1029,7 @@ export function createSubagentLifecycle<TContext extends SpawnSubagentToolContex
           .string()
           .optional()
           .describe("Short name for the subagent room. Auto-generated when omitted."),
-        agent: z
-          .enum(["claude", "codex", "maestro"])
-          .optional()
-          .describe("Agent backend override. Defaults to this room's agent."),
-        model: z
-          .string()
-          .optional()
-          .describe(
-            `Best-fit model override from the system prompt catalog. Omit agent+model to inherit ${ctx.agent}/${ctx.model ?? "default"}; overriding agent without model uses that agent's default.`,
-          ),
+        ...executionOverrideSchema,
         memory_topic: z
           .string()
           .optional()
@@ -1029,7 +1049,10 @@ export function createSubagentLifecycle<TContext extends SpawnSubagentToolContex
     };
   }
 
-  function createPrepareSubagentToolDefinition(ctx: TContext): SharedMcpTool {
+  function createPrepareSubagentToolDefinition(
+    ctx: TContext,
+    options: SubagentToolDefinitionOptions = {},
+  ): SharedMcpTool {
     return {
       name: "create_subagent",
       description:
@@ -1038,8 +1061,12 @@ export function createSubagentLifecycle<TContext extends SpawnSubagentToolContex
       schema: {
         task: z.string().describe("Self-contained task brief for the subagent."),
         name: z.string().optional().describe("Short room name. Auto-generated when omitted."),
-        agent: z.enum(["claude", "codex", "maestro"]).optional(),
-        model: z.string().optional(),
+        ...(options.executionOverrides === false
+          ? {}
+          : {
+              agent: z.enum(["claude", "codex", "maestro"]).optional(),
+              model: z.string().optional(),
+            }),
         memory_topic: z
           .string()
           .optional()

package/dist/runtime/src/mcp/factories/decision.ts

@@ -1,6 +1,7 @@
 import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
 import { z } from "zod";
 import { errMsg } from "#platform/error";
+import { getTopic } from "#storage/api-topics";
 import {
   createDecisions,
   DECISION_STATUS_VALUES,
@@ -21,6 +22,8 @@ export interface DecisionMcpContext {
   topicId?: string;
   agent: AgentKind;
   model?: string;
+  /** False for product surfaces that keep provider routing private. */
+  exposeExecutionMetadata?: boolean;
 }
 
 export interface DecisionMcpHost {
@@ -41,6 +44,9 @@ export function createDecisionMcpServer(
   const requireContext = (): ReturnType<typeof mcpError> | null =>
     !context.userId || !scopeKey ? mcpError("Error: missing userId/topic context.") : null;
   const statusEnum = z.enum(DECISION_STATUS_VALUES);
+  const exposeExecutionMetadata =
+    context.exposeExecutionMetadata ??
+    (!context.topicId || getTopic(context.topicId)?.surface !== "otium");
 
   server.tool(
     "decision_create",
@@ -146,9 +152,11 @@ export function createDecisionMcpServer(
         const decision = host
           .readDecisions(context.userId, scopeKey)
           .find((item) => item.id === id);
-        return decision
-          ? mcpOk(JSON.stringify(decision, null, 2))
-          : mcpError(`Decision #${id} not found.`);
+        if (!decision) return mcpError(`Decision #${id} not found.`);
+        const visibleDecision = exposeExecutionMetadata
+          ? decision
+          : (({ agent: _agent, model: _model, ...visible }) => visible)(decision);
+        return mcpOk(JSON.stringify(visibleDecision, null, 2));
       } catch (error) {
         return mcpError(`decision_get failed: ${errMsg(error)}`);
       }

package/dist/runtime/src/mcp/session-comm/server.ts

@@ -142,7 +142,7 @@ function canCurrentSubagentTell(targetTopicId: string): boolean {
 
 server.tool(
   "list_sessions",
-  "List all available Claude sessions (forum topics) for inter-session communication. Topics without an active session are still valid targets — ask_session / tell_session will wake them with a fresh session on first delivery.",
+  "List all available AI sessions (forum topics) for inter-session communication. Topics without an active session are still valid targets — ask_session / tell_session will wake them with a fresh session on first delivery.",
   {},
   async () => {
     const entries = listSessionTargetsForUser()

package/dist/runtime/src/platform/mcp-config.ts

@@ -40,6 +40,7 @@ import {
 } from "#platform/playwright/mcp-transport";
 import { getRegisteredCronSession } from "#runtime/cron-sessions";
 import type { HostMcpServerSpec } from "#runtime-gateway";
+import { getTopic } from "#storage/api-topics";
 import type { AgentKind, AgentQueryOptions, PeerRuntimeBridgeContext } from "#types";
 
 export type { RuntimeMcpScope } from "#platform/mcp-catalog-policy";
@@ -1111,37 +1112,10 @@ export function getMcpServersForQuery(opts: AgentQueryOptions): Record<string, u
   }
   if (opts.sessionType === "cron") {
     if (!opts.topicId) throw new Error("getMcpServersForQuery: cron sessionType requires topicId");
-    return getCronMcpServers({
-      userId: opts.userId || "local",
-      session: opts.session || "cron",
-      topicId: opts.topicId,
-      queryId: opts.queryId,
-      wikiTopicId: opts.wikiTopicId,
-      agent: opts.agent,
-      cwd: opts.cwd,
-      model: opts.model,
-      currentUserPrompt: opts.prompt,
-      playwrightPort: opts.playwrightPort,
-      playwrightCapability: opts.playwrightCapability,
-      visualTools: opts.visualTools,
-      fileDeliveryTools: opts.fileDeliveryTools,
-    });
-  }
-  if (opts.sessionType === "dm" || opts.sessionType === "ephemeral") {
-    return getDmMcpServers({
-      userId: opts.userId || "local",
-      session: opts.session,
-      topicId: opts.topicId,
-      agent: opts.agent,
-      playwrightPort: opts.playwrightPort,
-      playwrightCapability: opts.playwrightCapability,
-    });
-  }
-  if (opts.sessionType === "manager") {
-    return mergeHostMcpServers(
-      getManagerMcpServers({
+    return hideProviderIntrospectionForOtium(
+      getCronMcpServers({
         userId: opts.userId || "local",
-        session: opts.session,
+        session: opts.session || "cron",
         topicId: opts.topicId,
         queryId: opts.queryId,
         wikiTopicId: opts.wikiTopicId,
@@ -1151,37 +1125,84 @@ export function getMcpServersForQuery(opts: AgentQueryOptions): Record<string, u
         currentUserPrompt: opts.prompt,
         playwrightPort: opts.playwrightPort,
         playwrightCapability: opts.playwrightCapability,
-        autoContinue: opts.autoContinue,
         visualTools: opts.visualTools,
         fileDeliveryTools: opts.fileDeliveryTools,
       }),
-      opts.hostMcpServers,
+      opts.topicId,
     );
   }
-  return getForumMcpServers({
-    userId: opts.userId || "local",
-    actorUserId: opts.actorUserId,
-    vaultUserId: opts.vaultUserId,
-    session: opts.session || "default",
-    topicId: opts.topicId,
-    subagentParentTopicId: opts.subagentParentTopicId,
-    queryId: opts.queryId,
-    wikiTopicId: opts.wikiTopicId,
-    agent: opts.agent,
-    cwd: opts.cwd,
-    model: opts.model,
-    currentUserPrompt: opts.prompt,
-    playwrightPort: opts.playwrightPort,
-    playwrightCapability: opts.playwrightCapability,
-    bgBashPort: opts.bgBashPort,
-    autoContinue: opts.autoContinue,
-    visualTools: opts.visualTools,
-    fileDeliveryTools: opts.fileDeliveryTools,
-    threadRootId: opts.threadRootId,
-    depth: opts.depth,
-    enabled: opts.mcpEnabled,
-    extra: opts.mcpExtra,
-    silent: opts.silent,
-    peerBridge: opts.peerBridge,
-  });
+  if (opts.sessionType === "dm" || opts.sessionType === "ephemeral") {
+    return getDmMcpServers({
+      userId: opts.userId || "local",
+      session: opts.session,
+      topicId: opts.topicId,
+      agent: opts.agent,
+      playwrightPort: opts.playwrightPort,
+      playwrightCapability: opts.playwrightCapability,
+    });
+  }
+  if (opts.sessionType === "manager") {
+    return hideProviderIntrospectionForOtium(
+      mergeHostMcpServers(
+        getManagerMcpServers({
+          userId: opts.userId || "local",
+          session: opts.session,
+          topicId: opts.topicId,
+          queryId: opts.queryId,
+          wikiTopicId: opts.wikiTopicId,
+          agent: opts.agent,
+          cwd: opts.cwd,
+          model: opts.model,
+          currentUserPrompt: opts.prompt,
+          playwrightPort: opts.playwrightPort,
+          playwrightCapability: opts.playwrightCapability,
+          autoContinue: opts.autoContinue,
+          visualTools: opts.visualTools,
+          fileDeliveryTools: opts.fileDeliveryTools,
+        }),
+        opts.hostMcpServers,
+      ),
+      opts.topicId,
+    );
+  }
+  return hideProviderIntrospectionForOtium(
+    getForumMcpServers({
+      userId: opts.userId || "local",
+      actorUserId: opts.actorUserId,
+      vaultUserId: opts.vaultUserId,
+      session: opts.session || "default",
+      topicId: opts.topicId,
+      subagentParentTopicId: opts.subagentParentTopicId,
+      queryId: opts.queryId,
+      wikiTopicId: opts.wikiTopicId,
+      agent: opts.agent,
+      cwd: opts.cwd,
+      model: opts.model,
+      currentUserPrompt: opts.prompt,
+      playwrightPort: opts.playwrightPort,
+      playwrightCapability: opts.playwrightCapability,
+      bgBashPort: opts.bgBashPort,
+      autoContinue: opts.autoContinue,
+      visualTools: opts.visualTools,
+      fileDeliveryTools: opts.fileDeliveryTools,
+      threadRootId: opts.threadRootId,
+      depth: opts.depth,
+      enabled: opts.mcpEnabled,
+      extra: opts.mcpExtra,
+      silent: opts.silent,
+      peerBridge: opts.peerBridge,
+    }),
+    opts.topicId,
+  );
+}
+
+function hideProviderIntrospectionForOtium(
+  servers: Record<string, unknown>,
+  topicId: string | undefined,
+): Record<string, unknown> {
+  if (!topicId || getTopic(topicId)?.surface !== "otium") return servers;
+  const filtered = { ...servers };
+  delete filtered["agent-health"];
+  delete filtered["token-stats"];
+  return filtered;
 }

package/dist/runtime/src/prompts/builders.ts

@@ -272,6 +272,8 @@ export interface PromptBuilders {
 
 interface RuntimeToolSectionOpts {
   agentKind: AgentKind;
+  /** Product surfaces such as Otium own routing policy and must not expose provider details. */
+  hideExecutionDetails?: boolean;
   canSpawnSubagents?: boolean;
   canStageSubagents?: boolean;
   visualTools?: boolean;
@@ -294,6 +296,7 @@ function buildRuntimeToolSection(
 ): string {
   const {
     agentKind,
+    hideExecutionDetails = false,
     canSpawnSubagents = false,
     canStageSubagents = canSpawnSubagents,
     visualTools = false,
@@ -348,7 +351,9 @@ function buildRuntimeToolSection(
         "## Subagent Delegation",
         spawnSubagentToolLine,
         ...(canStageSubagents ? [lifecycleToolLine, subagentTopologyPolicyLine] : []),
-        "A subagent starts fresh but inherits this room's agent, model, and effective topic memory; include all required context, paths, and acceptance criteria in `task`.",
+        hideExecutionDetails
+          ? "A subagent starts fresh with this room's execution profile and effective topic memory; include all required context, paths, and acceptance criteria in `task`."
+          : "A subagent starts fresh but inherits this room's agent, model, and effective topic memory; include all required context, paths, and acceptance criteria in `task`.",
         "Subagents run asynchronously. Choose one result path: `auto` returns the final body to the direct parent; `tell` requires child `tell_session` to its recipient and does not auto-return the body; `status-only` returns lifecycle without content. Runtime length alone does not justify `status-only`. Do not wait or poll; continue or finish the turn.",
       ]
     : [];
@@ -356,7 +361,7 @@ function buildRuntimeToolSection(
     agentKind === "claude"
       ? `Do not use provider-native todo/task/subagent tools such as "TodoWrite", "Task", "Agent", "TaskCreate", "TaskUpdate", "TaskList", "TaskOutput", or "TaskStop"; they are disabled or not shared across agents.${canSpawnSubagents ? " For delegation, use the runtime spawn_subagent tool instead." : ""}`
       : agentKind === "maestro"
-        ? `Do not use provider-native task-store tools such as "TaskCreate", "TaskUpdate", "TaskList", "TaskGet", "TaskOutput", or "TaskStop"; they are disabled or not shared across agents. Do not use the Maestro "Agent" sub-agent tool either; it is disabled.${canSpawnSubagents ? " Use the runtime spawn_subagent tool for delegation so work is visible in its own room and reporting follows report_mode." : " Delegation is unavailable in this room."}`
+        ? `Do not use provider-native task-store tools such as "TaskCreate", "TaskUpdate", "TaskList", "TaskGet", "TaskOutput", or "TaskStop"; they are disabled or not shared across agents. Do not use the ${hideExecutionDetails ? "provider-native" : "Maestro"} "Agent" sub-agent tool either; it is disabled.${canSpawnSubagents ? " Use the runtime spawn_subagent tool for delegation so work is visible in its own room and reporting follows report_mode." : " Delegation is unavailable in this room."}`
         : 'Do not use provider-native goal/todo/plan surfaces such as "create_goal", "get_goal", "update_goal", "todo_list", or "update_plan"; they are disabled, ignored, or not shared across agents.';
   const visualSection = visualTools
     ? [
@@ -396,7 +401,9 @@ function buildRuntimeToolSection(
     "",
     "## Shared Tasks",
     taskToolLine,
-    "Use this shared task store for plans, progress, and checklist updates; it is visible across claude/codex/maestro turns.",
+    hideExecutionDetails
+      ? "Use this shared task store for plans, progress, and checklist updates; it is visible across all turns in this workspace."
+      : "Use this shared task store for plans, progress, and checklist updates; it is visible across claude/codex/maestro turns.",
     nativeTaskPolicyLine,
     "",
     "## Shared Decisions",
@@ -453,24 +460,25 @@ function buildRuntimeToolSection(
     "Agent guidance when the user explicitly asks to switch: `codex` for deepest reasoning and complex code/math; `claude` for tool-heavy MCP/file automation; `maestro` for inexpensive fast drafts and lighter experiments.",
   ];
 
+  const topicConfiguration = hideExecutionDetails
+    ? []
+    : [
+        ...extensions.render("before-topic-configuration"),
+        ...topicConfig,
+        ...extensions.render("after-topic-configuration"),
+      ];
+
   if (agentKind !== "claude") {
     return [
       ...shared,
-      ...extensions.render("before-topic-configuration"),
-      ...topicConfig,
-      ...extensions.render("after-topic-configuration"),
+      ...topicConfiguration,
       "",
       "## Runtime Tool Limits",
       "If file delivery or topic configuration tools are not present in your available tools for this session, do not claim you used them. Tell the user this session does not expose that in-chat tool action.",
     ].join("\n");
   }
 
-  return [
-    ...shared,
-    ...extensions.render("before-topic-configuration"),
-    ...topicConfig,
-    ...extensions.render("after-topic-configuration"),
-  ].join("\n");
+  return [...shared, ...topicConfiguration].join("\n");
 }
 
 export function createPromptBuilders(host: PromptBuilderHost = {}): PromptBuilders {
@@ -560,6 +568,7 @@ export function createPromptBuilders(host: PromptBuilderHost = {}): PromptBuilde
       buildRuntimeToolSection(
         {
           agentKind: opts.agentKind,
+          hideExecutionDetails: opts.surface === "otium",
           canSpawnSubagents: sessionKind === "channel" ? false : opts.canSpawnSubagents,
           canStageSubagents: sessionKind === "channel" ? false : opts.canStageSubagents,
           visualTools: opts.visualTools,
@@ -586,11 +595,19 @@ export function createPromptBuilders(host: PromptBuilderHost = {}): PromptBuilde
       // Substitute the same vars so a host manager template using placeholders
       // like {{RESPONSE_LANGUAGE}} never reaches the model unresolved.
       const managerTemplate = replaceVars(
-        template({
-          kind: "manager-system",
-          filename: "manager-system.md",
-          fallback: FALLBACK_MANAGER_SYSTEM_PROMPT_TEMPLATE,
-        }),
+        template(
+          opts.surface === "otium"
+            ? {
+                kind: "surface-profile",
+                filename: "surfaces/otium-manager.md",
+                fallback: FALLBACK_MANAGER_SYSTEM_PROMPT_TEMPLATE,
+              }
+            : {
+                kind: "manager-system",
+                filename: "manager-system.md",
+                fallback: FALLBACK_MANAGER_SYSTEM_PROMPT_TEMPLATE,
+              },
+        ),
         templateVars,
       );
       prompt += `\n\n${managerTemplate}`;

package/dist/runtime/src/prompts/sessions/surfaces/otium-manager.md

@@ -0,0 +1,18 @@
+## Manager Role
+This is the shared "General" hub of the user's Otium workspace.
+Act as the workspace manager: orient the user across rooms, summarize what is going on, and route focused work to the right room.
+
+Move substantial coding, browsing, long document work, or file conversion into a dedicated room when it benefits from focused context or tools. Handle small coordination tasks directly. General itself does not load browser tools.
+General is also the workspace memory hub for past decisions, archived rooms, and cross-room context.
+
+## State Check
+At the start of room-management work, call the host-provided `list_topics` tool first.
+- Resolve names from the current list before create, update, delete, or configuration changes.
+- Use only the public execution profiles offered by the host tools. Provider routing is private infrastructure and must not be inferred, requested, or disclosed.
+
+Use the host-provided topic administration tools for room creation, updates, resets, deletion, and MCP configuration. Confirm destructive operations with the user. Use session communication only when the user also asked to start or coordinate work in another room.
+
+## Worker Nodes
+Use `list_nodes`, `check_node`, and `get_node_health` for placement readiness. These tools intentionally expose operational readiness without provider routing details.
+
+After creating or changing a room, briefly state what changed and, when useful, suggest moving the next focused task into that room. Keep a concise, practical tone.

package/dist/runtime/src/version.ts

@@ -1 +1 @@
-export const NEGOTIUM_VERSION = "0.18.0";
+export const NEGOTIUM_VERSION = "0.18.2";

package/dist/types/packages/core/src/agents/mcp-tools/spawn-subagent.d.ts

@@ -15,6 +15,10 @@ export interface SpawnSubagentToolContext {
     model?: string;
 }
 export type SubagentToolContext = Pick<SpawnSubagentToolContext, "userId" | "topicId">;
+export interface SubagentToolDefinitionOptions {
+    /** Otium owns provider routing, so its public tools inherit execution and omit overrides. */
+    executionOverrides?: boolean;
+}
 export interface SubagentWatch {
     parentTopicId: string;
     childTopicId: string;
@@ -117,8 +121,8 @@ export interface SubagentLifecycle<TContext extends SpawnSubagentToolContext = S
     sweepStaleSubagentCards(): void;
     subagentReportMode(childTopicId: string): SubagentReportMode;
     createSubagentManagementToolDefinitions(ctx: SubagentToolContext): SharedMcpTool[];
-    createSpawnSubagentToolDefinition(ctx: TContext): SharedMcpTool;
-    createPrepareSubagentToolDefinition(ctx: TContext): SharedMcpTool;
+    createSpawnSubagentToolDefinition(ctx: TContext, options?: SubagentToolDefinitionOptions): SharedMcpTool;
+    createPrepareSubagentToolDefinition(ctx: TContext, options?: SubagentToolDefinitionOptions): SharedMcpTool;
 }
 export declare function createSubagentLifecycle<TContext extends SpawnSubagentToolContext>(host: SubagentLifecycleHost<TContext>): SubagentLifecycle<TContext>;
 export declare const computeSubagentDepth: (topicId: string) => number;
@@ -130,5 +134,5 @@ export declare const settleSubagentFailure: (queryId: string, reason: string) =>
 export declare const sweepStaleSubagentCards: () => void;
 export declare const subagentReportMode: (childTopicId: string) => SubagentReportMode;
 export declare const createSubagentManagementToolDefinitions: (ctx: SubagentToolContext) => SharedMcpTool[];
-export declare const createSpawnSubagentToolDefinition: (ctx: SpawnSubagentToolContext) => SharedMcpTool;
-export declare const createPrepareSubagentToolDefinition: (ctx: SpawnSubagentToolContext) => SharedMcpTool;
+export declare const createSpawnSubagentToolDefinition: (ctx: SpawnSubagentToolContext, options?: SubagentToolDefinitionOptions) => SharedMcpTool;
+export declare const createPrepareSubagentToolDefinition: (ctx: SpawnSubagentToolContext, options?: SubagentToolDefinitionOptions) => SharedMcpTool;

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

@@ -7,6 +7,8 @@ export interface DecisionMcpContext {
     topicId?: string;
     agent: AgentKind;
     model?: string;
+    /** False for product surfaces that keep provider routing private. */
+    exposeExecutionMetadata?: boolean;
 }
 export interface DecisionMcpHost {
     readDecisions(userId: string, scopeKey: string): StoredDecision[];

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

@@ -1 +1 @@
-export declare const NEGOTIUM_VERSION = "0.18.0";
+export declare const NEGOTIUM_VERSION = "0.18.2";

package/package.json

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