@pellux/goodvibes-agent 1.0.23 → 1.0.24

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/CHANGELOG.md CHANGED
@@ -2,6 +2,12 @@
2
2
 
3
3
  Product-facing release notes for GoodVibes Agent.
4
4
 
5
+ ## 1.0.24 - 2026-06-03
6
+
7
+ - Resolve confirmed agent_harness run_command requests by the same command, commandName, target, or query lookup used for slash-command inspection.
8
+ - Refuse ambiguous slash-command run lookups with candidate commands before any handler runs.
9
+ - Refresh package-facing docs, model-facing schema text, and focused harness coverage for slash-command execution parity.
10
+
5
11
  ## 1.0.23 - 2026-06-03
6
12
 
7
13
  - Return ambiguous agent_harness slash-command detail lookups with candidate commands instead of collapsing broad descriptive matches to unknown.
package/README.md CHANGED
@@ -66,7 +66,7 @@ Use the workspace as the primary product surface:
66
66
 
67
67
  Inside the Agent workspace, press `/` to search every workspace action by name, category, command, or detail. This is the primary discovery path for product actions; slash commands and CLI subcommands remain power-user/scriptable mirrors.
68
68
 
69
- The model has the same harness map through `agent_harness`: it can list Agent workspace actions, inspect or run one workspace action by `actionId`, `command`, `target`, or `query`, list built-in panels and inspect one panel by `panelId`, `target`, or `query`, inspect modal/overlay/picker UI surfaces by `surfaceId`, `target`, or `query`, list top-level CLI mirrors and inspect one mirror by `cliCommand`, `command`, `commandName`, `target`, or `query`, inspect fixed shortcuts and configurable keybindings by `actionId`, `target`, `key`, or `query`, run shell-safe keybinding equivalents with confirmation, list slash commands, inspect one slash command by `command`, `commandName`, `target`, or `query` with parsed arguments and policy metadata, inspect model tool definitions or one model tool schema, inspect or change Agent settings by `key`, `target`, or `query` with confirmation, run concrete slash-command mirrors with confirmation, and report connected-host capability and live readiness posture. CLI mirror modes are read-only catalog and parser inspection; inside the main conversation, the model uses the returned preferred model tool, workspace action, setting mode, or confirmed slash-command mirror instead of launching hidden nested CLI processes. Panel modes expose catalog/open state and route visible panel/workspace changes through the current Agent shell bridge with confirmation. UI surface modes expose help, shortcuts, command browser, conversation search, prompt-history search, slash-command mode, file picker, block actions, context, runtime activity, live process output, bookmarks, model/provider/reasoning-effort pickers, TTS provider/voice pickers, session/profile pickers, the panel-picker compatibility route, security/knowledge/subscription operator surfaces, settings, MCP workspace, onboarding, and Agent workspace entrypoints; `open_ui_surface` is confirmation-gated and only performs visible shell navigation. Shortcut modes expose fixed runtime/editor controls plus the live resolved keybinding table; each keybinding descriptor reports its model operation route, `run_keybinding` executes only supported shell-safe equivalents with confirmation, and prompt-editor-only or terminal-selection shortcuts remain explicit direct user interaction. `set_keybinding` and `reset_keybinding` write the same `keybindings.json` file the user edits and require confirmation. Workspace action discovery can inline editor field schemas with `includeParameters:true`; single-action lookup and execution use the same user-facing search fields, return or preserve lookup metadata where the action result carries descriptors, and refuse ambiguous run requests with candidates; CLI mirror, panel, UI surface, keybinding, slash-command, model tool, setting, and connected-host capability lookup use their catalog search fields and refuse ambiguous route, schema, capability, or mutation requests with candidates; profile editors use the current starter-template inventory, and routine schedule editors can prefill a selected local routine from `recordId`. Selection-based local workspace actions accept a local `recordId` so the model can use the same note promotion and local registry flows as the TUI. Direct local create editors for memory, notes, personas, skills, and routines can execute from submitted fields through `run_workspace_action` and `agent_local_registry` with confirmation. The `connected_host` report includes route families, allowed capabilities, blocked lifecycle/non-Agent surfaces, and availability for the first-class Agent tools; `connected_host_capability` inspects one allowed or blocked capability by id, target, or query with its route families and boundary. The `connected_host_status` report performs a read-only live check of the connected-host status route and the isolated Agent Knowledge status route, reports SDK compatibility, token posture, endpoint bindings, route readiness, and actionable findings, and still refuses connected-host lifecycle control. The model uses those first-class tools for product workflows where they exist, such as Agent Knowledge, local memory/notes/personas/skills/routines, channel sends, notifications, reminders, media generation, work plans, and connected-host operator actions.
69
+ The model has the same harness map through `agent_harness`: it can list Agent workspace actions, inspect or run one workspace action by `actionId`, `command`, `target`, or `query`, list built-in panels and inspect one panel by `panelId`, `target`, or `query`, inspect modal/overlay/picker UI surfaces by `surfaceId`, `target`, or `query`, list top-level CLI mirrors and inspect one mirror by `cliCommand`, `command`, `commandName`, `target`, or `query`, inspect fixed shortcuts and configurable keybindings by `actionId`, `target`, `key`, or `query`, run shell-safe keybinding equivalents with confirmation, list slash commands, inspect or run one slash command by `command`, `commandName`, `target`, or `query` with parsed arguments and policy metadata, inspect model tool definitions or one model tool schema, inspect or change Agent settings by `key`, `target`, or `query` with confirmation, and report connected-host capability and live readiness posture. CLI mirror modes are read-only catalog and parser inspection; inside the main conversation, the model uses the returned preferred model tool, workspace action, setting mode, or confirmed slash-command mirror instead of launching hidden nested CLI processes. Panel modes expose catalog/open state and route visible panel/workspace changes through the current Agent shell bridge with confirmation. UI surface modes expose help, shortcuts, command browser, conversation search, prompt-history search, slash-command mode, file picker, block actions, context, runtime activity, live process output, bookmarks, model/provider/reasoning-effort pickers, TTS provider/voice pickers, session/profile pickers, the panel-picker compatibility route, security/knowledge/subscription operator surfaces, settings, MCP workspace, onboarding, and Agent workspace entrypoints; `open_ui_surface` is confirmation-gated and only performs visible shell navigation. Shortcut modes expose fixed runtime/editor controls plus the live resolved keybinding table; each keybinding descriptor reports its model operation route, `run_keybinding` executes only supported shell-safe equivalents with confirmation, and prompt-editor-only or terminal-selection shortcuts remain explicit direct user interaction. `set_keybinding` and `reset_keybinding` write the same `keybindings.json` file the user edits and require confirmation. Workspace action discovery can inline editor field schemas with `includeParameters:true`; single-action lookup and execution use the same user-facing search fields, return or preserve lookup metadata where the action result carries descriptors, and refuse ambiguous run requests with candidates; CLI mirror, panel, UI surface, keybinding, slash-command, model tool, setting, and connected-host capability lookup use their catalog search fields and refuse ambiguous route, schema, capability, or mutation requests with candidates; confirmed slash-command execution uses the same slash-command lookup and refuses ambiguous requests before any handler runs; profile editors use the current starter-template inventory, and routine schedule editors can prefill a selected local routine from `recordId`. Selection-based local workspace actions accept a local `recordId` so the model can use the same note promotion and local registry flows as the TUI. Direct local create editors for memory, notes, personas, skills, and routines can execute from submitted fields through `run_workspace_action` and `agent_local_registry` with confirmation. The `connected_host` report includes route families, allowed capabilities, blocked lifecycle/non-Agent surfaces, and availability for the first-class Agent tools; `connected_host_capability` inspects one allowed or blocked capability by id, target, or query with its route families and boundary. The `connected_host_status` report performs a read-only live check of the connected-host status route and the isolated Agent Knowledge status route, reports SDK compatibility, token posture, endpoint bindings, route readiness, and actionable findings, and still refuses connected-host lifecycle control. The model uses those first-class tools for product workflows where they exist, such as Agent Knowledge, local memory/notes/personas/skills/routines, channel sends, notifications, reminders, media generation, work plans, and connected-host operator actions.
70
70
 
71
71
  The setup workspace surfaces discovered Agent-local persona, skill, and routine markdown files so day-one setup can import useful behavior instead of starting from blank records. It can also create one initial scratchpad note, local persona, skill, and routine directly during first-run setup; those records stay in Agent-local registries and never write to default knowledge or non-Agent segments.
72
72
 
@@ -389257,23 +389257,6 @@ function createSchema2(db) {
389257
389257
  `);
389258
389258
  db.run(`CREATE INDEX IF NOT EXISTS idx_knowledge_schedules_job_id ON knowledge_schedules(job_id)`);
389259
389259
  }
389260
- function getKnowledgeSchemaStatements() {
389261
- const statements = [];
389262
- createSchema2({
389263
- run(sql) {
389264
- const normalized = sql.trim();
389265
- if (normalized.length > 0)
389266
- statements.push(normalized);
389267
- }
389268
- });
389269
- return statements;
389270
- }
389271
- function renderKnowledgeSchemaSql() {
389272
- return `${getKnowledgeSchemaStatements().map((statement) => statement.endsWith(";") ? statement : `${statement};`).join(`
389273
-
389274
- `)}
389275
- `;
389276
- }
389277
389260
  function rowObject(columns, values2) {
389278
389261
  return Object.fromEntries(columns.map((column, index) => [column, values2[index]]));
389279
389262
  }
@@ -702611,9 +702594,6 @@ var init_ingest = __esm(() => {
702611
702594
  // node_modules/@pellux/goodvibes-sdk/dist/platform/knowledge/browser-history/index.js
702612
702595
  var init_browser_history = __esm(() => {
702613
702596
  init_ingest();
702614
- init_discover();
702615
- init_readers();
702616
- init_paths2();
702617
702597
  });
702618
702598
 
702619
702599
  // node_modules/graphql/jsutils/devAssert.mjs
@@ -720253,7 +720233,6 @@ var init_semantic = __esm(() => {
720253
720233
  init_llm();
720254
720234
  init_gap_repair();
720255
720235
  init_service4();
720256
- init_self_improvement();
720257
720236
  });
720258
720237
 
720259
720238
  // node_modules/@pellux/goodvibes-sdk/dist/platform/knowledge/home-graph/helpers.js
@@ -724222,40 +724201,8 @@ var init_map_view = __esm(() => {
724222
724201
  });
724223
724202
 
724224
724203
  // node_modules/@pellux/goodvibes-sdk/dist/platform/knowledge/home-graph/types.js
724225
- var HOME_GRAPH_NODE_KINDS, HOME_GRAPH_RELATIONS, HOME_GRAPH_CAPABILITIES;
724204
+ var HOME_GRAPH_CAPABILITIES;
724226
724205
  var init_types6 = __esm(() => {
724227
- HOME_GRAPH_NODE_KINDS = [
724228
- "ha_home",
724229
- "ha_entity",
724230
- "ha_device",
724231
- "ha_area",
724232
- "ha_automation",
724233
- "ha_script",
724234
- "ha_scene",
724235
- "ha_label",
724236
- "ha_integration",
724237
- "ha_room",
724238
- "ha_device_passport",
724239
- "ha_maintenance_item",
724240
- "ha_troubleshooting_case",
724241
- "ha_purchase",
724242
- "ha_network_node"
724243
- ];
724244
- HOME_GRAPH_RELATIONS = [
724245
- "controls",
724246
- "located_in",
724247
- "belongs_to_device",
724248
- "has_manual",
724249
- "has_receipt",
724250
- "has_warranty",
724251
- "has_issue",
724252
- "fixed_by",
724253
- "uses_battery",
724254
- "connected_via",
724255
- "part_of_network",
724256
- "mentioned_by",
724257
- "source_for"
724258
- ];
724259
724206
  HOME_GRAPH_CAPABILITIES = [
724260
724207
  "knowledge-space-isolation",
724261
724208
  "snapshot-sync",
@@ -725662,7 +725609,6 @@ var init_service5 = __esm(() => {
725662
725609
  var init_home_graph = __esm(() => {
725663
725610
  init_service5();
725664
725611
  init_extension();
725665
- init_types6();
725666
725612
  });
725667
725613
 
725668
725614
  // node_modules/@pellux/goodvibes-sdk/dist/platform/knowledge/store-refinement.js
@@ -727990,14 +727936,10 @@ var init_service6 = __esm(() => {
727990
727936
  var init_project_planning = __esm(() => {
727991
727937
  init_service6();
727992
727938
  init_helpers3();
727993
- init_readiness();
727994
727939
  });
727995
727940
 
727996
727941
  // node_modules/@pellux/goodvibes-sdk/dist/platform/knowledge/persistence.js
727997
- var init_persistence = __esm(() => {
727998
- init_store_schema();
727999
- init_store_load();
728000
- });
727942
+ var init_persistence = () => {};
728001
727943
 
728002
727944
  // node_modules/@pellux/goodvibes-sdk/dist/platform/knowledge/projections.js
728003
727945
  class KnowledgeProjectionService {
@@ -731505,21 +731447,21 @@ var init_service7 = __esm(() => {
731505
731447
  var exports_knowledge = {};
731506
731448
  __export(exports_knowledge, {
731507
731449
  withKnowledgeSpace: () => withKnowledgeSpace,
731508
- uniqKnowledgeValues: () => uniq2,
731509
- stabilizeKnowledgeText: () => stableText,
731510
- runKnowledgeSemanticSelfImprovement: () => runKnowledgeSemanticSelfImprovement,
731450
+ uniqKnowledgeValues: () => uniq3,
731451
+ stabilizeKnowledgeText: () => stableText2,
731452
+ runKnowledgeSemanticSelfImprovement: () => runKnowledgeSemanticSelfImprovement2,
731511
731453
  resolveProjectPlanningSpace: () => resolveProjectPlanningSpace,
731512
- resolveKnowledgeDbPathFromControlPlaneDir: () => resolveKnowledgeDbPathFromControlPlaneDir,
731454
+ resolveKnowledgeDbPathFromControlPlaneDir: () => resolveKnowledgeDbPathFromControlPlaneDir2,
731513
731455
  renderPacket: () => renderPacket,
731514
731456
  renderKnowledgeSchemaSql: () => renderKnowledgeSchemaSql,
731515
731457
  renderKnowledgeMap: () => renderKnowledgeMap,
731516
731458
  readKnowledgeSearchText: () => readKnowledgeSearchText,
731517
- readBrowserKnowledgeProfile: () => readBrowserKnowledgeProfile,
731459
+ readBrowserKnowledgeProfile: () => readBrowserKnowledgeProfile2,
731518
731460
  projectPlanningSourceId: () => projectPlanningSourceId,
731519
731461
  projectPlanningProjectIdFromPath: () => projectPlanningProjectIdFromPath,
731520
731462
  projectPlanningCanonicalUri: () => projectPlanningCanonicalUri,
731521
731463
  projectKnowledgeSpaceId: () => projectKnowledgeSpaceId,
731522
- parseKnowledgeJsonValue: () => parseJsonValue,
731464
+ parseKnowledgeJsonValue: () => parseJsonValue2,
731523
731465
  normalizeProjectId: () => normalizeProjectId,
731524
731466
  normalizeKnowledgeSpaceId: () => normalizeKnowledgeSpaceId,
731525
731467
  normalizeHomeAssistantInstallationId: () => normalizeHomeAssistantInstallationId,
@@ -731527,12 +731469,12 @@ __export(exports_knowledge, {
731527
731469
  materializeGeneratedKnowledgeProjection: () => materializeGeneratedKnowledgeProjection,
731528
731470
  looksLikeRawPdfPayload: () => looksLikeRawPdfPayload,
731529
731471
  looksBinaryLikeText: () => looksBinaryLikeText,
731530
- loadKnowledgeStoreSnapshot: () => loadKnowledgeStoreSnapshot,
731472
+ loadKnowledgeStoreSnapshot: () => loadKnowledgeStoreSnapshot2,
731531
731473
  listGeneratedKnowledgePages: () => listGeneratedKnowledgePages,
731532
- listBrowserKinds: () => listBrowserKinds,
731474
+ listBrowserKinds: () => listBrowserKinds2,
731533
731475
  knowledgeSpaceMetadata: () => knowledgeSpaceMetadata,
731534
731476
  knowledgePageSourceWeight: () => knowledgePageSourceWeight,
731535
- knowledgeNowMs: () => nowMs,
731477
+ knowledgeNowMs: () => nowMs2,
731536
731478
  knowledgeExtractionNeedsRefresh: () => knowledgeExtractionNeedsRefresh,
731537
731479
  isUsefulKnowledgePageSourceCandidate: () => isUsefulKnowledgePageSourceCandidate,
731538
731480
  isUsefulKnowledgePageSource: () => isUsefulKnowledgePageSource,
@@ -731552,12 +731494,12 @@ __export(exports_knowledge, {
731552
731494
  generatedKnowledgeSourceId: () => generatedKnowledgeSourceId,
731553
731495
  generatedKnowledgeCanonicalUri: () => generatedKnowledgeCanonicalUri,
731554
731496
  extractKnowledgeArtifact: () => extractKnowledgeArtifact,
731555
- evaluateProjectPlanningReadiness: () => evaluateProjectPlanningReadiness,
731556
- discoverBrowserKnowledgeProfiles: () => discoverBrowserKnowledgeProfiles,
731497
+ evaluateProjectPlanningReadiness: () => evaluateProjectPlanningReadiness2,
731498
+ discoverBrowserKnowledgeProfiles: () => discoverBrowserKnowledgeProfiles2,
731557
731499
  createWebKnowledgeGapRepairer: () => createWebKnowledgeGapRepairer,
731558
731500
  createProviderBackedKnowledgeSemanticLlm: () => createProviderBackedKnowledgeSemanticLlm,
731559
731501
  createMemoryApi: () => createMemoryApi,
731560
- createKnowledgeSchema: () => createSchema2,
731502
+ createKnowledgeSchema: () => createSchema3,
731561
731503
  createKnowledgeApi: () => createKnowledgeApi,
731562
731504
  createDefaultKnowledgeConnectorRegistry: () => createDefaultKnowledgeConnectorRegistry,
731563
731505
  compareKnowledgePageSources: () => compareKnowledgePageSources,
@@ -733995,7 +733937,7 @@ var init_delivery_manager = __esm(() => {
733995
733937
  });
733996
733938
 
733997
733939
  // node_modules/@pellux/goodvibes-sdk/dist/platform/automation/scheduler-capacity.js
733998
- function computeSchedulerCapacity(slotsTotal, runs, nowMs2 = Date.now()) {
733940
+ function computeSchedulerCapacity(slotsTotal, runs, nowMs3 = Date.now()) {
733999
733941
  let slotsInUse = 0;
734000
733942
  const queuedRuns = [];
734001
733943
  for (const run7 of runs) {
@@ -734005,7 +733947,7 @@ function computeSchedulerCapacity(slotsTotal, runs, nowMs2 = Date.now()) {
734005
733947
  queuedRuns.push(run7);
734006
733948
  }
734007
733949
  const queueDepth = queuedRuns.length;
734008
- const oldestQueuedAgeMs = queueDepth > 0 ? nowMs2 - Math.min(...queuedRuns.map((r5) => r5.queuedAt)) : null;
733950
+ const oldestQueuedAgeMs = queueDepth > 0 ? nowMs3 - Math.min(...queuedRuns.map((r5) => r5.queuedAt)) : null;
734009
733951
  return { slotsTotal, slotsInUse, queueDepth, oldestQueuedAgeMs };
734010
733952
  }
734011
733953
 
@@ -816566,7 +816508,7 @@ var createStyledCell = (char, overrides = {}) => ({
816566
816508
  // src/version.ts
816567
816509
  import { readFileSync } from "fs";
816568
816510
  import { join } from "path";
816569
- var _version = "1.0.23";
816511
+ var _version = "1.0.24";
816570
816512
  var _sdkVersion = "0.33.35";
816571
816513
  try {
816572
816514
  const pkg = JSON.parse(readFileSync(join(import.meta.dir, "..", "package.json"), "utf-8"));
@@ -839428,7 +839370,7 @@ var WORK_PLAN_STATUSES = [
839428
839370
  "failed",
839429
839371
  "cancelled"
839430
839372
  ];
839431
- function nowMs2() {
839373
+ function nowMs3() {
839432
839374
  return Date.now();
839433
839375
  }
839434
839376
  function isObject5(value) {
@@ -839534,7 +839476,7 @@ class WorkPlanStore {
839534
839476
  if (!normalizedTitle)
839535
839477
  throw new Error("Work plan item title is required.");
839536
839478
  const plan = this.readPlan();
839537
- const time4 = nowMs2();
839479
+ const time4 = nowMs3();
839538
839480
  const item = {
839539
839481
  id: createItemId(),
839540
839482
  title: normalizedTitle,
@@ -839558,7 +839500,7 @@ class WorkPlanStore {
839558
839500
  updateItem(idOrPrefix, patch2) {
839559
839501
  const plan = this.readPlan();
839560
839502
  const item = this.resolveItem(plan, idOrPrefix);
839561
- const time4 = nowMs2();
839503
+ const time4 = nowMs3();
839562
839504
  const nextStatus = patch2.status ?? item.status;
839563
839505
  const next = this.pruneItem({
839564
839506
  ...item,
@@ -839591,7 +839533,7 @@ class WorkPlanStore {
839591
839533
  removeItem(idOrPrefix) {
839592
839534
  const plan = this.readPlan();
839593
839535
  const item = this.resolveItem(plan, idOrPrefix);
839594
- const time4 = nowMs2();
839536
+ const time4 = nowMs3();
839595
839537
  const remaining = plan.items.filter((candidate) => candidate.id !== item.id);
839596
839538
  this.writePlan({
839597
839539
  ...plan,
@@ -839611,7 +839553,7 @@ class WorkPlanStore {
839611
839553
  ...plan,
839612
839554
  items: remaining,
839613
839555
  activeItemId: remaining[0]?.id,
839614
- updatedAt: nowMs2()
839556
+ updatedAt: nowMs3()
839615
839557
  });
839616
839558
  return removed;
839617
839559
  }
@@ -839650,7 +839592,7 @@ class WorkPlanStore {
839650
839592
  const parsed = JSON.parse(raw);
839651
839593
  if (!isObject5(parsed))
839652
839594
  return this.createEmptyPlan();
839653
- const time4 = nowMs2();
839595
+ const time4 = nowMs3();
839654
839596
  const createdAt = typeof parsed.createdAt === "number" ? parsed.createdAt : time4;
839655
839597
  const updatedAt = typeof parsed.updatedAt === "number" ? parsed.updatedAt : createdAt;
839656
839598
  const items = Array.isArray(parsed.items) ? parsed.items.map((item) => normalizeItem(item, createdAt)).filter((item) => item !== null) : [];
@@ -839669,7 +839611,7 @@ class WorkPlanStore {
839669
839611
  };
839670
839612
  }
839671
839613
  createEmptyPlan() {
839672
- const time4 = nowMs2();
839614
+ const time4 = nowMs3();
839673
839615
  return {
839674
839616
  id: createPlanId(this.options.projectId, this.options.projectRoot),
839675
839617
  projectId: this.options.projectId,
@@ -880078,7 +880020,7 @@ function commandDetailLookupFromArgs(args2) {
880078
880020
  }
880079
880021
  return null;
880080
880022
  }
880081
- function resolveCommandDetail(commandRegistry, args2) {
880023
+ function resolveHarnessCommandDetail(commandRegistry, args2) {
880082
880024
  const lookup = commandDetailLookupFromArgs(args2);
880083
880025
  if (!lookup?.parsedName)
880084
880026
  return null;
@@ -880132,7 +880074,7 @@ function listHarnessCommands(commandRegistry, args2) {
880132
880074
  return commandRegistry.list().filter((command8) => commandMatches(command8, query2)).sort((a4, b3) => a4.name.localeCompare(b3.name)).slice(0, limit3).map((command8) => describeCommand(command8));
880133
880075
  }
880134
880076
  function describeHarnessCommand(commandRegistry, args2) {
880135
- const detail = resolveCommandDetail(commandRegistry, args2);
880077
+ const detail = resolveHarnessCommandDetail(commandRegistry, args2);
880136
880078
  if (detail?.status === "found")
880137
880079
  return describeCommand(detail.command, detail.lookup);
880138
880080
  if (detail?.status === "ambiguous")
@@ -881511,7 +881453,7 @@ var AGENT_HARNESS_PARAMETER_PROPERTIES = {
881511
881453
  },
881512
881454
  commandName: {
881513
881455
  type: "string",
881514
- description: "Slash command root without the leading slash for mode command or run_command, or a top-level CLI command token for cli_command."
881456
+ description: "Slash command root without the leading slash for mode command or run_command, or a top-level CLI command token for cli_command. run_command can also resolve one slash command by target or query when the lookup is unique."
881515
881457
  },
881516
881458
  args: {
881517
881459
  type: "array",
@@ -882443,11 +882385,6 @@ function readLimit11(value, fallback) {
882443
882385
  return fallback;
882444
882386
  return Math.max(1, Math.min(500, Math.trunc(parsed)));
882445
882387
  }
882446
- function readStringArray13(value) {
882447
- if (!Array.isArray(value))
882448
- return [];
882449
- return value.map((entry) => typeof entry === "string" ? entry : String(entry));
882450
- }
882451
882388
  function readFieldMap3(value) {
882452
882389
  if (typeof value !== "object" || value === null || Array.isArray(value))
882453
882390
  return {};
@@ -882630,25 +882567,8 @@ function requireConfirmedAction(args2, action2) {
882630
882567
  return `${action2} requires confirm:true after an explicit user request.`;
882631
882568
  return null;
882632
882569
  }
882633
- function commandFromArgs(args2) {
882634
- const rawCommand = readString58(args2.command);
882635
- if (rawCommand) {
882636
- const parsed = parseSlashCommand(rawCommand);
882637
- if (!parsed.name)
882638
- return null;
882639
- return {
882640
- name: parsed.name,
882641
- args: parsed.args
882642
- };
882643
- }
882644
- const commandName = readString58(args2.commandName).replace(/^\//, "");
882645
- if (!commandName)
882646
- return null;
882647
- const commandArgs = readStringArray13(args2.args);
882648
- return {
882649
- name: commandName,
882650
- args: commandArgs
882651
- };
882570
+ function invocationArgsFromLookup(lookup) {
882571
+ return lookup.resolvedBy === "description" ? [] : lookup.parsedArgs;
882652
882572
  }
882653
882573
  function safeCommandDisplay(name51) {
882654
882574
  return `/${name51}`;
@@ -882657,11 +882577,12 @@ async function runCommand2(deps, args2) {
882657
882577
  const confirmationError2 = requireConfirmedAction(args2, "Slash command invocation");
882658
882578
  if (confirmationError2)
882659
882579
  return error52(confirmationError2);
882660
- const parsed = commandFromArgs(args2);
882661
- if (!parsed)
882662
- return error52("run_command requires command or commandName.");
882663
- if (!deps.commandRegistry.get(parsed.name))
882664
- return error52(`Unknown slash command /${parsed.name}. Use mode:"commands" to inspect available commands.`);
882580
+ const resolved = resolveHarnessCommandDetail(deps.commandRegistry, args2);
882581
+ if (resolved?.status === "ambiguous") {
882582
+ return error52(`Ambiguous slash command ${resolved.input}. Candidates: ${JSON.stringify(resolved.candidates)}`);
882583
+ }
882584
+ if (!resolved)
882585
+ return error52('run_command requires a valid command, commandName, target, or query. Use mode:"commands" to inspect available commands.');
882665
882586
  const printed = [];
882666
882587
  const toolContext = {
882667
882588
  ...deps.commandContext,
@@ -882669,15 +882590,17 @@ async function runCommand2(deps, args2) {
882669
882590
  printed.push(text);
882670
882591
  },
882671
882592
  renderRequest: () => {},
882672
- executeCommand: async (name51, commandArgs) => {
882673
- return deps.commandRegistry.execute(name51, commandArgs, toolContext);
882593
+ executeCommand: async (name51, commandArgs2) => {
882594
+ return deps.commandRegistry.execute(name51, commandArgs2, toolContext);
882674
882595
  }
882675
882596
  };
882676
- const handled = await deps.commandRegistry.execute(parsed.name, [...parsed.args], toolContext);
882597
+ const commandArgs = invocationArgsFromLookup(resolved.lookup);
882598
+ const handled = await deps.commandRegistry.execute(resolved.command.name, [...commandArgs], toolContext);
882677
882599
  if (!handled)
882678
- return error52(`Unknown slash command /${parsed.name}.`);
882600
+ return error52(`Unknown slash command /${resolved.command.name}.`);
882679
882601
  return output7([
882680
- `Command ${safeCommandDisplay(parsed.name)} completed.`,
882602
+ `Command ${safeCommandDisplay(resolved.command.name)} completed.`,
882603
+ `Resolved by ${resolved.lookup.source} ${resolved.lookup.resolvedBy}.`,
882681
882604
  printed.length > 0 ? printed.join(`
882682
882605
  `) : "(no text output)"
882683
882606
  ].join(`
@@ -882870,7 +882793,7 @@ function createAgentHarnessTool(deps) {
882870
882793
  panels: 'Use mode:"panels" to list and mode:"panel" with panelId, target, or query to inspect built-in panel catalog/open state; use mode:"open_panel" with confirm:true plus explicitUserRequest to route a visible panel/workspace change.',
882871
882794
  uiSurfaces: 'Use mode:"ui_surfaces" to list and mode:"ui_surface" with surfaceId, target, or query to inspect modal/overlay/picker/workspace surfaces; use mode:"open_ui_surface" with confirm:true plus explicitUserRequest to route visible UI navigation.',
882872
882795
  shortcuts: 'Use mode:"shortcuts" to inspect fixed shortcuts plus configurable keybindings. Use mode:"keybinding" with actionId, target, key, or query; use mode:"run_keybinding" for confirmation-gated shell-safe shortcut equivalents; use mode:"set_keybinding" and mode:"reset_keybinding" with confirm:true plus explicitUserRequest to edit the same config file the user edits.',
882873
- slashCommands: 'Use mode:"commands" to list slash commands and mode:"command" with command, commandName, target, or query to inspect one command; use mode:"run_command" with confirm:true plus explicitUserRequest to execute.',
882796
+ slashCommands: 'Use mode:"commands" to list slash commands and mode:"command" with command, commandName, target, or query to inspect one command; use mode:"run_command" with the same lookup fields plus confirm:true and explicitUserRequest to execute one uniquely resolved command.',
882874
882797
  workspace: 'Use mode:"workspace_actions" to list, mode:"workspace_action" with actionId, command, target, or query for one action and editor schema, and mode:"run_workspace_action" with the same lookup fields plus confirmation for executable actions; set includeParameters:true on workspace_actions to inline editor schemas.',
882875
882798
  settings: 'Use mode:"settings" to list and mode:"get_setting" with key, target, or query for one setting. Use mode:"set_setting" or mode:"reset_setting" with key, target, or query plus confirm:true and explicitUserRequest.',
882876
882799
  tools: 'Use mode:"tools" to list first-class model tools, or mode:"tool" with toolName, target, or query to inspect one schema.',
@@ -44,7 +44,7 @@ After setup has been applied once, the TUI opens directly into the Agent operato
44
44
 
45
45
  Press `/` inside the Agent workspace to search every workspace action by name, category, command, or detail. Use that finder before reaching for shell commands; CLI subcommands are scriptable mirrors of these TUI workflows.
46
46
 
47
- The model can inspect and use the same harness surface through Agent-owned tools. `agent_harness` exposes workspace action discovery, single workspace-action inspection and execution by action id, command, or lookup text, built-in panel discovery/routing by panel id or lookup text, modal/overlay/picker UI surface discovery/routing by surface id or lookup text, top-level CLI mirror discovery and single-mirror lookup by command string, command token, or lookup text, fixed shortcut and configurable keybinding discovery, keybinding inspection/mutation by action id or lookup text, confirmation-gated shell-safe keybinding execution, slash-command discovery, single slash-command inspection by typed command or lookup text, command policy metadata, command execution with confirmation, model tool discovery and single-tool schema inspection, settings inspection/mutation by key or lookup text, connected-host capability inventory, single connected-host capability inspection, and live connected-host readiness posture. CLI mirror modes are read-only catalog/parser inspection and point the model to the matching in-process tool, workspace action, setting mode, or slash-command mirror. Panel modes expose catalog/open state and route visible panel/workspace changes through the current Agent shell bridge with confirmation. UI surface modes expose help, shortcuts, command browser, conversation search, prompt-history search, slash-command mode, file picker, block actions, context, runtime activity, live process output, bookmarks, model/provider/reasoning-effort pickers, TTS provider/voice pickers, session/profile pickers, the panel-picker compatibility route, security/knowledge/subscription operator surfaces, settings, MCP workspace, onboarding, and Agent workspace entrypoints; `open_ui_surface` is confirmation-gated and only performs visible shell navigation. Shortcut modes expose the fixed runtime/editor shortcuts and the live keybindings table; keybinding descriptors include a model operation route, `run_keybinding` executes supported shell-safe equivalents only with confirmation, prompt-editor-only or terminal-selection shortcuts remain direct user interaction, and confirmed keybinding edits write the same `keybindings.json` file the user edits and reload the runtime manager. Workspace action discovery can include editor field schemas with `includeParameters:true`, including starter-template defaults for profile creation and selected-routine defaults for routine schedule promotion when `recordId` is supplied; single-action lookup and execution use the same user-facing search fields, return lookup metadata where the action result carries descriptors, and refuse ambiguous run requests with candidates. Single-CLI-mirror, single-panel, single-surface, single-keybinding, single-slash-command, single-tool, single-setting, and single-connected-host-capability lookup use their catalog search fields, return lookup metadata where the result carries it, and refuse ambiguous route, schema, capability, or mutation requests with candidates. Selection-based local workspace actions accept a local `recordId`, so the model can use the same note promotion and local registry flows as the TUI. Direct local create editors for memory, notes, personas, skills, and routines can execute from submitted fields through `run_workspace_action` and `agent_local_registry` with confirmation. First-class model tools cover the main product workflows directly: Agent Knowledge, Agent Knowledge ingest, Agent-local memory/notes/personas/skills/routines, operator actions, notifications, channel sends, reminders, generated media, and work plans.
47
+ The model can inspect and use the same harness surface through Agent-owned tools. `agent_harness` exposes workspace action discovery, single workspace-action inspection and execution by action id, command, or lookup text, built-in panel discovery/routing by panel id or lookup text, modal/overlay/picker UI surface discovery/routing by surface id or lookup text, top-level CLI mirror discovery and single-mirror lookup by command string, command token, or lookup text, fixed shortcut and configurable keybinding discovery, keybinding inspection/mutation by action id or lookup text, confirmation-gated shell-safe keybinding execution, slash-command discovery, single slash-command inspection by typed command or lookup text, command policy metadata, single slash-command execution by typed command or lookup text with confirmation, model tool discovery and single-tool schema inspection, settings inspection/mutation by key or lookup text, connected-host capability inventory, single connected-host capability inspection, and live connected-host readiness posture. CLI mirror modes are read-only catalog/parser inspection and point the model to the matching in-process tool, workspace action, setting mode, or slash-command mirror. Panel modes expose catalog/open state and route visible panel/workspace changes through the current Agent shell bridge with confirmation. UI surface modes expose help, shortcuts, command browser, conversation search, prompt-history search, slash-command mode, file picker, block actions, context, runtime activity, live process output, bookmarks, model/provider/reasoning-effort pickers, TTS provider/voice pickers, session/profile pickers, the panel-picker compatibility route, security/knowledge/subscription operator surfaces, settings, MCP workspace, onboarding, and Agent workspace entrypoints; `open_ui_surface` is confirmation-gated and only performs visible shell navigation. Shortcut modes expose the fixed runtime/editor shortcuts and the live keybindings table; keybinding descriptors include a model operation route, `run_keybinding` executes supported shell-safe equivalents only with confirmation, prompt-editor-only or terminal-selection shortcuts remain direct user interaction, and confirmed keybinding edits write the same `keybindings.json` file the user edits and reload the runtime manager. Workspace action discovery can include editor field schemas with `includeParameters:true`, including starter-template defaults for profile creation and selected-routine defaults for routine schedule promotion when `recordId` is supplied; single-action lookup and execution use the same user-facing search fields, return lookup metadata where the action result carries descriptors, and refuse ambiguous run requests with candidates. Single-CLI-mirror, single-panel, single-surface, single-keybinding, single-slash-command, single-tool, single-setting, and single-connected-host-capability lookup use their catalog search fields, return lookup metadata where the result carries it, and refuse ambiguous route, schema, capability, or mutation requests with candidates; confirmed slash-command execution uses the same slash-command lookup and refuses ambiguous requests before any handler runs. Selection-based local workspace actions accept a local `recordId`, so the model can use the same note promotion and local registry flows as the TUI. Direct local create editors for memory, notes, personas, skills, and routines can execute from submitted fields through `run_workspace_action` and `agent_local_registry` with confirmation. First-class model tools cover the main product workflows directly: Agent Knowledge, Agent Knowledge ingest, Agent-local memory/notes/personas/skills/routines, operator actions, notifications, channel sends, reminders, generated media, and work plans.
48
48
 
49
49
  Use the Artifacts area for concrete files and generated output: attach images to prompts, export conversations or saved sessions, ingest local source files and URL lists into Agent Knowledge, import bookmarks or browser history, inspect source records, and generate media artifacts from confirmed prompts.
50
50
 
@@ -50,7 +50,7 @@ The main Agent model has an Agent-owned harness bridge rather than generic SDK s
50
50
  - `agent_work_plan`: keep the visible Agent-local work plan current from the conversation.
51
51
  - `agent_channel_send`, `agent_notify`, `agent_reminder_schedule`, and `agent_media_generate`: perform confirmed external delivery, notification, reminder, or media actions when the user explicitly asks.
52
52
 
53
- `agent_harness` discovery modes are read-only. `summary` reports the model access map; `panels` lists the built-in panel catalog, and `panel` resolves one panel by `panelId`, `target`, or `query` with current open/focused state plus its matching Agent workspace route; `ui_surfaces` lists modal, overlay, picker, and workspace entrypoints, and `ui_surface` resolves one by `surfaceId`, `target`, or `query` with shell-opener availability and preferred model routes; `cli_commands` lists top-level package CLI mirror metadata, and `cli_command` resolves one mirror by `cliCommand`, `command`, `commandName`, `target`, or `query`, returning parser output for concrete invocations, blocked command tokens, lookup metadata, and preferred in-process model routes; `shortcuts` returns fixed runtime/editor shortcuts plus configurable keybindings; `keybindings` lists the live resolved keybinding table, and `keybinding`, `run_keybinding`, `set_keybinding`, and `reset_keybinding` resolve one action by `actionId`, `target`, `key`, or `query` with default bindings, custom state, config path, lookup metadata, and model-operation route metadata; `commands` lists slash-command descriptions; `command` returns one slash-command detail by `command`, `commandName`, `target`, or `query`, including parsed arguments plus effect/confirmation/preferred-tool/boundary policy metadata, and refuses ambiguous command lookup with candidate commands; `workspace_actions` lists Agent workspace actions and can inline editor field schemas with `includeParameters:true`; `workspace_action` and `run_workspace_action` resolve one action by `actionId`, `command`, `target`, or `query`, using the same user-facing action-search fields; inspection returns lookup metadata plus editor schema, and execution refuses ambiguous requests with candidate actions before any effect; `tools` lists model tool definitions and can inline JSON schemas with `includeParameters:true`; `tool` returns one model tool schema by `toolName`, `target`, or `query` and refuses ambiguous schema lookup with candidate tools; `settings` returns setting descriptors plus setting policy; `get_setting`, `set_setting`, and `reset_setting` resolve one setting by `key`, `target`, or `query`, return lookup metadata on success, and refuse ambiguous matches with candidate settings; `connected_host` returns the connected-host route families, allowed capabilities, blocked capabilities, and first-class tool availability; `connected_host_capability` returns one allowed or blocked connected-host capability by `capabilityId`, `target`, or `query` with related route families and boundary text and refuses ambiguous capability lookup with candidates; and `connected_host_status` performs a live read-only check of the connected-host status and Agent Knowledge status routes and reports endpoint bindings, token posture, SDK compatibility, route readiness, and findings without printing token values.
53
+ `agent_harness` discovery modes are read-only. `summary` reports the model access map; `panels` lists the built-in panel catalog, and `panel` resolves one panel by `panelId`, `target`, or `query` with current open/focused state plus its matching Agent workspace route; `ui_surfaces` lists modal, overlay, picker, and workspace entrypoints, and `ui_surface` resolves one by `surfaceId`, `target`, or `query` with shell-opener availability and preferred model routes; `cli_commands` lists top-level package CLI mirror metadata, and `cli_command` resolves one mirror by `cliCommand`, `command`, `commandName`, `target`, or `query`, returning parser output for concrete invocations, blocked command tokens, lookup metadata, and preferred in-process model routes; `shortcuts` returns fixed runtime/editor shortcuts plus configurable keybindings; `keybindings` lists the live resolved keybinding table, and `keybinding`, `run_keybinding`, `set_keybinding`, and `reset_keybinding` resolve one action by `actionId`, `target`, `key`, or `query` with default bindings, custom state, config path, lookup metadata, and model-operation route metadata; `commands` lists slash-command descriptions; `command` returns one slash-command detail by `command`, `commandName`, `target`, or `query`, including parsed arguments plus effect/confirmation/preferred-tool/boundary policy metadata, and refuses ambiguous command lookup with candidate commands; `run_command` executes one confirmed slash command using the same `command`, `commandName`, `target`, or `query` resolver and refuses ambiguous command lookup before any handler runs; `workspace_actions` lists Agent workspace actions and can inline editor field schemas with `includeParameters:true`; `workspace_action` and `run_workspace_action` resolve one action by `actionId`, `command`, `target`, or `query`, using the same user-facing action-search fields; inspection returns lookup metadata plus editor schema, and execution refuses ambiguous requests with candidate actions before any effect; `tools` lists model tool definitions and can inline JSON schemas with `includeParameters:true`; `tool` returns one model tool schema by `toolName`, `target`, or `query` and refuses ambiguous schema lookup with candidate tools; `settings` returns setting descriptors plus setting policy; `get_setting`, `set_setting`, and `reset_setting` resolve one setting by `key`, `target`, or `query`, return lookup metadata on success, and refuse ambiguous matches with candidate settings; `connected_host` returns the connected-host route families, allowed capabilities, blocked capabilities, and first-class tool availability; `connected_host_capability` returns one allowed or blocked connected-host capability by `capabilityId`, `target`, or `query` with related route families and boundary text and refuses ambiguous capability lookup with candidates; and `connected_host_status` performs a live read-only check of the connected-host status and Agent Knowledge status routes and reports endpoint bindings, token posture, SDK compatibility, route readiness, and findings without printing token values.
54
54
 
55
55
  `open_ui_surface` is a confirmation-gated visible navigation mode for the same shell surfaces the user can open: Agent workspace, settings, MCP workspace, model/provider/reasoning-effort pickers, TTS provider/voice pickers, session/profile pickers, the panel-picker compatibility route, security/knowledge/subscription operator surfaces, conversation search, prompt-history search, slash-command mode, command browser, file picker, block actions, bookmarks, context inspector, runtime activity monitor, live process output, help, shortcuts, and onboarding. It does not perform hidden operations; use first-class model tools, settings modes, workspace actions, or confirmed slash-command mirrors for actual state changes. Ambiguous UI surface lookup text is refused with candidate surfaces instead of routed.
56
56
 
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@pellux/goodvibes-agent",
3
- "version": "1.0.23",
3
+ "version": "1.0.24",
4
4
  "private": false,
5
5
  "description": "GoodVibes personal operator assistant TUI with a proactive Agent product brain, isolated Agent Knowledge, local profiles, routines, skills, personas, and explicit build delegation.",
6
6
  "type": "module",
@@ -11,7 +11,7 @@ export interface AgentHarnessCommandCatalogArgs {
11
11
  readonly limit?: unknown;
12
12
  }
13
13
 
14
- interface CommandDetailLookup {
14
+ export interface CommandDetailLookup {
15
15
  readonly source: 'command' | 'commandName' | 'target' | 'query';
16
16
  readonly input: string;
17
17
  readonly parsedName: string;
@@ -19,7 +19,7 @@ interface CommandDetailLookup {
19
19
  readonly resolvedBy: 'name' | 'alias' | 'case-insensitive-name' | 'case-insensitive-alias' | 'description' | 'prefix';
20
20
  }
21
21
 
22
- type CommandDetailResolution =
22
+ export type CommandDetailResolution =
23
23
  | { readonly status: 'found'; readonly command: SlashCommand; readonly lookup: CommandDetailLookup }
24
24
  | { readonly status: 'ambiguous'; readonly input: string; readonly candidates: readonly Record<string, unknown>[] };
25
25
 
@@ -111,7 +111,7 @@ function commandDetailLookupFromArgs(args: AgentHarnessCommandCatalogArgs): Omit
111
111
  return null;
112
112
  }
113
113
 
114
- function resolveCommandDetail(commandRegistry: CommandRegistry, args: AgentHarnessCommandCatalogArgs): CommandDetailResolution | null {
114
+ export function resolveHarnessCommandDetail(commandRegistry: CommandRegistry, args: AgentHarnessCommandCatalogArgs): CommandDetailResolution | null {
115
115
  const lookup = commandDetailLookupFromArgs(args);
116
116
  if (!lookup?.parsedName) return null;
117
117
  const direct = commandRegistry.get(lookup.parsedName);
@@ -173,7 +173,7 @@ export function listHarnessCommands(commandRegistry: CommandRegistry, args: Agen
173
173
  }
174
174
 
175
175
  export function describeHarnessCommand(commandRegistry: CommandRegistry, args: AgentHarnessCommandCatalogArgs): Record<string, unknown> | null {
176
- const detail = resolveCommandDetail(commandRegistry, args);
176
+ const detail = resolveHarnessCommandDetail(commandRegistry, args);
177
177
  if (detail?.status === 'found') return describeCommand(detail.command, detail.lookup);
178
178
  if (detail?.status === 'ambiguous') return { status: 'ambiguous', input: detail.input, candidates: detail.candidates };
179
179
  return null;
@@ -35,7 +35,7 @@ export const AGENT_HARNESS_PARAMETER_PROPERTIES = {
35
35
  },
36
36
  commandName: {
37
37
  type: 'string',
38
- description: 'Slash command root without the leading slash for mode command or run_command, or a top-level CLI command token for cli_command.',
38
+ description: 'Slash command root without the leading slash for mode command or run_command, or a top-level CLI command token for cli_command. run_command can also resolve one slash command by target or query when the lookup is unique.',
39
39
  },
40
40
  args: {
41
41
  type: 'array',
@@ -16,9 +16,8 @@ import type {
16
16
  AgentWorkspaceLocalLibraryItem,
17
17
  AgentWorkspaceRuntimeSnapshot,
18
18
  } from '../input/agent-workspace-types.ts';
19
- import { parseSlashCommand } from '../input/slash-command-parser.ts';
20
19
  import { blockedHarnessCliCommandTokens, describeHarnessCliCommand, listHarnessCliCommands, totalHarnessCliCommands } from './agent-harness-cli-metadata.ts';
21
- import { describeHarnessCommand, listHarnessCommands } from './agent-harness-command-catalog.ts';
20
+ import { describeHarnessCommand, listHarnessCommands, resolveHarnessCommandDetail, type CommandDetailLookup } from './agent-harness-command-catalog.ts';
22
21
  import { describeHarnessKeybinding, listHarnessKeybindings, listHarnessShortcuts, resetHarnessKeybinding, runHarnessKeybinding, setHarnessKeybinding, totalHarnessKeybindings, totalHarnessShortcuts } from './agent-harness-keybinding-metadata.ts';
23
22
  import { describeHarnessPanel, listHarnessPanels, openHarnessPanel, totalHarnessPanels } from './agent-harness-panel-metadata.ts';
24
23
  import { connectedHostStatusSummary } from './agent-harness-connected-host-status.ts';
@@ -126,11 +125,6 @@ function readLimit(value: unknown, fallback: number): number {
126
125
  return Math.max(1, Math.min(500, Math.trunc(parsed)));
127
126
  }
128
127
 
129
- function readStringArray(value: unknown): readonly string[] {
130
- if (!Array.isArray(value)) return [];
131
- return value.map((entry) => typeof entry === 'string' ? entry : String(entry));
132
- }
133
-
134
128
  function readFieldMap(value: unknown): Readonly<Record<string, string>> {
135
129
  if (typeof value !== 'object' || value === null || Array.isArray(value)) return {};
136
130
  return Object.fromEntries(Object.entries(value).map(([key, entry]) => [key, typeof entry === 'string' ? entry : String(entry)]));
@@ -330,23 +324,8 @@ function requireConfirmedAction(args: AgentHarnessToolArgs, action: string): str
330
324
  return null;
331
325
  }
332
326
 
333
- function commandFromArgs(args: AgentHarnessToolArgs): { readonly name: string; readonly args: readonly string[] } | null {
334
- const rawCommand = readString(args.command);
335
- if (rawCommand) {
336
- const parsed = parseSlashCommand(rawCommand);
337
- if (!parsed.name) return null;
338
- return {
339
- name: parsed.name,
340
- args: parsed.args,
341
- };
342
- }
343
- const commandName = readString(args.commandName).replace(/^\//, '');
344
- if (!commandName) return null;
345
- const commandArgs = readStringArray(args.args);
346
- return {
347
- name: commandName,
348
- args: commandArgs,
349
- };
327
+ function invocationArgsFromLookup(lookup: CommandDetailLookup): readonly string[] {
328
+ return lookup.resolvedBy === 'description' ? [] : lookup.parsedArgs;
350
329
  }
351
330
 
352
331
  function safeCommandDisplay(name: string): string {
@@ -356,9 +335,11 @@ function safeCommandDisplay(name: string): string {
356
335
  async function runCommand(deps: AgentHarnessToolDeps, args: AgentHarnessToolArgs): Promise<{ readonly success: boolean; readonly output?: string; readonly error?: string }> {
357
336
  const confirmationError = requireConfirmedAction(args, 'Slash command invocation');
358
337
  if (confirmationError) return error(confirmationError);
359
- const parsed = commandFromArgs(args);
360
- if (!parsed) return error('run_command requires command or commandName.');
361
- if (!deps.commandRegistry.get(parsed.name)) return error(`Unknown slash command /${parsed.name}. Use mode:"commands" to inspect available commands.`);
338
+ const resolved = resolveHarnessCommandDetail(deps.commandRegistry, args);
339
+ if (resolved?.status === 'ambiguous') {
340
+ return error(`Ambiguous slash command ${resolved.input}. Candidates: ${JSON.stringify(resolved.candidates)}`);
341
+ }
342
+ if (!resolved) return error('run_command requires a valid command, commandName, target, or query. Use mode:"commands" to inspect available commands.');
362
343
 
363
344
  const printed: string[] = [];
364
345
  const toolContext: CommandContext = {
@@ -371,10 +352,12 @@ async function runCommand(deps: AgentHarnessToolDeps, args: AgentHarnessToolArgs
371
352
  return deps.commandRegistry.execute(name, commandArgs, toolContext);
372
353
  },
373
354
  };
374
- const handled = await deps.commandRegistry.execute(parsed.name, [...parsed.args], toolContext);
375
- if (!handled) return error(`Unknown slash command /${parsed.name}.`);
355
+ const commandArgs = invocationArgsFromLookup(resolved.lookup);
356
+ const handled = await deps.commandRegistry.execute(resolved.command.name, [...commandArgs], toolContext);
357
+ if (!handled) return error(`Unknown slash command /${resolved.command.name}.`);
376
358
  return output([
377
- `Command ${safeCommandDisplay(parsed.name)} completed.`,
359
+ `Command ${safeCommandDisplay(resolved.command.name)} completed.`,
360
+ `Resolved by ${resolved.lookup.source} ${resolved.lookup.resolvedBy}.`,
378
361
  printed.length > 0 ? printed.join('\n') : '(no text output)',
379
362
  ].join('\n'));
380
363
  }
@@ -589,7 +572,7 @@ export function createAgentHarnessTool(deps: AgentHarnessToolDeps): Tool {
589
572
  panels: 'Use mode:"panels" to list and mode:"panel" with panelId, target, or query to inspect built-in panel catalog/open state; use mode:"open_panel" with confirm:true plus explicitUserRequest to route a visible panel/workspace change.',
590
573
  uiSurfaces: 'Use mode:"ui_surfaces" to list and mode:"ui_surface" with surfaceId, target, or query to inspect modal/overlay/picker/workspace surfaces; use mode:"open_ui_surface" with confirm:true plus explicitUserRequest to route visible UI navigation.',
591
574
  shortcuts: 'Use mode:"shortcuts" to inspect fixed shortcuts plus configurable keybindings. Use mode:"keybinding" with actionId, target, key, or query; use mode:"run_keybinding" for confirmation-gated shell-safe shortcut equivalents; use mode:"set_keybinding" and mode:"reset_keybinding" with confirm:true plus explicitUserRequest to edit the same config file the user edits.',
592
- slashCommands: 'Use mode:"commands" to list slash commands and mode:"command" with command, commandName, target, or query to inspect one command; use mode:"run_command" with confirm:true plus explicitUserRequest to execute.',
575
+ slashCommands: 'Use mode:"commands" to list slash commands and mode:"command" with command, commandName, target, or query to inspect one command; use mode:"run_command" with the same lookup fields plus confirm:true and explicitUserRequest to execute one uniquely resolved command.',
593
576
  workspace: 'Use mode:"workspace_actions" to list, mode:"workspace_action" with actionId, command, target, or query for one action and editor schema, and mode:"run_workspace_action" with the same lookup fields plus confirmation for executable actions; set includeParameters:true on workspace_actions to inline editor schemas.',
594
577
  settings: 'Use mode:"settings" to list and mode:"get_setting" with key, target, or query for one setting. Use mode:"set_setting" or mode:"reset_setting" with key, target, or query plus confirm:true and explicitUserRequest.',
595
578
  tools: 'Use mode:"tools" to list first-class model tools, or mode:"tool" with toolName, target, or query to inspect one schema.',
package/src/version.ts CHANGED
@@ -6,7 +6,7 @@ import { join } from 'node:path';
6
6
  // The prebuild script updates the fallback value before compilation.
7
7
  // Uses import.meta.dir (Bun) to locate package.json relative to this file,
8
8
  // which is correct regardless of the process working directory.
9
- let _version = '1.0.23';
9
+ let _version = '1.0.24';
10
10
  let _sdkVersion = '0.33.35';
11
11
  try {
12
12
  const pkg = JSON.parse(readFileSync(join(import.meta.dir, '..', 'package.json'), 'utf-8')) as {