@downcity/agent 1.1.10 → 1.1.12

package/bin/sdk/SdkSessionSystemComposer.d.ts

@@ -0,0 +1,106 @@
+/**
+ * SDK Session 默认 system composer。
+ *
+ * 关键点（中文）
+ * - 面向 `Agent` SDK 的本地会话执行场景。
+ * - 注入调用方显式传入的静态 instruction、显式注入 service system 与显式注册 plugin system。
+ * - SDK 不在 system 中注入动态变量；动态上下文应由调用方放入 user message。
+ */
+import { SessionSystemComposer } from "../session/composer/system/SessionSystemComposer.js";
+import type { SessionSystemMessage } from "../session/types/SessionPrompts.js";
+import type { AgentSessionSystemBlock } from "../sdk/AgentSdkTypes.js";
+/**
+ * 解析 SDK session system blocks 的输入。
+ */
+export interface ResolveSdkSessionSystemBlocksParams {
+    /**
+     * 当前 agent 的稳定标识。
+     */
+    agentId: string;
+    /**
+     * 当前 agent 绑定的项目根目录。
+     */
+    projectRoot: string;
+    /**
+     * 当前 sessionId。
+     */
+    sessionId: string;
+    /**
+     * 当前 session 首次创建时间（ms）。
+     */
+    createdAt: number;
+    /**
+     * 当前 session 初始化时解析到的系统时区。
+     */
+    timezone: string;
+    /**
+     * 读取当前 SDK 调用方传入的 instruction system blocks。
+     */
+    getInstructionSystemBlocks: () => AgentSessionSystemBlock[];
+    /**
+     * 读取当前显式注入 service 的 system blocks。
+     */
+    getServiceSystemBlocks: () => Promise<AgentSessionSystemBlock[]>;
+    /**
+     * 读取当前显式注册 plugin 的 system blocks。
+     */
+    getPluginSystemBlocks: () => Promise<AgentSessionSystemBlock[]>;
+}
+type SdkSessionSystemComposerOptions = {
+    /**
+     * 当前 agent 的稳定标识。
+     */
+    agentId: string;
+    /**
+     * 当前 agent 绑定的项目根目录。
+     */
+    projectRoot: string;
+    /**
+     * 读取当前 session 首次创建时间（ms）。
+     */
+    getSessionCreatedAt: () => number;
+    /**
+     * 读取当前 session 初始化时解析到的系统时区。
+     */
+    getSessionTimezone: () => string;
+    /**
+     * 读取当前 SDK 调用方传入的 instruction system blocks。
+     */
+    getInstructionSystemBlocks: () => AgentSessionSystemBlock[];
+    /**
+     * 读取当前显式注册 plugin 的 system blocks。
+     */
+    getPluginSystemBlocks: () => Promise<AgentSessionSystemBlock[]>;
+    /**
+     * 读取当前显式注入 service 的 system blocks。
+     */
+    getServiceSystemBlocks: () => Promise<AgentSessionSystemBlock[]>;
+};
+/**
+ * 解析 SDK session 当前生效的 system blocks。
+ */
+export declare function resolveSdkSessionSystemBlocks(params: ResolveSdkSessionSystemBlocksParams): Promise<AgentSessionSystemBlock[]>;
+/**
+ * 解析 SDK session 当前生效的 system messages。
+ */
+export declare function resolveSdkSessionSystemMessages(params: ResolveSdkSessionSystemBlocksParams): Promise<SessionSystemMessage[]>;
+/**
+ * SDK Session system composer 实现。
+ */
+export declare class SdkSessionSystemComposer extends SessionSystemComposer {
+    readonly name = "sdk_prompt_system";
+    private readonly agentId;
+    private readonly projectRoot;
+    private readonly getSessionCreatedAt;
+    private readonly getSessionTimezone;
+    private readonly getInstructionSystemBlocks;
+    private readonly getServiceSystemBlocks;
+    private readonly getPluginSystemBlocks;
+    constructor(options: SdkSessionSystemComposerOptions);
+    /**
+     * 解析本轮 SDK session system messages。
+     */
+    resolve(): Promise<import("ai").SystemModelMessage[]>;
+}
+export {};
+//# sourceMappingURL=SdkSessionSystemComposer.d.ts.map

package/bin/sdk/SdkSessionSystemComposer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SdkSessionSystemComposer.d.ts","sourceRoot":"","sources":["../../src/sdk/SdkSessionSystemComposer.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,qBAAqB,EAAE,MAAM,mDAAmD,CAAC;AAE1F,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,mCAAmC,CAAC;AAC9E,OAAO,KAAK,EACV,uBAAuB,EAExB,MAAM,wBAAwB,CAAC;AAEhC;;GAEG;AACH,MAAM,WAAW,mCAAmC;IAClD;;OAEG;IACH,OAAO,EAAE,MAAM,CAAC;IAEhB;;OAEG;IACH,WAAW,EAAE,MAAM,CAAC;IAEpB;;OAEG;IACH,SAAS,EAAE,MAAM,CAAC;IAElB;;OAEG;IACH,SAAS,EAAE,MAAM,CAAC;IAElB;;OAEG;IACH,QAAQ,EAAE,MAAM,CAAC;IAEjB;;OAEG;IACH,0BAA0B,EAAE,MAAM,uBAAuB,EAAE,CAAC;IAE5D;;OAEG;IACH,sBAAsB,EAAE,MAAM,OAAO,CAAC,uBAAuB,EAAE,CAAC,CAAC;IAEjE;;OAEG;IACH,qBAAqB,EAAE,MAAM,OAAO,CAAC,uBAAuB,EAAE,CAAC,CAAC;CACjE;AAED,KAAK,+BAA+B,GAAG;IACrC;;OAEG;IACH,OAAO,EAAE,MAAM,CAAC;IAEhB;;OAEG;IACH,WAAW,EAAE,MAAM,CAAC;IAEpB;;OAEG;IACH,mBAAmB,EAAE,MAAM,MAAM,CAAC;IAElC;;OAEG;IACH,kBAAkB,EAAE,MAAM,MAAM,CAAC;IAEjC;;OAEG;IACH,0BAA0B,EAAE,MAAM,uBAAuB,EAAE,CAAC;IAE5D;;OAEG;IACH,qBAAqB,EAAE,MAAM,OAAO,CAAC,uBAAuB,EAAE,CAAC,CAAC;IAEhE;;OAEG;IACH,sBAAsB,EAAE,MAAM,OAAO,CAAC,uBAAuB,EAAE,CAAC,CAAC;CAClE,CAAC;AA+DF;;GAEG;AACH,wBAAsB,6BAA6B,CACjD,MAAM,EAAE,mCAAmC,GAC1C,OAAO,CAAC,uBAAuB,EAAE,CAAC,CA8BpC;AAED;;GAEG;AACH,wBAAsB,+BAA+B,CACnD,MAAM,EAAE,mCAAmC,GAC1C,OAAO,CAAC,oBAAoB,EAAE,CAAC,CAMjC;AAED;;GAEG;AACH,qBAAa,wBAAyB,SAAQ,qBAAqB;IACjE,QAAQ,CAAC,IAAI,uBAAuB;IAEpC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAS;IACrC,OAAO,CAAC,QAAQ,CAAC,mBAAmB,CAAyD;IAC7F,OAAO,CAAC,QAAQ,CAAC,kBAAkB,CAAwD;IAC3F,OAAO,CAAC,QAAQ,CAAC,0BAA0B,CAAgE;IAC3G,OAAO,CAAC,QAAQ,CAAC,sBAAsB,CAA4D;IACnG,OAAO,CAAC,QAAQ,CAAC,qBAAqB,CAA2D;gBAErF,OAAO,EAAE,+BAA+B;IAiBpD;;OAEG;IACG,OAAO;CAgBd"}

package/bin/sdk/SdkSessionSystemComposer.js

@@ -0,0 +1,150 @@
+/**
+ * SDK Session 默认 system composer。
+ *
+ * 关键点（中文）
+ * - 面向 `Agent` SDK 的本地会话执行场景。
+ * - 注入调用方显式传入的静态 instruction、显式注入 service system 与显式注册 plugin system。
+ * - SDK 不在 system 中注入动态变量；动态上下文应由调用方放入 user message。
+ */
+import { SessionSystemComposer } from "../session/composer/system/SessionSystemComposer.js";
+import { getSessionRunScope } from "../session/SessionRunScope.js";
+function normalizeSystemBlocks(blocks) {
+    if (!Array.isArray(blocks))
+        return [];
+    return blocks
+        .map((block) => {
+        const content = String(block?.content || "").trim();
+        if (!content)
+            return null;
+        const source = block.source;
+        if (source !== "core" &&
+            source !== "instruction" &&
+            source !== "service" &&
+            source !== "plugin" &&
+            source !== "session") {
+            return null;
+        }
+        return {
+            source,
+            name: String(block.name || source).trim() || source,
+            content,
+        };
+    })
+        .filter((block) => Boolean(block));
+}
+function createSessionInfo(params) {
+    const createdAt = Number.isFinite(params.createdAt) ? params.createdAt : 0;
+    return {
+        agentId: String(params.agentId || "").trim(),
+        sessionId: String(params.sessionId || "").trim(),
+        projectRoot: String(params.projectRoot || "").trim(),
+        createdAt: new Date(createdAt).toISOString(),
+        timezone: String(params.timezone || "").trim() || "UTC",
+    };
+}
+function createSessionSystemBlock(session) {
+    const content = [
+        "当前会话上下文：",
+        `你正在服务 agent "${session.agentId}" 的 session "${session.sessionId}"。`,
+        `当前项目根目录是 "${session.projectRoot}"。`,
+        `本会话创建于 ${session.createdAt}，参考时区是 ${session.timezone}。`,
+        "这个创建时间是当前会话的稳定参考时间，不代表每轮运行时的当前时间。",
+        "如果用户消息中提供了新的当前时间、相对时间或其他动态上下文，应优先使用用户消息中的动态信息。",
+    ].join("\n");
+    return {
+        source: "session",
+        name: "context",
+        content,
+    };
+}
+/**
+ * 解析 SDK session 当前生效的 system blocks。
+ */
+export async function resolveSdkSessionSystemBlocks(params) {
+    const agentId = String(params.agentId || "").trim();
+    const projectRoot = String(params.projectRoot || "").trim();
+    const sessionId = String(params.sessionId || "").trim();
+    const createdAt = Number(params.createdAt || 0);
+    const timezone = String(params.timezone || "").trim();
+    if (!agentId) {
+        throw new Error("resolveSdkSessionSystemBlocks requires a non-empty agentId");
+    }
+    if (!projectRoot) {
+        throw new Error("resolveSdkSessionSystemBlocks requires a non-empty projectRoot");
+    }
+    if (!sessionId) {
+        throw new Error("resolveSdkSessionSystemBlocks requires a non-empty sessionId");
+    }
+    if (!Number.isFinite(createdAt) || createdAt <= 0) {
+        throw new Error("resolveSdkSessionSystemBlocks requires a valid createdAt");
+    }
+    if (!timezone) {
+        throw new Error("resolveSdkSessionSystemBlocks requires a non-empty timezone");
+    }
+    return [
+        ...normalizeSystemBlocks(params.getInstructionSystemBlocks()),
+        ...normalizeSystemBlocks(await params.getServiceSystemBlocks()),
+        ...normalizeSystemBlocks(await params.getPluginSystemBlocks()),
+        // session block 放在最后，尽量保留前缀 system blocks 的跨 session 缓存命中。
+        createSessionSystemBlock(createSessionInfo({ agentId, projectRoot, sessionId, createdAt, timezone })),
+    ];
+}
+/**
+ * 解析 SDK session 当前生效的 system messages。
+ */
+export async function resolveSdkSessionSystemMessages(params) {
+    const blocks = await resolveSdkSessionSystemBlocks(params);
+    return blocks.map((block) => ({
+        role: "system",
+        content: block.content,
+    }));
+}
+/**
+ * SDK Session system composer 实现。
+ */
+export class SdkSessionSystemComposer extends SessionSystemComposer {
+    name = "sdk_prompt_system";
+    agentId;
+    projectRoot;
+    getSessionCreatedAt;
+    getSessionTimezone;
+    getInstructionSystemBlocks;
+    getServiceSystemBlocks;
+    getPluginSystemBlocks;
+    constructor(options) {
+        super();
+        this.agentId = String(options.agentId || "").trim();
+        this.projectRoot = String(options.projectRoot || "").trim();
+        this.getSessionCreatedAt = options.getSessionCreatedAt;
+        this.getSessionTimezone = options.getSessionTimezone;
+        this.getInstructionSystemBlocks = options.getInstructionSystemBlocks;
+        this.getServiceSystemBlocks = options.getServiceSystemBlocks;
+        this.getPluginSystemBlocks = options.getPluginSystemBlocks;
+        if (!this.agentId) {
+            throw new Error("SdkSessionSystemComposer requires a non-empty agentId");
+        }
+        if (!this.projectRoot) {
+            throw new Error("SdkSessionSystemComposer requires a non-empty projectRoot");
+        }
+    }
+    /**
+     * 解析本轮 SDK session system messages。
+     */
+    async resolve() {
+        const sessionId = String(getSessionRunScope()?.sessionId || "").trim();
+        if (!sessionId) {
+            throw new Error("SdkSessionSystemComposer.resolve requires a non-empty sessionId");
+        }
+        return await resolveSdkSessionSystemMessages({
+            agentId: this.agentId,
+            projectRoot: this.projectRoot,
+            sessionId,
+            createdAt: this.getSessionCreatedAt(),
+            timezone: this.getSessionTimezone(),
+            getInstructionSystemBlocks: this.getInstructionSystemBlocks,
+            getServiceSystemBlocks: this.getServiceSystemBlocks,
+            getPluginSystemBlocks: this.getPluginSystemBlocks,
+        });
+    }
+}
+//# sourceMappingURL=SdkSessionSystemComposer.js.map

package/bin/sdk/SdkSessionSystemComposer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"SdkSessionSystemComposer.js","sourceRoot":"","sources":["../../src/sdk/SdkSessionSystemComposer.ts"],"names":[],"mappings":"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"}

package/bin/{host/sdk → sdk}/Session.d.ts

@@ -7,9 +7,9 @@
  * - 内部继续复用现有 `Session` / `JsonlSessionHistoryComposer` / `LocalSessionExecutor`。
  */
 import type { Tool } from "ai";
-import type { AgentSessionConfigSnapshot, AgentSessionForkInput, AgentSessionMetadata, AgentSessionRunInput, AgentSessionRunResult, AgentSessionSetInput, AgentSessionStreamEvent } from "../../host/sdk/AgentSdkTypes.js";
-import type { SessionMessageV1 } from "../../session/types/SessionMessages.js";
-import type { SessionPort } from "../../agent/AgentContextTypes.js";
+import type { AgentSessionConfigSnapshot, AgentSessionForkInput, AgentSessionMetadata, AgentSessionRunInput, AgentSessionRunResult, AgentSessionSetInput, AgentSessionStreamEvent, AgentSessionSystemBlock, AgentSessionSystemSnapshot } from "../sdk/AgentSdkTypes.js";
+import type { SessionMessageV1 } from "../session/types/SessionMessages.js";
+import type { SessionPort } from "../runtime/AgentContextTypes.js";
 type SdkSessionOptions = {
     /**
      * 当前 agent 稳定标识。
@@ -35,17 +35,17 @@ type SdkSessionOptions = {
         warn(message: string, details?: Record<string, unknown>): void;
     };
     /**
-     * 读取静态 system 文本集合。
+     * 读取当前 SDK 调用方传入的 instruction system blocks。
      */
-    getStaticSystemPrompts: () => string[];
+    getInstructionSystemBlocks: () => AgentSessionSystemBlock[];
     /**
-     * 读取当前 agent 显式注入 service 的 system 文本集合。
+     * 读取当前 agent 显式注入 service 的 system blocks。
      */
-    getServiceSystemPrompts: () => Promise<string[]>;
+    getServiceSystemBlocks: () => Promise<AgentSessionSystemBlock[]>;
     /**
-     * 读取当前 agent 显式注册 plugin 的 system 文本集合。
+     * 读取当前 agent 显式注册 plugin 的 system blocks。
      */
-    getPluginSystemPrompts: () => Promise<string[]>;
+    getPluginSystemBlocks: () => Promise<AgentSessionSystemBlock[]>;
 };
 /**
  * SDK 本地 Session。
@@ -56,12 +56,14 @@ export declare class SdkSession {
     private readonly projectRoot;
     private readonly tools;
     private readonly logger;
-    private readonly getStaticSystemPrompts;
-    private readonly getServiceSystemPrompts;
-    private readonly getPluginSystemPrompts;
+    private readonly getInstructionSystemBlocks;
+    private readonly getServiceSystemBlocks;
+    private readonly getPluginSystemBlocks;
     private readonly historyComposer;
     private readonly coreSession;
     private sessionConfig;
+    private createdAt;
+    private timezone;
     private initializePromise;
     private servicePort;
     constructor(options: SdkSessionOptions);
@@ -99,6 +101,15 @@ export declare class SdkSession {
      * 读取完整消息历史。
      */
     history(): Promise<SessionMessageV1[]>;
+    /**
+     * 读取当前 session 生效的 system prompt 文本集合。
+     *
+     * 关键点（中文）
+     * - 返回内容与实际 run 时使用的 SDK system composer 同源。
+     * - 包含 instruction/core、显式注入 service system、显式注册 plugin system 与 session 上下文。
+     * - 返回结构化快照，不把 system prompt 写入会话历史。
+     */
+    system(): Promise<AgentSessionSystemSnapshot>;
     /**
      * 返回当前 session 是否正在执行。
      */
@@ -125,16 +136,10 @@ export declare class SdkSession {
     toMetadata(): Promise<AgentSessionMetadata>;
     /**
      * 返回供 chat service 使用的 session 端口。
-     *
-     * 关键点（中文）
-     * - 这里不走 SDK `run()` 包装层，而是直接暴露底层 `CoreSession` 协议。
-     * - 这样 chat queue worker 可以复用既有 `SessionPort` 契约，不会重复补写消息。
      */
     getServicePort(): SessionPort;
     private touchMetadata;
     private persistAssistantResult;
-    private pushChunkEvent;
-    private toJsonValue;
 }
 export {};
 //# sourceMappingURL=Session.d.ts.map

package/bin/sdk/Session.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Session.d.ts","sourceRoot":"","sources":["../../src/sdk/Session.ts"],"names":[],"mappings":"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"}