@haaaiawd/second-nature 0.1.33 → 0.1.34

package/index.js

@@ -71,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.33";
+const SETUP_GUIDE_VERSION = "0.1.34";
 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. */

package/openclaw.plugin.json

@@ -1,7 +1,7 @@
 {
   "id": "second-nature",
   "name": "Second Nature",
-  "version": "0.1.33",
+  "version": "0.1.34",
   "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, snapshot:capture, narrative:diff, timeline, restore, runtime_secret_bootstrap.",
   "activation": {
     "onStartup": true,

package/package.json

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

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

@@ -154,6 +154,96 @@ function registerConnectorForWetProbe(input) {
         credentialTypes: ["runtime_ops_probe"],
     });
 }
+async function captureRuntimeSnapshot(deps, input) {
+    const generatedAt = new Date().toISOString();
+    if (!deps.state || !deps.restoreSnapshotStore) {
+        return {
+            ok: false,
+            command: "snapshot:capture",
+            runtimeMode: "unavailable",
+            surfaceMode: "cli",
+            generatedAt,
+            error: {
+                code: "SNAPSHOT_CAPTURE_DEPS_UNAVAILABLE",
+                message: "snapshot:capture requires state DB and RestoreSnapshotStore in OpsRouterDeps",
+                nextStep: "wire_state_and_restore_snapshot_store_into_ops_router",
+            },
+            warnings: [],
+            sourceRefs: [],
+        };
+    }
+    const snapshotId = textInput(input, "snapshotId") ??
+        `snapshot:${Date.now()}:${Math.random().toString(36).slice(2, 8)}`;
+    const requestedKinds = coerceRestorableKinds(input?.entityWhitelist) ?? [...DEFAULT_SNAPSHOT_KINDS];
+    const rowCounts = {};
+    const warnings = [];
+    for (const kind of requestedKinds) {
+        const table = SNAPSHOT_TABLE_BY_KIND[kind];
+        if (!tableExists(deps.state, table)) {
+            rowCounts[kind] = 0;
+            warnings.push(`table_missing:${kind}:${table}`);
+            continue;
+        }
+        rowCounts[kind] = readRowsFromTable(deps.state, table).length;
+    }
+    const historyStore = createHistoryDigestStore(deps.state);
+    const previousHash = (await historyStore.listNarrativeTimeline({ limit: 1 }))[0]?.currentHash ?? "";
+    const delta = buildSnapshotNarrativeDelta(input, snapshotId, rowCounts);
+    const currentHash = hashNarrativeSnapshot({
+        previousHash,
+        snapshotId,
+        delta,
+        createdAt: generatedAt,
+    });
+    await historyStore.appendNarrativeTimeline({
+        timelineId: snapshotId,
+        entryType: "owner.override",
+        subjectId: textInput(input, "subjectId") ?? snapshotId,
+        delta,
+        previousHash,
+        currentHash,
+        createdAt: generatedAt,
+    });
+    const payload = {};
+    const capturedKinds = [];
+    for (const kind of requestedKinds) {
+        const table = SNAPSHOT_TABLE_BY_KIND[kind];
+        if (!tableExists(deps.state, table))
+            continue;
+        const rows = readRowsFromTable(deps.state, table);
+        rowCounts[kind] = rows.length;
+        if (rows.length > 0) {
+            payload[kind] = rows;
+            capturedKinds.push(kind);
+        }
+    }
+    const snapshot = await deps.restoreSnapshotStore.captureSnapshot({
+        snapshotId,
+        entityWhitelist: requestedKinds,
+        payload,
+        capturedAt: generatedAt,
+    });
+    return {
+        ok: true,
+        command: "snapshot:capture",
+        runtimeMode: "workspace_full_runtime",
+        surfaceMode: "cli",
+        generatedAt,
+        data: {
+            snapshotId: snapshot.snapshotId,
+            capturedAt: snapshot.capturedAt,
+            entityWhitelist: snapshot.entityWhitelist,
+            capturedKinds,
+            rowCounts,
+            narrativeVersion: snapshotId,
+        },
+        warnings,
+        sourceRefs: [
+            "storage/services/restore-snapshot-store.ts",
+            "storage/services/history-digest-store.ts",
+        ],
+    };
+}
 /**
  * T1.2.8 — static local adapter: all checks return `unknown` when no real host is available.
  * Allows `capability_probe` to be called from CLI / workspace bridge without requiring a live host.
@@ -194,7 +284,7 @@ export function createOpsRouter(deps) {
                 const runtimeAvailable = typeof input?.runtimeAvailable === "boolean"
                     ? input.runtimeAvailable
                     : deps.runtimeAvailable;
-                return heartbeatCheck({
+                const result = await heartbeatCheck({
                     probeOnly: coerceProbeOnlyFlag(input),
                     runtimeAvailable,
                     fakeControlPlanePassthrough: input?.fakeControlPlanePassthrough &&
@@ -219,6 +309,34 @@ export function createOpsRouter(deps) {
                     connectorRegistry: input
                         ?.connectorRegistry ?? deps.connectorRegistry,
                 });
+                if (result.ok &&
+                    result.surfaceMode === "workspace_full_runtime" &&
+                    !coerceProbeOnlyFlag(input) &&
+                    deps.state &&
+                    deps.restoreSnapshotStore) {
+                    try {
+                        const capture = await captureRuntimeSnapshot(deps, {
+                            snapshotId: `heartbeat:${result.decisionId ?? "cycle"}:${Date.now()}`,
+                            subjectId: result.decisionId ?? "heartbeat_check",
+                            reasonCode: "heartbeat_check",
+                            summaryText: `Heartbeat ${result.status} captured bounded restore snapshot`,
+                            focus: result.status,
+                            progress: result.reasons.join(",") || "heartbeat_completed",
+                            nextIntent: "continue_runtime_loop",
+                            sourceRefs: result.decisionId
+                                ? [`heartbeat:${result.decisionId}`]
+                                : ["heartbeat:runtime"],
+                        });
+                        if (capture.ok) {
+                            result.reasons = [...result.reasons, "restore_snapshot_captured"];
+                        }
+                    }
+                    catch (err) {
+                        const msg = err instanceof Error ? err.message : String(err);
+                        result.reasons = [...result.reasons, `restore_snapshot_capture_failed:${msg}`];
+                    }
+                }
+                return result;
             }
             if (command === "fallback") {
                 const ref = typeof input?.ref === "string" ? input.ref.trim() : "";
@@ -737,96 +855,7 @@ export function createOpsRouter(deps) {
              * NarrativeTimeline. This gives restore and narrative:diff real state to consume.
              */
             if (command === "snapshot:capture") {
-                const generatedAt = new Date().toISOString();
-                if (!deps.state || !deps.restoreSnapshotStore) {
-                    const envelope = {
-                        ok: false,
-                        command: "snapshot:capture",
-                        runtimeMode: "unavailable",
-                        surfaceMode: "cli",
-                        generatedAt,
-                        error: {
-                            code: "SNAPSHOT_CAPTURE_DEPS_UNAVAILABLE",
-                            message: "snapshot:capture requires state DB and RestoreSnapshotStore in OpsRouterDeps",
-                            nextStep: "wire_state_and_restore_snapshot_store_into_ops_router",
-                        },
-                        warnings: [],
-                        sourceRefs: [],
-                    };
-                    return envelope;
-                }
-                const snapshotId = textInput(input, "snapshotId") ??
-                    `snapshot:${Date.now()}:${Math.random().toString(36).slice(2, 8)}`;
-                const requestedKinds = coerceRestorableKinds(input?.entityWhitelist) ?? [...DEFAULT_SNAPSHOT_KINDS];
-                const rowCounts = {};
-                const warnings = [];
-                for (const kind of requestedKinds) {
-                    const table = SNAPSHOT_TABLE_BY_KIND[kind];
-                    if (!tableExists(deps.state, table)) {
-                        rowCounts[kind] = 0;
-                        warnings.push(`table_missing:${kind}:${table}`);
-                        continue;
-                    }
-                    rowCounts[kind] = readRowsFromTable(deps.state, table).length;
-                }
-                const historyStore = createHistoryDigestStore(deps.state);
-                const previousHash = (await historyStore.listNarrativeTimeline({ limit: 1 }))[0]?.currentHash ?? "";
-                const delta = buildSnapshotNarrativeDelta(input, snapshotId, rowCounts);
-                const currentHash = hashNarrativeSnapshot({
-                    previousHash,
-                    snapshotId,
-                    delta,
-                    createdAt: generatedAt,
-                });
-                await historyStore.appendNarrativeTimeline({
-                    timelineId: snapshotId,
-                    entryType: "owner.override",
-                    subjectId: textInput(input, "subjectId") ?? snapshotId,
-                    delta,
-                    previousHash,
-                    currentHash,
-                    createdAt: generatedAt,
-                });
-                const payload = {};
-                const capturedKinds = [];
-                for (const kind of requestedKinds) {
-                    const table = SNAPSHOT_TABLE_BY_KIND[kind];
-                    if (!tableExists(deps.state, table))
-                        continue;
-                    const rows = readRowsFromTable(deps.state, table);
-                    rowCounts[kind] = rows.length;
-                    if (rows.length > 0) {
-                        payload[kind] = rows;
-                        capturedKinds.push(kind);
-                    }
-                }
-                const snapshot = await deps.restoreSnapshotStore.captureSnapshot({
-                    snapshotId,
-                    entityWhitelist: requestedKinds,
-                    payload,
-                    capturedAt: generatedAt,
-                });
-                const envelope = {
-                    ok: true,
-                    command: "snapshot:capture",
-                    runtimeMode: "workspace_full_runtime",
-                    surfaceMode: "cli",
-                    generatedAt,
-                    data: {
-                        snapshotId: snapshot.snapshotId,
-                        capturedAt: snapshot.capturedAt,
-                        entityWhitelist: snapshot.entityWhitelist,
-                        capturedKinds,
-                        rowCounts,
-                        narrativeVersion: snapshotId,
-                    },
-                    warnings,
-                    sourceRefs: [
-                        "storage/services/restore-snapshot-store.ts",
-                        "storage/services/history-digest-store.ts",
-                    ],
-                };
-                return envelope;
+                return captureRuntimeSnapshot(deps, input);
             }
             /**
              * [G6] narrative:diff — queryNarrativeDiff between two versions.

package/runtime/connectors/base/map-life-evidence.js

@@ -1,6 +1,11 @@
 function extractSourceRefs(platformId, data, observedAt) {
     if (data && typeof data === "object") {
         const record = data;
+        if (record.data && typeof record.data === "object") {
+            const nested = extractSourceRefs(platformId, record.data, observedAt);
+            if (nested.length > 0)
+                return nested;
+        }
         if (Array.isArray(record.sourceRefs)) {
             const out = [];
             for (const item of record.sourceRefs) {

package/runtime/storage/services/tool-experience-store.js

@@ -78,10 +78,18 @@ export function createCapabilityProbeResultStore(database) {
     const { sqlite } = database;
     return {
         async appendProbeResult(result) {
-            sqlite.run(`INSERT INTO capability_probe_result
-         (probe_result_id, capability_id, connector_id, actual_status,
-          http_status, sample_response_ref, probe_config_ref, created_at)
-         VALUES (?, ?, ?, ?, ?, ?, ?, ?)`, [
+            sqlite.run(`INSERT INTO capability_probe_result
+         (probe_result_id, capability_id, connector_id, actual_status,
+          http_status, sample_response_ref, probe_config_ref, created_at)
+         VALUES (?, ?, ?, ?, ?, ?, ?, ?)
+         ON CONFLICT(probe_result_id) DO UPDATE SET
+           capability_id = excluded.capability_id,
+           connector_id = excluded.connector_id,
+           actual_status = excluded.actual_status,
+           http_status = excluded.http_status,
+           sample_response_ref = excluded.sample_response_ref,
+           probe_config_ref = excluded.probe_config_ref,
+           created_at = excluded.created_at`, [
                 result.probeResultId,
                 result.capabilityId,
                 result.connectorId,