dot-agents 0.5.0 → 0.7.4

package/dist/lib/environment.js

@@ -0,0 +1,238 @@
+import { relative } from "node:path";
+import { listPersonas, loadPersona, loadRootPersona } from "./persona.js";
+import { listWorkflows, loadWorkflow } from "./workflow.js";
+import { listChannels } from "./channel.js";
+import { getProjectNameByPath, listProjects } from "./registry.js";
+import { getDaemonStatus } from "./daemon-status.js";
+/**
+ * Threshold for switching from full display to names-only
+ */
+const NAMES_ONLY_THRESHOLD = 10;
+/**
+ * Threshold for truncating list with "Run X for full list" message
+ */
+const TRUNCATE_THRESHOLD = 25;
+/**
+ * Build environment context by discovering project resources.
+ *
+ * This function:
+ * 1. Gets current project info from registry
+ * 2. Lists all registered projects with daemon status
+ * 3. Lists personas (name + description)
+ * 4. Lists workflows (name + description)
+ * 5. Lists channels
+ */
+export async function buildEnvironmentContext(config) {
+    // Get project name from registry
+    const projectName = await getProjectNameByPath(config.agentsDir);
+    // Get daemon status for current project
+    const daemonStatus = await getDaemonStatus(config.agentsDir);
+    // Get all registered projects with daemon status
+    const allProjects = await listProjects();
+    const registeredProjects = await Promise.all(allProjects.map(async (project) => {
+        const projectDaemonStatus = await getDaemonStatus(project.path);
+        return {
+            name: project.name,
+            path: project.path,
+            daemonRunning: projectDaemonStatus.running,
+            daemonPid: projectDaemonStatus.pid,
+        };
+    }));
+    // List personas
+    const personaPaths = await listPersonas(config.personasDir);
+    const personas = [];
+    // Check for root persona
+    const rootPersona = await loadRootPersona(config.agentsDir);
+    if (rootPersona) {
+        personas.push({
+            name: "root",
+            description: rootPersona.description,
+        });
+    }
+    for (const personaPath of personaPaths) {
+        try {
+            const persona = await loadPersona(personaPath);
+            // Skip _project if root persona came from there (avoid duplicate)
+            const relPath = relative(config.personasDir, personaPath);
+            if (relPath === "_project" && rootPersona?.path === personaPath) {
+                continue;
+            }
+            personas.push({
+                name: relPath,
+                description: persona.description,
+            });
+        }
+        catch {
+            // Skip invalid personas
+        }
+    }
+    // List workflows
+    const workflowPaths = await listWorkflows(config.workflowsDir);
+    const workflows = [];
+    for (const workflowPath of workflowPaths) {
+        try {
+            const workflow = await loadWorkflow(workflowPath);
+            workflows.push({
+                name: workflow.name,
+                description: workflow.description,
+            });
+        }
+        catch {
+            // Skip invalid workflows
+        }
+    }
+    // List channels
+    const channelList = await listChannels(config.channelsDir);
+    const channels = channelList.map((c) => ({
+        name: c.name,
+    }));
+    return {
+        currentTime: new Date(),
+        projectName,
+        daemonRunning: daemonStatus.running,
+        daemonPid: daemonStatus.pid,
+        registeredProjects,
+        personas,
+        workflows,
+        channels,
+    };
+}
+/**
+ * Format a list of items with length management.
+ *
+ * | Items | Behavior |
+ * |-------|----------|
+ * | ≤ 10 | Include full list with descriptions |
+ * | 11-25 | Include names only, no descriptions |
+ * | > 25 | Truncate + "Run `dot-agents list X` for full list" |
+ */
+function formatList(items, itemType) {
+    if (items.length === 0) {
+        return "(none)";
+    }
+    const count = items.length;
+    const lines = [];
+    if (count <= NAMES_ONLY_THRESHOLD) {
+        // Full list with descriptions
+        for (const item of items) {
+            if (item.description) {
+                lines.push(`- ${item.name} - ${item.description}`);
+            }
+            else {
+                lines.push(`- ${item.name}`);
+            }
+        }
+    }
+    else if (count <= TRUNCATE_THRESHOLD) {
+        // Names only, no descriptions
+        for (const item of items) {
+            lines.push(`- ${item.name}`);
+        }
+    }
+    else {
+        // Truncate and show first 10, then hint
+        for (let i = 0; i < 10; i++) {
+            lines.push(`- ${items[i].name}`);
+        }
+        lines.push(`- ... and ${count - 10} more`);
+        lines.push(`Run \`npx dot-agents list ${itemType}\` for full list`);
+    }
+    return lines.join("\n");
+}
+/**
+ * Format environment context as markdown for injection into persona prompt.
+ *
+ * Example output:
+ * ```markdown
+ * ## Your Environment
+ *
+ * **Project:** docs (registered as @docs) ○ daemon stopped
+ *
+ * **Personas:** (3)
+ * - dottie - Executive assistant
+ * - researcher - Deep research with web search
+ * - handyman - Routine maintenance fixes
+ *
+ * **Workflows:** (2)
+ * - process-inbox - Process inbox files
+ * - daily-review - Review daily sessions
+ *
+ * **Channels:** (4)
+ * #sessions, #issues, #journals, @human
+ *
+ * **Other Registered Projects:** (2)
+ * - @dot-agents ○ daemon stopped
+ * - @scoutos ● daemon running (pid 12345)
+ * ```
+ */
+export function formatEnvironmentContext(context) {
+    const lines = [];
+    lines.push("## Your Environment");
+    lines.push("");
+    // Current time with day of week
+    const dateOptions = {
+        weekday: "long",
+        year: "numeric",
+        month: "long",
+        day: "numeric",
+        hour: "numeric",
+        minute: "2-digit",
+        timeZoneName: "short",
+    };
+    const formattedTime = context.currentTime.toLocaleString(undefined, dateOptions);
+    lines.push(`**Current Time:** ${formattedTime}`);
+    lines.push("");
+    // Project info with daemon status
+    const daemonIndicator = context.daemonRunning
+        ? `● daemon running${context.daemonPid ? ` (pid ${context.daemonPid})` : ""}`
+        : "○ daemon stopped";
+    if (context.projectName) {
+        lines.push(`**Project:** ${context.projectName} (registered as @${context.projectName}) ${daemonIndicator}`);
+    }
+    else {
+        lines.push(`**Project:** (not registered) ${daemonIndicator}`);
+    }
+    lines.push("");
+    // Personas
+    lines.push(`**Personas:** (${context.personas.length})`);
+    lines.push(formatList(context.personas, "personas"));
+    lines.push("");
+    // Workflows
+    lines.push(`**Workflows:** (${context.workflows.length})`);
+    lines.push(formatList(context.workflows, "workflows"));
+    lines.push("");
+    // Channels - format inline if short, otherwise as list
+    lines.push(`**Channels:** (${context.channels.length})`);
+    if (context.channels.length === 0) {
+        lines.push("(none)");
+    }
+    else if (context.channels.length <= 10) {
+        // Inline format for short lists
+        lines.push(context.channels.map((c) => c.name).join(", "));
+    }
+    else {
+        lines.push(formatList(context.channels, "channels"));
+    }
+    lines.push("");
+    // Registered projects (other projects you can communicate with)
+    const otherProjects = context.registeredProjects.filter((p) => p.name !== context.projectName);
+    if (otherProjects.length > 0) {
+        lines.push(`**Other Registered Projects:** (${otherProjects.length})`);
+        for (const project of otherProjects) {
+            const daemonStatus = project.daemonRunning
+                ? `● daemon running${project.daemonPid ? ` (pid ${project.daemonPid})` : ""}`
+                : "○ daemon stopped";
+            lines.push(`- @${project.name} ${daemonStatus}`);
+        }
+    }
+    return lines.join("\n");
+}
+/**
+ * Build and format environment context as markdown.
+ * Convenience function that combines buildEnvironmentContext and formatEnvironmentContext.
+ */
+export async function getEnvironmentContextMarkdown(config) {
+    const context = await buildEnvironmentContext(config);
+    return formatEnvironmentContext(context);
+}
+//# sourceMappingURL=environment.js.map

package/dist/lib/environment.js.map

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

package/dist/lib/frontmatter.d.ts

@@ -7,6 +7,10 @@ export interface ParsedMarkdown<T> {
     /** Markdown body content (after frontmatter) */
     body: string;
 }
+/**
+ * Check if content has YAML frontmatter
+ */
+export declare function hasFrontmatter(content: string): boolean;
 /**
  * Parse YAML frontmatter from a markdown file
  */
@@ -15,4 +19,8 @@ export declare function parseFrontmatter<T>(content: string): ParsedMarkdown<T>;
  * Load and parse a markdown file with YAML frontmatter
  */
 export declare function loadMarkdownFile<T>(filePath: string): Promise<ParsedMarkdown<T>>;
+/**
+ * Stringify frontmatter and body back to markdown format
+ */
+export declare function stringifyFrontmatter<T>(frontmatter: T, body: string): string;
 //# sourceMappingURL=frontmatter.d.ts.map

package/dist/lib/frontmatter.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"frontmatter.d.ts","sourceRoot":"","sources":["../../src/lib/frontmatter.ts"],"names":[],"mappings":"AAGA;;GAEG;AACH,MAAM,WAAW,cAAc,CAAC,CAAC;IAC/B,8BAA8B;IAC9B,WAAW,EAAE,CAAC,CAAC;IACf,gDAAgD;IAChD,IAAI,EAAE,MAAM,CAAC;CACd;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,CAAC,EAAE,OAAO,EAAE,MAAM,GAAG,cAAc,CAAC,CAAC,CAAC,CAetE;AAED;;GAEG;AACH,wBAAsB,gBAAgB,CAAC,CAAC,EACtC,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC,CAG5B"}
+{"version":3,"file":"frontmatter.d.ts","sourceRoot":"","sources":["../../src/lib/frontmatter.ts"],"names":[],"mappings":"AAKA;;GAEG;AACH,MAAM,WAAW,cAAc,CAAC,CAAC;IAC/B,8BAA8B;IAC9B,WAAW,EAAE,CAAC,CAAC;IACf,gDAAgD;IAChD,IAAI,EAAE,MAAM,CAAC;CACd;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAEvD;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,CAAC,EAAE,OAAO,EAAE,MAAM,GAAG,cAAc,CAAC,CAAC,CAAC,CActE;AAED;;GAEG;AACH,wBAAsB,gBAAgB,CAAC,CAAC,EACtC,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC,CAG5B;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,CAAC,EAAE,WAAW,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAG5E"}

package/dist/lib/frontmatter.js

@@ -1,11 +1,17 @@
 import { readFile } from "node:fs/promises";
-import { parse as parseYaml } from "yaml";
+import { parse as parseYaml, stringify as stringifyYaml } from "yaml";
+const FRONTMATTER_REGEX = /^---\r?\n([\s\S]*?)\r?\n---\r?\n?([\s\S]*)$/;
+/**
+ * Check if content has YAML frontmatter
+ */
+export function hasFrontmatter(content) {
+    return FRONTMATTER_REGEX.test(content);
+}
 /**
  * Parse YAML frontmatter from a markdown file
  */
 export function parseFrontmatter(content) {
-    const frontmatterRegex = /^---\r?\n([\s\S]*?)\r?\n---\r?\n?([\s\S]*)$/;
-    const match = content.match(frontmatterRegex);
+    const match = content.match(FRONTMATTER_REGEX);
     if (!match) {
         throw new Error("No YAML frontmatter found");
     }
@@ -23,4 +29,11 @@ export async function loadMarkdownFile(filePath) {
     const content = await readFile(filePath, "utf-8");
     return parseFrontmatter(content);
 }
+/**
+ * Stringify frontmatter and body back to markdown format
+ */
+export function stringifyFrontmatter(frontmatter, body) {
+    const yamlContent = stringifyYaml(frontmatter, { indent: 2 }).trim();
+    return `---\n${yamlContent}\n---\n\n${body}`;
+}
 //# sourceMappingURL=frontmatter.js.map

package/dist/lib/frontmatter.js.map

@@ -1 +1 @@
-{"version":3,"file":"frontmatter.js","sourceRoot":"","sources":["../../src/lib/frontmatter.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAC5C,OAAO,EAAE,KAAK,IAAI,SAAS,EAAE,MAAM,MAAM,CAAC;AAY1C;;GAEG;AACH,MAAM,UAAU,gBAAgB,CAAI,OAAe;IACjD,MAAM,gBAAgB,GAAG,6CAA6C,CAAC;IACvE,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,gBAAgB,CAAC,CAAC;IAE9C,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,MAAM,IAAI,KAAK,CAAC,2BAA2B,CAAC,CAAC;IAC/C,CAAC;IAED,MAAM,CAAC,EAAE,WAAW,EAAE,IAAI,CAAC,GAAG,KAAK,CAAC;IACpC,MAAM,WAAW,GAAG,SAAS,CAAC,WAAW,CAAM,CAAC;IAEhD,OAAO;QACL,WAAW;QACX,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE;KAClB,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,gBAAgB,CACpC,QAAgB;IAEhB,MAAM,OAAO,GAAG,MAAM,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;IAClD,OAAO,gBAAgB,CAAI,OAAO,CAAC,CAAC;AACtC,CAAC"}
+{"version":3,"file":"frontmatter.js","sourceRoot":"","sources":["../../src/lib/frontmatter.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAC5C,OAAO,EAAE,KAAK,IAAI,SAAS,EAAE,SAAS,IAAI,aAAa,EAAE,MAAM,MAAM,CAAC;AAEtE,MAAM,iBAAiB,GAAG,6CAA6C,CAAC;AAYxE;;GAEG;AACH,MAAM,UAAU,cAAc,CAAC,OAAe;IAC5C,OAAO,iBAAiB,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;AACzC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,gBAAgB,CAAI,OAAe;IACjD,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,iBAAiB,CAAC,CAAC;IAE/C,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,MAAM,IAAI,KAAK,CAAC,2BAA2B,CAAC,CAAC;IAC/C,CAAC;IAED,MAAM,CAAC,EAAE,WAAW,EAAE,IAAI,CAAC,GAAG,KAAK,CAAC;IACpC,MAAM,WAAW,GAAG,SAAS,CAAC,WAAW,CAAM,CAAC;IAEhD,OAAO;QACL,WAAW;QACX,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE;KAClB,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,gBAAgB,CACpC,QAAgB;IAEhB,MAAM,OAAO,GAAG,MAAM,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;IAClD,OAAO,gBAAgB,CAAI,OAAO,CAAC,CAAC;AACtC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,oBAAoB,CAAI,WAAc,EAAE,IAAY;IAClE,MAAM,WAAW,GAAG,aAAa,CAAC,WAAW,EAAE,EAAE,MAAM,EAAE,CAAC,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;IACrE,OAAO,QAAQ,WAAW,YAAY,IAAI,EAAE,CAAC;AAC/C,CAAC"}

package/dist/lib/index.d.ts

@@ -5,6 +5,13 @@ export * from "./workflow.js";
 export * from "./variables.js";
 export * from "./config.js";
 export * from "./channel.js";
+export * from "./registry.js";
 export * from "./version.js";
+export * from "./session.js";
+export * from "./session-thread.js";
+export * from "./invoke.js";
+export * from "./processor.js";
+export * from "./environment.js";
+export * from "./daemon-status.js";
 export * from "./validation/index.js";
 //# sourceMappingURL=index.d.ts.map

package/dist/lib/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/lib/index.ts"],"names":[],"mappings":"AACA,cAAc,kBAAkB,CAAC;AAGjC,cAAc,kBAAkB,CAAC;AACjC,cAAc,cAAc,CAAC;AAC7B,cAAc,eAAe,CAAC;AAC9B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,aAAa,CAAC;AAC5B,cAAc,cAAc,CAAC;AAC7B,cAAc,cAAc,CAAC;AAG7B,cAAc,uBAAuB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/lib/index.ts"],"names":[],"mappings":"AACA,cAAc,kBAAkB,CAAC;AAGjC,cAAc,kBAAkB,CAAC;AACjC,cAAc,cAAc,CAAC;AAC7B,cAAc,eAAe,CAAC;AAC9B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,aAAa,CAAC;AAC5B,cAAc,cAAc,CAAC;AAC7B,cAAc,eAAe,CAAC;AAC9B,cAAc,cAAc,CAAC;AAC7B,cAAc,cAAc,CAAC;AAC7B,cAAc,qBAAqB,CAAC;AACpC,cAAc,aAAa,CAAC;AAC5B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,kBAAkB,CAAC;AACjC,cAAc,oBAAoB,CAAC;AAGnC,cAAc,uBAAuB,CAAC"}

package/dist/lib/index.js

@@ -7,7 +7,14 @@ export * from "./workflow.js";
 export * from "./variables.js";
 export * from "./config.js";
 export * from "./channel.js";
+export * from "./registry.js";
 export * from "./version.js";
+export * from "./session.js";
+export * from "./session-thread.js";
+export * from "./invoke.js";
+export * from "./processor.js";
+export * from "./environment.js";
+export * from "./daemon-status.js";
 // Validation
 export * from "./validation/index.js";
 //# sourceMappingURL=index.js.map

package/dist/lib/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/lib/index.ts"],"names":[],"mappings":"AAAA,QAAQ;AACR,cAAc,kBAAkB,CAAC;AAEjC,oBAAoB;AACpB,cAAc,kBAAkB,CAAC;AACjC,cAAc,cAAc,CAAC;AAC7B,cAAc,eAAe,CAAC;AAC9B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,aAAa,CAAC;AAC5B,cAAc,cAAc,CAAC;AAC7B,cAAc,cAAc,CAAC;AAE7B,aAAa;AACb,cAAc,uBAAuB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/lib/index.ts"],"names":[],"mappings":"AAAA,QAAQ;AACR,cAAc,kBAAkB,CAAC;AAEjC,oBAAoB;AACpB,cAAc,kBAAkB,CAAC;AACjC,cAAc,cAAc,CAAC;AAC7B,cAAc,eAAe,CAAC;AAC9B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,aAAa,CAAC;AAC5B,cAAc,cAAc,CAAC;AAC7B,cAAc,eAAe,CAAC;AAC9B,cAAc,cAAc,CAAC;AAC7B,cAAc,cAAc,CAAC;AAC7B,cAAc,qBAAqB,CAAC;AACpC,cAAc,aAAa,CAAC;AAC5B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,kBAAkB,CAAC;AACjC,cAAc,oBAAoB,CAAC;AAEnC,aAAa;AACb,cAAc,uBAAuB,CAAC"}

package/dist/lib/invoke.d.ts

@@ -0,0 +1,31 @@
+import { type DotAgentsConfig, type ExecutionResult } from "./index.js";
+/**
+ * Execution mode for persona invocation
+ */
+export type ExecutionMode = "headless" | "interactive";
+/**
+ * Options for invoking a persona directly
+ */
+export interface InvokePersonaOptions {
+    /** Extra context variables to include */
+    context?: Record<string, string>;
+    /** Source of the invocation (e.g., DM channel name) */
+    source?: string;
+    /** Goal description for the session */
+    goal?: string;
+    /** Timeout in milliseconds (default: 10 minutes) */
+    timeoutMs?: number;
+    /** Execution mode: headless (default) or interactive */
+    mode?: ExecutionMode;
+    /** Stream stdout/stderr to console for visibility */
+    verbose?: boolean;
+}
+/**
+ * Invoke a persona directly with a message (no workflow required)
+ *
+ * This is the shared implementation used by:
+ * - daemon/lib/executor.ts for DM-triggered invocations
+ * - lib/processor.ts for one-shot channel processing
+ */
+export declare function invokePersona(config: DotAgentsConfig, personaName: string, message: string, options?: InvokePersonaOptions): Promise<ExecutionResult>;
+//# sourceMappingURL=invoke.d.ts.map

package/dist/lib/invoke.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"invoke.d.ts","sourceRoot":"","sources":["../../src/lib/invoke.ts"],"names":[],"mappings":"AAGA,OAAO,EACL,KAAK,eAAe,EACpB,KAAK,eAAe,EAOrB,MAAM,YAAY,CAAC;AAGpB;;GAEG;AACH,MAAM,MAAM,aAAa,GAAG,UAAU,GAAG,aAAa,CAAC;AAEvD;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,yCAAyC;IACzC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,uDAAuD;IACvD,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,uCAAuC;IACvC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,oDAAoD;IACpD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,wDAAwD;IACxD,IAAI,CAAC,EAAE,aAAa,CAAC;IACrB,qDAAqD;IACrD,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED;;;;;;GAMG;AACH,wBAAsB,aAAa,CACjC,MAAM,EAAE,eAAe,EACvB,WAAW,EAAE,MAAM,EACnB,OAAO,EAAE,MAAM,EACf,OAAO,GAAE,oBAAyB,GACjC,OAAO,CAAC,eAAe,CAAC,CAgM1B"}

package/dist/lib/invoke.js

@@ -0,0 +1,170 @@
+import { join } from "node:path";
+import { hostname } from "node:os";
+import { execa } from "execa";
+import { resolvePersona, createExecutionContext, processTemplate, expandVariables, createSession, finalizeSession, } from "./index.js";
+import { getEnvironmentContextMarkdown } from "./environment.js";
+/**
+ * Invoke a persona directly with a message (no workflow required)
+ *
+ * This is the shared implementation used by:
+ * - daemon/lib/executor.ts for DM-triggered invocations
+ * - lib/processor.ts for one-shot channel processing
+ */
+export async function invokePersona(config, personaName, message, options = {}) {
+    const startedAt = new Date();
+    const { context: extraContext = {}, source = "dm", goal = `DM invocation: ${personaName}`, timeoutMs = 10 * 60 * 1000, mode = "headless", verbose = false, } = options;
+    // Resolve persona path - handle root persona specially
+    const personaPath = personaName === "root"
+        ? config.agentsDir
+        : join(config.personasDir, personaName);
+    const persona = await resolvePersona(personaPath, config.personasDir);
+    // Create session for DM invocation
+    const session = await createSession({
+        sessionsDir: config.sessionsDir,
+        runtime: {
+            hostname: hostname(),
+            executionMode: mode,
+            triggerType: "dm",
+            workingDir: config.agentsDir,
+        },
+        goal,
+        persona: {
+            name: persona.name,
+            inheritanceChain: persona.inheritanceChain,
+        },
+    });
+    const context = createExecutionContext({
+        PERSONA_NAME: persona.name,
+        PERSONA_DIR: persona.path,
+        AGENTS_DIR: config.agentsDir,
+        SESSION_DIR: session.path,
+        INVOCATION_SOURCE: source,
+        ...extraContext,
+    });
+    // Merge environment
+    // Include FROM_ADDRESS, FROM_CHANNEL, FROM_THREAD from context if provided
+    const env = {
+        ...process.env,
+        ...persona.env,
+        DOT_AGENTS_PERSONA: persona.name,
+        DOT_AGENTS_INVOCATION: "dm",
+        // Pass session env vars from legacy session
+        SESSION_DIR: session.path,
+        // Pass callback routing from context (for cross-project delegation)
+        ...(extraContext.FROM_ADDRESS && { FROM_ADDRESS: extraContext.FROM_ADDRESS }),
+        ...(extraContext.FROM_CHANNEL && { FROM_CHANNEL: extraContext.FROM_CHANNEL }),
+        ...(extraContext.FROM_THREAD && { FROM_THREAD: extraContext.FROM_THREAD }),
+    };
+    for (const [key, value] of Object.entries(env)) {
+        if (value) {
+            env[key] = expandVariables(value, context, env);
+        }
+    }
+    // Build prompt: persona prompt + environment context + message
+    const parts = [];
+    if (persona.prompt) {
+        const expandedPrompt = processTemplate(persona.prompt, context, persona.env);
+        parts.push(expandedPrompt);
+        parts.push("\n---\n");
+    }
+    // Inject environment discovery context
+    const environmentContext = await getEnvironmentContextMarkdown(config);
+    parts.push(environmentContext);
+    parts.push("\n---\n");
+    parts.push(`You received a direct message:\n\n${message}`);
+    const prompt = parts.join("\n");
+    // Use commands based on mode
+    const cmds = mode === "interactive" ? persona.commands.interactive : persona.commands.headless;
+    if (!cmds) {
+        const endedAt = new Date();
+        const result = {
+            success: false,
+            exitCode: 1,
+            stdout: "",
+            stderr: `Persona '${persona.name}' does not support ${mode} mode`,
+            duration: endedAt.getTime() - startedAt.getTime(),
+            runId: context.RUN_ID,
+            startedAt,
+            endedAt,
+            error: `Persona does not support ${mode} mode`,
+        };
+        await finalizeSession(session, {
+            success: result.success,
+            exitCode: result.exitCode,
+            duration: result.duration,
+            error: result.error,
+            stderr: result.stderr,
+        });
+        return result;
+    }
+    // Try each command
+    let lastError = null;
+    let result = null;
+    for (const cmd of cmds) {
+        try {
+            const expandedCmd = expandVariables(cmd, context, env);
+            const [command, ...args] = expandedCmd.split(/\s+/);
+            // Execute with appropriate stdio based on verbose mode
+            const execResult = verbose
+                ? await execa(command, args, {
+                    input: prompt,
+                    cwd: config.agentsDir,
+                    env,
+                    timeout: timeoutMs,
+                    reject: false,
+                    stdout: "inherit",
+                    stderr: "inherit",
+                })
+                : await execa(command, args, {
+                    input: prompt,
+                    cwd: config.agentsDir,
+                    env,
+                    timeout: timeoutMs,
+                    reject: false,
+                });
+            const endedAt = new Date();
+            result = {
+                success: execResult.exitCode === 0,
+                exitCode: execResult.exitCode ?? 1,
+                stdout: verbose ? "" : execResult.stdout || "",
+                stderr: verbose ? "" : execResult.stderr || "",
+                duration: endedAt.getTime() - startedAt.getTime(),
+                runId: context.RUN_ID,
+                startedAt,
+                endedAt,
+            };
+            if (result.success)
+                break;
+            const stderrStr = verbose ? "" : execResult.stderr || "";
+            lastError = new Error(`Command failed with exit code ${result.exitCode}${stderrStr ? `: ${stderrStr}` : ""}`);
+        }
+        catch (error) {
+            lastError = error;
+        }
+    }
+    if (!result) {
+        const endedAt = new Date();
+        result = {
+            success: false,
+            exitCode: 1,
+            stdout: "",
+            stderr: lastError?.message ?? "All commands failed",
+            duration: endedAt.getTime() - startedAt.getTime(),
+            runId: context.RUN_ID,
+            startedAt,
+            endedAt,
+            error: lastError?.message,
+        };
+    }
+    // Finalize session
+    await finalizeSession(session, {
+        success: result.success,
+        exitCode: result.exitCode,
+        duration: result.duration,
+        error: result.error,
+        stdout: result.stdout,
+        stderr: result.stderr,
+    });
+    return result;
+}
+//# sourceMappingURL=invoke.js.map

package/dist/lib/invoke.js.map

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

package/dist/lib/persona.d.ts

@@ -17,6 +17,10 @@ export declare function getInternalSkillsPath(): string;
  * Resolve cmd field to ResolvedCommands structure
  */
 export declare function resolveCommands(cmd: CommandSpec | CommandModes | undefined): ResolvedCommands;
+/**
+ * Check if a directory contains a PERSONA.md file
+ */
+declare function hasPersonaFile(dirPath: string): Promise<boolean>;
 /**
  * Load a single persona file
  */
@@ -26,6 +30,18 @@ export declare function loadPersona(personaPath: string): Promise<Persona>;
  * Returns null if not found (graceful degradation)
  */
 export declare function loadInternalBase(): Promise<Persona | null>;
+/**
+ * Load the project's _project persona if it exists
+ * Returns null if not found (graceful degradation)
+ * @deprecated Use loadRootPersona() instead
+ */
+export declare function loadProjectBase(personasRoot: string): Promise<Persona | null>;
+/**
+ * Load the root persona from .agents/PERSONA.md if it exists
+ * Falls back to _project for backwards compatibility
+ * Returns null if neither found
+ */
+export declare function loadRootPersona(agentsRoot: string): Promise<Persona | null>;
 /**
  * Build the inheritance chain for a persona path
  * Returns paths from root to leaf (e.g., ["claude", "claude/autonomous"])
@@ -44,9 +60,14 @@ export declare function deepMerge<T extends Record<string, unknown>>(parent: T,
  * Merge two personas (child inherits from parent)
  */
 export declare function mergePersonas(parent: Persona, child: Persona): Persona;
+/**
+ * Check if a directory contains a PERSONA.md file (exported for use in resolvePersona)
+ */
+export { hasPersonaFile };
 /**
  * Resolve a persona with full inheritance chain
- * Includes implicit inheritance from internal _base persona unless extends: "none"
+ * Uses directory-based inheritance: child inherits from parent directories
+ * Includes implicit inheritance from internal _base persona and root persona
  */
 export declare function resolvePersona(personaPath: string, personasRoot: string): Promise<ResolvedPersona>;
 /**

package/dist/lib/persona.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"persona.d.ts","sourceRoot":"","sources":["../../src/lib/persona.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EACV,OAAO,EAEP,eAAe,EACf,gBAAgB,EAChB,WAAW,EACX,YAAY,EACb,MAAM,oBAAoB,CAAC;AAI5B;;;GAGG;AACH,wBAAgB,uBAAuB,IAAI,MAAM,CAMhD;AAED;;GAEG;AACH,wBAAgB,mBAAmB,IAAI,MAAM,CAE5C;AAED;;;GAGG;AACH,wBAAgB,qBAAqB,IAAI,MAAM,CAM9C;AAsBD;;GAEG;AACH,wBAAgB,eAAe,CAAC,GAAG,EAAE,WAAW,GAAG,YAAY,GAAG,SAAS,GAAG,gBAAgB,CA0B7F;AAeD;;GAEG;AACH,wBAAsB,WAAW,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAoBvE;AAED;;;GAGG;AACH,wBAAsB,gBAAgB,IAAI,OAAO,CAAC,OAAO,GAAG,IAAI,CAAC,CAOhE;AAED;;;GAGG;AACH,wBAAgB,qBAAqB,CACnC,WAAW,EAAE,MAAM,EACnB,YAAY,EAAE,MAAM,GACnB,MAAM,EAAE,CAaV;AAED;;;GAGG;AACH,wBAAgB,uBAAuB,CACrC,MAAM,EAAE,MAAM,EAAE,EAChB,KAAK,EAAE,MAAM,EAAE,GACd,MAAM,EAAE,CAkBV;AAED;;GAEG;AACH,wBAAgB,SAAS,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACzD,MAAM,EAAE,CAAC,EACT,KAAK,EAAE,OAAO,CAAC,CAAC,CAAC,GAChB,CAAC,CA4BH;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE,OAAO,EAAE,KAAK,EAAE,OAAO,GAAG,OAAO,CAkBtE;AAED;;;GAGG;AACH,wBAAsB,cAAc,CAClC,WAAW,EAAE,MAAM,EACnB,YAAY,EAAE,MAAM,GACnB,OAAO,CAAC,eAAe,CAAC,CAqD1B;AAED;;GAEG;AACH,wBAAsB,YAAY,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAuB1E"}
+{"version":3,"file":"persona.d.ts","sourceRoot":"","sources":["../../src/lib/persona.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EACV,OAAO,EAEP,eAAe,EACf,gBAAgB,EAChB,WAAW,EACX,YAAY,EAIb,MAAM,oBAAoB,CAAC;AAM5B;;;GAGG;AACH,wBAAgB,uBAAuB,IAAI,MAAM,CAMhD;AAED;;GAEG;AACH,wBAAgB,mBAAmB,IAAI,MAAM,CAE5C;AAED;;;GAGG;AACH,wBAAgB,qBAAqB,IAAI,MAAM,CAM9C;AAsBD;;GAEG;AACH,wBAAgB,eAAe,CAAC,GAAG,EAAE,WAAW,GAAG,YAAY,GAAG,SAAS,GAAG,gBAAgB,CA0B7F;AAED;;GAEG;AACH,iBAAe,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAQ/D;AA6ED;;GAEG;AACH,wBAAsB,WAAW,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAoBvE;AAED;;;GAGG;AACH,wBAAsB,gBAAgB,IAAI,OAAO,CAAC,OAAO,GAAG,IAAI,CAAC,CAOhE;AAED;;;;GAIG;AACH,wBAAsB,eAAe,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,GAAG,IAAI,CAAC,CAMnF;AAED;;;;GAIG;AACH,wBAAsB,eAAe,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,GAAG,IAAI,CAAC,CAkBjF;AAED;;;GAGG;AACH,wBAAgB,qBAAqB,CACnC,WAAW,EAAE,MAAM,EACnB,YAAY,EAAE,MAAM,GACnB,MAAM,EAAE,CAaV;AAED;;;GAGG;AACH,wBAAgB,uBAAuB,CACrC,MAAM,EAAE,MAAM,EAAE,EAChB,KAAK,EAAE,MAAM,EAAE,GACd,MAAM,EAAE,CAkBV;AAED;;GAEG;AACH,wBAAgB,SAAS,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACzD,MAAM,EAAE,CAAC,EACT,KAAK,EAAE,OAAO,CAAC,CAAC,CAAC,GAChB,CAAC,CA4BH;AAYD;;GAEG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE,OAAO,EAAE,KAAK,EAAE,OAAO,GAAG,OAAO,CAkBtE;AAED;;GAEG;AACH,OAAO,EAAE,cAAc,EAAE,CAAC;AAE1B;;;;GAIG;AACH,wBAAsB,cAAc,CAClC,WAAW,EAAE,MAAM,EACnB,YAAY,EAAE,MAAM,GACnB,OAAO,CAAC,eAAe,CAAC,CAmF1B;AAED;;GAEG;AACH,wBAAsB,YAAY,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAuB1E"}