@hotmeshio/long-tail 0.16.1 → 0.16.4

package/build/api/exports.d.ts

@@ -77,6 +77,21 @@ export declare function exportWorkflowExecution(input: {
 export declare function getWorkflowStatus(input: {
     workflowId: string;
 }): Promise<LTApiResult>;
+/**
+ * Get a workflow's input and output envelopes — the effortless read.
+ *
+ * Two narrow lookups (no event stream, no full export): the input is
+ * available for the life of the job; the output is null with
+ * `status: 'running'` until the workflow completes, making this the natural
+ * polling body. A failed run answers `status: 'failed'` with the workflow's
+ * error message.
+ *
+ * @param input.workflowId — the workflow's unique identifier
+ * @returns `{ status: 200, data: { workflow_id, status, input, output, error? } }`
+ */
+export declare function getWorkflowEnvelopes(input: {
+    workflowId: string;
+}): Promise<LTApiResult>;
 /**
  * Get the current state data of a workflow.
  *

package/build/api/exports.js

@@ -37,6 +37,7 @@ exports.listJobs = listJobs;
 exports.exportWorkflowState = exportWorkflowState;
 exports.exportWorkflowExecution = exportWorkflowExecution;
 exports.getWorkflowStatus = getWorkflowStatus;
+exports.getWorkflowEnvelopes = getWorkflowEnvelopes;
 exports.getWorkflowState = getWorkflowState;
 const exportService = __importStar(require("../services/export"));
 const resolve_1 = require("../services/task/resolve");
@@ -171,6 +172,40 @@ async function getWorkflowStatus(input) {
         };
     }
 }
+/**
+ * Get a workflow's input and output envelopes — the effortless read.
+ *
+ * Two narrow lookups (no event stream, no full export): the input is
+ * available for the life of the job; the output is null with
+ * `status: 'running'` until the workflow completes, making this the natural
+ * polling body. A failed run answers `status: 'failed'` with the workflow's
+ * error message.
+ *
+ * @param input.workflowId — the workflow's unique identifier
+ * @returns `{ status: 200, data: { workflow_id, status, input, output, error? } }`
+ */
+async function getWorkflowEnvelopes(input) {
+    try {
+        let resolved;
+        try {
+            resolved = await (0, resolve_1.resolveWorkflowHandle)(input.workflowId);
+        }
+        catch {
+            return { status: 404, error: 'Workflow not found' };
+        }
+        const result = await exportService.getWorkflowEnvelopes(input.workflowId, resolved.taskQueue, resolved.workflowName);
+        return { status: 200, data: result };
+    }
+    catch (err) {
+        const status = err.status === 404 || err.message?.includes('Not Found') ? 404 : 500;
+        return {
+            status,
+            error: status === 404
+                ? 'Workflow data is no longer available (job may have expired)'
+                : err.message,
+        };
+    }
+}
 /**
  * Get the current state data of a workflow.
  *

package/build/bin/ltc.js

@@ -259,6 +259,10 @@ wfCmd.command('status <id>')
 wfCmd.command('result <id>')
     .option('--json', 'JSON output')
     .action(wrap(wf.getWorkflowResult));
+wfCmd.command('envelopes <id>')
+    .description('The workflow\'s input and output envelopes — light, never blocks')
+    .option('--json', 'JSON output')
+    .action(wrap(wf.getWorkflowEnvelopes));
 wfCmd.command('terminate <id>')
     .action(wrap(wf.terminateWorkflow));
 // ── Pipelines (YAML Workflows) ──────────────────────────────────────────

package/build/lib/cli/commands/workflows.d.ts

@@ -13,4 +13,7 @@ export declare function getWorkflowStatus(id: string, opts: {
 export declare function getWorkflowResult(id: string, opts: {
     json?: boolean;
 }): Promise<void>;
+export declare function getWorkflowEnvelopes(id: string, opts: {
+    json?: boolean;
+}): Promise<void>;
 export declare function terminateWorkflow(id: string): Promise<void>;

package/build/lib/cli/commands/workflows.js

@@ -40,6 +40,7 @@ exports.listWorkflows = listWorkflows;
 exports.invokeWorkflow = invokeWorkflow;
 exports.getWorkflowStatus = getWorkflowStatus;
 exports.getWorkflowResult = getWorkflowResult;
+exports.getWorkflowEnvelopes = getWorkflowEnvelopes;
 exports.terminateWorkflow = terminateWorkflow;
 const picocolors_1 = __importDefault(require("picocolors"));
 const client_1 = require("../client");
@@ -98,6 +99,27 @@ async function getWorkflowResult(id, opts) {
         console.log();
     }
 }
+async function getWorkflowEnvelopes(id, opts) {
+    const data = await (0, client_1.apiFetch)(`/workflow-states/${id}/envelopes`);
+    if (opts.json) {
+        console.log(JSON.stringify(data, null, 2));
+        return;
+    }
+    const status = data.status === 'completed' ? picocolors_1.default.green(data.status)
+        : data.status === 'failed' ? picocolors_1.default.red(data.status)
+            : picocolors_1.default.blue(data.status);
+    console.log(`\n  ${picocolors_1.default.dim(data.workflow_id)}  ${status}`);
+    console.log(`\n  ${picocolors_1.default.bold('Input')}`);
+    console.log(JSON.stringify(data.input, null, 2));
+    console.log(`\n  ${picocolors_1.default.bold('Output')}`);
+    if (data.error) {
+        console.log(picocolors_1.default.red(data.error));
+    }
+    else {
+        console.log(data.output === null ? picocolors_1.default.dim('(not yet — still running)') : JSON.stringify(data.output, null, 2));
+    }
+    console.log();
+}
 async function terminateWorkflow(id) {
     await (0, client_1.apiFetch)(`/workflows/terminate/${id}`, { method: 'POST' });
     console.log(`\n  ${picocolors_1.default.green('✓')} Terminated ${picocolors_1.default.dim(id)}\n`);

package/build/routes/exports.js

@@ -95,6 +95,17 @@ router.get('/:workflowId/execution', async (req, res) => {
     });
     res.status(result.status).json(result.data ?? { error: result.error });
 });
+/**
+ * GET /api/workflow-states/:workflowId/envelopes
+ * The workflow's input and output envelopes — two narrow lookups, no event
+ * stream. Output is null with status 'running' until the workflow completes.
+ */
+router.get('/:workflowId/envelopes', async (req, res) => {
+    const result = await api.getWorkflowEnvelopes({
+        workflowId: req.params.workflowId,
+    });
+    res.status(result.status).json(result.data ?? { error: result.error });
+});
 /**
  * GET /api/workflow-states/:workflowId/status
  * Return only the numeric status semaphore.

package/build/sdk/index.d.ts

@@ -247,6 +247,7 @@ export declare function createClient(options?: LTClientOptions): {
             options?: Record<string, any>;
         }, auth?: LTApiAuth) => Promise<LTApiResult<any>>;
         getStatus: typeof workflowsApi.getWorkflowStatus;
+        getEnvelopes: typeof exportsApi.getWorkflowEnvelopes;
         getResult: typeof workflowsApi.getWorkflowResult;
         terminate: typeof workflowsApi.terminateWorkflow;
         export: typeof workflowsApi.exportWorkflow;

package/build/sdk/index.js

@@ -155,6 +155,7 @@ function createClient(options = {}) {
         workflows: {
             invoke: bindAuth(workflowsApi.invokeWorkflow, auth),
             getStatus: workflowsApi.getWorkflowStatus,
+            getEnvelopes: exportsApi.getWorkflowEnvelopes,
             getResult: workflowsApi.getWorkflowResult,
             terminate: workflowsApi.terminateWorkflow,
             export: workflowsApi.exportWorkflow,

package/build/services/export/index.d.ts

@@ -24,6 +24,25 @@ export declare function getWorkflowStatus(workflowId: string, taskQueue: string,
  * system/user classification, and a summary.
  */
 export declare function exportWorkflowExecution(workflowId: string, taskQueue: string, workflowName: string, options?: ExecutionExportOptions): Promise<WorkflowExecution>;
+/** The input/output envelope pair plus the derived run status. */
+export interface WorkflowEnvelopes {
+    workflow_id: string;
+    status: 'running' | 'completed' | 'failed';
+    /** The workflow's input — the single LTEnvelope for one-arg workflows, else the args array. */
+    input: unknown;
+    /** The workflow's return envelope, or null while it is still running or when it failed. */
+    output: unknown;
+    /** The workflow's error message, present only when status is 'failed'. */
+    error?: string;
+}
+/**
+ * The effortless read: what went in, what came out. Two narrow lookups —
+ * `handle.input()` (one field read, available for the life of the job) and
+ * `handle.output()` (one state read, never blocks) — no event stream, no
+ * full export. While the workflow runs, `output` is null and `status` says
+ * so, making this the natural polling body.
+ */
+export declare function getWorkflowEnvelopes(workflowId: string, taskQueue: string, workflowName: string): Promise<WorkflowEnvelopes>;
 /**
  * Return the current job state of a workflow.
  * If the workflow is complete this is also the output.

package/build/services/export/index.js

@@ -3,6 +3,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.exportWorkflow = exportWorkflow;
 exports.getWorkflowStatus = getWorkflowStatus;
 exports.exportWorkflowExecution = exportWorkflowExecution;
+exports.getWorkflowEnvelopes = getWorkflowEnvelopes;
 exports.getWorkflowState = getWorkflowState;
 exports.listJobs = listJobs;
 const db_1 = require("../../lib/db");
@@ -66,21 +67,14 @@ async function getWorkflowStatus(workflowId, taskQueue, workflowName) {
 async function exportWorkflowExecution(workflowId, taskQueue, workflowName, options) {
     try {
         const handle = await (0, client_1.getHandle)(taskQueue, workflowName, workflowId);
-        const [execution, raw] = await Promise.all([
-            handle.exportExecution({ ...options, enrich_inputs: true }),
-            handle.export({ allow: ['state'], values: true }),
-        ]);
-        const processed = (0, post_process_1.postProcessExecution)(execution);
-        // Extract parent_workflow_id from the raw state metadata (HotMesh's `pj` field).
-        // The SDK's WorkflowExecution doesn't surface this yet; when it does,
-        // the SDK value takes precedence (defensive: only set if absent).
-        if (!processed.parent_workflow_id) {
-            const pj = extractParentJobId(raw);
-            if (pj && pj !== workflowId) {
-                processed.parent_workflow_id = pj;
-            }
-        }
-        return processed;
+        // include_lineage populates parent_workflow_id/origin_id from the jobs
+        // table in one indexed lookup — no second export call.
+        const execution = await handle.exportExecution({
+            ...options,
+            enrich_inputs: true,
+            include_lineage: true,
+        });
+        return (0, post_process_1.postProcessExecution)(execution);
     }
     catch (err) {
         if (err instanceof WorkflowNotFoundError)
@@ -89,25 +83,51 @@ async function exportWorkflowExecution(workflowId, taskQueue, workflowName, opti
     }
 }
 /**
- * Walk the raw export state looking for the `pj` (parent job ID) field.
- * HotMesh stores it at `state.output.metadata.pj` after symbol inflation.
- * Returns undefined if not found (workflow has no parent).
+ * The effortless read: what went in, what came out. Two narrow lookups —
+ * `handle.input()` (one field read, available for the life of the job) and
+ * `handle.output()` (one state read, never blocks) — no event stream, no
+ * full export. While the workflow runs, `output` is null and `status` says
+ * so, making this the natural polling body.
  */
-function extractParentJobId(raw) {
-    const state = raw?.state;
-    if (!state || typeof state !== 'object')
-        return undefined;
-    // Typical path: state.output.metadata.pj
-    const output = state.output ?? state;
-    const metadata = output?.metadata;
-    if (metadata?.pj && typeof metadata.pj === 'string') {
-        return metadata.pj;
-    }
-    // Fallback: walk top-level state keys (older export shapes)
-    if (state.pj && typeof state.pj === 'string') {
-        return state.pj;
-    }
-    return undefined;
+async function getWorkflowEnvelopes(workflowId, taskQueue, workflowName) {
+    let handle;
+    try {
+        handle = await (0, client_1.getHandle)(taskQueue, workflowName, workflowId);
+    }
+    catch {
+        throw new WorkflowNotFoundError(workflowId);
+    }
+    const [statusCode, args] = await Promise.all([
+        handle.status(),
+        handle.input().catch(() => undefined),
+    ]).catch(() => {
+        throw new WorkflowNotFoundError(workflowId);
+    });
+    // Long-tail workflows take a single LTEnvelope argument — unwrap it;
+    // multi-arg workflows keep the args array verbatim.
+    const input = Array.isArray(args) && args.length === 1 ? args[0] : args ?? null;
+    if (statusCode > 0) {
+        return { workflow_id: workflowId, status: 'running', input, output: null };
+    }
+    try {
+        const output = await handle.output();
+        return {
+            workflow_id: workflowId,
+            status: statusCode === 0 ? 'completed' : 'failed',
+            input,
+            output: output ?? null,
+        };
+    }
+    catch (err) {
+        // output() throws the workflow's own error for failed runs — that IS the outcome.
+        return {
+            workflow_id: workflowId,
+            status: 'failed',
+            input,
+            output: null,
+            error: err?.message ?? String(err),
+        };
+    }
 }
 /**
  * Return the current job state of a workflow.

package/build/shared/form-validation/field-validator.d.ts

@@ -8,13 +8,27 @@ interface ChecklistItem {
     required?: boolean;
 }
 /**
- * Resolve a checklist widget's item definitions from its `x-lt-source`
- * "domain.path" against the escalation context. Paths may embed
- * `{{domain.path}}` interpolation segments (cascading sources). Missing
- * domain/path, an unresolved segment, or a non-array value yields an empty
- * list.
+ * Resolve a checklist widget's item definitions from its `x-lt-source` —
+ * a "domain.path" or an ORDERED array of paths — against the escalation
+ * context. With an array, the first entry that resolves to a non-empty item
+ * list wins, so lookup-backed and envelope-embedded rows render the same
+ * shared schema interchangeably. Paths may embed `{{domain.path}}`
+ * interpolation segments (cascading sources); an entry that cannot resolve
+ * falls through to the next. Nothing resolvable yields an empty list.
  */
-export declare function resolveChecklistItems(sourcePath: unknown, ctx: Record<string, unknown> | undefined): ChecklistItem[];
+export declare function resolveChecklistItems(source: unknown, ctx: Record<string, unknown> | undefined): ChecklistItem[];
+export declare const X_LT_DEFAULT_CHECKED = "x-lt-default-checked";
+/**
+ * The checklist's first-load default (`x-lt-default-checked`): every resolved
+ * item starts checked, for affirm-then-exception flows where the submitter
+ * unchecks what failed. Returns the all-checked answer map ONLY when the
+ * field carries no answer yet — a saved or drafted map (any key, even
+ * all-false) is never clobbered — and null otherwise: absent flag, existing
+ * answer, or a source that resolves to no items. Declared on the widget
+ * because the item set is runtime-sourced (envelope or lookup): a pure
+ * escalation-minting step cannot enumerate the ids to seed formDefaults.
+ */
+export declare function resolveChecklistDefault(fieldSchema: Record<string, unknown> | null | undefined, currentValue: unknown, ctx?: Record<string, unknown>): Record<string, boolean> | null;
 /**
  * The checklist completion guard (`x-lt-require-all`): every rendered item must
  * be checked, except items whose definition carries `required: false` (the

package/build/shared/form-validation/field-validator.js

@@ -1,6 +1,8 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.X_LT_DEFAULT_CHECKED = void 0;
 exports.resolveChecklistItems = resolveChecklistItems;
+exports.resolveChecklistDefault = resolveChecklistDefault;
 exports.validateRequireAll = validateRequireAll;
 exports.validateFieldType = validateFieldType;
 exports.validateFieldConstraints = validateFieldConstraints;
@@ -8,24 +10,57 @@ exports.validateField = validateField;
 const x_lt_options_1 = require("./x-lt-options");
 const ctx_path_1 = require("./ctx-path");
 /**
- * Resolve a checklist widget's item definitions from its `x-lt-source`
- * "domain.path" against the escalation context. Paths may embed
- * `{{domain.path}}` interpolation segments (cascading sources). Missing
- * domain/path, an unresolved segment, or a non-array value yields an empty
- * list.
+ * Resolve a checklist widget's item definitions from its `x-lt-source` —
+ * a "domain.path" or an ORDERED array of paths — against the escalation
+ * context. With an array, the first entry that resolves to a non-empty item
+ * list wins, so lookup-backed and envelope-embedded rows render the same
+ * shared schema interchangeably. Paths may embed `{{domain.path}}`
+ * interpolation segments (cascading sources); an entry that cannot resolve
+ * falls through to the next. Nothing resolvable yields an empty list.
  */
-function resolveChecklistItems(sourcePath, ctx) {
-    if (typeof sourcePath !== 'string' || !ctx)
+function resolveChecklistItems(source, ctx) {
+    const paths = (typeof source === 'string' ? [source] : Array.isArray(source) ? source : [])
+        .filter((p) => typeof p === 'string' && p.length > 0);
+    if (paths.length === 0 || !ctx)
         return [];
-    let concrete = sourcePath;
-    if ((0, ctx_path_1.hasInterpolation)(sourcePath)) {
-        const resolved = (0, ctx_path_1.interpolatePath)(sourcePath, ctx);
-        if (resolved === null)
-            return [];
-        concrete = resolved;
+    for (const sourcePath of paths) {
+        let concrete = sourcePath;
+        if ((0, ctx_path_1.hasInterpolation)(sourcePath)) {
+            const resolved = (0, ctx_path_1.interpolatePath)(sourcePath, ctx);
+            if (resolved === null)
+                continue;
+            concrete = resolved;
+        }
+        const cur = (0, ctx_path_1.resolveCtxPath)(concrete, ctx);
+        if (Array.isArray(cur) && cur.length > 0)
+            return cur;
     }
-    const cur = (0, ctx_path_1.resolveCtxPath)(concrete, ctx);
-    return Array.isArray(cur) ? cur : [];
+    return [];
+}
+exports.X_LT_DEFAULT_CHECKED = 'x-lt-default-checked';
+/**
+ * The checklist's first-load default (`x-lt-default-checked`): every resolved
+ * item starts checked, for affirm-then-exception flows where the submitter
+ * unchecks what failed. Returns the all-checked answer map ONLY when the
+ * field carries no answer yet — a saved or drafted map (any key, even
+ * all-false) is never clobbered — and null otherwise: absent flag, existing
+ * answer, or a source that resolves to no items. Declared on the widget
+ * because the item set is runtime-sourced (envelope or lookup): a pure
+ * escalation-minting step cannot enumerate the ids to seed formDefaults.
+ */
+function resolveChecklistDefault(fieldSchema, currentValue, ctx) {
+    if (fieldSchema?.['x-lt-widget'] !== 'checklist')
+        return null;
+    if (fieldSchema[exports.X_LT_DEFAULT_CHECKED] !== true)
+        return null;
+    if (currentValue && typeof currentValue === 'object' && !Array.isArray(currentValue)
+        && Object.keys(currentValue).length > 0) {
+        return null;
+    }
+    const items = resolveChecklistItems(fieldSchema['x-lt-source'], ctx);
+    if (items.length === 0)
+        return null;
+    return Object.fromEntries(items.map((i) => [i.id, true]));
 }
 /**
  * The checklist completion guard (`x-lt-require-all`): every rendered item must

package/build/shared/form-validation/x-lt-options.js

@@ -10,10 +10,18 @@ exports.resolveFieldOptions = resolveFieldOptions;
  * offer a different legal set per escalation (e.g. `[1..N]` where N rides the
  * envelope, or a versioned knowledge lookup under the `lookup` domain).
  *
- *   x-lt-options   "domain.path" — e.g. "envelope.left_quantity_options"
- *                  paths may embed {{domain.path}} interpolation segments —
+ *   x-lt-options   "domain.path" or an ORDERED array of paths — e.g.
+ *                  "envelope.left_quantity_options" or
+ *                  ["lookup.reasons.items", "envelope.reject_reason_items"].
+ *                  With an array, the first entry that resolves to options
+ *                  wins, so lookup-backed and envelope-embedded rows render
+ *                  the same shared schema interchangeably (a parked row
+ *                  falls through to the envelope it already carries).
+ *                  Paths may embed {{domain.path}} interpolation segments —
  *                  e.g. "lookup.geo.regions.{{resolver.country}}" — making
- *                  the option list follow another answer (cascading selects)
+ *                  the option list follow another answer (cascading selects);
+ *                  an entry whose interpolation cannot resolve falls through
+ *                  to the next entry.
  *
  * Object entries separate what the submitter SEES from what the payload
  * STORES: the select renders the label and emits the value (a DB-backed pick
@@ -62,24 +70,30 @@ function resolveFieldOptions(fieldSchema, ctx) {
     if (Array.isArray(staticEnum) && staticEnum.length > 0) {
         return staticEnum.map((v) => ({ value: v, label: String(v) }));
     }
-    const sourcePath = fieldSchema[exports.X_LT_OPTIONS];
-    if (typeof sourcePath !== 'string')
+    const token = fieldSchema[exports.X_LT_OPTIONS];
+    const paths = (typeof token === 'string' ? [token] : Array.isArray(token) ? token : [])
+        .filter((p) => typeof p === 'string' && p.length > 0);
+    if (paths.length === 0)
         return undefined;
-    // Interpolated tokens are a standing contract: even unresolvable, the field
-    // stays a (disabled) select and fails closed. Plain paths keep the legacy
-    // undefined-on-miss reading.
-    const dynamic = (0, ctx_path_1.hasInterpolation)(sourcePath);
-    const miss = dynamic ? [] : undefined;
-    let concrete = sourcePath;
-    if (dynamic) {
-        const resolved = (0, ctx_path_1.interpolatePath)(sourcePath, ctx);
-        if (resolved === null)
-            return miss;
-        concrete = resolved;
+    // Interpolated entries are a standing contract: when nothing resolves, the
+    // field stays a (disabled) select and fails closed — a cascade child never
+    // becomes free text. All-plain-path tokens keep the legacy undefined-on-miss
+    // reading (the field falls back to its typed plain input).
+    const miss = paths.some(ctx_path_1.hasInterpolation) ? [] : undefined;
+    for (const sourcePath of paths) {
+        let concrete = sourcePath;
+        if ((0, ctx_path_1.hasInterpolation)(sourcePath)) {
+            const resolved = (0, ctx_path_1.interpolatePath)(sourcePath, ctx);
+            if (resolved === null)
+                continue;
+            concrete = resolved;
+        }
+        const cur = (0, ctx_path_1.resolveCtxPath)(concrete, ctx);
+        if (!Array.isArray(cur))
+            continue;
+        const options = cur.map(toOption).filter((o) => o !== null);
+        if (options.length > 0)
+            return options;
     }
-    const cur = (0, ctx_path_1.resolveCtxPath)(concrete, ctx);
-    if (!Array.isArray(cur))
-        return miss;
-    const options = cur.map(toOption).filter((o) => o !== null);
-    return options.length > 0 ? options : miss;
+    return miss;
 }

package/build/system/mcp-servers/admin/exports.js

@@ -89,6 +89,21 @@ function registerExportTools(server) {
         }
         return { content: [{ type: 'text', text: JSON.stringify((0, pick_1.pickPaths)(result.data, args.select)) }] };
     });
+    // mirrors GET /api/workflow-states/:workflowId/envelopes
+    server.registerTool('get_workflow_envelopes', {
+        title: 'Get Workflow Envelopes',
+        description: 'The workflow\'s input and output envelopes — two narrow lookups, no event ' +
+            'stream. Output is null with status running until the workflow completes; a ' +
+            'failed run carries its error message. The token-cheap read when you only ' +
+            'need what went in and what came out.',
+        inputSchema: schemas_1.getWorkflowEnvelopesSchema,
+    }, async (args) => {
+        const result = await api.getWorkflowEnvelopes({ workflowId: args.workflow_id });
+        if (result.error) {
+            return { content: [{ type: 'text', text: JSON.stringify({ error: result.error }) }], isError: true };
+        }
+        return { content: [{ type: 'text', text: JSON.stringify(result.data) }] };
+    });
     // mirrors GET /api/workflow-states/:workflowId/status
     server.registerTool('get_export_status', {
         title: 'Get Workflow Status',

package/build/system/mcp-servers/admin/schemas.d.ts

@@ -1420,6 +1420,13 @@ export declare const getExportStatusSchema: z.ZodObject<{
 }, {
     workflow_id: string;
 }>;
+export declare const getWorkflowEnvelopesSchema: z.ZodObject<{
+    workflow_id: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    workflow_id: string;
+}, {
+    workflow_id: string;
+}>;
 export declare const diagnoseJobSchema: z.ZodObject<{
     workflow_id: z.ZodString;
     app_id: z.ZodDefault<z.ZodOptional<z.ZodString>>;

package/build/system/mcp-servers/admin/schemas.js

@@ -1,8 +1,8 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.assignPersonaSchema = exports.unlinkPersonaRoleSchema = exports.linkPersonaRoleSchema = exports.deletePersonaSchema = exports.updatePersonaSchema = exports.createPersonaSchema = exports.getPersonaSchema = exports.listPersonasSchema = exports.listRoleSchemaVersionsSchema = exports.getRoleSchemaSchema = exports.updateRoleSchema = exports.addEscalationChainSchema = exports.createRoleSchema = exports.listRolesSchema = exports.removeUserRoleSchema = exports.addUserRoleSchema = exports.createUserSchema = exports.listUsersSchema = exports.invokeYamlWorkflowSchema = exports.deployYamlWorkflowSchema = exports.createYamlWorkflowSchema = exports.getYamlWorkflowSchema = exports.listYamlWorkflowsSchema = exports.disconnectMcpServerSchema = exports.connectMcpServerSchema = exports.updateMcpServerSchema = exports.listMcpServersSchema = exports.getDomainContextSchema = exports.terminateWorkflowSchema = exports.getWorkflowStatusSchema = exports.invokeWorkflowSchema = exports.listDiscoveredWorkflowsSchema = exports.deleteWorkflowConfigSchema = exports.upsertWorkflowConfigSchema = exports.listWorkflowConfigsSchema = exports.bulkTriageSchema = exports.releaseExpiredClaimsSchema = exports.bulkCancelSchema = exports.cancelEscalationSchema = exports.escalateEscalationSchema = exports.resolveBySignalKeySchema = exports.resolveEscalationSchema = exports.releaseEscalationSchema = exports.claimEscalationSchema = exports.getEscalationStatsSchema = exports.getEscalationsByWorkflowSchema = exports.getEscalationSchema = exports.findEscalationsSchema = exports.getProcessDetailSchema = exports.findTasksSchema = void 0;
-exports.resolveByIdsSchema = exports.facetQuerySchema = exports.findOrphanedSignalsSchema = exports.findStalledJobsSchema = exports.diagnoseJobSchema = exports.getExportStatusSchema = exports.exportWorkflowExecutionSchema = exports.exportWorkflowStateSchema = exports.listExportJobsSchema = exports.getSettingsSchema = exports.updatePrioritySchema = exports.bulkEscalateSchema = exports.bulkUnassignSchema = exports.bulkAssignSchema = exports.bulkClaimSchema = exports.resolveByMetadataSchema = exports.claimByMetadataSchema = exports.findByMetadataSchema = exports.deleteTopicSchema = exports.updateTopicSchema = exports.createTopicSchema = exports.getTopicSchema = exports.listTopicsSchema = exports.interruptJobSchema = exports.getJobExecutionSchema = exports.listPipelineJobsSchema = exports.listPipelineEntitiesSchema = exports.listStreamMessagesSchema = exports.getStreamStatsSchema = exports.applyThrottleSchema = exports.rollCallSchema = exports.listAppsSchema = exports.revokeBotKeySchema = exports.createBotApiKeySchema = exports.deleteBotSchema = exports.updateBotSchema = exports.createBotSchema = exports.getBotSchema = exports.listBotsSchema = exports.deleteAgentSubscriptionSchema = exports.createAgentSubscriptionSchema = exports.listAgentSubscriptionsSchema = exports.deleteAgentSchema = exports.updateAgentSchema = exports.createAgentSchema = exports.getAgentSchema = exports.listAgentsSchema = exports.pruneSchema = exports.getUserPersonasSchema = exports.unassignPersonaSchema = void 0;
-exports.deleteScanRuleSchema = exports.upsertScanRuleSchema = exports.upsertScanSchemeSchema = exports.listScanSchemesSchema = exports.executeScanChoiceSchema = exports.executeScanCodeSchema = exports.timelineByFacetSchema = exports.aggregateByFacetsSchema = exports.claimByFacetsSchema = exports.claimGroupsSchema = exports.searchByFacetsSchema = void 0;
+exports.facetQuerySchema = exports.findOrphanedSignalsSchema = exports.findStalledJobsSchema = exports.diagnoseJobSchema = exports.getWorkflowEnvelopesSchema = exports.getExportStatusSchema = exports.exportWorkflowExecutionSchema = exports.exportWorkflowStateSchema = exports.listExportJobsSchema = exports.getSettingsSchema = exports.updatePrioritySchema = exports.bulkEscalateSchema = exports.bulkUnassignSchema = exports.bulkAssignSchema = exports.bulkClaimSchema = exports.resolveByMetadataSchema = exports.claimByMetadataSchema = exports.findByMetadataSchema = exports.deleteTopicSchema = exports.updateTopicSchema = exports.createTopicSchema = exports.getTopicSchema = exports.listTopicsSchema = exports.interruptJobSchema = exports.getJobExecutionSchema = exports.listPipelineJobsSchema = exports.listPipelineEntitiesSchema = exports.listStreamMessagesSchema = exports.getStreamStatsSchema = exports.applyThrottleSchema = exports.rollCallSchema = exports.listAppsSchema = exports.revokeBotKeySchema = exports.createBotApiKeySchema = exports.deleteBotSchema = exports.updateBotSchema = exports.createBotSchema = exports.getBotSchema = exports.listBotsSchema = exports.deleteAgentSubscriptionSchema = exports.createAgentSubscriptionSchema = exports.listAgentSubscriptionsSchema = exports.deleteAgentSchema = exports.updateAgentSchema = exports.createAgentSchema = exports.getAgentSchema = exports.listAgentsSchema = exports.pruneSchema = exports.getUserPersonasSchema = exports.unassignPersonaSchema = void 0;
+exports.deleteScanRuleSchema = exports.upsertScanRuleSchema = exports.upsertScanSchemeSchema = exports.listScanSchemesSchema = exports.executeScanChoiceSchema = exports.executeScanCodeSchema = exports.timelineByFacetSchema = exports.aggregateByFacetsSchema = exports.claimByFacetsSchema = exports.claimGroupsSchema = exports.searchByFacetsSchema = exports.resolveByIdsSchema = void 0;
 /**
  * Zod schemas for the admin MCP server tools.
  *
@@ -579,6 +579,9 @@ exports.exportWorkflowExecutionSchema = zod_1.z.object({
 exports.getExportStatusSchema = zod_1.z.object({
     workflow_id: zod_1.z.string().describe('Workflow ID to check export status'),
 });
+exports.getWorkflowEnvelopesSchema = zod_1.z.object({
+    workflow_id: zod_1.z.string().describe('Workflow ID whose input/output envelopes to fetch'),
+});
 // ── Diagnostics ───────────────────────────────────────────────────────────────
 exports.diagnoseJobSchema = zod_1.z.object({
     workflow_id: zod_1.z.string().describe('Workflow ID to diagnose'),

package/build/system/seed/tool-manifests-admin.js

@@ -124,6 +124,7 @@ exports.ADMIN_TOOLS = [
     { name: 'list_export_jobs', description: 'List workflow jobs with optional filtering and pagination.', read_safe: true, inputSchema: { type: 'object', properties: { limit: { type: 'integer' }, offset: { type: 'integer' }, entity: { type: 'string' }, search: { type: 'string' }, status: { type: 'string' }, sort_by: { type: 'string' }, order: { type: 'string', enum: ['asc', 'desc'] } } } },
     { name: 'export_workflow_state', description: 'Export the full workflow state using HotMesh durable export. allow/block filter which sections the engine fetches; select (dot paths) projects the returned JSON.', read_safe: true, inputSchema: { type: 'object', properties: { workflow_id: { type: 'string' }, allow: { type: 'array', items: { type: 'string' } }, block: { type: 'array', items: { type: 'string' } }, values: { type: 'object' }, select: { type: 'array', items: { type: 'string' } } }, required: ['workflow_id'] } },
     { name: 'export_workflow_execution', description: 'Export workflow state as a structured execution event history. Histories run large — pass select (dot paths) to return only what you need.', read_safe: true, inputSchema: { type: 'object', properties: { workflow_id: { type: 'string' }, excludeSystem: { type: 'boolean' }, omitResults: { type: 'boolean' }, mode: { type: 'string' }, maxDepth: { type: 'integer' }, select: { type: 'array', items: { type: 'string' } } }, required: ['workflow_id'] } },
+    { name: 'get_workflow_envelopes', description: 'The workflow\'s input and output envelopes — two narrow lookups, no event stream. Output is null with status running until the workflow completes; a failed run carries its error message.', read_safe: true, inputSchema: { type: 'object', properties: { workflow_id: { type: 'string' } }, required: ['workflow_id'] } },
     { name: 'get_export_status', description: 'Return the numeric status semaphore for a workflow.', read_safe: true, inputSchema: { type: 'object', properties: { workflow_id: { type: 'string' } }, required: ['workflow_id'] } },
     // ── overview.ts ─────────────────────────────────────────────────────────
     { name: 'get_system_overview', description: 'Triage-ready system dashboard: escalation queue pressure, task throughput, hourly trends, infrastructure status, and process summary. One call for complete system state.', read_safe: true, inputSchema: { type: 'object', properties: { period: { type: 'string', enum: ['1h', '24h', '7d'], description: 'Time window (default: 24h)' } } } },

package/dashboard/dist/assets/{AdminDashboard-Dnj4asuh.js → AdminDashboard-Csq-oxmY.js}

@@ -1,2 +1,2 @@
-import{j as o}from"./vendor-query-RUZdMvN6.js";import{c as n}from"./tasks-Em0f5Rsk.js";import{T as m}from"./index-sbfCx2CF.js";import{f as c}from"./useEventHooks-B_Bqqzlo.js";import{u}from"./mcp-I2OmwD8P.js";import{P as d}from"./PageHeaderWithStats-D9tQxILm.js";import"./vendor-react-CdqEC2zv.js";import"./vendor-icons-h-jlRSb9.js";function j(){var a;c();const{data:s}=n({limit:1}),{data:e}=m({status:"pending",limit:1}),{data:t}=u(),r=((a=t==null?void 0:t.servers)==null?void 0:a.filter(i=>i.status==="connected").length)??0,l=t?`${r}/${t.total}`:"—";return o.jsx("div",{children:o.jsx(d,{title:"Admin",stats:[{label:"Tasks",value:(s==null?void 0:s.total)??"—"},{label:"Pending Escalations",value:(e==null?void 0:e.total)??"—",dotClass:"bg-status-pending"},{label:"MCP Servers",value:l},{label:"System",value:"Healthy",dotClass:"bg-status-success"}]})})}export{j as AdminDashboard};
-//# sourceMappingURL=AdminDashboard-Dnj4asuh.js.map
+import{j as o}from"./vendor-query-RUZdMvN6.js";import{c as n}from"./tasks-CGoPhQyw.js";import{T as m}from"./index-zqoZDL5j.js";import{f as c}from"./useEventHooks-onx-Z6IY.js";import{u}from"./mcp-D2WA-SHc.js";import{P as d}from"./PageHeaderWithStats-D9tQxILm.js";import"./vendor-react-CdqEC2zv.js";import"./vendor-icons-h-jlRSb9.js";function j(){var a;c();const{data:s}=n({limit:1}),{data:e}=m({status:"pending",limit:1}),{data:t}=u(),r=((a=t==null?void 0:t.servers)==null?void 0:a.filter(i=>i.status==="connected").length)??0,l=t?`${r}/${t.total}`:"—";return o.jsx("div",{children:o.jsx(d,{title:"Admin",stats:[{label:"Tasks",value:(s==null?void 0:s.total)??"—"},{label:"Pending Escalations",value:(e==null?void 0:e.total)??"—",dotClass:"bg-status-pending"},{label:"MCP Servers",value:l},{label:"System",value:"Healthy",dotClass:"bg-status-success"}]})})}export{j as AdminDashboard};
+//# sourceMappingURL=AdminDashboard-Csq-oxmY.js.map

package/dashboard/dist/assets/{AdminDashboard-Dnj4asuh.js.map → AdminDashboard-Csq-oxmY.js.map}

@@ -1 +1 @@
-{"version":3,"file":"AdminDashboard-Dnj4asuh.js","sources":["../../src/pages/admin/AdminDashboard.tsx"],"sourcesContent":["import { useTasks } from '../../api/tasks';\nimport { useEscalations } from '../../api/escalations';\nimport { useEscalationListEvents } from '../../hooks/useEventHooks';\nimport { useMcpServers } from '../../api/mcp';\nimport { PageHeaderWithStats } from '../../components/common/layout/PageHeaderWithStats';\n\nexport function AdminDashboard() {\n  useEscalationListEvents();\n  const { data: taskData } = useTasks({ limit: 1 });\n  const { data: pendingEsc } = useEscalations({ status: 'pending', limit: 1 });\n  const { data: mcpData } = useMcpServers();\n\n  const connectedServers =\n    mcpData?.servers?.filter((s) => s.status === 'connected').length ?? 0;\n  const mcpLabel = mcpData ? `${connectedServers}/${mcpData.total}` : '—';\n\n  return (\n    <div>\n      <PageHeaderWithStats\n        title=\"Admin\"\n        stats={[\n          { label: 'Tasks', value: taskData?.total ?? '—' },\n          { label: 'Pending Escalations', value: pendingEsc?.total ?? '—', dotClass: 'bg-status-pending' },\n          { label: 'MCP Servers', value: mcpLabel },\n          { label: 'System', value: 'Healthy', dotClass: 'bg-status-success' },\n        ]}\n      />\n    </div>\n  );\n}\n"],"names":["AdminDashboard","useEscalationListEvents","taskData","useTasks","pendingEsc","useEscalations","mcpData","useMcpServers","connectedServers","_a","s","mcpLabel","jsx","PageHeaderWithStats"],"mappings":"4UAMO,SAASA,GAAiB,OAC/BC,EAAA,EACA,KAAM,CAAE,KAAMC,CAAA,EAAaC,EAAS,CAAE,MAAO,EAAG,EAC1C,CAAE,KAAMC,CAAA,EAAeC,EAAe,CAAE,OAAQ,UAAW,MAAO,EAAG,EACrE,CAAE,KAAMC,CAAA,EAAYC,EAAA,EAEpBC,IACJC,EAAAH,GAAA,YAAAA,EAAS,UAAT,YAAAG,EAAkB,OAAQC,GAAMA,EAAE,SAAW,aAAa,SAAU,EAChEC,EAAWL,EAAU,GAAGE,CAAgB,IAAIF,EAAQ,KAAK,GAAK,IAEpE,aACG,MAAA,CACC,SAAAM,EAAAA,IAACC,EAAA,CACC,MAAM,QACN,MAAO,CACL,CAAE,MAAO,QAAS,OAAOX,GAAA,YAAAA,EAAU,QAAS,GAAA,EAC5C,CAAE,MAAO,sBAAuB,OAAOE,GAAA,YAAAA,EAAY,QAAS,IAAK,SAAU,mBAAA,EAC3E,CAAE,MAAO,cAAe,MAAOO,CAAA,EAC/B,CAAE,MAAO,SAAU,MAAO,UAAW,SAAU,mBAAA,CAAoB,CACrE,CAAA,EAEJ,CAEJ"}
+{"version":3,"file":"AdminDashboard-Csq-oxmY.js","sources":["../../src/pages/admin/AdminDashboard.tsx"],"sourcesContent":["import { useTasks } from '../../api/tasks';\nimport { useEscalations } from '../../api/escalations';\nimport { useEscalationListEvents } from '../../hooks/useEventHooks';\nimport { useMcpServers } from '../../api/mcp';\nimport { PageHeaderWithStats } from '../../components/common/layout/PageHeaderWithStats';\n\nexport function AdminDashboard() {\n  useEscalationListEvents();\n  const { data: taskData } = useTasks({ limit: 1 });\n  const { data: pendingEsc } = useEscalations({ status: 'pending', limit: 1 });\n  const { data: mcpData } = useMcpServers();\n\n  const connectedServers =\n    mcpData?.servers?.filter((s) => s.status === 'connected').length ?? 0;\n  const mcpLabel = mcpData ? `${connectedServers}/${mcpData.total}` : '—';\n\n  return (\n    <div>\n      <PageHeaderWithStats\n        title=\"Admin\"\n        stats={[\n          { label: 'Tasks', value: taskData?.total ?? '—' },\n          { label: 'Pending Escalations', value: pendingEsc?.total ?? '—', dotClass: 'bg-status-pending' },\n          { label: 'MCP Servers', value: mcpLabel },\n          { label: 'System', value: 'Healthy', dotClass: 'bg-status-success' },\n        ]}\n      />\n    </div>\n  );\n}\n"],"names":["AdminDashboard","useEscalationListEvents","taskData","useTasks","pendingEsc","useEscalations","mcpData","useMcpServers","connectedServers","_a","s","mcpLabel","jsx","PageHeaderWithStats"],"mappings":"4UAMO,SAASA,GAAiB,OAC/BC,EAAA,EACA,KAAM,CAAE,KAAMC,CAAA,EAAaC,EAAS,CAAE,MAAO,EAAG,EAC1C,CAAE,KAAMC,CAAA,EAAeC,EAAe,CAAE,OAAQ,UAAW,MAAO,EAAG,EACrE,CAAE,KAAMC,CAAA,EAAYC,EAAA,EAEpBC,IACJC,EAAAH,GAAA,YAAAA,EAAS,UAAT,YAAAG,EAAkB,OAAQC,GAAMA,EAAE,SAAW,aAAa,SAAU,EAChEC,EAAWL,EAAU,GAAGE,CAAgB,IAAIF,EAAQ,KAAK,GAAK,IAEpE,aACG,MAAA,CACC,SAAAM,EAAAA,IAACC,EAAA,CACC,MAAM,QACN,MAAO,CACL,CAAE,MAAO,QAAS,OAAOX,GAAA,YAAAA,EAAU,QAAS,GAAA,EAC5C,CAAE,MAAO,sBAAuB,OAAOE,GAAA,YAAAA,EAAY,QAAS,IAAK,SAAU,mBAAA,EAC3E,CAAE,MAAO,cAAe,MAAOO,CAAA,EAC/B,CAAE,MAAO,SAAU,MAAO,UAAW,SAAU,mBAAA,CAAoB,CACrE,CAAA,EAEJ,CAEJ"}