@pellux/goodvibes-agent 0.1.28 → 0.1.30

package/CHANGELOG.md

@@ -2,6 +2,14 @@
 
 All notable changes to GoodVibes Agent will be recorded here.
 
+## 0.1.30 - 2026-05-31
+
+- 6a1c818 Add channel readiness to Agent workspace
+
+## 0.1.29 - 2026-05-31
+
+- 3fafcda Add Agent channel workspace guidance
+
 ## 0.1.28 - 2026-05-31
 
 - 77a9dc4 Add isolated Agent runtime profiles

package/docs/operator-capability-benchmark.md

@@ -30,11 +30,18 @@ Inside the TUI:
 Primary sources used for the benchmark:
 
 - OpenClaw README: https://github.com/openclaw/openclaw/blob/main/README.md
+- OpenClaw Docs: https://docs.openclaw.ai/
+- OpenClaw Features: https://docs.openclaw.ai/concepts/features
 - OpenClaw FAQ: https://docs.openclaw.ai/help/faq
 - OpenClaw Memory: https://docs.openclaw.ai/concepts/memory
 - Hermes README: https://github.com/NousResearch/hermes-agent
+- Hermes Features Overview: https://hermes-agent.nousresearch.com/docs/user-guide/features/overview/
 - Hermes Tools: https://hermes-agent.nousresearch.com/docs/user-guide/features/tools/
+- Hermes Skills: https://hermes-agent.nousresearch.com/docs/user-guide/features/skills/
 - Hermes Cron: https://hermes-agent.nousresearch.com/docs/user-guide/features/cron/
+- Hermes MCP: https://hermes-agent.nousresearch.com/docs/user-guide/features/mcp/
+- Hermes Voice: https://hermes-agent.nousresearch.com/docs/user-guide/features/voice-mode/
+- Hermes API Server: https://hermes-agent.nousresearch.com/docs/user-guide/features/api-server/
 - Hermes Profiles: https://hermes-agent.nousresearch.com/docs/user-guide/profiles/
 
 ## Capability Targets
@@ -43,7 +50,7 @@ Primary sources used for the benchmark:
 | --- | --- | --- |
 | Terminal operator UI | Interactive CLI/TUI, commands, sessions | Near-fork GoodVibes TUI compositor/input/fullscreen foundation |
 | Always-on gateway | Gateway/service owns channels, sessions, tools, events | External GoodVibes daemon, never Agent-owned lifecycle |
-| Channels | WhatsApp, Telegram, Slack, Discord, Signal, iMessage, web chat | GoodVibes daemon channel and companion surfaces with Agent-side policy |
+| Channels | WhatsApp, Telegram, Slack, Discord, Signal, iMessage, web chat | GoodVibes daemon channel and companion surfaces with Agent-side policy, a Channels operator workspace, and per-channel readiness/risk labels |
 | Knowledge/memory | Durable memory, semantic search, wiki/claim layers | Isolated Agent Knowledge routes plus local memory/skills/personas/routines |
 | Skills/procedural memory | Skills directories, registries, skill lifecycle | Local Agent skills with review/stale/source/provenance fields |
 | Scheduling | Natural-language cron, run/pause/resume/edit/remove, delivery | Guarded automation/schedule routes plus local routines; hidden model scheduling blocked |
@@ -66,7 +73,7 @@ GoodVibes Agent should exceed OpenClaw/Hermes by making these properties true fr
 
 ## Current Gaps To Close
 
-- Agent-first channel onboarding workspace for pairing, account visibility, delivery defaults, and channel safety.
+- Live daemon account health and last delivery errors in the Channels workspace once a stable read-only route is available.
 - Richer Agent Knowledge ingest/review workspace for URLs, bookmarks, artifacts, issue queues, and consolidation.
 - Profile-aware onboarding summaries and profile export/import shortcuts from the Agent workspace.
 - Voice/media/browser/node setup workspaces.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pellux/goodvibes-agent",
-  "version": "0.1.28",
+  "version": "0.1.30",
   "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/input/agent-workspace.ts

@@ -30,6 +30,20 @@ export interface AgentWorkspaceCategory {
 
 export type AgentWorkspaceCommandDispatcher = (command: string) => void;
 
+export type AgentWorkspaceChannelRisk = 'dm' | 'group' | 'public' | 'webhook' | 'bridge';
+
+export interface AgentWorkspaceChannelStatus {
+  readonly id: string;
+  readonly label: string;
+  readonly enabled: boolean;
+  readonly ready: boolean;
+  readonly missingConfigCount: number;
+  readonly defaultTarget: 'configured' | 'missing' | 'not-required';
+  readonly delivery: 'disabled' | 'blocked' | 'explicit-target' | 'default-ready';
+  readonly risk: AgentWorkspaceChannelRisk;
+  readonly riskLabel: string;
+}
+
 export type AgentWorkspaceActionResultKind = 'guidance' | 'blocked' | 'dispatched' | 'refreshed' | 'error';
 
 export interface AgentWorkspaceActionResult {
@@ -64,9 +78,140 @@ export interface AgentWorkspaceRuntimeSnapshot {
   readonly knowledgeIsolation: 'agent-only';
   readonly executionPolicy: 'serial-proactive';
   readonly wrfcPolicy: 'explicit-build-delegation-only';
+  readonly channels: readonly AgentWorkspaceChannelStatus[];
   readonly warnings: readonly string[];
 }
 
+interface AgentWorkspaceChannelSpec {
+  readonly id: string;
+  readonly label: string;
+  readonly enabledKey: string;
+  readonly requiredKeys: readonly string[];
+  readonly defaultTargetKeys: readonly string[];
+  readonly risk: AgentWorkspaceChannelRisk;
+  readonly riskLabel: string;
+}
+
+const AGENT_WORKSPACE_CHANNEL_SPECS: readonly AgentWorkspaceChannelSpec[] = [
+  {
+    id: 'slack',
+    label: 'Slack',
+    enabledKey: 'surfaces.slack.enabled',
+    requiredKeys: ['surfaces.slack.botToken', 'surfaces.slack.signingSecret'],
+    defaultTargetKeys: ['surfaces.slack.defaultChannel'],
+    risk: 'group',
+    riskLabel: 'workspace/group channel',
+  },
+  {
+    id: 'discord',
+    label: 'Discord',
+    enabledKey: 'surfaces.discord.enabled',
+    requiredKeys: ['surfaces.discord.botToken', 'surfaces.discord.publicKey', 'surfaces.discord.applicationId'],
+    defaultTargetKeys: ['surfaces.discord.defaultChannelId'],
+    risk: 'group',
+    riskLabel: 'server/channel delivery',
+  },
+  {
+    id: 'telegram',
+    label: 'Telegram',
+    enabledKey: 'surfaces.telegram.enabled',
+    requiredKeys: ['surfaces.telegram.botToken'],
+    defaultTargetKeys: ['surfaces.telegram.defaultChatId'],
+    risk: 'dm',
+    riskLabel: 'bot DM/group delivery',
+  },
+  {
+    id: 'ntfy',
+    label: 'ntfy',
+    enabledKey: 'surfaces.ntfy.enabled',
+    requiredKeys: ['surfaces.ntfy.baseUrl', 'surfaces.ntfy.chatTopic', 'surfaces.ntfy.agentTopic'],
+    defaultTargetKeys: ['surfaces.ntfy.topic'],
+    risk: 'public',
+    riskLabel: 'topic-based public/private feed',
+  },
+  {
+    id: 'googleChat',
+    label: 'Google Chat',
+    enabledKey: 'surfaces.googleChat.enabled',
+    requiredKeys: ['surfaces.googleChat.webhookUrl', 'surfaces.googleChat.verificationToken'],
+    defaultTargetKeys: ['surfaces.googleChat.spaceId'],
+    risk: 'group',
+    riskLabel: 'space delivery',
+  },
+  {
+    id: 'signal',
+    label: 'Signal',
+    enabledKey: 'surfaces.signal.enabled',
+    requiredKeys: ['surfaces.signal.bridgeUrl', 'surfaces.signal.account'],
+    defaultTargetKeys: ['surfaces.signal.defaultRecipient'],
+    risk: 'bridge',
+    riskLabel: 'private bridge delivery',
+  },
+  {
+    id: 'whatsapp',
+    label: 'WhatsApp',
+    enabledKey: 'surfaces.whatsapp.enabled',
+    requiredKeys: ['surfaces.whatsapp.accessToken', 'surfaces.whatsapp.verifyToken', 'surfaces.whatsapp.phoneNumberId'],
+    defaultTargetKeys: ['surfaces.whatsapp.defaultRecipient'],
+    risk: 'dm',
+    riskLabel: 'phone-number delivery',
+  },
+  {
+    id: 'imessage',
+    label: 'iMessage',
+    enabledKey: 'surfaces.imessage.enabled',
+    requiredKeys: ['surfaces.imessage.bridgeUrl', 'surfaces.imessage.account'],
+    defaultTargetKeys: ['surfaces.imessage.defaultChatId'],
+    risk: 'bridge',
+    riskLabel: 'Apple bridge delivery',
+  },
+  {
+    id: 'bluebubbles',
+    label: 'BlueBubbles',
+    enabledKey: 'surfaces.bluebubbles.enabled',
+    requiredKeys: ['surfaces.bluebubbles.serverUrl', 'surfaces.bluebubbles.password'],
+    defaultTargetKeys: ['surfaces.bluebubbles.defaultChatGuid'],
+    risk: 'bridge',
+    riskLabel: 'iMessage bridge delivery',
+  },
+  {
+    id: 'msteams',
+    label: 'Microsoft Teams',
+    enabledKey: 'surfaces.msteams.enabled',
+    requiredKeys: ['surfaces.msteams.appId', 'surfaces.msteams.appPassword'],
+    defaultTargetKeys: ['surfaces.msteams.defaultConversationId', 'surfaces.msteams.defaultChannelId'],
+    risk: 'group',
+    riskLabel: 'tenant/channel delivery',
+  },
+  {
+    id: 'mattermost',
+    label: 'Mattermost',
+    enabledKey: 'surfaces.mattermost.enabled',
+    requiredKeys: ['surfaces.mattermost.baseUrl', 'surfaces.mattermost.botToken'],
+    defaultTargetKeys: ['surfaces.mattermost.defaultChannelId'],
+    risk: 'group',
+    riskLabel: 'team/channel delivery',
+  },
+  {
+    id: 'matrix',
+    label: 'Matrix',
+    enabledKey: 'surfaces.matrix.enabled',
+    requiredKeys: ['surfaces.matrix.homeserverUrl', 'surfaces.matrix.accessToken'],
+    defaultTargetKeys: ['surfaces.matrix.defaultRoomId'],
+    risk: 'group',
+    riskLabel: 'room delivery',
+  },
+  {
+    id: 'webhook',
+    label: 'Webhook',
+    enabledKey: 'surfaces.webhook.enabled',
+    requiredKeys: ['surfaces.webhook.defaultTarget'],
+    defaultTargetKeys: ['surfaces.webhook.defaultTarget'],
+    risk: 'webhook',
+    riskLabel: 'external HTTP delivery',
+  },
+];
+
 function readConfigString(context: CommandContext, key: string, fallback: string): string {
   try {
     const configManager = context.platform?.configManager as unknown as AgentWorkspaceConfigReader | undefined;
@@ -88,6 +233,64 @@ 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 value = configManager?.get(key);
+    if (typeof value === 'boolean') return value;
+    if (typeof value === 'string') {
+      const normalized = value.trim().toLowerCase();
+      if (normalized === 'true') return true;
+      if (normalized === 'false') return false;
+    }
+    return fallback;
+  } catch {
+    return fallback;
+  }
+}
+
+function hasConfigValue(context: CommandContext, key: string): boolean {
+  try {
+    const configManager = context.platform?.configManager as unknown as AgentWorkspaceConfigReader | undefined;
+    const value = configManager?.get(key);
+    if (typeof value === 'string') return value.trim().length > 0;
+    if (typeof value === 'number') return Number.isFinite(value);
+    if (typeof value === 'boolean') return value;
+    return value !== null && value !== undefined;
+  } catch {
+    return false;
+  }
+}
+
+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 defaultTarget = spec.defaultTargetKeys.length === 0
+    ? 'not-required'
+    : spec.defaultTargetKeys.some((key) => hasConfigValue(context, key))
+      ? 'configured'
+      : 'missing';
+  const ready = enabled && missingConfigCount === 0;
+  const delivery = !enabled
+    ? 'disabled'
+    : !ready
+      ? 'blocked'
+      : defaultTarget === 'configured'
+        ? 'default-ready'
+        : 'explicit-target';
+  return {
+    id: spec.id,
+    label: spec.label,
+    enabled,
+    ready,
+    missingConfigCount,
+    defaultTarget,
+    delivery,
+    risk: spec.risk,
+    riskLabel: spec.riskLabel,
+  };
+}
+
 export function buildAgentWorkspaceRuntimeSnapshot(context: CommandContext): AgentWorkspaceRuntimeSnapshot {
   const host = readConfigString(context, 'controlPlane.host', '127.0.0.1');
   const port = readConfigNumber(context, 'controlPlane.port', 3421);
@@ -161,6 +364,7 @@ export function buildAgentWorkspaceRuntimeSnapshot(context: CommandContext): Age
     knowledgeIsolation: 'agent-only',
     executionPolicy: 'serial-proactive',
     wrfcPolicy: 'explicit-build-delegation-only',
+    channels: AGENT_WORKSPACE_CHANNEL_SPECS.map((spec) => buildChannelStatus(context, spec)),
     warnings,
   };
 }
@@ -192,6 +396,19 @@ export const AGENT_WORKSPACE_CATEGORIES: readonly AgentWorkspaceCategory[] = [
       { id: 'auth', label: 'Auth review', detail: 'Review authentication posture without printing token values.', command: '/auth review', kind: 'command', safety: 'read-only' },
     ],
   },
+  {
+    id: 'channels',
+    group: 'SETUP',
+    label: 'Channels',
+    summary: 'Companion pairing, channel posture, and delivery safety.',
+    detail: 'Agent uses externally owned daemon channel surfaces. Pairing, account inspection, and readiness checks are visible here; inbound delivery and public channel exposure stay policy-gated.',
+    actions: [
+      { id: 'pair', label: 'Pair companion', detail: 'Open the TUI-derived QR pairing surface for companion app setup.', command: '/pair', kind: 'command', safety: 'safe' },
+      { id: 'communication', label: 'Communication routes', detail: 'Inspect structured communication routes and recent activity.', command: '/communication', kind: 'command', safety: 'read-only' },
+      { id: 'setup-review', label: 'Channel setup review', detail: 'Review setup posture without starting listeners or mutating daemon surface state.', command: '/setup review', kind: 'command', safety: 'read-only' },
+      { id: 'channel-safety', label: 'Delivery safety', detail: 'External messages, channel DMs, and public delivery targets require explicit user action and daemon-side policy. Agent will not silently send or expose channels from this workspace.', kind: 'guidance', safety: 'blocked' },
+    ],
+  },
   {
     id: 'knowledge',
     group: 'KNOW',

package/src/operator/capability-benchmark.ts

@@ -30,11 +30,18 @@ export interface OperatorCapabilityBenchmarkReport {
 
 export const OPERATOR_CAPABILITY_BENCHMARK_SOURCES = [
   'https://github.com/openclaw/openclaw/blob/main/README.md',
+  'https://docs.openclaw.ai/',
+  'https://docs.openclaw.ai/concepts/features',
   'https://docs.openclaw.ai/help/faq',
   'https://docs.openclaw.ai/concepts/memory',
   'https://github.com/NousResearch/hermes-agent',
+  'https://hermes-agent.nousresearch.com/docs/user-guide/features/overview/',
   'https://hermes-agent.nousresearch.com/docs/user-guide/features/tools/',
+  'https://hermes-agent.nousresearch.com/docs/user-guide/features/skills/',
   'https://hermes-agent.nousresearch.com/docs/user-guide/features/cron/',
+  'https://hermes-agent.nousresearch.com/docs/user-guide/features/mcp/',
+  'https://hermes-agent.nousresearch.com/docs/user-guide/features/voice-mode/',
+  'https://hermes-agent.nousresearch.com/docs/user-guide/features/api-server/',
   'https://hermes-agent.nousresearch.com/docs/user-guide/profiles/',
 ] as const;
 
@@ -69,11 +76,11 @@ export const OPERATOR_CAPABILITY_BENCHMARKS: readonly OperatorCapabilityBenchmar
     posture: 'configurable',
     competitors: ['openclaw', 'hermes'],
     competitorBaseline: 'Messaging gateway for WhatsApp, Telegram, Slack, Discord, Signal, iMessage, web chat, and related platforms.',
-    goodvibesAgent: 'Uses GoodVibes daemon channel, companion, pairing, QR, and session surfaces while keeping side effects behind explicit user action.',
-    configure: ['goodvibes-agent pair', 'goodvibes-agent qrcode', 'goodvibes-agent surfaces check'],
-    use: ['/channels', '/communication', '/pair'],
-    exceedsBy: ['Agent-owned safety policy over shared channel routes', 'read-only inspection by default', 'explicit approval path for external side effects'],
-    next: ['Add Agent-first channel onboarding workspace that exposes connected accounts, delivery defaults, and pairing state without daemon ownership.'],
+    goodvibesAgent: 'Uses GoodVibes daemon channel, companion, pairing, QR, communication, and session surfaces while keeping side effects behind explicit user action. The Agent workspace exposes channel setup, per-channel readiness, default-target posture, and risk labels as a first-class operator area.',
+    configure: ['goodvibes-agent pair', 'goodvibes-agent qrcode', 'goodvibes-agent surfaces check', '/agent → Channels'],
+    use: ['/agent → Channels', '/communication', '/pair'],
+    exceedsBy: ['Agent-owned safety policy over shared channel routes', 'read-only inspection by default', 'explicit approval path for external side effects', 'channel setup discoverable from the fullscreen operator workspace', 'per-channel readiness and delivery defaults shown without leaking token values'],
+    next: ['Pull live daemon account health and last delivery errors into the Channels workspace when a stable read-only route is available.'],
   },
   {
     id: 'isolated-knowledge-wiki',

package/src/renderer/agent-workspace.ts

@@ -88,6 +88,27 @@ function snapshotLines(category: AgentWorkspaceCategory, snapshot: AgentWorkspac
       { text: `Workspace: ${snapshot.workingDirectory}`, fg: PALETTE.muted },
       { text: `Home: ${snapshot.homeDirectory}`, fg: PALETTE.muted },
     );
+  } else if (category.id === 'channels') {
+    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(', ');
+    base.push(
+      { text: `External daemon: ${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 },
+    );
+    for (const channel of snapshot.channels) {
+      const enabled = channel.enabled ? 'enabled' : 'disabled';
+      const ready = channel.ready ? 'ready' : `${channel.missingConfigCount} missing`;
+      base.push({
+        text: `${channel.label}: ${enabled}; ${ready}; default ${channel.defaultTarget}; delivery ${channel.delivery}; risk ${channel.riskLabel}.`,
+        fg: channel.ready ? PALETTE.good : channel.enabled ? PALETTE.warn : PALETTE.dim,
+      });
+    }
   } else if (category.id === 'knowledge') {
     base.push(
       { text: `Route family: ${snapshot.knowledgeRoute}/{status,ask,search}`, fg: PALETTE.info },
@@ -222,7 +243,8 @@ function footerText(workspace: AgentWorkspace): string {
 }
 
 export function renderAgentWorkspace(workspace: AgentWorkspace, width: number, height: number): Line[] {
-  const metrics = getFullscreenWorkspaceMetrics({ width, height, leftWidth: width < 90 ? undefined : 30, contextRatio: 0.48, minContextRows: 8 });
+  const layoutOptions = { width, height, leftWidth: width < 90 ? undefined : 30, contextRatio: 0.62, minContextRows: 10 };
+  const metrics = getFullscreenWorkspaceMetrics(layoutOptions);
   const category = workspace.selectedCategory;
   const action = workspace.selectedAction;
 
@@ -237,5 +259,8 @@ export function renderAgentWorkspace(workspace: AgentWorkspace, width: number, h
     contextRows: buildContextRows(workspace, category, action, metrics.contextWidth),
     controlRows: buildActionRows(workspace, metrics.contextWidth, metrics.controlRows),
     footer: footerText(workspace),
+    leftWidth: layoutOptions.leftWidth,
+    contextRatio: layoutOptions.contextRatio,
+    minContextRows: layoutOptions.minContextRows,
   });
 }

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