daycare-cli 2026.2.7 → 2026.2.9

package/dist/engine/agents/agentSystem.d.ts

@@ -1,20 +1,21 @@
-import type { FileStore } from "../../files/store.js";
-import type { AuthStore } from "../../auth/store.js";
 import type { AgentTokenEntry, DelayedSignalCancelRepeatKeyInput, DelayedSignalScheduleInput, PermissionAccess, PermissionDecision, SessionPermissions, Signal, SignalSubscription } from "@/types";
+import type { AuthStore } from "../../auth/store.js";
+import type { Storage } from "../../storage/storage.js";
+import type { ConfigModule } from "../config/configModule.js";
+import type { Crons } from "../cron/crons.js";
+import type { Heartbeats } from "../heartbeat/heartbeats.js";
+import type { EngineEventBus } from "../ipc/events.js";
 import type { ConnectorRegistry } from "../modules/connectorRegistry.js";
 import type { ImageGenerationRegistry } from "../modules/imageGenerationRegistry.js";
+import type { InferenceRouter } from "../modules/inference/router.js";
 import type { ToolResolver } from "../modules/toolResolver.js";
+import { PermissionRequestRegistry } from "../modules/tools/permissionRequestRegistry.js";
 import type { PluginManager } from "../plugins/manager.js";
-import type { EngineEventBus } from "../ipc/events.js";
-import type { InferenceRouter } from "../modules/inference/router.js";
-import type { Crons } from "../cron/crons.js";
-import type { Heartbeats } from "../heartbeat/heartbeats.js";
-import type { AgentInboxItem, AgentInboxResult, AgentInboxSteering, AgentPostTarget } from "./ops/agentTypes.js";
-import type { AgentDescriptor, AgentFetchStrategy } from "./ops/agentDescriptorTypes.js";
-import type { ConfigModule } from "../config/configModule.js";
 import type { Signals } from "../signals/signals.js";
-import { PermissionRequestRegistry } from "../modules/tools/permissionRequestRegistry.js";
-import { AgentContext } from "./agentContext.js";
+import { UserHome } from "../users/userHome.js";
+import { Context } from "./context.js";
+import type { AgentDescriptor, AgentFetchStrategy } from "./ops/agentDescriptorTypes.js";
+import type { AgentInboxItem, AgentInboxResult, AgentInboxSteering, AgentPostTarget } from "./ops/agentTypes.js";
 type DelayedSignalsFacade = {
     schedule: (input: DelayedSignalScheduleInput) => Promise<unknown>;
     cancelByRepeatKey: (input: DelayedSignalCancelRepeatKeyInput) => Promise<number>;
@@ -22,12 +23,12 @@ type DelayedSignalsFacade = {
 export type AgentSystemOptions = {
     config: ConfigModule;
     eventBus: EngineEventBus;
+    storage?: Storage;
     connectorRegistry: ConnectorRegistry;
     imageRegistry: ImageGenerationRegistry;
     toolResolver: ToolResolver;
     pluginManager: PluginManager;
     inferenceRouter: InferenceRouter;
-    fileStore: FileStore;
     authStore: AuthStore;
     delayedSignals?: DelayedSignalsFacade;
     permissionRequestRegistry?: PermissionRequestRegistry;
@@ -35,12 +36,12 @@ export type AgentSystemOptions = {
 export declare class AgentSystem {
     readonly config: ConfigModule;
     readonly eventBus: EngineEventBus;
+    readonly storage: Storage;
     readonly connectorRegistry: ConnectorRegistry;
     readonly imageRegistry: ImageGenerationRegistry;
     readonly toolResolver: ToolResolver;
     readonly pluginManager: PluginManager;
     readonly inferenceRouter: InferenceRouter;
-    readonly fileStore: FileStore;
     readonly authStore: AuthStore;
     readonly permissionRequestRegistry: PermissionRequestRegistry;
     private readonly delayedSignals;
@@ -73,7 +74,7 @@ export declare class AgentSystem {
      * Reads agent + user identity by agent id.
      * Returns: null when the agent does not exist in memory or storage.
      */
-    agentContextForAgentId(agentId: string): Promise<AgentContext | null>;
+    contextForAgentId(agentId: string): Promise<Context | null>;
     signalDeliver(signal: Signal, subscriptions: SignalSubscription[]): Promise<void>;
     /**
      * Delivers a steering message to an agent, interrupting its current work.
@@ -133,7 +134,12 @@ export declare class AgentSystem {
     private restoreAgent;
     private resolveUserIdForDescriptor;
     private resolveUserIdForConnectorKey;
-    private ownerUserIdEnsure;
+    ownerUserIdEnsure(): Promise<string>;
+    /**
+     * Resolves a UserHome facade for a concrete user id.
+     * Expects: userId belongs to an existing or soon-to-be-created runtime user.
+     */
+    userHomeForUserId(userId: string): UserHome;
     private createCompletion;
 }
 export {};

package/dist/engine/agents/agentSystem.d.ts.map

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

package/dist/engine/agents/agentSystem.js

@@ -1,30 +1,25 @@
 import { promises as fs } from "node:fs";
 import { createId } from "@paralleldrive/cuid2";
 import { getLogger } from "../../log.js";
+import { storageResolve } from "../../storage/storageResolve.js";
+import { userConnectorKeyCreate } from "../../storage/userConnectorKeyCreate.js";
+import { AsyncLock } from "../../util/lock.js";
 import { cuid2Is } from "../../utils/cuid2Is.js";
+import { appPermissionStateGrant } from "../apps/appPermissionStateGrant.js";
+import { PermissionRequestRegistry } from "../modules/tools/permissionRequestRegistry.js";
+import { permissionAccessApply } from "../permissions/permissionAccessApply.js";
+import { permissionClone } from "../permissions/permissionClone.js";
+import { permissionFormatTag } from "../permissions/permissionFormatTag.js";
+import { UserHome } from "../users/userHome.js";
 import { Agent } from "./agent.js";
-import { AgentInbox } from "./ops/agentInbox.js";
-import { agentDescriptorMatchesStrategy } from "./ops/agentDescriptorMatchesStrategy.js";
+import { Context } from "./context.js";
 import { agentDescriptorCacheKey } from "./ops/agentDescriptorCacheKey.js";
-import { agentTimestampGet } from "./ops/agentTimestampGet.js";
+import { agentDescriptorMatchesStrategy } from "./ops/agentDescriptorMatchesStrategy.js";
 import { agentDescriptorRead } from "./ops/agentDescriptorRead.js";
+import { AgentInbox } from "./ops/agentInbox.js";
 import { agentStateRead } from "./ops/agentStateRead.js";
 import { agentStateWrite } from "./ops/agentStateWrite.js";
-import { AsyncLock } from "../../util/lock.js";
-import { permissionClone } from "../permissions/permissionClone.js";
-import { permissionAccessApply } from "../permissions/permissionAccessApply.js";
-import { permissionFormatTag } from "../permissions/permissionFormatTag.js";
-import { appPermissionStateGrant } from "../apps/appPermissionStateGrant.js";
-import { PermissionRequestRegistry } from "../modules/tools/permissionRequestRegistry.js";
-import { agentDbList } from "../../storage/agentDbList.js";
-import { agentDbRead } from "../../storage/agentDbRead.js";
-import { userDbConnectorKeyAdd } from "../../storage/userDbConnectorKeyAdd.js";
-import { userDbDelete } from "../../storage/userDbDelete.js";
-import { userDbList } from "../../storage/userDbList.js";
-import { userDbReadByConnectorKey } from "../../storage/userDbReadByConnectorKey.js";
-import { userDbWrite } from "../../storage/userDbWrite.js";
-import { userConnectorKeyCreate } from "../../storage/userConnectorKeyCreate.js";
-import { AgentContext } from "./agentContext.js";
+import { agentTimestampGet } from "./ops/agentTimestampGet.js";
 const logger = getLogger("engine.agent-system");
 const AGENT_IDLE_DELAY_MS = 60_000;
 const AGENT_IDLE_REPEAT_KEY = "lifecycle-idle";
@@ -33,12 +28,12 @@ const AGENT_POISON_PILL_REPEAT_KEY = "lifecycle-poison-pill";
 export class AgentSystem {
     config;
     eventBus;
+    storage;
     connectorRegistry;
     imageRegistry;
     toolResolver;
     pluginManager;
     inferenceRouter;
-    fileStore;
     authStore;
     permissionRequestRegistry;
     delayedSignals;
@@ -51,16 +46,15 @@ export class AgentSystem {
     constructor(options) {
         this.config = options.config;
         this.eventBus = options.eventBus;
+        this.storage = options.storage ?? storageResolve(this.config.current);
         this.connectorRegistry = options.connectorRegistry;
         this.imageRegistry = options.imageRegistry;
         this.toolResolver = options.toolResolver;
         this.pluginManager = options.pluginManager;
         this.inferenceRouter = options.inferenceRouter;
-        this.fileStore = options.fileStore;
         this.authStore = options.authStore;
         this.delayedSignals = options.delayedSignals ?? null;
-        this.permissionRequestRegistry =
-            options.permissionRequestRegistry ?? new PermissionRequestRegistry();
+        this.permissionRequestRegistry = options.permissionRequestRegistry ?? new PermissionRequestRegistry();
         this.eventBus.onEvent((event) => {
             if (event.type !== "signal.generated") {
                 return;
@@ -107,12 +101,12 @@ export class AgentSystem {
             return;
         }
         await fs.mkdir(this.config.current.dataDir, { recursive: true });
-        const records = await agentDbList(this.config.current);
+        const records = await this.storage.agents.findMany();
         for (const record of records) {
             const agentId = record.id;
             let state = null;
             try {
-                state = await agentStateRead(this.config.current, agentId);
+                state = await agentStateRead(this.storage, agentId);
             }
             catch (error) {
                 logger.warn({ agentId, error }, "restore: Agent restore skipped due to invalid persisted data");
@@ -140,7 +134,8 @@ export class AgentSystem {
                 continue;
             }
             const inbox = new AgentInbox(agentId);
-            const agent = Agent.restore(agentId, record.userId, descriptor, state, inbox, this);
+            const userHome = this.userHomeForUserId(record.userId);
+            const agent = Agent.restore(agentId, record.userId, descriptor, state, inbox, this, userHome);
             const registered = this.registerEntry({
                 agentId,
                 userId: record.userId,
@@ -167,8 +162,7 @@ export class AgentSystem {
         }
     }
     async post(target, item) {
-        if (this.stage === "idle" &&
-            (item.type === "message" || item.type === "system_message")) {
+        if (this.stage === "idle" && (item.type === "message" || item.type === "system_message")) {
             const agentType = "descriptor" in target ? target.descriptor.type : "agent";
             logger.warn({ agentType }, "load: AgentSystem received message before load");
         }
@@ -227,7 +221,7 @@ export class AgentSystem {
             return true;
         }
         try {
-            const descriptor = await agentDescriptorRead(this.config.current, agentId);
+            const descriptor = await agentDescriptorRead(this.storage, agentId);
             return !!descriptor;
         }
         catch {
@@ -238,28 +232,28 @@ export class AgentSystem {
      * Reads agent + user identity by agent id.
      * Returns: null when the agent does not exist in memory or storage.
      */
-    async agentContextForAgentId(agentId) {
+    async contextForAgentId(agentId) {
         const loaded = this.entries.get(agentId);
         if (loaded) {
-            return new AgentContext(loaded.agentId, loaded.userId);
+            return new Context(loaded.agentId, loaded.userId);
         }
-        const record = await agentDbRead(this.config.current, agentId);
+        const record = await this.storage.agents.findById(agentId);
         if (!record) {
             return null;
         }
-        return new AgentContext(record.id, record.userId);
+        return new Context(record.id, record.userId);
     }
     async signalDeliver(signal, subscriptions) {
         await Promise.all(subscriptions.map(async (subscription) => {
-            if (signal.source.type === "agent" && signal.source.id === subscription.agentId) {
+            if (signal.source.type === "agent" && signal.source.id === subscription.ctx.agentId) {
                 return;
             }
-            const context = await this.agentContextForAgentId(subscription.agentId);
-            if (!context || context.userId !== subscription.userId) {
+            const context = await this.contextForAgentId(subscription.ctx.agentId);
+            if (!context || context.userId !== subscription.ctx.userId) {
                 return;
             }
             try {
-                await this.post({ agentId: subscription.agentId }, {
+                await this.post({ agentId: subscription.ctx.agentId }, {
                     type: "signal",
                     signal,
                     subscriptionPattern: subscription.pattern
@@ -269,7 +263,7 @@ export class AgentSystem {
                 logger.warn({
                     signalId: signal.id,
                     signalType: signal.type,
-                    agentId: subscription.agentId,
+                    agentId: subscription.ctx.agentId,
                     pattern: subscription.pattern,
                     error
                 }, "skip: Signal delivery skipped");
@@ -320,7 +314,7 @@ export class AgentSystem {
         if (!applied) {
             throw new Error("Permission could not be applied.");
         }
-        await agentStateWrite(this.config.current, entry.agentId, entry.agent.state);
+        await agentStateWrite(this.storage, entry.agentId, entry.agent.state);
         const decision = options?.decision ?? {
             token: "direct",
             agentId: entry.agentId,
@@ -338,7 +332,20 @@ export class AgentSystem {
      * Expects: appId belongs to an installed app.
      */
     async grantAppPermission(appId, access, options) {
-        await appPermissionStateGrant(this.config.current.workspaceDir, appId, access);
+        const userIds = new Set();
+        for (const entry of this.entries.values()) {
+            if (entry.descriptor.type !== "app" || entry.descriptor.appId !== appId) {
+                continue;
+            }
+            userIds.add(entry.userId);
+        }
+        if (userIds.size === 0) {
+            userIds.add(await this.ownerUserIdEnsure());
+        }
+        for (const userId of userIds) {
+            const userHome = this.userHomeForUserId(userId);
+            await appPermissionStateGrant(userHome.apps, appId, access);
+        }
         for (const entry of this.entries.values()) {
             if (entry.descriptor.type !== "app" || entry.descriptor.appId !== appId) {
                 continue;
@@ -348,7 +355,7 @@ export class AgentSystem {
                 throw new Error("Permission could not be applied.");
             }
             entry.agent.state.updatedAt = Date.now();
-            await agentStateWrite(this.config.current, entry.agentId, entry.agent.state);
+            await agentStateWrite(this.storage, entry.agentId, entry.agent.state);
             const decision = options?.decision
                 ? {
                     ...options.decision,
@@ -392,7 +399,7 @@ export class AgentSystem {
                 return;
             }
             entry.agent.state.state = "sleeping";
-            await agentStateWrite(this.config.current, agentId, entry.agent.state);
+            await agentStateWrite(this.storage, agentId, entry.agent.state);
             this.eventBus.emit("agent.sleep", { agentId, reason });
             logger.debug({ agentId, reason }, "event: Agent entered sleep mode");
             // Keep sleep->idle scheduling under the same lock as wake->cancel to avoid
@@ -516,7 +523,8 @@ export class AgentSystem {
         logger.debug(`event: Creating agent entry agentId=${agentId} type=${resolvedDescriptor.type}`);
         const inbox = new AgentInbox(agentId);
         const userId = await this.resolveUserIdForDescriptor(resolvedDescriptor);
-        const agent = await Agent.create(agentId, resolvedDescriptor, userId, inbox, this);
+        const userHome = this.userHomeForUserId(userId);
+        const agent = await Agent.create(agentId, resolvedDescriptor, userId, inbox, this, userHome);
         const entry = this.registerEntry({
             agentId,
             userId,
@@ -573,7 +581,7 @@ export class AgentSystem {
         await this.cancelIdleSignal(entry.agentId);
         await this.cancelPoisonPill(entry.agentId, { descriptor: entry.descriptor });
         entry.agent.state.state = "active";
-        await agentStateWrite(this.config.current, entry.agentId, entry.agent.state);
+        await agentStateWrite(this.storage, entry.agentId, entry.agent.state);
         this.eventBus.emit("agent.woke", { agentId: entry.agentId });
         logger.debug({ agentId: entry.agentId }, "event: Agent woke from sleep");
         return true;
@@ -582,14 +590,17 @@ export class AgentSystem {
         if (!this.delayedSignals) {
             return;
         }
-        const context = await this.agentContextForAgentId(agentId);
+        const context = await this.contextForAgentId(agentId);
+        if (!context) {
+            return;
+        }
         const deliverAt = Date.now() + AGENT_IDLE_DELAY_MS;
         const type = lifecycleSignalTypeBuild(agentId, "idle");
         try {
             await this.delayedSignals.schedule({
                 type,
                 deliverAt,
-                source: { type: "agent", id: agentId, userId: context?.userId },
+                source: { type: "agent", id: agentId, userId: context.userId },
                 data: { agentId, state: "idle" },
                 repeatKey: AGENT_IDLE_REPEAT_KEY
             });
@@ -620,14 +631,17 @@ export class AgentSystem {
         if (descriptor?.type !== "subagent") {
             return;
         }
-        const context = await this.agentContextForAgentId(agentId);
+        const context = await this.contextForAgentId(agentId);
+        if (!context) {
+            return;
+        }
         try {
             // load() runs before DelayedSignals.start(); ensure persistence directory exists.
             await fs.mkdir(`${this.config.current.configDir}/signals`, { recursive: true });
             await this.delayedSignals.schedule({
                 type: lifecycleSignalTypeBuild(agentId, "poison-pill"),
                 deliverAt: options?.deliverAt ?? Date.now() + AGENT_POISON_PILL_DELAY_MS,
-                source: { type: "agent", id: agentId, userId: context?.userId },
+                source: { type: "agent", id: agentId, userId: context.userId },
                 data: { agentId, state: "poison-pill" },
                 repeatKey: AGENT_POISON_PILL_REPEAT_KEY
             });
@@ -658,11 +672,14 @@ export class AgentSystem {
         if (!this._signals) {
             return;
         }
-        const context = await this.agentContextForAgentId(agentId);
+        const context = await this.contextForAgentId(agentId);
+        if (!context) {
+            return;
+        }
         try {
             await this._signals.generate({
                 type: lifecycleSignalTypeBuild(agentId, state),
-                source: { type: "agent", id: agentId, userId: context?.userId },
+                source: { type: "agent", id: agentId, userId: context.userId },
                 data: { agentId, state }
             });
         }
@@ -701,8 +718,8 @@ export class AgentSystem {
         let descriptor = null;
         let state = null;
         try {
-            descriptor = await agentDescriptorRead(this.config.current, agentId);
-            state = await agentStateRead(this.config.current, agentId);
+            descriptor = await agentDescriptorRead(this.storage, agentId);
+            state = await agentStateRead(this.storage, agentId);
         }
         catch (error) {
             logger.warn({ agentId, error }, "error: Poison-pill read failed");
@@ -717,7 +734,7 @@ export class AgentSystem {
         await this.cancelPoisonPill(agentId, { descriptor });
         state.state = "dead";
         state.updatedAt = Date.now();
-        await agentStateWrite(this.config.current, agentId, state);
+        await agentStateWrite(this.storage, agentId, state);
         this.eventBus.emit("agent.dead", { agentId, reason: "poison-pill" });
     }
     async markEntryDead(entry, reason) {
@@ -733,7 +750,7 @@ export class AgentSystem {
             await this.cancelPoisonPill(entry.agentId, { descriptor: entry.descriptor });
             entry.agent.state.state = "dead";
             entry.agent.state.updatedAt = Date.now();
-            await agentStateWrite(this.config.current, entry.agentId, entry.agent.state);
+            await agentStateWrite(this.storage, entry.agentId, entry.agent.state);
             pending = entry.inbox.drainPending();
             changed = true;
         });
@@ -755,9 +772,9 @@ export class AgentSystem {
         let state = null;
         let recordUserId = "";
         try {
-            descriptor = await agentDescriptorRead(this.config.current, agentId);
-            state = await agentStateRead(this.config.current, agentId);
-            const record = await agentDbRead(this.config.current, agentId);
+            descriptor = await agentDescriptorRead(this.storage, agentId);
+            state = await agentStateRead(this.storage, agentId);
+            const record = await this.storage.agents.findById(agentId);
             recordUserId = record?.userId ?? "";
         }
         catch (error) {
@@ -774,7 +791,8 @@ export class AgentSystem {
             return null;
         }
         const inbox = new AgentInbox(agentId);
-        const agent = Agent.restore(agentId, recordUserId, descriptor, state, inbox, this);
+        const userHome = this.userHomeForUserId(recordUserId);
+        const agent = Agent.restore(agentId, recordUserId, descriptor, state, inbox, this, userHome);
         const entry = this.registerEntry({
             agentId,
             userId: recordUserId,
@@ -792,7 +810,7 @@ export class AgentSystem {
             return this.resolveUserIdForConnectorKey(connectorKey);
         }
         if (descriptor.type === "subagent" || descriptor.type === "app") {
-            const parent = await this.agentContextForAgentId(descriptor.parentAgentId);
+            const parent = await this.contextForAgentId(descriptor.parentAgentId);
             if (parent) {
                 return parent.userId;
             }
@@ -801,47 +819,27 @@ export class AgentSystem {
         return this.ownerUserIdEnsure();
     }
     async resolveUserIdForConnectorKey(connectorKey) {
-        const existing = await userDbReadByConnectorKey(this.config.current, connectorKey);
-        if (existing) {
-            return existing.id;
-        }
-        const users = await userDbList(this.config.current);
-        const now = Date.now();
-        const userId = createId();
-        await userDbWrite(this.config.current, {
-            id: userId,
-            isOwner: users.length === 0,
-            createdAt: now,
-            updatedAt: now
-        });
         try {
-            await userDbConnectorKeyAdd(this.config.current, userId, connectorKey);
-            return userId;
+            const user = await this.storage.resolveUserByConnectorKey(connectorKey);
+            const userId = user.id?.trim() ?? "";
+            if (userId) {
+                return userId;
+            }
         }
         catch (error) {
-            const raced = await userDbReadByConnectorKey(this.config.current, connectorKey);
-            if (raced) {
-                return raced.id;
-            }
-            try {
-                await userDbDelete(this.config.current, userId);
-            }
-            catch (deleteError) {
-                logger.warn({ userId, connectorKey, error: deleteError }, "warn: Failed to clean orphaned user row");
-            }
-            throw error;
+            logger.warn({ connectorKey, error }, "warn: Failed to resolve connector user; falling back to owner");
         }
+        return this.ownerUserIdEnsure();
     }
     async ownerUserIdEnsure() {
-        const users = await userDbList(this.config.current);
-        const owner = users.find((entry) => entry.isOwner);
+        const owner = await this.storage.users.findOwner();
         if (owner) {
             return owner.id;
         }
         const now = Date.now();
         const ownerId = createId();
         try {
-            await userDbWrite(this.config.current, {
+            await this.storage.users.create({
                 id: ownerId,
                 isOwner: true,
                 createdAt: now,
@@ -850,14 +848,20 @@ export class AgentSystem {
             return ownerId;
         }
         catch {
-            const reread = await userDbList(this.config.current);
-            const recovered = reread.find((entry) => entry.isOwner);
+            const recovered = await this.storage.users.findOwner();
             if (recovered) {
                 return recovered.id;
             }
             throw new Error("Failed to resolve owner user");
         }
     }
+    /**
+     * Resolves a UserHome facade for a concrete user id.
+     * Expects: userId belongs to an existing or soon-to-be-created runtime user.
+     */
+    userHomeForUserId(userId) {
+        return new UserHome(this.config.current.usersDir, userId);
+    }
     createCompletion() {
         let resolve = null;
         let reject = null;