@pulsarinteractive/geniustasker 0.1.0-beta.13 → 0.1.0-beta.15

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 (44) hide show
  1. package/CHANGELOG.md +21 -0
  2. package/README.md +5 -1
  3. package/docs/CHATGPT.md +17 -0
  4. package/docs/CLI.md +46 -1
  5. package/docs/FEEDBACK.md +96 -0
  6. package/docs/INTEGRATIONS.md +4 -4
  7. package/docs/PLANNING.md +149 -10
  8. package/docs/TASK_CHECKLISTS.md +85 -0
  9. package/docs/TASK_LOCKS.md +99 -0
  10. package/docs/TASK_PAUSES.md +91 -0
  11. package/examples/codex.toml +1 -1
  12. package/examples/mcp.json +1 -1
  13. package/mcp.json +1 -1
  14. package/package.json +1 -1
  15. package/plugin.json +1 -1
  16. package/remote/tool-catalog.json +735 -2
  17. package/remote/workflows.json +62 -6
  18. package/skills/geniustasker/SKILL.md +37 -0
  19. package/skills/geniustasker/references/agent-runs.md +33 -2
  20. package/skills/geniustasker/references/collaboration.md +15 -2
  21. package/skills/geniustasker/references/host-events.md +9 -0
  22. package/skills/geniustasker/references/incremental-reads.md +11 -0
  23. package/skills/geniustasker/references/protocols.md +29 -3
  24. package/skills/geniustasker-feedback/SKILL.md +44 -0
  25. package/skills/geniustasker-feedback/agents/openai.yaml +4 -0
  26. package/skills/geniustasker-planning/SKILL.md +48 -0
  27. package/src/changes.mjs +5 -1
  28. package/src/cli.mjs +134 -7
  29. package/src/client.mjs +16 -0
  30. package/src/command-catalog.mjs +156 -1
  31. package/src/command-input-schemas.mjs +924 -0
  32. package/src/commands.mjs +250 -20
  33. package/src/feedback-contract.mjs +629 -0
  34. package/src/feedback-image.mjs +123 -0
  35. package/src/feedback-media-transfer.mjs +61 -0
  36. package/src/feedback.mjs +152 -0
  37. package/src/intents.mjs +111 -0
  38. package/src/mcp.mjs +126 -3
  39. package/src/protocols.mjs +1 -0
  40. package/src/resources.mjs +26 -3
  41. package/src/task-availability-contract.mjs +166 -0
  42. package/src/task-availability.mjs +35 -0
  43. package/src/task-state-legacy-contract.mjs +121 -0
  44. package/src/transport.mjs +10 -3
package/src/cli.mjs CHANGED
@@ -1,3 +1,16 @@
1
+ import {
2
+ readFeedbackCapabilities,
3
+ readFeedbackPage,
4
+ readFeedbackDetail,
5
+ readFeedbackReceipt,
6
+ markFeedbackRead,
7
+ removeFeedbackImage,
8
+ } from './feedback.mjs';
9
+ import {
10
+ prepareFeedbackImage,
11
+ uploadFeedbackImage,
12
+ downloadFeedbackImage,
13
+ } from './feedback-media-transfer.mjs';
1
14
  import { workflow } from './workflows.mjs';
2
15
  import { readFile } from 'node:fs/promises';
3
16
  import {
@@ -6,7 +19,6 @@ import {
6
19
  unlockDocumentation,
7
20
  } from './documentation-sync.mjs';
8
21
  import open, { apps } from 'open';
9
- import catalog from './command-catalog.mjs';
10
22
  import { CredentialStore } from './store.mjs';
11
23
  import { ORIGINS, originOf, Transport } from './transport.mjs';
12
24
  import { AgentClient } from './client.mjs';
@@ -17,6 +29,7 @@ import { readChanges, watchChanges } from './changes.mjs';
17
29
  import { readMemoryTree, readMemoryMarkdown } from './documentation.mjs';
18
30
  import { searchMemory, exploreGraph, resolveMemory } from './knowledge.mjs';
19
31
  import { previewProtocol } from './protocols.mjs';
32
+ import { readIntents, previewIntent } from './intents.mjs';
20
33
  import { reportRunEvent } from './run-events.mjs';
21
34
  import { readResources, readMetrics } from './resources.mjs';
22
35
  import { MediaJournal, mediaAction, downloadMedia, compareMedia } from './media.mjs';
@@ -25,6 +38,57 @@ import { checkUpdate, installUpdate, maybeNotifyUpdate } from './update.mjs';
25
38
  import { acquireRuntime } from './update-runtime.mjs';
26
39
 
27
40
  export const commands = {
41
+ 'feedback capabilities': {
42
+ summary: 'Read private feedback eligibility, current epoch and image limits.',
43
+ options: [],
44
+ },
45
+ 'feedback prepare': {
46
+ summary:
47
+ 'Save an immutable draft from JSON without sending. Reads current epoch once if omitted.',
48
+ options: ['file'],
49
+ },
50
+ 'feedback submit': {
51
+ summary: 'Send exact approved feedback JSON with its saved command and draft IDs.',
52
+ options: ['file'],
53
+ },
54
+ 'feedback list': {
55
+ summary: 'Read one bounded page of your Starter/Pro feedback.',
56
+ options: ['status', 'type', 'after'],
57
+ },
58
+ 'feedback show': {
59
+ summary:
60
+ 'Read one exact private request, its status, resolution and optional final decision message.',
61
+ options: ['id'],
62
+ },
63
+ 'feedback receipt': {
64
+ summary: 'Recover delivery by exact command ID, including Free bug reports.',
65
+ options: ['id'],
66
+ },
67
+ 'feedback media-prepare': {
68
+ summary: 'Inspect one local screenshot up to 4 MB and prepare metadata; no network.',
69
+ options: ['draft-id', 'epoch', 'file'],
70
+ },
71
+ 'feedback media-open': {
72
+ summary: 'Reserve one screenshot from prepared JSON before sending feedback.',
73
+ options: ['file'],
74
+ },
75
+ 'feedback media-upload': {
76
+ summary: 'Upload exact reserved bytes for server compression or replay a confirmed receipt.',
77
+ options: ['operation', 'file'],
78
+ },
79
+ 'feedback mark-read': {
80
+ summary: 'Mark the exact viewed decision revision as read from JSON.',
81
+ options: ['file'],
82
+ },
83
+ 'feedback media-remove': {
84
+ summary: 'Remove one exact screenshot at the user’s request.',
85
+ options: ['id'],
86
+ },
87
+ 'feedback media-download': {
88
+ summary: 'Download an authorized feedback screenshot to a new file.',
89
+ options: ['id', 'file'],
90
+ },
91
+
28
92
  'update check': {
29
93
  summary: 'Check the official npm registry for this installation channel; no account access.',
30
94
  options: ['channel'],
@@ -133,6 +197,14 @@ export const commands = {
133
197
  summary: 'Read a bounded project page; follow nextAfter even for an empty page.',
134
198
  options: ['after'],
135
199
  },
200
+ 'intents read': {
201
+ summary: 'Read personal temporary instructions for one project.',
202
+ options: ['scope'],
203
+ },
204
+ 'intents preview': {
205
+ summary: 'Preview a temporary focus/defer selection from JSON without changing tasks.',
206
+ options: ['file'],
207
+ },
136
208
  'protocols preview': {
137
209
  summary: 'Preview one page of a published task protocol from JSON without creating tasks.',
138
210
  options: ['file'],
@@ -154,17 +226,19 @@ export const commands = {
154
226
  'id',
155
227
  'path',
156
228
  'metric-id',
229
+ 'task-state',
230
+ 'task-id',
157
231
  ],
158
232
  },
159
233
  'changes list': {
160
234
  summary:
161
235
  'Read one bounded change page from a completed resource inventory or previous nextCursor.',
162
- options: ['scope', 'collection', 'cursor'],
236
+ options: ['scope', 'collection', 'cursor', 'task-state'],
163
237
  },
164
238
  'changes watch': {
165
239
  summary:
166
240
  'Wait at most 60 seconds for one change page, rechecking rights on every poll. No infinite stream.',
167
- options: ['scope', 'collection', 'cursor', 'wait-seconds'],
241
+ options: ['scope', 'collection', 'cursor', 'wait-seconds', 'task-state'],
168
242
  },
169
243
  'questions answers': {
170
244
  summary:
@@ -257,7 +331,7 @@ export function help(command = 'help') {
257
331
  flow: 'browser (default, PKCE loopback) | device (SSH/headless)',
258
332
  browser: 'default (automatic) | chrome; --no-browser prints the link without opening it',
259
333
  scope:
260
- 'space-separated permission ceiling; official login proposes all requested permissions for review before approval',
334
+ 'space-separated permission ceiling; omitted by default so the server proposes its available permissions for human approval',
261
335
  interactive:
262
336
  'required when starting login without a terminal; never use to bypass human consent',
263
337
  },
@@ -339,7 +413,44 @@ export async function main(
339
413
  const store = new CredentialStore({ context: options.context, directory });
340
414
  const client = new AgentClient(new Transport(origin, { fetchImpl, signal }), store);
341
415
  let data;
342
- if (command === 'auth login') {
416
+ if (command === 'feedback capabilities') {
417
+ data = await readFeedbackCapabilities(client);
418
+ } else if (command === 'feedback prepare') {
419
+ data = await new CommandJournal(client).prepareFeedback(await readCommandFile(options.file));
420
+ } else if (command === 'feedback submit') {
421
+ data = await new CommandJournal(client).submitFeedback(await readCommandFile(options.file));
422
+ } else if (command === 'feedback list') {
423
+ data = await readFeedbackPage(client, {
424
+ status: options.status,
425
+ type: options.type,
426
+ after: options.after,
427
+ });
428
+ } else if (command === 'feedback show') {
429
+ data = await readFeedbackDetail(client, { id: options.id });
430
+ } else if (command === 'feedback receipt') {
431
+ data = await readFeedbackReceipt(client, { id: options.id });
432
+ } else if (command === 'feedback media-prepare') {
433
+ data = await prepareFeedbackImage({
434
+ draftId: options['draft-id'],
435
+ expectedEpoch: options.epoch,
436
+ file: options.file,
437
+ });
438
+ } else if (command === 'feedback media-open') {
439
+ data = await new CommandJournal(client).openFeedbackMedia(
440
+ await readCommandFile(options.file),
441
+ );
442
+ } else if (command === 'feedback media-upload') {
443
+ data = await uploadFeedbackImage(client, {
444
+ operationId: options.operation,
445
+ file: options.file,
446
+ });
447
+ } else if (command === 'feedback mark-read') {
448
+ data = await markFeedbackRead(client, await readCommandFile(options.file));
449
+ } else if (command === 'feedback media-remove') {
450
+ data = await removeFeedbackImage(client, { id: options.id });
451
+ } else if (command === 'feedback media-download') {
452
+ data = await downloadFeedbackImage(client, { id: options.id, file: options.file });
453
+ } else if (command === 'auth login') {
343
454
  if (!isTTY && !options.interactive) {
344
455
  fail('invalid_arguments', 'Login needs an interactive human.', {
345
456
  remediation:
@@ -368,7 +479,9 @@ export async function main(
368
479
  }
369
480
  };
370
481
  data = await (options.flow === 'device' ? deviceLogin : browserLogin)(client, {
371
- scope: options.scope ?? catalog.grants.permissions.join(' '),
482
+ // The selected deployment owns the default consent proposal. A newer
483
+ // CLI catalogue can contain permissions that production does not yet serve.
484
+ scope: options.scope,
372
485
  openBrowser: options['no-browser']
373
486
  ? undefined
374
487
  : async (url) => {
@@ -399,6 +512,10 @@ export async function main(
399
512
  data = await new AgentProfiles(client).restrict(await readCommandFile(options.file));
400
513
  } else if (command === 'profiles select') {
401
514
  data = await new AgentProfiles(client).select({ profileId: options.profile });
515
+ } else if (command === 'intents read') {
516
+ data = await readIntents(client, { scope: options.scope });
517
+ } else if (command === 'intents preview') {
518
+ data = await previewIntent(client, await readCommandFile(options.file));
402
519
  } else if (command === 'protocols preview') {
403
520
  data = await previewProtocol(client, await readCommandFile(options.file));
404
521
  } else if (command === 'runs event') {
@@ -432,6 +549,7 @@ export async function main(
432
549
  scope: options.scope,
433
550
  collection: options.collection,
434
551
  cursor: options.cursor,
552
+ taskState: options['task-state'],
435
553
  };
436
554
  data =
437
555
  command === 'changes list'
@@ -560,7 +678,16 @@ export async function main(
560
678
  const input = Object.fromEntries(
561
679
  commands[command].options
562
680
  .filter((key) => options[key] !== undefined)
563
- .map((key) => [key === 'metric-id' ? 'metricId' : key, options[key]]),
681
+ .map((key) => [
682
+ key === 'metric-id'
683
+ ? 'metricId'
684
+ : key === 'task-state'
685
+ ? 'taskState'
686
+ : key === 'task-id'
687
+ ? 'taskId'
688
+ : key,
689
+ options[key],
690
+ ]),
564
691
  );
565
692
  data =
566
693
  command === 'resources list'
package/src/client.mjs CHANGED
@@ -254,6 +254,22 @@ export class AgentClient {
254
254
  return { connected: false, revoked: true };
255
255
  }, this.transport.signal);
256
256
  }
257
+ async feedbackRead(resource = '', query) {
258
+ if (
259
+ typeof resource !== 'string' ||
260
+ !/^(?:capabilities|(?:receipts|detail)\/[a-fA-F0-9-]{36})?$/.test(resource)
261
+ ) {
262
+ fail(
263
+ 'invalid_arguments',
264
+ 'Use feedback capabilities, one exact request or command ID, or a bounded list.',
265
+ );
266
+ }
267
+ const token = await this.accessToken();
268
+ return this.transport.request(`/api/agents/v1/feedback${resource ? '/' + resource : ''}`, {
269
+ token,
270
+ query,
271
+ });
272
+ }
257
273
  async doctor() {
258
274
  const session = await this.store.read();
259
275
  return {
@@ -31,6 +31,49 @@ export default {
31
31
  "module": "Project/ProjectTaskComment",
32
32
  "permission": "approvals:write"
33
33
  },
34
+ "checklist.create": {
35
+ "action": "createChecklistItem",
36
+ "create": true,
37
+ "fields": [
38
+ "task",
39
+ "title"
40
+ ],
41
+ "inputSchema": "GeniusTasker.Checklists.Create",
42
+ "module": "Project/ProjectTaskChecklistItem",
43
+ "permission": "tasks:write"
44
+ },
45
+ "checklist.move": {
46
+ "action": "moveChecklistItem",
47
+ "fields": [
48
+ "task",
49
+ "neighborId",
50
+ "neighborRevision"
51
+ ],
52
+ "inputSchema": "GeniusTasker.Checklists.Move",
53
+ "module": "Project/ProjectTaskChecklistItem",
54
+ "permission": "tasks:write"
55
+ },
56
+ "checklist.remove": {
57
+ "action": "removeChecklistItem",
58
+ "delete": true,
59
+ "fields": [
60
+ "task"
61
+ ],
62
+ "inputSchema": "GeniusTasker.Checklists.Remove",
63
+ "module": "Project/ProjectTaskChecklistItem",
64
+ "permission": "tasks:write"
65
+ },
66
+ "checklist.update": {
67
+ "action": "updateChecklistItem",
68
+ "fields": [
69
+ "task",
70
+ "title",
71
+ "checked"
72
+ ],
73
+ "inputSchema": "GeniusTasker.Checklists.Update",
74
+ "module": "Project/ProjectTaskChecklistItem",
75
+ "permission": "tasks:write"
76
+ },
34
77
  "comment.create": {
35
78
  "create": true,
36
79
  "fields": [
@@ -165,6 +208,21 @@ export default {
165
208
  "module": "Project/ProjectMemberGoals",
166
209
  "permission": "goals:write"
167
210
  },
211
+ "intent.change": {
212
+ "action": "coachIntent",
213
+ "fields": [
214
+ "decision",
215
+ "id",
216
+ "expectedIntentRevision",
217
+ "selection",
218
+ "sourceVersion",
219
+ "replaces"
220
+ ],
221
+ "inputSchema": "GeniusTasker.CoachIntents.TaskerIntentCommand",
222
+ "module": "$private/TaskerCoachIntents",
223
+ "permission": "tasks:write",
224
+ "upsert": true
225
+ },
168
226
  "memory.create": {
169
227
  "create": true,
170
228
  "fields": [
@@ -423,6 +481,15 @@ export default {
423
481
  "permission": "metrics:write",
424
482
  "personalModule": "LocalUser/LocalUserMetricObservation"
425
483
  },
484
+ "project.configureInstructions": {
485
+ "action": "configureAgentInstructions",
486
+ "fields": [
487
+ "instructions"
488
+ ],
489
+ "inputSchema": "GeniusTasker.Contracts.AgentProjectInstructions",
490
+ "module": "Project/$",
491
+ "permission": "projects:write"
492
+ },
426
493
  "project.create": {
427
494
  "create": true,
428
495
  "fields": [
@@ -529,6 +596,18 @@ export default {
529
596
  "module": "$private/VoteDraft",
530
597
  "permission": "questions:write"
531
598
  },
599
+ "run.checklist": {
600
+ "action": "checklistRunTask",
601
+ "fields": [
602
+ "taskRevision",
603
+ "itemId",
604
+ "itemRevision",
605
+ "change"
606
+ ],
607
+ "inputSchema": "GeniusTasker.Runs.Checklist",
608
+ "module": "Project/ProjectAgentRun",
609
+ "permission": "tasks:write"
610
+ },
532
611
  "run.checkpoint": {
533
612
  "action": "checkpointRun",
534
613
  "fields": [
@@ -567,6 +646,16 @@ export default {
567
646
  "module": "Project/ProjectAgentRun",
568
647
  "permission": "tasks:write"
569
648
  },
649
+ "run.lock": {
650
+ "action": "lockRunTask",
651
+ "fields": [
652
+ "taskRevision",
653
+ "reason"
654
+ ],
655
+ "inputSchema": "GeniusTasker.Runs.Lock",
656
+ "module": "Project/ProjectAgentRun",
657
+ "permission": "tasks:write"
658
+ },
570
659
  "run.patch": {
571
660
  "action": "patchRunTask",
572
661
  "fields": [
@@ -577,6 +666,35 @@ export default {
577
666
  "module": "Project/ProjectAgentRun",
578
667
  "permission": "tasks:write"
579
668
  },
669
+ "run.pause": {
670
+ "action": "pauseRunTask",
671
+ "fields": [
672
+ "taskRevision",
673
+ "reason",
674
+ "nextSteps"
675
+ ],
676
+ "inputSchema": "GeniusTasker.Runs.Pause",
677
+ "module": "Project/ProjectAgentRun",
678
+ "permission": "tasks:write"
679
+ },
680
+ "run.resume": {
681
+ "action": "resumeRunTask",
682
+ "fields": [
683
+ "taskRevision"
684
+ ],
685
+ "inputSchema": "GeniusTasker.Runs.Resume",
686
+ "module": "Project/ProjectAgentRun",
687
+ "permission": "tasks:write"
688
+ },
689
+ "run.unlock": {
690
+ "action": "unlockRunTask",
691
+ "fields": [
692
+ "taskRevision"
693
+ ],
694
+ "inputSchema": "GeniusTasker.Runs.Unlock",
695
+ "module": "Project/ProjectAgentRun",
696
+ "permission": "tasks:write"
697
+ },
580
698
  "schedule.create": {
581
699
  "create": true,
582
700
  "fields": [
@@ -734,6 +852,26 @@ export default {
734
852
  "dependencies",
735
853
  "tags"
736
854
  ],
855
+ "inputSchema": "GeniusTasker.AgentTasks.Create",
856
+ "module": "Project/ProjectTask",
857
+ "permission": "tasks:write"
858
+ },
859
+ "task.lock": {
860
+ "action": "lockTask",
861
+ "fields": [
862
+ "reason"
863
+ ],
864
+ "inputSchema": "GeniusTasker.TaskPlanning.LockTask",
865
+ "module": "Project/ProjectTask",
866
+ "permission": "tasks:write"
867
+ },
868
+ "task.pause": {
869
+ "action": "pauseTask",
870
+ "fields": [
871
+ "reason",
872
+ "nextSteps"
873
+ ],
874
+ "inputSchema": "GeniusTasker.TaskPlanning.PauseTask",
737
875
  "module": "Project/ProjectTask",
738
876
  "permission": "tasks:write"
739
877
  },
@@ -753,6 +891,20 @@ export default {
753
891
  "module": "Project/ProjectTask",
754
892
  "permission": "tasks:write"
755
893
  },
894
+ "task.resume": {
895
+ "action": "resumeTask",
896
+ "fields": [],
897
+ "inputSchema": "GeniusTasker.TaskPlanning.ResumeTask",
898
+ "module": "Project/ProjectTask",
899
+ "permission": "tasks:write"
900
+ },
901
+ "task.unlock": {
902
+ "action": "unlockTask",
903
+ "fields": [],
904
+ "inputSchema": "GeniusTasker.TaskPlanning.UnlockTask",
905
+ "module": "Project/ProjectTask",
906
+ "permission": "tasks:write"
907
+ },
756
908
  "task.update": {
757
909
  "fields": [
758
910
  "title",
@@ -773,6 +925,7 @@ export default {
773
925
  "dependencies",
774
926
  "tags"
775
927
  ],
928
+ "inputSchema": "GeniusTasker.AgentTasks.Update",
776
929
  "module": "Project/ProjectTask",
777
930
  "permission": "tasks:write"
778
931
  },
@@ -848,7 +1001,9 @@ export default {
848
1001
  "memory:read",
849
1002
  "memory:write",
850
1003
  "media:read",
851
- "media:write"
1004
+ "media:write",
1005
+ "feedback:read",
1006
+ "feedback:write"
852
1007
  ],
853
1008
  "maxResources": 200,
854
1009
  "maxProfilesPerConnection": 20