@openplaybooks/agentfn 0.2.0

package/dist/compose.js

@@ -0,0 +1,217 @@
+import { getDefaultProvider } from "./provider.js";
+async function loadProvider(pkg) {
+    try {
+        return await import(pkg);
+    }
+    catch {
+        throw new Error(`Provider "${pkg}" is not installed. Install it with: pnpm add ${pkg}`);
+    }
+}
+import { enhancePrompt } from "./prompting.js";
+import { ensureSkillSymlinks, cleanupSkillSymlinks } from "./skills.js";
+import { findConvergeRoot } from "./find-converge-root.js";
+import { join } from "node:path";
+/**
+ * Create a composed function that orchestrates tools via Claude or Kimi.
+ *
+ * Tools created with `agentfn()` can be passed directly. The composition
+ * delegates to the underlying provider's compose implementation.
+ *
+ * @example
+ * ```typescript
+ * const translate = agentfn({ prompt: "Translate {{input}} to French" });
+ * const summarize = agentfn({ prompt: "Summarize {{input}}", provider: "kimi" });
+ *
+ * const fn = compose({
+ *   prompt: "Translate then summarize {{input}}",
+ *   tools: {
+ *     translate: { fn: translate, description: "Translate text" },
+ *     summarize: { fn: summarize, description: "Summarize text" },
+ *   },
+ * });
+ * ```
+ */
+export function compose(options) {
+    const provider = options.provider ?? getDefaultProvider();
+    const useNewSkills = !!options.skillsRoot;
+    const useLegacySkills = !useNewSkills && (options.enableSkills ?? true);
+    if (provider === "kimi") {
+        let fn;
+        return async (input) => {
+            if (!fn) {
+                const mod = await loadProvider("@openplaybooks/kimifn");
+                fn = mod.compose(toKimiComposeOptions(options));
+            }
+            let enhancedInput = input;
+            if (useLegacySkills && input) {
+                enhancedInput = enhancePrompt(input, { cwd: options.cwd });
+            }
+            const result = await fn(enhancedInput);
+            return { ...result, provider: "kimi" };
+        };
+    }
+    if (provider === "qwen") {
+        let fn;
+        return async (input) => {
+            if (!fn) {
+                const mod = await loadProvider("@openplaybooks/qwenfn");
+                fn = mod.compose(toQwenComposeOptions(options));
+            }
+            let enhancedInput = input;
+            if (useLegacySkills && input) {
+                enhancedInput = enhancePrompt(input, { cwd: options.cwd });
+            }
+            const result = await fn(enhancedInput);
+            return { ...result, provider: "qwen" };
+        };
+    }
+    if (provider === "gemini") {
+        let fn;
+        return async (input) => {
+            if (!fn) {
+                const mod = await loadProvider("@openplaybooks/geminifn");
+                fn = mod.compose(toGeminiComposeOptions(options));
+            }
+            let enhancedInput = input;
+            if (useLegacySkills && input) {
+                enhancedInput = enhancePrompt(input, { cwd: options.cwd });
+            }
+            const result = await fn(enhancedInput);
+            return { ...result, provider: "gemini" };
+        };
+    }
+    // Codex provider
+    if (provider === "codex") {
+        let fn;
+        return async (input) => {
+            if (!fn) {
+                const mod = await loadProvider("@openplaybooks/codexfn");
+                fn = mod.compose(toCodexComposeOptions(options));
+            }
+            let enhancedInput = input;
+            if (useLegacySkills && input) {
+                enhancedInput = enhancePrompt(input, { cwd: options.cwd });
+            }
+            const result = await fn(enhancedInput);
+            return { ...result, provider: "codex" };
+        };
+    }
+    // Claude provider — supports symlinks
+    let fn;
+    return async (input) => {
+        if (!fn) {
+            const mod = await loadProvider("@openplaybooks/claudefn");
+            fn = mod.compose(toClaudeComposeOptions(options));
+        }
+        let enhancedInput = input;
+        if (useLegacySkills && input) {
+            enhancedInput = enhancePrompt(input, { cwd: options.cwd });
+        }
+        // Symlink management for new API
+        let createdSymlinks = [];
+        let symlinkTarget;
+        if (useNewSkills && options.skillsRoot) {
+            const baseDir = options.cwd || process.cwd();
+            const projectRoot = findConvergeRoot(baseDir);
+            symlinkTarget = join(projectRoot ?? baseDir, ".claude", "skills");
+            createdSymlinks = ensureSkillSymlinks(options.skillsRoot, {
+                skills: options.skills,
+                targetRoot: symlinkTarget,
+            });
+        }
+        try {
+            const result = await fn(enhancedInput);
+            return { ...result, provider: "claude" };
+        }
+        finally {
+            if (createdSymlinks.length > 0 && symlinkTarget) {
+                cleanupSkillSymlinks(createdSymlinks, symlinkTarget);
+            }
+        }
+    };
+}
+// ─── Options Mapping ─────────────────────────────────────────
+function toClaudeComposeOptions(opts) {
+    return {
+        prompt: opts.prompt,
+        tools: opts.tools,
+        composeMode: opts.composeMode,
+        schema: opts.schema,
+        hooks: opts.hooks,
+        timeoutMs: opts.timeoutMs,
+        maxRetries: opts.maxRetries,
+        maxIterations: opts.maxIterations,
+        cwd: opts.cwd,
+        queue: opts.queue,
+        cliFlags: opts.cliFlags,
+        allowedTools: opts.allowedTools,
+        systemPrompt: opts.systemPrompt,
+        // Deprecated SDK-only options — passed through for backward compat
+        ...(opts.backend && { backend: opts.backend }),
+        ...(opts.model && { model: opts.model }),
+        ...(opts.permissionMode !== undefined && {
+            permissionMode: opts.permissionMode,
+        }),
+    };
+}
+function toKimiComposeOptions(opts) {
+    return {
+        prompt: opts.prompt,
+        tools: opts.tools,
+        composeMode: opts.composeMode,
+        schema: opts.schema,
+        hooks: opts.hooks,
+        timeoutMs: opts.timeoutMs,
+        maxRetries: opts.maxRetries,
+        maxIterations: opts.maxIterations,
+        cwd: opts.cwd,
+        queue: opts.queue,
+        cliFlags: opts.cliFlags,
+    };
+}
+function toQwenComposeOptions(opts) {
+    return {
+        prompt: opts.prompt,
+        tools: opts.tools,
+        composeMode: opts.composeMode,
+        schema: opts.schema,
+        hooks: opts.hooks,
+        timeoutMs: opts.timeoutMs,
+        maxRetries: opts.maxRetries,
+        maxIterations: opts.maxIterations,
+        cwd: opts.cwd,
+        queue: opts.queue,
+        cliFlags: opts.cliFlags,
+    };
+}
+function toGeminiComposeOptions(opts) {
+    return {
+        prompt: opts.prompt,
+        tools: opts.tools,
+        composeMode: opts.composeMode,
+        schema: opts.schema,
+        hooks: opts.hooks,
+        timeoutMs: opts.timeoutMs,
+        maxRetries: opts.maxRetries,
+        maxIterations: opts.maxIterations,
+        cwd: opts.cwd,
+        queue: opts.queue,
+        cliFlags: opts.cliFlags,
+    };
+}
+function toCodexComposeOptions(opts) {
+    return {
+        prompt: opts.prompt,
+        tools: opts.tools,
+        composeMode: opts.composeMode,
+        schema: opts.schema,
+        hooks: opts.hooks,
+        timeoutMs: opts.timeoutMs,
+        maxRetries: opts.maxRetries,
+        maxIterations: opts.maxIterations,
+        cwd: opts.cwd,
+        queue: opts.queue,
+        cliFlags: opts.cliFlags,
+    };
+}
+//# sourceMappingURL=compose.js.map

package/dist/compose.js.map

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

package/dist/feedback.d.ts

@@ -0,0 +1,78 @@
+/**
+ * Agent Feedback — send follow-up messages to a completed agent session.
+ *
+ * Uses the session ID from an initial agentfn() call to resume the
+ * conversation and request structured output (status, summary, errors, etc.).
+ */
+import type { AgentFnResult, Provider } from "./types.js";
+export interface AgentFeedbackOptions {
+    /** Session ID from the original agentfn result */
+    sessionId: string;
+    /** Follow-up prompt to send */
+    prompt: string;
+    /** Which provider was used (only "claude" supports resume) */
+    provider?: Provider;
+    /** Working directory */
+    cwd?: string;
+    /** Max time in ms (default: 120_000) */
+    timeoutMs?: number;
+    /** Extra CLI flags */
+    cliFlags?: string[];
+    /** Allowed tools for the follow-up */
+    allowedTools?: string[];
+}
+/**
+ * Send a follow-up message to an existing agent session.
+ *
+ * This resumes the conversation so the agent has full context from the
+ * initial task execution. Useful for requesting structured completion
+ * reports after a oneshot task finishes.
+ *
+ * @example
+ * ```typescript
+ * const ask = agentfn({ prompt: "Build the component" });
+ * const result = await ask("Create a Button component");
+ *
+ * // Ask for a structured completion report
+ * const report = await agentSendFeedback({
+ *   sessionId: result.sessionId!,
+ *   prompt: TASK_COMPLETION_PROMPT,
+ * });
+ * ```
+ */
+export declare function agentSendFeedback(opts: AgentFeedbackOptions): Promise<AgentFnResult<string>>;
+/**
+ * Standard follow-up prompt for task completion reports.
+ *
+ * Asks the agent to produce a structured XML report with:
+ * - Task status (completed | partial | failed)
+ * - Summary of what was done
+ * - Errors encountered
+ * - Follow-up action suggestions
+ */
+export declare const TASK_COMPLETION_PROMPT = "Now that you have finished the task, provide a structured completion report.\n\nRespond ONLY with the following XML \u2014 no other text before or after:\n\n<task-report>\n  <status>completed | partial | failed</status>\n  <summary>\n    A concise summary of what you did (2-4 sentences).\n    Include key files created or modified.\n  </summary>\n  <errors>\n    List any errors encountered, or \"none\" if everything succeeded.\n    Include error messages and which step they occurred in.\n  </errors>\n  <follow-up-actions>\n    Suggest 1-3 concrete next steps the user should take.\n    Each action should be specific and actionable.\n  </follow-up-actions>\n</task-report>";
+/**
+ * Parse the XML task-report into a structured object.
+ */
+export interface TaskCompletionReport {
+    status: "completed" | "partial" | "failed";
+    summary: string;
+    errors: string;
+    followUpActions: string;
+}
+/**
+ * Parse a task completion report from XML output.
+ * Falls back to raw text if XML parsing fails.
+ */
+export declare function parseTaskReport(raw: string): TaskCompletionReport;
+/**
+ * Format a TaskCompletionReport as a markdown document.
+ */
+export declare function formatReportAsMarkdown(report: TaskCompletionReport, meta?: {
+    taskId?: string;
+    taskTitle?: string;
+    epicTitle?: string;
+    durationMs?: number;
+    timestamp?: string;
+}): string;
+//# sourceMappingURL=feedback.d.ts.map

package/dist/feedback.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"feedback.d.ts","sourceRoot":"","sources":["../src/feedback.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAE1D,MAAM,WAAW,oBAAoB;IACnC,kDAAkD;IAClD,SAAS,EAAE,MAAM,CAAC;IAClB,+BAA+B;IAC/B,MAAM,EAAE,MAAM,CAAC;IACf,8DAA8D;IAC9D,QAAQ,CAAC,EAAE,QAAQ,CAAC;IACpB,wBAAwB;IACxB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,wCAAwC;IACxC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,sBAAsB;IACtB,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,sCAAsC;IACtC,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;CACzB;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAsB,iBAAiB,CACrC,IAAI,EAAE,oBAAoB,GACzB,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,CAAC,CAuChC;AAMD;;;;;;;;GAQG;AACH,eAAO,MAAM,sBAAsB,0qBAkBpB,CAAC;AAEhB;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,MAAM,EAAE,WAAW,GAAG,SAAS,GAAG,QAAQ,CAAC;IAC3C,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,eAAe,EAAE,MAAM,CAAC;CACzB;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAAC,GAAG,EAAE,MAAM,GAAG,oBAAoB,CAmBjE;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CACpC,MAAM,EAAE,oBAAoB,EAC5B,IAAI,CAAC,EAAE;IACL,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,GACA,MAAM,CAuDR"}

package/dist/feedback.js

@@ -0,0 +1,160 @@
+/**
+ * Agent Feedback — send follow-up messages to a completed agent session.
+ *
+ * Uses the session ID from an initial agentfn() call to resume the
+ * conversation and request structured output (status, summary, errors, etc.).
+ */
+/**
+ * Send a follow-up message to an existing agent session.
+ *
+ * This resumes the conversation so the agent has full context from the
+ * initial task execution. Useful for requesting structured completion
+ * reports after a oneshot task finishes.
+ *
+ * @example
+ * ```typescript
+ * const ask = agentfn({ prompt: "Build the component" });
+ * const result = await ask("Create a Button component");
+ *
+ * // Ask for a structured completion report
+ * const report = await agentSendFeedback({
+ *   sessionId: result.sessionId!,
+ *   prompt: TASK_COMPLETION_PROMPT,
+ * });
+ * ```
+ */
+export async function agentSendFeedback(opts) {
+    const provider = opts.provider ?? "claude";
+    if (provider !== "claude") {
+        throw new Error(`agentSendFeedback: resume/feedback is only supported for the "claude" provider, got "${provider}"`);
+    }
+    if (!opts.sessionId) {
+        throw new Error("agentSendFeedback: sessionId is required");
+    }
+    let claudeSendFeedback;
+    try {
+        const mod = await import("@openplaybooks/claudefn");
+        claudeSendFeedback = mod.sendFeedback;
+    }
+    catch {
+        throw new Error(`Provider "@openplaybooks/claudefn" is not installed. Install it with: pnpm add @openplaybooks/claudefn`);
+    }
+    const result = await claudeSendFeedback({
+        sessionId: opts.sessionId,
+        prompt: opts.prompt,
+        cwd: opts.cwd,
+        timeoutMs: opts.timeoutMs,
+        cliFlags: opts.cliFlags,
+        allowedTools: opts.allowedTools,
+    });
+    return {
+        data: result.data,
+        raw: result.raw,
+        durationMs: result.durationMs,
+        provider: "claude",
+        sessionId: opts.sessionId,
+    };
+}
+/* ------------------------------------------------------------------ */
+/*  Standard Feedback Prompts                                         */
+/* ------------------------------------------------------------------ */
+/**
+ * Standard follow-up prompt for task completion reports.
+ *
+ * Asks the agent to produce a structured XML report with:
+ * - Task status (completed | partial | failed)
+ * - Summary of what was done
+ * - Errors encountered
+ * - Follow-up action suggestions
+ */
+export const TASK_COMPLETION_PROMPT = `Now that you have finished the task, provide a structured completion report.
+
+Respond ONLY with the following XML — no other text before or after:
+
+<task-report>
+  <status>completed | partial | failed</status>
+  <summary>
+    A concise summary of what you did (2-4 sentences).
+    Include key files created or modified.
+  </summary>
+  <errors>
+    List any errors encountered, or "none" if everything succeeded.
+    Include error messages and which step they occurred in.
+  </errors>
+  <follow-up-actions>
+    Suggest 1-3 concrete next steps the user should take.
+    Each action should be specific and actionable.
+  </follow-up-actions>
+</task-report>`;
+/**
+ * Parse a task completion report from XML output.
+ * Falls back to raw text if XML parsing fails.
+ */
+export function parseTaskReport(raw) {
+    const extract = (tag) => {
+        const match = raw.match(new RegExp(`<${tag}>([\\s\\S]*?)</${tag}>`));
+        return match ? match[1].trim() : "";
+    };
+    const statusRaw = extract("status");
+    const status = (["completed", "partial", "failed"].includes(statusRaw)
+        ? statusRaw
+        : "partial");
+    return {
+        status,
+        summary: extract("summary") || raw.slice(0, 500),
+        errors: extract("errors") || "none",
+        followUpActions: extract("follow-up-actions") || "none",
+    };
+}
+/**
+ * Format a TaskCompletionReport as a markdown document.
+ */
+export function formatReportAsMarkdown(report, meta) {
+    const lines = [];
+    // Header
+    const title = meta?.taskTitle || "Task Completion Report";
+    lines.push(`# ${title}`);
+    lines.push("");
+    // Metadata
+    if (meta) {
+        lines.push("## Metadata");
+        lines.push("");
+        if (meta.taskId)
+            lines.push(`- **Task ID:** ${meta.taskId}`);
+        if (meta.epicTitle)
+            lines.push(`- **Epic:** ${meta.epicTitle}`);
+        if (meta.durationMs)
+            lines.push(`- **Duration:** ${(meta.durationMs / 1000).toFixed(1)}s`);
+        lines.push(`- **Timestamp:** ${meta.timestamp || new Date().toISOString()}`);
+        lines.push("");
+    }
+    // Status
+    const statusEmoji = report.status === "completed"
+        ? "DONE"
+        : report.status === "partial"
+            ? "PARTIAL"
+            : "FAILED";
+    lines.push(`## Status: ${statusEmoji}`);
+    lines.push("");
+    // Summary
+    lines.push("## Summary");
+    lines.push("");
+    lines.push(report.summary);
+    lines.push("");
+    // Errors
+    if (report.errors && report.errors !== "none") {
+        lines.push("## Errors");
+        lines.push("");
+        lines.push(report.errors);
+        lines.push("");
+    }
+    // Follow-up Actions
+    if (report.followUpActions && report.followUpActions !== "none") {
+        lines.push("## Follow-up Actions");
+        lines.push("");
+        lines.push(report.followUpActions);
+        lines.push("");
+    }
+    return lines.join("\n");
+}
+//# sourceMappingURL=feedback.js.map

package/dist/feedback.js.map

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

package/dist/find-converge-root.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Project root = nearest ancestor (or self) containing `.converge/`.
+ * Returns null if no such ancestor exists.
+ */
+export declare function findConvergeRoot(startDir: string): string | null;
+//# sourceMappingURL=find-converge-root.d.ts.map

package/dist/find-converge-root.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"find-converge-root.d.ts","sourceRoot":"","sources":["../src/find-converge-root.ts"],"names":[],"mappings":"AAGA;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAQhE"}

package/dist/find-converge-root.js

@@ -0,0 +1,18 @@
+import { existsSync } from "node:fs";
+import { dirname, join, resolve } from "node:path";
+/**
+ * Project root = nearest ancestor (or self) containing `.converge/`.
+ * Returns null if no such ancestor exists.
+ */
+export function findConvergeRoot(startDir) {
+    let dir = resolve(startDir);
+    while (true) {
+        if (existsSync(join(dir, ".converge")))
+            return dir;
+        const parent = dirname(dir);
+        if (parent === dir)
+            return null;
+        dir = parent;
+    }
+}
+//# sourceMappingURL=find-converge-root.js.map

package/dist/find-converge-root.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"find-converge-root.js","sourceRoot":"","sources":["../src/find-converge-root.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AACrC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEnD;;;GAGG;AACH,MAAM,UAAU,gBAAgB,CAAC,QAAgB;IAC/C,IAAI,GAAG,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAC;IAC5B,OAAO,IAAI,EAAE,CAAC;QACZ,IAAI,UAAU,CAAC,IAAI,CAAC,GAAG,EAAE,WAAW,CAAC,CAAC;YAAE,OAAO,GAAG,CAAC;QACnD,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC;QAC5B,IAAI,MAAM,KAAK,GAAG;YAAE,OAAO,IAAI,CAAC;QAChC,GAAG,GAAG,MAAM,CAAC;IACf,CAAC;AACH,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,14 @@
+export { agentfn } from "./agentfn.js";
+export { agentSendFeedback, TASK_COMPLETION_PROMPT, parseTaskReport, formatReportAsMarkdown, } from "./feedback.js";
+export type { AgentFeedbackOptions, TaskCompletionReport } from "./feedback.js";
+export { compose } from "./compose.js";
+export { agent } from "./agent.js";
+export type { UnifiedAgentOptions, AgentFn as AgentAgentFn } from "./agent.js";
+export { getDefaultProvider, setDefaultProvider } from "./provider.js";
+export { enhancePrompt, listSkills, listAgents } from "./prompting.js";
+export type { EnhancePromptOptions } from "./prompting.js";
+export { discoverSkills, loadSkill, loadSkillFromRoots, parseFrontmatter, stripFrontmatter, ensureSkillSymlinks, cleanupSkillSymlinks, discoverAgents, getSkillPath, getSkillMeta, getAgentPath, getAgentMeta, } from "./skills.js";
+export type { SkillInfo, SkillContent, SymlinkOptions } from "./skills.js";
+export { parseToolCalls as acpParseToolCalls, buildToolPreamble as acpBuildToolPreamble, buildCodePreamble as acpBuildCodePreamble, extractCode as acpExtractCode, executeCode as acpExecuteCode, } from "@openplaybooks/acpfn";
+export type { Provider, AgentFnHooks, AgentFnResult, AgentFn, AgentFnOptions, ToolDef, ComposeHooks, ComposeOptions, PromptInput, ExecutionMode, Backend, PermissionMode, SessionEvent, Session, StreamCallOptions, StreamFn, AgentResult, AgentHooks, ClaudeAgentOptions, McpServerConfig, AgentDefinition, ClaudeFnOptions, ClaudeFnResult, ClaudeFn, KimiFnOptions, KimiFnResult, KimiFn, QwenFnOptions, QwenFnResult, QwenFn, GeminiFnOptions, GeminiFnResult, GeminiFn, AcpFnOptions, AcpFnResult, AcpFn, OpenFnOptions, OpenFnResult, OpenFn, GlobalQueueOptions, } from "./types.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAGvC,OAAO,EACL,iBAAiB,EACjB,sBAAsB,EACtB,eAAe,EACf,sBAAsB,GACvB,MAAM,eAAe,CAAC;AACvB,YAAY,EAAE,oBAAoB,EAAE,oBAAoB,EAAE,MAAM,eAAe,CAAC;AAGhF,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAGvC,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AACnC,YAAY,EAAE,mBAAmB,EAAE,OAAO,IAAI,YAAY,EAAE,MAAM,YAAY,CAAC;AAG/E,OAAO,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC;AAGvE,OAAO,EAAE,aAAa,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AACvE,YAAY,EAAE,oBAAoB,EAAE,MAAM,gBAAgB,CAAC;AAG3D,OAAO,EAEL,cAAc,EACd,SAAS,EACT,kBAAkB,EAClB,gBAAgB,EAChB,gBAAgB,EAChB,mBAAmB,EACnB,oBAAoB,EAEpB,cAAc,EAEd,YAAY,EACZ,YAAY,EACZ,YAAY,EACZ,YAAY,GACb,MAAM,aAAa,CAAC;AACrB,YAAY,EAAE,SAAS,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAG3E,OAAO,EACL,cAAc,IAAI,iBAAiB,EACnC,iBAAiB,IAAI,oBAAoB,EACzC,iBAAiB,IAAI,oBAAoB,EACzC,WAAW,IAAI,cAAc,EAC7B,WAAW,IAAI,cAAc,GAC9B,MAAM,sBAAsB,CAAC;AAG9B,YAAY,EAEV,QAAQ,EAER,YAAY,EACZ,aAAa,EACb,OAAO,EACP,cAAc,EACd,OAAO,EACP,YAAY,EACZ,cAAc,EAEd,WAAW,EACX,aAAa,EACb,OAAO,EACP,cAAc,EAEd,YAAY,EACZ,OAAO,EACP,iBAAiB,EACjB,QAAQ,EAER,WAAW,EACX,UAAU,EACV,kBAAkB,EAElB,eAAe,EACf,eAAe,EACf,eAAe,EACf,cAAc,EACd,QAAQ,EAER,aAAa,EACb,YAAY,EACZ,MAAM,EAEN,aAAa,EACb,YAAY,EACZ,MAAM,EAEN,eAAe,EACf,cAAc,EACd,QAAQ,EAER,YAAY,EACZ,WAAW,EACX,KAAK,EAEL,aAAa,EACb,YAAY,EACZ,MAAM,EAEN,kBAAkB,GACnB,MAAM,YAAY,CAAC"}

package/dist/index.js

@@ -0,0 +1,23 @@
+// ─── Core ───────────────────────────────────────────────────
+export { agentfn } from "./agentfn.js";
+// ─── Feedback ───────────────────────────────────────────────
+export { agentSendFeedback, TASK_COMPLETION_PROMPT, parseTaskReport, formatReportAsMarkdown, } from "./feedback.js";
+// ─── Compose ────────────────────────────────────────────────
+export { compose } from "./compose.js";
+// ─── Agent (Claude only) ───────────────────────────────────
+export { agent } from "./agent.js";
+// ─── Provider ───────────────────────────────────────────────
+export { getDefaultProvider, setDefaultProvider } from "./provider.js";
+// ─── Prompting (legacy — deprecated) ────────────────────────
+export { enhancePrompt, listSkills, listAgents } from "./prompting.js";
+// ─── Skills ─────────────────────────────────────────────────
+export { 
+// New parameterized API
+discoverSkills, loadSkill, loadSkillFromRoots, parseFrontmatter, stripFrontmatter, ensureSkillSymlinks, cleanupSkillSymlinks, 
+// Agent utilities
+discoverAgents, 
+// Metadata loaders
+getSkillPath, getSkillMeta, getAgentPath, getAgentMeta, } from "./skills.js";
+// ─── Utilities (re-exported from acpfn) ─────────────────────
+export { parseToolCalls as acpParseToolCalls, buildToolPreamble as acpBuildToolPreamble, buildCodePreamble as acpBuildCodePreamble, extractCode as acpExtractCode, executeCode as acpExecuteCode, } from "@openplaybooks/acpfn";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,+DAA+D;AAC/D,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAEvC,+DAA+D;AAC/D,OAAO,EACL,iBAAiB,EACjB,sBAAsB,EACtB,eAAe,EACf,sBAAsB,GACvB,MAAM,eAAe,CAAC;AAGvB,+DAA+D;AAC/D,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAEvC,8DAA8D;AAC9D,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AAGnC,+DAA+D;AAC/D,OAAO,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC;AAEvE,+DAA+D;AAC/D,OAAO,EAAE,aAAa,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAGvE,+DAA+D;AAC/D,OAAO;AACL,wBAAwB;AACxB,cAAc,EACd,SAAS,EACT,kBAAkB,EAClB,gBAAgB,EAChB,gBAAgB,EAChB,mBAAmB,EACnB,oBAAoB;AACpB,kBAAkB;AAClB,cAAc;AACd,mBAAmB;AACnB,YAAY,EACZ,YAAY,EACZ,YAAY,EACZ,YAAY,GACb,MAAM,aAAa,CAAC;AAGrB,+DAA+D;AAC/D,OAAO,EACL,cAAc,IAAI,iBAAiB,EACnC,iBAAiB,IAAI,oBAAoB,EACzC,iBAAiB,IAAI,oBAAoB,EACzC,WAAW,IAAI,cAAc,EAC7B,WAAW,IAAI,cAAc,GAC9B,MAAM,sBAAsB,CAAC"}

package/dist/prompting.d.ts

@@ -0,0 +1,32 @@
+/**
+ * Prompt enhancement and injection module.
+ *
+ * Handles general prompt manipulation, including:
+ * - Skill/agent reference enhancement
+ * - Prompt templating and injection
+ * - Context augmentation
+ *
+ * Note: The enhancePrompt function uses legacy auto-detection.
+ * New code should use discoverSkills/loadSkill from skills.ts directly
+ * and format prompts at the application level.
+ */
+import { listSkills, listAgents } from "./skills.js";
+export interface EnhancePromptOptions {
+    /** Working directory for finding .converge folder */
+    cwd?: string;
+}
+/**
+ * @deprecated Application-level prompt formatting should be done by the caller.
+ * This function uses legacy auto-detection of .converge/ directories.
+ *
+ * Enhance a prompt by adding footnote references to skills and agents.
+ *
+ * - /skill refs point to .converge/{name}/SKILL.md
+ * - @agent refs point to .converge/{name}/AGENT.md or .converge/{name}.md (fallback to SKILL.md)
+ *
+ * Returns the enhanced prompt with skill/agent footnotes.
+ * The AI can load these files on-demand when needed.
+ */
+export declare function enhancePrompt(prompt: string, options?: EnhancePromptOptions): string;
+export { listSkills, listAgents };
+//# sourceMappingURL=prompting.d.ts.map

package/dist/prompting.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompting.d.ts","sourceRoot":"","sources":["../src/prompting.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,EACL,UAAU,EACV,UAAU,EAKX,MAAM,aAAa,CAAC;AAErB,MAAM,WAAW,oBAAoB;IACnC,qDAAqD;IACrD,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AA8BD;;;;;;;;;;;GAWG;AACH,wBAAgB,aAAa,CAC3B,MAAM,EAAE,MAAM,EACd,OAAO,CAAC,EAAE,oBAAoB,GAC7B,MAAM,CAiER;AAGD,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,CAAC"}