@pellux/goodvibes-agent 0.1.117 → 1.0.1

package/src/renderer/tool-call.ts

@@ -7,6 +7,16 @@ import { stripDangerousAnsi } from './ansi-sanitize.ts';
 const TOOL_NAME_MIN_WIDTH = 8;
 const TOOL_NAME_MAX_WIDTH = 20;
 
+function isRecord(value: unknown): value is Record<string, unknown> {
+  return Boolean(value) && typeof value === 'object' && !Array.isArray(value);
+}
+
+function readStringField(value: unknown, field: string): string | null {
+  if (!isRecord(value)) return null;
+  const fieldValue = value[field];
+  return typeof fieldValue === 'string' ? fieldValue : null;
+}
+
 function writeStyledText(
   line: Line,
   startCol: number,
@@ -100,32 +110,31 @@ function extractKeyArg(toolCall: ToolCall): string {
   if (Array.isArray(args.files) && args.files.length > 0) {
     const first = args.files[0];
     if (typeof first === 'string') return first;
-    if (first && typeof first === 'object' && typeof (first as Record<string, unknown>).path === 'string')
-      return (first as Record<string, unknown>).path as string;
+    const path = readStringField(first, 'path');
+    if (path) return path;
   }
   // Exec
   if (typeof args.command === 'string') return args.command;
   if (typeof args.cmd === 'string') return args.cmd;
   if (Array.isArray(args.commands) && args.commands.length > 0) {
     const first = args.commands[0];
-    if (first && typeof first === 'object' && typeof (first as Record<string, unknown>).cmd === 'string')
-      return (first as Record<string, unknown>).cmd as string;
+    const cmd = readStringField(first, 'cmd');
+    if (cmd) return cmd;
   }
   // Find/grep
   if (typeof args.pattern === 'string') return args.pattern;
   if (Array.isArray(args.queries) && args.queries.length > 0) {
     const first = args.queries[0];
-    if (first && typeof first === 'object') {
-      const firstRecord = first as Record<string, unknown>;
-      if (typeof firstRecord.query === 'string') return firstRecord.query;
-      if (typeof firstRecord.pattern === 'string') return firstRecord.pattern;
-    }
+    const query = readStringField(first, 'query');
+    if (query) return query;
+    const pattern = readStringField(first, 'pattern');
+    if (pattern) return pattern;
   }
   // Fetch
   if (Array.isArray(args.urls) && args.urls.length > 0) {
     const first = args.urls[0];
-    if (first && typeof first === 'object' && typeof (first as Record<string, unknown>).url === 'string')
-      return (first as Record<string, unknown>).url as string;
+    const url = readStringField(first, 'url');
+    if (url) return url;
   }
   // Agent
   if (typeof args.task === 'string') return args.task.slice(0, 40);

package/src/runtime/agent-runtime-events.ts

@@ -88,11 +88,11 @@ export function registerAgentRuntimeEvents(options: AgentRuntimeEventBridgeOptio
       const durationSeconds = record.completedAt !== undefined ? Math.round((record.completedAt - record.startedAt) / 1000) : 0;
       const taskSnippet = formatAgentTask(record.task);
       withRouter(getSystemMessageRouter, (router) => {
-        router.low(`[Agent task] ${record.template} ${payload.agentId.slice(-8)} completed in ${durationSeconds}s: "${taskSnippet}"`);
+        router.low(`[Delegated task] ${record.template} ${payload.agentId.slice(-8)} completed in ${durationSeconds}s "${taskSnippet}"`);
       });
       queueConversationFollowUp?.({
         key: `agent:${payload.agentId}:completed`,
-        summary: `${record.template} agent ${payload.agentId.slice(-8)} completed "${taskSnippet}" in ${durationSeconds}s after ${record.toolCallCount} tool calls.`,
+        summary: `${record.template} delegated task ${payload.agentId.slice(-8)} completed "${taskSnippet}" in ${durationSeconds}s after ${record.toolCallCount} tool calls.`,
       });
     }
     requestRender();
@@ -103,11 +103,11 @@ export function registerAgentRuntimeEvents(options: AgentRuntimeEventBridgeOptio
       const durationSeconds = record.completedAt !== undefined ? Math.round((record.completedAt - record.startedAt) / 1000) : 0;
       const taskSnippet = formatAgentTask(record.task);
       withRouter(getSystemMessageRouter, (router) => {
-        router.low(`[Agent task] ${record.template} ${payload.agentId.slice(-8)} failed in ${durationSeconds}s: ${payload.error.slice(0, 80)}`);
+        router.low(`[Delegated task] ${record.template} ${payload.agentId.slice(-8)} failed in ${durationSeconds}s ${payload.error.slice(0, 80)}`);
       });
       queueConversationFollowUp?.({
         key: `agent:${payload.agentId}:failed`,
-        summary: `${record.template} agent ${payload.agentId.slice(-8)} failed while working on "${taskSnippet}": ${payload.error.slice(0, 120)}`,
+        summary: `${record.template} delegated task ${payload.agentId.slice(-8)} failed while working on "${taskSnippet}" ${payload.error.slice(0, 120)}`,
       });
     }
     requestRender();
@@ -117,9 +117,9 @@ export function registerAgentRuntimeEvents(options: AgentRuntimeEventBridgeOptio
   agentStatusIntervalRef.value = setInterval(() => {
     const running = agentManager.list().filter((agent) => agent.status === 'running');
     if (running.length === 0) return;
-    const lines = running.map((agent) => `  ${agent.id.slice(-8)}: ${agent.progress ?? agent.status}`);
+    const lines = running.map((agent) => `  ${agent.id.slice(-8)} ${agent.progress ?? agent.status}`);
     withRouter(getSystemMessageRouter, (router) => {
-      router.low(`[Agent task] ${running.length} running:\n${lines.join('\n')}`);
+      router.low(`[Delegated task] ${running.length} running\n${lines.join('\n')}`);
     });
     requestRender();
   }, AGENT_STATUS_INTERVAL_MS);

package/src/runtime/bootstrap-command-context.ts

@@ -39,6 +39,8 @@ import type { PeerClient } from '@/runtime/index.ts';
 import type { DirectTransport } from '@/runtime/index.ts';
 import type { VoiceProviderRegistry, VoiceService } from '@pellux/goodvibes-sdk/platform/voice';
 import type { MediaProviderRegistry } from '@pellux/goodvibes-sdk/platform/media';
+import type { ArtifactStore } from '@pellux/goodvibes-sdk/platform/artifacts';
+import type { ChannelDeliveryRouter } from '@pellux/goodvibes-sdk/platform/channels';
 import {
   createBootstrapCommandActions,
   createBootstrapCommandClientsSection,
@@ -63,6 +65,8 @@ export type CreateBootstrapCommandContextOptions = {
   voiceProviderRegistry?: VoiceProviderRegistry;
   voiceService?: VoiceService;
   mediaProviderRegistry?: MediaProviderRegistry;
+  artifactStore?: ArtifactStore;
+  channelDeliveryRouter?: ChannelDeliveryRouter;
   forensicsRegistry: ForensicsRegistry;
   policyRuntimeState: PolicyRuntimeState;
   readModels: UiReadModels;
@@ -133,6 +137,8 @@ export function createBootstrapCommandContext(
     voiceProviderRegistry,
     voiceService,
     mediaProviderRegistry,
+    artifactStore,
+    channelDeliveryRouter,
     forensicsRegistry,
     policyRuntimeState,
     readModels,
@@ -240,7 +246,7 @@ export function createBootstrapCommandContext(
     projectPlanningProjectId,
     workPlanStore,
   }, shellServices);
-  const platform = createBootstrapCommandPlatformSection({ configManager, voiceProviderRegistry, voiceService, mediaProviderRegistry }, shellServices);
+  const platform = createBootstrapCommandPlatformSection({ configManager, voiceProviderRegistry, voiceService, mediaProviderRegistry, artifactStore, channelDeliveryRouter }, shellServices);
   const extensions = createBootstrapCommandExtensionsSection({
     toolRegistry,
     mcpRegistry,

package/src/runtime/bootstrap-command-parts.ts

@@ -42,6 +42,8 @@ import type { PeerClient } from '@/runtime/index.ts';
 import type { DirectTransport } from '@/runtime/index.ts';
 import type { VoiceProviderRegistry, VoiceService } from '@pellux/goodvibes-sdk/platform/voice';
 import type { MediaProviderRegistry } from '@pellux/goodvibes-sdk/platform/media';
+import type { ArtifactStore } from '@pellux/goodvibes-sdk/platform/artifacts';
+import type { ChannelDeliveryRouter } from '@pellux/goodvibes-sdk/platform/channels';
 import { summarizeError } from '@pellux/goodvibes-sdk/platform/utils';
 
 export type BootstrapCommandSessionSection = CommandContext['session'];
@@ -79,6 +81,8 @@ export interface BootstrapCommandSectionOptions {
   readonly voiceProviderRegistry?: VoiceProviderRegistry;
   readonly voiceService?: VoiceService;
   readonly mediaProviderRegistry?: MediaProviderRegistry;
+  readonly artifactStore?: ArtifactStore;
+  readonly channelDeliveryRouter?: ChannelDeliveryRouter;
   readonly forensicsRegistry: ForensicsRegistry;
   readonly policyRuntimeState: PolicyRuntimeState;
   readonly readModels: UiReadModels;
@@ -150,7 +154,6 @@ export function createBootstrapCommandActions(
   | 'exit'
   | 'reloadSystemPrompt'
   | 'showPanel'
-  | 'openPolicyPanel'
   | 'openMcpWorkspace'
   | 'openAgentWorkspace'
   | 'openSecurityPanel'
@@ -173,7 +176,7 @@ export function createBootstrapCommandActions(
   const showPanel = (panelId: string, pane?: 'top' | 'bottom') => {
     void pane;
     panelManager.hide();
-    conversation.log(`Panel "${panelId}" is deferred in GoodVibes Agent. Use /agent for the operator workspace.`, { fg: '214' });
+    conversation.log(`Panel route "${panelId}" is handled through Agent Workspace. Use /agent for current operator controls.`, { fg: '214' });
     requestRender();
   };
 
@@ -201,7 +204,7 @@ export function createBootstrapCommandActions(
           // Write to tool LLM config keys and enable the tool LLM
           configManager.set('tools.llmProvider', def.provider);
           configManager.set('tools.llmModel', key);
-          configManager.setDynamic('tools.llmEnabled' as never, true);
+          configManager.setDynamic('tools.llmEnabled', true);
           conversation.log(`Tool LLM set to: ${def.displayName} (${def.provider})`, { fg: '135' });
         } else if (resolvedTarget === 'tts') {
           configManager.set('tts.llmProvider', def.provider);
@@ -238,9 +241,6 @@ export function createBootstrapCommandActions(
     exit: () => unwiredShellAction('exit'),
     reloadSystemPrompt: loadSystemPrompt,
     showPanel,
-    openPolicyPanel: () => {
-      showPanel('policy');
-    },
     openMcpWorkspace: () => unwiredShellAction('openMcpWorkspace'),
     openAgentWorkspace: () => unwiredShellAction('openAgentWorkspace'),
     openSecurityPanel: () => {
@@ -309,7 +309,7 @@ export function createBootstrapCommandWorkspaceSection(
 export function createBootstrapCommandPlatformSection(
   options: Pick<
     BootstrapCommandSectionOptions,
-    'configManager' | 'voiceProviderRegistry' | 'voiceService' | 'mediaProviderRegistry'
+    'configManager' | 'voiceProviderRegistry' | 'voiceService' | 'mediaProviderRegistry' | 'artifactStore' | 'channelDeliveryRouter'
   >,
   shellServices: BootstrapCommandShellServices,
 ): BootstrapCommandPlatformSection {
@@ -319,6 +319,8 @@ export function createBootstrapCommandPlatformSection(
     voiceProviderRegistry: options.voiceProviderRegistry,
     voiceService: options.voiceService,
     mediaProviderRegistry: options.mediaProviderRegistry,
+    artifactStore: options.artifactStore,
+    channelDeliveryRouter: options.channelDeliveryRouter,
     ...shellServices.platform,
   };
 }

package/src/runtime/bootstrap-core.ts

@@ -29,7 +29,16 @@ import { registerBootstrapHookBridge } from '@/runtime/index.ts';
 import { createRuntimeServices, type RuntimeServices } from './services.ts';
 import { createUiRuntimeServices, type UiRuntimeServices } from './ui-services.ts';
 import { installAgentToolPolicyGuard } from '../tools/agent-tool-policy-guard.ts';
+import { registerAgentChannelSendTool } from '../tools/agent-channel-send-tool.ts';
+import { registerAgentKnowledgeIngestTool } from '../tools/agent-knowledge-ingest-tool.ts';
+import { registerAgentKnowledgeTool } from '../tools/agent-knowledge-tool.ts';
 import { registerAgentLocalRegistryTool } from '../tools/agent-local-registry-tool.ts';
+import { registerAgentMediaGenerateTool } from '../tools/agent-media-generate-tool.ts';
+import { registerAgentNotifyTool } from '../tools/agent-notify-tool.ts';
+import { registerAgentOperatorActionTool } from '../tools/agent-operator-action-tool.ts';
+import { registerAgentOperatorBriefingTool } from '../tools/agent-operator-briefing-tool.ts';
+import { registerAgentReminderScheduleTool } from '../tools/agent-reminder-schedule-tool.ts';
+import { registerAgentWorkPlanTool } from '../tools/agent-work-plan-tool.ts';
 import { GOODVIBES_AGENT_SURFACE_ROOT } from '../config/surface.ts';
 import { registerAgentRuntimeEvents } from './agent-runtime-events.ts';
 
@@ -139,7 +148,7 @@ export async function initializeBootstrapCore(
     metadata: {
       product: 'goodvibes-agent',
       surfaceRoot: GOODVIBES_AGENT_SURFACE_ROOT,
-      clientKindNote: 'SDK has no dedicated agent client kind yet; using service for the Agent operator surface.',
+      clientKindNote: 'SDK compatibility client kind; GoodVibes Agent remains an interactive operator TUI.',
     },
   }, 'bootstrap.control-plane');
 
@@ -227,7 +236,16 @@ export async function initializeBootstrapCore(
     overflowHandler: services.overflowHandler,
     changeTracker: services.sessionChangeTracker,
   });
+  registerAgentKnowledgeIngestTool(toolRegistry, services.shellPaths, configManager);
+  registerAgentChannelSendTool(toolRegistry, services.channelDeliveryRouter);
+  registerAgentKnowledgeTool(toolRegistry, services.shellPaths, configManager);
   registerAgentLocalRegistryTool(toolRegistry, services.shellPaths, services.memoryRegistry);
+  registerAgentMediaGenerateTool(toolRegistry, services.mediaProviders, services.artifactStore);
+  registerAgentNotifyTool(toolRegistry, configManager, services.webhookNotifier);
+  registerAgentOperatorActionTool(toolRegistry, services.shellPaths, configManager);
+  registerAgentOperatorBriefingTool(toolRegistry, services.shellPaths, configManager);
+  registerAgentReminderScheduleTool(toolRegistry, services.shellPaths, configManager);
+  registerAgentWorkPlanTool(toolRegistry, services.workPlanStore);
   installAgentToolPolicyGuard(toolRegistry, {
     getLastUserMessage: () => conversation.getLastUserMessage(),
   });

package/src/runtime/bootstrap-hook-bridge.ts

@@ -10,9 +10,9 @@ import type { ConfigManager } from '@pellux/goodvibes-sdk/platform/config';
 import { formatReturnContextForDisplay, getReturnContextMode, maybeAssistReturnContextSummary } from '@/runtime/index.ts';
 import type { SharedSessionBroker } from '@pellux/goodvibes-sdk/platform/control-plane';
 import type { SessionManager } from '@pellux/goodvibes-sdk/platform/sessions';
-import type { PanelManager } from '../panels/panel-manager.ts';
 import type { ProviderRegistry } from '@pellux/goodvibes-sdk/platform/providers';
 import { summarizeError } from '@pellux/goodvibes-sdk/platform/utils';
+import { readConversationMessageSnapshots } from '../core/conversation-message-snapshot.ts';
 
 export interface ResumeSessionOptions {
   readonly runtimeBus: RuntimeEventBus;
@@ -24,7 +24,6 @@ export interface ResumeSessionOptions {
   readonly writeLastSessionPointer: (sessionId: string) => void;
   readonly hookDispatcher: HookDispatcher;
   readonly sessionManager: SessionManager;
-  readonly panelManager: PanelManager;
   readonly configManager: Pick<ConfigManager, 'get' | 'getCategory'>;
   readonly providerRegistry: Pick<ProviderRegistry, 'get' | 'getCurrentModel' | 'getForModel' | 'require'>;
 }
@@ -42,7 +41,7 @@ export function createResumeSessionHandler(options: ResumeSessionOptions): (sess
         turnCount: messages.length,
       });
       options.conversation.fromJSON({
-        messages: messages as Parameters<typeof options.conversation.fromJSON>[0]['messages'],
+        messages: readConversationMessageSnapshots(messages),
         title: meta.title,
         titleSource: meta.titleSource,
       });
@@ -53,28 +52,18 @@ export function createResumeSessionHandler(options: ResumeSessionOptions): (sess
       options.writeLastSessionPointer(sessionId);
       void options.sharedSessionBroker.reopenSession(sessionId).catch((err) => { logger.debug('session broker reopen session failed', { err }); });
       options.conversation.log(`Resumed session: ${sessionId}`, { fg: '135' });
-      const reopenedPanels: string[] = [];
-      if (meta.returnContext?.openPanels?.length) {
-        for (const panelId of meta.returnContext.openPanels.slice(0, 4)) {
-          try {
-            options.panelManager.open(panelId);
-            reopenedPanels.push(panelId);
-          } catch {
-            // Ignore unavailable panels during restore.
-          }
-        }
-        if (reopenedPanels.length > 0) options.panelManager.show();
-      }
+      const ignoredPanels = meta.returnContext?.openPanels?.slice(0, 4) ?? [];
       const returnContextMode = getReturnContextMode(options.configManager);
       if (returnContextMode !== 'off' && meta.returnContext) {
         for (const line of formatReturnContextForDisplay(meta.returnContext)) {
+          if (line.startsWith('Open panels:')) continue;
           options.conversation.log(`Resume: ${line}`, { fg: '244' });
         }
-        if (reopenedPanels.length > 0) {
-          options.conversation.log(`Resume: Reopened panels: ${reopenedPanels.join(', ')}`, { fg: '244' });
+        if (ignoredPanels.length > 0) {
+          options.conversation.log(`Resume: Saved panel state ignored: ${ignoredPanels.join(', ')}. Open the Agent workspace for current operator controls.`, { fg: '244' });
         }
         if ((meta.returnContext.remoteRunners?.length ?? 0) > 0) {
-          options.conversation.log('Resume: Remote runner recovery belongs outside Agent; delegate explicit build/fix/review recovery from Agent.', { fg: '244' });
+          options.conversation.log('Resume: Remote build-host recovery belongs outside Agent; delegate explicit build/fix/review recovery from Agent.', { fg: '244' });
         }
         if (returnContextMode === 'assisted') {
           const helperModel = new HelperModel({

package/src/runtime/bootstrap-shell.ts

@@ -133,7 +133,6 @@ export function createBootstrapShell(options: BootstrapShellOptions): BootstrapS
     writeLastSessionPointer,
     hookDispatcher: services.hookDispatcher,
     sessionManager: services.sessionManager,
-    panelManager: services.panelManager,
     configManager,
     providerRegistry: services.providerRegistry,
   });
@@ -180,7 +179,7 @@ export function createBootstrapShell(options: BootstrapShellOptions): BootstrapS
     hookActivityTracker: services.hookActivityTracker,
     hookWorkbench: services.hookWorkbench,
     mcpRegistry: services.mcpRegistry,
-    daemonHomeDir: join(services.homeDirectory, '.goodvibes', 'daemon'),
+    connectedHostTokenDir: join(services.homeDirectory, '.goodvibes', 'daemon'),
   });
   services.panelManager.prewarmRegistered();
 
@@ -198,9 +197,8 @@ export function createBootstrapShell(options: BootstrapShellOptions): BootstrapS
 
   const commandRegistry = new CommandRegistry();
   registerBuiltinCommands(commandRegistry);
-  type RuntimeFoundationInput = Parameters<typeof createRuntimeFoundationClients>[0];
   const foundationClients = createRuntimeFoundationClients({
-    runtimeServices: services as unknown as RuntimeFoundationInput['runtimeServices'],
+    runtimeServices: services,
     tasksReadModel: uiServices.readModels.tasks,
     taskManager,
     opsControlPlane,
@@ -236,6 +234,8 @@ export function createBootstrapShell(options: BootstrapShellOptions): BootstrapS
     voiceProviderRegistry: services.voiceProviders,
     voiceService: services.voiceService,
     mediaProviderRegistry: services.mediaProviders,
+    artifactStore: services.artifactStore,
+    channelDeliveryRouter: services.channelDeliveryRouter,
     forensicsRegistry,
     policyRuntimeState,
     readModels: uiServices.readModels,

package/src/runtime/bootstrap.ts

@@ -45,14 +45,23 @@ import { buildReviewedMemoryPrompt } from '../agent/memory-prompt.ts';
 
 const GOODVIBES_AGENT_OPERATOR_POLICY = [
   '## GoodVibes Agent Operator Policy',
-  '- Default to serial, proactive assistant work in the main conversation. Answer, inspect, summarize, remember useful non-secret facts, configure local Agent state, use read-only connected-host/operator routes, and take safe non-destructive actions without spawning local agents or WRFC.',
+  '- Default to serial, proactive assistant work in the main conversation. Answer, inspect, summarize, remember useful non-secret facts, configure Agent-local state, use read-only connected-host/operator routes, and take safe non-destructive actions without creating separate Agent jobs or GoodVibes TUI delegations.',
   '- GoodVibes Agent connects to a GoodVibes host owned outside this package. Do not start, stop, restart, install, expose, or mutate connected-host network/listener posture from Agent.',
-  '- Use the `agent_local_registry` tool when a durable memory, reusable persona, skill, skill bundle, or routine would improve future work. Keep those records local, non-secret, source/provenance tagged, and reviewable. Review memory with a confidence score when it should shape future turns. Starting a routine means applying its steps in this same serial conversation, not creating a background job.',
-  '- WRFC is never the default Agent reasoning path. Do not create local WRFC chains for planning, research, operations, knowledge, memory, configuration, approvals, automation observability, or ordinary assistant work.',
-  '- GoodVibes Agent is not the coding TUI. Do not use the `agent` tool to spawn local Engineer, Reviewer, Tester, Verifier, or batch-spawn roots from Agent.',
-  '- When the user explicitly asks to build, implement, fix, patch, or review code, preserve the full original user ask and delegate one build request to GoodVibes TUI through the public shared-session/build-delegation contract. Include clear executionIntent and request WRFC only for explicit build/fix/review work or when the user explicitly asks for WRFC/agent review.',
-  '- Do not narrow explicit build/fix/review requests into design-only, read-only, or no-write work unless the user explicitly requested that limitation. TUI owns file edits, git/worktree work, execution isolation UX, and the WRFC owner chain.',
-  '- If a stable public delegation route is unavailable, say that the task needs GoodVibes TUI delegation and report the missing route instead of pretending to implement it locally or spawning sibling local agents.',
+  '- Use the `agent_operator_briefing` tool for read-only main-conversation summaries of connected work plan, approvals, automation, schedules, and scheduler capacity. This tool must not call mutation routes, connected-host lifecycle routes, default knowledge, non-Agent knowledge spaces, separate Agent job creation, or GoodVibes TUI delegation.',
+  '- When the user explicitly asks Agent to approve, deny, or cancel a specific approval, run/pause/resume a specific automation job, cancel/retry a specific automation run, or run a specific schedule, use the `agent_operator_action` tool with confirm:true and the original user request. It can call only its allowlisted public operator routes and must not create, edit, delete, or discover automation definitions.',
+  '- Use the `agent_work_plan` tool to keep the visible Agent-local work plan current while working in the main conversation. Create, inspect, and update local work items proactively when useful. Removing items or clearing completed items requires an explicit user request and confirm:true.',
+  '- Use the `agent_knowledge` tool for Agent Knowledge status, ask, and search from the main conversation. It must use only /api/goodvibes-agent/knowledge/* and must fail closed instead of falling back to default knowledge or non-Agent knowledge spaces.',
+  '- When the user explicitly asks Agent to add, import, remember, or ingest a URL, URL-list file, local file, bookmarks file, browser history, or connector input into Agent Knowledge, use the `agent_knowledge_ingest` tool with confirm:true and the original user request. It must write only to /api/goodvibes-agent/knowledge/* ingest routes and never to default knowledge or non-Agent knowledge spaces.',
+  '- Use the `agent_local_registry` tool when a scratchpad note, durable memory, reusable persona, skill, skill bundle, or routine would improve later work. Keep those records Agent-local, non-secret, source/provenance tagged, and reviewable. Notes are for temporary/source-triage context; promote them explicitly into memory, skills, personas, routines, or Agent Knowledge only when that is the correct durable home. Review memory with a confidence score when it should shape later turns. Starting a routine means applying its steps in this same serial conversation, not creating a background job.',
+  '- When the user explicitly asks Agent to generate an image, video, or other media artifact, use the `agent_media_generate` tool with confirm:true and the original user request. Generated media is stored as artifacts; do not print base64, call default knowledge, use non-Agent knowledge spaces, send channels, create separate Agent jobs, or request GoodVibes TUI delegation for media generation.',
+  '- When the user explicitly asks Agent to send an alert, message, or notification to configured notification targets, use the `agent_notify` tool with confirm:true and the original user request. Do not infer external notifications from vague suggestions, and never create channel routes or account authorizations from the main conversation.',
+  '- When the user explicitly asks Agent to send one message to a specific configured channel, route, webhook, or link target, use the `agent_channel_send` tool with confirm:true and the original user request. It can deliver one message through configured delivery strategies, but must not create routes, authorize accounts, manage connected-host hosting, use default knowledge, use non-Agent knowledge spaces, create separate Agent jobs, or request GoodVibes TUI delegation.',
+  '- When the user explicitly asks for a reminder or asks Agent to schedule a reminder, use the `agent_reminder_schedule` tool with confirm:true and the original user request. That creates one connected schedules.create reminder on the external GoodVibes host. Do not infer reminders from vague suggestions or routine startup, and never create local scheduler jobs.',
+  '- GoodVibes TUI delegation is never the default Agent reasoning path. Do not delegate planning, research, operations, knowledge, memory, configuration, approvals, automation observability, or ordinary assistant work.',
+  '- GoodVibes Agent is not the coding TUI. Do not use the `agent` tool to create coding-role Agent jobs or batch job roots from Agent.',
+  '- When the user explicitly asks to build, implement, fix, patch, or review code, preserve the full original user ask and delegate one build request to GoodVibes TUI through the public shared-session/build-delegation contract. Include clear executionIntent and request delegated review only for explicit build/fix/review work or when the user explicitly asks for delegated Agent review.',
+  '- Do not narrow explicit build/fix/review requests into design-only, read-only, or no-write work unless the user explicitly requested that limitation. TUI owns file edits, git/worktree work, execution isolation UX, and delegated review coordination.',
+  '- If a stable public delegation route is unavailable, say that the task needs GoodVibes TUI delegation and report the missing route instead of pretending to implement it locally or creating sibling Agent jobs.',
 ].join('\n');
 
 function joinPromptParts(...parts: Array<string | null | undefined>): string {
@@ -126,7 +135,7 @@ export type BootstrapContext = RuntimeContext & {
  *   1. Config, caches, keybindings
  *   2. Runtime event bus, conversation, compositor, selection
  *   3. Tool registry + agent wiring
- *   4. Runtime bus subscriptions (WRFC, subagent, hook bridge)
+ *   4. Runtime bus subscriptions (delegation, subagent, hook bridge)
  *   5. Providers, webhooks, PermissionManager, HookDispatcher
  *   6. Orchestrator and Agent-local task read models
  *   7. MCP auto-connect + workspace/panel manager
@@ -295,7 +304,7 @@ export async function bootstrapRuntime(
     },
   };
 
-  // ── Phase 7: External services + deferred startup ──────────────────────
+  // ── Phase 7: Connected-host posture + deferred startup ────────────────
 
   const deferredStartup = createDeferredStartupCoordinator();
 
@@ -310,7 +319,7 @@ export async function bootstrapRuntime(
     return `http://${urlHost}:${port}`;
   };
 
-  const createExternalAgentServiceStatus = (
+  const createAgentDependencyStatus = (
     service: 'daemon' | 'httpListener',
   ): HostServiceStatus => {
     const host = String(configManager.get(service === 'daemon' ? 'controlPlane.host' : 'httpListener.host') ?? '127.0.0.1');
@@ -321,7 +330,7 @@ export async function bootstrapRuntime(
       port,
       baseUrl: formatHostServiceBaseUrl(host, port),
       reason: service === 'daemon'
-        ? 'GoodVibes Agent connects to a GoodVibes host owned outside this product and does not start or restart them.'
+        ? 'GoodVibes Agent connects to a GoodVibes host owned outside this product and does not start or restart it.'
         : 'GoodVibes Agent does not own listener lifecycle.',
     };
   };
@@ -330,15 +339,15 @@ export async function bootstrapRuntime(
 
   const hostServiceIsBlocked = (status: HostServiceStatus): boolean => status.mode === 'blocked';
 
-  const inspectExternalServices = () => {
+  const inspectAgentDependencies = () => {
     const daemonStatus = externalServices.daemonStatus;
     const httpListenerStatus = externalServices.httpListenerStatus;
     return {
-      daemonRunning: hostServiceIsActive(daemonStatus),
-      daemonPortInUse: hostServiceIsBlocked(daemonStatus),
+      connectedHostRunning: hostServiceIsActive(daemonStatus),
+      connectedHostPortInUse: hostServiceIsBlocked(daemonStatus),
       httpListenerRunning: hostServiceIsActive(httpListenerStatus),
       httpListenerPortInUse: hostServiceIsBlocked(httpListenerStatus),
-      daemonStatus,
+      connectedHostStatus: daemonStatus,
       httpListenerStatus,
     };
   };
@@ -346,8 +355,8 @@ export async function bootstrapRuntime(
   let externalServices: ExternalServicesHandle = {
     daemonServer: null,
     httpListener: null,
-    daemonStatus: createExternalAgentServiceStatus('daemon'),
-    httpListenerStatus: createExternalAgentServiceStatus('httpListener'),
+    daemonStatus: createAgentDependencyStatus('daemon'),
+    httpListenerStatus: createAgentDependencyStatus('httpListener'),
     listRecentControlPlaneEvents: () => [],
     async stop(): Promise<void> {},
   };
@@ -355,16 +364,16 @@ export async function bootstrapRuntime(
     externalServices: NonNullable<typeof uiServices.platform.externalServices>;
   };
   platformExternalServices.externalServices = {
-    inspect: inspectExternalServices,
+    inspect: inspectAgentDependencies,
     restart: async () => {
       externalServices = {
         ...externalServices,
-        daemonStatus: createExternalAgentServiceStatus('daemon'),
-        httpListenerStatus: createExternalAgentServiceStatus('httpListener'),
+        daemonStatus: createAgentDependencyStatus('daemon'),
+        httpListenerStatus: createAgentDependencyStatus('httpListener'),
       };
       systemMessageRouter.high('[Startup] GoodVibes Agent does not start or restart the connected GoodVibes host. Start it from GoodVibes TUI or the owning host, then refresh status.');
       requestRender();
-      return inspectExternalServices();
+      return inspectAgentDependencies();
     },
   };
   deferredStartup.schedule({
@@ -440,7 +449,7 @@ export async function bootstrapRuntime(
   bootstrapUnsubs.push(() => mcpAutoReload.stop());
   if (configManager.get('automation.enabled')) {
     logger.warn('Local automation startup is disabled in GoodVibes Agent; use connected-host observability instead.');
-    systemMessageRouter.low('[Startup] Local automation runners are disabled in GoodVibes Agent; use read-only automation observability or explicit connected-host actions.');
+    systemMessageRouter.low('[Startup] Local automation execution is disabled in GoodVibes Agent; use read-only automation observability or explicit connected-host actions.');
   }
 
   // ── Phase 12: Session:start lifecycle hook ─────────────────────────────

package/src/runtime/connected-host-auth.ts

@@ -1,3 +1,4 @@
+import { createHash } from 'node:crypto';
 import { existsSync, readFileSync } from 'node:fs';
 import { join } from 'node:path';
 
@@ -32,11 +33,15 @@ export function readConnectedHostOperatorToken(homeDirectory: string): Connected
   }
 }
 
+export function connectedHostOperatorTokenFingerprint(token: string): string {
+  return createHash('sha256').update(token).digest('hex').slice(0, 12);
+}
+
 export function connectedHostTokenRequiredMessage(path: string): string {
   return [
     'Connected-host operator token is required.',
-    `  token path: ${path}`,
+    `  token path ${path}`,
     '  Agent does not create or rotate connected-host auth tokens.',
-    '  Start or repair the owning GoodVibes host, then rerun this command.',
+    '  Provision or repair connected-host access through the owning GoodVibes host, then rerun this command.',
   ].join('\n');
 }

package/src/runtime/diagnostics/panels/index.ts

@@ -12,8 +12,8 @@ export type { InspectableDomain } from '@/runtime/index.ts';
 export { HealthPanel } from '@/runtime/index.ts';
 export { DivergencePanel } from '@/runtime/index.ts';
 export { ReplayPanel } from '@/runtime/index.ts';
-export { PolicyPanel } from './policy.ts';
-export type { PolicyPanelSnapshot } from './policy.ts';
+export { PolicyDiagnosticsPanel } from './policy.ts';
+export type { PolicyDiagnosticsSnapshot } from './policy.ts';
 export { ToolContractsPanel } from '@/runtime/index.ts';
 export { TransportPanel } from '@/runtime/index.ts';
 export type { TransportPanelSnapshot } from '@/runtime/index.ts';

package/src/runtime/diagnostics/panels/policy.ts

@@ -1,5 +1,5 @@
 /**
- * Policy diagnostics panel data provider.
+ * Policy diagnostics data provider.
  *
  * Wraps a `PolicyRegistry` and optionally a `DivergencePanel` to expose
  * combined policy state (current bundle, candidate, simulation status,
@@ -24,7 +24,7 @@ import { logger } from '@pellux/goodvibes-sdk/platform/utils';
 /**
  * A point-in-time snapshot of policy state for diagnostics rendering.
  */
-export interface PolicyPanelSnapshot {
+export interface PolicyDiagnosticsSnapshot {
   /** The currently enforced bundle, or null if no policy is active. */
   current: PolicyBundleVersion | null;
   /** The pending candidate bundle, or null if none loaded. */
@@ -48,12 +48,12 @@ export interface PolicyPanelSnapshot {
 }
 
 /**
- * PolicyPanel — diagnostics data provider for the policy registry.
+ * PolicyDiagnosticsPanel — diagnostics data provider for the policy registry.
  *
  * Usage:
  * ```ts
  * const registry = new PolicyRegistry();
- * const panel = new PolicyPanel(registry, divergencePanel);
+ * const panel = new PolicyDiagnosticsPanel(registry, divergencePanel);
  *
  * panel.subscribe(() => {
  *   const snap = panel.getSnapshot();
@@ -67,7 +67,7 @@ export interface PolicyPanelSnapshot {
  * panel.dispose();
  * ```
  */
-export class PolicyPanel {
+export class PolicyDiagnosticsPanel {
   private readonly _registry: PolicyRegistry;
   private readonly _divergencePanel: DivergencePanel | null;
   private readonly _config: PanelConfig;
@@ -118,7 +118,7 @@ export class PolicyPanel {
   /**
    * getSnapshot — Returns the current combined policy + divergence snapshot.
    */
-  public getSnapshot(): PolicyPanelSnapshot {
+  public getSnapshot(): PolicyDiagnosticsSnapshot {
     const current = this._registry.getCurrent();
     const candidate = this._registry.getCandidate();
     const rawHistory = this._registry.getHistory();
@@ -170,7 +170,7 @@ export class PolicyPanel {
       try {
         cb();
       } catch (err) {
-        logger.warn(`[PolicyPanel] subscriber error: ${err}`);
+        logger.warn(`[PolicyDiagnosticsPanel] subscriber error: ${err}`);
       }
     }
   }

package/src/runtime/index.ts

@@ -112,7 +112,7 @@ function agentExternalHostStatus(
     port,
     baseUrl: `http://${host}:${port}`,
     reason: service === 'daemon'
-      ? 'GoodVibes Agent connects to a GoodVibes host owned outside this product and does not start or restart them.'
+      ? 'GoodVibes Agent connects to a GoodVibes host owned outside this product and does not start or restart it.'
       : 'GoodVibes Agent does not own listener lifecycle.',
   };
 }
@@ -437,6 +437,7 @@ export const summarizeWorktreeOwnership = shell.summarizeWorktreeOwnership;
 export const listPersistedWorktreeMeta = shell.listPersistedWorktreeMeta;
 export const getPersistedWorktreeMeta = shell.getPersistedWorktreeMeta;
 export const reviewWorktreeAttachments = shell.reviewWorktreeAttachments;
+export const WorktreeRegistry = shell.WorktreeRegistry;
 
 export type MutableRuntimeState = Shell.MutableRuntimeState;
 export type ProviderAccountRecord = Shell.ProviderAccountRecord;