@minionry/sdk 0.4.23 → 0.5.2

package/dist/index.d.ts

@@ -3,7 +3,7 @@ export * from './transport.js';
 export * from './protocol.js';
 export { createProvider } from './provider.js';
 export { createMockTransport, mock } from './transports/mock.js';
-export type { MockConfig, MockToolCallOptions, MockToolsController, MockToolSummary, } from './transports/mock.js';
+export type { MockChainsController, MockConfig, MockToolCallOptions, MockToolsController, MockToolSummary, } from './transports/mock.js';
 export { connectPostMessage, createPostMessageTransport } from './transports/post-message.js';
 export type { PostMessageTransportOptions } from './transports/post-message.js';
 export { installKeyboardForwarding } from './keyboard.js';
@@ -12,5 +12,5 @@ export { announceProvider, detect } from './detect.js';
 export type { DetectOptions } from './detect.js';
 export { createOfflineCache } from './cache.js';
 export type { OfflineCache, OfflineCacheEntry, OfflineCacheOptions, SwrOptions } from './cache.js';
-export declare const SDK_VERSION = "0.4.23";
+export declare const SDK_VERSION = "0.5.2";
 export declare const PROVIDER_API_VERSION = "1";

package/dist/index.js

@@ -7,5 +7,5 @@ export { connectPostMessage, createPostMessageTransport } from './transports/pos
 export { installKeyboardForwarding } from './keyboard.js';
 export { announceProvider, detect } from './detect.js';
 export { createOfflineCache } from './cache.js';
-export const SDK_VERSION = '0.4.23';
+export const SDK_VERSION = '0.5.2';
 export const PROVIDER_API_VERSION = '1';

package/dist/provider.js

@@ -52,6 +52,15 @@ const APP_ENDPOINTS_FEATURE = 'appEndpoints';
 const AGENTS_APP_ENDPOINT_FEATURE = 'agentsAppEndpoint';
 const AGENT_RUN_APP_ENDPOINT_FIELDS = ['model', 'systemPrompt', 'budget', 'sessionId'];
 const AGENTS_MODEL_SELECTION_FEATURE = 'agentsModelSelection';
+const AGENTS_ENGINE_SELECTION_FEATURE = 'agentsEngineSelection';
+const FILES_CONDITIONAL_WRITE_FEATURE = 'filesConditionalWrite';
+const INFERENCE_FAST_MODE_FEATURE = 'inferenceFastMode';
+const PM_CHAINS_FEATURE = 'pmChains';
+const AGENT_SCHEDULES_FEATURE = 'agentSchedules';
+const SCHEDULE_WALL_CLOCK_FEATURE = 'scheduleWallClock';
+const PM_SCHEDULE_ZIP_FEATURE = 'pmScheduleZip';
+const PM_SCHEDULE_RUN_NOW_FEATURE = 'pmScheduleRunNow';
+const WALL_CLOCK_TIMING_KINDS = new Set(['daily', 'monthly']);
 function deliverStreamFrames(tracker, frames) {
     for (const frame of [...frames].sort((a, b) => a.seq - b.seq)) {
         if (frame.seq <= tracker.lastSeq)
@@ -107,6 +116,14 @@ export function createProvider(transport) {
             throw new MinionryError('UNSUPPORTED', `${what} needs a host that advertises the '${flag}' feature — this host does not, so nothing was sent`);
         }
     };
+    const requireWallClockFeature = async (what, timing, maxLatenessMs) => {
+        if (maxLatenessMs !== undefined) {
+            await requireFeature(SCHEDULE_WALL_CLOCK_FEATURE, `${what} with maxLatenessMs`);
+        }
+        else if (timing !== undefined && WALL_CLOCK_TIMING_KINDS.has(timing.kind)) {
+            await requireFeature(SCHEDULE_WALL_CLOCK_FEATURE, `${what} with ${timing.kind} timing`);
+        }
+    };
     const supportsResume = () => hostFeatures().then((flags) => flags.includes(STREAM_RESUME_FEATURE), () => false);
     const registerStream = (requestId, deliver, onGap) => {
         streams.set(requestId, { lastSeq: 0, resuming: false, pending: [], deliver, onGap });
@@ -304,11 +321,16 @@ export function createProvider(transport) {
                 if (req.modelSelection !== undefined) {
                     await requireFeature(AGENTS_MODEL_SELECTION_FEATURE, 'agents.run with modelSelection');
                 }
+                if (req.engineSelection !== undefined) {
+                    await requireFeature(AGENTS_ENGINE_SELECTION_FEATURE, 'agents.run with engineSelection');
+                }
                 const params = { prompt: req.prompt, title: req.title };
                 for (const field of endpointFields)
                     params[field] = req[field];
                 if (req.modelSelection !== undefined)
                     params.modelSelection = req.modelSelection;
+                if (req.engineSelection !== undefined)
+                    params.engineSelection = req.engineSelection;
                 const requestId = mintRequestId();
                 const runEvents = new Emitter();
                 registerStream(requestId, (event, payload) => runEvents.emit(event, payload), (message) => runEvents.emit('gap', { message }));
@@ -378,6 +400,29 @@ export function createProvider(transport) {
                     await request('agents.sessions.stop', { sessionId });
                 },
             },
+            schedules: {
+                async list() {
+                    await requireFeature(AGENT_SCHEDULES_FEATURE, 'agents.schedules.list');
+                    const result = (await request('agents.schedules.list', {}));
+                    return Array.isArray(result) ? result : result.schedules;
+                },
+                async create(req) {
+                    await requireFeature(AGENT_SCHEDULES_FEATURE, 'agents.schedules.create');
+                    return (await request('agents.schedules.create', req));
+                },
+                async update(scheduleId, patch) {
+                    await requireFeature(AGENT_SCHEDULES_FEATURE, 'agents.schedules.update');
+                    return (await request('agents.schedules.update', { scheduleId, patch }));
+                },
+                async delete(scheduleId) {
+                    await requireFeature(AGENT_SCHEDULES_FEATURE, 'agents.schedules.delete');
+                    await request('agents.schedules.delete', { scheduleId });
+                },
+                async runNow(scheduleId) {
+                    await requireFeature(AGENT_SCHEDULES_FEATURE, 'agents.schedules.runNow');
+                    return (await request('agents.schedules.runNow', { scheduleId }));
+                },
+            },
         },
         apps: {
             async open(req) {
@@ -474,14 +519,42 @@ export function createProvider(transport) {
                     return result.schedules;
                 },
                 async create(req) {
+                    if (req.source?.kind === 'board-zip') {
+                        await requireFeature(PM_SCHEDULE_ZIP_FEATURE, 'pm.schedules.create with a board-zip source');
+                    }
+                    await requireWallClockFeature('pm.schedules.create', req.timing, req.maxLatenessMs);
                     return (await request('pm.schedules.create', req));
                 },
                 async update(scheduleId, patch) {
+                    await requireWallClockFeature('pm.schedules.update', patch.timing, patch.maxLatenessMs);
                     return (await request('pm.schedules.update', { scheduleId, patch }));
                 },
                 async delete(scheduleId) {
                     await request('pm.schedules.delete', { scheduleId });
                 },
+                async runNow(scheduleId) {
+                    await requireFeature(PM_SCHEDULE_RUN_NOW_FEATURE, 'pm.schedules.runNow');
+                    return (await request('pm.schedules.runNow', { scheduleId }));
+                },
+            },
+            chains: {
+                async list() {
+                    await requireFeature(PM_CHAINS_FEATURE, 'pm.chains.list');
+                    const result = (await request('pm.chains.list', {}));
+                    return result.links;
+                },
+                async create(req) {
+                    await requireFeature(PM_CHAINS_FEATURE, 'pm.chains.create');
+                    return (await request('pm.chains.create', req));
+                },
+                async update(linkId, patch) {
+                    await requireFeature(PM_CHAINS_FEATURE, 'pm.chains.update');
+                    return (await request('pm.chains.update', { linkId, patch }));
+                },
+                async delete(linkId) {
+                    await requireFeature(PM_CHAINS_FEATURE, 'pm.chains.delete');
+                    await request('pm.chains.delete', { linkId });
+                },
             },
         },
         files: {
@@ -491,8 +564,14 @@ export function createProvider(transport) {
             async readEntry(path) {
                 return (await request('files.readEntry', { path }));
             },
-            async write(path, content) {
-                await request('files.write', { path, content });
+            async write(path, content, opts) {
+                const expectedModifiedAt = opts?.expectedModifiedAt;
+                if (expectedModifiedAt === undefined) {
+                    await request('files.write', { path, content });
+                    return;
+                }
+                await requireFeature(FILES_CONDITIONAL_WRITE_FEATURE, 'files.write with expectedModifiedAt');
+                await request('files.write', { path, content, expectedModifiedAt });
             },
             async list(path) {
                 return (await request('files.list', { path }));
@@ -547,6 +626,8 @@ export function createProvider(transport) {
                 registerStream(requestId, (event, payload) => {
                     if (active && event === 'changed')
                         cb(payload);
+                    if (active && event === 'gap')
+                        providerEvents.emit('fileChangeGap', { path, ...payload });
                 }, (message) => {
                     if (active)
                         providerEvents.emit('fileChangeGap', { path, message });
@@ -1432,12 +1513,15 @@ export function createProvider(transport) {
                 registerStream(requestId, (event, payload) => runEvents.emit(event, payload), (message) => runEvents.emit('gap', { message }));
                 let runId;
                 try {
+                    const fastMode = req.fastMode === true &&
+                        (await hostFeatures().then((flags) => flags.includes(INFERENCE_FAST_MODE_FEATURE), () => false));
                     const params = {
                         messages: req.messages,
                         system: req.system,
                         engine: req.engine,
                         model: req.model,
                         effortLevel: req.effortLevel,
+                        ...(fastMode ? { fastMode: true } : {}),
                     };
                     runId = (await request('inference.chat', params, requestId)).runId;
                 }

package/dist/transport.d.ts

@@ -1,4 +1,4 @@
-export type SdkMethodName = 'features' | 'connect' | 'disconnect' | 'auth.getToken' | 'agents.run' | 'agents.result' | 'agents.sessions.list' | 'agents.sessions.create' | 'agents.sessions.attach' | 'agents.sessions.close' | 'agents.sessions.rename' | 'agents.sessions.history' | 'agents.sessions.replay' | 'agents.sessions.approve' | 'agents.sessions.answerQuestion' | 'agents.sessions.prompt' | 'agents.sessions.stop' | 'apps.open' | 'cancel' | 'pm.createBoard' | 'pm.getBoard' | 'pm.listBoards' | 'pm.createIssue' | 'pm.updateIssue' | 'pm.deleteIssue' | 'pm.updateBoard' | 'pm.subscribeBoard' | 'pm.execute' | 'pm.pause' | 'pm.resume' | 'pm.stop' | 'pm.schedules.list' | 'pm.schedules.create' | 'pm.schedules.update' | 'pm.schedules.delete' | 'stream.resume' | 'files.read' | 'files.readEntry' | 'files.write' | 'files.list' | 'files.delete' | 'files.mkdir' | 'files.rename' | 'files.search' | 'files.definition' | 'files.subscribeChanges' | 'files.uploadStart' | 'files.uploadChunk' | 'files.uploadStatus' | 'files.uploadCancel' | 'files.downloadStart' | 'files.downloadChunk' | 'files.downloadCancel' | 'storage.get' | 'storage.set' | 'storage.delete' | 'storage.keys' | 'notifications.request' | 'notifications.status' | 'notifications.revoke' | 'theme.get' | 'locale.get' | 'browser.tabs.list' | 'browser.tabs.subscribe' | 'browser.navigate' | 'browser.open' | 'browser.close' | 'browser.select' | 'browser.snapshot' | 'browser.screenshot' | 'browser.evaluate' | 'browser.automate' | 'browser.automate.approve' | 'browser.back' | 'browser.forward' | 'browser.reload' | 'browser.stop' | 'browser.view.attach' | 'browser.view.answer' | 'browser.view.ice' | 'browser.view.state' | 'browser.view.input' | 'browser.view.bounds' | 'browser.preflight' | 'browser.resumeDriver' | 'browser.setDeviceProfile' | 'composer.autocomplete' | 'composer.skills' | 'composer.snippets' | 'composer.settings' | 'terminal.sessions.list' | 'terminal.sessions.subscribe' | 'terminal.open' | 'terminal.attach' | 'terminal.write' | 'terminal.resize' | 'terminal.close' | 'git.status' | 'git.log' | 'git.diff' | 'git.show' | 'git.commitDiff' | 'git.branches.list' | 'git.branches.create' | 'git.branches.delete' | 'git.tags.list' | 'git.tags.create' | 'git.tags.push' | 'git.remote.info' | 'git.repos.discover' | 'git.worktrees.list' | 'git.worktrees.create' | 'git.worktrees.remove' | 'git.worktrees.switchActive' | 'git.worktrees.subscribe' | 'git.merge.preview' | 'git.merge.run' | 'git.merge.abort' | 'git.merge.complete' | 'git.merge.stashPop' | 'git.merge.discardBlockers' | 'git.pr.generateDescription' | 'git.pr.create' | 'git.stage' | 'git.unstage' | 'git.commit' | 'git.generateCommitMessage' | 'git.checkout' | 'git.push' | 'git.pull' | 'git.subscribeBranchChanged' | 'git.subscribeCommitSuggestion' | 'tools.register' | 'tools.result' | 'quality.state' | 'quality.detectTools' | 'quality.result' | 'quality.settings' | 'quality.subscribeChanges' | 'quality.run' | 'quality.cancel' | 'quality.installTools' | 'quality.saveDirectories' | 'quality.setSettings' | 'inference.chat' | 'inference.result' | 'endpoints.register' | 'endpoints.unregister' | 'endpoints.list' | 'quality.setFindingState' | 'quality.schedules.list' | 'quality.schedules.create' | 'quality.schedules.update' | 'quality.schedules.delete';
+export type SdkMethodName = 'features' | 'connect' | 'disconnect' | 'auth.getToken' | 'agents.run' | 'agents.result' | 'agents.sessions.list' | 'agents.sessions.create' | 'agents.sessions.attach' | 'agents.sessions.close' | 'agents.sessions.rename' | 'agents.sessions.history' | 'agents.sessions.replay' | 'agents.sessions.approve' | 'agents.sessions.answerQuestion' | 'agents.sessions.prompt' | 'agents.sessions.stop' | 'agents.schedules.list' | 'agents.schedules.create' | 'agents.schedules.update' | 'agents.schedules.delete' | 'agents.schedules.runNow' | 'apps.open' | 'cancel' | 'pm.createBoard' | 'pm.getBoard' | 'pm.listBoards' | 'pm.createIssue' | 'pm.updateIssue' | 'pm.deleteIssue' | 'pm.updateBoard' | 'pm.subscribeBoard' | 'pm.execute' | 'pm.pause' | 'pm.resume' | 'pm.stop' | 'pm.schedules.list' | 'pm.schedules.create' | 'pm.schedules.update' | 'pm.schedules.delete' | 'pm.schedules.runNow' | 'pm.chains.list' | 'pm.chains.create' | 'pm.chains.update' | 'pm.chains.delete' | 'stream.resume' | 'files.read' | 'files.readEntry' | 'files.write' | 'files.list' | 'files.delete' | 'files.mkdir' | 'files.rename' | 'files.search' | 'files.definition' | 'files.subscribeChanges' | 'files.uploadStart' | 'files.uploadChunk' | 'files.uploadStatus' | 'files.uploadCancel' | 'files.downloadStart' | 'files.downloadChunk' | 'files.downloadCancel' | 'storage.get' | 'storage.set' | 'storage.delete' | 'storage.keys' | 'notifications.request' | 'notifications.status' | 'notifications.revoke' | 'theme.get' | 'locale.get' | 'browser.tabs.list' | 'browser.tabs.subscribe' | 'browser.navigate' | 'browser.open' | 'browser.close' | 'browser.select' | 'browser.snapshot' | 'browser.screenshot' | 'browser.evaluate' | 'browser.automate' | 'browser.automate.approve' | 'browser.back' | 'browser.forward' | 'browser.reload' | 'browser.stop' | 'browser.view.attach' | 'browser.view.answer' | 'browser.view.ice' | 'browser.view.state' | 'browser.view.input' | 'browser.view.bounds' | 'browser.preflight' | 'browser.resumeDriver' | 'browser.setDeviceProfile' | 'composer.autocomplete' | 'composer.skills' | 'composer.snippets' | 'composer.settings' | 'terminal.sessions.list' | 'terminal.sessions.subscribe' | 'terminal.open' | 'terminal.attach' | 'terminal.write' | 'terminal.resize' | 'terminal.close' | 'git.status' | 'git.log' | 'git.diff' | 'git.show' | 'git.commitDiff' | 'git.branches.list' | 'git.branches.create' | 'git.branches.delete' | 'git.tags.list' | 'git.tags.create' | 'git.tags.push' | 'git.remote.info' | 'git.repos.discover' | 'git.worktrees.list' | 'git.worktrees.create' | 'git.worktrees.remove' | 'git.worktrees.switchActive' | 'git.worktrees.subscribe' | 'git.merge.preview' | 'git.merge.run' | 'git.merge.abort' | 'git.merge.complete' | 'git.merge.stashPop' | 'git.merge.discardBlockers' | 'git.pr.generateDescription' | 'git.pr.create' | 'git.stage' | 'git.unstage' | 'git.commit' | 'git.generateCommitMessage' | 'git.checkout' | 'git.push' | 'git.pull' | 'git.subscribeBranchChanged' | 'git.subscribeCommitSuggestion' | 'tools.register' | 'tools.result' | 'quality.state' | 'quality.detectTools' | 'quality.result' | 'quality.settings' | 'quality.subscribeChanges' | 'quality.run' | 'quality.cancel' | 'quality.installTools' | 'quality.saveDirectories' | 'quality.setSettings' | 'inference.chat' | 'inference.result' | 'endpoints.register' | 'endpoints.unregister' | 'endpoints.list' | 'quality.setFindingState' | 'quality.schedules.list' | 'quality.schedules.create' | 'quality.schedules.update' | 'quality.schedules.delete';
 export interface SdkRequestFrame {
     requestId: string;
     method: SdkMethodName;

package/dist/transports/mock.d.ts

@@ -12,6 +12,9 @@ export interface MockToolsController {
     call(tool: string, input?: unknown, opts?: MockToolCallOptions): Promise<unknown>;
     cancel(callId: string): void;
 }
+export interface MockChainsController {
+    settleBoard(boardId: string, outcome: 'success' | 'failure'): void;
+}
 export interface MockConfig {
     space?: Partial<SpaceInfo>;
     user?: Partial<UserInfo> | null;
@@ -21,9 +24,13 @@ export interface MockConfig {
     storage?: Record<string, unknown>;
     theme?: Partial<ThemeSnapshot>;
     locale?: Partial<LocaleSnapshot>;
+    agentRunEngines?: string[] | null;
     tools?: {
         onRegister?(controller: MockToolsController): void;
     };
+    chains?: {
+        onReady?(controller: MockChainsController): void;
+    };
 }
 export declare function createMockTransport(config?: MockConfig): Transport;
 export declare function mock(config?: MockConfig): MinionryProvider;