@assemblyline-agents/runtime 1.0.0 → 3.0.0

package/dist/agent-hook-evaluation.js

@@ -0,0 +1,197 @@
+import { evaluateAgentSetup, validateResolvedAgentCapabilities } from "@assemblyline-agents/core";
+import { defaultHookConnections, defaultHookSkills, defaultHookSubagents, defaultHookTools, hookCapabilityCatalog } from "./agent-hook-context.js";
+import { rootAgentSurface } from "./agent-surface.js";
+import { capabilitySnapshotMaterial, persistCapabilitySnapshot } from "./agent-capability-snapshot.js";
+import { failRun } from "./run-outcome.js";
+import { loadAuthoredHookRegistrations } from "./authored-hooks.js";
+export class AgentHookEvaluationError extends Error {
+    constructor(message, options) {
+        super(message, options);
+        this.name = "AgentHookEvaluationError";
+    }
+}
+/** Owns dirty tracking and atomic replacement of one run's capability snapshot. */
+export class AgentHookRunController {
+    options;
+    snapshotValue;
+    dirtyValue = true;
+    evaluationSequence = 0;
+    evaluating = false;
+    constructor(options) {
+        this.options = options;
+    }
+    get current() {
+        if (!this.snapshotValue)
+            throw new Error("Agent hooks have not been evaluated for this run.");
+        return this.snapshotValue;
+    }
+    get dirty() {
+        return this.dirtyValue || this.options.agentState.revision !== this.snapshotValue?.stateRevision;
+    }
+    markDirty() {
+        this.dirtyValue = true;
+    }
+    async evaluate(reason) {
+        if (this.evaluating)
+            throw new Error("Agent hook evaluation is already active for this run.");
+        if (this.evaluationSequence >= 50) {
+            throw new Error("Agent hook evaluation exceeded the 50-snapshot cycle limit for one run.");
+        }
+        this.evaluating = true;
+        try {
+            const stateSnapshot = await this.options.agentState.refresh();
+            const module = await this.options.sourceLoader.load(this.options.agentSource ?? this.options.manifest.agentSource);
+            const definition = module.default;
+            if (!definition || typeof definition !== "object" || typeof definition.setup !== "function") {
+                throw new Error("agent.ts must default-export defineAgent({ setup() { ... } }).");
+            }
+            const surface = this.options.surface ?? rootAgentSurface(this.options.manifest);
+            const catalog = this.options.catalog ?? hookCapabilityCatalog(this.options.manifest, surface);
+            const defaultTools = defaultHookTools(this.options.manifest, surface).filter((tool) => catalog.tools.has(tool));
+            let declaration = evaluateAgentSetup(definition.setup.bind(definition), {
+                run: this.options.run,
+                state: { values: stateSnapshot.values, revision: stateSnapshot.revision },
+                defaultTools,
+                defaultSkills: (this.options.defaultSkills ?? defaultHookSkills(surface)).filter((skill) => catalog.skills.has(skill)),
+                defaultConnections: defaultHookConnections(surface).filter((connection) => catalog.connections.has(connection)),
+                defaultSubagents: defaultHookSubagents(surface).filter((subagent) => catalog.subagents.has(subagent)),
+                setState: (key, value) => typeof value === "function"
+                    ? this.options.agentState.update(key, value)
+                    : this.options.agentState.set(key, value)
+            });
+            declaration = applyHostRestrictions(declaration, this.options.disabledTools, this.options.disabledConnections);
+            declaration = validateResolvedAgentCapabilities(declaration, catalog);
+            if (reason === "recovery") {
+                const restored = await this.restoreMatchingSnapshot(declaration, stateSnapshot.revision);
+                if (restored)
+                    return restored;
+            }
+            this.evaluationSequence += 1;
+            const snapshot = await persistCapabilitySnapshot({
+                state: this.options.state,
+                blob: this.options.blob,
+                runId: this.options.run.id,
+                declaration,
+                sequence: this.evaluationSequence,
+                stateRevision: stateSnapshot.revision,
+                reason,
+                createCheckpoint: this.options.createCheckpoint
+            });
+            const authoredHooks = await loadAuthoredHookRegistrations(this.options.hooks ?? [], this.options.sourceLoader);
+            this.options.eventHandlers.replace(this.options.run.id, [...authoredHooks, ...declaration.events]);
+            this.snapshotValue = snapshot;
+            this.dirtyValue = this.options.agentState.revision !== stateSnapshot.revision;
+            return snapshot;
+        }
+        catch (error) {
+            const message = error instanceof Error ? error.message : String(error);
+            await this.options.state.appendEvent(this.options.run.id, "agent.hook_evaluation_failed", {
+                reason,
+                stateRevision: this.options.agentState.revision,
+                error: message
+            });
+            this.options.logger.warn("agent.hook_evaluation_failed", {
+                runId: this.options.run.id,
+                error: message
+            });
+            const current = await this.options.state.getRun(this.options.run.id);
+            if (current && current.status !== "failed") {
+                await failRun({ state: this.options.state }, this.options.run.id, {
+                    reason: "agent.hook_evaluation_failed",
+                    error: message,
+                    data: { evaluationReason: reason, stateRevision: this.options.agentState.revision }
+                });
+            }
+            throw new AgentHookEvaluationError(message, { cause: error });
+        }
+        finally {
+            this.evaluating = false;
+        }
+    }
+    async refreshIfDirty() {
+        if (!this.dirty) {
+            // Another run in the same conversation may have advanced the shared
+            // revision, so local dirty notifications are only an optimization.
+            await this.options.agentState.refresh();
+        }
+        return this.dirty ? this.evaluate("state_changed") : this.current;
+    }
+    async restoreMatchingSnapshot(declaration, stateRevision) {
+        const checkpoints = await (this.options.listCheckpoints?.(this.options.run.id)
+            ?? this.options.state.listCheckpoints(this.options.run.id));
+        const checkpoint = [...checkpoints].reverse().find((candidate) => candidate.name === "agent.capability_snapshot");
+        if (!checkpoint)
+            return undefined;
+        const sequence = numberField(checkpoint.data.evaluationSequence ?? checkpoint.data.sequence);
+        if (sequence !== undefined)
+            this.evaluationSequence = Math.max(this.evaluationSequence, sequence);
+        const checkpointRevision = numberField(checkpoint.data.stateRevision);
+        const checkpointHash = stringField(checkpoint.data.hash);
+        const snapshotId = stringField(checkpoint.data.snapshotId);
+        if (checkpointRevision !== stateRevision || !checkpointHash || !snapshotId || sequence === undefined)
+            return undefined;
+        const material = capabilitySnapshotMaterial(declaration);
+        if (material.hash !== checkpointHash)
+            return undefined;
+        const restored = {
+            id: snapshotId,
+            hash: checkpointHash,
+            sequence,
+            stateRevision,
+            reason: "recovery",
+            declaration,
+            serializable: material.serializable,
+            checkpointId: checkpoint.id
+        };
+        const authoredHooks = await loadAuthoredHookRegistrations(this.options.hooks ?? [], this.options.sourceLoader);
+        this.options.eventHandlers.replace(this.options.run.id, [...authoredHooks, ...declaration.events]);
+        this.snapshotValue = restored;
+        this.dirtyValue = this.options.agentState.revision !== stateRevision;
+        return restored;
+    }
+}
+function stringField(value) {
+    return typeof value === "string" ? value : undefined;
+}
+function numberField(value) {
+    return typeof value === "number" && Number.isFinite(value) ? value : undefined;
+}
+function applyHostRestrictions(declaration, disabledTools, disabledConnections) {
+    const restricted = {
+        ...declaration,
+        instructions: [...declaration.instructions],
+        tools: disabledTools ? declaration.tools.filter((tool) => !disabledTools.has(tool)) : [...declaration.tools],
+        skills: [...declaration.skills],
+        connections: disabledConnections
+            ? declaration.connections.filter((connection) => !disabledConnections.has(connection))
+            : [...declaration.connections],
+        subagents: [...declaration.subagents],
+        events: [...declaration.events]
+    };
+    return restricted;
+}
+export function immutableAgentRunContext(input) {
+    const attachments = (input.attachments ?? []).map(attachmentMetadata);
+    return Object.freeze({
+        id: input.id,
+        message: input.message,
+        channel: input.channel,
+        conversationId: input.conversationId,
+        ...(input.userId ? { userId: input.userId } : {}),
+        ...(input.principal ? { principal: Object.freeze(cloneObject(input.principal)) } : {}),
+        ...(input.initiator ? { initiator: Object.freeze(cloneObject(input.initiator)) } : {}),
+        audience: Object.freeze(cloneObject((input.audience ?? { private: true }))),
+        attachments: Object.freeze(attachments),
+        ...(input.metadata ? { metadata: Object.freeze(cloneObject(input.metadata)) } : {})
+    });
+}
+function attachmentMetadata(attachment) {
+    const copy = cloneObject(attachment);
+    for (const key of ["data", "bytes", "contents", "text", "base64"])
+        delete copy[key];
+    return Object.freeze(copy);
+}
+function cloneObject(value) {
+    return JSON.parse(JSON.stringify(value));
+}
+//# sourceMappingURL=agent-hook-evaluation.js.map

package/dist/agent-hook-evaluation.js.map

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

package/dist/agent-hook-run-lifecycle.d.ts

@@ -0,0 +1,44 @@
+import type { AgentCapabilityCatalog, AgentManifest, AgentRunContext, CompiledHook, JsonObject, ResolvedAgentCapabilities, SourceReference } from "@assemblyline-agents/core";
+import type { AgentEventHandlerRegistry } from "./agent-event-handlers.js";
+import { AgentHookRunController } from "./agent-hook-evaluation.js";
+import { RuntimeAgentStateHandle } from "./agent-state.js";
+import type { RuntimeLogger } from "./logging.js";
+import type { RunStreamEvent } from "./run-stream.js";
+import type { AgentSourceModuleLoader } from "./source-loader.js";
+import type { BlobAdapter } from "./runtime-types.js";
+import type { CheckpointRecord, ResolvedStateAdapter, RunRecord } from "./state.js";
+import type { AgentSurface } from "./agent-surface.js";
+export interface RuntimeAgentHookControllerOptions {
+    manifest: AgentManifest;
+    state: ResolvedStateAdapter;
+    blob: BlobAdapter;
+    sourceLoader: AgentSourceModuleLoader;
+    eventHandlers: AgentEventHandlerRegistry;
+    logger: RuntimeLogger;
+    agentScope: string;
+    conversationId: string;
+    run: AgentRunContext;
+    agentSource?: SourceReference;
+    surface?: AgentSurface;
+    catalog?: AgentCapabilityCatalog;
+    defaultSkills?: readonly string[];
+    hooks?: readonly CompiledHook[];
+    disabledTools?: ReadonlySet<string>;
+    disabledConnections?: ReadonlySet<string>;
+    createCheckpoint(input: Omit<CheckpointRecord, "id" | "createdAt">): Promise<CheckpointRecord>;
+    listCheckpoints(runId: string): Promise<CheckpointRecord[]>;
+}
+export declare function createRuntimeAgentHookController(options: RuntimeAgentHookControllerOptions): Promise<{
+    controller: AgentHookRunController;
+    agentState: RuntimeAgentStateHandle;
+}>;
+export interface RecoverAgentHookControllerOptions {
+    run: RunRecord;
+    manifest: AgentManifest;
+    createMain(message: string, metadata: JsonObject | undefined, channel: string, conversationId: string, attachments: JsonObject[]): Promise<AgentHookRunController>;
+    createSubagent(subagent: AgentManifest["subagents"][number], message: string, conversationId: string): Promise<AgentHookRunController>;
+}
+export declare function recoverAgentHookController(options: RecoverAgentHookControllerOptions): Promise<AgentHookRunController>;
+export declare function removeTerminalAgentHookState(runId: string, event: RunStreamEvent, handlers: AgentEventHandlerRegistry, controllers: Map<string, AgentHookRunController>, states: Map<string, RuntimeAgentStateHandle>): void;
+export declare function resolvedInstructionsForRun(manifest: AgentManifest, run: RunRecord, baseInstructions: string, capabilities: ResolvedAgentCapabilities): string;
+//# sourceMappingURL=agent-hook-run-lifecycle.d.ts.map

package/dist/agent-hook-run-lifecycle.d.ts.map

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

package/dist/agent-hook-run-lifecycle.js

@@ -0,0 +1,76 @@
+import { AgentHookRunController } from "./agent-hook-evaluation.js";
+import { RuntimeAgentStateHandle } from "./agent-state.js";
+import { RUN_STREAM_TERMINAL_EVENTS } from "./run-stream.js";
+import { findSubagent, surfaceForRun } from "./agent-surface.js";
+export async function createRuntimeAgentHookController(options) {
+    let controller;
+    const agentState = await RuntimeAgentStateHandle.create({
+        state: options.state,
+        scope: { agentScope: options.agentScope, conversationId: options.conversationId },
+        runId: options.run.id,
+        appendEvent: (runId, type, data) => options.state.appendEvent(runId, type, data),
+        onChanged: () => controller?.markDirty()
+    });
+    controller = new AgentHookRunController({
+        manifest: options.manifest,
+        state: options.state,
+        blob: options.blob,
+        sourceLoader: options.sourceLoader,
+        agentState,
+        run: options.run,
+        eventHandlers: options.eventHandlers,
+        logger: options.logger,
+        createCheckpoint: options.createCheckpoint,
+        listCheckpoints: options.listCheckpoints,
+        ...(options.agentSource ? { agentSource: options.agentSource } : {}),
+        ...(options.surface ? { surface: options.surface } : {}),
+        ...(options.catalog ? { catalog: options.catalog } : {}),
+        ...(options.defaultSkills ? { defaultSkills: options.defaultSkills } : {}),
+        hooks: options.hooks ?? (options.agentSource ? [] : options.manifest.hooks ?? []),
+        ...(options.disabledTools ? { disabledTools: options.disabledTools } : {}),
+        ...(options.disabledConnections ? { disabledConnections: options.disabledConnections } : {})
+    });
+    return { controller, agentState };
+}
+export async function recoverAgentHookController(options) {
+    const { run } = options;
+    const conversationId = typeof run.input.conversationId === "string" ? run.input.conversationId : run.id;
+    const message = typeof run.input.message === "string"
+        ? run.input.message
+        : isRecord(run.input.task) ? JSON.stringify(run.input.task) : "";
+    const subagentName = typeof run.input.subagent === "string" ? run.input.subagent : undefined;
+    const subagentPath = typeof run.input.agentSurface === "string" ? run.input.agentSurface : undefined;
+    let controller;
+    if (subagentName) {
+        const subagent = subagentPath ? findSubagent(options.manifest, subagentPath) : options.manifest.subagents.find((candidate) => candidate.name === subagentName);
+        if (!subagent)
+            throw new Error(`Subagent not found during hook recovery: ${subagentName}.`);
+        controller = await options.createSubagent(subagent, message, conversationId);
+    }
+    else {
+        const metadata = isRecord(run.input.metadata) ? run.input.metadata : undefined;
+        const attachments = Array.isArray(run.input.attachmentMetadata)
+            ? run.input.attachmentMetadata.filter(isRecord)
+            : [];
+        controller = await options.createMain(message, metadata, typeof run.input.channel === "string" ? run.input.channel : "local", conversationId, attachments);
+    }
+    await controller.evaluate("recovery");
+    return controller;
+}
+export function removeTerminalAgentHookState(runId, event, handlers, controllers, states) {
+    if (!RUN_STREAM_TERMINAL_EVENTS.has(event.type))
+        return;
+    handlers.remove(runId);
+    controllers.delete(runId);
+    states.delete(runId);
+}
+export function resolvedInstructionsForRun(manifest, run, baseInstructions, capabilities) {
+    const surface = surfaceForRun(manifest, run);
+    if (surface.path === "root")
+        return baseInstructions;
+    return [surface.instructions.text, ...capabilities.instructions].filter(Boolean).join("\n\n");
+}
+function isRecord(value) {
+    return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+//# sourceMappingURL=agent-hook-run-lifecycle.js.map

package/dist/agent-hook-run-lifecycle.js.map

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

package/dist/agent-state.d.ts

@@ -0,0 +1,31 @@
+import type { AgentStateHandle, JsonObject, JsonValue } from "@assemblyline-agents/core";
+import type { AgentStateScope, AgentStateSnapshot, ResolvedStateAdapter } from "./state.js";
+export interface RuntimeAgentStateOptions {
+    state: ResolvedStateAdapter;
+    scope: AgentStateScope;
+    runId: string;
+    appendEvent(runId: string, type: string, data: JsonObject): Promise<unknown>;
+    onChanged(revision: number): void;
+}
+/** Revision-aware state handle shared by setup evaluation and authored tools. */
+export declare class RuntimeAgentStateHandle implements AgentStateHandle {
+    private readonly options;
+    private current;
+    private constructor();
+    static create(options: RuntimeAgentStateOptions): Promise<RuntimeAgentStateHandle>;
+    get revision(): number;
+    snapshot(): AgentStateSnapshot;
+    refresh(): Promise<AgentStateSnapshot>;
+    get<T extends JsonValue>(key: string): Promise<T | undefined>;
+    set<T extends JsonValue>(key: string, value: T, options?: {
+        expectedRevision?: number;
+    }): Promise<number>;
+    update<T extends JsonValue>(key: string, update: (current: T | undefined) => T, options?: {
+        expectedRevision?: number;
+    }): Promise<number>;
+    delete(key: string, options?: {
+        expectedRevision?: number;
+    }): Promise<number>;
+    private afterMutation;
+}
+//# sourceMappingURL=agent-state.d.ts.map

package/dist/agent-state.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-state.d.ts","sourceRoot":"","sources":["../src/agent-state.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,gBAAgB,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,2BAA2B,CAAC;AACzF,OAAO,KAAK,EACV,eAAe,EACf,kBAAkB,EAClB,oBAAoB,EACrB,MAAM,YAAY,CAAC;AAEpB,MAAM,WAAW,wBAAwB;IACvC,KAAK,EAAE,oBAAoB,CAAC;IAC5B,KAAK,EAAE,eAAe,CAAC;IACvB,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,UAAU,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAC7E,SAAS,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;CACnC;AAKD,iFAAiF;AACjF,qBAAa,uBAAwB,YAAW,gBAAgB;IAI5D,OAAO,CAAC,QAAQ,CAAC,OAAO;IAH1B,OAAO,CAAC,OAAO,CAAqB;IAEpC,OAAO;WAOM,MAAM,CAAC,OAAO,EAAE,wBAAwB,GAAG,OAAO,CAAC,uBAAuB,CAAC;IAMxF,IAAI,QAAQ,IAAI,MAAM,CAErB;IAED,QAAQ,IAAI,kBAAkB;IAQxB,OAAO,IAAI,OAAO,CAAC,kBAAkB,CAAC;IAOtC,GAAG,CAAC,CAAC,SAAS,SAAS,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,GAAG,SAAS,CAAC;IAK7D,GAAG,CAAC,CAAC,SAAS,SAAS,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,EAAE,OAAO,GAAE;QAAE,gBAAgB,CAAC,EAAE,MAAM,CAAA;KAAO,GAAG,OAAO,CAAC,MAAM,CAAC;IAM7G,MAAM,CAAC,CAAC,SAAS,SAAS,EAC9B,GAAG,EAAE,MAAM,EACX,MAAM,EAAE,CAAC,OAAO,EAAE,CAAC,GAAG,SAAS,KAAK,CAAC,EACrC,OAAO,GAAE;QAAE,gBAAgB,CAAC,EAAE,MAAM,CAAA;KAAO,GAC1C,OAAO,CAAC,MAAM,CAAC;IAWZ,MAAM,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,GAAE;QAAE,gBAAgB,CAAC,EAAE,MAAM,CAAA;KAAO,GAAG,OAAO,CAAC,MAAM,CAAC;YAMzE,aAAa;CAa5B"}

package/dist/agent-state.js

@@ -0,0 +1,80 @@
+import { createHash } from "node:crypto";
+const MAX_AGENT_STATE_KEYS = 256;
+const MAX_AGENT_STATE_SNAPSHOT_CHARS = 262_144;
+/** Revision-aware state handle shared by setup evaluation and authored tools. */
+export class RuntimeAgentStateHandle {
+    options;
+    current;
+    constructor(options, snapshot) {
+        this.options = options;
+        this.current = snapshot;
+    }
+    static async create(options) {
+        const snapshot = await options.state.readAgentState(options.scope);
+        assertBoundedSnapshot(snapshot);
+        return new RuntimeAgentStateHandle(options, snapshot);
+    }
+    get revision() {
+        return this.current.revision;
+    }
+    snapshot() {
+        return {
+            ...this.options.scope,
+            revision: this.current.revision,
+            values: cloneJsonObject(this.current.values)
+        };
+    }
+    async refresh() {
+        const snapshot = await this.options.state.readAgentState(this.options.scope);
+        assertBoundedSnapshot(snapshot);
+        this.current = snapshot;
+        return this.snapshot();
+    }
+    async get(key) {
+        const record = await this.options.state.getAgentState(this.options.scope, key);
+        return record?.value;
+    }
+    async set(key, value, options = {}) {
+        const mutation = await this.options.state.setAgentState(this.options.scope, key, value, options);
+        await this.afterMutation(key, mutation.changed, mutation.revision, value);
+        return mutation.revision;
+    }
+    async update(key, update, options = {}) {
+        const mutation = await this.options.state.updateAgentState(this.options.scope, key, (current) => update(current), options);
+        await this.afterMutation(key, mutation.changed, mutation.revision, mutation.record?.value);
+        return mutation.revision;
+    }
+    async delete(key, options = {}) {
+        const mutation = await this.options.state.deleteAgentState(this.options.scope, key, options);
+        await this.afterMutation(key, mutation.changed, mutation.revision);
+        return mutation.revision;
+    }
+    async afterMutation(key, changed, revision, value) {
+        if (!changed)
+            return;
+        this.current = await this.options.state.readAgentState(this.options.scope);
+        this.options.onChanged(revision);
+        await this.options.appendEvent(this.options.runId, "agent.state_changed", {
+            scope: "conversation",
+            key,
+            revision,
+            ...(value === undefined
+                ? { deleted: true }
+                : { valueHash: createHash("sha256").update(JSON.stringify(value)).digest("hex") })
+        });
+    }
+}
+function cloneJsonObject(value) {
+    return JSON.parse(JSON.stringify(value));
+}
+function assertBoundedSnapshot(snapshot) {
+    const keys = Object.keys(snapshot.values);
+    if (keys.length > MAX_AGENT_STATE_KEYS) {
+        throw new Error(`Agent hook state exceeds the ${MAX_AGENT_STATE_KEYS}-key conversation limit.`);
+    }
+    const serialized = JSON.stringify(snapshot.values);
+    if (serialized.length > MAX_AGENT_STATE_SNAPSHOT_CHARS) {
+        throw new Error(`Agent hook state exceeds the ${MAX_AGENT_STATE_SNAPSHOT_CHARS}-character conversation limit.`);
+    }
+}
+//# sourceMappingURL=agent-state.js.map

package/dist/agent-state.js.map

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

package/dist/agent-surface.d.ts

@@ -0,0 +1,32 @@
+import type { AgentManifest, CompiledCapability, CompiledInstructions, CompiledSkill, CompiledSubagent, CompiledTool, SkillBundle, SelfImprovementConfig, SourceReference } from "@assemblyline-agents/core";
+import type { RunRecord } from "./state.js";
+export declare const ROOT_AGENT_SURFACE = "root";
+/** Runtime view of one recursively filesystem-scoped agent. */
+export interface AgentSurface {
+    path: string;
+    name: string;
+    description?: string;
+    agentSource: SourceReference;
+    possibleModels: string[];
+    instructions: CompiledInstructions;
+    tools: CompiledTool[];
+    skills: CompiledSkill[];
+    skillBundles: SkillBundle[];
+    capabilities: CompiledCapability[];
+    subagents: CompiledSubagent[];
+    maxIterations?: number;
+    maxReasoning?: CompiledSubagent["maxReasoning"];
+    selfImprovement?: SelfImprovementConfig;
+    connections: string[];
+}
+export declare function rootAgentSurface(manifest: AgentManifest): AgentSurface;
+export declare function subagentSurface(subagent: CompiledSubagent): AgentSurface;
+export declare function findSubagent(manifest: AgentManifest, path: string): CompiledSubagent | undefined;
+export declare function findChildSubagent(surface: AgentSurface, name: string): CompiledSubagent | undefined;
+export declare function surfaceForPath(manifest: AgentManifest, path: string | undefined): AgentSurface;
+export declare function surfaceForRun(manifest: AgentManifest, run: RunRecord): AgentSurface;
+export declare function flattenSubagents(subagents: readonly CompiledSubagent[]): CompiledSubagent[];
+export declare function allSkillBundles(manifest: AgentManifest): SkillBundle[];
+export declare function allSkills(manifest: AgentManifest): CompiledSkill[];
+export declare function durableAgentSurfaceScope(agentScope: string, surfacePath: string): string;
+//# sourceMappingURL=agent-surface.d.ts.map

package/dist/agent-surface.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-surface.d.ts","sourceRoot":"","sources":["../src/agent-surface.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,aAAa,EACb,kBAAkB,EAClB,oBAAoB,EACpB,aAAa,EACb,gBAAgB,EAChB,YAAY,EACZ,WAAW,EACX,qBAAqB,EACrB,eAAe,EAChB,MAAM,2BAA2B,CAAC;AACnC,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAE5C,eAAO,MAAM,kBAAkB,SAAS,CAAC;AAEzC,+DAA+D;AAC/D,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,eAAe,CAAC;IAC7B,cAAc,EAAE,MAAM,EAAE,CAAC;IACzB,YAAY,EAAE,oBAAoB,CAAC;IACnC,KAAK,EAAE,YAAY,EAAE,CAAC;IACtB,MAAM,EAAE,aAAa,EAAE,CAAC;IACxB,YAAY,EAAE,WAAW,EAAE,CAAC;IAC5B,YAAY,EAAE,kBAAkB,EAAE,CAAC;IACnC,SAAS,EAAE,gBAAgB,EAAE,CAAC;IAC9B,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,YAAY,CAAC,EAAE,gBAAgB,CAAC,cAAc,CAAC,CAAC;IAChD,eAAe,CAAC,EAAE,qBAAqB,CAAC;IACxC,WAAW,EAAE,MAAM,EAAE,CAAC;CACvB;AAED,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,aAAa,GAAG,YAAY,CAkBtE;AAED,wBAAgB,eAAe,CAAC,QAAQ,EAAE,gBAAgB,GAAG,YAAY,CAkBxE;AAED,wBAAgB,YAAY,CAAC,QAAQ,EAAE,aAAa,EAAE,IAAI,EAAE,MAAM,GAAG,gBAAgB,GAAG,SAAS,CAUhG;AAED,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,YAAY,EAAE,IAAI,EAAE,MAAM,GAAG,gBAAgB,GAAG,SAAS,CAEnG;AAED,wBAAgB,cAAc,CAAC,QAAQ,EAAE,aAAa,EAAE,IAAI,EAAE,MAAM,GAAG,SAAS,GAAG,YAAY,CAK9F;AAED,wBAAgB,aAAa,CAAC,QAAQ,EAAE,aAAa,EAAE,GAAG,EAAE,SAAS,GAAG,YAAY,CAGnF;AAED,wBAAgB,gBAAgB,CAAC,SAAS,EAAE,SAAS,gBAAgB,EAAE,GAAG,gBAAgB,EAAE,CAE3F;AAED,wBAAgB,eAAe,CAAC,QAAQ,EAAE,aAAa,GAAG,WAAW,EAAE,CAKtE;AAED,wBAAgB,SAAS,CAAC,QAAQ,EAAE,aAAa,GAAG,aAAa,EAAE,CAKlE;AAED,wBAAgB,wBAAwB,CAAC,UAAU,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,MAAM,CAExF"}

package/dist/agent-surface.js

@@ -0,0 +1,85 @@
+export const ROOT_AGENT_SURFACE = "root";
+export function rootAgentSurface(manifest) {
+    return {
+        path: ROOT_AGENT_SURFACE,
+        name: manifest.agent.name ?? "agent",
+        ...(manifest.agent.description ? { description: manifest.agent.description } : {}),
+        agentSource: manifest.agentSource,
+        possibleModels: manifest.possibleModels,
+        instructions: manifest.instructions,
+        tools: manifest.tools,
+        skills: manifest.skills,
+        skillBundles: manifest.skillBundles ?? [],
+        capabilities: manifest.capabilities,
+        subagents: manifest.subagents,
+        ...(manifest.agent.maxIterations !== undefined ? { maxIterations: manifest.agent.maxIterations } : {}),
+        ...(manifest.agent.maxReasoning !== undefined ? { maxReasoning: manifest.agent.maxReasoning } : {}),
+        ...(manifest.agent.selfImprovement ? { selfImprovement: manifest.agent.selfImprovement } : {}),
+        connections: manifest.connections.map((connection) => connection.name)
+    };
+}
+export function subagentSurface(subagent) {
+    return {
+        path: subagent.path,
+        name: subagent.name,
+        description: subagent.description,
+        agentSource: subagent.agentSource,
+        possibleModels: subagent.possibleModels,
+        instructions: subagent.instructions,
+        tools: subagent.tools,
+        skills: subagent.skills,
+        skillBundles: subagent.skillBundles,
+        capabilities: subagent.capabilities,
+        subagents: subagent.subagents,
+        ...(subagent.maxIterations !== undefined ? { maxIterations: subagent.maxIterations } : {}),
+        ...(subagent.maxReasoning !== undefined ? { maxReasoning: subagent.maxReasoning } : {}),
+        ...(subagent.selfImprovement ? { selfImprovement: subagent.selfImprovement } : {}),
+        connections: subagent.connections
+    };
+}
+export function findSubagent(manifest, path) {
+    const parts = path.split("/").filter(Boolean);
+    let children = manifest.subagents;
+    let found;
+    for (const part of parts) {
+        found = children.find((candidate) => candidate.name === part);
+        if (!found)
+            return undefined;
+        children = found.subagents;
+    }
+    return found;
+}
+export function findChildSubagent(surface, name) {
+    return surface.subagents.find((candidate) => candidate.name === name);
+}
+export function surfaceForPath(manifest, path) {
+    if (!path || path === ROOT_AGENT_SURFACE)
+        return rootAgentSurface(manifest);
+    const subagent = findSubagent(manifest, path);
+    if (!subagent)
+        throw new Error(`Agent surface not found: ${path}`);
+    return subagentSurface(subagent);
+}
+export function surfaceForRun(manifest, run) {
+    const path = typeof run.input.agentSurface === "string" ? run.input.agentSurface : ROOT_AGENT_SURFACE;
+    return surfaceForPath(manifest, path);
+}
+export function flattenSubagents(subagents) {
+    return subagents.flatMap((subagent) => [subagent, ...flattenSubagents(subagent.subagents)]);
+}
+export function allSkillBundles(manifest) {
+    return [
+        ...(manifest.skillBundles ?? []),
+        ...flattenSubagents(manifest.subagents).flatMap((subagent) => subagent.skillBundles)
+    ];
+}
+export function allSkills(manifest) {
+    return [
+        ...manifest.skills,
+        ...flattenSubagents(manifest.subagents).flatMap((subagent) => subagent.skills)
+    ];
+}
+export function durableAgentSurfaceScope(agentScope, surfacePath) {
+    return surfacePath === ROOT_AGENT_SURFACE ? agentScope : `${agentScope}:subagent:${surfacePath}`;
+}
+//# sourceMappingURL=agent-surface.js.map

package/dist/agent-surface.js.map

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