dot-agents 0.4.1 → 0.6.0

package/dist/lib/environment.d.ts

@@ -0,0 +1,87 @@
+import type { DotAgentsConfig } from "./types/index.js";
+/**
+ * Persona info for environment context
+ */
+interface PersonaInfo {
+    name: string;
+    description?: string;
+}
+/**
+ * Workflow info for environment context
+ */
+interface WorkflowInfo {
+    name: string;
+    description?: string;
+}
+/**
+ * Channel info for environment context
+ */
+interface ChannelInfo {
+    name: string;
+}
+/**
+ * Registered project info for environment context
+ */
+interface RegisteredProjectInfo {
+    name: string;
+    path: string;
+    daemonRunning: boolean;
+    daemonPid?: number;
+}
+/**
+ * Environment context data
+ */
+export interface EnvironmentContext {
+    projectName: string | null;
+    daemonRunning: boolean;
+    daemonPid?: number;
+    registeredProjects: RegisteredProjectInfo[];
+    personas: PersonaInfo[];
+    workflows: WorkflowInfo[];
+    channels: ChannelInfo[];
+}
+/**
+ * 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 declare function buildEnvironmentContext(config: DotAgentsConfig): Promise<EnvironmentContext>;
+/**
+ * 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 declare function formatEnvironmentContext(context: EnvironmentContext): string;
+/**
+ * Build and format environment context as markdown.
+ * Convenience function that combines buildEnvironmentContext and formatEnvironmentContext.
+ */
+export declare function getEnvironmentContextMarkdown(config: DotAgentsConfig): Promise<string>;
+export {};
+//# sourceMappingURL=environment.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"environment.d.ts","sourceRoot":"","sources":["../../src/lib/environment.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AAYxD;;GAEG;AACH,UAAU,WAAW;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED;;GAEG;AACH,UAAU,YAAY;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED;;GAEG;AACH,UAAU,WAAW;IACnB,IAAI,EAAE,MAAM,CAAC;CACd;AAED;;GAEG;AACH,UAAU,qBAAqB;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,aAAa,EAAE,OAAO,CAAC;IACvB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,aAAa,EAAE,OAAO,CAAC;IACvB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,kBAAkB,EAAE,qBAAqB,EAAE,CAAC;IAC5C,QAAQ,EAAE,WAAW,EAAE,CAAC;IACxB,SAAS,EAAE,YAAY,EAAE,CAAC;IAC1B,QAAQ,EAAE,WAAW,EAAE,CAAC;CACzB;AAED;;;;;;;;;GASG;AACH,wBAAsB,uBAAuB,CAC3C,MAAM,EAAE,eAAe,GACtB,OAAO,CAAC,kBAAkB,CAAC,CAkF7B;AAgDD;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,wBAAgB,wBAAwB,CAAC,OAAO,EAAE,kBAAkB,GAAG,MAAM,CAuD5E;AAED;;;GAGG;AACH,wBAAsB,6BAA6B,CACjD,MAAM,EAAE,eAAe,GACtB,OAAO,CAAC,MAAM,CAAC,CAGjB"}

package/dist/lib/environment.js

@@ -0,0 +1,224 @@
+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 {
+        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("");
+    // 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/frontmatter.test.d.ts

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"frontmatter.test.d.ts","sourceRoot":"","sources":["../../src/lib/frontmatter.test.ts"],"names":[],"mappings":""}

package/dist/lib/frontmatter.test.js

@@ -0,0 +1,60 @@
+import { describe, it } from "node:test";
+import assert from "node:assert";
+import { parseFrontmatter, hasFrontmatter } from "./frontmatter.js";
+describe("parseFrontmatter", () => {
+    it("parses valid frontmatter", () => {
+        const content = `---
+title: Test
+count: 42
+---
+
+Body content here.`;
+        const result = parseFrontmatter(content);
+        assert.deepStrictEqual(result.frontmatter, { title: "Test", count: 42 });
+        assert.strictEqual(result.body, "Body content here.");
+    });
+    it("handles empty body", () => {
+        const content = `---
+key: value
+---
+`;
+        const result = parseFrontmatter(content);
+        assert.deepStrictEqual(result.frontmatter, { key: "value" });
+        assert.strictEqual(result.body, "");
+    });
+    it("throws on missing frontmatter", () => {
+        const content = "Just plain markdown content";
+        assert.throws(() => parseFrontmatter(content), {
+            message: "No YAML frontmatter found",
+        });
+    });
+    it("throws on malformed frontmatter (missing closing)", () => {
+        const content = `---
+title: Test
+No closing delimiter`;
+        assert.throws(() => parseFrontmatter(content), {
+            message: "No YAML frontmatter found",
+        });
+    });
+});
+describe("hasFrontmatter", () => {
+    it("returns true for content with frontmatter", () => {
+        const content = `---
+title: Test
+---
+
+Body`;
+        assert.strictEqual(hasFrontmatter(content), true);
+    });
+    it("returns false for content without frontmatter", () => {
+        const content = "Just plain markdown";
+        assert.strictEqual(hasFrontmatter(content), false);
+    });
+    it("returns false for partial frontmatter", () => {
+        const content = `---
+title: Test
+Missing closing`;
+        assert.strictEqual(hasFrontmatter(content), false);
+    });
+});
+//# sourceMappingURL=frontmatter.test.js.map

package/dist/lib/frontmatter.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"frontmatter.test.js","sourceRoot":"","sources":["../../src/lib/frontmatter.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,WAAW,CAAC;AACzC,OAAO,MAAM,MAAM,aAAa,CAAC;AACjC,OAAO,EAAE,gBAAgB,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAEpE,QAAQ,CAAC,kBAAkB,EAAE,GAAG,EAAE;IAChC,EAAE,CAAC,0BAA0B,EAAE,GAAG,EAAE;QAClC,MAAM,OAAO,GAAG;;;;;mBAKD,CAAC;QAEhB,MAAM,MAAM,GAAG,gBAAgB,CAAmC,OAAO,CAAC,CAAC;QAE3E,MAAM,CAAC,eAAe,CAAC,MAAM,CAAC,WAAW,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC,CAAC;QACzE,MAAM,CAAC,WAAW,CAAC,MAAM,CAAC,IAAI,EAAE,oBAAoB,CAAC,CAAC;IACxD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,oBAAoB,EAAE,GAAG,EAAE;QAC5B,MAAM,OAAO,GAAG;;;CAGnB,CAAC;QAEE,MAAM,MAAM,GAAG,gBAAgB,CAAkB,OAAO,CAAC,CAAC;QAE1D,MAAM,CAAC,eAAe,CAAC,MAAM,CAAC,WAAW,EAAE,EAAE,GAAG,EAAE,OAAO,EAAE,CAAC,CAAC;QAC7D,MAAM,CAAC,WAAW,CAAC,MAAM,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;IACtC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,+BAA+B,EAAE,GAAG,EAAE;QACvC,MAAM,OAAO,GAAG,6BAA6B,CAAC;QAE9C,MAAM,CAAC,MAAM,CAAC,GAAG,EAAE,CAAC,gBAAgB,CAAC,OAAO,CAAC,EAAE;YAC7C,OAAO,EAAE,2BAA2B;SACrC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,mDAAmD,EAAE,GAAG,EAAE;QAC3D,MAAM,OAAO,GAAG;;qBAEC,CAAC;QAElB,MAAM,CAAC,MAAM,CAAC,GAAG,EAAE,CAAC,gBAAgB,CAAC,OAAO,CAAC,EAAE;YAC7C,OAAO,EAAE,2BAA2B;SACrC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC;AAEH,QAAQ,CAAC,gBAAgB,EAAE,GAAG,EAAE;IAC9B,EAAE,CAAC,2CAA2C,EAAE,GAAG,EAAE;QACnD,MAAM,OAAO,GAAG;;;;KAIf,CAAC;QAEF,MAAM,CAAC,WAAW,CAAC,cAAc,CAAC,OAAO,CAAC,EAAE,IAAI,CAAC,CAAC;IACpD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,+CAA+C,EAAE,GAAG,EAAE;QACvD,MAAM,OAAO,GAAG,qBAAqB,CAAC;QAEtC,MAAM,CAAC,WAAW,CAAC,cAAc,CAAC,OAAO,CAAC,EAAE,KAAK,CAAC,CAAC;IACrD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,uCAAuC,EAAE,GAAG,EAAE;QAC/C,MAAM,OAAO,GAAG;;gBAEJ,CAAC;QAEb,MAAM,CAAC,WAAW,CAAC,cAAc,CAAC,OAAO,CAAC,EAAE,KAAK,CAAC,CAAC;IACrD,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/lib/index.d.ts

@@ -5,5 +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;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,6 +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;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/integration.test.d.ts

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

package/dist/lib/integration.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"integration.test.d.ts","sourceRoot":"","sources":["../../src/lib/integration.test.ts"],"names":[],"mappings":""}