unfazed 0.5.0 → 0.6.0

package/dist/index.js

@@ -24,6 +24,28 @@
 export { Unfazed } from "./unfazed.js";
 export { UnfazedClient, DEFAULT_BASE_URL, DEFAULT_ENDPOINT, ENDPOINT_ENV_VAR, GRAPHQL_PATH, TOKEN_ENV_VAR, VERSION, } from "./client.js";
 export { DEPLOYMENT_NOT_FOUND, UnfazedAuthError, UnfazedConfigError, UnfazedConflictError, UnfazedDeployError, UnfazedError, UnfazedGraphQLError, UnfazedHTTPError, UnfazedNotFoundError, UnfazedRunError, UnfazedTimeoutError, WORKSPACE_NOT_FOUND, isDuplicateWorkspaceName, isNotFoundSentinel, } from "./errors.js";
+export { UnfazedInspectError } from "./errors.js";
+export { APP_ENV_VAR } from "./remote/app.js";
+/**
+ * The `unfazed` backend of Workflow SDK's CLI: a read-mostly World over the
+ * platform's workflow inspection API, for one app.
+ *
+ * ```sh
+ * export UNFZ_API_TOKEN=...                                   # https://unfazed.dev/auth.md
+ * UNFZ_APP=birthday-card npx workflow inspect runs --backend unfazed
+ * ```
+ *
+ * The CLI (and its `--web` UI) resolve `unfazed` from the project and call
+ * this with no arguments. The app is `UNFZ_APP`, else the `alias` (or the
+ * single `apps[]` entry) of `unfazed.json` in the current directory. Reads
+ * and `workflow cancel` work; every other write throws, since an app's own
+ * World is `unfazed/workflow`. The module behind it loads on first call, so
+ * `import "unfazed"` stays as light as before.
+ */
+export async function createWorld(options) {
+    const { createRemoteWorld } = await import("./remote/world.js");
+    return createRemoteWorld(options);
+}
 /**
  * Every operation document the workflow layer uses, for callers that want the
  * typed documents but not the wrapper methods.

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAuBvC,OAAO,EACL,aAAa,EACb,gBAAgB,EAChB,gBAAgB,EAChB,gBAAgB,EAChB,YAAY,EACZ,aAAa,EACb,OAAO,GACR,MAAM,aAAa,CAAC;AAUrB,OAAO,EACL,oBAAoB,EACpB,gBAAgB,EAChB,kBAAkB,EAClB,oBAAoB,EACpB,kBAAkB,EAClB,YAAY,EACZ,mBAAmB,EACnB,gBAAgB,EAChB,oBAAoB,EACpB,eAAe,EACf,mBAAmB,EACnB,mBAAmB,EACnB,wBAAwB,EACxB,kBAAkB,GACnB,MAAM,aAAa,CAAC;AAKrB;;;GAGG;AACH,OAAO,KAAK,UAAU,MAAM,iBAAiB,CAAC","sourcesContent":["/**\n * unfazed — official TypeScript SDK.\n *\n * The code-mode companion to the unfazed MCP server: write one script that\n * deploys, waits, reads logs and filters them locally, instead of chaining a\n * dozen tool calls through a model's context.\n *\n * ```ts\n * import { Unfazed } from \"unfazed\";\n *\n * const unfazed = new Unfazed();                       // reads UNFZ_API_TOKEN\n * const ws = await unfazed.createWorkspace(\"hello\");\n * await unfazed.writeFiles(ws.id, {\n *   \"server.ts\": `export default { fetch: () => new Response(\"hi\") }`,\n * });\n * const app = await unfazed.deployService({ workspaceId: ws.id, alias: \"hello\", wait: true });\n * console.log(app.url);\n * ```\n *\n * Two layers, both public:\n *  - {@link Unfazed} — the workflow layer (deploy + wait, batch writes, one-call rollback).\n *  - {@link UnfazedClient} — the typed GraphQL transport, for anything not wrapped.\n */\n\nexport { Unfazed } from \"./unfazed.js\";\nexport type {\n  CreateRunOptions,\n  FollowUpRunOptions,\n  DeleteDeploymentOptions,\n  DeleteWorkspaceOptions,\n  Deployment,\n  DeployBoxOptions,\n  DeployOptions,\n  DeployServiceOptions,\n  DeployStaticOptions,\n  EnvVar,\n  FileContent,\n  FilesMap,\n  ListRunsFilter,\n  RollbackOptions,\n  Run,\n  UnfazedOptions,\n  Workspace,\n  WorkspaceFile,\n  WriteFilesOptions,\n} from \"./unfazed.js\";\n\nexport {\n  UnfazedClient,\n  DEFAULT_BASE_URL,\n  DEFAULT_ENDPOINT,\n  ENDPOINT_ENV_VAR,\n  GRAPHQL_PATH,\n  TOKEN_ENV_VAR,\n  VERSION,\n} from \"./client.js\";\nexport type {\n  ClientOptions,\n  FetchLike,\n  GraphQLDocument,\n  RequestOptions,\n  ResultOf,\n  VariablesOf,\n} from \"./client.js\";\n\nexport {\n  DEPLOYMENT_NOT_FOUND,\n  UnfazedAuthError,\n  UnfazedConfigError,\n  UnfazedConflictError,\n  UnfazedDeployError,\n  UnfazedError,\n  UnfazedGraphQLError,\n  UnfazedHTTPError,\n  UnfazedNotFoundError,\n  UnfazedRunError,\n  UnfazedTimeoutError,\n  WORKSPACE_NOT_FOUND,\n  isDuplicateWorkspaceName,\n  isNotFoundSentinel,\n} from \"./errors.js\";\nexport type { GraphQLResponseError } from \"./errors.js\";\n\nexport type { WaitOptions } from \"./wait.js\";\n\n/**\n * Every operation document the workflow layer uses, for callers that want the\n * typed documents but not the wrapper methods.\n */\nexport * as operations from \"./operations.js\";\n\n/**\n * Schema types generated from the platform's `graph/schema.graphqls`: enums\n * (`DeploymentStatus`, `ServiceMode`, ...), input objects\n * (`CreateDeploymentInput`, ...) and every operation's result type.\n */\nexport type * from \"./generated/graphql.js\";\n"]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAIH,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAuBvC,OAAO,EACL,aAAa,EACb,gBAAgB,EAChB,gBAAgB,EAChB,gBAAgB,EAChB,YAAY,EACZ,aAAa,EACb,OAAO,GACR,MAAM,aAAa,CAAC;AAUrB,OAAO,EACL,oBAAoB,EACpB,gBAAgB,EAChB,kBAAkB,EAClB,oBAAoB,EACpB,kBAAkB,EAClB,YAAY,EACZ,mBAAmB,EACnB,gBAAgB,EAChB,oBAAoB,EACpB,eAAe,EACf,mBAAmB,EACnB,mBAAmB,EACnB,wBAAwB,EACxB,kBAAkB,GACnB,MAAM,aAAa,CAAC;AAKrB,OAAO,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAClD,OAAO,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAG9C;;;;;;;;;;;;;;;GAeG;AACH,MAAM,CAAC,KAAK,UAAU,WAAW,CAAC,OAA4B;IAC5D,MAAM,EAAE,iBAAiB,EAAE,GAAG,MAAM,MAAM,CAAC,mBAAmB,CAAC,CAAC;IAChE,OAAO,iBAAiB,CAAC,OAAO,CAAC,CAAC;AACpC,CAAC;AAED;;;GAGG;AACH,OAAO,KAAK,UAAU,MAAM,iBAAiB,CAAC","sourcesContent":["/**\n * unfazed — official TypeScript SDK.\n *\n * The code-mode companion to the unfazed MCP server: write one script that\n * deploys, waits, reads logs and filters them locally, instead of chaining a\n * dozen tool calls through a model's context.\n *\n * ```ts\n * import { Unfazed } from \"unfazed\";\n *\n * const unfazed = new Unfazed();                       // reads UNFZ_API_TOKEN\n * const ws = await unfazed.createWorkspace(\"hello\");\n * await unfazed.writeFiles(ws.id, {\n *   \"server.ts\": `export default { fetch: () => new Response(\"hi\") }`,\n * });\n * const app = await unfazed.deployService({ workspaceId: ws.id, alias: \"hello\", wait: true });\n * console.log(app.url);\n * ```\n *\n * Two layers, both public:\n *  - {@link Unfazed} — the workflow layer (deploy + wait, batch writes, one-call rollback).\n *  - {@link UnfazedClient} — the typed GraphQL transport, for anything not wrapped.\n */\n\nimport type { RemoteWorld, RemoteWorldOptions } from \"./remote/world.js\";\n\nexport { Unfazed } from \"./unfazed.js\";\nexport type {\n  CreateRunOptions,\n  FollowUpRunOptions,\n  DeleteDeploymentOptions,\n  DeleteWorkspaceOptions,\n  Deployment,\n  DeployBoxOptions,\n  DeployOptions,\n  DeployServiceOptions,\n  DeployStaticOptions,\n  EnvVar,\n  FileContent,\n  FilesMap,\n  ListRunsFilter,\n  RollbackOptions,\n  Run,\n  UnfazedOptions,\n  Workspace,\n  WorkspaceFile,\n  WriteFilesOptions,\n} from \"./unfazed.js\";\n\nexport {\n  UnfazedClient,\n  DEFAULT_BASE_URL,\n  DEFAULT_ENDPOINT,\n  ENDPOINT_ENV_VAR,\n  GRAPHQL_PATH,\n  TOKEN_ENV_VAR,\n  VERSION,\n} from \"./client.js\";\nexport type {\n  ClientOptions,\n  FetchLike,\n  GraphQLDocument,\n  RequestOptions,\n  ResultOf,\n  VariablesOf,\n} from \"./client.js\";\n\nexport {\n  DEPLOYMENT_NOT_FOUND,\n  UnfazedAuthError,\n  UnfazedConfigError,\n  UnfazedConflictError,\n  UnfazedDeployError,\n  UnfazedError,\n  UnfazedGraphQLError,\n  UnfazedHTTPError,\n  UnfazedNotFoundError,\n  UnfazedRunError,\n  UnfazedTimeoutError,\n  WORKSPACE_NOT_FOUND,\n  isDuplicateWorkspaceName,\n  isNotFoundSentinel,\n} from \"./errors.js\";\nexport type { GraphQLResponseError } from \"./errors.js\";\n\nexport type { WaitOptions } from \"./wait.js\";\n\nexport { UnfazedInspectError } from \"./errors.js\";\nexport { APP_ENV_VAR } from \"./remote/app.js\";\nexport type { RemoteWorld, RemoteWorldOptions } from \"./remote/world.js\";\n\n/**\n * The `unfazed` backend of Workflow SDK's CLI: a read-mostly World over the\n * platform's workflow inspection API, for one app.\n *\n * ```sh\n * export UNFZ_API_TOKEN=...                                   # https://unfazed.dev/auth.md\n * UNFZ_APP=birthday-card npx workflow inspect runs --backend unfazed\n * ```\n *\n * The CLI (and its `--web` UI) resolve `unfazed` from the project and call\n * this with no arguments. The app is `UNFZ_APP`, else the `alias` (or the\n * single `apps[]` entry) of `unfazed.json` in the current directory. Reads\n * and `workflow cancel` work; every other write throws, since an app's own\n * World is `unfazed/workflow`. The module behind it loads on first call, so\n * `import \"unfazed\"` stays as light as before.\n */\nexport async function createWorld(options?: RemoteWorldOptions): Promise<RemoteWorld> {\n  const { createRemoteWorld } = await import(\"./remote/world.js\");\n  return createRemoteWorld(options);\n}\n\n/**\n * Every operation document the workflow layer uses, for callers that want the\n * typed documents but not the wrapper methods.\n */\nexport * as operations from \"./operations.js\";\n\n/**\n * Schema types generated from the platform's `graph/schema.graphqls`: enums\n * (`DeploymentStatus`, `ServiceMode`, ...), input objects\n * (`CreateDeploymentInput`, ...) and every operation's result type.\n */\nexport type * from \"./generated/graphql.js\";\n"]}

package/dist/remote/app.d.ts

@@ -0,0 +1,18 @@
+/** Environment variable naming the app (its alias) the CLI backend reads. */
+export declare const APP_ENV_VAR = "UNFZ_APP";
+/** The project file the alias is read from when `UNFZ_APP` is unset. */
+export declare const MANIFEST_FILE = "unfazed.json";
+type Env = Record<string, string | undefined>;
+/**
+ * The app alias: `alias` when given, else `UNFZ_APP`, else `unfazed.json` in
+ * `cwd`: its `alias`, or the alias of its only `apps[]` entry. Throws
+ * {@link UnfazedConfigError} saying what to set when none of them names one.
+ */
+export declare function resolveAlias(options: {
+    alias?: string;
+    env: Env;
+    cwd: string;
+}): string;
+/** The current directory, or `"."` where there is no `process`. */
+export declare function currentDirectory(): string;
+export {};

package/dist/remote/app.js

@@ -0,0 +1,76 @@
+/**
+ * Which app the `unfazed` CLI backend reads: `UNFZ_APP`, else the alias the
+ * current directory's `unfazed.json` names.
+ */
+import { UnfazedConfigError } from "../errors.js";
+/** Environment variable naming the app (its alias) the CLI backend reads. */
+export const APP_ENV_VAR = "UNFZ_APP";
+/** The project file the alias is read from when `UNFZ_APP` is unset. */
+export const MANIFEST_FILE = "unfazed.json";
+/**
+ * The app alias: `alias` when given, else `UNFZ_APP`, else `unfazed.json` in
+ * `cwd`: its `alias`, or the alias of its only `apps[]` entry. Throws
+ * {@link UnfazedConfigError} saying what to set when none of them names one.
+ */
+export function resolveAlias(options) {
+    const explicit = options.alias?.trim() || options.env[APP_ENV_VAR]?.trim();
+    if (explicit)
+        return explicit;
+    const path = joinPath(options.cwd, MANIFEST_FILE);
+    const text = readText(path);
+    const hint = `Set ${APP_ENV_VAR} to the app's alias (the <alias> of https://<alias>.unfz.to), e.g.\n` +
+        `  ${APP_ENV_VAR}=my-app npx workflow inspect runs --backend unfazed\n` +
+        `or run it from the app's directory with "alias" in its ${MANIFEST_FILE}.`;
+    if (text === undefined)
+        throw new UnfazedConfigError(`unfazed: which app? ${APP_ENV_VAR} is not set and there is no ${path}. ${hint}`);
+    let manifest;
+    try {
+        manifest = JSON.parse(text);
+    }
+    catch (error) {
+        throw new UnfazedConfigError(`unfazed: ${path} is not valid JSON (${error.message}). ${hint}`);
+    }
+    if (typeof manifest.alias === "string" && manifest.alias.trim())
+        return manifest.alias.trim();
+    const aliases = (Array.isArray(manifest.apps) ? manifest.apps : [])
+        .map((app) => (typeof app?.alias === "string" ? app.alias.trim() : ""))
+        .filter((alias) => alias !== "");
+    if (aliases.length === 1)
+        return aliases[0];
+    if (aliases.length > 1) {
+        throw new UnfazedConfigError(`unfazed: ${path} deploys ${aliases.length} apps (${aliases.join(", ")}). ` +
+            `Set ${APP_ENV_VAR} to the one to inspect, e.g. ${APP_ENV_VAR}=${aliases[0]}.`);
+    }
+    throw new UnfazedConfigError(`unfazed: which app? ${path} names no "alias" and no apps[]. ${hint}`);
+}
+/** The current directory, or `"."` where there is no `process`. */
+export function currentDirectory() {
+    const proc = globalThis.process;
+    return proc?.cwd?.() ?? ".";
+}
+/**
+ * A file's text, or `undefined` when it does not exist. `node:fs` comes from
+ * `process.getBuiltinModule` (Node >= 20.16, Bun, Deno), never from an
+ * import: the root entry stays free of Node imports, so a browser bundle of
+ * `unfazed` does not trip over them.
+ */
+function readText(path) {
+    const proc = globalThis.process;
+    const fs = proc?.getBuiltinModule?.("node:fs");
+    if (!fs) {
+        throw new UnfazedConfigError(`unfazed: cannot read ${path} on this runtime (it needs process.getBuiltinModule: Node >= 20.16, Bun or Deno). ` +
+            `Set ${APP_ENV_VAR} to the app's alias.`);
+    }
+    try {
+        return fs.readFileSync(path, "utf8");
+    }
+    catch (error) {
+        if (error.code === "ENOENT")
+            return undefined;
+        throw new UnfazedConfigError(`unfazed: could not read ${path}: ${error.message}`);
+    }
+}
+function joinPath(dir, file) {
+    return dir.endsWith("/") || dir.endsWith("\\") ? dir + file : `${dir}/${file}`;
+}
+//# sourceMappingURL=app.js.map

package/dist/remote/app.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"app.js","sourceRoot":"","sources":["../../src/remote/app.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Which app the `unfazed` CLI backend reads: `UNFZ_APP`, else the alias the\n * current directory's `unfazed.json` names.\n */\nimport { UnfazedConfigError } from \"../errors.js\";\n\n/** Environment variable naming the app (its alias) the CLI backend reads. */\nexport const APP_ENV_VAR = \"UNFZ_APP\";\n\n/** The project file the alias is read from when `UNFZ_APP` is unset. */\nexport const MANIFEST_FILE = \"unfazed.json\";\n\ntype Env = Record<string, string | undefined>;\n\ninterface Manifest {\n  alias?: unknown;\n  apps?: { alias?: unknown; rootDir?: unknown }[];\n}\n\n/**\n * The app alias: `alias` when given, else `UNFZ_APP`, else `unfazed.json` in\n * `cwd`: its `alias`, or the alias of its only `apps[]` entry. Throws\n * {@link UnfazedConfigError} saying what to set when none of them names one.\n */\nexport function resolveAlias(options: { alias?: string; env: Env; cwd: string }): string {\n  const explicit = options.alias?.trim() || options.env[APP_ENV_VAR]?.trim();\n  if (explicit) return explicit;\n\n  const path = joinPath(options.cwd, MANIFEST_FILE);\n  const text = readText(path);\n  const hint =\n    `Set ${APP_ENV_VAR} to the app's alias (the <alias> of https://<alias>.unfz.to), e.g.\\n` +\n    `  ${APP_ENV_VAR}=my-app npx workflow inspect runs --backend unfazed\\n` +\n    `or run it from the app's directory with \"alias\" in its ${MANIFEST_FILE}.`;\n  if (text === undefined) throw new UnfazedConfigError(`unfazed: which app? ${APP_ENV_VAR} is not set and there is no ${path}. ${hint}`);\n\n  let manifest: Manifest;\n  try {\n    manifest = JSON.parse(text) as Manifest;\n  } catch (error) {\n    throw new UnfazedConfigError(`unfazed: ${path} is not valid JSON (${(error as Error).message}). ${hint}`);\n  }\n  if (typeof manifest.alias === \"string\" && manifest.alias.trim()) return manifest.alias.trim();\n  const aliases = (Array.isArray(manifest.apps) ? manifest.apps : [])\n    .map((app) => (typeof app?.alias === \"string\" ? app.alias.trim() : \"\"))\n    .filter((alias) => alias !== \"\");\n  if (aliases.length === 1) return aliases[0]!;\n  if (aliases.length > 1) {\n    throw new UnfazedConfigError(\n      `unfazed: ${path} deploys ${aliases.length} apps (${aliases.join(\", \")}). ` +\n        `Set ${APP_ENV_VAR} to the one to inspect, e.g. ${APP_ENV_VAR}=${aliases[0]}.`,\n    );\n  }\n  throw new UnfazedConfigError(`unfazed: which app? ${path} names no \"alias\" and no apps[]. ${hint}`);\n}\n\n/** The current directory, or `\".\"` where there is no `process`. */\nexport function currentDirectory(): string {\n  const proc = (globalThis as { process?: { cwd?: () => string } }).process;\n  return proc?.cwd?.() ?? \".\";\n}\n\n/**\n * A file's text, or `undefined` when it does not exist. `node:fs` comes from\n * `process.getBuiltinModule` (Node >= 20.16, Bun, Deno), never from an\n * import: the root entry stays free of Node imports, so a browser bundle of\n * `unfazed` does not trip over them.\n */\nfunction readText(path: string): string | undefined {\n  const proc = (globalThis as { process?: { getBuiltinModule?: (id: string) => unknown } }).process;\n  const fs = proc?.getBuiltinModule?.(\"node:fs\") as\n    | { readFileSync(path: string, encoding: \"utf8\"): string }\n    | undefined;\n  if (!fs) {\n    throw new UnfazedConfigError(\n      `unfazed: cannot read ${path} on this runtime (it needs process.getBuiltinModule: Node >= 20.16, Bun or Deno). ` +\n        `Set ${APP_ENV_VAR} to the app's alias.`,\n    );\n  }\n  try {\n    return fs.readFileSync(path, \"utf8\");\n  } catch (error) {\n    if ((error as { code?: string }).code === \"ENOENT\") return undefined;\n    throw new UnfazedConfigError(`unfazed: could not read ${path}: ${(error as Error).message}`);\n  }\n}\n\nfunction joinPath(dir: string, file: string): string {\n  return dir.endsWith(\"/\") || dir.endsWith(\"\\\\\") ? dir + file : `${dir}/${file}`;\n}\n"]}

package/dist/remote/documents.d.ts

@@ -0,0 +1,175 @@
+/**
+ * The GraphQL documents the `unfazed` CLI backend sends: the platform's
+ * workflow inspection API (unfazed docs/workflow-inspect.md, "GraphQL").
+ *
+ * Written by hand rather than through codegen because the vendored schema
+ * predates these fields; `test/remote/documents.test.ts` validates every
+ * document against a copy of the inspection schema, so a misspelt field fails
+ * there instead of on the platform.
+ */
+/** `WorkflowValue`: a payload as display text, cut at the route's cap. */
+export interface WorkflowValue {
+    text: string;
+    bytes: number;
+    truncated: boolean;
+    error: boolean;
+}
+/** `WorkflowError`: a thrown run or step error. */
+export interface WorkflowError {
+    message: string;
+    stack: string | null;
+    code: string | null;
+    truncated: boolean;
+}
+export type WorkflowRunStatus = "PENDING" | "RUNNING" | "COMPLETED" | "FAILED" | "CANCELLED";
+export interface WorkflowRunSummary {
+    runID: string;
+    workflowName: string;
+    displayName: string;
+    module: string;
+    status: WorkflowRunStatus;
+    deploymentID: string;
+    createdAt: string;
+    startedAt: string | null;
+    completedAt: string | null;
+    updatedAt: string;
+    expiredAt: string | null;
+    errorCode: string | null;
+    attributes: {
+        key: string;
+        value: string;
+    }[];
+}
+export interface WorkflowStep {
+    stepID: string;
+    stepName: string;
+    displayName: string;
+    module: string;
+    status: string;
+    attempt: number;
+    createdAt: string;
+    startedAt: string | null;
+    completedAt: string | null;
+    updatedAt: string;
+    retryAfter: string | null;
+}
+export interface WorkflowEvent {
+    eventID: string;
+    eventType: string;
+    correlationID: string | null;
+    createdAt: string;
+    info: Record<string, unknown>;
+    infoTruncated: boolean;
+}
+export interface WorkflowWait {
+    correlationID: string;
+    status: string;
+    createdAt: string;
+    resumeAt: string | null;
+    completedAt: string | null;
+}
+export interface WorkflowHook {
+    hookID: string;
+    kind: string;
+    status: string;
+    createdAt: string;
+    receivedCount: number;
+    lastReceivedAt: string | null;
+    disposedAt: string | null;
+}
+export interface WorkflowStreamInfo {
+    name: string;
+    tailIndex: number | null;
+    done: boolean | null;
+}
+export interface WorkflowStreamChunk {
+    index: number;
+    bytes: number;
+    encoding: string;
+    text: string;
+    truncated: boolean;
+}
+export interface WorkflowRunPage {
+    run: WorkflowRunSummary;
+    input: WorkflowValue | null;
+    output: WorkflowValue | null;
+    error: WorkflowError | null;
+    steps: WorkflowStep[];
+    stepsNextCursor: string | null;
+    stepsHasMore: boolean;
+    waits: WorkflowWait[];
+    waitsTruncated: boolean;
+    hooks: WorkflowHook[];
+    hooksTruncated: boolean;
+    streams: WorkflowStreamInfo[];
+    eventsScanned: number;
+    eventsComplete: boolean;
+}
+export declare const RUNS = "\n  query SdkWorkflowRuns($alias: String!, $status: [WorkflowRunStatus!], $workflowName: String, $limit: Int, $cursor: String) {\n    workflowRuns(alias: $alias, status: $status, workflowName: $workflowName, limit: $limit, cursor: $cursor) {\n      runs { runID workflowName displayName module status deploymentID createdAt startedAt completedAt\n      updatedAt expiredAt errorCode attributes { key value } }\n      nextCursor\n      hasMore\n    }\n  }\n";
+export interface RunsResult {
+    workflowRuns: {
+        runs: WorkflowRunSummary[];
+        nextCursor: string | null;
+        hasMore: boolean;
+    };
+}
+export declare const RUN = "\n  query SdkWorkflowRun($alias: String!, $runID: ID!) {\n    workflowRun(alias: $alias, runID: $runID) {\n      run { runID workflowName displayName module status deploymentID createdAt startedAt completedAt\n      updatedAt expiredAt errorCode attributes { key value } }\n      input { text bytes truncated error }\n      output { text bytes truncated error }\n      error { message stack code truncated }\n      steps { stepID stepName displayName module status attempt createdAt startedAt completedAt updatedAt retryAfter }\n      stepsNextCursor\n      stepsHasMore\n      waits { correlationID status createdAt resumeAt completedAt }\n      waitsTruncated\n      hooks { hookID kind status createdAt receivedCount lastReceivedAt disposedAt }\n      hooksTruncated\n      streams { name tailIndex done }\n      eventsScanned\n      eventsComplete\n    }\n  }\n";
+export interface RunResult {
+    workflowRun: WorkflowRunPage;
+}
+export declare const STEPS = "\n  query SdkWorkflowSteps($alias: String!, $runID: ID!, $limit: Int, $cursor: String) {\n    workflowSteps(alias: $alias, runID: $runID, limit: $limit, cursor: $cursor) {\n      steps { stepID stepName displayName module status attempt createdAt startedAt completedAt updatedAt retryAfter }\n      nextCursor\n      hasMore\n    }\n  }\n";
+export interface StepsResult {
+    workflowSteps: {
+        steps: WorkflowStep[];
+        nextCursor: string | null;
+        hasMore: boolean;
+    };
+}
+export declare const STEP_DETAIL = "\n  query SdkWorkflowStep($alias: String!, $runID: ID!, $stepID: ID!) {\n    workflowStep(alias: $alias, runID: $runID, stepID: $stepID) {\n      step { stepID stepName displayName module status attempt createdAt startedAt completedAt updatedAt retryAfter }\n      input { text bytes truncated error }\n      output { text bytes truncated error }\n      error { message stack code truncated }\n    }\n  }\n";
+export interface StepResult {
+    workflowStep: {
+        step: WorkflowStep;
+        input: WorkflowValue | null;
+        output: WorkflowValue | null;
+        error: WorkflowError | null;
+    };
+}
+export declare const EVENTS = "\n  query SdkWorkflowEvents(\n    $alias: String!\n    $runID: ID!\n    $correlationID: String\n    $newestFirst: Boolean\n    $limit: Int\n    $cursor: String\n  ) {\n    workflowEvents(\n      alias: $alias\n      runID: $runID\n      correlationID: $correlationID\n      newestFirst: $newestFirst\n      limit: $limit\n      cursor: $cursor\n    ) {\n      events { eventID eventType correlationID createdAt info infoTruncated }\n      nextCursor\n      hasMore\n    }\n  }\n";
+export interface EventsResult {
+    workflowEvents: {
+        events: WorkflowEvent[];
+        nextCursor: string | null;
+        hasMore: boolean;
+    };
+}
+export declare const EVENT_DETAIL = "\n  query SdkWorkflowEvent($alias: String!, $runID: ID!, $eventID: ID!) {\n    workflowEvent(alias: $alias, runID: $runID, eventID: $eventID) {\n      event { eventID eventType correlationID createdAt info infoTruncated }\n      data { text bytes truncated error }\n    }\n  }\n";
+export interface EventResult {
+    workflowEvent: {
+        event: WorkflowEvent;
+        data: WorkflowValue | null;
+    };
+}
+export declare const STREAM = "\n  query SdkWorkflowStream($alias: String!, $runID: ID!, $name: String!, $limit: Int, $cursor: String) {\n    workflowStream(alias: $alias, runID: $runID, name: $name, limit: $limit, cursor: $cursor) {\n      name\n      chunks { index bytes encoding text truncated }\n      nextCursor\n      hasMore\n      done\n      tailIndex\n    }\n  }\n";
+export interface StreamResult {
+    workflowStream: {
+        name: string;
+        chunks: WorkflowStreamChunk[];
+        nextCursor: string | null;
+        hasMore: boolean;
+        done: boolean;
+        tailIndex: number;
+    };
+}
+export declare const CANCEL = "\n  mutation SdkCancelWorkflowRun($input: CancelWorkflowRunInput!) {\n    cancelWorkflowRun(input: $input) {\n      runID\n      status\n    }\n  }\n";
+export interface CancelResult {
+    cancelWorkflowRun: {
+        runID: string;
+        status: WorkflowRunStatus;
+    };
+}
+export declare const WAKE = "\n  mutation SdkWakeWorkflowRun($input: WakeWorkflowRunInput!) {\n    wakeWorkflowRun(input: $input) {\n      stoppedCount\n    }\n  }\n";
+export interface WakeResult {
+    wakeWorkflowRun: {
+        stoppedCount: number;
+    };
+}

package/dist/remote/documents.js

@@ -0,0 +1,122 @@
+/**
+ * The GraphQL documents the `unfazed` CLI backend sends: the platform's
+ * workflow inspection API (unfazed docs/workflow-inspect.md, "GraphQL").
+ *
+ * Written by hand rather than through codegen because the vendored schema
+ * predates these fields; `test/remote/documents.test.ts` validates every
+ * document against a copy of the inspection schema, so a misspelt field fails
+ * there instead of on the platform.
+ */
+const VALUE = "text bytes truncated error";
+const ERROR = "message stack code truncated";
+const RUN_SUMMARY = `runID workflowName displayName module status deploymentID createdAt startedAt completedAt
+      updatedAt expiredAt errorCode attributes { key value }`;
+const STEP = "stepID stepName displayName module status attempt createdAt startedAt completedAt updatedAt retryAfter";
+const EVENT = "eventID eventType correlationID createdAt info infoTruncated";
+export const RUNS = `
+  query SdkWorkflowRuns($alias: String!, $status: [WorkflowRunStatus!], $workflowName: String, $limit: Int, $cursor: String) {
+    workflowRuns(alias: $alias, status: $status, workflowName: $workflowName, limit: $limit, cursor: $cursor) {
+      runs { ${RUN_SUMMARY} }
+      nextCursor
+      hasMore
+    }
+  }
+`;
+export const RUN = `
+  query SdkWorkflowRun($alias: String!, $runID: ID!) {
+    workflowRun(alias: $alias, runID: $runID) {
+      run { ${RUN_SUMMARY} }
+      input { ${VALUE} }
+      output { ${VALUE} }
+      error { ${ERROR} }
+      steps { ${STEP} }
+      stepsNextCursor
+      stepsHasMore
+      waits { correlationID status createdAt resumeAt completedAt }
+      waitsTruncated
+      hooks { hookID kind status createdAt receivedCount lastReceivedAt disposedAt }
+      hooksTruncated
+      streams { name tailIndex done }
+      eventsScanned
+      eventsComplete
+    }
+  }
+`;
+export const STEPS = `
+  query SdkWorkflowSteps($alias: String!, $runID: ID!, $limit: Int, $cursor: String) {
+    workflowSteps(alias: $alias, runID: $runID, limit: $limit, cursor: $cursor) {
+      steps { ${STEP} }
+      nextCursor
+      hasMore
+    }
+  }
+`;
+export const STEP_DETAIL = `
+  query SdkWorkflowStep($alias: String!, $runID: ID!, $stepID: ID!) {
+    workflowStep(alias: $alias, runID: $runID, stepID: $stepID) {
+      step { ${STEP} }
+      input { ${VALUE} }
+      output { ${VALUE} }
+      error { ${ERROR} }
+    }
+  }
+`;
+export const EVENTS = `
+  query SdkWorkflowEvents(
+    $alias: String!
+    $runID: ID!
+    $correlationID: String
+    $newestFirst: Boolean
+    $limit: Int
+    $cursor: String
+  ) {
+    workflowEvents(
+      alias: $alias
+      runID: $runID
+      correlationID: $correlationID
+      newestFirst: $newestFirst
+      limit: $limit
+      cursor: $cursor
+    ) {
+      events { ${EVENT} }
+      nextCursor
+      hasMore
+    }
+  }
+`;
+export const EVENT_DETAIL = `
+  query SdkWorkflowEvent($alias: String!, $runID: ID!, $eventID: ID!) {
+    workflowEvent(alias: $alias, runID: $runID, eventID: $eventID) {
+      event { ${EVENT} }
+      data { ${VALUE} }
+    }
+  }
+`;
+export const STREAM = `
+  query SdkWorkflowStream($alias: String!, $runID: ID!, $name: String!, $limit: Int, $cursor: String) {
+    workflowStream(alias: $alias, runID: $runID, name: $name, limit: $limit, cursor: $cursor) {
+      name
+      chunks { index bytes encoding text truncated }
+      nextCursor
+      hasMore
+      done
+      tailIndex
+    }
+  }
+`;
+export const CANCEL = `
+  mutation SdkCancelWorkflowRun($input: CancelWorkflowRunInput!) {
+    cancelWorkflowRun(input: $input) {
+      runID
+      status
+    }
+  }
+`;
+export const WAKE = `
+  mutation SdkWakeWorkflowRun($input: WakeWorkflowRunInput!) {
+    wakeWorkflowRun(input: $input) {
+      stoppedCount
+    }
+  }
+`;
+//# sourceMappingURL=documents.js.map

package/dist/remote/documents.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"documents.js","sourceRoot":"","sources":["../../src/remote/documents.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AA4GH,MAAM,KAAK,GAAG,4BAA4B,CAAC;AAC3C,MAAM,KAAK,GAAG,8BAA8B,CAAC;AAC7C,MAAM,WAAW,GAAG;6DACyC,CAAC;AAC9D,MAAM,IAAI,GAAG,wGAAwG,CAAC;AACtH,MAAM,KAAK,GAAG,8DAA8D,CAAC;AAE7E,MAAM,CAAC,MAAM,IAAI,GAAG;;;eAGL,WAAW;;;;;CAKzB,CAAC;AAKF,MAAM,CAAC,MAAM,GAAG,GAAG;;;cAGL,WAAW;gBACT,KAAK;iBACJ,KAAK;gBACN,KAAK;gBACL,IAAI;;;;;;;;;;;;CAYnB,CAAC;AAKF,MAAM,CAAC,MAAM,KAAK,GAAG;;;gBAGL,IAAI;;;;;CAKnB,CAAC;AAKF,MAAM,CAAC,MAAM,WAAW,GAAG;;;eAGZ,IAAI;gBACH,KAAK;iBACJ,KAAK;gBACN,KAAK;;;CAGpB,CAAC;AAUF,MAAM,CAAC,MAAM,MAAM,GAAG;;;;;;;;;;;;;;;;;iBAiBL,KAAK;;;;;CAKrB,CAAC;AAKF,MAAM,CAAC,MAAM,YAAY,GAAG;;;gBAGZ,KAAK;eACN,KAAK;;;CAGnB,CAAC;AAKF,MAAM,CAAC,MAAM,MAAM,GAAG;;;;;;;;;;;CAWrB,CAAC;AAYF,MAAM,CAAC,MAAM,MAAM,GAAG;;;;;;;CAOrB,CAAC;AAKF,MAAM,CAAC,MAAM,IAAI,GAAG;;;;;;CAMnB,CAAC","sourcesContent":["/**\n * The GraphQL documents the `unfazed` CLI backend sends: the platform's\n * workflow inspection API (unfazed docs/workflow-inspect.md, \"GraphQL\").\n *\n * Written by hand rather than through codegen because the vendored schema\n * predates these fields; `test/remote/documents.test.ts` validates every\n * document against a copy of the inspection schema, so a misspelt field fails\n * there instead of on the platform.\n */\n\n/** `WorkflowValue`: a payload as display text, cut at the route's cap. */\nexport interface WorkflowValue {\n  text: string;\n  bytes: number;\n  truncated: boolean;\n  error: boolean;\n}\n\n/** `WorkflowError`: a thrown run or step error. */\nexport interface WorkflowError {\n  message: string;\n  stack: string | null;\n  code: string | null;\n  truncated: boolean;\n}\n\nexport type WorkflowRunStatus = \"PENDING\" | \"RUNNING\" | \"COMPLETED\" | \"FAILED\" | \"CANCELLED\";\n\nexport interface WorkflowRunSummary {\n  runID: string;\n  workflowName: string;\n  displayName: string;\n  module: string;\n  status: WorkflowRunStatus;\n  deploymentID: string;\n  createdAt: string;\n  startedAt: string | null;\n  completedAt: string | null;\n  updatedAt: string;\n  expiredAt: string | null;\n  errorCode: string | null;\n  attributes: { key: string; value: string }[];\n}\n\nexport interface WorkflowStep {\n  stepID: string;\n  stepName: string;\n  displayName: string;\n  module: string;\n  status: string;\n  attempt: number;\n  createdAt: string;\n  startedAt: string | null;\n  completedAt: string | null;\n  updatedAt: string;\n  retryAfter: string | null;\n}\n\nexport interface WorkflowEvent {\n  eventID: string;\n  eventType: string;\n  correlationID: string | null;\n  createdAt: string;\n  info: Record<string, unknown>;\n  infoTruncated: boolean;\n}\n\nexport interface WorkflowWait {\n  correlationID: string;\n  status: string;\n  createdAt: string;\n  resumeAt: string | null;\n  completedAt: string | null;\n}\n\nexport interface WorkflowHook {\n  hookID: string;\n  kind: string;\n  status: string;\n  createdAt: string;\n  receivedCount: number;\n  lastReceivedAt: string | null;\n  disposedAt: string | null;\n}\n\nexport interface WorkflowStreamInfo {\n  name: string;\n  tailIndex: number | null;\n  done: boolean | null;\n}\n\nexport interface WorkflowStreamChunk {\n  index: number;\n  bytes: number;\n  encoding: string;\n  text: string;\n  truncated: boolean;\n}\n\nexport interface WorkflowRunPage {\n  run: WorkflowRunSummary;\n  input: WorkflowValue | null;\n  output: WorkflowValue | null;\n  error: WorkflowError | null;\n  steps: WorkflowStep[];\n  stepsNextCursor: string | null;\n  stepsHasMore: boolean;\n  waits: WorkflowWait[];\n  waitsTruncated: boolean;\n  hooks: WorkflowHook[];\n  hooksTruncated: boolean;\n  streams: WorkflowStreamInfo[];\n  eventsScanned: number;\n  eventsComplete: boolean;\n}\n\nconst VALUE = \"text bytes truncated error\";\nconst ERROR = \"message stack code truncated\";\nconst RUN_SUMMARY = `runID workflowName displayName module status deploymentID createdAt startedAt completedAt\n      updatedAt expiredAt errorCode attributes { key value }`;\nconst STEP = \"stepID stepName displayName module status attempt createdAt startedAt completedAt updatedAt retryAfter\";\nconst EVENT = \"eventID eventType correlationID createdAt info infoTruncated\";\n\nexport const RUNS = `\n  query SdkWorkflowRuns($alias: String!, $status: [WorkflowRunStatus!], $workflowName: String, $limit: Int, $cursor: String) {\n    workflowRuns(alias: $alias, status: $status, workflowName: $workflowName, limit: $limit, cursor: $cursor) {\n      runs { ${RUN_SUMMARY} }\n      nextCursor\n      hasMore\n    }\n  }\n`;\nexport interface RunsResult {\n  workflowRuns: { runs: WorkflowRunSummary[]; nextCursor: string | null; hasMore: boolean };\n}\n\nexport const RUN = `\n  query SdkWorkflowRun($alias: String!, $runID: ID!) {\n    workflowRun(alias: $alias, runID: $runID) {\n      run { ${RUN_SUMMARY} }\n      input { ${VALUE} }\n      output { ${VALUE} }\n      error { ${ERROR} }\n      steps { ${STEP} }\n      stepsNextCursor\n      stepsHasMore\n      waits { correlationID status createdAt resumeAt completedAt }\n      waitsTruncated\n      hooks { hookID kind status createdAt receivedCount lastReceivedAt disposedAt }\n      hooksTruncated\n      streams { name tailIndex done }\n      eventsScanned\n      eventsComplete\n    }\n  }\n`;\nexport interface RunResult {\n  workflowRun: WorkflowRunPage;\n}\n\nexport const STEPS = `\n  query SdkWorkflowSteps($alias: String!, $runID: ID!, $limit: Int, $cursor: String) {\n    workflowSteps(alias: $alias, runID: $runID, limit: $limit, cursor: $cursor) {\n      steps { ${STEP} }\n      nextCursor\n      hasMore\n    }\n  }\n`;\nexport interface StepsResult {\n  workflowSteps: { steps: WorkflowStep[]; nextCursor: string | null; hasMore: boolean };\n}\n\nexport const STEP_DETAIL = `\n  query SdkWorkflowStep($alias: String!, $runID: ID!, $stepID: ID!) {\n    workflowStep(alias: $alias, runID: $runID, stepID: $stepID) {\n      step { ${STEP} }\n      input { ${VALUE} }\n      output { ${VALUE} }\n      error { ${ERROR} }\n    }\n  }\n`;\nexport interface StepResult {\n  workflowStep: {\n    step: WorkflowStep;\n    input: WorkflowValue | null;\n    output: WorkflowValue | null;\n    error: WorkflowError | null;\n  };\n}\n\nexport const EVENTS = `\n  query SdkWorkflowEvents(\n    $alias: String!\n    $runID: ID!\n    $correlationID: String\n    $newestFirst: Boolean\n    $limit: Int\n    $cursor: String\n  ) {\n    workflowEvents(\n      alias: $alias\n      runID: $runID\n      correlationID: $correlationID\n      newestFirst: $newestFirst\n      limit: $limit\n      cursor: $cursor\n    ) {\n      events { ${EVENT} }\n      nextCursor\n      hasMore\n    }\n  }\n`;\nexport interface EventsResult {\n  workflowEvents: { events: WorkflowEvent[]; nextCursor: string | null; hasMore: boolean };\n}\n\nexport const EVENT_DETAIL = `\n  query SdkWorkflowEvent($alias: String!, $runID: ID!, $eventID: ID!) {\n    workflowEvent(alias: $alias, runID: $runID, eventID: $eventID) {\n      event { ${EVENT} }\n      data { ${VALUE} }\n    }\n  }\n`;\nexport interface EventResult {\n  workflowEvent: { event: WorkflowEvent; data: WorkflowValue | null };\n}\n\nexport const STREAM = `\n  query SdkWorkflowStream($alias: String!, $runID: ID!, $name: String!, $limit: Int, $cursor: String) {\n    workflowStream(alias: $alias, runID: $runID, name: $name, limit: $limit, cursor: $cursor) {\n      name\n      chunks { index bytes encoding text truncated }\n      nextCursor\n      hasMore\n      done\n      tailIndex\n    }\n  }\n`;\nexport interface StreamResult {\n  workflowStream: {\n    name: string;\n    chunks: WorkflowStreamChunk[];\n    nextCursor: string | null;\n    hasMore: boolean;\n    done: boolean;\n    tailIndex: number;\n  };\n}\n\nexport const CANCEL = `\n  mutation SdkCancelWorkflowRun($input: CancelWorkflowRunInput!) {\n    cancelWorkflowRun(input: $input) {\n      runID\n      status\n    }\n  }\n`;\nexport interface CancelResult {\n  cancelWorkflowRun: { runID: string; status: WorkflowRunStatus };\n}\n\nexport const WAKE = `\n  mutation SdkWakeWorkflowRun($input: WakeWorkflowRunInput!) {\n    wakeWorkflowRun(input: $input) {\n      stoppedCount\n    }\n  }\n`;\nexport interface WakeResult {\n  wakeWorkflowRun: { stoppedCount: number };\n}\n"]}

package/dist/remote/values.d.ts

@@ -0,0 +1,67 @@
+/**
+ * How the `unfazed` CLI backend turns the inspection API's display data back
+ * into what Workflow SDK's tooling reads from a World.
+ *
+ * The app's inspection route hydrates every payload inside the app and sends
+ * it as display text (`JSON.stringify` of the hydrated value, cut at the
+ * route's caps). The CLI and the web UI expect a World to hand them serialized
+ * data, which they hydrate themselves: a `Uint8Array` with a 4-byte format
+ * prefix, `devl` followed by devalue text. So each value is parsed back from
+ * its display text and re-encoded as `devl` + devalue, which every Workflow
+ * SDK reader hydrates to the same plain value. A value that was cut, or that
+ * the app could not hydrate, becomes a string that says so.
+ *
+ * Pure functions, no dependencies.
+ */
+import type { WorkflowError, WorkflowStreamChunk, WorkflowValue } from "./documents.js";
+/**
+ * devalue's `stringify` for the values JSON can hold (what `JSON.parse`
+ * returns, plus `undefined`): a flat array whose first entry is the root,
+ * where an object or array refers to its members by index. Strings,
+ * numbers, booleans and `null` sit in the array as themselves, so the
+ * encoding never produces devalue's typed tuples (`["Date", …]`), and every
+ * reviver set reads it the same way.
+ */
+export declare function devalueStringify(value: unknown): string;
+/** `value` as Workflow SDK serialized data: `devl` + devalue text. */
+export declare function serialize(value: unknown): Uint8Array;
+/**
+ * One stream frame as Workflow SDK's stream writer writes it: a 4-byte
+ * big-endian length, then the serialized value. `getDeserializeStream()`
+ * (what `workflow inspect stream` and the web UI read streams with) turns
+ * each frame back into the value.
+ */
+export declare function frame(value: unknown): Uint8Array;
+/** What a payload cut at the inspection route's cap ends with. */
+export declare function truncationNote(bytes: number): string;
+/** What a payload the app could not hydrate reads as. */
+export declare function unreadable(reason: string): string;
+/**
+ * The value behind a `WorkflowValue`: its display JSON parsed back, a string
+ * marked as cut when the route cut it (the cut text is not valid JSON), or a
+ * string with the reason when the app could not hydrate it.
+ */
+export declare function displayValue(value: WorkflowValue): unknown;
+/** A `WorkflowValue` as serialized data, or `undefined` for an absent payload. */
+export declare function serializedValue(value: WorkflowValue | null | undefined): Uint8Array | undefined;
+/** A run or step error as Workflow SDK's `StructuredError`. */
+export declare function structuredError(error: WorkflowError): {
+    message: string;
+    stack?: string;
+    code?: string;
+};
+/**
+ * The value of one stream chunk: `json` chunks (what `getWritable()` writes)
+ * parsed back, `utf8` chunks as their text, `base64` chunks (bytes that are
+ * not UTF-8) as `{ $bytes, base64 }`, the route's display form for bytes.
+ */
+export declare function chunkValue(chunk: WorkflowStreamChunk): unknown;
+/** An RFC 3339 time as a `Date`, or `undefined`. */
+export declare function toDate(value: string | null | undefined): Date | undefined;
+/** An event's `info` as `eventData`, its date fields as `Date`s. */
+export declare function eventData(info: Record<string, unknown> | null | undefined): Record<string, unknown>;
+/**
+ * The payload field of each event type, as `getEventDataRefFields()` in
+ * `@workflow/world` lists them: where `events.get` puts the event's data.
+ */
+export declare const EVENT_PAYLOAD_FIELDS: Readonly<Record<string, string>>;