@dna113p/machines 0.3.5 → 0.3.6

package/README.md

@@ -176,10 +176,10 @@ npm ci
 npm pack
 ```
 
-Then install the generated `dna113p-machines-0.3.5.tgz` into a project:
+Then install the generated `dna113p-machines-0.3.6.tgz` into a project:
 
 ```bash
-npm install /absolute/path/to/machines/dna113p-machines-0.3.5.tgz
+npm install /absolute/path/to/machines/dna113p-machines-0.3.6.tgz
 npx machine list
 ```
 

package/dist/src/host.d.ts

@@ -1,6 +1,7 @@
 import { type JsonValue } from "./json.ts";
 import type { StateValue } from "xstate";
 import type { AgentUpdate, HumanRequest } from "./index.ts";
+import type { RunGraph } from "./run-graph.ts";
 import { type PrepareMachineRunOptions } from "./launcher.ts";
 export interface HostedHumanRequest extends HumanRequest {
     readonly requestId: string;
@@ -33,6 +34,11 @@ export interface MachineHostRun {
     readonly description: string;
     readonly path: string;
     readonly agentRoles: Readonly<Record<string, string>>;
+    /**
+     * The Machine's states and transitions, as its published run status carries
+     * them, whether or not this run is published. Absent for a Machine too large to draw.
+     */
+    readonly graph?: RunGraph;
     readonly result: Promise<MachineHostResult>;
     respond(response: string, requestId: string): Promise<void>;
     ask(question: string, requestId: string): Promise<void>;

package/dist/src/host.js

@@ -208,6 +208,7 @@ export function startMachineHost(options) {
                     description: message.description,
                     path: message.path,
                     agentRoles: message.agentRoles,
+                    ...(message.graph === undefined ? {} : { graph: message.graph }),
                     result,
                     async respond(response, requestId) {
                         if (phase !== "running" || pendingHuman === undefined) {

package/dist/src/index.d.ts

@@ -79,6 +79,7 @@ export type AgentUpdate = {
 export type AgentReporter = (update: AgentUpdate) => void;
 export type { JsonValue } from "./json.ts";
 export { AgentLimitError, agentLimitOf, type AgentLimit } from "./agent-limit.ts";
+export { machineGraph, statePaths, type RunGraph, type RunGraphEdge, type RunGraphState, type RunTrailStep, } from "./run-graph.ts";
 export type AgentRunner = (request: AgentRequest, report?: AgentReporter) => Event | Promise<Event>;
 export interface RunOptions {
     readonly agents?: Readonly<Record<string, AgentRunner>>;

package/dist/src/index.js

@@ -2,6 +2,7 @@ import { agentLimitOf } from "./agent-limit.js";
 import { terminalHuman } from "./terminal-human.js";
 import { createActor, fromPromise, raise, setup, } from "xstate";
 export { AgentLimitError, agentLimitOf } from "./agent-limit.js";
+export { machineGraph, statePaths, } from "./run-graph.js";
 const machines = setup({
     actions: {
         humanInputFinished: () => { },

package/docs/integrations.md

@@ -230,6 +230,12 @@ states the run entered, oldest first, each with the time it was entered, as the
 same dotted paths; it keeps the latest 200. Both are additions to version 2:
 a reader that does not know them ignores them.
 
+The graph does not depend on publication. `machineGraph(definition)` from
+`@dna113p/machines` returns it for any Machine definition a program holds, or
+undefined for one too large to draw. The value `startMachineHost` resolves to
+carries the run's `graph` whether or not the host publishes, and its `onState`
+callback reports each state a trail is made of.
+
 A run hosted through `startMachineHost` from `@dna113p/machines/host` publishes
 the same record when its host asks with `publishRunStatus: true` and
 publication is on in the hosting process, as a daemon that runs tickets does. A

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dna113p/machines",
-  "version": "0.3.5",
+  "version": "0.3.6",
   "description": "Reusable workflows coordinating agents, local operations, and human decisions.",
   "license": "MIT",
   "repository": {