@pellux/goodvibes-agent 1.0.31 → 1.0.34

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

@@ -78,18 +78,13 @@ export function createAgentNotifyTool(
   return {
     definition: {
       name: 'agent_notify',
-      description: [
-        'Send one plain-text notification to configured GoodVibes Agent webhook notification targets from the main conversation.',
-        'Use only when the user explicitly asks Agent to notify, message, alert, or send a configured notification.',
-        'This uses Agent-local notification webhook targets; it does not create channel routes, authorize accounts, manage connected-host hosting, create separate Agent jobs, run delegated review, or write to default knowledge or non-Agent knowledge segments.',
-        'Set confirm:true only for an explicit user request. Otherwise return the preview/confirmation error.',
-      ].join(' '),
+      description: 'Send one confirmed plain-text notification.',
       parameters: {
         type: 'object',
         properties: {
           message: {
             type: 'string',
-            description: 'Plain-text notification body to send to configured Agent notification webhook targets.',
+            description: 'Plain-text notification body.',
           },
           confirm: {
             type: 'boolean',
@@ -97,7 +92,7 @@ export function createAgentNotifyTool(
           },
           explicitUserRequest: {
             type: 'string',
-            description: 'Short quote or summary of the user request that authorized this external notification.',
+            description: 'User request authorizing this notification.',
           },
         },
         required: ['message', 'confirm', 'explicitUserRequest'],

package/src/tools/agent-operator-action-tool.ts

@@ -35,13 +35,7 @@ export function createAgentOperatorActionTool(
   return {
     definition: {
       name: 'agent_operator_action',
-      description: [
-        'Perform one explicit, confirmed connected-host operator action from the main conversation.',
-        'Allowed actions are approvals.approve, approvals.deny, approvals.cancel, automation.jobs.run, automation.jobs.pause, automation.jobs.resume, automation.runs.cancel, automation.runs.retry, and schedules.run.',
-        'Use only when the user explicitly asks for that exact approval, automation job, automation run, or schedule action.',
-        'This tool never creates, edits, deletes, or discovers automation definitions; never manages connected-host hosting; never uses default knowledge, non-Agent knowledge segments, separate Agent jobs, delegated review, or arbitrary route invocation.',
-        'Set confirm:true only for an explicit user request. Otherwise return the preview/confirmation error.',
-      ].join(' '),
+      description: 'Run one confirmed allowlisted operator action.',
       parameters: {
         type: 'object',
         properties: {
@@ -52,7 +46,7 @@ export function createAgentOperatorActionTool(
           },
           targetId: {
             type: 'string',
-            description: 'Generic target id. Prefer the specific approvalId, jobId, runId, or scheduleId field when known.',
+            description: 'Generic target id.',
           },
           approvalId: {
             type: 'string',
@@ -60,7 +54,7 @@ export function createAgentOperatorActionTool(
           },
           jobId: {
             type: 'string',
-            description: 'Automation job id for automation.jobs.run, automation.jobs.pause, or automation.jobs.resume.',
+            description: 'Automation job id.',
           },
           runId: {
             type: 'string',
@@ -80,7 +74,7 @@ export function createAgentOperatorActionTool(
           },
           confirm: {
             type: 'boolean',
-            description: 'Required true only when the user explicitly asked for this exact operator action.',
+            description: 'Required true for confirmed operator action.',
           },
           explicitUserRequest: {
             type: 'string',

package/src/tools/agent-operator-briefing-tool.ts

@@ -175,12 +175,7 @@ export function createAgentOperatorBriefingTool(
   return {
     definition: {
       name: 'agent_operator_briefing',
-      description: [
-        'Read connected GoodVibes operator state for a concise main-conversation briefing.',
-        'Use when the user asks what needs attention, what is pending, what is scheduled, or what the operator status is.',
-        'This is read-only and calls only public work-plan, approvals, automation, schedules, and scheduler routes.',
-        'It never uses default knowledge, non-Agent knowledge segments, channel send routes, mutation routes, connected-host lifecycle, separate Agent jobs, or delegated review.',
-      ].join(' '),
+      description: 'Read connected Agent operator state for a concise briefing.',
       parameters: {
         type: 'object',
         properties: {},

package/src/tools/agent-read-policy.ts

@@ -126,10 +126,7 @@ export function isBlockedReadPath(path: string): boolean {
 }
 
 function narrowReadToolDefinitionForAgentPolicy(tool: Tool): void {
-  tool.definition.description = [
-    'Read ordinary project files for GoodVibes Agent with bounded, non-secret, main-conversation policy.',
-    'Hidden paths, secret-looking files, broad batches, unoptimized image extraction, and oversized image reads are disabled.',
-  ].join(' ');
+  tool.definition.description = 'Read ordinary non-secret project files for GoodVibes Agent.';
   tool.definition.sideEffects = ['read_fs'];
   tool.definition.concurrency = 'serial';
 

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

@@ -120,12 +120,7 @@ export function createAgentReminderScheduleTool(
   return {
     definition: {
       name: 'agent_reminder_schedule',
-      description: [
-        'Create one connected GoodVibes Agent reminder schedule from the main conversation.',
-        'Use only when the user explicitly asks to be reminded or asks Agent to schedule a reminder.',
-        'This calls the public schedules.create route on the connected GoodVibes host; it does not manage connected-host hosting, create a local scheduler, create separate Agent jobs, use delegated review, or write to default knowledge or non-Agent knowledge segments.',
-        'Set confirm:true only for an explicit user request. Otherwise return the preview/confirmation error.',
-      ].join(' '),
+      description: 'Schedule one confirmed GoodVibes Agent reminder.',
       parameters: {
         type: 'object',
         properties: {
@@ -136,7 +131,7 @@ export function createAgentReminderScheduleTool(
           scheduleKind: {
             type: 'string',
             enum: [...SCHEDULE_KINDS],
-            description: 'Schedule selector: at for one timestamp, every for an interval, cron for a cron expression.',
+            description: 'Schedule kind: at, every, or cron.',
           },
           scheduleValue: {
             type: 'string',
@@ -160,7 +155,7 @@ export function createAgentReminderScheduleTool(
           },
           deliveryChannel: {
             type: 'string',
-            description: 'Optional delivery channel target: surfaceKind:routeId:label, for example slack:ops:Ops.',
+            description: 'Optional delivery channel target.',
           },
           deliveryRoute: {
             type: 'string',
@@ -184,7 +179,7 @@ export function createAgentReminderScheduleTool(
           },
           explicitUserRequest: {
             type: 'string',
-            description: 'Short quote or summary of the user request that authorized this reminder creation.',
+            description: 'User request authorizing this reminder.',
           },
         },
         required: ['message', 'scheduleKind', 'scheduleValue', 'confirm', 'explicitUserRequest'],

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

@@ -206,10 +206,7 @@ export function installAgentToolPolicyGuard(registry: ToolRegistry, options: Age
       wrapModeRestrictedToolForAgentPolicy(tool, {
         allowedModes: READ_ONLY_REMOTE_TOOL_MODES,
         modeSet: READ_ONLY_REMOTE_TOOL_MODE_SET,
-        description: [
-          'Read-only remote build-host inspection for GoodVibes Agent.',
-          'Pool creation, host assignment, unassignment, and artifact import are disabled in the main conversation.',
-        ].join(' '),
+        description: 'Read-only remote build-host inspection. Mutations are disabled in Agent.',
         denial: REMOTE_MUTATION_DENIAL,
       });
     } else if (tool.definition.name === 'channel') {
@@ -218,10 +215,7 @@ export function installAgentToolPolicyGuard(registry: ToolRegistry, options: Age
       wrapModeRestrictedToolForAgentPolicy(tool, {
         allowedModes: READ_ONLY_MCP_TOOL_MODES,
         modeSet: READ_ONLY_MCP_TOOL_MODE_SET,
-        description: [
-          'Read-only MCP inspection for GoodVibes Agent.',
-          'Quarantine approval, trust mutation, and role mutation are disabled in the main conversation.',
-        ].join(' '),
+        description: 'Read-only MCP inspection. Mutations are disabled in Agent.',
         denial: MCP_SECURITY_MUTATION_DENIAL,
       });
     } else if (tool.definition.name === 'fetch') {
@@ -246,17 +240,14 @@ export function installAgentToolPolicyGuard(registry: ToolRegistry, options: Age
       wrapModeRestrictedToolForAgentPolicy(tool, {
         allowedModes: READ_ONLY_CONTROL_TOOL_MODES,
         modeSet: READ_ONLY_CONTROL_TOOL_MODE_SET,
-        description: [
-          'Read-only product-control inspection for GoodVibes Agent.',
-          'Command, panel, and subscription catalogs can be inspected, but product-control mutation and connected-host lifecycle are external.',
-        ].join(' '),
+        description: 'Read-only product-control inspection. Mutations are external.',
         denial: CONTROL_MUTATION_DENIAL,
       });
     } else if (tool.definition.name === 'task') {
       wrapModeRestrictedToolForAgentPolicy(tool, {
         allowedModes: READ_ONLY_TASK_TOOL_MODES,
         modeSet: READ_ONLY_TASK_TOOL_MODE_SET,
-        description: 'Read-only task/workflow inspection for GoodVibes Agent. Task creation, status changes, dependencies, cancellation, and handoff mutation are disabled in the main conversation.',
+        description: 'Read-only task/workflow inspection. Mutations are disabled in Agent.',
         denial: DURABLE_WORKFLOW_MUTATION_DENIAL,
         removedProperties: ['title', 'label', 'status', 'dependsOnSessionId', 'dependsOnTaskId', 'reason', 'toSessionId'],
       });
@@ -264,7 +255,7 @@ export function installAgentToolPolicyGuard(registry: ToolRegistry, options: Age
       wrapModeRestrictedToolForAgentPolicy(tool, {
         allowedModes: READ_ONLY_TEAM_TOOL_MODES,
         modeSet: READ_ONLY_TEAM_TOOL_MODE_SET,
-        description: 'Read-only team inspection for GoodVibes Agent. Team creation, membership changes, lane changes, and deletion are disabled in the main conversation.',
+        description: 'Read-only team inspection. Mutations are disabled in Agent.',
         denial: DURABLE_WORKFLOW_MUTATION_DENIAL,
         removedProperties: ['name', 'summary', 'memberId', 'role', 'lanes'],
       });
@@ -272,7 +263,7 @@ export function installAgentToolPolicyGuard(registry: ToolRegistry, options: Age
       wrapModeRestrictedToolForAgentPolicy(tool, {
         allowedModes: READ_ONLY_WORKLIST_TOOL_MODES,
         modeSet: READ_ONLY_WORKLIST_TOOL_MODE_SET,
-        description: 'Read-only worklist inspection for GoodVibes Agent. Worklist creation and item lifecycle changes are disabled in the main conversation.',
+        description: 'Read-only worklist inspection. Mutations are disabled in Agent.',
         denial: DURABLE_WORKFLOW_MUTATION_DENIAL,
         removedProperties: ['title', 'itemId', 'text', 'owner', 'priority'],
       });
@@ -280,7 +271,7 @@ export function installAgentToolPolicyGuard(registry: ToolRegistry, options: Age
       wrapModeRestrictedToolForAgentPolicy(tool, {
         allowedModes: READ_ONLY_PACKET_TOOL_MODES,
         modeSet: READ_ONLY_PACKET_TOOL_MODE_SET,
-        description: 'Read-only operator packet inspection for GoodVibes Agent. Packet creation, revision, and publishing are disabled in the main conversation.',
+        description: 'Read-only operator packet inspection. Mutations are disabled in Agent.',
         denial: DURABLE_WORKFLOW_MUTATION_DENIAL,
         removedProperties: ['title', 'summary', 'goals', 'constraints', 'risks', 'audience'],
       });
@@ -288,7 +279,7 @@ export function installAgentToolPolicyGuard(registry: ToolRegistry, options: Age
       wrapModeRestrictedToolForAgentPolicy(tool, {
         allowedModes: READ_ONLY_QUERY_TOOL_MODES,
         modeSet: READ_ONLY_QUERY_TOOL_MODE_SET,
-        description: 'Read-only operator query inspection for GoodVibes Agent. Asking, answering, and closing runtime-owned workflow queries are disabled in the main conversation.',
+        description: 'Read-only operator query inspection. Mutations are disabled in Agent.',
         denial: DURABLE_WORKFLOW_MUTATION_DENIAL,
         removedProperties: ['prompt', 'askedBy', 'target', 'answer', 'resolution'],
       });
@@ -318,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 });
 }
@@ -358,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',
@@ -612,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;
@@ -628,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;
@@ -657,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;
@@ -698,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;
@@ -732,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,12 +165,7 @@ export function createAgentWorkPlanTool(store: WorkPlanStore): Tool {
   return {
     definition: {
       name: 'agent_work_plan',
-      description: [
-        'Inspect and maintain the visible GoodVibes Agent local work plan from the main conversation.',
-        'Use this to track concrete tasks the assistant is doing or has agreed to do, so the work is visible in the Agent TUI workspace.',
-        'This uses only Agent-local persisted work-plan state; it does not call connected-host mutation routes, start background jobs, create separate Agent jobs, use delegated review, write default knowledge, or use non-Agent knowledge segments.',
-        'Create, update, and set_status are safe local state actions. remove and clear_completed require confirm:true plus explicitUserRequest.',
-      ].join(' '),
+      description: 'Inspect or update the visible Agent-local work plan.',
       parameters: {
         type: 'object',
         properties: {

package/src/version.ts

@@ -6,8 +6,8 @@ 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.31';
-let _sdkVersion = '0.33.35';
+let _version = '1.0.34';
+let _sdkVersion = '0.33.36';
 try {
   const pkg = JSON.parse(readFileSync(join(import.meta.dir, '..', 'package.json'), 'utf-8')) as {
     readonly version?: unknown;