@downcity/city 1.1.6 → 1.1.9

package/src/control/PluginApiRoutes.ts

@@ -10,10 +10,8 @@
 import type { Hono } from "hono";
 import {
   findBuiltinPlugin,
-  isCityPluginEnabled,
   listStaticPluginViews,
   runLocalPluginAction,
-  setCityPluginEnabled,
 } from "@downcity/agent";
 import type { PlatformAgentOption } from "@downcity/agent";
 import type {
@@ -24,6 +22,10 @@ import type {
   PluginView,
 } from "@downcity/agent";
 import type { JsonValue } from "@downcity/agent";
+import {
+  isCityPluginEnabled,
+  setCityPluginEnabled,
+} from "@/platform/PluginLifecycle.js";
 
 type PluginActionConfigItem = {
   name: string;

package/src/control/gateway/AgentActions.ts

@@ -33,6 +33,7 @@ import type { AgentProjectInitializationResult } from "@downcity/agent";
 import type {
   ExecutionBindingConfig,
 } from "@downcity/agent";
+import { createAgentPlatformRuntime } from "@/process/registry/AgentHostRuntime.js";
 
 function resolveExecutionInput(params: {
   modelId?: unknown;
@@ -56,14 +57,17 @@ export async function initializePlatformAgentProject(params: {
   modelId?: unknown;
   forceOverwriteShipJson?: unknown;
 }): Promise<AgentProjectInitializationResult> {
-  return initializeAgentProject({
-    projectRoot: params.projectRoot,
-    agentName: String(params.agentName || "").trim() || undefined,
-    execution: resolveExecutionInput({
-      modelId: params.modelId,
-    }),
-    forceOverwriteShipJson: params.forceOverwriteShipJson === true,
-  });
+  return initializeAgentProject(
+    {
+      projectRoot: params.projectRoot,
+      agentName: String(params.agentName || "").trim() || undefined,
+      execution: resolveExecutionInput({
+        modelId: params.modelId,
+      }),
+      forceOverwriteShipJson: params.forceOverwriteShipJson === true,
+    },
+    createAgentPlatformRuntime(),
+  );
 }
 
 /**
@@ -253,14 +257,17 @@ export async function startManagedAgentByProjectRoot(params: {
         `Project not ready: ${normalizedRoot}. Required files: PROFILE.md and downcity.json`,
       );
     }
-    await initializeAgentProject({
-      projectRoot: normalizedRoot,
-      agentName: String(params.initialization?.agentName || "").trim() || undefined,
-      execution: resolveExecutionInput({
-        modelId: params.initialization?.modelId,
-      }),
-      forceOverwriteShipJson: params.initialization?.forceOverwriteShipJson === true,
-    });
+    await initializeAgentProject(
+      {
+        projectRoot: normalizedRoot,
+        agentName: String(params.initialization?.agentName || "").trim() || undefined,
+        execution: resolveExecutionInput({
+          modelId: params.initialization?.modelId,
+        }),
+        forceOverwriteShipJson: params.initialization?.forceOverwriteShipJson === true,
+      },
+      createAgentPlatformRuntime(),
+    );
   } else {
     const profilePath = getProfileMdPath(normalizedRoot);
     const shipPath = getDowncityJsonPath(normalizedRoot);
@@ -271,7 +278,7 @@ export async function startManagedAgentByProjectRoot(params: {
     }
   }
 
-  ensureRuntimeExecutionBindingReady(normalizedRoot);
+  ensureRuntimeExecutionBindingReady(normalizedRoot, createAgentPlatformRuntime());
   const args = await buildRunArgsFromOptions(normalizedRoot, {});
   const started = await startDaemonProcess({
     projectRoot: normalizedRoot,

package/src/control/gateway/AgentCatalog.ts

@@ -18,9 +18,9 @@ import {
 import {
   getProfileMdPath,
   getDowncityJsonPath,
-  getDowncityMemoryIndexPath,
   getDowncitySchemaPath,
   getSoulMdPath,
+  getDowncityMemoryLongTermPath,
 } from "@/config/Paths.js";
 import { isAgentProjectInitialized } from "@downcity/agent";
 import { listManagedAgentEntries } from "@/process/registry/CityRegistry.js";
@@ -44,7 +44,7 @@ import type {
   PlatformAgentShipJson,
 } from "@downcity/agent";
 import type { DowncityConfig } from "@downcity/agent";
-import { PlatformStore } from "@downcity/agent";
+import { PlatformStore } from "@/platform/store/index.js";
 const DEFAULT_RUNTIME_HOST = "127.0.0.1";
 const DEFAULT_RUNTIME_PORT = 5314;
 
@@ -596,8 +596,8 @@ export async function buildPlatformConfigStatusResponse(params: {
       readPlatformConfigFileStatus({
         key: "memory_index",
         scope: "agent",
-        label: ".downcity/memory/index.sqlite",
-        filePath: getDowncityMemoryIndexPath(cwd),
+        label: ".downcity/memory/MEMORY.md",
+        filePath: getDowncityMemoryLongTermPath(cwd),
       }),
     ]);
   }

package/src/http/auth/AuthService.ts

@@ -8,10 +8,10 @@
 
 import type { AuthIssuedToken, AuthTokenSummary } from "@downcity/agent";
 import type { AuthPrincipal, AuthTokenRecord, AuthUser } from "@downcity/agent";
-import { optionalTrimmedText } from "@downcity/agent";
 import { AuthError } from "./AuthError.js";
 import { AuthStore, type AuthStoreOptions } from "./AuthStore.js";
 import { extractBearerToken, generateAccessToken, hashAccessToken } from "./TokenService.js";
+import { optionalTrimmedText } from "@/platform/store/StoreShared.js";
 
 const LOCAL_CLI_USERNAME = "local-cli";
 const LOCAL_CLI_DISPLAY_NAME = "Local CLI";

package/src/http/auth/AuthStore.ts

@@ -27,13 +27,13 @@ import type {
   AuthTokenRecord,
   AuthUser,
 } from "@downcity/agent";
-import { ensurePlatformStoreSchema } from "@downcity/agent";
 import {
   nowIso,
   normalizeNonEmptyText,
   optionalTrimmedText,
   type PlatformStoreContext,
-} from "@downcity/agent";
+} from "@/platform/store/StoreShared.js";
+import { ensurePlatformStoreSchema } from "@/platform/store/StoreSchema.js";
 
 /**
  * AuthStore 构造参数。

package/src/platform/PluginLifecycle.ts

@@ -0,0 +1,132 @@
+/**
+ * City 级 plugin 生命周期管理。
+ *
+ * 关键点（中文）
+ * - plugin 启用/关闭属于 city 全局配置，不应由 agent 自己写入。
+ * - 这里把状态落到平台安全配置中，由 city 统一读写。
+ * - 默认策略：未显式关闭时，一律视为启用。
+ */
+
+import { PlatformStore } from "@/platform/store/index.js";
+
+/**
+ * 单个 plugin 的 city 级生命周期配置。
+ */
+export interface CityPluginLifecycleItem {
+  /**
+   * 当前 plugin 是否在 city 级被启用。
+   */
+  enabled: boolean;
+  /**
+   * 最近更新时间（ISO 字符串）。
+   */
+  updatedAt: string;
+}
+
+/**
+ * city 级 plugin 生命周期配置映射。
+ */
+export interface CityPluginLifecycleConfig {
+  /**
+   * 插件生命周期配置对象映射。
+   */
+  [pluginName: string]: CityPluginLifecycleItem | undefined;
+}
+
+const PLUGIN_LIFECYCLE_SETTING_KEY = "plugins.lifecycle";
+
+function normalizeLifecycleItem(input: unknown): CityPluginLifecycleItem | null {
+  if (!input || typeof input !== "object" || Array.isArray(input)) return null;
+  const record = input as Record<string, unknown>;
+  if (typeof record.enabled !== "boolean") return null;
+  return {
+    enabled: record.enabled,
+    updatedAt: String(record.updatedAt || "").trim() || new Date().toISOString(),
+  };
+}
+
+function normalizeLifecycleConfig(input: unknown): CityPluginLifecycleConfig {
+  if (!input || typeof input !== "object" || Array.isArray(input)) return {};
+  const out: CityPluginLifecycleConfig = {};
+  for (const [pluginName, raw] of Object.entries(input as Record<string, unknown>)) {
+    const key = String(pluginName || "").trim();
+    if (!key) continue;
+    const item = normalizeLifecycleItem(raw);
+    if (!item) continue;
+    out[key] = item;
+  }
+  return out;
+}
+
+/**
+ * 读取 city 级 plugin 生命周期配置。
+ */
+export function readCityPluginLifecycleConfig(): CityPluginLifecycleConfig {
+  const store = new PlatformStore();
+  try {
+    return normalizeLifecycleConfig(
+      store.getSecureSettingJsonSync<CityPluginLifecycleConfig>(
+        PLUGIN_LIFECYCLE_SETTING_KEY,
+      ),
+    );
+  } finally {
+    store.close();
+  }
+}
+
+/**
+ * 写入完整 city 级 plugin 生命周期配置。
+ */
+export function writeCityPluginLifecycleConfig(
+  value: CityPluginLifecycleConfig,
+): CityPluginLifecycleConfig {
+  const normalized = normalizeLifecycleConfig(value);
+  const store = new PlatformStore();
+  try {
+    store.setSecureSettingJsonSync(PLUGIN_LIFECYCLE_SETTING_KEY, normalized);
+    return normalized;
+  } finally {
+    store.close();
+  }
+}
+
+/**
+ * 读取单个 plugin 的 city 级生命周期状态。
+ */
+export function readCityPluginLifecycleItem(
+  pluginName: string,
+): CityPluginLifecycleItem | null {
+  const key = String(pluginName || "").trim();
+  if (!key) return null;
+  return readCityPluginLifecycleConfig()[key] || null;
+}
+
+/**
+ * 判断单个 plugin 是否启用。
+ */
+export function isCityPluginEnabled(pluginName: string): boolean {
+  const item = readCityPluginLifecycleItem(pluginName);
+  if (!item) return true;
+  return item.enabled === true;
+}
+
+/**
+ * 设置单个 plugin 的启用态。
+ */
+export function setCityPluginEnabled(
+  pluginName: string,
+  enabled: boolean,
+): CityPluginLifecycleConfig {
+  const key = String(pluginName || "").trim();
+  if (!key) {
+    throw new Error("pluginName is required");
+  }
+  const current = readCityPluginLifecycleConfig();
+  return writeCityPluginLifecycleConfig({
+    ...current,
+    [key]: {
+      enabled,
+      updatedAt: new Date().toISOString(),
+    },
+  });
+}

package/src/platform/chatAuthorization/Store.ts

@@ -0,0 +1,181 @@
+/**
+ * City 级 chat authorization 配置存储。
+ *
+ * 关键点（中文）
+ * - 静态 chat 授权配置属于 city 维护的项目侧状态。
+ * - 这里把配置落在项目 `.downcity/chat/authorization/config.json`。
+ * - agent 只消费注入进来的读写能力，不再自己管理这份配置。
+ */
+
+import fs from "fs-extra";
+import path from "node:path";
+import type {
+  ChatAuthorizationChannel,
+  ChatAuthorizationConfig,
+  ChatAuthorizationRole,
+  ChatChannelAuthorizationConfig,
+} from "@downcity/agent";
+import {
+  CHAT_AUTHORIZATION_CHANNELS,
+  createDefaultChatAuthorizationRoles,
+} from "@downcity/agent";
+
+function normalizeText(value: unknown): string | undefined {
+  const text = String(value || "").trim();
+  return text || undefined;
+}
+
+function normalizeRoleMap(input: unknown): Record<string, ChatAuthorizationRole> {
+  const defaultRoles = createDefaultChatAuthorizationRoles();
+  if (!input || typeof input !== "object" || Array.isArray(input)) return defaultRoles;
+  const roles: Record<string, ChatAuthorizationRole> = {};
+  for (const [rawRoleId, rawRole] of Object.entries(input as Record<string, unknown>)) {
+    const roleId = normalizeText(rawRoleId);
+    if (!roleId) continue;
+    const roleObj =
+      rawRole && typeof rawRole === "object" && !Array.isArray(rawRole)
+        ? (rawRole as {
+            name?: unknown;
+            description?: unknown;
+            permissions?: unknown[];
+          })
+        : null;
+    if (!roleObj) continue;
+    const builtinRole = defaultRoles[roleId];
+    const permissions = Array.isArray(roleObj.permissions)
+      ? [...new Set(roleObj.permissions.map((item) => normalizeText(item)).filter(Boolean))]
+      : [];
+    roles[roleId] = {
+      roleId,
+      name: normalizeText(roleObj.name) || builtinRole?.name || roleId,
+      ...(normalizeText(roleObj.description) || builtinRole?.description
+        ? {
+            description:
+              normalizeText(roleObj.description) || builtinRole?.description || undefined,
+          }
+        : {}),
+      permissions: permissions as ChatAuthorizationRole["permissions"],
+    };
+  }
+  if (Object.keys(roles).length === 0) return defaultRoles;
+  if (!roles.default) roles.default = defaultRoles.default;
+  return roles;
+}
+
+function normalizeBindingMap(
+  input: unknown,
+  roles: Record<string, ChatAuthorizationRole>,
+): Record<string, string> {
+  if (!input || typeof input !== "object" || Array.isArray(input)) return {};
+  const out: Record<string, string> = {};
+  for (const [rawId, rawRoleId] of Object.entries(input as Record<string, unknown>)) {
+    const entityId = normalizeText(rawId);
+    const roleId = normalizeText(rawRoleId);
+    if (!entityId || !roleId || !roles[roleId]) continue;
+    out[entityId] = roleId;
+  }
+  return out;
+}
+
+function normalizeChannelConfig(
+  input: unknown,
+  roles: Record<string, ChatAuthorizationRole>,
+): ChatChannelAuthorizationConfig {
+  const raw =
+    input && typeof input === "object" && !Array.isArray(input)
+      ? (input as {
+          defaultUserRoleId?: unknown;
+          userRoles?: unknown;
+        })
+      : {};
+  const defaultUserRoleId = normalizeText(raw.defaultUserRoleId) || "default";
+  return {
+    defaultUserRoleId: roles[defaultUserRoleId] ? defaultUserRoleId : "default",
+    userRoles: normalizeBindingMap(raw.userRoles, roles),
+  };
+}
+
+function normalizeAuthorizationConfig(input: unknown): ChatAuthorizationConfig {
+  const raw =
+    input && typeof input === "object" && !Array.isArray(input)
+      ? (input as { roles?: unknown; channels?: Record<string, unknown> })
+      : {};
+  const roles = normalizeRoleMap(raw.roles);
+  const channels: Partial<Record<ChatAuthorizationChannel, ChatChannelAuthorizationConfig>> = {};
+  for (const channel of CHAT_AUTHORIZATION_CHANNELS) {
+    channels[channel] = normalizeChannelConfig(raw.channels?.[channel], roles);
+  }
+  return { roles, channels };
+}
+
+function getChatAuthorizationConfigPath(projectRoot: string): string {
+  return path.join(projectRoot, ".downcity", "chat", "authorization", "config.json");
+}
+
+function readConfigFile(projectRoot: string): ChatAuthorizationConfig {
+  const file = getChatAuthorizationConfigPath(projectRoot);
+  if (!fs.existsSync(file)) return normalizeAuthorizationConfig({});
+  try {
+    return normalizeAuthorizationConfig(fs.readJsonSync(file));
+  } catch {
+    return normalizeAuthorizationConfig({});
+  }
+}
+
+function writeConfigFile(projectRoot: string, config: ChatAuthorizationConfig): ChatAuthorizationConfig {
+  const file = getChatAuthorizationConfigPath(projectRoot);
+  fs.ensureDirSync(path.dirname(file));
+  fs.writeJsonSync(file, normalizeAuthorizationConfig(config), { spaces: 2 });
+  return normalizeAuthorizationConfig(config);
+}
+
+/**
+ * 同步读取 chat authorization 配置。
+ */
+export function readChatAuthorizationConfigSync(projectRoot: string): ChatAuthorizationConfig {
+  return readConfigFile(String(projectRoot || "").trim());
+}
+
+/**
+ * 读取 chat authorization 配置。
+ */
+export async function readChatAuthorizationConfig(
+  projectRoot: string,
+): Promise<ChatAuthorizationConfig> {
+  return readChatAuthorizationConfigSync(projectRoot);
+}
+
+/**
+ * 覆盖写入 chat authorization 配置。
+ */
+export async function writeChatAuthorizationConfig(
+  projectRoot: string,
+  nextConfig: ChatAuthorizationConfig,
+): Promise<ChatAuthorizationConfig> {
+  return writeConfigFile(String(projectRoot || "").trim(), nextConfig);
+}
+
+/**
+ * 设置单个用户角色。
+ */
+export async function setChatAuthorizationUserRole(params: {
+  projectRoot: string;
+  channel: ChatAuthorizationChannel;
+  userId: string;
+  roleId: string;
+}): Promise<ChatAuthorizationConfig> {
+  const projectRoot = String(params.projectRoot || "").trim();
+  const userId = normalizeText(params.userId);
+  const roleId = normalizeText(params.roleId);
+  if (!projectRoot) throw new Error("projectRoot is required");
+  if (!userId || !roleId) throw new Error("userId and roleId are required");
+  const next = readConfigFile(projectRoot);
+  next.roles = normalizeRoleMap(next.roles);
+  if (!next.roles[roleId]) throw new Error(`Unknown roleId: ${roleId}`);
+  next.channels ??= {};
+  const channelConfig = normalizeChannelConfig(next.channels[params.channel], next.roles);
+  channelConfig.userRoles ??= {};
+  channelConfig.userRoles[userId] = roleId;
+  next.channels[params.channel] = channelConfig;
+  return writeConfigFile(projectRoot, next);
+}