@pellux/goodvibes-agent 0.1.117 → 1.0.0

package/src/input/agent-workspace-snapshot.ts

@@ -1,7 +1,9 @@
 import { basename, sep } from 'node:path';
 import type { MemoryRecord } from '@pellux/goodvibes-sdk/platform/state';
 import type { CommandContext } from './command-registry.ts';
+import { AgentNoteRegistry, type AgentNoteRecord } from '../agent/note-registry.ts';
 import { AgentPersonaRegistry, type AgentPersonaRecord } from '../agent/persona-registry.ts';
+import { formatAgentRecordOrigin } from '../agent/record-labels.ts';
 import { AgentRoutineRegistry, evaluateAgentRoutineReadiness, type AgentRoutineRecord } from '../agent/routine-registry.ts';
 import {
   AgentSkillRegistry,
@@ -14,23 +16,24 @@ import {
 import { summarizeAgentBehaviorDiscovery } from '../agent/behavior-discovery-summary.ts';
 import { isPromptActiveMemory } from '../agent/memory-prompt.ts';
 import { getAgentRuntimeProfilesRoot, listAgentRuntimeProfiles, listAgentRuntimeProfileTemplates, readAgentRuntimeProfileSelection } from '../agent/runtime-profile.ts';
+import { RoutineScheduleReceiptStore } from '../agent/routine-schedule-receipts.ts';
+import { GOODVIBES_AGENT_PAIRING_SURFACE } from '../config/surface.ts';
+import { connectedHostOperatorTokenFingerprint, readConnectedHostOperatorToken, type ConnectedHostOperatorToken } from '../runtime/connected-host-auth.ts';
 import { buildAgentWorkspaceChannels } from './agent-workspace-channels.ts';
+import { getAgentWorkspaceConfigReader } from './agent-workspace-config-reader.ts';
 import { buildAgentWorkspaceSetupChecklist } from './agent-workspace-setup.ts';
 import { buildAgentWorkspaceVoiceMediaReadiness, type AgentWorkspaceVoiceMediaProviderDescriptor } from './agent-workspace-voice-media.ts';
 import type {
   AgentWorkspaceLocalLibraryItem,
+  AgentWorkspaceRoutineScheduleReceiptSummary,
   AgentWorkspaceRuntimeProfileItem,
   AgentWorkspaceRuntimeSnapshot,
   AgentWorkspaceRuntimeStarterTemplateItem,
 } from './agent-workspace-types.ts';
 
-type AgentWorkspaceConfigReader = {
-  get(key: string): unknown;
-};
-
 function readConfigString(context: CommandContext, key: string, fallback: string): string {
   try {
-    const configManager = context.platform?.configManager as unknown as AgentWorkspaceConfigReader | undefined;
+    const configManager = getAgentWorkspaceConfigReader(context);
     const value = configManager?.get(key);
     return typeof value === 'string' && value.trim().length > 0 ? value.trim() : fallback;
   } catch {
@@ -40,7 +43,7 @@ function readConfigString(context: CommandContext, key: string, fallback: string
 
 function readConfigNumber(context: CommandContext, key: string, fallback: number): number {
   try {
-    const configManager = context.platform?.configManager as unknown as AgentWorkspaceConfigReader | undefined;
+    const configManager = getAgentWorkspaceConfigReader(context);
     const value = configManager?.get(key);
     const numberValue = typeof value === 'number' ? value : Number(value);
     return Number.isFinite(numberValue) ? numberValue : fallback;
@@ -51,7 +54,7 @@ function readConfigNumber(context: CommandContext, key: string, fallback: number
 
 function readConfigBoolean(context: CommandContext, key: string, fallback: boolean): boolean {
   try {
-    const configManager = context.platform?.configManager as unknown as AgentWorkspaceConfigReader | undefined;
+    const configManager = getAgentWorkspaceConfigReader(context);
     const value = configManager?.get(key);
     if (typeof value === 'boolean') return value;
     if (typeof value === 'string') {
@@ -82,7 +85,7 @@ function summarizePersonaItem(persona: AgentPersonaRecord, activePersonaId: stri
     name: persona.name,
     description: persona.description,
     reviewState: persona.reviewState,
-    source: persona.source,
+    source: formatAgentRecordOrigin(persona.source, persona.provenance),
     tags: persona.tags,
     triggers: persona.triggers,
     active: persona.id === activePersonaId,
@@ -96,7 +99,7 @@ function summarizeSkillItem(skill: AgentSkillRecord): AgentWorkspaceLocalLibrary
     name: skill.name,
     description: skill.description,
     reviewState: skill.reviewState,
-    source: skill.source,
+    source: formatAgentRecordOrigin(skill.source, skill.provenance),
     tags: skill.tags,
     triggers: skill.triggers,
     enabled: skill.enabled,
@@ -117,7 +120,7 @@ function summarizeSkillBundleItem(bundle: AgentSkillBundleRecord, skills: readon
     name: bundle.name,
     description: `${bundle.description} Skills: ${bundle.skillIds.join(', ')}`,
     reviewState: bundle.reviewState,
-    source: bundle.source,
+    source: formatAgentRecordOrigin(bundle.source, bundle.provenance),
     tags: bundle.skillIds,
     triggers: [],
     enabled: bundle.enabled,
@@ -134,7 +137,7 @@ function summarizeRoutineItem(routine: AgentRoutineRecord): AgentWorkspaceLocalL
     name: routine.name,
     description: routine.description,
     reviewState: routine.reviewState,
-    source: routine.source,
+    source: formatAgentRecordOrigin(routine.source, routine.provenance),
     tags: routine.tags,
     triggers: routine.triggers,
     enabled: routine.enabled,
@@ -145,6 +148,21 @@ function summarizeRoutineItem(routine: AgentRoutineRecord): AgentWorkspaceLocalL
   };
 }
 
+function summarizeRoutineScheduleReceipt(
+  receipt: ReturnType<RoutineScheduleReceiptStore['snapshot']>['receipts'][number],
+): AgentWorkspaceRoutineScheduleReceiptSummary {
+  return {
+    id: receipt.id,
+    status: receipt.status,
+    routineId: receipt.routineId,
+    routineName: receipt.routineName,
+    scheduleName: receipt.scheduleName,
+    scheduleKind: receipt.scheduleKind,
+    scheduleValue: receipt.scheduleValue,
+    createdAt: receipt.createdAt,
+  };
+}
+
 function summarizeMemoryItem(record: MemoryRecord): AgentWorkspaceLocalLibraryItem {
   const detail = record.detail?.trim();
   return {
@@ -152,7 +170,7 @@ function summarizeMemoryItem(record: MemoryRecord): AgentWorkspaceLocalLibraryIt
     name: record.summary,
     description: detail && detail.length > 0 ? detail : `${record.scope}/${record.cls}`,
     reviewState: record.reviewState,
-    source: 'agent-memory',
+    source: 'Agent memory',
     tags: record.tags,
     triggers: [],
     scope: record.scope,
@@ -161,6 +179,22 @@ function summarizeMemoryItem(record: MemoryRecord): AgentWorkspaceLocalLibraryIt
   };
 }
 
+function summarizeNoteItem(note: AgentNoteRecord): AgentWorkspaceLocalLibraryItem {
+  const preview = note.body.replace(/\s+/g, ' ').trim();
+  const description = note.sourceUrl
+    ? `${preview.slice(0, 160)}${preview.length > 160 ? '...' : ''} Origin URL ${note.sourceUrl}`
+    : preview;
+  return {
+    id: note.id,
+    name: note.title,
+    description,
+    reviewState: note.reviewState,
+    source: formatAgentRecordOrigin(note.source, note.provenance),
+    tags: note.tags,
+    triggers: [],
+  };
+}
+
 function summarizeRuntimeProfile(profile: ReturnType<typeof listAgentRuntimeProfiles>[number]): AgentWorkspaceRuntimeProfileItem {
   return {
     id: profile.id,
@@ -231,6 +265,20 @@ export function buildAgentWorkspaceRuntimeSnapshot(context: CommandContext): Age
       return { count: 0, activeName: '(unavailable)', items: [] };
     }
   })();
+  const noteSnapshot = (() => {
+    try {
+      const shellPaths = context.workspace?.shellPaths;
+      if (!shellPaths) return { count: 0, reviewQueueCount: 0, items: [] };
+      const snapshot = AgentNoteRegistry.fromShellPaths(shellPaths).snapshot();
+      return {
+        count: snapshot.notes.length,
+        reviewQueueCount: snapshot.reviewQueue.length,
+        items: snapshot.notes.map(summarizeNoteItem),
+      };
+    } catch {
+      return { count: 0, reviewQueueCount: 0, items: [] };
+    }
+  })();
   const skillSnapshot = (() => {
     try {
       const shellPaths = context.workspace?.shellPaths;
@@ -263,6 +311,21 @@ export function buildAgentWorkspaceRuntimeSnapshot(context: CommandContext): Age
       return { count: 0, enabled: 0, items: [] };
     }
   })();
+  const routineScheduleReceipts = (() => {
+    try {
+      const shellPaths = context.workspace?.shellPaths;
+      if (!shellPaths) return { count: 0, successful: 0, failed: 0, latest: null };
+      const receipts = RoutineScheduleReceiptStore.fromShellPaths(shellPaths).snapshot().receipts;
+      return {
+        count: receipts.length,
+        successful: receipts.filter((receipt) => receipt.status === 'created').length,
+        failed: receipts.filter((receipt) => receipt.status === 'failed').length,
+        latest: receipts[0] ? summarizeRoutineScheduleReceipt(receipts[0]) : null,
+      };
+    } catch {
+      return { count: 0, successful: 0, failed: 0, latest: null };
+    }
+  })();
   const discoveredBehavior = summarizeAgentBehaviorDiscovery(context.workspace?.shellPaths);
   const profileBaseHome = inferRuntimeProfileBaseHome(context.workspace?.shellPaths?.homeDirectory ?? '');
   const runtimeProfiles = (() => {
@@ -336,6 +399,32 @@ export function buildAgentWorkspaceRuntimeSnapshot(context: CommandContext): Age
   const ttsLlmProvider = readConfigString(context, 'tts.llmProvider', '');
   const ttsLlmModel = readConfigString(context, 'tts.llmModel', '');
   const runtimeBaseUrl = `http://${host}:${port}`;
+  const companionAccess = (() => {
+    const homeDirectory = context.workspace?.shellPaths?.homeDirectory ?? '';
+    const tokenRecord: ConnectedHostOperatorToken = homeDirectory.length > 0
+      ? readConnectedHostOperatorToken(homeDirectory)
+      : { path: '(Agent home unavailable)', present: false, token: null };
+    const tokenFingerprint = tokenRecord.token ? connectedHostOperatorTokenFingerprint(tokenRecord.token) : null;
+    const pairingReady = Boolean(tokenRecord.token);
+    const nextStep = tokenRecord.error
+      ? 'Repair the connected-host operator token file through the owning GoodVibes host, then rerun /pair.'
+      : pairingReady
+        ? 'Use /pair to scan the QR code. Manual token display stays hidden unless /pair --show-token --yes is used.'
+        : 'Pair or provision connected-host access through the owning GoodVibes host, then rerun /pair.';
+    return {
+      surface: GOODVIBES_AGENT_PAIRING_SURFACE,
+      hostUrl: runtimeBaseUrl,
+      tokenPath: tokenRecord.path,
+      tokenPresent: tokenRecord.present,
+      tokenReadable: Boolean(tokenRecord.token),
+      tokenFingerprint,
+      tokenError: tokenRecord.error ?? null,
+      pairingReady,
+      qrCommand: '/pair',
+      manualTokenCommand: '/pair --show-token --yes',
+      nextStep,
+    } as const;
+  })();
   const channels = buildAgentWorkspaceChannels(context);
   const voiceMediaReadiness = buildAgentWorkspaceVoiceMediaReadiness({
     context,
@@ -349,6 +438,8 @@ export function buildAgentWorkspaceRuntimeSnapshot(context: CommandContext): Age
     sessionMemoryCount,
     localMemoryCount: memorySnapshot.count,
     localMemoryReviewQueueCount: memorySnapshot.reviewQueueCount,
+    localNoteCount: noteSnapshot.count,
+    localNoteReviewQueueCount: noteSnapshot.reviewQueueCount,
     routineCount: routineSnapshot.count,
     enabledRoutineCount: routineSnapshot.enabled,
     missingRoutineRequirementCount: routineSnapshot.items.reduce((total, item) => total + (item.missingRequirementCount ?? 0), 0),
@@ -382,9 +473,16 @@ export function buildAgentWorkspaceRuntimeSnapshot(context: CommandContext): Age
     localMemoryReviewQueueCount: memorySnapshot.reviewQueueCount,
     localMemoryPromptActiveCount: memorySnapshot.promptActiveCount,
     localMemories: memorySnapshot.items,
+    localNoteCount: noteSnapshot.count,
+    localNoteReviewQueueCount: noteSnapshot.reviewQueueCount,
+    localNotes: noteSnapshot.items,
     localRoutineCount: routineSnapshot.count,
     enabledRoutineCount: routineSnapshot.enabled,
     localRoutines: routineSnapshot.items,
+    routineScheduleReceiptCount: routineScheduleReceipts.count,
+    successfulRoutineScheduleReceiptCount: routineScheduleReceipts.successful,
+    failedRoutineScheduleReceiptCount: routineScheduleReceipts.failed,
+    latestRoutineScheduleReceipt: routineScheduleReceipts.latest,
     localSkillCount: skillSnapshot.count,
     enabledSkillCount: skillSnapshot.enabled,
     localSkillBundleCount: skillSnapshot.bundleCount,
@@ -399,7 +497,8 @@ export function buildAgentWorkspaceRuntimeSnapshot(context: CommandContext): Age
     knowledgeRoute: '/api/goodvibes-agent/knowledge',
     knowledgeIsolation: 'agent-only',
     executionPolicy: 'serial-proactive',
-    wrfcPolicy: 'explicit-build-delegation-only',
+    delegatedReviewPolicy: 'explicit-build-delegation-only',
+    companionAccess,
     channels,
     voiceProviderCount: voiceProviders.length,
     voiceStreamingProviderCount: voiceProviders.filter((entry) => entry.capabilities.includes('tts-stream')).length,

package/src/input/agent-workspace-task-command-editors.ts

@@ -14,7 +14,7 @@ export function createAgentWorkspaceTaskCommandEditor(kind: AgentWorkspaceTaskCo
     return {
       kind,
       mode: 'create',
-      title: 'Filter Runtime Tasks',
+      title: 'Filter Host Tasks',
       selectedFieldIndex: 0,
       message: 'List connected-host tasks filtered by status or kind. This is read-only and never creates, retries, or cancels tasks.',
       fields: [
@@ -30,18 +30,18 @@ export function createAgentWorkspaceTaskCommandEditor(kind: AgentWorkspaceTaskCo
       selectedFieldIndex: 0,
       message: 'Print one connected-host task output from the Agent workspace. This is read-only and does not retry, cancel, or mutate the task.',
       fields: [
-        { id: 'taskId', label: 'Task id', value: '', required: true, multiline: false, hint: 'Connected-host task id from Runtime tasks.' },
+        { id: 'taskId', label: 'Task id', value: '', required: true, multiline: false, hint: 'Connected-host task id from Host tasks.' },
       ],
     };
   }
   return {
     kind,
     mode: 'create',
-    title: 'Inspect Runtime Task',
+    title: 'Inspect Host Task',
     selectedFieldIndex: 0,
     message: 'Inspect one connected-host task from the Agent workspace. This is read-only and does not retry, cancel, or mutate the task.',
     fields: [
-      { id: 'taskId', label: 'Task id', value: '', required: true, multiline: false, hint: 'Connected-host task id from Runtime tasks.' },
+      { id: 'taskId', label: 'Task id', value: '', required: true, multiline: false, hint: 'Connected-host task id from Host tasks.' },
     ],
   };
 }

package/src/input/agent-workspace-token.ts

@@ -25,11 +25,25 @@ export function handleAgentWorkspaceToken(
   }
 
   if (token.type === 'key') {
+    if (workspace.actionSearchActive) {
+      if (token.logicalName === 'escape') workspace.clearActionSearch();
+      else if (token.logicalName === 'enter') workspace.activateSelected(requestRender);
+      else if (token.logicalName === 'up') workspace.moveUp();
+      else if (token.logicalName === 'down') workspace.moveDown();
+      else if (token.logicalName === 'home') workspace.jumpHome();
+      else if (token.logicalName === 'end') workspace.jumpEnd();
+      else if (token.logicalName === 'backspace' || token.logicalName === 'delete') workspace.actionSearchBackspace();
+      else if (token.logicalName === 'space') workspace.appendActionSearchText(' ');
+      requestRender();
+      return true;
+    }
     if (token.logicalName === 'escape') {
       handleEscape();
       return true;
     }
-    if (token.logicalName === 'enter' || token.logicalName === 'space') workspace.activateSelected(requestRender);
+    if (token.ctrl === true && token.logicalName === ']') workspace.cycleCategory('next');
+    else if (token.ctrl === true && token.logicalName === '[') workspace.cycleCategory('prev');
+    else if (token.logicalName === 'enter' || token.logicalName === 'space') workspace.activateSelected(requestRender);
     else if (token.logicalName === 'left') workspace.focusCategories();
     else if (token.logicalName === 'right') workspace.focusActions();
     else if (token.logicalName === 'up') workspace.moveUp();
@@ -38,7 +52,9 @@ export function handleAgentWorkspaceToken(
     else if (token.logicalName === 'home') workspace.jumpHome();
     else if (token.logicalName === 'end') workspace.jumpEnd();
   } else if (token.type === 'text') {
-    if (token.value === 'h') workspace.focusCategories();
+    if (workspace.actionSearchActive) workspace.appendActionSearchText(token.value);
+    else if (token.value === '/') workspace.beginActionSearch();
+    else if (token.value === 'h') workspace.focusCategories();
     else if (token.value === 'l') workspace.focusActions();
     else if (token.value === 'j') workspace.moveDown();
     else if (token.value === 'k') workspace.moveUp();

package/src/input/agent-workspace-types.ts

@@ -7,12 +7,38 @@ export const AGENT_WORKSPACE_MODAL_NAME = 'agentWorkspace';
 
 export type AgentWorkspaceFocusPane = 'categories' | 'actions';
 
+export const AGENT_WORKSPACE_CATEGORY_IDS = [
+  'home',
+  'setup',
+  'research',
+  'artifacts',
+  'conversation',
+  'channels',
+  'tools',
+  'knowledge',
+  'voice-media',
+  'profiles',
+  'memory',
+  'notes',
+  'personas',
+  'skills',
+  'routines',
+  'work',
+  'host',
+  'automation',
+  'delegate',
+] as const;
+
+export type AgentWorkspaceCategoryId = (typeof AGENT_WORKSPACE_CATEGORY_IDS)[number];
+
 export type AgentWorkspaceActionKind = 'command' | 'guidance' | 'workspace' | 'editor' | 'local-selection' | 'local-operation';
 
-export type AgentWorkspaceLocalEditorKind = 'memory' | 'persona' | 'skill' | 'routine' | 'profile';
+export type AgentWorkspaceLocalEditorKind = 'memory' | 'note' | 'persona' | 'skill' | 'routine' | 'profile';
 
 export type AgentWorkspaceEditorKind =
   | AgentWorkspaceLocalEditorKind
+  | 'web-research'
+  | 'web-fetch'
   | 'knowledge-url'
   | 'knowledge-urls'
   | 'knowledge-file'
@@ -55,12 +81,14 @@ export type AgentWorkspaceEditorKind =
   | 'notify-webhook-remove'
   | 'notify-webhook-clear'
   | 'notify-webhook-test'
+  | 'notify-send'
   | 'secret-set'
   | 'secret-link'
   | 'secret-test'
   | 'secret-delete'
   | 'tts-prompt'
   | 'image-input'
+  | 'media-generate'
   | 'skill-bundle'
   | 'skill-bundle-search'
   | 'skill-bundle-show'
@@ -116,6 +144,7 @@ export type AgentWorkspaceEditorKind =
   | 'channel-show'
   | 'channel-doctor'
   | 'channel-setup'
+  | 'channel-send'
   | 'session-save'
   | 'session-load'
   | 'session-rename'
@@ -135,6 +164,15 @@ export type AgentWorkspaceEditorKind =
   | 'plan-clear'
   | 'health-repair'
   | 'approval-review'
+  | 'approval-approve'
+  | 'approval-deny'
+  | 'approval-cancel'
+  | 'automation-job-run'
+  | 'automation-job-pause'
+  | 'automation-job-resume'
+  | 'automation-run-cancel'
+  | 'automation-run-retry'
+  | 'schedule-run'
   | 'routine-receipt'
   | 'schedule-receipt'
   | 'mode-preset'
@@ -155,6 +193,15 @@ export type AgentWorkspaceLocalOperation =
   | 'memory-review'
   | 'memory-stale'
   | 'memory-delete'
+  | 'note-edit'
+  | 'note-review'
+  | 'note-stale'
+  | 'note-delete'
+  | 'note-promote-memory'
+  | 'note-promote-persona'
+  | 'note-promote-skill'
+  | 'note-promote-routine'
+  | 'note-promote-knowledge-url'
   | 'persona-edit'
   | 'persona-use'
   | 'persona-review'
@@ -197,7 +244,7 @@ export interface AgentWorkspaceAction {
   readonly label: string;
   readonly detail: string;
   readonly command?: string;
-  readonly targetCategoryId?: string;
+  readonly targetCategoryId?: AgentWorkspaceCategoryId;
   readonly editorKind?: AgentWorkspaceEditorKind;
   readonly localKind?: AgentWorkspaceLocalEditorKind;
   readonly selectionDelta?: number;
@@ -207,7 +254,7 @@ export interface AgentWorkspaceAction {
 }
 
 export interface AgentWorkspaceCategory {
-  readonly id: string;
+  readonly id: AgentWorkspaceCategoryId;
   readonly group: string;
   readonly label: string;
   readonly summary: string;
@@ -215,7 +262,15 @@ export interface AgentWorkspaceCategory {
   readonly actions: readonly AgentWorkspaceAction[];
 }
 
+export interface AgentWorkspaceActionSearchResult {
+  readonly category: AgentWorkspaceCategory;
+  readonly categoryIndex: number;
+  readonly action: AgentWorkspaceAction;
+  readonly actionIndex: number;
+}
+
 export type AgentWorkspaceCommandDispatcher = (command: string) => void;
+export type AgentWorkspacePromptDispatcher = (prompt: string) => void;
 
 export type AgentWorkspaceActionResultKind = 'guidance' | 'blocked' | 'dispatched' | 'refreshed' | 'error';
 
@@ -264,6 +319,31 @@ export interface AgentWorkspaceRuntimeStarterTemplateItem {
   readonly source: string;
 }
 
+export interface AgentWorkspaceRoutineScheduleReceiptSummary {
+  readonly id: string;
+  readonly status: string;
+  readonly routineId: string;
+  readonly routineName: string;
+  readonly scheduleName: string;
+  readonly scheduleKind: string;
+  readonly scheduleValue: string;
+  readonly createdAt: string;
+}
+
+export interface AgentWorkspaceCompanionAccessSummary {
+  readonly surface: 'goodvibes-agent';
+  readonly hostUrl: string;
+  readonly tokenPath: string;
+  readonly tokenPresent: boolean;
+  readonly tokenReadable: boolean;
+  readonly tokenFingerprint: string | null;
+  readonly tokenError: string | null;
+  readonly pairingReady: boolean;
+  readonly qrCommand: '/pair';
+  readonly manualTokenCommand: '/pair --show-token --yes';
+  readonly nextStep: string;
+}
+
 export interface AgentWorkspaceRuntimeSnapshot {
   readonly provider: string;
   readonly model: string;
@@ -278,9 +358,16 @@ export interface AgentWorkspaceRuntimeSnapshot {
   readonly localMemoryReviewQueueCount: number;
   readonly localMemoryPromptActiveCount: number;
   readonly localMemories: readonly AgentWorkspaceLocalLibraryItem[];
+  readonly localNoteCount: number;
+  readonly localNoteReviewQueueCount: number;
+  readonly localNotes: readonly AgentWorkspaceLocalLibraryItem[];
   readonly localRoutineCount: number;
   readonly enabledRoutineCount: number;
   readonly localRoutines: readonly AgentWorkspaceLocalLibraryItem[];
+  readonly routineScheduleReceiptCount: number;
+  readonly successfulRoutineScheduleReceiptCount: number;
+  readonly failedRoutineScheduleReceiptCount: number;
+  readonly latestRoutineScheduleReceipt: AgentWorkspaceRoutineScheduleReceiptSummary | null;
   readonly localSkillCount: number;
   readonly enabledSkillCount: number;
   readonly localSkillBundleCount: number;
@@ -295,7 +382,8 @@ export interface AgentWorkspaceRuntimeSnapshot {
   readonly knowledgeRoute: '/api/goodvibes-agent/knowledge';
   readonly knowledgeIsolation: 'agent-only';
   readonly executionPolicy: 'serial-proactive';
-  readonly wrfcPolicy: 'explicit-build-delegation-only';
+  readonly delegatedReviewPolicy: 'explicit-build-delegation-only';
+  readonly companionAccess: AgentWorkspaceCompanionAccessSummary;
   readonly channels: readonly AgentWorkspaceChannelStatus[];
   readonly voiceProviderCount: number;
   readonly voiceStreamingProviderCount: number;

package/src/input/agent-workspace-voice-media.ts

@@ -1,4 +1,5 @@
 import type { CommandContext } from './command-registry.ts';
+import { getAgentWorkspaceConfigReader } from './agent-workspace-config-reader.ts';
 
 export type AgentWorkspaceVoiceMediaDomain = 'voice' | 'media';
 export type AgentWorkspaceVoiceMediaSetupState = 'ready' | 'registered' | 'needs-secret' | 'not-registered';
@@ -36,10 +37,6 @@ export interface AgentWorkspaceVoiceMediaReadiness {
   readonly nextSteps: readonly string[];
 }
 
-type AgentWorkspaceConfigReader = {
-  get(key: string): unknown;
-};
-
 type ProviderSecretSpec = {
   readonly id: string;
   readonly secretKeyOptions: readonly string[];
@@ -66,7 +63,7 @@ const MEDIA_SECRET_SPECS: readonly ProviderSecretSpec[] = [
 
 function readConfigString(context: CommandContext, key: string, fallback: string): string {
   try {
-    const configManager = context.platform?.configManager as unknown as AgentWorkspaceConfigReader | undefined;
+    const configManager = getAgentWorkspaceConfigReader(context);
     const value = configManager?.get(key);
     return typeof value === 'string' && value.trim().length > 0 ? value.trim() : fallback;
   } catch {
@@ -76,7 +73,7 @@ function readConfigString(context: CommandContext, key: string, fallback: string
 
 function readConfigBoolean(context: CommandContext, key: string, fallback: boolean): boolean {
   try {
-    const configManager = context.platform?.configManager as unknown as AgentWorkspaceConfigReader | undefined;
+    const configManager = getAgentWorkspaceConfigReader(context);
     const value = configManager?.get(key);
     if (typeof value === 'boolean') return value;
     if (typeof value === 'string') {

package/src/input/agent-workspace-web-research-editor.ts

@@ -0,0 +1,104 @@
+import type { AgentWorkspaceActionResult, AgentWorkspaceLocalEditor } from './agent-workspace-types.ts';
+
+type AgentWorkspaceFieldReader = (fieldId: string) => string;
+export type AgentWorkspaceWebResearchMode = 'research' | 'fetch';
+
+export type AgentWorkspaceWebResearchSubmission =
+  | {
+    readonly kind: 'editor';
+    readonly editor: AgentWorkspaceLocalEditor;
+    readonly status: string;
+    readonly actionResult?: AgentWorkspaceActionResult;
+  }
+  | {
+    readonly kind: 'prompt';
+    readonly prompt: string;
+    readonly status: string;
+    readonly actionResult: AgentWorkspaceActionResult;
+  };
+
+export function createAgentWorkspaceWebResearchEditor(mode: AgentWorkspaceWebResearchMode): AgentWorkspaceLocalEditor {
+  if (mode === 'fetch') {
+    return {
+      kind: 'web-fetch',
+      mode: 'create',
+      title: 'Fetch or Inspect URL',
+      selectedFieldIndex: 0,
+      message: 'Submit a normal Agent conversation turn that inspects one URL with connected read-only web tools. This does not ingest the URL into Agent Knowledge unless you explicitly ask for that.',
+      fields: [
+        { id: 'url', label: 'URL', value: '', required: true, multiline: false, hint: 'https://example.com/page' },
+        { id: 'goal', label: 'Question or goal', value: '', required: false, multiline: true, hint: 'What should Agent extract, compare, summarize, or verify? Ctrl-J inserts a new line.' },
+      ],
+    };
+  }
+  return {
+    kind: 'web-research',
+    mode: 'create',
+    title: 'Web Research Request',
+    selectedFieldIndex: 0,
+    message: 'Submit a normal Agent conversation turn that searches or reads the web through connected read-only tools. Agent should answer in the main conversation and remember only durable facts that belong in Agent memory.',
+    fields: [
+      { id: 'query', label: 'Research request', value: '', required: true, multiline: true, hint: 'Ask for the outcome you want, not just keywords. Ctrl-J inserts a new line.' },
+      { id: 'scope', label: 'Source or freshness hints', value: '', required: false, multiline: false, hint: 'Optional filters such as official docs only, last 30 days, primary sources, or compare products.' },
+    ],
+  };
+}
+
+export function buildAgentWorkspaceWebResearchSubmission(
+  editor: AgentWorkspaceLocalEditor,
+  readField: AgentWorkspaceFieldReader,
+  promptDispatchAvailable: boolean,
+): AgentWorkspaceWebResearchSubmission {
+  if (!promptDispatchAvailable) {
+    return {
+      kind: 'editor',
+      editor: { ...editor, message: 'Main-conversation submission is unavailable; cannot send this request from the workspace.' },
+      status: 'Main-conversation submission unavailable.',
+      actionResult: {
+        kind: 'error',
+        title: 'Conversation submission unavailable',
+        detail: 'The Agent workspace cannot hand this request back to the main conversation route.',
+      },
+    };
+  }
+
+  if (editor.kind === 'web-fetch') {
+    const url = readField('url');
+    const goal = readField('goal');
+    const prompt = [
+      `Use connected read-only web tools to inspect this URL: ${url}`,
+      goal.length > 0 ? `Goal: ${goal}` : 'Goal: summarize the useful facts, source title, and any caveats.',
+      'Do not ingest this into Agent Knowledge unless I explicitly ask you to.',
+    ].join('\n');
+    return {
+      kind: 'prompt',
+      prompt,
+      status: 'Submitting URL inspection to the main conversation.',
+      actionResult: {
+        kind: 'dispatched',
+        title: 'Submitting URL inspection',
+        detail: 'The workspace closed and handed a read-only URL inspection request to the normal Agent conversation.',
+        safety: 'read-only',
+      },
+    };
+  }
+
+  const query = readField('query');
+  const scope = readField('scope');
+  const prompt = [
+    `Use connected read-only web tools to research this request: ${query}`,
+    scope.length > 0 ? `Source and freshness guidance: ${scope}` : 'Prefer current, primary, or official sources when they are available.',
+    'Answer in the main conversation. Do not ingest sources into Agent Knowledge unless I explicitly ask you to.',
+  ].join('\n');
+  return {
+    kind: 'prompt',
+    prompt,
+    status: 'Submitting web research to the main conversation.',
+    actionResult: {
+      kind: 'dispatched',
+      title: 'Submitting web research',
+      detail: 'The workspace closed and handed a read-only web research request to the normal Agent conversation.',
+      safety: 'read-only',
+    },
+  };
+}