@x12i/memorix-service 3.1.0 → 3.2.0

package/dist/connector-catalog.d.ts

@@ -0,0 +1,68 @@
+/**
+ * Unified connector catalog — registry + builtins + MGC (generic connectors).
+ * Used by GET /api/connectors and Jobs listExecutionTargets.
+ * Role helpers live in connector-role.ts (no import cycle).
+ */
+import type { ConnectorRegistry } from "@x12i/memorix-memory";
+import { type ConnectorRole } from "./connector-role.js";
+import { type GenericConnectorsConfig } from "./generic-connectors.js";
+export type ConnectorCatalogOrigin = "registry" | "builtin" | "generic-connectors";
+export type UnifiedConnectorRow = {
+    id: string;
+    version: string;
+    displayName: string;
+    protocol: string;
+    enabled: boolean;
+    /** Capability flags as record (for /api/connectors) or derived keys. */
+    capabilities: Record<string, boolean>;
+    capabilityKeys: string[];
+    origin: ConnectorCatalogOrigin;
+    hostBaseUrl?: string;
+    remoteHosting: boolean;
+    framework: boolean;
+    isSource: boolean;
+    isTarget: boolean;
+    connectorRole: ConnectorRole | null;
+    /** Host missing for generic remote entries. */
+    unavailableReason?: string;
+    definitionHash?: string;
+};
+export type ListUnifiedConnectorsInput = {
+    connectorRegistry: ConnectorRegistry | {
+        list: () => Array<{
+            connectorId: string;
+            version?: string;
+            enabled?: boolean;
+            protocol?: string;
+            workflowHash?: string;
+            manifest?: Record<string, unknown>;
+        }>;
+    };
+    genericConnectors: GenericConnectorsConfig;
+    fetchImpl?: typeof fetch;
+};
+/**
+ * List all connector packages operators may pick (AI-style catalog root).
+ * Registry wins over builtins and MGC for the same id.
+ * Live MGC catalog supplies role-tagged packages; env id lists are offline stubs only.
+ */
+export declare function listUnifiedConnectors(input: ListUnifiedConnectorsInput): Promise<UnifiedConnectorRow[]>;
+/** Shape for GET /api/connectors response rows. */
+export declare function toApiConnectorRow(row: UnifiedConnectorRow): {
+    definitionHash?: string | undefined;
+    unavailableReason?: string | undefined;
+    remoteHosting?: boolean | undefined;
+    hostBaseUrl?: string | undefined;
+    id: string;
+    version: string;
+    protocol: string;
+    enabled: boolean;
+    framework: boolean;
+    displayName: string;
+    capabilities: Record<string, boolean>;
+    connectorRole: ConnectorRole | null;
+    isSource: boolean;
+    isTarget: boolean;
+    origin: ConnectorCatalogOrigin;
+};
+//# sourceMappingURL=connector-catalog.d.ts.map

package/dist/connector-catalog.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"connector-catalog.d.ts","sourceRoot":"","sources":["../src/connector-catalog.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AAC9D,OAAO,EAEL,KAAK,aAAa,EACnB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAEL,KAAK,uBAAuB,EAC7B,MAAM,yBAAyB,CAAC;AAEjC,MAAM,MAAM,sBAAsB,GAC9B,UAAU,GACV,SAAS,GACT,oBAAoB,CAAC;AAEzB,MAAM,MAAM,mBAAmB,GAAG;IAChC,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,OAAO,CAAC;IACjB,wEAAwE;IACxE,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACtC,cAAc,EAAE,MAAM,EAAE,CAAC;IACzB,MAAM,EAAE,sBAAsB,CAAC;IAC/B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,aAAa,EAAE,OAAO,CAAC;IACvB,SAAS,EAAE,OAAO,CAAC;IACnB,QAAQ,EAAE,OAAO,CAAC;IAClB,QAAQ,EAAE,OAAO,CAAC;IAClB,aAAa,EAAE,aAAa,GAAG,IAAI,CAAC;IACpC,+CAA+C;IAC/C,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB,CAAC;AA6EF,MAAM,MAAM,0BAA0B,GAAG;IACvC,iBAAiB,EAAE,iBAAiB,GAAG;QACrC,IAAI,EAAE,MAAM,KAAK,CAAC;YAChB,WAAW,EAAE,MAAM,CAAC;YACpB,OAAO,CAAC,EAAE,MAAM,CAAC;YACjB,OAAO,CAAC,EAAE,OAAO,CAAC;YAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;YAClB,YAAY,CAAC,EAAE,MAAM,CAAC;YACtB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;SACpC,CAAC,CAAC;KACJ,CAAC;IACF,iBAAiB,EAAE,uBAAuB,CAAC;IAC3C,SAAS,CAAC,EAAE,OAAO,KAAK,CAAC;CAC1B,CAAC;AAwCF;;;;GAIG;AACH,wBAAsB,qBAAqB,CACzC,KAAK,EAAE,0BAA0B,GAChC,OAAO,CAAC,mBAAmB,EAAE,CAAC,CA2KhC;AAED,mDAAmD;AACnD,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,mBAAmB;;;;;;;;;;;;;;;;EAoBzD"}

package/dist/connector-catalog.js

@@ -0,0 +1,258 @@
+import { classifyConnectorRole, } from "./connector-role.js";
+import { fetchGenericConnectorCatalog, } from "./generic-connectors.js";
+const BUILTIN_CONNECTORS = [
+    {
+        id: "opx-rest",
+        displayName: "OpX REST",
+        capabilities: { pull: true, cursor: true, simulation: true },
+    },
+    {
+        id: "knowx-rest",
+        displayName: "KnowX REST",
+        capabilities: { pull: true, cursor: true, simulation: true },
+    },
+    {
+        id: "knowx-folder",
+        displayName: "KnowX folder",
+        capabilities: { pull: true, simulation: true },
+    },
+    {
+        id: "knowx-managed",
+        displayName: "KnowX managed",
+        capabilities: {
+            pull: true,
+            largeContent: true,
+            remoteHosting: true,
+            validation: true,
+            health: true,
+            simulation: true,
+        },
+    },
+];
+function capsToRecord(caps, fallback = { pull: true }) {
+    if (!caps)
+        return { ...fallback };
+    if (Array.isArray(caps)) {
+        const out = {};
+        for (const k of caps) {
+            if (typeof k === "string" && k.trim())
+                out[k.trim()] = true;
+        }
+        return Object.keys(out).length ? out : { ...fallback };
+    }
+    const out = {};
+    for (const [k, v] of Object.entries(caps)) {
+        if (v === true)
+            out[k] = true;
+    }
+    return Object.keys(out).length ? out : { ...fallback };
+}
+function finalizeRow(partial) {
+    const { explicitRole, ...rest } = partial;
+    const { isSource, isTarget, role } = classifyConnectorRole(rest.capabilities, explicitRole);
+    return {
+        ...rest,
+        capabilityKeys: Object.keys(rest.capabilities).filter((k) => rest.capabilities[k] === true),
+        isSource,
+        isTarget,
+        connectorRole: role,
+    };
+}
+function addStub(byId, id, opts) {
+    if (byId.has(id))
+        return;
+    const capabilities = opts.role === "source"
+        ? { pull: true, remoteHosting: true }
+        : {
+            push: true,
+            export: true,
+            destination: true,
+            remoteHosting: true,
+        };
+    byId.set(id, finalizeRow({
+        id,
+        version: "0.0.0",
+        displayName: id,
+        protocol: "memorix-connector/1",
+        enabled: true,
+        capabilities,
+        origin: "generic-connectors",
+        hostBaseUrl: opts.hostBaseUrl,
+        remoteHosting: true,
+        framework: true,
+        unavailableReason: opts.unavailableReason,
+        explicitRole: opts.role,
+    }));
+}
+/**
+ * List all connector packages operators may pick (AI-style catalog root).
+ * Registry wins over builtins and MGC for the same id.
+ * Live MGC catalog supplies role-tagged packages; env id lists are offline stubs only.
+ */
+export async function listUnifiedConnectors(input) {
+    const byId = new Map();
+    const fetchImpl = input.fetchImpl ?? fetch;
+    const mgc = input.genericConnectors;
+    for (const doc of input.connectorRegistry.list()) {
+        const manifest = (doc.manifest ?? {});
+        const caps = capsToRecord(manifest.capabilities);
+        byId.set(doc.connectorId, finalizeRow({
+            id: doc.connectorId,
+            version: doc.version ?? "0.0.0",
+            displayName: typeof manifest.displayName === "string"
+                ? manifest.displayName
+                : doc.connectorId,
+            protocol: doc.protocol ?? "memorix-connector/1",
+            enabled: doc.enabled !== false,
+            capabilities: caps,
+            origin: "registry",
+            remoteHosting: caps.remoteHosting === true,
+            framework: true,
+            hostBaseUrl: typeof manifest.hostBaseUrl === "string"
+                ? manifest.hostBaseUrl
+                : undefined,
+            explicitRole: manifest.role,
+        }));
+    }
+    for (const b of BUILTIN_CONNECTORS) {
+        if (byId.has(b.id))
+            continue;
+        byId.set(b.id, finalizeRow({
+            id: b.id,
+            version: "1.0.0",
+            displayName: b.displayName,
+            protocol: "memorix-connector/1",
+            enabled: true,
+            capabilities: { ...b.capabilities },
+            origin: "builtin",
+            remoteHosting: b.capabilities.remoteHosting === true,
+            framework: true,
+        }));
+    }
+    // MGC source connectors (live catalog)
+    if (mgc.sourceServiceUrl) {
+        const rows = await fetchGenericConnectorCatalog(mgc.sourceServiceUrl, fetchImpl, { defaultRole: "source" });
+        for (const row of rows) {
+            if (byId.has(row.id))
+                continue;
+            const fallback = row.role === "target"
+                ? { push: true, remoteHosting: true }
+                : { pull: true, remoteHosting: true };
+            const caps = capsToRecord(row.capabilities, fallback);
+            caps.remoteHosting = true;
+            byId.set(row.id, finalizeRow({
+                id: row.id,
+                version: row.version,
+                displayName: row.displayName ?? row.id,
+                protocol: row.protocol ?? "memorix-connector/1",
+                enabled: true,
+                capabilities: caps,
+                origin: "generic-connectors",
+                hostBaseUrl: mgc.sourceServiceUrl,
+                remoteHosting: true,
+                framework: true,
+                explicitRole: row.role,
+                definitionHash: row.definitionHash,
+            }));
+        }
+        // Offline stubs only when explicitly configured and catalog missed the id
+        for (const id of mgc.remoteSourceConnectorIds) {
+            addStub(byId, id, {
+                hostBaseUrl: mgc.sourceServiceUrl,
+                role: "source",
+            });
+        }
+    }
+    else {
+        for (const id of mgc.remoteSourceConnectorIds) {
+            addStub(byId, id, {
+                role: "source",
+                unavailableReason: "Set MGC_SOURCE_SERVICE_URL to enable",
+            });
+        }
+    }
+    // MGC target connectors (live catalog)
+    if (mgc.targetServiceUrl) {
+        const rows = await fetchGenericConnectorCatalog(mgc.targetServiceUrl, fetchImpl, { defaultRole: "target" });
+        for (const row of rows) {
+            if (byId.has(row.id)) {
+                const existing = byId.get(row.id);
+                if (!existing.isTarget) {
+                    existing.capabilities = {
+                        ...existing.capabilities,
+                        push: true,
+                        export: true,
+                        destination: true,
+                    };
+                    const roles = classifyConnectorRole(existing.capabilities, row.role ?? "target");
+                    existing.isSource = roles.isSource;
+                    existing.isTarget = roles.isTarget;
+                    existing.connectorRole = roles.role;
+                    existing.capabilityKeys = Object.keys(existing.capabilities);
+                }
+                if (!existing.hostBaseUrl)
+                    existing.hostBaseUrl = mgc.targetServiceUrl;
+                continue;
+            }
+            const caps = capsToRecord(row.capabilities, {
+                push: true,
+                export: true,
+                destination: true,
+                remoteHosting: true,
+            });
+            caps.remoteHosting = true;
+            byId.set(row.id, finalizeRow({
+                id: row.id,
+                version: row.version,
+                displayName: row.displayName ?? row.id,
+                protocol: row.protocol ?? "memorix-connector/1",
+                enabled: true,
+                capabilities: caps,
+                origin: "generic-connectors",
+                hostBaseUrl: mgc.targetServiceUrl,
+                remoteHosting: true,
+                framework: true,
+                explicitRole: row.role ?? "target",
+                definitionHash: row.definitionHash,
+            }));
+        }
+        for (const id of mgc.remoteTargetConnectorIds) {
+            addStub(byId, id, {
+                hostBaseUrl: mgc.targetServiceUrl,
+                role: "target",
+            });
+        }
+    }
+    else {
+        for (const id of mgc.remoteTargetConnectorIds) {
+            addStub(byId, id, {
+                role: "target",
+                unavailableReason: "Set MGC_TARGET_SERVICE_URL to enable",
+            });
+        }
+    }
+    return [...byId.values()].sort((a, b) => a.id.localeCompare(b.id));
+}
+/** Shape for GET /api/connectors response rows. */
+export function toApiConnectorRow(row) {
+    return {
+        id: row.id,
+        version: row.version,
+        protocol: row.protocol,
+        enabled: row.enabled,
+        framework: row.framework,
+        displayName: row.displayName,
+        capabilities: row.capabilities,
+        connectorRole: row.connectorRole,
+        isSource: row.isSource,
+        isTarget: row.isTarget,
+        origin: row.origin,
+        ...(row.hostBaseUrl ? { hostBaseUrl: row.hostBaseUrl } : {}),
+        ...(row.remoteHosting ? { remoteHosting: true } : {}),
+        ...(row.unavailableReason
+            ? { unavailableReason: row.unavailableReason }
+            : {}),
+        ...(row.definitionHash ? { definitionHash: row.definitionHash } : {}),
+    };
+}
+//# sourceMappingURL=connector-catalog.js.map

package/dist/connector-catalog.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"connector-catalog.js","sourceRoot":"","sources":["../src/connector-catalog.ts"],"names":[],"mappings":"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"}

package/dist/connector-role.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Leaf helpers for source vs target connector role.
+ * Keep free of execution-target / catalog imports to avoid cycles.
+ */
+export type ConnectorRole = "source" | "target" | "both";
+/** Normalize capability maps / string lists for source vs target classification. */
+export declare function normalizeCapabilityKeys(capabilities: string[] | Record<string, unknown> | undefined | null): Set<string>;
+/**
+ * Parse explicit MGC / catalog `role` (`source` | `target` | `both`).
+ * Preferred over capability inference when present (MGC 0.1.2+).
+ */
+export declare function parseExplicitConnectorRole(role: unknown): ConnectorRole | null;
+/**
+ * Classify connector direction.
+ * Prefer explicit `role` (catalog item / well-known); fall back to capabilities.
+ */
+export declare function classifyConnectorRole(capabilities: string[] | Record<string, unknown> | undefined | null, explicitRole?: unknown): {
+    isSource: boolean;
+    isTarget: boolean;
+    role: ConnectorRole | null;
+};
+//# sourceMappingURL=connector-role.d.ts.map

package/dist/connector-role.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"connector-role.d.ts","sourceRoot":"","sources":["../src/connector-role.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH,MAAM,MAAM,aAAa,GAAG,QAAQ,GAAG,QAAQ,GAAG,MAAM,CAAC;AAEzD,oFAAoF;AACpF,wBAAgB,uBAAuB,CACrC,YAAY,EAAE,MAAM,EAAE,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,GAAG,IAAI,GAClE,GAAG,CAAC,MAAM,CAAC,CAeb;AAED;;;GAGG;AACH,wBAAgB,0BAA0B,CACxC,IAAI,EAAE,OAAO,GACZ,aAAa,GAAG,IAAI,CAMtB;AAED;;;GAGG;AACH,wBAAgB,qBAAqB,CACnC,YAAY,EAAE,MAAM,EAAE,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,GAAG,IAAI,EACnE,YAAY,CAAC,EAAE,OAAO,GACrB;IAAE,QAAQ,EAAE,OAAO,CAAC;IAAC,QAAQ,EAAE,OAAO,CAAC;IAAC,IAAI,EAAE,aAAa,GAAG,IAAI,CAAA;CAAE,CA0BtE"}

package/dist/connector-role.js

@@ -0,0 +1,71 @@
+/**
+ * Leaf helpers for source vs target connector role.
+ * Keep free of execution-target / catalog imports to avoid cycles.
+ */
+const TARGET_CAPABILITY_KEYS = new Set(["push", "export", "destination"]);
+/** Normalize capability maps / string lists for source vs target classification. */
+export function normalizeCapabilityKeys(capabilities) {
+    const out = new Set();
+    if (!capabilities)
+        return out;
+    if (Array.isArray(capabilities)) {
+        for (const c of capabilities) {
+            if (typeof c === "string" && c.trim())
+                out.add(c.trim());
+        }
+        return out;
+    }
+    if (typeof capabilities === "object") {
+        for (const [k, v] of Object.entries(capabilities)) {
+            if (v === true)
+                out.add(k);
+        }
+    }
+    return out;
+}
+/**
+ * Parse explicit MGC / catalog `role` (`source` | `target` | `both`).
+ * Preferred over capability inference when present (MGC 0.1.2+).
+ */
+export function parseExplicitConnectorRole(role) {
+    if (role === "source" || role === "target" || role === "both")
+        return role;
+    if (typeof role !== "string")
+        return null;
+    const t = role.trim().toLowerCase();
+    if (t === "source" || t === "target" || t === "both")
+        return t;
+    return null;
+}
+/**
+ * Classify connector direction.
+ * Prefer explicit `role` (catalog item / well-known); fall back to capabilities.
+ */
+export function classifyConnectorRole(capabilities, explicitRole) {
+    const fromRole = parseExplicitConnectorRole(explicitRole);
+    if (fromRole === "source") {
+        return { isSource: true, isTarget: false, role: "source" };
+    }
+    if (fromRole === "target") {
+        return { isSource: false, isTarget: true, role: "target" };
+    }
+    if (fromRole === "both") {
+        return { isSource: true, isTarget: true, role: "both" };
+    }
+    const keys = normalizeCapabilityKeys(capabilities);
+    const hasPull = keys.has("pull");
+    const hasTarget = [...TARGET_CAPABILITY_KEYS].some((k) => keys.has(k));
+    // Legacy / incomplete manifests: treat as source when not outbound-only.
+    const isSource = hasPull || !hasTarget;
+    const isTarget = hasTarget;
+    if (!isSource && !isTarget) {
+        return { isSource: false, isTarget: false, role: null };
+    }
+    if (isSource && isTarget) {
+        return { isSource: true, isTarget: true, role: "both" };
+    }
+    if (isSource)
+        return { isSource: true, isTarget: false, role: "source" };
+    return { isSource: false, isTarget: true, role: "target" };
+}
+//# sourceMappingURL=connector-role.js.map

package/dist/connector-role.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"connector-role.js","sourceRoot":"","sources":["../src/connector-role.ts"],"names":[],"mappings":"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"}

package/dist/destination-runtime.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Module-level deliverer for pipeline destination invoke (memorix-destination/1).
+ * Set at platform boot — avoids importing Mongo/platform into live.ts cycle.
+ */
+import type { MemoryDeliverer, MemoryDeliverRequest } from "@x12i/memorix-memory";
+export declare function setPlatformDeliverer(d: MemoryDeliverer | null): void;
+export declare function deliverViaPlatform(request: MemoryDeliverRequest): Promise<Awaited<ReturnType<MemoryDeliverer["deliver"]>>>;
+//# sourceMappingURL=destination-runtime.d.ts.map

package/dist/destination-runtime.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"destination-runtime.d.ts","sourceRoot":"","sources":["../src/destination-runtime.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,KAAK,EAAE,eAAe,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AAIlF,wBAAgB,oBAAoB,CAAC,CAAC,EAAE,eAAe,GAAG,IAAI,GAAG,IAAI,CAEpE;AAED,wBAAsB,kBAAkB,CACtC,OAAO,EAAE,oBAAoB,GAC5B,OAAO,CACR,OAAO,CAAC,UAAU,CAAC,eAAe,CAAC,SAAS,CAAC,CAAC,CAAC,CAChD,CAKA"}

package/dist/destination-runtime.js

@@ -0,0 +1,11 @@
+let deliverer = null;
+export function setPlatformDeliverer(d) {
+    deliverer = d;
+}
+export async function deliverViaPlatform(request) {
+    if (!deliverer) {
+        throw new Error("MEMORY_DELIVERER_UNAVAILABLE: platform deliverer not configured");
+    }
+    return deliverer.deliver(request);
+}
+//# sourceMappingURL=destination-runtime.js.map

package/dist/destination-runtime.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"destination-runtime.js","sourceRoot":"","sources":["../src/destination-runtime.ts"],"names":[],"mappings":"AAMA,IAAI,SAAS,GAA2B,IAAI,CAAC;AAE7C,MAAM,UAAU,oBAAoB,CAAC,CAAyB;IAC5D,SAAS,GAAG,CAAC,CAAC;AAChB,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,kBAAkB,CACtC,OAA6B;IAI7B,IAAI,CAAC,SAAS,EAAE,CAAC;QACf,MAAM,IAAI,KAAK,CAAC,iEAAiE,CAAC,CAAC;IACrF,CAAC;IACD,OAAO,SAAS,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;AACpC,CAAC"}

package/dist/execution-target.d.ts

@@ -0,0 +1,141 @@
+/**
+ * Jobs Manager execution targets — pipelines, connectors, services, AI items.
+ * Direct (non-pipeline) targets compile into stable synthetic one-step plans.
+ */
+import type { PipelineDefinition } from "@x12i/memorix-pipeline/v2";
+import { type ServiceDefSlice } from "./pipeline-compile.js";
+export type ExecutionTargetRef = {
+    kind: "pipeline";
+    pipelineId: string;
+} | {
+    kind: "connector";
+    connectorId: string;
+    sourceId: string;
+} | {
+    kind: "destination";
+    connectorId: string;
+    destinationId: string;
+} | {
+    kind: "service";
+    serviceId: string;
+} | {
+    kind: "ai-service";
+    aiServiceType: string;
+    itemId: string;
+} | {
+    kind: "runx";
+    capabilityId: string;
+};
+export { classifyConnectorRole, normalizeCapabilityKeys, type ConnectorRole, } from "./connector-role.js";
+export type ExecutionTargetCatalogEntry = {
+    kind: ExecutionTargetRef["kind"];
+    id: string;
+    name: string;
+    description?: string;
+    available: boolean;
+    unavailableReason?: string;
+    capabilities?: string[];
+    /** Concrete target ref to submit on queue/Work APIs. */
+    target: ExecutionTargetRef;
+    /** Nested options (e.g. sources under a connector, AI items under a type). */
+    children?: ExecutionTargetCatalogEntry[];
+    meta?: Record<string, unknown>;
+};
+export type ResolveExecutionTargetResult = {
+    target: ExecutionTargetRef;
+    pipelineId: string;
+    compiled: PipelineDefinition;
+    label: string;
+};
+export declare function isSyntheticPipelineId(pipelineId: string): boolean;
+export declare function syntheticPipelineId(target: ExecutionTargetRef): string;
+export declare function parseSyntheticPipelineId(pipelineId: string): ExecutionTargetRef | null;
+/** Parse body.executionTarget or legacy body.pipelineId. */
+export declare function parseExecutionTarget(body: unknown): ExecutionTargetRef;
+export declare function buildSyntheticAuthoringDefinition(target: ExecutionTargetRef, opts?: {
+    serviceDefs?: ServiceDefSlice[];
+    sourceName?: string;
+    serviceName?: string;
+    itemTitle?: string;
+}): Record<string, unknown>;
+export type ExecutionTargetPlatform = {
+    metadata: {
+        resolveEffective: (agentIds: string[]) => {
+            effective?: Array<{
+                kind: string;
+                id: string;
+                definition: Record<string, unknown>;
+                provenance?: unknown;
+            }>;
+        };
+        getDefinition: (agentIds: string[], kind: string, id: string) => {
+            definition: unknown;
+        } | null | undefined;
+    };
+    connectorRegistry: {
+        list: () => Array<{
+            connectorId: string;
+            version?: string;
+            enabled?: boolean;
+            protocol?: string;
+            manifest?: Record<string, unknown>;
+        }>;
+    };
+    orgRuntimeSourcesFor: (orgId: string) => {
+        list: (opts?: {
+            agentIds?: string[];
+            origin?: string;
+        }) => Promise<Array<{
+            sourceId: string;
+            definition: Record<string, unknown>;
+            agentIds: string[];
+            origin?: string;
+        }>>;
+    };
+    /** Optional — destination deliver ET + catalog children. */
+    destinationStore?: {
+        list: (orgId: string) => Promise<Array<{
+            definition: {
+                id: string;
+                name: string;
+                connectorRef: string;
+                hostBaseUrl?: string;
+            };
+        }>>;
+        get: (orgId: string, destinationId: string) => Promise<{
+            definition: {
+                id: string;
+                name: string;
+                connectorRef: string;
+                hostBaseUrl?: string;
+            };
+        } | null>;
+    };
+    /** Optional — MGC env for unified catalog. */
+    genericConnectors?: import("./generic-connectors.js").GenericConnectorsConfig;
+};
+export declare function resolveExecutionTarget(platform: ExecutionTargetPlatform, opts: {
+    agentIds: string[];
+    orgId?: string | null;
+    target: ExecutionTargetRef;
+}): Promise<ResolveExecutionTargetResult>;
+/** Resolve by pipelineId — installed or synthetic. */
+export declare function resolvePipelineIdAsTarget(platform: ExecutionTargetPlatform, opts: {
+    agentIds: string[];
+    orgId?: string | null;
+    pipelineId: string;
+}): Promise<ResolveExecutionTargetResult>;
+export declare function listExecutionTargets(platform: ExecutionTargetPlatform, opts: {
+    agentIds: string[];
+    orgId?: string | null;
+}): Promise<{
+    pipelines: ExecutionTargetCatalogEntry[];
+    /** Alias of sourceConnectors (compat). */
+    connectors: ExecutionTargetCatalogEntry[];
+    sourceConnectors: ExecutionTargetCatalogEntry[];
+    targetConnectors: ExecutionTargetCatalogEntry[];
+    services: ExecutionTargetCatalogEntry[];
+    aiServices: ExecutionTargetCatalogEntry[];
+    runx: ExecutionTargetCatalogEntry[];
+}>;
+//# sourceMappingURL=execution-target.d.ts.map

package/dist/execution-target.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"execution-target.d.ts","sourceRoot":"","sources":["../src/execution-target.ts"],"names":[],"mappings":"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"}