@haaaiawd/second-nature 0.1.43 → 0.1.51

package/runtime/core/second-nature/orchestrator/platform-capability-router.js

@@ -1,131 +1,149 @@
-function kindToCapability(kind) {
-    if (kind === "exploration")
-        return "feed.read";
-    if (kind === "social")
-        return "comment.reply";
-    if (kind === "work")
-        return "work.discover";
-    if (kind === "outreach")
-        return "message.send";
-    return null;
-}
-function getPlatformIds(registry) {
-    if (registry) {
-        return registry.listRegisteredPlatformIds();
-    }
-    // Fallback: built-in platforms when registry is absent (backward compat)
-    return ["moltbook", "instreet", "evomap", "agent-world"];
-}
-const FALLBACK_PLATFORM_CAPABILITIES = {
-    "moltbook": ["feed.read", "post.publish", "comment.reply", "message.send"],
-    "instreet": ["notification.list", "message.send", "comment.reply", "agent.heartbeat"],
-    "evomap": ["agent.register", "agent.heartbeat", "work.discover", "task.claim"],
-    "agent-world": ["feed.read", "work.discover", "task.claim"],
-};
-function fallbackPlatformSupportsCapability(platformId, kind) {
-    const capability = kindToCapability(kind);
-    if (!capability)
-        return false;
-    return (FALLBACK_PLATFORM_CAPABILITIES[platformId] ?? []).includes(capability);
-}
-function extractPlatformIdsFromGoals(goals, kind, platformIds) {
-    const capability = kindToCapability(kind);
-    const results = new Set();
-    for (const goal of goals) {
-        const text = `${goal.description} ${goal.completionCriteria ?? ""}`.toLowerCase();
-        for (const pid of platformIds) {
-            if (text.includes(pid)) {
-                results.add(pid);
-            }
-        }
-        // Also match if goal text contains the capability name (e.g. "feed.read")
-        if (capability && text.includes(capability.toLowerCase())) {
-            // capability alone doesn't tell us platform; keep for later
-        }
-    }
-    return [...results];
-}
-function extractPlatformIdsFromEvidence(refs, platformIds) {
-    const results = new Set();
-    for (const ref of refs) {
-        if (ref.kind === "connector_result" && ref.id) {
-            for (const pid of platformIds) {
-                if (ref.id.includes(pid)) {
-                    results.add(pid);
-                }
-            }
-        }
-        // Parse platform:// URIs (e.g. platform://moltbook/feed.read)
-        if (ref.uri && ref.uri.startsWith("platform://")) {
-            const afterScheme = ref.uri.slice("platform://".length);
-            const platformPart = afterScheme.split("/")[0];
-            if (platformPart && platformIds.includes(platformPart)) {
-                results.add(platformPart);
-            }
-        }
-        // L-02: Also support namespace format moltbook:feed.read (connector-system §5.3)
-        if (ref.uri && !ref.uri.includes("://") && ref.uri.includes(":")) {
-            const nsPart = ref.uri.split(":")[0];
-            if (nsPart && platformIds.includes(nsPart)) {
-                results.add(nsPart);
-            }
-        }
-    }
-    return [...results];
-}
-function validatePlatformCapability(platformId, kind, registry) {
-    const capability = kindToCapability(kind);
-    if (!capability)
-        return false;
-    try {
-        return registry.hasCapability(platformId, capability);
-    }
-    catch (err) {
-        // H-08: Log registry validation failures for observability.
-        console.warn(`[platform-capability-router] Registry validation failed for ${platformId}:${capability}`, err);
-        return false;
-    }
-}
-/**
- * Resolve an explicit platformId for a candidate intent kind.
- * Returns `undefined` when no unambiguous platform can be inferred.
- */
-export function resolvePlatformForIntent(kind, context, registry) {
-    const capability = kindToCapability(kind);
-    if (!capability) {
-        // Quiet, reflection, maintenance have no connector capability mapping.
-        return undefined;
-    }
-    const platformIds = getPlatformIds(registry);
-    const candidates = [];
-    if (context.acceptedGoals && context.acceptedGoals.length > 0) {
-        candidates.push(...extractPlatformIdsFromGoals(context.acceptedGoals, kind, platformIds));
-    }
-    if (context.evidenceRefs && context.evidenceRefs.length > 0) {
-        candidates.push(...extractPlatformIdsFromEvidence(context.evidenceRefs, platformIds));
-    }
-    // Deduplicate while preserving order
-    const ordered = [...new Set(candidates)];
-    if (ordered.length === 0) {
-        return undefined;
-    }
-    if (ordered.length > 1) {
-        // Ambiguous: multiple platforms inferred → do not guess, return undefined.
-        // Guard layer will deny with "ambiguous_platform" reason.
-        return undefined;
-    }
-    const single = ordered[0];
-    if (registry) {
-        if (validatePlatformCapability(single, kind, registry)) {
-            return single;
-        }
-        // Registry says unsupported → undefined (guard layer will deny)
-        return undefined;
-    }
-    // No registry: keep legacy platform-name fallback, but do not invent an
-    // unsupported platform/capability pair that later fails as protocol_mismatch.
-    if (!fallbackPlatformSupportsCapability(single, kind)) {
-        return undefined;
-    }
-    return single;
-}
+function kindToCapability(kind) {
+    if (kind === "exploration")
+        return "feed.read";
+    if (kind === "social")
+        return "comment.reply";
+    if (kind === "work")
+        return "work.discover";
+    if (kind === "outreach")
+        return "message.send";
+    return null;
+}
+function getPlatformIds(registry) {
+    if (registry) {
+        return registry.listRegisteredPlatformIds();
+    }
+    // Fallback: built-in platforms when registry is absent (backward compat)
+    return ["moltbook", "instreet", "evomap", "agent-world"];
+}
+const FALLBACK_PLATFORM_CAPABILITIES = {
+    "moltbook": ["feed.read", "post.publish", "comment.reply", "message.send"],
+    "instreet": ["notification.list", "message.send", "comment.reply", "agent.heartbeat"],
+    "evomap": ["agent.register", "agent.heartbeat", "work.discover", "task.claim"],
+    "agent-world": ["feed.read", "work.discover", "task.claim"],
+};
+function fallbackPlatformSupportsCapability(platformId, kind) {
+    const capability = kindToCapability(kind);
+    if (!capability)
+        return false;
+    return (FALLBACK_PLATFORM_CAPABILITIES[platformId] ?? []).includes(capability);
+}
+function extractPlatformIdsFromGoals(goals, kind, platformIds) {
+    const capability = kindToCapability(kind);
+    const results = new Set();
+    for (const goal of goals) {
+        const text = `${goal.description} ${goal.completionCriteria ?? ""}`.toLowerCase();
+        for (const pid of platformIds) {
+            if (text.includes(pid)) {
+                results.add(pid);
+            }
+        }
+        // Also match if goal text contains the capability name (e.g. "feed.read")
+        if (capability && text.includes(capability.toLowerCase())) {
+            // capability alone doesn't tell us platform; keep for later
+        }
+    }
+    return [...results];
+}
+function extractPlatformIdsFromEvidence(refs, platformIds) {
+    const results = new Set();
+    for (const ref of refs) {
+        if (ref.kind === "connector_result" && ref.id) {
+            for (const pid of platformIds) {
+                if (ref.id.includes(pid)) {
+                    results.add(pid);
+                }
+            }
+        }
+        // Parse platform:// URIs (e.g. platform://moltbook/feed.read)
+        if (ref.uri && ref.uri.startsWith("platform://")) {
+            const afterScheme = ref.uri.slice("platform://".length);
+            const platformPart = afterScheme.split("/")[0];
+            if (platformPart && platformIds.includes(platformPart)) {
+                results.add(platformPart);
+            }
+        }
+        // L-02: Also support namespace format moltbook:feed.read (connector-system §5.3)
+        if (ref.uri && !ref.uri.includes("://") && ref.uri.includes(":")) {
+            const nsPart = ref.uri.split(":")[0];
+            if (nsPart && platformIds.includes(nsPart)) {
+                results.add(nsPart);
+            }
+        }
+    }
+    return [...results];
+}
+function validatePlatformCapability(platformId, kind, registry) {
+    const capability = kindToCapability(kind);
+    if (!capability)
+        return false;
+    try {
+        return registry.hasCapability(platformId, capability);
+    }
+    catch (err) {
+        // H-08: Log registry validation failures for observability.
+        console.warn(`[platform-capability-router] Registry validation failed for ${platformId}:${capability}`, err);
+        return false;
+    }
+}
+/**
+ * Resolve an explicit platformId for a candidate intent kind.
+ * Returns `undefined` when no unambiguous platform can be inferred.
+ */
+export function resolvePlatformForIntent(kind, context, registry) {
+    const capability = kindToCapability(kind);
+    if (!capability) {
+        // Quiet, reflection, maintenance have no connector capability mapping.
+        return undefined;
+    }
+    const platformIds = getPlatformIds(registry);
+    const candidates = [];
+    if (context.acceptedGoals && context.acceptedGoals.length > 0) {
+        candidates.push(...extractPlatformIdsFromGoals(context.acceptedGoals, kind, platformIds));
+    }
+    if (context.evidenceRefs && context.evidenceRefs.length > 0) {
+        candidates.push(...extractPlatformIdsFromEvidence(context.evidenceRefs, platformIds));
+    }
+    // Deduplicate while preserving order
+    const ordered = [...new Set(candidates)];
+    if (ordered.length > 1) {
+        // Ambiguous: multiple platforms inferred → do not guess, return undefined.
+        // Guard layer will deny with "ambiguous_platform" reason.
+        return undefined;
+    }
+    if (ordered.length === 1) {
+        const single = ordered[0];
+        if (registry) {
+            if (validatePlatformCapability(single, kind, registry)) {
+                return single;
+            }
+            // Registry says unsupported → undefined (guard layer will deny)
+            return undefined;
+        }
+        // No registry: keep legacy platform-name fallback, but do not invent an
+        // unsupported platform/capability pair that later fails as protocol_mismatch.
+        if (!fallbackPlatformSupportsCapability(single, kind)) {
+            return undefined;
+        }
+        return single;
+    }
+    // No candidates inferred from goals/evidence → fallback to a supported platform.
+    // Sort alphabetically so different capabilities map to different platforms over time,
+    // preventing a single platform (e.g. moltbook) from monopolising all connector traffic.
+    if (registry) {
+        const supported = platformIds
+            .filter((pid) => validatePlatformCapability(pid, kind, registry))
+            .sort();
+        if (supported.length > 0) {
+            return supported[0];
+        }
+    }
+    // No registry: use fallback capability mapping
+    const supportedFallback = platformIds
+        .filter((pid) => fallbackPlatformSupportsCapability(pid, kind))
+        .sort();
+    if (supportedFallback.length > 0) {
+        return supportedFallback[0];
+    }
+    return undefined;
+}