@pellux/goodvibes-sdk 0.18.14 → 0.18.16

package/dist/_internal/platform/control-plane/method-catalog-media.js

@@ -0,0 +1,248 @@
+import { BOOLEAN_SCHEMA, EMPTY_OBJECT_SCHEMA, NUMBER_SCHEMA, STRING_SCHEMA, bodyEnvelopeSchema, methodDescriptor, objectSchema } from './method-catalog-shared.js';
+import { METADATA_SCHEMA } from './operator-contract-schemas-shared.js';
+import { ARTIFACT_ENTITY_OUTPUT_SCHEMA, ARTIFACT_LIST_OUTPUT_SCHEMA, MEDIA_ANALYZE_REQUEST_SCHEMA, MEDIA_ANALYSIS_RESULT_SCHEMA, MEDIA_GENERATION_REQUEST_SCHEMA, MEDIA_GENERATION_RESULT_SCHEMA, MEDIA_TRANSFORM_REQUEST_SCHEMA, MEDIA_PROVIDERS_OUTPUT_SCHEMA, MEDIA_TRANSFORM_RESULT_SCHEMA, MULTIMODAL_ANALYZE_REQUEST_SCHEMA, MULTIMODAL_ANALYZE_OUTPUT_SCHEMA, MULTIMODAL_PACKET_REQUEST_SCHEMA, MULTIMODAL_PACKET_OUTPUT_SCHEMA, MULTIMODAL_PROVIDERS_OUTPUT_SCHEMA, MULTIMODAL_STATUS_SCHEMA, MULTIMODAL_WRITEBACK_REQUEST_SCHEMA, MULTIMODAL_WRITEBACK_OUTPUT_SCHEMA, VOICE_REALTIME_SESSION_REQUEST_SCHEMA, VOICE_SYNTHESIS_REQUEST_SCHEMA, VOICE_TRANSCRIPTION_REQUEST_SCHEMA, VOICE_PROVIDERS_OUTPUT_SCHEMA, VOICE_REALTIME_SESSION_SCHEMA, VOICE_STATUS_SCHEMA, VOICE_SYNTHESIS_RESULT_SCHEMA, VOICE_TRANSCRIPTION_RESULT_SCHEMA, VOICE_VOICES_OUTPUT_SCHEMA, WEB_SEARCH_PROVIDERS_OUTPUT_SCHEMA, WEB_SEARCH_RESPONSE_SCHEMA, } from './operator-contract-schemas.js';
+export const builtinGatewayMediaMethodDescriptors = [
+    methodDescriptor({
+        id: 'voice.status',
+        title: 'Voice Status',
+        description: 'Return configured voice provider posture and capabilities.',
+        category: 'voice',
+        scopes: ['read:voice'],
+        http: { method: 'GET', path: '/api/voice' },
+        inputSchema: EMPTY_OBJECT_SCHEMA,
+        outputSchema: VOICE_STATUS_SCHEMA,
+    }),
+    methodDescriptor({
+        id: 'voice.providers.list',
+        title: 'List Voice Providers',
+        description: 'Return registered voice providers.',
+        category: 'voice',
+        scopes: ['read:voice'],
+        http: { method: 'GET', path: '/api/voice/providers' },
+        inputSchema: EMPTY_OBJECT_SCHEMA,
+        outputSchema: VOICE_PROVIDERS_OUTPUT_SCHEMA,
+    }),
+    methodDescriptor({
+        id: 'voice.voices.list',
+        title: 'List Voices',
+        description: 'Return registered voices for a voice provider.',
+        category: 'voice',
+        scopes: ['read:voice'],
+        http: { method: 'GET', path: '/api/voice/voices' },
+        inputSchema: objectSchema({ providerId: STRING_SCHEMA }),
+        outputSchema: VOICE_VOICES_OUTPUT_SCHEMA,
+    }),
+    methodDescriptor({
+        id: 'voice.tts',
+        title: 'Run Text To Speech',
+        description: 'Synthesize audio through a registered voice provider.',
+        category: 'voice',
+        scopes: ['write:voice'],
+        http: { method: 'POST', path: '/api/voice/tts' },
+        inputSchema: VOICE_SYNTHESIS_REQUEST_SCHEMA,
+        outputSchema: VOICE_SYNTHESIS_RESULT_SCHEMA,
+    }),
+    methodDescriptor({
+        id: 'voice.stt',
+        title: 'Run Speech To Text',
+        description: 'Transcribe an audio artifact through a registered voice provider.',
+        category: 'voice',
+        scopes: ['write:voice'],
+        http: { method: 'POST', path: '/api/voice/stt' },
+        inputSchema: VOICE_TRANSCRIPTION_REQUEST_SCHEMA,
+        outputSchema: VOICE_TRANSCRIPTION_RESULT_SCHEMA,
+    }),
+    methodDescriptor({
+        id: 'voice.realtime.session',
+        title: 'Open Voice Realtime Session',
+        description: 'Open a realtime voice session through a registered voice provider.',
+        category: 'voice',
+        scopes: ['write:voice'],
+        http: { method: 'POST', path: '/api/voice/realtime/session' },
+        inputSchema: VOICE_REALTIME_SESSION_REQUEST_SCHEMA,
+        outputSchema: VOICE_REALTIME_SESSION_SCHEMA,
+    }),
+    methodDescriptor({
+        id: 'web_search.providers.list',
+        title: 'List Web Search Providers',
+        description: 'Return registered web search provider capabilities.',
+        category: 'web-search',
+        scopes: ['read:web-search'],
+        http: { method: 'GET', path: '/api/web-search/providers' },
+        inputSchema: EMPTY_OBJECT_SCHEMA,
+        outputSchema: WEB_SEARCH_PROVIDERS_OUTPUT_SCHEMA,
+    }),
+    methodDescriptor({
+        id: 'web_search.query',
+        title: 'Run Web Search',
+        description: 'Execute a provider-backed web search and return normalized ranked results.',
+        category: 'web-search',
+        scopes: ['write:web-search'],
+        http: { method: 'POST', path: '/api/web-search/query' },
+        inputSchema: bodyEnvelopeSchema({
+            query: STRING_SCHEMA,
+            providerId: STRING_SCHEMA,
+            maxResults: NUMBER_SCHEMA,
+            verbosity: STRING_SCHEMA,
+            region: STRING_SCHEMA,
+            safeSearch: STRING_SCHEMA,
+            timeRange: STRING_SCHEMA,
+            includeInstantAnswer: BOOLEAN_SCHEMA,
+            includeEvidence: BOOLEAN_SCHEMA,
+            evidenceTopN: NUMBER_SCHEMA,
+            evidenceExtract: STRING_SCHEMA,
+        }, ['query']),
+        outputSchema: WEB_SEARCH_RESPONSE_SCHEMA,
+    }),
+    methodDescriptor({
+        id: 'artifacts.list',
+        title: 'List Artifacts',
+        description: 'Return stored artifact metadata for files and attachments.',
+        category: 'artifacts',
+        scopes: ['read:artifacts'],
+        http: { method: 'GET', path: '/api/artifacts' },
+        inputSchema: EMPTY_OBJECT_SCHEMA,
+        outputSchema: ARTIFACT_LIST_OUTPUT_SCHEMA,
+    }),
+    methodDescriptor({
+        id: 'artifacts.create',
+        title: 'Create Artifact',
+        description: 'Store a file or attachment artifact for later delivery or analysis.',
+        category: 'artifacts',
+        scopes: ['write:artifacts'],
+        http: { method: 'POST', path: '/api/artifacts' },
+        inputSchema: bodyEnvelopeSchema({
+            kind: STRING_SCHEMA,
+            mimeType: STRING_SCHEMA,
+            filename: STRING_SCHEMA,
+            dataBase64: STRING_SCHEMA,
+            text: STRING_SCHEMA,
+            path: STRING_SCHEMA,
+            uri: STRING_SCHEMA,
+            allowPrivateHosts: BOOLEAN_SCHEMA,
+            retentionMs: NUMBER_SCHEMA,
+            metadata: METADATA_SCHEMA,
+        }),
+        outputSchema: ARTIFACT_ENTITY_OUTPUT_SCHEMA,
+    }),
+    methodDescriptor({
+        id: 'artifacts.get',
+        title: 'Get Artifact',
+        description: 'Return metadata for a stored artifact.',
+        category: 'artifacts',
+        scopes: ['read:artifacts'],
+        http: { method: 'GET', path: '/api/artifacts/{artifactId}' },
+        inputSchema: objectSchema({ artifactId: STRING_SCHEMA }, ['artifactId']),
+        outputSchema: ARTIFACT_ENTITY_OUTPUT_SCHEMA,
+    }),
+    methodDescriptor({
+        id: 'artifacts.content.get',
+        title: 'Get Artifact Content',
+        description: 'Return the raw content bytes for a stored artifact.',
+        category: 'artifacts',
+        scopes: ['read:artifacts'],
+        transport: ['http'],
+        http: { method: 'GET', path: '/api/artifacts/{artifactId}/content' },
+        inputSchema: objectSchema({
+            artifactId: STRING_SCHEMA,
+            download: STRING_SCHEMA,
+        }, ['artifactId']),
+        outputSchema: objectSchema({
+            contentType: STRING_SCHEMA,
+            contentLength: NUMBER_SCHEMA,
+        }, ['contentType', 'contentLength']),
+        invokable: false,
+        metadata: { responseKind: 'binary' },
+    }),
+    methodDescriptor({
+        id: 'media.providers.list',
+        title: 'List Media Providers',
+        description: 'Return registered media provider capabilities.',
+        category: 'media',
+        scopes: ['read:media'],
+        http: { method: 'GET', path: '/api/media/providers' },
+        inputSchema: EMPTY_OBJECT_SCHEMA,
+        outputSchema: MEDIA_PROVIDERS_OUTPUT_SCHEMA,
+    }),
+    methodDescriptor({
+        id: 'media.analyze',
+        title: 'Analyze Media Artifact',
+        description: 'Analyze an artifact through a registered media provider.',
+        category: 'media',
+        scopes: ['write:media'],
+        http: { method: 'POST', path: '/api/media/analyze' },
+        inputSchema: MEDIA_ANALYZE_REQUEST_SCHEMA,
+        outputSchema: MEDIA_ANALYSIS_RESULT_SCHEMA,
+    }),
+    methodDescriptor({
+        id: 'media.transform',
+        title: 'Transform Media Artifact',
+        description: 'Transform an artifact through a registered media provider.',
+        category: 'media',
+        scopes: ['write:media'],
+        http: { method: 'POST', path: '/api/media/transform' },
+        inputSchema: MEDIA_TRANSFORM_REQUEST_SCHEMA,
+        outputSchema: MEDIA_TRANSFORM_RESULT_SCHEMA,
+    }),
+    methodDescriptor({
+        id: 'media.generate',
+        title: 'Generate Media Artifact',
+        description: 'Generate a media artifact through a registered media provider.',
+        category: 'media',
+        scopes: ['write:media'],
+        http: { method: 'POST', path: '/api/media/generate' },
+        inputSchema: MEDIA_GENERATION_REQUEST_SCHEMA,
+        outputSchema: MEDIA_GENERATION_RESULT_SCHEMA,
+    }),
+    methodDescriptor({
+        id: 'multimodal.status',
+        title: 'Multimodal Status',
+        description: 'Return the unified multimodal runtime status across image, audio, video, and document analysis.',
+        category: 'media',
+        scopes: ['read:media'],
+        http: { method: 'GET', path: '/api/multimodal' },
+        inputSchema: EMPTY_OBJECT_SCHEMA,
+        outputSchema: MULTIMODAL_STATUS_SCHEMA,
+    }),
+    methodDescriptor({
+        id: 'multimodal.providers.list',
+        title: 'List Multimodal Providers',
+        description: 'Return the normalized multimodal provider catalog spanning media understanding, speech-to-text, and extractors.',
+        category: 'media',
+        scopes: ['read:media'],
+        http: { method: 'GET', path: '/api/multimodal/providers' },
+        inputSchema: EMPTY_OBJECT_SCHEMA,
+        outputSchema: MULTIMODAL_PROVIDERS_OUTPUT_SCHEMA,
+    }),
+    methodDescriptor({
+        id: 'multimodal.analyze',
+        title: 'Run Multimodal Analysis',
+        description: 'Analyze an image, audio file, video artifact, or document through the unified multimodal service.',
+        category: 'media',
+        scopes: ['write:media'],
+        http: { method: 'POST', path: '/api/multimodal/analyze' },
+        inputSchema: MULTIMODAL_ANALYZE_REQUEST_SCHEMA,
+        outputSchema: MULTIMODAL_ANALYZE_OUTPUT_SCHEMA,
+    }),
+    methodDescriptor({
+        id: 'multimodal.packet',
+        title: 'Build Multimodal Packet',
+        description: 'Build a token-efficient packet from an existing multimodal analysis result.',
+        category: 'media',
+        scopes: ['read:media'],
+        http: { method: 'POST', path: '/api/multimodal/packet' },
+        inputSchema: MULTIMODAL_PACKET_REQUEST_SCHEMA,
+        outputSchema: MULTIMODAL_PACKET_OUTPUT_SCHEMA,
+    }),
+    methodDescriptor({
+        id: 'multimodal.writeback',
+        title: 'Write Back Multimodal Analysis',
+        description: 'Persist a multimodal analysis result as an artifact and ingest it into the structured knowledge store.',
+        category: 'media',
+        scopes: ['write:media', 'write:knowledge'],
+        access: 'admin',
+        http: { method: 'POST', path: '/api/multimodal/writeback' },
+        inputSchema: MULTIMODAL_WRITEBACK_REQUEST_SCHEMA,
+        outputSchema: MULTIMODAL_WRITEBACK_OUTPUT_SCHEMA,
+    }),
+];

package/dist/_internal/platform/control-plane/method-catalog-runtime.d.ts

@@ -0,0 +1,3 @@
+import type { GatewayMethodDescriptor } from './method-catalog-shared.js';
+export declare const builtinGatewayRuntimeMethodDescriptors: readonly GatewayMethodDescriptor[];
+//# sourceMappingURL=method-catalog-runtime.d.ts.map

package/dist/_internal/platform/control-plane/method-catalog-runtime.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"method-catalog-runtime.d.ts","sourceRoot":"","sources":["../../../../src/_internal/platform/control-plane/method-catalog-runtime.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,4BAA4B,CAAC;AAyC1E,eAAO,MAAM,sCAAsC,EAAE,SAAS,uBAAuB,EAsQpF,CAAC"}

package/dist/_internal/platform/control-plane/method-catalog-runtime.js

@@ -0,0 +1,265 @@
+import { EMPTY_OBJECT_SCHEMA, STRING_SCHEMA, objectSchema, listOutputSchema, entityOutputSchema, bodyEnvelopeSchema, methodDescriptor, runtimeEventId, } from './method-catalog-shared.js';
+import { CONTINUITY_SNAPSHOT_SCHEMA, DISTRIBUTED_NODE_HOST_CONTRACT_SCHEMA, HEALTH_SNAPSHOT_SCHEMA, INTELLIGENCE_SNAPSHOT_SCHEMA, MEMORY_DOCTOR_REPORT_SCHEMA, MEMORY_VECTOR_STATS_SCHEMA, PROVIDER_ACCOUNT_SNAPSHOT_SCHEMA, PROVIDER_RUNTIME_SNAPSHOT_SCHEMA, PROVIDER_USAGE_SNAPSHOT_SCHEMA, REMOTE_PAIR_APPROVAL_OUTPUT_SCHEMA, REMOTE_PAIR_REQUEST_OUTPUT_SCHEMA, REMOTE_PAIR_REQUESTS_OUTPUT_SCHEMA, REMOTE_PEERS_OUTPUT_SCHEMA, REMOTE_PAIR_REQUEST_ACTION_INPUT_SCHEMA, REMOTE_PEER_DISCONNECT_INPUT_SCHEMA, REMOTE_PEER_INVOKE_INPUT_SCHEMA, REMOTE_PEER_INVOKE_OUTPUT_SCHEMA, REMOTE_PEER_OUTPUT_SCHEMA, REMOTE_PEER_TOKEN_REVOKE_INPUT_SCHEMA, REMOTE_PEER_TOKEN_ROTATE_INPUT_SCHEMA, REMOTE_PEER_TOKEN_ROTATE_OUTPUT_SCHEMA, REMOTE_SNAPSHOT_SCHEMA, REMOTE_WORK_LIST_OUTPUT_SCHEMA, REMOTE_WORK_CANCEL_INPUT_SCHEMA, REMOTE_WORK_OUTPUT_SCHEMA, SETTINGS_SNAPSHOT_SCHEMA, WORKTREE_SNAPSHOT_SCHEMA, } from './operator-contract-schemas.js';
+export const builtinGatewayRuntimeMethodDescriptors = [
+    methodDescriptor({
+        id: 'remote.snapshot',
+        title: 'Remote Runtime Snapshot',
+        description: 'Return distributed node/device runtime state.',
+        category: 'remote',
+        scopes: ['read:remote'],
+        http: { method: 'GET', path: '/api/remote' },
+        events: [runtimeEventId('control-plane')],
+        inputSchema: EMPTY_OBJECT_SCHEMA,
+        outputSchema: REMOTE_SNAPSHOT_SCHEMA,
+    }),
+    methodDescriptor({
+        id: 'remote.pair.requests.list',
+        title: 'List Remote Pair Requests',
+        description: 'Return pending remote pair requests.',
+        category: 'remote',
+        scopes: ['read:remote'],
+        http: { method: 'GET', path: '/api/remote/pair/requests' },
+        inputSchema: EMPTY_OBJECT_SCHEMA,
+        outputSchema: REMOTE_PAIR_REQUESTS_OUTPUT_SCHEMA,
+    }),
+    methodDescriptor({
+        id: 'remote.pair.requests.approve',
+        title: 'Approve Remote Pair Request',
+        description: 'Approve a pending remote pair request.',
+        category: 'remote',
+        scopes: ['write:remote'],
+        access: 'admin',
+        http: { method: 'POST', path: '/api/remote/pair/requests/{requestId}/approve' },
+        inputSchema: REMOTE_PAIR_REQUEST_ACTION_INPUT_SCHEMA,
+        outputSchema: REMOTE_PAIR_APPROVAL_OUTPUT_SCHEMA,
+    }),
+    methodDescriptor({
+        id: 'remote.pair.requests.reject',
+        title: 'Reject Remote Pair Request',
+        description: 'Reject a pending remote pair request.',
+        category: 'remote',
+        scopes: ['write:remote'],
+        access: 'admin',
+        http: { method: 'POST', path: '/api/remote/pair/requests/{requestId}/reject' },
+        inputSchema: REMOTE_PAIR_REQUEST_ACTION_INPUT_SCHEMA,
+        outputSchema: REMOTE_PAIR_REQUEST_OUTPUT_SCHEMA,
+    }),
+    methodDescriptor({
+        id: 'remote.peers.list',
+        title: 'List Remote Peers',
+        description: 'Return known remote peers.',
+        category: 'remote',
+        scopes: ['read:remote'],
+        http: { method: 'GET', path: '/api/remote/peers' },
+        inputSchema: EMPTY_OBJECT_SCHEMA,
+        outputSchema: REMOTE_PEERS_OUTPUT_SCHEMA,
+    }),
+    methodDescriptor({
+        id: 'remote.peers.token.rotate',
+        title: 'Rotate Remote Peer Token',
+        description: 'Rotate the active token for a remote peer.',
+        category: 'remote',
+        scopes: ['write:remote'],
+        access: 'admin',
+        http: { method: 'POST', path: '/api/remote/peers/{peerId}/token/rotate' },
+        inputSchema: REMOTE_PEER_TOKEN_ROTATE_INPUT_SCHEMA,
+        outputSchema: REMOTE_PEER_TOKEN_ROTATE_OUTPUT_SCHEMA,
+    }),
+    methodDescriptor({
+        id: 'remote.peers.token.revoke',
+        title: 'Revoke Remote Peer Token',
+        description: 'Revoke the active token for a remote peer.',
+        category: 'remote',
+        scopes: ['write:remote'],
+        access: 'admin',
+        http: { method: 'POST', path: '/api/remote/peers/{peerId}/token/revoke' },
+        inputSchema: REMOTE_PEER_TOKEN_REVOKE_INPUT_SCHEMA,
+        outputSchema: REMOTE_PEER_OUTPUT_SCHEMA,
+    }),
+    methodDescriptor({
+        id: 'remote.peers.disconnect',
+        title: 'Disconnect Remote Peer',
+        description: 'Disconnect a remote peer.',
+        category: 'remote',
+        scopes: ['write:remote'],
+        access: 'admin',
+        http: { method: 'POST', path: '/api/remote/peers/{peerId}/disconnect' },
+        inputSchema: REMOTE_PEER_DISCONNECT_INPUT_SCHEMA,
+        outputSchema: REMOTE_PEER_OUTPUT_SCHEMA,
+    }),
+    methodDescriptor({
+        id: 'remote.peers.invoke',
+        title: 'Invoke Remote Peer',
+        description: 'Invoke a method on a connected remote peer.',
+        category: 'remote',
+        scopes: ['write:remote'],
+        access: 'admin',
+        http: { method: 'POST', path: '/api/remote/peers/{peerId}/invoke' },
+        inputSchema: REMOTE_PEER_INVOKE_INPUT_SCHEMA,
+        outputSchema: REMOTE_PEER_INVOKE_OUTPUT_SCHEMA,
+    }),
+    methodDescriptor({
+        id: 'remote.work.list',
+        title: 'List Remote Work',
+        description: 'Return queued and leased remote work items.',
+        category: 'remote',
+        scopes: ['read:remote'],
+        http: { method: 'GET', path: '/api/remote/work' },
+        inputSchema: EMPTY_OBJECT_SCHEMA,
+        outputSchema: REMOTE_WORK_LIST_OUTPUT_SCHEMA,
+    }),
+    methodDescriptor({
+        id: 'remote.work.cancel',
+        title: 'Cancel Remote Work',
+        description: 'Cancel a remote work item.',
+        category: 'remote',
+        scopes: ['write:remote'],
+        access: 'admin',
+        http: { method: 'POST', path: '/api/remote/work/{workId}/cancel' },
+        inputSchema: REMOTE_WORK_CANCEL_INPUT_SCHEMA,
+        outputSchema: REMOTE_WORK_OUTPUT_SCHEMA,
+    }),
+    methodDescriptor({
+        id: 'remote.node_host.contract',
+        title: 'Node Host Contract',
+        description: 'Return the distributed node/device host API contract.',
+        category: 'remote',
+        scopes: ['read:remote'],
+        http: { method: 'GET', path: '/api/remote/node-host/contract' },
+        inputSchema: EMPTY_OBJECT_SCHEMA,
+        outputSchema: entityOutputSchema('contract', DISTRIBUTED_NODE_HOST_CONTRACT_SCHEMA),
+        metadata: { aliasPaths: ['/api/remote/device/contract'] },
+    }),
+    methodDescriptor({
+        id: 'health.snapshot',
+        title: 'Health Snapshot',
+        description: 'Return the health integration snapshot.',
+        category: 'health',
+        scopes: ['read:health'],
+        http: { method: 'GET', path: '/api/health' },
+        inputSchema: EMPTY_OBJECT_SCHEMA,
+        outputSchema: HEALTH_SNAPSHOT_SCHEMA,
+    }),
+    methodDescriptor({
+        id: 'accounts.snapshot',
+        title: 'Accounts Snapshot',
+        description: 'Return provider and channel account posture.',
+        category: 'accounts',
+        scopes: ['read:accounts'],
+        http: { method: 'GET', path: '/api/accounts' },
+        inputSchema: EMPTY_OBJECT_SCHEMA,
+        outputSchema: PROVIDER_ACCOUNT_SNAPSHOT_SCHEMA,
+    }),
+    methodDescriptor({
+        id: 'providers.list',
+        title: 'Providers List',
+        description: 'Return runtime provider metadata, policy hooks, and priced model summaries.',
+        category: 'providers',
+        scopes: ['read:providers'],
+        http: { method: 'GET', path: '/api/providers' },
+        inputSchema: EMPTY_OBJECT_SCHEMA,
+        outputSchema: listOutputSchema('providers', PROVIDER_RUNTIME_SNAPSHOT_SCHEMA),
+    }),
+    methodDescriptor({
+        id: 'providers.get',
+        title: 'Provider Snapshot',
+        description: 'Return runtime metadata for a single provider.',
+        category: 'providers',
+        scopes: ['read:providers'],
+        http: { method: 'GET', path: '/api/providers/{providerId}' },
+        inputSchema: objectSchema({ providerId: STRING_SCHEMA }, ['providerId']),
+        outputSchema: PROVIDER_RUNTIME_SNAPSHOT_SCHEMA,
+    }),
+    methodDescriptor({
+        id: 'providers.usage.get',
+        title: 'Provider Usage',
+        description: 'Return usage and pricing posture for a single provider.',
+        category: 'providers',
+        scopes: ['read:providers'],
+        http: { method: 'GET', path: '/api/providers/{providerId}/usage' },
+        inputSchema: objectSchema({ providerId: STRING_SCHEMA }, ['providerId']),
+        outputSchema: PROVIDER_USAGE_SNAPSHOT_SCHEMA,
+    }),
+    methodDescriptor({
+        id: 'settings.snapshot',
+        title: 'Settings Snapshot',
+        description: 'Return the settings integration snapshot.',
+        category: 'settings',
+        scopes: ['read:settings'],
+        http: { method: 'GET', path: '/api/settings' },
+        inputSchema: EMPTY_OBJECT_SCHEMA,
+        outputSchema: SETTINGS_SNAPSHOT_SCHEMA,
+    }),
+    methodDescriptor({
+        id: 'continuity.snapshot',
+        title: 'Continuity Snapshot',
+        description: 'Return the continuity integration snapshot.',
+        category: 'continuity',
+        scopes: ['read:continuity'],
+        http: { method: 'GET', path: '/api/continuity' },
+        inputSchema: EMPTY_OBJECT_SCHEMA,
+        outputSchema: CONTINUITY_SNAPSHOT_SCHEMA,
+    }),
+    methodDescriptor({
+        id: 'worktrees.snapshot',
+        title: 'Worktrees Snapshot',
+        description: 'Return the worktree integration snapshot.',
+        category: 'worktrees',
+        scopes: ['read:worktrees'],
+        http: { method: 'GET', path: '/api/worktrees' },
+        inputSchema: EMPTY_OBJECT_SCHEMA,
+        outputSchema: WORKTREE_SNAPSHOT_SCHEMA,
+    }),
+    methodDescriptor({
+        id: 'intelligence.snapshot',
+        title: 'Intelligence Snapshot',
+        description: 'Return the intelligence integration snapshot.',
+        category: 'intelligence',
+        scopes: ['read:intelligence'],
+        http: { method: 'GET', path: '/api/intelligence' },
+        inputSchema: EMPTY_OBJECT_SCHEMA,
+        outputSchema: INTELLIGENCE_SNAPSHOT_SCHEMA,
+    }),
+    methodDescriptor({
+        id: 'memory.doctor',
+        title: 'Memory Doctor',
+        description: 'Return sqlite-vec and memory embedding-provider diagnostics.',
+        category: 'memory',
+        scopes: ['read:memory'],
+        http: { method: 'GET', path: '/api/memory/doctor' },
+        inputSchema: EMPTY_OBJECT_SCHEMA,
+        outputSchema: MEMORY_DOCTOR_REPORT_SCHEMA,
+    }),
+    methodDescriptor({
+        id: 'memory.vector.stats',
+        title: 'Memory Vector Stats',
+        description: 'Return the current sqlite-vec vector-store posture.',
+        category: 'memory',
+        scopes: ['read:memory'],
+        http: { method: 'GET', path: '/api/memory/vector' },
+        inputSchema: EMPTY_OBJECT_SCHEMA,
+        outputSchema: objectSchema({ vector: MEMORY_VECTOR_STATS_SCHEMA }, ['vector']),
+    }),
+    methodDescriptor({
+        id: 'memory.vector.rebuild',
+        title: 'Rebuild Memory Vector Index',
+        description: 'Rebuild the sqlite-vec vector index.',
+        category: 'memory',
+        scopes: ['write:memory'],
+        access: 'admin',
+        http: { method: 'POST', path: '/api/memory/vector/rebuild' },
+        inputSchema: EMPTY_OBJECT_SCHEMA,
+        outputSchema: objectSchema({ vector: MEMORY_VECTOR_STATS_SCHEMA }, ['vector']),
+    }),
+    methodDescriptor({
+        id: 'memory.embeddings.default.set',
+        title: 'Set Default Memory Embedding Provider',
+        description: 'Set the active default memory embedding provider.',
+        category: 'memory',
+        scopes: ['write:memory'],
+        access: 'admin',
+        http: { method: 'POST', path: '/api/memory/embeddings/default' },
+        inputSchema: bodyEnvelopeSchema({ providerId: STRING_SCHEMA }, ['providerId']),
+        outputSchema: MEMORY_DOCTOR_REPORT_SCHEMA,
+    }),
+];

package/dist/_internal/platform/control-plane/method-catalog-shared.d.ts

@@ -0,0 +1,100 @@
+import type { RuntimeEventDomain } from '../runtime/events/index.js';
+export type GatewayMethodTransport = 'http' | 'ws' | 'internal';
+export type GatewayMethodSource = 'builtin' | 'plugin';
+export type GatewayMethodAccess = 'public' | 'authenticated' | 'admin' | 'remote-peer';
+export type GatewayEventTransport = 'sse' | 'ws' | 'internal';
+export interface GatewayHttpBinding {
+    readonly method: 'GET' | 'POST' | 'PATCH' | 'DELETE';
+    readonly path: string;
+}
+export interface GatewayMethodDescriptor {
+    readonly id: string;
+    readonly title: string;
+    readonly description: string;
+    readonly category: string;
+    readonly source: GatewayMethodSource;
+    readonly access: GatewayMethodAccess;
+    readonly transport: readonly GatewayMethodTransport[];
+    readonly scopes: readonly string[];
+    readonly http?: GatewayHttpBinding;
+    readonly events?: readonly string[];
+    readonly inputSchema?: Record<string, unknown>;
+    readonly outputSchema?: Record<string, unknown>;
+    readonly pluginId?: string;
+    readonly dangerous?: boolean;
+    readonly invokable?: boolean;
+    readonly metadata?: Record<string, unknown>;
+}
+export interface GatewayEventDescriptor {
+    readonly id: string;
+    readonly title: string;
+    readonly description: string;
+    readonly category: string;
+    readonly source: GatewayMethodSource;
+    readonly transport: readonly GatewayEventTransport[];
+    readonly scopes: readonly string[];
+    readonly domains?: readonly RuntimeEventDomain[];
+    readonly wireEvents?: readonly string[];
+    readonly outputSchema?: Record<string, unknown>;
+    readonly pluginId?: string;
+    readonly metadata?: Record<string, unknown>;
+}
+export interface GatewayMethodInvocationContext {
+    readonly principalId?: string;
+    readonly principalKind?: 'user' | 'bot' | 'service' | 'token' | 'remote-peer';
+    readonly admin?: boolean;
+    readonly scopes?: readonly string[];
+    readonly clientKind?: string;
+    readonly authToken?: string;
+    readonly metadata?: Record<string, unknown>;
+}
+export interface GatewayMethodInvocation {
+    readonly body?: unknown;
+    readonly query?: Record<string, unknown>;
+    readonly context: GatewayMethodInvocationContext;
+}
+export type GatewayMethodHandler = (input: GatewayMethodInvocation) => unknown | Promise<unknown>;
+export interface GatewayMethodListOptions {
+    readonly category?: string;
+    readonly source?: GatewayMethodSource;
+    readonly pluginId?: string;
+}
+export interface GatewayEventListOptions {
+    readonly category?: string;
+    readonly source?: GatewayMethodSource;
+    readonly pluginId?: string;
+    readonly domain?: RuntimeEventDomain;
+}
+export declare const EMPTY_OBJECT_SCHEMA: {
+    readonly type: "object";
+    readonly properties: {};
+    readonly additionalProperties: false;
+};
+export declare const STRING_SCHEMA: {
+    readonly type: "string";
+};
+export declare const BOOLEAN_SCHEMA: {
+    readonly type: "boolean";
+};
+export declare const NUMBER_SCHEMA: {
+    readonly type: "number";
+};
+export declare const JSON_VALUE_SCHEMA: Record<string, unknown>;
+export declare const JSON_OBJECT_SCHEMA: Record<string, unknown>;
+export declare const JSON_ARRAY_SCHEMA: Record<string, unknown>;
+export declare function arraySchema(itemSchema: Record<string, unknown>): Record<string, unknown>;
+export declare function objectSchema(properties: Record<string, Record<string, unknown>>, required?: readonly string[], options?: {
+    readonly additionalProperties?: boolean;
+}): Record<string, unknown>;
+export declare const GATEWAY_HTTP_BINDING_SCHEMA: Record<string, unknown>;
+export declare const METHOD_DESCRIPTOR_SCHEMA: Record<string, unknown>;
+export declare const EVENT_DESCRIPTOR_SCHEMA: Record<string, unknown>;
+export declare function listOutputSchema(key: string, itemSchema: Record<string, unknown>): Record<string, unknown>;
+export declare function entityOutputSchema(key: string, entitySchema: Record<string, unknown>): Record<string, unknown>;
+export declare function actionResultOutputSchema(key: string, entitySchema: Record<string, unknown>): Record<string, unknown>;
+export declare function bodyEnvelopeSchema(properties?: Record<string, Record<string, unknown>>, required?: readonly string[]): Record<string, unknown>;
+export declare function methodDescriptor(input: Omit<GatewayMethodDescriptor, 'source' | 'transport' | 'access'> & Partial<Pick<GatewayMethodDescriptor, 'source' | 'transport' | 'access'>>): GatewayMethodDescriptor;
+export declare function eventDescriptor(input: Omit<GatewayEventDescriptor, 'source'> & Partial<Pick<GatewayEventDescriptor, 'source'>>): GatewayEventDescriptor;
+export declare function runtimeEventId(domain: RuntimeEventDomain): string;
+export declare function runtimeDomainEvent(domain: RuntimeEventDomain, description: string): GatewayEventDescriptor;
+//# sourceMappingURL=method-catalog-shared.d.ts.map

package/dist/_internal/platform/control-plane/method-catalog-shared.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"method-catalog-shared.d.ts","sourceRoot":"","sources":["../../../../src/_internal/platform/control-plane/method-catalog-shared.ts"],"names":[],"mappings":"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"}