daycare-cli 0.0.1

package/dist/engine/agents/ops/agentDescriptorBuild.d.ts

@@ -0,0 +1,7 @@
+import type { AgentDescriptor } from "./agentDescriptorTypes.js";
+/**
+ * Builds an AgentDescriptor from message source and context.
+ * Expects: source === "system" for synthetic agents.
+ */
+export declare function agentDescriptorBuild(source: string, _context: unknown, agentId: string): AgentDescriptor;
+//# sourceMappingURL=agentDescriptorBuild.d.ts.map

package/dist/engine/agents/ops/agentDescriptorBuild.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agentDescriptorBuild.d.ts","sourceRoot":"","sources":["../../../../sources/engine/agents/ops/agentDescriptorBuild.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAC;AAEjE;;;GAGG;AACH,wBAAgB,oBAAoB,CAClC,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,OAAO,EACjB,OAAO,EAAE,MAAM,GACd,eAAe,CAUjB"}

package/dist/engine/agents/ops/agentDescriptorBuild.js

@@ -0,0 +1,16 @@
+/**
+ * Builds an AgentDescriptor from message source and context.
+ * Expects: source === "system" for synthetic agents.
+ */
+export function agentDescriptorBuild(source, _context, agentId) {
+    if (source === "system") {
+        return {
+            type: "subagent",
+            id: agentId,
+            parentAgentId: "system",
+            name: "system"
+        };
+    }
+    throw new Error("Agent descriptor requires explicit descriptor data for non-system sources");
+}
+//# sourceMappingURL=agentDescriptorBuild.js.map

package/dist/engine/agents/ops/agentDescriptorBuild.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agentDescriptorBuild.js","sourceRoot":"","sources":["../../../../sources/engine/agents/ops/agentDescriptorBuild.ts"],"names":[],"mappings":"AAEA;;;GAGG;AACH,MAAM,UAAU,oBAAoB,CAClC,MAAc,EACd,QAAiB,EACjB,OAAe;IAEf,IAAI,MAAM,KAAK,QAAQ,EAAE,CAAC;QACxB,OAAO;YACL,IAAI,EAAE,UAAU;YAChB,EAAE,EAAE,OAAO;YACX,aAAa,EAAE,QAAQ;YACvB,IAAI,EAAE,QAAQ;SACf,CAAC;IACJ,CAAC;IACD,MAAM,IAAI,KAAK,CAAC,2EAA2E,CAAC,CAAC;AAC/F,CAAC"}

package/dist/engine/agents/ops/agentDescriptorIsCron.d.ts

@@ -0,0 +1,9 @@
+import type { AgentDescriptor } from "./agentDescriptorTypes.js";
+/**
+ * Detects cron agents from a descriptor.
+ * Expects: descriptor is validated.
+ */
+export declare function agentDescriptorIsCron(descriptor?: AgentDescriptor): descriptor is Extract<AgentDescriptor, {
+    type: "cron";
+}>;
+//# sourceMappingURL=agentDescriptorIsCron.d.ts.map

package/dist/engine/agents/ops/agentDescriptorIsCron.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agentDescriptorIsCron.d.ts","sourceRoot":"","sources":["../../../../sources/engine/agents/ops/agentDescriptorIsCron.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAC;AAEjE;;;GAGG;AACH,wBAAgB,qBAAqB,CACnC,UAAU,CAAC,EAAE,eAAe,GAC3B,UAAU,IAAI,OAAO,CAAC,eAAe,EAAE;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC,CAE1D"}

package/dist/engine/agents/ops/agentDescriptorIsCron.js

@@ -0,0 +1,8 @@
+/**
+ * Detects cron agents from a descriptor.
+ * Expects: descriptor is validated.
+ */
+export function agentDescriptorIsCron(descriptor) {
+    return descriptor?.type === "cron";
+}
+//# sourceMappingURL=agentDescriptorIsCron.js.map

package/dist/engine/agents/ops/agentDescriptorIsCron.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agentDescriptorIsCron.js","sourceRoot":"","sources":["../../../../sources/engine/agents/ops/agentDescriptorIsCron.ts"],"names":[],"mappings":"AAEA;;;GAGG;AACH,MAAM,UAAU,qBAAqB,CACnC,UAA4B;IAE5B,OAAO,UAAU,EAAE,IAAI,KAAK,MAAM,CAAC;AACrC,CAAC"}

package/dist/engine/agents/ops/agentDescriptorIsHeartbeat.d.ts

@@ -0,0 +1,10 @@
+import type { AgentDescriptor } from "./agentDescriptorTypes.js";
+/**
+ * Detects heartbeat agents from a descriptor.
+ * Expects: descriptor is validated.
+ */
+export declare function agentDescriptorIsHeartbeat(descriptor?: AgentDescriptor): descriptor is Extract<AgentDescriptor, {
+    type: "system";
+    tag: "heartbeat";
+}>;
+//# sourceMappingURL=agentDescriptorIsHeartbeat.d.ts.map

package/dist/engine/agents/ops/agentDescriptorIsHeartbeat.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agentDescriptorIsHeartbeat.d.ts","sourceRoot":"","sources":["../../../../sources/engine/agents/ops/agentDescriptorIsHeartbeat.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAC;AAEjE;;;GAGG;AACH,wBAAgB,0BAA0B,CACxC,UAAU,CAAC,EAAE,eAAe,GAC3B,UAAU,IAAI,OAAO,CAAC,eAAe,EAAE;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,GAAG,EAAE,WAAW,CAAA;CAAE,CAAC,CAE9E"}

package/dist/engine/agents/ops/agentDescriptorIsHeartbeat.js

@@ -0,0 +1,8 @@
+/**
+ * Detects heartbeat agents from a descriptor.
+ * Expects: descriptor is validated.
+ */
+export function agentDescriptorIsHeartbeat(descriptor) {
+    return descriptor?.type === "system" && descriptor.tag === "heartbeat";
+}
+//# sourceMappingURL=agentDescriptorIsHeartbeat.js.map

package/dist/engine/agents/ops/agentDescriptorIsHeartbeat.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agentDescriptorIsHeartbeat.js","sourceRoot":"","sources":["../../../../sources/engine/agents/ops/agentDescriptorIsHeartbeat.ts"],"names":[],"mappings":"AAEA;;;GAGG;AACH,MAAM,UAAU,0BAA0B,CACxC,UAA4B;IAE5B,OAAO,UAAU,EAAE,IAAI,KAAK,QAAQ,IAAI,UAAU,CAAC,GAAG,KAAK,WAAW,CAAC;AACzE,CAAC"}

package/dist/engine/agents/ops/agentDescriptorIsHeartbeat.spec.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=agentDescriptorIsHeartbeat.spec.d.ts.map

package/dist/engine/agents/ops/agentDescriptorIsHeartbeat.spec.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agentDescriptorIsHeartbeat.spec.d.ts","sourceRoot":"","sources":["../../../../sources/engine/agents/ops/agentDescriptorIsHeartbeat.spec.ts"],"names":[],"mappings":""}

package/dist/engine/agents/ops/agentDescriptorIsHeartbeat.spec.js

@@ -0,0 +1,17 @@
+import { describe, expect, it } from "vitest";
+import { agentDescriptorIsHeartbeat } from "./agentDescriptorIsHeartbeat.js";
+describe("agentDescriptorIsHeartbeat", () => {
+    it("matches the heartbeat system tag", () => {
+        expect(agentDescriptorIsHeartbeat({ type: "system", tag: "heartbeat" })).toBe(true);
+    });
+    it("rejects non-heartbeat descriptors", () => {
+        expect(agentDescriptorIsHeartbeat({ type: "system", tag: "architect" })).toBe(false);
+        expect(agentDescriptorIsHeartbeat({
+            type: "user",
+            connector: "telegram",
+            userId: "u1",
+            channelId: "c1"
+        })).toBe(false);
+    });
+});
+//# sourceMappingURL=agentDescriptorIsHeartbeat.spec.js.map

package/dist/engine/agents/ops/agentDescriptorIsHeartbeat.spec.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agentDescriptorIsHeartbeat.spec.js","sourceRoot":"","sources":["../../../../sources/engine/agents/ops/agentDescriptorIsHeartbeat.spec.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AAE9C,OAAO,EAAE,0BAA0B,EAAE,MAAM,iCAAiC,CAAC;AAE7E,QAAQ,CAAC,4BAA4B,EAAE,GAAG,EAAE;IAC1C,EAAE,CAAC,kCAAkC,EAAE,GAAG,EAAE;QAC1C,MAAM,CAAC,0BAA0B,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,GAAG,EAAE,WAAW,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACtF,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,mCAAmC,EAAE,GAAG,EAAE;QAC3C,MAAM,CAAC,0BAA0B,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,GAAG,EAAE,WAAW,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACrF,MAAM,CACJ,0BAA0B,CAAC;YACzB,IAAI,EAAE,MAAM;YACZ,SAAS,EAAE,UAAU;YACrB,MAAM,EAAE,IAAI;YACZ,SAAS,EAAE,IAAI;SAChB,CAAC,CACH,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAChB,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/engine/agents/ops/agentDescriptorLabel.d.ts

@@ -0,0 +1,7 @@
+import type { AgentDescriptor } from "./agentDescriptorTypes.js";
+/**
+ * Builds a short human-friendly label for an agent descriptor.
+ * Expects: descriptor is valid.
+ */
+export declare function agentDescriptorLabel(descriptor: AgentDescriptor): string;
+//# sourceMappingURL=agentDescriptorLabel.d.ts.map

package/dist/engine/agents/ops/agentDescriptorLabel.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agentDescriptorLabel.d.ts","sourceRoot":"","sources":["../../../../sources/engine/agents/ops/agentDescriptorLabel.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAC;AAEjE;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,UAAU,EAAE,eAAe,GAAG,MAAM,CAWxE"}

package/dist/engine/agents/ops/agentDescriptorLabel.js

@@ -0,0 +1,17 @@
+/**
+ * Builds a short human-friendly label for an agent descriptor.
+ * Expects: descriptor is valid.
+ */
+export function agentDescriptorLabel(descriptor) {
+    if (descriptor.type === "subagent" || descriptor.type === "permanent") {
+        return descriptor.name ?? descriptor.type;
+    }
+    if (descriptor.type === "cron") {
+        return descriptor.name ?? "cron task";
+    }
+    if (descriptor.type === "system") {
+        return descriptor.tag;
+    }
+    return "user";
+}
+//# sourceMappingURL=agentDescriptorLabel.js.map

package/dist/engine/agents/ops/agentDescriptorLabel.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agentDescriptorLabel.js","sourceRoot":"","sources":["../../../../sources/engine/agents/ops/agentDescriptorLabel.ts"],"names":[],"mappings":"AAEA;;;GAGG;AACH,MAAM,UAAU,oBAAoB,CAAC,UAA2B;IAC9D,IAAI,UAAU,CAAC,IAAI,KAAK,UAAU,IAAI,UAAU,CAAC,IAAI,KAAK,WAAW,EAAE,CAAC;QACtE,OAAO,UAAU,CAAC,IAAI,IAAI,UAAU,CAAC,IAAI,CAAC;IAC5C,CAAC;IACD,IAAI,UAAU,CAAC,IAAI,KAAK,MAAM,EAAE,CAAC;QAC/B,OAAO,UAAU,CAAC,IAAI,IAAI,WAAW,CAAC;IACxC,CAAC;IACD,IAAI,UAAU,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;QACjC,OAAO,UAAU,CAAC,GAAG,CAAC;IACxB,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/engine/agents/ops/agentDescriptorLabel.spec.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=agentDescriptorLabel.spec.d.ts.map

package/dist/engine/agents/ops/agentDescriptorLabel.spec.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agentDescriptorLabel.spec.d.ts","sourceRoot":"","sources":["../../../../sources/engine/agents/ops/agentDescriptorLabel.spec.ts"],"names":[],"mappings":""}

package/dist/engine/agents/ops/agentDescriptorLabel.spec.js

@@ -0,0 +1,41 @@
+import { describe, expect, it } from "vitest";
+import { agentDescriptorLabel } from "./agentDescriptorLabel.js";
+describe("agentDescriptorLabel", () => {
+    it("labels named agents", () => {
+        expect(agentDescriptorLabel({
+            type: "subagent",
+            id: "sub-1",
+            parentAgentId: "parent",
+            name: "web-checker"
+        })).toBe("web-checker");
+        expect(agentDescriptorLabel({
+            type: "permanent",
+            id: "perm-1",
+            name: "memory",
+            description: "desc",
+            systemPrompt: "prompt"
+        })).toBe("memory");
+    });
+    it("labels non-user agents", () => {
+        expect(agentDescriptorLabel({
+            type: "cron",
+            id: "cron-1"
+        })).toBe("cron task");
+        expect(agentDescriptorLabel({
+            type: "cron",
+            id: "cron-2",
+            name: "daily summary"
+        })).toBe("daily summary");
+        expect(agentDescriptorLabel({ type: "system", tag: "heartbeat" })).toBe("heartbeat");
+        expect(agentDescriptorLabel({ type: "system", tag: "architect" })).toBe("architect");
+    });
+    it("labels user agents", () => {
+        expect(agentDescriptorLabel({
+            type: "user",
+            connector: "telegram",
+            userId: "u1",
+            channelId: "c1"
+        })).toBe("user");
+    });
+});
+//# sourceMappingURL=agentDescriptorLabel.spec.js.map

package/dist/engine/agents/ops/agentDescriptorLabel.spec.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agentDescriptorLabel.spec.js","sourceRoot":"","sources":["../../../../sources/engine/agents/ops/agentDescriptorLabel.spec.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AAE9C,OAAO,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAC;AAEjE,QAAQ,CAAC,sBAAsB,EAAE,GAAG,EAAE;IACpC,EAAE,CAAC,qBAAqB,EAAE,GAAG,EAAE;QAC7B,MAAM,CACJ,oBAAoB,CAAC;YACnB,IAAI,EAAE,UAAU;YAChB,EAAE,EAAE,OAAO;YACX,aAAa,EAAE,QAAQ;YACvB,IAAI,EAAE,aAAa;SACpB,CAAC,CACH,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;QACtB,MAAM,CACJ,oBAAoB,CAAC;YACnB,IAAI,EAAE,WAAW;YACjB,EAAE,EAAE,QAAQ;YACZ,IAAI,EAAE,QAAQ;YACd,WAAW,EAAE,MAAM;YACnB,YAAY,EAAE,QAAQ;SACvB,CAAC,CACH,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IACnB,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,wBAAwB,EAAE,GAAG,EAAE;QAChC,MAAM,CACJ,oBAAoB,CAAC;YACnB,IAAI,EAAE,MAAM;YACZ,EAAE,EAAE,QAAQ;SACb,CAAC,CACH,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;QACpB,MAAM,CACJ,oBAAoB,CAAC;YACnB,IAAI,EAAE,MAAM;YACZ,EAAE,EAAE,QAAQ;YACZ,IAAI,EAAE,eAAe;SACtB,CAAC,CACH,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC;QACxB,MAAM,CAAC,oBAAoB,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,GAAG,EAAE,WAAW,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;QACrF,MAAM,CAAC,oBAAoB,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,GAAG,EAAE,WAAW,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;IACvF,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,oBAAoB,EAAE,GAAG,EAAE;QAC5B,MAAM,CACJ,oBAAoB,CAAC;YACnB,IAAI,EAAE,MAAM;YACZ,SAAS,EAAE,UAAU;YACrB,MAAM,EAAE,IAAI;YACZ,SAAS,EAAE,IAAI;SAChB,CAAC,CACH,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IACjB,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/engine/agents/ops/agentDescriptorMatchesStrategy.d.ts

@@ -0,0 +1,7 @@
+import type { AgentDescriptor, AgentFetchStrategy } from "./agentDescriptorTypes.js";
+/**
+ * Checks whether a descriptor matches a lookup strategy.
+ * Expects: descriptor is validated.
+ */
+export declare function agentDescriptorMatchesStrategy(descriptor: AgentDescriptor, strategy: AgentFetchStrategy): boolean;
+//# sourceMappingURL=agentDescriptorMatchesStrategy.d.ts.map

package/dist/engine/agents/ops/agentDescriptorMatchesStrategy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agentDescriptorMatchesStrategy.d.ts","sourceRoot":"","sources":["../../../../sources/engine/agents/ops/agentDescriptorMatchesStrategy.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAErF;;;GAGG;AACH,wBAAgB,8BAA8B,CAC5C,UAAU,EAAE,eAAe,EAC3B,QAAQ,EAAE,kBAAkB,GAC3B,OAAO,CAST"}

package/dist/engine/agents/ops/agentDescriptorMatchesStrategy.js

@@ -0,0 +1,15 @@
+/**
+ * Checks whether a descriptor matches a lookup strategy.
+ * Expects: descriptor is validated.
+ */
+export function agentDescriptorMatchesStrategy(descriptor, strategy) {
+    switch (strategy) {
+        case "most-recent-foreground":
+            return descriptor.type === "user";
+        case "heartbeat":
+            return descriptor.type === "system" && descriptor.tag === "heartbeat";
+        default:
+            return false;
+    }
+}
+//# sourceMappingURL=agentDescriptorMatchesStrategy.js.map

package/dist/engine/agents/ops/agentDescriptorMatchesStrategy.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agentDescriptorMatchesStrategy.js","sourceRoot":"","sources":["../../../../sources/engine/agents/ops/agentDescriptorMatchesStrategy.ts"],"names":[],"mappings":"AAEA;;;GAGG;AACH,MAAM,UAAU,8BAA8B,CAC5C,UAA2B,EAC3B,QAA4B;IAE5B,QAAQ,QAAQ,EAAE,CAAC;QACjB,KAAK,wBAAwB;YAC3B,OAAO,UAAU,CAAC,IAAI,KAAK,MAAM,CAAC;QACpC,KAAK,WAAW;YACd,OAAO,UAAU,CAAC,IAAI,KAAK,QAAQ,IAAI,UAAU,CAAC,GAAG,KAAK,WAAW,CAAC;QACxE;YACE,OAAO,KAAK,CAAC;IACjB,CAAC;AACH,CAAC"}

package/dist/engine/agents/ops/agentDescriptorRead.d.ts

@@ -0,0 +1,8 @@
+import type { Config } from "@/types";
+import type { AgentDescriptor } from "./agentDescriptorTypes.js";
+/**
+ * Loads and validates an agent descriptor from disk.
+ * Expects: descriptor.json exists and matches the descriptor schema.
+ */
+export declare function agentDescriptorRead(config: Config, agentId: string): Promise<AgentDescriptor | null>;
+//# sourceMappingURL=agentDescriptorRead.d.ts.map

package/dist/engine/agents/ops/agentDescriptorRead.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agentDescriptorRead.d.ts","sourceRoot":"","sources":["../../../../sources/engine/agents/ops/agentDescriptorRead.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AACtC,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAC;AA6CjE;;;GAGG;AACH,wBAAsB,mBAAmB,CACvC,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,MAAM,GACd,OAAO,CAAC,eAAe,GAAG,IAAI,CAAC,CAcjC"}

package/dist/engine/agents/ops/agentDescriptorRead.js

@@ -0,0 +1,66 @@
+import { promises as fs } from "node:fs";
+import path from "node:path";
+import { z } from "zod";
+import { agentPathBuild } from "./agentPathBuild.js";
+const descriptorSchema = z.discriminatedUnion("type", [
+    z
+        .object({
+        type: z.literal("user"),
+        connector: z.string().min(1),
+        userId: z.string().min(1),
+        channelId: z.string().min(1)
+    })
+        .strict(),
+    z
+        .object({
+        type: z.literal("cron"),
+        id: z.string().min(1),
+        name: z.string().min(1).optional()
+    })
+        .strict(),
+    z
+        .object({
+        type: z.literal("system"),
+        tag: z.string().regex(/^[a-z]+$/, "system tag must be lowercase english letters")
+    })
+        .strict(),
+    z
+        .object({
+        type: z.literal("subagent"),
+        id: z.string().min(1),
+        parentAgentId: z.string().min(1),
+        name: z.string().min(1)
+    })
+        .strict(),
+    z
+        .object({
+        type: z.literal("permanent"),
+        id: z.string().min(1),
+        name: z.string().min(1),
+        description: z.string().min(1),
+        systemPrompt: z.string().min(1),
+        workspaceDir: z.string().min(1).optional()
+    })
+        .strict()
+]);
+/**
+ * Loads and validates an agent descriptor from disk.
+ * Expects: descriptor.json exists and matches the descriptor schema.
+ */
+export async function agentDescriptorRead(config, agentId) {
+    const basePath = agentPathBuild(config, agentId);
+    const filePath = path.join(basePath, "descriptor.json");
+    let raw = "";
+    try {
+        raw = await fs.readFile(filePath, "utf8");
+    }
+    catch (error) {
+        if (error.code === "ENOENT") {
+            return null;
+        }
+        throw error;
+    }
+    const parsed = JSON.parse(raw);
+    return descriptorSchema.parse(parsed);
+}
+//# sourceMappingURL=agentDescriptorRead.js.map

package/dist/engine/agents/ops/agentDescriptorRead.js.map

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

package/dist/engine/agents/ops/agentDescriptorTargetResolve.d.ts

@@ -0,0 +1,10 @@
+import type { AgentDescriptor } from "./agentDescriptorTypes.js";
+/**
+ * Resolves connector targeting for user agents.
+ * Expects: descriptor is validated.
+ */
+export declare function agentDescriptorTargetResolve(descriptor: AgentDescriptor): {
+    connector: string;
+    targetId: string;
+} | null;
+//# sourceMappingURL=agentDescriptorTargetResolve.d.ts.map

package/dist/engine/agents/ops/agentDescriptorTargetResolve.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agentDescriptorTargetResolve.d.ts","sourceRoot":"","sources":["../../../../sources/engine/agents/ops/agentDescriptorTargetResolve.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAC;AAEjE;;;GAGG;AACH,wBAAgB,4BAA4B,CAC1C,UAAU,EAAE,eAAe,GAC1B;IAAE,SAAS,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAKhD"}

package/dist/engine/agents/ops/agentDescriptorTargetResolve.js

@@ -0,0 +1,11 @@
+/**
+ * Resolves connector targeting for user agents.
+ * Expects: descriptor is validated.
+ */
+export function agentDescriptorTargetResolve(descriptor) {
+    if (descriptor.type !== "user") {
+        return null;
+    }
+    return { connector: descriptor.connector, targetId: descriptor.channelId };
+}
+//# sourceMappingURL=agentDescriptorTargetResolve.js.map

package/dist/engine/agents/ops/agentDescriptorTargetResolve.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agentDescriptorTargetResolve.js","sourceRoot":"","sources":["../../../../sources/engine/agents/ops/agentDescriptorTargetResolve.ts"],"names":[],"mappings":"AAEA;;;GAGG;AACH,MAAM,UAAU,4BAA4B,CAC1C,UAA2B;IAE3B,IAAI,UAAU,CAAC,IAAI,KAAK,MAAM,EAAE,CAAC;QAC/B,OAAO,IAAI,CAAC;IACd,CAAC;IACD,OAAO,EAAE,SAAS,EAAE,UAAU,CAAC,SAAS,EAAE,QAAQ,EAAE,UAAU,CAAC,SAAS,EAAE,CAAC;AAC7E,CAAC"}

package/dist/engine/agents/ops/agentDescriptorTargetResolve.spec.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=agentDescriptorTargetResolve.spec.d.ts.map

package/dist/engine/agents/ops/agentDescriptorTargetResolve.spec.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agentDescriptorTargetResolve.spec.d.ts","sourceRoot":"","sources":["../../../../sources/engine/agents/ops/agentDescriptorTargetResolve.spec.ts"],"names":[],"mappings":""}

package/dist/engine/agents/ops/agentDescriptorTargetResolve.spec.js

@@ -0,0 +1,18 @@
+import { describe, expect, it } from "vitest";
+import { agentDescriptorTargetResolve } from "./agentDescriptorTargetResolve.js";
+describe("agentDescriptorTargetResolve", () => {
+    it("returns connector target for user descriptors", () => {
+        const result = agentDescriptorTargetResolve({
+            type: "user",
+            connector: "telegram",
+            userId: "user-1",
+            channelId: "channel-1"
+        });
+        expect(result).toEqual({ connector: "telegram", targetId: "channel-1" });
+    });
+    it("returns null for non-user descriptors", () => {
+        const result = agentDescriptorTargetResolve({ type: "system", tag: "heartbeat" });
+        expect(result).toBeNull();
+    });
+});
+//# sourceMappingURL=agentDescriptorTargetResolve.spec.js.map

package/dist/engine/agents/ops/agentDescriptorTargetResolve.spec.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agentDescriptorTargetResolve.spec.js","sourceRoot":"","sources":["../../../../sources/engine/agents/ops/agentDescriptorTargetResolve.spec.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AAE9C,OAAO,EAAE,4BAA4B,EAAE,MAAM,mCAAmC,CAAC;AAEjF,QAAQ,CAAC,8BAA8B,EAAE,GAAG,EAAE;IAC5C,EAAE,CAAC,+CAA+C,EAAE,GAAG,EAAE;QACvD,MAAM,MAAM,GAAG,4BAA4B,CAAC;YAC1C,IAAI,EAAE,MAAM;YACZ,SAAS,EAAE,UAAU;YACrB,MAAM,EAAE,QAAQ;YAChB,SAAS,EAAE,WAAW;SACvB,CAAC,CAAC;QAEH,MAAM,CAAC,MAAM,CAAC,CAAC,OAAO,CAAC,EAAE,SAAS,EAAE,UAAU,EAAE,QAAQ,EAAE,WAAW,EAAE,CAAC,CAAC;IAC3E,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,uCAAuC,EAAE,GAAG,EAAE;QAC/C,MAAM,MAAM,GAAG,4BAA4B,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,GAAG,EAAE,WAAW,EAAE,CAAC,CAAC;QAElF,MAAM,CAAC,MAAM,CAAC,CAAC,QAAQ,EAAE,CAAC;IAC5B,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/engine/agents/ops/agentDescriptorTypes.d.ts

@@ -0,0 +1,27 @@
+export type AgentDescriptor = {
+    type: "user";
+    connector: string;
+    userId: string;
+    channelId: string;
+} | {
+    type: "cron";
+    id: string;
+    name?: string;
+} | {
+    type: "system";
+    tag: string;
+} | {
+    type: "subagent";
+    id: string;
+    parentAgentId: string;
+    name: string;
+} | {
+    type: "permanent";
+    id: string;
+    name: string;
+    description: string;
+    systemPrompt: string;
+    workspaceDir?: string;
+};
+export type AgentFetchStrategy = "most-recent-foreground" | "heartbeat";
+//# sourceMappingURL=agentDescriptorTypes.d.ts.map

package/dist/engine/agents/ops/agentDescriptorTypes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agentDescriptorTypes.d.ts","sourceRoot":"","sources":["../../../../sources/engine/agents/ops/agentDescriptorTypes.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,eAAe,GACvB;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,GACtE;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,EAAE,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE,GAC3C;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,GAC/B;IAAE,IAAI,EAAE,UAAU,CAAC;IAAC,EAAE,EAAE,MAAM,CAAC;IAAC,aAAa,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GACrE;IACE,IAAI,EAAE,WAAW,CAAC;IAClB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB,CAAC;AAEN,MAAM,MAAM,kBAAkB,GAAG,wBAAwB,GAAG,WAAW,CAAC"}

package/dist/engine/agents/ops/agentDescriptorTypes.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=agentDescriptorTypes.js.map

package/dist/engine/agents/ops/agentDescriptorTypes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agentDescriptorTypes.js","sourceRoot":"","sources":["../../../../sources/engine/agents/ops/agentDescriptorTypes.ts"],"names":[],"mappings":""}

package/dist/engine/agents/ops/agentDescriptorWrite.d.ts

@@ -0,0 +1,8 @@
+import type { Config } from "@/types";
+import type { AgentDescriptor } from "./agentDescriptorTypes.js";
+/**
+ * Writes an agent descriptor to disk with an atomic rename.
+ * Expects: descriptor has been validated.
+ */
+export declare function agentDescriptorWrite(config: Config, agentId: string, descriptor: AgentDescriptor): Promise<void>;
+//# sourceMappingURL=agentDescriptorWrite.d.ts.map

package/dist/engine/agents/ops/agentDescriptorWrite.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agentDescriptorWrite.d.ts","sourceRoot":"","sources":["../../../../sources/engine/agents/ops/agentDescriptorWrite.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AACtC,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAC;AAIjE;;;GAGG;AACH,wBAAsB,oBAAoB,CACxC,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,MAAM,EACf,UAAU,EAAE,eAAe,GAC1B,OAAO,CAAC,IAAI,CAAC,CAMf"}

package/dist/engine/agents/ops/agentDescriptorWrite.js

@@ -0,0 +1,16 @@
+import { promises as fs } from "node:fs";
+import path from "node:path";
+import { agentPathBuild } from "./agentPathBuild.js";
+import { atomicWrite } from "../../../util/atomicWrite.js";
+/**
+ * Writes an agent descriptor to disk with an atomic rename.
+ * Expects: descriptor has been validated.
+ */
+export async function agentDescriptorWrite(config, agentId, descriptor) {
+    const basePath = agentPathBuild(config, agentId);
+    await fs.mkdir(basePath, { recursive: true });
+    const filePath = path.join(basePath, "descriptor.json");
+    const payload = `${JSON.stringify(descriptor, null, 2)}\n`;
+    await atomicWrite(filePath, payload);
+}
+//# sourceMappingURL=agentDescriptorWrite.js.map

package/dist/engine/agents/ops/agentDescriptorWrite.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agentDescriptorWrite.js","sourceRoot":"","sources":["../../../../sources/engine/agents/ops/agentDescriptorWrite.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,IAAI,EAAE,EAAE,MAAM,SAAS,CAAC;AACzC,OAAO,IAAI,MAAM,WAAW,CAAC;AAI7B,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AACrD,OAAO,EAAE,WAAW,EAAE,MAAM,8BAA8B,CAAC;AAE3D;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,oBAAoB,CACxC,MAAc,EACd,OAAe,EACf,UAA2B;IAE3B,MAAM,QAAQ,GAAG,cAAc,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACjD,MAAM,EAAE,CAAC,KAAK,CAAC,QAAQ,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAC9C,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,iBAAiB,CAAC,CAAC;IACxD,MAAM,OAAO,GAAG,GAAG,IAAI,CAAC,SAAS,CAAC,UAAU,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC;IAC3D,MAAM,WAAW,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;AACvC,CAAC"}

package/dist/engine/agents/ops/agentHistoryAppend.d.ts

@@ -0,0 +1,8 @@
+import type { Config } from "@/types";
+import type { AgentHistoryRecord } from "./agentTypes.js";
+/**
+ * Appends a history record to the agent history log.
+ * Expects: record is JSON-serializable.
+ */
+export declare function agentHistoryAppend(config: Config, agentId: string, record: AgentHistoryRecord): Promise<void>;
+//# sourceMappingURL=agentHistoryAppend.d.ts.map

package/dist/engine/agents/ops/agentHistoryAppend.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agentHistoryAppend.d.ts","sourceRoot":"","sources":["../../../../sources/engine/agents/ops/agentHistoryAppend.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AACtC,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AAG1D;;;GAGG;AACH,wBAAsB,kBAAkB,CACtC,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,kBAAkB,GACzB,OAAO,CAAC,IAAI,CAAC,CAMf"}

package/dist/engine/agents/ops/agentHistoryAppend.js

@@ -0,0 +1,15 @@
+import { promises as fs } from "node:fs";
+import path from "node:path";
+import { agentPathBuild } from "./agentPathBuild.js";
+/**
+ * Appends a history record to the agent history log.
+ * Expects: record is JSON-serializable.
+ */
+export async function agentHistoryAppend(config, agentId, record) {
+    const basePath = agentPathBuild(config, agentId);
+    await fs.mkdir(basePath, { recursive: true });
+    const filePath = path.join(basePath, "history.jsonl");
+    const line = `${JSON.stringify(record)}\n`;
+    await fs.appendFile(filePath, line, "utf8");
+}
+//# sourceMappingURL=agentHistoryAppend.js.map

package/dist/engine/agents/ops/agentHistoryAppend.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agentHistoryAppend.js","sourceRoot":"","sources":["../../../../sources/engine/agents/ops/agentHistoryAppend.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,IAAI,EAAE,EAAE,MAAM,SAAS,CAAC;AACzC,OAAO,IAAI,MAAM,WAAW,CAAC;AAI7B,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAErD;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,kBAAkB,CACtC,MAAc,EACd,OAAe,EACf,MAA0B;IAE1B,MAAM,QAAQ,GAAG,cAAc,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACjD,MAAM,EAAE,CAAC,KAAK,CAAC,QAAQ,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAC9C,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,eAAe,CAAC,CAAC;IACtD,MAAM,IAAI,GAAG,GAAG,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,IAAI,CAAC;IAC3C,MAAM,EAAE,CAAC,UAAU,CAAC,QAAQ,EAAE,IAAI,EAAE,MAAM,CAAC,CAAC;AAC9C,CAAC"}

package/dist/engine/agents/ops/agentHistoryLoad.d.ts

@@ -0,0 +1,8 @@
+import type { Config } from "@/types";
+import type { AgentHistoryRecord } from "./agentTypes.js";
+/**
+ * Loads history records after the most recent start/reset marker.
+ * Expects: history.jsonl is newline-delimited JSON.
+ */
+export declare function agentHistoryLoad(config: Config, agentId: string): Promise<AgentHistoryRecord[]>;
+//# sourceMappingURL=agentHistoryLoad.d.ts.map

package/dist/engine/agents/ops/agentHistoryLoad.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agentHistoryLoad.d.ts","sourceRoot":"","sources":["../../../../sources/engine/agents/ops/agentHistoryLoad.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AACtC,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AA0F1D;;;GAGG;AACH,wBAAsB,gBAAgB,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,kBAAkB,EAAE,CAAC,CAqDrG"}