@haaaiawd/second-nature 0.1.29 → 0.1.31

package/index.js

@@ -58,23 +58,11 @@ import { fileURLToPath } from "node:url";
 import { startRuntimeService, } from "./runtime/core/second-nature/runtime/service-entry.js";
 import { getLifecycleState, recordRegistration, } from "./runtime/core/second-nature/runtime/lifecycle-service.js";
 import { openWorkspaceOpsBridge } from "./workspace-ops-bridge.js";
-// definePluginEntry is OpenClaw's canonical factory for non-channel plugins
-// (provider/tool/command/service/memory/context-engine). At runtime it returns
-// a plain options object; it does NOT add a brand symbol — earlier debugging
-// rounds wrongly assumed the factory was the "plain-capability" marker. The
-// real classification happens via manifest fields (see file header). We still
-// use the factory because it is the documented, supported entry shape, and
-// keeping it future-proof against SDK option-processing changes.
-//
-// IMPORTANT — keep this a STATIC import. The packaged runtime is loaded inside
-// OpenClaw's vm sandbox, which rejects top-level await (manifests as
-// "SyntaxError: Unexpected identifier 'Promise'" at host load time). The same
-// constraint applies to the sql.js async bootstrap noted in the file header.
-// In production the host always provides `openclaw` as a sibling module under
-// ~/.openclaw/npm/node_modules/, so this resolves synchronously. Locally,
-// `openclaw` is declared as a devDependency so build and tests resolve via
-// the same import path.
-import { definePluginEntry } from "openclaw/plugin-sdk/plugin-entry";
+// Keep the entry as a plain object instead of importing OpenClaw's
+// SDK entry helper. Upload/package validators may import this module
+// before the host SDK is installed; a static SDK import turns a valid package
+// into ERR_MODULE_NOT_FOUND. OpenClaw classifies this plugin from the manifest
+// fields, and the helper returns this same object shape at runtime.
 // Stderr sentinels make daemon load-path observable in `gateway.log`. Three
 // lines should appear at startup: "module evaluated", "register() entered ...",
 // "register() completed". Their absence after `openclaw gateway run` proves
@@ -83,7 +71,7 @@ process.stderr.write("[second-nature] module evaluated\n");
 const INTERNAL_RUNTIME_TRACE_PREFIX = "sn-runtime-";
 const HOST_SAFE_LIMITATION_MESSAGE = "Host-safe plugin package keeps synchronous register/load semantics, but mutating workspace runtime flows remain unavailable here.";
 const SETUP_MARKER_RELATIVE_PATH = path.join(".second-nature", "setup", "agent-inner-guide-ack.json");
-const SETUP_GUIDE_VERSION = "0.1.28";
+const SETUP_GUIDE_VERSION = "0.1.31";
 const SETUP_COMMANDS = new Set(["setup_hint", "setup_ack"]);
 let activationSpine = null;
 /** T1.1.4 — lazily opened full read bridge; closed when workspace root / resolution changes. */
@@ -1189,7 +1177,7 @@ const SECOND_NATURE_TOOL_SCHEMA = {
     },
     required: ["command"],
 };
-export default definePluginEntry({
+export default {
     id: "second-nature",
     name: "Second Nature",
     description: "Registers command/tool/service surface with load-reload lifecycle semantics.",
@@ -1264,4 +1252,4 @@ export default definePluginEntry({
         });
         process.stderr.write("[second-nature] register() completed\n");
     },
-});
+};

package/openclaw.plugin.json

@@ -1,7 +1,7 @@
 {
   "id": "second-nature",
   "name": "Second Nature",
-  "version": "0.1.29",
+  "version": "0.1.31",
   "description": "OpenClaw native plugin with synchronous surface registration and bundled runtime spine. Set SECOND_NATURE_WORKSPACE_ROOT or tool workspaceRoot to the same path as the agent workspace. Agent inner guide is packaged as agent-inner-guide.md. v7 ops surface: self_health, tool_affordance, heartbeat_digest, narrative:diff, timeline, restore, runtime_secret_bootstrap.",
   "activation": {
     "onStartup": true,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@haaaiawd/second-nature",
-  "version": "0.1.29",
+  "version": "0.1.31",
   "description": "OpenClaw native plugin with synchronous registration, a packaged runtime artifact, and operator-facing status/explain flows.",
   "keywords": [
     "openclaw",

package/runtime/cli/commands/connector-status.d.ts

@@ -7,6 +7,7 @@ export interface ConnectorStatusInput {
 export interface ConnectorTestInput {
     platformId: string;
     dryRun?: boolean;
+    workspaceRoot?: string;
 }
 export declare function connectorStatus(registry: DynamicConnectorRegistry | undefined, ledger: ConnectorInventoryLedger | undefined, input?: ConnectorStatusInput): Promise<Record<string, unknown>>;
 export declare function connectorTest(registry: DynamicConnectorRegistry | undefined, input: ConnectorTestInput): Promise<Record<string, unknown>>;

package/runtime/cli/commands/connector-status.js

@@ -97,6 +97,11 @@ export async function connectorTest(registry, input) {
             },
         };
     }
+    // Workspace bridge calls are often process-isolated per tool invocation.
+    // Reload here as well as in connector_status so dry-run tests see the same inventory.
+    if (input.workspaceRoot) {
+        registry.reloadConnectors(input.workspaceRoot);
+    }
     const entry = registry.describeConnector(platformId);
     if (!entry) {
         return {

package/runtime/cli/commands/index.js

@@ -23,6 +23,14 @@ function explainSubjectError(code, message) {
 }
 export function createCliCommands(deps) {
     const { readModels, actionBridge, opsRouter } = deps;
+    const opsCommand = (name, description) => ({
+        name,
+        description,
+        execute: async (input) => {
+            const surface = await Promise.resolve(opsRouter.dispatch(name, input));
+            return surface;
+        },
+    });
     return [
         {
             name: "status",
@@ -268,6 +276,14 @@ export function createCliCommands(deps) {
                 return surface;
             },
         },
+        opsCommand("connector:run", "T-ROS.C.3 — manually execute a connector capability outside heartbeat cadence"),
+        opsCommand("self_health", "T-ROS.C.1 — show v7 self-health snapshot and degraded dimensions"),
+        opsCommand("tool_affordance", "T-ROS.C.1 — show v7 tool affordance map or explicit unavailable state"),
+        opsCommand("heartbeat_digest", "T-ROS.C.1 — assemble v7 heartbeat digest for a day"),
+        opsCommand("narrative:diff", "T-ROS.C.1 — compare two narrative timeline versions"),
+        opsCommand("timeline", "T-ROS.C.1 — query v7 narrative timeline with cursor pagination"),
+        opsCommand("restore", "T-ROS.C.1 — apply bounded restore and write restore audit"),
+        opsCommand("runtime_secret_bootstrap", "T-ROS.C.1 — inspect runtime secret anchor health without exposing plaintext"),
         {
             name: "goal",
             description: "T1.2.4 — owner-governed goal operations: set, list, accept, reject",

package/runtime/cli/ops/ops-router.js

@@ -249,6 +249,9 @@ export function createOpsRouter(deps) {
                 const result = await connectorTest(deps.registry, {
                     platformId: typeof input?.platformId === "string" ? input.platformId : "",
                     dryRun: isWet ? false : (input?.dryRun === false ? false : true),
+                    workspaceRoot: typeof input?.workspaceRoot === "string"
+                        ? input.workspaceRoot
+                        : deps.workspaceRoot,
                 });
                 if (isWet && result.ok) {
                     // Annotate result with manual trigger context (DR-038 / T-ROS.C.3)

package/runtime/core/second-nature/orchestrator/intent-planner.js

@@ -79,6 +79,9 @@ export function planIntentWithKind(kind, basePriority, runtime, context, registr
         return [];
     const config = INTENT_CONFIGS[kind];
     const platformId = resolvePlatformForIntent(kind, context ?? {}, registry);
+    if (kind === "work" && !options?.multiSource && !platformId) {
+        return [];
+    }
     let priority = basePriority;
     // Social budget exhaustion → cap priority.
     if (kind === "social" &&

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

@@ -14,7 +14,19 @@ function getPlatformIds(registry) {
         return registry.listRegisteredPlatformIds();
     }
     // Fallback: built-in platforms when registry is absent (backward compat)
-    return ["moltbook", "instreet", "evomap"];
+    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);
@@ -110,6 +122,10 @@ export function resolvePlatformForIntent(kind, context, registry) {
         // Registry says unsupported → undefined (guard layer will deny)
         return undefined;
     }
-    // No registry: best-effort return the single candidate (backward compat)
+    // 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;
 }

package/workspace-ops-bridge.js

@@ -23,7 +23,19 @@ import fs from "node:fs";
 import path from "node:path";
 import { fileURLToPath } from "node:url";
 export async function openWorkspaceOpsBridge(workspaceRoot) {
-    const resolvedRoot = path.resolve(workspaceRoot);
+    const declaredRoot = typeof workspaceRoot === "string" ? workspaceRoot.trim() : "";
+    if (!declaredRoot) {
+        return {
+            ok: false,
+            error: {
+                code: "WORKSPACE_ROOT_REQUIRED",
+                message: "openWorkspaceOpsBridge requires a workspaceRoot path. Set SECOND_NATURE_WORKSPACE_ROOT or pass tool workspaceRoot.",
+                nextStep: "reinvoke_with_workspaceRoot_or_set_SECOND_NATURE_WORKSPACE_ROOT",
+                requiredUserInput: ["workspaceRoot"],
+            },
+        };
+    }
+    const resolvedRoot = path.resolve(declaredRoot);
     try {
         const pluginPackageRoot = path.dirname(fileURLToPath(import.meta.url));
         // Packaged `plugin/runtime` is emitted JS without sibling `.d.ts` in this repo layout.