@pellux/goodvibes-agent 0.1.2 → 0.1.3

package/src/panels/builtin/session.ts

@@ -14,6 +14,7 @@ import {
   buildCompanionConnectionInfo,
 } from '@pellux/goodvibes-sdk/platform/pairing';
 import { copyToClipboard } from '../../utils/clipboard.ts';
+import { GOODVIBES_AGENT_PAIRING_SURFACE } from '../../config/surface.ts';
 
 function getLocalNetworkIp(): string {
   const nets = networkInterfaces();
@@ -51,7 +52,7 @@ export function registerSessionPanels(manager: PanelManager, deps: ResolvedBuilt
     factory: () => {
       if (!deps.daemonHomeDir) throw new Error('daemonHomeDir must be provided to the session panel factory via BuiltinPanelDeps');
       const daemonHomeDir = deps.daemonHomeDir;
-      const tokenRecord = getOrCreateCompanionToken('tui', { daemonHomeDir });
+      const tokenRecord = getOrCreateCompanionToken(GOODVIBES_AGENT_PAIRING_SURFACE, { daemonHomeDir });
       const daemonPort = deps.configManager.get('controlPlane.port');
       const daemonHost = String(process.env['GOODVIBES_DAEMON_HOST'] ?? getLocalNetworkIp());
       const daemonUrl = `http://${daemonHost}:${daemonPort}`;
@@ -60,7 +61,7 @@ export function registerSessionPanels(manager: PanelManager, deps: ResolvedBuilt
         daemonUrl,
         token: tokenRecord.token,
         password: bootstrapPassword,
-        surface: 'tui',
+        surface: GOODVIBES_AGENT_PAIRING_SURFACE,
       });
       const regenerate = (): typeof connectionInfo => {
         const newRecord = regenerateCompanionToken({ daemonHomeDir });
@@ -68,7 +69,7 @@ export function registerSessionPanels(manager: PanelManager, deps: ResolvedBuilt
           daemonUrl,
           token: newRecord.token,
           password: bootstrapPassword,
-          surface: 'tui',
+          surface: GOODVIBES_AGENT_PAIRING_SURFACE,
         });
       };
       return new QrPanel(connectionInfo, regenerate, copyToClipboard);

package/src/panels/index.ts

@@ -6,13 +6,9 @@ export { TokenBudgetPanel } from './token-budget-panel.ts';
 export { CostTrackerPanel } from './cost-tracker-panel.ts';
 export { AgentInspectorPanel } from './agent-inspector-panel.ts';
 export { AgentLogsPanel } from './agent-logs-panel.ts';
-export { WrfcPanel } from './wrfc-panel.ts';
 export { ProviderHealthPanel } from './provider-health-panel.ts';
 export { ProviderHealthTracker } from './provider-health-tracker.ts';
 export type { ProviderHealth, ProviderStatus } from './provider-health-tracker.ts';
-export { GitPanel } from './git-panel.ts';
-export { SymbolOutlinePanel } from './symbol-outline-panel.ts';
-export type { SymbolEntry, SymbolKind } from './symbol-outline-panel.ts';
 export { ProviderStatsPanel } from './provider-stats-panel.ts';
 export { SessionBrowserPanel } from './session-browser-panel.ts';
 export { DocsPanel } from './docs-panel.ts';
@@ -38,7 +34,6 @@ export { SubscriptionPanel } from './subscription-panel.ts';
 export { HooksPanel } from './hooks-panel.ts';
 export { SecurityPanel } from './security-panel.ts';
 export { MarketplacePanel } from './marketplace-panel.ts';
-export { SandboxPanel } from './sandbox-panel.ts';
 export { ApprovalPanel } from './approval-panel.ts';
 export { KnowledgePanel } from './knowledge-panel.ts';
 export { SystemMessagesPanel } from './system-messages-panel.ts';

package/src/panels/orchestration-panel.ts

@@ -1,6 +1,5 @@
 /**
- * OrchestrationPanel — displays task graphs, node contracts, recursion guards,
- * and WRFC-visible orchestration state.
+ * OrchestrationPanel — displays task graphs, node contracts, and recursion guards.
  *
  * Migrated (Wave B2): extends ScrollableListPanel<OrchestrationGraphRecord>.
  * Navigation (up/down/j/k) is handled by the base class.
@@ -102,7 +101,7 @@ export class OrchestrationPanel extends ScrollableListPanel<OrchestrationGraphRe
   // ---------------------------------------------------------------------------
 
   public render(width: number, height: number): Line[] {
-    const intro = 'Task graphs, node contracts, recursion guards, and WRFC-visible orchestration state.';
+    const intro = 'Read-only task graph posture, node contracts, and recursion guard state. Agent does not start local worker chains.';
 
     if (!this.readModel) {
       this.needsRender = false;
@@ -134,7 +133,7 @@ export class OrchestrationPanel extends ScrollableListPanel<OrchestrationGraphRe
         { label: 'failed', value: String(snapshot.totalFailedGraphs), valueColor: snapshot.totalFailedGraphs > 0 ? C.failed : C.dim },
         { label: 'guards', value: String(snapshot.recursionGuardTrips), valueColor: snapshot.recursionGuardTrips > 0 ? C.blocked : C.dim },
       ], C),
-      buildGuidanceLine(width, '/orchestration', 'inspect recursive execution posture, graph health, and node contract flow', C),
+      buildGuidanceLine(width, '/orchestration', 'inspect graph health without spawning local workers', C),
     ];
     if (graphs.length === 0) {
       this.needsRender = false;
@@ -148,7 +147,7 @@ export class OrchestrationPanel extends ScrollableListPanel<OrchestrationGraphRe
             ...buildEmptyState(
               width,
               this.getEmptyStateMessage(),
-              'Graphs, nodes, child contracts, and recursion guard trips will appear here as orchestration starts.',
+              'Graphs, nodes, child contracts, and recursion guard trips appear here only if a runtime record already exists.',
               [
                 { command: '/tasks', summary: 'create or inspect task flows that feed orchestration graphs' },
                 { command: '/communication', summary: 'review structured agent communication alongside graph execution' },

package/src/panels/qr-panel.ts

@@ -7,6 +7,7 @@ import {
 } from './polish.ts';
 import { renderQrMatrix, generateQrMatrix } from '../renderer/qr-renderer.ts';
 import { encodeConnectionPayload } from '@pellux/goodvibes-sdk/platform/pairing';
+import { GOODVIBES_AGENT_PAIRING_SURFACE } from '../config/surface.ts';
 
 const C = {
   ...DEFAULT_PANEL_PALETTE,
@@ -32,7 +33,7 @@ export interface QrPanelConnectionInfo {
   readonly password?: string;
   /** SDK/surface version (defaults to '0.0.0' if omitted) */
   readonly version?: string;
-  /** Surface identifier (defaults to 'tui' if omitted) */
+  /** Surface identifier (defaults to GoodVibes Agent if omitted) */
   readonly surface?: string;
 }
 
@@ -139,7 +140,7 @@ export class QrPanel extends BasePanel {
       username: this.connectionInfo.username,
       ...(this.connectionInfo.password !== undefined ? { password: this.connectionInfo.password } : {}),
       version: this.connectionInfo.version ?? '0.0.0',
-      surface: this.connectionInfo.surface ?? 'tui',
+      surface: this.connectionInfo.surface ?? GOODVIBES_AGENT_PAIRING_SURFACE,
     });
     const matrix = generateQrMatrix(payload);
     const qrLines = renderQrMatrix(matrix.modules, width, { fg: C.qrFg, bg: C.qrBg });

package/src/panels/tasks-panel.ts

@@ -179,7 +179,7 @@ export class TasksPanel extends ScrollableListPanel<RuntimeTask> {
   protected override getEmptyStateActions() {
     return [
       { command: '/tasks create', summary: 'create a tracked task from the shell' },
-      { command: '/orchestration', summary: 'review graph-native task execution and WRFC flows' },
+      { command: '/delegate <task>', summary: 'send explicit build/fix/review work to GoodVibes TUI' },
     ];
   }
 
@@ -276,8 +276,8 @@ export class TasksPanel extends ScrollableListPanel<RuntimeTask> {
       ]));
     }
     postureLines.push(
-      buildGuidanceLine(width, '/teamwork review', 'inspect task-family posture, archetype metadata, and recovery options for active work', C),
-      buildGuidanceLine(width, '/worktree task <task-id>', 'review worktree ownership, restore, and merge posture for the selected task', C),
+      buildGuidanceLine(width, '/tasks', 'inspect local runtime task posture without starting background agents', C),
+      buildGuidanceLine(width, '/delegate <task>', 'delegate explicit build/fix/review work to GoodVibes TUI when code execution is required', C),
     );
 
     const detailRows: Line[] = [];
@@ -354,7 +354,7 @@ export class TasksPanel extends ScrollableListPanel<RuntimeTask> {
           [String(attachedWorktrees.paused), attachedWorktrees.paused > 0 ? C.blocked : C.dim],
         ]));
         detailRows.push(buildPanelLine(width, [[
-          `  Next: /worktree task ${selected.id}  /worktree recover task ${selected.id}`,
+          '  Worktree lifecycle is externalized; open GoodVibes TUI in the target workspace for recovery.',
           C.dim,
         ]]));
         for (const record of attachedWorktrees.records.slice(0, 2)) {

package/src/renderer/agent-workspace.ts

@@ -97,6 +97,8 @@ function snapshotLines(category: AgentWorkspaceCategory, snapshot: AgentWorkspac
   } else if (category.id === 'memory') {
     base.push(
       { text: `Session memories: ${snapshot.sessionMemoryCount}`, fg: PALETTE.info },
+      { text: `Local skills: ${snapshot.localSkillCount}; enabled: ${snapshot.enabledSkillCount}`, fg: PALETTE.info },
+      { text: `Local personas: ${snapshot.localPersonaCount}; active: ${snapshot.activePersonaName}`, fg: PALETTE.info },
       { text: 'Durable memory, skills, and personas remain Agent-local until shared registry contracts exist.', fg: PALETTE.good },
       { text: 'Secrets are rejected/redacted; store secret references instead of secret values.', fg: PALETTE.warn },
     );

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

@@ -100,6 +100,7 @@ export type CreateBootstrapCommandContextOptions = {
   sessionOrchestration?: ShellSessionOrchestrationService;
   operatorClient?: OperatorClient;
   peerClient?: PeerClient;
+  agentKnowledgeApi?: KnowledgeApi;
   knowledgeApi?: KnowledgeApi;
   hookApi?: HookApi;
   mcpApi?: McpApi;
@@ -170,6 +171,7 @@ export function createBootstrapCommandContext(
     sessionOrchestration,
     operatorClient,
     peerClient,
+    agentKnowledgeApi,
     knowledgeApi,
     hookApi,
     mcpApi,
@@ -245,6 +247,7 @@ export function createBootstrapCommandContext(
   const clients = createBootstrapCommandClientsSection({
     operatorClient,
     peerClient,
+    agentKnowledgeApi,
     providerApi,
     knowledgeApi,
     hookApi,

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

@@ -117,6 +117,7 @@ export interface BootstrapCommandSectionOptions {
   readonly operatorClient?: OperatorClient;
   readonly peerClient?: PeerClient;
   readonly providerApi?: ProviderApi;
+  readonly agentKnowledgeApi?: KnowledgeApi;
   readonly knowledgeApi?: KnowledgeApi;
   readonly hookApi?: HookApi;
   readonly mcpApi?: McpApi;
@@ -360,23 +361,26 @@ export function createBootstrapCommandExtensionsSection(
   >,
   shellServices: BootstrapCommandShellServices,
 ): BootstrapCommandExtensionSection {
+  const shellExtensionServices = shellServices.extensions;
   return {
     toolRegistry: options.toolRegistry,
     mcpRegistry: options.mcpRegistry,
-    ...shellServices.extensions,
+    ...shellExtensionServices,
+    agentKnowledgeService: shellExtensionServices.knowledgeService,
   };
 }
 
 export function createBootstrapCommandClientsSection(
   options: Pick<
     BootstrapCommandSectionOptions,
-    'operatorClient' | 'peerClient' | 'providerApi' | 'knowledgeApi' | 'hookApi' | 'mcpApi' | 'opsApi' | 'directTransport'
+    'operatorClient' | 'peerClient' | 'providerApi' | 'agentKnowledgeApi' | 'knowledgeApi' | 'hookApi' | 'mcpApi' | 'opsApi' | 'directTransport'
   >,
 ): BootstrapCommandClientSection {
   return {
     operator: options.operatorClient,
     peer: options.peerClient,
     providerApi: options.providerApi,
+    agentKnowledgeApi: options.agentKnowledgeApi,
     knowledgeApi: options.knowledgeApi,
     hookApi: options.hookApi,
     mcpApi: options.mcpApi,

package/src/runtime/bootstrap-core.ts

@@ -126,16 +126,20 @@ export async function initializeBootstrapCore(
     isRunning: Boolean(configManager.get('controlPlane.enabled')),
   }, 'bootstrap.control-plane');
   domainDispatch.syncControlPlaneClient({
-    id: 'client:tui',
-    kind: 'tui',
-    label: 'Terminal UI',
+    id: 'client:goodvibes-agent',
+    kind: 'service',
+    label: 'GoodVibes Agent',
     transport: 'local',
     connected: true,
     sessionId: userSessionId,
     authenticatedAt: Date.now(),
     lastSeenAt: Date.now(),
     capabilities: ['session', 'panels', 'commands', 'automation'],
-    metadata: {},
+    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.',
+    },
   }, 'bootstrap.control-plane');
 
   const {

package/src/runtime/bootstrap-shell.ts

@@ -177,6 +177,7 @@ export function createBootstrapShell(options: BootstrapShellOptions): BootstrapS
     opsApi,
     providerApi,
   } = foundationClients;
+  const agentKnowledgeApi = createKnowledgeApi(services.agentKnowledgeService, { memoryRegistry: services.memoryRegistry });
   const remoteRuntime = createShellRemoteCommandService({
     readModels: uiServices.readModels,
     remoteRunnerRegistry: services.remoteRunnerRegistry,
@@ -239,7 +240,8 @@ export function createBootstrapShell(options: BootstrapShellOptions): BootstrapS
     sessionOrchestration: services.sessionOrchestration,
     operatorClient: directTransport.operator,
     peerClient: directTransport.peer,
-    knowledgeApi: createKnowledgeApi(services.agentKnowledgeService, { memoryRegistry: services.memoryRegistry }),
+    agentKnowledgeApi,
+    knowledgeApi: agentKnowledgeApi,
     hookApi,
     mcpApi,
     opsApi,

package/src/runtime/bootstrap.ts

@@ -42,6 +42,8 @@ import { createBootstrapShell } from './bootstrap-shell.ts';
 import { summarizeError } from '@pellux/goodvibes-sdk/platform/utils';
 import { startMcpConfigAutoReload } from '../mcp/runtime-reload.ts';
 import { GOODVIBES_AGENT_SURFACE_ROOT } from '../config/surface.ts';
+import { buildActivePersonaPrompt } from '../agent/persona-registry.ts';
+import { buildEnabledSkillsPrompt } from '../agent/skill-registry.ts';
 
 const GOODVIBES_AGENT_OPERATOR_POLICY = [
   '## GoodVibes Agent Operator Policy',
@@ -50,7 +52,7 @@ const GOODVIBES_AGENT_OPERATOR_POLICY = [
   '- 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, sandbox/QEMU UX, and any WRFC owner chain.',
+  '- 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, sandbox/QEMU 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.',
 ].join('\n');
 
@@ -205,7 +207,13 @@ export async function bootstrapRuntime(
       const contextWindow = providerRegistry.getContextWindowForModel(currentModel);
       const tier = getTierForContextWindow(contextWindow);
       const supplement = getTierPromptSupplement(tier);
-      return joinPromptParts(runtime.systemPrompt, GOODVIBES_AGENT_OPERATOR_POLICY, supplement);
+      return joinPromptParts(
+        runtime.systemPrompt,
+        GOODVIBES_AGENT_OPERATOR_POLICY,
+        buildEnabledSkillsPrompt(services.shellPaths),
+        buildActivePersonaPrompt(services.shellPaths),
+        supplement,
+      );
     },
     hookDispatcher,
     flagManager: services.featureFlags,

package/src/runtime/cloudflare-control-plane.ts

@@ -1,6 +1,7 @@
 import { join } from 'node:path';
 import { getOrCreateCompanionToken } from '@pellux/goodvibes-sdk/platform/pairing';
 import type { ConfigManager } from '../config/index.ts';
+import { GOODVIBES_AGENT_PAIRING_SURFACE } from '../config/surface.ts';
 
 export const CLOUDFLARE_COMPONENT_IDS = [
   'workers',
@@ -296,7 +297,7 @@ export function buildDefaultCloudflareDaemonBaseUrl(configManager: Pick<ConfigMa
 
 function readDaemonToken(homeDirectory: string): string {
   const daemonHomeDir = join(homeDirectory, '.goodvibes', 'daemon');
-  return getOrCreateCompanionToken('tui', { daemonHomeDir }).token;
+  return getOrCreateCompanionToken(GOODVIBES_AGENT_PAIRING_SURFACE, { daemonHomeDir }).token;
 }
 
 async function readJsonResponse<T>(response: Response): Promise<T> {

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.2';
+let _version = '0.1.3';
 try {
   const pkg = JSON.parse(readFileSync(join(import.meta.dir, '..', 'package.json'), 'utf-8'));
   _version = pkg.version ?? _version;

package/src/daemon/cli.ts

@@ -1,55 +0,0 @@
-#!/usr/bin/env bun
-import {
-  parseGoodVibesCli,
-  renderGoodVibesDaemonHelp,
-  renderGoodVibesVersion,
-} from '../cli/index.ts';
-
-function externalDaemonMessage(binary: string): string {
-  return [
-    `${binary} is disabled in GoodVibes Agent.`,
-    'GoodVibes Agent connects to an already-running GoodVibes daemon and never starts, installs, restarts, or owns daemon/listener lifecycle.',
-    'Start or manage the daemon from GoodVibes TUI or your daemon host tooling, then run goodvibes-agent against that external daemon.',
-  ].join('\n');
-}
-
-async function main(): Promise<void> {
-  const binary = 'goodvibes-daemon';
-  const cli = parseGoodVibesCli(process.argv.slice(2), binary);
-
-  if (cli.errors.length > 0) {
-    console.error(cli.errors.join('\n'));
-    console.error('');
-    console.error(renderGoodVibesDaemonHelp(binary));
-    process.exit(2);
-  }
-
-  if (cli.flags.help || cli.command === 'help') {
-    console.log(renderGoodVibesDaemonHelp(binary));
-    process.exit(0);
-  }
-
-  if (cli.flags.version || cli.command === 'version') {
-    console.log(renderGoodVibesVersion('goodvibes-agent'));
-    process.exit(0);
-  }
-
-  const message = externalDaemonMessage(binary);
-  if (cli.flags.outputFormat === 'json') {
-    console.log(JSON.stringify({
-      ok: false,
-      kind: 'daemon_lifecycle_external',
-      command: binary,
-      error: message,
-    }, null, 2));
-  } else {
-    console.error(message);
-  }
-  process.exit(2);
-}
-
-main().catch((error: unknown) => {
-  const message = error instanceof Error ? error.message : String(error);
-  console.error(message);
-  process.exit(1);
-});

package/src/daemon/safe-serve.ts

@@ -1,61 +0,0 @@
-import { logger } from '@pellux/goodvibes-sdk/platform/utils';
-import { summarizeError } from '@pellux/goodvibes-sdk/platform/utils';
-
-type HostServeFetch = (
-  request: Request,
-  server: unknown,
-) => Response | undefined | Promise<Response | undefined>;
-
-type HostServeOptions = Parameters<typeof Bun.serve>[0] & {
-  fetch?: HostServeFetch;
-};
-
-function requestPath(request: Request): string {
-  try {
-    return new URL(request.url).pathname;
-  } catch {
-    return request.url;
-  }
-}
-
-export function createHostRequestFailureResponse(
-  surface: string,
-  request: Request,
-  error: unknown,
-): Response {
-  const message = summarizeError(error);
-  logger.error(`${surface}: request handler failed`, {
-    method: request.method,
-    path: requestPath(request),
-    error: message,
-  });
-  return Response.json({
-    error: message,
-    code: 'HOST_REQUEST_HANDLER_FAILED',
-  }, { status: 500 });
-}
-
-export function createSafeHostServeFactory(
-  surface: string,
-  baseServeFactory: typeof Bun.serve = Bun.serve,
-): typeof Bun.serve {
-  return ((options: HostServeOptions) => {
-    const originalFetch = options.fetch;
-    if (typeof originalFetch !== 'function') {
-      return baseServeFactory(options as Parameters<typeof Bun.serve>[0]);
-    }
-
-    const wrappedFetch: HostServeFetch = async (request, server) => {
-      try {
-        return await originalFetch(request, server);
-      } catch (error) {
-        return createHostRequestFailureResponse(surface, request, error);
-      }
-    };
-
-    return baseServeFactory({
-      ...options,
-      fetch: wrappedFetch,
-    } as Parameters<typeof Bun.serve>[0]);
-  }) as typeof Bun.serve;
-}