@assemblyline-agents/runtime 0.1.0

package/dist/tool-apis.js

@@ -0,0 +1,344 @@
+import { isJsonObject, safeJson } from "./json-util.js";
+import { durableStepEventData, timestamp } from "./runtime-util.js";
+import { memoryDocumentForModel, memoryDocumentSummary } from "./storage.js";
+/**
+ * The tool execution context handed to authored tools and the tool-API
+ * factories it composes: self-improvement, schedule manager, connection
+ * manager, memory, and resources, plus the durable step helper and the
+ * approval guards those APIs enforce. Imports only the
+ * {@link ToolExecutionHost} type from ./tool-execution.js, so the value-level
+ * module graph stays acyclic.
+ */
+export class HumanInputRequired extends Error {
+    question;
+    options;
+    constructor(question, options) {
+        super("Human input required.");
+        this.name = "HumanInputRequired";
+        this.question = question;
+        if (options)
+            this.options = options;
+    }
+}
+export function createToolContext(host, run, sandboxHandle, approvedToolCall = false) {
+    const scheduleManager = createScheduleManagerToolApi(host, run, approvedToolCall);
+    return {
+        runId: run.id,
+        agentRevision: host.manifest.agentRevision,
+        approvedToolCall,
+        connections: Object.fromEntries(host.manifest.connections.map((connection) => [
+            connection.name,
+            host.connections[connection.name] ?? { provider: connection.provider, required: connection.required }
+        ])),
+        channel: toolChannelContext(host, run),
+        getSandbox: async () => sandboxHandle.getWrapped(),
+        hydrateSandboxPath: async (path, options) => {
+            const sandbox = await sandboxHandle.get();
+            await host.hydrateLogicalPathForTool(run, sandbox, path, options);
+        },
+        recordSandboxTombstone: async (path) => {
+            const sandbox = await sandboxHandle.getWrapped();
+            await host.recordSandboxTombstone(run, sandbox, path);
+        },
+        spawnSubagent: async (input) => {
+            const timeline = await host.runSubagent(run.id, input.name, {
+                task: input.task,
+                ...(input.expectedOutput ? { expectedOutput: input.expectedOutput } : {}),
+                ...(input.constraints ? { constraints: input.constraints } : {})
+            });
+            return {
+                runId: timeline.run.id,
+                status: timeline.run.status,
+                events: timeline.events.map((event) => ({ type: event.type, data: event.data })).slice(-8)
+            };
+        },
+        memory: createMemoryToolApiImpl(host, run),
+        resources: createResourceToolApiImpl(host, run, sandboxHandle),
+        askQuestion: async (question, options) => {
+            const jsonOptions = {};
+            if (options?.choices)
+                jsonOptions.choices = options.choices;
+            if (typeof options?.allowFreeform === "boolean")
+                jsonOptions.allowFreeform = options.allowFreeform;
+            if (options?.metadata)
+                jsonOptions.metadata = options.metadata;
+            throw new HumanInputRequired(question, jsonOptions);
+        },
+        emit: async (eventType, data = {}) => {
+            await host.state.appendEvent(run.id, eventType, data);
+        },
+        idempotencyKey: (scope) => `${run.id}:${scope}`,
+        step: (key, fn, options) => durableStepImpl(host, run.id, key, fn, options),
+        ...(host.skillsConfig.writable ? { selfImprovement: createSelfImprovementToolApi(host) } : {}),
+        automationManager: automationManagerFromScheduleManager(scheduleManager),
+        scheduleManager,
+        connectionManager: createConnectionManagerToolApi(host, approvedToolCall)
+    };
+}
+function automationManagerFromScheduleManager(manager) {
+    return {
+        createAutomation: (input) => manager.createSchedule(input),
+        listAutomations: () => manager.listSchedules(),
+        updateAutomation: (id, patch) => manager.updateSchedule(id, patch),
+        deleteAutomation: (id) => manager.deleteSchedule(id)
+    };
+}
+export async function durableStepImpl(host, runId, key, fn, options) {
+    if (typeof key !== "string" || key.trim().length === 0) {
+        throw new Error("Durable step key must be a non-empty string.");
+    }
+    const stepKey = key;
+    const eventData = durableStepEventData(stepKey, options);
+    const checkpoints = await host.listHydratedCheckpoints(runId);
+    for (let index = checkpoints.length - 1; index >= 0; index -= 1) {
+        const checkpoint = checkpoints[index];
+        if (!checkpoint || checkpoint.name !== "durable_step.completed")
+            continue;
+        if (checkpoint.data.key !== stepKey || !Object.prototype.hasOwnProperty.call(checkpoint.data, "result"))
+            continue;
+        await host.state.appendEvent(runId, "durable_step.replayed", {
+            ...eventData,
+            checkpointId: checkpoint.id
+        });
+        return checkpoint.data.result;
+    }
+    await host.state.appendEvent(runId, "durable_step.started", eventData);
+    let result;
+    try {
+        result = safeJson(await fn());
+    }
+    catch (error) {
+        await host.state.appendEvent(runId, "durable_step.failed", {
+            ...eventData,
+            error: error instanceof Error ? error.message : String(error)
+        });
+        throw error;
+    }
+    const checkpointData = { ...eventData, result };
+    await host.createCheckpoint({
+        runId,
+        name: "durable_step.completed",
+        data: checkpointData
+    });
+    await host.state.appendEvent(runId, "durable_step.completed", eventData);
+    return result;
+}
+/** Skill self-authoring API (the `selfImprovement` surface — skills only). */
+function createSelfImprovementToolApi(host) {
+    const runtime = host;
+    return {
+        async saveSkill(input) {
+            return runtime.saveSkill(input);
+        },
+        async listSkills() {
+            return runtime.listSkills();
+        },
+        async deleteSkill(name) {
+            await runtime.deleteSkill(name);
+        }
+    };
+}
+/** Dynamic-schedule management API. */
+function createScheduleManagerToolApi(host, run, approvedToolCall) {
+    const runtime = host;
+    const scheduleScope = host.scheduleScopeForRun(run);
+    const channelName = typeof run.input.channel === "string" ? run.input.channel : "local";
+    const userId = typeof run.input.userId === "string" ? run.input.userId : undefined;
+    const conversationId = typeof run.input.conversationId === "string" ? run.input.conversationId : undefined;
+    const projectId = typeof run.input.projectId === "string" ? run.input.projectId : undefined;
+    return {
+        async createSchedule(input) {
+            requireDynamicScheduleApproval(runtime, approvedToolCall);
+            const created = await runtime.createDynamicSchedule({
+                scope: scheduleScope,
+                ...(input.prompt ? { prompt: input.prompt } : {}),
+                ...(input.message ? { message: input.message } : {}),
+                channel: input.channel ?? channelName,
+                ...(userId ? { userId } : {}),
+                ...(conversationId ? { conversationId } : {}),
+                ...(projectId ? { projectId } : {}),
+                ...(input.target ? { target: input.target } : {}),
+                ...(input.trigger ? { trigger: input.trigger } : {}),
+                ...(input.cron ? { cron: input.cron } : {}),
+                ...(input.everyMinutes !== undefined ? { everyMinutes: input.everyMinutes } : {}),
+                ...(input.timezone ? { timezone: input.timezone } : {}),
+                ...(input.firstRunAt ? { firstRunAt: input.firstRunAt } : {}),
+                ...(input.enabled !== undefined ? { enabled: input.enabled } : {}),
+                ...(input.metadata ? { metadata: input.metadata } : {})
+            });
+            return safeJson(created);
+        },
+        async listSchedules() {
+            const schedules = await runtime.listDynamicSchedules(scheduleScope);
+            return schedules.map((schedule) => safeJson(schedule));
+        },
+        async updateSchedule(id, patch) {
+            requireDynamicScheduleApproval(runtime, approvedToolCall);
+            const updated = await runtime.updateDynamicSchedule(scheduleScope, id, patch);
+            return safeJson(updated);
+        },
+        async deleteSchedule(id) {
+            requireDynamicScheduleApproval(runtime, approvedToolCall);
+            return runtime.deleteDynamicSchedule(scheduleScope, id);
+        }
+    };
+}
+/** Dynamic-connection management API. */
+function createConnectionManagerToolApi(host, approvedToolCall) {
+    const runtime = host;
+    return {
+        async saveConnection(input) {
+            requireDynamicConnectionApproval(runtime, approvedToolCall);
+            const saveInput = {
+                name: input.name,
+                protocol: input.protocol,
+                description: input.description,
+                definition: input.definition
+            };
+            return runtime.saveConnectionDefinition(saveInput);
+        },
+        async listConnections() {
+            return runtime.listConnectionDefinitions();
+        },
+        async deleteConnection(name) {
+            requireDynamicConnectionApproval(runtime, approvedToolCall);
+            await runtime.deleteConnectionDefinition(name);
+        }
+    };
+}
+function requireDynamicScheduleApproval(host, approvedToolCall) {
+    if (host.schedulesConfig.approval && !approvedToolCall) {
+        throw new Error("Dynamic schedule changes require an approved tool call.");
+    }
+}
+function requireDynamicConnectionApproval(host, approvedToolCall) {
+    if (host.connectionsConfig.approval && !approvedToolCall) {
+        throw new Error("Dynamic connection changes require an approved tool call.");
+    }
+}
+function toolChannelContext(host, run) {
+    const input = run.input;
+    const channelName = typeof input.channel === "string" ? input.channel : "local";
+    const turn = { channel: channelName };
+    if (typeof input.eventId === "string")
+        turn.eventId = input.eventId;
+    if (typeof input.conversationId === "string")
+        turn.conversationId = input.conversationId;
+    if (typeof input.userId === "string")
+        turn.userId = input.userId;
+    if (typeof input.message === "string")
+        turn.message = input.message;
+    if (isJsonObject(input.delivery))
+        turn.delivery = input.delivery;
+    if (isJsonObject(input.metadata))
+        turn.metadata = input.metadata;
+    const context = { name: channelName, env: host.env, turn };
+    if (host.fetch)
+        context.fetch = host.fetch;
+    return context;
+}
+export function createMemoryToolApiImpl(host, run) {
+    const runtime = host;
+    const scope = host.memoryScopeForRun(run);
+    return {
+        async list(input) {
+            const documents = await runtime.memoryStore.list(scope, input);
+            await runtime.state.appendEvent(run.id, "memory.list_completed", {
+                pathPrefix: input.pathPrefix ?? null,
+                count: documents.length
+            });
+            return {
+                documents: documents.map(memoryDocumentSummary)
+            };
+        },
+        async search(input) {
+            const spanStartedAt = timestamp();
+            const results = await runtime.memoryStore.search(scope, input);
+            await runtime.state.appendEvent(run.id, "memory.search_completed", {
+                query: input.query,
+                mode: input.mode ?? "hybrid",
+                count: results.length
+            });
+            await runtime.emitSpan("ai.assembly-line.memory.search", spanStartedAt, runtime.runSpanAttributes(run, {
+                mode: input.mode ?? "hybrid",
+                resultCount: results.length,
+                pathPrefix: input.pathPrefix ?? "",
+                status: "completed"
+            }), {
+                parentSpanId: runtime.turnSpanId(run.id),
+                status: "ok"
+            });
+            return { results: results.map((result) => safeJson(result)) };
+        },
+        async read(input) {
+            const document = await runtime.memoryStore.read(scope, input);
+            await runtime.state.appendEvent(run.id, "memory.read_completed", {
+                path: input.path,
+                found: Boolean(document)
+            });
+            return document ? memoryDocumentForModel(document) : { path: input.path, found: false };
+        },
+        async write(input) {
+            const document = await runtime.memoryStore.write(scope, input);
+            await runtime.state.appendEvent(run.id, "memory.write_completed", {
+                path: document.path,
+                revision: document.revision,
+                tokenEstimate: document.tokenEstimate
+            });
+            return memoryDocumentForModel(document);
+        }
+    };
+}
+export function createResourceToolApiImpl(host, run, sandboxHandle) {
+    const runtime = host;
+    const scope = host.memoryScopeForRun(run);
+    return {
+        async list(input = {}) {
+            const resources = await runtime.listResourcesForRun(run, scope, input);
+            await runtime.state.appendEvent(run.id, "resource.list_completed", {
+                pathPrefix: input.pathPrefix ?? null,
+                kind: input.kind ?? null,
+                count: resources.length
+            });
+            return resources;
+        },
+        async read(input) {
+            const result = await runtime.readResourceForRun(run, scope, input);
+            await runtime.state.appendEvent(run.id, "resource.read_completed", {
+                path: input.path,
+                found: result.found,
+                bytes: result.resource?.sizeBytes ?? 0
+            });
+            return result;
+        },
+        async project(input) {
+            const spanStartedAt = timestamp();
+            const sandbox = await sandboxHandle.getWrapped();
+            try {
+                const result = await runtime.projectResourcesForRun(run, scope, sandbox, input);
+                await runtime.emitSpan("ai.assembly-line.resource.project", spanStartedAt, runtime.runSpanAttributes(run, {
+                    sandboxId: result.sandboxId,
+                    resourceCount: result.projected.length,
+                    byteCount: result.projected.reduce((sum, resource) => sum + resource.sizeBytes, 0),
+                    status: "completed"
+                }), {
+                    parentSpanId: runtime.turnSpanId(run.id),
+                    status: "ok"
+                });
+                return result;
+            }
+            catch (error) {
+                await runtime.emitSpan("ai.assembly-line.resource.project", spanStartedAt, runtime.runSpanAttributes(run, {
+                    sandboxId: sandbox.id,
+                    status: "failed",
+                    error: error instanceof Error ? error.message : String(error)
+                }), {
+                    parentSpanId: runtime.turnSpanId(run.id),
+                    status: "error"
+                });
+                throw error;
+            }
+        }
+    };
+}
+//# sourceMappingURL=tool-apis.js.map

package/dist/tool-apis.js.map

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

package/dist/tool-execution.d.ts

@@ -0,0 +1,143 @@
+import type { AgentManifest, CompiledConnection, CompiledTool, JsonObject, ResourceListInput, ResourceMetadata, ResourceProjectInput, ResourceProjectResult, ResourceReadInput, ResourceReadResult, SandboxSession, ScheduleTriggerDefinition, ToolDefinition } from "@assemblyline-agents/core";
+import { type HarnessToolDescriptor, type HarnessToolOutcome } from "@assemblyline-agents/core";
+import { type ConnectionAuthorizationSessionStore, type ConnectionGrantStore, type ConnectionToolMetadata, type RuntimeConnectionRegistry } from "./connections.js";
+import type { RunTimeline } from "./index.js";
+import type { DynamicConnectionGrantInput, EmitSpanOptions, HarnessLoopState, MemoryStore, RunAgentOptions, RuntimeSandboxHandle, SandboxAdapter } from "./runtime-types.js";
+import { type ResolvedCoreToolPolicy } from "./security.js";
+import type { DynamicScheduleRecord, ResolvedConnectionsConfig, ResolvedSchedulesConfig, ResolvedSkillsConfig, SkillStore, StoredConnectionProtocol } from "./self-improvement.js";
+import type { CheckpointRecord, MemoryScope, RunRecord, StateAdapter, ToolCallRecord } from "./state.js";
+/**
+ * Core tool execution path: tool selection, execution and persistence
+ * (including the approval gates and the recoverable built-in-tool error
+ * distinction), the harness tool dispatcher, the model-visible tool surface,
+ * the deferred tool_call bridge, and sandbox wrapping/sync obligations. The
+ * tool execution context and its tool-API factories live in ./tool-apis.js;
+ * the runtime-handled builtin and connection tool executors live in
+ * ./builtin-tool-executors.js. Follows the delivery-send/resource-projection
+ * host-delegate pattern: OpenEveRuntime builds a {@link ToolExecutionHost}
+ * closing over itself and keeps thin delegate methods with unchanged
+ * signatures.
+ */
+/** Narrow slice of the runtime the tool execution path needs. */
+/** Narrow slice of the runtime the tool execution path needs. */
+export interface ToolExecutionHost {
+    state: StateAdapter;
+    env: Record<string, string | undefined>;
+    fetch: typeof fetch;
+    manifest: AgentManifest;
+    coreToolPolicy: ResolvedCoreToolPolicy;
+    skillStore: SkillStore;
+    memoryStore: MemoryStore;
+    sandbox: SandboxAdapter;
+    connections: Record<string, unknown>;
+    connectionGrantStore: ConnectionGrantStore;
+    connectionAuthorizationSessionStore: ConnectionAuthorizationSessionStore;
+    connectionCallbackBaseUrl: string | undefined;
+    toolOutputMaxChars: number;
+    /** Default wall-clock deadline for tool `execute` calls. 0 disables. */
+    toolTimeoutMs: number;
+    sandboxSyncMaxAttempts: number;
+    skillsConfig: ResolvedSkillsConfig;
+    schedulesConfig: ResolvedSchedulesConfig;
+    connectionsConfig: ResolvedConnectionsConfig;
+    ensureSkillsSeeded(): Promise<void>;
+    skillScope(): string;
+    scheduleScopeForRun(run: RunRecord): string;
+    memoryScopeForRun(run: RunRecord): MemoryScope;
+    sandboxSessionKey(run: RunRecord): string;
+    mergedConnections(): CompiledConnection[];
+    loadConnectionDefinition(connection: CompiledConnection): Promise<unknown>;
+    loadTool(tool: CompiledTool, run?: RunRecord): Promise<ToolDefinition>;
+    runSubagent(parentRunId: string, subagentName: string, task: JsonObject): Promise<RunTimeline>;
+    projectSkillIntoSandbox(run: RunRecord, sandbox: SandboxSession, skillName: string): Promise<void>;
+    hydrateLogicalPathForTool(run: RunRecord, sandbox: SandboxSession, path: string, options?: {
+        list?: boolean;
+        limit?: number;
+    }): Promise<void>;
+    recordSandboxTombstone(run: RunRecord, sandbox: SandboxSession, path: string): Promise<void>;
+    createCheckpoint(input: Omit<CheckpointRecord, "id" | "createdAt">): Promise<CheckpointRecord>;
+    listHydratedCheckpoints(runId: string): Promise<CheckpointRecord[]>;
+    emitSpan(name: string, startedAt: string, attributes: JsonObject, options?: EmitSpanOptions): Promise<void>;
+    runSpanAttributes(run: RunRecord, extra?: JsonObject): JsonObject;
+    turnSpanId(runId: string): string;
+    toolContentAttributes(input: unknown, output: unknown): JsonObject;
+    saveSkill(input: {
+        name: string;
+        body: string;
+        origin?: "agent" | "user";
+    }): Promise<{
+        name: string;
+        pending: boolean;
+    }>;
+    listSkills(): Promise<Array<{
+        name: string;
+        description: string;
+        origin: string;
+        pending: boolean;
+    }>>;
+    deleteSkill(name: string): Promise<void>;
+    createDynamicSchedule(input: {
+        scope: string;
+        prompt?: string;
+        message?: string;
+        channel: string;
+        userId?: string;
+        conversationId?: string;
+        projectId?: string;
+        target?: JsonObject;
+        trigger?: ScheduleTriggerDefinition;
+        cron?: string;
+        everyMinutes?: number | null;
+        timezone?: string;
+        firstRunAt?: string;
+        enabled?: boolean;
+        metadata?: JsonObject;
+    }): Promise<DynamicScheduleRecord>;
+    listDynamicSchedules(scope: string): Promise<DynamicScheduleRecord[]>;
+    updateDynamicSchedule(scope: string, id: string, patch: JsonObject): Promise<DynamicScheduleRecord>;
+    deleteDynamicSchedule(scope: string, id: string): Promise<boolean>;
+    saveConnectionDefinition(input: {
+        name: string;
+        protocol: StoredConnectionProtocol;
+        description: string;
+        definition: JsonObject;
+        grant?: DynamicConnectionGrantInput;
+        scope?: string;
+    }): Promise<{
+        name: string;
+    }>;
+    listConnectionDefinitions(scope?: string): Promise<JsonObject[]>;
+    deleteConnectionDefinition(name: string, scope?: string): Promise<void>;
+    listResourcesForRun(run: RunRecord, scope: MemoryScope, input?: ResourceListInput): Promise<ResourceMetadata[]>;
+    readResourceForRun(run: RunRecord, scope: MemoryScope, input: ResourceReadInput): Promise<ResourceReadResult>;
+    projectResourcesForRun(run: RunRecord, scope: MemoryScope, sandbox: SandboxSession, input: ResourceProjectInput): Promise<ResourceProjectResult>;
+}
+export declare function visibleToolSetImpl(host: ToolExecutionHost, defaultToolNames: Set<string>, activeSkills: Set<string>): Set<string>;
+export declare function modelToolsImpl(host: ToolExecutionHost, activeToolNames: Set<string>, connectionRegistry?: RuntimeConnectionRegistry, discoveredConnectionTools?: Map<string, ConnectionToolMetadata>): Promise<HarnessToolDescriptor[]>;
+export declare function harnessExecuteToolImpl(host: ToolExecutionHost, call: {
+    toolCallId: string;
+    name: string;
+    input: unknown;
+}, state: HarnessLoopState): Promise<HarnessToolOutcome>;
+export declare function selectToolImpl(host: ToolExecutionHost, options: RunAgentOptions): CompiledTool | undefined;
+export declare function executeToolImpl(host: ToolExecutionHost, run: RunRecord, tool: CompiledTool, input: unknown, sandboxHandle: RuntimeSandboxHandle, approved: boolean, idempotencyKey?: string): Promise<{
+    run: RunRecord;
+    modelOutput?: unknown;
+    waitingForApproval?: boolean;
+    waitingForInput?: boolean;
+    waitingForConnection?: boolean;
+    toolCallId?: string;
+    toolName?: string;
+    authorizationSessionId?: string;
+}>;
+export declare function executeToolWithRecordImpl(host: ToolExecutionHost, run: RunRecord, tool: CompiledTool, toolCall: ToolCallRecord, input: unknown, sandboxHandle: RuntimeSandboxHandle, approvedToolCall?: boolean): Promise<{
+    run: RunRecord;
+    modelOutput?: unknown;
+    waitingForInput?: boolean;
+    toolCallId?: string;
+    toolName?: string;
+}>;
+/** Clamp a (possibly model-supplied) shell timeout to [1s, OPENEVE_BASH_TIMEOUT_MAX_MS]; 0/negative/NaN fall to the default. */
+export declare function clampShellTimeoutMs(requested: number | undefined, env: Record<string, string | undefined>): number;
+export declare function wrapSandboxImpl(host: ToolExecutionHost, runId: string, session: SandboxSession): SandboxSession;
+//# sourceMappingURL=tool-execution.d.ts.map

package/dist/tool-execution.d.ts.map

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