@assemblyline-agents/core 0.1.0

package/dist/sandbox-types.d.ts

@@ -0,0 +1,114 @@
+import type { AgentManifest, JsonObject, MaybePromise } from "./index.js";
+export interface SandboxSession {
+    id: string;
+    root: string;
+    provider?: string;
+    metadata?: JsonObject;
+    readFile(path: string): MaybePromise<string>;
+    writeFile(path: string, contents: string | Uint8Array): MaybePromise<void>;
+    listFiles?(path: string, options?: {
+        excludeTopLevel?: string[];
+    }): MaybePromise<SandboxFileEntry[]>;
+    deletePath?(path: string, options?: {
+        recursive?: boolean;
+    }): MaybePromise<void>;
+    shell(command: string, options?: {
+        cwd?: string;
+        timeoutMs?: number;
+        env?: Record<string, string>;
+    }): MaybePromise<SandboxCommandResult>;
+    spawn?(command: string, args: string[], options?: SandboxSpawnOptions): MaybePromise<SandboxProcess>;
+    snapshot?(request?: SandboxSnapshotRequest): MaybePromise<SandboxSnapshot>;
+    dispose?(): MaybePromise<void>;
+}
+export interface SandboxSpawnOptions {
+    cwd?: string;
+    env?: Record<string, string>;
+    timeoutMs?: number;
+    stdin?: string | Uint8Array;
+}
+export interface SandboxProcess {
+    id: string;
+    stdout: AsyncIterable<string>;
+    stderr: AsyncIterable<string>;
+    completed: Promise<SandboxCommandResult>;
+    write?(input: string | Uint8Array): MaybePromise<void>;
+    kill?(signal?: string): MaybePromise<void>;
+}
+export type SandboxSnapshotMode = "never" | "manual" | "on_failure" | "always";
+export interface SandboxSnapshotPolicy {
+    mode: SandboxSnapshotMode;
+    retainLast?: number;
+    reason?: string;
+    metadata?: JsonObject;
+}
+export interface SandboxSnapshotRequest {
+    mode: SandboxSnapshotMode;
+    reason: string;
+    retainLast?: number;
+    metadata?: JsonObject;
+}
+export interface SandboxFileEntry {
+    path: string;
+    contents: string | Uint8Array;
+    size?: number;
+}
+export interface SandboxCommandResult {
+    command: string;
+    exitCode: number;
+    stdout: string;
+    stderr: string;
+    durationMs: number;
+}
+export interface SandboxSnapshot {
+    id: string;
+    createdAt: string;
+    metadata?: JsonObject;
+}
+export interface SandboxDefinition {
+    adapter: string;
+    image?: string;
+    workingDirectory?: string;
+    env?: string[];
+    snapshot?: SandboxSnapshotPolicy;
+    metadata?: JsonObject;
+}
+export interface InstrumentationSetupContext {
+    agentName: string;
+    manifest: AgentManifest;
+    env: Record<string, string | undefined>;
+}
+/**
+ * How much of each model call is recorded on telemetry spans. `off` disables
+ * span content; `usage` (the default) records token/cost/model/tool metadata
+ * but no message bodies; `content` adds prompt/completion/tool content
+ * (truncated + redacted); `full` is the same coverage with truncation relaxed.
+ */
+export type ContentCaptureLevel = "off" | "usage" | "content" | "full";
+/** Developer-controlled capture policy; a bare level is sugar for `{ level }`. */
+export interface ContentCapturePolicy {
+    level: ContentCaptureLevel;
+    /** Per-field character cap before truncation. Default ~8000 (relaxed at `full`). */
+    maxChars?: number;
+    /** Key-based redaction of sensitive values. Default true (even at `full`). */
+    redact?: boolean;
+    /** Extra sensitive key names to redact, in addition to the built-in set. */
+    redactKeys?: string[];
+    /** Per-trace sampling of content, 0..1 (usage/metadata always exported). Default 1. */
+    sampleRate?: number;
+    /** Capture tool arguments/results. Defaults to (level === "content" || "full"). */
+    includeToolIO?: boolean;
+}
+export interface InstrumentationDefinition {
+    serviceName?: string;
+    /** Environment variables required before a hosted runtime can initialize telemetry. */
+    requiredEnv?: string[];
+    setup?: (context: InstrumentationSetupContext) => MaybePromise<unknown>;
+    recordInputs?: boolean;
+    recordOutputs?: boolean;
+    /** Content capture detail. A bare level string is shorthand for `{ level }`. */
+    captureContent?: ContentCaptureLevel | ContentCapturePolicy;
+    functionId?: string;
+    metadata?: JsonObject;
+}
+//# sourceMappingURL=sandbox-types.d.ts.map

package/dist/sandbox-types.d.ts.map

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

package/dist/sandbox-types.js

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

package/dist/sandbox-types.js.map

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

package/package.json

@@ -0,0 +1,47 @@
+{
+  "name": "@assemblyline-agents/core",
+  "version": "0.1.0",
+  "type": "module",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    }
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "check": "tsc -p tsconfig.json --noEmit"
+  },
+  "dependencies": {
+    "ajv": "^8.20.0"
+  },
+  "description": "Vendor-neutral, filesystem-first framework for durable AI agents.",
+  "files": [
+    "dist"
+  ],
+  "engines": {
+    "node": ">=22.19.0"
+  },
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/jasonbadeaux/openeve.git",
+    "directory": "packages/core"
+  },
+  "bugs": {
+    "url": "https://github.com/jasonbadeaux/openeve/issues"
+  },
+  "homepage": "https://github.com/jasonbadeaux/openeve#readme",
+  "author": "OpenEve contributors",
+  "keywords": [
+    "openeve",
+    "ai",
+    "agents",
+    "framework",
+    "durable-agents",
+    "filesystem-first"
+  ],
+  "publishConfig": {
+    "access": "public"
+  }
+}