@assemblyline-agents/runtime 1.0.0 → 3.0.0

package/dist/automation-event-match.js

@@ -0,0 +1,25 @@
+import { isJsonObject } from "./json-util.js";
+export function matchingEventAutomations(manifest, event) {
+    return (manifest.automationRegistrations ?? []).filter((automation) => eventAutomationMatches(automation, event));
+}
+export function eventAutomationMatches(automation, event) {
+    if (automation.trigger.type !== "event")
+        return false;
+    if (automation.trigger.source !== event.source || automation.trigger.event !== event.event)
+        return false;
+    if (automation.trigger.connection && automation.trigger.connection !== event.connection)
+        return false;
+    return !automation.trigger.filter || jsonSubsetMatches(automation.trigger.filter, event.payload);
+}
+function jsonSubsetMatches(expected, actual) {
+    return Object.entries(expected).every(([key, expectedValue]) => {
+        if (!Object.prototype.hasOwnProperty.call(actual, key))
+            return false;
+        const actualValue = actual[key];
+        if (isJsonObject(expectedValue)) {
+            return isJsonObject(actualValue) && jsonSubsetMatches(expectedValue, actualValue);
+        }
+        return JSON.stringify(expectedValue) === JSON.stringify(actualValue);
+    });
+}
+//# sourceMappingURL=automation-event-match.js.map

package/dist/automation-event-match.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"automation-event-match.js","sourceRoot":"","sources":["../src/automation-event-match.ts"],"names":[],"mappings":"AAOA,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAI9C,MAAM,UAAU,wBAAwB,CACtC,QAAwD,EACxD,KAAsB;IAEtB,OAAO,CAAC,QAAQ,CAAC,uBAAuB,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,UAAU,EAAE,EAAE,CAAC,sBAAsB,CAAC,UAAU,EAAE,KAAK,CAAC,CAAC,CAAC;AACpH,CAAC;AAED,MAAM,UAAU,sBAAsB,CACpC,UAAkC,EAClC,KAAsB;IAEtB,IAAI,UAAU,CAAC,OAAO,CAAC,IAAI,KAAK,OAAO;QAAE,OAAO,KAAK,CAAC;IACtD,IAAI,UAAU,CAAC,OAAO,CAAC,MAAM,KAAK,KAAK,CAAC,MAAM,IAAI,UAAU,CAAC,OAAO,CAAC,KAAK,KAAK,KAAK,CAAC,KAAK;QAAE,OAAO,KAAK,CAAC;IACzG,IAAI,UAAU,CAAC,OAAO,CAAC,UAAU,IAAI,UAAU,CAAC,OAAO,CAAC,UAAU,KAAK,KAAK,CAAC,UAAU;QAAE,OAAO,KAAK,CAAC;IACtG,OAAO,CAAC,UAAU,CAAC,OAAO,CAAC,MAAM,IAAI,iBAAiB,CAAC,UAAU,CAAC,OAAO,CAAC,MAAM,EAAE,KAAK,CAAC,OAAO,CAAC,CAAC;AACnG,CAAC;AAED,SAAS,iBAAiB,CAAC,QAAoB,EAAE,MAAkB;IACjE,OAAO,MAAM,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,GAAG,EAAE,aAAa,CAAC,EAAE,EAAE;QAC7D,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,cAAc,CAAC,IAAI,CAAC,MAAM,EAAE,GAAG,CAAC;YAAE,OAAO,KAAK,CAAC;QACrE,MAAM,WAAW,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC;QAChC,IAAI,YAAY,CAAC,aAAa,CAAC,EAAE,CAAC;YAChC,OAAO,YAAY,CAAC,WAAW,CAAC,IAAI,iBAAiB,CAAC,aAAa,EAAE,WAAW,CAAC,CAAC;QACpF,CAAC;QACD,OAAO,IAAI,CAAC,SAAS,CAAC,aAAa,CAAC,KAAK,IAAI,CAAC,SAAS,CAAC,WAAW,CAAC,CAAC;IACvE,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/background-review-trigger.d.ts

@@ -0,0 +1,9 @@
+import type { BackgroundReviewJobRecord } from "./learning-store.js";
+import type { BackgroundReviewHost } from "./background-review-types.js";
+/** Decide whether a completed foreground run carries enough signal to review. */
+export declare function enqueueBackgroundReviewForCompletedRun(host: BackgroundReviewHost, runId: string): Promise<BackgroundReviewJobRecord | undefined>;
+export declare function enqueueBackgroundReviewForFeedback(host: BackgroundReviewHost, runId: string, feedback: {
+    rating: "positive" | "negative";
+    comment?: string;
+}): Promise<BackgroundReviewJobRecord>;
+//# sourceMappingURL=background-review-trigger.d.ts.map

package/dist/background-review-trigger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"background-review-trigger.d.ts","sourceRoot":"","sources":["../src/background-review-trigger.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,qBAAqB,CAAC;AACrE,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,8BAA8B,CAAC;AAMzE,iFAAiF;AACjF,wBAAsB,sCAAsC,CAC1D,IAAI,EAAE,oBAAoB,EAC1B,KAAK,EAAE,MAAM,GACZ,OAAO,CAAC,yBAAyB,GAAG,SAAS,CAAC,CAwChD;AAED,wBAAsB,kCAAkC,CACtD,IAAI,EAAE,oBAAoB,EAC1B,KAAK,EAAE,MAAM,EACb,QAAQ,EAAE;IAAE,MAAM,EAAE,UAAU,GAAG,UAAU,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAA;CAAE,GAC9D,OAAO,CAAC,yBAAyB,CAAC,CAkBpC"}

package/dist/background-review-trigger.js

@@ -0,0 +1,72 @@
+function object(value) {
+    return value && typeof value === "object" && !Array.isArray(value) ? value : {};
+}
+/** Decide whether a completed foreground run carries enough signal to review. */
+export async function enqueueBackgroundReviewForCompletedRun(host, runId) {
+    const run = await host.state.getRun(runId);
+    if (!run || run.status !== "completed" || run.input.purpose === "background_review")
+        return undefined;
+    const config = host.skillsConfigForRun(run);
+    if (!config.enabled)
+        return undefined;
+    const scope = host.skillScopeForRun(run);
+    const [toolCalls, events] = await Promise.all([
+        host.state.listToolCalls(runId),
+        host.state.listEvents(runId)
+    ]);
+    const reasons = [];
+    const failedTools = toolCalls.filter((call) => call.status === "failed" || call.status === "timeout");
+    if (toolCalls.length >= config.reviewMinToolCalls)
+        reasons.push("complex_tool_use");
+    if (failedTools.length > 0)
+        reasons.push("recovered_tool_error");
+    const loadedSkill = events.some((event) => event.type === "skill.loaded");
+    if (loadedSkill && (failedTools.length > 0 || toolCalls.length >= config.reviewMinToolCalls)) {
+        reasons.push("skill_used_in_difficult_run");
+    }
+    const counterKey = "self-improvement:turn-count";
+    const currentCounter = object((await host.state.getSetting(scope, counterKey))?.value);
+    const alreadyCounted = currentCounter.lastRunId === runId;
+    const turnCount = alreadyCounted
+        ? (typeof currentCounter.count === "number" ? currentCounter.count : 0)
+        : (typeof currentCounter.count === "number" ? currentCounter.count : 0) + 1;
+    if (!alreadyCounted) {
+        await host.state.setSetting(scope, counterKey, { count: turnCount, lastRunId: runId });
+    }
+    if (!alreadyCounted && turnCount > 0 && turnCount % config.reviewEveryTurns === 0) {
+        reasons.push("turn_cadence");
+    }
+    if (reasons.length === 0)
+        return undefined;
+    const job = await host.learningStore.enqueueBackgroundReview({
+        scope,
+        sourceRunId: runId,
+        idempotencyKey: `run:${runId}`,
+        reasons,
+        now: host.now()
+    });
+    await host.state.appendEvent(runId, "learning.review_queued", { jobId: job.id, reasons: job.reasons });
+    return job;
+}
+export async function enqueueBackgroundReviewForFeedback(host, runId, feedback) {
+    const run = await host.state.getRun(runId);
+    if (!run || run.input.purpose === "background_review")
+        throw new Error(`Foreground run not found: ${runId}`);
+    if (!host.skillsConfigForRun(run).enabled)
+        throw new Error("Self-improvement is disabled.");
+    const comment = feedback.comment?.slice(0, 4_000);
+    const event = await host.state.appendEvent(runId, "learning.feedback_received", {
+        rating: feedback.rating,
+        ...(comment ? { comment } : {})
+    });
+    const job = await host.learningStore.enqueueBackgroundReview({
+        scope: host.skillScopeForRun(run),
+        sourceRunId: runId,
+        idempotencyKey: `feedback:${event.id}`,
+        reasons: ["explicit_feedback"],
+        now: host.now()
+    });
+    await host.state.appendEvent(runId, "learning.review_queued", { jobId: job.id, reasons: job.reasons });
+    return job;
+}
+//# sourceMappingURL=background-review-trigger.js.map

package/dist/background-review-trigger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"background-review-trigger.js","sourceRoot":"","sources":["../src/background-review-trigger.ts"],"names":[],"mappings":"AAGA,SAAS,MAAM,CAAC,KAAc;IAC5B,OAAO,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAgC,CAAC,CAAC,CAAC,EAAE,CAAC;AAC7G,CAAC;AAED,iFAAiF;AACjF,MAAM,CAAC,KAAK,UAAU,sCAAsC,CAC1D,IAA0B,EAC1B,KAAa;IAEb,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IAC3C,IAAI,CAAC,GAAG,IAAI,GAAG,CAAC,MAAM,KAAK,WAAW,IAAI,GAAG,CAAC,KAAK,CAAC,OAAO,KAAK,mBAAmB;QAAE,OAAO,SAAS,CAAC;IACtG,MAAM,MAAM,GAAG,IAAI,CAAC,kBAAkB,CAAC,GAAG,CAAC,CAAC;IAC5C,IAAI,CAAC,MAAM,CAAC,OAAO;QAAE,OAAO,SAAS,CAAC;IACtC,MAAM,KAAK,GAAG,IAAI,CAAC,gBAAgB,CAAC,GAAG,CAAC,CAAC;IACzC,MAAM,CAAC,SAAS,EAAE,MAAM,CAAC,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC;QAC5C,IAAI,CAAC,KAAK,CAAC,aAAa,CAAC,KAAK,CAAC;QAC/B,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,KAAK,CAAC;KAC7B,CAAC,CAAC;IACH,MAAM,OAAO,GAAa,EAAE,CAAC;IAC7B,MAAM,WAAW,GAAG,SAAS,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,MAAM,KAAK,QAAQ,IAAI,IAAI,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC;IACtG,IAAI,SAAS,CAAC,MAAM,IAAI,MAAM,CAAC,kBAAkB;QAAE,OAAO,CAAC,IAAI,CAAC,kBAAkB,CAAC,CAAC;IACpF,IAAI,WAAW,CAAC,MAAM,GAAG,CAAC;QAAE,OAAO,CAAC,IAAI,CAAC,sBAAsB,CAAC,CAAC;IACjE,MAAM,WAAW,GAAG,MAAM,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,KAAK,cAAc,CAAC,CAAC;IAC1E,IAAI,WAAW,IAAI,CAAC,WAAW,CAAC,MAAM,GAAG,CAAC,IAAI,SAAS,CAAC,MAAM,IAAI,MAAM,CAAC,kBAAkB,CAAC,EAAE,CAAC;QAC7F,OAAO,CAAC,IAAI,CAAC,6BAA6B,CAAC,CAAC;IAC9C,CAAC;IACD,MAAM,UAAU,GAAG,6BAA6B,CAAC;IACjD,MAAM,cAAc,GAAG,MAAM,CAAC,CAAC,MAAM,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,KAAK,EAAE,UAAU,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC;IACvF,MAAM,cAAc,GAAG,cAAc,CAAC,SAAS,KAAK,KAAK,CAAC;IAC1D,MAAM,SAAS,GAAG,cAAc;QAC9B,CAAC,CAAC,CAAC,OAAO,cAAc,CAAC,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,cAAc,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;QACvE,CAAC,CAAC,CAAC,OAAO,cAAc,CAAC,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,cAAc,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;IAC9E,IAAI,CAAC,cAAc,EAAE,CAAC;QACpB,MAAM,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,KAAK,EAAE,UAAU,EAAE,EAAE,KAAK,EAAE,SAAS,EAAE,SAAS,EAAE,KAAK,EAAE,CAAC,CAAC;IACzF,CAAC;IACD,IAAI,CAAC,cAAc,IAAI,SAAS,GAAG,CAAC,IAAI,SAAS,GAAG,MAAM,CAAC,gBAAgB,KAAK,CAAC,EAAE,CAAC;QAClF,OAAO,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;IAC/B,CAAC;IACD,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,SAAS,CAAC;IAC3C,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,aAAa,CAAC,uBAAuB,CAAC;QAC3D,KAAK;QACL,WAAW,EAAE,KAAK;QAClB,cAAc,EAAE,OAAO,KAAK,EAAE;QAC9B,OAAO;QACP,GAAG,EAAE,IAAI,CAAC,GAAG,EAAE;KAChB,CAAC,CAAC;IACH,MAAM,IAAI,CAAC,KAAK,CAAC,WAAW,CAAC,KAAK,EAAE,wBAAwB,EAAE,EAAE,KAAK,EAAE,GAAG,CAAC,EAAE,EAAE,OAAO,EAAE,GAAG,CAAC,OAAO,EAAE,CAAC,CAAC;IACvG,OAAO,GAAG,CAAC;AACb,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,kCAAkC,CACtD,IAA0B,EAC1B,KAAa,EACb,QAA+D;IAE/D,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IAC3C,IAAI,CAAC,GAAG,IAAI,GAAG,CAAC,KAAK,CAAC,OAAO,KAAK,mBAAmB;QAAE,MAAM,IAAI,KAAK,CAAC,6BAA6B,KAAK,EAAE,CAAC,CAAC;IAC7G,IAAI,CAAC,IAAI,CAAC,kBAAkB,CAAC,GAAG,CAAC,CAAC,OAAO;QAAE,MAAM,IAAI,KAAK,CAAC,+BAA+B,CAAC,CAAC;IAC5F,MAAM,OAAO,GAAG,QAAQ,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC;IAClD,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,WAAW,CAAC,KAAK,EAAE,4BAA4B,EAAE;QAC9E,MAAM,EAAE,QAAQ,CAAC,MAAM;QACvB,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KAChC,CAAC,CAAC;IACH,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,aAAa,CAAC,uBAAuB,CAAC;QAC3D,KAAK,EAAE,IAAI,CAAC,gBAAgB,CAAC,GAAG,CAAC;QACjC,WAAW,EAAE,KAAK;QAClB,cAAc,EAAE,YAAY,KAAK,CAAC,EAAE,EAAE;QACtC,OAAO,EAAE,CAAC,mBAAmB,CAAC;QAC9B,GAAG,EAAE,IAAI,CAAC,GAAG,EAAE;KAChB,CAAC,CAAC;IACH,MAAM,IAAI,CAAC,KAAK,CAAC,WAAW,CAAC,KAAK,EAAE,wBAAwB,EAAE,EAAE,KAAK,EAAE,GAAG,CAAC,EAAE,EAAE,OAAO,EAAE,GAAG,CAAC,OAAO,EAAE,CAAC,CAAC;IACvG,OAAO,GAAG,CAAC;AACb,CAAC"}

package/dist/background-review-types.d.ts

@@ -0,0 +1,60 @@
+import type { AgentHarness, AgentManifest } from "@assemblyline-agents/core";
+import type { LearningStore } from "./learning-store.js";
+import type { RuntimeLogger } from "./logging.js";
+import type { MemoryStore } from "./runtime-types.js";
+import type { MemoryScope, ResolvedStateAdapter, RunRecord } from "./state.js";
+import type { ResolvedSkillsConfig, SkillStore } from "./self-improvement.js";
+export interface BackgroundReviewHost {
+    state: ResolvedStateAdapter;
+    manifest: AgentManifest;
+    env: Record<string, string | undefined>;
+    logger: RuntimeLogger;
+    learningStore: LearningStore;
+    skillStore: SkillStore;
+    memoryStore: MemoryStore;
+    anySkillsEnabled(): boolean;
+    skillsConfigForRun(run: RunRecord): ResolvedSkillsConfig;
+    skillScopeForRun(run: RunRecord): string;
+    memoryScopeForRun(run: RunRecord): MemoryScope;
+    resolveAgentHarness(modelSpec?: string): Promise<AgentHarness>;
+    saveReviewSkill(input: {
+        scope: string;
+        requireApproval: boolean;
+        name: string;
+        body: string;
+        sourceRunId: string;
+        reviewJobId: string;
+    }): Promise<{
+        name: string;
+        pending: boolean;
+    }>;
+    archiveReviewSkill(input: {
+        scope: string;
+        requireApproval: boolean;
+        name: string;
+        sourceRunId: string;
+        reviewJobId: string;
+    }): Promise<{
+        pending: boolean;
+    }>;
+    restoreReviewSkill(input: {
+        scope: string;
+        requireApproval: boolean;
+        name: string;
+        revision: number;
+        sourceRunId: string;
+        reviewJobId: string;
+    }): Promise<{
+        name: string;
+        pending: boolean;
+    }>;
+    now(): Date;
+}
+export interface BackgroundReviewExecutionResult {
+    jobId: string;
+    sourceRunId: string;
+    reviewRunId?: string;
+    status: "completed" | "retrying" | "failed";
+    error?: string;
+}
+//# sourceMappingURL=background-review-types.d.ts.map

package/dist/background-review-types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"background-review-types.d.ts","sourceRoot":"","sources":["../src/background-review-types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAC;AAC7E,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACzD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAClD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACtD,OAAO,KAAK,EAAE,WAAW,EAAE,oBAAoB,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAC/E,OAAO,KAAK,EAAE,oBAAoB,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AAE9E,MAAM,WAAW,oBAAoB;IACnC,KAAK,EAAE,oBAAoB,CAAC;IAC5B,QAAQ,EAAE,aAAa,CAAC;IACxB,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAC;IACxC,MAAM,EAAE,aAAa,CAAC;IACtB,aAAa,EAAE,aAAa,CAAC;IAC7B,UAAU,EAAE,UAAU,CAAC;IACvB,WAAW,EAAE,WAAW,CAAC;IACzB,gBAAgB,IAAI,OAAO,CAAC;IAC5B,kBAAkB,CAAC,GAAG,EAAE,SAAS,GAAG,oBAAoB,CAAC;IACzD,gBAAgB,CAAC,GAAG,EAAE,SAAS,GAAG,MAAM,CAAC;IACzC,iBAAiB,CAAC,GAAG,EAAE,SAAS,GAAG,WAAW,CAAC;IAC/C,mBAAmB,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC;IAC/D,eAAe,CAAC,KAAK,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,eAAe,EAAE,OAAO,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,OAAO,CAAA;KAAE,CAAC,CAAC;IACvL,kBAAkB,CAAC,KAAK,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,eAAe,EAAE,OAAO,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC;QAAE,OAAO,EAAE,OAAO,CAAA;KAAE,CAAC,CAAC;IAC9J,kBAAkB,CAAC,KAAK,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,eAAe,EAAE,OAAO,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,OAAO,CAAA;KAAE,CAAC,CAAC;IAC9L,GAAG,IAAI,IAAI,CAAC;CACb;AAED,MAAM,WAAW,+BAA+B;IAC9C,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,MAAM,EAAE,WAAW,GAAG,UAAU,GAAG,QAAQ,CAAC;IAC5C,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB"}

package/dist/background-review-types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=background-review-types.js.map

package/dist/background-review-types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"background-review-types.js","sourceRoot":"","sources":["../src/background-review-types.ts"],"names":[],"mappings":""}

package/dist/background-review-worker.d.ts

@@ -0,0 +1,14 @@
+import type { BackgroundReviewExecutionResult, BackgroundReviewHost } from "./background-review-types.js";
+export declare function runDueBackgroundReviews(host: BackgroundReviewHost, options?: {
+    now?: Date;
+    limit?: number;
+    leaseForMs?: number;
+}): Promise<BackgroundReviewExecutionResult[]>;
+export declare function startBackgroundReviewWorker(host: BackgroundReviewHost, options?: {
+    intervalMs?: number;
+    limit?: number;
+    leaseForMs?: number;
+}): {
+    stop(): void;
+} | undefined;
+//# sourceMappingURL=background-review-worker.d.ts.map

package/dist/background-review-worker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"background-review-worker.d.ts","sourceRoot":"","sources":["../src/background-review-worker.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,+BAA+B,EAAE,oBAAoB,EAAE,MAAM,8BAA8B,CAAC;AAM1G,wBAAsB,uBAAuB,CAC3C,IAAI,EAAE,oBAAoB,EAC1B,OAAO,GAAE;IAAE,GAAG,CAAC,EAAE,IAAI,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,UAAU,CAAC,EAAE,MAAM,CAAA;CAAO,GAChE,OAAO,CAAC,+BAA+B,EAAE,CAAC,CAwC5C;AAED,wBAAgB,2BAA2B,CACzC,IAAI,EAAE,oBAAoB,EAC1B,OAAO,GAAE;IAAE,UAAU,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,UAAU,CAAC,EAAE,MAAM,CAAA;CAAO,GACzE;IAAE,IAAI,IAAI,IAAI,CAAA;CAAE,GAAG,SAAS,CAU9B"}

package/dist/background-review-worker.js

@@ -0,0 +1,61 @@
+import { executeBackgroundReview } from "./background-review.js";
+function object(value) {
+    return value && typeof value === "object" && !Array.isArray(value) ? value : {};
+}
+export async function runDueBackgroundReviews(host, options = {}) {
+    if (!host.anySkillsEnabled())
+        return [];
+    const now = options.now ?? host.now();
+    const jobs = await host.learningStore.leaseBackgroundReviews({
+        now,
+        limit: options.limit ?? 1,
+        leaseForMs: options.leaseForMs ?? 15 * 60_000
+    });
+    const results = [];
+    for (const job of jobs) {
+        const leaseToken = job.leaseToken;
+        if (!leaseToken)
+            continue;
+        try {
+            const reviewRun = await executeBackgroundReview(host, job);
+            await host.learningStore.completeBackgroundReview(job.id, leaseToken, reviewRun.id, host.now());
+            await host.state.appendEvent(job.sourceRunId, "learning.review_completed", {
+                jobId: job.id,
+                reviewRunId: reviewRun.id
+            });
+            results.push({ jobId: job.id, sourceRunId: job.sourceRunId, reviewRunId: reviewRun.id, status: "completed" });
+        }
+        catch (error) {
+            const message = error instanceof Error ? error.message : String(error);
+            const failed = await host.learningStore.failBackgroundReview(job.id, leaseToken, message, host.now());
+            const reviewRunId = object(error).reviewRunId;
+            await host.state.appendEvent(job.sourceRunId, failed.status === "pending" ? "learning.review_retrying" : "learning.review_failed", {
+                jobId: job.id,
+                error: message,
+                attemptCount: failed.attemptCount,
+                ...(typeof reviewRunId === "string" ? { reviewRunId } : {})
+            });
+            results.push({
+                jobId: job.id,
+                sourceRunId: job.sourceRunId,
+                ...(typeof reviewRunId === "string" ? { reviewRunId } : {}),
+                status: failed.status === "pending" ? "retrying" : "failed",
+                error: message
+            });
+        }
+    }
+    return results;
+}
+export function startBackgroundReviewWorker(host, options = {}) {
+    if (!host.anySkillsEnabled())
+        return undefined;
+    const intervalMs = options.intervalMs && options.intervalMs > 0 ? Math.floor(options.intervalMs) : 15_000;
+    const tick = () => void runDueBackgroundReviews(host, options).catch((error) => {
+        host.logger.warn("background review sweep failed", { error: error instanceof Error ? error.message : String(error) });
+    });
+    const timer = setInterval(tick, intervalMs);
+    timer.unref?.();
+    tick();
+    return { stop: () => clearInterval(timer) };
+}
+//# sourceMappingURL=background-review-worker.js.map

package/dist/background-review-worker.js.map

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

package/dist/background-review.d.ts

@@ -0,0 +1,5 @@
+import type { BackgroundReviewJobRecord } from "./learning-store.js";
+import type { RunRecord } from "./state.js";
+import type { BackgroundReviewHost } from "./background-review-types.js";
+export declare function executeBackgroundReview(host: BackgroundReviewHost, job: BackgroundReviewJobRecord): Promise<RunRecord>;
+//# sourceMappingURL=background-review.d.ts.map

package/dist/background-review.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"background-review.d.ts","sourceRoot":"","sources":["../src/background-review.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,qBAAqB,CAAC;AACrE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAC5C,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,8BAA8B,CAAC;AAgSzE,wBAAsB,uBAAuB,CAC3C,IAAI,EAAE,oBAAoB,EAC1B,GAAG,EAAE,yBAAyB,GAC7B,OAAO,CAAC,SAAS,CAAC,CAiEpB"}

package/dist/background-review.js

@@ -0,0 +1,332 @@
+import { redactedToolInput, safeJson } from "./json-util.js";
+const REVIEW_SYSTEM_PROMPT = `You are the agent's background learning reviewer.
+Review the supplied evidence and preserve only reusable, evidence-backed improvements.
+You may read and write durable memory and skills using the two tools provided.
+Write directly when a change is useful; no proposal is required. Skill writes may be staged by owner policy.
+Do not save secrets, one-off run details, raw transcripts, or guesses. Prefer no change over weak learning.
+Keep skills narrowly procedural and memory concise. Never attempt to invoke unrelated tools.`;
+const MEMORY_TOOL = {
+    name: "memory_manage",
+    description: "List, read, or save durable agent memory for reusable learning.",
+    execution: "sequential",
+    inputSchema: {
+        type: "object",
+        properties: {
+            action: { type: "string", enum: ["list", "read", "save"] },
+            path: { type: "string" },
+            content: { type: "string" }
+        },
+        required: ["action"],
+        additionalProperties: false
+    }
+};
+const SKILL_TOOL = {
+    name: "skill_manage",
+    description: "List, read, save, archive, inspect versions, or restore durable skills.",
+    execution: "sequential",
+    inputSchema: {
+        type: "object",
+        properties: {
+            action: { type: "string", enum: ["list", "read", "save", "archive", "versions", "restore"] },
+            name: { type: "string" },
+            body: { type: "string" },
+            revision: { type: "number" }
+        },
+        required: ["action"],
+        additionalProperties: false
+    }
+};
+function text(value) {
+    return typeof value === "string" ? value.trim() : "";
+}
+function number(value) {
+    return typeof value === "number" && Number.isFinite(value) ? value : undefined;
+}
+function object(value) {
+    return value && typeof value === "object" && !Array.isArray(value) ? value : {};
+}
+function bounded(value, maxChars = 8_000) {
+    const json = JSON.stringify(safeJson(value));
+    if (json.length <= maxChars)
+        return safeJson(value);
+    return { truncated: true, preview: json.slice(0, maxChars) };
+}
+async function reviewEvidence(host, job, sourceRun) {
+    const [events, toolCalls] = await Promise.all([
+        host.state.listEvents(sourceRun.id),
+        host.state.listToolCalls(sourceRun.id)
+    ]);
+    const conversationId = text(sourceRun.input.conversationId);
+    const messages = conversationId ? await host.state.listRecentMessages(conversationId, 20) : [];
+    const config = host.skillsConfigForRun(sourceRun);
+    const model = config.reviewModel === "inherit"
+        ? text([...events].reverse().find((event) => event.type === "model.request_started")?.data.model)
+            || host.manifest.possibleModels[0]
+            || ""
+        : config.reviewModel;
+    if (!model)
+        throw new Error("No model is available for background review.");
+    const relevantEvents = events
+        .filter((event) => event.type === "skill.loaded" || event.type === "learning.feedback_received" || event.type.startsWith("run."))
+        .slice(-30)
+        .map((event) => ({ type: event.type, timestamp: event.timestamp, data: bounded(event.data, 2_000) }));
+    const evidence = {
+        sourceRun: {
+            id: sourceRun.id,
+            status: sourceRun.status,
+            input: bounded(sourceRun.input, 4_000)
+        },
+        reasons: job.reasons,
+        messages: messages.map((message) => ({
+            role: message.role,
+            runId: message.runId ?? null,
+            content: bounded(message.content, 4_000)
+        })),
+        toolCalls: toolCalls.map((call) => ({
+            name: call.toolName,
+            status: call.status,
+            input: bounded(redactedToolInput(call.input), 3_000),
+            modelOutput: bounded(call.modelOutput ?? call.result ?? null, 4_000),
+            error: call.error ?? null
+        })),
+        events: relevantEvents
+    };
+    return {
+        model,
+        prompt: `Review this completed run evidence. Make only durable improvements that will help future runs.\n\n${JSON.stringify(evidence, null, 2)}`
+    };
+}
+async function runReviewTool(host, job, sourceRun, name, input) {
+    const value = object(input);
+    const action = text(value.action);
+    if (name === "memory_manage") {
+        const scope = host.memoryScopeForRun(sourceRun);
+        if (action === "list") {
+            const documents = await host.memoryStore.list(scope, { pathPrefix: text(value.path) || "/memory", limit: 50 });
+            return documents.map((document) => ({ path: document.path, title: document.title, summary: document.summary, revision: document.revision }));
+        }
+        const path = text(value.path);
+        if (!path.startsWith("/memory/"))
+            throw new Error("Memory path must start with /memory/.");
+        if (action === "read") {
+            const document = await host.memoryStore.read(scope, { path });
+            return document ? { path, body: document.body, revision: document.revision, tags: document.tags } : { found: false };
+        }
+        if (action === "save") {
+            const content = text(value.content);
+            if (!content)
+                throw new Error("Memory save requires content.");
+            const document = await host.memoryStore.write(scope, {
+                path,
+                content,
+                mode: "replace",
+                metadata: {
+                    tags: ["background-review"],
+                    confidence: "high",
+                    sourceRefs: [`run:${sourceRun.id}`, `review-job:${job.id}`]
+                }
+            });
+            return { saved: document.path, revision: document.revision };
+        }
+        throw new Error(`Unsupported memory action: ${action}`);
+    }
+    if (name !== "skill_manage")
+        throw new Error(`Background reviewer cannot use tool: ${name}`);
+    const config = host.skillsConfigForRun(sourceRun);
+    if (job.scope !== host.skillScopeForRun(sourceRun)) {
+        throw new Error(`Background review scope does not match source run ${sourceRun.id}.`);
+    }
+    if (action === "list") {
+        return (await host.skillStore.list(job.scope))
+            .filter((skill) => !skill.pending && !skill.archived)
+            .map((skill) => ({ name: skill.name, origin: skill.origin, revision: skill.revision ?? null }));
+    }
+    const skillName = text(value.name);
+    if (!skillName)
+        throw new Error("Skill action requires name.");
+    if (!/^[A-Za-z0-9][A-Za-z0-9._-]{0,127}$/.test(skillName)) {
+        throw new Error("Skill name must use letters, numbers, dots, underscores, or hyphens.");
+    }
+    if (action === "read") {
+        const skill = await host.skillStore.get(job.scope, skillName);
+        return skill && !skill.archived ? { name: skill.name, body: skill.body, revision: skill.revision ?? null } : { found: false };
+    }
+    if (action === "save") {
+        const body = text(value.body);
+        if (!body)
+            throw new Error("Skill save requires a complete SKILL.md body.");
+        return host.saveReviewSkill({ scope: job.scope, requireApproval: config.writeApproval, name: skillName, body, sourceRunId: sourceRun.id, reviewJobId: job.id });
+    }
+    if (action === "archive") {
+        return host.archiveReviewSkill({ scope: job.scope, requireApproval: config.writeApproval, name: skillName, sourceRunId: sourceRun.id, reviewJobId: job.id });
+    }
+    if (action === "versions") {
+        return host.learningStore.listSkillRevisions(job.scope, skillName);
+    }
+    if (action === "restore") {
+        const revision = number(value.revision);
+        if (revision === undefined)
+            throw new Error("Skill restore requires revision.");
+        return host.restoreReviewSkill({ scope: job.scope, requireApproval: config.writeApproval, name: skillName, revision: Math.floor(revision), sourceRunId: sourceRun.id, reviewJobId: job.id });
+    }
+    throw new Error(`Unsupported skill action: ${action}`);
+}
+async function executeRecordedReviewTool(host, reviewRun, sourceRun, job, call) {
+    await host.state.appendEvent(reviewRun.id, "tool.call_requested", { toolName: call.name, input: bounded(call.input) });
+    let record = await host.state.createToolCall({
+        runId: reviewRun.id,
+        toolName: call.name,
+        status: "requested",
+        input: bounded(call.input),
+        idempotencyKey: `background-review:${job.id}:${call.toolCallId}`
+    });
+    record = await host.state.updateToolCall(record.id, { status: "running" });
+    await host.state.appendEvent(reviewRun.id, "tool.execution_started", { toolCallId: record.id, toolName: call.name });
+    try {
+        const output = safeJson(await runReviewTool(host, job, sourceRun, call.name, call.input));
+        await host.state.updateToolCall(record.id, { status: "completed", result: output, modelOutput: output });
+        await host.state.appendEvent(reviewRun.id, "tool.execution_completed", { toolCallId: record.id, toolName: call.name, modelOutput: output });
+        return { kind: "result", output };
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        await host.state.updateToolCall(record.id, { status: "failed", error: message });
+        await host.state.appendEvent(reviewRun.id, "tool.execution_failed", { toolCallId: record.id, toolName: call.name, error: message });
+        return { kind: "result", output: { ok: false, error: message } };
+    }
+}
+async function emitReviewHarnessEvent(host, run, sourceRun, model, job, event) {
+    if (event.type === "response_delta")
+        return;
+    if (event.type === "request_started") {
+        await host.state.appendEvent(run.id, "model.request_started", {
+            model,
+            iteration: event.iteration,
+            tools: event.toolNames,
+            parentRunId: sourceRun.id,
+            purpose: "background_review"
+        });
+        return;
+    }
+    if (event.type === "model_retry") {
+        await host.state.appendEvent(run.id, "model.request_retried", {
+            iteration: event.iteration,
+            attempt: event.attempt,
+            delayMs: event.delayMs,
+            error: event.error,
+            ...(event.status === undefined ? {} : { status: event.status })
+        });
+        return;
+    }
+    if (event.type === "assistant_message_completed") {
+        await host.state.appendEvent(run.id, "agent.message_completed", {
+            role: "assistant",
+            phase: "commentary",
+            iteration: event.iteration,
+            text: event.text,
+            ...(event.messageId ? { messageId: event.messageId } : {}),
+            parentRunId: sourceRun.id,
+            purpose: "background_review"
+        });
+        return;
+    }
+    const usage = event.usage ?? {};
+    await host.state.recordUsage({
+        idempotencyKey: `background-review:${job.id}:${event.iteration}`,
+        runId: run.id,
+        parentRunId: sourceRun.id,
+        agentId: host.manifest.agent.id ?? host.manifest.agentRevision,
+        agentRevision: host.manifest.agentRevision,
+        iteration: event.iteration,
+        model,
+        provider: event.provider ?? model.split("/")[0] ?? "unknown",
+        billingMode: event.billingMode ?? "unknown",
+        recordKind: "transaction",
+        ...(usage.inputTokens === undefined ? {} : { inputTokens: usage.inputTokens }),
+        ...(usage.outputTokens === undefined ? {} : { outputTokens: usage.outputTokens }),
+        ...(usage.cachedTokens === undefined ? {} : { cachedTokens: usage.cachedTokens }),
+        ...(usage.cacheWriteTokens === undefined ? {} : { cacheWriteTokens: usage.cacheWriteTokens }),
+        ...(usage.reasoningTokens === undefined ? {} : { reasoningTokens: usage.reasoningTokens }),
+        ...(usage.costUsd === undefined ? {} : { costUsd: usage.costUsd }),
+        ...(usage.upstreamCostUsd === undefined ? {} : { upstreamCostUsd: usage.upstreamCostUsd }),
+        ...(usage.currency === undefined ? {} : { currency: usage.currency }),
+        tokenSource: usage.tokenSource ?? "unavailable",
+        costSource: usage.costSource ?? "unavailable",
+        metadata: { purpose: "background_review", reviewJobId: job.id }
+    });
+    await host.state.appendEvent(run.id, "model.response_completed", {
+        model,
+        iteration: event.iteration,
+        toolCallCount: event.toolCallCount,
+        usage: safeJson(usage),
+        purpose: "background_review"
+    });
+}
+export async function executeBackgroundReview(host, job) {
+    const sourceRun = await host.state.getRun(job.sourceRunId);
+    if (!sourceRun)
+        throw new Error(`Background review source run not found: ${job.sourceRunId}`);
+    const evidence = await reviewEvidence(host, job, sourceRun);
+    const harness = await host.resolveAgentHarness(evidence.model);
+    let reviewRun = await host.state.createRun({
+        agentRevision: host.manifest.agentRevision,
+        status: "created",
+        input: {
+            purpose: "background_review",
+            parentRunId: sourceRun.id,
+            reviewJobId: job.id,
+            reasons: job.reasons,
+            model: evidence.model
+        }
+    });
+    await host.state.appendEvent(reviewRun.id, "run.accepted", {
+        agentRevision: host.manifest.agentRevision,
+        purpose: "background_review",
+        parentRunId: sourceRun.id
+    });
+    reviewRun = await host.state.updateRun(reviewRun.id, { status: "running" });
+    const heartbeat = setInterval(() => {
+        void host.state.touchRun?.(reviewRun.id).catch((error) => {
+            host.logger.warn("background review heartbeat failed", {
+                runId: reviewRun.id,
+                error: error instanceof Error ? error.message : String(error)
+            });
+        });
+    }, 30_000);
+    heartbeat.unref?.();
+    const context = {
+        runId: reviewRun.id,
+        sessionId: `background-review:${job.id}`,
+        modelSpec: evidence.model,
+        systemPrompt: REVIEW_SYSTEM_PROMPT,
+        maxIterations: 4,
+        env: host.env,
+        tools: async () => [MEMORY_TOOL, SKILL_TOOL],
+        executeTool: (call) => executeRecordedReviewTool(host, reviewRun, sourceRun, job, call),
+        emit: (event) => emitReviewHarnessEvent(host, reviewRun, sourceRun, evidence.model, job, event),
+        captureContent: false
+    };
+    try {
+        const result = await harness.runTurn({ kind: "message", message: evidence.prompt, recentHistory: [] }, context);
+        reviewRun = await host.state.updateRun(reviewRun.id, { status: "completed" });
+        const toolCalls = await host.state.listToolCalls(reviewRun.id);
+        await host.state.appendEvent(reviewRun.id, "run.completed", {
+            purpose: "background_review",
+            parentRunId: sourceRun.id,
+            changed: toolCalls.some((call) => call.status === "completed"
+                && ["save", "archive", "restore"].includes(text(object(call.input).action))),
+            summary: result.response.slice(0, 1_000)
+        });
+        return reviewRun;
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        reviewRun = await host.state.updateRun(reviewRun.id, { status: "failed", terminalReason: "background_review_failed", terminalError: message });
+        await host.state.appendEvent(reviewRun.id, "run.failed", { reason: "background_review_failed", error: message });
+        throw Object.assign(new Error(message), { reviewRunId: reviewRun.id });
+    }
+    finally {
+        clearInterval(heartbeat);
+    }
+}
+//# sourceMappingURL=background-review.js.map