@pellux/goodvibes-agent 0.1.77 → 0.1.78

package/CHANGELOG.md

@@ -2,6 +2,11 @@
 
 All notable changes to GoodVibes Agent will be recorded here.
 
+## 0.1.78 - 2026-06-01
+
+- Expanded the Agent channel workspace into a concrete readiness matrix with setup state, missing runtime config keys, default-target posture, and safe next steps for each externally owned channel.
+- Kept channel setup read-only inside Agent: no runtime lifecycle ownership, no hidden sends, and no secret values rendered.
+
 ## 0.1.77 - 2026-06-01
 
 - Added a first-class Agent profile creation form inside the fullscreen operator workspace instead of dispatching a placeholder command template.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pellux/goodvibes-agent",
-  "version": "0.1.77",
+  "version": "0.1.78",
   "private": false,
   "description": "GoodVibes personal operator assistant TUI with a proactive Agent product brain, isolated Agent Knowledge, local profiles, routines, skills, personas, and explicit build delegation.",
   "type": "module",

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

@@ -7,11 +7,17 @@ export interface AgentWorkspaceChannelStatus {
   readonly label: string;
   readonly enabled: boolean;
   readonly ready: boolean;
+  readonly requiredKeys: readonly string[];
+  readonly missingRequiredKeys: readonly string[];
   readonly missingConfigCount: number;
+  readonly defaultTargetKeys: readonly string[];
+  readonly configuredDefaultTargetKeys: readonly string[];
   readonly defaultTarget: 'configured' | 'missing' | 'not-required';
   readonly delivery: 'disabled' | 'blocked' | 'explicit-target' | 'default-ready';
   readonly risk: AgentWorkspaceChannelRisk;
   readonly riskLabel: string;
+  readonly setupState: 'disabled' | 'needs-config' | 'needs-target' | 'ready';
+  readonly nextStep: string;
 }
 
 interface AgentWorkspaceConfigReader {
@@ -182,10 +188,12 @@ function hasConfigValue(context: CommandContext, key: string): boolean {
 
 function buildChannelStatus(context: CommandContext, spec: AgentWorkspaceChannelSpec): AgentWorkspaceChannelStatus {
   const enabled = readConfigBoolean(context, spec.enabledKey, false);
-  const missingConfigCount = spec.requiredKeys.filter((key) => !hasConfigValue(context, key)).length;
+  const missingRequiredKeys = spec.requiredKeys.filter((key) => !hasConfigValue(context, key));
+  const configuredDefaultTargetKeys = spec.defaultTargetKeys.filter((key) => hasConfigValue(context, key));
+  const missingConfigCount = missingRequiredKeys.length;
   const defaultTarget = spec.defaultTargetKeys.length === 0
     ? 'not-required'
-    : spec.defaultTargetKeys.some((key) => hasConfigValue(context, key))
+    : configuredDefaultTargetKeys.length > 0
       ? 'configured'
       : 'missing';
   const ready = enabled && missingConfigCount === 0;
@@ -196,16 +204,36 @@ function buildChannelStatus(context: CommandContext, spec: AgentWorkspaceChannel
       : defaultTarget === 'configured'
         ? 'default-ready'
         : 'explicit-target';
+  const setupState = !enabled
+    ? 'disabled'
+    : missingConfigCount > 0
+      ? 'needs-config'
+      : defaultTarget === 'missing'
+        ? 'needs-target'
+        : 'ready';
+  const nextStep = setupState === 'disabled'
+    ? `Enable ${spec.label} in the owning GoodVibes runtime before Agent can use it.`
+    : setupState === 'needs-config'
+      ? `Configure ${missingRequiredKeys.join(', ')} in the owning runtime or secret manager.`
+      : setupState === 'needs-target'
+        ? `Provide an explicit delivery target per send, or configure one of ${spec.defaultTargetKeys.join(', ')}.`
+        : `Use explicit user action or runtime policy to send through ${spec.label}.`;
   return {
     id: spec.id,
     label: spec.label,
     enabled,
     ready,
+    requiredKeys: spec.requiredKeys,
+    missingRequiredKeys,
     missingConfigCount,
+    defaultTargetKeys: spec.defaultTargetKeys,
+    configuredDefaultTargetKeys,
     defaultTarget,
     delivery,
     risk: spec.risk,
     riskLabel: spec.riskLabel,
+    setupState,
+    nextStep,
   };
 }
 

package/src/renderer/agent-workspace.ts

@@ -205,23 +205,34 @@ function snapshotLines(workspace: AgentWorkspace, category: AgentWorkspaceCatego
     const enabledCount = snapshot.channels.filter((channel) => channel.enabled).length;
     const readyCount = snapshot.channels.filter((channel) => channel.ready).length;
     const configuredDefaults = snapshot.channels.filter((channel) => channel.defaultTarget === 'configured').length;
-    const disabledChannels = snapshot.channels.filter((channel) => !channel.enabled).map((channel) => channel.label).join(', ');
+    const readyChannels = snapshot.channels.filter((channel) => channel.ready).map((channel) => channel.label);
+    const needsTarget = snapshot.channels.filter((channel) => channel.setupState === 'needs-target');
+    const needsConfig = snapshot.channels.filter((channel) => channel.setupState === 'needs-config');
+    const disabledChannels = snapshot.channels.filter((channel) => !channel.enabled).map((channel) => channel.label);
+    const disabledPreview = disabledChannels.slice(0, 6).join(', ');
+    const disabledSuffix = disabledChannels.length > 6 ? `, +${disabledChannels.length - 6} more` : '';
+    const orderedChannels = [
+      ...snapshot.channels.filter((channel) => channel.enabled),
+      ...snapshot.channels.filter((channel) => !channel.enabled),
+    ].slice(0, 6);
     base.push(
       { text: `GoodVibes runtime: ${snapshot.daemonBaseUrl}`, fg: PALETTE.info },
       { text: `Readiness: ${readyCount}/${snapshot.channels.length} ready; ${enabledCount} enabled; ${configuredDefaults} default target(s) configured.`, fg: PALETTE.info },
-      { text: `Disabled channels: ${disabledChannels || 'none'}.`, fg: PALETTE.dim },
-      { text: 'Pairing: use /pair or /qrcode for companion setup.', fg: PALETTE.info },
-      { text: 'Channel posture: inspect via /communication and /setup review.', fg: PALETTE.muted },
-      { text: 'Safety: external delivery, unknown senders, and public exposure require explicit policy and user action.', fg: PALETTE.warn },
+      { text: `Ready channels: ${readyChannels.join(', ') || 'none'}.`, fg: readyChannels.length > 0 ? PALETTE.good : PALETTE.warn },
+      { text: `Needs default target: ${needsTarget.map((channel) => `${channel.label} -> ${channel.defaultTargetKeys.join('|')}`).join(', ') || 'none'}.`, fg: needsTarget.length > 0 ? PALETTE.warn : PALETTE.muted },
+      { text: `Needs config: ${needsConfig.map((channel) => `${channel.label} -> ${channel.missingRequiredKeys.join('|')}`).join(', ') || 'none'}.`, fg: needsConfig.length > 0 ? PALETTE.warn : PALETTE.muted },
+      { text: `Disabled channels: ${disabledPreview || 'none'}${disabledSuffix}.`, fg: PALETTE.dim },
+      { text: 'Safety: no secret values; sends and public exposure require explicit user action and runtime policy.', fg: PALETTE.warn },
     );
-    for (const channel of snapshot.channels) {
-      const enabled = channel.enabled ? 'enabled' : 'disabled';
+    for (const channel of orderedChannels) {
       const ready = channel.ready ? 'ready' : `${channel.missingConfigCount} missing`;
       base.push({
-        text: `${channel.label}: ${enabled}; ${ready}; default ${channel.defaultTarget}; delivery ${channel.delivery}; risk ${channel.riskLabel}.`,
+        text: `${channel.label}: ${channel.setupState}; ${ready}; target ${channel.defaultTarget}; delivery ${channel.delivery}; risk ${channel.risk}.`,
         fg: channel.ready ? PALETTE.good : channel.enabled ? PALETTE.warn : PALETTE.dim,
       });
     }
+    base.push({ text: 'Only config key names and readiness state are rendered here.', fg: PALETTE.muted });
+    base.push({ text: 'Pairing: use /pair or /qrcode; inspect routed activity with /communication and /setup review.', fg: PALETTE.info });
   } else if (category.id === 'knowledge') {
     base.push(
       { text: `Route family: ${snapshot.knowledgeRoute}/{status,ask,search}`, fg: PALETTE.info },

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.77';
+let _version = '0.1.78';
 let _sdkVersion = '0.33.35';
 try {
   const pkg = JSON.parse(readFileSync(join(import.meta.dir, '..', 'package.json'), 'utf-8')) as {