@mysten-incubation/devstack 0.0.1 → 0.1.0

package/dist/plugins/host-service/index.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.mjs","names":["Logger"],"sources":["../../../src/plugins/host-service/index.ts"],"sourcesContent":["// Generic host-process service plugin.\n//\n// Use this for browser dev servers and other local host processes that\n// should be supervised by devstack rather than launched manually in a\n// sibling terminal.\n\nimport { Effect } from 'effect';\n\nimport { definePlugin, resource, type AnyResourceRef } from '../../api/define-plugin.ts';\nimport { pluginErrorContributions } from '../../api/plugin-errors.ts';\nimport {\n\tPortBrokerService,\n\ttype PortProbeHost,\n} from '../../substrate/runtime/port-broker/index.ts';\nimport { Logger } from '../../substrate/runtime/observability/index.ts';\nimport { CurrentPluginKey } from '../../substrate/runtime/current-plugin.ts';\n\nimport {\n\tHOST_SERVICE_ERROR_TAGS,\n\tHostServiceAcquireError,\n\ttype HostServiceConfigError,\n\ttype HostServiceError,\n} from './errors.ts';\nimport {\n\tacquireHostService,\n\tnormalizeHostServiceOptions,\n\tprepareHostService,\n\tHOST_SERVICE_PORT_TOKEN,\n\ttype HostServiceOptions,\n\ttype PreparedHostService,\n\ttype HostServiceResolvedOptions,\n\ttype HostServiceValue,\n\ttype HostServiceReadyProbe,\n\ttype HostProcessChild,\n\ttype HostProcessSpawner,\n\ttype HostProcessSpawnOptions,\n\ttype HostServiceAcquireContext,\n} from './service.ts';\nimport { HOST_SERVICE_DEFAULT_ENDPOINT_NAME, makeHostServiceRoutable } from './routable.ts';\n\nexport const hostServiceResourceId = <Name extends string>(name: Name): `host-service/${Name}` =>\n\t`host-service/${name}`;\n\nexport const hostServiceResource = <Name extends string>(name: Name) =>\n\tresource<`host-service/${Name}`, HostServiceValue>(hostServiceResourceId(name));\n\nconst hostServiceErrorContributions = pluginErrorContributions(HOST_SERVICE_ERROR_TAGS);\nconst HOST_SERVICE_PORT_PROBE_HOST: PortProbeHost = '0.0.0.0';\n\nexport type HostServiceAfter = ReadonlyArray<AnyResourceRef>;\n\nexport const hostService = <const After extends HostServiceAfter = readonly []>(\n\toptions: HostServiceOptions<After>,\n) => {\n\tconst normalized = normalizeHostServiceOptions(options);\n\tconst serviceResource = hostServiceResource(normalized.serviceName);\n\tconst after = options.after ?? ([] as unknown as After);\n\n\treturn definePlugin({\n\t\tid: serviceResource.id,\n\t\tdependsOn: after,\n\t\trole: 'service',\n\t\tstart: () =>\n\t\t\tEffect.gen(function* () {\n\t\t\t\tconst portBroker = yield* PortBrokerService;\n\t\t\t\tconst logger = yield* Logger;\n\t\t\t\tconst currentPlugin = yield* CurrentPluginKey;\n\t\t\t\tconst acquireContext = {\n\t\t\t\t\tallocatePort: (preferredPort) =>\n\t\t\t\t\t\tportBroker\n\t\t\t\t\t\t\t.allocate({\n\t\t\t\t\t\t\t\tkind: 'http',\n\t\t\t\t\t\t\t\tprobeHost: HOST_SERVICE_PORT_PROBE_HOST,\n\t\t\t\t\t\t\t\t...(preferredPort === undefined ? {} : { preferredPort }),\n\t\t\t\t\t\t\t})\n\t\t\t\t\t\t\t.pipe(Effect.map((allocation) => allocation.port)),\n\t\t\t\t\tlogger,\n\t\t\t\t\tpluginKey: currentPlugin.key,\n\t\t\t\t} satisfies HostServiceAcquireContext;\n\t\t\t\tconst prepared = yield* prepareHostService(normalized, acquireContext);\n\t\t\t\tyield* prepared.start;\n\t\t\t\treturn prepared.value;\n\t\t\t}),\n\t\terrorContributions: hostServiceErrorContributions,\n\t\tcapabilities: ({ value }) =>\n\t\t\t[\n\t\t\t\tmakeHostServiceRoutable({\n\t\t\t\t\tendpointName: value.endpointName,\n\t\t\t\t\tserviceName: value.name,\n\t\t\t\t\tport: value.port,\n\t\t\t\t}),\n\t\t\t] as const,\n\t});\n};\n\nexport type {\n\tHostServiceAcquireContext,\n\tHostServiceError,\n\tHostServiceOptions,\n\tPreparedHostService,\n\tHostServiceReadyProbe,\n\tHostServiceResolvedOptions,\n\tHostServiceValue,\n\tHostProcessChild,\n\tHostProcessSpawner,\n\tHostProcessSpawnOptions,\n\tHostServiceConfigError,\n};\nexport {\n\tacquireHostService,\n\tprepareHostService,\n\tHOST_SERVICE_DEFAULT_ENDPOINT_NAME,\n\tHOST_SERVICE_ERROR_TAGS,\n\tHOST_SERVICE_PORT_TOKEN,\n\tHostServiceAcquireError,\n\tmakeHostServiceRoutable,\n\tnormalizeHostServiceOptions,\n};\n"],"mappings":";;;;;;;;;;AAwCA,MAAa,yBAA8C,SAC1D,gBAAgB;AAEjB,MAAa,uBAA4C,SACxD,SAAmD,sBAAsB,KAAK,CAAC;AAEhF,MAAM,gCAAgC,yBAAyB,wBAAwB;AACvF,MAAM,+BAA8C;AAIpD,MAAa,eACZ,YACI;CACJ,MAAM,aAAa,4BAA4B,QAAQ;CACvD,MAAM,kBAAkB,oBAAoB,WAAW,YAAY;CACnE,MAAM,QAAQ,QAAQ,SAAU,EAAE;AAElC,QAAO,aAAa;EACnB,IAAI,gBAAgB;EACpB,WAAW;EACX,MAAM;EACN,aACC,OAAO,IAAI,aAAa;GACvB,MAAM,aAAa,OAAO;GAe1B,MAAM,WAAW,OAAO,mBAAmB,YAAY;IAXtD,eAAe,kBACd,WACE,SAAS;KACT,MAAM;KACN,WAAW;KACX,GAAI,kBAAkB,KAAA,IAAY,EAAE,GAAG,EAAE,eAAe;KACxD,CAAC,CACD,KAAK,OAAO,KAAK,eAAe,WAAW,KAAK,CAAC;IACpD,QAAA,OAXqBA;IAYrB,YAAW,OAXiB,kBAWH;IAE2C,CAAC;AACtE,UAAO,SAAS;AAChB,UAAO,SAAS;IACf;EACH,oBAAoB;EACpB,eAAe,EAAE,YAChB,CACC,wBAAwB;GACvB,cAAc,MAAM;GACpB,aAAa,MAAM;GACnB,MAAM,MAAM;GACZ,CAAC,CACF;EACF,CAAC"}
+{"version":3,"file":"index.mjs","names":["Logger"],"sources":["../../../src/plugins/host-service/index.ts"],"sourcesContent":["// Generic host-process service plugin.\n//\n// Use this for browser dev servers and other local host processes that\n// should be supervised by devstack rather than launched manually in a\n// sibling terminal.\n\nimport { Effect } from 'effect';\n\nimport { definePlugin, resource, type AnyResourceRef } from '../../api/define-plugin.ts';\nimport { pluginErrorContributions } from '../../api/plugin-errors.ts';\nimport {\n\tPortBrokerService,\n\ttype PortProbeHost,\n} from '../../substrate/runtime/port-broker/index.ts';\nimport { PostAcquireTasksService } from '../../substrate/runtime/post-acquire-tasks.ts';\nimport { Logger } from '../../substrate/runtime/observability/index.ts';\nimport { CurrentPluginKey } from '../../substrate/runtime/current-plugin.ts';\nimport { IdentityContext, RuntimeRoot } from '../../substrate/runtime/paths.ts';\nimport { renderUrl, routedHostname } from '../../substrate/runtime/routed-url.ts';\n\nimport {\n\tHOST_SERVICE_ERROR_TAGS,\n\tHostServiceAcquireError,\n\ttype HostServiceConfigError,\n\ttype HostServiceError,\n} from './errors.ts';\nimport {\n\tacquireHostService,\n\tnormalizeHostServiceOptions,\n\tprepareHostService,\n\tHOST_SERVICE_PORT_TOKEN,\n\ttype HostServiceOptions,\n\ttype PreparedHostService,\n\ttype HostServiceResolvedOptions,\n\ttype HostServiceValue,\n\ttype HostServiceReadyProbe,\n\ttype HostProcessChild,\n\ttype HostProcessSpawner,\n\ttype HostProcessSpawnOptions,\n\ttype HostServiceAcquireContext,\n} from './service.ts';\nimport {\n\tHOST_SERVICE_DEFAULT_ENDPOINT_NAME,\n\tHOST_SERVICE_DEFAULT_ENTRYPOINT_PORT,\n\tmakeHostServiceRoutable,\n} from './routable.ts';\n\nexport const hostServiceResourceId = <Name extends string>(name: Name): `host-service/${Name}` =>\n\t`host-service/${name}`;\n\nexport const hostServiceResource = <Name extends string>(name: Name) =>\n\tresource<`host-service/${Name}`, HostServiceValue>(hostServiceResourceId(name));\n\nconst hostServiceErrorContributions = pluginErrorContributions(HOST_SERVICE_ERROR_TAGS);\nconst HOST_SERVICE_PORT_PROBE_HOST: PortProbeHost = '0.0.0.0';\n\nexport type HostServiceAfter = ReadonlyArray<AnyResourceRef>;\n\nexport const hostService = <const After extends HostServiceAfter = readonly []>(\n\toptions: HostServiceOptions<After>,\n) => {\n\tconst normalized = normalizeHostServiceOptions(options);\n\tconst serviceResource = hostServiceResource(normalized.serviceName);\n\tconst after = options.after ?? ([] as unknown as After);\n\n\treturn definePlugin({\n\t\tid: serviceResource.id,\n\t\tdependsOn: after,\n\t\trole: 'service',\n\t\tsection: 'service',\n\t\tstart: () =>\n\t\t\tEffect.gen(function* () {\n\t\t\t\tconst portBroker = yield* PortBrokerService;\n\t\t\t\tconst logger = yield* Logger;\n\t\t\t\tconst currentPlugin = yield* CurrentPluginKey;\n\t\t\t\tconst postAcquireTasks = yield* PostAcquireTasksService;\n\t\t\t\t// Effective stack + runtime root for this supervised run, so\n\t\t\t\t// the host-service can publish them into the spawned child's\n\t\t\t\t// env. The Vite plugin runs IN that child and re-discovers the\n\t\t\t\t// manifest via `resolveDiscoveryEnv(process.env)`; `--stack` is\n\t\t\t\t// a CLI flag that never reaches the child otherwise. Sourced\n\t\t\t\t// from the same boot-wired `Identity` / `RuntimeRoot` the rest\n\t\t\t\t// of the run uses, so the values point at the real manifest at\n\t\t\t\t// `<root>/stacks/<stack>/manifest.json`.\n\t\t\t\tconst identity = yield* IdentityContext;\n\t\t\t\tconst { root: runtimeRoot } = yield* RuntimeRoot;\n\t\t\t\t// Best-effort canonical routed URL for this endpoint. This is the\n\t\t\t\t// URL the dev-wallet CORS allowlist accepts (the wallet allowlists\n\t\t\t\t// `routedHostname(identity, dev) : 5175`, NOT the raw Vite bind), so\n\t\t\t\t// publishing it as the host-service's `value.url` points `devstack\n\t\t\t\t// up` output (and any consumer holding the resolved value) at the\n\t\t\t\t// URL that pairs the wallet successfully. The routed entrypoint port is the\n\t\t\t\t// shared Traefik port for every built-in endpoint\n\t\t\t\t// (`HOST_SERVICE_DEFAULT_ENTRYPOINT_PORT` ===\n\t\t\t\t// `DEFAULT_ROUTER_ENTRYPOINT_PORT`); the role is THIS service's\n\t\t\t\t// `endpointName`, matching `makeHostServiceRoutable`'s\n\t\t\t\t// `dispatchId.role`. A hostname-validation failure (an\n\t\t\t\t// out-of-RFC-1035 app/stack/endpoint label) must NOT fail the\n\t\t\t\t// host-service boot — fall back to the raw loopback `value.url` via\n\t\t\t\t// `Effect.orElseSucceed(() => null)`. The raw bind still exists for\n\t\t\t\t// Vite's listen + the readiness probe (which derives its own\n\t\t\t\t// `127.0.0.1:<port>` literal independently of `value.url`).\n\t\t\t\tconst routedUrl = yield* routedHostname(identity, normalized.endpointName).pipe(\n\t\t\t\t\tEffect.map((hostname) =>\n\t\t\t\t\t\trenderUrl({\n\t\t\t\t\t\t\tprotocol: 'http',\n\t\t\t\t\t\t\thostname,\n\t\t\t\t\t\t\tport: HOST_SERVICE_DEFAULT_ENTRYPOINT_PORT,\n\t\t\t\t\t\t}),\n\t\t\t\t\t),\n\t\t\t\t\tEffect.orElseSucceed(() => null),\n\t\t\t\t);\n\t\t\t\tconst acquireContext = {\n\t\t\t\t\tallocatePort: (preferredPort) =>\n\t\t\t\t\t\tportBroker\n\t\t\t\t\t\t\t.allocate({\n\t\t\t\t\t\t\t\towner: `host-service:${normalized.serviceName}`,\n\t\t\t\t\t\t\t\tprobeHost: HOST_SERVICE_PORT_PROBE_HOST,\n\t\t\t\t\t\t\t\t...(preferredPort === undefined ? {} : { preferredPort }),\n\t\t\t\t\t\t\t})\n\t\t\t\t\t\t\t.pipe(Effect.map((allocation) => allocation.port)),\n\t\t\t\t\tlogger,\n\t\t\t\t\tpluginKey: currentPlugin.key,\n\t\t\t\t\tdiscoveryIdentity: { stack: identity.stack, runtimeRoot },\n\t\t\t\t\troutedUrl,\n\t\t\t\t} satisfies HostServiceAcquireContext;\n\t\t\t\tconst prepared = yield* prepareHostService(normalized, acquireContext);\n\t\t\t\tyield* postAcquireTasks.register({\n\t\t\t\t\tpluginKey: currentPlugin.key,\n\t\t\t\t\tlabel: `host-service:${normalized.serviceName}.start`,\n\t\t\t\t\trun: prepared.start,\n\t\t\t\t});\n\t\t\t\treturn prepared.value;\n\t\t\t}),\n\t\terrorContributions: hostServiceErrorContributions,\n\t\tcapabilities: ({ value }) =>\n\t\t\t[\n\t\t\t\tmakeHostServiceRoutable({\n\t\t\t\t\tendpointName: value.endpointName,\n\t\t\t\t\tserviceName: value.name,\n\t\t\t\t\tport: value.port,\n\t\t\t\t}),\n\t\t\t] as const,\n\t});\n};\n\nexport type {\n\tHostServiceAcquireContext,\n\tHostServiceError,\n\tHostServiceOptions,\n\tPreparedHostService,\n\tHostServiceReadyProbe,\n\tHostServiceResolvedOptions,\n\tHostServiceValue,\n\tHostProcessChild,\n\tHostProcessSpawner,\n\tHostProcessSpawnOptions,\n\tHostServiceConfigError,\n};\nexport {\n\tacquireHostService,\n\tprepareHostService,\n\tHOST_SERVICE_DEFAULT_ENDPOINT_NAME,\n\tHOST_SERVICE_DEFAULT_ENTRYPOINT_PORT,\n\tHOST_SERVICE_ERROR_TAGS,\n\tHOST_SERVICE_PORT_TOKEN,\n\tHostServiceAcquireError,\n\tmakeHostServiceRoutable,\n\tnormalizeHostServiceOptions,\n};\n"],"mappings":";;;;;;;;;;;;;;;;AA+CA,MAAa,yBAA8C,SAC1D,gBAAgB;AAEjB,MAAa,uBAA4C,SACxD,SAAmD,sBAAsB,KAAK,CAAC;AAEhF,MAAM,gCAAgC,yBAAyB,wBAAwB;AACvF,MAAM,+BAA8C;AAIpD,MAAa,eACZ,YACI;CACJ,MAAM,aAAa,4BAA4B,QAAQ;CACvD,MAAM,kBAAkB,oBAAoB,WAAW,YAAY;CACnE,MAAM,QAAQ,QAAQ,SAAU,EAAE;AAElC,QAAO,aAAa;EACnB,IAAI,gBAAgB;EACpB,WAAW;EACX,MAAM;EACN,SAAS;EACT,aACC,OAAO,IAAI,aAAa;GACvB,MAAM,aAAa,OAAO;GAC1B,MAAM,SAAS,OAAOA;GACtB,MAAM,gBAAgB,OAAO;GAC7B,MAAM,mBAAmB,OAAO;GAShC,MAAM,WAAW,OAAO;GACxB,MAAM,EAAE,MAAM,gBAAgB,OAAO;GAiBrC,MAAM,YAAY,OAAO,eAAe,UAAU,WAAW,aAAa,CAAC,KAC1E,OAAO,KAAK,aACX,UAAU;IACT,UAAU;IACV;IACA,MAAM;IACN,CAAC,CACF,EACD,OAAO,oBAAoB,KAAK,CAChC;GAeD,MAAM,WAAW,OAAO,mBAAmB,YAAY;IAbtD,eAAe,kBACd,WACE,SAAS;KACT,OAAO,gBAAgB,WAAW;KAClC,WAAW;KACX,GAAI,kBAAkB,KAAA,IAAY,EAAE,GAAG,EAAE,eAAe;KACxD,CAAC,CACD,KAAK,OAAO,KAAK,eAAe,WAAW,KAAK,CAAC;IACpD;IACA,WAAW,cAAc;IACzB,mBAAmB;KAAE,OAAO,SAAS;KAAO;KAAa;IACzD;IAEoE,CAAC;AACtE,UAAO,iBAAiB,SAAS;IAChC,WAAW,cAAc;IACzB,OAAO,gBAAgB,WAAW,YAAY;IAC9C,KAAK,SAAS;IACd,CAAC;AACF,UAAO,SAAS;IACf;EACH,oBAAoB;EACpB,eAAe,EAAE,YAChB,CACC,wBAAwB;GACvB,cAAc,MAAM;GACpB,aAAa,MAAM;GACnB,MAAM,MAAM;GACZ,CAAC,CACF;EACF,CAAC"}

package/dist/plugins/host-service/routable.mjs

@@ -16,7 +16,8 @@ const makeHostServiceRoutable = (parts) => ({
 		port: parts.port
 	},
 	cors: true,
-	wireProtocol: "http"
+	wireProtocol: "http",
+	readiness: "deferred"
 });
 //#endregion
 export { HOST_SERVICE_DEFAULT_ENTRYPOINT_PORT, HOST_SERVICE_ENTRYPOINTS, makeHostServiceRoutable };

package/dist/plugins/host-service/routable.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"routable.mjs","names":[],"sources":["../../../src/plugins/host-service/routable.ts"],"sourcesContent":["import type { EntrypointDecl, RoutableDecl } from '../../contracts/routable.ts';\n\nexport const HOST_SERVICE_DEFAULT_ENDPOINT_NAME = 'dev' as const;\nexport const HOST_SERVICE_DEFAULT_ENTRYPOINT_PORT = 5175;\n\nexport const HOST_SERVICE_ENTRYPOINTS: ReadonlyArray<EntrypointDecl> = [\n\t{\n\t\tname: HOST_SERVICE_DEFAULT_ENDPOINT_NAME,\n\t\tport: HOST_SERVICE_DEFAULT_ENTRYPOINT_PORT,\n\t\tprotocol: 'http',\n\t},\n];\n\nexport const makeHostServiceRoutable = (parts: {\n\treadonly endpointName: string;\n\treadonly serviceName: string;\n\treadonly port: number;\n}): RoutableDecl => ({\n\tkind: 'routable',\n\tendpointName: parts.endpointName,\n\tdispatchId: {\n\t\tserviceKey: `host-service.${parts.serviceName}`,\n\t\trole: parts.endpointName,\n\t},\n\tupstream: { type: 'host-loopback', port: parts.port },\n\tcors: true,\n\twireProtocol: 'http',\n});\n"],"mappings":"AAGA,MAAa,uCAAuC;AAEpD,MAAa,2BAA0D,CACtE;CACC,MAAA;CACA,MAAM;CACN,UAAU;CACV,CACD;AAED,MAAa,2BAA2B,WAInB;CACpB,MAAM;CACN,cAAc,MAAM;CACpB,YAAY;EACX,YAAY,gBAAgB,MAAM;EAClC,MAAM,MAAM;EACZ;CACD,UAAU;EAAE,MAAM;EAAiB,MAAM,MAAM;EAAM;CACrD,MAAM;CACN,cAAc;CACd"}
+{"version":3,"file":"routable.mjs","names":[],"sources":["../../../src/plugins/host-service/routable.ts"],"sourcesContent":["import type { EntrypointDecl, RoutableDecl } from '../../contracts/routable.ts';\n\nexport const HOST_SERVICE_DEFAULT_ENDPOINT_NAME = 'dev' as const;\nexport const HOST_SERVICE_DEFAULT_ENTRYPOINT_PORT = 5175;\n\nexport const HOST_SERVICE_ENTRYPOINTS: ReadonlyArray<EntrypointDecl> = [\n\t{\n\t\tname: HOST_SERVICE_DEFAULT_ENDPOINT_NAME,\n\t\tport: HOST_SERVICE_DEFAULT_ENTRYPOINT_PORT,\n\t\tprotocol: 'http',\n\t},\n];\n\nexport const makeHostServiceRoutable = (parts: {\n\treadonly endpointName: string;\n\treadonly serviceName: string;\n\treadonly port: number;\n}): RoutableDecl => ({\n\tkind: 'routable',\n\tendpointName: parts.endpointName,\n\tdispatchId: {\n\t\tserviceKey: `host-service.${parts.serviceName}`,\n\t\trole: parts.endpointName,\n\t},\n\tupstream: { type: 'host-loopback', port: parts.port },\n\tcors: true,\n\twireProtocol: 'http',\n\treadiness: 'deferred',\n});\n"],"mappings":"AAGA,MAAa,uCAAuC;AAEpD,MAAa,2BAA0D,CACtE;CACC,MAAA;CACA,MAAM;CACN,UAAU;CACV,CACD;AAED,MAAa,2BAA2B,WAInB;CACpB,MAAM;CACN,cAAc,MAAM;CACpB,YAAY;EACX,YAAY,gBAAgB,MAAM;EAClC,MAAM,MAAM;EACZ;CACD,UAAU;EAAE,MAAM;EAAiB,MAAM,MAAM;EAAM;CACrD,MAAM;CACN,cAAc;CACd,WAAW;CACX"}

package/dist/plugins/host-service/service.d.mts

@@ -10,6 +10,14 @@ type HostServiceReadyProbe = {
   readonly intervalMs?: number;
 } | {
   readonly kind: 'log';
+  /** Pattern matched against each stdout/stderr line. `string` is a
+   *  fast substring match. `RegExp` is evaluated via `.test(line)`
+   *  per line and runs synchronously on the observer fiber —
+   *  AVOID catastrophic-backtracking shapes like `(a+)+b` or
+   *  `(a|a)*c` which can wedge the fiber on adversarial output.
+   *  Prefer anchored, non-nested-quantifier patterns. The
+   *  plugin emits a one-time warning at registration if it
+   *  detects nested-quantifier shapes. */
   readonly pattern: string | RegExp;
   readonly stream?: 'stdout' | 'stderr' | 'both';
   readonly timeoutMs?: number;
@@ -41,7 +49,20 @@ interface HostServiceValue {
   readonly command: string;
   readonly args: ReadonlyArray<string>;
   readonly cwd: string;
+  /** The real loopback port the child (Vite) binds. Always the bound
+   *  port, regardless of how `url` is shaped — readiness probes and
+   *  direct host tooling read this. */
   readonly port: number;
+  /** Canonical URL for this service: the router-fronted routed origin
+   *  (`http://<endpoint>.<stack?>.<app>.localhost:5175`) when the
+   *  supervisor derived one, the raw `http://127.0.0.1:<port>` loopback
+   *  bind otherwise. The routed form is what the dev-wallet CORS
+   *  allowlist accepts, so any consumer that hands this URL to a browser
+   *  — `devstack up` output, an app or build integration holding the
+   *  resolved `HostServiceValue` — gets a working wallet pairing.
+   *  Consumers that need the bind target read `port`. Mirrors
+   *  `WalletValue.url` ("router-fronted when available, loopback
+   *  otherwise"). */
   readonly url: string;
 }
 //#endregion

package/dist/plugins/host-service/service.mjs

@@ -1,8 +1,10 @@
-import { observeProcessLines, readableToByteStream } from "../../substrate/runtime/observability/process-lines.mjs";
 import { SpanAttr } from "../../substrate/runtime/observability/spans.mjs";
-import { expectNonEmptyString, expectOneOf, expectOptionalNonEmptyString, expectOptionalPort, expectOptionalPositiveInteger, expectStringRecord } from "../../substrate/runtime/config-validation.mjs";
-import { waitForHttpEndpoint } from "../../substrate/runtime/http-probe.mjs";
+import { observeProcessLines, readableToByteStream } from "../../substrate/runtime/observability/process-lines.mjs";
+import "../../substrate/runtime/observability/index.mjs";
 import { awaitManagedProcessReady, describeProcessExitStatus, nodeProcessSpawner, onceProcessError, onceProcessExit, terminateManagedProcess } from "../../substrate/runtime/process-supervisor.mjs";
+import { waitForHttpEndpoint } from "../../substrate/runtime/http-probe.mjs";
+import "./routable.mjs";
+import { expectNonEmptyString, expectOptionalPositiveInteger } from "../../substrate/runtime/config-validation.mjs";
 import { HostServiceAcquireError, hostServiceConfigError } from "./errors.mjs";
 import { Effect, Exit, Ref } from "effect";
 import { resolve } from "node:path";
@@ -12,6 +14,11 @@ const DEFAULT_SHUTDOWN_GRACE_MS = 5e3;
 const DEFAULT_HTTP_READY_TIMEOUT_MS = 6e4;
 const DEFAULT_HTTP_READY_INTERVAL_MS = 250;
 const DEFAULT_LOG_READY_TIMEOUT_MS = 6e4;
+const READY_STREAM_VALUES = [
+	"stdout",
+	"stderr",
+	"both"
+];
 const shellInvocationFor = (script) => {
 	if (process.platform === "win32") return {
 		command: process.env.ComSpec ?? process.env.COMSPEC ?? "cmd.exe",
@@ -32,7 +39,7 @@ const normalizeReadyProbe = (serviceName, ready) => {
 	if (ready === void 0) return void 0;
 	const mkError = configErrorFor(serviceName);
 	if (ready.kind === "http") {
-		expectOptionalNonEmptyString(ready.url, {
+		if (ready.url !== void 0) expectNonEmptyString(ready.url, {
 			field: "ready.url",
 			mkError
 		});
@@ -51,13 +58,9 @@ const normalizeReadyProbe = (serviceName, ready) => {
 			field: "ready.pattern",
 			message: "must be a string or RegExp"
 		});
-		if (ready.stream !== void 0) expectOneOf(ready.stream, [
-			"stdout",
-			"stderr",
-			"both"
-		], {
+		if (ready.stream !== void 0 && !READY_STREAM_VALUES.includes(ready.stream)) throw mkError({
 			field: "ready.stream",
-			mkError
+			message: "must be one of 'stdout', 'stderr', 'both'"
 		});
 		expectOptionalPositiveInteger(ready.timeoutMs, {
 			field: "ready.timeoutMs",
@@ -97,15 +100,30 @@ const normalizeHostServiceOptions = (options) => {
 		field: "args",
 		message: "args are only supported with command"
 	});
-	const preferredPort = expectOptionalPort(options.port, {
+	if (options.port !== void 0 && !(typeof options.port === "number" && Number.isInteger(options.port) && options.port > 0 && options.port <= 65535)) throw mkError({
 		field: "port",
-		mkError
+		message: "must be an integer between 1 and 65535"
 	});
+	const preferredPort = options.port;
 	const cwd = resolve(options.cwd ?? process.cwd());
-	const env = expectStringRecord(options.env, {
-		field: "env",
-		mkError
-	});
+	const rawEnv = options.env;
+	if (rawEnv !== void 0) {
+		if (typeof rawEnv !== "object" || rawEnv === null || Array.isArray(rawEnv)) throw mkError({
+			field: "env",
+			message: "must be an object of string values"
+		});
+		for (const [key, entry] of Object.entries(rawEnv)) {
+			if (key.length === 0) throw mkError({
+				field: "env",
+				message: "environment variable names must be non-empty"
+			});
+			if (typeof entry !== "string") throw mkError({
+				field: `env.${key}`,
+				message: "must be a string"
+			});
+		}
+	}
+	const env = rawEnv ?? {};
 	const shutdownGraceMs = expectOptionalPositiveInteger(options.shutdownGraceMs, {
 		field: "shutdownGraceMs",
 		mkError
@@ -134,6 +152,19 @@ const normalizeHostServiceOptions = (options) => {
 	};
 };
 const renderPortToken = (value, port) => value.replaceAll(HOST_SERVICE_PORT_TOKEN, String(port));
+/** Heuristic: catastrophic-backtracking patterns typically nest a
+*  quantifier inside another quantifier (e.g. `(a+)+`, `(a*)*`,
+*  `(a|a)*`). This is intentionally conservative — it flags clearly
+*  risky shapes without trying to be a real ReDoS analyzer. The
+*  guard runs once at host-service start and only emits a warning,
+*  not a fail-stop. */
+const looksRedosProne = (pattern) => {
+	const source = pattern.source;
+	if (/\)[*+?](?:\{[^}]*\})?[*+?]/.test(source)) return true;
+	if (/\([^()]*[*+?][^()]*\)[*+?]/.test(source)) return true;
+	if (/\([^()]*\|[^()]*\)[*+]/.test(source)) return true;
+	return false;
+};
 const renderCommand = (options, port) => {
 	const renderedEnv = {};
 	for (const [key, value] of Object.entries(options.env)) renderedEnv[key] = renderPortToken(value, port);
@@ -143,14 +174,14 @@ const renderCommand = (options, port) => {
 		env: renderedEnv
 	};
 };
-const hostServiceValue = (options, port, rendered) => ({
+const hostServiceValue = (options, port, rendered, routedUrl) => ({
 	name: options.serviceName,
 	endpointName: options.endpointName,
 	command: rendered.command,
 	args: rendered.args,
 	cwd: options.cwd,
 	port,
-	url: `http://127.0.0.1:${port}`
+	url: routedUrl ?? `http://127.0.0.1:${port}`
 });
 const terminateChild = (child, timeoutMs, logger, pluginKey, tag) => terminateManagedProcess(child, {
 	graceMs: timeoutMs,
@@ -166,7 +197,8 @@ const httpReady = (url, timeoutMs, intervalMs, exit, processError, error) => awa
 		endpoint: url,
 		timeoutMs,
 		intervalMs,
-		validate: () => true
+		requestInit: { redirect: "manual" },
+		validate: (response) => response.status === 200
 	}).pipe(Effect.mapError((cause) => new HostServiceAcquireError({
 		...error,
 		phase: "ready",
@@ -202,9 +234,22 @@ const logReady = (ready, readySignal, exit, processError, error) => awaitManaged
 			readySignal.then(() => {
 				clearTimeout(timeout);
 				resolveReady();
+			}, (cause) => {
+				clearTimeout(timeout);
+				rejectReady(cause);
 			});
 		}),
-		catch: (cause) => cause instanceof HostServiceAcquireError ? cause : error
+		catch: (cause) => cause instanceof HostServiceAcquireError ? cause : new HostServiceAcquireError({
+			serviceName: error.serviceName,
+			cwd: error.cwd,
+			command: error.command,
+			args: error.args,
+			phase: error.phase,
+			message: error.message,
+			exitCode: error.exitCode,
+			signal: error.signal,
+			cause
+		})
 	}),
 	exit,
 	processError,
@@ -234,11 +279,24 @@ const allocateHostPort = (options, ctx) => ctx.allocatePort(options.preferredPor
 const startHostProcess = (options, ctx, port) => Effect.gen(function* () {
 	const rendered = renderCommand(options, port);
 	const env = {
+		...ctx.discoveryIdentity === void 0 ? {} : {
+			DEVSTACK_STACK: ctx.discoveryIdentity.stack,
+			DEVSTACK_RUNTIME_ROOT: ctx.discoveryIdentity.runtimeRoot
+		},
 		...ctx.processEnv ?? process.env,
 		...rendered.env,
 		PORT: String(port)
 	};
 	const tag = `host-service/${options.serviceName}`;
+	if (options.ready?.kind === "log" && options.ready.pattern instanceof RegExp && looksRedosProne(options.ready.pattern)) yield* ctx.logger.log(tag, ctx.pluginKey, {
+		level: "warn",
+		message: "host service readiness pattern has a nested-quantifier shape that may exhibit catastrophic backtracking on adversarial output; prefer anchored, non-nested patterns",
+		fields: {
+			[SpanAttr.serviceName]: options.serviceName,
+			[SpanAttr.event]: "host-service.ready-pattern.redos-warning",
+			"host-service.ready-pattern.source": options.ready.pattern.source
+		}
+	});
 	let resolveLogReady;
 	const logReadySignal = options.ready?.kind === "log" ? new Promise((resolveReady) => {
 		resolveLogReady = resolveReady;
@@ -249,47 +307,50 @@ const startHostProcess = (options, ctx, port) => Effect.gen(function* () {
 		if (typeof options.ready.pattern === "string" ? line.includes(options.ready.pattern) : options.ready.pattern.test(line)) resolveLogReady?.();
 	};
 	const spawnChild = ctx.spawner ?? nodeProcessSpawner;
-	const child = yield* Effect.try({
-		try: () => spawnChild(rendered.command, rendered.args, {
-			cwd: options.cwd,
-			env,
-			stdio: "pipe",
-			detached: process.platform !== "win32"
-		}),
-		catch: (cause) => new HostServiceAcquireError({
-			serviceName: options.serviceName,
-			cwd: options.cwd,
-			command: rendered.command,
-			args: rendered.args,
-			phase: "spawn",
-			message: "host service spawn failed",
-			cause
-		})
-	});
 	let shuttingDown = false;
 	let exitStatus = null;
+	const child = yield* Effect.uninterruptible(Effect.gen(function* () {
+		const spawned = yield* Effect.try({
+			try: () => spawnChild(rendered.command, rendered.args, {
+				cwd: options.cwd,
+				env,
+				stdio: "pipe",
+				detached: process.platform !== "win32"
+			}),
+			catch: (cause) => new HostServiceAcquireError({
+				serviceName: options.serviceName,
+				cwd: options.cwd,
+				command: rendered.command,
+				args: rendered.args,
+				phase: "spawn",
+				message: "host service spawn failed",
+				cause
+			})
+		});
+		yield* observeProcessLines({
+			stdout: readableToByteStream(spawned.stdout),
+			stderr: readableToByteStream(spawned.stderr)
+		}, {
+			logger: ctx.logger,
+			pluginKey: ctx.pluginKey,
+			tag,
+			fields: { [SpanAttr.serviceName]: options.serviceName },
+			onLine: ({ line, stream }) => Effect.sync(() => {
+				observeReadinessLine(line, stream);
+			})
+		});
+		yield* Effect.addFinalizer(() => Effect.gen(function* () {
+			shuttingDown = true;
+			if (exitStatus !== null) return;
+			yield* terminateChild(spawned, options.shutdownGraceMs, ctx.logger, ctx.pluginKey, tag);
+		}));
+		return spawned;
+	}));
 	const exited = onceProcessExit(child).then((status) => {
 		exitStatus = status;
 		return status;
 	});
 	const processError = onceProcessError(child);
-	yield* observeProcessLines({
-		stdout: readableToByteStream(child.stdout),
-		stderr: readableToByteStream(child.stderr)
-	}, {
-		logger: ctx.logger,
-		pluginKey: ctx.pluginKey,
-		tag,
-		fields: { [SpanAttr.serviceName]: options.serviceName },
-		onLine: ({ line, stream }) => Effect.sync(() => {
-			observeReadinessLine(line, stream);
-		})
-	});
-	yield* Effect.addFinalizer(() => Effect.gen(function* () {
-		shuttingDown = true;
-		if (exitStatus !== null) return;
-		yield* terminateChild(child, options.shutdownGraceMs, ctx.logger, ctx.pluginKey, tag);
-	}));
 	const baseError = new HostServiceAcquireError({
 		serviceName: options.serviceName,
 		cwd: options.cwd,
@@ -328,32 +389,26 @@ const startHostProcess = (options, ctx, port) => Effect.gen(function* () {
 		if (exitStatus === null) yield* terminateChild(child, options.shutdownGraceMs, ctx.logger, ctx.pluginKey, tag);
 		return yield* Effect.failCause(readinessExit.cause);
 	}
-	exited.then((status) => {
-		if (shuttingDown) return;
-		Effect.runPromise(ctx.logger.log(tag, ctx.pluginKey, {
-			level: "error",
-			message: "host service exited after readiness",
-			fields: {
-				[SpanAttr.event]: "process.exited",
-				[SpanAttr.serviceName]: options.serviceName,
-				[SpanAttr.exitCode]: status.code,
-				[SpanAttr.exitSignal]: status.signal,
-				[SpanAttr.exitStatus]: describeProcessExitStatus(status)
-			}
-		})).catch(() => {});
-	});
-	processError.then((cause) => {
-		if (shuttingDown) return;
-		Effect.runPromise(ctx.logger.log(tag, ctx.pluginKey, {
-			level: "error",
-			message: "host service process emitted an error after readiness",
-			fields: {
-				[SpanAttr.event]: "process.error",
-				[SpanAttr.serviceName]: options.serviceName,
-				[SpanAttr.errorCause]: cause
-			}
-		})).catch(() => {});
-	});
+	yield* Effect.forkScoped(Effect.promise(() => exited).pipe(Effect.flatMap((status) => shuttingDown ? Effect.void : ctx.logger.log(tag, ctx.pluginKey, {
+		level: "error",
+		message: "host service exited after readiness",
+		fields: {
+			[SpanAttr.event]: "process.exited",
+			[SpanAttr.serviceName]: options.serviceName,
+			[SpanAttr.exitCode]: status.code,
+			[SpanAttr.exitSignal]: status.signal,
+			[SpanAttr.exitStatus]: describeProcessExitStatus(status)
+		}
+	}))));
+	yield* Effect.forkScoped(Effect.promise(() => processError).pipe(Effect.flatMap((cause) => shuttingDown ? Effect.void : ctx.logger.log(tag, ctx.pluginKey, {
+		level: "error",
+		message: "host service process emitted an error after readiness",
+		fields: {
+			[SpanAttr.event]: "process.error",
+			[SpanAttr.serviceName]: options.serviceName,
+			[SpanAttr.errorCause]: cause
+		}
+	}))));
 });
 const prepareHostService = (options, ctx) => Effect.gen(function* () {
 	const port = yield* allocateHostPort(options, ctx);
@@ -365,7 +420,7 @@ const prepareHostService = (options, ctx) => Effect.gen(function* () {
 		yield* Ref.set(started, true);
 	});
 	return {
-		value: hostServiceValue(options, port, rendered),
+		value: hostServiceValue(options, port, rendered, ctx.routedUrl ?? null),
 		start
 	};
 });

package/dist/plugins/host-service/service.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"service.mjs","names":[],"sources":["../../../src/plugins/host-service/service.ts"],"sourcesContent":["import { resolve } from 'node:path';\n\nimport { Effect, Exit, Ref } from 'effect';\nimport type { Scope } from 'effect';\n\nimport type { PluginKey } from '../../substrate/brand.ts';\nimport type { AnyResourceRef } from '../../api/define-plugin.ts';\nimport {\n\texpectNonEmptyString,\n\texpectOneOf,\n\texpectOptionalNonEmptyString,\n\texpectOptionalPort,\n\texpectOptionalPositiveInteger,\n\texpectStringRecord,\n} from '../../substrate/runtime/config-validation.ts';\nimport {\n\tobserveProcessLines,\n\treadableToByteStream,\n\tSpanAttr,\n\ttype LoggerShape,\n} from '../../substrate/runtime/observability/index.ts';\nimport { waitForHttpEndpoint } from '../../substrate/runtime/http-probe.ts';\nimport type { PortBrokerError } from '../../substrate/runtime/port-broker/index.ts';\nimport {\n\tawaitManagedProcessReady,\n\tdescribeProcessExitStatus,\n\tnodeProcessSpawner,\n\tonceProcessError,\n\tonceProcessExit,\n\tterminateManagedProcess,\n\ttype ManagedProcessChild,\n\ttype ManagedProcessSpawner,\n\ttype ManagedProcessSpawnOptions,\n} from '../../substrate/runtime/process-supervisor.ts';\n\nimport { HOST_SERVICE_DEFAULT_ENDPOINT_NAME } from './routable.ts';\nimport { hostServiceConfigError, HostServiceAcquireError } from './errors.ts';\n\nexport const HOST_SERVICE_PORT_TOKEN = '{port}' as const;\n\nexport type HostServiceReadyProbe =\n\t| {\n\t\t\treadonly kind: 'http';\n\t\t\treadonly url?: string;\n\t\t\treadonly timeoutMs?: number;\n\t\t\treadonly intervalMs?: number;\n\t  }\n\t| {\n\t\t\treadonly kind: 'log';\n\t\t\treadonly pattern: string | RegExp;\n\t\t\treadonly stream?: 'stdout' | 'stderr' | 'both';\n\t\t\treadonly timeoutMs?: number;\n\t  };\n\ninterface HostServiceBaseOptions<After extends ReadonlyArray<AnyResourceRef>> {\n\treadonly name?: string;\n\treadonly endpointName?: string;\n\treadonly after?: After;\n\treadonly cwd?: string;\n\treadonly port?: number;\n\treadonly env?: Readonly<Record<string, string>>;\n\treadonly ready?: HostServiceReadyProbe;\n\treadonly shutdownGraceMs?: number;\n}\n\ninterface HostServiceCommandOptions<\n\tAfter extends ReadonlyArray<AnyResourceRef>,\n> extends HostServiceBaseOptions<After> {\n\treadonly command: string;\n\treadonly args?: ReadonlyArray<string>;\n\treadonly script?: never;\n}\n\ninterface HostServiceScriptOptions<\n\tAfter extends ReadonlyArray<AnyResourceRef>,\n> extends HostServiceBaseOptions<After> {\n\treadonly script: string;\n\treadonly command?: never;\n\treadonly args?: never;\n}\n\nexport type HostServiceOptions<\n\tAfter extends ReadonlyArray<AnyResourceRef> = ReadonlyArray<AnyResourceRef>,\n> = HostServiceCommandOptions<After> | HostServiceScriptOptions<After>;\n\nexport interface HostServiceResolvedOptions {\n\treadonly serviceName: string;\n\treadonly endpointName: string;\n\treadonly command: string;\n\treadonly args: ReadonlyArray<string>;\n\treadonly cwd: string;\n\treadonly preferredPort?: number;\n\treadonly env: Readonly<Record<string, string>>;\n\treadonly ready?: HostServiceReadyProbe;\n\treadonly shutdownGraceMs: number;\n}\n\nexport interface HostServiceValue {\n\treadonly name: string;\n\treadonly endpointName: string;\n\treadonly command: string;\n\treadonly args: ReadonlyArray<string>;\n\treadonly cwd: string;\n\treadonly port: number;\n\treadonly url: string;\n}\n\nexport interface PreparedHostService {\n\treadonly value: HostServiceValue;\n\treadonly start: Effect.Effect<void, HostServiceAcquireError, Scope.Scope>;\n}\n\nexport type HostProcessChild = ManagedProcessChild;\nexport type HostProcessSpawnOptions = ManagedProcessSpawnOptions;\nexport type HostProcessSpawner = ManagedProcessSpawner;\n\nexport interface HostServiceAcquireContext {\n\treadonly allocatePort: (\n\t\tpreferredPort: number | undefined,\n\t) => Effect.Effect<number, PortBrokerError, Scope.Scope>;\n\treadonly logger: LoggerShape;\n\treadonly pluginKey: PluginKey;\n\treadonly spawner?: HostProcessSpawner;\n\treadonly processEnv?: NodeJS.ProcessEnv;\n}\n\nconst DEFAULT_SHUTDOWN_GRACE_MS = 5_000;\nconst DEFAULT_HTTP_READY_TIMEOUT_MS = 60_000;\nconst DEFAULT_HTTP_READY_INTERVAL_MS = 250;\nconst DEFAULT_LOG_READY_TIMEOUT_MS = 60_000;\n\nconst shellInvocationFor = (script: string): { command: string; args: ReadonlyArray<string> } => {\n\tif (process.platform === 'win32') {\n\t\treturn {\n\t\t\tcommand: process.env.ComSpec ?? process.env.COMSPEC ?? 'cmd.exe',\n\t\t\targs: ['/d', '/s', '/c', script],\n\t\t};\n\t}\n\treturn {\n\t\tcommand: '/bin/sh',\n\t\targs: ['-c', script],\n\t};\n};\n\nconst configErrorFor =\n\t(serviceName: string) => (issue: Parameters<typeof hostServiceConfigError>[1]) =>\n\t\thostServiceConfigError(serviceName, issue);\n\nconst normalizeReadyProbe = (\n\tserviceName: string,\n\tready: HostServiceReadyProbe | undefined,\n): HostServiceReadyProbe | undefined => {\n\tif (ready === undefined) return undefined;\n\tconst mkError = configErrorFor(serviceName);\n\tif (ready.kind === 'http') {\n\t\texpectOptionalNonEmptyString(ready.url, { field: 'ready.url', mkError });\n\t\texpectOptionalPositiveInteger(ready.timeoutMs, { field: 'ready.timeoutMs', mkError });\n\t\texpectOptionalPositiveInteger(ready.intervalMs, { field: 'ready.intervalMs', mkError });\n\t\treturn ready;\n\t}\n\tif (ready.kind === 'log') {\n\t\tif (typeof ready.pattern !== 'string' && !(ready.pattern instanceof RegExp)) {\n\t\t\tthrow mkError({ field: 'ready.pattern', message: 'must be a string or RegExp' });\n\t\t}\n\t\tif (ready.stream !== undefined) {\n\t\t\texpectOneOf(ready.stream, ['stdout', 'stderr', 'both'] as const, {\n\t\t\t\tfield: 'ready.stream',\n\t\t\t\tmkError,\n\t\t\t});\n\t\t}\n\t\texpectOptionalPositiveInteger(ready.timeoutMs, { field: 'ready.timeoutMs', mkError });\n\t\treturn ready;\n\t}\n\tthrow mkError({ field: 'ready.kind', message: \"must be 'http' or 'log'\" });\n};\n\nexport const normalizeHostServiceOptions = (\n\toptions: HostServiceOptions,\n): HostServiceResolvedOptions => {\n\tconst endpointName = options.endpointName ?? HOST_SERVICE_DEFAULT_ENDPOINT_NAME;\n\tconst serviceName = options.name ?? endpointName;\n\tconst mkError = configErrorFor(serviceName);\n\texpectNonEmptyString(serviceName, { field: 'name', mkError });\n\texpectNonEmptyString(endpointName, { field: 'endpointName', mkError });\n\n\tconst rawCommand = (options as { readonly command?: unknown }).command;\n\tconst rawArgs = (options as { readonly args?: unknown }).args;\n\tconst rawScript = (options as { readonly script?: unknown }).script;\n\tif (rawCommand !== undefined && rawScript !== undefined) {\n\t\tthrow mkError({ field: 'command', message: 'use either command or script, not both' });\n\t}\n\tif (rawCommand === undefined && rawScript === undefined) {\n\t\tthrow mkError({ field: 'command', message: 'is required unless script is provided' });\n\t}\n\tif (rawScript !== undefined && rawArgs !== undefined) {\n\t\tthrow mkError({ field: 'args', message: 'args are only supported with command' });\n\t}\n\n\tconst preferredPort = expectOptionalPort(options.port, { field: 'port', mkError });\n\tconst cwd = resolve(options.cwd ?? process.cwd());\n\tconst env = expectStringRecord(options.env, { field: 'env', mkError });\n\tconst shutdownGraceMs =\n\t\texpectOptionalPositiveInteger(options.shutdownGraceMs, {\n\t\t\tfield: 'shutdownGraceMs',\n\t\t\tmkError,\n\t\t}) ?? DEFAULT_SHUTDOWN_GRACE_MS;\n\tconst ready = normalizeReadyProbe(serviceName, options.ready);\n\tconst invocation =\n\t\trawScript !== undefined\n\t\t\t? shellInvocationFor(expectNonEmptyString(rawScript, { field: 'script', mkError }))\n\t\t\t: {\n\t\t\t\t\tcommand: expectNonEmptyString(rawCommand, { field: 'command', mkError }),\n\t\t\t\t\targs: options.args ?? [],\n\t\t\t\t};\n\n\treturn {\n\t\tserviceName,\n\t\tendpointName,\n\t\tcommand: invocation.command,\n\t\targs: invocation.args,\n\t\tcwd,\n\t\t...(preferredPort === undefined ? {} : { preferredPort }),\n\t\tenv,\n\t\t...(ready === undefined ? {} : { ready }),\n\t\tshutdownGraceMs,\n\t};\n};\n\nconst renderPortToken = (value: string, port: number): string =>\n\tvalue.replaceAll(HOST_SERVICE_PORT_TOKEN, String(port));\n\nconst renderCommand = (\n\toptions: HostServiceResolvedOptions,\n\tport: number,\n): {\n\treadonly command: string;\n\treadonly args: ReadonlyArray<string>;\n\treadonly env: NodeJS.ProcessEnv;\n} => {\n\tconst renderedEnv: NodeJS.ProcessEnv = {};\n\tfor (const [key, value] of Object.entries(options.env)) {\n\t\trenderedEnv[key] = renderPortToken(value, port);\n\t}\n\treturn {\n\t\tcommand: renderPortToken(options.command, port),\n\t\targs: options.args.map((arg) => renderPortToken(arg, port)),\n\t\tenv: renderedEnv,\n\t};\n};\n\nconst hostServiceValue = (\n\toptions: HostServiceResolvedOptions,\n\tport: number,\n\trendered: { readonly command: string; readonly args: ReadonlyArray<string> },\n): HostServiceValue => ({\n\tname: options.serviceName,\n\tendpointName: options.endpointName,\n\tcommand: rendered.command,\n\targs: rendered.args,\n\tcwd: options.cwd,\n\tport,\n\turl: `http://127.0.0.1:${port}`,\n});\n\nconst terminateChild = (\n\tchild: HostProcessChild,\n\ttimeoutMs: number,\n\tlogger: LoggerShape,\n\tpluginKey: PluginKey,\n\ttag: string,\n): Effect.Effect<void> =>\n\tterminateManagedProcess(child, {\n\t\tgraceMs: timeoutMs,\n\t\tprocessGroup: true,\n\t\tonEscalate: () =>\n\t\t\tlogger.log(tag, pluginKey, {\n\t\t\t\tlevel: 'warn',\n\t\t\t\tmessage: 'host service did not exit after SIGTERM; sending SIGKILL',\n\t\t\t\tfields: { [SpanAttr.event]: 'process.shutdown.escalated' },\n\t\t\t}),\n\t});\n\nconst httpReady = (\n\turl: string,\n\ttimeoutMs: number,\n\tintervalMs: number,\n\texit: Promise<{ readonly code: number | null; readonly signal: NodeJS.Signals | null }>,\n\tprocessError: Promise<unknown>,\n\terror: HostServiceAcquireError,\n): Effect.Effect<void, HostServiceAcquireError> =>\n\tawaitManagedProcessReady({\n\t\tready: waitForHttpEndpoint({\n\t\t\tendpoint: url,\n\t\t\ttimeoutMs,\n\t\t\tintervalMs,\n\t\t\t// Host services only need to prove their listener is up. App-level\n\t\t\t// 4xx/5xx responses can be transient while devstack writes generated files.\n\t\t\tvalidate: () => true,\n\t\t}).pipe(\n\t\t\tEffect.mapError(\n\t\t\t\t(cause) =>\n\t\t\t\t\tnew HostServiceAcquireError({\n\t\t\t\t\t\t...error,\n\t\t\t\t\t\tphase: 'ready',\n\t\t\t\t\t\tmessage: `host service did not become ready at ${url} within ${timeoutMs}ms`,\n\t\t\t\t\t\tcause,\n\t\t\t\t\t}),\n\t\t\t),\n\t\t),\n\t\texit,\n\t\tprocessError,\n\t\tonExitBeforeReady: (status) =>\n\t\t\tnew HostServiceAcquireError({\n\t\t\t\t...error,\n\t\t\t\tphase: 'exit',\n\t\t\t\tmessage: 'host service exited before readiness',\n\t\t\t\texitCode: status.code,\n\t\t\t\tsignal: status.signal,\n\t\t\t}),\n\t\tonProcessErrorBeforeReady: (cause) =>\n\t\t\tnew HostServiceAcquireError({\n\t\t\t\t...error,\n\t\t\t\tphase: 'spawn',\n\t\t\t\tmessage: 'host service process failed before readiness',\n\t\t\t\tcause,\n\t\t\t}),\n\t});\n\nconst logReady = (\n\tready: Extract<HostServiceReadyProbe, { readonly kind: 'log' }>,\n\treadySignal: Promise<void>,\n\texit: Promise<{ readonly code: number | null; readonly signal: NodeJS.Signals | null }>,\n\tprocessError: Promise<unknown>,\n\terror: HostServiceAcquireError,\n): Effect.Effect<void, HostServiceAcquireError> =>\n\tawaitManagedProcessReady({\n\t\tready: Effect.tryPromise({\n\t\t\ttry: () =>\n\t\t\t\tnew Promise<void>((resolveReady, rejectReady) => {\n\t\t\t\t\tconst timeout = setTimeout(() => {\n\t\t\t\t\t\trejectReady(\n\t\t\t\t\t\t\tnew HostServiceAcquireError({\n\t\t\t\t\t\t\t\t...error,\n\t\t\t\t\t\t\t\tphase: 'ready',\n\t\t\t\t\t\t\t\tmessage: `host service did not emit readiness log within ${ready.timeoutMs ?? DEFAULT_LOG_READY_TIMEOUT_MS}ms`,\n\t\t\t\t\t\t\t}),\n\t\t\t\t\t\t);\n\t\t\t\t\t}, ready.timeoutMs ?? DEFAULT_LOG_READY_TIMEOUT_MS);\n\t\t\t\t\treadySignal.then(() => {\n\t\t\t\t\t\tclearTimeout(timeout);\n\t\t\t\t\t\tresolveReady();\n\t\t\t\t\t});\n\t\t\t\t}),\n\t\t\tcatch: (cause) => (cause instanceof HostServiceAcquireError ? cause : error),\n\t\t}),\n\t\texit,\n\t\tprocessError,\n\t\tonExitBeforeReady: (status) =>\n\t\t\tnew HostServiceAcquireError({\n\t\t\t\t...error,\n\t\t\t\tphase: 'exit',\n\t\t\t\tmessage: 'host service exited before readiness',\n\t\t\t\texitCode: status.code,\n\t\t\t\tsignal: status.signal,\n\t\t\t}),\n\t\tonProcessErrorBeforeReady: (cause) =>\n\t\t\tnew HostServiceAcquireError({\n\t\t\t\t...error,\n\t\t\t\tphase: 'spawn',\n\t\t\t\tmessage: 'host service process failed before readiness',\n\t\t\t\tcause,\n\t\t\t}),\n\t});\n\nconst allocateHostPort = (\n\toptions: HostServiceResolvedOptions,\n\tctx: HostServiceAcquireContext,\n): Effect.Effect<number, HostServiceAcquireError, Scope.Scope> =>\n\tctx.allocatePort(options.preferredPort).pipe(\n\t\tEffect.mapError(\n\t\t\t(cause) =>\n\t\t\t\tnew HostServiceAcquireError({\n\t\t\t\t\tserviceName: options.serviceName,\n\t\t\t\t\tcwd: options.cwd,\n\t\t\t\t\tcommand: options.command,\n\t\t\t\t\targs: options.args,\n\t\t\t\t\tphase: 'allocate-port',\n\t\t\t\t\tmessage: 'host service failed to allocate HTTP port',\n\t\t\t\t\tcause,\n\t\t\t\t}),\n\t\t),\n\t);\n\nconst startHostProcess = (\n\toptions: HostServiceResolvedOptions,\n\tctx: HostServiceAcquireContext,\n\tport: number,\n): Effect.Effect<void, HostServiceAcquireError, Scope.Scope> =>\n\tEffect.gen(function* () {\n\t\tconst rendered = renderCommand(options, port);\n\t\tconst env: NodeJS.ProcessEnv = {\n\t\t\t...(ctx.processEnv ?? process.env),\n\t\t\t...rendered.env,\n\t\t\tPORT: String(port),\n\t\t};\n\t\tconst tag = `host-service/${options.serviceName}`;\n\t\tlet resolveLogReady: (() => void) | undefined;\n\t\tconst logReadySignal =\n\t\t\toptions.ready?.kind === 'log'\n\t\t\t\t? new Promise<void>((resolveReady) => {\n\t\t\t\t\t\tresolveLogReady = resolveReady;\n\t\t\t\t\t})\n\t\t\t\t: null;\n\t\tconst observeReadinessLine = (line: string, stream: 'stdout' | 'stderr'): void => {\n\t\t\tif (options.ready?.kind !== 'log') return;\n\t\t\tif (\n\t\t\t\toptions.ready.stream !== undefined &&\n\t\t\t\toptions.ready.stream !== 'both' &&\n\t\t\t\toptions.ready.stream !== stream\n\t\t\t) {\n\t\t\t\treturn;\n\t\t\t}\n\t\t\tconst matches =\n\t\t\t\ttypeof options.ready.pattern === 'string'\n\t\t\t\t\t? line.includes(options.ready.pattern)\n\t\t\t\t\t: options.ready.pattern.test(line);\n\t\t\tif (matches) resolveLogReady?.();\n\t\t};\n\n\t\tconst spawnChild = ctx.spawner ?? nodeProcessSpawner;\n\t\tconst child = yield* Effect.try({\n\t\t\ttry: () =>\n\t\t\t\tspawnChild(rendered.command, rendered.args, {\n\t\t\t\t\tcwd: options.cwd,\n\t\t\t\t\tenv,\n\t\t\t\t\tstdio: 'pipe',\n\t\t\t\t\tdetached: process.platform !== 'win32',\n\t\t\t\t}),\n\t\t\tcatch: (cause) =>\n\t\t\t\tnew HostServiceAcquireError({\n\t\t\t\t\tserviceName: options.serviceName,\n\t\t\t\t\tcwd: options.cwd,\n\t\t\t\t\tcommand: rendered.command,\n\t\t\t\t\targs: rendered.args,\n\t\t\t\t\tphase: 'spawn',\n\t\t\t\t\tmessage: 'host service spawn failed',\n\t\t\t\t\tcause,\n\t\t\t\t}),\n\t\t});\n\t\tlet shuttingDown = false;\n\t\tlet exitStatus: {\n\t\t\treadonly code: number | null;\n\t\t\treadonly signal: NodeJS.Signals | null;\n\t\t} | null = null;\n\t\tconst exited = onceProcessExit(child).then((status) => {\n\t\t\texitStatus = status;\n\t\t\treturn status;\n\t\t});\n\t\tconst processError = onceProcessError(child);\n\t\tyield* observeProcessLines(\n\t\t\t{\n\t\t\t\tstdout: readableToByteStream(\n\t\t\t\t\tchild.stdout as unknown as AsyncIterable<Uint8Array> | null | undefined,\n\t\t\t\t),\n\t\t\t\tstderr: readableToByteStream(\n\t\t\t\t\tchild.stderr as unknown as AsyncIterable<Uint8Array> | null | undefined,\n\t\t\t\t),\n\t\t\t},\n\t\t\t{\n\t\t\t\tlogger: ctx.logger,\n\t\t\t\tpluginKey: ctx.pluginKey,\n\t\t\t\ttag,\n\t\t\t\tfields: { [SpanAttr.serviceName]: options.serviceName },\n\t\t\t\tonLine: ({ line, stream }) =>\n\t\t\t\t\tEffect.sync(() => {\n\t\t\t\t\t\tobserveReadinessLine(line, stream);\n\t\t\t\t\t}),\n\t\t\t},\n\t\t);\n\t\tyield* Effect.addFinalizer(() =>\n\t\t\tEffect.gen(function* () {\n\t\t\t\tshuttingDown = true;\n\t\t\t\tif (exitStatus !== null) return;\n\t\t\t\tyield* terminateChild(child, options.shutdownGraceMs, ctx.logger, ctx.pluginKey, tag);\n\t\t\t}),\n\t\t);\n\n\t\tconst baseError = new HostServiceAcquireError({\n\t\t\tserviceName: options.serviceName,\n\t\t\tcwd: options.cwd,\n\t\t\tcommand: rendered.command,\n\t\t\targs: rendered.args,\n\t\t\tphase: 'ready',\n\t\t\tmessage: 'host service readiness failed',\n\t\t});\n\t\tconst awaitReadiness = (() => {\n\t\t\tif (options.ready?.kind === 'http') {\n\t\t\t\tconst url = renderPortToken(options.ready.url ?? 'http://127.0.0.1:{port}', port);\n\t\t\t\treturn httpReady(\n\t\t\t\t\turl,\n\t\t\t\t\toptions.ready.timeoutMs ?? DEFAULT_HTTP_READY_TIMEOUT_MS,\n\t\t\t\t\toptions.ready.intervalMs ?? DEFAULT_HTTP_READY_INTERVAL_MS,\n\t\t\t\t\texited,\n\t\t\t\t\tprocessError,\n\t\t\t\t\tbaseError,\n\t\t\t\t);\n\t\t\t}\n\t\t\tif (options.ready?.kind === 'log' && logReadySignal !== null) {\n\t\t\t\treturn logReady(options.ready, logReadySignal, exited, processError, baseError);\n\t\t\t}\n\t\t\treturn Effect.gen(function* () {\n\t\t\t\tyield* awaitManagedProcessReady({\n\t\t\t\t\tready: Effect.promise(\n\t\t\t\t\t\t() => new Promise<void>((resolveReady) => setTimeout(resolveReady, 0)),\n\t\t\t\t\t),\n\t\t\t\t\texit: exited,\n\t\t\t\t\tprocessError,\n\t\t\t\t\tonExitBeforeReady: (status) =>\n\t\t\t\t\t\tnew HostServiceAcquireError({\n\t\t\t\t\t\t\t...baseError,\n\t\t\t\t\t\t\tphase: 'exit',\n\t\t\t\t\t\t\tmessage: 'host service exited before readiness',\n\t\t\t\t\t\t\texitCode: status.code,\n\t\t\t\t\t\t\tsignal: status.signal,\n\t\t\t\t\t\t}),\n\t\t\t\t\tonProcessErrorBeforeReady: (cause) =>\n\t\t\t\t\t\tnew HostServiceAcquireError({\n\t\t\t\t\t\t\t...baseError,\n\t\t\t\t\t\t\tphase: 'spawn',\n\t\t\t\t\t\t\tmessage: 'host service process failed before readiness',\n\t\t\t\t\t\t\tcause,\n\t\t\t\t\t\t}),\n\t\t\t\t});\n\t\t\t});\n\t\t})();\n\t\tconst readinessExit = yield* Effect.exit(awaitReadiness);\n\t\tif (Exit.isFailure(readinessExit)) {\n\t\t\tshuttingDown = true;\n\t\t\tif (exitStatus === null) {\n\t\t\t\tyield* terminateChild(child, options.shutdownGraceMs, ctx.logger, ctx.pluginKey, tag);\n\t\t\t}\n\t\t\treturn yield* Effect.failCause(readinessExit.cause);\n\t\t}\n\n\t\tvoid exited.then((status) => {\n\t\t\tif (shuttingDown) return;\n\t\t\tvoid Effect.runPromise(\n\t\t\t\tctx.logger.log(tag, ctx.pluginKey, {\n\t\t\t\t\tlevel: 'error',\n\t\t\t\t\tmessage: 'host service exited after readiness',\n\t\t\t\t\tfields: {\n\t\t\t\t\t\t[SpanAttr.event]: 'process.exited',\n\t\t\t\t\t\t[SpanAttr.serviceName]: options.serviceName,\n\t\t\t\t\t\t[SpanAttr.exitCode]: status.code,\n\t\t\t\t\t\t[SpanAttr.exitSignal]: status.signal,\n\t\t\t\t\t\t[SpanAttr.exitStatus]: describeProcessExitStatus(status),\n\t\t\t\t\t},\n\t\t\t\t}),\n\t\t\t).catch(() => {});\n\t\t});\n\t\tvoid processError.then((cause) => {\n\t\t\tif (shuttingDown) return;\n\t\t\tvoid Effect.runPromise(\n\t\t\t\tctx.logger.log(tag, ctx.pluginKey, {\n\t\t\t\t\tlevel: 'error',\n\t\t\t\t\tmessage: 'host service process emitted an error after readiness',\n\t\t\t\t\tfields: {\n\t\t\t\t\t\t[SpanAttr.event]: 'process.error',\n\t\t\t\t\t\t[SpanAttr.serviceName]: options.serviceName,\n\t\t\t\t\t\t[SpanAttr.errorCause]: cause,\n\t\t\t\t\t},\n\t\t\t\t}),\n\t\t\t).catch(() => {});\n\t\t});\n\t});\n\nexport const prepareHostService = (\n\toptions: HostServiceResolvedOptions,\n\tctx: HostServiceAcquireContext,\n): Effect.Effect<PreparedHostService, HostServiceAcquireError, Scope.Scope> =>\n\tEffect.gen(function* () {\n\t\tconst port = yield* allocateHostPort(options, ctx);\n\t\tconst rendered = renderCommand(options, port);\n\t\tconst started = yield* Ref.make(false);\n\t\tconst start = Effect.gen(function* () {\n\t\t\tif (yield* Ref.get(started)) return;\n\t\t\tyield* startHostProcess(options, ctx, port);\n\t\t\tyield* Ref.set(started, true);\n\t\t});\n\n\t\treturn {\n\t\t\tvalue: hostServiceValue(options, port, rendered),\n\t\t\tstart,\n\t\t};\n\t});\n\nexport const acquireHostService = (\n\toptions: HostServiceResolvedOptions,\n\tctx: HostServiceAcquireContext,\n): Effect.Effect<HostServiceValue, HostServiceAcquireError, Scope.Scope> =>\n\tEffect.gen(function* () {\n\t\tconst prepared = yield* prepareHostService(options, ctx);\n\t\tyield* prepared.start;\n\t\treturn prepared.value;\n\t});\n"],"mappings":"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"}
+{"version":3,"file":"service.mjs","names":[],"sources":["../../../src/plugins/host-service/service.ts"],"sourcesContent":["import { resolve } from 'node:path';\n\nimport { Effect, Exit, Ref } from 'effect';\nimport type { Scope } from 'effect';\n\nimport type { PluginKey } from '../../substrate/brand.ts';\nimport type { AnyResourceRef } from '../../api/define-plugin.ts';\nimport {\n\texpectNonEmptyString,\n\texpectOptionalPositiveInteger,\n} from '../../substrate/runtime/config-validation.ts';\nimport {\n\tobserveProcessLines,\n\treadableToByteStream,\n\tSpanAttr,\n\ttype LoggerShape,\n} from '../../substrate/runtime/observability/index.ts';\nimport { waitForHttpEndpoint } from '../../substrate/runtime/http-probe.ts';\nimport type { PortBrokerError } from '../../substrate/runtime/port-broker/index.ts';\nimport {\n\tawaitManagedProcessReady,\n\tdescribeProcessExitStatus,\n\tnodeProcessSpawner,\n\tonceProcessError,\n\tonceProcessExit,\n\tterminateManagedProcess,\n\ttype ManagedProcessChild,\n\ttype ManagedProcessSpawner,\n\ttype ManagedProcessSpawnOptions,\n} from '../../substrate/runtime/process-supervisor.ts';\n\nimport { HOST_SERVICE_DEFAULT_ENDPOINT_NAME } from './routable.ts';\nimport { hostServiceConfigError, HostServiceAcquireError } from './errors.ts';\n\nexport const HOST_SERVICE_PORT_TOKEN = '{port}' as const;\n\nexport type HostServiceReadyProbe =\n\t| {\n\t\t\treadonly kind: 'http';\n\t\t\treadonly url?: string;\n\t\t\treadonly timeoutMs?: number;\n\t\t\treadonly intervalMs?: number;\n\t  }\n\t| {\n\t\t\treadonly kind: 'log';\n\t\t\t/** Pattern matched against each stdout/stderr line. `string` is a\n\t\t\t *  fast substring match. `RegExp` is evaluated via `.test(line)`\n\t\t\t *  per line and runs synchronously on the observer fiber —\n\t\t\t *  AVOID catastrophic-backtracking shapes like `(a+)+b` or\n\t\t\t *  `(a|a)*c` which can wedge the fiber on adversarial output.\n\t\t\t *  Prefer anchored, non-nested-quantifier patterns. The\n\t\t\t *  plugin emits a one-time warning at registration if it\n\t\t\t *  detects nested-quantifier shapes. */\n\t\t\treadonly pattern: string | RegExp;\n\t\t\treadonly stream?: 'stdout' | 'stderr' | 'both';\n\t\t\treadonly timeoutMs?: number;\n\t  };\n\ninterface HostServiceBaseOptions<After extends ReadonlyArray<AnyResourceRef>> {\n\treadonly name?: string;\n\treadonly endpointName?: string;\n\treadonly after?: After;\n\treadonly cwd?: string;\n\treadonly port?: number;\n\treadonly env?: Readonly<Record<string, string>>;\n\treadonly ready?: HostServiceReadyProbe;\n\treadonly shutdownGraceMs?: number;\n}\n\ninterface HostServiceCommandOptions<\n\tAfter extends ReadonlyArray<AnyResourceRef>,\n> extends HostServiceBaseOptions<After> {\n\treadonly command: string;\n\treadonly args?: ReadonlyArray<string>;\n\treadonly script?: never;\n}\n\ninterface HostServiceScriptOptions<\n\tAfter extends ReadonlyArray<AnyResourceRef>,\n> extends HostServiceBaseOptions<After> {\n\treadonly script: string;\n\treadonly command?: never;\n\treadonly args?: never;\n}\n\nexport type HostServiceOptions<\n\tAfter extends ReadonlyArray<AnyResourceRef> = ReadonlyArray<AnyResourceRef>,\n> = HostServiceCommandOptions<After> | HostServiceScriptOptions<After>;\n\nexport interface HostServiceResolvedOptions {\n\treadonly serviceName: string;\n\treadonly endpointName: string;\n\treadonly command: string;\n\treadonly args: ReadonlyArray<string>;\n\treadonly cwd: string;\n\treadonly preferredPort?: number;\n\treadonly env: Readonly<Record<string, string>>;\n\treadonly ready?: HostServiceReadyProbe;\n\treadonly shutdownGraceMs: number;\n}\n\nexport interface HostServiceValue {\n\treadonly name: string;\n\treadonly endpointName: string;\n\treadonly command: string;\n\treadonly args: ReadonlyArray<string>;\n\treadonly cwd: string;\n\t/** The real loopback port the child (Vite) binds. Always the bound\n\t *  port, regardless of how `url` is shaped — readiness probes and\n\t *  direct host tooling read this. */\n\treadonly port: number;\n\t/** Canonical URL for this service: the router-fronted routed origin\n\t *  (`http://<endpoint>.<stack?>.<app>.localhost:5175`) when the\n\t *  supervisor derived one, the raw `http://127.0.0.1:<port>` loopback\n\t *  bind otherwise. The routed form is what the dev-wallet CORS\n\t *  allowlist accepts, so any consumer that hands this URL to a browser\n\t *  — `devstack up` output, an app or build integration holding the\n\t *  resolved `HostServiceValue` — gets a working wallet pairing.\n\t *  Consumers that need the bind target read `port`. Mirrors\n\t *  `WalletValue.url` (\"router-fronted when available, loopback\n\t *  otherwise\"). */\n\treadonly url: string;\n}\n\nexport interface PreparedHostService {\n\treadonly value: HostServiceValue;\n\treadonly start: Effect.Effect<void, HostServiceAcquireError, Scope.Scope>;\n}\n\nexport type HostProcessChild = ManagedProcessChild;\nexport type HostProcessSpawnOptions = ManagedProcessSpawnOptions;\nexport type HostProcessSpawner = ManagedProcessSpawner;\n\nexport interface HostServiceAcquireContext {\n\treadonly allocatePort: (\n\t\tpreferredPort: number | undefined,\n\t) => Effect.Effect<number, PortBrokerError, Scope.Scope>;\n\treadonly logger: LoggerShape;\n\treadonly pluginKey: PluginKey;\n\treadonly spawner?: HostProcessSpawner;\n\treadonly processEnv?: NodeJS.ProcessEnv;\n\t/**\n\t * Stack identity to publish into the spawned child's environment so\n\t * that in-process build integrations running INSIDE that child (the\n\t * `devstack` Vite plugin in particular) can re-discover the active\n\t * stack's manifest. `--stack` is a CLI flag, not an env var, and the\n\t * supervisor process does not mutate its own `process.env`, so without\n\t * this the child would inherit no `DEVSTACK_STACK` /\n\t * `DEVSTACK_RUNTIME_ROOT` and the Vite plugin's\n\t * `resolveDiscoveryEnv(process.env)` would fall back to the `main`\n\t * stack — aliasing `@generated` at the wrong stack's codegen output.\n\t *\n\t * `stack` is the effective stack name (`Identity.stack`); `runtimeRoot`\n\t * is the absolute on-disk runtime root (`RuntimeRoot.root`). The two\n\t * map directly onto the `<runtimeRoot>/stacks/<stack>/manifest.json`\n\t * path the supervisor writes and `discoverManifestPath` reads. Optional\n\t * so non-supervised callers (and tests) can omit them.\n\t */\n\treadonly discoveryIdentity?: {\n\t\treadonly stack: string;\n\t\treadonly runtimeRoot: string;\n\t};\n\t/**\n\t * Canonical router-fronted URL for this host-service's endpoint, e.g.\n\t * `http://dev.<stack>.<app>.localhost:5175`. When supplied it becomes\n\t * the published `HostServiceValue.url` so every consumer that reads\n\t * \"the host-service's URL\" (`devstack up` output, an app / build\n\t * integration holding the resolved value) is pointed at the URL that\n\t * actually works end-to-end — in particular the one whose Origin the\n\t * dev-wallet CORS allowlist accepts. The raw `http://127.0.0.1:<port>` loopback\n\t * bind is kept INTERNAL (Vite's listen + the readiness probe, which\n\t * derives its own loopback literal) and remains the fallback here when\n\t * no routed URL is available (router disabled, or a hostname-validation\n\t * failure in the caller's best-effort derivation). Optional + nullable\n\t * so non-supervised callers and tests fall back to loopback exactly as\n\t * before.\n\t *\n\t * Mirrors the wallet's own `WalletValue.url` rule (\"router-fronted URL\n\t * when available, loopback otherwise\") and the ARCHITECTURE.md\n\t * \"Host-service = endpoint-defaults bus\" intent that the ROUTED origin\n\t * is canonical.\n\t */\n\treadonly routedUrl?: string | null;\n}\n\nconst DEFAULT_SHUTDOWN_GRACE_MS = 5_000;\nconst DEFAULT_HTTP_READY_TIMEOUT_MS = 60_000;\nconst DEFAULT_HTTP_READY_INTERVAL_MS = 250;\nconst DEFAULT_LOG_READY_TIMEOUT_MS = 60_000;\nconst READY_STREAM_VALUES = ['stdout', 'stderr', 'both'] as const;\n\nconst shellInvocationFor = (script: string): { command: string; args: ReadonlyArray<string> } => {\n\tif (process.platform === 'win32') {\n\t\treturn {\n\t\t\tcommand: process.env.ComSpec ?? process.env.COMSPEC ?? 'cmd.exe',\n\t\t\targs: ['/d', '/s', '/c', script],\n\t\t};\n\t}\n\treturn {\n\t\tcommand: '/bin/sh',\n\t\targs: ['-c', script],\n\t};\n};\n\nconst configErrorFor =\n\t(serviceName: string) => (issue: Parameters<typeof hostServiceConfigError>[1]) =>\n\t\thostServiceConfigError(serviceName, issue);\n\nconst normalizeReadyProbe = (\n\tserviceName: string,\n\tready: HostServiceReadyProbe | undefined,\n): HostServiceReadyProbe | undefined => {\n\tif (ready === undefined) return undefined;\n\tconst mkError = configErrorFor(serviceName);\n\tif (ready.kind === 'http') {\n\t\tif (ready.url !== undefined) {\n\t\t\texpectNonEmptyString(ready.url, { field: 'ready.url', mkError });\n\t\t}\n\t\texpectOptionalPositiveInteger(ready.timeoutMs, { field: 'ready.timeoutMs', mkError });\n\t\texpectOptionalPositiveInteger(ready.intervalMs, { field: 'ready.intervalMs', mkError });\n\t\treturn ready;\n\t}\n\tif (ready.kind === 'log') {\n\t\tif (typeof ready.pattern !== 'string' && !(ready.pattern instanceof RegExp)) {\n\t\t\tthrow mkError({ field: 'ready.pattern', message: 'must be a string or RegExp' });\n\t\t}\n\t\tif (ready.stream !== undefined && !READY_STREAM_VALUES.includes(ready.stream)) {\n\t\t\tthrow mkError({\n\t\t\t\tfield: 'ready.stream',\n\t\t\t\tmessage: \"must be one of 'stdout', 'stderr', 'both'\",\n\t\t\t});\n\t\t}\n\t\texpectOptionalPositiveInteger(ready.timeoutMs, { field: 'ready.timeoutMs', mkError });\n\t\treturn ready;\n\t}\n\tthrow mkError({ field: 'ready.kind', message: \"must be 'http' or 'log'\" });\n};\n\nexport const normalizeHostServiceOptions = (\n\toptions: HostServiceOptions,\n): HostServiceResolvedOptions => {\n\tconst endpointName = options.endpointName ?? HOST_SERVICE_DEFAULT_ENDPOINT_NAME;\n\tconst serviceName = options.name ?? endpointName;\n\tconst mkError = configErrorFor(serviceName);\n\texpectNonEmptyString(serviceName, { field: 'name', mkError });\n\texpectNonEmptyString(endpointName, { field: 'endpointName', mkError });\n\n\tconst rawCommand = (options as { readonly command?: unknown }).command;\n\tconst rawArgs = (options as { readonly args?: unknown }).args;\n\tconst rawScript = (options as { readonly script?: unknown }).script;\n\tif (rawCommand !== undefined && rawScript !== undefined) {\n\t\tthrow mkError({ field: 'command', message: 'use either command or script, not both' });\n\t}\n\tif (rawCommand === undefined && rawScript === undefined) {\n\t\tthrow mkError({ field: 'command', message: 'is required unless script is provided' });\n\t}\n\tif (rawScript !== undefined && rawArgs !== undefined) {\n\t\tthrow mkError({ field: 'args', message: 'args are only supported with command' });\n\t}\n\n\tif (\n\t\toptions.port !== undefined &&\n\t\t!(\n\t\t\ttypeof options.port === 'number' &&\n\t\t\tNumber.isInteger(options.port) &&\n\t\t\toptions.port > 0 &&\n\t\t\toptions.port <= 65_535\n\t\t)\n\t) {\n\t\tthrow mkError({ field: 'port', message: 'must be an integer between 1 and 65535' });\n\t}\n\tconst preferredPort = options.port;\n\tconst cwd = resolve(options.cwd ?? process.cwd());\n\tconst rawEnv = options.env;\n\tif (rawEnv !== undefined) {\n\t\tif (typeof rawEnv !== 'object' || rawEnv === null || Array.isArray(rawEnv)) {\n\t\t\tthrow mkError({ field: 'env', message: 'must be an object of string values' });\n\t\t}\n\t\tfor (const [key, entry] of Object.entries(rawEnv)) {\n\t\t\tif (key.length === 0) {\n\t\t\t\tthrow mkError({ field: 'env', message: 'environment variable names must be non-empty' });\n\t\t\t}\n\t\t\tif (typeof entry !== 'string') {\n\t\t\t\tthrow mkError({ field: `env.${key}`, message: 'must be a string' });\n\t\t\t}\n\t\t}\n\t}\n\tconst env: Readonly<Record<string, string>> = rawEnv ?? {};\n\tconst shutdownGraceMs =\n\t\texpectOptionalPositiveInteger(options.shutdownGraceMs, {\n\t\t\tfield: 'shutdownGraceMs',\n\t\t\tmkError,\n\t\t}) ?? DEFAULT_SHUTDOWN_GRACE_MS;\n\tconst ready = normalizeReadyProbe(serviceName, options.ready);\n\tconst invocation =\n\t\trawScript !== undefined\n\t\t\t? shellInvocationFor(expectNonEmptyString(rawScript, { field: 'script', mkError }))\n\t\t\t: {\n\t\t\t\t\tcommand: expectNonEmptyString(rawCommand, { field: 'command', mkError }),\n\t\t\t\t\targs: options.args ?? [],\n\t\t\t\t};\n\n\treturn {\n\t\tserviceName,\n\t\tendpointName,\n\t\tcommand: invocation.command,\n\t\targs: invocation.args,\n\t\tcwd,\n\t\t...(preferredPort === undefined ? {} : { preferredPort }),\n\t\tenv,\n\t\t...(ready === undefined ? {} : { ready }),\n\t\tshutdownGraceMs,\n\t};\n};\n\nconst renderPortToken = (value: string, port: number): string =>\n\tvalue.replaceAll(HOST_SERVICE_PORT_TOKEN, String(port));\n\n/** Heuristic: catastrophic-backtracking patterns typically nest a\n *  quantifier inside another quantifier (e.g. `(a+)+`, `(a*)*`,\n *  `(a|a)*`). This is intentionally conservative — it flags clearly\n *  risky shapes without trying to be a real ReDoS analyzer. The\n *  guard runs once at host-service start and only emits a warning,\n *  not a fail-stop. */\nconst looksRedosProne = (pattern: RegExp): boolean => {\n\tconst source = pattern.source;\n\t// `(...)<quant><quant>` — quantifier directly after a group's quantifier.\n\tif (/\\)[*+?](?:\\{[^}]*\\})?[*+?]/.test(source)) return true;\n\t// `(...<quant>...)<quant>` — quantifier inside a group that itself is quantified.\n\tif (/\\([^()]*[*+?][^()]*\\)[*+?]/.test(source)) return true;\n\t// `(a|a)*` style — alternation with overlapping branches under a quantifier.\n\tif (/\\([^()]*\\|[^()]*\\)[*+]/.test(source)) return true;\n\treturn false;\n};\n\nconst renderCommand = (\n\toptions: HostServiceResolvedOptions,\n\tport: number,\n): {\n\treadonly command: string;\n\treadonly args: ReadonlyArray<string>;\n\treadonly env: NodeJS.ProcessEnv;\n} => {\n\tconst renderedEnv: NodeJS.ProcessEnv = {};\n\tfor (const [key, value] of Object.entries(options.env)) {\n\t\trenderedEnv[key] = renderPortToken(value, port);\n\t}\n\treturn {\n\t\tcommand: renderPortToken(options.command, port),\n\t\targs: options.args.map((arg) => renderPortToken(arg, port)),\n\t\tenv: renderedEnv,\n\t};\n};\n\nconst hostServiceValue = (\n\toptions: HostServiceResolvedOptions,\n\tport: number,\n\trendered: { readonly command: string; readonly args: ReadonlyArray<string> },\n\troutedUrl: string | null,\n): HostServiceValue => ({\n\tname: options.serviceName,\n\tendpointName: options.endpointName,\n\tcommand: rendered.command,\n\targs: rendered.args,\n\tcwd: options.cwd,\n\tport,\n\t// Canonical routed URL when the supervisor derived one, raw loopback\n\t// otherwise. `port` above always stays the real bound loopback port —\n\t// callers that need the bind target (readiness, direct host tooling)\n\t// read `.port`, not `.url`.\n\turl: routedUrl ?? `http://127.0.0.1:${port}`,\n});\n\nconst terminateChild = (\n\tchild: HostProcessChild,\n\ttimeoutMs: number,\n\tlogger: LoggerShape,\n\tpluginKey: PluginKey,\n\ttag: string,\n): Effect.Effect<void> =>\n\tterminateManagedProcess(child, {\n\t\tgraceMs: timeoutMs,\n\t\tprocessGroup: true,\n\t\tonEscalate: () =>\n\t\t\tlogger.log(tag, pluginKey, {\n\t\t\t\tlevel: 'warn',\n\t\t\t\tmessage: 'host service did not exit after SIGTERM; sending SIGKILL',\n\t\t\t\tfields: { [SpanAttr.event]: 'process.shutdown.escalated' },\n\t\t\t}),\n\t});\n\nconst httpReady = (\n\turl: string,\n\ttimeoutMs: number,\n\tintervalMs: number,\n\texit: Promise<{ readonly code: number | null; readonly signal: NodeJS.Signals | null }>,\n\tprocessError: Promise<unknown>,\n\terror: HostServiceAcquireError,\n): Effect.Effect<void, HostServiceAcquireError> =>\n\tawaitManagedProcessReady({\n\t\tready: waitForHttpEndpoint({\n\t\t\tendpoint: url,\n\t\t\ttimeoutMs,\n\t\t\tintervalMs,\n\t\t\t// HTTP readiness is a health check: require a 200 from the probed\n\t\t\t// `url` ITSELF. `redirect: 'manual'` means a 3xx is not followed —\n\t\t\t// it reads as `status 0`, so a server that 302s to a 200 login page\n\t\t\t// is NOT counted as ready off the redirect target. Point `url` at an\n\t\t\t// endpoint that returns 200 when the service is up (default: the\n\t\t\t// service root). Anything else — a still-compiling dev server, a\n\t\t\t// 5xx, a redirect — keeps polling until the readiness timeout. Use a\n\t\t\t// `log` probe instead when 200-at-a-URL isn't the right signal.\n\t\t\trequestInit: { redirect: 'manual' },\n\t\t\tvalidate: (response) => response.status === 200,\n\t\t}).pipe(\n\t\t\tEffect.mapError(\n\t\t\t\t(cause) =>\n\t\t\t\t\tnew HostServiceAcquireError({\n\t\t\t\t\t\t...error,\n\t\t\t\t\t\tphase: 'ready',\n\t\t\t\t\t\tmessage: `host service did not become ready at ${url} within ${timeoutMs}ms`,\n\t\t\t\t\t\tcause,\n\t\t\t\t\t}),\n\t\t\t),\n\t\t),\n\t\texit,\n\t\tprocessError,\n\t\tonExitBeforeReady: (status) =>\n\t\t\tnew HostServiceAcquireError({\n\t\t\t\t...error,\n\t\t\t\tphase: 'exit',\n\t\t\t\tmessage: 'host service exited before readiness',\n\t\t\t\texitCode: status.code,\n\t\t\t\tsignal: status.signal,\n\t\t\t}),\n\t\tonProcessErrorBeforeReady: (cause) =>\n\t\t\tnew HostServiceAcquireError({\n\t\t\t\t...error,\n\t\t\t\tphase: 'spawn',\n\t\t\t\tmessage: 'host service process failed before readiness',\n\t\t\t\tcause,\n\t\t\t}),\n\t});\n\nexport const logReady = (\n\tready: Extract<HostServiceReadyProbe, { readonly kind: 'log' }>,\n\treadySignal: Promise<void>,\n\texit: Promise<{ readonly code: number | null; readonly signal: NodeJS.Signals | null }>,\n\tprocessError: Promise<unknown>,\n\terror: HostServiceAcquireError,\n): Effect.Effect<void, HostServiceAcquireError> =>\n\tawaitManagedProcessReady({\n\t\tready: Effect.tryPromise({\n\t\t\ttry: () =>\n\t\t\t\tnew Promise<void>((resolveReady, rejectReady) => {\n\t\t\t\t\tconst timeout = setTimeout(() => {\n\t\t\t\t\t\trejectReady(\n\t\t\t\t\t\t\tnew HostServiceAcquireError({\n\t\t\t\t\t\t\t\t...error,\n\t\t\t\t\t\t\t\tphase: 'ready',\n\t\t\t\t\t\t\t\tmessage: `host service did not emit readiness log within ${ready.timeoutMs ?? DEFAULT_LOG_READY_TIMEOUT_MS}ms`,\n\t\t\t\t\t\t\t}),\n\t\t\t\t\t\t);\n\t\t\t\t\t}, ready.timeoutMs ?? DEFAULT_LOG_READY_TIMEOUT_MS);\n\t\t\t\t\treadySignal.then(\n\t\t\t\t\t\t() => {\n\t\t\t\t\t\t\tclearTimeout(timeout);\n\t\t\t\t\t\t\tresolveReady();\n\t\t\t\t\t\t},\n\t\t\t\t\t\t// Thread a rejecting readiness signal through as the\n\t\t\t\t\t\t// inner-Promise rejection (a non-tagged cause). Without\n\t\t\t\t\t\t// this `onRejected` handler a rejected signal would be an\n\t\t\t\t\t\t// unhandled rejection and the `catch:` arm below could\n\t\t\t\t\t\t// never see it. The `catch` arm preserves this raw cause\n\t\t\t\t\t\t// on `HostServiceAcquireError.cause`.\n\t\t\t\t\t\t(cause: unknown) => {\n\t\t\t\t\t\t\tclearTimeout(timeout);\n\t\t\t\t\t\t\trejectReady(cause);\n\t\t\t\t\t\t},\n\t\t\t\t\t);\n\t\t\t\t}),\n\t\t\tcatch: (cause) =>\n\t\t\t\tcause instanceof HostServiceAcquireError\n\t\t\t\t\t? cause\n\t\t\t\t\t: new HostServiceAcquireError({\n\t\t\t\t\t\t\tserviceName: error.serviceName,\n\t\t\t\t\t\t\tcwd: error.cwd,\n\t\t\t\t\t\t\tcommand: error.command,\n\t\t\t\t\t\t\targs: error.args,\n\t\t\t\t\t\t\tphase: error.phase,\n\t\t\t\t\t\t\tmessage: error.message,\n\t\t\t\t\t\t\texitCode: error.exitCode,\n\t\t\t\t\t\t\tsignal: error.signal,\n\t\t\t\t\t\t\tcause,\n\t\t\t\t\t\t}),\n\t\t}),\n\t\texit,\n\t\tprocessError,\n\t\tonExitBeforeReady: (status) =>\n\t\t\tnew HostServiceAcquireError({\n\t\t\t\t...error,\n\t\t\t\tphase: 'exit',\n\t\t\t\tmessage: 'host service exited before readiness',\n\t\t\t\texitCode: status.code,\n\t\t\t\tsignal: status.signal,\n\t\t\t}),\n\t\tonProcessErrorBeforeReady: (cause) =>\n\t\t\tnew HostServiceAcquireError({\n\t\t\t\t...error,\n\t\t\t\tphase: 'spawn',\n\t\t\t\tmessage: 'host service process failed before readiness',\n\t\t\t\tcause,\n\t\t\t}),\n\t});\n\nconst allocateHostPort = (\n\toptions: HostServiceResolvedOptions,\n\tctx: HostServiceAcquireContext,\n): Effect.Effect<number, HostServiceAcquireError, Scope.Scope> =>\n\tctx.allocatePort(options.preferredPort).pipe(\n\t\tEffect.mapError(\n\t\t\t(cause) =>\n\t\t\t\tnew HostServiceAcquireError({\n\t\t\t\t\tserviceName: options.serviceName,\n\t\t\t\t\tcwd: options.cwd,\n\t\t\t\t\tcommand: options.command,\n\t\t\t\t\targs: options.args,\n\t\t\t\t\tphase: 'allocate-port',\n\t\t\t\t\tmessage: 'host service failed to allocate HTTP port',\n\t\t\t\t\tcause,\n\t\t\t\t}),\n\t\t),\n\t);\n\nconst startHostProcess = (\n\toptions: HostServiceResolvedOptions,\n\tctx: HostServiceAcquireContext,\n\tport: number,\n): Effect.Effect<void, HostServiceAcquireError, Scope.Scope> =>\n\tEffect.gen(function* () {\n\t\tconst rendered = renderCommand(options, port);\n\t\t// Per-stack discovery identity for in-child build integrations\n\t\t// (the `devstack` Vite plugin). These are a LOW-precedence base\n\t\t// layer: the inherited process env and the user's explicit\n\t\t// `options.env` both spread on top, so a user-set\n\t\t// `DEVSTACK_STACK` / `DEVSTACK_RUNTIME_ROOT` always wins. The\n\t\t// literal var names + the `RUNTIME_ROOT`-over-`STATE_DIR`\n\t\t// preference mirror `resolveDiscoveryEnv` (the plugin's reader);\n\t\t// `runtimeRoot` is absolute, so `discoverManifestPath` resolves\n\t\t// `<runtimeRoot>/stacks/<stack>/manifest.json` directly — exactly\n\t\t// where the supervisor writes the manifest.\n\t\tconst discoveryEnv: NodeJS.ProcessEnv =\n\t\t\tctx.discoveryIdentity === undefined\n\t\t\t\t? {}\n\t\t\t\t: {\n\t\t\t\t\t\tDEVSTACK_STACK: ctx.discoveryIdentity.stack,\n\t\t\t\t\t\tDEVSTACK_RUNTIME_ROOT: ctx.discoveryIdentity.runtimeRoot,\n\t\t\t\t\t};\n\t\tconst env: NodeJS.ProcessEnv = {\n\t\t\t...discoveryEnv,\n\t\t\t...(ctx.processEnv ?? process.env),\n\t\t\t...rendered.env,\n\t\t\tPORT: String(port),\n\t\t};\n\t\tconst tag = `host-service/${options.serviceName}`;\n\t\t// One-time ReDoS-shape warning. The log observer runs `RegExp.test`\n\t\t// synchronously per stdout/stderr line; a catastrophic-backtracking\n\t\t// pattern would wedge the observer fiber on adversarial output.\n\t\tif (\n\t\t\toptions.ready?.kind === 'log' &&\n\t\t\toptions.ready.pattern instanceof RegExp &&\n\t\t\tlooksRedosProne(options.ready.pattern)\n\t\t) {\n\t\t\tyield* ctx.logger.log(tag, ctx.pluginKey, {\n\t\t\t\tlevel: 'warn',\n\t\t\t\tmessage:\n\t\t\t\t\t'host service readiness pattern has a nested-quantifier shape that may exhibit catastrophic backtracking on adversarial output; prefer anchored, non-nested patterns',\n\t\t\t\tfields: {\n\t\t\t\t\t[SpanAttr.serviceName]: options.serviceName,\n\t\t\t\t\t[SpanAttr.event]: 'host-service.ready-pattern.redos-warning',\n\t\t\t\t\t// Namespaced diagnostic field (the offending pattern source),\n\t\t\t\t\t// consistent with the `event` name above. A bare `pattern`\n\t\t\t\t\t// key collides with the generic attribute vocabulary.\n\t\t\t\t\t'host-service.ready-pattern.source': options.ready.pattern.source,\n\t\t\t\t},\n\t\t\t});\n\t\t}\n\t\tlet resolveLogReady: (() => void) | undefined;\n\t\tconst logReadySignal =\n\t\t\toptions.ready?.kind === 'log'\n\t\t\t\t? new Promise<void>((resolveReady) => {\n\t\t\t\t\t\tresolveLogReady = resolveReady;\n\t\t\t\t\t})\n\t\t\t\t: null;\n\t\tconst observeReadinessLine = (line: string, stream: 'stdout' | 'stderr'): void => {\n\t\t\tif (options.ready?.kind !== 'log') return;\n\t\t\tif (\n\t\t\t\toptions.ready.stream !== undefined &&\n\t\t\t\toptions.ready.stream !== 'both' &&\n\t\t\t\toptions.ready.stream !== stream\n\t\t\t) {\n\t\t\t\treturn;\n\t\t\t}\n\t\t\tconst matches =\n\t\t\t\ttypeof options.ready.pattern === 'string'\n\t\t\t\t\t? line.includes(options.ready.pattern)\n\t\t\t\t\t: options.ready.pattern.test(line);\n\t\t\tif (matches) resolveLogReady?.();\n\t\t};\n\n\t\tconst spawnChild = ctx.spawner ?? nodeProcessSpawner;\n\t\t// Mutable cells declared before the setup block so the terminator\n\t\t// finalizer below can observe them.\n\t\tlet shuttingDown = false;\n\t\tlet exitStatus: {\n\t\t\treadonly code: number | null;\n\t\t\treadonly signal: NodeJS.Signals | null;\n\t\t} | null = null;\n\t\t// Atomic, deadlock-free process setup.\n\t\t//\n\t\t// Three things happen in one `Effect.uninterruptible` region — spawn,\n\t\t// fork the stdout/stderr line drains (`observeProcessLines`), and\n\t\t// register the kill finalizer — so that:\n\t\t//\n\t\t//  1. No interrupt can land between a successful spawn and the finalizer\n\t\t//     registration. That gap was the original leak window: a SIGINT\n\t\t//     mid-boot could orphan a detached child still holding its port.\n\t\t//\n\t\t//  2. The terminator finalizer is registered *after* the drain fibers,\n\t\t//     so on scope close (LIFO) it runs *before* they are interrupted.\n\t\t//     This ordering is load-bearing: the drains read the child's stdout/\n\t\t//     stderr via `Stream.fromAsyncIterable`, whose `iterator.next()`\n\t\t//     park is NON-interruptible — it only unblocks when the stream ends.\n\t\t//     The child's streams end when the child is killed. So the\n\t\t//     terminator must run first to kill the child (ending the streams),\n\t\t//     which lets the drains drain-to-end and their interrupts complete.\n\t\t//     Registering the terminator *before* the drains (e.g. via\n\t\t//     `acquireRelease` at the top, or any pre-`observeProcessLines`\n\t\t//     finalizer) inverts this and deadlocks scope close: the drain\n\t\t//     interrupt can never complete because the terminator that would end\n\t\t//     its stream is queued to run after it.\n\t\t//\n\t\t// The post-readiness `exited`/`processError` observers below are\n\t\t// registered later still, so they are interrupted before the terminator\n\t\t// runs — their `Effect.promise` waits are interruptible, so that unwinds\n\t\t// cleanly without needing the child to exit first.\n\t\tconst child = yield* Effect.uninterruptible(\n\t\t\tEffect.gen(function* () {\n\t\t\t\tconst spawned = yield* Effect.try({\n\t\t\t\t\ttry: () =>\n\t\t\t\t\t\tspawnChild(rendered.command, rendered.args, {\n\t\t\t\t\t\t\tcwd: options.cwd,\n\t\t\t\t\t\t\tenv,\n\t\t\t\t\t\t\tstdio: 'pipe',\n\t\t\t\t\t\t\tdetached: process.platform !== 'win32',\n\t\t\t\t\t\t}),\n\t\t\t\t\tcatch: (cause) =>\n\t\t\t\t\t\tnew HostServiceAcquireError({\n\t\t\t\t\t\t\tserviceName: options.serviceName,\n\t\t\t\t\t\t\tcwd: options.cwd,\n\t\t\t\t\t\t\tcommand: rendered.command,\n\t\t\t\t\t\t\targs: rendered.args,\n\t\t\t\t\t\t\tphase: 'spawn',\n\t\t\t\t\t\t\tmessage: 'host service spawn failed',\n\t\t\t\t\t\t\tcause,\n\t\t\t\t\t\t}),\n\t\t\t\t});\n\t\t\t\tyield* observeProcessLines(\n\t\t\t\t\t{\n\t\t\t\t\t\tstdout: readableToByteStream(\n\t\t\t\t\t\t\tspawned.stdout as unknown as AsyncIterable<Uint8Array> | null | undefined,\n\t\t\t\t\t\t),\n\t\t\t\t\t\tstderr: readableToByteStream(\n\t\t\t\t\t\t\tspawned.stderr as unknown as AsyncIterable<Uint8Array> | null | undefined,\n\t\t\t\t\t\t),\n\t\t\t\t\t},\n\t\t\t\t\t{\n\t\t\t\t\t\tlogger: ctx.logger,\n\t\t\t\t\t\tpluginKey: ctx.pluginKey,\n\t\t\t\t\t\ttag,\n\t\t\t\t\t\tfields: { [SpanAttr.serviceName]: options.serviceName },\n\t\t\t\t\t\tonLine: ({ line, stream }) =>\n\t\t\t\t\t\t\tEffect.sync(() => {\n\t\t\t\t\t\t\t\tobserveReadinessLine(line, stream);\n\t\t\t\t\t\t\t}),\n\t\t\t\t\t},\n\t\t\t\t);\n\t\t\t\tyield* Effect.addFinalizer(() =>\n\t\t\t\t\tEffect.gen(function* () {\n\t\t\t\t\t\tshuttingDown = true;\n\t\t\t\t\t\tif (exitStatus !== null) return;\n\t\t\t\t\t\tyield* terminateChild(spawned, options.shutdownGraceMs, ctx.logger, ctx.pluginKey, tag);\n\t\t\t\t\t}),\n\t\t\t\t);\n\t\t\t\treturn spawned;\n\t\t\t}),\n\t\t);\n\t\tconst exited = onceProcessExit(child).then((status) => {\n\t\t\texitStatus = status;\n\t\t\treturn status;\n\t\t});\n\t\tconst processError = onceProcessError(child);\n\n\t\tconst baseError = new HostServiceAcquireError({\n\t\t\tserviceName: options.serviceName,\n\t\t\tcwd: options.cwd,\n\t\t\tcommand: rendered.command,\n\t\t\targs: rendered.args,\n\t\t\tphase: 'ready',\n\t\t\tmessage: 'host service readiness failed',\n\t\t});\n\t\tconst awaitReadiness = (() => {\n\t\t\tif (options.ready?.kind === 'http') {\n\t\t\t\tconst url = renderPortToken(options.ready.url ?? 'http://127.0.0.1:{port}', port);\n\t\t\t\treturn httpReady(\n\t\t\t\t\turl,\n\t\t\t\t\toptions.ready.timeoutMs ?? DEFAULT_HTTP_READY_TIMEOUT_MS,\n\t\t\t\t\toptions.ready.intervalMs ?? DEFAULT_HTTP_READY_INTERVAL_MS,\n\t\t\t\t\texited,\n\t\t\t\t\tprocessError,\n\t\t\t\t\tbaseError,\n\t\t\t\t);\n\t\t\t}\n\t\t\tif (options.ready?.kind === 'log' && logReadySignal !== null) {\n\t\t\t\treturn logReady(options.ready, logReadySignal, exited, processError, baseError);\n\t\t\t}\n\t\t\treturn Effect.gen(function* () {\n\t\t\t\tyield* awaitManagedProcessReady({\n\t\t\t\t\tready: Effect.promise(\n\t\t\t\t\t\t() => new Promise<void>((resolveReady) => setTimeout(resolveReady, 0)),\n\t\t\t\t\t),\n\t\t\t\t\texit: exited,\n\t\t\t\t\tprocessError,\n\t\t\t\t\tonExitBeforeReady: (status) =>\n\t\t\t\t\t\tnew HostServiceAcquireError({\n\t\t\t\t\t\t\t...baseError,\n\t\t\t\t\t\t\tphase: 'exit',\n\t\t\t\t\t\t\tmessage: 'host service exited before readiness',\n\t\t\t\t\t\t\texitCode: status.code,\n\t\t\t\t\t\t\tsignal: status.signal,\n\t\t\t\t\t\t}),\n\t\t\t\t\tonProcessErrorBeforeReady: (cause) =>\n\t\t\t\t\t\tnew HostServiceAcquireError({\n\t\t\t\t\t\t\t...baseError,\n\t\t\t\t\t\t\tphase: 'spawn',\n\t\t\t\t\t\t\tmessage: 'host service process failed before readiness',\n\t\t\t\t\t\t\tcause,\n\t\t\t\t\t\t}),\n\t\t\t\t});\n\t\t\t});\n\t\t})();\n\t\tconst readinessExit = yield* Effect.exit(awaitReadiness);\n\t\tif (Exit.isFailure(readinessExit)) {\n\t\t\tshuttingDown = true;\n\t\t\tif (exitStatus === null) {\n\t\t\t\tyield* terminateChild(child, options.shutdownGraceMs, ctx.logger, ctx.pluginKey, tag);\n\t\t\t}\n\t\t\treturn yield* Effect.failCause(readinessExit.cause);\n\t\t}\n\n\t\t// Post-readiness observers. These previously used `void\n\t\t// promise.then(() => Effect.runPromise(...))` which could fire\n\t\t// AFTER the surrounding Scope had already closed (running logger\n\t\t// effects outside any scope, with `.catch(() => {})` swallowing\n\t\t// any failures). Fork into the Scope via `Effect.forkScoped` so\n\t\t// that scope-close interrupts the observer fiber cleanly — the\n\t\t// finalizer flips `shuttingDown` first, so expected-exit cases\n\t\t// still no-op as before. These observers are registered after the\n\t\t// terminator finalizer, so on scope close they are interrupted before\n\t\t// it runs; their `Effect.promise` waits are interruptible, so they\n\t\t// unwind cleanly without waiting on the child to exit.\n\t\tyield* Effect.forkScoped(\n\t\t\tEffect.promise(() => exited).pipe(\n\t\t\t\tEffect.flatMap((status) =>\n\t\t\t\t\tshuttingDown\n\t\t\t\t\t\t? Effect.void\n\t\t\t\t\t\t: ctx.logger.log(tag, ctx.pluginKey, {\n\t\t\t\t\t\t\t\tlevel: 'error',\n\t\t\t\t\t\t\t\tmessage: 'host service exited after readiness',\n\t\t\t\t\t\t\t\tfields: {\n\t\t\t\t\t\t\t\t\t[SpanAttr.event]: 'process.exited',\n\t\t\t\t\t\t\t\t\t[SpanAttr.serviceName]: options.serviceName,\n\t\t\t\t\t\t\t\t\t[SpanAttr.exitCode]: status.code,\n\t\t\t\t\t\t\t\t\t[SpanAttr.exitSignal]: status.signal,\n\t\t\t\t\t\t\t\t\t[SpanAttr.exitStatus]: describeProcessExitStatus(status),\n\t\t\t\t\t\t\t\t},\n\t\t\t\t\t\t\t}),\n\t\t\t\t),\n\t\t\t),\n\t\t);\n\t\tyield* Effect.forkScoped(\n\t\t\tEffect.promise(() => processError).pipe(\n\t\t\t\tEffect.flatMap((cause) =>\n\t\t\t\t\tshuttingDown\n\t\t\t\t\t\t? Effect.void\n\t\t\t\t\t\t: ctx.logger.log(tag, ctx.pluginKey, {\n\t\t\t\t\t\t\t\tlevel: 'error',\n\t\t\t\t\t\t\t\tmessage: 'host service process emitted an error after readiness',\n\t\t\t\t\t\t\t\tfields: {\n\t\t\t\t\t\t\t\t\t[SpanAttr.event]: 'process.error',\n\t\t\t\t\t\t\t\t\t[SpanAttr.serviceName]: options.serviceName,\n\t\t\t\t\t\t\t\t\t[SpanAttr.errorCause]: cause,\n\t\t\t\t\t\t\t\t},\n\t\t\t\t\t\t\t}),\n\t\t\t\t),\n\t\t\t),\n\t\t);\n\t});\n\nexport const prepareHostService = (\n\toptions: HostServiceResolvedOptions,\n\tctx: HostServiceAcquireContext,\n): Effect.Effect<PreparedHostService, HostServiceAcquireError, Scope.Scope> =>\n\tEffect.gen(function* () {\n\t\tconst port = yield* allocateHostPort(options, ctx);\n\t\tconst rendered = renderCommand(options, port);\n\t\tconst started = yield* Ref.make(false);\n\t\tconst start = Effect.gen(function* () {\n\t\t\tif (yield* Ref.get(started)) return;\n\t\t\tyield* startHostProcess(options, ctx, port);\n\t\t\tyield* Ref.set(started, true);\n\t\t});\n\n\t\treturn {\n\t\t\tvalue: hostServiceValue(options, port, rendered, ctx.routedUrl ?? null),\n\t\t\tstart,\n\t\t};\n\t});\n\nexport const acquireHostService = (\n\toptions: HostServiceResolvedOptions,\n\tctx: HostServiceAcquireContext,\n): Effect.Effect<HostServiceValue, HostServiceAcquireError, Scope.Scope> =>\n\tEffect.gen(function* () {\n\t\tconst prepared = yield* prepareHostService(options, ctx);\n\t\tyield* prepared.start;\n\t\treturn prepared.value;\n\t});\n"],"mappings":"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"}

package/dist/plugins/internal/acquire-on-chain-artifact.mjs

@@ -0,0 +1,23 @@
+import "../../primitives/artifact-publisher.mjs";
+import { Effect } from "effect";
+//#region src/plugins/internal/acquire-on-chain-artifact.ts
+/** Submit an on-chain artifact spec with the universal
+*  `register: () => Effect.void` no-op baked in. Returns the substrate's
+*  resolved `Produced` payload (decoded cached payload on verify-hit;
+*  freshly produced payload on miss).
+*
+*  Callers that need a non-void `register` (or a phase-preserving
+*  produce wrap) should consume the underlying `publisher.publish`
+*  surface directly. */
+const acquireOnChainArtifact = (publisher, spec) => publisher.publish({
+	namespace: spec.namespace,
+	chain: spec.chain,
+	contentHash: spec.contentHash,
+	verify: spec.verify,
+	produce: spec.produce,
+	register: () => Effect.void
+});
+//#endregion
+export { acquireOnChainArtifact };
+
+//# sourceMappingURL=acquire-on-chain-artifact.mjs.map

package/dist/plugins/internal/acquire-on-chain-artifact.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"acquire-on-chain-artifact.mjs","names":[],"sources":["../../../src/plugins/internal/acquire-on-chain-artifact.ts"],"sourcesContent":["// acquireOnChainArtifact — thin compactor over `ArtifactPublisher.publish`.\n//\n// Recurs across plugins that publish on-chain artifacts (coin/mint,\n// deepbook/pyth, deepbook/deploy, …). All three sites share:\n//\n//   - the `register: () => Effect.void` no-op (these plugins keep no\n//     in-process registry — the cached payload IS the resolved value),\n//   - the `publish<Produced, Verified>({namespace, chain, contentHash,\n//     verify, produce, register})` skeleton.\n//\n// The helper does NOT touch the `produce` body itself: the three\n// consumers' produce pipelines diverge meaningfully (coin/mint uses\n// `signAndDispatch` against the Account bus; deepbook/{pyth,deploy} use\n// `executeSuiTx` against the raw SDK client). Forcing a union over those\n// shapes would either widen the helper to the point of unhelpfulness or\n// regress one of the consumers. Each consumer continues to compose its\n// own `produce`; the helper centralises the surrounding boilerplate.\n//\n// For the rarer \"phase-preserving produce\" pattern (action plugin's\n// Ref-stash to recover typed-error phases across the substrate's\n// ArtifactPublishError wrap), see\n// `substrate/runtime/phase-preserving-produce.ts`.\n//\n// Boundary discipline: this module lives under `plugins/internal/`\n// because it consumes the public `ArtifactPublisher` surface AND the\n// public `ChainId`/`ContentHash` brands. No plugin-domain types leak in;\n// callers project the `Produced` payload to their resolved value\n// themselves.\n\nimport { Effect, type Scope } from 'effect';\n\nimport type { ChainId, ContentHash } from '../../substrate/brand.ts';\nimport {\n\ttype ArtifactPublishError,\n\ttype ArtifactPublisher,\n\ttype ArtifactSpec,\n} from '../../primitives/artifact-publisher.ts';\n\n/** Spec slice consumed by `acquireOnChainArtifact`. Mirrors\n *  `ArtifactSpec<Produced, Verified>` minus the `register` field — the\n *  helper supplies the universal `() => Effect.void` register for\n *  artifact plugins with no in-process registry to feed. */\nexport interface AcquireOnChainArtifactSpec<Produced, Verified> {\n\treadonly namespace: string;\n\treadonly chain: ChainId;\n\treadonly contentHash: ContentHash;\n\treadonly verify: ArtifactSpec<Produced, Verified>['verify'];\n\treadonly produce: ArtifactSpec<Produced, Verified>['produce'];\n}\n\n/** Submit an on-chain artifact spec with the universal\n *  `register: () => Effect.void` no-op baked in. Returns the substrate's\n *  resolved `Produced` payload (decoded cached payload on verify-hit;\n *  freshly produced payload on miss).\n *\n *  Callers that need a non-void `register` (or a phase-preserving\n *  produce wrap) should consume the underlying `publisher.publish`\n *  surface directly. */\nexport const acquireOnChainArtifact = <Produced, Verified>(\n\tpublisher: ArtifactPublisher,\n\tspec: AcquireOnChainArtifactSpec<Produced, Verified>,\n): Effect.Effect<Produced, ArtifactPublishError, Scope.Scope> =>\n\tpublisher.publish<Produced, Verified>({\n\t\tnamespace: spec.namespace,\n\t\tchain: spec.chain,\n\t\tcontentHash: spec.contentHash,\n\t\tverify: spec.verify,\n\t\tproduce: spec.produce,\n\t\t// Register on EVERY cycle (hit AND miss) — substrate contract\n\t\t// (architecture §10). The on-chain-artifact plugins this helper\n\t\t// serves keep no in-process registry; the cached payload carries\n\t\t// everything callers need.\n\t\tregister: () => Effect.void,\n\t});\n"],"mappings":";;;;;;;;;;;AA0DA,MAAa,0BACZ,WACA,SAEA,UAAU,QAA4B;CACrC,WAAW,KAAK;CAChB,OAAO,KAAK;CACZ,aAAa,KAAK;CAClB,QAAQ,KAAK;CACb,SAAS,KAAK;CAKd,gBAAgB,OAAO;CACvB,CAAC"}