feat(agent): add Hermes transitional capability matrix (#738)

packages/agent/src/hermes-runtime-provider.ts

@@ -11,9 +11,19 @@ import type {
   RuntimeSessionState,
   RuntimeSessionTree,
   RuntimeStreamEvent,
+  TransitionalCapabilityInventoryEntry,
+  TransitionalCapabilityInventoryProvider,
+  TransitionalRuntimeCapability,
 } from '@mosaicstack/types';
 
 const HERMES_PROVIDER_ID = 'runtime.hermes';
+const TRANSITIONAL_CAPABILITIES: readonly TransitionalRuntimeCapability[] = [
+  'kanban',
+  'skills',
+  'memory',
+  'tools',
+  'cron',
+];
 const RUNTIME_CAPABILITIES: readonly RuntimeCapability[] = [
   'session.list',
   'session.tree',
@@ -65,11 +75,38 @@ export class HermesRuntimeProviderError extends Error {
  * Transitional Hermes adapter. Legacy identifiers and schemas do not cross this
  * boundary: callers only observe Mosaic AgentRuntimeProvider contracts.
  */
-export class HermesRuntimeProvider implements AgentRuntimeProvider {
+export class HermesRuntimeProvider
+  implements AgentRuntimeProvider, TransitionalCapabilityInventoryProvider
+{
   readonly id = HERMES_PROVIDER_ID;
 
   constructor(private readonly transport: HermesRuntimeTransport) {}
 
+  /**
+   * Full AC-TESS-05 migration inventory. These operations are deliberately
+   * unsupported until their Mosaic-owned plugin contracts exist.
+   */
+  async transitionalCapabilityMatrix(
+    _scope: RuntimeScope,
+  ): Promise<TransitionalCapabilityInventoryEntry[]> {
+    return TRANSITIONAL_CAPABILITIES.map((capability) => ({ capability, status: 'unsupported' }));
+  }
+
+  async assertTransitionalCapability(
+    capability: TransitionalRuntimeCapability,
+    scope: RuntimeScope,
+  ): Promise<void> {
+    const entry = (await this.transitionalCapabilityMatrix(scope)).find(
+      (candidate) => candidate.capability === capability,
+    );
+    if (!entry || entry.status !== 'supported') {
+      throw new HermesRuntimeProviderError(
+        'capability_unsupported',
+        `Hermes transitional capability is unsupported: ${capability}`,
+      );
+    }
+  }
+
   async capabilities(scope: RuntimeScope): Promise<RuntimeCapabilitySet> {
     const legacyCapabilities = await this.transport.capabilities(scope);
     return {