@downcity/agent 1.1.1

package/bin/shared/types/auth/AuthPermission.js

@@ -0,0 +1,92 @@
+/**
+ * 统一账户权限目录定义。
+ *
+ * 关键点（中文）
+ * - V1 使用稳定的字符串权限 key，避免把权限判断散落在业务代码里。
+ * - 默认角色与权限关系也在这里收口，方便 bootstrap 时统一 seed。
+ */
+/**
+ * V1 支持的权限 key 列表。
+ */
+export const AUTH_PERMISSION_KEYS = [
+    "agent.read",
+    "agent.write",
+    "agent.execute",
+    "service.read",
+    "service.write",
+    "task.read",
+    "task.run",
+    "model.read",
+    "model.write",
+    "env.read",
+    "env.write",
+    "channel.read",
+    "channel.write",
+    "auth.read",
+    "auth.write",
+    "shell.execute",
+    "session.read",
+    "session.write",
+    "plugin.read",
+    "plugin.write",
+];
+/**
+ * 权限说明映射。
+ */
+export const AUTH_PERMISSION_DESCRIPTIONS = {
+    "agent.read": "读取 agent 基础信息与运行状态。",
+    "agent.write": "修改 agent 配置与元信息。",
+    "agent.execute": "触发 agent 执行与会话运行。",
+    "service.read": "查看 service 状态与元数据。",
+    "service.write": "启动、停止或修改 service。",
+    "task.read": "查看 task 定义与运行结果。",
+    "task.run": "创建或手动执行 task。",
+    "model.read": "查看模型池与模型绑定。",
+    "model.write": "修改模型池与模型绑定。",
+    "env.read": "查看环境变量配置。",
+    "env.write": "修改环境变量配置。",
+    "channel.read": "查看渠道账号与渠道状态。",
+    "channel.write": "修改渠道账号与渠道配置。",
+    "auth.read": "查看统一账户、角色、权限与 token 状态。",
+    "auth.write": "修改统一账户、角色、权限与 token 状态。",
+    "shell.execute": "执行 shell 指令。",
+    "session.read": "查看 session 与消息。",
+    "session.write": "修改 session 或写入消息。",
+    "plugin.read": "查看 plugin 状态与配置。",
+    "plugin.write": "修改 plugin 配置并执行管理动作。",
+};
+/**
+ * 默认角色名称。
+ */
+export const AUTH_DEFAULT_ROLE_NAMES = ["admin", "operator", "viewer"];
+/**
+ * V1 默认角色目录。
+ */
+export const AUTH_DEFAULT_ROLES = [
+    {
+        name: "admin",
+        description: "系统管理员，可管理统一账户与所有控制面能力。",
+        permissions: [...AUTH_PERMISSION_KEYS],
+    },
+    {
+        name: "operator",
+        description: "运维角色，可查看并操作运行时，但不管理统一账户。",
+        permissions: AUTH_PERMISSION_KEYS.filter((permission) => permission !== "auth.write" && permission !== "auth.read"),
+    },
+    {
+        name: "viewer",
+        description: "只读角色，可查看状态但不能执行高危变更。",
+        permissions: [
+            "agent.read",
+            "service.read",
+            "task.read",
+            "model.read",
+            "env.read",
+            "channel.read",
+            "auth.read",
+            "session.read",
+            "plugin.read",
+        ],
+    },
+];
+//# sourceMappingURL=AuthPermission.js.map

package/bin/shared/types/auth/AuthPermission.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"AuthPermission.js","sourceRoot":"","sources":["../../../../src/shared/types/auth/AuthPermission.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH;;GAEG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAG;IAClC,YAAY;IACZ,aAAa;IACb,eAAe;IACf,cAAc;IACd,eAAe;IACf,WAAW;IACX,UAAU;IACV,YAAY;IACZ,aAAa;IACb,UAAU;IACV,WAAW;IACX,cAAc;IACd,eAAe;IACf,WAAW;IACX,YAAY;IACZ,eAAe;IACf,cAAc;IACd,eAAe;IACf,aAAa;IACb,cAAc;CACN,CAAC;AAOX;;GAEG;AACH,MAAM,CAAC,MAAM,4BAA4B,GAAsC;IAC7E,YAAY,EAAE,qBAAqB;IACnC,aAAa,EAAE,kBAAkB;IACjC,eAAe,EAAE,mBAAmB;IACpC,cAAc,EAAE,oBAAoB;IACpC,eAAe,EAAE,mBAAmB;IACpC,WAAW,EAAE,kBAAkB;IAC/B,UAAU,EAAE,eAAe;IAC3B,YAAY,EAAE,aAAa;IAC3B,aAAa,EAAE,aAAa;IAC5B,UAAU,EAAE,WAAW;IACvB,WAAW,EAAE,WAAW;IACxB,cAAc,EAAE,cAAc;IAC9B,eAAe,EAAE,cAAc;IAC/B,WAAW,EAAE,yBAAyB;IACtC,YAAY,EAAE,yBAAyB;IACvC,eAAe,EAAE,cAAc;IAC/B,cAAc,EAAE,iBAAiB;IACjC,eAAe,EAAE,mBAAmB;IACpC,aAAa,EAAE,kBAAkB;IACjC,cAAc,EAAE,sBAAsB;CACvC,CAAC;AAEF;;GAEG;AACH,MAAM,CAAC,MAAM,uBAAuB,GAAG,CAAC,OAAO,EAAE,UAAU,EAAE,QAAQ,CAAU,CAAC;AAyBhF;;GAEG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAgC;IAC7D;QACE,IAAI,EAAE,OAAO;QACb,WAAW,EAAE,wBAAwB;QACrC,WAAW,EAAE,CAAC,GAAG,oBAAoB,CAAC;KACvC;IACD;QACE,IAAI,EAAE,UAAU;QAChB,WAAW,EAAE,0BAA0B;QACvC,WAAW,EAAE,oBAAoB,CAAC,MAAM,CAAC,CAAC,UAAU,EAAE,EAAE,CACtD,UAAU,KAAK,YAAY,IAAI,UAAU,KAAK,WAAW,CAC1D;KACF;IACD;QACE,IAAI,EAAE,QAAQ;QACd,WAAW,EAAE,sBAAsB;QACnC,WAAW,EAAE;YACX,YAAY;YACZ,cAAc;YACd,WAAW;YACX,YAAY;YACZ,UAAU;YACV,cAAc;YACd,WAAW;YACX,cAAc;YACd,aAAa;SACd;KACF;CACF,CAAC"}

package/bin/shared/types/auth/AuthRoute.d.ts

@@ -0,0 +1,29 @@
+/**
+ * 统一账户路由策略类型。
+ *
+ * 关键点（中文）
+ * - 当前文件先定义协议，后续路由全面切入 Bearer 鉴权时直接复用。
+ */
+import type { AuthPermissionKey } from "./AuthPermission.js";
+/**
+ * 单条路由的鉴权策略。
+ */
+export interface AuthRoutePolicy {
+    /**
+     * 路由路径模式。
+     */
+    path: string;
+    /**
+     * HTTP 方法。
+     */
+    method: string;
+    /**
+     * 是否必须登录。
+     */
+    requireAuth: boolean;
+    /**
+     * 通过该路由所需的任一权限集合。
+     */
+    anyPermissions?: AuthPermissionKey[];
+}
+//# sourceMappingURL=AuthRoute.d.ts.map

package/bin/shared/types/auth/AuthRoute.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AuthRoute.d.ts","sourceRoot":"","sources":["../../../../src/shared/types/auth/AuthRoute.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAE7D;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B;;OAEG;IACH,IAAI,EAAE,MAAM,CAAC;IACb;;OAEG;IACH,MAAM,EAAE,MAAM,CAAC;IACf;;OAEG;IACH,WAAW,EAAE,OAAO,CAAC;IACrB;;OAEG;IACH,cAAc,CAAC,EAAE,iBAAiB,EAAE,CAAC;CACtC"}

package/bin/shared/types/auth/AuthRoute.js

@@ -0,0 +1,8 @@
+/**
+ * 统一账户路由策略类型。
+ *
+ * 关键点（中文）
+ * - 当前文件先定义协议，后续路由全面切入 Bearer 鉴权时直接复用。
+ */
+export {};
+//# sourceMappingURL=AuthRoute.js.map

package/bin/shared/types/auth/AuthRoute.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"AuthRoute.js","sourceRoot":"","sources":["../../../../src/shared/types/auth/AuthRoute.ts"],"names":[],"mappings":"AAAA;;;;;GAKG"}

package/bin/shared/types/auth/AuthToken.d.ts

@@ -0,0 +1,46 @@
+/**
+ * 统一账户 Token 响应类型。
+ *
+ * 关键点（中文）
+ * - 明文 token 只在签发时返回一次。
+ * - 列表与详情接口一律只返回摘要，不返回明文。
+ */
+/**
+ * 对外返回的 token 摘要。
+ */
+export interface AuthTokenSummary {
+    /**
+     * token 记录 ID。
+     */
+    id: string;
+    /**
+     * token 名称。
+     */
+    name: string;
+    /**
+     * 过期时间（可选）。
+     */
+    expiresAt?: string;
+    /**
+     * 最近使用时间（可选）。
+     */
+    lastUsedAt?: string;
+    /**
+     * 创建时间（ISO 字符串）。
+     */
+    createdAt: string;
+    /**
+     * 更新时间（ISO 字符串）。
+     */
+    updatedAt: string;
+}
+/**
+ * 新签发 token 的一次性返回结构。
+ */
+export interface AuthIssuedToken extends AuthTokenSummary {
+    /**
+     * 明文 Bearer Token。
+     */
+    token: string;
+}
+//# sourceMappingURL=AuthToken.d.ts.map

package/bin/shared/types/auth/AuthToken.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AuthToken.d.ts","sourceRoot":"","sources":["../../../../src/shared/types/auth/AuthToken.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B;;OAEG;IACH,EAAE,EAAE,MAAM,CAAC;IACX;;OAEG;IACH,IAAI,EAAE,MAAM,CAAC;IACb;;OAEG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;;OAEG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB;;OAEG;IACH,SAAS,EAAE,MAAM,CAAC;IAClB;;OAEG;IACH,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,eAAgB,SAAQ,gBAAgB;IACvD;;OAEG;IACH,KAAK,EAAE,MAAM,CAAC;CACf"}

package/bin/shared/types/auth/AuthToken.js

@@ -0,0 +1,9 @@
+/**
+ * 统一账户 Token 响应类型。
+ *
+ * 关键点（中文）
+ * - 明文 token 只在签发时返回一次。
+ * - 列表与详情接口一律只返回摘要，不返回明文。
+ */
+export {};
+//# sourceMappingURL=AuthToken.js.map

package/bin/shared/types/auth/AuthToken.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"AuthToken.js","sourceRoot":"","sources":["../../../../src/shared/types/auth/AuthToken.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG"}

package/bin/shared/types/auth/AuthTypes.d.ts

@@ -0,0 +1,227 @@
+/**
+ * 统一账户领域基础类型。
+ *
+ * 关键点（中文）
+ * - 这些类型描述的是 auth 表记录与运行时 principal，不承载路由细节。
+ * - 所有字段都保持可序列化，便于 API 响应与审计日志复用。
+ */
+import type { AuthPermissionKey } from "./AuthPermission.js";
+/**
+ * 用户状态。
+ */
+export type AuthUserStatus = "active" | "disabled";
+/**
+ * 用户记录。
+ */
+export interface AuthUser {
+    /**
+     * 用户主键 ID。
+     */
+    id: string;
+    /**
+     * 登录用户名。
+     */
+    username: string;
+    /**
+     * 密码哈希值。
+     */
+    passwordHash: string;
+    /**
+     * 展示名称。
+     */
+    displayName?: string;
+    /**
+     * 用户状态。
+     */
+    status: AuthUserStatus;
+    /**
+     * 创建时间（ISO 字符串）。
+     */
+    createdAt: string;
+    /**
+     * 更新时间（ISO 字符串）。
+     */
+    updatedAt: string;
+}
+/**
+ * 角色记录。
+ */
+export interface AuthRole {
+    /**
+     * 角色主键 ID。
+     */
+    id: string;
+    /**
+     * 角色名。
+     */
+    name: string;
+    /**
+     * 角色说明。
+     */
+    description?: string;
+    /**
+     * 创建时间（ISO 字符串）。
+     */
+    createdAt: string;
+    /**
+     * 更新时间（ISO 字符串）。
+     */
+    updatedAt: string;
+}
+/**
+ * 权限记录。
+ */
+export interface AuthPermission {
+    /**
+     * 权限主键 ID。
+     */
+    id: string;
+    /**
+     * 权限 key。
+     */
+    key: AuthPermissionKey;
+    /**
+     * 权限说明。
+     */
+    description?: string;
+    /**
+     * 创建时间（ISO 字符串）。
+     */
+    createdAt: string;
+    /**
+     * 更新时间（ISO 字符串）。
+     */
+    updatedAt: string;
+}
+/**
+ * Token 记录。
+ */
+export interface AuthTokenRecord {
+    /**
+     * token 记录主键 ID。
+     */
+    id: string;
+    /**
+     * 所属用户 ID。
+     */
+    userId: string;
+    /**
+     * token 名称。
+     */
+    name: string;
+    /**
+     * token 哈希值。
+     */
+    tokenHash: string;
+    /**
+     * 过期时间（可选）。
+     */
+    expiresAt?: string;
+    /**
+     * 吊销时间（可选）。
+     */
+    revokedAt?: string;
+    /**
+     * 最近使用时间（可选）。
+     */
+    lastUsedAt?: string;
+    /**
+     * 创建时间（ISO 字符串）。
+     */
+    createdAt: string;
+    /**
+     * 更新时间（ISO 字符串）。
+     */
+    updatedAt: string;
+}
+/**
+ * 审计日志记录。
+ */
+export interface AuthAuditLog {
+    /**
+     * 审计日志主键 ID。
+     */
+    id: string;
+    /**
+     * 操作人用户 ID。
+     */
+    actorUserId?: string;
+    /**
+     * 操作人 token ID。
+     */
+    actorTokenId?: string;
+    /**
+     * 资源类型。
+     */
+    resourceType: string;
+    /**
+     * 资源 ID。
+     */
+    resourceId?: string;
+    /**
+     * 动作名。
+     */
+    action: string;
+    /**
+     * 动作结果。
+     */
+    result: string;
+    /**
+     * 请求 ID。
+     */
+    requestId?: string;
+    /**
+     * 请求 IP。
+     */
+    ip?: string;
+    /**
+     * User-Agent。
+     */
+    userAgent?: string;
+    /**
+     * 附加元数据 JSON 字符串。
+     */
+    metaJson?: string;
+    /**
+     * 创建时间（ISO 字符串）。
+     */
+    createdAt: string;
+}
+/**
+ * 当前请求的认证主体。
+ */
+export interface AuthPrincipal {
+    /**
+     * 当前用户 ID。
+     */
+    userId: string;
+    /**
+     * 当前用户名。
+     */
+    username: string;
+    /**
+     * 当前展示名。
+     */
+    displayName?: string;
+    /**
+     * 当前用户状态。
+     */
+    status: AuthUserStatus;
+    /**
+     * 当前 token 记录 ID。
+     */
+    tokenId: string;
+    /**
+     * 当前 token 名称。
+     */
+    tokenName: string;
+    /**
+     * 当前用户角色列表。
+     */
+    roles: string[];
+    /**
+     * 当前用户权限列表。
+     */
+    permissions: AuthPermissionKey[];
+}
+//# sourceMappingURL=AuthTypes.d.ts.map

package/bin/shared/types/auth/AuthTypes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AuthTypes.d.ts","sourceRoot":"","sources":["../../../../src/shared/types/auth/AuthTypes.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAE7D;;GAEG;AACH,MAAM,MAAM,cAAc,GAAG,QAAQ,GAAG,UAAU,CAAC;AAEnD;;GAEG;AACH,MAAM,WAAW,QAAQ;IACvB;;OAEG;IACH,EAAE,EAAE,MAAM,CAAC;IACX;;OAEG;IACH,QAAQ,EAAE,MAAM,CAAC;IACjB;;OAEG;IACH,YAAY,EAAE,MAAM,CAAC;IACrB;;OAEG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB;;OAEG;IACH,MAAM,EAAE,cAAc,CAAC;IACvB;;OAEG;IACH,SAAS,EAAE,MAAM,CAAC;IAClB;;OAEG;IACH,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,QAAQ;IACvB;;OAEG;IACH,EAAE,EAAE,MAAM,CAAC;IACX;;OAEG;IACH,IAAI,EAAE,MAAM,CAAC;IACb;;OAEG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB;;OAEG;IACH,SAAS,EAAE,MAAM,CAAC;IAClB;;OAEG;IACH,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B;;OAEG;IACH,EAAE,EAAE,MAAM,CAAC;IACX;;OAEG;IACH,GAAG,EAAE,iBAAiB,CAAC;IACvB;;OAEG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB;;OAEG;IACH,SAAS,EAAE,MAAM,CAAC;IAClB;;OAEG;IACH,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B;;OAEG;IACH,EAAE,EAAE,MAAM,CAAC;IACX;;OAEG;IACH,MAAM,EAAE,MAAM,CAAC;IACf;;OAEG;IACH,IAAI,EAAE,MAAM,CAAC;IACb;;OAEG;IACH,SAAS,EAAE,MAAM,CAAC;IAClB;;OAEG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;;OAEG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;;OAEG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB;;OAEG;IACH,SAAS,EAAE,MAAM,CAAC;IAClB;;OAEG;IACH,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B;;OAEG;IACH,EAAE,EAAE,MAAM,CAAC;IACX;;OAEG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB;;OAEG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB;;OAEG;IACH,YAAY,EAAE,MAAM,CAAC;IACrB;;OAEG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB;;OAEG;IACH,MAAM,EAAE,MAAM,CAAC;IACf;;OAEG;IACH,MAAM,EAAE,MAAM,CAAC;IACf;;OAEG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;;OAEG;IACH,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ;;OAEG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;;OAEG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB;;OAEG;IACH,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B;;OAEG;IACH,MAAM,EAAE,MAAM,CAAC;IACf;;OAEG;IACH,QAAQ,EAAE,MAAM,CAAC;IACjB;;OAEG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB;;OAEG;IACH,MAAM,EAAE,cAAc,CAAC;IACvB;;OAEG;IACH,OAAO,EAAE,MAAM,CAAC;IAChB;;OAEG;IACH,SAAS,EAAE,MAAM,CAAC;IAClB;;OAEG;IACH,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB;;OAEG;IACH,WAAW,EAAE,iBAAiB,EAAE,CAAC;CAClC"}

package/bin/shared/types/auth/AuthTypes.js

@@ -0,0 +1,9 @@
+/**
+ * 统一账户领域基础类型。
+ *
+ * 关键点（中文）
+ * - 这些类型描述的是 auth 表记录与运行时 principal，不承载路由细节。
+ * - 所有字段都保持可序列化，便于 API 响应与审计日志复用。
+ */
+export {};
+//# sourceMappingURL=AuthTypes.js.map

package/bin/shared/types/auth/AuthTypes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"AuthTypes.js","sourceRoot":"","sources":["../../../../src/shared/types/auth/AuthTypes.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG"}

package/bin/shared/utils/Id.d.ts

@@ -0,0 +1,9 @@
+/**
+ * ID 生成工具。
+ *
+ * 关键点（中文）
+ * - 提供跨层通用的唯一 ID 生成能力。
+ * - 放在 `utils`，避免 `core -> main` 反向依赖。
+ */
+export declare function generateId(): string;
+//# sourceMappingURL=Id.d.ts.map

package/bin/shared/utils/Id.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Id.d.ts","sourceRoot":"","sources":["../../../src/shared/utils/Id.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAIH,wBAAgB,UAAU,IAAI,MAAM,CAEnC"}

package/bin/shared/utils/Id.js

@@ -0,0 +1,12 @@
+/**
+ * ID 生成工具。
+ *
+ * 关键点（中文）
+ * - 提供跨层通用的唯一 ID 生成能力。
+ * - 放在 `utils`，避免 `core -> main` 反向依赖。
+ */
+import { nanoid } from "nanoid";
+export function generateId() {
+    return nanoid(16);
+}
+//# sourceMappingURL=Id.js.map

package/bin/shared/utils/Id.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Id.js","sourceRoot":"","sources":["../../../src/shared/utils/Id.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAEhC,MAAM,UAAU,UAAU;IACxB,OAAO,MAAM,CAAC,EAAE,CAAC,CAAC;AACpB,CAAC"}

package/bin/shared/utils/Template.d.ts

@@ -0,0 +1,17 @@
+/**
+ * 字符串模板渲染工具。
+ *
+ * 职责说明（中文）
+ * - 提供统一的 `{{variable}}` 占位符替换能力。
+ * - 供 init 模板与 runtime system prompt 渲染复用，避免重复实现。
+ */
+import type { TemplateVariableMap } from "../../shared/types/Template.js";
+/**
+ * 渲染模板中的 `{{variable}}` 占位符。
+ *
+ * 关键点（中文）
+ * - 变量名支持字母、数字、下划线，且允许写成 `{{ key }}`。
+ * - 未提供值的变量保持原样，便于排查模板与变量映射不一致问题。
+ */
+export declare function renderTemplateVariables(template: string, variables: TemplateVariableMap): string;
+//# sourceMappingURL=Template.d.ts.map

package/bin/shared/utils/Template.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Template.d.ts","sourceRoot":"","sources":["../../../src/shared/utils/Template.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AAEtE;;;;;;GAMG;AACH,wBAAgB,uBAAuB,CACrC,QAAQ,EAAE,MAAM,EAChB,SAAS,EAAE,mBAAmB,GAC7B,MAAM,CAOR"}

package/bin/shared/utils/Template.js

@@ -0,0 +1,24 @@
+/**
+ * 字符串模板渲染工具。
+ *
+ * 职责说明（中文）
+ * - 提供统一的 `{{variable}}` 占位符替换能力。
+ * - 供 init 模板与 runtime system prompt 渲染复用，避免重复实现。
+ */
+/**
+ * 渲染模板中的 `{{variable}}` 占位符。
+ *
+ * 关键点（中文）
+ * - 变量名支持字母、数字、下划线，且允许写成 `{{ key }}`。
+ * - 未提供值的变量保持原样，便于排查模板与变量映射不一致问题。
+ */
+export function renderTemplateVariables(template, variables) {
+    if (!template)
+        return template;
+    return template.replace(/\{\{\s*([a-zA-Z0-9_]+)\s*\}\}/g, (match, key) => {
+        return Object.prototype.hasOwnProperty.call(variables, key)
+            ? String(variables[key])
+            : match;
+    });
+}
+//# sourceMappingURL=Template.js.map

package/bin/shared/utils/Template.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Template.js","sourceRoot":"","sources":["../../../src/shared/utils/Template.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAIH;;;;;;GAMG;AACH,MAAM,UAAU,uBAAuB,CACrC,QAAgB,EAChB,SAA8B;IAE9B,IAAI,CAAC,QAAQ;QAAE,OAAO,QAAQ,CAAC;IAC/B,OAAO,QAAQ,CAAC,OAAO,CAAC,gCAAgC,EAAE,CAAC,KAAK,EAAE,GAAG,EAAE,EAAE;QACvE,OAAO,MAAM,CAAC,SAAS,CAAC,cAAc,CAAC,IAAI,CAAC,SAAS,EAAE,GAAG,CAAC;YACzD,CAAC,CAAC,MAAM,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC;YACxB,CAAC,CAAC,KAAK,CAAC;IACZ,CAAC,CAAC,CAAC;AACL,CAAC"}

package/bin/shared/utils/Time.d.ts

@@ -0,0 +1,15 @@
+/**
+ * 时间格式工具模块。
+ *
+ * 职责说明：
+ * 1. 提供统一时间戳格式。
+ * 2. 提供耗时格式化，便于日志和 CLI 输出使用一致单位。
+ * 3. 提供 runtime 时区格式化，确保 prompt / message / task 共享同一时间口径。
+ */
+export declare function getTimestamp(): string;
+export declare function formatDuration(ms: number): string;
+export declare function resolveRuntimeTimezone(): string;
+export declare function formatDateInTimezone(date?: Date, timezone?: string): string;
+export declare function formatDateTimeInTimezone(date?: Date, timezone?: string): string;
+export declare function formatYearInTimezone(date?: Date, timezone?: string): string;
+//# sourceMappingURL=Time.d.ts.map

package/bin/shared/utils/Time.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Time.d.ts","sourceRoot":"","sources":["../../../src/shared/utils/Time.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,wBAAgB,YAAY,IAAI,MAAM,CAErC;AAED,wBAAgB,cAAc,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,CAIjD;AAED,wBAAgB,sBAAsB,IAAI,MAAM,CAG/C;AAED,wBAAgB,oBAAoB,CAClC,IAAI,GAAE,IAAiB,EACvB,QAAQ,GAAE,MAAiC,GAC1C,MAAM,CAYR;AAED,wBAAgB,wBAAwB,CACtC,IAAI,GAAE,IAAiB,EACvB,QAAQ,GAAE,MAAiC,GAC1C,MAAM,CAmBR;AAED,wBAAgB,oBAAoB,CAClC,IAAI,GAAE,IAAiB,EACvB,QAAQ,GAAE,MAAiC,GAC1C,MAAM,CASR"}

package/bin/shared/utils/Time.js

@@ -0,0 +1,69 @@
+/**
+ * 时间格式工具模块。
+ *
+ * 职责说明：
+ * 1. 提供统一时间戳格式。
+ * 2. 提供耗时格式化，便于日志和 CLI 输出使用一致单位。
+ * 3. 提供 runtime 时区格式化，确保 prompt / message / task 共享同一时间口径。
+ */
+export function getTimestamp() {
+    return new Date().toISOString();
+}
+export function formatDuration(ms) {
+    if (ms < 1000)
+        return `${ms}ms`;
+    if (ms < 60000)
+        return `${(ms / 1000).toFixed(1)}s`;
+    return `${(ms / 60000).toFixed(1)}m`;
+}
+export function resolveRuntimeTimezone() {
+    const timezone = Intl.DateTimeFormat().resolvedOptions().timeZone || "UTC";
+    return String(timezone || "").trim() || "UTC";
+}
+export function formatDateInTimezone(date = new Date(), timezone = resolveRuntimeTimezone()) {
+    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 formatDateTimeInTimezone(date = new Date(), timezone = resolveRuntimeTimezone()) {
+    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 function formatYearInTimezone(date = new Date(), timezone = resolveRuntimeTimezone()) {
+    try {
+        return new Intl.DateTimeFormat("en-US", {
+            timeZone: timezone,
+            year: "numeric",
+        }).format(date);
+    }
+    catch {
+        return String(date.getUTCFullYear());
+    }
+}
+//# sourceMappingURL=Time.js.map

package/bin/shared/utils/Time.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Time.js","sourceRoot":"","sources":["../../../src/shared/utils/Time.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,MAAM,UAAU,YAAY;IAC1B,OAAO,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;AAClC,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,EAAU;IACvC,IAAI,EAAE,GAAG,IAAI;QAAE,OAAO,GAAG,EAAE,IAAI,CAAC;IAChC,IAAI,EAAE,GAAG,KAAK;QAAE,OAAO,GAAG,CAAC,EAAE,GAAG,IAAI,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC;IACpD,OAAO,GAAG,CAAC,EAAE,GAAG,KAAK,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC;AACvC,CAAC;AAED,MAAM,UAAU,sBAAsB;IACpC,MAAM,QAAQ,GAAG,IAAI,CAAC,cAAc,EAAE,CAAC,eAAe,EAAE,CAAC,QAAQ,IAAI,KAAK,CAAC;IAC3E,OAAO,MAAM,CAAC,QAAQ,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,IAAI,KAAK,CAAC;AAChD,CAAC;AAED,MAAM,UAAU,oBAAoB,CAClC,OAAa,IAAI,IAAI,EAAE,EACvB,WAAmB,sBAAsB,EAAE;IAE3C,IAAI,CAAC;QACH,+CAA+C;QAC/C,OAAO,IAAI,IAAI,CAAC,cAAc,CAAC,OAAO,EAAE;YACtC,QAAQ,EAAE,QAAQ;YAClB,IAAI,EAAE,SAAS;YACf,KAAK,EAAE,SAAS;YAChB,GAAG,EAAE,SAAS;SACf,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;IAClB,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC,WAAW,EAAE,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;IACzC,CAAC;AACH,CAAC;AAED,MAAM,UAAU,wBAAwB,CACtC,OAAa,IAAI,IAAI,EAAE,EACvB,WAAmB,sBAAsB,EAAE;IAE3C,IAAI,CAAC;QACH,gCAAgC;QAChC,MAAM,SAAS,GAAG,IAAI,IAAI,CAAC,cAAc,CAAC,OAAO,EAAE;YACjD,QAAQ,EAAE,QAAQ;YAClB,IAAI,EAAE,SAAS;YACf,KAAK,EAAE,SAAS;YAChB,GAAG,EAAE,SAAS;YACd,IAAI,EAAE,SAAS;YACf,MAAM,EAAE,SAAS;YACjB,MAAM,EAAE,SAAS;YACjB,MAAM,EAAE,KAAK;SACd,CAAC;aACC,MAAM,CAAC,IAAI,CAAC;aACZ,OAAO,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC;QACrB,OAAO,GAAG,SAAS,KAAK,QAAQ,GAAG,CAAC;IACtC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC,WAAW,EAAE,CAAC;IAC5B,CAAC;AACH,CAAC;AAED,MAAM,UAAU,oBAAoB,CAClC,OAAa,IAAI,IAAI,EAAE,EACvB,WAAmB,sBAAsB,EAAE;IAE3C,IAAI,CAAC;QACH,OAAO,IAAI,IAAI,CAAC,cAAc,CAAC,OAAO,EAAE;YACtC,QAAQ,EAAE,QAAQ;YAClB,IAAI,EAAE,SAAS;SAChB,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;IAClB,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,MAAM,CAAC,IAAI,CAAC,cAAc,EAAE,CAAC,CAAC;IACvC,CAAC;AACH,CAAC"}

package/bin/shared/utils/cli/Checker.d.ts

@@ -0,0 +1,8 @@
+/**
+ * CLI 端口参数解析。
+ *
+ * 关键点（中文）
+ * - 统一校验范围 1~65535，避免各 service 重复实现。
+ */
+export declare function parsePortOption(value: string): number;
+//# sourceMappingURL=Checker.d.ts.map

package/bin/shared/utils/cli/Checker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Checker.d.ts","sourceRoot":"","sources":["../../../../src/shared/utils/cli/Checker.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAYrD"}

package/bin/shared/utils/cli/Checker.js

@@ -0,0 +1,18 @@
+/**
+ * CLI 端口参数解析。
+ *
+ * 关键点（中文）
+ * - 统一校验范围 1~65535，避免各 service 重复实现。
+ */
+export function parsePortOption(value) {
+    const port = Number.parseInt(value, 10);
+    if (!Number.isFinite(port) ||
+        Number.isNaN(port) ||
+        !Number.isInteger(port) ||
+        port <= 0 ||
+        port > 65535) {
+        throw new Error(`Invalid port: ${value}`);
+    }
+    return port;
+}
+//# sourceMappingURL=Checker.js.map

package/bin/shared/utils/cli/Checker.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Checker.js","sourceRoot":"","sources":["../../../../src/shared/utils/cli/Checker.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,MAAM,UAAU,eAAe,CAAC,KAAa;IAC3C,MAAM,IAAI,GAAG,MAAM,CAAC,QAAQ,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;IACxC,IACE,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC;QACtB,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC;QAClB,CAAC,MAAM,CAAC,SAAS,CAAC,IAAI,CAAC;QACvB,IAAI,IAAI,CAAC;QACT,IAAI,GAAG,KAAK,EACZ,CAAC;QACD,MAAM,IAAI,KAAK,CAAC,iBAAiB,KAAK,EAAE,CAAC,CAAC;IAC5C,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC"}