@stigmer/server 3.14.0-dev.20260910084630

package/dist/temporal/workflowexecution/workflows/invoke-workflow-execution.js

@@ -0,0 +1,430 @@
+/**
+ * The workflow-execution orchestrator workflow — ports
+ * pkg/domain/workflowexecution/temporal/workflows/invoke_workflow_impl.go
+ * (registered as "stigmer/workflow-execution/invoke"; proven by the
+ * workflowexecution execution suites on local-execution and the
+ * co-located TestWorkflowEnvironment tests).
+ *
+ * Orchestration only — the TS unified runner owns the actual CNCF
+ * Serverless Workflow engine as the child workflow
+ * "stigmer/workflow/execute-from-execution" on the memo-pinned runner
+ * queue; the runner reports progressive status via gRPC. This workflow:
+ *
+ *   1. Installs the signal forwarders (pause, resume, relaySignal).
+ *   2. Starts the child (ID "workflow-exec-{executionId}",
+ *      ParentClosePolicy REQUEST_CANCEL, MaximumAttempts 1) and awaits it.
+ *   3. On failure: FAILED persist (worker-shutdown shapes mapped to the
+ *      honest platform-failure copy, #776), EC delete, ApplicationFailure.
+ *      On cancellation: CANCELLED persist + EC delete on a
+ *      non-cancellable scope (Go's disconnected context). On success:
+ *      EC delete.
+ *
+ * Pause/resume ordering guarantee (D2 §4, Go startSignalHandlers): both
+ * signals are processed by ONE serialized loop so their relays to the
+ * child can never be reordered — both mutate the same `paused` flag in
+ * the child, and a resume overtaking its preceding pause would leave the
+ * child blocked forever. Each signal's status persist and relay complete
+ * before the next signal is read; pause wins ties when both are buffered
+ * in the same workflow task (Go registers pause first on its Selector).
+ *
+ * v1 semantics only (OD-6): Go's "child-workflow-migration" and
+ * "remote-cleanup-stubs" version gates and the legacy ExecuteWorkflow
+ * activity path are NOT ported — no Go-era history can replay here. The
+ * surviving arms are the child-workflow path and the REGULAR-activity
+ * cleanup persists (Go v1 uses remote activities on the failure/cancel
+ * paths to dodge a Go-SDK RECORD_MARKER replay bug; the history shape is
+ * preserved as contract, the same ruling as agentexecution's port).
+ *
+ * Status persists are best-effort defense-in-depth: the RPC lifecycle
+ * steps persist the same phases synchronously, and the runner streams
+ * real statuses via gRPC. NOTE (sub-project DD-002): in Go these persists
+ * are silently DEAD — the production worker registers the activity under
+ * a derived name the workflow's constant never matches. This port
+ * registers and invokes under the one constant name, so the lane works
+ * here (disclosed divergence in the safe direction; Go issue filed).
+ *
+ * WORKFLOW-BUNDLE IMPORT DISCIPLINE: this file runs in Temporal's
+ * deterministic sandbox. Only @temporalio/workflow, @temporalio/common,
+ * @bufbuild/protobuf, generated protos, and verified-pure modules may be
+ * imported (sub-project 20260824.03 discipline).
+ */
+import { create, toJson } from "@bufbuild/protobuf";
+import { ApplicationFailure, CancelledFailure } from "@temporalio/common";
+import { CancellationScope, condition, defineSignal, executeChild, getExternalWorkflowHandle, log, ParentClosePolicy, proxyActivities, proxyLocalActivities, setHandler, workflowInfo, } from "@temporalio/workflow";
+import { WorkflowExecutionStatusSchema } from "@stigmer/protos/ai/stigmer/agentic/workflowexecution/v1/api_pb";
+import { ExecutionPhase } from "@stigmer/protos/ai/stigmer/agentic/workflowexecution/v1/enum_pb";
+import { DELETE_EXECUTION_CONTEXT_ACTIVITY_NAME } from "../../../domain/executioncontext/temporal/delete-execution-context.js";
+import { isWorkerShutdown, WORKER_SHUTDOWN_STATUS_ERROR, } from "../../runner-failure.js";
+import { CHILD_WORKFLOW_TYPE, childWorkflowId, DEFAULT_RUNNER_TASK_QUEUE, MEMO_RUNNER_TASK_QUEUE, PAUSE_SIGNAL_NAME, RELAY_SIGNAL_CHANNEL_NAME, RESUME_SIGNAL_NAME, UPDATE_WORKFLOW_EXECUTION_STATUS_ACTIVITY_NAME, } from "../names.js";
+// ─── Signals (byte-pinned names; see names.ts) ──────────────────────────
+const pauseSignal = defineSignal(PAUSE_SIGNAL_NAME);
+const resumeSignal = defineSignal(RESUME_SIGNAL_NAME);
+const relaySignal = defineSignal(RELAY_SIGNAL_CHANNEL_NAME);
+/**
+ * LOCAL-activity mode: the pause/resume signal handlers' persists (Go
+ * updateStatusToPaused/updateStatusToRunning use ExecuteLocalActivity).
+ */
+const signalPathActivities = proxyLocalActivities({
+    scheduleToCloseTimeout: "30s",
+    retry: { maximumAttempts: 3, initialInterval: "2s" },
+});
+/**
+ * REGULAR-activity mode on this workflow's own (stigmer) queue: the
+ * failure/cancellation persists and the EC delete (Go's v1
+ * "remote-cleanup-stubs" arm — local-activity RECORD_MARKER events in the
+ * same workflow task as a child-workflow failure trigger a Go-SDK state
+ * machine bug; the history shape is preserved as contract).
+ */
+const cleanupActivities = proxyActivities({
+    scheduleToCloseTimeout: "30s",
+    retry: { maximumAttempts: 3, initialInterval: "2s" },
+});
+// ─── The workflow ───────────────────────────────────────────────────────
+export async function invokeWorkflowExecution(input) {
+    const executionId = input.execution_id;
+    log.info("Starting workflow for execution", { executionId });
+    // Go reads ctx.Err() to distinguish external workflow cancellation from
+    // ordinary failures; the TS equivalent observes the root scope's
+    // cancellation request (the dangling rejection is the designed API
+    // shape — cancelRequested is a Promise<never>).
+    let workflowCancelled = false;
+    CancellationScope.current().cancelRequested.catch(() => {
+        workflowCancelled = true;
+    });
+    startSignalForwarders(executionId);
+    let childError;
+    try {
+        await executeChildWorkflow(input);
+    }
+    catch (error) {
+        childError = error;
+    }
+    if (childError !== undefined) {
+        // Cancellation path — keyed on the WORKFLOW's cancel state alone
+        // (Go temporal.IsCanceledError(ctx.Err())): cleanup runs on a
+        // non-cancellable scope and the workflow must end CANCELLED, not
+        // FAILED, so the underlying CancelledFailure is what propagates.
+        if (workflowCancelled) {
+            log.info("Workflow cancelled, running cancellation cleanup", {
+                executionId,
+            });
+            await handleCancellation(executionId);
+            throw (findInCauseChain(childError, CancelledFailure) ??
+                new CancelledFailure("Workflow cancelled"));
+        }
+        log.error("Workflow execution failed", {
+            executionId,
+            error: errorMessage(childError),
+        });
+        try {
+            await updateStatusOnFailure(executionId, childError);
+        }
+        catch (error) {
+            // Go logs and proceeds — the EC delete and the workflow's own
+            // failure must not be lost to a status-persist failure.
+            log.error("Failed to update execution status", {
+                error: errorMessage(error),
+            });
+        }
+        await deleteExecutionContext(executionId);
+        // Only a TemporalFailure fails a TS workflow — a plain throw fails
+        // the workflow TASK, which the server retries forever (the #18 panel
+        // finding). Go: temporal.NewApplicationError("Workflow execution
+        // failed", "", err).
+        throw ApplicationFailure.create({
+            message: "Workflow execution failed",
+            cause: childError instanceof Error
+                ? childError
+                : new Error(String(childError)),
+        });
+    }
+    log.info("Workflow completed for execution (status updates were sent progressively via gRPC)", { executionId });
+    await deleteExecutionContext(executionId);
+}
+// ─── Signal forwarders (Go startSignalHandlers) ─────────────────────────
+/**
+ * Installs the three signal handlers and starts the two forwarding loops.
+ * The loops are fire-and-forget workflow "goroutines": they emit no
+ * commands until a signal is actually processed, so the common case (no
+ * signal ever received) leaves history untouched. On external workflow
+ * cancellation their `condition` waits reject in the cancel activation
+ * itself — caught and treated as loop exit, because an uncaught rejection
+ * would fail the workflow task at the activation boundary and the server
+ * would retry it forever (the #18 monitor lesson; Go's goroutines get
+ * this leniency from their SDK for free).
+ */
+function startSignalForwarders(executionId) {
+    // Buffered-channel semantics (Go GetSignalChannel): signals delivered
+    // before a handler runs — or while the loop is busy processing an
+    // earlier one — queue losslessly.
+    const pauseQueue = [];
+    let resumePending = 0;
+    const relayQueue = [];
+    setHandler(pauseSignal, (reason) => {
+        pauseQueue.push(reason ?? "");
+    });
+    setHandler(resumeSignal, () => {
+        resumePending++;
+    });
+    setHandler(relaySignal, (payload) => {
+        if (payload === undefined || (payload.signalName ?? "") === "") {
+            // Go zero-values a malformed envelope and the empty signal name
+            // then fails inside SignalExternalWorkflow's relay (warn-only).
+            // Refusing it here reaches the same non-fatal outcome without
+            // burning a relay command on a signal that cannot deliver.
+            log.warn("Relay signal with empty envelope ignored", { executionId });
+            return;
+        }
+        relayQueue.push(payload);
+    });
+    // ONE serialized pause/resume loop — the ordering guarantee (see the
+    // module header). Pause is checked first each iteration: Go's Selector
+    // registers pause first, so it wins ties when both are buffered.
+    void (async () => {
+        for (;;) {
+            try {
+                await condition(() => pauseQueue.length > 0 || resumePending > 0);
+            }
+            catch {
+                return; // External cancellation — stand down.
+            }
+            if (pauseQueue.length > 0) {
+                const reason = pauseQueue.shift() ?? "";
+                log.info("Pause signal received", { executionId, reason });
+                await persistPhase(executionId, ExecutionPhase.EXECUTION_PAUSED, "Failed to update execution status to PAUSED");
+                await relaySignalToChild(executionId, PAUSE_SIGNAL_NAME, reason);
+            }
+            else {
+                resumePending--;
+                log.info("Resume signal received", { executionId });
+                await persistPhase(executionId, ExecutionPhase.EXECUTION_IN_PROGRESS, "Failed to update execution status to IN_PROGRESS");
+                await relaySignalToChild(executionId, RESUME_SIGNAL_NAME, null);
+            }
+        }
+    })();
+    // Generic relay loop (LISTEN / human_input tasks): the API layer
+    // signals this orchestrator via SignalWithStart; task-specific signal
+    // channels are registered in the child.
+    void (async () => {
+        for (;;) {
+            try {
+                await condition(() => relayQueue.length > 0);
+            }
+            catch {
+                return; // External cancellation — stand down.
+            }
+            const payload = relayQueue.shift();
+            if (payload === undefined) {
+                continue;
+            }
+            log.info("Relay signal received", {
+                executionId,
+                signal: payload.signalName,
+            });
+            await relaySignalToChild(executionId, payload.signalName, payload.payload);
+        }
+    })();
+}
+/**
+ * Forwards a signal to the TS child workflow via SignalExternalWorkflow
+ * (Go relaySignalToChild). Best-effort: a missing/completed child is a
+ * warning, never a workflow failure. The payload is always sent as one
+ * argument — Go sends exactly one (nil for resume), and the child's
+ * handlers read the first argument or ignore it.
+ */
+async function relaySignalToChild(executionId, signalName, payload) {
+    const childId = childWorkflowId(executionId);
+    try {
+        await getExternalWorkflowHandle(childId).signal(signalName, payload);
+    }
+    catch (error) {
+        log.warn("Failed to relay signal to child workflow", {
+            executionId,
+            signal: signalName,
+            childWorkflowId: childId,
+            error: errorMessage(error),
+        });
+    }
+}
+// ─── The child workflow (Go executeChildWorkflow) ───────────────────────
+/**
+ * Starts the TS unified runner's engine as a Temporal child workflow and
+ * awaits its result. The child handles the actual CNCF Serverless
+ * Workflow execution and reports progressive status via gRPC.
+ */
+async function executeChildWorkflow(input) {
+    const executionId = input.execution_id;
+    const childId = childWorkflowId(executionId);
+    const taskQueue = getRunnerTaskQueue();
+    log.info("Starting child workflow", {
+        executionId,
+        childWorkflowId: childId,
+        taskQueue,
+    });
+    await executeChild(CHILD_WORKFLOW_TYPE, {
+        workflowId: childId,
+        taskQueue,
+        // The parent's close requests cancellation rather than killing the
+        // child mid-write; recover's terminate-existing step is the hard
+        // stop when an operator needs one.
+        parentClosePolicy: ParentClosePolicy.REQUEST_CANCEL,
+        // ALL retry semantics live above the child (recover is
+        // terminate-and-start-fresh, stigmer#200) — a blind engine re-run
+        // would replay side effects the runner already streamed.
+        retry: { maximumAttempts: 1 },
+        args: [input],
+    });
+}
+/**
+ * The dispatch-resolved runner queue, pinned in the workflow memo at
+ * creation (workflow_creator.go). The fallback "should never happen if
+ * the workflow is created properly" (Go getRunnerTaskQueue). Go's legacy
+ * "activityTaskQueue" memo fallback is deliberately not ported — no
+ * pre-migration history can replay on this server (OD-6; names.ts).
+ */
+function getRunnerTaskQueue() {
+    const memoValue = workflowInfo().memo?.[MEMO_RUNNER_TASK_QUEUE];
+    if (typeof memoValue === "string" && memoValue !== "") {
+        return memoValue;
+    }
+    return DEFAULT_RUNNER_TASK_QUEUE;
+}
+// ─── Status persists ────────────────────────────────────────────────────
+/**
+ * Phase-only status persist for the pause/resume handlers (Go
+ * updateStatusToPaused/updateStatusToRunning): LOCAL activity,
+ * best-effort — logs on error, never propagates.
+ */
+async function persistPhase(executionId, phase, warnMessage) {
+    const status = create(WorkflowExecutionStatusSchema, { phase });
+    try {
+        await signalPathActivities[UPDATE_WORKFLOW_EXECUTION_STATUS_ACTIVITY_NAME](executionId, statusToJson(status));
+        log.info("Updated execution status", {
+            executionId,
+            phase: ExecutionPhase[phase],
+        });
+    }
+    catch (error) {
+        log.warn(warnMessage, { executionId, error: errorMessage(error) });
+    }
+}
+/**
+ * FAILED persist on the system-error path (Go updateStatusOnFailure):
+ * REGULAR activity. Recognized worker-shutdown shapes persist the honest
+ * platform-failure copy instead of raw Temporal drain internals (#776) —
+ * the raw text stays in the workflow log (the caller already logged it).
+ * Unlike the other persists this one PROPAGATES its error (Go returns it
+ * for the caller's log line).
+ */
+async function updateStatusOnFailure(executionId, originalError) {
+    log.info("Updating execution status to FAILED", { executionId });
+    // The child's real error hides in the failure's CAUSE chain (the TS
+    // SDK's ChildWorkflowFailure.message is the generic "Child Workflow
+    // execution failed"); Go's %s renders the whole chain, so the persisted
+    // copy joins it too — status.error is the operator's only view of WHY.
+    const statusError = isWorkerShutdown(originalError)
+        ? WORKER_SHUTDOWN_STATUS_ERROR
+        : `Workflow execution failed: ${errorChainMessage(originalError)}`;
+    const failedStatus = create(WorkflowExecutionStatusSchema, {
+        phase: ExecutionPhase.EXECUTION_FAILED,
+        error: statusError,
+    });
+    await cleanupActivities[UPDATE_WORKFLOW_EXECUTION_STATUS_ACTIVITY_NAME](executionId, statusToJson(failedStatus));
+    log.info("Updated execution status to FAILED", { executionId });
+}
+/**
+ * Cancellation cleanup on a non-cancellable scope (Go's disconnected
+ * context): both operations are best-effort and independent — the
+ * execution must reach CANCELLED and the ExecutionContext (secrets) must
+ * be cleaned up regardless.
+ */
+async function handleCancellation(executionId) {
+    await CancellationScope.nonCancellable(async () => {
+        await updateStatusOnCancellation(executionId);
+        await deleteExecutionContext(executionId);
+    });
+}
+/**
+ * CANCELLED persist (Go updateStatusOnCancellation): REGULAR activity,
+ * best-effort. Deliberately sets NO status.error — a user-initiated
+ * cancel is a quiet terminal state, not a failure (stigmer#282); display
+ * layers key error styling on status.error, so a sentinel here would
+ * render the stop as a failure. The CANCELLED phase alone carries the
+ * state.
+ */
+async function updateStatusOnCancellation(executionId) {
+    const cancelledStatus = create(WorkflowExecutionStatusSchema, {
+        phase: ExecutionPhase.EXECUTION_CANCELLED,
+    });
+    try {
+        await cleanupActivities[UPDATE_WORKFLOW_EXECUTION_STATUS_ACTIVITY_NAME](executionId, statusToJson(cancelledStatus));
+        log.info("Updated execution status to CANCELLED", { executionId });
+    }
+    catch (error) {
+        log.warn("Failed to update execution status to CANCELLED", {
+            executionId,
+            error: errorMessage(error),
+        });
+    }
+}
+/**
+ * Deletes the ephemeral ExecutionContext (the fully-merged environment,
+ * including secrets) on a non-cancellable scope so cleanup runs on every
+ * exit path, cancellation included (Go's disconnected context). REGULAR
+ * activity (Go's v1 arm — agentexecution's Go uses a local activity here;
+ * this domain's Go does not, and the port follows ITS source). Errors are
+ * logged, never propagated. A failed cleanup is never retried — no TTL
+ * sweep exists (oss#892; the retired Go server's log claimed one that
+ * never did) — the row stays encrypted at rest (oss#535) and the WARN is
+ * the operator's signal.
+ */
+async function deleteExecutionContext(executionId) {
+    await CancellationScope.nonCancellable(async () => {
+        try {
+            await cleanupActivities[DELETE_EXECUTION_CONTEXT_ACTIVITY_NAME](executionId);
+            log.info("ExecutionContext cleaned up", { executionId });
+        }
+        catch (error) {
+            log.warn("ExecutionContext cleanup failed — nothing retries it; any remaining row stays encrypted at rest (operator cleanup)", {
+                executionId,
+                error: errorMessage(error),
+            });
+        }
+    });
+}
+// ─── Helpers ────────────────────────────────────────────────────────────
+/**
+ * Statuses cross the activity payload boundary as proto-JSON — the TS
+ * default payload converter cannot serialize typed messages' bigint
+ * int64 fields (sub-project 20260824.03 design rule). Server-internal:
+ * this worker's workflow is the only caller.
+ */
+function statusToJson(status) {
+    return toJson(WorkflowExecutionStatusSchema, status);
+}
+function findInCauseChain(error, ctor) {
+    for (let e = error; e instanceof Error; e = e.cause) {
+        if (e instanceof ctor) {
+            return e;
+        }
+    }
+    return undefined;
+}
+function errorMessage(error) {
+    return error instanceof Error ? error.message : String(error);
+}
+/**
+ * Joins the failure's message chain (Go's `%s` on a wrapped error renders
+ * every layer): "Child Workflow execution failed: child engine boom".
+ * Used for the persisted user-facing copy; logs keep the top message.
+ */
+function errorChainMessage(error) {
+    const messages = [];
+    for (let e = error; e instanceof Error; e = e.cause) {
+        if (e.message !== "") {
+            messages.push(e.message);
+        }
+    }
+    return messages.length > 0 ? messages.join(": ") : String(error);
+}
+//# sourceMappingURL=invoke-workflow-execution.js.map

package/dist/temporal/workflowexecution/workflows/invoke-workflow-execution.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"invoke-workflow-execution.js","sourceRoot":"","sources":["../../../../src/temporal/workflowexecution/workflows/invoke-workflow-execution.ts"],"names":[],"mappings":"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"}

package/dist/transport/console/assets.d.ts

@@ -0,0 +1,16 @@
+import type { Logger } from "../../boot/logger.js";
+import { type ConsoleFileIndex } from "./resolver.js";
+export interface ConsoleAssets {
+    /** Absolute filesystem root of the static export. */
+    readonly root: string;
+    /** "/"-rooted, "/"-separated file index the resolver consumes. */
+    readonly index: ConsoleFileIndex;
+    readonly fileCount: number;
+}
+/**
+ * Resolve and index the console export. Returns undefined — the modeled
+ * "not bundled" state, not an error — when neither the override nor the
+ * sibling exists.
+ */
+export declare function resolveConsoleAssets(overrideDir: string, logger: Logger): ConsoleAssets | undefined;
+//# sourceMappingURL=assets.d.ts.map

package/dist/transport/console/assets.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"assets.d.ts","sourceRoot":"","sources":["../../../src/transport/console/assets.ts"],"names":[],"mappings":"AAmBA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,sBAAsB,CAAC;AACnD,OAAO,EAAyB,KAAK,gBAAgB,EAAE,MAAM,eAAe,CAAC;AAE7E,MAAM,WAAW,aAAa;IAC5B,qDAAqD;IACrD,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,kEAAkE;IAClE,QAAQ,CAAC,KAAK,EAAE,gBAAgB,CAAC;IACjC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;CAC5B;AAED;;;;GAIG;AACH,wBAAgB,oBAAoB,CAClC,WAAW,EAAE,MAAM,EACnB,MAAM,EAAE,MAAM,GACb,aAAa,GAAG,SAAS,CA6B3B"}

package/dist/transport/console/assets.js

@@ -0,0 +1,66 @@
+/**
+ * Console asset discovery — locates the web console's static export and
+ * indexes it for the console lane. The discovery rule is the workflow
+ * bundles' sibling idiom (src/temporal/workflow-source.ts): the slim
+ * packaging emits `console/` next to main.js, where the bundled
+ * import.meta.url shim resolves it; in the tsc dist the sibling never
+ * exists, so dev/test servers boot without the lane unless
+ * STIGMER_CONSOLE_DIR points somewhere explicitly (the conformance and
+ * unit-test posture — the lane is wire-invisible when assets are absent).
+ *
+ * The export is indexed ONCE at composition: it is immutable for the
+ * server's lifetime (it shipped inside the same artifact — DD-012's
+ * no-skew property), so a boot-time scan buys O(1) resolution, an exact
+ * availability answer, and a pure resolver.
+ */
+import { readdirSync, statSync } from "node:fs";
+import path from "node:path";
+import { fileURLToPath } from "node:url";
+import { buildConsoleFileIndex } from "./resolver.js";
+/**
+ * Resolve and index the console export. Returns undefined — the modeled
+ * "not bundled" state, not an error — when neither the override nor the
+ * sibling exists.
+ */
+export function resolveConsoleAssets(overrideDir, logger) {
+    const sibling = fileURLToPath(new URL("./console/", import.meta.url));
+    const root = overrideDir !== "" ? path.resolve(overrideDir) : sibling;
+    let rootStat;
+    try {
+        rootStat = statSync(root);
+    }
+    catch {
+        return undefined;
+    }
+    if (!rootStat.isDirectory()) {
+        return undefined;
+    }
+    const files = [];
+    scan(root, "", files);
+    if (files.length === 0) {
+        // An empty directory serves nothing but would report "available" —
+        // treat it as absent and say why.
+        logger.warn("console asset directory is empty; console lane disabled", {
+            dir: root,
+        });
+        return undefined;
+    }
+    return {
+        root,
+        index: buildConsoleFileIndex(files),
+        fileCount: files.length,
+    };
+}
+/** Depth-first scan into "/"-separated index paths (never path.sep). */
+function scan(absoluteDir, indexPrefix, out) {
+    for (const entry of readdirSync(absoluteDir, { withFileTypes: true })) {
+        const indexPath = `${indexPrefix}/${entry.name}`;
+        if (entry.isDirectory()) {
+            scan(path.join(absoluteDir, entry.name), indexPath, out);
+        }
+        else if (entry.isFile()) {
+            out.push(indexPath);
+        }
+    }
+}
+//# sourceMappingURL=assets.js.map

package/dist/transport/console/assets.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"assets.js","sourceRoot":"","sources":["../../../src/transport/console/assets.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AACH,OAAO,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAChD,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAGzC,OAAO,EAAE,qBAAqB,EAAyB,MAAM,eAAe,CAAC;AAU7E;;;;GAIG;AACH,MAAM,UAAU,oBAAoB,CAClC,WAAmB,EACnB,MAAc;IAEd,MAAM,OAAO,GAAG,aAAa,CAAC,IAAI,GAAG,CAAC,YAAY,EAAE,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;IACtE,MAAM,IAAI,GAAG,WAAW,KAAK,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC;IAEtE,IAAI,QAAQ,CAAC;IACb,IAAI,CAAC;QACH,QAAQ,GAAG,QAAQ,CAAC,IAAI,CAAC,CAAC;IAC5B,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,SAAS,CAAC;IACnB,CAAC;IACD,IAAI,CAAC,QAAQ,CAAC,WAAW,EAAE,EAAE,CAAC;QAC5B,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,IAAI,CAAC,IAAI,EAAE,EAAE,EAAE,KAAK,CAAC,CAAC;IACtB,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACvB,mEAAmE;QACnE,kCAAkC;QAClC,MAAM,CAAC,IAAI,CAAC,yDAAyD,EAAE;YACrE,GAAG,EAAE,IAAI;SACV,CAAC,CAAC;QACH,OAAO,SAAS,CAAC;IACnB,CAAC;IACD,OAAO;QACL,IAAI;QACJ,KAAK,EAAE,qBAAqB,CAAC,KAAK,CAAC;QACnC,SAAS,EAAE,KAAK,CAAC,MAAM;KACxB,CAAC;AACJ,CAAC;AAED,wEAAwE;AACxE,SAAS,IAAI,CAAC,WAAmB,EAAE,WAAmB,EAAE,GAAa;IACnE,KAAK,MAAM,KAAK,IAAI,WAAW,CAAC,WAAW,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,EAAE,CAAC;QACtE,MAAM,SAAS,GAAG,GAAG,WAAW,IAAI,KAAK,CAAC,IAAI,EAAE,CAAC;QACjD,IAAI,KAAK,CAAC,WAAW,EAAE,EAAE,CAAC;YACxB,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,KAAK,CAAC,IAAI,CAAC,EAAE,SAAS,EAAE,GAAG,CAAC,CAAC;QAC3D,CAAC;aAAM,IAAI,KAAK,CAAC,MAAM,EAAE,EAAE,CAAC;YAC1B,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;QACtB,CAAC;IACH,CAAC;AACH,CAAC"}

package/dist/transport/console/handler.d.ts

@@ -0,0 +1,20 @@
+import type { Logger } from "../../boot/logger.js";
+import type { LaneHandler, LaneRequest } from "../lanes.js";
+import type { ConsoleAssets } from "./assets.js";
+/**
+ * Whether the console lane may claim this request. Exported for the lane
+ * router (server.ts), which stays a thin if-chain — the guard's knowledge
+ * of RPC path shapes belongs to this module.
+ */
+export declare function consoleLaneEligible(request: LaneRequest): boolean;
+export interface ConsoleLaneOptions {
+    readonly assets: ConsoleAssets;
+    /**
+     * Fallback port for the synthesized apiUrl when a request carries no
+     * Host/:authority (technically possible on HTTP/1.0-style clients).
+     */
+    readonly grpcPort: number;
+    readonly logger: Logger;
+}
+export declare function createConsoleLane(options: ConsoleLaneOptions): LaneHandler;
+//# sourceMappingURL=handler.d.ts.map

package/dist/transport/console/handler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"handler.d.ts","sourceRoot":"","sources":["../../../src/transport/console/handler.ts"],"names":[],"mappings":"AA+BA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,sBAAsB,CAAC;AACnD,OAAO,KAAK,EAAE,WAAW,EAAE,WAAW,EAAgB,MAAM,aAAa,CAAC;AAC1E,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAkBjD;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,WAAW,GAAG,OAAO,CAYjE;AAQD,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,MAAM,EAAE,aAAa,CAAC;IAC/B;;;OAGG;IACH,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB;AAED,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,kBAAkB,GAAG,WAAW,CA8C1E"}