@assemblyline-agents/runtime 1.0.0 → 3.0.0

package/dist/runtime-bundle.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"runtime-bundle.d.ts","sourceRoot":"","sources":["../src/runtime-bundle.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAEzD,wBAAgB,iBAAiB,CAAC,YAAY,EAAE,MAAM,GAAG,cAAc,CActE"}
+{"version":3,"file":"runtime-bundle.d.ts","sourceRoot":"","sources":["../src/runtime-bundle.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAEzD,wBAAgB,iBAAiB,CAAC,YAAY,EAAE,MAAM,GAAG,cAAc,CAgBtE"}

package/dist/runtime-bundle.js

@@ -8,9 +8,11 @@ export function loadRuntimeBundle(artifactRoot) {
     const sourceBundle = existsSync(sourcePath)
         ? JSON.parse(readFileSync(sourcePath, "utf8"))
         : {};
+    const resourcesRoot = join(root, "resources");
     return {
         manifest,
         artifactRoot: root,
+        ...(existsSync(resourcesRoot) ? { resourcesRoot } : {}),
         sourceBundle,
         devMode: true
     };

package/dist/runtime-bundle.js.map

@@ -1 +1 @@
-{"version":3,"file":"runtime-bundle.js","sourceRoot":"","sources":["../src/runtime-bundle.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACnD,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAI1C,MAAM,UAAU,iBAAiB,CAAC,YAAoB;IACpD,MAAM,IAAI,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC;IACnC,MAAM,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,IAAI,CAAC,IAAI,EAAE,eAAe,CAAC,EAAE,MAAM,CAAC,CAAkB,CAAC;IAChG,QAAQ,CAAC,IAAI,GAAG,IAAI,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;IACpC,MAAM,UAAU,GAAG,IAAI,CAAC,IAAI,EAAE,QAAQ,EAAE,cAAc,CAAC,CAAC;IACxD,MAAM,YAAY,GAAG,UAAU,CAAC,UAAU,CAAC;QACzC,CAAC,CAAE,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,UAAU,EAAE,MAAM,CAAC,CAA4B;QAC1E,CAAC,CAAC,EAAE,CAAC;IACP,OAAO;QACL,QAAQ;QACR,YAAY,EAAE,IAAI;QAClB,YAAY;QACZ,OAAO,EAAE,IAAI;KACd,CAAC;AACJ,CAAC"}
+{"version":3,"file":"runtime-bundle.js","sourceRoot":"","sources":["../src/runtime-bundle.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACnD,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAI1C,MAAM,UAAU,iBAAiB,CAAC,YAAoB;IACpD,MAAM,IAAI,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC;IACnC,MAAM,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,IAAI,CAAC,IAAI,EAAE,eAAe,CAAC,EAAE,MAAM,CAAC,CAAkB,CAAC;IAChG,QAAQ,CAAC,IAAI,GAAG,IAAI,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;IACpC,MAAM,UAAU,GAAG,IAAI,CAAC,IAAI,EAAE,QAAQ,EAAE,cAAc,CAAC,CAAC;IACxD,MAAM,YAAY,GAAG,UAAU,CAAC,UAAU,CAAC;QACzC,CAAC,CAAE,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,UAAU,EAAE,MAAM,CAAC,CAA4B;QAC1E,CAAC,CAAC,EAAE,CAAC;IACP,MAAM,aAAa,GAAG,IAAI,CAAC,IAAI,EAAE,WAAW,CAAC,CAAC;IAC9C,OAAO;QACL,QAAQ;QACR,YAAY,EAAE,IAAI;QAClB,GAAG,CAAC,UAAU,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,EAAE,aAAa,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACvD,YAAY;QACZ,OAAO,EAAE,IAAI;KACd,CAAC;AACJ,CAAC"}

package/dist/runtime-learning.d.ts

@@ -0,0 +1,88 @@
+import type { AgentHarness, AgentManifest } from "@assemblyline-agents/core";
+import type { BackgroundReviewExecutionResult } from "./background-review-types.js";
+import type { LearningStore, PendingSkillChangeRecord, SkillRevisionRecord } from "./learning-store.js";
+import type { RuntimeLogger } from "./logging.js";
+import type { MemoryStore } from "./runtime-types.js";
+import { type ResolvedSkillsConfig, type SkillStore } from "./self-improvement.js";
+import type { MemoryScope, ResolvedStateAdapter, RunRecord } from "./state.js";
+interface RuntimeLearningOptions {
+    state: ResolvedStateAdapter;
+    manifest: AgentManifest;
+    env: Record<string, string | undefined>;
+    logger: RuntimeLogger;
+    learningStore: LearningStore;
+    skillStore: SkillStore;
+    memoryStore: MemoryStore;
+    skillsConfigForSurface(surfacePath: string): ResolvedSkillsConfig;
+    skillScopeForSurface(surfacePath: string): string;
+    anySkillsEnabled(): boolean;
+    memoryScopeForRun(run: RunRecord): MemoryScope;
+    resolveAgentHarness(modelSpec?: string): Promise<AgentHarness>;
+    now(): Date;
+}
+export interface RuntimeSkillWriteInput {
+    name: string;
+    body: string;
+    origin?: "agent" | "user" | "background-review";
+    sourceRunId?: string;
+    reviewJobId?: string;
+}
+export declare class RuntimeLearningManager {
+    private readonly options;
+    private readonly seededSurfaces;
+    private readonly migratedSurfaceScopes;
+    private skillScopeMigrated;
+    constructor(options: RuntimeLearningOptions);
+    ensureSkillsSeeded(surfacePath?: string): Promise<void>;
+    listSkills(surfacePath?: string): Promise<Array<{
+        name: string;
+        description: string;
+        origin: string;
+        pending: boolean;
+    }>>;
+    saveSkill(input: RuntimeSkillWriteInput, surfacePath?: string): Promise<{
+        name: string;
+        pending: boolean;
+    }>;
+    deleteSkill(name: string, surfacePath?: string): Promise<void>;
+    listSkillRevisions(name: string, surfacePath?: string): Promise<SkillRevisionRecord[]>;
+    restoreSkillRevision(name: string, revision: number, surfacePath?: string): Promise<{
+        name: string;
+        pending: boolean;
+    }>;
+    listPendingSkillChanges(surfacePath?: string): Promise<PendingSkillChangeRecord[]>;
+    approveSkillChange(id: string, surfacePath?: string): Promise<{
+        name: string;
+        action: string;
+    }>;
+    rejectSkillChange(id: string, surfacePath?: string): Promise<void>;
+    recordRunFeedback(runId: string, feedback: {
+        rating: "positive" | "negative";
+        comment?: string;
+    }): Promise<{
+        jobId: string;
+        status: string;
+    }>;
+    listBackgroundReviews(surfacePath?: string): Promise<import("./learning-store.js").BackgroundReviewJobRecord[]>;
+    runDueBackgroundReviews(options?: {
+        now?: Date;
+        limit?: number;
+        leaseForMs?: number;
+    }): Promise<BackgroundReviewExecutionResult[]>;
+    startBackgroundReviewWorker(options?: {
+        intervalMs?: number;
+        limit?: number;
+        leaseForMs?: number;
+    }): {
+        stop(): void;
+    } | undefined;
+    handleRuntimeEvent(runId: string, eventType: string): Promise<void>;
+    private assertEnabled;
+    private pendingSkillChange;
+    private migrateLegacySkillScope;
+    private migrateLegacyPendingSkills;
+    private backfillSkillRevisionMetadata;
+    private reviewHost;
+}
+export {};
+//# sourceMappingURL=runtime-learning.d.ts.map

package/dist/runtime-learning.d.ts.map

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

package/dist/runtime-learning.js

@@ -0,0 +1,260 @@
+import { enqueueBackgroundReviewForCompletedRun, enqueueBackgroundReviewForFeedback } from "./background-review-trigger.js";
+import { runDueBackgroundReviews, startBackgroundReviewWorker } from "./background-review-worker.js";
+import { archiveSkill, liveSkills, seedSkills, writeSkill } from "./self-improvement.js";
+import { ROOT_AGENT_SURFACE, surfaceForPath, surfaceForRun } from "./agent-surface.js";
+export class RuntimeLearningManager {
+    options;
+    seededSurfaces = new Set();
+    migratedSurfaceScopes = new Set();
+    skillScopeMigrated = false;
+    constructor(options) {
+        this.options = options;
+    }
+    async ensureSkillsSeeded(surfacePath = ROOT_AGENT_SURFACE) {
+        if (this.seededSurfaces.has(surfacePath))
+            return;
+        const surface = surfaceForPath(this.options.manifest, surfacePath);
+        await this.migrateLegacySkillScope(surfacePath);
+        await this.migrateLegacyPendingSkills(surfacePath);
+        await this.backfillSkillRevisionMetadata(surfacePath);
+        await seedSkills(this.options.skillStore, this.options.learningStore, this.options.skillScopeForSurface(surfacePath), surface.skills);
+        this.seededSurfaces.add(surfacePath);
+    }
+    async listSkills(surfacePath = ROOT_AGENT_SURFACE) {
+        await this.ensureSkillsSeeded(surfacePath);
+        return liveSkills(this.options.skillStore, this.options.skillScopeForSurface(surfacePath));
+    }
+    async saveSkill(input, surfacePath = ROOT_AGENT_SURFACE) {
+        const config = this.assertEnabled(surfacePath);
+        await this.ensureSkillsSeeded(surfacePath);
+        const record = await writeSkill(this.options.skillStore, this.options.learningStore, this.options.skillScopeForSurface(surfacePath), input, { requireApproval: config.writeApproval });
+        return { name: record.name, pending: record.pending ?? false };
+    }
+    async deleteSkill(name, surfacePath = ROOT_AGENT_SURFACE) {
+        const config = this.assertEnabled(surfacePath);
+        await this.ensureSkillsSeeded(surfacePath);
+        await archiveSkill(this.options.skillStore, this.options.learningStore, this.options.skillScopeForSurface(surfacePath), name, { requireApproval: config.writeApproval });
+    }
+    async listSkillRevisions(name, surfacePath = ROOT_AGENT_SURFACE) {
+        await this.ensureSkillsSeeded(surfacePath);
+        return this.options.learningStore.listSkillRevisions(this.options.skillScopeForSurface(surfacePath), name);
+    }
+    async restoreSkillRevision(name, revision, surfacePath = ROOT_AGENT_SURFACE) {
+        const config = this.assertEnabled(surfacePath);
+        await this.ensureSkillsSeeded(surfacePath);
+        const scope = this.options.skillScopeForSurface(surfacePath);
+        const historical = await this.options.learningStore.getSkillRevision(scope, name, revision);
+        if (!historical)
+            throw new Error(`Skill revision not found: ${name}@${revision}`);
+        const record = await writeSkill(this.options.skillStore, this.options.learningStore, scope, {
+            name,
+            body: historical.body,
+            origin: "user",
+            action: "restore"
+        }, { requireApproval: config.writeApproval });
+        return { name, pending: record.pending ?? false };
+    }
+    listPendingSkillChanges(surfacePath = ROOT_AGENT_SURFACE) {
+        return this.options.learningStore.listPendingSkillChanges(this.options.skillScopeForSurface(surfacePath));
+    }
+    async approveSkillChange(id, surfacePath = ROOT_AGENT_SURFACE) {
+        const pending = await this.pendingSkillChange(id, surfacePath);
+        if (pending.action === "write") {
+            if (pending.body === undefined)
+                throw new Error(`Pending skill write has no body: ${id}`);
+            await writeSkill(this.options.skillStore, this.options.learningStore, pending.scope, {
+                name: pending.name,
+                body: pending.body,
+                origin: pending.origin,
+                action: pending.revisionAction ?? "write",
+                ...(pending.sourceRunId ? { sourceRunId: pending.sourceRunId } : {}),
+                ...(pending.reviewJobId ? { reviewJobId: pending.reviewJobId } : {})
+            }, { requireApproval: false });
+        }
+        else {
+            await archiveSkill(this.options.skillStore, this.options.learningStore, pending.scope, pending.name, {
+                requireApproval: false,
+                origin: pending.origin,
+                ...(pending.sourceRunId ? { sourceRunId: pending.sourceRunId } : {}),
+                ...(pending.reviewJobId ? { reviewJobId: pending.reviewJobId } : {})
+            });
+        }
+        await this.options.learningStore.deletePendingSkillChange(id);
+        return { name: pending.name, action: pending.action };
+    }
+    async rejectSkillChange(id, surfacePath = ROOT_AGENT_SURFACE) {
+        await this.pendingSkillChange(id, surfacePath);
+        await this.options.learningStore.deletePendingSkillChange(id);
+    }
+    async recordRunFeedback(runId, feedback) {
+        const job = await enqueueBackgroundReviewForFeedback(this.reviewHost(), runId, feedback);
+        return { jobId: job.id, status: job.status };
+    }
+    listBackgroundReviews(surfacePath = ROOT_AGENT_SURFACE) {
+        return this.options.learningStore.listBackgroundReviews(this.options.skillScopeForSurface(surfacePath));
+    }
+    runDueBackgroundReviews(options = {}) {
+        return runDueBackgroundReviews(this.reviewHost(), options);
+    }
+    startBackgroundReviewWorker(options = {}) {
+        return startBackgroundReviewWorker(this.reviewHost(), options);
+    }
+    async handleRuntimeEvent(runId, eventType) {
+        if (eventType !== "run.completed")
+            return;
+        await enqueueBackgroundReviewForCompletedRun(this.reviewHost(), runId).catch((error) => {
+            this.options.logger.warn("background review enqueue failed", {
+                runId,
+                error: error instanceof Error ? error.message : String(error)
+            });
+        });
+    }
+    assertEnabled(surfacePath) {
+        const config = this.options.skillsConfigForSurface(surfacePath);
+        if (!config.enabled) {
+            throw new Error("Self-improvement is disabled (selfImprovement.enabled is false).");
+        }
+        return config;
+    }
+    async pendingSkillChange(id, surfacePath) {
+        const pending = await this.options.learningStore.getPendingSkillChange(id);
+        if (!pending || pending.scope !== this.options.skillScopeForSurface(surfacePath)) {
+            throw new Error(`Pending skill change not found: ${id}`);
+        }
+        return pending;
+    }
+    async migrateLegacySkillScope(surfacePath) {
+        if (surfacePath !== ROOT_AGENT_SURFACE || this.skillScopeMigrated)
+            return;
+        this.skillScopeMigrated = true;
+        const scope = this.options.skillScopeForSurface(surfacePath);
+        const legacyScope = this.options.manifest.agentRevision;
+        if (scope === legacyScope || (await this.options.skillStore.list(scope)).length > 0)
+            return;
+        for (const skill of await this.options.skillStore.list(legacyScope)) {
+            let migratedRevision;
+            const revisions = await this.options.learningStore.listSkillRevisions(legacyScope, skill.name);
+            for (const revision of revisions) {
+                const migrated = await this.options.learningStore.appendSkillRevision({
+                    scope,
+                    name: revision.name,
+                    action: revision.action,
+                    body: revision.body,
+                    bodySha256: revision.bodySha256,
+                    origin: revision.origin,
+                    ...(migratedRevision ? { previousRevision: migratedRevision } : {}),
+                    ...(revision.sourceRunId ? { sourceRunId: revision.sourceRunId } : {}),
+                    ...(revision.reviewJobId ? { reviewJobId: revision.reviewJobId } : {})
+                });
+                migratedRevision = migrated.revision;
+            }
+            const { revision: _legacyRevision, ...stored } = skill;
+            await this.options.skillStore.put(scope, {
+                ...stored,
+                ...(migratedRevision ? { revision: migratedRevision } : {})
+            });
+        }
+        for (const pending of await this.options.learningStore.listPendingSkillChanges(legacyScope)) {
+            await this.options.learningStore.putPendingSkillChange({
+                scope,
+                name: pending.name,
+                action: pending.action,
+                ...(pending.revisionAction ? { revisionAction: pending.revisionAction } : {}),
+                ...(pending.body ? { body: pending.body } : {}),
+                origin: pending.origin,
+                ...(pending.sourceRunId ? { sourceRunId: pending.sourceRunId } : {}),
+                ...(pending.reviewJobId ? { reviewJobId: pending.reviewJobId } : {})
+            });
+        }
+    }
+    async migrateLegacyPendingSkills(surfacePath) {
+        const scope = this.options.skillScopeForSurface(surfacePath);
+        if (this.migratedSurfaceScopes.has(`pending:${scope}`))
+            return;
+        this.migratedSurfaceScopes.add(`pending:${scope}`);
+        const pendingChanges = await this.options.learningStore.listPendingSkillChanges(scope);
+        for (const skill of await this.options.skillStore.list(scope)) {
+            if (!skill.pending)
+                continue;
+            const alreadyMigrated = pendingChanges.some((pending) => pending.name === skill.name && pending.action === "write" && pending.body === skill.body);
+            if (!alreadyMigrated) {
+                pendingChanges.push(await this.options.learningStore.putPendingSkillChange({
+                    scope,
+                    name: skill.name,
+                    action: "write",
+                    revisionAction: "write",
+                    body: skill.body,
+                    origin: skill.origin
+                }));
+            }
+            await this.options.skillStore.delete(scope, skill.name);
+        }
+    }
+    async backfillSkillRevisionMetadata(surfacePath) {
+        const scope = this.options.skillScopeForSurface(surfacePath);
+        if (this.migratedSurfaceScopes.has(`revisions:${scope}`))
+            return;
+        this.migratedSurfaceScopes.add(`revisions:${scope}`);
+        for (const skill of await this.options.skillStore.list(scope)) {
+            if (skill.revision !== undefined)
+                continue;
+            const history = await this.options.learningStore.listSkillRevisions(scope, skill.name);
+            const matching = [...history].reverse().find((revision) => revision.bodySha256 === skill.bodySha256);
+            const revision = matching ?? await this.options.learningStore.appendSkillRevision({
+                scope,
+                name: skill.name,
+                action: skill.archived ? "archive" : skill.origin === "seeded" ? "seed" : "write",
+                body: skill.body,
+                bodySha256: skill.bodySha256,
+                origin: skill.origin,
+                ...(history.at(-1) ? { previousRevision: history.at(-1).revision } : {})
+            });
+            await this.options.skillStore.put(scope, { ...skill, revision: revision.revision });
+        }
+    }
+    reviewHost() {
+        const options = this.options;
+        return {
+            ...options,
+            anySkillsEnabled: options.anySkillsEnabled,
+            skillsConfigForRun: (run) => options.skillsConfigForSurface(surfaceForRun(options.manifest, run).path),
+            skillScopeForRun: (run) => options.skillScopeForSurface(surfaceForRun(options.manifest, run).path),
+            memoryScopeForRun: options.memoryScopeForRun,
+            resolveAgentHarness: options.resolveAgentHarness,
+            saveReviewSkill: async (input) => {
+                const record = await writeSkill(options.skillStore, options.learningStore, input.scope, {
+                    name: input.name,
+                    body: input.body,
+                    origin: "background-review",
+                    sourceRunId: input.sourceRunId,
+                    reviewJobId: input.reviewJobId
+                }, { requireApproval: input.requireApproval });
+                return { name: record.name, pending: record.pending ?? false };
+            },
+            archiveReviewSkill: async (input) => {
+                return archiveSkill(options.skillStore, options.learningStore, input.scope, input.name, {
+                    requireApproval: input.requireApproval,
+                    origin: "background-review",
+                    sourceRunId: input.sourceRunId,
+                    reviewJobId: input.reviewJobId
+                });
+            },
+            restoreReviewSkill: async (input) => {
+                const historical = await options.learningStore.getSkillRevision(input.scope, input.name, input.revision);
+                if (!historical)
+                    throw new Error(`Skill revision not found: ${input.name}@${input.revision}`);
+                const record = await writeSkill(options.skillStore, options.learningStore, input.scope, {
+                    name: input.name,
+                    body: historical.body,
+                    origin: "background-review",
+                    action: "restore",
+                    sourceRunId: input.sourceRunId,
+                    reviewJobId: input.reviewJobId
+                }, { requireApproval: input.requireApproval });
+                return { name: record.name, pending: record.pending ?? false };
+            },
+            now: options.now
+        };
+    }
+}
+//# sourceMappingURL=runtime-learning.js.map

package/dist/runtime-learning.js.map

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

package/dist/runtime-types.d.ts

@@ -1,4 +1,4 @@
-import type { AgentHarness, AgentManifest, ConnectionPrincipal, ContentCaptureLevel, ContentCapturePolicy, JsonObject, JsonSchema, JsonValue, MemoryListInput, MemoryReadInput, MemorySearchInput, MemoryWriteInput, ReasoningLevel, ResourceKind, ResourceMetadata, SandboxSession, SandboxSnapshotPolicy, ScheduleTriggerDefinition, TriggerTarget } from "@assemblyline-agents/core";
+import type { AgentPrincipal, AgentAudience, AgentHarness, AgentManifest, CompiledAutomationLifecycle, ConnectionPrincipal, ContentCaptureLevel, ContentCapturePolicy, JsonObject, JsonSchema, JsonValue, MemoryListInput, MemoryReadInput, MemorySearchInput, MemoryWriteInput, ReasoningLevel, ResourceKind, ResourceMetadata, SandboxSession, SandboxEnvironmentEnsureInput, SandboxEnvironmentResolution, SandboxSnapshotPolicy, ScheduleTriggerDefinition, TriggerTarget } from "@assemblyline-agents/core";
 import type { ChannelTurn } from "./channel.js";
 import type { EvalRunOptions } from "./eval-run-options.js";
 import type { CheckpointRetentionPolicy } from "./checkpoints.js";
@@ -7,9 +7,12 @@ import type { ConnectionAuthorizationSessionStore, ConnectionGrantStore, Connect
 import type { RuntimePause } from "./harness-continuation.js";
 import type { RuntimeLogger } from "./logging.js";
 import type { SchedulerAdapter } from "./scheduler.js";
+import type { MediaProcessor } from "./media-processor.js";
 import type { CoreToolPolicy } from "./security.js";
 import type { ConnectionDefinitionStore, ScheduleStore, SkillStore } from "./self-improvement.js";
+import type { LearningStore } from "./learning-store.js";
 import type { DeliveryObligation, MemoryDocument, MemoryEmbeddingProvider, MemoryScope, MemorySearchResult, RunEvent, RunRecord, StateAdapter, StateStores, ToolCallRecord } from "./state.js";
+import type { ConnectionEventStore } from "./connection-event-store.js";
 import type { TelemetrySink, TelemetrySpan } from "./telemetry.js";
 /**
  * Runtime option/result/adapter contracts shared by the AssemblyLineRuntime class
@@ -25,6 +28,13 @@ export interface BlobPutOptions {
 export interface BlobAdapter {
     put(key: string, value: string | Uint8Array, contentTypeOrOptions?: string | BlobPutOptions): Promise<BlobRecord>;
     get(key: string): Promise<Uint8Array | undefined>;
+    delete(key: string): Promise<boolean>;
+    list(prefix?: string): Promise<BlobObjectRecord[]>;
+}
+export interface BlobObjectRecord {
+    key: string;
+    size: number;
+    modifiedAt?: string;
 }
 export interface BlobRecord {
     id: string;
@@ -37,8 +47,12 @@ export interface BlobRecord {
 }
 export interface SandboxAdapter {
     provider?: string;
-    acquire(run: RunRecord): Promise<SandboxSession>;
-    create?(run: RunRecord, input?: SandboxCreateInput): Promise<SandboxSession>;
+    /** Deployment-time environment reconciliation; runtime-only providers may omit it. */
+    ensureEnvironment?(input: SandboxEnvironmentEnsureInput): Promise<SandboxEnvironmentResolution>;
+    /** Optional convenience entrypoint for callers that do not manage durable session identity. */
+    acquire?(run: RunRecord): Promise<SandboxSession>;
+    /** Runtime entrypoint. Implementations must derive provider identity from input.sessionKey. */
+    create(run: RunRecord, input: SandboxCreateInput): Promise<SandboxSession>;
     lookup?(input: SandboxLookupInput): Promise<SandboxLookupResult | undefined>;
     connect?(input: SandboxReconnectInput): Promise<SandboxSession | undefined>;
     wake?(input: SandboxReconnectInput): Promise<SandboxSession | undefined>;
@@ -50,11 +64,15 @@ export interface SandboxAdapter {
 }
 export interface SandboxCreateInput {
     sessionKey: string;
+    agentScope: string;
+    logicalSessionKey: string;
     snapshotId?: string;
     metadata?: JsonObject;
 }
 export interface SandboxLookupInput {
     sessionKey: string;
+    agentScope: string;
+    logicalSessionKey: string;
     runId: string;
     agentRevision: string;
     manifest?: JsonObject;
@@ -68,7 +86,9 @@ export interface SandboxLookupResult {
 export interface SandboxReconnectInput {
     runId: string;
     sandboxId: string;
-    sessionKey?: string;
+    sessionKey: string;
+    agentScope: string;
+    logicalSessionKey: string;
     root?: string;
     manifest?: JsonObject;
 }
@@ -93,6 +113,10 @@ export interface RuntimeSandboxHandle {
     current(): SandboxSession | undefined;
     get(): Promise<SandboxSession>;
     getWrapped(): Promise<SandboxSession>;
+    /** Stop publishing a still-pending acquisition after its caller timed out or was cancelled. */
+    abandonAcquisition(): void;
+    /** Dispose the selected session so a changed hook profile is acquired lazily. */
+    reset(): Promise<void>;
     dispose(): Promise<void>;
 }
 export interface SandboxTombstone {
@@ -125,10 +149,14 @@ export interface RuntimeOptions {
     manifest: AgentManifest;
     /** Built artifact root used for runtime module-cache package resolution. */
     artifactRoot?: string;
+    /** Byte-for-byte skill bundle resource root (`<artifact>/resources`), when present. */
+    resourcesRoot?: string;
     state?: StateAdapter | StateStores;
     blob?: BlobAdapter;
     sandbox?: SandboxAdapter;
     scheduler?: SchedulerAdapter;
+    /** Gateway-provided attachment processors executed before model context construction. */
+    mediaProcessors?: MediaProcessor[];
     /** Persist delivery obligations without invoking channel senders (for evals and dry runs). */
     deliveryMode?: "send" | "record-only";
     /**
@@ -138,7 +166,7 @@ export interface RuntimeOptions {
      * model-output bounding still apply; connection tools are not stubbable.
      */
     toolStubs?: Record<string, (input: unknown) => unknown | Promise<unknown>>;
-    /** Optional pi model catalog override, forwarded to `piAgentHarness({ models })`. */
+    /** Optional Pi provider registry override, forwarded to `piAgentHarness({ models })`. */
     models?: unknown;
     /** Provider-prefix model harnesses; `agentHarness` remains higher precedence. */
     modelHarnesses?: Record<string, AgentHarness>;
@@ -152,14 +180,18 @@ export interface RuntimeOptions {
     connections?: Record<string, unknown>;
     env?: Record<string, string | undefined>;
     fetch?: typeof fetch;
+    /** DNS seam for attachment SSRF validation; defaults to the system resolver. */
+    attachmentHostResolver?: import("./outbound-http-policy.js").AttachmentHostResolver;
     telemetry?: TelemetrySink;
     /** Host/gateway-supplied instrumentation overrides; win over `instrumentation.ts`. */
     instrumentation?: RuntimeInstrumentationOverride;
     logger?: RuntimeLogger;
     connectionGrantStore?: ConnectionGrantStore;
     connectionAuthorizationSessionStore?: ConnectionAuthorizationSessionStore;
+    connectionEventStore?: ConnectionEventStore;
     connectionCallbackBaseUrl?: string;
     skillStore?: SkillStore;
+    learningStore?: LearningStore;
     scheduleStore?: ScheduleStore;
     connectionDefinitionStore?: ConnectionDefinitionStore;
     schedulerEnabled?: boolean;
@@ -176,12 +208,12 @@ export interface RuntimeOptions {
     deliveryQueueMaxAttempts?: number;
     deliveryQueueIntervalMs?: number;
     runHeartbeatMs?: number;
-    /** Wall-clock cap per active run execution segment (env `OPENEVE_MAX_RUN_DURATION_MS`). Default 1h; 0 disables. */
+    /** Wall-clock cap per active run execution segment (env `ASSEMBLY_LINE_MAX_RUN_DURATION_MS`). Default 1h; 0 disables. */
     maxRunDurationMs?: number;
     runRecoveryIntervalMs?: number;
-    /** Max simultaneously executing brand-new runs (env `OPENEVE_MAX_CONCURRENT_RUNS`). Default Infinity. Resumes never count against this. */
+    /** Max simultaneously executing brand-new runs (env `ASSEMBLY_LINE_MAX_CONCURRENT_RUNS`). Default Infinity. Resumes never count against this. */
     maxConcurrentRuns?: number;
-    /** Max brand-new runs waiting for a slot before rejection (env `OPENEVE_MAX_QUEUED_RUNS`). Default 0. */
+    /** Max brand-new runs waiting for a slot before rejection (env `ASSEMBLY_LINE_MAX_QUEUED_RUNS`). Default 0. */
     maxQueuedRuns?: number;
     checkpointRetention?: CheckpointRetentionPolicy;
     memoryEmbeddingProvider?: MemoryEmbeddingProvider;
@@ -194,9 +226,13 @@ export interface DynamicConnectionGrantInput {
     principal?: ConnectionPrincipal;
     principalKey?: string;
 }
+/** Non-secret, authenticated host intent for one connection's sandbox credential. */
+export interface SandboxCredentialRequest extends JsonObject {
+    repository: string;
+    capability: string;
+}
 export interface RunAgentOptions {
     message: string;
-    model?: string;
     toolName?: string;
     input?: unknown;
     approve?: boolean;
@@ -205,21 +241,39 @@ export interface RunAgentOptions {
     attachments?: JsonObject[];
     turn?: ChannelTurn;
     metadata?: JsonObject;
+    /** Exact per-connection resource/capability requests. Persisted for audit; never contains credential values. */
+    sandboxCredentials?: Record<string, SandboxCredentialRequest>;
     eventId?: string;
     userId?: string;
+    /** Canonical current actor. Authenticated channel/host code owns this value. */
+    principal?: AgentPrincipal;
+    /** Canonical actor that originally started the conversation. */
+    initiator?: AgentPrincipal;
+    /** Immutable trust boundary. Direct runs default to the whole agent. */
+    audience?: AgentAudience;
     conversationId?: string;
     projectId?: string;
+    /** Select an existing durable workspace instead of resolving one from the run scope. */
+    workspaceId?: string;
+    /** Tenant boundary used to authorize explicit workspace selection. */
+    tenantId?: string;
     delivery?: JsonObject;
     existingRun?: RunRecord;
     target?: TriggerTarget;
     promptContext?: JsonObject;
     trustedAttachmentProvider?: string;
+    /** Explicitly permit generic public HTTP(S) attachment metadata for this direct run. */
+    allowRemoteAttachments?: boolean;
     /**
      * Eval harness options (tool stubs, approval auto-resolve, record-only
      * delivery). Persisted verbatim into RunRecord.input.eval so the block is
      * auditable in run detail and survives crash-resume.
      */
     eval?: EvalRunOptions;
+    /** Runtime-owned frozen context used only by exact run replay. */
+    contextSnapshot?: ContextBundle;
+    /** Durable provenance for a runtime-owned exact-input replay. */
+    replay?: RunReplayProvenance;
     /**
      * Pre-acquired capacity admission from a host entry point that claimed the
      * slot before consuming an idempotency key. Internal; `run()` releases it.
@@ -238,6 +292,14 @@ export interface RunAgentOptions {
      */
     onRunCreated?: (run: RunRecord) => Promise<void> | void;
 }
+export interface RunReplayProvenance {
+    sourceRunId: string;
+    sourceAgentRevision: string;
+    inputSha256: string;
+    contextSha256: string;
+    attachmentSha256s: string[];
+    deliveryMode: "record-only";
+}
 export interface RunAgentResult {
     run: RunRecord;
     events: RunEvent[];
@@ -296,20 +358,25 @@ export interface RuntimeScheduleExecution {
     message: string;
     channel: string;
     trigger?: ScheduleTriggerDefinition;
+    lifecycle?: CompiledAutomationLifecycle;
     target?: TriggerTarget;
     automationEvent?: import("@assemblyline-agents/core").AutomationEvent;
     metadata: JsonObject;
     definition: JsonObject;
     userId?: string;
+    principal?: AgentPrincipal;
+    initiator?: AgentPrincipal;
+    audience?: AgentAudience;
     conversationId?: string;
     projectId?: string;
+    workspaceId?: string;
+    tenantId?: string;
     delivery?: JsonObject;
     turnMetadata?: JsonObject;
 }
 export interface FilesystemSyncResult {
     memoryRevision: string;
     memoryFiles: BlobRecord[];
-    artifacts: BlobRecord[];
     fileRevisions: JsonObject[];
 }
 /** Engine-neutral session state the runtime persists alongside an opaque harness continuation. */
@@ -337,6 +404,8 @@ export interface HarnessLoopState {
     defaultToolNames: Set<string>;
     connectionRegistry: RuntimeConnectionRegistry;
     discoveredConnectionTools: Map<string, ConnectionToolMetadata>;
+    /** Deferred tools registered with an engine-native discovery surface. */
+    exposedDeferredToolNames: Set<string>;
     setPause: (pause: RuntimePause) => void;
 }
 /** Engine-neutral fields restored from a persisted harness continuation checkpoint. */