@coralai/sps-cli 0.66.7 → 0.67.0

package/dist/seams/agents/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/seams/agents/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AACH,OAAO,EAAE,KAAK,OAAO,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAC;AAC5D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mCAAmC,CAAC;AACtE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,qCAAqC,CAAC;AAEtE,yCAAyC;AACzC,eAAO,MAAM,MAAM,eAAe,CAAC;AAEnC,MAAM,WAAW,mBAAmB;IAClC,2DAA2D;IAC3D,EAAE,EAAE,MAAM,CAAC;IACX,0BAA0B;IAC1B,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,GAAG,EAAE,UAAU,GAAG,YAAY,CAAC;CACvC;AAED,MAAM,CAAC,OAAO,OAAO,oBAAqB,SAAQ,OAAO;IACvD,OAAO,CAAC,QAAQ,CAAC,IAAI,CAA0C;gBAEnD,GAAG,EAAE,OAAO;IAIxB;;;;;OAKG;IACH,QAAQ,CAAC,CAAC,EAAE,mBAAmB,GAAG,MAAM,IAAI;IAU5C,sDAAsD;IACtD,MAAM,CAAC,EAAE,EAAE,MAAM,EAAE,GAAG,EAAE,UAAU,GAAG,YAAY;IAUjD,IAAI,IAAI,MAAM,EAAE;CAGjB;AAED,OAAO,QAAQ,qBAAqB,CAAC;IACnC,UAAU,OAAO;QACf,YAAY,EAAE,oBAAoB,CAAC;KACpC;CACF"}

package/dist/seams/agents/index.js

@@ -0,0 +1,54 @@
+/**
+ * @module        seams/agents
+ * @description   **agent 后端注册表 seam** —— 插件把 agent 后端注册进来,派活时按名字取。
+ *
+ * @layer         seam
+ *
+ * 类型:**乙 · 注册表型**(见 docs/design/plugin-architecture.md §3c)。
+ * 判据是「换实现是**项目决定**」——"这个项目用 claude 还是 openai",不是部署级选一个。
+ *
+ * 🔴 **这是仓库北极星那句话的机制化**:
+ *    > 换一个 agent 后端时,上层编排代码应几乎不用改。
+ *    今天它是一条**纪律**(`resolveBackend` 里一个手写 switch,加实现要改内核代码);
+ *    做成注册表之后它是**结构**:写一个包 → `sps plugin add` → 项目配置里写名字。
+ *
+ * 🔴 **取不到时要列出有哪些。** "agent 配错了"是最难查的一类 ——
+ *    症状是"卡片永远不动",而真因只是配置里一个拼错的名字。
+ */
+import { Service } from '@deepseek-ai/cordis';
+/** 服务名。加 `sps.` 前缀 —— Cordis 是扁平命名空间。 */
+export const AGENTS = 'sps.agents';
+export default class AgentBackendRegistry extends Service {
+    byId = new Map();
+    constructor(ctx) {
+        super(ctx, AGENTS);
+    }
+    /**
+     * 注册一个后端。**返回注销函数**,调用方应当包进 `ctx.effect`。
+     *
+     * 🔴 重名**抛错**不是覆盖:静默覆盖会让"这个项目到底跑在哪个后端上"无从判断,
+     *    而那正是排查 worker 行为异常时第一个要确认的事。
+     */
+    register(f) {
+        if (this.byId.has(f.id)) {
+            throw new Error(`agent 后端 id 重复:${f.id}(已有注册者;请改名或先卸载那个插件)`);
+        }
+        this.byId.set(f.id, f);
+        return () => {
+            if (this.byId.get(f.id) === f)
+                this.byId.delete(f.id);
+        };
+    }
+    /** 按 id 造一个后端。**取不到就抛,并列出有哪些** —— 别让配置错误表现成"卡片不动"。 */
+    create(id, ctx) {
+        const f = this.byId.get(id);
+        if (!f) {
+            throw new Error(`未注册的 agent 后端:${id}。已注册的有:${this.list().join(', ') || '(一个都没有)'}`);
+        }
+        return f.create(ctx);
+    }
+    list() {
+        return [...this.byId.keys()].sort();
+    }
+}
+//# sourceMappingURL=index.js.map

package/dist/seams/agents/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/seams/agents/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AACH,OAAO,EAAgB,OAAO,EAAE,MAAM,qBAAqB,CAAC;AAI5D,yCAAyC;AACzC,MAAM,CAAC,MAAM,MAAM,GAAG,YAAY,CAAC;AAUnC,MAAM,CAAC,OAAO,OAAO,oBAAqB,SAAQ,OAAO;IACtC,IAAI,GAAG,IAAI,GAAG,EAA+B,CAAC;IAE/D,YAAY,GAAY;QACtB,KAAK,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC;IACrB,CAAC;IAED;;;;;OAKG;IACH,QAAQ,CAAC,CAAsB;QAC7B,IAAI,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC;YACxB,MAAM,IAAI,KAAK,CAAC,kBAAkB,CAAC,CAAC,EAAE,qBAAqB,CAAC,CAAC;QAC/D,CAAC;QACD,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC;QACvB,OAAO,GAAG,EAAE;YACV,IAAI,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC;gBAAE,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;QACxD,CAAC,CAAC;IACJ,CAAC;IAED,sDAAsD;IACtD,MAAM,CAAC,EAAU,EAAE,GAAe;QAChC,MAAM,CAAC,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QAC5B,IAAI,CAAC,CAAC,EAAE,CAAC;YACP,MAAM,IAAI,KAAK,CACb,iBAAiB,EAAE,UAAU,IAAI,CAAC,IAAI,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,SAAS,EAAE,CACnE,CAAC;QACJ,CAAC;QACD,OAAO,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;IACvB,CAAC;IAED,IAAI;QACF,OAAO,CAAC,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;IACtC,CAAC;CACF"}

package/dist/seams/agents-builtin/index.d.ts

@@ -0,0 +1,19 @@
+/**
+ * @module        seams/agents-builtin
+ * @description   把 sps 内建的四个 agent 后端注册进 `sps.agents`。
+ *
+ * @layer         seam
+ *
+ * 🔴 **这里替代了 `resolveBackend` 的那个 switch。** 那个 switch 的问题不是写法,
+ *    是**加一个后端必须改内核代码** —— 而"换 agent 后端上层不改"正是北极星那句话。
+ *    现在加后端 = 写一个包 + 装配档一行。
+ *
+ * ⚠️ 构造细节(provider 传输选择等)原样保留在各 factory 里,没有趁机重写 ——
+ *    这一步只搬**选择方式**,不动**构造逻辑**。两件事混在一次改动里,
+ *    出问题时分不清是搬错了还是改错了。
+ */
+import { type Context } from '@deepseek-ai/cordis';
+export declare const name = "sps-agents-builtin";
+export declare const inject: string[];
+export declare function apply(ctx: Context): void;
+//# sourceMappingURL=index.d.ts.map

package/dist/seams/agents-builtin/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/seams/agents-builtin/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AACH,OAAO,EAAE,KAAK,OAAO,EAAW,MAAM,qBAAqB,CAAC;AAoE5D,eAAO,MAAM,IAAI,uBAAuB,CAAC;AACzC,eAAO,MAAM,MAAM,UAAW,CAAC;AAE/B,wBAAgB,KAAK,CAAC,GAAG,EAAE,OAAO,GAAG,IAAI,CAKxC"}

package/dist/seams/agents-builtin/index.js

@@ -0,0 +1,69 @@
+import { ClaudeSdkBackend } from '../../core/agents/ClaudeSdkBackend.js';
+import { DaemonBackend } from '../../core/agents/DaemonBackend.js';
+import { OpenAiAgentBackend } from '../../core/agents/OpenAiAgentBackend.js';
+import { AGENTS } from '../agents/index.js';
+const BUILTIN = [
+    {
+        id: 'claude-daemon',
+        summary: '人才市场:委托共享 daemon(与 chat 同宿主,统一并发/监控)',
+        create: (ctx) => new DaemonBackend({
+            backend: 'claude',
+            sessionName: ctx.sessionName,
+            cwd: ctx.cwd,
+            project: ctx.project,
+            resumeSessionId: ctx.resumeSessionId,
+            extraEnv: ctx.extraEnv,
+        }),
+    },
+    {
+        id: 'openai-daemon',
+        summary: 'openai/codex 走共享 daemon;provider 传输按 providerId 推导',
+        create: (ctx) => {
+            const providerId = ctx.providerId ?? 'official';
+            const transport = ctx.providerTransport ??
+                (providerId === 'codex'
+                    ? 'codex'
+                    : providerId === 'official'
+                        ? 'responses'
+                        : 'chat_completions');
+            return new DaemonBackend({
+                backend: 'openai',
+                sessionName: ctx.sessionName,
+                cwd: ctx.cwd,
+                project: ctx.project,
+                resumeSessionId: ctx.resumeSessionId,
+                extraEnv: ctx.extraEnv,
+                provider: {
+                    providerId,
+                    model: ctx.modelName,
+                    transport,
+                    ...(ctx.providerBaseUrl ? { baseUrl: ctx.providerBaseUrl } : {}),
+                },
+            });
+        },
+    },
+    {
+        id: 'openai-sdk',
+        summary: '进程内 @openai/agents SDK',
+        create: (ctx) => new OpenAiAgentBackend({
+            model: ctx.makeModel(),
+            cwd: ctx.cwd,
+            project: ctx.project,
+            sessionFile: ctx.sessionFile,
+        }),
+    },
+    {
+        id: 'claude-sdk',
+        summary: '进程内 claude-agent-sdk',
+        create: (ctx) => new ClaudeSdkBackend({ model: ctx.modelName, cwd: ctx.cwd, project: ctx.project }),
+    },
+];
+export const name = 'sps-agents-builtin';
+export const inject = [AGENTS];
+export function apply(ctx) {
+    for (const f of BUILTIN) {
+        // effect 作用域:插件卸载时这些后端跟着注销,不会留下"注册着但代码已不在"的条目。
+        ctx.effect(() => ctx[AGENTS].register(f));
+    }
+}
+//# sourceMappingURL=index.js.map

package/dist/seams/agents-builtin/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/seams/agents-builtin/index.ts"],"names":[],"mappings":"AAeA,OAAO,EAAE,gBAAgB,EAAE,MAAM,uCAAuC,CAAC;AACzE,OAAO,EAAE,aAAa,EAAE,MAAM,oCAAoC,CAAC;AACnE,OAAO,EAAE,kBAAkB,EAAE,MAAM,yCAAyC,CAAC;AAE7E,OAAO,EAAE,MAAM,EAA4B,MAAM,oBAAoB,CAAC;AAEtE,MAAM,OAAO,GAA0B;IACrC;QACE,EAAE,EAAE,eAAe;QACnB,OAAO,EAAE,sCAAsC;QAC/C,MAAM,EAAE,CAAC,GAAe,EAAE,EAAE,CAC1B,IAAI,aAAa,CAAC;YAChB,OAAO,EAAE,QAAQ;YACjB,WAAW,EAAE,GAAG,CAAC,WAAW;YAC5B,GAAG,EAAE,GAAG,CAAC,GAAG;YACZ,OAAO,EAAE,GAAG,CAAC,OAAO;YACpB,eAAe,EAAE,GAAG,CAAC,eAAe;YACpC,QAAQ,EAAE,GAAG,CAAC,QAAQ;SACvB,CAAC;KACL;IACD;QACE,EAAE,EAAE,eAAe;QACnB,OAAO,EAAE,oDAAoD;QAC7D,MAAM,EAAE,CAAC,GAAe,EAAE,EAAE;YAC1B,MAAM,UAAU,GAAG,GAAG,CAAC,UAAU,IAAI,UAAU,CAAC;YAChD,MAAM,SAAS,GACb,GAAG,CAAC,iBAAiB;gBACrB,CAAC,UAAU,KAAK,OAAO;oBACrB,CAAC,CAAC,OAAO;oBACT,CAAC,CAAC,UAAU,KAAK,UAAU;wBACzB,CAAC,CAAC,WAAW;wBACb,CAAC,CAAC,kBAAkB,CAAC,CAAC;YAC5B,OAAO,IAAI,aAAa,CAAC;gBACvB,OAAO,EAAE,QAAQ;gBACjB,WAAW,EAAE,GAAG,CAAC,WAAW;gBAC5B,GAAG,EAAE,GAAG,CAAC,GAAG;gBACZ,OAAO,EAAE,GAAG,CAAC,OAAO;gBACpB,eAAe,EAAE,GAAG,CAAC,eAAe;gBACpC,QAAQ,EAAE,GAAG,CAAC,QAAQ;gBACtB,QAAQ,EAAE;oBACR,UAAU;oBACV,KAAK,EAAE,GAAG,CAAC,SAAS;oBACpB,SAAS;oBACT,GAAG,CAAC,GAAG,CAAC,eAAe,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,GAAG,CAAC,eAAe,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;iBACjE;aACF,CAAC,CAAC;QACL,CAAC;KACF;IACD;QACE,EAAE,EAAE,YAAY;QAChB,OAAO,EAAE,wBAAwB;QACjC,MAAM,EAAE,CAAC,GAAe,EAAE,EAAE,CAC1B,IAAI,kBAAkB,CAAC;YACrB,KAAK,EAAE,GAAG,CAAC,SAAS,EAAE;YACtB,GAAG,EAAE,GAAG,CAAC,GAAG;YACZ,OAAO,EAAE,GAAG,CAAC,OAAO;YACpB,WAAW,EAAE,GAAG,CAAC,WAAW;SAC7B,CAAC;KACL;IACD;QACE,EAAE,EAAE,YAAY;QAChB,OAAO,EAAE,sBAAsB;QAC/B,MAAM,EAAE,CAAC,GAAe,EAAE,EAAE,CAC1B,IAAI,gBAAgB,CAAC,EAAE,KAAK,EAAE,GAAG,CAAC,SAAS,EAAE,GAAG,EAAE,GAAG,CAAC,GAAG,EAAE,OAAO,EAAE,GAAG,CAAC,OAAO,EAAE,CAAC;KACrF;CACF,CAAC;AAEF,MAAM,CAAC,MAAM,IAAI,GAAG,oBAAoB,CAAC;AACzC,MAAM,CAAC,MAAM,MAAM,GAAG,CAAC,MAAM,CAAC,CAAC;AAE/B,MAAM,UAAU,KAAK,CAAC,GAAY;IAChC,KAAK,MAAM,CAAC,IAAI,OAAO,EAAE,CAAC;QACxB,+CAA+C;QAC/C,GAAG,CAAC,MAAM,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC;IAC5C,CAAC;AACH,CAAC"}

package/dist/seams/capabilities/index.d.ts

@@ -0,0 +1,39 @@
+/**
+ * @module        seams/capabilities
+ * @description   **工具卡能力注册表 seam** —— 插件把能力注册进来,工具卡按 id 调。
+ *
+ * @layer         seam
+ *
+ * 类型:**乙 · 注册表型**。它本来就是注册表(`core/tools/registry`),
+ * 这一层只是把它**变成一个可被插件写入的服务**。
+ *
+ * 🔴 **改的是"谁能往里加",不是注册表本身。**
+ *    之前每跑一张工具卡就 `new CapabilityRegistry(artCapabilities())` —— 一个**每次重建、
+ *    只装内建**的注册表,插件根本插不进去。现在它是进程级服务,装配档决定谁往里注册。
+ *
+ * ⚠️ **script 层能力从这里进**:`Capability.source` 已经预留了
+ *    `{ kind: 'script', template, script }`。那条路一直被 template.json 未落地挡着;
+ *    插件化之后它的载体就是这个注册表 —— 一个模板包插件把自己的脚本能力注册进来。
+ */
+import { type Context, Service } from '@deepseek-ai/cordis';
+import type { Capability } from '../../core/tools/registry.js';
+export declare const CAPABILITIES = "sps.capabilities";
+export default class CapabilitySeam extends Service {
+    private readonly byId;
+    constructor(ctx: Context);
+    /**
+     * 注册一个能力。**返回注销函数**,调用方包进 `ctx.effect`。
+     *
+     * 🔴 重名**抛错**不是覆盖 —— 静默覆盖会让"我调的是哪一个 art.resize"无从判断
+     *    (与 `core/tools/registry` 原本的判据一致)。
+     */
+    register(cap: Capability): () => void;
+    get(id: string): Capability | undefined;
+    list(): Capability[];
+}
+declare module '@deepseek-ai/cordis' {
+    interface Context {
+        'sps.capabilities': CapabilitySeam;
+    }
+}
+//# sourceMappingURL=index.d.ts.map

package/dist/seams/capabilities/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/seams/capabilities/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AACH,OAAO,EAAE,KAAK,OAAO,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAC;AAC5D,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,8BAA8B,CAAC;AAE/D,eAAO,MAAM,YAAY,qBAAqB,CAAC;AAE/C,MAAM,CAAC,OAAO,OAAO,cAAe,SAAQ,OAAO;IACjD,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAiC;gBAE1C,GAAG,EAAE,OAAO;IAIxB;;;;;OAKG;IACH,QAAQ,CAAC,GAAG,EAAE,UAAU,GAAG,MAAM,IAAI;IAQrC,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,UAAU,GAAG,SAAS;IAIvC,IAAI,IAAI,UAAU,EAAE;CAGrB;AAED,OAAO,QAAQ,qBAAqB,CAAC;IACnC,UAAU,OAAO;QACf,kBAAkB,EAAE,cAAc,CAAC;KACpC;CACF"}

package/dist/seams/capabilities/index.js

@@ -0,0 +1,47 @@
+/**
+ * @module        seams/capabilities
+ * @description   **工具卡能力注册表 seam** —— 插件把能力注册进来,工具卡按 id 调。
+ *
+ * @layer         seam
+ *
+ * 类型:**乙 · 注册表型**。它本来就是注册表(`core/tools/registry`),
+ * 这一层只是把它**变成一个可被插件写入的服务**。
+ *
+ * 🔴 **改的是"谁能往里加",不是注册表本身。**
+ *    之前每跑一张工具卡就 `new CapabilityRegistry(artCapabilities())` —— 一个**每次重建、
+ *    只装内建**的注册表,插件根本插不进去。现在它是进程级服务,装配档决定谁往里注册。
+ *
+ * ⚠️ **script 层能力从这里进**:`Capability.source` 已经预留了
+ *    `{ kind: 'script', template, script }`。那条路一直被 template.json 未落地挡着;
+ *    插件化之后它的载体就是这个注册表 —— 一个模板包插件把自己的脚本能力注册进来。
+ */
+import { Service } from '@deepseek-ai/cordis';
+export const CAPABILITIES = 'sps.capabilities';
+export default class CapabilitySeam extends Service {
+    byId = new Map();
+    constructor(ctx) {
+        super(ctx, CAPABILITIES);
+    }
+    /**
+     * 注册一个能力。**返回注销函数**,调用方包进 `ctx.effect`。
+     *
+     * 🔴 重名**抛错**不是覆盖 —— 静默覆盖会让"我调的是哪一个 art.resize"无从判断
+     *    (与 `core/tools/registry` 原本的判据一致)。
+     */
+    register(cap) {
+        if (this.byId.has(cap.id))
+            throw new Error(`能力 id 重复:${cap.id}`);
+        this.byId.set(cap.id, cap);
+        return () => {
+            if (this.byId.get(cap.id) === cap)
+                this.byId.delete(cap.id);
+        };
+    }
+    get(id) {
+        return this.byId.get(id);
+    }
+    list() {
+        return [...this.byId.values()].sort((a, b) => a.id.localeCompare(b.id));
+    }
+}
+//# sourceMappingURL=index.js.map

package/dist/seams/capabilities/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/seams/capabilities/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AACH,OAAO,EAAgB,OAAO,EAAE,MAAM,qBAAqB,CAAC;AAG5D,MAAM,CAAC,MAAM,YAAY,GAAG,kBAAkB,CAAC;AAE/C,MAAM,CAAC,OAAO,OAAO,cAAe,SAAQ,OAAO;IAChC,IAAI,GAAG,IAAI,GAAG,EAAsB,CAAC;IAEtD,YAAY,GAAY;QACtB,KAAK,CAAC,GAAG,EAAE,YAAY,CAAC,CAAC;IAC3B,CAAC;IAED;;;;;OAKG;IACH,QAAQ,CAAC,GAAe;QACtB,IAAI,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC;YAAE,MAAM,IAAI,KAAK,CAAC,YAAY,GAAG,CAAC,EAAE,EAAE,CAAC,CAAC;QACjE,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,EAAE,GAAG,CAAC,CAAC;QAC3B,OAAO,GAAG,EAAE;YACV,IAAI,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC,KAAK,GAAG;gBAAE,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QAC9D,CAAC,CAAC;IACJ,CAAC;IAED,GAAG,CAAC,EAAU;QACZ,OAAO,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IAC3B,CAAC;IAED,IAAI;QACF,OAAO,CAAC,GAAG,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,aAAa,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IAC1E,CAAC;CACF"}

package/dist/seams/capabilities-art/index.d.ts

@@ -0,0 +1,14 @@
+/**
+ * @module        seams/capabilities-art
+ * @description   把十个内建 art 能力注册进 `sps.capabilities`。
+ *
+ * @layer         seam
+ *
+ * ⚠️ 能力本身(取参/围栏/落盘)不动,仍在 `core/tools/artCapabilities` ——
+ *    这一步只搬**注册方式**。
+ */
+import type { Context } from '@deepseek-ai/cordis';
+export declare const name = "sps-capabilities-art";
+export declare const inject: string[];
+export declare function apply(ctx: Context): void;
+//# sourceMappingURL=index.d.ts.map

package/dist/seams/capabilities-art/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/seams/capabilities-art/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAC;AAInD,eAAO,MAAM,IAAI,yBAAyB,CAAC;AAC3C,eAAO,MAAM,MAAM,UAAiB,CAAC;AAErC,wBAAgB,KAAK,CAAC,GAAG,EAAE,OAAO,GAAG,IAAI,CAExC"}

package/dist/seams/capabilities-art/index.js

@@ -0,0 +1,9 @@
+import { artCapabilities } from '../../core/tools/artCapabilities.js';
+import { CAPABILITIES } from '../capabilities/index.js';
+export const name = 'sps-capabilities-art';
+export const inject = [CAPABILITIES];
+export function apply(ctx) {
+    for (const cap of artCapabilities())
+        ctx.effect(() => ctx[CAPABILITIES].register(cap));
+}
+//# sourceMappingURL=index.js.map

package/dist/seams/capabilities-art/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/seams/capabilities-art/index.ts"],"names":[],"mappings":"AAUA,OAAO,EAAE,eAAe,EAAE,MAAM,qCAAqC,CAAC;AACtE,OAAO,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAExD,MAAM,CAAC,MAAM,IAAI,GAAG,sBAAsB,CAAC;AAC3C,MAAM,CAAC,MAAM,MAAM,GAAG,CAAC,YAAY,CAAC,CAAC;AAErC,MAAM,UAAU,KAAK,CAAC,GAAY;IAChC,KAAK,MAAM,GAAG,IAAI,eAAe,EAAE;QAAE,GAAG,CAAC,MAAM,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC;AACzF,CAAC"}

package/dist/seams/im/index.d.ts

@@ -0,0 +1,28 @@
+/**
+ * @module        seams/im
+ * @description   **IM 平台适配器注册表 seam** —— telegram / 钉钉 / matrix / slack …
+ *
+ * @layer         seam
+ *
+ * 类型:**乙 · 注册表型**。与 `sps.media` 同一条判据:
+ * 🔴 **seam 在 adapter,不在实例。**
+ *    "配了哪几个机器人、各自什么 token"是**数据**,落 `~/.coral/im/config.json`
+ *    (含密,0600,已有测试锁着);而"支持哪些平台"是一张写死在
+ *    `IMGatewayManager.REGISTRY` 里的表 —— 加一个平台必须改内核。痛在这儿。
+ */
+import { type Context, Service } from '@deepseek-ai/cordis';
+import type { IMAdapterFactory } from '../../im/IMAdapter.js';
+export declare const IM = "sps.im";
+export default class IMAdapterRegistry extends Service {
+    private readonly byKind;
+    constructor(ctx: Context);
+    register(kind: string, factory: IMAdapterFactory): () => void;
+    get(kind: string): IMAdapterFactory | undefined;
+    list(): string[];
+}
+declare module '@deepseek-ai/cordis' {
+    interface Context {
+        'sps.im': IMAdapterRegistry;
+    }
+}
+//# sourceMappingURL=index.d.ts.map

package/dist/seams/im/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/seams/im/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AACH,OAAO,EAAE,KAAK,OAAO,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAC;AAC5D,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAE9D,eAAO,MAAM,EAAE,WAAW,CAAC;AAE3B,MAAM,CAAC,OAAO,OAAO,iBAAkB,SAAQ,OAAO;IACpD,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAuC;gBAElD,GAAG,EAAE,OAAO;IAIxB,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,gBAAgB,GAAG,MAAM,IAAI;IAQ7D,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,gBAAgB,GAAG,SAAS;IAI/C,IAAI,IAAI,MAAM,EAAE;CAGjB;AAED,OAAO,QAAQ,qBAAqB,CAAC;IACnC,UAAU,OAAO;QACf,QAAQ,EAAE,iBAAiB,CAAC;KAC7B;CACF"}

package/dist/seams/im/index.js

@@ -0,0 +1,36 @@
+/**
+ * @module        seams/im
+ * @description   **IM 平台适配器注册表 seam** —— telegram / 钉钉 / matrix / slack …
+ *
+ * @layer         seam
+ *
+ * 类型:**乙 · 注册表型**。与 `sps.media` 同一条判据:
+ * 🔴 **seam 在 adapter,不在实例。**
+ *    "配了哪几个机器人、各自什么 token"是**数据**,落 `~/.coral/im/config.json`
+ *    (含密,0600,已有测试锁着);而"支持哪些平台"是一张写死在
+ *    `IMGatewayManager.REGISTRY` 里的表 —— 加一个平台必须改内核。痛在这儿。
+ */
+import { Service } from '@deepseek-ai/cordis';
+export const IM = 'sps.im';
+export default class IMAdapterRegistry extends Service {
+    byKind = new Map();
+    constructor(ctx) {
+        super(ctx, IM);
+    }
+    register(kind, factory) {
+        if (this.byKind.has(kind))
+            throw new Error(`IM 平台 kind 重复:${kind}`);
+        this.byKind.set(kind, factory);
+        return () => {
+            if (this.byKind.get(kind) === factory)
+                this.byKind.delete(kind);
+        };
+    }
+    get(kind) {
+        return this.byKind.get(kind);
+    }
+    list() {
+        return [...this.byKind.keys()].sort();
+    }
+}
+//# sourceMappingURL=index.js.map

package/dist/seams/im/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/seams/im/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AACH,OAAO,EAAgB,OAAO,EAAE,MAAM,qBAAqB,CAAC;AAG5D,MAAM,CAAC,MAAM,EAAE,GAAG,QAAQ,CAAC;AAE3B,MAAM,CAAC,OAAO,OAAO,iBAAkB,SAAQ,OAAO;IACnC,MAAM,GAAG,IAAI,GAAG,EAA4B,CAAC;IAE9D,YAAY,GAAY;QACtB,KAAK,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC;IACjB,CAAC;IAED,QAAQ,CAAC,IAAY,EAAE,OAAyB;QAC9C,IAAI,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC;YAAE,MAAM,IAAI,KAAK,CAAC,iBAAiB,IAAI,EAAE,CAAC,CAAC;QACpE,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;QAC/B,OAAO,GAAG,EAAE;YACV,IAAI,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,KAAK,OAAO;gBAAE,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;QAClE,CAAC,CAAC;IACJ,CAAC;IAED,GAAG,CAAC,IAAY;QACd,OAAO,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IAC/B,CAAC;IAED,IAAI;QACF,OAAO,CAAC,GAAG,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;IACxC,CAAC;CACF"}

package/dist/seams/im-builtin/index.d.ts

@@ -0,0 +1,13 @@
+/**
+ * @module        seams/im-builtin
+ * @description   内建的六个 IM 平台注册进 `sps.im`。
+ *
+ * @layer         seam
+ *
+ * ⚠️ 适配器实现不动,仍在 `im/adapters/` —— 这一步只搬**注册方式**。
+ */
+import type { Context } from '@deepseek-ai/cordis';
+export declare const name = "sps-im-builtin";
+export declare const inject: string[];
+export declare function apply(ctx: Context): void;
+//# sourceMappingURL=index.d.ts.map

package/dist/seams/im-builtin/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/seams/im-builtin/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAC;AAUnD,eAAO,MAAM,IAAI,mBAAmB,CAAC;AACrC,eAAO,MAAM,MAAM,UAAO,CAAC;AAa3B,wBAAgB,KAAK,CAAC,GAAG,EAAE,OAAO,GAAG,IAAI,CAIxC"}

package/dist/seams/im-builtin/index.js

@@ -0,0 +1,25 @@
+import { DingTalkAdapter } from '../../im/adapters/dingtalkAdapter.js';
+import { DiscordAdapter } from '../../im/adapters/discordAdapter.js';
+import { FeishuAdapter } from '../../im/adapters/feishuAdapter.js';
+import { MatrixAdapter } from '../../im/adapters/matrixAdapter.js';
+import { SlackAdapter } from '../../im/adapters/slackAdapter.js';
+import { TelegramAdapter } from '../../im/adapters/telegramAdapter.js';
+import { IM } from '../im/index.js';
+export const name = 'sps-im-builtin';
+export const inject = [IM];
+// biome-ignore-start lint/suspicious/noExplicitAny: 各适配器的 cfg 形状不同,原样沿用既有写法
+const BUILT_IN = {
+    telegram: (cfg) => new TelegramAdapter(cfg),
+    dingtalk: (cfg) => new DingTalkAdapter(cfg),
+    matrix: (cfg) => new MatrixAdapter(cfg),
+    slack: (cfg) => new SlackAdapter(cfg),
+    discord: (cfg) => new DiscordAdapter(cfg),
+    feishu: (cfg) => new FeishuAdapter(cfg),
+};
+// biome-ignore-end lint/suspicious/noExplicitAny: 见上
+export function apply(ctx) {
+    for (const [kind, factory] of Object.entries(BUILT_IN)) {
+        ctx.effect(() => ctx[IM].register(kind, factory));
+    }
+}
+//# sourceMappingURL=index.js.map

package/dist/seams/im-builtin/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/seams/im-builtin/index.ts"],"names":[],"mappings":"AASA,OAAO,EAAE,eAAe,EAAE,MAAM,sCAAsC,CAAC;AACvE,OAAO,EAAE,cAAc,EAAE,MAAM,qCAAqC,CAAC;AACrE,OAAO,EAAE,aAAa,EAAE,MAAM,oCAAoC,CAAC;AACnE,OAAO,EAAE,aAAa,EAAE,MAAM,oCAAoC,CAAC;AACnE,OAAO,EAAE,YAAY,EAAE,MAAM,mCAAmC,CAAC;AACjE,OAAO,EAAE,eAAe,EAAE,MAAM,sCAAsC,CAAC;AAEvE,OAAO,EAAE,EAAE,EAAE,MAAM,gBAAgB,CAAC;AAEpC,MAAM,CAAC,MAAM,IAAI,GAAG,gBAAgB,CAAC;AACrC,MAAM,CAAC,MAAM,MAAM,GAAG,CAAC,EAAE,CAAC,CAAC;AAE3B,4EAA4E;AAC5E,MAAM,QAAQ,GAAqC;IACjD,QAAQ,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,IAAI,eAAe,CAAC,GAAU,CAAC;IAClD,QAAQ,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,IAAI,eAAe,CAAC,GAAU,CAAC;IAClD,MAAM,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,IAAI,aAAa,CAAC,GAAU,CAAC;IAC9C,KAAK,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,IAAI,YAAY,CAAC,GAAU,CAAC;IAC5C,OAAO,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,IAAI,cAAc,CAAC,GAAU,CAAC;IAChD,MAAM,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,IAAI,aAAa,CAAC,GAAU,CAAC;CAC/C,CAAC;AACF,qDAAqD;AAErD,MAAM,UAAU,KAAK,CAAC,GAAY;IAChC,KAAK,MAAM,CAAC,IAAI,EAAE,OAAO,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAC;QACvD,GAAG,CAAC,MAAM,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC,CAAC;IACpD,CAAC;AACH,CAAC"}

package/dist/seams/media/index.d.ts

@@ -0,0 +1,30 @@
+/**
+ * @module        seams/media
+ * @description   **媒体适配器注册表 seam** —— 生图/生视频/TTS 各家厂商的调用适配。
+ *
+ * @layer         seam
+ *
+ * 类型:**乙 · 注册表型**。
+ *
+ * 🔴 **seam 的位置在 adapter,不在 provider。**
+ *    provider(端点 + 密钥 + 能力)本来就是**数据**,存在 `~/.coral/media-providers.json`,
+ *    加一个 = 改配置。而 `ADAPTERS` 是一张**写死的表** ——
+ *    加一个新厂商(Replicate / Luma…)必须改内核代码。**痛在这儿,seam 就该在这儿。**
+ *    看错位置的话,会把一个已经可配置的东西再包一层,却没解决真正卡人的那一格。
+ */
+import { type Context, Service } from '@deepseek-ai/cordis';
+import type { MediaAdapter } from '../../providers/media/adapters.js';
+export declare const MEDIA = "sps.media";
+export default class MediaAdapterRegistry extends Service {
+    private readonly byId;
+    constructor(ctx: Context);
+    register(id: string, adapter: MediaAdapter): () => void;
+    get(id: string): MediaAdapter | undefined;
+    list(): string[];
+}
+declare module '@deepseek-ai/cordis' {
+    interface Context {
+        'sps.media': MediaAdapterRegistry;
+    }
+}
+//# sourceMappingURL=index.d.ts.map

package/dist/seams/media/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/seams/media/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AACH,OAAO,EAAE,KAAK,OAAO,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAC;AAC5D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mCAAmC,CAAC;AAEtE,eAAO,MAAM,KAAK,cAAc,CAAC;AAEjC,MAAM,CAAC,OAAO,OAAO,oBAAqB,SAAQ,OAAO;IACvD,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAmC;gBAE5C,GAAG,EAAE,OAAO;IAIxB,QAAQ,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,YAAY,GAAG,MAAM,IAAI;IAQvD,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,YAAY,GAAG,SAAS;IAIzC,IAAI,IAAI,MAAM,EAAE;CAGjB;AAED,OAAO,QAAQ,qBAAqB,CAAC;IACnC,UAAU,OAAO;QACf,WAAW,EAAE,oBAAoB,CAAC;KACnC;CACF"}

package/dist/seams/media/index.js

@@ -0,0 +1,38 @@
+/**
+ * @module        seams/media
+ * @description   **媒体适配器注册表 seam** —— 生图/生视频/TTS 各家厂商的调用适配。
+ *
+ * @layer         seam
+ *
+ * 类型:**乙 · 注册表型**。
+ *
+ * 🔴 **seam 的位置在 adapter,不在 provider。**
+ *    provider(端点 + 密钥 + 能力)本来就是**数据**,存在 `~/.coral/media-providers.json`,
+ *    加一个 = 改配置。而 `ADAPTERS` 是一张**写死的表** ——
+ *    加一个新厂商(Replicate / Luma…)必须改内核代码。**痛在这儿,seam 就该在这儿。**
+ *    看错位置的话,会把一个已经可配置的东西再包一层,却没解决真正卡人的那一格。
+ */
+import { Service } from '@deepseek-ai/cordis';
+export const MEDIA = 'sps.media';
+export default class MediaAdapterRegistry extends Service {
+    byId = new Map();
+    constructor(ctx) {
+        super(ctx, MEDIA);
+    }
+    register(id, adapter) {
+        if (this.byId.has(id))
+            throw new Error(`媒体适配器 id 重复:${id}`);
+        this.byId.set(id, adapter);
+        return () => {
+            if (this.byId.get(id) === adapter)
+                this.byId.delete(id);
+        };
+    }
+    get(id) {
+        return this.byId.get(id);
+    }
+    list() {
+        return [...this.byId.keys()].sort();
+    }
+}
+//# sourceMappingURL=index.js.map

package/dist/seams/media/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/seams/media/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AACH,OAAO,EAAgB,OAAO,EAAE,MAAM,qBAAqB,CAAC;AAG5D,MAAM,CAAC,MAAM,KAAK,GAAG,WAAW,CAAC;AAEjC,MAAM,CAAC,OAAO,OAAO,oBAAqB,SAAQ,OAAO;IACtC,IAAI,GAAG,IAAI,GAAG,EAAwB,CAAC;IAExD,YAAY,GAAY;QACtB,KAAK,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;IACpB,CAAC;IAED,QAAQ,CAAC,EAAU,EAAE,OAAqB;QACxC,IAAI,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;YAAE,MAAM,IAAI,KAAK,CAAC,eAAe,EAAE,EAAE,CAAC,CAAC;QAC5D,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,OAAO,CAAC,CAAC;QAC3B,OAAO,GAAG,EAAE;YACV,IAAI,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,KAAK,OAAO;gBAAE,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;QAC1D,CAAC,CAAC;IACJ,CAAC;IAED,GAAG,CAAC,EAAU;QACZ,OAAO,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IAC3B,CAAC;IAED,IAAI;QACF,OAAO,CAAC,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;IACtC,CAAC;CACF"}

package/dist/seams/media-builtin/index.d.ts

@@ -0,0 +1,13 @@
+/**
+ * @module        seams/media-builtin
+ * @description   把内建的十个媒体适配器注册进 `sps.media`。
+ *
+ * @layer         seam
+ *
+ * ⚠️ 适配器实现不动,仍在 `providers/media/adapters` —— 这一步只搬**注册方式**。
+ */
+import type { Context } from '@deepseek-ai/cordis';
+export declare const name = "sps-media-builtin";
+export declare const inject: string[];
+export declare function apply(ctx: Context): void;
+//# sourceMappingURL=index.d.ts.map

package/dist/seams/media-builtin/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/seams/media-builtin/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAC;AAInD,eAAO,MAAM,IAAI,sBAAsB,CAAC;AACxC,eAAO,MAAM,MAAM,UAAU,CAAC;AAE9B,wBAAgB,KAAK,CAAC,GAAG,EAAE,OAAO,GAAG,IAAI,CAIxC"}

package/dist/seams/media-builtin/index.js

@@ -0,0 +1,10 @@
+import { ADAPTERS } from '../../providers/media/adapters.js';
+import { MEDIA } from '../media/index.js';
+export const name = 'sps-media-builtin';
+export const inject = [MEDIA];
+export function apply(ctx) {
+    for (const [id, adapter] of Object.entries(ADAPTERS)) {
+        ctx.effect(() => ctx[MEDIA].register(id, adapter));
+    }
+}
+//# sourceMappingURL=index.js.map

package/dist/seams/media-builtin/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/seams/media-builtin/index.ts"],"names":[],"mappings":"AASA,OAAO,EAAE,QAAQ,EAAE,MAAM,mCAAmC,CAAC;AAC7D,OAAO,EAAE,KAAK,EAAE,MAAM,mBAAmB,CAAC;AAE1C,MAAM,CAAC,MAAM,IAAI,GAAG,mBAAmB,CAAC;AACxC,MAAM,CAAC,MAAM,MAAM,GAAG,CAAC,KAAK,CAAC,CAAC;AAE9B,MAAM,UAAU,KAAK,CAAC,GAAY;IAChC,KAAK,MAAM,CAAC,EAAE,EAAE,OAAO,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAC;QACrD,GAAG,CAAC,MAAM,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,QAAQ,CAAC,EAAE,EAAE,OAAO,CAAC,CAAC,CAAC;IACrD,CAAC;AACH,CAAC"}

package/dist/seams/memory/index.d.ts

@@ -0,0 +1,58 @@
+/**
+ * @module        seams/memory
+ * @description   **记忆 seam 的服务定义** —— 读路契约在这里,实现在 `memory-*`。
+ *
+ * @layer         seam
+ *
+ * 类型:**甲 · 工厂型**(见 docs/design/plugin-architecture.md §3c)。
+ * 判据是「换实现是**部署决定**」——"这台节点的记忆走本地 markdown 还是别的后端"。
+ *
+ * 🔴 **seam 只管"哪个后端",不管"这个后端开不开"。**
+ *    memory2 自己有 `SPS_MEMORY_MODE=none` 这个开关,那是**后端的配置**。
+ *    在 seam 上再造一个 `memory-none`,就有了两处能关掉记忆的地方 —— 两处判据必漂,
+ *    而且排错时"到底是谁关的"要翻两个地方。
+ *    (与 notifier 一致:seam 选 Matrix,MatrixNotifier 自己读 MATRIX_* 并自我降级。)
+ *
+ * ⚠️ **今天只有一个实现**,而且是有意的:`external` / `local+external` 的适配器
+ *    memory2 里明确标了 YAGNI(无已接外部后端)。造第二个实现只为"证明能换",
+ *    等于造一条没有东西会跑的路径。可换性由用例上的替身证明,不由多发一个包证明。
+ */
+import { type Context, Service } from '@deepseek-ai/cordis';
+import type { WorkerOutputEvent } from '../../core/agents/AgentBackend.js';
+import type { CaptureOutcome } from '../../core/memory2/capture.js';
+import type { MemoryEntry, SaveInput, ScopeRef } from '../../core/memory2/types.js';
+/** 服务名。加 `sps.` 前缀 —— Cordis 是扁平命名空间。 */
+export declare const MEMORY = "sps.memory";
+export declare abstract class MemorySeam extends Service {
+    constructor(ctx: Context);
+    /**
+     * 拼 `<memory>` 注入块;**没有记忆时返回空串**(派活方据此决定要不要 prepend)。
+     *
+     * 🔴 返回空串是契约的一部分,不是"失败" —— 实现不要用抛错表达"没有记忆"。
+     */
+    abstract buildInjection(refs: ScopeRef[]): string;
+    abstract captureStart(project: string, cardId: string): void;
+    /** 绑一个取消订阅函数;flush/discard 时由实现负责调用。 */
+    abstract captureBindUnsub(project: string, cardId: string, unsub: () => void): void;
+    abstract captureNote(project: string, cardId: string, ev: WorkerOutputEvent): void;
+    /** 落盘并结束这次捕获。 */
+    abstract captureFlush(project: string, cardId: string): CaptureOutcome;
+    /** 丢弃这次捕获(卡失败/取消时用),**不落盘**。 */
+    abstract captureDiscard(project: string, cardId: string): void;
+    abstract listEntries(ref: ScopeRef): MemoryEntry[];
+    abstract readEntry(ref: ScopeRef, id: string): MemoryEntry | null;
+    abstract listAllScopes(): ScopeRef[];
+    abstract saveEntry(ref: ScopeRef, input: SaveInput): MemoryEntry;
+    abstract deleteEntry(ref: ScopeRef, id: string): boolean;
+    /** 记一次"被用到" —— 检索排序要用。 */
+    abstract bumpUses(ref: ScopeRef, id: string): void;
+    abstract promoteEntry(from: ScopeRef, id: string, to: ScopeRef, opts: {
+        move?: boolean;
+    }): MemoryEntry | null;
+}
+declare module '@deepseek-ai/cordis' {
+    interface Context {
+        'sps.memory': MemorySeam;
+    }
+}
+//# sourceMappingURL=index.d.ts.map

package/dist/seams/memory/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/seams/memory/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AACH,OAAO,EAAE,KAAK,OAAO,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAC;AAC5D,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,mCAAmC,CAAC;AAC3E,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAC;AACpE,OAAO,KAAK,EAAE,WAAW,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,6BAA6B,CAAC;AAEpF,yCAAyC;AACzC,eAAO,MAAM,MAAM,eAAe,CAAC;AAEnC,8BAAsB,UAAW,SAAQ,OAAO;gBAClC,GAAG,EAAE,OAAO;IAMxB;;;;OAIG;IACH,QAAQ,CAAC,cAAc,CAAC,IAAI,EAAE,QAAQ,EAAE,GAAG,MAAM;IAWjD,QAAQ,CAAC,YAAY,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI;IAC5D,wCAAwC;IACxC,QAAQ,CAAC,gBAAgB,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,IAAI,GAAG,IAAI;IACnF,QAAQ,CAAC,WAAW,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,EAAE,EAAE,iBAAiB,GAAG,IAAI;IAClF,iBAAiB;IACjB,QAAQ,CAAC,YAAY,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,cAAc;IACtE,gCAAgC;IAChC,QAAQ,CAAC,cAAc,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI;IAI9D,QAAQ,CAAC,WAAW,CAAC,GAAG,EAAE,QAAQ,GAAG,WAAW,EAAE;IAClD,QAAQ,CAAC,SAAS,CAAC,GAAG,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,GAAG,WAAW,GAAG,IAAI;IACjE,QAAQ,CAAC,aAAa,IAAI,QAAQ,EAAE;IAQpC,QAAQ,CAAC,SAAS,CAAC,GAAG,EAAE,QAAQ,EAAE,KAAK,EAAE,SAAS,GAAG,WAAW;IAChE,QAAQ,CAAC,WAAW,CAAC,GAAG,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,GAAG,OAAO;IACxD,0BAA0B;IAC1B,QAAQ,CAAC,QAAQ,CAAC,GAAG,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,GAAG,IAAI;IAClD,QAAQ,CAAC,YAAY,CAAC,IAAI,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE;QAAE,IAAI,CAAC,EAAE,OAAO,CAAA;KAAE,GAAG,WAAW,GAAG,IAAI;CAC9G;AAED,OAAO,QAAQ,qBAAqB,CAAC;IACnC,UAAU,OAAO;QACf,YAAY,EAAE,UAAU,CAAC;KAC1B;CACF"}

package/dist/seams/memory/index.js

@@ -0,0 +1,28 @@
+/**
+ * @module        seams/memory
+ * @description   **记忆 seam 的服务定义** —— 读路契约在这里,实现在 `memory-*`。
+ *
+ * @layer         seam
+ *
+ * 类型:**甲 · 工厂型**(见 docs/design/plugin-architecture.md §3c)。
+ * 判据是「换实现是**部署决定**」——"这台节点的记忆走本地 markdown 还是别的后端"。
+ *
+ * 🔴 **seam 只管"哪个后端",不管"这个后端开不开"。**
+ *    memory2 自己有 `SPS_MEMORY_MODE=none` 这个开关,那是**后端的配置**。
+ *    在 seam 上再造一个 `memory-none`,就有了两处能关掉记忆的地方 —— 两处判据必漂,
+ *    而且排错时"到底是谁关的"要翻两个地方。
+ *    (与 notifier 一致:seam 选 Matrix,MatrixNotifier 自己读 MATRIX_* 并自我降级。)
+ *
+ * ⚠️ **今天只有一个实现**,而且是有意的:`external` / `local+external` 的适配器
+ *    memory2 里明确标了 YAGNI(无已接外部后端)。造第二个实现只为"证明能换",
+ *    等于造一条没有东西会跑的路径。可换性由用例上的替身证明,不由多发一个包证明。
+ */
+import { Service } from '@deepseek-ai/cordis';
+/** 服务名。加 `sps.` 前缀 —— Cordis 是扁平命名空间。 */
+export const MEMORY = 'sps.memory';
+export class MemorySeam extends Service {
+    constructor(ctx) {
+        super(ctx, MEMORY);
+    }
+}
+//# sourceMappingURL=index.js.map

package/dist/seams/memory/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/seams/memory/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AACH,OAAO,EAAgB,OAAO,EAAE,MAAM,qBAAqB,CAAC;AAK5D,yCAAyC;AACzC,MAAM,CAAC,MAAM,MAAM,GAAG,YAAY,CAAC;AAEnC,MAAM,OAAgB,UAAW,SAAQ,OAAO;IAC9C,YAAY,GAAY;QACtB,KAAK,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC;IACrB,CAAC;CA8CF"}