@haaaiawd/second-nature 0.1.17 → 0.1.18

package/runtime/connectors/base/route-planner.js

@@ -1,99 +1,99 @@
-import { ConnectorPolicyError } from "./failure-taxonomy.js";
-const HIGH_RISK_SIDE_EFFECTS = new Set([
-    "post.publish",
-    "comment.reply",
-    "message.send",
-    "task.claim",
-]);
-function endpointModeFor(channel) {
-    if (channel === "a2a")
-        return "a2a_envelope";
-    if (channel === "cli")
-        return "cli_stdout";
-    if (channel === "skill" || channel === "browser")
-        return "skill_call";
-    return "rest_json";
-}
-const DEFAULT_DEGRADED_CHANNELS = ["cli", "skill", "browser"];
-function isDegradedChannel(channel, degradedChannels) {
-    const policy = degradedChannels && degradedChannels.length > 0 ? degradedChannels : DEFAULT_DEGRADED_CHANNELS;
-    return policy.includes(channel);
-}
-function chooseByCredentialState(channels, credential) {
-    if (credential.status === "pending_verification") {
-        if (channels.includes("skill"))
-            return "skill";
-        if (channels.includes("browser"))
-            return "browser";
-        throw new ConnectorPolicyError("verification_required", "verification_recovery_channel_missing");
-    }
-    return undefined;
-}
-function choosePreferred(channels, preferred) {
-    if (preferred && channels.includes(preferred))
-        return preferred;
-    return undefined;
-}
-function chooseHealthy(channels, platformId, health) {
-    for (const channel of channels) {
-        const snapshot = health.get(platformId, channel);
-        if (!snapshot)
-            return channel;
-        if (snapshot.healthy && !snapshot.degraded)
-            return channel;
-        if (snapshot.healthy)
-            return channel;
-    }
-    return channels[0];
-}
-function enforceSideEffectSafety(intent, channel, degradedChannels) {
-    if (!HIGH_RISK_SIDE_EFFECTS.has(intent)) {
-        return;
-    }
-    if (isDegradedChannel(channel, degradedChannels)) {
-        throw new ConnectorPolicyError("protocol_mismatch", "degraded_channel_not_allowed_for_side_effect");
-    }
-}
-export class ConnectorRoutePlanner {
-    registry;
-    statePort;
-    channelHealth;
-    constructor(registry, statePort, channelHealth) {
-        this.registry = registry;
-        this.statePort = statePort;
-        this.channelHealth = channelHealth;
-    }
-    async planRoute(intent, request) {
-        const manifest = this.registry.loadManifest(request.platformId);
-        if (!manifest.supportedCapabilities.includes(intent)) {
-            throw new ConnectorPolicyError("protocol_mismatch", "capability_not_supported_by_manifest");
-        }
-        const cooldown = await this.statePort.loadCooldownState(request.platformId, intent);
-        if (cooldown.blocked) {
-            throw new ConnectorPolicyError("cooldown_blocked", "platform_or_intent_cooldown_blocked", cooldown.retryAfterMs);
-        }
-        const credential = await this.statePort.loadCredentialState(request.platformId);
-        if (credential.status === "missing" || credential.status === "revoked" || credential.status === "failed") {
-            throw new ConnectorPolicyError("auth_failure", "credential_unavailable_for_route");
-        }
-        if (credential.status === "expired") {
-            throw new ConnectorPolicyError("credential_expired", "credential_expired_for_route");
-        }
-        const channels = [...manifest.channelPriority];
-        const byCredential = chooseByCredentialState(channels, credential);
-        const preferred = choosePreferred(channels, request.preferredChannel);
-        const selected = byCredential ?? preferred ?? chooseHealthy(channels, request.platformId, this.channelHealth);
-        if (!selected) {
-            throw new ConnectorPolicyError("protocol_mismatch", "no_available_channel");
-        }
-        enforceSideEffectSafety(intent, selected, manifest.degradedChannels);
-        return {
-            platformId: request.platformId,
-            intent,
-            channel: selected,
-            endpointMode: endpointModeFor(selected),
-            idempotencyKey: request.idempotencyKey,
-            degraded: isDegradedChannel(selected, manifest.degradedChannels),
-        };
-    }
-}
+import { ConnectorPolicyError } from "./failure-taxonomy.js";
+const HIGH_RISK_SIDE_EFFECTS = new Set([
+    "post.publish",
+    "comment.reply",
+    "message.send",
+    "task.claim",
+]);
+function endpointModeFor(channel) {
+    if (channel === "a2a")
+        return "a2a_envelope";
+    if (channel === "cli")
+        return "cli_stdout";
+    if (channel === "skill" || channel === "browser")
+        return "skill_call";
+    return "rest_json";
+}
+const DEFAULT_DEGRADED_CHANNELS = ["cli", "skill", "browser"];
+function isDegradedChannel(channel, degradedChannels) {
+    const policy = degradedChannels && degradedChannels.length > 0 ? degradedChannels : DEFAULT_DEGRADED_CHANNELS;
+    return policy.includes(channel);
+}
+function chooseByCredentialState(channels, credential) {
+    if (credential.status === "pending_verification") {
+        if (channels.includes("skill"))
+            return "skill";
+        if (channels.includes("browser"))
+            return "browser";
+        throw new ConnectorPolicyError("verification_required", "verification_recovery_channel_missing");
+    }
+    return undefined;
+}
+function choosePreferred(channels, preferred) {
+    if (preferred && channels.includes(preferred))
+        return preferred;
+    return undefined;
+}
+function chooseHealthy(channels, platformId, health) {
+    for (const channel of channels) {
+        const snapshot = health.get(platformId, channel);
+        if (!snapshot)
+            return channel;
+        if (snapshot.healthy && !snapshot.degraded)
+            return channel;
+        if (snapshot.healthy)
+            return channel;
+    }
+    return channels[0];
+}
+function enforceSideEffectSafety(intent, channel, degradedChannels) {
+    if (!HIGH_RISK_SIDE_EFFECTS.has(intent)) {
+        return;
+    }
+    if (isDegradedChannel(channel, degradedChannels)) {
+        throw new ConnectorPolicyError("protocol_mismatch", "degraded_channel_not_allowed_for_side_effect");
+    }
+}
+export class ConnectorRoutePlanner {
+    registry;
+    statePort;
+    channelHealth;
+    constructor(registry, statePort, channelHealth) {
+        this.registry = registry;
+        this.statePort = statePort;
+        this.channelHealth = channelHealth;
+    }
+    async planRoute(intent, request) {
+        const manifest = this.registry.loadManifest(request.platformId);
+        if (!manifest.supportedCapabilities.includes(intent)) {
+            throw new ConnectorPolicyError("protocol_mismatch", "capability_not_supported_by_manifest");
+        }
+        const cooldown = await this.statePort.loadCooldownState(request.platformId, intent);
+        if (cooldown.blocked) {
+            throw new ConnectorPolicyError("cooldown_blocked", "platform_or_intent_cooldown_blocked", cooldown.retryAfterMs);
+        }
+        const credential = await this.statePort.loadCredentialState(request.platformId);
+        if (credential.status === "missing" || credential.status === "revoked" || credential.status === "failed") {
+            throw new ConnectorPolicyError("auth_failure", "credential_unavailable_for_route");
+        }
+        if (credential.status === "expired") {
+            throw new ConnectorPolicyError("credential_expired", "credential_expired_for_route");
+        }
+        const channels = [...manifest.channelPriority];
+        const byCredential = chooseByCredentialState(channels, credential);
+        const preferred = choosePreferred(channels, request.preferredChannel);
+        const selected = byCredential ?? preferred ?? chooseHealthy(channels, request.platformId, this.channelHealth);
+        if (!selected) {
+            throw new ConnectorPolicyError("protocol_mismatch", "no_available_channel");
+        }
+        enforceSideEffectSafety(intent, selected, manifest.degradedChannels);
+        return {
+            platformId: request.platformId,
+            intent,
+            channel: selected,
+            endpointMode: endpointModeFor(selected),
+            idempotencyKey: request.idempotencyKey,
+            degraded: isDegradedChannel(selected, manifest.degradedChannels),
+        };
+    }
+}

package/runtime/connectors/index.d.ts

@@ -1,5 +1,5 @@
-export * from "./base/index.js";
-export * from "./social-community/moltbook/index.js";
-export * from "./social-community/instreet/index.js";
-export * from "./agent-network/evomap/index.js";
-export * from "./near-real/near-real-connector-smoke.js";
+export * from "./base/index.js";
+export * from "./social-community/moltbook/index.js";
+export * from "./social-community/instreet/index.js";
+export * from "./agent-network/evomap/index.js";
+export * from "./near-real/near-real-connector-smoke.js";

package/runtime/connectors/index.js

@@ -1,5 +1,5 @@
-export * from "./base/index.js";
-export * from "./social-community/moltbook/index.js";
-export * from "./social-community/instreet/index.js";
-export * from "./agent-network/evomap/index.js";
-export * from "./near-real/near-real-connector-smoke.js";
+export * from "./base/index.js";
+export * from "./social-community/moltbook/index.js";
+export * from "./social-community/instreet/index.js";
+export * from "./agent-network/evomap/index.js";
+export * from "./near-real/near-real-connector-smoke.js";

package/runtime/connectors/near-real/near-real-connector-smoke.d.ts

@@ -1,19 +1,19 @@
-import type { ObservabilityDatabase } from "../../observability/db/index.js";
-import type { StateDatabase } from "../../storage/db/index.js";
-export interface NearRealConnectorSmokeResult {
-    generatedAt: string;
-    platforms: {
-        social: "moltbook";
-        agentNetwork: "evomap";
-    };
-    feedReadEvidenceId?: string;
-    workDiscoverEvidenceId?: string;
-    taskClaimDryRunOk: boolean;
-    executionAttemptRowsForDecision: number;
-}
-export interface RunNearRealConnectorSmokeInput {
-    state: StateDatabase;
-    observabilityDb: ObservabilityDatabase;
-    workspaceRoot: string;
-}
-export declare function runNearRealConnectorSmoke(input: RunNearRealConnectorSmokeInput): Promise<NearRealConnectorSmokeResult>;
+import type { ObservabilityDatabase } from "../../observability/db/index.js";
+import type { StateDatabase } from "../../storage/db/index.js";
+export interface NearRealConnectorSmokeResult {
+    generatedAt: string;
+    platforms: {
+        social: "moltbook";
+        agentNetwork: "evomap";
+    };
+    feedReadEvidenceId?: string;
+    workDiscoverEvidenceId?: string;
+    taskClaimDryRunOk: boolean;
+    executionAttemptRowsForDecision: number;
+}
+export interface RunNearRealConnectorSmokeInput {
+    state: StateDatabase;
+    observabilityDb: ObservabilityDatabase;
+    workspaceRoot: string;
+}
+export declare function runNearRealConnectorSmoke(input: RunNearRealConnectorSmokeInput): Promise<NearRealConnectorSmokeResult>;

package/runtime/connectors/near-real/near-real-connector-smoke.js

@@ -1,152 +1,152 @@
-/**
- * T3.3.1 — Near-real connector smoke: sentinel adapters + policy + telemetry + life evidence ingest.
- * Uses fixture payloads (no live HTTP); task.claim runs with idempotency key (dry-run style outcome).
- */
-import { eq } from "drizzle-orm";
-import { CapabilityContractRegistry } from "../base/manifest.js";
-import { ConnectorRoutePlanner } from "../base/route-planner.js";
-import { ChannelHealthStore } from "../base/channel-health.js";
-import { createConnectorPolicyLayer } from "../base/policy-layer.js";
-import { InMemoryEffectCommitLedger } from "../base/execution-policy.js";
-import { mapLifeEvidence } from "../base/map-life-evidence.js";
-import { moltbookManifest } from "../social-community/moltbook/manifest.js";
-import { evomapManifest } from "../agent-network/evomap/manifest.js";
-import { ExecutionTelemetry } from "../../observability/services/execution-telemetry.js";
-import { executionAttempts } from "../../observability/db/schema/index.js";
-import { appendLifeEvidence } from "../../storage/life-evidence/append-life-evidence.js";
-const DECISION_ID = "dec-near-real-smoke";
-function smokeRouteContext() {
-    return {
-        async loadCredentialState(platformId) {
-            if (platformId === "moltbook") {
-                return { platformId, status: "active", credentialType: "api_key" };
-            }
-            if (platformId === "evomap") {
-                return { platformId, status: "active", credentialType: "node_secret" };
-            }
-            throw new Error(`near_real_smoke_unsupported_platform:${platformId}`);
-        },
-        async loadCooldownState() {
-            return { blocked: false };
-        },
-    };
-}
-const smokeExecutionRunner = {
-    async run(plan, request) {
-        if (plan.platformId === "moltbook" && plan.intent === "feed.read") {
-            return {
-                platformId: plan.platformId,
-                channel: plan.channel,
-                latencyMs: 2,
-                success: true,
-                payload: {
-                    items: [{ id: "mb-smoke-1", title: "near-real fixture post" }],
-                },
-            };
-        }
-        if (plan.platformId === "evomap" && plan.intent === "work.discover") {
-            return {
-                platformId: plan.platformId,
-                channel: plan.channel,
-                latencyMs: 3,
-                success: true,
-                payload: {
-                    items: [{ id: "ev-task-smoke-1", title: "fixture agent task" }],
-                },
-            };
-        }
-        if (plan.platformId === "evomap" && plan.intent === "task.claim") {
-            return {
-                platformId: plan.platformId,
-                channel: plan.channel,
-                latencyMs: 1,
-                success: true,
-                degraded: plan.degraded,
-                payload: {
-                    dryRun: true,
-                    taskId: typeof request.payload.taskId === "string" ? request.payload.taskId : "unknown",
-                    note: "near_real_smoke_no_external_side_effect",
-                },
-            };
-        }
-        throw new Error(`near_real_smoke_unhandled:${plan.platformId}:${plan.intent}`);
-    },
-};
-export async function runNearRealConnectorSmoke(input) {
-    const ledger = new InMemoryEffectCommitLedger();
-    const registry = new CapabilityContractRegistry();
-    registry.register({ ...moltbookManifest });
-    registry.register({ ...evomapManifest });
-    const planner = new ConnectorRoutePlanner(registry, smokeRouteContext(), new ChannelHealthStore());
-    const telemetry = new ExecutionTelemetry(input.observabilityDb);
-    const policy = createConnectorPolicyLayer({
-        routePlanner: planner,
-        executionRunner: smokeExecutionRunner,
-        telemetry,
-        effectCommitLedger: ledger,
-        retryPolicy: { maxRetries: 1, jitter: false },
-    });
-    const base = {
-        decisionId: DECISION_ID,
-        payload: {},
-    };
-    const feedResult = await policy.executeWithPolicy("feed.read", {
-        platformId: "moltbook",
-        intent: "feed.read",
-        ...base,
-        intentId: "intent-smoke-feed-read",
-        payload: {},
-    });
-    let feedReadEvidenceId;
-    const feedCand = mapLifeEvidence({
-        platformId: "moltbook",
-        intent: "feed.read",
-        result: feedResult,
-    });
-    if (feedCand) {
-        const ack = await appendLifeEvidence(input.state, input.workspaceRoot, feedCand);
-        feedReadEvidenceId = ack.evidenceId;
-    }
-    const workResult = await policy.executeWithPolicy("work.discover", {
-        platformId: "evomap",
-        intent: "work.discover",
-        ...base,
-        intentId: "intent-smoke-work-discover",
-        payload: {},
-    });
-    let workDiscoverEvidenceId;
-    const workCand = mapLifeEvidence({
-        platformId: "evomap",
-        intent: "work.discover",
-        result: workResult,
-    });
-    if (workCand) {
-        const ack = await appendLifeEvidence(input.state, input.workspaceRoot, workCand);
-        workDiscoverEvidenceId = ack.evidenceId;
-    }
-    const claimResult = await policy.executeWithPolicy("task.claim", {
-        platformId: "evomap",
-        intent: "task.claim",
-        ...base,
-        intentId: "intent-smoke-task-claim",
-        payload: { taskId: "ev-task-smoke-1" },
-        idempotencyKey: "idem-near-real-task-claim-smoke",
-    });
-    const claimPayload = claimResult.status === "success" && claimResult.data && typeof claimResult.data === "object"
-        ? claimResult.data
-        : undefined;
-    const attemptRows = await input.observabilityDb.db
-        .select()
-        .from(executionAttempts)
-        .where(eq(executionAttempts.decisionId, DECISION_ID));
-    return {
-        generatedAt: new Date().toISOString(),
-        platforms: { social: "moltbook", agentNetwork: "evomap" },
-        feedReadEvidenceId,
-        workDiscoverEvidenceId,
-        taskClaimDryRunOk: claimResult.status === "success" &&
-            claimPayload?.dryRun === true &&
-            claimPayload?.note === "near_real_smoke_no_external_side_effect",
-        executionAttemptRowsForDecision: attemptRows.length,
-    };
-}
+/**
+ * T3.3.1 — Near-real connector smoke: sentinel adapters + policy + telemetry + life evidence ingest.
+ * Uses fixture payloads (no live HTTP); task.claim runs with idempotency key (dry-run style outcome).
+ */
+import { eq } from "drizzle-orm";
+import { CapabilityContractRegistry } from "../base/manifest.js";
+import { ConnectorRoutePlanner } from "../base/route-planner.js";
+import { ChannelHealthStore } from "../base/channel-health.js";
+import { createConnectorPolicyLayer } from "../base/policy-layer.js";
+import { InMemoryEffectCommitLedger } from "../base/execution-policy.js";
+import { mapLifeEvidence } from "../base/map-life-evidence.js";
+import { moltbookManifest } from "../social-community/moltbook/manifest.js";
+import { evomapManifest } from "../agent-network/evomap/manifest.js";
+import { ExecutionTelemetry } from "../../observability/services/execution-telemetry.js";
+import { executionAttempts } from "../../observability/db/schema/index.js";
+import { appendLifeEvidence } from "../../storage/life-evidence/append-life-evidence.js";
+const DECISION_ID = "dec-near-real-smoke";
+function smokeRouteContext() {
+    return {
+        async loadCredentialState(platformId) {
+            if (platformId === "moltbook") {
+                return { platformId, status: "active", credentialType: "api_key" };
+            }
+            if (platformId === "evomap") {
+                return { platformId, status: "active", credentialType: "node_secret" };
+            }
+            throw new Error(`near_real_smoke_unsupported_platform:${platformId}`);
+        },
+        async loadCooldownState() {
+            return { blocked: false };
+        },
+    };
+}
+const smokeExecutionRunner = {
+    async run(plan, request) {
+        if (plan.platformId === "moltbook" && plan.intent === "feed.read") {
+            return {
+                platformId: plan.platformId,
+                channel: plan.channel,
+                latencyMs: 2,
+                success: true,
+                payload: {
+                    items: [{ id: "mb-smoke-1", title: "near-real fixture post" }],
+                },
+            };
+        }
+        if (plan.platformId === "evomap" && plan.intent === "work.discover") {
+            return {
+                platformId: plan.platformId,
+                channel: plan.channel,
+                latencyMs: 3,
+                success: true,
+                payload: {
+                    items: [{ id: "ev-task-smoke-1", title: "fixture agent task" }],
+                },
+            };
+        }
+        if (plan.platformId === "evomap" && plan.intent === "task.claim") {
+            return {
+                platformId: plan.platformId,
+                channel: plan.channel,
+                latencyMs: 1,
+                success: true,
+                degraded: plan.degraded,
+                payload: {
+                    dryRun: true,
+                    taskId: typeof request.payload.taskId === "string" ? request.payload.taskId : "unknown",
+                    note: "near_real_smoke_no_external_side_effect",
+                },
+            };
+        }
+        throw new Error(`near_real_smoke_unhandled:${plan.platformId}:${plan.intent}`);
+    },
+};
+export async function runNearRealConnectorSmoke(input) {
+    const ledger = new InMemoryEffectCommitLedger();
+    const registry = new CapabilityContractRegistry();
+    registry.register({ ...moltbookManifest });
+    registry.register({ ...evomapManifest });
+    const planner = new ConnectorRoutePlanner(registry, smokeRouteContext(), new ChannelHealthStore());
+    const telemetry = new ExecutionTelemetry(input.observabilityDb);
+    const policy = createConnectorPolicyLayer({
+        routePlanner: planner,
+        executionRunner: smokeExecutionRunner,
+        telemetry,
+        effectCommitLedger: ledger,
+        retryPolicy: { maxRetries: 1, jitter: false },
+    });
+    const base = {
+        decisionId: DECISION_ID,
+        payload: {},
+    };
+    const feedResult = await policy.executeWithPolicy("feed.read", {
+        platformId: "moltbook",
+        intent: "feed.read",
+        ...base,
+        intentId: "intent-smoke-feed-read",
+        payload: {},
+    });
+    let feedReadEvidenceId;
+    const feedCand = mapLifeEvidence({
+        platformId: "moltbook",
+        intent: "feed.read",
+        result: feedResult,
+    });
+    if (feedCand) {
+        const ack = await appendLifeEvidence(input.state, input.workspaceRoot, feedCand);
+        feedReadEvidenceId = ack.evidenceId;
+    }
+    const workResult = await policy.executeWithPolicy("work.discover", {
+        platformId: "evomap",
+        intent: "work.discover",
+        ...base,
+        intentId: "intent-smoke-work-discover",
+        payload: {},
+    });
+    let workDiscoverEvidenceId;
+    const workCand = mapLifeEvidence({
+        platformId: "evomap",
+        intent: "work.discover",
+        result: workResult,
+    });
+    if (workCand) {
+        const ack = await appendLifeEvidence(input.state, input.workspaceRoot, workCand);
+        workDiscoverEvidenceId = ack.evidenceId;
+    }
+    const claimResult = await policy.executeWithPolicy("task.claim", {
+        platformId: "evomap",
+        intent: "task.claim",
+        ...base,
+        intentId: "intent-smoke-task-claim",
+        payload: { taskId: "ev-task-smoke-1" },
+        idempotencyKey: "idem-near-real-task-claim-smoke",
+    });
+    const claimPayload = claimResult.status === "success" && claimResult.data && typeof claimResult.data === "object"
+        ? claimResult.data
+        : undefined;
+    const attemptRows = await input.observabilityDb.db
+        .select()
+        .from(executionAttempts)
+        .where(eq(executionAttempts.decisionId, DECISION_ID));
+    return {
+        generatedAt: new Date().toISOString(),
+        platforms: { social: "moltbook", agentNetwork: "evomap" },
+        feedReadEvidenceId,
+        workDiscoverEvidenceId,
+        taskClaimDryRunOk: claimResult.status === "success" &&
+            claimPayload?.dryRun === true &&
+            claimPayload?.note === "near_real_smoke_no_external_side_effect",
+        executionAttemptRowsForDecision: attemptRows.length,
+    };
+}