@minionry/minion 0.7.36

package/dist/server/services/sdk/registry.js

@@ -0,0 +1,597 @@
+// Copyright (c) 2025-present Minionry, Inc.
+// SPDX-License-Identifier: LicenseRef-Minionry-Software
+import { createHash } from 'node:crypto';
+import { agentsSessionsAnswerQuestionHandler, agentsSessionsApproveHandler, agentsSessionsAttachHandler, agentsSessionsCloseHandler, agentsSessionsCreateHandler, agentsSessionsHistoryHandler, agentsSessionsListHandler, agentsSessionsPromptHandler, agentsSessionsRenameHandler, agentsSessionsReplayHandler, agentsSessionsStopHandler, } from './agent-sessions.js';
+import { agentsResultHandler, agentsRunAdmit, agentsRunBouncerInput, agentsRunHandler, resolveAgentsRunScopes, sdkCancelHandler, } from './agents.js';
+import { toolsRegisterHandler, toolsResultHandler } from './app-tools.js';
+import { browserAutomateApproveHandler, browserAutomateHandler, browserBackHandler, browserCloseHandler, browserEvaluateHandler, browserForwardHandler, browserNavigateHandler, browserOpenHandler, browserPreflightHandler, browserReloadHandler, browserResumeDriverHandler, browserScreenshotHandler, browserSelectHandler, browserSetDeviceProfileHandler, browserSnapshotHandler, browserStopHandler, browserTabsListHandler, browserTabsSubscribeHandler, browserViewAnswerHandler, browserViewAttachHandler, browserViewBoundsHandler, browserViewIceHandler, browserViewInputHandler, browserViewStateHandler, } from './browser.js';
+import { composerAutocompleteHandler, composerSettingsHandler, composerSkillsHandler, composerSnippetsHandler, } from './composer.js';
+import { runConnect } from './connect.js';
+import { endpointsListHandler, endpointsRegisterBouncerInput, endpointsRegisterHandler, endpointsUnregisterHandler, } from './endpoints.js';
+import { filesDefinitionHandler, filesSearchHandler, filesSubscribeChangesHandler } from './files-search.js';
+import { filesDownloadCancelHandler, filesDownloadChunkHandler, filesDownloadStartHandler, filesUploadCancelHandler, filesUploadChunkHandler, filesUploadStartHandler, filesUploadStatusHandler, } from './files-transfer.js';
+import { filesDeleteRoutedHandler, filesListRoutedHandler, filesMkdirRoutedHandler, filesReadEntryRoutedHandler, filesReadRoutedHandler, filesRenameRoutedHandler, filesWriteRoutedHandler, resolveFilesReadScopes, resolveFilesWriteScopes, } from './files-workspace.js';
+import { gitBranchesCreateHandler, gitBranchesDeleteHandler, gitBranchesListHandler, gitCheckoutHandler, gitCommitDiffHandler, gitCommitHandler, gitDiffHandler, gitGenerateCommitMessageHandler, gitLogHandler, gitMergeAbortHandler, gitMergeCompleteHandler, gitMergeDiscardBlockersHandler, gitMergePreviewHandler, gitMergeRunHandler, gitMergeStashPopHandler, gitPrCreateHandler, gitPrGenerateDescriptionHandler, gitPullHandler, gitPushHandler, gitRemoteInfoHandler, gitReposDiscoverHandler, gitShowHandler, gitStageHandler, gitStatusHandler, gitSubscribeBranchChangedHandler, gitSubscribeCommitSuggestionHandler, gitTagsCreateHandler, gitTagsListHandler, gitTagsPushHandler, gitUnstageHandler, gitWorktreesCreateHandler, gitWorktreesListHandler, gitWorktreesRemoveHandler, gitWorktreesSubscribeHandler, gitWorktreesSwitchActiveHandler, } from './git.js';
+import { auditRecentHandler, listGrantsHandler } from './host-ops.js';
+import { inferenceBouncerInput, inferenceChatHandler, inferenceResultHandler } from './inference.js';
+import { getLiveSubscriptionsForApp } from './live-registry.js';
+import { pmCreateBoardHandler, pmCreateIssueHandler, pmDeleteIssueHandler, pmGetBoardHandler, pmListBoardsHandler, pmOnBoardUpdateHandler, pmUpdateBoardHandler, pmUpdateIssueHandler, } from './pm.js';
+import { pmExecuteHandler, pmPauseHandler, pmResumeHandler, pmStopHandler } from './pm-execute.js';
+import { pmSchedulesCreateHandler, pmSchedulesDeleteHandler, pmSchedulesListHandler, pmSchedulesUpdateHandler, } from './pm-schedule.js';
+import { qualityCancelHandler, qualityDetectToolsHandler, qualityInstallToolsHandler, qualityResultHandler, qualityRunHandler, qualitySaveDirectoriesHandler, qualitySetFindingStateHandler, qualitySetSettingsHandler, qualitySettingsHandler, qualityStateHandler, qualitySubscribeChangesHandler, } from './quality.js';
+import { qualitySchedulesCreateHandler, qualitySchedulesDeleteHandler, qualitySchedulesListHandler, qualitySchedulesUpdateHandler, } from './quality-schedule.js';
+import { dropSubscription, revokeGrantsHandler } from './revoke.js';
+import { storageDeleteHandler, storageGetHandler, storageKeysHandler, storageSetHandler, } from './storage.js';
+import { sdkStreamResumeHandler } from './streams.js';
+import { terminalAttachHandler, terminalCloseHandler, terminalOpenHandler, terminalResizeHandler, terminalSessionsListHandler, terminalSessionsSubscribeHandler, terminalWriteHandler, } from './terminal.js';
+export const SDK_WRITE_CAPABILITY = {
+    sdkAgentRun: 'execute',
+    sdkPmWrite: 'editPlan',
+    sdkPmExecute: 'editPlan',
+    sdkPmSchedule: 'editPlan',
+    sdkFilesWrite: 'editFiles',
+    sdkStorageWrite: 'editFiles',
+    sdkCancel: 'execute',
+    sdkRevoke: 'editSettings',
+    sdkAgentSession: 'execute',
+    sdkAgentInteract: 'execute',
+    sdkGitWrite: 'git',
+    sdkTerminalWrite: 'terminal',
+    sdkToolsServe: 'execute',
+    sdkQualityWrite: 'editSettings',
+    sdkBrowserWrite: 'driveBrowser',
+    sdkInferenceRun: 'execute',
+    sdkEndpointsWrite: 'editSettings',
+};
+export class SdkMethodError extends Error {
+    code;
+    constructor(code, message) {
+        super(message);
+        this.name = 'SdkMethodError';
+        this.code = code;
+    }
+}
+export const SDK_GRANTLESS_METHODS = new Set([
+    'connect',
+    'features',
+    'disconnect',
+    'grants.revoke',
+    'grants.list',
+    'audit.recent',
+    'theme.get',
+    'locale.get',
+    'notifications.status',
+    'notifications.revoke',
+]);
+function sdkFeaturesHandler() {
+    return [
+        'agents',
+        'pm',
+        'files',
+        'storage',
+        'role',
+        'streamResume',
+        'theme',
+        'agentsRichStream',
+        'appTools',
+        'quality',
+        'locale',
+        'browser',
+        'browserAutomate',
+        'browserView',
+        'browserOps',
+        'inference',
+        'appEndpoints',
+        'agentsAppEndpoint',
+        'qualityFindingState',
+        'agentsModelSelection',
+        'qualitySchedules',
+    ];
+}
+function notificationsUnsupportedHandler() {
+    throw new SdkMethodError('UNSUPPORTED', 'push notifications are not available from this host surface — use the app inside the Minionry shell');
+}
+function sdkThemeGetHandler() {
+    return {
+        mode: 'light',
+        tokens: {
+            background: '#faf9f5',
+            surface: '#f0efe8',
+            foreground: '#141413',
+            foregroundMuted: '#6b6a68',
+            accent: '#ae5630',
+            border: 'rgba(20, 20, 19, 0.1)',
+        },
+    };
+}
+function sdkLocaleGetHandler() {
+    return { locale: 'en', dir: 'ltr' };
+}
+function sdkDisconnectHandler(args) {
+    for (const sub of getLiveSubscriptionsForApp(args.appId, args.spaceKey)) {
+        dropSubscription(sub, 'disconnect.subscriptionDropped', 'app called disconnect()');
+    }
+}
+export function deriveSpaceId(spaceKey) {
+    return `space-${createHash('sha256').update(spaceKey, 'utf8').digest('hex').slice(0, 24)}`;
+}
+export const SDK_METHOD_REGISTRY = {
+    connect: { scopes: [], type: 'sdkConnect', handler: runConnect },
+    features: { scopes: [], type: 'sdkRequest', handler: sdkFeaturesHandler },
+    disconnect: { scopes: [], type: 'sdkRequest', handler: sdkDisconnectHandler },
+    'theme.get': { scopes: [], type: 'sdkRequest', handler: sdkThemeGetHandler },
+    'locale.get': { scopes: [], type: 'sdkRequest', handler: sdkLocaleGetHandler },
+    'notifications.request': { scopes: ['notifications'], type: 'sdkRequest', handler: notificationsUnsupportedHandler },
+    'notifications.status': { scopes: [], type: 'sdkRequest', handler: notificationsUnsupportedHandler },
+    'notifications.revoke': { scopes: [], type: 'sdkRequest', handler: notificationsUnsupportedHandler },
+    'browser.tabs.list': {
+        scopes: ['browser:read'],
+        type: 'sdkRequest',
+        handler: browserTabsListHandler,
+        bouncerToolName: 'browser_tabs',
+    },
+    'browser.tabs.subscribe': {
+        scopes: ['browser:read'],
+        type: 'sdkRequest',
+        handler: browserTabsSubscribeHandler,
+        bouncerToolName: 'browser_tabs',
+    },
+    'browser.navigate': {
+        scopes: ['browser:control'],
+        type: 'sdkBrowserWrite',
+        handler: browserNavigateHandler,
+        bouncerToolName: 'browser_navigate',
+    },
+    'browser.open': {
+        scopes: ['browser:control'],
+        type: 'sdkBrowserWrite',
+        handler: browserOpenHandler,
+        bouncerToolName: 'browser_tab_new',
+    },
+    'browser.close': {
+        scopes: ['browser:control'],
+        type: 'sdkBrowserWrite',
+        handler: browserCloseHandler,
+        bouncerToolName: 'browser_tab_close',
+    },
+    'browser.select': {
+        scopes: ['browser:control'],
+        type: 'sdkBrowserWrite',
+        handler: browserSelectHandler,
+        bouncerToolName: 'browser_tab_select',
+    },
+    'browser.snapshot': {
+        scopes: ['browser:control'],
+        type: 'sdkBrowserWrite',
+        handler: browserSnapshotHandler,
+        bouncerToolName: 'browser_snapshot',
+    },
+    'browser.screenshot': {
+        scopes: ['browser:control'],
+        type: 'sdkBrowserWrite',
+        handler: browserScreenshotHandler,
+        bouncerToolName: 'browser_take_screenshot',
+    },
+    'browser.evaluate': {
+        scopes: ['browser:control'],
+        type: 'sdkBrowserWrite',
+        handler: browserEvaluateHandler,
+        bouncerToolName: 'browser_evaluate',
+    },
+    'browser.automate': {
+        scopes: ['browser:control'],
+        type: 'sdkBrowserWrite',
+        handler: browserAutomateHandler,
+    },
+    'browser.automate.approve': {
+        scopes: ['browser:control'],
+        type: 'sdkBrowserWrite',
+        handler: browserAutomateApproveHandler,
+    },
+    'browser.back': {
+        scopes: ['browser:control'],
+        type: 'sdkBrowserWrite',
+        handler: browserBackHandler,
+        bouncerToolName: 'browser_back',
+    },
+    'browser.forward': {
+        scopes: ['browser:control'],
+        type: 'sdkBrowserWrite',
+        handler: browserForwardHandler,
+        bouncerToolName: 'browser_forward',
+    },
+    'browser.reload': {
+        scopes: ['browser:control'],
+        type: 'sdkBrowserWrite',
+        handler: browserReloadHandler,
+        bouncerToolName: 'browser_reload',
+    },
+    'browser.stop': {
+        scopes: ['browser:control'],
+        type: 'sdkBrowserWrite',
+        handler: browserStopHandler,
+    },
+    'browser.view.attach': {
+        scopes: ['browser:control'],
+        type: 'sdkBrowserWrite',
+        handler: browserViewAttachHandler,
+    },
+    'browser.view.answer': {
+        scopes: ['browser:control'],
+        type: 'sdkBrowserWrite',
+        handler: browserViewAnswerHandler,
+    },
+    'browser.view.ice': {
+        scopes: ['browser:control'],
+        type: 'sdkBrowserWrite',
+        handler: browserViewIceHandler,
+    },
+    'browser.view.state': {
+        scopes: ['browser:control'],
+        type: 'sdkBrowserWrite',
+        handler: browserViewStateHandler,
+    },
+    'browser.view.input': {
+        scopes: ['browser:control'],
+        type: 'sdkBrowserWrite',
+        handler: browserViewInputHandler,
+    },
+    'browser.view.bounds': {
+        scopes: ['browser:control'],
+        type: 'sdkBrowserWrite',
+        handler: browserViewBoundsHandler,
+    },
+    'browser.preflight': {
+        scopes: ['browser:read'],
+        type: 'sdkRequest',
+        handler: browserPreflightHandler,
+    },
+    'browser.resumeDriver': {
+        scopes: ['browser:control'],
+        type: 'sdkBrowserWrite',
+        handler: browserResumeDriverHandler,
+    },
+    'browser.setDeviceProfile': {
+        scopes: ['browser:control'],
+        type: 'sdkBrowserWrite',
+        handler: browserSetDeviceProfileHandler,
+    },
+    'composer.autocomplete': { scopes: ['files:workspace:read'], type: 'sdkRequest', handler: composerAutocompleteHandler },
+    'composer.skills': { scopes: ['settings:read'], type: 'sdkRequest', handler: composerSkillsHandler },
+    'composer.snippets': { scopes: ['settings:read'], type: 'sdkRequest', handler: composerSnippetsHandler },
+    'composer.settings': { scopes: ['settings:read'], type: 'sdkRequest', handler: composerSettingsHandler },
+    'pm.getBoard': { scopes: ['pm:read'], type: 'sdkRequest', handler: pmGetBoardHandler },
+    'pm.listBoards': { scopes: ['pm:read'], type: 'sdkRequest', handler: pmListBoardsHandler },
+    'pm.subscribeBoard': { scopes: ['pm:read'], type: 'sdkRequest', handler: pmOnBoardUpdateHandler },
+    'pm.schedules.list': { scopes: ['pm:schedule'], type: 'sdkRequest', handler: pmSchedulesListHandler },
+    'agents.result': { scopes: ['agents:run'], type: 'sdkRequest', handler: agentsResultHandler },
+    'inference.result': { scopes: ['inference:run'], type: 'sdkRequest', handler: inferenceResultHandler },
+    'endpoints.list': { scopes: ['endpoints:register'], type: 'sdkRequest', handler: endpointsListHandler },
+    'files.read': {
+        scopes: ['files:app'],
+        resolveScopes: resolveFilesReadScopes,
+        type: 'sdkRequest',
+        handler: filesReadRoutedHandler,
+    },
+    'files.list': {
+        scopes: ['files:app'],
+        resolveScopes: resolveFilesReadScopes,
+        type: 'sdkRequest',
+        handler: filesListRoutedHandler,
+    },
+    'files.readEntry': {
+        scopes: ['files:app'],
+        resolveScopes: resolveFilesReadScopes,
+        type: 'sdkRequest',
+        handler: filesReadEntryRoutedHandler,
+    },
+    'files.search': {
+        scopes: ['files:app'],
+        resolveScopes: resolveFilesReadScopes,
+        type: 'sdkRequest',
+        handler: filesSearchHandler,
+    },
+    'files.definition': {
+        scopes: ['files:app'],
+        resolveScopes: resolveFilesReadScopes,
+        type: 'sdkRequest',
+        handler: filesDefinitionHandler,
+    },
+    'files.subscribeChanges': {
+        scopes: ['files:app'],
+        resolveScopes: resolveFilesReadScopes,
+        type: 'sdkRequest',
+        handler: filesSubscribeChangesHandler,
+    },
+    'files.uploadStatus': { scopes: [], type: 'sdkRequest', handler: filesUploadStatusHandler },
+    'files.downloadStart': {
+        scopes: ['files:app'],
+        resolveScopes: resolveFilesReadScopes,
+        type: 'sdkRequest',
+        handler: filesDownloadStartHandler,
+    },
+    'files.downloadChunk': { scopes: [], type: 'sdkRequest', handler: filesDownloadChunkHandler },
+    'files.downloadCancel': { scopes: [], type: 'sdkRequest', handler: filesDownloadCancelHandler },
+    'storage.get': { scopes: ['storage'], type: 'sdkRequest', handler: storageGetHandler },
+    'storage.keys': { scopes: ['storage'], type: 'sdkRequest', handler: storageKeysHandler },
+    'grants.list': { scopes: [], type: 'sdkRequest', handler: listGrantsHandler },
+    'audit.recent': { scopes: [], type: 'sdkRequest', handler: auditRecentHandler },
+    'agents.sessions.list': { scopes: ['agents:sessions'], type: 'sdkRequest', handler: agentsSessionsListHandler },
+    'agents.sessions.attach': { scopes: ['agents:sessions'], type: 'sdkRequest', handler: agentsSessionsAttachHandler },
+    'agents.sessions.history': { scopes: ['agents:sessions'], type: 'sdkRequest', handler: agentsSessionsHistoryHandler },
+    'agents.sessions.replay': { scopes: ['agents:sessions'], type: 'sdkRequest', handler: agentsSessionsReplayHandler },
+    'stream.resume': { scopes: [], type: 'sdkRequest', handler: sdkStreamResumeHandler },
+    'git.status': { scopes: ['git:read'], type: 'sdkRequest', handler: gitStatusHandler },
+    'git.log': { scopes: ['git:read'], type: 'sdkRequest', handler: gitLogHandler },
+    'git.diff': { scopes: ['git:read'], type: 'sdkRequest', handler: gitDiffHandler },
+    'git.show': { scopes: ['git:read'], type: 'sdkRequest', handler: gitShowHandler },
+    'git.commitDiff': { scopes: ['git:read'], type: 'sdkRequest', handler: gitCommitDiffHandler },
+    'git.branches.list': { scopes: ['git:read'], type: 'sdkRequest', handler: gitBranchesListHandler },
+    'git.tags.list': { scopes: ['git:read'], type: 'sdkRequest', handler: gitTagsListHandler },
+    'git.remote.info': { scopes: ['git:read'], type: 'sdkRequest', handler: gitRemoteInfoHandler },
+    'git.repos.discover': { scopes: ['git:read'], type: 'sdkRequest', handler: gitReposDiscoverHandler },
+    'git.worktrees.list': { scopes: ['git:read'], type: 'sdkRequest', handler: gitWorktreesListHandler },
+    'git.merge.preview': { scopes: ['git:read'], type: 'sdkRequest', handler: gitMergePreviewHandler },
+    'git.pr.generateDescription': {
+        scopes: ['git:read'],
+        type: 'sdkRequest',
+        handler: gitPrGenerateDescriptionHandler,
+        bouncerToolName: 'git_pr_generate_description',
+    },
+    'git.subscribeBranchChanged': { scopes: ['git:read'], type: 'sdkRequest', handler: gitSubscribeBranchChangedHandler },
+    'git.subscribeCommitSuggestion': { scopes: ['git:read'], type: 'sdkRequest', handler: gitSubscribeCommitSuggestionHandler },
+    'git.worktrees.subscribe': { scopes: ['git:read'], type: 'sdkRequest', handler: gitWorktreesSubscribeHandler },
+    'terminal.sessions.list': { scopes: ['terminal:read'], type: 'sdkRequest', handler: terminalSessionsListHandler },
+    'terminal.sessions.subscribe': { scopes: ['terminal:read'], type: 'sdkRequest', handler: terminalSessionsSubscribeHandler },
+    'terminal.attach': { scopes: ['terminal:read'], type: 'sdkRequest', handler: terminalAttachHandler },
+    'quality.state': { scopes: ['quality:read'], type: 'sdkRequest', handler: qualityStateHandler },
+    'quality.detectTools': { scopes: ['quality:read'], type: 'sdkRequest', handler: qualityDetectToolsHandler },
+    'quality.result': { scopes: ['quality:read'], type: 'sdkRequest', handler: qualityResultHandler },
+    'quality.settings': { scopes: ['quality:read'], type: 'sdkRequest', handler: qualitySettingsHandler },
+    'quality.subscribeChanges': { scopes: ['quality:read'], type: 'sdkRequest', handler: qualitySubscribeChangesHandler },
+    'quality.schedules.list': { scopes: ['quality:read'], type: 'sdkRequest', handler: qualitySchedulesListHandler },
+    'agents.run': {
+        scopes: ['agents:run'],
+        resolveScopes: resolveAgentsRunScopes,
+        type: 'sdkAgentRun',
+        handler: agentsRunHandler,
+        admit: agentsRunAdmit,
+        bouncerInput: agentsRunBouncerInput,
+    },
+    'pm.createBoard': { scopes: ['pm:write'], type: 'sdkPmWrite', handler: pmCreateBoardHandler },
+    'pm.createIssue': { scopes: ['pm:write'], type: 'sdkPmWrite', handler: pmCreateIssueHandler },
+    'pm.updateIssue': { scopes: ['pm:write'], type: 'sdkPmWrite', handler: pmUpdateIssueHandler },
+    'pm.deleteIssue': { scopes: ['pm:write'], type: 'sdkPmWrite', handler: pmDeleteIssueHandler },
+    'pm.updateBoard': { scopes: ['pm:write'], type: 'sdkPmWrite', handler: pmUpdateBoardHandler },
+    'pm.execute': { scopes: ['pm:execute'], type: 'sdkPmExecute', handler: pmExecuteHandler },
+    'pm.pause': { scopes: ['pm:execute'], type: 'sdkPmExecute', handler: pmPauseHandler },
+    'pm.resume': { scopes: ['pm:execute'], type: 'sdkPmExecute', handler: pmResumeHandler },
+    'pm.stop': { scopes: ['pm:execute'], type: 'sdkPmExecute', handler: pmStopHandler },
+    'pm.schedules.create': { scopes: ['pm:schedule'], type: 'sdkPmSchedule', handler: pmSchedulesCreateHandler },
+    'pm.schedules.update': { scopes: ['pm:schedule'], type: 'sdkPmSchedule', handler: pmSchedulesUpdateHandler },
+    'pm.schedules.delete': { scopes: ['pm:schedule'], type: 'sdkPmSchedule', handler: pmSchedulesDeleteHandler },
+    'files.write': {
+        scopes: ['files:app'],
+        resolveScopes: resolveFilesWriteScopes,
+        type: 'sdkFilesWrite',
+        handler: filesWriteRoutedHandler,
+    },
+    'files.delete': {
+        scopes: ['files:app'],
+        resolveScopes: resolveFilesWriteScopes,
+        type: 'sdkFilesWrite',
+        handler: filesDeleteRoutedHandler,
+    },
+    'files.mkdir': {
+        scopes: ['files:app'],
+        resolveScopes: resolveFilesWriteScopes,
+        type: 'sdkFilesWrite',
+        handler: filesMkdirRoutedHandler,
+    },
+    'files.rename': {
+        scopes: ['files:app'],
+        resolveScopes: resolveFilesWriteScopes,
+        type: 'sdkFilesWrite',
+        handler: filesRenameRoutedHandler,
+    },
+    'files.uploadStart': {
+        scopes: ['files:app'],
+        resolveScopes: resolveFilesWriteScopes,
+        type: 'sdkFilesWrite',
+        handler: filesUploadStartHandler,
+    },
+    'files.uploadChunk': { scopes: [], type: 'sdkFilesWrite', handler: filesUploadChunkHandler },
+    'files.uploadCancel': { scopes: [], type: 'sdkFilesWrite', handler: filesUploadCancelHandler },
+    'storage.set': { scopes: ['storage'], type: 'sdkStorageWrite', handler: storageSetHandler },
+    'storage.delete': { scopes: ['storage'], type: 'sdkStorageWrite', handler: storageDeleteHandler },
+    'agents.sessions.create': { scopes: ['agents:sessions'], type: 'sdkAgentSession', handler: agentsSessionsCreateHandler },
+    'agents.sessions.close': { scopes: ['agents:sessions'], type: 'sdkAgentSession', handler: agentsSessionsCloseHandler },
+    'agents.sessions.rename': { scopes: ['agents:sessions'], type: 'sdkAgentSession', handler: agentsSessionsRenameHandler },
+    'agents.sessions.approve': { scopes: ['agents:sessions'], type: 'sdkAgentInteract', handler: agentsSessionsApproveHandler },
+    'agents.sessions.answerQuestion': {
+        scopes: ['agents:sessions'],
+        type: 'sdkAgentInteract',
+        handler: agentsSessionsAnswerQuestionHandler,
+    },
+    'agents.sessions.prompt': { scopes: ['agents:sessions'], type: 'sdkAgentInteract', handler: agentsSessionsPromptHandler },
+    'agents.sessions.stop': { scopes: ['agents:sessions'], type: 'sdkAgentInteract', handler: agentsSessionsStopHandler },
+    'git.stage': { scopes: ['git:write'], type: 'sdkGitWrite', handler: gitStageHandler, bouncerToolName: 'git_stage' },
+    'git.unstage': { scopes: ['git:write'], type: 'sdkGitWrite', handler: gitUnstageHandler, bouncerToolName: 'git_unstage' },
+    'git.commit': { scopes: ['git:write'], type: 'sdkGitWrite', handler: gitCommitHandler, bouncerToolName: 'git_commit' },
+    'git.generateCommitMessage': {
+        scopes: ['git:write'],
+        type: 'sdkGitWrite',
+        handler: gitGenerateCommitMessageHandler,
+        bouncerToolName: 'git_generate_commit_message',
+    },
+    'git.checkout': { scopes: ['git:write'], type: 'sdkGitWrite', handler: gitCheckoutHandler, bouncerToolName: 'git_checkout' },
+    'git.branches.create': {
+        scopes: ['git:write'],
+        type: 'sdkGitWrite',
+        handler: gitBranchesCreateHandler,
+        bouncerToolName: 'git_branch_create',
+    },
+    'git.branches.delete': {
+        scopes: ['git:write'],
+        type: 'sdkGitWrite',
+        handler: gitBranchesDeleteHandler,
+        bouncerToolName: 'git_branch_delete',
+    },
+    'git.tags.create': { scopes: ['git:write'], type: 'sdkGitWrite', handler: gitTagsCreateHandler, bouncerToolName: 'git_tag_create' },
+    'git.worktrees.create': {
+        scopes: ['git:write'],
+        type: 'sdkGitWrite',
+        handler: gitWorktreesCreateHandler,
+        bouncerToolName: 'git_worktree_create',
+    },
+    'git.worktrees.remove': {
+        scopes: ['git:write'],
+        type: 'sdkGitWrite',
+        handler: gitWorktreesRemoveHandler,
+        bouncerToolName: 'git_worktree_remove',
+    },
+    'git.worktrees.switchActive': {
+        scopes: ['git:write'],
+        type: 'sdkGitWrite',
+        handler: gitWorktreesSwitchActiveHandler,
+        bouncerToolName: 'git_worktree_switch',
+    },
+    'git.merge.run': { scopes: ['git:write'], type: 'sdkGitWrite', handler: gitMergeRunHandler, bouncerToolName: 'git_merge_run' },
+    'git.merge.abort': { scopes: ['git:write'], type: 'sdkGitWrite', handler: gitMergeAbortHandler, bouncerToolName: 'git_merge_abort' },
+    'git.merge.complete': {
+        scopes: ['git:write'],
+        type: 'sdkGitWrite',
+        handler: gitMergeCompleteHandler,
+        bouncerToolName: 'git_merge_complete',
+    },
+    'git.merge.stashPop': {
+        scopes: ['git:write'],
+        type: 'sdkGitWrite',
+        handler: gitMergeStashPopHandler,
+        bouncerToolName: 'git_merge_stash_pop',
+    },
+    'git.merge.discardBlockers': {
+        scopes: ['git:write'],
+        type: 'sdkGitWrite',
+        handler: gitMergeDiscardBlockersHandler,
+        bouncerToolName: 'git_merge_discard_blockers',
+    },
+    'git.push': { scopes: ['git:remote'], type: 'sdkGitWrite', handler: gitPushHandler, bouncerToolName: 'git_push' },
+    'git.pull': { scopes: ['git:remote'], type: 'sdkGitWrite', handler: gitPullHandler, bouncerToolName: 'git_pull' },
+    'git.tags.push': { scopes: ['git:remote'], type: 'sdkGitWrite', handler: gitTagsPushHandler, bouncerToolName: 'git_tag_push' },
+    'git.pr.create': { scopes: ['git:remote'], type: 'sdkGitWrite', handler: gitPrCreateHandler, bouncerToolName: 'git_pr_create' },
+    'terminal.open': { scopes: ['terminal:exec'], type: 'sdkTerminalWrite', handler: terminalOpenHandler, bouncerToolName: 'terminal_open' },
+    'terminal.write': { scopes: ['terminal:exec'], type: 'sdkTerminalWrite', handler: terminalWriteHandler, bouncerToolName: 'terminal_input' },
+    'terminal.resize': { scopes: ['terminal:exec'], type: 'sdkTerminalWrite', handler: terminalResizeHandler, bouncerToolName: 'terminal_resize' },
+    'terminal.close': { scopes: ['terminal:exec'], type: 'sdkTerminalWrite', handler: terminalCloseHandler, bouncerToolName: 'terminal_close' },
+    'tools.register': { scopes: ['tools:serve'], type: 'sdkToolsServe', handler: toolsRegisterHandler },
+    'tools.result': { scopes: ['tools:serve'], type: 'sdkToolsServe', handler: toolsResultHandler },
+    'quality.run': {
+        scopes: ['quality:run'],
+        type: 'sdkQualityWrite',
+        handler: qualityRunHandler,
+        bouncerToolName: 'quality_run',
+    },
+    'quality.cancel': {
+        scopes: ['quality:run'],
+        type: 'sdkQualityWrite',
+        handler: qualityCancelHandler,
+        bouncerToolName: 'quality_cancel',
+    },
+    'quality.installTools': {
+        scopes: ['quality:run'],
+        type: 'sdkQualityWrite',
+        handler: qualityInstallToolsHandler,
+        bouncerToolName: 'quality_install_tools',
+    },
+    'quality.saveDirectories': {
+        scopes: ['quality:run'],
+        type: 'sdkQualityWrite',
+        handler: qualitySaveDirectoriesHandler,
+        bouncerToolName: 'quality_save_directories',
+    },
+    'quality.setSettings': {
+        scopes: ['quality:run'],
+        type: 'sdkQualityWrite',
+        handler: qualitySetSettingsHandler,
+        bouncerToolName: 'quality_set_settings',
+    },
+    'inference.chat': {
+        scopes: ['inference:run'],
+        type: 'sdkInferenceRun',
+        handler: inferenceChatHandler,
+        bouncerInput: inferenceBouncerInput,
+    },
+    'endpoints.register': {
+        scopes: ['endpoints:register'],
+        type: 'sdkEndpointsWrite',
+        handler: endpointsRegisterHandler,
+        bouncerInput: endpointsRegisterBouncerInput,
+    },
+    'endpoints.unregister': { scopes: ['endpoints:register'], type: 'sdkEndpointsWrite', handler: endpointsUnregisterHandler },
+    'quality.setFindingState': {
+        scopes: ['quality:run'],
+        type: 'sdkQualityWrite',
+        handler: qualitySetFindingStateHandler,
+        bouncerToolName: 'quality_set_finding_state',
+    },
+    'quality.schedules.create': {
+        scopes: ['quality:run'],
+        type: 'sdkQualityWrite',
+        handler: qualitySchedulesCreateHandler,
+        bouncerToolName: 'quality_schedule_create',
+    },
+    'quality.schedules.update': {
+        scopes: ['quality:run'],
+        type: 'sdkQualityWrite',
+        handler: qualitySchedulesUpdateHandler,
+        bouncerToolName: 'quality_schedule_update',
+    },
+    'quality.schedules.delete': {
+        scopes: ['quality:run'],
+        type: 'sdkQualityWrite',
+        handler: qualitySchedulesDeleteHandler,
+        bouncerToolName: 'quality_schedule_delete',
+    },
+    cancel: { scopes: [], type: 'sdkCancel', handler: sdkCancelHandler },
+    'grants.revoke': { scopes: [], type: 'sdkRevoke', handler: revokeGrantsHandler },
+};
+export const SDK_READ_METHODS = new Set(Object.entries(SDK_METHOD_REGISTRY)
+    .filter(([, row]) => row.type === 'sdkRequest')
+    .map(([method]) => method));
+export function resolveSdkMethod(wireType, envelopeMethod) {
+    if (wireType === 'sdkRequest') {
+        const method = envelopeMethod ?? '';
+        const row = SDK_METHOD_REGISTRY[method];
+        if (row && row.type === 'sdkRequest')
+            return { ok: true, method, row };
+        if (row) {
+            return {
+                ok: false,
+                message: `'${method}' is not a registered read method — sdkRequest carries reads only (D6); mutating methods use their dedicated message type`,
+            };
+        }
+        return { ok: false, message: `'${method}' is not a registered sdk method (fail closed)` };
+    }
+    const candidates = Object.entries(SDK_METHOD_REGISTRY).filter(([, row]) => row.type === wireType);
+    if (candidates.length === 0) {
+        return { ok: false, message: `unknown sdk message type: ${wireType} (fail closed)` };
+    }
+    if (envelopeMethod !== undefined) {
+        const hit = candidates.find(([method]) => method === envelopeMethod);
+        if (!hit) {
+            return {
+                ok: false,
+                message: `'${envelopeMethod}' does not ride ${wireType} — the write-type split is fixed by the method registry (D6)`,
+            };
+        }
+        return { ok: true, method: hit[0], row: hit[1] };
+    }
+    if (candidates.length === 1) {
+        return { ok: true, method: candidates[0][0], row: candidates[0][1] };
+    }
+    return {
+        ok: false,
+        message: `${wireType} carries multiple methods (${candidates.map(([method]) => method).join(', ')}) — the envelope must name one`,
+    };
+}