@femtomc/mu-orchestrator 26.2.14 → 26.2.16

package/dist/dag_runner.d.ts

@@ -1,20 +1,50 @@
 import { type EventLog } from "@femtomc/mu-core/node";
 import type { ForumStore } from "@femtomc/mu-forum";
 import type { IssueStore } from "@femtomc/mu-issue";
+import type { ModelOverrides } from "./model_resolution.js";
 import type { BackendRunner } from "./pi_backend.js";
 export type DagResult = {
     status: "root_final" | "no_executable_leaf" | "max_steps_exhausted" | "error";
     steps: number;
     error: string;
 };
+export type DagRunnerStepStartEvent = {
+    rootId: string;
+    step: number;
+    issueId: string;
+    role: string | null;
+    title: string;
+};
+export type DagRunnerStepEndEvent = {
+    rootId: string;
+    step: number;
+    issueId: string;
+    exitCode: number;
+    elapsedS: number;
+    outcome: string | null;
+};
+export type DagRunnerBackendLineEvent = {
+    rootId: string;
+    step: number;
+    issueId: string;
+    logSuffix: string;
+    line: string;
+};
+export type DagRunnerHooks = {
+    onStepStart?: (ev: DagRunnerStepStartEvent) => void | Promise<void>;
+    onStepEnd?: (ev: DagRunnerStepEndEvent) => void | Promise<void>;
+    onBackendLine?: (ev: DagRunnerBackendLineEvent) => void;
+};
+export type DagRunnerRunOpts = {
+    hooks?: DagRunnerHooks;
+};
 export declare class DagRunner {
     #private;
     constructor(store: IssueStore, forum: ForumStore, repoRoot: string, opts?: {
         backend?: BackendRunner;
         events?: EventLog;
+        modelOverrides?: ModelOverrides;
     });
-    run(rootId: string, maxSteps?: number, opts?: {
-        review?: boolean;
-    }): Promise<DagResult>;
+    run(rootId: string, maxSteps?: number, opts?: DagRunnerRunOpts): Promise<DagResult>;
 }
 //# sourceMappingURL=dag_runner.d.ts.map

package/dist/dag_runner.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"dag_runner.d.ts","sourceRoot":"","sources":["../src/dag_runner.ts"],"names":[],"mappings":"AAIA,OAAO,EAEN,KAAK,QAAQ,EAMb,MAAM,uBAAuB,CAAC;AAC/B,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AACpD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AACpD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAIrD,MAAM,MAAM,SAAS,GAAG;IACvB,MAAM,EAAE,YAAY,GAAG,oBAAoB,GAAG,qBAAqB,GAAG,OAAO,CAAC;IAC9E,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;CACd,CAAC;AAuBF,qBAAa,SAAS;;gBAepB,KAAK,EAAE,UAAU,EACjB,KAAK,EAAE,UAAU,EACjB,QAAQ,EAAE,MAAM,EAChB,IAAI,GAAE;QAAE,OAAO,CAAC,EAAE,aAAa,CAAC;QAAC,MAAM,CAAC,EAAE,QAAQ,CAAA;KAAO;IAiVpD,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,GAAE,MAAW,EAAE,IAAI,GAAE;QAAE,MAAM,CAAC,EAAE,OAAO,CAAA;KAAO,GAAG,OAAO,CAAC,SAAS,CAAC;CAkLrG"}
+{"version":3,"file":"dag_runner.d.ts","sourceRoot":"","sources":["../src/dag_runner.ts"],"names":[],"mappings":"AAGA,OAAO,EAEN,KAAK,QAAQ,EAKb,MAAM,uBAAuB,CAAC;AAC/B,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AACpD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AACpD,OAAO,KAAK,EAAE,cAAc,EAAuB,MAAM,uBAAuB,CAAC;AAGjF,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAGrD,MAAM,MAAM,SAAS,GAAG;IACvB,MAAM,EAAE,YAAY,GAAG,oBAAoB,GAAG,qBAAqB,GAAG,OAAO,CAAC;IAC9E,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;CACd,CAAC;AAEF,MAAM,MAAM,uBAAuB,GAAG;IACrC,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB,KAAK,EAAE,MAAM,CAAC;CACd,CAAC;AAEF,MAAM,MAAM,qBAAqB,GAAG;IACnC,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;CACvB,CAAC;AAEF,MAAM,MAAM,yBAAyB,GAAG;IACvC,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC;CACb,CAAC;AAEF,MAAM,MAAM,cAAc,GAAG;IAC5B,WAAW,CAAC,EAAE,CAAC,EAAE,EAAE,uBAAuB,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACpE,SAAS,CAAC,EAAE,CAAC,EAAE,EAAE,qBAAqB,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAChE,aAAa,CAAC,EAAE,CAAC,EAAE,EAAE,yBAAyB,KAAK,IAAI,CAAC;CACxD,CAAC;AAEF,MAAM,MAAM,gBAAgB,GAAG;IAC9B,KAAK,CAAC,EAAE,cAAc,CAAC;CACvB,CAAC;AA2BF,qBAAa,SAAS;;gBAWpB,KAAK,EAAE,UAAU,EACjB,KAAK,EAAE,UAAU,EACjB,QAAQ,EAAE,MAAM,EAChB,IAAI,GAAE;QAAE,OAAO,CAAC,EAAE,aAAa,CAAC;QAAC,MAAM,CAAC,EAAE,QAAQ,CAAC;QAAC,cAAc,CAAC,EAAE,cAAc,CAAA;KAAO;IAsKrF,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,GAAE,MAAW,EAAE,IAAI,GAAE,gBAAqB,GAAG,OAAO,CAAC,SAAS,CAAC;CAiMjG"}

package/dist/dag_runner.js

@@ -1,13 +1,21 @@
-import { existsSync } from "node:fs";
 import { mkdir } from "node:fs/promises";
 import { join, relative } from "node:path";
-import { currentRunId, executionSpecFromDict, fsEventLogFromRepoRoot, getStorePaths, newRunId, runContext, } from "@femtomc/mu-core/node";
+import { currentRunId, fsEventLogFromRepoRoot, getStorePaths, newRunId, runContext, } from "@femtomc/mu-core/node";
+import { resolveModelConfig } from "./model_resolution.js";
+import { parseMuRole, systemPromptForRole } from "./mu_roles.js";
 import { PiSdkBackend } from "./pi_sdk_backend.js";
-import { readPromptMeta, renderPromptTemplate } from "./prompt.js";
 function roundTo(n, digits) {
     const f = 10 ** digits;
     return Math.round(n * f) / f;
 }
+function specRoleFromExecutionSpec(execution_spec) {
+    const role = execution_spec?.role;
+    if (typeof role !== "string") {
+        return null;
+    }
+    const trimmed = role.trim();
+    return trimmed.length > 0 ? trimmed : null;
+}
 function relPath(repoRoot, path) {
     try {
         const rel = relative(repoRoot, path);
@@ -18,15 +26,12 @@ function relPath(repoRoot, path) {
     }
 }
 export class DagRunner {
-    // Hardcoded fallbacks if neither execution_spec nor orchestrator.md provide config.
-    #fallbackCli = "pi";
-    #fallbackModel = "gpt-5.3-codex";
-    #fallbackReasoning = "xhigh";
     #store;
     #forum;
     #repoRoot;
     #events;
     #backend;
+    #modelOverrides;
     #reorchestrateOutcomes = new Set(["failure", "needs_work"]);
     constructor(store, forum, repoRoot, opts = {}) {
         this.#store = store;
@@ -34,70 +39,29 @@ export class DagRunner {
         this.#repoRoot = repoRoot;
         this.#events = opts.events ?? fsEventLogFromRepoRoot(repoRoot);
         this.#backend = opts.backend ?? new PiSdkBackend();
+        this.#modelOverrides = opts.modelOverrides ?? {};
     }
     async #resolveConfig(issue) {
-        let cli = this.#fallbackCli;
-        let model = this.#fallbackModel;
-        let reasoning = this.#fallbackReasoning;
-        let promptPath = null;
-        // Tier 1: orchestrator.md frontmatter (global defaults).
-        const { orchestratorPath } = getStorePaths(this.#repoRoot);
-        if (existsSync(orchestratorPath)) {
-            const meta = await readPromptMeta(orchestratorPath);
-            if (typeof meta.cli === "string")
-                cli = meta.cli;
-            if (typeof meta.model === "string")
-                model = meta.model;
-            if (typeof meta.reasoning === "string")
-                reasoning = meta.reasoning;
-            promptPath = orchestratorPath;
-        }
-        // Parse execution spec (may set role + explicit fields).
-        const specDict = issue.execution_spec ?? null;
-        const spec = specDict ? executionSpecFromDict(specDict, this.#repoRoot) : null;
-        // Tier 2: role file frontmatter (role-specific defaults).
-        if (spec?.role) {
-            const rolePath = join(this.#repoRoot, ".mu", "roles", `${spec.role}.md`);
-            if (existsSync(rolePath)) {
-                const roleMeta = await readPromptMeta(rolePath);
-                if (typeof roleMeta.cli === "string")
-                    cli = roleMeta.cli;
-                if (typeof roleMeta.model === "string")
-                    model = roleMeta.model;
-                if (typeof roleMeta.reasoning === "string")
-                    reasoning = roleMeta.reasoning;
-            }
-        }
-        // Tier 3: execution_spec explicit fields (highest priority).
-        if (spec) {
-            if (spec.cli != null)
-                cli = spec.cli;
-            if (spec.model != null)
-                model = spec.model;
-            if (spec.reasoning != null)
-                reasoning = spec.reasoning;
-            if (spec.prompt_path != null)
-                promptPath = spec.prompt_path;
-        }
-        return { cli, model, reasoning, promptPath };
+        void issue;
+        return resolveModelConfig(this.#modelOverrides);
     }
-    async #renderPrompt(issue, promptPath, rootId) {
-        let rendered;
-        if (promptPath && existsSync(promptPath)) {
-            rendered = await renderPromptTemplate(promptPath, issue, { repoRoot: this.#repoRoot });
+    async #renderUserPrompt(issue, rootId, step) {
+        let rendered = issue.title ?? "";
+        if (issue.body) {
+            rendered += `\n\n${issue.body}`;
         }
-        else {
-            rendered = issue.title;
-            if (issue.body) {
-                rendered += `\n\n${issue.body}`;
-            }
+        const runId = currentRunId();
+        rendered += `\n\n## Mu Run Context\nRoot: ${rootId}\nAssigned issue: ${issue.id}\nStep: ${step}\n`;
+        if (runId) {
+            rendered += `Run: ${runId}\n`;
         }
-        rendered += `\n\n## Inshallah Context\nRoot: ${rootId}\nAssigned issue: ${issue.id}\n`;
         return rendered;
     }
-    async #executeBackend(issue, cfg, rootId, opts = {}) {
+    async #executeBackend(issue, cfg, rootId, step, opts = {}) {
+        const role = parseMuRole(specRoleFromExecutionSpec(issue.execution_spec));
         const logSuffix = opts.logSuffix ?? "";
-        const rendered = await this.#renderPrompt(issue, cfg.promptPath, rootId);
+        const rendered = await this.#renderUserPrompt(issue, rootId, step);
+        const systemPrompt = systemPromptForRole(role);
         const { logsDir } = getStorePaths(this.#repoRoot);
         await mkdir(logsDir, { recursive: true });
         const suffix = logSuffix ? `.${logSuffix}` : "";
@@ -106,10 +70,10 @@ export class DagRunner {
             source: "backend",
             issueId: issue.id,
             payload: {
+                role,
                 cli: cfg.cli,
                 model: cfg.model,
                 reasoning: cfg.reasoning,
-                prompt_path: cfg.promptPath,
                 tee_path: relPath(this.#repoRoot, teePath),
                 log_suffix: logSuffix,
             },
@@ -117,14 +81,16 @@ export class DagRunner {
         const t0 = Date.now();
         const exitCode = await this.#backend.run({
             issueId: issue.id,
+            role,
+            systemPrompt,
             prompt: rendered,
             model: cfg.model,
             thinking: cfg.reasoning,
             cwd: this.#repoRoot,
             cli: cfg.cli,
-            promptPath: cfg.promptPath,
             logSuffix,
             teePath,
+            onLine: opts.onLine,
         });
         const elapsedS = (Date.now() - t0) / 1000;
         await this.#events.emit("backend.run.end", {
@@ -140,44 +106,16 @@ export class DagRunner {
         });
         return { exitCode, elapsedS };
     }
-    #hasReviewer() {
-        return existsSync(join(this.#repoRoot, ".mu", "roles", "reviewer.md"));
-    }
-    async #maybeReview(issue, rootId, step) {
-        const issueId = issue.id;
-        // Guards.
-        if (issue.outcome !== "success") {
-            return issue;
-        }
-        if (!this.#hasReviewer()) {
-            return issue;
+    async #reopenForOrchestration(issueId, opts) {
+        const before = await this.#store.get(issueId);
+        if (!before) {
+            return;
         }
-        await this.#events.emit("dag.review.start", {
-            source: "dag_runner",
-            issueId,
-            payload: { root_id: rootId, step },
+        const reopened = await this.#store.update(issueId, {
+            status: "open",
+            outcome: null,
+            execution_spec: { role: "orchestrator" },
         });
-        const reviewIssue = { ...issue, execution_spec: { role: "reviewer" } };
-        const cfg = await this.#resolveConfig(reviewIssue);
-        const { exitCode, elapsedS } = await this.#executeBackend(reviewIssue, cfg, rootId, { logSuffix: "review" });
-        await this.#forum.post(`issue:${issueId}`, JSON.stringify({
-            step,
-            issue_id: issueId,
-            title: issue.title,
-            exit_code: exitCode,
-            elapsed_s: roundTo(elapsedS, 1),
-            type: "review",
-        }), "reviewer");
-        const updated = (await this.#store.get(issueId)) ?? issue;
-        await this.#events.emit("dag.review.end", {
-            source: "dag_runner",
-            issueId,
-            payload: { root_id: rootId, step, outcome: updated.outcome },
-        });
-        return updated;
-    }
-    async #reopenForOrchestration(issueId, opts) {
-        const reopened = await this.#store.update(issueId, { status: "open", outcome: null, execution_spec: null });
         await this.#events.emit("dag.unstick.reopen", {
             source: "dag_runner",
             issueId,
@@ -231,99 +169,14 @@ export class DagRunner {
         await this.#reopenForOrchestration(target.id, { reason: `was outcome=${target.outcome}`, step });
         return true;
     }
-    async #collapseReview(issue, rootId, step) {
-        const issueId = issue.id;
-        await this.#events.emit("dag.collapse_review.start", {
-            source: "dag_runner",
-            issueId,
-            payload: { root_id: rootId, step },
-        });
-        const kids = await this.#store.children(issueId);
-        const lines = [];
-        for (const kid of kids) {
-            lines.push(`- [${kid.outcome ?? "?"}] ${kid.id}: ${kid.title}`);
-        }
-        const childrenSummary = lines.join("\n");
-        const originalBody = issue.body || "";
-        const collapsePrompt = `# Collapse Review\n\n` +
-            `## Original Specification\n\n` +
-            `**${issue.title}**\n\n` +
-            `${originalBody}\n\n` +
-            `## Children Outcomes\n\n` +
-            `${childrenSummary}\n\n` +
-            `## Instructions\n\n` +
-            `All children of this issue have completed. Review whether their aggregate work satisfies the original specification above.\n\n` +
-            `If satisfied: no action needed (the issue will be marked successful).\n\n` +
-            `If NOT satisfied: mark the parent as needing work by running:\n\n` +
-            `  \`mu issues update ${issueId} --outcome needs_work\`\n\n` +
-            `Then explain the gaps in the forum topic (issue:${issueId}).\n\n` +
-            `Do NOT create child issues yourself; the orchestrator will re-expand the issue into remediation children.\n`;
-        const reviewIssue = {
-            ...issue,
-            title: `Collapse review: ${issue.title}`,
-            body: collapsePrompt,
-            execution_spec: { role: "reviewer" },
-        };
-        const cfg = await this.#resolveConfig(reviewIssue);
-        const { exitCode, elapsedS } = await this.#executeBackend(reviewIssue, { ...cfg, promptPath: null }, rootId, {
-            logSuffix: "collapse-review",
-        });
-        await this.#forum.post(`issue:${issueId}`, JSON.stringify({
-            step,
-            issue_id: issueId,
-            title: issue.title,
-            exit_code: exitCode,
-            elapsed_s: roundTo(elapsedS, 1),
-            type: "collapse-review",
-        }), "reviewer");
-        const newKids = await this.#store.children(issueId);
-        const openKids = newKids.filter((k) => k.status !== "closed");
-        const updated = (await this.#store.get(issueId)) ?? issue;
-        if (updated.status !== "closed") {
-            await this.#events.emit("dag.collapse_review.end", {
-                source: "dag_runner",
-                issueId,
-                payload: { root_id: rootId, step, status: updated.status, outcome: updated.outcome },
-            });
-            return;
-        }
-        if (updated.outcome && this.#reorchestrateOutcomes.has(updated.outcome)) {
-            await this.#events.emit("dag.collapse_review.end", {
-                source: "dag_runner",
-                issueId,
-                payload: { root_id: rootId, step, status: updated.status, outcome: updated.outcome },
-            });
-            return;
-        }
-        if (openKids.length > 0) {
-            await this.#events.emit("dag.collapse_review.end", {
-                source: "dag_runner",
-                issueId,
-                payload: {
-                    root_id: rootId,
-                    step,
-                    status: updated.status,
-                    outcome: updated.outcome,
-                    open_kids: openKids.length,
-                },
-            });
-            return;
-        }
-        await this.#store.update(issueId, { outcome: "success" });
-        await this.#events.emit("dag.collapse_review.end", {
-            source: "dag_runner",
-            issueId,
-            payload: { root_id: rootId, step, outcome: "success" },
-        });
-    }
     async run(rootId, maxSteps = 20, opts = {}) {
-        const review = opts.review ?? true;
+        const hooks = opts.hooks;
         const runId = currentRunId() ?? newRunId();
         return await runContext({ runId }, async () => {
             await this.#events.emit("dag.run.start", {
                 source: "dag_runner",
                 issueId: rootId,
-                payload: { root_id: rootId, max_steps: maxSteps, review },
+                payload: { root_id: rootId, max_steps: maxSteps },
             });
             let final = null;
             try {
@@ -331,14 +184,6 @@ export class DagRunner {
                     const step = i + 1;
                     // 0. Unstick: failures / needs_work trigger re-orchestration.
                     await this.#maybeUnstick(rootId, step);
-                    // 1. Collapse review (before termination check).
-                    if (review && this.#hasReviewer()) {
-                        const collapsible = await this.#store.collapsible(rootId);
-                        if (collapsible.length > 0) {
-                            await this.#collapseReview(collapsible[0], rootId, step);
-                            continue;
-                        }
-                    }
                     // 2. Check termination.
                     const v = await this.#store.validate(rootId);
                     if (v.is_final) {
@@ -371,8 +216,13 @@ export class DagRunner {
                             execution_spec: null,
                         };
                         const cfg = await this.#resolveConfig(repairIssue);
-                        const { exitCode, elapsedS } = await this.#executeBackend(repairIssue, cfg, rootId, {
-                            logSuffix: "unstick",
+                        const logSuffix = "unstick";
+                        const onBackendLine = hooks?.onBackendLine;
+                        const { exitCode, elapsedS } = await this.#executeBackend(repairIssue, cfg, rootId, step, {
+                            logSuffix,
+                            onLine: onBackendLine
+                                ? (line) => onBackendLine({ rootId, step, issueId: rootId, logSuffix, line })
+                                : undefined,
                         });
                         await this.#forum.post(`issue:${rootId}`, JSON.stringify({
                             step,
@@ -391,11 +241,16 @@ export class DagRunner {
                     }
                     const issue = candidates[0];
                     const issueId = issue.id;
+                    // Validate role early so we don't claim/work an unsupported leaf.
+                    const role = parseMuRole(specRoleFromExecutionSpec(issue.execution_spec));
                     await this.#events.emit("dag.step.start", {
                         source: "dag_runner",
                         issueId,
                         payload: { root_id: rootId, step, title: issue.title ?? "" },
                     });
+                    if (hooks?.onStepStart) {
+                        await hooks.onStepStart({ rootId, step, issueId, role, title: issue.title ?? "" });
+                    }
                     // 3. Claim.
                     await this.#events.emit("dag.claim", {
                         source: "dag_runner",
@@ -405,7 +260,14 @@ export class DagRunner {
                     await this.#store.claim(issueId);
                     // 4. Route + 5. Render + 6. Execute.
                     const cfg = await this.#resolveConfig(issue);
-                    const { exitCode, elapsedS } = await this.#executeBackend(issue, cfg, rootId);
+                    const logSuffix = "";
+                    const onBackendLine = hooks?.onBackendLine;
+                    const { exitCode, elapsedS } = await this.#executeBackend(issue, cfg, rootId, step, {
+                        logSuffix,
+                        onLine: onBackendLine
+                            ? (line) => onBackendLine({ rootId, step, issueId, logSuffix, line })
+                            : undefined,
+                    });
                     // 7. Check postconditions.
                     let updated = await this.#store.get(issueId);
                     if (!updated) {
@@ -415,10 +277,6 @@ export class DagRunner {
                     if (updated.status !== "closed") {
                         updated = await this.#store.close(issueId, "failure");
                     }
-                    // 7b. Review phase.
-                    if (review && updated.status === "closed") {
-                        updated = await this.#maybeReview(updated, rootId, step);
-                    }
                     // 8. Log to forum.
                     await this.#forum.post(`issue:${issueId}`, JSON.stringify({
                         step,
@@ -428,6 +286,16 @@ export class DagRunner {
                         outcome: updated.outcome,
                         elapsed_s: roundTo(elapsedS, 1),
                     }), "orchestrator");
+                    if (hooks?.onStepEnd) {
+                        await hooks.onStepEnd({
+                            rootId,
+                            step,
+                            issueId,
+                            exitCode,
+                            elapsedS: roundTo(elapsedS, 3),
+                            outcome: updated.outcome ?? null,
+                        });
+                    }
                     await this.#events.emit("dag.step.end", {
                         source: "dag_runner",
                         issueId,

package/dist/index.d.ts

@@ -1,8 +1,12 @@
-export type { DagResult } from "./dag_runner.js";
+export type { DagResult, DagRunnerBackendLineEvent, DagRunnerHooks, DagRunnerRunOpts, DagRunnerStepEndEvent, DagRunnerStepStartEvent, } from "./dag_runner.js";
 export { DagRunner } from "./dag_runner.js";
+export type { ModelOverrides, ResolvedModelConfig } from "./model_resolution.js";
+export { resolveModelConfig } from "./model_resolution.js";
 export type { BackendRunner, BackendRunOpts } from "./pi_backend.js";
 export { PiCliBackend, piStreamHasError } from "./pi_backend.js";
-export { PiSdkBackend } from "./pi_sdk_backend.js";
+export { createMuResourceLoader, PiSdkBackend } from "./pi_sdk_backend.js";
+export type { PiStreamRendererOpts } from "./pi_stream_renderer.js";
+export { PiStreamRenderer } from "./pi_stream_renderer.js";
 export type { PromptMeta } from "./prompt.js";
 export { buildRoleCatalog, extractDescription, readPromptMeta, renderPromptTemplate, splitFrontmatter, } from "./prompt.js";
 export declare function orchestratorHello(): string;

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AACjD,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAC5C,YAAY,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AACrE,OAAO,EAAE,YAAY,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AACjE,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACnD,YAAY,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAC9C,OAAO,EACN,gBAAgB,EAChB,kBAAkB,EAClB,cAAc,EACd,oBAAoB,EACpB,gBAAgB,GAChB,MAAM,aAAa,CAAC;AAGrB,wBAAgB,iBAAiB,IAAI,MAAM,CAE1C"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,YAAY,EACX,SAAS,EACT,yBAAyB,EACzB,cAAc,EACd,gBAAgB,EAChB,qBAAqB,EACrB,uBAAuB,GACvB,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAC5C,YAAY,EAAE,cAAc,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AACjF,OAAO,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AAC3D,YAAY,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AACrE,OAAO,EAAE,YAAY,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AACjE,OAAO,EAAE,sBAAsB,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAC3E,YAAY,EAAE,oBAAoB,EAAE,MAAM,yBAAyB,CAAC;AACpE,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAC3D,YAAY,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAC9C,OAAO,EACN,gBAAgB,EAChB,kBAAkB,EAClB,cAAc,EACd,oBAAoB,EACpB,gBAAgB,GAChB,MAAM,aAAa,CAAC;AAGrB,wBAAgB,iBAAiB,IAAI,MAAM,CAE1C"}

package/dist/index.js

@@ -1,6 +1,8 @@
 export { DagRunner } from "./dag_runner.js";
+export { resolveModelConfig } from "./model_resolution.js";
 export { PiCliBackend, piStreamHasError } from "./pi_backend.js";
-export { PiSdkBackend } from "./pi_sdk_backend.js";
+export { createMuResourceLoader, PiSdkBackend } from "./pi_sdk_backend.js";
+export { PiStreamRenderer } from "./pi_stream_renderer.js";
 export { buildRoleCatalog, extractDescription, readPromptMeta, renderPromptTemplate, splitFrontmatter, } from "./prompt.js";
 // Back-compat placeholder API used by other packages/tests.
 export function orchestratorHello() {

package/dist/model_resolution.d.ts

@@ -0,0 +1,21 @@
+import { AuthStorage } from "@mariozechner/pi-coding-agent";
+export type ModelOverrides = {
+    model?: string;
+    provider?: string;
+    reasoning?: string;
+};
+export type ResolvedModelConfig = {
+    cli: string;
+    model: string;
+    reasoning: string;
+};
+/**
+ * Resolve model configuration from overrides and authenticated providers.
+ *
+ * Resolution order:
+ *   1. Explicit --model: find across providers (prefer auth'd)
+ *   2. Explicit --provider only: pick best model from that provider
+ *   3. Auto-detect: best model from any auth'd provider
+ */
+export declare function resolveModelConfig(overrides: ModelOverrides, authStorage?: AuthStorage): ResolvedModelConfig;
+//# sourceMappingURL=model_resolution.d.ts.map

package/dist/model_resolution.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"model_resolution.d.ts","sourceRoot":"","sources":["../src/model_resolution.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,WAAW,EAAE,MAAM,+BAA+B,CAAC;AAE5D,MAAM,MAAM,cAAc,GAAG;IAC5B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;CACnB,CAAC;AAEF,MAAM,MAAM,mBAAmB,GAAG;IACjC,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;CAClB,CAAC;AAmBF;;;;;;;GAOG;AACH,wBAAgB,kBAAkB,CAAC,SAAS,EAAE,cAAc,EAAE,WAAW,CAAC,EAAE,WAAW,GAAG,mBAAmB,CAY5G"}

package/dist/model_resolution.js

@@ -0,0 +1,88 @@
+import { getModels, getProviders, supportsXhigh } from "@mariozechner/pi-ai";
+import { AuthStorage } from "@mariozechner/pi-coding-agent";
+/**
+ * Rank models by capability: reasoning > output cost (proxy for tier) > context window.
+ */
+function rankModel(m) {
+    const reasoningScore = m.reasoning ? 1_000_000 : 0;
+    const costScore = (m.cost?.output ?? 0) * 1_000;
+    const ctxScore = (m.contextWindow ?? 0) / 1_000_000;
+    return reasoningScore + costScore + ctxScore;
+}
+function pickReasoning(model, explicit) {
+    if (explicit)
+        return explicit;
+    if (supportsXhigh(model))
+        return "xhigh";
+    if (model.reasoning)
+        return "high";
+    return "high";
+}
+/**
+ * Resolve model configuration from overrides and authenticated providers.
+ *
+ * Resolution order:
+ *   1. Explicit --model: find across providers (prefer auth'd)
+ *   2. Explicit --provider only: pick best model from that provider
+ *   3. Auto-detect: best model from any auth'd provider
+ */
+export function resolveModelConfig(overrides, authStorage) {
+    const auth = authStorage ?? new AuthStorage();
+    if (overrides.model) {
+        return resolveExplicitModel(overrides.model, overrides.provider, overrides.reasoning, auth);
+    }
+    if (overrides.provider) {
+        return resolveFromProvider(overrides.provider, overrides.reasoning, auth);
+    }
+    return autoDetect(overrides.reasoning, auth);
+}
+function resolveExplicitModel(modelId, providerConstraint, reasoningOverride, auth) {
+    let fallback;
+    for (const provider of getProviders()) {
+        if (providerConstraint && provider !== providerConstraint)
+            continue;
+        const models = getModels(provider);
+        const match = models.find((m) => m.id === modelId);
+        if (!match)
+            continue;
+        if (auth.hasAuth(provider)) {
+            return { cli: "pi", model: match.id, reasoning: pickReasoning(match, reasoningOverride) };
+        }
+        if (!fallback) {
+            fallback = match;
+        }
+    }
+    if (fallback) {
+        return { cli: "pi", model: fallback.id, reasoning: pickReasoning(fallback, reasoningOverride) };
+    }
+    const scope = providerConstraint ? ` in provider "${providerConstraint}"` : "";
+    throw new Error(`Model "${modelId}" not found${scope}. Run \`mu login --list\` to see available providers.`);
+}
+function resolveFromProvider(providerId, reasoningOverride, auth) {
+    const providers = getProviders();
+    if (!providers.includes(providerId)) {
+        throw new Error(`Unknown provider "${providerId}". Available: ${providers.join(", ")}`);
+    }
+    if (!auth.hasAuth(providerId)) {
+        throw new Error(`No auth for provider "${providerId}". Run \`mu login ${providerId}\``);
+    }
+    const models = getModels(providerId);
+    if (models.length === 0) {
+        throw new Error(`No models available for provider "${providerId}".`);
+    }
+    const best = [...models].sort((a, b) => rankModel(b) - rankModel(a))[0];
+    return { cli: "pi", model: best.id, reasoning: pickReasoning(best, reasoningOverride) };
+}
+function autoDetect(reasoningOverride, auth) {
+    const authedModels = [];
+    for (const provider of getProviders()) {
+        if (!auth.hasAuth(provider))
+            continue;
+        authedModels.push(...getModels(provider));
+    }
+    if (authedModels.length === 0) {
+        throw new Error("No authenticated providers. Run `mu login` to authenticate.");
+    }
+    const best = authedModels.sort((a, b) => rankModel(b) - rankModel(a))[0];
+    return { cli: "pi", model: best.id, reasoning: pickReasoning(best, reasoningOverride) };
+}

package/dist/mu_roles.d.ts

@@ -0,0 +1,4 @@
+export type MuRole = "orchestrator" | "worker";
+export declare function parseMuRole(role: string | null | undefined): MuRole;
+export declare function systemPromptForRole(role: MuRole): string;
+//# sourceMappingURL=mu_roles.d.ts.map

package/dist/mu_roles.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mu_roles.d.ts","sourceRoot":"","sources":["../src/mu_roles.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,MAAM,GAAG,cAAc,GAAG,QAAQ,CAAC;AAE/C,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,MAAM,CAanE;AAED,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CA6BxD"}

package/dist/mu_roles.js

@@ -0,0 +1,39 @@
+export function parseMuRole(role) {
+    if (role == null) {
+        return "orchestrator";
+    }
+    const trimmed = role.trim();
+    if (trimmed === "orchestrator" || trimmed === "worker") {
+        return trimmed;
+    }
+    throw new Error(`unsupported execution_spec.role=${JSON.stringify(trimmed)} (only "orchestrator" and "worker" are supported)`);
+}
+export function systemPromptForRole(role) {
+    if (role === "orchestrator") {
+        return [
+            "You are mu's orchestrator.",
+            "",
+            "Responsibilities:",
+            "- Decompose the assigned goal into small, concrete child issues.",
+            "- Decide ordering using dependencies (e.g. blocks) and keep work items atomic.",
+            "- Do not implement code changes directly; delegate execution to the worker role.",
+            "- Keep plans deterministic and minimal.",
+            "",
+            "Role rules:",
+            "- Use only the roles: orchestrator, worker.",
+            "- Assign executable leaves to role=worker.",
+        ].join("\n");
+    }
+    return [
+        "You are mu's worker.",
+        "",
+        "Responsibilities:",
+        "- Execute exactly one atomic issue end-to-end.",
+        "- Keep scope tight to the issue specification.",
+        "- Verify results (tests/typecheck/etc) and report what changed.",
+        "- Close with a terminal outcome: success, failure, or skipped.",
+        "",
+        "Role rules:",
+        "- Use only the roles: orchestrator, worker.",
+    ].join("\n");
+}

package/dist/pi_backend.d.ts

@@ -1,11 +1,13 @@
+import type { MuRole } from "./mu_roles.js";
 export type BackendRunOpts = {
     issueId: string;
+    role: MuRole;
+    systemPrompt: string;
     prompt: string;
     model: string;
     thinking: string;
     cwd: string;
     cli: string;
-    promptPath: string | null;
     logSuffix: string;
     onLine?: (line: string) => void;
     teePath?: string;

package/dist/pi_backend.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"pi_backend.d.ts","sourceRoot":"","sources":["../src/pi_backend.ts"],"names":[],"mappings":"AAMA,MAAM,MAAM,cAAc,GAAG;IAC5B,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,GAAG,EAAE,MAAM,CAAC;IACZ,GAAG,EAAE,MAAM,CAAC;IACZ,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IAChC,OAAO,CAAC,EAAE,MAAM,CAAC;CACjB,CAAC;AAEF,MAAM,WAAW,aAAa;IAC7B,GAAG,CAAC,IAAI,EAAE,cAAc,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;CAC3C;AAED,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CA4BtD;AAED,qBAAa,YAAa,YAAW,aAAa;;IAKpC,GAAG,CAAC,IAAI,EAAE,cAAc,GAAG,OAAO,CAAC,MAAM,CAAC;CA0DvD"}
+{"version":3,"file":"pi_backend.d.ts","sourceRoot":"","sources":["../src/pi_backend.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,eAAe,CAAC;AAE5C,MAAM,MAAM,cAAc,GAAG;IAC5B,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,YAAY,EAAE,MAAM,CAAC;IACrB,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,GAAG,EAAE,MAAM,CAAC;IACZ,GAAG,EAAE,MAAM,CAAC;IACZ,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IAChC,OAAO,CAAC,EAAE,MAAM,CAAC;CACjB,CAAC;AAEF,MAAM,WAAW,aAAa;IAC7B,GAAG,CAAC,IAAI,EAAE,cAAc,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;CAC3C;AAED,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CA4BtD;AAED,qBAAa,YAAa,YAAW,aAAa;;IAKpC,GAAG,CAAC,IAAI,EAAE,cAAc,GAAG,OAAO,CAAC,MAAM,CAAC;CAuEvD"}

package/dist/pi_backend.js

@@ -53,6 +53,7 @@ export class PiCliBackend {
             proc.stdout?.pipe(merged);
             proc.stderr?.pipe(merged);
             let sawAssistantError = false;
+            const DELTA_TYPES = /^(?:thinking_delta|toolcall_delta|text_delta)$/;
             const rl = createInterface({ input: merged, crlfDelay: Number.POSITIVE_INFINITY });
             const readLoop = (async () => {
                 for await (const line of rl) {
@@ -62,8 +63,21 @@ export class PiCliBackend {
                     }
                     opts.onLine?.(trimmed);
                     if (teeFh) {
-                        // Preserve Python's JSONL tee behavior: write one line per line.
-                        await teeFh.write(`${trimmed}\n`);
+                        // Skip streaming deltas from the log — they carry the full
+                        // accumulated message state on every token, causing quadratic
+                        // log growth. Structural events are preserved.
+                        let skip = false;
+                        try {
+                            const parsed = JSON.parse(trimmed);
+                            const aType = parsed?.assistantMessageEvent?.type;
+                            if (typeof aType === "string" && DELTA_TYPES.test(aType)) {
+                                skip = true;
+                            }
+                        }
+                        catch { }
+                        if (!skip) {
+                            await teeFh.write(`${trimmed}\n`);
+                        }
                     }
                 }
             })();

package/dist/pi_sdk_backend.d.ts

@@ -1,4 +1,5 @@
-import type { BackendRunOpts, BackendRunner } from "./pi_backend.js";
+import { DefaultResourceLoader, SettingsManager } from "@mariozechner/pi-coding-agent";
+import type { BackendRunner, BackendRunOpts } from "./pi_backend.js";
 /**
  * In-process backend using the pi SDK.
  *
@@ -8,4 +9,12 @@ import type { BackendRunOpts, BackendRunner } from "./pi_backend.js";
 export declare class PiSdkBackend implements BackendRunner {
     run(opts: BackendRunOpts): Promise<number>;
 }
+export type CreateMuResourceLoaderOpts = {
+    cwd: string;
+    systemPrompt: string;
+    agentDir?: string;
+    settingsManager?: SettingsManager;
+    additionalSkillPaths?: string[];
+};
+export declare function createMuResourceLoader(opts: CreateMuResourceLoaderOpts): DefaultResourceLoader;
 //# sourceMappingURL=pi_sdk_backend.d.ts.map

package/dist/pi_sdk_backend.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"pi_sdk_backend.d.ts","sourceRoot":"","sources":["../src/pi_sdk_backend.ts"],"names":[],"mappings":"AAYA,OAAO,KAAK,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAgBrE;;;;;GAKG;AACH,qBAAa,YAAa,YAAW,aAAa;IAC3C,GAAG,CAAC,IAAI,EAAE,cAAc,GAAG,OAAO,CAAC,MAAM,CAAC;CAsEhD"}
+{"version":3,"file":"pi_sdk_backend.d.ts","sourceRoot":"","sources":["../src/pi_sdk_backend.ts"],"names":[],"mappings":"AAMA,OAAO,EAWN,qBAAqB,EAErB,eAAe,EACf,MAAM,+BAA+B,CAAC;AACvC,OAAO,KAAK,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AA8BrE;;;;;GAKG;AACH,qBAAa,YAAa,YAAW,aAAa;IAC3C,GAAG,CAAC,IAAI,EAAE,cAAc,GAAG,OAAO,CAAC,MAAM,CAAC;CAsGhD;AAED,MAAM,MAAM,0BAA0B,GAAG;IACxC,GAAG,EAAE,MAAM,CAAC;IACZ,YAAY,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,eAAe,CAAC,EAAE,eAAe,CAAC;IAClC,oBAAoB,CAAC,EAAE,MAAM,EAAE,CAAC;CAChC,CAAC;AAEF,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,0BAA0B,GAAG,qBAAqB,CAsB9F"}

package/dist/pi_sdk_backend.js

@@ -1,20 +1,32 @@
+import { existsSync } from "node:fs";
 import { mkdir, open } from "node:fs/promises";
-import { dirname } from "node:path";
-import { SessionManager, SettingsManager, createAgentSession, createCodingTools, } from "@mariozechner/pi-coding-agent";
+import { basename, dirname, join } from "node:path";
 import { getModels, getProviders } from "@mariozechner/pi-ai";
+import { AuthStorage, createAgentSession, createBashTool, createEditTool, createFindTool, createGrepTool, createLsTool, createReadTool, createWriteTool, DefaultResourceLoader, SessionManager, SettingsManager, } from "@mariozechner/pi-coding-agent";
 import { piStreamHasError } from "./pi_backend.js";
 /**
- * Resolve a bare model ID (e.g. "gpt-5.3-codex") to a pi-ai Model object
- * by searching across all known providers.
+ * Resolve a bare model ID (e.g. "gpt-5.3-codex") to a pi-ai Model object.
+ *
+ * When multiple providers offer the same model ID, prefer providers that
+ * have auth configured (env var, OAuth, or stored API key).
  */
-function resolveModel(modelId) {
+function resolveModel(modelId, authStorage) {
+    let fallback;
     for (const provider of getProviders()) {
         const models = getModels(provider);
         const match = models.find((m) => m.id === modelId);
-        if (match)
+        if (!match)
+            continue;
+        // Prefer providers that have auth configured.
+        if (authStorage.hasAuth(provider)) {
             return match;
+        }
+        // Keep first match as fallback.
+        if (!fallback) {
+            fallback = match;
+        }
     }
-    return undefined;
+    return fallback;
 }
 /**
  * In-process backend using the pi SDK.
@@ -24,17 +36,37 @@ function resolveModel(modelId) {
  */
 export class PiSdkBackend {
     async run(opts) {
-        const model = resolveModel(opts.model);
+        const authStorage = new AuthStorage();
+        const model = resolveModel(opts.model, authStorage);
         if (!model) {
-            throw new Error(`Model "${opts.model}" not found in pi-ai registry`);
+            throw new Error(`Model "${opts.model}" not found in pi-ai registry. ` + `Available providers: ${getProviders().join(", ")}`);
         }
+        const settingsManager = SettingsManager.inMemory();
+        const resourceLoader = createMuResourceLoader({
+            cwd: opts.cwd,
+            systemPrompt: opts.systemPrompt,
+            settingsManager,
+        });
+        await resourceLoader.reload();
+        const tools = [
+            // Mu expects these built-in tools to exist at least for role=orchestrator.
+            createReadTool(opts.cwd),
+            createBashTool(opts.cwd),
+            createEditTool(opts.cwd),
+            createWriteTool(opts.cwd),
+            createGrepTool(opts.cwd),
+            createFindTool(opts.cwd),
+            createLsTool(opts.cwd),
+        ];
         const sessionOpts = {
             cwd: opts.cwd,
             model,
             thinkingLevel: opts.thinking,
-            tools: createCodingTools(opts.cwd),
+            tools,
             sessionManager: SessionManager.inMemory(opts.cwd),
-            settingsManager: SettingsManager.inMemory(),
+            settingsManager,
+            resourceLoader,
+            authStorage,
         };
         const { session } = await createAgentSession(sessionOpts);
         let teeFh = null;
@@ -56,23 +88,29 @@ export class PiSdkBackend {
                 onError: () => { },
             });
             let sawError = false;
+            const DELTA_TYPES = new Set(["thinking_delta", "toolcall_delta", "text_delta"]);
             // Subscribe to events — serialize to JSONL for tee and error detection.
             const unsub = session.subscribe((event) => {
                 const line = JSON.stringify(event);
                 if (piStreamHasError(line)) {
                     sawError = true;
                 }
+                // onLine gets everything (CLI needs deltas for live rendering).
                 opts.onLine?.(line);
+                // Tee file: skip streaming deltas (they carry the full accumulated
+                // message state on every token, causing quadratic log growth).
+                // Structural events (message_start/end, turn_start/end, tool_execution_*,
+                // thinking_start/end, toolcall_start/end) are kept.
                 if (teeFh) {
-                    teeFh.write(`${line}\n`).catch(() => { });
+                    const aType = event?.assistantMessageEvent?.type;
+                    if (!DELTA_TYPES.has(aType)) {
+                        teeFh.write(`${line}\n`).catch(() => { });
+                    }
                 }
             });
             try {
                 await session.prompt(opts.prompt, { expandPromptTemplates: false });
             }
-            catch {
-                return 1;
-            }
             finally {
                 unsub();
             }
@@ -86,3 +124,24 @@ export class PiSdkBackend {
         }
     }
 }
+export function createMuResourceLoader(opts) {
+    const skillPaths = new Set();
+    for (const p of opts.additionalSkillPaths ?? []) {
+        skillPaths.add(p);
+    }
+    // If a repo has a top-level `skills/` dir (like workshop/), load it.
+    const repoSkills = join(opts.cwd, "skills");
+    if (existsSync(repoSkills)) {
+        skillPaths.add(repoSkills);
+    }
+    return new DefaultResourceLoader({
+        cwd: opts.cwd,
+        agentDir: opts.agentDir,
+        settingsManager: opts.settingsManager ?? SettingsManager.inMemory(),
+        additionalSkillPaths: [...skillPaths],
+        systemPromptOverride: (_base) => opts.systemPrompt,
+        agentsFilesOverride: (base) => ({
+            agentsFiles: base.agentsFiles.filter((f) => basename(f.path) === "AGENTS.md"),
+        }),
+    });
+}

package/dist/pi_stream_renderer.d.ts

@@ -0,0 +1,31 @@
+export type PiStreamRendererOpts = {
+    /**
+     * Render tool execution lifecycle events (start/end).
+     * Default: false (assistant text only).
+     */
+    showToolEvents?: boolean;
+    /**
+     * Render model "thinking" deltas (if present).
+     * Default: false.
+     */
+    showThinking?: boolean;
+};
+/**
+ * Minimal renderer for pi JSONL event streams (pi CLI `--mode json` and pi SDK AgentEvent JSON).
+ *
+ * Intended usage:
+ *
+ * ```ts
+ * const r = new PiStreamRenderer();
+ * onLine: (line) => {
+ *   const out = r.renderLine(line);
+ *   if (out) process.stdout.write(out);
+ * }
+ * ```
+ */
+export declare class PiStreamRenderer {
+    #private;
+    constructor(opts?: PiStreamRendererOpts);
+    renderLine(line: string): string | null;
+}
+//# sourceMappingURL=pi_stream_renderer.d.ts.map

package/dist/pi_stream_renderer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pi_stream_renderer.d.ts","sourceRoot":"","sources":["../src/pi_stream_renderer.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,oBAAoB,GAAG;IAClC;;;OAGG;IACH,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB;;;OAGG;IACH,YAAY,CAAC,EAAE,OAAO,CAAC;CACvB,CAAC;AAEF;;;;;;;;;;;;GAYG;AACH,qBAAa,gBAAgB;;gBAKhB,IAAI,GAAE,oBAAyB;IAK3C,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI;CAkFvC"}

package/dist/pi_stream_renderer.js

@@ -0,0 +1,97 @@
+/**
+ * Minimal renderer for pi JSONL event streams (pi CLI `--mode json` and pi SDK AgentEvent JSON).
+ *
+ * Intended usage:
+ *
+ * ```ts
+ * const r = new PiStreamRenderer();
+ * onLine: (line) => {
+ *   const out = r.renderLine(line);
+ *   if (out) process.stdout.write(out);
+ * }
+ * ```
+ */
+export class PiStreamRenderer {
+    #showToolEvents;
+    #showThinking;
+    #needsNewline = false;
+    constructor(opts = {}) {
+        this.#showToolEvents = opts.showToolEvents ?? false;
+        this.#showThinking = opts.showThinking ?? false;
+    }
+    renderLine(line) {
+        let event;
+        try {
+            event = JSON.parse(line);
+        }
+        catch {
+            // Mixed stdout/stderr can include plain-text warnings; surface them.
+            if (!line)
+                return null;
+            this.#needsNewline = false;
+            return line.endsWith("\n") ? line : `${line}\n`;
+        }
+        const type = event?.type;
+        if (type === "message_update") {
+            const assistantEvent = event?.assistantMessageEvent;
+            if (assistantEvent?.type === "text_delta" && typeof assistantEvent.delta === "string") {
+                const delta = assistantEvent.delta;
+                if (!delta)
+                    return null;
+                this.#needsNewline = !delta.endsWith("\n");
+                return delta;
+            }
+            if (this.#showThinking &&
+                assistantEvent?.type === "thinking_delta" &&
+                typeof assistantEvent.delta === "string") {
+                const delta = assistantEvent.delta;
+                if (!delta)
+                    return null;
+                this.#needsNewline = !delta.endsWith("\n");
+                return delta;
+            }
+            if (assistantEvent?.type === "error") {
+                let out = "";
+                if (this.#needsNewline) {
+                    out += "\n";
+                    this.#needsNewline = false;
+                }
+                const reason = typeof assistantEvent.reason === "string" ? assistantEvent.reason : "error";
+                out += `[assistant:${reason}]\n`;
+                return out;
+            }
+            return null;
+        }
+        if (type === "message_end") {
+            const msg = event?.message;
+            if (msg && typeof msg === "object" && msg.role === "assistant") {
+                if (this.#needsNewline) {
+                    this.#needsNewline = false;
+                    return "\n";
+                }
+            }
+            return null;
+        }
+        if (this.#showToolEvents && type === "tool_execution_start") {
+            const toolName = typeof event?.toolName === "string" ? event.toolName : "tool";
+            let out = "";
+            if (this.#needsNewline) {
+                out += "\n";
+                this.#needsNewline = false;
+            }
+            out += `[tool] ${toolName}\n`;
+            return out;
+        }
+        if (this.#showToolEvents && type === "tool_execution_end" && event?.isError === true) {
+            const toolName = typeof event?.toolName === "string" ? event.toolName : "tool";
+            let out = "";
+            if (this.#needsNewline) {
+                out += "\n";
+                this.#needsNewline = false;
+            }
+            out += `[tool:error] ${toolName}\n`;
+            return out;
+        }
+        return null;
+    }
+}

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@femtomc/mu-orchestrator",
-	"version": "26.2.14",
+	"version": "26.2.16",
 	"type": "module",
 	"main": "./dist/index.js",
 	"types": "./dist/index.d.ts",
@@ -12,9 +12,9 @@
 	},
 	"files": ["dist/**"],
 	"dependencies": {
-		"@femtomc/mu-core": "26.2.14",
-		"@femtomc/mu-forum": "26.2.14",
-		"@femtomc/mu-issue": "26.2.14",
+		"@femtomc/mu-core": "26.2.16",
+		"@femtomc/mu-forum": "26.2.16",
+		"@femtomc/mu-issue": "26.2.16",
 		"@mariozechner/pi-agent-core": "^0.52.12",
 		"@mariozechner/pi-coding-agent": "^0.52.12",
 		"@mariozechner/pi-ai": "^0.52.12"