@downcity/agent 1.1.438 → 1.1.446

package/src/types/{executor → turn}/SessionTurnContext.ts

@@ -7,20 +7,16 @@
  * - 可变状态只能通过行为方法更新，消费者不能直接操作内部数组、lease 或 callback。
  */
 
-import type { RuntimeToolEffect } from "@downcity/type";
-import type { ShellApprovalGateway } from "@downcity/type";
+import type { ToolEffect } from "@downcity/type";
 import type {
   SessionModelUserContent,
   SessionUserMessage,
 } from "@downcity/type";
 import type { SessionAgentContent } from "@downcity/type";
-import type { SessionAssistantOutput } from "@/types/executor/SessionAssistantOutput.js";
-import type { SessionHookContext } from "@downcity/type";
-import type { SessionHookScopeRuntime } from "@downcity/type";
+import type { SessionAssistantOutput } from "@/types/turn/SessionAssistantOutput.js";
 import type {
   AgentSessionActionCallback,
   AgentSessionActionEvent,
-  AgentSessionActionRecord,
 } from "@/types/sdk/AgentSessionAction.js";
 import type { SessionInteractionPort } from "@downcity/type";
 import type { SessionOrigin } from "@downcity/type";
@@ -65,11 +61,8 @@ export interface SessionTurnContextInit {
   /** 当前 Session 执行面创建用户异步交互的端口。 */
   interactions?: SessionInteractionPort;
 
-  /** 当前 Session 提供的 host Shell 审批网关。 */
-  shell_approval_gateway?: ShellApprovalGateway;
-
   /** 当前 Turn effects 追加后触发的实时观测回调，宿主可据此广播文件改动摘要。 */
-  on_effects_changed?: (effects: readonly RuntimeToolEffect[]) => void;
+  on_effects_changed?: (effects: readonly ToolEffect[]) => void;
 
   /** 把辅助 Action 持久化并发布为 Session 事件的回调。 */
   publish_action?: AgentSessionActionCallback;
@@ -117,11 +110,8 @@ export interface SessionTurnContext {
     /** 当前 Step 已提交生效的 Agent instruction 快照。 */
     readonly agent_systems: readonly string[];
 
-    /** 当前 Step 持有的稳定 Hook 作用域。 */
-    readonly hooks?: SessionHookScopeRuntime;
-
-    /** 当前 Turn 首次解析后冻结的 Plugin 动态上下文。 */
-    readonly plugin_context_blocks: readonly SessionHookContextBlock[];
+    /** 当前 Turn 首次解析后冻结的扩展动态上下文。 */
+    readonly power_context_blocks: readonly SessionHookContextBlock[];
 
     /** 原子提交当前 Step 使用的 env 与 instruction 快照。 */
     commit(input: {
@@ -132,19 +122,10 @@ export interface SessionTurnContext {
       agent_systems: readonly string[];
     }): void;
 
-    /** 切换当前 Step 的 Hook 作用域，并先关闭前一个作用域。 */
-    replace_hooks(hooks?: SessionHookScopeRuntime): Promise<void>;
-
     /** 首次调用时解析并冻结动态上下文，后续 Step 与重试复用同一快照。 */
-    resolve_plugin_context_blocks(
+    resolve_power_context_blocks(
       resolver: () => Promise<readonly SessionHookContextBlock[]>,
     ): Promise<readonly SessionHookContextBlock[]>;
-
-    /** 释放当前 Step 持有的 Plugin Hook 作用域。 */
-    release(): Promise<void>;
-
-    /** 为 City Plugin 生成只包含稳定、只读运行快照的新对象。 */
-    hook_context(call_id?: string): SessionHookContext;
   };
 
   /** 当前运行的动态 User 输入。 */
@@ -189,24 +170,17 @@ export interface SessionTurnContext {
   /** 当前 Turn 已经发生、等待在收口检查点投影的 Tool 副作用。 */
   readonly effects: {
     /** 按实际发生顺序追加 Tool 副作用。 */
-    append(effects: readonly RuntimeToolEffect[]): void;
+    append(effects: readonly ToolEffect[]): void;
 
     /** 返回当前 Turn 已收集副作用的不可变快照。 */
-    snapshot(): readonly RuntimeToolEffect[];
+    snapshot(): readonly ToolEffect[];
   };
 
   /** 当前 Session 执行面创建用户异步交互的端口。 */
   readonly interactions?: SessionInteractionPort;
-
-  /** 当前运行可使用的 Shell 协作能力。 */
-  readonly shell: {
-    /** 当前 Session 提供的 host 执行审批网关。 */
-    readonly approval_gateway?: ShellApprovalGateway;
-  };
 }
 
 export type {
   AgentSessionActionCallback,
   AgentSessionActionEvent,
-  AgentSessionActionRecord,
 };

package/src/utils/Time.ts

@@ -1,71 +1,19 @@
 /**
  * 时间格式工具模块。
  *
- * 职责说明：
- * 1. 提供统一时间戳格式。
- * 2. 提供耗时格式化，便于日志和 CLI 输出使用一致单位。
- * 3. 提供 runtime 时区格式化，确保 prompt / message / task 共享同一时间口径。
+ * 关键点（中文）
+ * - 时区与日期格式的实现已归位到 `@downcity/type`，与 City Power 共享同一口径。
+ * - 本模块只保留 Agent 侧独有的时间戳能力，并重导出定义层函数，避免出现两份实现。
  */
-export function get_timestamp(): string {
-  return new Date().toISOString();
-}
-
-export function resolve_runtime_timezone(): string {
-  const timezone = Intl.DateTimeFormat().resolvedOptions().timeZone || "UTC";
-  return String(timezone || "").trim() || "UTC";
-}
 
-export function format_date_in_timezone(
-  date: Date = new Date(),
-  timezone: string = resolve_runtime_timezone(),
-): string {
-  try {
-    // 关键点（中文）：sv-SE locale 默认输出 ISO 风格日期，便于模型稳定解析。
-    return new Intl.DateTimeFormat("sv-SE", {
-      timeZone: timezone,
-      year: "numeric",
-      month: "2-digit",
-      day: "2-digit",
-    }).format(date);
-  } catch {
-    return date.toISOString().slice(0, 10);
-  }
-}
-
-export function format_date_time_in_timezone(
-  date: Date = new Date(),
-  timezone: string = resolve_runtime_timezone(),
-): string {
-  try {
-    // 关键点（中文）：使用固定格式，确保模型读取时区信息时稳定。
-    const formatted = new Intl.DateTimeFormat("sv-SE", {
-      timeZone: timezone,
-      year: "numeric",
-      month: "2-digit",
-      day: "2-digit",
-      hour: "2-digit",
-      minute: "2-digit",
-      second: "2-digit",
-      hour12: false,
-    })
-      .format(date)
-      .replace(" ", "T");
-    return `${formatted} (${timezone})`;
-  } catch {
-    return date.toISOString();
-  }
-}
+export {
+  format_date_in_timezone,
+  format_date_time_in_timezone,
+  format_year_in_timezone,
+  resolve_runtime_timezone,
+} from "@downcity/type";
 
-export function format_year_in_timezone(
-  date: Date = new Date(),
-  timezone: string = resolve_runtime_timezone(),
-): string {
-  try {
-    return new Intl.DateTimeFormat("en-US", {
-      timeZone: timezone,
-      year: "numeric",
-    }).format(date);
-  } catch {
-    return String(date.getUTCFullYear());
-  }
+/** 返回当前 UTC 时间戳的 ISO 字符串。 */
+export function get_timestamp(): string {
+  return new Date().toISOString();
 }

package/tsconfig.json

@@ -8,8 +8,7 @@
     "outDir": "./bin",
     "rootDir": "src",
     "paths": {
-      "@/*": ["./src/*"],
-      "@executor/*": ["./src/executor/*"]
+      "@/*": ["./src/*"]
     },
     "strict": true,
     "noImplicitAny": false,