@pellux/goodvibes-agent 1.0.33 → 1.0.35

package/src/tools/agent-tool-policy-guard.ts

@@ -309,11 +309,7 @@ export function normalizeAgentToolInvocationForAgentPolicy(args: AgentToolArgs):
 }
 
 export function wrapBlockedMainConversationToolForAgentPolicy(tool: Tool): void {
-  tool.definition.description = [
-    `Blocked in GoodVibes Agent main conversation: ${tool.definition.name}.`,
-    'Use explicit GoodVibes TUI build delegation for build/fix/review/code execution work.',
-    'Use Agent-owned local registries and isolated Agent Knowledge routes for Agent memory and knowledge work.',
-  ].join(' ');
+  tool.definition.description = `Blocked in GoodVibes Agent: ${tool.definition.name}.`;
   tool.definition.sideEffects = [];
   tool.execute = async () => ({ success: false, error: LOCAL_CODING_TOOL_DENIAL });
 }
@@ -349,11 +345,7 @@ export function wrapStateToolForAgentPolicy(tool: Tool): void {
 }
 
 export function wrapBlockedSettingsToolForAgentPolicy(tool: Tool): void {
-  tool.definition.description = [
-    'Blocked in GoodVibes Agent main conversation: configuration mutation.',
-    'Use explicit Agent CLI/slash settings commands for intentional config changes.',
-    'Connected-host lifecycle and service exposure remain externally managed outside GoodVibes Agent.',
-  ].join(' ');
+  tool.definition.description = 'Blocked in GoodVibes Agent: configuration mutation.';
   tool.definition.sideEffects = [];
   tool.definition.parameters = {
     type: 'object',
@@ -603,11 +595,7 @@ function isPresent(value: unknown): boolean {
 }
 
 function narrowAgentToolDefinitionForAgentPolicy(tool: Tool): void {
-  tool.definition.description = [
-    'Read-only local Agent inspection for GoodVibes Agent.',
-    'This product does not create separate Agent jobs or run local delegated review chains.',
-    'For build/fix/review work, delegate to GoodVibes TUI through the explicit build-delegation path instead.',
-  ].join(' ');
+  tool.definition.description = 'Read-only local Agent inspection for GoodVibes Agent.';
   tool.definition.sideEffects = [];
 
   const properties = tool.definition.parameters.properties;
@@ -619,11 +607,7 @@ function narrowAgentToolDefinitionForAgentPolicy(tool: Tool): void {
 }
 
 function narrowExecToolDefinitionForAgentPolicy(tool: Tool): void {
-  tool.definition.description = [
-    'Execute foreground shell commands serially for GoodVibes Agent main-conversation work.',
-    'Background processes, parallel batches, background process controls, and exec file_ops are disabled by Agent policy.',
-    'Delegate long-running build/fix/review execution to GoodVibes TUI instead.',
-  ].join(' ');
+  tool.definition.description = 'Execute foreground shell commands serially for GoodVibes Agent.';
 
   const properties = tool.definition.parameters.properties;
   if (!isRecord(properties)) return;
@@ -648,11 +632,7 @@ function narrowExecToolDefinitionForAgentPolicy(tool: Tool): void {
 }
 
 function narrowFetchToolDefinitionForAgentPolicy(tool: Tool): void {
-  tool.definition.description = [
-    'Fetch public URLs for GoodVibes Agent with serial, read-only HTTP requests.',
-    'Only GET, HEAD, and OPTIONS are available in the main conversation.',
-    'Credentialed requests, request bodies, trust overrides, raw unsanitized responses, and parallel batches are disabled by Agent policy.',
-  ].join(' ');
+  tool.definition.description = 'Fetch public URLs with serial, read-only HTTP requests.';
 
   const properties = tool.definition.parameters.properties;
   if (!isRecord(properties)) return;
@@ -689,11 +669,7 @@ function narrowFetchToolDefinitionForAgentPolicy(tool: Tool): void {
 }
 
 function narrowStateToolDefinitionForAgentPolicy(tool: Tool): void {
-  tool.definition.description = [
-    'Inspect runtime-owned state for GoodVibes Agent.',
-    'State mutation, runtime-owned memory writes, hook changes, output-mode changes, and analytics writes are disabled in the main conversation.',
-    'Use Agent-owned commands for intentional memory, skill, persona, and routine changes.',
-  ].join(' ');
+  tool.definition.description = 'Inspect runtime-owned state for GoodVibes Agent.';
 
   const properties = tool.definition.parameters.properties;
   if (!isRecord(properties)) return;
@@ -723,10 +699,7 @@ function narrowStateToolDefinitionForAgentPolicy(tool: Tool): void {
 }
 
 function narrowInspectToolDefinitionForAgentPolicy(tool: Tool): void {
-  tool.definition.description = [
-    'Inspect and analyze project structure for GoodVibes Agent.',
-    'Scaffold mode is dry-run-only in the main conversation; code creation must be delegated to GoodVibes TUI.',
-  ].join(' ');
+  tool.definition.description = 'Inspect and analyze project structure for GoodVibes Agent.';
 
   const properties = tool.definition.parameters.properties;
   if (!isRecord(properties)) return;

package/src/tools/agent-web-search-policy.ts

@@ -73,10 +73,7 @@ export function normalizeWebSearchToolInvocationForAgentPolicy(args: WebSearchTo
 }
 
 function narrowWebSearchToolDefinitionForAgentPolicy(tool: Tool): void {
-  tool.definition.description = [
-    'Run bounded, read-only web research for GoodVibes Agent.',
-    'Full-page/raw/summary extraction, safe-search off, and high-fanout searches are disabled in the main conversation.',
-  ].join(' ');
+  tool.definition.description = 'Run bounded, read-only web research for GoodVibes Agent.';
   tool.definition.sideEffects = ['network'];
 
   const properties = tool.definition.parameters.properties;

package/src/tools/agent-work-plan-tool.ts

@@ -165,11 +165,7 @@ export function createAgentWorkPlanTool(store: WorkPlanStore): Tool {
   return {
     definition: {
       name: 'agent_work_plan',
-      description: [
-        'Inspect or update the visible Agent-local work plan.',
-        'Use for task/status tracking.',
-        'Destructive actions require confirm:true plus explicitUserRequest.',
-      ].join(' '),
+      description: 'Inspect or update the visible Agent-local work plan.',
       parameters: {
         type: 'object',
         properties: {

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

@@ -0,0 +1,49 @@
+import type { ToolRegistry } from '@pellux/goodvibes-sdk/platform/tools';
+import type { ToolDefinition } from '@pellux/goodvibes-sdk/platform/types';
+
+const DEFAULT_TOOL_DESCRIPTION_LIMIT = 120;
+
+const TOOL_DESCRIPTION_OVERRIDES: Readonly<Record<string, string>> = {
+  agent_harness: 'Harness catalog/control. Start with mode:"modes"; inspect settings, commands, UI, status, tools, and confirmed effects.',
+  agent_knowledge: 'Read isolated Agent Knowledge.',
+  agent_knowledge_ingest: 'Ingest one confirmed source into isolated Agent Knowledge.',
+  agent_local_registry: 'Inspect or update Agent-local memory, notes, personas, skills, bundles, and routines.',
+  agent_work_plan: 'Inspect or 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 one confirmed message through one 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 = TOOL_DESCRIPTION_OVERRIDES[definition.name]
+    ?? compactText(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,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 = '1.0.33';
+let _version = '1.0.35';
 let _sdkVersion = '0.33.36';
 try {
   const pkg = JSON.parse(readFileSync(join(import.meta.dir, '..', 'package.json'), 'utf-8')) as {