@pellux/goodvibes-agent 1.0.34 → 1.0.36

package/src/tools/agent-harness-workspace-actions.ts

@@ -4,6 +4,8 @@ import { AGENT_WORKSPACE_CATEGORIES } from '../input/agent-workspace-categories.
 import { searchAgentWorkspaceActions } from '../input/agent-workspace-search.ts';
 import { buildAgentWorkspaceRuntimeSnapshot } from '../input/agent-workspace-snapshot.ts';
 import type { AgentWorkspaceAction, AgentWorkspaceCategory, AgentWorkspaceEditorKind, AgentWorkspaceLocalEditor, AgentWorkspaceLocalLibraryItem, AgentWorkspaceRuntimeSnapshot } from '../input/agent-workspace-types.ts';
+import { parseSlashCommand } from '../input/slash-command-parser.ts';
+import { describeCommandPolicy } from './agent-harness-metadata.ts';
 import { describeLocalWorkspaceModelExecution } from './agent-harness-local-operations.ts';
 import { describeWorkspaceEditorModelExecution } from './agent-harness-workspace-editor-execution.ts';
 
@@ -97,9 +99,66 @@ export function describeWorkspaceEditor(editor: AgentWorkspaceLocalEditor): Reco
   };
 }
 
-function previewText(value: string, maxLength = 120): string {
+function previewText(value: string, maxLength = 56): string {
   const normalized = value.replace(/\s+/g, ' ').trim();
-  return normalized.length <= maxLength ? normalized : `${normalized.slice(0, maxLength - 1).trimEnd()}...`;
+  return normalized.length <= maxLength ? normalized : `${normalized.slice(0, maxLength - 3).trimEnd()}...`;
+}
+
+function commandRouteHint(command: string): string {
+  const parsed = parseSlashCommand(command);
+  const commandName = parsed.name || command.replace(/^\//, '').trim().split(/\s+/)[0] || command;
+  return describeCommandPolicy(commandName).preferredModelTool ?? 'agent_harness mode:"run_command"';
+}
+
+function editorRouteHint(editorKind: AgentWorkspaceEditorKind): string {
+  if (
+    editorKind === 'memory'
+    || editorKind === 'note'
+    || editorKind === 'persona'
+    || editorKind === 'skill'
+    || editorKind === 'routine'
+  ) return 'agent_local_registry';
+  if (
+    editorKind === 'knowledge-url'
+    || editorKind === 'knowledge-urls'
+    || editorKind === 'knowledge-file'
+    || editorKind === 'knowledge-bookmarks'
+    || editorKind === 'knowledge-browser-history'
+    || editorKind === 'knowledge-connector-ingest'
+  ) return 'agent_knowledge_ingest';
+  if (
+    editorKind === 'knowledge-reindex'
+    || editorKind === 'knowledge-review-issue'
+    || editorKind === 'knowledge-consolidate'
+  ) return 'agent_harness mode:"run_workspace_action"';
+  if (editorKind.startsWith('knowledge-')) return 'agent_knowledge';
+  if (editorKind === 'web-research' || editorKind === 'web-fetch') return 'main conversation prompt';
+  if (editorKind === 'media-generate') return 'agent_media_generate';
+  if (editorKind === 'channel-send') return 'agent_channel_send';
+  if (editorKind === 'notify-send' || editorKind === 'notify-webhook-test') return 'agent_notify';
+  if (editorKind === 'reminder-schedule') return 'agent_reminder_schedule';
+  if (
+    editorKind.startsWith('approval-')
+    || editorKind.startsWith('automation-')
+    || editorKind === 'schedule-run'
+  ) return 'agent_operator_action';
+  if (editorKind.startsWith('workplan-') || editorKind.startsWith('plan-') || editorKind.startsWith('task-')) return 'agent_work_plan';
+  return 'agent_harness mode:"run_workspace_action"';
+}
+
+function localActionRouteHint(action: AgentWorkspaceAction): string {
+  const modelExecution = describeLocalWorkspaceModelExecution(action);
+  const tool = modelExecution && typeof modelExecution.tool === 'string' ? modelExecution.tool : '';
+  return tool || 'agent_local_registry';
+}
+
+function workspaceActionRouteHint(action: AgentWorkspaceAction): string {
+  if (action.command) return commandRouteHint(action.command);
+  if (action.editorKind) return editorRouteHint(action.editorKind);
+  if (action.kind === 'local-selection' || action.kind === 'local-operation') return localActionRouteHint(action);
+  if (action.targetCategoryId || action.kind === 'workspace') return 'agent_harness mode:"open_ui_surface"';
+  if (action.kind === 'guidance') return action.safety === 'blocked' ? 'main conversation policy' : 'main conversation';
+  return 'agent_harness mode:"workspace_action"';
 }
 
 function selectedRoutineFromArgs(
@@ -152,6 +211,7 @@ export function describeWorkspaceAction(
     detail: action.detail,
     kind: action.kind,
     safety: action.safety,
+    modelRoute: previewText(workspaceActionRouteHint(action)),
     ...(action.command ? { command: action.command } : {}),
     ...(action.targetCategoryId ? { targetCategoryId: action.targetCategoryId } : {}),
     ...(action.editorKind ? { editorKind: action.editorKind } : {}),
@@ -181,6 +241,7 @@ function describeWorkspaceActionSummary(
     summary: previewText(action.detail),
     kind: action.kind,
     safety: action.safety,
+    modelRoute: previewText(workspaceActionRouteHint(action)),
     ...(action.command ? { command: action.command } : {}),
     ...(action.targetCategoryId ? { targetCategoryId: action.targetCategoryId } : {}),
     ...(action.editorKind ? { editorKind: action.editorKind } : {}),
@@ -195,7 +256,7 @@ export function listWorkspaceActions(
 ): readonly Record<string, unknown>[] {
   const query = readString(args.query);
   const categoryId = readString(args.categoryId || args.category);
-  const limit = readLimit(args.limit, 200);
+  const limit = readLimit(args.limit, 500);
   const includeEditor = args.includeParameters === true;
   const editorContext = includeEditor ? buildWorkspaceEditorContext(context, args) : null;
   const source = query

package/src/tools/agent-knowledge-ingest-tool.ts

@@ -326,7 +326,7 @@ export function createAgentKnowledgeIngestTool(
           },
           allowPrivateHosts: {
             type: 'boolean',
-            description: 'Allow private-host source URLs where the Agent Knowledge route supports it.',
+            description: 'Allow supported private-host source URLs.',
           },
           confirm: {
             type: 'boolean',

package/src/tools/agent-knowledge-tool.ts

@@ -142,7 +142,7 @@ export function createAgentKnowledgeTool(
           },
           connectorId: {
             type: 'string',
-            description: 'Connector id for action connector or connector_doctor. id may also be used.',
+            description: 'Connector id for connector or connector_doctor.',
           },
           limit: {
             type: 'number',

package/src/tools/agent-media-generate-tool.ts

@@ -74,11 +74,11 @@ export function createAgentMediaGenerateTool(
           },
           confirm: {
             type: 'boolean',
-            description: 'Required true only when the user explicitly asked for this media generation.',
+            description: 'Required true only when user requested this media.',
           },
           explicitUserRequest: {
             type: 'string',
-            description: 'Short quote or summary of the user request that authorized this generation.',
+            description: 'User request authorizing this media generation.',
           },
         },
         required: ['prompt', 'confirm', 'explicitUserRequest'],

package/src/tools/agent-notify-tool.ts

@@ -88,7 +88,7 @@ export function createAgentNotifyTool(
           },
           confirm: {
             type: 'boolean',
-            description: 'Required true only when the user explicitly asked to send this notification.',
+            description: 'Required true only when user requested notification.',
           },
           explicitUserRequest: {
             type: 'string',

package/src/tools/agent-reminder-schedule-tool.ts

@@ -175,7 +175,7 @@ export function createAgentReminderScheduleTool(
           },
           confirm: {
             type: 'boolean',
-            description: 'Required true only when the user explicitly asked to create this reminder.',
+            description: 'Required true only when user requested reminder.',
           },
           explicitUserRequest: {
             type: 'string',

package/src/tools/tool-definition-compaction.ts

@@ -0,0 +1,76 @@
+import type { ToolRegistry } from '@pellux/goodvibes-sdk/platform/tools';
+import type { ToolDefinition } from '@pellux/goodvibes-sdk/platform/types';
+
+const DEFAULT_TOOL_DESCRIPTION_LIMIT = 56;
+
+const TOOL_DESCRIPTION_OVERRIDES: Readonly<Record<string, string>> = {
+  agent: 'Inspect explicit subagent tasks.',
+  analyze: 'Analyze code impact, symbols, and project risk.',
+  channel: 'Inspect or operate configured channel surfaces.',
+  control: 'Inspect commands, panels, and runtime posture.',
+  edit: 'Edit files with exact, fuzzy, or regex replacements.',
+  exec: 'Run shell commands with timeout and retry.',
+  fetch: 'Fetch HTTP URLs with auth and sanitization.',
+  find: 'Search files, content, symbols, and project structure.',
+  goodvibes_context: 'Inspect current GoodVibes runtime and host harness.',
+  goodvibes_settings: 'Inspect/update GoodVibes settings on explicit request.',
+  inspect: 'Inspect project structure, APIs, routes, and deps.',
+  mcp: 'Inspect MCP servers, tools, schemas, and trust state.',
+  packet: 'Manage implementation and execution packets.',
+  query: 'Track operator queries, answers, and closure.',
+  read: 'Read files, outlines, symbols, and ranges.',
+  registry: 'Discover local skills, agents, tools, and templates.',
+  remote: 'Manage remote runner pools and artifacts.',
+  repl: 'Evaluate bounded JS, TS, Python, SQL, or GraphQL.',
+  state: 'Read/update session state and diagnostics.',
+  task: 'Manage cross-session tasks and handoffs.',
+  team: 'Manage team definitions, roles, and lanes.',
+  web_search: 'Search the web through the configured provider.',
+  workflow: 'Inspect/control configured workflow automation.',
+  worklist: 'Manage durable worklists and checklist items.',
+  write: 'Write files with batch, mkdir, backup, and validation.',
+  agent_harness: 'Harness catalog: modes, settings, commands, UI, tools.',
+  agent_knowledge: 'Read isolated Agent Knowledge.',
+  agent_knowledge_ingest: 'Ingest confirmed source into Agent Knowledge.',
+  agent_local_registry: 'Inspect/update Agent memory, notes, skills, routines.',
+  agent_work_plan: 'Inspect/update the visible Agent-local work plan.',
+  agent_operator_briefing: 'Read connected Agent operator state.',
+  agent_operator_action: 'Run one confirmed allowlisted operator action.',
+  agent_reminder_schedule: 'Schedule one confirmed Agent reminder.',
+  agent_channel_send: 'Send confirmed message to configured Agent target.',
+  agent_notify: 'Send one confirmed plain-text notification.',
+  agent_media_generate: 'Generate one confirmed image or video artifact.',
+};
+
+function compactText(value: string, limit: number): string {
+  const normalized = value.replace(/\s+/g, ' ').trim();
+  if (normalized.length <= limit) return normalized;
+  if (limit <= 3) return normalized.slice(0, limit);
+  return `${normalized.slice(0, limit - 3).trimEnd()}...`;
+}
+
+function stripSchemaDescriptions(value: unknown): unknown {
+  if (Array.isArray(value)) return value.map(stripSchemaDescriptions);
+  if (!value || typeof value !== 'object') return value;
+
+  const result: Record<string, unknown> = {};
+  for (const [key, entry] of Object.entries(value)) {
+    if (key === 'description') continue;
+    result[key] = stripSchemaDescriptions(entry);
+  }
+  return result;
+}
+
+function compactToolDefinition(definition: ToolDefinition): void {
+  definition.description = compactText(
+    TOOL_DESCRIPTION_OVERRIDES[definition.name] ?? definition.description,
+    DEFAULT_TOOL_DESCRIPTION_LIMIT,
+  );
+  definition.parameters = stripSchemaDescriptions(definition.parameters) as Record<string, unknown>;
+}
+
+export function compactRegisteredToolDefinitions(toolRegistry: ToolRegistry): void {
+  for (const definition of toolRegistry.getToolDefinitions()) {
+    compactToolDefinition(definition);
+  }
+}

package/src/version.ts

@@ -6,20 +6,14 @@ 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 = '1.0.34';
-let _sdkVersion = '0.33.36';
+let _version = '1.0.36';
 try {
   const pkg = JSON.parse(readFileSync(join(import.meta.dir, '..', 'package.json'), 'utf-8')) as {
     readonly version?: unknown;
-    readonly dependencies?: Record<string, unknown>;
-    readonly devDependencies?: Record<string, unknown>;
   };
   _version = typeof pkg.version === 'string' ? pkg.version : _version;
-  const packageSdkVersion = pkg.dependencies?.['@pellux/goodvibes-sdk'] ?? pkg.devDependencies?.['@pellux/goodvibes-sdk'];
-  _sdkVersion = typeof packageSdkVersion === 'string' ? packageSdkVersion : _sdkVersion;
 } catch {
-  // Compiled binary or missing package.json — use fallback
+  // Compiled binary or missing package.json - use fallback.
 }
 
 export const VERSION = _version;
-export const SDK_VERSION = _sdkVersion;