@pulsarinteractive/geniustasker 0.1.0-beta.12 → 0.1.0-beta.14
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 +20 -0
- package/README.md +12 -1
- package/docs/CHATGPT.md +6 -0
- package/docs/CLI.md +75 -5
- package/docs/FEEDBACK.md +96 -0
- package/docs/INTEGRATIONS.md +25 -2
- package/docs/PLANNING.md +95 -0
- package/docs/TASK_LOCKS.md +91 -0
- package/examples/codex.toml +1 -1
- package/examples/mcp.json +1 -1
- package/mcp.json +1 -1
- package/package.json +1 -1
- package/plugin.json +1 -1
- package/remote/tool-catalog.json +779 -1
- package/remote/workflows.json +56 -2
- package/skills/geniustasker/SKILL.md +29 -1
- package/skills/geniustasker/references/agent-runs.md +13 -0
- package/skills/geniustasker/references/incremental-reads.md +9 -0
- package/skills/geniustasker/references/metric-goals.md +143 -0
- package/skills/geniustasker/references/metrics-observations.md +184 -0
- package/skills/geniustasker/references/metrics.md +136 -0
- package/skills/geniustasker/references/protocols.md +18 -3
- package/skills/geniustasker-feedback/SKILL.md +44 -0
- package/skills/geniustasker-feedback/agents/openai.yaml +4 -0
- package/skills/geniustasker-memory/SKILL.md +4 -1
- package/skills/geniustasker-planning/SKILL.md +28 -0
- package/src/changes.mjs +7 -5
- package/src/cli.mjs +165 -16
- package/src/client.mjs +16 -0
- package/src/command-catalog.mjs +151 -1
- package/src/command-input-schemas.mjs +1254 -93
- package/src/commands.mjs +257 -22
- package/src/feedback-contract.mjs +629 -0
- package/src/feedback-image.mjs +123 -0
- package/src/feedback-media-transfer.mjs +61 -0
- package/src/feedback.mjs +152 -0
- package/src/intents.mjs +111 -0
- package/src/mcp.mjs +143 -20
- package/src/protocols.mjs +1 -0
- package/src/resources.mjs +114 -0
- package/src/task-availability-contract.mjs +121 -0
- package/src/task-availability.mjs +25 -0
- package/src/transport.mjs +10 -3
package/src/commands.mjs
CHANGED
|
@@ -1,5 +1,14 @@
|
|
|
1
|
+
import {
|
|
2
|
+
feedbackDraftSchema,
|
|
3
|
+
prepareFeedbackCommand,
|
|
4
|
+
readFeedbackCapabilities,
|
|
5
|
+
validateFeedbackCreate,
|
|
6
|
+
validateFeedbackUpload,
|
|
7
|
+
validFeedbackReceipt,
|
|
8
|
+
validFeedbackMediaSession,
|
|
9
|
+
} from './feedback.mjs';
|
|
1
10
|
import { retryAt, requireRetryReady } from './recovery.mjs';
|
|
2
|
-
import { randomUUID } from 'node:crypto';
|
|
11
|
+
import { randomUUID, createHash } from 'node:crypto';
|
|
3
12
|
import { constants } from 'node:fs';
|
|
4
13
|
import { open } from 'node:fs/promises';
|
|
5
14
|
import { join } from 'node:path';
|
|
@@ -26,7 +35,7 @@ export const commandSchema = z
|
|
|
26
35
|
.string()
|
|
27
36
|
.max(256)
|
|
28
37
|
// eslint-disable-next-line no-control-regex -- Reject control characters in untrusted input.
|
|
29
|
-
.regex(/^(project|memory):[^\u0000-\u001f]+$/u),
|
|
38
|
+
.regex(/^(project|memory|personal):[^\u0000-\u001f]+$/u),
|
|
30
39
|
epoch: identifier,
|
|
31
40
|
id: identifier,
|
|
32
41
|
expectedRevision: z
|
|
@@ -38,6 +47,15 @@ export const commandSchema = z
|
|
|
38
47
|
})
|
|
39
48
|
.strict();
|
|
40
49
|
export const draftSchema = commandSchema.omit({ operationId: true, issuedAt: true });
|
|
50
|
+
export const metricCommandSchema = commandSchema
|
|
51
|
+
.extend({
|
|
52
|
+
kind: z.enum(
|
|
53
|
+
Object.entries(catalog.commands)
|
|
54
|
+
.filter(([, definition]) => definition.permission === 'metrics:write')
|
|
55
|
+
.map(([kind]) => kind),
|
|
56
|
+
),
|
|
57
|
+
})
|
|
58
|
+
.strict();
|
|
41
59
|
const canonical = (value) =>
|
|
42
60
|
JSON.stringify(value, (_, item) =>
|
|
43
61
|
item && typeof item === 'object' && !Array.isArray(item)
|
|
@@ -65,19 +83,28 @@ export function validateCommand(value) {
|
|
|
65
83
|
if (
|
|
66
84
|
Buffer.byteLength(JSON.stringify(command)) > catalog.maxCommandBytes ||
|
|
67
85
|
Object.keys(command.data).some((key) => !definition.fields.includes(key)) ||
|
|
68
|
-
(definition.
|
|
86
|
+
(!definition.upsert &&
|
|
87
|
+
(definition.create ? command.expectedRevision !== null : command.expectedRevision === null))
|
|
69
88
|
) {
|
|
70
89
|
fail(
|
|
71
90
|
'invalid_arguments',
|
|
72
|
-
'Use the declared command fields and size limit. Creation requires a null revision;
|
|
91
|
+
'Use the declared command fields and size limit. Creation requires a null revision; updates require the current record revision. Declared upserts use the revision returned by their dedicated read.',
|
|
73
92
|
);
|
|
74
93
|
}
|
|
75
|
-
const prefix =
|
|
94
|
+
const prefix =
|
|
95
|
+
command.scope.startsWith('personal:') && definition.personalModule
|
|
96
|
+
? 'personal:'
|
|
97
|
+
: definition.module.startsWith('Memory/')
|
|
98
|
+
? 'memory:'
|
|
99
|
+
: 'project:';
|
|
76
100
|
if (
|
|
77
101
|
!command.scope.startsWith(prefix) ||
|
|
78
102
|
(definition.module.endsWith('/$') && command.id !== command.scope.slice(prefix.length))
|
|
79
103
|
) {
|
|
80
|
-
fail(
|
|
104
|
+
fail(
|
|
105
|
+
'invalid_arguments',
|
|
106
|
+
'Use the matching project or memory scope. Only declared personal metric commands may target personal:<connected-owner>.',
|
|
107
|
+
);
|
|
81
108
|
}
|
|
82
109
|
if (
|
|
83
110
|
['memory.create', 'project.create'].includes(command.kind) &&
|
|
@@ -162,7 +189,7 @@ const binding = (session) => ({
|
|
|
162
189
|
profileId: session.profile_id,
|
|
163
190
|
sessionId: session.session_id,
|
|
164
191
|
});
|
|
165
|
-
function checkSavedCommand(row, input, identity) {
|
|
192
|
+
function checkSavedCommand(row, input, identity, protocol) {
|
|
166
193
|
if (row && (row.formatVersion !== 1 || canonical(row.binding) !== canonical(identity))) {
|
|
167
194
|
fail(
|
|
168
195
|
'operation_identity_mismatch',
|
|
@@ -173,7 +200,7 @@ function checkSavedCommand(row, input, identity) {
|
|
|
173
200
|
},
|
|
174
201
|
);
|
|
175
202
|
}
|
|
176
|
-
if (row && canonical(row.input) !== canonical(input)) {
|
|
203
|
+
if (row && (row.protocol !== protocol || canonical(row.input) !== canonical(input))) {
|
|
177
204
|
fail(
|
|
178
205
|
'idempotency_mismatch',
|
|
179
206
|
'The operation ID already belongs to a different immutable request.',
|
|
@@ -205,6 +232,21 @@ const receiptSchema = z
|
|
|
205
232
|
})
|
|
206
233
|
.strict();
|
|
207
234
|
|
|
235
|
+
const confirmationProtocols = {
|
|
236
|
+
feedback_submit: {
|
|
237
|
+
validate: validateFeedbackCreate,
|
|
238
|
+
validReceipt: validFeedbackReceipt,
|
|
239
|
+
operationId: (input) => input.commandId,
|
|
240
|
+
path: '/api/agents/v1/feedback',
|
|
241
|
+
},
|
|
242
|
+
feedback_media_open: {
|
|
243
|
+
validate: validateFeedbackUpload,
|
|
244
|
+
validReceipt: validFeedbackMediaSession,
|
|
245
|
+
operationId: (input) => input.id,
|
|
246
|
+
path: '/api/agents/v1/feedback/media/uploads',
|
|
247
|
+
},
|
|
248
|
+
};
|
|
249
|
+
|
|
208
250
|
/** A journal is bound to one authenticated terminal identity. Persist the full
|
|
209
251
|
* request before the network call, never regenerate a UUID after a timeout.
|
|
210
252
|
* It contains private project text but no access/refresh tokens. A process crash
|
|
@@ -244,14 +286,184 @@ export class CommandJournal {
|
|
|
244
286
|
return { operationId: input.operationId, state: row?.state ?? 'prepared', request: input };
|
|
245
287
|
}, this.client.transport.signal);
|
|
246
288
|
}
|
|
289
|
+
async prepareFeedback(draft) {
|
|
290
|
+
const value = checked(feedbackDraftSchema, draft);
|
|
291
|
+
const identity = binding(await this.client.session());
|
|
292
|
+
if (!value.expectedEpoch) {
|
|
293
|
+
value.expectedEpoch = (await readFeedbackCapabilities(this.client)).epoch;
|
|
294
|
+
}
|
|
295
|
+
if (canonical(binding(await this.client.session())) !== canonical(identity)) {
|
|
296
|
+
fail('operation_identity_mismatch', 'The connection changed while preparing feedback.');
|
|
297
|
+
}
|
|
298
|
+
const prepared = prepareFeedbackCommand(value),
|
|
299
|
+
store = this.store(prepared.command.commandId);
|
|
300
|
+
await store.locked(
|
|
301
|
+
() =>
|
|
302
|
+
store.write({
|
|
303
|
+
formatVersion: 1,
|
|
304
|
+
protocol: 'feedback_submit',
|
|
305
|
+
binding: identity,
|
|
306
|
+
input: prepared.command,
|
|
307
|
+
state: 'prepared',
|
|
308
|
+
}),
|
|
309
|
+
this.client.transport.signal,
|
|
310
|
+
);
|
|
311
|
+
return prepared;
|
|
312
|
+
}
|
|
313
|
+
async submitFeedback(value) {
|
|
314
|
+
return this.#execute(value, 'feedback_submit');
|
|
315
|
+
}
|
|
316
|
+
async openFeedbackMedia(value) {
|
|
317
|
+
return this.#execute(value, 'feedback_media_open');
|
|
318
|
+
}
|
|
319
|
+
async #mediaUploadRow(store, protocol = 'feedback_media_open') {
|
|
320
|
+
const identity = binding(await this.client.session());
|
|
321
|
+
const row = await store.read();
|
|
322
|
+
if (
|
|
323
|
+
!row ||
|
|
324
|
+
row.formatVersion !== 1 ||
|
|
325
|
+
row.input?.id !== store.context ||
|
|
326
|
+
row.protocol !== protocol ||
|
|
327
|
+
row.state !== 'confirmed' ||
|
|
328
|
+
!confirmationProtocols[protocol].validReceipt(row.receipt, row.input)
|
|
329
|
+
) {
|
|
330
|
+
fail(
|
|
331
|
+
'operation_not_found',
|
|
332
|
+
'Confirm the saved upload reservation first. Recover an uncertain reservation with commands retry.',
|
|
333
|
+
);
|
|
334
|
+
}
|
|
335
|
+
if (canonical(row.binding) !== canonical(identity)) {
|
|
336
|
+
fail(
|
|
337
|
+
'operation_identity_mismatch',
|
|
338
|
+
'The upload belongs to another connection, profile, session or environment.',
|
|
339
|
+
);
|
|
340
|
+
}
|
|
341
|
+
return { identity, row };
|
|
342
|
+
}
|
|
343
|
+
#confirmedMediaReceipt(row) {
|
|
344
|
+
if (row.uploadState !== 'confirmed') {
|
|
345
|
+
return null;
|
|
346
|
+
}
|
|
347
|
+
if (
|
|
348
|
+
!confirmationProtocols[row.protocol].validReceipt(row.uploadReceipt, row.input) ||
|
|
349
|
+
row.uploadReceipt.state !== 'ready'
|
|
350
|
+
) {
|
|
351
|
+
fail(
|
|
352
|
+
'invalid_response',
|
|
353
|
+
'The saved feedback image receipt is invalid. Inspect the operation before acting.',
|
|
354
|
+
);
|
|
355
|
+
}
|
|
356
|
+
return row.uploadReceipt;
|
|
357
|
+
}
|
|
358
|
+
#requireCurrentMediaSize(row) {
|
|
359
|
+
if (row.input.size > 4_000_000) {
|
|
360
|
+
fail('feedback_media_too_large', 'Use a screenshot no larger than 4,000,000 bytes.', {
|
|
361
|
+
status: 413,
|
|
362
|
+
});
|
|
363
|
+
}
|
|
364
|
+
}
|
|
365
|
+
/** A confirmed upload can be replayed without reopening the source file.
|
|
366
|
+
* The same identity and receipt checks still apply; no HTTP request is made. */
|
|
367
|
+
async confirmedFeedbackMediaUpload(id) {
|
|
368
|
+
return this.#confirmedMediaUpload(id, 'feedback_media_open');
|
|
369
|
+
}
|
|
370
|
+
async #confirmedMediaUpload(id, protocol) {
|
|
371
|
+
const store = this.store(id);
|
|
372
|
+
return store.locked(async () => {
|
|
373
|
+
const { row } = await this.#mediaUploadRow(store, protocol);
|
|
374
|
+
const receipt = this.#confirmedMediaReceipt(row);
|
|
375
|
+
if (!receipt) {
|
|
376
|
+
this.#requireCurrentMediaSize(row);
|
|
377
|
+
}
|
|
378
|
+
return receipt;
|
|
379
|
+
}, this.client.transport.signal);
|
|
380
|
+
}
|
|
381
|
+
/** Binary transfer uses the already-confirmed immutable reservation. It
|
|
382
|
+
* never renews an uncertain reservation or retries another request silently. */
|
|
383
|
+
async uploadFeedbackMediaBytes(id, bytes, sha256) {
|
|
384
|
+
return this.#uploadMediaBytes(id, bytes, sha256, 'feedback_media_open');
|
|
385
|
+
}
|
|
386
|
+
async #uploadMediaBytes(id, bytes, sha256, protocol) {
|
|
387
|
+
const store = this.store(id);
|
|
388
|
+
return store.locked(async () => {
|
|
389
|
+
const { identity, row } = await this.#mediaUploadRow(store, protocol);
|
|
390
|
+
const confirmed = this.#confirmedMediaReceipt(row);
|
|
391
|
+
if (confirmed) {
|
|
392
|
+
return confirmed;
|
|
393
|
+
}
|
|
394
|
+
this.#requireCurrentMediaSize(row);
|
|
395
|
+
const source = row.input;
|
|
396
|
+
if (
|
|
397
|
+
!Buffer.isBuffer(bytes) ||
|
|
398
|
+
bytes.length !== source.size ||
|
|
399
|
+
sha256 !== source.sha256 ||
|
|
400
|
+
createHash('sha256').update(bytes).digest('hex') !== source.sha256
|
|
401
|
+
) {
|
|
402
|
+
fail(
|
|
403
|
+
'idempotency_mismatch',
|
|
404
|
+
'The image bytes changed after preparation. Do not reuse this reservation.',
|
|
405
|
+
);
|
|
406
|
+
}
|
|
407
|
+
requireRetryReady(row.uploadRetryAt);
|
|
408
|
+
const session = await this.client.authorizedSession();
|
|
409
|
+
if (canonical(binding(session)) !== canonical(identity)) {
|
|
410
|
+
fail('operation_identity_mismatch', 'The connection changed before upload.');
|
|
411
|
+
}
|
|
412
|
+
await store.write({ ...row, uploadState: 'uncertain' });
|
|
413
|
+
this.client.invalidateReads?.();
|
|
414
|
+
try {
|
|
415
|
+
const result = await this.client.transport.request(row.receipt.uploadPath, {
|
|
416
|
+
method: 'PUT',
|
|
417
|
+
token: session.access_token,
|
|
418
|
+
bytes,
|
|
419
|
+
});
|
|
420
|
+
if (
|
|
421
|
+
!confirmationProtocols[protocol].validReceipt(result, row.input) ||
|
|
422
|
+
result.state !== 'ready'
|
|
423
|
+
) {
|
|
424
|
+
fail(
|
|
425
|
+
'invalid_response',
|
|
426
|
+
'The feedback image upload receipt is invalid. Retry the same bytes and reservation.',
|
|
427
|
+
{ execution: 'unknown' },
|
|
428
|
+
);
|
|
429
|
+
}
|
|
430
|
+
await store.write({ ...row, uploadState: 'confirmed', uploadReceipt: result });
|
|
431
|
+
return result;
|
|
432
|
+
} catch (error) {
|
|
433
|
+
const safe = safeError(error);
|
|
434
|
+
await store
|
|
435
|
+
.write({
|
|
436
|
+
...row,
|
|
437
|
+
uploadState: 'uncertain',
|
|
438
|
+
uploadRetryAt: retryAt(error),
|
|
439
|
+
uploadError: safe.toJSON(),
|
|
440
|
+
})
|
|
441
|
+
.catch(() => {});
|
|
442
|
+
throw new AgentError(safe.code, safe.message, {
|
|
443
|
+
status: safe.status,
|
|
444
|
+
retryable: safe.retryable,
|
|
445
|
+
...safe.details,
|
|
446
|
+
execution: 'unknown',
|
|
447
|
+
operationId: id,
|
|
448
|
+
});
|
|
449
|
+
}
|
|
450
|
+
}, this.client.transport.signal);
|
|
451
|
+
}
|
|
247
452
|
async inspect(id) {
|
|
248
453
|
const row = await this.store(id).read();
|
|
249
|
-
if (
|
|
454
|
+
if (
|
|
455
|
+
!row ||
|
|
456
|
+
row.formatVersion !== 1 ||
|
|
457
|
+
(row.protocol
|
|
458
|
+
? confirmationProtocols[row.protocol]?.operationId(row.input)
|
|
459
|
+
: row.input?.operationId) !== id
|
|
460
|
+
) {
|
|
250
461
|
fail('operation_not_found', 'This context has no valid local operation with that ID.');
|
|
251
462
|
}
|
|
252
463
|
return {
|
|
253
464
|
operationId: id,
|
|
254
465
|
source: 'local_journal',
|
|
466
|
+
...(row.protocol ? { protocol: row.protocol } : {}),
|
|
255
467
|
state: row.state,
|
|
256
468
|
request: row.input,
|
|
257
469
|
...(row.receipt ? { receipt: row.receipt } : {}),
|
|
@@ -260,16 +472,27 @@ export class CommandJournal {
|
|
|
260
472
|
};
|
|
261
473
|
}
|
|
262
474
|
async execute(value) {
|
|
263
|
-
|
|
264
|
-
|
|
475
|
+
return this.#execute(value);
|
|
476
|
+
}
|
|
477
|
+
async #execute(value, protocol) {
|
|
478
|
+
const typed = protocol ? confirmationProtocols[protocol] : null;
|
|
479
|
+
if (protocol && !typed) {
|
|
480
|
+
fail('invalid_arguments', 'Unknown saved operation protocol.');
|
|
481
|
+
}
|
|
482
|
+
const input = typed ? typed.validate(value) : validateCommand(value),
|
|
483
|
+
operationId = typed ? typed.operationId(input) : input.operationId,
|
|
484
|
+
store = this.store(operationId);
|
|
265
485
|
return store.locked(async () => {
|
|
266
486
|
// Capture token and identity together under the refresh lock. A later
|
|
267
487
|
// logout/login cannot turn this pending operation into another profile.
|
|
268
488
|
const localSession = await this.client.session(),
|
|
269
489
|
identity = binding(localSession);
|
|
270
490
|
let row = await store.read();
|
|
271
|
-
checkSavedCommand(row, input, identity);
|
|
491
|
+
checkSavedCommand(row, input, identity, protocol);
|
|
272
492
|
if (row?.state === 'confirmed') {
|
|
493
|
+
if (typed && !typed.validReceipt(row.receipt, input)) {
|
|
494
|
+
fail('invalid_response', 'Invalid saved feedback receipt.');
|
|
495
|
+
}
|
|
273
496
|
return { source: 'local_receipt', receipt: row.receipt };
|
|
274
497
|
}
|
|
275
498
|
requireRetryReady(row?.retryAt);
|
|
@@ -277,17 +500,28 @@ export class CommandJournal {
|
|
|
277
500
|
if (canonical(binding(session)) !== canonical(identity)) {
|
|
278
501
|
fail('operation_identity_mismatch', 'The connection changed before transmission.');
|
|
279
502
|
}
|
|
280
|
-
row = {
|
|
503
|
+
row = {
|
|
504
|
+
formatVersion: 1,
|
|
505
|
+
...(protocol ? { protocol } : {}),
|
|
506
|
+
binding: identity,
|
|
507
|
+
input,
|
|
508
|
+
state: 'uncertain',
|
|
509
|
+
};
|
|
281
510
|
await store.write(row);
|
|
282
511
|
try {
|
|
283
|
-
const receipt = await this.client.transport.request(
|
|
284
|
-
|
|
285
|
-
|
|
286
|
-
|
|
287
|
-
|
|
512
|
+
const receipt = await this.client.transport.request(
|
|
513
|
+
typed?.path ?? '/api/agents/v1/commands',
|
|
514
|
+
{
|
|
515
|
+
method: 'POST',
|
|
516
|
+
json: input,
|
|
517
|
+
token: session.access_token,
|
|
518
|
+
},
|
|
519
|
+
);
|
|
288
520
|
if (
|
|
289
|
-
|
|
290
|
-
|
|
521
|
+
typed
|
|
522
|
+
? !typed.validReceipt(receipt, input)
|
|
523
|
+
: !receiptSchema.safeParse(receipt).success ||
|
|
524
|
+
['operationId', 'scope', 'kind', 'epoch'].some((key) => receipt[key] !== input[key])
|
|
291
525
|
) {
|
|
292
526
|
fail(
|
|
293
527
|
'invalid_response',
|
|
@@ -305,7 +539,7 @@ export class CommandJournal {
|
|
|
305
539
|
remediation: safe.remediation,
|
|
306
540
|
execution: 'unknown',
|
|
307
541
|
...safe.details,
|
|
308
|
-
operationId
|
|
542
|
+
operationId,
|
|
309
543
|
});
|
|
310
544
|
// The uncertainty marker is already durable. Preserve the useful original
|
|
311
545
|
// error/operation ID even if disk pressure prevents saving diagnostics.
|
|
@@ -317,6 +551,7 @@ export class CommandJournal {
|
|
|
317
551
|
}, this.client.transport.signal);
|
|
318
552
|
}
|
|
319
553
|
async retry(id) {
|
|
320
|
-
|
|
554
|
+
const saved = await this.inspect(id);
|
|
555
|
+
return this.#execute(saved.request, saved.protocol);
|
|
321
556
|
}
|
|
322
557
|
}
|