@pellux/goodvibes-agent 0.1.117 → 1.0.0

package/src/input/submission-router.ts

@@ -23,8 +23,8 @@ export function routeSubmissionIntent(input: SubmissionRouterInput): SubmissionI
 
   if (!trimmed) {
     return {
-      kind: input.panelFocused ? 'panel-action' : 'empty',
-      label: input.panelFocused ? 'panel action' : 'prompt',
+      kind: 'empty',
+      label: 'prompt',
       hasAttachments,
     };
   }
@@ -46,7 +46,7 @@ export function routeSubmissionIntent(input: SubmissionRouterInput): SubmissionI
       return { kind: 'delegation', label: 'TUI delegation', commandName, hasAttachments };
     }
     if (PANEL_COMMANDS.has(commandName)) {
-      return { kind: 'panel-action', label: 'panel action', commandName, hasAttachments };
+      return { kind: 'slash-command', label: 'Agent workspace', commandName, hasAttachments };
     }
     if (ORCHESTRATION_COMMANDS.has(commandName)) {
       return { kind: 'orchestration', label: 'orchestration', commandName, hasAttachments };

package/src/main.ts

@@ -4,6 +4,7 @@ import { Compositor } from './renderer/compositor.ts';
 import { type Line } from './types/grid.ts';
 import { UIFactory } from './renderer/ui-factory.ts';
 import { Orchestrator } from './core/orchestrator';
+import { conversationMessagesAsSessionRecords } from './core/conversation-message-snapshot.ts';
 import { InputHandler } from './input/handler.ts';
 import { SelectionManager } from './input/selection.ts';
 import type { ContentPart } from '@pellux/goodvibes-sdk/platform/providers';
@@ -38,6 +39,7 @@ import {
   persistConversation,
   writeRecoveryFile,
 } from '@/runtime/index.ts';
+import type { SessionSnapshot } from '@/runtime/index.ts';
 import { handleBlockingShellInput, type PendingPermissionState } from './shell/blocking-input.ts';
 import { wireShellUiOpeners } from './shell/ui-openers.ts';
 import { deriveComposerState } from './core/composer-state.ts';
@@ -136,6 +138,16 @@ async function main() {
       openPanels: panelManager.getAllOpen().map((panel) => panel.id),
     };
   };
+  const buildCurrentSessionSnapshot = (): SessionSnapshot => {
+    const messages = conversation.getMessageSnapshot();
+    const persisted = buildPersistedSessionContext(messages, conversation.getTitleSource(), buildSessionContinuityHints());
+    return {
+      messages: conversationMessagesAsSessionRecords(messages),
+      timestamp: Date.now(),
+      title: conversation.title,
+      ...persisted,
+    };
+  };
 
   let pendingPermission: PendingPermissionState | null = null;
   approvalBroker.subscribe((approval) => {
@@ -219,8 +231,8 @@ async function main() {
   const exitApp = (): void => {
     stopSpokenOutputForExit?.();
     unsubs.forEach(fn => fn());
-    const snapshot = conversation.toJSON() as { messages: Array<import('./core/conversation.ts').ConversationMessageSnapshot>; timestamp?: number };
-    ctx.shutdown({ ...snapshot, ...buildPersistedSessionContext(snapshot.messages, conversation.getTitleSource(), buildSessionContinuityHints()) }).catch((err) => {
+    const snapshot = buildCurrentSessionSnapshot();
+    ctx.shutdown(snapshot).catch((err) => {
       logger.debug('ctx.shutdown error during exitApp (non-fatal)', { error: summarizeError(err) });
     });
     if (recoveryInterval !== null) { clearInterval(recoveryInterval); recoveryInterval = null; }
@@ -666,11 +678,10 @@ async function main() {
   unsubs.push(uiServices.events.turns.on('TURN_COMPLETED', () => {
     // Auto-save after every LLM turn so kills don't lose the session
     try {
-      const snapshot = conversation.toJSON() as { messages: Array<import('./core/conversation.ts').ConversationMessageSnapshot>; timestamp?: number };
-      const persisted = buildPersistedSessionContext(snapshot.messages, conversation.getTitleSource(), buildSessionContinuityHints());
+      const snapshot = buildCurrentSessionSnapshot();
       persistConversation(
         runtime.sessionId,
-        { ...snapshot, ...persisted },
+        snapshot,
         runtime.model,
         runtime.provider,
         conversation.title || '',
@@ -748,10 +759,9 @@ async function main() {
 
   // --- Auto-save to recovery file every 60s ---
   recoveryInterval = setInterval(() => {
-    const snapshot = conversation.toJSON() as { messages: Array<import('./core/conversation.ts').ConversationMessageSnapshot> };
-    const persisted = buildPersistedSessionContext(snapshot.messages, conversation.getTitleSource(), buildSessionContinuityHints());
+    const snapshot = buildCurrentSessionSnapshot();
     writeRecoveryFile(
-      { ...snapshot, ...persisted },
+      snapshot,
       runtime.sessionId,
       conversation.title ?? '',
       { workingDirectory: workingDir, homeDirectory },

package/src/panels/approval-panel.ts

@@ -15,14 +15,14 @@ const C = {
 } as const;
 
 const APPROVAL_ROWS = [
-  ['shell', 'why prompted: side effects, destructive ops, secret exposure, escalation', 'review via /security and /policy preflight'],
+  ['shell', 'why prompted: side effects, destructive ops, secret exposure, escalation', 'review via /approval review shell'],
   ['file', 'why prompted: config mutation, notebook edits, secret-bearing paths', 'review via /approval review file'],
   ['network', 'why prompted: external hosts, fetch scope, egress policy', 'review via /approval review network'],
-  ['delegate', 'why prompted: recursive agents, spawn ceilings, write-set inheritance', 'review via /approval review delegate'],
-  ['mcp', 'why prompted: trust escalation, host scope, path scope, coherence mismatch', 'review via /mcp trust and /security'],
-  ['remote', 'why prompted: runner trust, remote write scope, artifact requirements', 'review delegated TUI execution context'],
-  ['hook', 'why prompted: deny/mutate authority, blocking behavior, runner provenance', 'review via /hooks and /security'],
-  ['plugin', 'why prompted: install/update lifecycle, provenance, capability grants', 'review via /marketplace and /security'],
+  ['delegate', 'why prompted: explicit TUI build handoff, write scope, result ownership', 'review via /approval review delegate'],
+  ['mcp', 'why prompted: trust escalation, host scope, path scope, coherence mismatch', 'review via /approval review mcp'],
+  ['remote', 'why prompted: build-host trust, remote write scope, artifact requirements', 'review via /approval review remote'],
+  ['hook', 'why prompted: deny/mutate authority, blocking behavior, execution provenance', 'review via /approval review hook'],
+  ['plugin', 'why prompted: install/update lifecycle, provenance, capability grants', 'review via /approval review plugin'],
 ] as const;
 
 type ApprovalRow = (typeof APPROVAL_ROWS)[number];
@@ -123,8 +123,8 @@ export class ApprovalPanel extends ScrollableListPanel<ApprovalRow> {
       buildPanelLine(width, [['  Approval posture', C.label]]),
       buildKeyValueLine(width, [
         { label: 'why prompted', value: 'risk summary', valueColor: C.value },
-        { label: 'what-if', value: '/policy simulate + preflight', valueColor: C.info },
-        { label: 'operator', value: '/security + /cockpit', valueColor: C.good },
+        { label: 'what-if', value: '/security review', valueColor: C.info },
+        { label: 'operator', value: '/approval + /security', valueColor: C.good },
       ], C),
       buildPanelLine(width, [
         ['  \u2713 ', C.good],

package/src/panels/automation-control-panel.ts

@@ -103,7 +103,7 @@ export class AutomationControlPanel extends ScrollableListPanel<AutomationRun> {
           lines: buildEmptyState(
             width,
             ' Connected-host automation state is unavailable.',
-            'Use /schedule list for the supported Agent schedule summary. This deferred panel does not start or mutate automation.',
+            'This operator view is read-only. Use /schedule list for compact transcript output; automation stays unchanged.',
             [{ command: '/schedule list', summary: 'review automation without starting hidden work' }],
             C,
           ),
@@ -182,7 +182,7 @@ export class AutomationControlPanel extends ScrollableListPanel<AutomationRun> {
       );
       if (selectedRun.error) {
         footerLines.push(buildPanelLine(width, [
-          ['  Error: ', C.label],
+          ['  Error ', C.label],
           [truncateDisplay(selectedRun.error, Math.max(0, width - 10)), C.error],
         ]));
       }

package/src/panels/base-panel.ts

@@ -34,7 +34,7 @@ export abstract class BasePanel implements Panel {
 
   /**
    * Clear a specific timer and remove it from the registry.
-   * Safe to call with an id that was never registered or already cleared.
+   * Safe to call with an unregistered or already-cleared id.
    */
   protected clearTimer(id: ReturnType<typeof setTimeout> | ReturnType<typeof setInterval>): void {
     clearInterval(id as ReturnType<typeof setInterval>);

package/src/panels/builtin/agent.ts

@@ -80,7 +80,7 @@ export function registerAgentPanels(manager: PanelManager, deps: ResolvedBuiltin
     name: 'Schedule',
     icon: 'Z',
     category: 'agent',
-    description: 'Read-only schedule posture from the connected GoodVibes host; local Agent schedule mutation is blocked',
+    description: 'Read-only schedule posture from the connected GoodVibes host; Agent-local schedule mutation is blocked',
     factory: () => new SchedulePanel(requireAutomationManager(deps)),
   });
 }

package/src/panels/builtin/operations.ts

@@ -7,7 +7,6 @@ import { SecurityPanel } from '../security-panel.ts';
 import { TasksPanel } from '../tasks-panel.ts';
 import { ProviderStatsPanel } from '../provider-stats-panel.ts';
 import { ProviderHealthPanel } from '../provider-health-panel.ts';
-import { PolicyPanel } from '../policy-panel.ts';
 import { createProviderAccountSnapshotQuery } from '../provider-account-snapshot.ts';
 import {
   createEnvironmentVariableQuery,
@@ -72,7 +71,7 @@ export function registerOperationsPanels(manager: PanelManager, deps: ResolvedBu
     name: 'Security',
     icon: 'U',
     category: 'monitoring',
-    description: 'Security review workspace for token audit, policy posture, MCP quarantine, and incident pressure',
+    description: 'Security review workspace for token posture, policy posture, MCP quarantine, and incident pressure',
     factory: () => new SecurityPanel(ui.readModels.security),
   });
 
@@ -119,12 +118,4 @@ export function registerOperationsPanels(manager: PanelManager, deps: ResolvedBu
     ),
   });
 
-  manager.registerType({
-    id: 'policy',
-    name: 'Policy',
-    icon: 'U',
-    category: 'monitoring',
-    description: 'Policy governance: active/candidate bundles, divergence gate, rollout history, and simulation evidence',
-    factory: () => new PolicyPanel(deps.policyRuntimeState),
-  });
 }

package/src/panels/builtin/session.ts

@@ -45,7 +45,7 @@ function readOperatorToken(tokenPath: string): string | null {
   try {
     const parsed = JSON.parse(readFileSync(tokenPath, 'utf-8')) as unknown;
     if (!parsed || typeof parsed !== 'object' || Array.isArray(parsed)) return null;
-    const token = (parsed as Record<string, unknown>)['token'];
+    const token = 'token' in parsed ? parsed.token : undefined;
     return typeof token === 'string' && token.trim().length > 0 ? token : null;
   } catch {
     return null;
@@ -58,23 +58,23 @@ export function registerSessionPanels(manager: PanelManager, deps: ResolvedBuilt
     name: 'QR Code',
     icon: 'Q',
     category: 'session',
-    description: 'QR code for companion app pairing — scan to connect a mobile or desktop companion',
+    description: 'QR code for companion app pairing through the connected GoodVibes host',
     factory: () => {
-      if (!deps.daemonHomeDir) throw new Error('daemonHomeDir must be provided to the session panel factory via BuiltinPanelDeps');
-      const token = readOperatorToken(`${deps.daemonHomeDir}/operator-tokens.json`);
-      const daemonPort = deps.configManager.get('controlPlane.port');
-      const daemonHost = String(process.env['GOODVIBES_DAEMON_HOST'] ?? getLocalNetworkIp());
-      const daemonUrl = `http://${daemonHost}:${daemonPort}`;
+      if (!deps.connectedHostTokenDir) throw new Error('connected host token directory must be provided to the session panel factory via BuiltinPanelDeps');
+      const token = readOperatorToken(`${deps.connectedHostTokenDir}/operator-tokens.json`);
+      const connectedHostPort = deps.configManager.get('controlPlane.port');
+      const connectedHostName = String(process.env['GOODVIBES_AGENT_RUNTIME_HOST'] ?? process.env['GOODVIBES_DAEMON_HOST'] ?? getLocalNetworkIp());
+      const connectedHostUrl = `http://${connectedHostName}:${connectedHostPort}`;
       const bootstrapPassword = readBootstrapPassword(deps.localUserAuthManager.getBootstrapCredentialPath());
       const connectionInfo = token
         ? buildCompanionConnectionInfo({
-          daemonUrl,
+          daemonUrl: connectedHostUrl,
           token,
           password: bootstrapPassword,
           surface: GOODVIBES_AGENT_PAIRING_SURFACE,
         })
         : {
-          url: daemonUrl,
+          url: connectedHostUrl,
           token: '',
           username: 'admin',
           ...(bootstrapPassword !== undefined ? { password: bootstrapPassword } : {}),

package/src/panels/builtin/shared.ts

@@ -80,7 +80,7 @@ export interface BuiltinPanelDeps {
   tokenAuditor: ApiTokenAuditor;
   /** Shared component-health monitor for rate-limited panels and diagnostics. */
   componentHealthMonitor: ComponentHealthMonitor;
-  /** Copied shell dependency kept inert in Agent; build worktree UX belongs to GoodVibes TUI delegation. */
+  /** Inert shell dependency in Agent; build worktree UX belongs to GoodVibes TUI delegation. */
   worktreeRegistry: WorktreeRegistry;
   /** Isolation session registry used by MCP internals; Agent does not expose local execution-isolation command UX. */
   sandboxSessionRegistry: SandboxSessionRegistry;
@@ -88,7 +88,7 @@ export interface BuiltinPanelDeps {
    * Resolved connected-host token directory (e.g. `~/.goodvibes/daemon`) — owned by the
    * composition root and passed explicitly so panel factories do not discover cwd/home implicitly.
    */
-  daemonHomeDir?: string;
+  connectedHostTokenDir?: string;
   /** Session memory store for context and token budget panels. */
   sessionMemoryStore?: SessionMemoryStore;
   /** Execution plan manager for plan dashboard panels. */

package/src/panels/cost-tracker-panel.ts

@@ -198,7 +198,7 @@ export class CostTrackerPanel extends BasePanel {
       turnEvents.on('TURN_COMPLETED', () => this.onTurnComplete()),
     );
 
-    // Track agent spawns
+    // Track runtime worker events for cost attribution only.
     this.unsubs.push(
       agentEvents.on('AGENT_SPAWNING', (payload) => {
         this.agents.set(payload.agentId, {

package/src/panels/docs-panel.ts

@@ -36,15 +36,17 @@ const C = {
 // ---------------------------------------------------------------------------
 const SHORTCUTS: Array<{ key: string; desc: string }> = [
   { key: 'Ctrl+C',      desc: 'Cancel generation / exit (double)' },
-  { key: 'Ctrl+P',      desc: 'Open panel picker' },
+  { key: 'Ctrl+P',      desc: 'Open Agent operator workspace' },
   { key: 'Ctrl+F',      desc: 'Search conversation' },
   { key: 'Ctrl+K',      desc: 'Copy last response to clipboard' },
   { key: 'Ctrl+L',      desc: 'Clear screen' },
   { key: 'Ctrl+Z',      desc: 'Undo input' },
   { key: 'Alt+Enter',   desc: 'Insert newline in prompt' },
   { key: 'PageUp/Down', desc: 'Scroll conversation' },
-  { key: 'Alt+PgUp/Dn', desc: 'Scroll panel' },
-  { key: 'Tab',         desc: 'Path completion / tab panels' },
+  { key: 'Alt+PgUp/Dn', desc: 'Scroll active workspace surface' },
+  { key: 'Tab',         desc: 'Path completion / workspace focus' },
+  { key: '@path',       desc: 'Attach bounded file/folder/URL context in composer' },
+  { key: '!@path',      desc: 'Inject raw file contents in composer' },
   { key: '/',           desc: 'Start slash command' },
   { key: 'Enter',       desc: 'Submit prompt' },
   { key: 'Esc',         desc: 'Close overlay / cancel search' },

package/src/panels/index.ts

@@ -15,7 +15,6 @@ export { ToolInspectorPanel } from './tool-inspector-panel.ts';
 export { ContextVisualizerPanel } from './context-visualizer-panel.ts';
 export { registerBuiltinPanels } from './builtin-panels.ts';
 export type { BuiltinPanelDeps } from './builtin-panels.ts';
-export { PolicyPanel } from './policy-panel.ts';
 export { TasksPanel } from './tasks-panel.ts';
 export { SubscriptionPanel } from './subscription-panel.ts';
 export { SecurityPanel } from './security-panel.ts';

package/src/panels/knowledge-panel.ts

@@ -3,6 +3,7 @@ import { ScrollableListPanel } from './scrollable-list-panel.ts';
 import { type ConfirmState, handleConfirmInput, renderConfirmLines } from './confirm-state.ts';
 import type { MemoryClass, MemoryRecord, MemoryRegistry, MemoryReviewState } from '@pellux/goodvibes-sdk/platform/state';
 import type { KnowledgeStatus } from '@pellux/goodvibes-sdk/platform/knowledge';
+import { formatAgentRecordReferences } from '../agent/record-labels.ts';
 import {
   buildBodyText,
   buildGuidanceLine,
@@ -105,7 +106,7 @@ export class KnowledgePanel extends ScrollableListPanel<MemoryRecord> {
       { command: '/knowledge status', summary: 'inspect the isolated Agent Knowledge store' },
       { command: '/knowledge ingest-url <url> --yes', summary: 'ingest source-backed material into Agent Knowledge only' },
       { command: '/knowledge queue', summary: 'review Agent Knowledge issues' },
-      { command: '/recall add fact <summary>', summary: 'capture a local non-secret memory record when appropriate' },
+      { command: '/memory add fact <summary>', summary: 'capture a local non-secret memory record when appropriate' },
     ];
   }
 
@@ -233,7 +234,7 @@ export class KnowledgePanel extends ScrollableListPanel<MemoryRecord> {
       buildPanelLine(width, [
         ['  route ', C.label],
         ['/api/goodvibes-agent/knowledge/*', C.info],
-        ['  isolated: no default Knowledge/Wiki or non-Agent fallback', C.dim],
+        ['  isolated: no default knowledge or non-Agent fallback', C.dim],
       ]),
     ];
     if (this.agentKnowledgeLoading && !this.agentKnowledgeStatus) {
@@ -283,7 +284,7 @@ export class KnowledgePanel extends ScrollableListPanel<MemoryRecord> {
 
     if (this.records.length === 0) this.refresh();
 
-    const intro = 'Isolated Agent Knowledge plus local non-secret memory review. This surface never falls back to default Knowledge/Wiki or non-Agent knowledge segments.';
+    const intro = 'Isolated Agent Knowledge plus local non-secret memory review. This surface never falls back to default knowledge or non-Agent knowledge segments.';
     const records = this.registry.search({ limit: 200 });
     const agentKnowledgeHeader = this.buildAgentKnowledgeHeader(width);
 
@@ -335,7 +336,7 @@ export class KnowledgePanel extends ScrollableListPanel<MemoryRecord> {
         ['  project ', C.label], [String(byScope.get('project') ?? 0), C.value],
         ['  team ', C.label], [String(byScope.get('team') ?? 0), C.good],
       ]),
-      buildGuidanceLine(width, '/recall review', 'work the stale and contradicted queue from the command workspace', C),
+      buildGuidanceLine(width, '/memory review', 'work the stale and contradicted queue from the command workspace', C),
     ];
 
     const recentSummaryLines: Line[] = [];
@@ -376,7 +377,7 @@ export class KnowledgePanel extends ScrollableListPanel<MemoryRecord> {
       if (selectedRecord.provenance.length) {
         selectedLines.push(...buildBodyText(
           width,
-          `Provenance: ${selectedRecord.provenance.map((p) => `${p.kind}:${p.ref}`).join(', ')}`,
+          `Origin: ${formatAgentRecordReferences(selectedRecord.provenance)}`,
           C,
           C.dim,
         ));

package/src/panels/memory-panel.ts

@@ -7,6 +7,7 @@
 import type { Line } from '../types/grid.ts';
 import type { MemoryRegistry } from '@pellux/goodvibes-sdk/platform/state';
 import type { MemoryRecord, MemoryClass } from '@pellux/goodvibes-sdk/platform/state';
+import { formatAgentRecordReferences } from '../agent/record-labels.ts';
 import { SearchableListPanel } from './scrollable-list-panel.ts';
 import {
   buildBodyText,
@@ -125,12 +126,12 @@ export class MemoryPanel extends SearchableListPanel<MemoryRecord> {
   protected override getEmptyStateMessage() {
     return this.searchQuery
       ? ` No records matching "${this.searchQuery}"`
-      : ' No memory records. Use /recall add <class> <summary> to create one.';
+      : ' No memory records. Use /memory add <class> <summary> to create one.';
   }
   protected override getEmptyStateActions() {
     return [
-      { command: '/recall add fact <summary>', summary: 'capture a durable fact directly' },
-      { command: '/recall capture incident latest', summary: 'promote the latest incident into memory' },
+      { command: '/memory add fact <summary>', summary: 'capture a durable fact directly' },
+      { command: '/memory capture incident latest', summary: 'promote the latest incident into memory' },
     ];
   }
 
@@ -170,7 +171,7 @@ export class MemoryPanel extends SearchableListPanel<MemoryRecord> {
 
   render(width: number, height: number): Line[] {
     this.clampSelection();
-    const intro = 'Durable project memory across decisions, constraints, incidents, patterns, risks, runbooks, and related provenance.';
+    const intro = 'Durable project memory across decisions, constraints, incidents, patterns, risks, runbooks, and related origin links.';
 
     const records = this.getItems();
     const byClass = new Map<MemoryClass, number>();
@@ -189,7 +190,7 @@ export class MemoryPanel extends SearchableListPanel<MemoryRecord> {
         { label: 'runbooks', value: String(byClass.get('runbook') ?? 0), valueColor: C.runbook },
       ], C),
       filterLine,
-      buildGuidanceLine(width, '/recall review', 'review durable knowledge and queue posture from the command workspace', C),
+      buildGuidanceLine(width, '/memory review', 'review durable memory and queue posture from the command workspace', C),
     ];
 
     const selected = records[this.selectedIndex];
@@ -206,7 +207,7 @@ export class MemoryPanel extends SearchableListPanel<MemoryRecord> {
       if (selected.provenance.length) {
         selectedLines.push(...buildBodyText(
           width,
-          `Provenance: ${selected.provenance.map((p) => `${p.kind}:${p.ref}`).join('  ')}`,
+          `Origin: ${formatAgentRecordReferences(selected.provenance)}`,
           C,
           C.dim,
         ));