@alquimia-ai/tools 2.1.0 → 2.2.0

package/dist/worklog/index.js

@@ -0,0 +1,218 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/worklog/index.ts
+var worklog_exports = {};
+__export(worklog_exports, {
+  EVENT_REGISTRY: () => EVENT_REGISTRY,
+  foldWorklog: () => foldWorklog,
+  frameToRecord: () => frameToRecord,
+  initialWorklogState: () => initialWorklogState,
+  reduceWorklog: () => reduceWorklog,
+  resolveInterpreter: () => resolveInterpreter,
+  useWorklog: () => useWorklog
+});
+module.exports = __toCommonJS(worklog_exports);
+
+// src/worklog/types.ts
+function initialWorklogState(taskId = null) {
+  return { taskId, status: "idle", answer: null, nodes: [], index: {}, raw: [] };
+}
+
+// src/worklog/registry.ts
+var asRecord = (data) => data && typeof data === "object" ? data : {};
+var toolTitle = (r) => {
+  const name = asRecord(r.data).name;
+  return typeof name === "string" && name.length > 0 ? `Tool: ${name}` : "Tool";
+};
+var agentTitle = (r) => {
+  const name = asRecord(r.data).name;
+  return typeof name === "string" && name.length > 0 ? `Agent: ${name}` : "Agent-to-agent";
+};
+var constTitle = (label) => () => label;
+var EVENT_REGISTRY = {
+  // Run envelope
+  AssistantInference: { kind: "answer", role: "run-open", title: constTitle("Inference started") },
+  AssistantInferenceResponse: { kind: "answer", role: "run-close", title: constTitle("Answer") },
+  // Safeguard
+  ShieldInference: { kind: "safeguard", role: "open", title: constTitle("Safeguard") },
+  ShieldInferenceResponse: { kind: "safeguard", role: "close", title: constTitle("Safeguard") },
+  // Reasoning
+  ResponseInference: { kind: "reasoning", role: "open", title: constTitle("Reasoning") },
+  ResponseInferenceResponse: { kind: "reasoning", role: "close", title: constTitle("Reasoning") },
+  // Tools (server + subclasses) and their responses
+  ServerToolExecution: { kind: "tool", role: "open", title: toolTitle },
+  BuiltinToolExecution: { kind: "tool", role: "open", title: toolTitle },
+  UnknownToolExecution: { kind: "tool", role: "open", title: toolTitle },
+  ClientToolExecution: { kind: "tool", role: "open", title: toolTitle, pending: true },
+  ToolExecutionResponse: { kind: "tool", role: "close", title: toolTitle },
+  BuiltinToolExecutionResponse: { kind: "tool", role: "close", title: toolTitle },
+  // Tool schema discovery
+  ToolSchema: { kind: "tool", role: "open", title: constTitle("Tool schema") },
+  ToolSchemaResponse: { kind: "tool", role: "close", title: constTitle("Tool schema") },
+  // Agent-to-agent
+  A2AInference: { kind: "a2a", role: "open", title: agentTitle },
+  AgentDiscovery: { kind: "a2a", role: "open", title: constTitle("Agent discovery") },
+  AgentDiscoveryResponse: { kind: "a2a", role: "close", title: constTitle("Agent discovery") },
+  // Memory / persistence
+  ContextPersistence: { kind: "memory", role: "open", title: constTitle("Memory persistence") },
+  ContextFlush: { kind: "memory", role: "open", title: constTitle("Memory flush") },
+  ContextFlushResponse: { kind: "memory", role: "close", title: constTitle("Memory flush") },
+  // Human approval
+  HumanApprovalRequired: {
+    kind: "tool",
+    role: "open",
+    title: constTitle("Human approval required"),
+    pending: true
+  },
+  HumanApprovalRequiredResponse: { kind: "tool", role: "close", title: constTitle("Human approval") }
+};
+function resolveInterpreter(eventClass) {
+  if (Object.prototype.hasOwnProperty.call(EVENT_REGISTRY, eventClass)) {
+    return EVENT_REGISTRY[eventClass];
+  }
+  return {
+    kind: "unknown",
+    role: "open",
+    title: (r) => r.event_class
+  };
+}
+
+// src/worklog/reducer.ts
+var asString = (v) => typeof v === "string" ? v : v == null ? "" : JSON.stringify(v);
+var nodeDepth = (record) => {
+  const d = record.data && typeof record.data === "object" ? record.data.depth : void 0;
+  return typeof d === "number" ? d : 0;
+};
+var makeOpenNode = (record, interp, id) => ({
+  id,
+  kind: interp.kind,
+  eventClass: record.event_class,
+  status: interp.pending ? "pending" : "running",
+  title: interp.title(record),
+  startedAt: record.date_submitted,
+  depth: nodeDepth(record),
+  children: [],
+  command: record.data,
+  raw: [record]
+});
+var makeClosedNode = (record, interp, id) => ({
+  id,
+  kind: interp.kind,
+  eventClass: record.event_class,
+  status: record.status === "error" ? "failed" : "completed",
+  title: interp.title(record),
+  startedAt: record.date_submitted,
+  endedAt: record.date_submitted,
+  depth: nodeDepth(record),
+  children: [],
+  response: record.data,
+  error: record.status === "error" ? asString(record.data) : void 0,
+  raw: [record]
+});
+function reduceWorklog(state, record) {
+  const interp = resolveInterpreter(record.event_class);
+  const next = {
+    ...state,
+    nodes: state.nodes.slice(),
+    index: { ...state.index },
+    raw: [...state.raw, record]
+  };
+  if (interp.role === "ignore") return next;
+  if (interp.role === "run-open") {
+    next.status = "running";
+    return next;
+  }
+  if (interp.role === "run-close") {
+    next.answer = asString(record.data) || null;
+    next.status = record.status === "error" ? "error" : "success";
+    return next;
+  }
+  const key = record.control_id ?? `${record.event_class}-${next.raw.length}`;
+  if (interp.role === "close") {
+    const pos2 = Object.prototype.hasOwnProperty.call(next.index, key) ? next.index[key] : void 0;
+    if (pos2 != null) {
+      const existing = next.nodes[pos2];
+      next.nodes[pos2] = {
+        ...existing,
+        status: record.status === "error" ? "failed" : "completed",
+        endedAt: record.date_submitted,
+        response: record.data,
+        error: record.status === "error" ? asString(record.data) : existing.error,
+        raw: [...existing.raw, record]
+      };
+    } else {
+      next.index[key] = next.nodes.length;
+      next.nodes.push(makeClosedNode(record, interp, key));
+    }
+    if (record.status === "error") next.status = "error";
+    return next;
+  }
+  const pos = Object.prototype.hasOwnProperty.call(next.index, key) ? next.index[key] : void 0;
+  if (pos != null) {
+    const existing = next.nodes[pos];
+    next.nodes[pos] = { ...existing, raw: [...existing.raw, record] };
+  } else {
+    next.index[key] = next.nodes.length;
+    next.nodes.push(makeOpenNode(record, interp, key));
+  }
+  return next;
+}
+function foldWorklog(records, taskId = null) {
+  return records.reduce(reduceWorklog, initialWorklogState(taskId));
+}
+
+// src/worklog/use-worklog.ts
+var import_react = require("react");
+function hookReducer(state, action) {
+  switch (action.type) {
+    case "ingest":
+      return reduceWorklog(state, action.record);
+    case "ingestMany":
+      return action.records.reduce(reduceWorklog, state);
+    case "reset":
+      return initialWorklogState(action.taskId);
+  }
+}
+function useWorklog(taskId = null) {
+  const [worklog, dispatch] = (0, import_react.useReducer)(hookReducer, taskId, initialWorklogState);
+  const ingest = (0, import_react.useCallback)((record) => dispatch({ type: "ingest", record }), []);
+  const ingestMany = (0, import_react.useCallback)(
+    (records) => dispatch({ type: "ingestMany", records }),
+    []
+  );
+  const reset = (0, import_react.useCallback)(
+    (id = null) => dispatch({ type: "reset", taskId: id }),
+    []
+  );
+  return { worklog, ingest, ingestMany, reset };
+}
+
+// src/worklog/from-frame.ts
+function frameToRecord(frame) {
+  const status = frame.status === "success" || frame.status === "error" ? frame.status : null;
+  return {
+    event_class: typeof frame.event_class === "string" && frame.event_class.length > 0 ? frame.event_class : "Unknown",
+    control_id: frame.control_id ?? null,
+    data: frame.data,
+    status,
+    date_submitted: typeof frame.date_submitted === "string" ? frame.date_submitted : ""
+  };
+}
+//# sourceMappingURL=index.js.map

package/dist/worklog/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/worklog/index.ts","../../src/worklog/types.ts","../../src/worklog/registry.ts","../../src/worklog/reducer.ts","../../src/worklog/use-worklog.ts","../../src/worklog/from-frame.ts"],"sourcesContent":["export * from \"./types\";\nexport { EVENT_REGISTRY, resolveInterpreter } from \"./registry\";\nexport { reduceWorklog, foldWorklog } from \"./reducer\";\nexport { useWorklog } from \"./use-worklog\";\nexport { frameToRecord, type RawFrame } from \"./from-frame\";\n","/** One granular Runtime worklog record (a `bus_mode` SSE frame or a `/worklog/{task_id}/events` item). */\nexport interface WorklogRecord {\n  event_class: string;\n  control_id: string | null;\n  data: unknown;\n  status: \"success\" | \"error\" | null;\n  date_submitted: string;\n}\n\n/** Semantic bucket a node belongs to. */\nexport type NodeKind =\n  | \"safeguard\"\n  | \"reasoning\"\n  | \"tool\"\n  | \"a2a\"\n  | \"memory\"\n  | \"answer\"\n  | \"unknown\";\n\n/** Lifecycle state of a single node. */\nexport type NodeStatus = \"pending\" | \"running\" | \"completed\" | \"failed\" | \"skipped\";\n\n/** Overall run status. */\nexport type RunStatus = \"idle\" | \"running\" | \"success\" | \"error\";\n\n/** A single step in the execution chain (command + its response merged by control_id). */\nexport interface WorklogNode {\n  id: string;\n  kind: NodeKind;\n  eventClass: string;\n  status: NodeStatus;\n  title: string;\n  startedAt?: string;\n  endedAt?: string;\n  depth: number;\n  parentId?: string;\n  children: WorklogNode[];\n  command?: unknown;\n  response?: unknown;\n  error?: string;\n  raw: WorklogRecord[];\n}\n\n/** Normalized execution model produced by the reducer. */\nexport interface WorklogState {\n  taskId: string | null;\n  status: RunStatus;\n  answer: string | null;\n  nodes: WorklogNode[];\n  index: Record<string, number>;\n  raw: WorklogRecord[];\n}\n\n/** How a record acts on the model. */\nexport type EventRole = \"open\" | \"close\" | \"run-open\" | \"run-close\" | \"ignore\";\n\n/** Registry descriptor for one event_class. */\nexport interface EventInterpreter {\n  kind: NodeKind;\n  role: EventRole;\n  title: (record: WorklogRecord) => string;\n  /** If true, an opened node starts in \"pending\" (awaiting external input) rather than \"running\". */\n  pending?: boolean;\n}\n\nexport function initialWorklogState(taskId: string | null = null): WorklogState {\n  return { taskId, status: \"idle\", answer: null, nodes: [], index: {}, raw: [] };\n}\n","import type { EventInterpreter, WorklogRecord } from \"./types\";\n\nconst asRecord = (data: unknown): Record<string, unknown> =>\n  data && typeof data === \"object\" ? (data as Record<string, unknown>) : {};\n\nconst toolTitle = (r: WorklogRecord): string => {\n  const name = asRecord(r.data).name;\n  return typeof name === \"string\" && name.length > 0 ? `Tool: ${name}` : \"Tool\";\n};\n\nconst agentTitle = (r: WorklogRecord): string => {\n  const name = asRecord(r.data).name;\n  return typeof name === \"string\" && name.length > 0 ? `Agent: ${name}` : \"Agent-to-agent\";\n};\n\nconst constTitle = (label: string) => () => label;\n\nexport const EVENT_REGISTRY: Record<string, EventInterpreter> = {\n  // Run envelope\n  AssistantInference: { kind: \"answer\", role: \"run-open\", title: constTitle(\"Inference started\") },\n  AssistantInferenceResponse: { kind: \"answer\", role: \"run-close\", title: constTitle(\"Answer\") },\n\n  // Safeguard\n  ShieldInference: { kind: \"safeguard\", role: \"open\", title: constTitle(\"Safeguard\") },\n  ShieldInferenceResponse: { kind: \"safeguard\", role: \"close\", title: constTitle(\"Safeguard\") },\n\n  // Reasoning\n  ResponseInference: { kind: \"reasoning\", role: \"open\", title: constTitle(\"Reasoning\") },\n  ResponseInferenceResponse: { kind: \"reasoning\", role: \"close\", title: constTitle(\"Reasoning\") },\n\n  // Tools (server + subclasses) and their responses\n  ServerToolExecution: { kind: \"tool\", role: \"open\", title: toolTitle },\n  BuiltinToolExecution: { kind: \"tool\", role: \"open\", title: toolTitle },\n  UnknownToolExecution: { kind: \"tool\", role: \"open\", title: toolTitle },\n  ClientToolExecution: { kind: \"tool\", role: \"open\", title: toolTitle, pending: true },\n  ToolExecutionResponse: { kind: \"tool\", role: \"close\", title: toolTitle },\n  BuiltinToolExecutionResponse: { kind: \"tool\", role: \"close\", title: toolTitle },\n\n  // Tool schema discovery\n  ToolSchema: { kind: \"tool\", role: \"open\", title: constTitle(\"Tool schema\") },\n  ToolSchemaResponse: { kind: \"tool\", role: \"close\", title: constTitle(\"Tool schema\") },\n\n  // Agent-to-agent\n  A2AInference: { kind: \"a2a\", role: \"open\", title: agentTitle },\n  AgentDiscovery: { kind: \"a2a\", role: \"open\", title: constTitle(\"Agent discovery\") },\n  AgentDiscoveryResponse: { kind: \"a2a\", role: \"close\", title: constTitle(\"Agent discovery\") },\n\n  // Memory / persistence\n  ContextPersistence: { kind: \"memory\", role: \"open\", title: constTitle(\"Memory persistence\") },\n  ContextFlush: { kind: \"memory\", role: \"open\", title: constTitle(\"Memory flush\") },\n  ContextFlushResponse: { kind: \"memory\", role: \"close\", title: constTitle(\"Memory flush\") },\n\n  // Human approval\n  HumanApprovalRequired: {\n    kind: \"tool\",\n    role: \"open\",\n    title: constTitle(\"Human approval required\"),\n    pending: true,\n  },\n  HumanApprovalRequiredResponse: { kind: \"tool\", role: \"close\", title: constTitle(\"Human approval\") },\n};\n\nexport function resolveInterpreter(eventClass: string): EventInterpreter {\n  if (Object.prototype.hasOwnProperty.call(EVENT_REGISTRY, eventClass)) {\n    return EVENT_REGISTRY[eventClass];\n  }\n  return {\n    kind: \"unknown\",\n    role: \"open\",\n    title: (r: WorklogRecord) => r.event_class,\n  };\n}\n","import { resolveInterpreter } from \"./registry\";\nimport type { EventInterpreter, WorklogNode, WorklogRecord, WorklogState } from \"./types\";\nimport { initialWorklogState } from \"./types\";\n\nconst asString = (v: unknown): string =>\n  typeof v === \"string\" ? v : v == null ? \"\" : JSON.stringify(v);\n\nconst nodeDepth = (record: WorklogRecord): number => {\n  const d = record.data && typeof record.data === \"object\"\n    ? (record.data as Record<string, unknown>).depth\n    : undefined;\n  return typeof d === \"number\" ? d : 0;\n};\n\nconst makeOpenNode = (record: WorklogRecord, interp: EventInterpreter, id: string): WorklogNode => ({\n  id,\n  kind: interp.kind,\n  eventClass: record.event_class,\n  status: interp.pending ? \"pending\" : \"running\",\n  title: interp.title(record),\n  startedAt: record.date_submitted,\n  depth: nodeDepth(record),\n  children: [],\n  command: record.data,\n  raw: [record],\n});\n\nconst makeClosedNode = (record: WorklogRecord, interp: EventInterpreter, id: string): WorklogNode => ({\n  id,\n  kind: interp.kind,\n  eventClass: record.event_class,\n  status: record.status === \"error\" ? \"failed\" : \"completed\",\n  title: interp.title(record),\n  startedAt: record.date_submitted,\n  endedAt: record.date_submitted,\n  depth: nodeDepth(record),\n  children: [],\n  response: record.data,\n  error: record.status === \"error\" ? asString(record.data) : undefined,\n  raw: [record],\n});\n\nexport function reduceWorklog(state: WorklogState, record: WorklogRecord): WorklogState {\n  const interp = resolveInterpreter(record.event_class);\n  const next: WorklogState = {\n    ...state,\n    nodes: state.nodes.slice(),\n    index: { ...state.index },\n    raw: [...state.raw, record],\n  };\n\n  if (interp.role === \"ignore\") return next;\n\n  if (interp.role === \"run-open\") {\n    next.status = \"running\";\n    return next;\n  }\n\n  if (interp.role === \"run-close\") {\n    next.answer = asString(record.data) || null;\n    next.status = record.status === \"error\" ? \"error\" : \"success\";\n    return next;\n  }\n\n  const key = record.control_id ?? `${record.event_class}-${next.raw.length}`;\n\n  if (interp.role === \"close\") {\n    const pos = Object.prototype.hasOwnProperty.call(next.index, key) ? next.index[key] : undefined;\n    if (pos != null) {\n      const existing = next.nodes[pos];\n      next.nodes[pos] = {\n        ...existing,\n        status: record.status === \"error\" ? \"failed\" : \"completed\",\n        endedAt: record.date_submitted,\n        response: record.data,\n        error: record.status === \"error\" ? asString(record.data) : existing.error,\n        raw: [...existing.raw, record],\n      };\n    } else {\n      // response arrived without a seen command — create it already closed\n      next.index[key] = next.nodes.length;\n      next.nodes.push(makeClosedNode(record, interp, key));\n    }\n    if (record.status === \"error\") next.status = \"error\";\n    return next;\n  }\n\n  // role === \"open\"\n  const pos = Object.prototype.hasOwnProperty.call(next.index, key) ? next.index[key] : undefined;\n  if (pos != null) {\n    const existing = next.nodes[pos];\n    next.nodes[pos] = { ...existing, raw: [...existing.raw, record] };\n  } else {\n    next.index[key] = next.nodes.length;\n    next.nodes.push(makeOpenNode(record, interp, key));\n  }\n  return next;\n}\n\nexport function foldWorklog(records: WorklogRecord[], taskId: string | null = null): WorklogState {\n  return records.reduce(reduceWorklog, initialWorklogState(taskId));\n}\n","import { useCallback, useReducer } from \"react\";\nimport { reduceWorklog } from \"./reducer\";\nimport { initialWorklogState, type WorklogRecord, type WorklogState } from \"./types\";\n\ntype Action =\n  | { type: \"ingest\"; record: WorklogRecord }\n  | { type: \"ingestMany\"; records: WorklogRecord[] }\n  | { type: \"reset\"; taskId: string | null };\n\nfunction hookReducer(state: WorklogState, action: Action): WorklogState {\n  switch (action.type) {\n    case \"ingest\":\n      return reduceWorklog(state, action.record);\n    case \"ingestMany\":\n      return action.records.reduce(reduceWorklog, state);\n    case \"reset\":\n      return initialWorklogState(action.taskId);\n  }\n}\n\n/** Live worklog accumulator. Feed it `bus_mode` records via `ingest`; use `foldWorklog` for history. */\nexport function useWorklog(taskId: string | null = null) {\n  const [worklog, dispatch] = useReducer(hookReducer, taskId, initialWorklogState);\n\n  const ingest = useCallback((record: WorklogRecord) => dispatch({ type: \"ingest\", record }), []);\n  const ingestMany = useCallback(\n    (records: WorklogRecord[]) => dispatch({ type: \"ingestMany\", records }),\n    [],\n  );\n  const reset = useCallback(\n    (id: string | null = null) => dispatch({ type: \"reset\", taskId: id }),\n    [],\n  );\n\n  return { worklog, ingest, ingestMany, reset };\n}\n","import type { WorklogRecord } from \"./types\";\n\n/** Loosely-typed shape of a parsed SSE `data:` frame from the granular Runtime stream. */\nexport interface RawFrame {\n  event_class?: string;\n  control_id?: string | null;\n  data?: unknown;\n  status?: string | null;\n  date_submitted?: string;\n}\n\n/** Normalize a parsed SSE frame into a WorklogRecord (defaults missing fields; never throws). */\nexport function frameToRecord(frame: RawFrame): WorklogRecord {\n  const status = frame.status === \"success\" || frame.status === \"error\" ? frame.status : null;\n  return {\n    event_class: typeof frame.event_class === \"string\" && frame.event_class.length > 0\n      ? frame.event_class\n      : \"Unknown\",\n    control_id: frame.control_id ?? null,\n    data: frame.data,\n    status,\n    date_submitted: typeof frame.date_submitted === \"string\" ? frame.date_submitted : \"\",\n  };\n}\n"],"mappings":"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","names":["pos"]}

package/dist/worklog/index.mjs

@@ -0,0 +1,195 @@
+// src/worklog/types.ts
+function initialWorklogState(taskId = null) {
+  return { taskId, status: "idle", answer: null, nodes: [], index: {}, raw: [] };
+}
+
+// src/worklog/registry.ts
+var asRecord = (data) => data && typeof data === "object" ? data : {};
+var toolTitle = (r) => {
+  const name = asRecord(r.data).name;
+  return typeof name === "string" && name.length > 0 ? `Tool: ${name}` : "Tool";
+};
+var agentTitle = (r) => {
+  const name = asRecord(r.data).name;
+  return typeof name === "string" && name.length > 0 ? `Agent: ${name}` : "Agent-to-agent";
+};
+var constTitle = (label) => () => label;
+var EVENT_REGISTRY = {
+  // Run envelope
+  AssistantInference: { kind: "answer", role: "run-open", title: constTitle("Inference started") },
+  AssistantInferenceResponse: { kind: "answer", role: "run-close", title: constTitle("Answer") },
+  // Safeguard
+  ShieldInference: { kind: "safeguard", role: "open", title: constTitle("Safeguard") },
+  ShieldInferenceResponse: { kind: "safeguard", role: "close", title: constTitle("Safeguard") },
+  // Reasoning
+  ResponseInference: { kind: "reasoning", role: "open", title: constTitle("Reasoning") },
+  ResponseInferenceResponse: { kind: "reasoning", role: "close", title: constTitle("Reasoning") },
+  // Tools (server + subclasses) and their responses
+  ServerToolExecution: { kind: "tool", role: "open", title: toolTitle },
+  BuiltinToolExecution: { kind: "tool", role: "open", title: toolTitle },
+  UnknownToolExecution: { kind: "tool", role: "open", title: toolTitle },
+  ClientToolExecution: { kind: "tool", role: "open", title: toolTitle, pending: true },
+  ToolExecutionResponse: { kind: "tool", role: "close", title: toolTitle },
+  BuiltinToolExecutionResponse: { kind: "tool", role: "close", title: toolTitle },
+  // Tool schema discovery
+  ToolSchema: { kind: "tool", role: "open", title: constTitle("Tool schema") },
+  ToolSchemaResponse: { kind: "tool", role: "close", title: constTitle("Tool schema") },
+  // Agent-to-agent
+  A2AInference: { kind: "a2a", role: "open", title: agentTitle },
+  AgentDiscovery: { kind: "a2a", role: "open", title: constTitle("Agent discovery") },
+  AgentDiscoveryResponse: { kind: "a2a", role: "close", title: constTitle("Agent discovery") },
+  // Memory / persistence
+  ContextPersistence: { kind: "memory", role: "open", title: constTitle("Memory persistence") },
+  ContextFlush: { kind: "memory", role: "open", title: constTitle("Memory flush") },
+  ContextFlushResponse: { kind: "memory", role: "close", title: constTitle("Memory flush") },
+  // Human approval
+  HumanApprovalRequired: {
+    kind: "tool",
+    role: "open",
+    title: constTitle("Human approval required"),
+    pending: true
+  },
+  HumanApprovalRequiredResponse: { kind: "tool", role: "close", title: constTitle("Human approval") }
+};
+function resolveInterpreter(eventClass) {
+  if (Object.prototype.hasOwnProperty.call(EVENT_REGISTRY, eventClass)) {
+    return EVENT_REGISTRY[eventClass];
+  }
+  return {
+    kind: "unknown",
+    role: "open",
+    title: (r) => r.event_class
+  };
+}
+
+// src/worklog/reducer.ts
+var asString = (v) => typeof v === "string" ? v : v == null ? "" : JSON.stringify(v);
+var nodeDepth = (record) => {
+  const d = record.data && typeof record.data === "object" ? record.data.depth : void 0;
+  return typeof d === "number" ? d : 0;
+};
+var makeOpenNode = (record, interp, id) => ({
+  id,
+  kind: interp.kind,
+  eventClass: record.event_class,
+  status: interp.pending ? "pending" : "running",
+  title: interp.title(record),
+  startedAt: record.date_submitted,
+  depth: nodeDepth(record),
+  children: [],
+  command: record.data,
+  raw: [record]
+});
+var makeClosedNode = (record, interp, id) => ({
+  id,
+  kind: interp.kind,
+  eventClass: record.event_class,
+  status: record.status === "error" ? "failed" : "completed",
+  title: interp.title(record),
+  startedAt: record.date_submitted,
+  endedAt: record.date_submitted,
+  depth: nodeDepth(record),
+  children: [],
+  response: record.data,
+  error: record.status === "error" ? asString(record.data) : void 0,
+  raw: [record]
+});
+function reduceWorklog(state, record) {
+  const interp = resolveInterpreter(record.event_class);
+  const next = {
+    ...state,
+    nodes: state.nodes.slice(),
+    index: { ...state.index },
+    raw: [...state.raw, record]
+  };
+  if (interp.role === "ignore") return next;
+  if (interp.role === "run-open") {
+    next.status = "running";
+    return next;
+  }
+  if (interp.role === "run-close") {
+    next.answer = asString(record.data) || null;
+    next.status = record.status === "error" ? "error" : "success";
+    return next;
+  }
+  const key = record.control_id ?? `${record.event_class}-${next.raw.length}`;
+  if (interp.role === "close") {
+    const pos2 = Object.prototype.hasOwnProperty.call(next.index, key) ? next.index[key] : void 0;
+    if (pos2 != null) {
+      const existing = next.nodes[pos2];
+      next.nodes[pos2] = {
+        ...existing,
+        status: record.status === "error" ? "failed" : "completed",
+        endedAt: record.date_submitted,
+        response: record.data,
+        error: record.status === "error" ? asString(record.data) : existing.error,
+        raw: [...existing.raw, record]
+      };
+    } else {
+      next.index[key] = next.nodes.length;
+      next.nodes.push(makeClosedNode(record, interp, key));
+    }
+    if (record.status === "error") next.status = "error";
+    return next;
+  }
+  const pos = Object.prototype.hasOwnProperty.call(next.index, key) ? next.index[key] : void 0;
+  if (pos != null) {
+    const existing = next.nodes[pos];
+    next.nodes[pos] = { ...existing, raw: [...existing.raw, record] };
+  } else {
+    next.index[key] = next.nodes.length;
+    next.nodes.push(makeOpenNode(record, interp, key));
+  }
+  return next;
+}
+function foldWorklog(records, taskId = null) {
+  return records.reduce(reduceWorklog, initialWorklogState(taskId));
+}
+
+// src/worklog/use-worklog.ts
+import { useCallback, useReducer } from "react";
+function hookReducer(state, action) {
+  switch (action.type) {
+    case "ingest":
+      return reduceWorklog(state, action.record);
+    case "ingestMany":
+      return action.records.reduce(reduceWorklog, state);
+    case "reset":
+      return initialWorklogState(action.taskId);
+  }
+}
+function useWorklog(taskId = null) {
+  const [worklog, dispatch] = useReducer(hookReducer, taskId, initialWorklogState);
+  const ingest = useCallback((record) => dispatch({ type: "ingest", record }), []);
+  const ingestMany = useCallback(
+    (records) => dispatch({ type: "ingestMany", records }),
+    []
+  );
+  const reset = useCallback(
+    (id = null) => dispatch({ type: "reset", taskId: id }),
+    []
+  );
+  return { worklog, ingest, ingestMany, reset };
+}
+
+// src/worklog/from-frame.ts
+function frameToRecord(frame) {
+  const status = frame.status === "success" || frame.status === "error" ? frame.status : null;
+  return {
+    event_class: typeof frame.event_class === "string" && frame.event_class.length > 0 ? frame.event_class : "Unknown",
+    control_id: frame.control_id ?? null,
+    data: frame.data,
+    status,
+    date_submitted: typeof frame.date_submitted === "string" ? frame.date_submitted : ""
+  };
+}
+export {
+  EVENT_REGISTRY,
+  foldWorklog,
+  frameToRecord,
+  initialWorklogState,
+  reduceWorklog,
+  resolveInterpreter,
+  useWorklog
+};
+//# sourceMappingURL=index.mjs.map

package/dist/worklog/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/worklog/types.ts","../../src/worklog/registry.ts","../../src/worklog/reducer.ts","../../src/worklog/use-worklog.ts","../../src/worklog/from-frame.ts"],"sourcesContent":["/** One granular Runtime worklog record (a `bus_mode` SSE frame or a `/worklog/{task_id}/events` item). */\nexport interface WorklogRecord {\n  event_class: string;\n  control_id: string | null;\n  data: unknown;\n  status: \"success\" | \"error\" | null;\n  date_submitted: string;\n}\n\n/** Semantic bucket a node belongs to. */\nexport type NodeKind =\n  | \"safeguard\"\n  | \"reasoning\"\n  | \"tool\"\n  | \"a2a\"\n  | \"memory\"\n  | \"answer\"\n  | \"unknown\";\n\n/** Lifecycle state of a single node. */\nexport type NodeStatus = \"pending\" | \"running\" | \"completed\" | \"failed\" | \"skipped\";\n\n/** Overall run status. */\nexport type RunStatus = \"idle\" | \"running\" | \"success\" | \"error\";\n\n/** A single step in the execution chain (command + its response merged by control_id). */\nexport interface WorklogNode {\n  id: string;\n  kind: NodeKind;\n  eventClass: string;\n  status: NodeStatus;\n  title: string;\n  startedAt?: string;\n  endedAt?: string;\n  depth: number;\n  parentId?: string;\n  children: WorklogNode[];\n  command?: unknown;\n  response?: unknown;\n  error?: string;\n  raw: WorklogRecord[];\n}\n\n/** Normalized execution model produced by the reducer. */\nexport interface WorklogState {\n  taskId: string | null;\n  status: RunStatus;\n  answer: string | null;\n  nodes: WorklogNode[];\n  index: Record<string, number>;\n  raw: WorklogRecord[];\n}\n\n/** How a record acts on the model. */\nexport type EventRole = \"open\" | \"close\" | \"run-open\" | \"run-close\" | \"ignore\";\n\n/** Registry descriptor for one event_class. */\nexport interface EventInterpreter {\n  kind: NodeKind;\n  role: EventRole;\n  title: (record: WorklogRecord) => string;\n  /** If true, an opened node starts in \"pending\" (awaiting external input) rather than \"running\". */\n  pending?: boolean;\n}\n\nexport function initialWorklogState(taskId: string | null = null): WorklogState {\n  return { taskId, status: \"idle\", answer: null, nodes: [], index: {}, raw: [] };\n}\n","import type { EventInterpreter, WorklogRecord } from \"./types\";\n\nconst asRecord = (data: unknown): Record<string, unknown> =>\n  data && typeof data === \"object\" ? (data as Record<string, unknown>) : {};\n\nconst toolTitle = (r: WorklogRecord): string => {\n  const name = asRecord(r.data).name;\n  return typeof name === \"string\" && name.length > 0 ? `Tool: ${name}` : \"Tool\";\n};\n\nconst agentTitle = (r: WorklogRecord): string => {\n  const name = asRecord(r.data).name;\n  return typeof name === \"string\" && name.length > 0 ? `Agent: ${name}` : \"Agent-to-agent\";\n};\n\nconst constTitle = (label: string) => () => label;\n\nexport const EVENT_REGISTRY: Record<string, EventInterpreter> = {\n  // Run envelope\n  AssistantInference: { kind: \"answer\", role: \"run-open\", title: constTitle(\"Inference started\") },\n  AssistantInferenceResponse: { kind: \"answer\", role: \"run-close\", title: constTitle(\"Answer\") },\n\n  // Safeguard\n  ShieldInference: { kind: \"safeguard\", role: \"open\", title: constTitle(\"Safeguard\") },\n  ShieldInferenceResponse: { kind: \"safeguard\", role: \"close\", title: constTitle(\"Safeguard\") },\n\n  // Reasoning\n  ResponseInference: { kind: \"reasoning\", role: \"open\", title: constTitle(\"Reasoning\") },\n  ResponseInferenceResponse: { kind: \"reasoning\", role: \"close\", title: constTitle(\"Reasoning\") },\n\n  // Tools (server + subclasses) and their responses\n  ServerToolExecution: { kind: \"tool\", role: \"open\", title: toolTitle },\n  BuiltinToolExecution: { kind: \"tool\", role: \"open\", title: toolTitle },\n  UnknownToolExecution: { kind: \"tool\", role: \"open\", title: toolTitle },\n  ClientToolExecution: { kind: \"tool\", role: \"open\", title: toolTitle, pending: true },\n  ToolExecutionResponse: { kind: \"tool\", role: \"close\", title: toolTitle },\n  BuiltinToolExecutionResponse: { kind: \"tool\", role: \"close\", title: toolTitle },\n\n  // Tool schema discovery\n  ToolSchema: { kind: \"tool\", role: \"open\", title: constTitle(\"Tool schema\") },\n  ToolSchemaResponse: { kind: \"tool\", role: \"close\", title: constTitle(\"Tool schema\") },\n\n  // Agent-to-agent\n  A2AInference: { kind: \"a2a\", role: \"open\", title: agentTitle },\n  AgentDiscovery: { kind: \"a2a\", role: \"open\", title: constTitle(\"Agent discovery\") },\n  AgentDiscoveryResponse: { kind: \"a2a\", role: \"close\", title: constTitle(\"Agent discovery\") },\n\n  // Memory / persistence\n  ContextPersistence: { kind: \"memory\", role: \"open\", title: constTitle(\"Memory persistence\") },\n  ContextFlush: { kind: \"memory\", role: \"open\", title: constTitle(\"Memory flush\") },\n  ContextFlushResponse: { kind: \"memory\", role: \"close\", title: constTitle(\"Memory flush\") },\n\n  // Human approval\n  HumanApprovalRequired: {\n    kind: \"tool\",\n    role: \"open\",\n    title: constTitle(\"Human approval required\"),\n    pending: true,\n  },\n  HumanApprovalRequiredResponse: { kind: \"tool\", role: \"close\", title: constTitle(\"Human approval\") },\n};\n\nexport function resolveInterpreter(eventClass: string): EventInterpreter {\n  if (Object.prototype.hasOwnProperty.call(EVENT_REGISTRY, eventClass)) {\n    return EVENT_REGISTRY[eventClass];\n  }\n  return {\n    kind: \"unknown\",\n    role: \"open\",\n    title: (r: WorklogRecord) => r.event_class,\n  };\n}\n","import { resolveInterpreter } from \"./registry\";\nimport type { EventInterpreter, WorklogNode, WorklogRecord, WorklogState } from \"./types\";\nimport { initialWorklogState } from \"./types\";\n\nconst asString = (v: unknown): string =>\n  typeof v === \"string\" ? v : v == null ? \"\" : JSON.stringify(v);\n\nconst nodeDepth = (record: WorklogRecord): number => {\n  const d = record.data && typeof record.data === \"object\"\n    ? (record.data as Record<string, unknown>).depth\n    : undefined;\n  return typeof d === \"number\" ? d : 0;\n};\n\nconst makeOpenNode = (record: WorklogRecord, interp: EventInterpreter, id: string): WorklogNode => ({\n  id,\n  kind: interp.kind,\n  eventClass: record.event_class,\n  status: interp.pending ? \"pending\" : \"running\",\n  title: interp.title(record),\n  startedAt: record.date_submitted,\n  depth: nodeDepth(record),\n  children: [],\n  command: record.data,\n  raw: [record],\n});\n\nconst makeClosedNode = (record: WorklogRecord, interp: EventInterpreter, id: string): WorklogNode => ({\n  id,\n  kind: interp.kind,\n  eventClass: record.event_class,\n  status: record.status === \"error\" ? \"failed\" : \"completed\",\n  title: interp.title(record),\n  startedAt: record.date_submitted,\n  endedAt: record.date_submitted,\n  depth: nodeDepth(record),\n  children: [],\n  response: record.data,\n  error: record.status === \"error\" ? asString(record.data) : undefined,\n  raw: [record],\n});\n\nexport function reduceWorklog(state: WorklogState, record: WorklogRecord): WorklogState {\n  const interp = resolveInterpreter(record.event_class);\n  const next: WorklogState = {\n    ...state,\n    nodes: state.nodes.slice(),\n    index: { ...state.index },\n    raw: [...state.raw, record],\n  };\n\n  if (interp.role === \"ignore\") return next;\n\n  if (interp.role === \"run-open\") {\n    next.status = \"running\";\n    return next;\n  }\n\n  if (interp.role === \"run-close\") {\n    next.answer = asString(record.data) || null;\n    next.status = record.status === \"error\" ? \"error\" : \"success\";\n    return next;\n  }\n\n  const key = record.control_id ?? `${record.event_class}-${next.raw.length}`;\n\n  if (interp.role === \"close\") {\n    const pos = Object.prototype.hasOwnProperty.call(next.index, key) ? next.index[key] : undefined;\n    if (pos != null) {\n      const existing = next.nodes[pos];\n      next.nodes[pos] = {\n        ...existing,\n        status: record.status === \"error\" ? \"failed\" : \"completed\",\n        endedAt: record.date_submitted,\n        response: record.data,\n        error: record.status === \"error\" ? asString(record.data) : existing.error,\n        raw: [...existing.raw, record],\n      };\n    } else {\n      // response arrived without a seen command — create it already closed\n      next.index[key] = next.nodes.length;\n      next.nodes.push(makeClosedNode(record, interp, key));\n    }\n    if (record.status === \"error\") next.status = \"error\";\n    return next;\n  }\n\n  // role === \"open\"\n  const pos = Object.prototype.hasOwnProperty.call(next.index, key) ? next.index[key] : undefined;\n  if (pos != null) {\n    const existing = next.nodes[pos];\n    next.nodes[pos] = { ...existing, raw: [...existing.raw, record] };\n  } else {\n    next.index[key] = next.nodes.length;\n    next.nodes.push(makeOpenNode(record, interp, key));\n  }\n  return next;\n}\n\nexport function foldWorklog(records: WorklogRecord[], taskId: string | null = null): WorklogState {\n  return records.reduce(reduceWorklog, initialWorklogState(taskId));\n}\n","import { useCallback, useReducer } from \"react\";\nimport { reduceWorklog } from \"./reducer\";\nimport { initialWorklogState, type WorklogRecord, type WorklogState } from \"./types\";\n\ntype Action =\n  | { type: \"ingest\"; record: WorklogRecord }\n  | { type: \"ingestMany\"; records: WorklogRecord[] }\n  | { type: \"reset\"; taskId: string | null };\n\nfunction hookReducer(state: WorklogState, action: Action): WorklogState {\n  switch (action.type) {\n    case \"ingest\":\n      return reduceWorklog(state, action.record);\n    case \"ingestMany\":\n      return action.records.reduce(reduceWorklog, state);\n    case \"reset\":\n      return initialWorklogState(action.taskId);\n  }\n}\n\n/** Live worklog accumulator. Feed it `bus_mode` records via `ingest`; use `foldWorklog` for history. */\nexport function useWorklog(taskId: string | null = null) {\n  const [worklog, dispatch] = useReducer(hookReducer, taskId, initialWorklogState);\n\n  const ingest = useCallback((record: WorklogRecord) => dispatch({ type: \"ingest\", record }), []);\n  const ingestMany = useCallback(\n    (records: WorklogRecord[]) => dispatch({ type: \"ingestMany\", records }),\n    [],\n  );\n  const reset = useCallback(\n    (id: string | null = null) => dispatch({ type: \"reset\", taskId: id }),\n    [],\n  );\n\n  return { worklog, ingest, ingestMany, reset };\n}\n","import type { WorklogRecord } from \"./types\";\n\n/** Loosely-typed shape of a parsed SSE `data:` frame from the granular Runtime stream. */\nexport interface RawFrame {\n  event_class?: string;\n  control_id?: string | null;\n  data?: unknown;\n  status?: string | null;\n  date_submitted?: string;\n}\n\n/** Normalize a parsed SSE frame into a WorklogRecord (defaults missing fields; never throws). */\nexport function frameToRecord(frame: RawFrame): WorklogRecord {\n  const status = frame.status === \"success\" || frame.status === \"error\" ? frame.status : null;\n  return {\n    event_class: typeof frame.event_class === \"string\" && frame.event_class.length > 0\n      ? frame.event_class\n      : \"Unknown\",\n    control_id: frame.control_id ?? null,\n    data: frame.data,\n    status,\n    date_submitted: typeof frame.date_submitted === \"string\" ? frame.date_submitted : \"\",\n  };\n}\n"],"mappings":"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","names":["pos"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@alquimia-ai/tools",
-  "version": "2.1.0",
+  "version": "2.2.0",
   "author": "Alquimia AI",
   "description": "tools for Alquimia SDK",
   "private": false,
@@ -61,6 +61,11 @@
       "import": "./dist/utils/index.mjs",
       "require": "./dist/utils/index.js"
     },
+    "./worklog": {
+      "types": "./dist/worklog/index.d.ts",
+      "import": "./dist/worklog/index.mjs",
+      "require": "./dist/worklog/index.js"
+    },
     "./types": {
       "types": "./dist/types/index.d.ts",
       "import": "./dist/types/index.mjs",