@x12i/memorix-service 3.0.5 → 3.1.0

package/dist/routes/memory.js

@@ -3,6 +3,7 @@ import { credentialHandleFromDelegation, createCredentialHandle, } from "@x12i/m
 import { resolveScope } from "../request-scope.js";
 import { ServiceError } from "../errors.js";
 import { forbidCallbackGrant, requireCallbackAccess } from "../access-gate.js";
+import { asSourceDefinition } from "../org-sources.js";
 const CONNECTION_PROBE_MS = 2000;
 /** Module-level replay ledger — lives for the process lifetime. */
 const pushEnvelopeStore = createInMemoryPushEnvelopeStore({ maxSize: 50_000 });
@@ -59,18 +60,77 @@ async function probeSourceHealth(baseUrl) {
         return false;
     }
 }
-function resolveSourceDefinition(platform, agentIds, sourceId) {
-    const def = platform.metadata.getDefinition(agentIds, "sources", sourceId);
-    if (!def) {
-        throw new ServiceError("NOT_FOUND", `source not found: ${sourceId}`, 404);
+const STREAM_PROBE_PREVIEW_MAX = 32_768;
+/** Expand `:param` segments from workRef / query; fail if any remain unresolved. */
+function expandStreamEndpoint(endpoint, opts) {
+    const params = [...endpoint.matchAll(/:([A-Za-z_][A-Za-z0-9_]*)/g)].map((m) => m[1]);
+    let path = endpoint;
+    for (const name of params) {
+        const fromQuery = opts.query?.[name];
+        let value = null;
+        if (typeof fromQuery === "string" && fromQuery.trim()) {
+            value = fromQuery.trim();
+        }
+        else if (typeof fromQuery === "number" && Number.isFinite(fromQuery)) {
+            value = String(fromQuery);
+        }
+        else if (opts.workRef?.trim()) {
+            if (name === "id" || params.length === 1) {
+                value = opts.workRef.trim();
+            }
+        }
+        if (!value) {
+            return {
+                error: `path parameter :${name} requires workRef or query.${name}`,
+            };
+        }
+        path = path.replace(new RegExp(`:${name}\\b`), encodeURIComponent(value));
+    }
+    if (path.includes(":")) {
+        return { error: `unresolved path parameters in ${endpoint}` };
+    }
+    return { path };
+}
+function redactProbeHeaders(headers) {
+    const out = {};
+    headers.forEach((value, key) => {
+        const lower = key.toLowerCase();
+        if (lower === "authorization" ||
+            lower === "cookie" ||
+            lower === "set-cookie" ||
+            lower.includes("secret") ||
+            lower.includes("token")) {
+            out[key] = "[redacted]";
+            return;
+        }
+        out[key] = value;
+    });
+    return out;
+}
+function connectorFrameworkFlag(entry) {
+    return entry.protocol === "memorix-connector/1";
+}
+async function resolveSourceDefinition(platform, scope, sourceId) {
+    const packDef = platform.metadata.getDefinition(scope.agentIds, "sources", sourceId);
+    if (packDef?.definition) {
+        return packDef.definition;
+    }
+    const orgDoc = await platform
+        .orgRuntimeSourcesFor(scope.orgId)
+        .get(sourceId);
+    if (orgDoc &&
+        (!orgDoc.agentIds.length ||
+            !scope.agentIds.length ||
+            scope.agentIds.some((a) => orgDoc.agentIds.includes(a)))) {
+        return orgDoc.definition;
     }
-    return def.definition;
+    throw new ServiceError("NOT_FOUND", `source not found: ${sourceId}`, 404);
 }
 export async function registerMemoryRoutes(app, platform) {
     app.get("/api/memory/sources", async (req) => {
         const scope = resolveScope(req);
         const effective = platform.metadata.resolveEffective(scope.agentIds);
-        const sources = (effective.effective ?? [])
+        const packSources = (effective.effective ?? [])
             .filter((e) => e.kind === "sources")
             .map((e) => {
             const d = e.definition;
@@ -78,6 +138,7 @@ export async function registerMemoryRoutes(app, platform) {
             return {
                 id: e.id,
                 ...safe,
+                registry: "pack",
                 provenance: {
                     definedByAgentId: e.provenance.definedByAgentId,
                     inheritancePath: e.provenance.inheritancePath,
@@ -85,19 +146,108 @@ export async function registerMemoryRoutes(app, platform) {
                 },
             };
         });
-        return { scope, sources, note: "credentialRef only" };
+        const packIds = new Set(packSources.map((s) => s.id));
+        const orgRows = await platform
+            .orgRuntimeSourcesFor(scope.orgId)
+            .list({ agentIds: scope.agentIds });
+        const orgSources = orgRows
+            .filter((r) => !packIds.has(r.sourceId))
+            .map((r) => {
+            const d = r.definition;
+            const { credential: _c, credentials: _cs, secret: _s, ...safe } = d;
+            return {
+                id: r.sourceId,
+                ...safe,
+                registry: "org",
+                origin: r.origin,
+                provenance: {
+                    definedByAgentId: r.agentIds[0] ?? null,
+                    inheritancePath: r.agentIds,
+                    selectedAgentId: r.agentIds[0] ?? null,
+                },
+            };
+        });
+        return {
+            scope,
+            sources: [...packSources, ...orgSources],
+            note: "credentialRef only; registry=pack|org",
+        };
+    });
+    app.get("/api/memory/org-sources", async (req) => {
+        const scope = resolveScope(req);
+        const q = req.query;
+        const sources = await platform.orgRuntimeSourcesFor(scope.orgId).list({
+            origin: q.origin?.trim() || undefined,
+            agentIds: scope.agentIds,
+        });
+        return { scope, sources };
+    });
+    app.put("/api/memory/org-sources/:sourceId", async (req) => {
+        const scope = resolveScope(req);
+        const sourceId = String(req.params.sourceId ?? "").trim();
+        if (!sourceId) {
+            throw new ServiceError("VALIDATION", "sourceId required", 400);
+        }
+        const body = (req.body ?? {});
+        if (!body.definition || typeof body.definition !== "object") {
+            throw new ServiceError("VALIDATION", "definition object required", 400);
+        }
+        const definition = asSourceDefinition(body.definition, sourceId);
+        const saved = await platform.orgRuntimeSourcesFor(scope.orgId).upsert({
+            sourceId,
+            definition,
+            agentIds: body.agentIds?.length ? body.agentIds : scope.agentIds,
+            origin: body.origin?.trim() || "knowx-folder",
+        });
+        return { scope, source: saved };
+    });
+    app.delete("/api/memory/org-sources/:sourceId", async (req) => {
+        const scope = resolveScope(req);
+        const sourceId = String(req.params.sourceId ?? "").trim();
+        if (!sourceId) {
+            throw new ServiceError("VALIDATION", "sourceId required", 400);
+        }
+        const deleted = await platform
+            .orgRuntimeSourcesFor(scope.orgId)
+            .delete(sourceId);
+        if (!deleted) {
+            throw new ServiceError("NOT_FOUND", `org source not found: ${sourceId}`, 404);
+        }
+        return { scope, deleted: true, sourceId };
+    });
+    app.post("/api/memory/org-sources/replace", async (req) => {
+        const scope = resolveScope(req);
+        const body = (req.body ?? {});
+        const origin = body.origin?.trim() || "knowx-folder";
+        if (!Array.isArray(body.sources)) {
+            throw new ServiceError("VALIDATION", "sources array required", 400);
+        }
+        const defs = body.sources.map((s, i) => {
+            const sourceId = String(s.sourceId ?? s.definition?.id ?? "").trim();
+            if (!sourceId) {
+                throw new ServiceError("VALIDATION", `sources[${i}].sourceId required`, 400);
+            }
+            if (!s.definition || typeof s.definition !== "object") {
+                throw new ServiceError("VALIDATION", `sources[${i}].definition required`, 400);
+            }
+            return {
+                sourceId,
+                definition: asSourceDefinition(s.definition, sourceId),
+                agentIds: s.agentIds?.length ? s.agentIds : scope.agentIds,
+            };
+        });
+        const result = await platform
+            .orgRuntimeSourcesFor(scope.orgId)
+            .replaceAllForOrigin(origin, defs);
+        return { scope, origin, ...result };
     });
     app.get("/api/memory/sources/:sourceId/connection", async (req) => {
         const scope = resolveScope(req);
         const sourceId = String(req.params.sourceId ?? "").trim();
         if (!sourceId)
             throw new ServiceError("VALIDATION", "sourceId required", 400);
-        const effective = platform.metadata.resolveEffective(scope.agentIds);
-        const entry = (effective.effective ?? []).find((e) => e.kind === "sources" && e.id === sourceId);
-        if (!entry) {
-            throw new ServiceError("NOT_FOUND", `source not found: ${sourceId}`, 404);
-        }
-        const definition = entry.definition;
+        const source = await resolveSourceDefinition(platform, scope, sourceId);
+        const definition = source;
         const baseUrl = resolveSourceBaseUrl(definition);
         const checkedAt = new Date().toISOString();
         if (!baseUrl) {
@@ -120,22 +270,109 @@ export async function registerMemoryRoutes(app, platform) {
             checkedAt,
         };
     });
+    app.post("/api/memory/sources/:sourceId/streams/probe", async (req) => {
+        const scope = resolveScope(req);
+        const sourceId = String(req.params.sourceId ?? "").trim();
+        if (!sourceId)
+            throw new ServiceError("VALIDATION", "sourceId required", 400);
+        const source = await resolveSourceDefinition(platform, scope, sourceId);
+        const definition = source;
+        const body = (req.body ?? {});
+        const endpoint = String(body.endpoint ?? "").trim();
+        if (!endpoint) {
+            throw new ServiceError("VALIDATION", "endpoint required", 400);
+        }
+        const baseUrl = resolveSourceBaseUrl(definition);
+        if (!baseUrl) {
+            throw new ServiceError("VALIDATION", "source has no configured base URL (baseUrlEnv / defaultBaseUrl)", 400);
+        }
+        const expanded = expandStreamEndpoint(endpoint, {
+            workRef: typeof body.workRef === "string" ? body.workRef : undefined,
+            query: body.query && typeof body.query === "object" ? body.query : undefined,
+        });
+        if ("error" in expanded) {
+            throw new ServiceError("VALIDATION", expanded.error, 400);
+        }
+        const url = new URL(expanded.path.replace(/^\//, ""), `${baseUrl}/`);
+        const query = body.query && typeof body.query === "object" ? body.query : undefined;
+        const pathParamNames = new Set([...endpoint.matchAll(/:([A-Za-z_][A-Za-z0-9_]*)/g)].map((m) => m[1]));
+        if (query) {
+            for (const [key, value] of Object.entries(query)) {
+                if (key.startsWith(":") || pathParamNames.has(key))
+                    continue;
+                if (typeof value === "string" || typeof value === "number" || typeof value === "boolean") {
+                    url.searchParams.set(key, String(value));
+                }
+            }
+        }
+        if (typeof body.limit === "number" && Number.isFinite(body.limit) && body.limit > 0) {
+            url.searchParams.set("limit", String(Math.floor(body.limit)));
+        }
+        const started = Date.now();
+        try {
+            const res = await fetch(url.toString(), {
+                method: "GET",
+                signal: AbortSignal.timeout(CONNECTION_PROBE_MS),
+                headers: { accept: "application/json, text/plain, */*" },
+            });
+            const durationMs = Date.now() - started;
+            const contentType = res.headers.get("content-type") ?? undefined;
+            const text = await res.text();
+            const truncated = text.length > STREAM_PROBE_PREVIEW_MAX;
+            const bodyPreview = truncated ? text.slice(0, STREAM_PROBE_PREVIEW_MAX) : text;
+            return {
+                scope,
+                sourceId,
+                streamId: typeof body.streamId === "string" ? body.streamId : undefined,
+                endpoint,
+                ok: res.ok,
+                status: res.status,
+                url: url.toString(),
+                durationMs,
+                contentType,
+                headers: redactProbeHeaders(res.headers),
+                bodyPreview,
+                truncated,
+            };
+        }
+        catch (err) {
+            const durationMs = Date.now() - started;
+            const msg = err instanceof Error ? err.message : String(err);
+            return {
+                scope,
+                sourceId,
+                streamId: typeof body.streamId === "string" ? body.streamId : undefined,
+                endpoint,
+                ok: false,
+                status: 0,
+                url: url.toString(),
+                durationMs,
+                contentType: undefined,
+                headers: {},
+                bodyPreview: "",
+                truncated: false,
+                error: msg,
+            };
+        }
+    });
     app.get("/api/memory/sources/:sourceId/checkpoints", async (req) => {
         requireCallbackAccess(req, "checkpoints");
         const scope = resolveScope(req);
         const sourceId = String(req.params.sourceId ?? "").trim();
         if (!sourceId)
             throw new ServiceError("VALIDATION", "sourceId required", 400);
-        const source = resolveSourceDefinition(platform, scope.agentIds, sourceId);
+        const source = await resolveSourceDefinition(platform, scope, sourceId);
         const ports = platform.portsFor(scope);
         const cursors = await ports.memoryRunStore.listCursors({ sourceId });
         const mode = req.query.mode === "context" || req.query.mode === "knowledge"
             ? req.query.mode
             : undefined;
         const includeTechnical = req.query.technical === "1" || req.query.technical === "true";
+        const workRef = req.query.workRef?.trim() || undefined;
         const checkpoints = listCheckpointSummariesForSource({
             source,
             mode,
+            workRef,
             cursors,
             includeTechnical,
         });
@@ -154,7 +391,7 @@ export async function registerMemoryRoutes(app, platform) {
         if (!sourceId || !checkpointKey) {
             throw new ServiceError("VALIDATION", "sourceId and checkpointKey required", 400);
         }
-        resolveSourceDefinition(platform, scope.agentIds, sourceId);
+        await resolveSourceDefinition(platform, scope, sourceId);
         const ports = platform.portsFor(scope);
         const doc = await ports.memoryRunStore.getCursor(checkpointKey);
         if (!doc || doc.sourceId !== sourceId) {
@@ -172,7 +409,7 @@ export async function registerMemoryRoutes(app, platform) {
         const sourceId = String(req.params.sourceId ?? "").trim();
         if (!sourceId)
             throw new ServiceError("VALIDATION", "sourceId required", 400);
-        const source = resolveSourceDefinition(platform, scope.agentIds, sourceId);
+        const source = await resolveSourceDefinition(platform, scope, sourceId);
         const body = (req.body ?? {});
         const ports = platform.portsFor(scope);
         const mode = body.mode ?? "knowledge";
@@ -215,7 +452,7 @@ export async function registerMemoryRoutes(app, platform) {
         const sourceId = String(req.params.sourceId ?? "").trim();
         if (!sourceId)
             throw new ServiceError("VALIDATION", "sourceId required", 400);
-        const source = resolveSourceDefinition(platform, scope.agentIds, sourceId);
+        const source = await resolveSourceDefinition(platform, scope, sourceId);
         const body = (req.body ?? {});
         if (!body.objectType) {
             throw new ServiceError("VALIDATION", "objectType required", 400);
@@ -324,7 +561,7 @@ export async function registerMemoryRoutes(app, platform) {
         const sourceId = String(req.params.sourceId ?? "").trim();
         if (!sourceId)
             throw new ServiceError("VALIDATION", "sourceId required", 400);
-        resolveSourceDefinition(platform, scope.agentIds, sourceId);
+        await resolveSourceDefinition(platform, scope, sourceId);
         const mode = req.query.mode === "context" ? "context" : "knowledge";
         const ports = platform.portsFor(scope);
         const schedule = await ports.memoryScheduleStore.getSchedule(sourceId, mode);
@@ -335,7 +572,7 @@ export async function registerMemoryRoutes(app, platform) {
         const sourceId = String(req.params.sourceId ?? "").trim();
         if (!sourceId)
             throw new ServiceError("VALIDATION", "sourceId required", 400);
-        resolveSourceDefinition(platform, scope.agentIds, sourceId);
+        await resolveSourceDefinition(platform, scope, sourceId);
         const body = (req.body ?? {});
         if (!body.interval) {
             throw new ServiceError("VALIDATION", "interval required", 400);
@@ -362,7 +599,7 @@ export async function registerMemoryRoutes(app, platform) {
         const sourceId = String(req.params.sourceId ?? "").trim();
         if (!sourceId)
             throw new ServiceError("VALIDATION", "sourceId required", 400);
-        resolveSourceDefinition(platform, scope.agentIds, sourceId);
+        await resolveSourceDefinition(platform, scope, sourceId);
         const mode = req.query.mode === "context" ? "context" : "knowledge";
         const ports = platform.portsFor(scope);
         const existing = await ports.memoryScheduleStore.getSchedule(sourceId, mode);
@@ -383,7 +620,7 @@ export async function registerMemoryRoutes(app, platform) {
         const sourceId = String(req.params.sourceId ?? "").trim();
         if (!sourceId)
             throw new ServiceError("VALIDATION", "sourceId required", 400);
-        resolveSourceDefinition(platform, scope.agentIds, sourceId);
+        await resolveSourceDefinition(platform, scope, sourceId);
         const mode = req.query.mode === "context" ? "context" : "knowledge";
         const ports = platform.portsFor(scope);
         const existing = await ports.memoryScheduleStore.getSchedule(sourceId, mode);
@@ -410,7 +647,7 @@ export async function registerMemoryRoutes(app, platform) {
         const sourceId = String(req.params.sourceId ?? "").trim();
         if (!sourceId)
             throw new ServiceError("VALIDATION", "sourceId required", 400);
-        resolveSourceDefinition(platform, scope.agentIds, sourceId);
+        await resolveSourceDefinition(platform, scope, sourceId);
         const mode = req.query.mode === "context" ? "context" : "knowledge";
         const ports = platform.portsFor(scope);
         const existing = await ports.memoryScheduleStore.getSchedule(sourceId, mode);
@@ -468,7 +705,7 @@ export async function registerMemoryRoutes(app, platform) {
         const sourceId = String(req.params.sourceId ?? "").trim();
         if (!sourceId)
             throw new ServiceError("VALIDATION", "sourceId required", 400);
-        resolveSourceDefinition(platform, scope.agentIds, sourceId);
+        await resolveSourceDefinition(platform, scope, sourceId);
         const mode = req.query.mode === "context" ? "context" : "knowledge";
         const ports = platform.portsFor(scope);
         const removed = await ports.memoryScheduleStore.deleteSchedule(sourceId, mode);
@@ -530,7 +767,7 @@ export async function registerMemoryRoutes(app, platform) {
         const sourceId = String(req.params.sourceId ?? "").trim();
         if (!sourceId)
             throw new ServiceError("VALIDATION", "sourceId required", 400);
-        const source = resolveSourceDefinition(platform, scope.agentIds, sourceId);
+        const source = await resolveSourceDefinition(platform, scope, sourceId);
         const body = (req.body ?? {});
         if (!body.objectType) {
             throw new ServiceError("VALIDATION", "objectType required", 400);
@@ -588,7 +825,7 @@ export async function registerMemoryRoutes(app, platform) {
         const sourceId = String(req.params.sourceId ?? "").trim();
         if (!sourceId)
             throw new ServiceError("VALIDATION", "sourceId required", 400);
-        resolveSourceDefinition(platform, scope.agentIds, sourceId);
+        await resolveSourceDefinition(platform, scope, sourceId);
         const body = (req.body ?? {});
         // Delivery replay guard — short-circuit duplicate provider deliveries.
         const deliveryId = body.deliveryId?.trim() || null;
@@ -643,7 +880,7 @@ export async function registerMemoryRoutes(app, platform) {
         const sourceId = String(req.params.sourceId ?? "").trim();
         if (!sourceId)
             throw new ServiceError("VALIDATION", "sourceId required", 400);
-        const source = resolveSourceDefinition(platform, scope.agentIds, sourceId);
+        const source = await resolveSourceDefinition(platform, scope, sourceId);
         const connectorRef = source.connectorRef
             ?? source.kind;
         const connector = connectorRef
@@ -692,7 +929,7 @@ export async function registerMemoryRoutes(app, platform) {
         const sourceId = String(req.params.sourceId ?? "").trim();
         if (!sourceId)
             throw new ServiceError("VALIDATION", "sourceId required", 400);
-        const source = resolveSourceDefinition(platform, scope.agentIds, sourceId);
+        const source = await resolveSourceDefinition(platform, scope, sourceId);
         const connectorRef = source.connectorRef
             ?? source.kind;
         const connector = connectorRef
@@ -729,23 +966,88 @@ export async function registerMemoryRoutes(app, platform) {
     });
     app.get("/api/connectors", async (req) => {
         const scope = resolveScope(req);
-        const frameworkConnectors = platform.connectorRegistry.list().map((doc) => ({
-            id: doc.connectorId,
-            version: doc.version,
-            protocol: doc.protocol,
-            enabled: doc.enabled,
-            workflowHash: doc.workflowHash,
-        }));
-        const legacyConnectors = [
-            { id: "rest-fixture", version: "0.0.0-legacy", protocol: "memorix-connector/1", enabled: true },
-            { id: "opx-fixture", version: "0.0.0-legacy", protocol: "memorix-connector/1", enabled: true },
-            { id: "knowx-fixture", version: "0.0.0-legacy", protocol: "memorix-connector/1", enabled: true },
+        const frameworkConnectors = platform.connectorRegistry.list().map((doc) => {
+            const manifest = (doc.manifest ?? {});
+            const caps = manifest.capabilities && typeof manifest.capabilities === "object"
+                ? manifest.capabilities
+                : undefined;
+            return {
+                id: doc.connectorId,
+                version: doc.version,
+                protocol: doc.protocol,
+                enabled: doc.enabled,
+                workflowHash: doc.workflowHash,
+                framework: connectorFrameworkFlag(doc),
+                displayName: typeof manifest.displayName === "string" ? manifest.displayName : undefined,
+                capabilities: caps
+                    ? {
+                        pull: caps.pull === true,
+                        ...(caps.simulation === true ? { simulation: true } : {}),
+                        ...(caps.providerPush === true ? { providerPush: true } : {}),
+                        ...(caps.cursor === true ? { cursor: true } : {}),
+                        ...(caps.watermark === true ? { watermark: true } : {}),
+                        ...(caps.fullScanHash === true ? { fullScanHash: true } : {}),
+                        ...(caps.polling === true ? { polling: true } : {}),
+                        ...(caps.scheduling === true ? { scheduling: true } : {}),
+                        ...(caps.largeContent === true ? { largeContent: true } : {}),
+                        ...(caps.xml === true ? { xml: true } : {}),
+                        ...(caps.validation === true ? { validation: true } : {}),
+                        ...(caps.health === true ? { health: true } : {}),
+                        ...(caps.remoteHosting === true ? { remoteHosting: true } : {}),
+                    }
+                    : { pull: true },
+            };
+        });
+        const builtinFramework = [
+            {
+                id: "opx-rest",
+                version: "1.0.0",
+                protocol: "memorix-connector/1",
+                enabled: true,
+                framework: true,
+                displayName: "OpX REST",
+                capabilities: { pull: true, cursor: true, simulation: true },
+            },
+            {
+                id: "knowx-rest",
+                version: "1.0.0",
+                protocol: "memorix-connector/1",
+                enabled: true,
+                framework: true,
+                displayName: "KnowX REST",
+                capabilities: { pull: true, cursor: true, simulation: true },
+            },
+            {
+                id: "knowx-folder",
+                version: "1.0.0",
+                protocol: "memorix-connector/1",
+                enabled: true,
+                framework: true,
+                displayName: "KnowX folder",
+                capabilities: { pull: true, simulation: true },
+            },
+            {
+                id: "knowx-managed",
+                version: "1.0.0",
+                protocol: "memorix-connector/1",
+                enabled: true,
+                framework: true,
+                displayName: "KnowX managed",
+                capabilities: {
+                    pull: true,
+                    largeContent: true,
+                    remoteHosting: true,
+                    validation: true,
+                    health: true,
+                    simulation: true,
+                },
+            },
         ];
-        // Deduplicate: framework connectors take precedence over legacy stubs.
+        // Deduplicate: registry connectors take precedence over builtins.
         const frameworkIds = new Set(frameworkConnectors.map((c) => c.id));
         const connectors = [
             ...frameworkConnectors,
-            ...legacyConnectors.filter((c) => !frameworkIds.has(c.id)),
+            ...builtinFramework.filter((c) => !frameworkIds.has(c.id)),
         ];
         return { scope, connectors };
     });
@@ -756,7 +1058,7 @@ export async function registerMemoryRoutes(app, platform) {
         const sourceId = String(req.params.sourceId ?? "").trim();
         if (!sourceId)
             throw new ServiceError("VALIDATION", "sourceId required", 400);
-        const source = resolveSourceDefinition(platform, scope.agentIds, sourceId);
+        const source = await resolveSourceDefinition(platform, scope, sourceId);
         const body = (req.body ?? {});
         const action = body.action ?? "create";
         const connectorRef = source.connectorRef ??