@yu_robotics/remote-cli 1.6.230 → 1.6.232

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 (80) hide show
  1. package/dist/client/MessageHandler.d.ts +16 -0
  2. package/dist/client/MessageHandler.d.ts.map +1 -1
  3. package/dist/client/MessageHandler.js +255 -2
  4. package/dist/client/MessageHandler.js.map +1 -1
  5. package/dist/client/WebSocketClient.d.ts +4 -1
  6. package/dist/client/WebSocketClient.d.ts.map +1 -1
  7. package/dist/client/WebSocketClient.js +43 -3
  8. package/dist/client/WebSocketClient.js.map +1 -1
  9. package/dist/maintenance/release-notes.json +1 -1
  10. package/dist/output/OutputFiles.d.ts +7 -0
  11. package/dist/output/OutputFiles.d.ts.map +1 -1
  12. package/dist/output/OutputFiles.js +16 -3
  13. package/dist/output/OutputFiles.js.map +1 -1
  14. package/dist/output/OutputSnapshots.d.ts +3 -1
  15. package/dist/output/OutputSnapshots.d.ts.map +1 -1
  16. package/dist/output/OutputSnapshots.js +14 -4
  17. package/dist/output/OutputSnapshots.js.map +1 -1
  18. package/dist/output/PendingOutputFiles.d.ts +13 -0
  19. package/dist/output/PendingOutputFiles.d.ts.map +1 -0
  20. package/dist/output/PendingOutputFiles.js +67 -0
  21. package/dist/output/PendingOutputFiles.js.map +1 -0
  22. package/dist/scheduling/ClaudeNativeScheduleProvider.d.ts +19 -0
  23. package/dist/scheduling/ClaudeNativeScheduleProvider.d.ts.map +1 -0
  24. package/dist/scheduling/ClaudeNativeScheduleProvider.js +570 -0
  25. package/dist/scheduling/ClaudeNativeScheduleProvider.js.map +1 -0
  26. package/dist/scheduling/DshNativeScheduleProvider.d.ts +19 -0
  27. package/dist/scheduling/DshNativeScheduleProvider.d.ts.map +1 -0
  28. package/dist/scheduling/DshNativeScheduleProvider.js +470 -0
  29. package/dist/scheduling/DshNativeScheduleProvider.js.map +1 -0
  30. package/dist/scheduling/ScheduleCapabilities.d.ts +53 -0
  31. package/dist/scheduling/ScheduleCapabilities.d.ts.map +1 -0
  32. package/dist/scheduling/ScheduleCapabilities.js +65 -0
  33. package/dist/scheduling/ScheduleCapabilities.js.map +1 -0
  34. package/dist/scheduling/ScheduleCommand.d.ts +27 -0
  35. package/dist/scheduling/ScheduleCommand.d.ts.map +1 -0
  36. package/dist/scheduling/ScheduleCommand.js +173 -0
  37. package/dist/scheduling/ScheduleCommand.js.map +1 -0
  38. package/dist/scheduling/ScheduleDeliveryClient.d.ts +17 -0
  39. package/dist/scheduling/ScheduleDeliveryClient.d.ts.map +1 -0
  40. package/dist/scheduling/ScheduleDeliveryClient.js +109 -0
  41. package/dist/scheduling/ScheduleDeliveryClient.js.map +1 -0
  42. package/dist/scheduling/ScheduleService.d.ts +73 -0
  43. package/dist/scheduling/ScheduleService.d.ts.map +1 -0
  44. package/dist/scheduling/ScheduleService.js +742 -0
  45. package/dist/scheduling/ScheduleService.js.map +1 -0
  46. package/dist/scheduling/claude/rules.d.ts +8 -0
  47. package/dist/scheduling/claude/rules.d.ts.map +1 -0
  48. package/dist/scheduling/claude/rules.js +46 -0
  49. package/dist/scheduling/claude/rules.js.map +1 -0
  50. package/dist/scheduling/dsh/HostBridge.d.ts +96 -0
  51. package/dist/scheduling/dsh/HostBridge.d.ts.map +1 -0
  52. package/dist/scheduling/dsh/HostBridge.js +364 -0
  53. package/dist/scheduling/dsh/HostBridge.js.map +1 -0
  54. package/dist/scheduling/dsh/ScopePlugin.d.ts +9 -0
  55. package/dist/scheduling/dsh/ScopePlugin.d.ts.map +1 -0
  56. package/dist/scheduling/dsh/ScopePlugin.js +13 -0
  57. package/dist/scheduling/dsh/ScopePlugin.js.map +1 -0
  58. package/dist/scheduling/dsh/launch.d.ts +13 -0
  59. package/dist/scheduling/dsh/launch.d.ts.map +1 -0
  60. package/dist/scheduling/dsh/launch.js +58 -0
  61. package/dist/scheduling/dsh/launch.js.map +1 -0
  62. package/dist/scheduling/dsh/protocol.d.ts +28 -0
  63. package/dist/scheduling/dsh/protocol.d.ts.map +1 -0
  64. package/dist/scheduling/dsh/protocol.js +142 -0
  65. package/dist/scheduling/dsh/protocol.js.map +1 -0
  66. package/dist/scheduling/types.d.ts +79 -0
  67. package/dist/scheduling/types.d.ts.map +1 -0
  68. package/dist/scheduling/types.js +13 -0
  69. package/dist/scheduling/types.js.map +1 -0
  70. package/dist/types/index.d.ts +4 -0
  71. package/dist/types/index.d.ts.map +1 -1
  72. package/native/prebuilds/darwin-arm64/managed_native.node +0 -0
  73. package/native/prebuilds/darwin-arm64/manifest.json +1 -1
  74. package/native/prebuilds/darwin-x64/managed_native.node +0 -0
  75. package/native/prebuilds/darwin-x64/manifest.json +1 -1
  76. package/native/prebuilds/win32-arm64/managed_native.node +0 -0
  77. package/native/prebuilds/win32-arm64/manifest.json +1 -1
  78. package/native/prebuilds/win32-x64/managed_native.node +0 -0
  79. package/native/prebuilds/win32-x64/manifest.json +1 -1
  80. package/package.json +1 -1
@@ -0,0 +1,27 @@
1
+ import type { ScheduleRule } from './types';
2
+ export declare const MAX_SCHEDULE_PROMPT_BYTES: number;
3
+ export declare const MAX_SCHEDULE_DELAY_MS: number;
4
+ export declare const SCHEDULE_USAGE: string;
5
+ export type ScheduleCommand = {
6
+ kind: 'help' | 'capabilities' | 'list';
7
+ } | {
8
+ kind: 'cancel';
9
+ id: string;
10
+ } | {
11
+ kind: 'create';
12
+ rule: ScheduleRule;
13
+ prompt: string;
14
+ } | {
15
+ kind: 'invalid';
16
+ message: string;
17
+ };
18
+ export declare function validateScheduleId(id: unknown): asserts id is string;
19
+ export declare function validateSchedulePrompt(prompt: unknown): asserts prompt is string;
20
+ /** Validate field values and grammar, not just the number of cron tokens. */
21
+ export declare function validateScheduleCron(expression: unknown, timezone: unknown): void;
22
+ /** Date.parse normalizes invalid calendar days, so validate the calendar first. */
23
+ export declare function parseScheduleTimestamp(value: unknown): number;
24
+ export declare function validateScheduleRule(rule: ScheduleRule, nowMs?: number): void;
25
+ /** Unrelated messages return undefined; malformed schedule commands never pass through. */
26
+ export declare function parseScheduleCommand(content: string, nowMs?: number): ScheduleCommand | undefined;
27
+ //# sourceMappingURL=ScheduleCommand.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"ScheduleCommand.d.ts","sourceRoot":"","sources":["../../src/scheduling/ScheduleCommand.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAE5C,eAAO,MAAM,yBAAyB,QAAY,CAAC;AACnD,eAAO,MAAM,qBAAqB,QAA4B,CAAC;AAC/D,eAAO,MAAM,cAAc,QAWf,CAAC;AAEb,MAAM,MAAM,eAAe,GACvB;IAAE,IAAI,EAAE,MAAM,GAAG,cAAc,GAAG,MAAM,CAAA;CAAE,GAC1C;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,EAAE,EAAE,MAAM,CAAA;CAAE,GAC9B;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,IAAI,EAAE,YAAY,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GACtD;IAAE,IAAI,EAAE,SAAS,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC;AAEzC,wBAAgB,kBAAkB,CAAC,EAAE,EAAE,OAAO,GAAG,OAAO,CAAC,EAAE,IAAI,MAAM,CAKpE;AAED,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,OAAO,GAAG,OAAO,CAAC,MAAM,IAAI,MAAM,CAKhF;AAED,6EAA6E;AAC7E,wBAAgB,oBAAoB,CAAC,UAAU,EAAE,OAAO,EAAE,QAAQ,EAAE,OAAO,GAAG,IAAI,CA8BjF;AAED,mFAAmF;AACnF,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAe7D;AAED,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,YAAY,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAa7E;AAaD,2FAA2F;AAC3F,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,SAAa,GAAG,eAAe,GAAG,SAAS,CAgCrG"}
@@ -0,0 +1,173 @@
1
+ "use strict";
2
+ Object.defineProperty(exports, "__esModule", { value: true });
3
+ exports.SCHEDULE_USAGE = exports.MAX_SCHEDULE_DELAY_MS = exports.MAX_SCHEDULE_PROMPT_BYTES = void 0;
4
+ exports.validateScheduleId = validateScheduleId;
5
+ exports.validateSchedulePrompt = validateSchedulePrompt;
6
+ exports.validateScheduleCron = validateScheduleCron;
7
+ exports.parseScheduleTimestamp = parseScheduleTimestamp;
8
+ exports.validateScheduleRule = validateScheduleRule;
9
+ exports.parseScheduleCommand = parseScheduleCommand;
10
+ exports.MAX_SCHEDULE_PROMPT_BYTES = 16 * 1024;
11
+ exports.MAX_SCHEDULE_DELAY_MS = 365 * 24 * 60 * 60 * 1000;
12
+ exports.SCHEDULE_USAGE = [
13
+ '/schedule',
14
+ '/schedule capabilities',
15
+ '/schedule list',
16
+ '/schedule cancel <id>',
17
+ '/schedule after <positive integer><m|h|d> -- <prompt>',
18
+ '/schedule at <ISO timestamp with Z or offset> -- <prompt>',
19
+ '/schedule cron "<five numeric fields>" --tz <IANA timezone> -- <prompt>',
20
+ 'Claude and DSH schedules require their dedicated native process to remain running.',
21
+ 'Restarted schedules are marked interrupted and are never automatically recreated.',
22
+ 'One-shot times round up to the next minute; native firing times may include jitter.',
23
+ ].join('\n');
24
+ function validateScheduleId(id) {
25
+ if (typeof id !== 'string' || !/^[A-Za-z0-9_-]{1,128}$/.test(id)
26
+ || ['__proto__', 'constructor', 'prototype'].includes(id)) {
27
+ throw new Error('Schedule ID must contain 1-128 letters, digits, underscores or hyphens.');
28
+ }
29
+ }
30
+ function validateSchedulePrompt(prompt) {
31
+ if (typeof prompt !== 'string' || !prompt.trim() || prompt.includes('\0')
32
+ || Buffer.byteLength(prompt, 'utf8') > exports.MAX_SCHEDULE_PROMPT_BYTES) {
33
+ throw new Error('Schedule prompt must be nonempty, contain no NUL, and fit within 16 KiB.');
34
+ }
35
+ }
36
+ /** Validate field values and grammar, not just the number of cron tokens. */
37
+ function validateScheduleCron(expression, timezone) {
38
+ if (typeof expression !== 'string' || expression.length > 256)
39
+ throw new Error('Invalid cron expression.');
40
+ const fields = expression.trim().split(/\s+/);
41
+ const bounds = [[0, 59], [0, 23], [1, 31], [1, 12], [0, 7]];
42
+ if (fields.length !== bounds.length)
43
+ throw new Error('Cron requires exactly five numeric fields.');
44
+ fields.forEach((field, index) => {
45
+ const [min, max] = bounds[index];
46
+ for (const part of field.split(',')) {
47
+ const match = /^(\*|\d+(?:-\d+)?)(?:\/(\d+))?$/.exec(part);
48
+ if (!match)
49
+ throw new Error(`Invalid cron field ${index + 1}.`);
50
+ const [base, step] = [match[1], match[2]];
51
+ if (step !== undefined && (base !== '*' && !base.includes('-')
52
+ || !Number.isSafeInteger(Number(step)) || Number(step) < 1 || Number(step) > max - min + 1)) {
53
+ throw new Error(`Invalid cron step in field ${index + 1}.`);
54
+ }
55
+ if (base !== '*') {
56
+ const [start, end = start] = base.split('-').map(Number);
57
+ if (!Number.isSafeInteger(start) || !Number.isSafeInteger(end)
58
+ || start < min || end > max || start > end) {
59
+ throw new Error(`Cron field ${index + 1} must be within ${min}-${max}, with ascending ranges.`);
60
+ }
61
+ }
62
+ }
63
+ });
64
+ if (typeof timezone !== 'string' || timezone.length > 128
65
+ || !/^[A-Za-z_]+(?:\/[A-Za-z0-9_+.-]+)*$/.test(timezone)) {
66
+ throw new Error('An explicit IANA timezone is required.');
67
+ }
68
+ try {
69
+ new Intl.DateTimeFormat('en', { timeZone: timezone });
70
+ }
71
+ catch {
72
+ throw new Error('Unknown IANA timezone.');
73
+ }
74
+ }
75
+ /** Date.parse normalizes invalid calendar days, so validate the calendar first. */
76
+ function parseScheduleTimestamp(value) {
77
+ if (typeof value !== 'string')
78
+ throw new Error('An ISO timestamp with an explicit offset or Z is required.');
79
+ const match = /^(\d{4})-(\d{2})-(\d{2})T(\d{2}):(\d{2})(?::(\d{2})(?:\.(\d{1,3}))?)?(Z|[+-]\d{2}:\d{2})$/.exec(value);
80
+ if (!match)
81
+ throw new Error('An ISO timestamp with an explicit offset or Z is required.');
82
+ const [, year, month, day, hour, minute, second = '0', , zone] = match;
83
+ const lastDay = new Date(0);
84
+ lastDay.setUTCFullYear(Number(year), Number(month), 0);
85
+ if (Number(month) < 1 || Number(month) > 12 || Number(day) < 1 || Number(day) > lastDay.getUTCDate()
86
+ || Number(hour) > 23 || Number(minute) > 59 || Number(second) > 59
87
+ || (zone !== 'Z' && (Number(zone.slice(1, 3)) > 23 || Number(zone.slice(4)) > 59))) {
88
+ throw new Error('Invalid ISO calendar date or time.');
89
+ }
90
+ const time = Date.parse(value);
91
+ if (!Number.isFinite(time))
92
+ throw new Error('Invalid ISO timestamp.');
93
+ return time;
94
+ }
95
+ function validateScheduleRule(rule, nowMs) {
96
+ if (!rule || typeof rule !== 'object')
97
+ throw new Error('Invalid schedule rule.');
98
+ const keys = rule.kind === 'once' ? ['kind', 'at'] : ['kind', 'expression', 'timezone'];
99
+ if (Array.isArray(rule) || Object.keys(rule).some(key => !keys.includes(key)))
100
+ throw new Error('Invalid schedule rule fields.');
101
+ if (rule.kind === 'cron') {
102
+ validateScheduleCron(rule.expression, rule.timezone);
103
+ }
104
+ else if (rule.kind === 'once') {
105
+ const time = parseScheduleTimestamp(rule.at);
106
+ if (time % 60_000 !== 0)
107
+ throw new Error('One-shot timestamps must be aligned to a minute.');
108
+ if (nowMs !== undefined && (!Number.isFinite(nowMs) || time <= nowMs || time - nowMs > exports.MAX_SCHEDULE_DELAY_MS)) {
109
+ throw new Error('One-shot time must be in the future and within 365 days.');
110
+ }
111
+ }
112
+ else
113
+ throw new Error('Unknown schedule rule.');
114
+ }
115
+ function once(time, nowMs) {
116
+ if (!Number.isFinite(nowMs) || !Number.isFinite(time) || time <= nowMs) {
117
+ throw new Error('One-shot time must be in the future.');
118
+ }
119
+ const rounded = Math.ceil(time / 60_000) * 60_000;
120
+ if (rounded - nowMs > exports.MAX_SCHEDULE_DELAY_MS)
121
+ throw new Error('One-shot time must be within 365 days after rounding.');
122
+ const rule = { kind: 'once', at: new Date(rounded).toISOString() };
123
+ validateScheduleRule(rule, nowMs);
124
+ return rule;
125
+ }
126
+ /** Unrelated messages return undefined; malformed schedule commands never pass through. */
127
+ function parseScheduleCommand(content, nowMs = Date.now()) {
128
+ const command = /^\/schedule(?:\s+([\s\S]*))?$/.exec(content.trim());
129
+ if (!command)
130
+ return undefined;
131
+ const args = (command[1] ?? '').trim();
132
+ if (!args || args === 'help')
133
+ return { kind: 'help' };
134
+ if (args === 'capabilities' || args === 'list')
135
+ return { kind: args };
136
+ try {
137
+ const cancel = /^cancel\s+(\S+)$/.exec(args);
138
+ if (cancel) {
139
+ validateScheduleId(cancel[1]);
140
+ return { kind: 'cancel', id: cancel[1] };
141
+ }
142
+ const split = /\s+--(?:\s+|$)/.exec(args);
143
+ if (!split)
144
+ throw new Error('Unknown operation or missing " -- " prompt separator.');
145
+ const options = args.slice(0, split.index);
146
+ const prompt = args.slice(split.index + split[0].length).trim();
147
+ validateSchedulePrompt(prompt);
148
+ let rule;
149
+ const after = /^after\s+([1-9]\d*)([mhd])$/.exec(options);
150
+ const at = /^at\s+(\S+)$/.exec(options);
151
+ const cron = /^cron\s+"([^"\r\n]+)"\s+--tz\s+(\S+)$/.exec(options);
152
+ if (after) {
153
+ const count = Number(after[1]);
154
+ if (!Number.isSafeInteger(count))
155
+ throw new Error('Invalid schedule delay.');
156
+ const unit = { m: 60_000, h: 3_600_000, d: 86_400_000 }[after[2]];
157
+ rule = once(nowMs + count * unit, nowMs);
158
+ }
159
+ else if (at)
160
+ rule = once(parseScheduleTimestamp(at[1]), nowMs);
161
+ else if (cron) {
162
+ validateScheduleCron(cron[1], cron[2]);
163
+ rule = { kind: 'cron', expression: cron[1].trim().replace(/\s+/g, ' '), timezone: cron[2] };
164
+ }
165
+ else
166
+ throw new Error('Unknown operation or malformed schedule arguments.');
167
+ return { kind: 'create', rule, prompt };
168
+ }
169
+ catch (error) {
170
+ return { kind: 'invalid', message: error instanceof Error ? error.message : 'Invalid schedule command.' };
171
+ }
172
+ }
173
+ //# sourceMappingURL=ScheduleCommand.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"ScheduleCommand.js","sourceRoot":"","sources":["../../src/scheduling/ScheduleCommand.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,17 @@
1
+ import type { WebSocketClient } from '../client/WebSocketClient';
2
+ import type { ScheduleDelivery } from './types';
3
+ /** Sends an outbox result, never replaying a model turn or tracking its bytes in TaskRecovery. */
4
+ export declare class ScheduleDeliveryClient {
5
+ private readonly wsClient;
6
+ private readonly pending;
7
+ private readonly unsubscribeAck;
8
+ private readonly unsubscribeClose;
9
+ private destroyed;
10
+ constructor(wsClient: WebSocketClient);
11
+ /** Caller must verify negotiated scheduleResultsV1 support and current schedule ownership. */
12
+ deliver(delivery: ScheduleDelivery, threadName: string): Promise<void>;
13
+ destroy(): void;
14
+ private finish;
15
+ private rejectAll;
16
+ }
17
+ //# sourceMappingURL=ScheduleDeliveryClient.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"ScheduleDeliveryClient.d.ts","sourceRoot":"","sources":["../../src/scheduling/ScheduleDeliveryClient.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAC;AAEjE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAC;AAuBhD,kGAAkG;AAClG,qBAAa,sBAAsB;IAMrB,OAAO,CAAC,QAAQ,CAAC,QAAQ;IALrC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAsC;IAC9D,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAa;IAC5C,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAa;IAC9C,OAAO,CAAC,SAAS,CAAS;gBAEG,QAAQ,EAAE,eAAe;IAWtD,8FAA8F;IAC9F,OAAO,CAAC,QAAQ,EAAE,gBAAgB,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IA2CtE,OAAO,IAAI,IAAI;IAQf,OAAO,CAAC,MAAM;IASd,OAAO,CAAC,SAAS;CAGlB"}
@@ -0,0 +1,109 @@
1
+ "use strict";
2
+ Object.defineProperty(exports, "__esModule", { value: true });
3
+ exports.ScheduleDeliveryClient = void 0;
4
+ const ScheduleCapabilities_1 = require("./ScheduleCapabilities");
5
+ const ACK_TIMEOUT_MS = 15_000;
6
+ const MAX_PENDING = 100;
7
+ const MAX_RESULT_CHARACTERS = 64 * 1024;
8
+ function boundedResult(text) {
9
+ if (text === undefined || text.length <= MAX_RESULT_CHARACTERS)
10
+ return text;
11
+ const marker = '\n\n[Scheduled result truncated for delivery.]';
12
+ return text.slice(0, MAX_RESULT_CHARACTERS - marker.length) + marker;
13
+ }
14
+ /** Sends an outbox result, never replaying a model turn or tracking its bytes in TaskRecovery. */
15
+ class ScheduleDeliveryClient {
16
+ wsClient;
17
+ pending = new Map();
18
+ unsubscribeAck;
19
+ unsubscribeClose;
20
+ destroyed = false;
21
+ constructor(wsClient) {
22
+ this.wsClient = wsClient;
23
+ this.unsubscribeAck = wsClient.onTaskResultAck(messageId => {
24
+ const pending = this.pending.get(messageId);
25
+ // A receipt during queue_started cannot acknowledge the response still to be sent.
26
+ if (!pending?.responseStarted)
27
+ return;
28
+ pending.acknowledged = true;
29
+ if (pending.sent)
30
+ this.finish(messageId);
31
+ });
32
+ this.unsubscribeClose = wsClient.onClose(() => this.rejectAll('Scheduled result delivery disconnected'));
33
+ }
34
+ /** Caller must verify negotiated scheduleResultsV1 support and current schedule ownership. */
35
+ deliver(delivery, threadName) {
36
+ if (this.destroyed)
37
+ return Promise.reject(new Error('Scheduled result delivery is shut down'));
38
+ if (!this.wsClient.isConnected())
39
+ return Promise.reject(new Error('Scheduled result delivery is disconnected'));
40
+ const existing = this.pending.get(delivery.id);
41
+ if (existing)
42
+ return existing.promise;
43
+ if (this.pending.size >= MAX_PENDING)
44
+ return Promise.reject(new Error('Too many pending scheduled results'));
45
+ const schedule = delivery.schedule;
46
+ if ([delivery.id, schedule.id, schedule.openId, schedule.threadId].some(value => !value || value.length > 256)
47
+ || !schedule.cwd || schedule.cwd.length > 4096 || !(0, ScheduleCapabilities_1.isNativeScheduleBackend)(schedule.backend)) {
48
+ return Promise.reject(new Error('Invalid scheduled result routing metadata'));
49
+ }
50
+ let resolve;
51
+ let reject;
52
+ const promise = new Promise((accept, decline) => { resolve = accept; reject = decline; });
53
+ const pending = {
54
+ promise, resolve, reject, responseStarted: false, sent: false, acknowledged: false,
55
+ timer: setTimeout(() => this.finish(delivery.id, new Error('Scheduled result receipt timed out')), ACK_TIMEOUT_MS),
56
+ };
57
+ this.pending.set(delivery.id, pending);
58
+ const queueStarted = {
59
+ source: 'schedule', scheduleId: schedule.id, threadName: threadName.slice(0, 100), backend: schedule.backend,
60
+ cwd: schedule.cwd, preview: schedule.prompt.replace(/\s+/g, ' ').slice(0, 240), remainingCount: 0,
61
+ };
62
+ const routing = { messageId: delivery.id, openId: schedule.openId, threadId: schedule.threadId,
63
+ cwd: schedule.cwd, queueStarted };
64
+ try {
65
+ if (!this.wsClient.send({ type: 'queue_started', ...routing, timestamp: Date.now() })) {
66
+ throw new Error('Scheduled result start was not sent');
67
+ }
68
+ if (this.pending.get(delivery.id) !== pending)
69
+ return promise;
70
+ pending.responseStarted = true;
71
+ if (!this.wsClient.send({ type: 'response', ...routing, timestamp: Date.now(), success: delivery.success,
72
+ output: boundedResult(delivery.output), error: boundedResult(delivery.error) })) {
73
+ throw new Error('Scheduled result was not sent');
74
+ }
75
+ pending.sent = true;
76
+ if (pending.acknowledged)
77
+ this.finish(delivery.id);
78
+ }
79
+ catch {
80
+ this.finish(delivery.id, new Error('Scheduled result transport send failed'));
81
+ }
82
+ return promise;
83
+ }
84
+ destroy() {
85
+ if (this.destroyed)
86
+ return;
87
+ this.destroyed = true;
88
+ this.unsubscribeAck();
89
+ this.unsubscribeClose();
90
+ this.rejectAll('Scheduled result delivery is shut down');
91
+ }
92
+ finish(messageId, error) {
93
+ const pending = this.pending.get(messageId);
94
+ if (!pending)
95
+ return;
96
+ this.pending.delete(messageId);
97
+ clearTimeout(pending.timer);
98
+ if (error)
99
+ pending.reject(error);
100
+ else
101
+ pending.resolve();
102
+ }
103
+ rejectAll(message) {
104
+ for (const id of this.pending.keys())
105
+ this.finish(id, new Error(message));
106
+ }
107
+ }
108
+ exports.ScheduleDeliveryClient = ScheduleDeliveryClient;
109
+ //# sourceMappingURL=ScheduleDeliveryClient.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"ScheduleDeliveryClient.js","sourceRoot":"","sources":["../../src/scheduling/ScheduleDeliveryClient.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,73 @@
1
+ import type { NativeScheduleInput, NativeScheduleProvider, ScheduleDelivery, ScheduleOwner, ScheduleRecord } from './types';
2
+ export declare const SCHEDULE_CATALOG_FILE = "schedule-catalog.json";
3
+ export interface ScheduleServiceOptions {
4
+ directory: string;
5
+ provider: NativeScheduleProvider;
6
+ /** Reject when disconnected or not delivered. Success is not an exactly-once receipt. */
7
+ deliver: (delivery: ScheduleDelivery) => Promise<void>;
8
+ isOwnerCurrent: (owner: ScheduleOwner) => boolean;
9
+ now?: () => number;
10
+ maxLiveSchedules?: number;
11
+ maxRecords?: number;
12
+ maxPendingDeliveries?: number;
13
+ maxOccurrencesPerSchedule?: number;
14
+ }
15
+ /**
16
+ * Single service instance per directory. Native processes, never this service, own timing.
17
+ * Delivery is fenced immediately before invoking the callback; an external send already
18
+ * in flight cannot be revoked. A crash between sending and persisting acknowledgement
19
+ * can replay an outbox entry after explicit reconnect. Consumers receive a stable ID.
20
+ */
21
+ export declare class ScheduleService {
22
+ private readonly options;
23
+ private readonly maxLive;
24
+ private readonly maxRecords;
25
+ private readonly maxPending;
26
+ private readonly maxOccurrences;
27
+ private readonly now;
28
+ private records;
29
+ private pending;
30
+ private runtimes;
31
+ private tail;
32
+ private deliveryTail;
33
+ private tasks;
34
+ private operations;
35
+ private initialization?;
36
+ private initialized;
37
+ private closing;
38
+ private destruction?;
39
+ private fault?;
40
+ private catalogPath;
41
+ constructor(options: ScheduleServiceOptions);
42
+ initialize(): Promise<void>;
43
+ create(owner: ScheduleOwner, input: NativeScheduleInput): Promise<ScheduleRecord>;
44
+ private createSchedule;
45
+ /** Catalog lookup only; this does not probe or recreate native jobs. */
46
+ list(owner: ScheduleOwner): Promise<ScheduleRecord[]>;
47
+ /** Includes terminal jobs whose native process exit is still unconfirmed. */
48
+ hasActiveSchedules(threadId?: string): boolean;
49
+ /** User-requested native reconciliation only; no background polling is installed. */
50
+ refresh(owner: ScheduleOwner): Promise<void>;
51
+ private refreshNative;
52
+ cancel(owner: ScheduleOwner, id: string): Promise<ScheduleRecord>;
53
+ private cancelSchedule;
54
+ /** Explicit reconnect retry. No timer or periodic retry is installed. */
55
+ retryDeliveries(): Promise<void>;
56
+ destroy(): Promise<void>;
57
+ private cancelNative;
58
+ private onEvent;
59
+ private attemptDeliveries;
60
+ private stop;
61
+ private newRuntime;
62
+ private track;
63
+ private operation;
64
+ private current;
65
+ private owned;
66
+ private dropPending;
67
+ private checkReady;
68
+ private serial;
69
+ private readCatalog;
70
+ private load;
71
+ private persist;
72
+ }
73
+ //# sourceMappingURL=ScheduleService.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"ScheduleService.d.ts","sourceRoot":"","sources":["../../src/scheduling/ScheduleService.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAA6C,mBAAmB,EAAE,sBAAsB,EAClG,gBAAgB,EAAE,aAAa,EAAE,cAAc,EAAgB,MAAM,SAAS,CAAC;AAIjF,eAAO,MAAM,qBAAqB,0BAA0B,CAAC;AAO7D,MAAM,WAAW,sBAAsB;IACrC,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,sBAAsB,CAAC;IACjC,yFAAyF;IACzF,OAAO,EAAE,CAAC,QAAQ,EAAE,gBAAgB,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACvD,cAAc,EAAE,CAAC,KAAK,EAAE,aAAa,KAAK,OAAO,CAAC;IAClD,GAAG,CAAC,EAAE,MAAM,MAAM,CAAC;IACnB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B,yBAAyB,CAAC,EAAE,MAAM,CAAC;CACpC;AA8DD;;;;;GAKG;AACH,qBAAa,eAAe;IAC1B,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAyB;IACjD,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;IACpC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;IACpC,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAS;IACxC,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAe;IACnC,OAAO,CAAC,OAAO,CAAqC;IACpD,OAAO,CAAC,OAAO,CAAsC;IACrD,OAAO,CAAC,QAAQ,CAA8B;IAC9C,OAAO,CAAC,IAAI,CAAuC;IACnD,OAAO,CAAC,YAAY,CAAuC;IAC3D,OAAO,CAAC,KAAK,CAA+B;IAC5C,OAAO,CAAC,UAAU,CAA+B;IACjD,OAAO,CAAC,cAAc,CAAC,CAAgB;IACvC,OAAO,CAAC,WAAW,CAAS;IAC5B,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,WAAW,CAAC,CAAgB;IACpC,OAAO,CAAC,KAAK,CAAC,CAAQ;IACtB,OAAO,CAAC,WAAW,CAAM;gBAEb,OAAO,EAAE,sBAAsB;IAc3C,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAqB3B,MAAM,CAAC,KAAK,EAAE,aAAa,EAAE,KAAK,EAAE,mBAAmB,GAAG,OAAO,CAAC,cAAc,CAAC;YAInE,cAAc;IAgE5B,wEAAwE;IAClE,IAAI,CAAC,KAAK,EAAE,aAAa,GAAG,OAAO,CAAC,cAAc,EAAE,CAAC;IAK3D,6EAA6E;IAC7E,kBAAkB,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,OAAO;IAK9C,qFAAqF;IACrF,OAAO,CAAC,KAAK,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC;YAI9B,aAAa;IAgC3B,MAAM,CAAC,KAAK,EAAE,aAAa,EAAE,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC;YAInD,cAAc;IAwB5B,yEAAyE;IACnE,eAAe,IAAI,OAAO,CAAC,IAAI,CAAC;IAMtC,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;YA0BV,YAAY;YA+BZ,OAAO;IA+DrB,OAAO,CAAC,iBAAiB;IAoCzB,OAAO,CAAC,IAAI;IAqBZ,OAAO,CAAC,UAAU;IAMlB,OAAO,CAAC,KAAK;IASb,OAAO,CAAC,SAAS;IAMjB,OAAO,CAAC,OAAO;IAIf,OAAO,CAAC,KAAK;IAMb,OAAO,CAAC,WAAW;IAInB,OAAO,CAAC,UAAU;IAKlB,OAAO,CAAC,MAAM;YAMA,WAAW;IA8BzB,OAAO,CAAC,IAAI;YAkCE,OAAO;CAoBtB"}