@pellux/goodvibes-agent 1.1.7 → 1.3.0

package/src/tools/agent-harness-tool-schema.ts

@@ -1,14 +1,27 @@
 export const AGENT_HARNESS_MODES = [
-  'summary', 'modes', 'mode', 'cli_commands', 'cli_command', 'panels', 'panel', 'open_panel',
+  'summary', 'modes', 'mode', 'route_decision', 'cli_commands', 'cli_command', 'panels', 'panel', 'open_panel',
   'ui_surfaces', 'ui_surface', 'open_ui_surface',
   'shortcuts', 'keybindings', 'keybinding', 'run_keybinding', 'set_keybinding', 'reset_keybinding',
-  'commands', 'command', 'run_command', 'channels', 'channel', 'notifications', 'notification_target',
+  'commands', 'command', 'run_command', 'channels', 'channel', 'channel_setup_guide', 'channel_triage', 'channel_deliveries', 'notifications', 'notification_target',
   'provider_accounts', 'provider_account', 'mcp_servers', 'mcp_server',
-  'setup_posture', 'setup_item',
-  'model_routing', 'model_route',
+  'setup_posture', 'setup_item', 'setup_repair', 'setup_checkpoint', 'mark_setup_checkpoint', 'clear_setup_checkpoint', 'provision_connected_host_token', 'run_setup_smoke',
+  'project_context', 'project_context_file', 'prompt_context',
+  'agent_orchestration', 'agent_orchestration_agent',
+  'model_routing', 'model_route', 'run_local_model_smoke',
+  'execution_posture', 'execution_route', 'browser_control_route',
+  'background_processes', 'background_process', 'run_background_process',
+  'execution_history', 'execution_history_item',
+  'file_recovery', 'run_file_recovery',
+  'personal_ops_briefing', 'personal_ops', 'personal_ops_queue', 'personal_ops_intake', 'personal_ops_lane', 'run_personal_ops_read',
+  'memory_posture', 'memory_provider', 'memory_refinement', 'run_memory_refinement',
+  'autonomy_intake', 'autonomy_queue', 'autonomy_queue_item',
+  'learning_curator', 'learning_candidate',
+  'research_briefing', 'research_workflow', 'research_runs', 'research_run',
+  'research_queue', 'research_source',
+  'document_ops', 'document_ops_lane',
   'pairing_posture', 'pairing_route',
   'delegation_posture', 'delegation_route',
-  'security_posture', 'security_finding', 'support_bundles', 'support_bundle',
+  'security_posture', 'security_finding', 'policy_explain', 'support_bundles', 'support_bundle',
   'media_posture', 'media_provider',
   'sessions', 'session',
   'settings', 'get_setting', 'set_setting',
@@ -75,9 +88,97 @@ export const AGENT_HARNESS_PARAMETER_PROPERTIES = {
     type: 'string',
     description: 'Setup item id for setup_item mode.',
   },
+  contextFileId: {
+    type: 'string',
+    description: 'Project context file id for project_context_file mode.',
+  },
+  receiptId: {
+    type: 'string',
+    description: 'Prompt-context receipt id for prompt_context drill-in.',
+  },
+  turnId: {
+    type: 'string',
+    description: 'Prompt-context turn id for prompt_context receipt filtering.',
+  },
+  outcomeStatus: {
+    type: 'string',
+    enum: ['completed', 'error', 'cancelled', 'pending'],
+    description: 'Prompt-context receipt outcome filter.',
+  },
+  agentId: {
+    type: 'string',
+    description: 'Visible Agent id for agent_orchestration_agent mode.',
+  },
   modelRouteId: {
     type: 'string',
-    description: 'Model route id or model key for model_route mode.',
+    description: 'Model route, model key, or local endpoint id.',
+  },
+  executionRouteId: {
+    type: 'string',
+    description: 'Execution route id for execution_route mode.',
+  },
+  executionRecordId: {
+    type: 'string',
+    description: 'Execution history record id for execution_history_item mode.',
+  },
+  processId: {
+    type: 'string',
+    description: 'Background process id for process inspect or lifecycle modes.',
+  },
+  processSessionId: {
+    type: 'string',
+    description: 'Process session id alias for background process modes.',
+  },
+  processAction: {
+    type: 'string',
+    enum: ['start', 'spawn', 'run', 'stop', 'kill', 'cancel', 'wait', 'list', 'status', 'poll', 'log', 'output', 'write', 'capabilities', 'doctor', 'parity'],
+    description: 'Background process lifecycle action or process-style alias.',
+  },
+  action: {
+    type: 'string',
+    enum: ['start', 'spawn', 'run', 'stop', 'kill', 'cancel', 'wait', 'list', 'status', 'poll', 'log', 'output', 'write', 'capabilities', 'doctor', 'parity'],
+    description: 'Process-style action alias for run_background_process.',
+  },
+  cwd: {
+    type: 'string',
+    description: 'Workspace-relative cwd for a background process start.',
+  },
+  timeoutMs: {
+    type: 'number',
+    description: 'Timeout for process waits or local model smoke probes.',
+  },
+  pty: {
+    type: 'boolean',
+    description: 'Request PTY mode; currently reports unsupported.',
+  },
+  data: {
+    type: 'string',
+    description: 'Input data for process write; currently reports unsupported.',
+  },
+  recoveryAction: {
+    type: 'string',
+    enum: ['undo', 'redo'],
+    description: 'File recovery action for run_file_recovery mode.',
+  },
+  laneId: {
+    type: 'string',
+    description: 'Lane id for personal_ops_lane or document_ops_lane mode.',
+  },
+  queueItemId: {
+    type: 'string',
+    description: 'Queue item id for autonomy_queue_item mode.',
+  },
+  candidateId: {
+    type: 'string',
+    description: 'Candidate id for learning_candidate mode.',
+  },
+  sourceId: {
+    type: 'string',
+    description: 'Research source id for research_source mode.',
+  },
+  runId: {
+    type: 'string',
+    description: 'Research run id for research_run mode.',
   },
   pairingRouteId: {
     type: 'string',
@@ -101,7 +202,11 @@ export const AGENT_HARNESS_PARAMETER_PROPERTIES = {
   },
   sessionId: {
     type: 'string',
-    description: 'Saved session id for session mode.',
+    description: 'Saved session id, or process session id in process modes.',
+  },
+  session_id: {
+    type: 'string',
+    description: 'Snake-case process session id alias.',
   },
   categoryId: {
     type: 'string',
@@ -137,6 +242,28 @@ export const AGENT_HARNESS_PARAMETER_PROPERTIES = {
     type: 'string',
     description: 'Selected Agent-local record id.',
   },
+  knowledgeSpaceId: {
+    type: 'string',
+    description: 'Agent Knowledge space id for memory_refinement or run_memory_refinement.',
+  },
+  sourceIds: {
+    type: 'array',
+    items: { type: 'string' },
+    description: 'Agent Knowledge source ids for scoped semantic refinement.',
+  },
+  gapIds: {
+    type: 'array',
+    items: { type: 'string' },
+    description: 'Agent Knowledge semantic gap ids for scoped refinement.',
+  },
+  maxRunMs: {
+    type: 'number',
+    description: 'Maximum semantic refinement run budget in milliseconds.',
+  },
+  force: {
+    type: 'boolean',
+    description: 'Force semantic refinement reprocessing where supported.',
+  },
   key: {
     type: 'string',
     description: 'Agent setting key.',
@@ -177,6 +304,14 @@ export const AGENT_HARNESS_PARAMETER_PROPERTIES = {
     type: 'string',
     description: 'First-class model tool name.',
   },
+  tool: {
+    type: 'string',
+    description: 'Alias for toolName in policy_explain mode.',
+  },
+  toolArgs: {
+    type: 'object',
+    description: 'Model tool arguments for policy_explain mode.',
+  },
   category: {
     type: 'string',
     description: 'Setting category filter.',

package/src/tools/agent-harness-tool-types.ts

@@ -0,0 +1,83 @@
+import type { ToolRegistry } from '@pellux/goodvibes-sdk/platform/tools';
+import type { CommandContext, CommandRegistry } from '../input/command-registry.ts';
+
+export interface AgentHarnessToolArgs {
+  readonly mode?: unknown;
+  readonly query?: unknown;
+  readonly command?: unknown;
+  readonly cliCommand?: unknown;
+  readonly commandName?: unknown;
+  readonly args?: unknown;
+  readonly channelId?: unknown;
+  readonly notificationTargetId?: unknown;
+  readonly providerId?: unknown;
+  readonly mcpServerId?: unknown;
+  readonly setupItemId?: unknown;
+  readonly contextFileId?: unknown;
+  readonly receiptId?: unknown;
+  readonly turnId?: unknown;
+  readonly outcomeStatus?: unknown;
+  readonly modelRouteId?: unknown;
+  readonly executionRouteId?: unknown;
+  readonly executionRecordId?: unknown;
+  readonly processId?: unknown;
+  readonly processSessionId?: unknown;
+  readonly processAction?: unknown;
+  readonly action?: unknown;
+  readonly recoveryAction?: unknown;
+  readonly laneId?: unknown;
+  readonly queueItemId?: unknown;
+  readonly candidateId?: unknown;
+  readonly sourceId?: unknown;
+  readonly runId?: unknown;
+  readonly pairingRouteId?: unknown;
+  readonly delegationRouteId?: unknown;
+  readonly findingId?: unknown;
+  readonly bundlePath?: unknown;
+  readonly mediaProviderId?: unknown;
+  readonly sessionId?: unknown;
+  readonly session_id?: unknown;
+  readonly categoryId?: unknown;
+  readonly panelId?: unknown;
+  readonly actionId?: unknown;
+  readonly recordId?: unknown;
+  readonly knowledgeSpaceId?: unknown;
+  readonly sourceIds?: unknown;
+  readonly gapIds?: unknown;
+  readonly maxRunMs?: unknown;
+  readonly force?: unknown;
+  readonly fields?: unknown;
+  readonly combo?: unknown;
+  readonly combos?: unknown;
+  readonly surfaceId?: unknown;
+  readonly key?: unknown;
+  readonly value?: unknown;
+  readonly cwd?: unknown;
+  readonly timeoutMs?: unknown;
+  readonly pty?: unknown;
+  readonly data?: unknown;
+  readonly target?: unknown;
+  readonly artifactId?: unknown;
+  readonly itemId?: unknown;
+  readonly methodId?: unknown;
+  readonly endpointId?: unknown;
+  readonly capabilityId?: unknown;
+  readonly toolName?: unknown;
+  readonly tool?: unknown;
+  readonly toolArgs?: unknown;
+  readonly agentId?: unknown;
+  readonly category?: unknown;
+  readonly prefix?: unknown;
+  readonly includeHidden?: unknown;
+  readonly includeParameters?: unknown;
+  readonly limit?: unknown;
+  readonly pane?: unknown;
+  readonly confirm?: unknown;
+  readonly explicitUserRequest?: unknown;
+}
+
+export interface AgentHarnessToolDeps {
+  readonly commandRegistry: CommandRegistry;
+  readonly commandContext: CommandContext;
+  readonly toolRegistry: ToolRegistry;
+}

package/src/tools/agent-harness-tool-utils.ts

@@ -0,0 +1,43 @@
+import type { AgentHarnessToolArgs } from './agent-harness-tool-types.ts';
+
+export function readString(value: unknown): string {
+  return typeof value === 'string' ? value.trim() : '';
+}
+
+export function settingLookupArgs(args: AgentHarnessToolArgs) {
+  return {
+    key: readString(args.key) || undefined,
+    target: readString(args.target) || undefined,
+    query: readString(args.query) || undefined,
+    category: readString(args.category) || undefined,
+    prefix: readString(args.prefix) || undefined,
+    includeHidden: args.includeHidden === true,
+  };
+}
+
+export function readLimit(value: unknown, fallback: number): number {
+  const parsed = typeof value === 'string' && value.trim() ? Number(value) : value;
+  if (typeof parsed !== 'number' || !Number.isFinite(parsed)) return fallback;
+  return Math.max(1, Math.min(500, Math.trunc(parsed)));
+}
+
+export function readFieldMap(value: unknown): Readonly<Record<string, string>> {
+  if (typeof value !== 'object' || value === null || Array.isArray(value)) return {};
+  return Object.fromEntries(Object.entries(value).map(([key, entry]) => [key, typeof entry === 'string' ? entry : String(entry)]));
+}
+
+export function output(value: unknown): { readonly success: true; readonly output: string } {
+  return {
+    success: true,
+    output: typeof value === 'string' ? value : JSON.stringify(value, null, 2),
+  };
+}
+
+export function error(message: string): { readonly success: false; readonly error: string } { return { success: false, error: message }; }
+
+export function requireConfirmedAction(args: AgentHarnessToolArgs, action: string): string | null {
+  const explicitUserRequest = readString(args.explicitUserRequest);
+  if (!explicitUserRequest) return `${action} requires explicitUserRequest with the user's exact request or a short faithful summary.`;
+  if (args.confirm !== true) return `${action} requires confirm:true after an explicit user request.`;
+  return null;
+}