@pellux/goodvibes-agent 1.0.31 → 1.0.33

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.
Files changed (63) hide show
  1. package/CHANGELOG.md +38 -3
  2. package/README.md +7 -5
  3. package/dist/package/main.js +7346 -2349
  4. package/docs/README.md +2 -2
  5. package/docs/channels-remote-and-api.md +6 -2
  6. package/docs/connected-host.md +26 -5
  7. package/docs/getting-started.md +29 -9
  8. package/docs/knowledge-artifacts-and-multimodal.md +16 -4
  9. package/docs/project-planning.md +2 -2
  10. package/docs/providers-and-routing.md +3 -2
  11. package/docs/release-and-publishing.md +15 -11
  12. package/docs/tools-and-commands.md +20 -8
  13. package/package.json +8 -3
  14. package/release/live-verification/live-verification.json +148 -0
  15. package/release/live-verification/live-verification.md +187 -0
  16. package/release/performance-snapshot.json +57 -0
  17. package/release/release-notes.md +28 -0
  18. package/release/release-readiness.json +581 -0
  19. package/src/cli/agent-knowledge-command.ts +5 -5
  20. package/src/cli/agent-knowledge-format.ts +11 -0
  21. package/src/cli/agent-knowledge-runtime.ts +92 -13
  22. package/src/cli/bundle-command.ts +5 -4
  23. package/src/cli/entrypoint.ts +5 -2
  24. package/src/cli/external-runtime.ts +2 -15
  25. package/src/cli/management.ts +4 -3
  26. package/src/input/commands/guidance-runtime.ts +1 -1
  27. package/src/input/commands/knowledge.ts +2 -2
  28. package/src/runtime/bootstrap.ts +2 -2
  29. package/src/runtime/connected-host-auth.ts +16 -0
  30. package/src/tools/agent-channel-send-tool.ts +5 -7
  31. package/src/tools/agent-harness-channel-metadata.ts +177 -0
  32. package/src/tools/agent-harness-connected-host-status.ts +1 -1
  33. package/src/tools/agent-harness-delegation-posture.ts +216 -0
  34. package/src/tools/agent-harness-keybinding-metadata.ts +57 -22
  35. package/src/tools/agent-harness-mcp-metadata.ts +246 -0
  36. package/src/tools/agent-harness-media-posture.ts +282 -0
  37. package/src/tools/agent-harness-metadata.ts +21 -4
  38. package/src/tools/agent-harness-model-routing.ts +501 -0
  39. package/src/tools/agent-harness-notification-metadata.ts +217 -0
  40. package/src/tools/agent-harness-operator-methods.ts +285 -0
  41. package/src/tools/agent-harness-pairing-posture.ts +265 -0
  42. package/src/tools/agent-harness-provider-account-metadata.ts +203 -0
  43. package/src/tools/agent-harness-release-evidence.ts +364 -0
  44. package/src/tools/agent-harness-release-readiness.ts +298 -0
  45. package/src/tools/agent-harness-security-posture.ts +646 -0
  46. package/src/tools/agent-harness-service-posture.ts +201 -0
  47. package/src/tools/agent-harness-session-metadata.ts +282 -0
  48. package/src/tools/agent-harness-setup-posture.ts +295 -0
  49. package/src/tools/agent-harness-tool-schema.ts +103 -27
  50. package/src/tools/agent-harness-tool.ts +209 -236
  51. package/src/tools/agent-harness-ui-surface-metadata.ts +1 -1
  52. package/src/tools/agent-harness-workspace-actions.ts +232 -0
  53. package/src/tools/agent-knowledge-ingest-tool.ts +6 -8
  54. package/src/tools/agent-knowledge-tool.ts +122 -23
  55. package/src/tools/agent-local-registry-tool.ts +4 -5
  56. package/src/tools/agent-media-generate-tool.ts +4 -6
  57. package/src/tools/agent-notify-tool.ts +5 -6
  58. package/src/tools/agent-operator-action-tool.ts +6 -8
  59. package/src/tools/agent-operator-briefing-tool.ts +3 -4
  60. package/src/tools/agent-reminder-schedule-tool.ts +6 -7
  61. package/src/tools/agent-tool-policy-guard.ts +8 -17
  62. package/src/tools/agent-work-plan-tool.ts +3 -4
  63. package/src/version.ts +2 -2
@@ -121,10 +121,9 @@ export function createAgentReminderScheduleTool(
121
121
  definition: {
122
122
  name: 'agent_reminder_schedule',
123
123
  description: [
124
- 'Create one connected GoodVibes Agent reminder schedule from the main conversation.',
125
- 'Use only when the user explicitly asks to be reminded or asks Agent to schedule a reminder.',
126
- '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.',
127
- 'Set confirm:true only for an explicit user request. Otherwise return the preview/confirmation error.',
124
+ 'Schedule one confirmed GoodVibes Agent reminder.',
125
+ 'Use only for an explicit reminder request.',
126
+ 'No host lifecycle, background job, or Knowledge write.',
128
127
  ].join(' '),
129
128
  parameters: {
130
129
  type: 'object',
@@ -136,7 +135,7 @@ export function createAgentReminderScheduleTool(
136
135
  scheduleKind: {
137
136
  type: 'string',
138
137
  enum: [...SCHEDULE_KINDS],
139
- description: 'Schedule selector: at for one timestamp, every for an interval, cron for a cron expression.',
138
+ description: 'Schedule kind: at, every, or cron.',
140
139
  },
141
140
  scheduleValue: {
142
141
  type: 'string',
@@ -160,7 +159,7 @@ export function createAgentReminderScheduleTool(
160
159
  },
161
160
  deliveryChannel: {
162
161
  type: 'string',
163
- description: 'Optional delivery channel target: surfaceKind:routeId:label, for example slack:ops:Ops.',
162
+ description: 'Optional delivery channel target.',
164
163
  },
165
164
  deliveryRoute: {
166
165
  type: 'string',
@@ -184,7 +183,7 @@ export function createAgentReminderScheduleTool(
184
183
  },
185
184
  explicitUserRequest: {
186
185
  type: 'string',
187
- description: 'Short quote or summary of the user request that authorized this reminder creation.',
186
+ description: 'User request authorizing this reminder.',
188
187
  },
189
188
  },
190
189
  required: ['message', 'scheduleKind', 'scheduleValue', 'confirm', 'explicitUserRequest'],
@@ -206,10 +206,7 @@ export function installAgentToolPolicyGuard(registry: ToolRegistry, options: Age
206
206
  wrapModeRestrictedToolForAgentPolicy(tool, {
207
207
  allowedModes: READ_ONLY_REMOTE_TOOL_MODES,
208
208
  modeSet: READ_ONLY_REMOTE_TOOL_MODE_SET,
209
- description: [
210
- 'Read-only remote build-host inspection for GoodVibes Agent.',
211
- 'Pool creation, host assignment, unassignment, and artifact import are disabled in the main conversation.',
212
- ].join(' '),
209
+ description: 'Read-only remote build-host inspection. Mutations are disabled in Agent.',
213
210
  denial: REMOTE_MUTATION_DENIAL,
214
211
  });
215
212
  } else if (tool.definition.name === 'channel') {
@@ -218,10 +215,7 @@ export function installAgentToolPolicyGuard(registry: ToolRegistry, options: Age
218
215
  wrapModeRestrictedToolForAgentPolicy(tool, {
219
216
  allowedModes: READ_ONLY_MCP_TOOL_MODES,
220
217
  modeSet: READ_ONLY_MCP_TOOL_MODE_SET,
221
- description: [
222
- 'Read-only MCP inspection for GoodVibes Agent.',
223
- 'Quarantine approval, trust mutation, and role mutation are disabled in the main conversation.',
224
- ].join(' '),
218
+ description: 'Read-only MCP inspection. Mutations are disabled in Agent.',
225
219
  denial: MCP_SECURITY_MUTATION_DENIAL,
226
220
  });
227
221
  } else if (tool.definition.name === 'fetch') {
@@ -246,17 +240,14 @@ export function installAgentToolPolicyGuard(registry: ToolRegistry, options: Age
246
240
  wrapModeRestrictedToolForAgentPolicy(tool, {
247
241
  allowedModes: READ_ONLY_CONTROL_TOOL_MODES,
248
242
  modeSet: READ_ONLY_CONTROL_TOOL_MODE_SET,
249
- description: [
250
- 'Read-only product-control inspection for GoodVibes Agent.',
251
- 'Command, panel, and subscription catalogs can be inspected, but product-control mutation and connected-host lifecycle are external.',
252
- ].join(' '),
243
+ description: 'Read-only product-control inspection. Mutations are external.',
253
244
  denial: CONTROL_MUTATION_DENIAL,
254
245
  });
255
246
  } else if (tool.definition.name === 'task') {
256
247
  wrapModeRestrictedToolForAgentPolicy(tool, {
257
248
  allowedModes: READ_ONLY_TASK_TOOL_MODES,
258
249
  modeSet: READ_ONLY_TASK_TOOL_MODE_SET,
259
- description: 'Read-only task/workflow inspection for GoodVibes Agent. Task creation, status changes, dependencies, cancellation, and handoff mutation are disabled in the main conversation.',
250
+ description: 'Read-only task/workflow inspection. Mutations are disabled in Agent.',
260
251
  denial: DURABLE_WORKFLOW_MUTATION_DENIAL,
261
252
  removedProperties: ['title', 'label', 'status', 'dependsOnSessionId', 'dependsOnTaskId', 'reason', 'toSessionId'],
262
253
  });
@@ -264,7 +255,7 @@ export function installAgentToolPolicyGuard(registry: ToolRegistry, options: Age
264
255
  wrapModeRestrictedToolForAgentPolicy(tool, {
265
256
  allowedModes: READ_ONLY_TEAM_TOOL_MODES,
266
257
  modeSet: READ_ONLY_TEAM_TOOL_MODE_SET,
267
- description: 'Read-only team inspection for GoodVibes Agent. Team creation, membership changes, lane changes, and deletion are disabled in the main conversation.',
258
+ description: 'Read-only team inspection. Mutations are disabled in Agent.',
268
259
  denial: DURABLE_WORKFLOW_MUTATION_DENIAL,
269
260
  removedProperties: ['name', 'summary', 'memberId', 'role', 'lanes'],
270
261
  });
@@ -272,7 +263,7 @@ export function installAgentToolPolicyGuard(registry: ToolRegistry, options: Age
272
263
  wrapModeRestrictedToolForAgentPolicy(tool, {
273
264
  allowedModes: READ_ONLY_WORKLIST_TOOL_MODES,
274
265
  modeSet: READ_ONLY_WORKLIST_TOOL_MODE_SET,
275
- description: 'Read-only worklist inspection for GoodVibes Agent. Worklist creation and item lifecycle changes are disabled in the main conversation.',
266
+ description: 'Read-only worklist inspection. Mutations are disabled in Agent.',
276
267
  denial: DURABLE_WORKFLOW_MUTATION_DENIAL,
277
268
  removedProperties: ['title', 'itemId', 'text', 'owner', 'priority'],
278
269
  });
@@ -280,7 +271,7 @@ export function installAgentToolPolicyGuard(registry: ToolRegistry, options: Age
280
271
  wrapModeRestrictedToolForAgentPolicy(tool, {
281
272
  allowedModes: READ_ONLY_PACKET_TOOL_MODES,
282
273
  modeSet: READ_ONLY_PACKET_TOOL_MODE_SET,
283
- description: 'Read-only operator packet inspection for GoodVibes Agent. Packet creation, revision, and publishing are disabled in the main conversation.',
274
+ description: 'Read-only operator packet inspection. Mutations are disabled in Agent.',
284
275
  denial: DURABLE_WORKFLOW_MUTATION_DENIAL,
285
276
  removedProperties: ['title', 'summary', 'goals', 'constraints', 'risks', 'audience'],
286
277
  });
@@ -288,7 +279,7 @@ export function installAgentToolPolicyGuard(registry: ToolRegistry, options: Age
288
279
  wrapModeRestrictedToolForAgentPolicy(tool, {
289
280
  allowedModes: READ_ONLY_QUERY_TOOL_MODES,
290
281
  modeSet: READ_ONLY_QUERY_TOOL_MODE_SET,
291
- description: 'Read-only operator query inspection for GoodVibes Agent. Asking, answering, and closing runtime-owned workflow queries are disabled in the main conversation.',
282
+ description: 'Read-only operator query inspection. Mutations are disabled in Agent.',
292
283
  denial: DURABLE_WORKFLOW_MUTATION_DENIAL,
293
284
  removedProperties: ['prompt', 'askedBy', 'target', 'answer', 'resolution'],
294
285
  });
@@ -166,10 +166,9 @@ export function createAgentWorkPlanTool(store: WorkPlanStore): Tool {
166
166
  definition: {
167
167
  name: 'agent_work_plan',
168
168
  description: [
169
- 'Inspect and maintain the visible GoodVibes Agent local work plan from the main conversation.',
170
- '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.',
171
- '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.',
172
- 'Create, update, and set_status are safe local state actions. remove and clear_completed require confirm:true plus explicitUserRequest.',
169
+ 'Inspect or update the visible Agent-local work plan.',
170
+ 'Use for task/status tracking.',
171
+ 'Destructive actions require confirm:true plus explicitUserRequest.',
173
172
  ].join(' '),
174
173
  parameters: {
175
174
  type: 'object',
package/src/version.ts CHANGED
@@ -6,8 +6,8 @@ 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.31';
10
- let _sdkVersion = '0.33.35';
9
+ let _version = '1.0.33';
10
+ let _sdkVersion = '0.33.36';
11
11
  try {
12
12
  const pkg = JSON.parse(readFileSync(join(import.meta.dir, '..', 'package.json'), 'utf-8')) as {
13
13
  readonly version?: unknown;