@sovara/runner 0.3.4 → 0.4.0

package/dist/context.js

@@ -1,73 +1,210 @@
 import { AsyncLocalStorage } from "node:async_hooks";
+import { loadAgentConnection, resolveProjectConfig } from "./agentCredentials.js";
 import { collectCodeVersion } from "./codeVersion.js";
 import { readRunnerConfig } from "./env.js";
-import { resolveProjectContext } from "./projectContext.js";
 import { installRunLogCapture } from "./runLogCapture.js";
-import { RuntimeClient } from "./runtimeClient.js";
+import { RuntimeClient, RuntimeClientError } from "./runtimeClient.js";
 import { ensureServerRunning } from "./serverLifecycle.js";
-import { startRunSseListener } from "./sseListener.js";
+import { isDegraded, markDegraded, raiseIfConfigError, SovaraConfigError } from "./failsafe.js";
 import { ensureMcpPatchInstalled } from "./mcpPatch.js";
+import { warnOnce } from "./util/logger.js";
 const scopeStorage = new AsyncLocalStorage();
-function normalizeOptions(input) {
-    if (typeof input === "string") {
-        return { name: input };
+const lessonScopeStorage = new AsyncLocalStorage();
+export const client = new RuntimeClient(readRunnerConfig().url);
+const ROOT_SCOPE_MARKERS = new Set(["", ".", "/"]);
+function normalizeRunOptions(input) {
+    const options = typeof input === "string" ? { name: input } : input;
+    const name = options.name.trim();
+    if (!name) {
+        throw new Error("withSovaraRun() name must be a non-empty string.");
+    }
+    return { ...options, name };
+}
+function normalizeSubrunOptions(input) {
+    const options = typeof input === "string" ? { name: input } : input;
+    const name = options.name.trim();
+    if (!name) {
+        throw new Error("withSovaraSubrun() name must be a non-empty string.");
+    }
+    return { ...options, name };
+}
+function normalizeLessonScopePath(path) {
+    if (typeof path !== "string") {
+        throw new Error("lessonScope paths must be strings.");
+    }
+    const raw = path.trim();
+    if (ROOT_SCOPE_MARKERS.has(raw))
+        return "";
+    if (raw.includes("//")) {
+        throw new Error("lessonScope paths must not contain '//'.");
+    }
+    const cleaned = raw.replace(/^\/+|\/+$/g, "");
+    if (!cleaned)
+        return "";
+    for (const segment of cleaned.split("/")) {
+        if (!segment || segment === "." || segment === ".." || segment.startsWith(".")) {
+            throw new Error(`Invalid lessonScope path segment: ${segment}`);
+        }
+    }
+    return `${cleaned}/`;
+}
+export function normalizeLessonScope(scope) {
+    if (scope === null || scope === undefined)
+        return null;
+    if (typeof scope === "string") {
+        const normalized = normalizeLessonScopePath(scope);
+        return normalized ? [normalized] : null;
+    }
+    if (!Array.isArray(scope)) {
+        throw new Error("lessonScope must be a string, string array, null, or undefined.");
+    }
+    const paths = [];
+    for (const item of scope) {
+        const normalized = normalizeLessonScopePath(item);
+        if (!normalized)
+            return null;
+        if (!paths.includes(normalized))
+            paths.push(normalized);
+    }
+    return paths;
+}
+function cloneLessonScopePaths(scopePaths) {
+    return scopePaths === null ? null : [...scopePaths];
+}
+function ambientLessonScopePaths() {
+    const scopePaths = lessonScopeStorage.getStore();
+    return scopePaths === undefined ? undefined : cloneLessonScopePaths(scopePaths);
+}
+function resolveLessonScope(lessonScope, fallback) {
+    return lessonScope === undefined
+        ? cloneLessonScopePaths(fallback)
+        : normalizeLessonScope(lessonScope);
+}
+function scopeWithLessonScope(parent, lessonScopePaths) {
+    return {
+        ...parent,
+        lessonScopePaths: cloneLessonScopePaths(lessonScopePaths),
+    };
+}
+function resolveRunProjectConfig(cwd, options) {
+    try {
+        return resolveProjectConfig(cwd, options.projectName);
+    }
+    catch (error) {
+        if (options.__testing?.client && options.__testing.skipLifecycle) {
+            return { projectName: "Project", projectRoot: cwd };
+        }
+        throw new SovaraConfigError(error instanceof Error ? error.message : String(error));
     }
-    return input;
 }
 export function getCurrentRunScope() {
     return scopeStorage.getStore();
 }
+function currentScopeFor(apiName) {
+    const scope = getCurrentRunScope();
+    if (!scope) {
+        warnOnce(apiName, `[sovara] ${apiName}() only works inside an active Sovara run.`);
+    }
+    return scope;
+}
+export function getRunId() {
+    return getCurrentRunScope()?.runId;
+}
+export async function logMetrics(metrics) {
+    const scope = currentScopeFor("logMetrics");
+    if (!scope)
+        return;
+    if (!scope.client.logMetrics)
+        return;
+    await scope.client.logMetrics({ runId: scope.runId, metrics });
+}
+export async function logInput(input) {
+    const scope = currentScopeFor("logInput");
+    if (!scope)
+        return;
+    if (!scope.client.logInput)
+        return;
+    await scope.client.logInput({ runId: scope.runId, value: input });
+}
+export async function logOutput(output) {
+    const scope = currentScopeFor("logOutput");
+    if (!scope)
+        return;
+    if (!scope.client.logOutput)
+        return;
+    await scope.client.logOutput({ runId: scope.runId, value: output });
+}
+export async function queueForAnnotation() {
+    const scope = currentScopeFor("queueForAnnotation");
+    if (!scope)
+        return;
+    if (!scope.client.requestAnnotationEvaluation)
+        return;
+    await scope.client.requestAnnotationEvaluation({ runId: scope.runId });
+}
 export async function withSovaraRun(input, fn) {
     await ensureMcpPatchInstalled();
-    const options = normalizeOptions(input);
+    const options = normalizeRunOptions(input);
     const parent = getCurrentRunScope();
+    if (!parent && isDegraded()) {
+        return await fn();
+    }
     if (parent) {
-        const subrun = await parent.client.registerSubrun({
-            name: options.name,
-            parentRunId: parent.runId,
-        });
-        const scope = {
-            runId: subrun.runId,
-            name: options.name,
-            url: parent.url,
-            client: parent.client,
-        };
-        try {
-            return await scopeStorage.run(scope, fn);
-        }
-        finally {
-            await parent.client.deregisterRun({ runId: scope.runId });
-        }
+        console.warn("withSovaraRun() was called inside an active run; ignoring nested run. Use withSovaraSubrun() for child agent execution.");
+        return await fn();
     }
     const config = readRunnerConfig();
-    const url = options.url ?? config.url;
+    const project = resolveRunProjectConfig(config.cwd, options);
+    const connection = loadAgentConnection(project.projectName);
+    const url = options.url ?? connection?.serverUrl ?? config.url;
     const skipLifecycle = options.__testing?.skipLifecycle ?? false;
     if (!skipLifecycle) {
-        await ensureServerRunning(url);
+        const reachable = await ensureServerRunning(url);
+        if (!reachable) {
+            return await fn(); // no-op: run user code without a scope
+        }
     }
-    const client = options.__testing?.client ?? new RuntimeClient(url);
-    const project = await resolveProjectContext(client, config.cwd, options.project, {
-        allowMissingProjectConfig: Boolean(options.__testing?.client
-            && skipLifecycle
-            && !options.__testing.requireProjectConfig),
-    });
+    const client = options.__testing?.client ?? new RuntimeClient(url, undefined, connection?.agentToken);
     const codeVersion = collectCodeVersion(project.projectRoot);
-    const registration = await client.registerRun({
-        name: options.name,
-        cwd: config.cwd,
-        command: process.argv.join(" "),
-        environment: config.environment,
-        projectId: project.projectId,
-        projectName: project.projectName,
-        projectDescription: project.projectDescription,
-        projectRoot: project.projectRoot,
-        codeVersion,
-    });
+    let registration;
+    try {
+        registration = await client.registerRun({
+            name: options.name,
+            clientRunId: options.clientRunId,
+            projectId: connection?.projectId,
+            projectName: project.projectName,
+            projectRoot: project.projectRoot,
+            codeVersion,
+        });
+    }
+    catch (error) {
+        raiseIfConfigError(error); // auth -> throw SovaraConfigError
+        warnOnce("register", "[sovara] Run registration failed; continuing without recording.");
+        markDegraded();
+        return await fn();
+    }
     const scope = {
         runId: registration.runId,
         name: options.name,
         url,
         client,
+        lessonScopePaths: resolveLessonScope(options.lessonScope, ambientLessonScopePaths() ?? null),
+    };
+    const pendingLogUpdates = new Set();
+    const trackLogUpdate = (update) => {
+        const tracked = update.catch((error) => {
+            // A buffered log chunk can reach the server after the run has been
+            // deregistered, which answers 409 "Run is not active". That race is
+            // benign — swallow it. Anything else is worth a one-time warning.
+            if (error instanceof RuntimeClientError && error.status === 409) {
+                return;
+            }
+            warnOnce("update-run-log-failed", "[sovara] Failed to update run log.");
+        });
+        pendingLogUpdates.add(tracked);
+        void tracked.finally(() => {
+            pendingLogUpdates.delete(tracked);
+        });
     };
     const stopLogCapture = options.captureLogs === false
         ? () => { }
@@ -75,27 +212,64 @@ export async function withSovaraRun(input, fn) {
             runId: registration.runId,
             resolveRunId: () => getCurrentRunScope()?.runId,
             onAppend: (runId, chunk) => {
-                void client.updateRunLog({ runId, logText: chunk, replace: false });
+                trackLogUpdate(client.updateRunLog({ runId, logText: chunk, replace: false }));
             },
         });
-    let shutdownRequested = false;
-    const sse = startRunSseListener({
-        url,
-        runId: registration.runId,
-        onShutdown: () => {
-            shutdownRequested = true;
-        },
-    });
     try {
         return await scopeStorage.run(scope, fn);
     }
     finally {
         stopLogCapture();
-        sse.close();
-        await client.deregisterRun({ runId: registration.runId });
-        if (shutdownRequested) {
-            // Deliberately do nothing in library mode: user code decides lifecycle.
+        // Flush in-flight log updates before finalizing the run, otherwise a late
+        // update lands after deregister and the server rejects it with 409.
+        await Promise.allSettled(pendingLogUpdates);
+        try {
+            await client.deregisterRun({ runId: registration.runId });
+        }
+        catch (error) {
+            // If the run was already finalized server-side (e.g. the connection
+            // dropped early and the server's disconnect handler finished it), the
+            // deregister answers 409 "Run is not active". That is benign.
+            if (!(error instanceof RuntimeClientError && error.status === 409)) {
+                throw error;
+            }
         }
     }
 }
+export async function withSovaraSubrun(input, fn) {
+    const options = normalizeSubrunOptions(input);
+    const parent = getCurrentRunScope();
+    if (!parent) {
+        throw new Error("withSovaraSubrun() requires an active Sovara run.");
+    }
+    const lessonScopePaths = resolveLessonScope(options.lessonScope, parent.lessonScopePaths);
+    const subrun = await parent.client.registerSubrun({
+        name: options.name,
+        parentRunId: parent.runId,
+        lessonScopePaths,
+    });
+    const scope = {
+        runId: subrun.runId,
+        name: options.name,
+        url: parent.url,
+        client: parent.client,
+        lessonScopePaths,
+    };
+    try {
+        return await scopeStorage.run(scope, fn);
+    }
+    finally {
+        await parent.client.deregisterRun({ runId: scope.runId });
+    }
+}
+export async function withLessonScope(lessonScope, fn) {
+    const lessonScopePaths = normalizeLessonScope(lessonScope);
+    const parent = getCurrentRunScope();
+    return await lessonScopeStorage.run(lessonScopePaths, async () => {
+        if (!parent) {
+            return await fn();
+        }
+        return await scopeStorage.run(scopeWithLessonScope(parent, lessonScopePaths), fn);
+    });
+}
 //# sourceMappingURL=context.js.map

package/dist/context.js.map

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

package/dist/env.d.ts

@@ -1,6 +1,5 @@
 export type RunnerConfig = {
     cwd: string;
-    environment: Record<string, string>;
     url: string;
 };
 export declare function resolveServerURL(): string;

package/dist/env.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"env.d.ts","sourceRoot":"","sources":["../src/env.ts"],"names":[],"mappings":"AAEA,MAAM,MAAM,YAAY,GAAG;IACzB,GAAG,EAAE,MAAM,CAAC;IACZ,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACpC,GAAG,EAAE,MAAM,CAAC;CACb,CAAC;AAEF,wBAAgB,gBAAgB,IAAI,MAAM,CAEzC;AAED,wBAAgB,gBAAgB,IAAI,YAAY,CAU/C"}
+{"version":3,"file":"env.d.ts","sourceRoot":"","sources":["../src/env.ts"],"names":[],"mappings":"AAEA,MAAM,MAAM,YAAY,GAAG;IACzB,GAAG,EAAE,MAAM,CAAC;IACZ,GAAG,EAAE,MAAM,CAAC;CACb,CAAC;AAEF,wBAAgB,gBAAgB,IAAI,MAAM,CAEzC;AAED,wBAAgB,gBAAgB,IAAI,YAAY,CAK/C"}

package/dist/env.js

@@ -3,10 +3,8 @@ export function resolveServerURL() {
     return DEFAULT_SERVER_URL;
 }
 export function readRunnerConfig() {
-    const environment = Object.fromEntries(Object.entries(process.env).filter(([, value]) => typeof value === "string"));
     return {
         cwd: process.cwd(),
-        environment,
         url: resolveServerURL(),
     };
 }

package/dist/env.js.map

@@ -1 +1 @@
-{"version":3,"file":"env.js","sourceRoot":"","sources":["../src/env.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AAQpD,MAAM,UAAU,gBAAgB;IAC9B,OAAO,kBAAkB,CAAC;AAC5B,CAAC;AAED,MAAM,UAAU,gBAAgB;IAC9B,MAAM,WAAW,GAAG,MAAM,CAAC,WAAW,CACpC,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,KAAK,CAAC,EAAE,EAAE,CAAC,OAAO,KAAK,KAAK,QAAQ,CAAC,CACnD,CAAC;IAE5B,OAAO;QACL,GAAG,EAAE,OAAO,CAAC,GAAG,EAAE;QAClB,WAAW;QACX,GAAG,EAAE,gBAAgB,EAAE;KACxB,CAAC;AACJ,CAAC"}
+{"version":3,"file":"env.js","sourceRoot":"","sources":["../src/env.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AAOpD,MAAM,UAAU,gBAAgB;IAC9B,OAAO,kBAAkB,CAAC;AAC5B,CAAC;AAED,MAAM,UAAU,gBAAgB;IAC9B,OAAO;QACL,GAAG,EAAE,OAAO,CAAC,GAAG,EAAE;QAClB,GAAG,EAAE,gBAAgB,EAAE;KACxB,CAAC;AACJ,CAAC"}

package/dist/failsafe.d.ts

@@ -0,0 +1,8 @@
+export declare class SovaraConfigError extends Error {
+}
+export declare function markDegraded(): void;
+export declare function isDegraded(): boolean;
+export declare function resetDegraded(): void;
+export declare function isAuthError(err: unknown): boolean;
+export declare function raiseIfConfigError(err: unknown): void;
+//# sourceMappingURL=failsafe.d.ts.map

package/dist/failsafe.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"failsafe.d.ts","sourceRoot":"","sources":["../src/failsafe.ts"],"names":[],"mappings":"AAEA,qBAAa,iBAAkB,SAAQ,KAAK;CAAG;AAI/C,wBAAgB,YAAY,IAAI,IAAI,CAEnC;AAED,wBAAgB,UAAU,IAAI,OAAO,CAEpC;AAED,wBAAgB,aAAa,IAAI,IAAI,CAEpC;AAED,wBAAgB,WAAW,CAAC,GAAG,EAAE,OAAO,GAAG,OAAO,CAKjD;AAED,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,OAAO,GAAG,IAAI,CAWrD"}

package/dist/failsafe.js

@@ -0,0 +1,28 @@
+import { RuntimeClientError } from "./runtimeClient.js";
+export class SovaraConfigError extends Error {
+}
+let degraded = false;
+export function markDegraded() {
+    degraded = true;
+}
+export function isDegraded() {
+    return degraded;
+}
+export function resetDegraded() {
+    degraded = false;
+}
+export function isAuthError(err) {
+    return (err instanceof RuntimeClientError &&
+        (err.status === 401 || err.status === 403));
+}
+export function raiseIfConfigError(err) {
+    if (err instanceof SovaraConfigError) {
+        throw err;
+    }
+    if (isAuthError(err)) {
+        const status = err.status;
+        throw new SovaraConfigError(`Sovara rejected the agent token (HTTP ${status}). ` +
+            "Reconnect this project with `sovara connect-agent` or set SOVARA_AGENT_TOKEN.");
+    }
+}
+//# sourceMappingURL=failsafe.js.map

package/dist/failsafe.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"failsafe.js","sourceRoot":"","sources":["../src/failsafe.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AAExD,MAAM,OAAO,iBAAkB,SAAQ,KAAK;CAAG;AAE/C,IAAI,QAAQ,GAAG,KAAK,CAAC;AAErB,MAAM,UAAU,YAAY;IAC1B,QAAQ,GAAG,IAAI,CAAC;AAClB,CAAC;AAED,MAAM,UAAU,UAAU;IACxB,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED,MAAM,UAAU,aAAa;IAC3B,QAAQ,GAAG,KAAK,CAAC;AACnB,CAAC;AAED,MAAM,UAAU,WAAW,CAAC,GAAY;IACtC,OAAO,CACL,GAAG,YAAY,kBAAkB;QACjC,CAAC,GAAG,CAAC,MAAM,KAAK,GAAG,IAAI,GAAG,CAAC,MAAM,KAAK,GAAG,CAAC,CAC3C,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,kBAAkB,CAAC,GAAY;IAC7C,IAAI,GAAG,YAAY,iBAAiB,EAAE,CAAC;QACrC,MAAM,GAAG,CAAC;IACZ,CAAC;IACD,IAAI,WAAW,CAAC,GAAG,CAAC,EAAE,CAAC;QACrB,MAAM,MAAM,GAAI,GAA0B,CAAC,MAAM,CAAC;QAClD,MAAM,IAAI,iBAAiB,CACzB,yCAAyC,MAAM,KAAK;YAClD,+EAA+E,CAClF,CAAC;IACJ,CAAC;AACH,CAAC"}

package/dist/index.d.ts

@@ -1,8 +1,6 @@
-export { withSovaraRun } from "./context.js";
-export type { WithSovaraRunOptions } from "./context.js";
-export { evaluateAnnotation, evaluateAnnotationAsync } from "./annotation.js";
-export { injectPriors, renderPriorsBlock } from "./priors.js";
-export type { InjectPriorsMethod } from "./priors.js";
+export { client, getRunId, logInput, logMetrics, logOutput, queueForAnnotation, withLessonScope, withSovaraRun, withSovaraSubrun, } from "./context.js";
+export type { LessonScopeInput, WithSovaraRunOptions, WithSovaraSubrunOptions } from "./context.js";
+export { injectLessons, renderLessonsBlock } from "./lessons.js";
 export { trace } from "./trace.js";
 export type { TraceOptions } from "./trace.js";
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAQA,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAC7C,YAAY,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAC;AACzD,OAAO,EAAE,kBAAkB,EAAE,uBAAuB,EAAE,MAAM,iBAAiB,CAAC;AAC9E,OAAO,EAAE,YAAY,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAC9D,YAAY,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AACtD,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AACnC,YAAY,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAgBA,OAAO,EACL,MAAM,EACN,QAAQ,EACR,QAAQ,EACR,UAAU,EACV,SAAS,EACT,kBAAkB,EAClB,eAAe,EACf,aAAa,EACb,gBAAgB,GACjB,MAAM,cAAc,CAAC;AACtB,YAAY,EAAE,gBAAgB,EAAE,oBAAoB,EAAE,uBAAuB,EAAE,MAAM,cAAc,CAAC;AACpG,OAAO,EAAE,aAAa,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC;AACjE,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AACnC,YAAY,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC"}

package/dist/index.js

@@ -1,11 +1,16 @@
 import { installFetchPatch } from "./transport/fetchPatch.js";
 import { installNodeHttpPatch } from "./transport/nodeHttpPatch.js";
 import { installAwsSdkHttp2Patch } from "./transport/awsSdkHttp2Patch.js";
-installFetchPatch();
-installNodeHttpPatch();
-installAwsSdkHttp2Patch();
-export { withSovaraRun } from "./context.js";
-export { evaluateAnnotation, evaluateAnnotationAsync } from "./annotation.js";
-export { injectPriors, renderPriorsBlock } from "./priors.js";
+import { warnOnce } from "./util/logger.js";
+try {
+    installFetchPatch();
+    installNodeHttpPatch();
+    installAwsSdkHttp2Patch();
+}
+catch {
+    warnOnce("install-patches", "[sovara] Failed to install transport patches; continuing.");
+}
+export { client, getRunId, logInput, logMetrics, logOutput, queueForAnnotation, withLessonScope, withSovaraRun, withSovaraSubrun, } from "./context.js";
+export { injectLessons, renderLessonsBlock } from "./lessons.js";
 export { trace } from "./trace.js";
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAC;AAC9D,OAAO,EAAE,oBAAoB,EAAE,MAAM,8BAA8B,CAAC;AACpE,OAAO,EAAE,uBAAuB,EAAE,MAAM,iCAAiC,CAAC;AAE1E,iBAAiB,EAAE,CAAC;AACpB,oBAAoB,EAAE,CAAC;AACvB,uBAAuB,EAAE,CAAC;AAE1B,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAE7C,OAAO,EAAE,kBAAkB,EAAE,uBAAuB,EAAE,MAAM,iBAAiB,CAAC;AAC9E,OAAO,EAAE,YAAY,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAE9D,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAC;AAC9D,OAAO,EAAE,oBAAoB,EAAE,MAAM,8BAA8B,CAAC;AACpE,OAAO,EAAE,uBAAuB,EAAE,MAAM,iCAAiC,CAAC;AAC1E,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAE5C,IAAI,CAAC;IACH,iBAAiB,EAAE,CAAC;IACpB,oBAAoB,EAAE,CAAC;IACvB,uBAAuB,EAAE,CAAC;AAC5B,CAAC;AAAC,MAAM,CAAC;IACP,QAAQ,CACN,iBAAiB,EACjB,2DAA2D,CAC5D,CAAC;AACJ,CAAC;AAED,OAAO,EACL,MAAM,EACN,QAAQ,EACR,QAAQ,EACR,UAAU,EACV,SAAS,EACT,kBAAkB,EAClB,eAAe,EACf,aAAa,EACb,gBAAgB,GACjB,MAAM,cAAc,CAAC;AAEtB,OAAO,EAAE,aAAa,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC;AACjE,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC"}

package/dist/lessons.d.ts

@@ -0,0 +1,6 @@
+import type { LessonRecord } from "./runtimeClient.js";
+export declare function renderLessonsBlock(lessons: LessonRecord[], options?: {
+    manual?: boolean;
+}): string;
+export declare function injectLessons(context: unknown): Promise<string>;
+//# sourceMappingURL=lessons.d.ts.map

package/dist/lessons.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lessons.d.ts","sourceRoot":"","sources":["../src/lessons.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAUvD,wBAAgB,kBAAkB,CAChC,OAAO,EAAE,YAAY,EAAE,EACvB,OAAO,GAAE;IAAE,MAAM,CAAC,EAAE,OAAO,CAAA;CAAO,GACjC,MAAM,CA6BR;AAaD,wBAAsB,aAAa,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,MAAM,CAAC,CAgCrE"}

package/dist/lessons.js

@@ -0,0 +1,68 @@
+import { readFileSync } from "node:fs";
+import { fileURLToPath } from "node:url";
+import { getCurrentRunScope } from "./context.js";
+import { warnOnce } from "./util/logger.js";
+const LESSONS_BLOCK_GUIDANCE = JSON.parse(readFileSync(fileURLToPath(new URL("./lessonsBlockGuidance.json", import.meta.url)), "utf8")).guidance;
+export function renderLessonsBlock(lessons, options = {}) {
+    if (lessons.length === 0) {
+        return "";
+    }
+    const manifest = {
+        lessons: lessons
+            .filter((lesson) => typeof lesson.lesson_id === "string" && lesson.lesson_id.length > 0)
+            .map((lesson) => ({ lesson_id: lesson.lesson_id })),
+    };
+    if (options.manual) {
+        manifest.manual = true;
+    }
+    const blocks = lessons
+        .map((lesson) => {
+        const heading = lesson.title ?? lesson.name ?? lesson.lesson_id ?? "Untitled";
+        const body = lesson.content ?? "";
+        return `## ${heading}\n${body}`;
+    })
+        .join("\n\n");
+    return ("<sovara-lessons>\n" +
+        `<!-- ${JSON.stringify(manifest)} -->\n` +
+        `${LESSONS_BLOCK_GUIDANCE}\n\n` +
+        `${blocks}\n` +
+        "</sovara-lessons>");
+}
+function stringifyContext(context) {
+    if (typeof context === "string") {
+        return context;
+    }
+    try {
+        return JSON.stringify(context, null, 2);
+    }
+    catch {
+        return String(context);
+    }
+}
+export async function injectLessons(context) {
+    if (context === null || context === undefined) {
+        throw new Error("context is required for injectLessons()");
+    }
+    const scope = getCurrentRunScope();
+    if (!scope) {
+        warnOnce("injectLessons:no-active-run", "[sovara] injectLessons() called outside of withSovaraRun(); returning empty context.");
+        return "";
+    }
+    const { client } = scope;
+    try {
+        if (!client.retrieveLessons) {
+            return "";
+        }
+        const { lessons } = await client.retrieveLessons({
+            runId: scope.runId,
+            scopePaths: scope.lessonScopePaths,
+            context: stringifyContext(context),
+        });
+        return renderLessonsBlock(lessons, { manual: true });
+    }
+    catch (error) {
+        warnOnce("injectLessons:fetch-failed", `[sovara] injectLessons() failed: ${error instanceof Error ? error.message : String(error)}`);
+        return "";
+    }
+}
+//# sourceMappingURL=lessons.js.map

package/dist/lessons.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"lessons.js","sourceRoot":"","sources":["../src/lessons.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACvC,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AACzC,OAAO,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC;AAElD,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAE5C,MAAM,sBAAsB,GAAW,IAAI,CAAC,KAAK,CAC/C,YAAY,CACV,aAAa,CAAC,IAAI,GAAG,CAAC,6BAA6B,EAAE,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EACtE,MAAM,CACP,CACF,CAAC,QAAQ,CAAC;AAEX,MAAM,UAAU,kBAAkB,CAChC,OAAuB,EACvB,UAAgC,EAAE;IAElC,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACzB,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,MAAM,QAAQ,GAA4B;QACxC,OAAO,EAAE,OAAO;aACb,MAAM,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,OAAO,MAAM,CAAC,SAAS,KAAK,QAAQ,IAAI,MAAM,CAAC,SAAS,CAAC,MAAM,GAAG,CAAC,CAAC;aACvF,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,EAAE,SAAS,EAAE,MAAM,CAAC,SAAS,EAAE,CAAC,CAAC;KACtD,CAAC;IACF,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;QACnB,QAAQ,CAAC,MAAM,GAAG,IAAI,CAAC;IACzB,CAAC;IAED,MAAM,MAAM,GAAG,OAAO;SACnB,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE;QACd,MAAM,OAAO,GAAG,MAAM,CAAC,KAAK,IAAI,MAAM,CAAC,IAAI,IAAI,MAAM,CAAC,SAAS,IAAI,UAAU,CAAC;QAC9E,MAAM,IAAI,GAAG,MAAM,CAAC,OAAO,IAAI,EAAE,CAAC;QAClC,OAAO,MAAM,OAAO,KAAK,IAAI,EAAE,CAAC;IAClC,CAAC,CAAC;SACD,IAAI,CAAC,MAAM,CAAC,CAAC;IAEhB,OAAO,CACL,oBAAoB;QACpB,QAAQ,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,QAAQ;QACxC,GAAG,sBAAsB,MAAM;QAC/B,GAAG,MAAM,IAAI;QACb,mBAAmB,CACpB,CAAC;AACJ,CAAC;AAED,SAAS,gBAAgB,CAAC,OAAgB;IACxC,IAAI,OAAO,OAAO,KAAK,QAAQ,EAAE,CAAC;QAChC,OAAO,OAAO,CAAC;IACjB,CAAC;IACD,IAAI,CAAC;QACH,OAAO,IAAI,CAAC,SAAS,CAAC,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;IAC1C,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,MAAM,CAAC,OAAO,CAAC,CAAC;IACzB,CAAC;AACH,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,aAAa,CAAC,OAAgB;IAClD,IAAI,OAAO,KAAK,IAAI,IAAI,OAAO,KAAK,SAAS,EAAE,CAAC;QAC9C,MAAM,IAAI,KAAK,CAAC,yCAAyC,CAAC,CAAC;IAC7D,CAAC;IACD,MAAM,KAAK,GAAG,kBAAkB,EAAE,CAAC;IACnC,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,QAAQ,CACN,6BAA6B,EAC7B,sFAAsF,CACvF,CAAC;QACF,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,MAAM,EAAE,MAAM,EAAE,GAAG,KAAK,CAAC;IAEzB,IAAI,CAAC;QACH,IAAI,CAAC,MAAM,CAAC,eAAe,EAAE,CAAC;YAC5B,OAAO,EAAE,CAAC;QACZ,CAAC;QACD,MAAM,EAAE,OAAO,EAAE,GAAG,MAAM,MAAM,CAAC,eAAe,CAAC;YAC/C,KAAK,EAAE,KAAK,CAAC,KAAK;YAClB,UAAU,EAAE,KAAK,CAAC,gBAAgB;YAClC,OAAO,EAAE,gBAAgB,CAAC,OAAO,CAAC;SACnC,CAAC,CAAC;QACH,OAAO,kBAAkB,CAAC,OAAO,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC;IACvD,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,QAAQ,CACN,4BAA4B,EAC5B,oCAAoC,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAC7F,CAAC;QACF,OAAO,EAAE,CAAC;IACZ,CAAC;AACH,CAAC"}

package/dist/lessonsBlockGuidance.json

@@ -0,0 +1,3 @@
+{
+  "guidance": "These retrieved lessons are mandatory operating constraints for the current task when relevant. Because they were retrieved for this prompt, assume they are relevant unless there is a clear reason they do not apply. Before answering, identify internally which lessons apply and use them to shape the response. If a relevant lesson conflicts with your default reasoning, source phrasing, or broader habits, follow the lesson unless the user explicitly asks otherwise. Do not add content or framing that weakens, bypasses, or contradicts a relevant lesson."
+}

package/dist/mcpPatch.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"mcpPatch.d.ts","sourceRoot":"","sources":["../src/mcpPatch.ts"],"names":[],"mappings":"AAiMA,wBAAsB,uBAAuB,IAAI,OAAO,CAAC,IAAI,CAAC,CA0C7D"}
+{"version":3,"file":"mcpPatch.d.ts","sourceRoot":"","sources":["../src/mcpPatch.ts"],"names":[],"mappings":"AAsMA,wBAAsB,uBAAuB,IAAI,OAAO,CAAC,IAAI,CAAC,CA0C7D"}