psyche-ai 9.2.8 → 9.2.9

package/README.md

@@ -1,7 +1,7 @@
 # Psyche — 面向智能体的 AI-first 主观性内核
 
 [![npm](https://img.shields.io/npm/v/psyche-ai)](https://www.npmjs.com/package/psyche-ai)
-[![tests](https://img.shields.io/badge/tests-1307%20passing-brightgreen)]()
+[![tests](https://img.shields.io/badge/tests-1308%20passing-brightgreen)]()
 [![deps](https://img.shields.io/badge/dependencies-0-blue)]()
 [![license](https://img.shields.io/badge/license-MIT-yellow)](LICENSE)
 
@@ -209,6 +209,30 @@ npm view psyche-ai version
 - `git` 工作树和本地路径安装不会偷偷改你的代码；脏工作树只会提示手动命令。
 - OpenClaw 如果是从当前仓库本地加载，升级后记得重启 gateway 以载入新的 `dist/`。
 
+## 给本机其他 Agent 的真实验收
+
+如果另一个 agent 声称“已经在用 Psyche”，不要接受口头解释，直接让它跑：
+
+```bash
+psyche probe --json
+```
+
+这条命令会实际调用一次 `processInput()` 和 `processOutput()`，并返回：
+
+- 实际版本
+- 实际加载路径
+- 是否真的调用成功
+- `replyEnvelope` 这个规范主接口是否存在
+
+通过标准不是“它理解了 Psyche”，而是：
+
+- `ok = true`
+- `processInputCalled = true`
+- `processOutputCalled = true`
+- `canonicalHostSurface = true`
+
+正式说明见：[docs/AGENT_RUNTIME_PROBE.md](docs/AGENT_RUNTIME_PROBE.md)
+
 ---
 
 ## 它和你认知中的 AI 完全不同
@@ -523,7 +547,7 @@ Psyche 核心引擎永久开源（MIT）。
 ```bash
 npm install
 npm run build
-npm test           # 1307 tests
+npm test           # 1308 tests
 npm run typecheck  # strict mode
 ```
 

package/dist/cli.js

@@ -13,6 +13,7 @@
 //   psyche reset <dir> [--full]
 //   psyche diagnose <dir> [--github]
 //   psyche upgrade [--check]
+//   psyche probe [--json]
 //   psyche profiles [--json] [--mbti TYPE]
 // ============================================================
 import { resolve } from "node:path";
@@ -27,6 +28,7 @@ import { t } from "./i18n.js";
 import { CHEMICAL_KEYS, CHEMICAL_NAMES_ZH, DRIVE_KEYS, DRIVE_NAMES_ZH } from "./types.js";
 import { isMBTIType, isChemicalKey, isLocale } from "./guards.js";
 import { getPackageVersion, selfUpdate } from "./update.js";
+import { runRuntimeProbe } from "./runtime-probe.js";
 // ── Logger ───────────────────────────────────────────────────
 const cliLogger = {
     info: (msg) => console.error(`[info] ${msg}`),
@@ -425,6 +427,33 @@ async function cmdUpgrade(checkOnly) {
     const result = await selfUpdate({ checkOnly });
     console.log(result.message);
 }
+async function cmdProbe(json) {
+    const result = await runRuntimeProbe();
+    if (json) {
+        console.log(JSON.stringify(result, null, 2));
+        return;
+    }
+    if (!result.ok) {
+        console.log("\nPsyche runtime probe: FAILED\n");
+        console.log(`  version: ${result.version}`);
+        console.log(`  entry: ${result.entry}`);
+        console.log(`  load path: ${result.loadPath}`);
+        console.log(`  module path: ${result.modulePath}`);
+        console.log(`  cli path: ${result.cliPath}`);
+        console.log(`  error: ${result.error ?? "unknown error"}`);
+        return;
+    }
+    console.log("\nPsyche runtime probe: OK\n");
+    console.log(`  version: ${result.version}`);
+    console.log(`  entry: ${result.entry}`);
+    console.log(`  load path: ${result.loadPath}`);
+    console.log(`  module path: ${result.modulePath}`);
+    console.log(`  cli path: ${result.cliPath}`);
+    console.log(`  processInput: ok (stimulus=${result.stimulus ?? "null"})`);
+    console.log(`  processOutput: ok (stateChanged=${String(result.stateChanged)})`);
+    console.log(`  replyEnvelope: ${result.canonicalHostSurface ? "present" : "missing"}`);
+    console.log(`  externalContinuity: ${result.externalContinuityAvailable ? "present" : "missing"}`);
+}
 // ── Usage ────────────────────────────────────────────────────
 function usage() {
     console.log(`
@@ -442,6 +471,7 @@ Usage:
   psyche reset <dir> [--full]
   psyche diagnose <dir> [--github]   Run health checks & show diagnostic report
   psyche upgrade [--check]           Check/apply package updates safely
+  psyche probe [--json]              Verify the runtime is truly callable
   psyche profiles [--mbti TYPE] [--json]
 
 Options:
@@ -474,6 +504,9 @@ Examples:
 
   # Check for new package versions without applying them
   psyche upgrade --check
+
+  # Prove this environment can really call Psyche
+  psyche probe --json
 	`);
 }
 // ── Main ─────────────────────────────────────────────────────
@@ -614,6 +647,17 @@ async function main() {
                 await cmdUpgrade(values.check ?? false);
                 break;
             }
+            case "probe": {
+                const { values } = parseArgs({
+                    args: rest,
+                    options: {
+                        json: { type: "boolean", default: false },
+                    },
+                    allowPositionals: true,
+                });
+                await cmdProbe(values.json ?? false);
+                break;
+            }
             default:
                 die(`unknown command: ${command}. Run 'psyche help' for usage.`);
         }

package/dist/index.d.ts

@@ -33,6 +33,8 @@ export { computeRelationMove, evolveDyadicField, evolvePendingRelationSignals, g
 export { EXTERNAL_CONTINUITY_SIGNAL_KINDS, EXTERNAL_CONTINUITY_TRACE_KINDS, buildExternalContinuityEnvelope, } from "./external-continuity.js";
 export { deriveThrongletsExports } from "./thronglets-export.js";
 export { taxonomyForThrongletsExport, serializeThrongletsExportAsTrace, serializeExternalContinuityForThronglets, } from "./thronglets-runtime.js";
+export { runRuntimeProbe } from "./runtime-probe.js";
+export type { RuntimeProbeResult } from "./runtime-probe.js";
 export { computeExperientialField, computeCoherence, detectUnnamedEmotion, computeAffectCore } from "./experiential-field.js";
 export type { ExperientialField, ExperientialQuality, ConstructionContext } from "./experiential-field.js";
 export { computeGenerativeSelf, predictSelfReaction, detectInternalConflicts, buildIdentityNarrative } from "./generative-self.js";

package/dist/index.js

@@ -43,6 +43,7 @@ export { computeRelationMove, evolveDyadicField, evolvePendingRelationSignals, g
 export { EXTERNAL_CONTINUITY_SIGNAL_KINDS, EXTERNAL_CONTINUITY_TRACE_KINDS, buildExternalContinuityEnvelope, } from "./external-continuity.js";
 export { deriveThrongletsExports } from "./thronglets-export.js";
 export { taxonomyForThrongletsExport, serializeThrongletsExportAsTrace, serializeExternalContinuityForThronglets, } from "./thronglets-runtime.js";
+export { runRuntimeProbe } from "./runtime-probe.js";
 // Experiential field (P6 + P8 Barrett construction)
 export { computeExperientialField, computeCoherence, detectUnnamedEmotion, computeAffectCore } from "./experiential-field.js";
 // Generative self (P6)

package/dist/runtime-probe.d.ts

@@ -0,0 +1,18 @@
+export interface RuntimeProbeResult {
+    ok: boolean;
+    packageName: "psyche-ai";
+    version: string;
+    entry: "sdk";
+    loadPath: string;
+    modulePath: string;
+    cliPath: string;
+    processInputCalled: boolean;
+    processOutputCalled: boolean;
+    canonicalHostSurface: boolean;
+    externalContinuityAvailable: boolean;
+    stimulus: string | null;
+    cleanedText?: string;
+    stateChanged?: boolean;
+    error?: string;
+}
+export declare function runRuntimeProbe(): Promise<RuntimeProbeResult>;

package/dist/runtime-probe.js

@@ -0,0 +1,56 @@
+import { dirname, resolve } from "node:path";
+import { fileURLToPath } from "node:url";
+import { PsycheEngine } from "./core.js";
+import { MemoryStorageAdapter } from "./storage.js";
+import { getPackageVersion } from "./update.js";
+export async function runRuntimeProbe() {
+    const modulePath = fileURLToPath(import.meta.url);
+    const loadPath = resolve(dirname(modulePath), "..");
+    const cliPath = resolve(loadPath, "dist", "cli.js");
+    const version = await getPackageVersion();
+    try {
+        const engine = new PsycheEngine({
+            name: "Probe",
+            locale: "en",
+            persist: false,
+        }, new MemoryStorageAdapter());
+        await engine.initialize();
+        const input = await engine.processInput("Runtime probe: verify the SDK is actually callable.");
+        const output = await engine.processOutput("Probe output acknowledged.");
+        return {
+            ok: true,
+            packageName: "psyche-ai",
+            version,
+            entry: "sdk",
+            loadPath,
+            modulePath,
+            cliPath,
+            processInputCalled: true,
+            processOutputCalled: true,
+            canonicalHostSurface: Boolean(input.replyEnvelope?.subjectivityKernel
+                && input.replyEnvelope?.responseContract
+                && input.replyEnvelope?.generationControls),
+            externalContinuityAvailable: Boolean(input.externalContinuity?.provider === "thronglets"),
+            stimulus: input.stimulus,
+            cleanedText: output.cleanedText,
+            stateChanged: output.stateChanged,
+        };
+    }
+    catch (error) {
+        return {
+            ok: false,
+            packageName: "psyche-ai",
+            version,
+            entry: "sdk",
+            loadPath,
+            modulePath,
+            cliPath,
+            processInputCalled: false,
+            processOutputCalled: false,
+            canonicalHostSurface: false,
+            externalContinuityAvailable: false,
+            stimulus: null,
+            error: error instanceof Error ? error.message : String(error),
+        };
+    }
+}

package/llms.txt

@@ -142,6 +142,23 @@ npm install psyche-ai
 npx psyche-mcp
 ```
 
+## Runtime Proof
+
+If an agent claims it is already using Psyche in the current environment, require a real probe:
+
+```bash
+psyche probe --json
+```
+
+Passing means:
+
+- `ok = true`
+- `processInputCalled = true`
+- `processOutputCalled = true`
+- `canonicalHostSurface = true`
+
+This is runtime proof. Conceptual understanding is not enough.
+
 ## Links
 
 - npm: https://www.npmjs.com/package/psyche-ai

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "psyche-ai",
-  "version": "9.2.8",
+  "version": "9.2.9",
   "description": "AI-first subjectivity kernel for agents with continuous appraisal, relation dynamics, and adaptive reply loops",
   "mcpName": "io.github.Shangri-la-0428/psyche-ai",
   "type": "module",
@@ -43,7 +43,10 @@
     "test": "npm run build && npm run build:test && node --test dist-test/tests/*.test.js",
     "typecheck": "tsc --noEmit --strict",
     "dev": "tsc --watch",
-    "demo": "node scripts/demo-ab.js"
+    "demo": "node scripts/demo-ab.js",
+    "probe": "node dist/cli.js probe --json",
+    "release:guard": "node scripts/release-guard.mjs",
+    "prepublishOnly": "npm run release:guard && npm test"
   },
   "license": "MIT",
   "repository": {