@assemblyline-agents/runtime 7.1.0 → 7.2.1

package/dist/task-list.d.ts

@@ -0,0 +1,14 @@
+import { type CompiledTool, type JsonObject, type ToolDefinition } from "@assemblyline-agents/core";
+export declare const TASK_LIST_KEY = "runtime_tasks";
+export declare const TASK_LIST_TOOL_NAME = "task_list";
+export interface AgentTask extends JsonObject {
+    id: string;
+    description: string;
+    status: "pending" | "active" | "blocked" | "completed" | "cancelled";
+    blockedOn?: string;
+    resultRefs?: string[];
+}
+export declare const taskListCompiledTool: CompiledTool;
+export declare function storedTasks(value: unknown): AgentTask[];
+export declare const taskListToolDefinition: ToolDefinition;
+//# sourceMappingURL=task-list.d.ts.map

package/dist/task-list.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"task-list.d.ts","sourceRoot":"","sources":["../src/task-list.ts"],"names":[],"mappings":"AAAA,OAAO,EAAiB,KAAK,YAAY,EAAE,KAAK,UAAU,EAAE,KAAK,cAAc,EAA6B,MAAM,2BAA2B,CAAC;AAE9I,eAAO,MAAM,aAAa,kBAAkB,CAAC;AAC7C,eAAO,MAAM,mBAAmB,cAAc,CAAC;AAC/C,MAAM,WAAW,SAAU,SAAQ,UAAU;IAC3C,EAAE,EAAE,MAAM,CAAC;IACX,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,SAAS,GAAG,QAAQ,GAAG,SAAS,GAAG,WAAW,GAAG,WAAW,CAAC;IACrE,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;CACvB;AAED,eAAO,MAAM,oBAAoB,EAAE,YAsBlC,CAAC;AAEF,wBAAgB,WAAW,CAAC,KAAK,EAAE,OAAO,GAAG,SAAS,EAAE,CAKvD;AAED,eAAO,MAAM,sBAAsB,EAAE,cAiCpC,CAAC"}

package/dist/task-list.js

@@ -0,0 +1,75 @@
+import { approvalNever, validateAgainstJsonSchema } from "@assemblyline-agents/core";
+export const TASK_LIST_KEY = "runtime_tasks";
+export const TASK_LIST_TOOL_NAME = "task_list";
+export const taskListCompiledTool = {
+    name: TASK_LIST_TOOL_NAME,
+    description: "Own finite commitments across turns. Omit tasks to read; pass tasks to merge by id. Keep unfinished work until completed or cancelled. Block only on a specific missing input, event, or worker run. Complete only after verifying the result and delivery, citing their references. Ordinary conversation needs no task.",
+    inputSchema: {
+        type: "object", additionalProperties: false,
+        properties: {
+            tasks: { type: "array", maxItems: 32, items: {
+                    type: "object", additionalProperties: false,
+                    properties: {
+                        id: { type: "string", minLength: 1, maxLength: 80 },
+                        description: { type: "string", minLength: 1, maxLength: 1200 },
+                        status: { type: "string", enum: ["pending", "active", "blocked", "completed", "cancelled"] },
+                        blockedOn: { type: "string", minLength: 1, maxLength: 500 },
+                        resultRefs: { type: "array", maxItems: 16, uniqueItems: true, items: { type: "string", minLength: 1, maxLength: 200 } }
+                    }, required: ["id", "description", "status"]
+                } },
+            expectedRevision: { type: "integer", minimum: 0 }
+        }
+    },
+    needsApproval: approvalNever(), defaultEnabled: true, visibility: "always", execution: "direct",
+    tags: ["tasks", "state"], aliases: [], hasToModelOutput: false,
+    source: { path: "__builtin__/tasks", sha256: "builtin-tasks" }
+};
+export function storedTasks(value) {
+    if (value === undefined)
+        return [];
+    const validation = validateAgainstJsonSchema({ tasks: value }, taskListCompiledTool.inputSchema);
+    if (!validation.valid)
+        throw new Error(`Invalid task state: ${validation.errors.join("; ")}`);
+    return value;
+}
+export const taskListToolDefinition = {
+    description: taskListCompiledTool.description,
+    inputSchema: taskListCompiledTool.inputSchema,
+    async execute(input, ctx) {
+        if (ctx.agentSurface !== "root")
+            throw new Error("The parent owns the task list; return your result or blocker to it.");
+        const params = input;
+        const validation = validateAgainstJsonSchema(params, taskListCompiledTool.inputSchema);
+        if (!validation.valid)
+            throw new Error(validation.errors.join("; "));
+        if (params.tasks) {
+            const seen = new Set();
+            for (const task of params.tasks) {
+                if (seen.has(task.id))
+                    throw new Error(`Duplicate task id: ${task.id}`);
+                seen.add(task.id);
+                if (task.status === "blocked" && !task.blockedOn?.trim())
+                    throw new Error(`Task ${task.id} needs a specific blocker.`);
+                if (task.status === "completed" && !task.resultRefs?.length)
+                    throw new Error(`Task ${task.id} needs verified result references.`);
+            }
+            await ctx.agentState.update(TASK_LIST_KEY, current => {
+                const tasks = new Map(storedTasks(current).map(task => [task.id, task]));
+                for (const task of params.tasks) {
+                    const { blockedOn, ...rest } = task;
+                    tasks.set(task.id, { ...rest, ...(task.status === "blocked" ? { blockedOn: blockedOn } : {}) });
+                }
+                // Keep active work and a bounded recent completion history.
+                const values = [...tasks.values()];
+                const active = values.filter(task => !["completed", "cancelled"].includes(task.status));
+                if (active.length > 32)
+                    throw new Error("At most 32 unfinished tasks are allowed.");
+                const keep = 32 - active.length;
+                const terminal = values.filter(task => ["completed", "cancelled"].includes(task.status));
+                return [...active, ...(keep ? terminal.slice(-keep) : [])];
+            }, params.expectedRevision === undefined ? {} : { expectedRevision: params.expectedRevision });
+        }
+        return { tasks: storedTasks(await ctx.agentState.get(TASK_LIST_KEY)), revision: ctx.agentState.revision };
+    }
+};
+//# sourceMappingURL=task-list.js.map

package/dist/task-list.js.map

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

package/dist/tool-progress.d.ts

@@ -0,0 +1,4 @@
+import type { RunRecord, StateAdapter } from "./state.js";
+/** Stop an unchanged call/result loop, while allowing polls whose evidence changes. */
+export declare function stopRepeatedToolCalls(state: StateAdapter, run: RunRecord, name: string, input: unknown): Promise<RunRecord | undefined>;
+//# sourceMappingURL=tool-progress.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"tool-progress.d.ts","sourceRoot":"","sources":["../src/tool-progress.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAM1D,uFAAuF;AACvF,wBAAsB,qBAAqB,CAAC,KAAK,EAAE,YAAY,EAAE,GAAG,EAAE,SAAS,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,OAAO,CAAC,SAAS,GAAG,SAAS,CAAC,CAU7I"}

package/dist/tool-progress.js

@@ -0,0 +1,16 @@
+import { failRun } from "./run-outcome.js";
+import { isDeepStrictEqual } from "node:util";
+const MAX_IDENTICAL_TOOL_CALLS = 5;
+/** Stop an unchanged call/result loop, while allowing polls whose evidence changes. */
+export async function stopRepeatedToolCalls(state, run, name, input) {
+    const recent = (await state.listToolCalls(run.id)).slice(-MAX_IDENTICAL_TOOL_CALLS);
+    if (recent.length < MAX_IDENTICAL_TOOL_CALLS || recent.some(call => !["completed", "failed", "timeout"].includes(call.status)
+        || call.toolName !== name || !isDeepStrictEqual(call.input, input)
+        || call.status !== recent[0].status || call.error !== recent[0].error
+        || !isDeepStrictEqual(call.result, recent[0].result)))
+        return;
+    const error = `${name} repeated the same arguments ${MAX_IDENTICAL_TOOL_CALLS} times without advancing the work.`;
+    await state.appendEvent(run.id, "run.stalled", { toolName: name, reason: "repeated_tool_call", error });
+    return failRun({ state }, run.id, { reason: "run.stalled", error });
+}
+//# sourceMappingURL=tool-progress.js.map

package/dist/tool-progress.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-progress.js","sourceRoot":"","sources":["../src/tool-progress.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAC3C,OAAO,EAAE,iBAAiB,EAAE,MAAM,WAAW,CAAC;AAE9C,MAAM,wBAAwB,GAAG,CAAC,CAAC;AAEnC,uFAAuF;AACvF,MAAM,CAAC,KAAK,UAAU,qBAAqB,CAAC,KAAmB,EAAE,GAAc,EAAE,IAAY,EAAE,KAAc;IAC3G,MAAM,MAAM,GAAG,CAAC,MAAM,KAAK,CAAC,aAAa,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,wBAAwB,CAAC,CAAC;IACpF,IAAI,MAAM,CAAC,MAAM,GAAG,wBAAwB,IAAI,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CACjE,CAAC,CAAC,WAAW,EAAE,QAAQ,EAAE,SAAS,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC;WACtD,IAAI,CAAC,QAAQ,KAAK,IAAI,IAAI,CAAC,iBAAiB,CAAC,IAAI,CAAC,KAAK,EAAE,KAAK,CAAC;WAC/D,IAAI,CAAC,MAAM,KAAK,MAAM,CAAC,CAAC,CAAE,CAAC,MAAM,IAAI,IAAI,CAAC,KAAK,KAAK,MAAM,CAAC,CAAC,CAAE,CAAC,KAAK;WACpE,CAAC,iBAAiB,CAAC,IAAI,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAE,CAAC,MAAM,CAAC,CAAC;QAAE,OAAO;IACjE,MAAM,KAAK,GAAG,GAAG,IAAI,gCAAgC,wBAAwB,oCAAoC,CAAC;IAClH,MAAM,KAAK,CAAC,WAAW,CAAC,GAAG,CAAC,EAAE,EAAE,aAAa,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,EAAE,oBAAoB,EAAE,KAAK,EAAE,CAAC,CAAC;IACxG,OAAO,OAAO,CAAC,EAAE,KAAK,EAAE,EAAE,GAAG,CAAC,EAAE,EAAE,EAAE,MAAM,EAAE,aAAa,EAAE,KAAK,EAAE,CAAC,CAAC;AACtE,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@assemblyline-agents/runtime",
-  "version": "7.1.0",
+  "version": "7.2.1",
   "type": "module",
   "exports": {
     ".": {
@@ -18,8 +18,8 @@
     "esbuild": "^0.28.1",
     "heic-decode": "^2.1.0",
     "jpeg-js": "^0.4.4",
-    "@assemblyline-agents/core": "7.1.0",
-    "@assemblyline-agents/pi": "7.1.0"
+    "@assemblyline-agents/pi": "7.2.1",
+    "@assemblyline-agents/core": "7.2.1"
   },
   "description": "Vendor-neutral, filesystem-first framework for durable AI agents.",
   "files": [