@assemblyline-agents/runtime 0.1.0

package/dist/resource-projection-util.js

@@ -0,0 +1,298 @@
+import { createHash } from "node:crypto";
+import { existsSync } from "node:fs";
+import { join } from "node:path";
+import { attachmentResourcePath } from "./attachments.js";
+import { resolveBooleanEnv, resolvePositiveIntegerEnv } from "./env-config.js";
+import { stringValue } from "./runtime-util.js";
+import { markReadOnly, markWritable } from "./sandbox-fs.js";
+import { parseSkillBody } from "./self-improvement.js";
+import { estimateTokens, memoryBodyText } from "./storage.js";
+/**
+ * Resource-projection leaf helpers: metadata builders for memory, skill,
+ * history, attachment, file-index, and runtime-context resources, plus the
+ * path normalization/validation rules for projecting them into the sandbox.
+ */
+export const RESOURCE_KINDS = ["memory", "file", "history", "skill", "runtime"];
+export const RESOURCE_ROOTS = ["/memory", "/files", "/history", "/skills", "/workspace"];
+export function isResourceKind(value) {
+    return typeof value === "string" && RESOURCE_KINDS.includes(value);
+}
+export function resolveResourceProjectionPolicy(policy, env) {
+    const maxFiles = policy?.maxFiles ?? resolvePositiveIntegerEnv(env.OPENEVE_RESOURCE_PROJECTION_MAX_FILES, 8);
+    const maxTotalBytes = policy?.maxTotalBytes ?? resolvePositiveIntegerEnv(env.OPENEVE_RESOURCE_PROJECTION_MAX_BYTES, 256 * 1024);
+    const envKinds = typeof env.OPENEVE_RESOURCE_PROJECTION_ALLOWED_KINDS === "string"
+        ? env.OPENEVE_RESOURCE_PROJECTION_ALLOWED_KINDS.split(",").map((kind) => kind.trim()).filter(isResourceKind)
+        : undefined;
+    return {
+        maxFiles,
+        maxTotalBytes,
+        allowedKinds: new Set(policy?.allowedKinds ?? envKinds ?? RESOURCE_KINDS),
+        allowWritable: policy?.allowWritable ?? resolveBooleanEnv(env.OPENEVE_RESOURCE_PROJECTION_ALLOW_WRITABLE, false)
+    };
+}
+export function memoryDocumentResourceMetadata(document) {
+    const body = memoryBodyText(document);
+    return resourceMetadata({
+        path: document.path,
+        kind: "memory",
+        contentType: document.contentType,
+        contents: body,
+        mutability: "writable",
+        trustLevel: "untrusted",
+        source: "memory",
+        revision: document.revision,
+        tokenEstimate: document.tokenEstimate,
+        sha256: document.sha256
+    });
+}
+export function skillResourceMetadata(skill) {
+    return resourceMetadata({
+        path: `/skills/${skill.name}/SKILL.md`,
+        kind: "skill",
+        contentType: "text/markdown",
+        contents: skill.body,
+        mutability: "writable",
+        trustLevel: "trusted",
+        source: `skill:${skill.origin}`,
+        revision: skill.bodySha256,
+        tokenEstimate: estimateTokens(skill.body),
+        sha256: skill.bodySha256
+    });
+}
+export function historyResourceMetadata(bundle) {
+    return [
+        historyResource("/history/brief.md", bundle.recentHistory.slice(-5).join("\n")),
+        historyResource("/history/recent.md", bundle.recentHistory.join("\n")),
+        historyResource("/history/index.json", JSON.stringify({ generatedFrom: "context-bundle", entries: bundle.recentHistory.length }, null, 2), "application/json")
+    ].map((resource) => resource.metadata);
+}
+export function resolveHistoryResource(bundle, path) {
+    if (path === "/history/brief.md")
+        return historyResource(path, bundle.recentHistory.slice(-5).join("\n"));
+    if (path === "/history/recent.md")
+        return historyResource(path, bundle.recentHistory.join("\n"));
+    if (path === "/history/index.json") {
+        return historyResource(path, JSON.stringify({ generatedFrom: "context-bundle", entries: bundle.recentHistory.length }, null, 2), "application/json");
+    }
+    return undefined;
+}
+export function historyResource(path, contents, contentType = "text/markdown") {
+    return {
+        metadata: resourceMetadata({
+            path,
+            kind: "history",
+            contentType,
+            contents,
+            mutability: "read-only",
+            trustLevel: "untrusted",
+            source: "conversation-history",
+            tokenEstimate: estimateTokens(contents)
+        }),
+        contents
+    };
+}
+export function runtimeContextResourceMetadata(bundle) {
+    const contents = runtimeContextResourceBody(bundle);
+    return resourceMetadata({
+        path: "/workspace/.openeve/context.json",
+        kind: "runtime",
+        contentType: "application/json",
+        contents,
+        mutability: "read-only",
+        trustLevel: "derived",
+        source: "context-bundle",
+        revision: bundle.id,
+        tokenEstimate: estimateTokens(contents)
+    });
+}
+export function resolveRuntimeResource(bundle, path) {
+    if (path !== "/workspace/.openeve/context.json")
+        return undefined;
+    const contents = runtimeContextResourceBody(bundle);
+    return {
+        metadata: runtimeContextResourceMetadata(bundle),
+        contents
+    };
+}
+export function runtimeContextResourceBody(bundle) {
+    return JSON.stringify({
+        ...bundle,
+        skillFilesystem: {}
+    }, null, 2);
+}
+export function attachmentResourceMetadataForContents(attachment, contents) {
+    const metadataInput = {
+        path: attachmentResourcePath(attachment),
+        kind: "file",
+        contentType: stringValue(attachment.contentType) || stringValue(attachment.mimeType) || "text/plain",
+        contents,
+        mutability: "read-only",
+        trustLevel: "untrusted",
+        source: "turn-attachment",
+        revision: stringValue(attachment.revision) || resourceSha256(contents)
+    };
+    if (typeof contents === "string")
+        metadataInput.tokenEstimate = estimateTokens(contents);
+    return resourceMetadata({
+        ...metadataInput
+    });
+}
+export function fileIndexResourcePath(record) {
+    const normalized = normalizeResourcePath(record.path);
+    return normalized.startsWith("/files") ? normalized : `/files/catalog/${sanitizeResourcePath(normalized)}`;
+}
+export function fileIndexResourceMetadata(record) {
+    const contentType = typeof record.metadata.contentType === "string" ? record.metadata.contentType : "application/octet-stream";
+    return {
+        path: fileIndexResourcePath(record),
+        kind: "file",
+        contentType,
+        sizeBytes: record.sizeBytes,
+        sha256: record.sha256,
+        mutability: "read-only",
+        trustLevel: "untrusted",
+        source: "file-index",
+        revision: record.sha256
+    };
+}
+export function resourceMetadata(input) {
+    const metadata = {
+        path: normalizeResourcePath(input.path),
+        kind: input.kind,
+        contentType: input.contentType,
+        sizeBytes: resourceByteLength(input.contents),
+        sha256: input.sha256 ?? resourceSha256(input.contents),
+        mutability: input.mutability,
+        trustLevel: input.trustLevel,
+        source: input.source
+    };
+    if (input.revision)
+        metadata.revision = input.revision;
+    if (input.tokenEstimate !== undefined)
+        metadata.tokenEstimate = input.tokenEstimate;
+    return metadata;
+}
+export function resourceByteLength(contents) {
+    return typeof contents === "string" ? Buffer.byteLength(contents) : contents.byteLength;
+}
+export function sandboxWriteByteLength(contents) {
+    return typeof contents === "string" ? Buffer.byteLength(contents) : contents.byteLength;
+}
+export function resourceSha256(contents) {
+    return createHash("sha256").update(contents).digest("hex");
+}
+export function resourceContentsForModel(contents, maxBytes) {
+    const bytes = typeof contents === "string" ? Buffer.from(contents) : Buffer.from(contents);
+    const truncated = bytes.byteLength > maxBytes;
+    const slice = truncated ? bytes.subarray(0, maxBytes) : bytes;
+    if (typeof contents === "string") {
+        return { body: slice.toString("utf8"), encoding: "utf8", truncated };
+    }
+    return { body: slice.toString("base64"), encoding: "base64", truncated };
+}
+export function normalizeResourceProjectionSelectors(input) {
+    const selectors = [];
+    if (input.path)
+        selectors.push({ path: input.path });
+    for (const path of input.paths ?? [])
+        selectors.push({ path });
+    for (const resource of input.resources ?? []) {
+        const selector = { path: resource.path };
+        if (resource.sandboxPath)
+            selector.sandboxPath = resource.sandboxPath;
+        if (resource.writable !== undefined)
+            selector.writable = resource.writable;
+        selectors.push(selector);
+    }
+    const seen = new Set();
+    return selectors.filter((selector) => {
+        const key = `${selector.path}\n${selector.sandboxPath ?? ""}`;
+        if (seen.has(key))
+            return false;
+        seen.add(key);
+        return true;
+    });
+}
+export function normalizeResourcePath(path) {
+    const normalized = path.replace(/\\/g, "/").replace(/\/+/g, "/").trim();
+    const absolute = normalized.startsWith("/") ? normalized : `/${normalized}`;
+    if (absolute.split("/").some((part) => part === "..")) {
+        throw new Error(`Invalid resource path: ${path}`);
+    }
+    return absolute === "/" ? "/" : absolute.replace(/\/$/u, "");
+}
+export function normalizeProjectionSandboxPath(path) {
+    const normalized = normalizeResourcePath(path);
+    if (!RESOURCE_ROOTS.some((root) => normalized === root || normalized.startsWith(`${root}/`))) {
+        throw new Error(`Resource projection target must be under ${RESOURCE_ROOTS.join(", ")}.`);
+    }
+    return normalized;
+}
+export function skillNameFromResourcePath(path) {
+    const direct = /^\/skills\/([^/]+)\/SKILL\.md$/u.exec(path);
+    if (direct?.[1])
+        return direct[1];
+    const runtime = /^\/workspace\/\.agents\/skills\/([^/]+)\/SKILL\.md$/u.exec(path);
+    return runtime?.[1];
+}
+export function skillNameFromSandboxRelativePath(relativePath) {
+    const normalized = relativePath.replace(/\\/g, "/").replace(/^\/+/u, "");
+    const match = /^([^/]+)\/SKILL\.md$/u.exec(normalized);
+    const name = match?.[1];
+    return name && isValidSandboxSkillName(name) ? name : undefined;
+}
+export function skillNameFromSkillPath(path) {
+    try {
+        const name = skillNameFromResourcePath(normalizeResourcePath(path));
+        return name && isValidSandboxSkillName(name) ? name : undefined;
+    }
+    catch {
+        return undefined;
+    }
+}
+export function isValidSandboxSkillName(name) {
+    return /^[A-Za-z0-9_-]+$/u.test(name);
+}
+export function isValidSandboxSkillBody(body) {
+    if (!/^---\n[\s\S]*?\n---\n?/u.test(body))
+        return false;
+    const parsed = parseSkillBody(body);
+    return parsed.instructions.trim().length > 0;
+}
+export function sandboxFileContentsToUtf8(contents) {
+    return typeof contents === "string" ? contents : Buffer.from(contents).toString("utf8");
+}
+export function sha256Text(contents) {
+    return createHash("sha256").update(contents).digest("hex");
+}
+export async function writeProjectedResourceToSandbox(sandbox, path, contents) {
+    const localReadOnlyRoot = localReadOnlyRootForProjection(sandbox, path);
+    if (localReadOnlyRoot)
+        markWritable(localReadOnlyRoot);
+    try {
+        await sandbox.writeFile(path, contents);
+    }
+    finally {
+        if (localReadOnlyRoot)
+            markReadOnly(localReadOnlyRoot);
+    }
+}
+export function localReadOnlyRootForProjection(sandbox, path) {
+    const normalized = normalizeResourcePath(path);
+    if (!normalized.startsWith("/files/") && !normalized.startsWith("/history/"))
+        return undefined;
+    if (!sandbox.root || !existsSync(sandbox.root))
+        return undefined;
+    const root = normalized.startsWith("/files/") ? "files" : "history";
+    return join(sandbox.root, root);
+}
+export function sanitizeResourcePath(path) {
+    return path
+        .replace(/\\/g, "/")
+        .replace(/^\/+/u, "")
+        .split("/")
+        .filter((part) => part && part !== "." && part !== "..")
+        .map((part) => part.replace(/[^A-Za-z0-9._-]/gu, "_"))
+        .join("/") || "resource";
+}
+//# sourceMappingURL=resource-projection-util.js.map

package/dist/resource-projection-util.js.map

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

package/dist/resource-projection.d.ts

@@ -0,0 +1,45 @@
+import type { ResourceListInput, ResourceMetadata, ResourceProjectInput, ResourceProjectResult, ResourceReadInput, ResourceReadResult, SandboxSession } from "@assemblyline-agents/core";
+import type { BlobAdapter, MemoryDocumentBackfillResult, MemoryEmbeddingBackfillResult, MemoryStore, ResolvedResourceProjectionPolicy, SandboxTombstone } from "./runtime-types.js";
+import type { SkillStore } from "./self-improvement.js";
+import type { MemoryEmbeddingProvider, MemoryScope, RunRecord, StateAdapter } from "./state.js";
+/**
+ * Resource projection: listing/reading logical resources (/memory, /skills,
+ * /history, /files, runtime context) for a run, projecting them into the
+ * sandbox filesystem with policy enforcement, tombstone bookkeeping for
+ * deletions, and the memory backfill sweeps. Follows the
+ * delivery-queue/run-recovery host-delegate pattern: OpenEveRuntime builds a
+ * {@link ResourceProjectionHost} closing over itself and keeps thin delegate
+ * methods with unchanged signatures.
+ */
+/** Narrow slice of the runtime the resource projection paths need. */
+export interface ResourceProjectionHost {
+    state: StateAdapter;
+    blob: BlobAdapter;
+    memoryStore: MemoryStore;
+    skillStore: SkillStore;
+    resourceProjectionPolicy: ResolvedResourceProjectionPolicy;
+    memoryEmbeddingProvider: MemoryEmbeddingProvider | undefined;
+    memoryEmbeddingsEnabled: boolean;
+    skillScope(): string;
+    durableAgentScope(): string;
+}
+export declare function listResourcesForRunImpl(host: ResourceProjectionHost, run: RunRecord, scope: MemoryScope, input?: ResourceListInput): Promise<ResourceMetadata[]>;
+export declare function readResourceForRunImpl(host: ResourceProjectionHost, run: RunRecord, scope: MemoryScope, input: ResourceReadInput): Promise<ResourceReadResult>;
+export declare function projectResourcesForRunImpl(host: ResourceProjectionHost, run: RunRecord, scope: MemoryScope, sandbox: SandboxSession, input: ResourceProjectInput): Promise<ResourceProjectResult>;
+export declare function projectSkillIntoSandboxImpl(host: ResourceProjectionHost, run: RunRecord, sandbox: SandboxSession, skillName: string): Promise<void>;
+export declare function hydrateLogicalPathForToolImpl(host: ResourceProjectionHost, run: RunRecord, sandbox: SandboxSession, path: string, options?: {
+    list?: boolean;
+    limit?: number;
+}): Promise<void>;
+export declare function recordSandboxTombstoneImpl(host: ResourceProjectionHost, run: RunRecord, sandbox: SandboxSession, path: string): Promise<void>;
+export declare function readSandboxTombstonesWithMissingProjectedFilesImpl(host: ResourceProjectionHost, sandbox: SandboxSession): Promise<SandboxTombstone[]>;
+export declare function memoryScopeForRunImpl(host: ResourceProjectionHost, run: RunRecord): MemoryScope;
+export declare function backfillMemoryDocumentsFromFileIndexesImpl(host: ResourceProjectionHost, options?: {
+    runId?: string;
+    limit?: number;
+}): Promise<MemoryDocumentBackfillResult>;
+export declare function runMemoryEmbeddingBackfillImpl(host: ResourceProjectionHost, options?: {
+    scope?: MemoryScope;
+    limit?: number;
+}): Promise<MemoryEmbeddingBackfillResult>;
+//# sourceMappingURL=resource-projection.d.ts.map

package/dist/resource-projection.d.ts.map

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