@pellux/goodvibes-agent 0.1.8 → 0.1.9

package/CHANGELOG.md

@@ -2,6 +2,14 @@
 
 All notable changes to GoodVibes Agent will be recorded here.
 
+## 0.1.9 - 2026-05-31
+
+- 75e5d4a Align shell surface delegation test
+- a24c581 Use delegation wording in runtime indicator
+- 259a75f Guard Agent knowledge isolation
+- 59b6729 Align task help with Agent policy
+- 0074a76 Classify stale daemon knowledge routes
+
 ## 0.1.8 - 2026-05-31
 
 - 384c85a Remove stale WRFC artifact test

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pellux/goodvibes-agent",
-  "version": "0.1.8",
+  "version": "0.1.9",
   "private": false,
   "description": "Near-fork GoodVibes operator assistant with the GoodVibes TUI shell, renderer, input, fullscreen workspace, and daemon-connected Agent product brain.",
   "type": "module",

package/src/cli/agent-knowledge-command.ts

@@ -17,10 +17,12 @@ interface AgentDaemonConnection {
 
 interface AgentKnowledgeFailure {
   readonly ok: false;
-  readonly kind: 'daemon_unavailable' | 'auth_required' | 'daemon_route_unavailable' | 'daemon_error';
+  readonly kind: 'daemon_unavailable' | 'auth_required' | 'version_mismatch' | 'daemon_route_unavailable' | 'daemon_error';
   readonly error: string;
   readonly baseUrl: string;
   readonly route: string;
+  readonly daemonVersion?: string;
+  readonly expectedSdkVersion?: string;
 }
 
 interface AgentKnowledgeSuccess<TData> {
@@ -200,13 +202,28 @@ async function fetchDaemonStatus(connection: AgentDaemonConnection): Promise<{ r
   }
 }
 
-function classifyKnowledgeError(error: unknown, connection: AgentDaemonConnection, route: string): AgentKnowledgeFailure {
+async function classifyKnowledgeError(error: unknown, connection: AgentDaemonConnection, route: string): Promise<AgentKnowledgeFailure> {
   const message = summarizeError(error);
   const lower = message.toLowerCase();
   if (lower.includes('401') || lower.includes('unauthorized') || lower.includes('auth')) {
     return { ok: false, kind: 'auth_required', error: message, baseUrl: connection.baseUrl, route };
   }
   if (lower.includes('404') || lower.includes('not found')) {
+    const metadata = readPackageMetadata();
+    const daemon = await fetchDaemonStatus(connection);
+    const daemonRecord = isRecord(daemon.body) ? daemon.body : {};
+    const daemonVersion = readString(daemonRecord, 'version') ?? 'unknown';
+    if (daemon.ok && daemonVersion !== metadata.sdkVersion) {
+      return {
+        ok: false,
+        kind: 'version_mismatch',
+        error: `External daemon SDK version ${daemonVersion} does not match Agent SDK pin ${metadata.sdkVersion}; Agent Knowledge route is unavailable.`,
+        baseUrl: connection.baseUrl,
+        route,
+        daemonVersion,
+        expectedSdkVersion: metadata.sdkVersion,
+      };
+    }
     return { ok: false, kind: 'daemon_route_unavailable', error: message, baseUrl: connection.baseUrl, route };
   }
   if (lower.includes('fetch') || lower.includes('connect') || lower.includes('econnrefused')) {
@@ -407,6 +424,12 @@ function formatFailure(failure: AgentKnowledgeFailure, json: boolean): string {
     `  ${failure.error}`,
     `  daemon: ${failure.baseUrl}`,
     `  route: ${failure.route}`,
+    failure.kind === 'version_mismatch' && failure.daemonVersion && failure.expectedSdkVersion
+      ? `  versions: daemon=${failure.daemonVersion} expected=${failure.expectedSdkVersion}`
+      : null,
+    failure.kind === 'version_mismatch'
+      ? '  next: update/restart the external GoodVibes daemon so /status matches the Agent SDK pin.'
+      : null,
     failure.kind === 'daemon_route_unavailable'
       ? '  next: update/restart the external GoodVibes daemon to the SDK version required by this Agent package.'
       : null,

package/src/cli/help.ts

@@ -45,7 +45,7 @@ export function renderGoodVibesHelp(binary = 'goodvibes-agent'): string {
     '  subscription               Start/finish/logout provider subscription sessions',
     '  secrets                    List, set, link, delete, and test GoodVibes secret refs',
     '  sessions                   List, show, export, or resume saved sessions',
-    '  tasks                      List/show in-process tasks or submit a non-interactive task',
+    '  tasks                      List/show in-process runtime tasks (read-only)',
     '  pair|qrcode                Print companion pairing payload and QR code',
     '  surfaces                   Inspect/check browser/listener/external surfaces (read-only)',
     '  listener test              Test HTTP listener/webhook readiness',
@@ -198,9 +198,9 @@ const COMMAND_HELP: Record<string, CommandHelp> = {
     examples: ['sessions list', 'sessions show latest-session', 'sessions export abc123 session.json'],
   },
   tasks: {
-    usage: ['tasks list', 'tasks show <taskId>', 'tasks submit <prompt>'],
-    summary: 'Inspect runtime tasks or submit a non-interactive task.',
-    examples: ['tasks list', 'tasks submit "check provider readiness"'],
+    usage: ['tasks list', 'tasks show <taskId>'],
+    summary: 'Inspect in-process runtime tasks. Agent blocks copied task submission; use run for one-shot work or delegate for explicit build/fix/review handoff.',
+    examples: ['tasks list', 'tasks show task-123', 'run "check provider readiness"', 'delegate "fix the failing tests"'],
   },
   surfaces: {
     usage: ['surfaces [list]', 'surfaces check', 'surfaces show <surfaceId>'],

package/src/renderer/process-indicator.ts

@@ -20,7 +20,7 @@ function truncateToWidth(text: string, maxWidth: number): string {
  * renderProcessIndicator — shows a one-line summary of active runtime
  * activity below the input area.
  *
- * Dimmed when no entries are active, highlighted (cyan) when delegated agent
+ * Dimmed when no entries are active, highlighted (cyan) when delegated work
  * records or shell exec processes are running. Includes an `Enter to view`
  * hint when active.
  */
@@ -32,6 +32,7 @@ export function renderProcessIndicator(
   agentProgress?: string,
 ): Line[] {
   const total = agentCount + toolCount;
+  const delegationLabel = (count: number): string => `${count} delegation${count !== 1 ? 's' : ''}`;
   const renderPlainStatus = (text: string, style: { fg: string; bold?: boolean; dim?: boolean }): Line[] => (
     [UIFactory.stringToLine(`   ${text}`, width, style)]
   );
@@ -59,7 +60,7 @@ export function renderProcessIndicator(
   // --- Focused state: always render before idle/active branches ---
   if (focused) {
     const parts: string[] = [];
-    if (agentCount > 0) parts.push(`${agentCount} agent${agentCount !== 1 ? 's' : ''}`);
+    if (agentCount > 0) parts.push(delegationLabel(agentCount));
     if (toolCount > 0) parts.push(`${toolCount} tool${toolCount !== 1 ? 's' : ''} running`);
     const label = total === 0
       ? `No runtime activity  ${GLYPHS.status.pending}  back to input`
@@ -71,18 +72,18 @@ export function renderProcessIndicator(
     return renderPlainStatus('No runtime activity', { fg: '238', dim: true });
   }
 
-  // Build the label: "2 agents | Turn 3 | write - src/foo.ts"
+  // Build the label: "2 delegations | Turn 3 | write - src/foo.ts"
   const parts: string[] = [];
   if (agentCount > 0) {
-    parts.push(`${agentCount} agent${agentCount !== 1 ? 's' : ''}`);
+    parts.push(delegationLabel(agentCount));
   }
   if (toolCount > 0) {
     parts.push(`${toolCount} tool${toolCount !== 1 ? 's' : ''} running`);
   }
   // Append the first running agent's progress (truncated to fit)
   /**
-   * Number of columns reserved for the agent count label and hint text.
-   * Breakdown: "bg: N agents" prefix (~15 chars) + " | " separator (~3)
+   * Number of columns reserved for the delegation count label and hint text.
+   * Breakdown: "N delegations" prefix (~15 chars) + " | " separator (~3)
    * + "  Enter to view  " hint (~17) + padding (~8) ≈ 43 chars.
    */
   const PROGRESS_RESERVED_CHARS = 43;

package/src/version.ts

@@ -6,7 +6,7 @@ import { join } from 'node:path';
 // The prebuild script updates the fallback value before compilation.
 // Uses import.meta.dir (Bun) to locate package.json relative to this file,
 // which is correct regardless of the process working directory.
-let _version = '0.1.8';
+let _version = '0.1.9';
 try {
   const pkg = JSON.parse(readFileSync(join(import.meta.dir, '..', 'package.json'), 'utf-8'));
   _version = pkg.version ?? _version;