@haaaiawd/second-nature 0.1.15 → 0.1.16

package/index.js

@@ -16,6 +16,30 @@
  * - structured mutating flows such as policy set / credential verify remain unavailable here
  * - full evidence-backed workspace runtime can be reintroduced later behind a host-safe boundary
  *
+ * Plugin classification (verified against OpenClaw 2026.5.4 internals, see
+ * docs/validation/openclaw-plugin-classification.md and the explore reports
+ * dated 2026-05-06):
+ * - Second Nature is a TOOL plugin (exposes `second_nature_ops` to agent
+ *   sessions). It is intentionally NOT a channel/provider/context-engine.
+ * - OpenClaw's `loadGatewayStartupPluginPlan` only loads plugins that opt in
+ *   via `manifest.activation.onStartup === true`, occupy a configured slot
+ *   (channel/contextEngine/provider), or declare an explicit hook intent. A
+ *   tool-only plugin without `activation.onStartup` will be enabled in the
+ *   registry yet never loaded by the gateway daemon — register(api) only fires
+ *   inside the `openclaw plugins enable` CLI process, which produces the
+ *   illusion of a working plugin while agent sessions see no tool. We hit
+ *   exactly that on 2026-05-06; the fix lives in plugin/openclaw.plugin.json
+ *   under the `activation` block.
+ * - `Shape: non-capability` reported by `openclaw plugins info` is EXPECTED
+ *   for this plugin. OpenClaw counts capabilities only across cli-backend /
+ *   text-inference / speech / realtime-* / media-understanding /
+ *   image-generation / web-search / agent-harness / context-engine / channel.
+ *   Tool/command/service contributions never bump that count. Pretending to
+ *   be a context engine with a stub factory just to flip the label would lie
+ *   to the host (ContextEngine.ingest/assemble/compact get called for real).
+ *   When Second Nature ships a genuine context-engine layer in a future
+ *   release, the shape will move to plain-capability honestly.
+ *
  * OpenClaw operator norm (T1.1.4 / T1.1.5): set `SECOND_NATURE_WORKSPACE_ROOT` or tool `workspaceRoot` to the
  * **same absolute path** as the OpenClaw **agent workspace** (default `~/.openclaw/workspace`, or
  * `agents.defaults.workspace` in `~/.openclaw/openclaw.json`). Do **not** infer that root from the plugin
@@ -30,20 +54,27 @@
 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";
-// SDK factory marker is mandatory: OpenClaw 2026.5.x identifies a plugin as
-// "plain-capability" only when its default export is produced by definePluginEntry
-// (or sibling factories). Plain-object exports get classified as "non-capability"
-// and the host silently skips register(api), so tools never reach agent sessions.
+// 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 is documented above about sql.js async bootstrap. In production the
-// host always provides `openclaw` as a sibling module under
+// 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
-// the same path.
+// `openclaw` is declared as a devDependency so build and tests resolve via
+// the same import path.
 import { definePluginEntry } from "openclaw/plugin-sdk/plugin-entry";
+// 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
+// the daemon never reached this entry — typically a manifest activation gap.
 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.";

package/openclaw.plugin.json

@@ -1,10 +1,13 @@
 {
   "id": "second-nature",
   "name": "Second Nature",
-  "version": "0.1.15",
+  "version": "0.1.16",
   "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 (see README / T1.1.4 ops norm).",
   "activation": {
-    "onStartup": false
+    "onStartup": true,
+    "onCapabilities": [
+      "tool"
+    ]
   },
   "contracts": {
     "commands": [

package/package.json

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

package/runtime/core/second-nature/runtime/service-entry.js

@@ -27,7 +27,7 @@ export function startRuntimeService(ctx) {
     // - control-plane-system (heartbeat bridge preparation)
     const workspaceRoot = ctx?.workspaceRoot ?? process.cwd();
     /** Keep in sync with `plugin/package.json` when cutting releases. */
-    const version = "0.1.15";
+    const version = "0.1.16";
     activeHandle = {
         ready: true,
         version,