feat(automation): expose connector origin on ConnectorDescriptor (ADR-0096 #2977)

`getConnectorDescriptors()` (served by GET /api/v1/automation/connectors) now
includes `origin: 'plugin' | 'declarative'` per connector, so a designer can tell
a materialized declarative instance (ADR-0096) apart from a plugin-registered
connector. Additive: the field is always present; existing consumers ignore it.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01Pbmw3pMqNJfPbkvwh9Fkjs

Author: claude

.changeset/adr-0096-runtime-rematerialization.md

@@ -19,3 +19,8 @@ is now a **reconcile** run both at boot and on `metadata:reloaded`:
   the same problems are logged and the offending entry skipped, so a bad publish
   never crashes a running server; a changed instance's old connector keeps
   serving until its replacement materializes successfully.
+
+Also: `ConnectorDescriptor` (served by `GET /api/v1/automation/connectors`) now
+carries an `origin` field (`'plugin' | 'declarative'`), so a designer can
+distinguish a materialized declarative instance from a plugin-registered
+connector.

packages/services/service-automation/src/connector-materialization.test.ts

@@ -203,7 +203,9 @@ describe('ADR-0096 — declarative connector materialization', () => {
         const desc = engine.getConnectorDescriptors().find((d) => d.name === 'billing');
         expect(desc).toBeDefined();
         expect(desc?.actions.map((a) => a.key)).toEqual(['ping']);
-        // Origin is 'declarative', not 'plugin'.
+        // Origin is 'declarative', not 'plugin' — surfaced on the descriptor so a
+        // designer can distinguish a materialized instance from a plugin connector.
+        expect(desc?.origin).toBe('declarative');
         expect(engine.getConnectorOrigin('billing')).toBe('declarative');
         // The factory saw the declared identity.
         expect(calls[0]?.name).toBe('billing');

packages/services/service-automation/src/engine.ts

@@ -246,6 +246,14 @@ export interface ConnectorDescriptor {
     readonly description?: string;
     readonly icon?: string;
     readonly actions: ConnectorActionDescriptor[];
+    /**
+     * How the connector reached the registry (ADR-0096 §4): `plugin` — registered
+     * by a connector plugin via `registerConnector`; `declarative` — materialized
+     * from a provider-bound `connectors:` stack entry at boot. Lets a designer
+     * distinguish a live declarative instance from a plugin connector (and both
+     * from an inert catalog descriptor, which never reaches this list).
+     */
+    readonly origin: ConnectorOrigin;
 }
 
 // ─── Core Automation Engine ─────────────────────────────────────────
@@ -926,12 +934,13 @@ export class AutomationEngine implements IAutomationService {
      * Handlers are omitted — they are runtime code, not metadata.
      */
     getConnectorDescriptors(): ConnectorDescriptor[] {
-        return [...this.connectors.values()].map(({ def }) => ({
+        return [...this.connectors.values()].map(({ def, origin }) => ({
             name: def.name,
             label: def.label,
             type: def.type,
             description: def.description,
             icon: def.icon,
+            origin,
             actions: (def.actions ?? []).map((a) => ({
                 key: a.key,
                 label: a.label,