@ai-ecoverse/slicc-agent 6.18.17 → 6.19.0

package/dist/workflow/script.js

@@ -0,0 +1,250 @@
+const MAX_SOURCE = 512 * 1024;
+const MAX_AGENTS = 1e3;
+const MAX_ITEMS = 4096;
+const MAX_SCHEMA = 64 * 1024;
+const DEFAULT_CONCURRENCY = 8;
+function maxConcurrency(cores = globalThis.navigator?.hardwareConcurrency ?? 8) {
+  return Math.min(16, Math.max(8, cores * 4));
+}
+function skipQuoted(source, at) {
+  const quote = source[at];
+  for (let i = at + 1; i < source.length; i++) {
+    if (source[i] === "\\") i++;
+    else if (source[i] === quote) return i;
+  }
+  return source.length;
+}
+function block(source, start) {
+  let depth = 0;
+  for (let i = start; i < source.length; i++) {
+    const char = source[i];
+    if (char === '"' || char === "'" || char === "`") i = skipQuoted(source, i);
+    else if (char === "{") depth++;
+    else if (char === "}" && --depth === 0) return source.slice(start + 1, i);
+  }
+  return null;
+}
+function field(text, name) {
+  const found = new RegExp(
+    `(?:^|[\\s,{])["']?${name}["']?\\s*:\\s*(["'\`])((?:\\\\.|(?!\\1)[^\\\\])*)\\1`
+  ).exec(text);
+  return found ? found[2] : null;
+}
+function parseMeta(source) {
+  if (source.length > MAX_SOURCE) throw new Error("a workflow is at most 512 KiB");
+  const found = /^\s*export\s+const\s+meta\s*=\s*\{/.exec(source.replace(/^#![^\n]*/, ""));
+  if (!found) throw new Error("a workflow starts with export const meta = { name, description }");
+  const offset = source.length - source.replace(/^#![^\n]*/, "").length;
+  const text = block(source, offset + found[0].length - 1);
+  if (text === null) throw new Error("export const meta has no closing brace");
+  const name = field(text, "name");
+  const description = field(text, "description");
+  if (!name?.trim()) throw new Error("meta.name must be a non-empty string");
+  if (!description?.trim()) throw new Error("meta.description must be a non-empty string");
+  return { name, description };
+}
+function stripExports(source) {
+  return source.replace(/^#![^\n]*/, "").replace(/\bexport\s+(const|let|var|function|async\s+function|class)\b/g, "$1");
+}
+const PRELUDE = `
+class WorkflowError extends Error {
+  constructor(message) {
+    super(message);
+    this.name = 'WorkflowError';
+  }
+}
+const RealDate = globalThis.Date;
+const RealMath = globalThis.Math;
+const banned = (what) => () => {
+  throw new WorkflowError(what + ' is not allowed in a workflow; pass time or randomness in args');
+};
+const Date = function Date(...given) {
+  if (new.target === undefined) banned('Date()')();
+  if (given.length === 0) banned('new Date()')();
+  return new RealDate(...given);
+};
+Date.prototype = RealDate.prototype;
+Date.UTC = RealDate.UTC;
+Date.parse = RealDate.parse;
+Date.now = banned('Date.now()');
+Object.freeze(Date);
+const Math = {};
+for (const key of Object.getOwnPropertyNames(RealMath)) Math[key] = RealMath[key];
+Math.random = banned('Math.random()');
+Object.freeze(Math);
+const crypto = Object.freeze({
+  getRandomValues: banned('crypto.getRandomValues()'),
+  randomUUID: banned('crypto.randomUUID()'),
+});
+const performance = Object.freeze({ now: banned('performance.now()') });
+const setTimeout = banned('setTimeout()');
+const setInterval = banned('setInterval()');
+const OPTIONS = ['label', 'phase', 'schema', 'model', 'effort', 'agentType', 'isolation'];
+const lanes = config.concurrency;
+let started = 0;
+let spent = 0;
+let current = null;
+let active = 0;
+const waiting = [];
+const acquire = async () => {
+  if (active < lanes) {
+    active++;
+    return;
+  }
+  await new Promise((resume) => waiting.push(resume));
+};
+const release = () => {
+  const next = waiting.shift();
+  if (next) next();
+  else active--;
+};
+const textOf = (values) =>
+  values.map((value) => (typeof value === 'string' ? value : JSON.stringify(value))).join(' ');
+const note = (kind, text) => {
+  tell({ kind, text }).then(undefined, () => undefined);
+};
+const gate = () => {
+  if (config.budget !== null && spent >= config.budget)
+    throw new WorkflowError('agent(): the budget of ' + config.budget + ' output tokens is spent');
+};
+const failed = (error) => {
+  note('log', '[error] ' + (error && error.message ? error.message : String(error)));
+  return null;
+};
+const console = Object.freeze({
+  log: (...values) => note('log', textOf(values)),
+  info: (...values) => note('log', textOf(values)),
+  debug: (...values) => note('log', textOf(values)),
+  warn: (...values) => note('log', '[warn] ' + textOf(values)),
+  error: (...values) => note('log', '[error] ' + textOf(values)),
+});
+const budget = Object.freeze({
+  total: config.budget,
+  spent: () => spent,
+  remaining: () => (config.budget === null ? Infinity : Math.max(0, config.budget - spent)),
+});
+function phase(title) {
+  current = String(title);
+  note('phase', current);
+}
+function log(message) {
+  note('log', String(message));
+}
+function workflow() {
+  throw new WorkflowError('workflow(): nested workflows are not supported in SLICC');
+}
+async function agent(prompt, options) {
+  if (typeof prompt !== 'string' || !prompt.trim()) throw new WorkflowError('agent() needs a prompt string');
+  const given = options === undefined || options === null ? {} : options;
+  if (typeof given !== 'object' || Array.isArray(given)) throw new WorkflowError('agent(): options must be an object');
+  for (const key of Object.keys(given))
+    if (!OPTIONS.includes(key)) throw new WorkflowError('agent(): unknown option ' + key);
+  if (given.isolation !== undefined) throw new WorkflowError('agent(): isolation is not supported in SLICC');
+  if (started >= ${MAX_AGENTS}) throw new WorkflowError('agent(): a workflow starts at most ${MAX_AGENTS} agents');
+  gate();
+  started++;
+  await acquire();
+  try {
+    gate();
+    const call = { ...given, prompt };
+    if (call.phase === undefined && current !== null) call.phase = current;
+    try {
+      const answer = await host(call);
+      spent += answer.outputTokens;
+      return answer.value;
+    } catch (error) {
+      spent += error && typeof error.outputTokens === 'number' ? error.outputTokens : 0;
+      throw error;
+    }
+  } finally {
+    release();
+  }
+}
+async function parallel(thunks) {
+  if (!Array.isArray(thunks) || thunks.some((thunk) => typeof thunk !== 'function'))
+    throw new WorkflowError('parallel() expects an array of functions');
+  if (thunks.length > ${MAX_ITEMS}) throw new WorkflowError('parallel(): at most ${MAX_ITEMS} items per call');
+  return Promise.all(
+    thunks.map(async (thunk) => {
+      try {
+        return await thunk();
+      } catch (error) {
+        return failed(error);
+      }
+    })
+  );
+}
+async function pipeline(items, ...stages) {
+  if (!Array.isArray(items)) throw new WorkflowError('pipeline() expects an array as its first argument');
+  if (items.length > ${MAX_ITEMS}) throw new WorkflowError('pipeline(): at most ${MAX_ITEMS} items per call');
+  if (stages.some((stage) => typeof stage !== 'function')) throw new WorkflowError('pipeline(): every stage must be a function');
+  return Promise.all(
+    items.map(async (item, index) => {
+      let value = item;
+      for (const stage of stages) {
+        try {
+          value = await stage(value, item, index);
+        } catch (error) {
+          return failed(error);
+        }
+        if (value === null) return null;
+      }
+      return value;
+    })
+  );
+}
+return Object.freeze({
+  agent, parallel, pipeline, phase, log, workflow, console, budget, args: config.args,
+  Date, Math, crypto, performance, setTimeout, setInterval, WorkflowError,
+});
+`;
+const PUBLIC = [
+  "agent",
+  "parallel",
+  "pipeline",
+  "phase",
+  "log",
+  "workflow",
+  "console",
+  "budget",
+  "args",
+  "Date",
+  "Math",
+  "crypto",
+  "performance",
+  "setTimeout",
+  "setInterval",
+  "WorkflowError"
+];
+function buildCode(source, config) {
+  return [
+    "{",
+    `const __api = (function (config, host, tell) {${PRELUDE}})(Object.freeze(${JSON.stringify(config)}), __agent, __notify);`,
+    "{",
+    "const tools = undefined;",
+    "const __agent = undefined;",
+    "const __notify = undefined;",
+    `const { ${PUBLIC.join(", ")} } = __api;`,
+    "const __main = async () => {",
+    stripExports(source),
+    "};",
+    "const __value = await __main();",
+    "return __value === undefined ? null : __value;",
+    "}",
+    "}"
+  ].join("\n");
+}
+export {
+  DEFAULT_CONCURRENCY,
+  MAX_AGENTS,
+  MAX_ITEMS,
+  MAX_SCHEMA,
+  MAX_SOURCE,
+  PRELUDE,
+  PUBLIC,
+  buildCode,
+  maxConcurrency,
+  parseMeta,
+  stripExports
+};
+//# sourceMappingURL=script.js.map

package/dist/workflow/script.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/workflow/script.ts"],
+  "sourcesContent": ["export const MAX_SOURCE = 512 * 1024;\nexport const MAX_AGENTS = 1000;\nexport const MAX_ITEMS = 4096;\nexport const MAX_SCHEMA = 64 * 1024;\nexport const DEFAULT_CONCURRENCY = 8;\n\nexport interface Meta {\n  name: string;\n  description: string;\n}\n\nexport interface Config {\n  args?: unknown;\n  budget: number | null;\n  concurrency: number;\n}\n\nexport function maxConcurrency(cores = globalThis.navigator?.hardwareConcurrency ?? 8): number {\n  return Math.min(16, Math.max(8, cores * 4));\n}\n\nfunction skipQuoted(source: string, at: number): number {\n  const quote = source[at];\n  for (let i = at + 1; i < source.length; i++) {\n    if (source[i] === '\\\\') i++;\n    else if (source[i] === quote) return i;\n  }\n  return source.length;\n}\n\nfunction block(source: string, start: number): string | null {\n  let depth = 0;\n  for (let i = start; i < source.length; i++) {\n    const char = source[i] as string;\n    if (char === '\"' || char === \"'\" || char === '`') i = skipQuoted(source, i);\n    else if (char === '{') depth++;\n    else if (char === '}' && --depth === 0) return source.slice(start + 1, i);\n  }\n  return null;\n}\n\nfunction field(text: string, name: string): string | null {\n  const found = new RegExp(\n    `(?:^|[\\\\s,{])[\"']?${name}[\"']?\\\\s*:\\\\s*([\"'\\`])((?:\\\\\\\\.|(?!\\\\1)[^\\\\\\\\])*)\\\\1`\n  ).exec(text);\n  return found ? (found[2] as string) : null;\n}\n\nexport function parseMeta(source: string): Meta {\n  if (source.length > MAX_SOURCE) throw new Error('a workflow is at most 512 KiB');\n  const found = /^\\s*export\\s+const\\s+meta\\s*=\\s*\\{/.exec(source.replace(/^#![^\\n]*/, ''));\n  if (!found) throw new Error('a workflow starts with export const meta = { name, description }');\n  const offset = source.length - source.replace(/^#![^\\n]*/, '').length;\n  const text = block(source, offset + found[0].length - 1);\n  if (text === null) throw new Error('export const meta has no closing brace');\n  const name = field(text, 'name');\n  const description = field(text, 'description');\n  if (!name?.trim()) throw new Error('meta.name must be a non-empty string');\n  if (!description?.trim()) throw new Error('meta.description must be a non-empty string');\n  return { name, description };\n}\n\nexport function stripExports(source: string): string {\n  return source\n    .replace(/^#![^\\n]*/, '')\n    .replace(/\\bexport\\s+(const|let|var|function|async\\s+function|class)\\b/g, '$1');\n}\n\nexport const PRELUDE = `\nclass WorkflowError extends Error {\n  constructor(message) {\n    super(message);\n    this.name = 'WorkflowError';\n  }\n}\nconst RealDate = globalThis.Date;\nconst RealMath = globalThis.Math;\nconst banned = (what) => () => {\n  throw new WorkflowError(what + ' is not allowed in a workflow; pass time or randomness in args');\n};\nconst Date = function Date(...given) {\n  if (new.target === undefined) banned('Date()')();\n  if (given.length === 0) banned('new Date()')();\n  return new RealDate(...given);\n};\nDate.prototype = RealDate.prototype;\nDate.UTC = RealDate.UTC;\nDate.parse = RealDate.parse;\nDate.now = banned('Date.now()');\nObject.freeze(Date);\nconst Math = {};\nfor (const key of Object.getOwnPropertyNames(RealMath)) Math[key] = RealMath[key];\nMath.random = banned('Math.random()');\nObject.freeze(Math);\nconst crypto = Object.freeze({\n  getRandomValues: banned('crypto.getRandomValues()'),\n  randomUUID: banned('crypto.randomUUID()'),\n});\nconst performance = Object.freeze({ now: banned('performance.now()') });\nconst setTimeout = banned('setTimeout()');\nconst setInterval = banned('setInterval()');\nconst OPTIONS = ['label', 'phase', 'schema', 'model', 'effort', 'agentType', 'isolation'];\nconst lanes = config.concurrency;\nlet started = 0;\nlet spent = 0;\nlet current = null;\nlet active = 0;\nconst waiting = [];\nconst acquire = async () => {\n  if (active < lanes) {\n    active++;\n    return;\n  }\n  await new Promise((resume) => waiting.push(resume));\n};\nconst release = () => {\n  const next = waiting.shift();\n  if (next) next();\n  else active--;\n};\nconst textOf = (values) =>\n  values.map((value) => (typeof value === 'string' ? value : JSON.stringify(value))).join(' ');\nconst note = (kind, text) => {\n  tell({ kind, text }).then(undefined, () => undefined);\n};\nconst gate = () => {\n  if (config.budget !== null && spent >= config.budget)\n    throw new WorkflowError('agent(): the budget of ' + config.budget + ' output tokens is spent');\n};\nconst failed = (error) => {\n  note('log', '[error] ' + (error && error.message ? error.message : String(error)));\n  return null;\n};\nconst console = Object.freeze({\n  log: (...values) => note('log', textOf(values)),\n  info: (...values) => note('log', textOf(values)),\n  debug: (...values) => note('log', textOf(values)),\n  warn: (...values) => note('log', '[warn] ' + textOf(values)),\n  error: (...values) => note('log', '[error] ' + textOf(values)),\n});\nconst budget = Object.freeze({\n  total: config.budget,\n  spent: () => spent,\n  remaining: () => (config.budget === null ? Infinity : Math.max(0, config.budget - spent)),\n});\nfunction phase(title) {\n  current = String(title);\n  note('phase', current);\n}\nfunction log(message) {\n  note('log', String(message));\n}\nfunction workflow() {\n  throw new WorkflowError('workflow(): nested workflows are not supported in SLICC');\n}\nasync function agent(prompt, options) {\n  if (typeof prompt !== 'string' || !prompt.trim()) throw new WorkflowError('agent() needs a prompt string');\n  const given = options === undefined || options === null ? {} : options;\n  if (typeof given !== 'object' || Array.isArray(given)) throw new WorkflowError('agent(): options must be an object');\n  for (const key of Object.keys(given))\n    if (!OPTIONS.includes(key)) throw new WorkflowError('agent(): unknown option ' + key);\n  if (given.isolation !== undefined) throw new WorkflowError('agent(): isolation is not supported in SLICC');\n  if (started >= ${MAX_AGENTS}) throw new WorkflowError('agent(): a workflow starts at most ${MAX_AGENTS} agents');\n  gate();\n  started++;\n  await acquire();\n  try {\n    gate();\n    const call = { ...given, prompt };\n    if (call.phase === undefined && current !== null) call.phase = current;\n    try {\n      const answer = await host(call);\n      spent += answer.outputTokens;\n      return answer.value;\n    } catch (error) {\n      spent += error && typeof error.outputTokens === 'number' ? error.outputTokens : 0;\n      throw error;\n    }\n  } finally {\n    release();\n  }\n}\nasync function parallel(thunks) {\n  if (!Array.isArray(thunks) || thunks.some((thunk) => typeof thunk !== 'function'))\n    throw new WorkflowError('parallel() expects an array of functions');\n  if (thunks.length > ${MAX_ITEMS}) throw new WorkflowError('parallel(): at most ${MAX_ITEMS} items per call');\n  return Promise.all(\n    thunks.map(async (thunk) => {\n      try {\n        return await thunk();\n      } catch (error) {\n        return failed(error);\n      }\n    })\n  );\n}\nasync function pipeline(items, ...stages) {\n  if (!Array.isArray(items)) throw new WorkflowError('pipeline() expects an array as its first argument');\n  if (items.length > ${MAX_ITEMS}) throw new WorkflowError('pipeline(): at most ${MAX_ITEMS} items per call');\n  if (stages.some((stage) => typeof stage !== 'function')) throw new WorkflowError('pipeline(): every stage must be a function');\n  return Promise.all(\n    items.map(async (item, index) => {\n      let value = item;\n      for (const stage of stages) {\n        try {\n          value = await stage(value, item, index);\n        } catch (error) {\n          return failed(error);\n        }\n        if (value === null) return null;\n      }\n      return value;\n    })\n  );\n}\nreturn Object.freeze({\n  agent, parallel, pipeline, phase, log, workflow, console, budget, args: config.args,\n  Date, Math, crypto, performance, setTimeout, setInterval, WorkflowError,\n});\n`;\n\nexport const PUBLIC = [\n  'agent',\n  'parallel',\n  'pipeline',\n  'phase',\n  'log',\n  'workflow',\n  'console',\n  'budget',\n  'args',\n  'Date',\n  'Math',\n  'crypto',\n  'performance',\n  'setTimeout',\n  'setInterval',\n  'WorkflowError',\n];\n\nexport function buildCode(source: string, config: Config): string {\n  return [\n    '{',\n    `const __api = (function (config, host, tell) {${PRELUDE}})(Object.freeze(${JSON.stringify(config)}), __agent, __notify);`,\n    '{',\n    'const tools = undefined;',\n    'const __agent = undefined;',\n    'const __notify = undefined;',\n    `const { ${PUBLIC.join(', ')} } = __api;`,\n    'const __main = async () => {',\n    stripExports(source),\n    '};',\n    'const __value = await __main();',\n    'return __value === undefined ? null : __value;',\n    '}',\n    '}',\n  ].join('\\n');\n}\n"],
+  "mappings": "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",
+  "names": []
+}

package/dist/workflow/step.js

@@ -0,0 +1,132 @@
+import { BACKGROUND_CONTEXT } from "@earendil-works/chord/context";
+import { UsageDoc } from "@earendil-works/pi-durable";
+import { Check, Errors } from "typebox/schema";
+import { findRole } from "../roles/roles.js";
+import { modelOf } from "../scoops/service.js";
+import { MAX_SCHEMA } from "./script.js";
+const EFFORT = {
+  low: "low",
+  medium: "medium",
+  high: "high",
+  xhigh: "xhigh",
+  max: "xhigh"
+};
+class StepError extends Error {
+  outputTokens;
+  constructor(message, outputTokens2 = 0) {
+    super(message);
+    this.outputTokens = outputTokens2;
+  }
+}
+function schemaOf(value) {
+  if (value === void 0) return void 0;
+  if (typeof value !== "object" || value === null || Array.isArray(value))
+    throw new StepError("agent(): schema must be a JSON Schema object");
+  if (JSON.stringify(value).length > MAX_SCHEMA)
+    throw new StepError("agent(): schema is at most 64 KiB");
+  return value;
+}
+function instruction(schema) {
+  return `
+
+End your work with a final answer that is only JSON, with no other text and no code fence, matching this JSON Schema:
+${JSON.stringify(schema)}`;
+}
+const OPTIONS = /* @__PURE__ */ new Set(["prompt", "label", "phase", "schema", "model", "effort", "agentType"]);
+function checked(call) {
+  if (typeof call !== "object" || call === null || Array.isArray(call))
+    throw new StepError("agent(): options must be an object");
+  const given = call;
+  if (typeof given.prompt !== "string" || !given.prompt.trim())
+    throw new StepError("agent() needs a prompt string");
+  if ("isolation" in given) throw new StepError("agent(): isolation is not supported in SLICC");
+  const unknown = Object.keys(given).find((key) => !OPTIONS.has(key));
+  if (unknown) throw new StepError(`agent(): unknown option ${unknown}`);
+  return given;
+}
+function plan(given, roles) {
+  const call = checked(given);
+  const role = call.agentType === void 0 ? void 0 : findRole(roles.roles, call.agentType);
+  if (call.agentType !== void 0 && !role)
+    throw new StepError(`agent(): there is no agent role ${call.agentType}`);
+  const model = call.model === void 0 ? void 0 : modelOf(String(call.model));
+  if (call.model !== void 0 && !model)
+    throw new StepError(`agent(): model must be provider/model, not ${call.model}`);
+  const thinking = call.effort === void 0 ? void 0 : EFFORT[String(call.effort)];
+  if (call.effort !== void 0 && !thinking)
+    throw new StepError("agent(): effort must be low, medium, high, xhigh or max");
+  const schema = schemaOf(call.schema);
+  const label = typeof call.label === "string" && call.label.trim() ? call.label : void 0;
+  return {
+    name: label ?? role?.name ?? "workflow",
+    prompt: schema ? `${call.prompt}${instruction(schema)}` : call.prompt,
+    ...role ? { role } : {},
+    ...model ? { model } : {},
+    ...thinking ? { thinking } : {},
+    ...schema ? { schema } : {}
+  };
+}
+function parseAnswer(text, schema) {
+  const fenced = /^\s*```(?:json)?\s*\n([\s\S]*?)\n\s*```\s*$/.exec(text);
+  const body = fenced ? fenced[1] : text;
+  let value;
+  try {
+    value = JSON.parse(body.trim());
+  } catch {
+    throw new Error(`agent(): the answer is not JSON: ${body.trim().slice(0, 120)}`);
+  }
+  if (!Check(schema, value)) {
+    const [, errors] = Errors(schema, value);
+    const detail = errors.slice(0, 1).map((error) => `: ${error.instancePath || "/"} ${error.message}`).join("");
+    throw new Error(`agent(): the answer does not match the schema${detail}`);
+  }
+  return value;
+}
+async function outputTokens(harness, conversation, context) {
+  const usage = await harness.snapshot(UsageDoc, conversation, context);
+  return Object.values(usage?.models ?? {}).reduce(
+    (sum, entry) => sum + (entry.output ?? 0),
+    0
+  );
+}
+async function cleanup(host, folder) {
+  const id = `scoop:${folder}`;
+  const record = host.agents.state().scoops[id];
+  await host.scoops.stop(id, false, BACKGROUND_CONTEXT).catch(() => void 0);
+  if (record)
+    await host.env.remove(
+      host.layout.scoopRoot(record.folder),
+      { recursive: true, force: true },
+      BACKGROUND_CONTEXT
+    ).catch(() => void 0);
+}
+async function settle(host, folder, task, planned, wait, context) {
+  const result = await wait(task);
+  const record = host.agents.state().scoops[`scoop:${folder}`];
+  const spent = record ? await outputTokens(host.harness, record.conversation, context) : 0;
+  if (result.failed)
+    throw new StepError(`agent(): the agent ended without an answer: ${result.failed}`, spent);
+  if (!planned.schema) return { value: result.text, outputTokens: spent };
+  try {
+    return { value: parseAnswer(result.text, planned.schema), outputTokens: spent };
+  } catch (error) {
+    throw new StepError(error.message, spent);
+  }
+}
+async function waitReport(wait, task, context) {
+  const settled = await wait(task, context);
+  const outcome = settled.state.outcome;
+  return outcome.status === "completed" && outcome.result ? outcome.result : { text: "", failed: outcome.status, path: null };
+}
+export {
+  EFFORT,
+  StepError,
+  cleanup,
+  instruction,
+  outputTokens,
+  parseAnswer,
+  plan,
+  settle,
+  waitReport
+};
+//# sourceMappingURL=step.js.map

package/dist/workflow/step.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/workflow/step.ts"],
+  "sourcesContent": ["import type { Context, JsonValue } from '@earendil-works/chord';\nimport { BACKGROUND_CONTEXT } from '@earendil-works/chord/context';\nimport type { ConversationId, Harness, TaskId } from '@earendil-works/pi-durable';\nimport { UsageDoc } from '@earendil-works/pi-durable';\nimport type { ExecutionEnv } from '@earendil-works/pi-durable/env';\nimport { Check, Errors } from 'typebox/schema';\nimport type { Agents } from '../agents.ts';\nimport type { Layout } from '../layout.ts';\nimport { findRole, type Role, type Roles } from '../roles/roles.ts';\nimport type { ReportResult } from '../scoops/extension.ts';\nimport { modelOf, type Scoops } from '../scoops/service.ts';\nimport { MAX_SCHEMA } from './script.ts';\n\nexport const EFFORT: Record<string, string> = {\n  low: 'low',\n  medium: 'medium',\n  high: 'high',\n  xhigh: 'xhigh',\n  max: 'xhigh',\n};\n\nexport interface AgentCall {\n  prompt: string;\n  label?: string;\n  phase?: string;\n  schema?: JsonValue;\n  model?: string;\n  effort?: string;\n  agentType?: string;\n}\n\nexport interface StepHost {\n  harness: Harness;\n  agents: Agents;\n  scoops: Scoops;\n  roles: (context: Context) => Promise<Roles>;\n  env: Pick<ExecutionEnv, 'remove'>;\n  layout: Layout;\n}\n\nexport class StepError extends Error {\n  readonly outputTokens: number;\n\n  constructor(message: string, outputTokens = 0) {\n    super(message);\n    this.outputTokens = outputTokens;\n  }\n}\n\nexport interface Planned {\n  name: string;\n  prompt: string;\n  role?: Role;\n  model?: { provider: string; modelId: string };\n  thinking?: string;\n  schema?: object;\n}\n\nfunction schemaOf(value: JsonValue | undefined): object | undefined {\n  if (value === undefined) return undefined;\n  if (typeof value !== 'object' || value === null || Array.isArray(value))\n    throw new StepError('agent(): schema must be a JSON Schema object');\n  if (JSON.stringify(value).length > MAX_SCHEMA)\n    throw new StepError('agent(): schema is at most 64 KiB');\n  return value;\n}\n\nexport function instruction(schema: object): string {\n  return `\\n\\nEnd your work with a final answer that is only JSON, with no other text and no code fence, matching this JSON Schema:\\n${JSON.stringify(schema)}`;\n}\n\nconst OPTIONS = new Set(['prompt', 'label', 'phase', 'schema', 'model', 'effort', 'agentType']);\n\nfunction checked(call: unknown): AgentCall {\n  if (typeof call !== 'object' || call === null || Array.isArray(call))\n    throw new StepError('agent(): options must be an object');\n  const given = call as Record<string, unknown>;\n  if (typeof given.prompt !== 'string' || !given.prompt.trim())\n    throw new StepError('agent() needs a prompt string');\n  if ('isolation' in given) throw new StepError('agent(): isolation is not supported in SLICC');\n  const unknown = Object.keys(given).find((key) => !OPTIONS.has(key));\n  if (unknown) throw new StepError(`agent(): unknown option ${unknown}`);\n  return given as unknown as AgentCall;\n}\n\nexport function plan(given: unknown, roles: Roles): Planned {\n  const call = checked(given);\n  const role = call.agentType === undefined ? undefined : findRole(roles.roles, call.agentType);\n  if (call.agentType !== undefined && !role)\n    throw new StepError(`agent(): there is no agent role ${call.agentType}`);\n  const model = call.model === undefined ? undefined : modelOf(String(call.model));\n  if (call.model !== undefined && !model)\n    throw new StepError(`agent(): model must be provider/model, not ${call.model}`);\n  const thinking = call.effort === undefined ? undefined : EFFORT[String(call.effort)];\n  if (call.effort !== undefined && !thinking)\n    throw new StepError('agent(): effort must be low, medium, high, xhigh or max');\n  const schema = schemaOf(call.schema);\n  const label = typeof call.label === 'string' && call.label.trim() ? call.label : undefined;\n  return {\n    name: label ?? role?.name ?? 'workflow',\n    prompt: schema ? `${call.prompt}${instruction(schema)}` : call.prompt,\n    ...(role ? { role } : {}),\n    ...(model ? { model } : {}),\n    ...(thinking ? { thinking } : {}),\n    ...(schema ? { schema } : {}),\n  };\n}\n\nexport function parseAnswer(text: string, schema: object): JsonValue {\n  const fenced = /^\\s*```(?:json)?\\s*\\n([\\s\\S]*?)\\n\\s*```\\s*$/.exec(text);\n  const body = (fenced ? fenced[1] : text) as string;\n  let value: JsonValue;\n  try {\n    value = JSON.parse(body.trim()) as JsonValue;\n  } catch {\n    throw new Error(`agent(): the answer is not JSON: ${body.trim().slice(0, 120)}`);\n  }\n  if (!Check(schema as never, value)) {\n    const [, errors] = Errors(schema as never, value) as unknown as [\n      boolean,\n      { instancePath: string; message: string }[],\n    ];\n    const detail = errors\n      .slice(0, 1)\n      .map((error) => `: ${error.instancePath || '/'} ${error.message}`)\n      .join('');\n    throw new Error(`agent(): the answer does not match the schema${detail}`);\n  }\n  return value;\n}\n\nexport async function outputTokens(\n  harness: Harness,\n  conversation: number,\n  context: Context\n): Promise<number> {\n  const usage = await harness.snapshot(UsageDoc, conversation as ConversationId, context);\n  return Object.values(usage?.models ?? {}).reduce(\n    (sum, entry) => sum + ((entry as { output?: number }).output ?? 0),\n    0\n  );\n}\n\nexport async function cleanup(host: StepHost, folder: string): Promise<void> {\n  const id = `scoop:${folder}`;\n  const record = host.agents.state().scoops[id];\n  await host.scoops.stop(id, false, BACKGROUND_CONTEXT).catch(() => undefined);\n  if (record)\n    await host.env\n      .remove(\n        host.layout.scoopRoot(record.folder),\n        { recursive: true, force: true },\n        BACKGROUND_CONTEXT\n      )\n      .catch(() => undefined);\n}\n\nexport async function settle(\n  host: StepHost,\n  folder: string,\n  task: number,\n  planned: Planned,\n  wait: (task: number) => Promise<ReportResult>,\n  context: Context\n): Promise<{ value: JsonValue; outputTokens: number }> {\n  const result = await wait(task);\n  const record = host.agents.state().scoops[`scoop:${folder}`];\n  const spent = record ? await outputTokens(host.harness, record.conversation, context) : 0;\n  if (result.failed)\n    throw new StepError(`agent(): the agent ended without an answer: ${result.failed}`, spent);\n  if (!planned.schema) return { value: result.text, outputTokens: spent };\n  try {\n    return { value: parseAnswer(result.text, planned.schema), outputTokens: spent };\n  } catch (error) {\n    throw new StepError((error as Error).message, spent);\n  }\n}\n\nexport async function waitReport(\n  wait: (id: TaskId<ReportResult>, context: Context) => Promise<{ state: unknown }>,\n  task: number,\n  context: Context\n): Promise<ReportResult> {\n  const settled = (await wait(task as TaskId<ReportResult>, context)) as {\n    state: { outcome: { status: string; result?: ReportResult } };\n  };\n  const outcome = settled.state.outcome;\n  return outcome.status === 'completed' && outcome.result\n    ? outcome.result\n    : { text: '', failed: outcome.status, path: null };\n}\n"],
+  "mappings": "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",
+  "names": ["outputTokens"]
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ai-ecoverse/slicc-agent",
-  "version": "6.18.17",
+  "version": "6.19.0",
   "description": "SLICC's agent core on pi durable: an agent worker, session storage, remoting and pi extensions",
   "type": "module",
   "license": "Apache-2.0",
@@ -65,9 +65,9 @@
     "release": "semantic-release"
   },
   "devDependencies": {
-    "@ai-ecoverse/slicc-kernel": "1.143.0",
+    "@ai-ecoverse/slicc-kernel": "1.143.2",
     "@ai-ecoverse/slicc-scrub": "1.0.0",
-    "@ai-ecoverse/slicc-shared-web": "1.29.16",
+    "@ai-ecoverse/slicc-shared-web": "1.30.1",
     "@ai-ecoverse/slicc-spectrum": "1.104.3",
     "@ai-ecoverse/wasi-fnox": "1.39.0-6",
     "@ai-ecoverse/wasm-bash": "5.3.0-22",
@@ -79,13 +79,13 @@
     "fake-indexeddb": "6.2.5",
     "lefthook": "2.2.2",
     "monocart-coverage-reports": "2.13.2",
-    "playwright-core": "1.64.0",
+    "playwright-core": "1.64.1",
     "semantic-release": "25.0.9",
     "slicc-agent-5": "npm:@ai-ecoverse/slicc-agent@5.10.1",
     "typescript": "7.0.2"
   },
   "dependencies": {
-    "@ai-ecoverse/slicc-browsers": "1.15.0",
+    "@ai-ecoverse/slicc-browsers": "1.15.1",
     "@ai-ecoverse/slicc-vault": "1.15.2",
     "@aws-sdk/middleware-websocket": "^3.972.54",
     "@earendil-works/chord": "1.3.0",

package/packages/vfs-root/skills/agent/SKILL.md

@@ -73,6 +73,10 @@ A scoop can post a progress note to its cone; it arrives as a lick:
 agent send parent "Halfway: the parser is done, starting on the tests"
 ```
 
+## Workflows
+
+A Claude Code `.workflow.js` runs as a durable background run that survives a reload: `agent workflow run <file.js> [--args <json>] [--budget <tokens>] [--concurrency <n>] [--wait]`. Its `agent()` calls are scoops. `agent workflow list`, `status <run>`, `wait <run>`, `stop <run>` and `save <run> <name>` manage runs, and `agent workflow help` lists the script's globals. A cone can also use the `workflow` tool.
+
 ## Limits
 
 A cone can have 16 live scoops and start 64 per turn (`subagents.maxLiveScoops` and `subagents.maxPerTurn` in `~/.pi/agent/settings.json`).