@impulselab/hepha 0.2.400 → 0.2.402

package/dist/index.js

@@ -1878,6 +1878,8 @@ var HOST_TOOL_NAMES = {
   SEND_TO_TASK: "send_to_task",
   STOP_TASK: "stop_task",
   PICKUP_TASK: "pickup_task",
+  // A JS script whose agent() calls ARE platform tasks (docs/agents/workflows.md).
+  WORKFLOW: "workflow",
   // docs/integrations/database-access.md; detect is environment-setup only.
   DATABASE_QUERY: "database_query",
   DATABASE_WRITE: "database_write",
@@ -2245,6 +2247,179 @@ function describeAnnotateImage(record, state) {
   );
 }
 
+// ../../packages/core/src/source-scan/end-of-comment.ts
+function endOfComment(source, at) {
+  if (source[at] !== "/") return at;
+  if (source[at + 1] === "/") {
+    const line = source.indexOf("\n", at);
+    return line === -1 ? source.length : line - 1;
+  }
+  if (source[at + 1] === "*") {
+    const block = source.indexOf("*/", at + 2);
+    return block === -1 ? source.length : block + 1;
+  }
+  return at;
+}
+
+// ../../packages/core/src/source-scan/end-of-string-literal.ts
+function endOfStringLiteral(source, open) {
+  const quote = source[open];
+  for (let at = open + 1; at < source.length; at += 1) {
+    if (source[at] === "\\") at += 1;
+    else if (source[at] === quote) return at;
+  }
+  return source.length;
+}
+
+// ../../packages/core/src/source-scan/end-of-skippable.ts
+function endOfSkippable(source, at) {
+  const char = source[at];
+  if (char === "'" || char === '"' || char === "`") {
+    return endOfStringLiteral(source, at);
+  }
+  return endOfComment(source, at);
+}
+
+// ../../packages/core/src/source-scan/end-of-object-literal.ts
+function endOfObjectLiteral(source, open) {
+  let depth = 0;
+  for (let at = open; at < source.length; at += 1) {
+    const skipped = endOfSkippable(source, at);
+    if (skipped !== at) {
+      at = skipped;
+      continue;
+    }
+    if (source[at] === "{") depth += 1;
+    else if (source[at] === "}" && (depth -= 1) === 0) return at + 1;
+  }
+  return -1;
+}
+
+// ../../packages/core/src/source-scan/has-spread-in-code.ts
+function hasSpreadInCode(literal) {
+  for (let at = 0; at < literal.length; at += 1) {
+    const skipped = endOfSkippable(literal, at);
+    if (skipped !== at) {
+      at = skipped;
+      continue;
+    }
+    if (literal.startsWith("...", at)) return true;
+  }
+  return false;
+}
+
+// ../../packages/core/src/source-scan/meta-declaration-open.ts
+function metaDeclarationOpen(script) {
+  const anchor = /export[ \t]+const[ \t]+meta[ \t]*=\s*\{/y;
+  let at = 0;
+  while (at < script.length) {
+    if (/\s/.test(script[at] ?? "")) {
+      at += 1;
+      continue;
+    }
+    const comment = endOfComment(script, at);
+    if (comment !== at) {
+      at = comment + 1;
+      continue;
+    }
+    anchor.lastIndex = at;
+    return anchor.test(script) ? script.indexOf("{", at) : -1;
+  }
+  return -1;
+}
+
+// ../../packages/core/src/source-scan/unescape-string-literal.ts
+function unescapeStringLiteral(body) {
+  const single = {
+    n: "\n",
+    t: "	",
+    r: "\r",
+    b: "\b",
+    f: "\f",
+    v: "\v",
+    "0": "\0"
+  };
+  return body.replace(
+    /\\(u\{([0-9a-fA-F]+)\}|u([0-9a-fA-F]{4})|x([0-9a-fA-F]{2})|.)/gs,
+    (_, escape, braced, unicode, hex) => {
+      const code = braced ?? unicode ?? hex;
+      if (code === void 0) return single[escape] ?? escape;
+      const point = Number.parseInt(code, 16);
+      return point <= 1114111 ? String.fromCodePoint(point) : `\\${escape}`;
+    }
+  );
+}
+
+// ../../packages/core/src/source-scan/quoted-field-at.ts
+function quotedFieldAt(literal, at, field) {
+  const key = /^(['"])?/.exec(literal.slice(at));
+  const quoted = key?.[1] ?? "";
+  const start = at + quoted.length;
+  if (!literal.startsWith(field, start)) return void 0;
+  if (!quoted && /[A-Za-z0-9_$]/.test(literal[at - 1] ?? "")) return void 0;
+  const after = literal.slice(start + field.length);
+  const opener = new RegExp(`^${quoted}\\s*:\\s*['"\`]`).exec(after);
+  if (!opener) return void 0;
+  const quote = start + field.length + opener[0].length - 1;
+  const close = endOfStringLiteral(literal, quote);
+  let tail = close + 1;
+  for (; ; ) {
+    while (/\s/.test(literal[tail] ?? "")) tail += 1;
+    const skipped = endOfSkippable(literal, tail);
+    if (skipped === tail) break;
+    tail = skipped + 1;
+  }
+  if (literal[tail] !== "," && literal[tail] !== "}") return void 0;
+  if (literal[quote] === "`" && /\$\{/.test(literal.slice(quote, close))) {
+    return void 0;
+  }
+  return unescapeStringLiteral(literal.slice(quote + 1, close));
+}
+
+// ../../packages/core/src/source-scan/top-level-string-field.ts
+function topLevelStringField(literal, field) {
+  let depth = 0;
+  let found;
+  for (let at = 0; at < literal.length; at += 1) {
+    if (depth === 1) {
+      const value = quotedFieldAt(literal, at, field);
+      if (value !== void 0) found = value;
+    }
+    const skipped = endOfSkippable(literal, at);
+    if (skipped !== at) {
+      at = skipped;
+      continue;
+    }
+    const char = literal[at];
+    if (char === "{" || char === "[") depth += 1;
+    else if (char === "}" || char === "]") depth -= 1;
+  }
+  return found;
+}
+
+// ../../packages/core/src/source-scan/meta-name-in-script.ts
+function metaNameInScript(script) {
+  const open = metaDeclarationOpen(script);
+  if (open === -1) return void 0;
+  const end = endOfObjectLiteral(script, open);
+  if (end === -1) return void 0;
+  const literal = script.slice(open, end);
+  if (hasSpreadInCode(literal)) return void 0;
+  const name = topLevelStringField(literal, "name");
+  return name?.trim() && topLevelStringField(literal, "description")?.trim() ? name.slice(0, 80) : void 0;
+}
+
+// ../../packages/agents/src/tool-activity/canonical/workflow-script-name.ts
+function workflowScriptName(script) {
+  return metaNameInScript(script);
+}
+
+// ../../packages/agents/src/tool-activity/canonical/describe-workflow.ts
+function describeWorkflow(record) {
+  const name = workflowScriptName(toolInput.str(record.script) ?? "");
+  return labelOnly(name ? `Ran workflow "${name}"` : "Ran a workflow");
+}
+
 // ../../packages/agents/src/tool-activity/capture/describe-attach-image.ts
 function describeAttachImage(record, state) {
   const file = toolActivityBasename(toolInput.str(record.path));
@@ -2569,6 +2744,7 @@ var canonicalToolActivityDescribers = new Map([
     }
   ],
   [HOST_TOOL_NAMES.LIST_TASKS, () => labelOnly("Listed the team tasks")],
+  [HOST_TOOL_NAMES.WORKFLOW, describeWorkflow],
   [HOST_TOOL_NAMES.PICKUP_TASK, () => labelOnly("Picked up a team task")],
   [
     HOST_TOOL_NAMES.UPDATE_TASK,