{"_id":"@finddatatechnology/yongyi-client","_rev":"6-fa270314552054a3562f30fb2bdaa10e","name":"@finddatatechnology/yongyi-client","dist-tags":{"latest":"0.1.4"},"versions":{"0.0.0-stage":{"name":"@finddatatechnology/yongyi-client","version":"0.0.0-stage","_id":"@finddatatechnology/yongyi-client@0.0.0-stage","stub":true,"maintainers":[{"name":"finddatatechonology","email":"aloadtree@gmail.com"}],"dist":{"shasum":"885132384851b4f7fc1c3d83dc7072fbd5016348","tarball":"https://registry.npmjs.org/@finddatatechnology/yongyi-client/-/yongyi-client-0.0.0-stage.tgz","fileCount":2,"integrity":"sha512-4JYiVN/XbaFH9UIrth7zHvJ94Zdj3DYIvY0WRxq1ZKgOXBYyeoXqxGtgZxR3jAaqjJ5UJjf4sGNdfz8UGKCF6w==","signatures":[{"sig":"MEUCIBzAq2W/kFFNn7K/OWpOto7wbsTXKt/ODgTPNSV8dmJxAiEAznnIpDGyIbfEaWbMnItvK3ZvVyu+31/me9yp0iTalH8=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":355},"_npmUser":{"name":"finddatatechonology","email":"aloadtree@gmail.com"},"description":"Temporary package placeholder for staged publishing","directories":{}},"0.1.0":{"name":"@finddatatechnology/yongyi-client","version":"0.1.0","keywords":["agent","memory","llm","mcp","working-memory","yongyi"],"license":"MIT","_id":"@finddatatechnology/yongyi-client@0.1.0","maintainers":[{"name":"finddatatechonology","email":"aloadtree@gmail.com"}],"homepage":"https://github.com/FindDataTechnology/fd-memory#readme","bugs":{"url":"https://github.com/FindDataTechnology/fd-memory/issues"},"dist":{"shasum":"b59019919aa7d11adbe44f4cc1dbb6cb177859a7","tarball":"https://registry.npmjs.org/@finddatatechnology/yongyi-client/-/yongyi-client-0.1.0.tgz","fileCount":16,"integrity":"sha512-2DdoaUY7HOp+HHRjWLT7tgkyAjO0uTvvLhthjubOm6jjzsZFY6w5UKU6efV0spMWBGml0VSYPy6yoZeiEMY/3g==","signatures":[{"sig":"MEUCIQCSco5WxyAwwAPw+vAcLH4tBoqbfIgfBWqpy1eHxmaV7gIgVlMHPyzZn9kUBZcdHkWAk2cYzsDr70tdDZMB+NH+itM=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"},{"sig":"MEUCIQCOc8bfgEdhVt32ctCpJYiQ/3GDKjNGG+BehiOyjg6nHQIgVjuxAEzew/7vwMRiyyGboVRs+743dSVpNwwXhRJ1gZw=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":61568},"main":"./dist/index.js","type":"module","types":"./dist/index.d.ts","engines":{"node":">=22.5.0"},"exports":{".":{"types":"./dist/index.d.ts","import":"./dist/index.js"}},"gitHead":"c83e48b97c43a5f1063cd008a3e5cf0531a098ab","scripts":{"test":"tsc -p tsconfig.test.json && node --test \"dist-test/test/*.test.js\"","build":"tsc -p tsconfig.json"},"_npmUser":{"name":"finddatatechonology","email":"aloadtree@gmail.com"},"repository":{"url":"git+https://github.com/FindDataTechnology/fd-memory.git","type":"git","directory":"sdk"},"_npmVersion":"11.20.0","description":"永忆（YongYi / fd-memory）客户端 SDK：召回注入阶梯、纪律文本单源、五类事实捕获、令牌铸造缓存、/observe 上报。零运行时依赖，只以 fetch 打内核 HTTP 面。","directories":{},"_nodeVersion":"26.13.0","_hasShrinkwrap":false,"readmeFilename":"README.md","devDependencies":{"typescript":"^5.6.0","@types/node":"^22.0.0"},"_npmOperationalInternal":{"tmp":"tmp/yongyi-client_0.1.0_1794047401700_0.01097966191906219","host":"s3://npm-registry-packages-npm-production"}},"0.1.1":{"name":"@finddatatechnology/yongyi-client","version":"0.1.1","keywords":["agent","memory","llm","mcp","working-memory","yongyi"],"license":"MIT","_id":"@finddatatechnology/yongyi-client@0.1.1","maintainers":[{"name":"finddatatechonology","email":"aloadtree@gmail.com"}],"homepage":"https://github.com/FindDataTechnology/fd-memory#readme","bugs":{"url":"https://github.com/FindDataTechnology/fd-memory/issues"},"dist":{"shasum":"876cc7635f35a42aff53dcda0982b546b2019506","tarball":"https://registry.npmjs.org/@finddatatechnology/yongyi-client/-/yongyi-client-0.1.1.tgz","fileCount":16,"integrity":"sha512-q6Bdn3Sf8z9WL+B5dJascKepfb+9lAXKEdmIFMgz9RJNK1yVuSfqdz37xu8uOl28BcVNtcsn/gViWTCjhGK2Sg==","signatures":[{"sig":"MEUCIQC9t5NUoS6w2HDGMqN5mZRv9z8VowFNOr306bD4EcH7LgIgK8rmQQUx/P7YCcKwSmFaOqwHoFzkYURMKC3vU+SrSRs=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"},{"sig":"MEUCIQCUsbQUJdluUIN0odva3BaUP8wUrI70fPS0+hSFAIR8EAIgEIgZcN4I1PaiXzwetdD0BGlviYa0oH1/4aC/fuk5ae0=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":61567},"main":"./dist/index.js","type":"module","types":"./dist/index.d.ts","engines":{"node":">=22.5.0"},"exports":{".":{"types":"./dist/index.d.ts","import":"./dist/index.js"}},"gitHead":"c83e48b97c43a5f1063cd008a3e5cf0531a098ab","scripts":{"test":"tsc -p tsconfig.test.json && node --test \"dist-test/test/*.test.js\"","build":"tsc -p tsconfig.json"},"_npmUser":{"name":"finddatatechonology","email":"aloadtree@gmail.com"},"repository":{"url":"git+https://github.com/FindDataTechnology/fd-memory.git","type":"git","directory":"sdk"},"_npmVersion":"11.20.0","description":"永忆（YongYi / fd-memory）客户端 SDK：召回注入阶梯、纪律文本单源、五类事实捕获、令牌铸造缓存、/observe 上报。零运行时依赖，只以 fetch 打内核 HTTP 面。","directories":{},"_nodeVersion":"26.13.0","_hasShrinkwrap":false,"devDependencies":{"typescript":"^5.6.0","@types/node":"^22.0.0"},"_npmOperationalInternal":{"tmp":"tmp/yongyi-client_0.1.1_1794047448666_0.8157146574020175","host":"s3://npm-registry-packages-npm-production"}},"0.1.2":{"name":"@finddatatechnology/yongyi-client","version":"0.1.2","keywords":["agent","memory","llm","mcp","working-memory","yongyi"],"license":"MIT","_id":"@finddatatechnology/yongyi-client@0.1.2","maintainers":[{"name":"finddatatechonology","email":"aloadtree@gmail.com"}],"homepage":"https://github.com/FindDataTechnology/fd-memory#readme","bugs":{"url":"https://github.com/FindDataTechnology/fd-memory/issues"},"dist":{"shasum":"27cdcae3610976c95be726a492774ac76be1e76a","tarball":"https://registry.npmjs.org/@finddatatechnology/yongyi-client/-/yongyi-client-0.1.2.tgz","fileCount":18,"integrity":"sha512-B2Kw8bxE7PQgE9/xrKYc7NqzWmg/CmvmFhmpyGFED8KjvqPkS7jATRBsQvoVJRaQad1/ijVdBI+LisOAUJYmMQ==","signatures":[{"sig":"MEUCIQDoM4iftjgcKaT7dw0PMjWGtP2xXUDWpcWz/bTxbozMrgIgS0t9t3HQuJxtALSBufh9VnNm10M+Il8qvAgaeJXEQKU=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"},{"sig":"MEYCIQC31n/zksm5wyHposM6O8piHbNd/GWUF2wn6/PUlz9ejwIhAOQMgDKgp/LcxjwnT9dRVE6RHwf/RO2LgxtFYlouuQx/","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":64555},"main":"./dist/index.js","type":"module","types":"./dist/index.d.ts","engines":{"node":">=22.5.0"},"exports":{".":{"types":"./dist/index.d.ts","import":"./dist/index.js"}},"gitHead":"5648695aa6c50efbe9f4f69602dfa8d599e30235","scripts":{"test":"tsc -p tsconfig.test.json && node --test \"dist-test/test/*.test.js\"","build":"tsc -p tsconfig.json"},"_npmUser":{"name":"finddatatechonology","email":"aloadtree@gmail.com"},"repository":{"url":"git+https://github.com/FindDataTechnology/fd-memory.git","type":"git","directory":"sdk"},"_npmVersion":"11.20.0","description":"永忆（YongYi / fd-memory）客户端 SDK：召回注入阶梯、纪律文本单源、五类事实捕获、令牌铸造缓存、/observe 上报。零运行时依赖，只以 fetch 打内核 HTTP 面。","directories":{},"_nodeVersion":"26.13.0","_hasShrinkwrap":false,"devDependencies":{"typescript":"^5.6.0","@types/node":"^22.0.0"},"_npmOperationalInternal":{"tmp":"tmp/yongyi-client_0.1.2_1794049806388_0.13329214916035614","host":"s3://npm-registry-packages-npm-production"}},"0.1.3":{"name":"@finddatatechnology/yongyi-client","version":"0.1.3","keywords":["agent","memory","llm","mcp","working-memory","yongyi"],"license":"MIT","_id":"@finddatatechnology/yongyi-client@0.1.3","maintainers":[{"name":"finddatatechonology","email":"aloadtree@gmail.com"}],"homepage":"https://github.com/FindDataTechnology/fd-memory#readme","bugs":{"url":"https://github.com/FindDataTechnology/fd-memory/issues"},"dist":{"shasum":"ee1f716e17ec643ebcd6c7626ce9ca6b49e22d59","tarball":"https://registry.npmjs.org/@finddatatechnology/yongyi-client/-/yongyi-client-0.1.3.tgz","fileCount":18,"integrity":"sha512-iyb9gUSL1lUzTvvAFYgyYJwJPKklpmlMBGXpwGL4yZMiWeJRfca/A/Xrk2pVssP7gg79wbsFSSQJjcaR8t/8xA==","signatures":[{"sig":"MEYCIQDGGv+UowZcqUFlGfmae96dGrUmHirXi3o/HUk0b46A1AIhALJ1pFEv2uH4ZfpuMR5+K+egBgQ0ke/6QA3CBaLW02Q9","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"},{"sig":"MEQCIE4aoeqzw6PSxtFsEPWpbaga51TEo6cvx8MYsdHgu8C7AiBZQX6ziYRnlm9b9t9ycb+/CO4Y4/b5NUhFbLax86AG8Q==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":64763},"main":"./dist/index.js","type":"module","types":"./dist/index.d.ts","engines":{"node":">=22.5.0"},"exports":{".":{"types":"./dist/index.d.ts","import":"./dist/index.js"}},"gitHead":"5648695aa6c50efbe9f4f69602dfa8d599e30235","scripts":{"test":"tsc -p tsconfig.test.json && node --test \"dist-test/test/*.test.js\"","build":"tsc -p tsconfig.json"},"_npmUser":{"name":"finddatatechonology","email":"aloadtree@gmail.com"},"repository":{"url":"git+https://github.com/FindDataTechnology/fd-memory.git","type":"git","directory":"sdk"},"_npmVersion":"11.20.0","description":"永忆（YongYi / fd-memory）客户端 SDK：召回注入阶梯、纪律文本单源、五类事实捕获、令牌铸造缓存、/observe 上报。零运行时依赖，只以 fetch 打内核 HTTP 面。","directories":{},"_nodeVersion":"26.13.0","_hasShrinkwrap":false,"devDependencies":{"typescript":"^5.6.0","@types/node":"^22.0.0"},"_npmOperationalInternal":{"tmp":"tmp/yongyi-client_0.1.3_1794055336805_0.9150562454675836","host":"s3://npm-registry-packages-npm-production"}},"0.1.4":{"_id":"@finddatatechnology/yongyi-client@0.1.4","bugs":{"url":"https://github.com/FindDataTechnology/fd-memory/issues"},"dist":{"shasum":"5a4074dce4f8252f6ac70ade6f02fe010ad31c86","tarball":"https://registry.npmjs.org/@finddatatechnology/yongyi-client/-/yongyi-client-0.1.4.tgz","fileCount":18,"integrity":"sha512-iiNvNXcGjeewiJhOrbY8VnQRBYQ3x26RMsoWP070iCS2DPoXY7hYlWlYOTKCRthOynhzlB5Mc8Ybnq25Pxc47g==","signatures":[{"sig":"MEYCIQCFYbN1eJxuv3NKJK8wP1I51FXxFb4IJa0qPiSGWx498AIhAP99LXnZLegahkGXdF+KwdPJ50cQKpbloqKqAuA9I62z","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"},{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCIQDNFiozTSruV5IAzk9aKHOnm1zA/RprqIWZt4s2IqweQwIgJqlDtIGfAzKL5MI197yE58PiXiLe+EAkE8qg9UesRUs="}],"unpackedSize":66870},"main":"./dist/index.js","name":"@finddatatechnology/yongyi-client","type":"module","types":"./dist/index.d.ts","engines":{"node":">=22.5.0"},"exports":{".":{"types":"./dist/index.d.ts","import":"./dist/index.js"}},"gitHead":"5704462a7c1e785f4e8f78846ddfddcf26bac1fc","license":"MIT","scripts":{"test":"tsc -p tsconfig.test.json && node --test \"dist-test/test/*.test.js\"","build":"tsc -p tsconfig.json"},"version":"0.1.4","_npmUser":{"name":"finddatatechonology","email":"aloadtree@gmail.com"},"homepage":"https://github.com/FindDataTechnology/fd-memory#readme","keywords":["agent","memory","llm","mcp","working-memory","yongyi"],"repository":{"url":"git+https://github.com/FindDataTechnology/fd-memory.git","type":"git","directory":"sdk"},"_npmVersion":"11.20.0","description":"永忆（YongYi / fd-memory）客户端 SDK：召回注入阶梯、纪律文本单源、五类事实捕获、令牌铸造缓存、/observe 上报。零运行时依赖，只以 fetch 打内核 HTTP 面。","directories":{},"maintainers":[{"name":"finddatatechonology","email":"aloadtree@gmail.com"}],"_nodeVersion":"26.13.0","_hasShrinkwrap":false,"devDependencies":{"typescript":"^5.6.0","@types/node":"^22.0.0"},"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/yongyi-client_0.1.4_1794256513667_0.6528245517423111"}}},"time":{"created":"2026-11-07T10:28:25.357Z","modified":"2026-11-09T20:35:13.959Z","0.0.0-stage":"2026-11-07T10:28:25.357Z","0.1.0":"2026-11-07T10:30:01.813Z","0.1.1":"2026-11-07T10:30:48.758Z","0.1.2":"2026-11-07T11:10:06.479Z","0.1.3":"2026-11-07T12:42:16.918Z","0.1.4":"2026-11-09T20:35:13.747Z"},"bugs":{"url":"https://github.com/FindDataTechnology/fd-memory/issues"},"license":"MIT","homepage":"https://github.com/FindDataTechnology/fd-memory#readme","keywords":["agent","memory","llm","mcp","working-memory","yongyi"],"repository":{"url":"git+https://github.com/FindDataTechnology/fd-memory.git","type":"git","directory":"sdk"},"description":"永忆（YongYi / fd-memory）客户端 SDK：召回注入阶梯、纪律文本单源、五类事实捕获、令牌铸造缓存、/observe 上报。零运行时依赖，只以 fetch 打内核 HTTP 面。","maintainers":[{"name":"finddatatechonology","email":"aloadtree@gmail.com"}],"readme":"# @finddatatechnology/yongyi-client\n\n永忆（YongYi / fd-memory）客户端 SDK：把经过旗舰平台（agent 工作台/运行器）实战验证的接入件下放为独立 npm 包，任何 harness 集成方拿到同一套接入件。\n\n**零运行时依赖**——只用 Node 内置 fetch 打永忆内核的 HTTP 面（`/digest`、`/pages`、`/admin/mint`、`/observe`），与内核之间是网络契约，不是代码契约。\n\n- 模块：`ladder`（注入阶梯）、`discipline`（纪律文本单源）、`facts`（五类事实捕获）、`tokens`（令牌铸造缓存）、`observe`（/observe 上报）、`http`（出站死线包装）。\n- 契约：降级开放——注入与捕获的任何失败都以缺席告终，绝不向宿主回合抛错；铸造失败则原样抛给调用方计数处理，绝不静默假装成功。\n- 字节同源：注入块与旗舰平台现行输出逐字节一致（金样固化于 `test/goldens/`，由现役实现实跑产出）。\n\n```bash\nnpm install @finddatatechnology/yongyi-client\n```\n\n## ladder — 注入阶梯\n\ndigest 面优先（服务端渲染块），失败降级标题列表，再降级缺席；digest 读死线默认 9000ms（必须高于内核 embed 预算帽 8000ms）。\n\n```js\nimport { clusterMemoryFor, memoryInjectionFor, chatMemoryInjectionFor } from \"@finddatatechnology/yongyi-client\";\n\nconst env = {\n  CELL_MEMORY_ENABLED: \"1\",\n  CELL_MEMORY_URL: \"http://127.0.0.1:8080\",\n  CELL_MEMORY_PLATFORM_TOKEN: \"<平台令牌>\",\n  CELL_MEMORY_DATA: \"/var/lib/my-harness\",   // 令牌磁盘缓存根（0600）\n};\nconst cm = await clusterMemoryFor(env, \"owner@example.com\");\nif (cm) {\n  // 集群车道：prompt 追加记忆块；source ∈ digest | titles | none\n  const { prompt, source } = await memoryInjectionFor(cm, \"cluster-42\", userPrompt, { k: 5, budget: 1500 });\n  // 聊天车道：项目固定 default；CELL_MEMORY_CHAT_DIGEST=0 为总开关（经 opts.env 传入）\n  const chat = await chatMemoryInjectionFor(cm, userPrompt, { env });\n}\n```\n\n任何失败（服务不可达、digest 超时）都返回空块与 `source: \"none\"`，prompt 保持未注入形态。\n\n## discipline — 纪律文本单源\n\n双语（zh + en）纪律文本的单源导出。消费者经本接口取文本用于自己的 persona 注入，不得手抄副本；文本更新随 SDK 版本发布。\n\n```js\nimport { MEMORY_DISCIPLINE } from \"@finddatatechnology/yongyi-client\";\npersonaSuffix += MEMORY_DISCIPLINE;  // 与旗舰现行注入逐字节一致\n```\n\n## facts — 五类事实捕获\n\n封闭五类：`turn`、`health` 落成员 own 分区（`d/<pack>/<member>`）；`decision-opened`、`decision-resolved`、`swap` 落团队 shared 分区。每页携带一等 metadata `{fleetId, memberId, kind}`；进程内有界幂等去重窗（512，键含内容）；未知类型计失败而非误落分区。\n\n```js\nimport { fleetMemoryFor, createFleetMemoryCapture, createHealthFlipTracker } from \"@finddatatechnology/yongyi-client\";\n\nconst fm = await fleetMemoryFor(env, \"owner@example.com\");\nif (fm) {\n  const capture = createFleetMemoryCapture({ memory: fm });\n  const healthFlip = createHealthFlipTracker();\n  if (healthFlip(\"fleet-9\", \"writer-a\", \"failed\")) {\n    await capture(\"fleet-9\", \"writer-a\", \"health\", \"writer-a 开始失败\", \"digest HTTP 503 ×3\");\n  }\n  await capture(\"fleet-9\", \"writer-a\", \"decision-resolved\", \"采用方案 B\", \"理由……\");\n  // capture 失败只进计数器：capture.failures / capture.captured\n}\n```\n\n## tokens — 令牌铸造与缓存\n\n经平台令牌铸造 person（`u/`）与 deployment（`d/<pack>/<member>`）令牌；磁盘缓存 0600、重启稳定、同身份只铸一次（namespace 校验后复用）。\n\n```js\nimport { cellMemoryConfig, personTokenFor, memberTokenFor, memoryMcpEntry } from \"@finddatatechnology/yongyi-client\";\n\nconst cfg = cellMemoryConfig(env);          // 四件套缺一即 null（整体关闭）\nconst person = await personTokenFor(cfg, \"owner@example.com\");   // 失败 → throw，调用方计数\nconst member = await memberTokenFor(cfg, { packId: \"fleet-9\", memberId: \"writer-a\", ownerEmail: \"owner@example.com\" });\nconst mcpEntry = memoryMcpEntry(cfg.url, person);                // DeepSeek Harness MCP 客户端加载行（http 分支） // leak-check:allow\n```\n\n## observe — /observe 上报\n\n事件投递到内核 `POST /observe`（封闭集 `turn_outcome | tool_call | health_flip`）。幂等键缺省自动 `crypto.randomUUID()`；`observeFireAndForget` 失败即丢、无重试、有界超时（默认 10s），永不阻塞宿主。\n\n```js\nimport { observeFireAndForget, observeOnce } from \"@finddatatechnology/yongyi-client\";\n\nobserveFireAndForget({\n  url: \"http://127.0.0.1:8080\", token: person,\n  type: \"turn_outcome\", title: \"回合收尾\", body: \"完成 X，下一步 Y\",\n  harness: \"claude-code\",           // 来源标注（跨 harness 合流）\n});\n// 要结果（如 hook 转发器收尾前确认）用 await observeOnce(...)\n```\n\n## 挂载行形状（参照）\n\nDeepSeek Harness / ACP 两类载体的记忆挂载行形状（`dshMemoryMount` / `acpMemoryMount`）：\n\n```js\n// DeepSeek Harness：mcp 客户端加载行\n{ id: \"mcp-fd-memory\", name: \"@deepseek-ai/dsh-mcp-client\", // leak-check:allow 公开 npm 包名\n  config: { serverName: \"fd-memory\", failOnStartupError: false, transport: \"streamable-http\",\n            url: \"<url>/mcp\", headers: { Authorization: \"Bearer <token>\" } } }\n// ACP：SDK wire 行（headers 为 {name,value} 数组）\n{ type: \"http\", name: \"fd-memory\", url: \"<url>/mcp\",\n  headers: [{ name: \"Authorization\", value: \"Bearer <token>\" }] }\n```\n\n## 构建与测试\n\n```bash\nnpm install        # 开发依赖：typescript、@types/node（运行时零依赖）\nnpm run build      # tsc -p tsconfig.json → dist/\nnpm test           # 编译 src+test → dist-test/，node --test 全绿（mock fetch，无网络）\nnpm pack --dry-run # 文件清单：dist/ + README.md，无测试产物泄漏\n```\n\n## License\n\nMIT\n","readmeFilename":"README.md"}