@plurnk/plurnk-service 1.7.0 → 1.9.0

package/dist/server/loopDocs.sql

@@ -1,10 +1,16 @@
--- Kernel pull-document reconciliation ({§schemes-self-doc-materialization}).
+-- Worker generated-document reconciliation: the whole {§worker-generated-subtree}
+-- — scheme and tool references, AGENTS.md, and every Functionality family's
+-- documents ({§schemes-self-doc-materialization}, {§tools-resource-materialization},
+-- {§functionality-documents}).
 
 -- PREP: loop_docs_materialized
-SELECT pathname
-FROM entries
-WHERE workspace_id = $workspace_id
-  AND owner_id = $owner_id
-  AND scheme = 'worker'
-  AND substr(pathname, 1, 6) = '/docs/'
-ORDER BY pathname;
+SELECT e.pathname, ec.content
+FROM entries e
+JOIN workers owner ON owner.id = e.owner_id
+LEFT JOIN entry_channels ec ON ec.entry_id = e.id AND ec.name = 'body'
+WHERE owner.workspace_id = $workspace_id
+  AND e.owner_id = $owner_id
+  AND e.scheme = 'worker'
+  AND e.authority = ''
+  AND substr(e.pathname, 1, 9) = '/_plurnk/'
+ORDER BY e.pathname;

package/dist/server/model-catalog.d.ts

@@ -0,0 +1,3 @@
+import { type ModelCatalogPage, type ModelCatalogQuery } from "@plurnk/plurnk-contracts";
+export declare const listModelCatalog: (input: ModelCatalogQuery, env?: NodeJS.ProcessEnv) => ModelCatalogPage;
+//# sourceMappingURL=model-catalog.d.ts.map

package/dist/server/model-catalog.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"model-catalog.d.ts","sourceRoot":"","sources":["../../src/server/model-catalog.ts"],"names":[],"mappings":"AAAA,OAAO,EAGH,KAAK,gBAAgB,EACrB,KAAK,iBAAiB,EAEzB,MAAM,0BAA0B,CAAC;AAuBlC,eAAO,MAAM,gBAAgB,UAClB,iBAAiB,QACnB,MAAM,CAAC,UAAU,KACvB,gBAkEF,CAAC"}

package/dist/server/model-catalog.js

@@ -0,0 +1,83 @@
+import { Validator, } from "@plurnk/plurnk-contracts";
+import { catalogSnapshot, providerCatalogSnapshot, providerNameFromCatalogId, } from "@plurnk/plurnk-models";
+import { providerReadiness } from "@plurnk/plurnk-providers";
+const DEFAULT_LIMIT = 50;
+const compareText = (left, right) => left < right ? -1 : left > right ? 1 : 0;
+const entryMatches = (entry, search) => [
+    entry.selector,
+    entry.provider,
+    entry.providerName,
+    entry.model,
+    entry.modelName,
+].some((value) => value.toLowerCase().includes(search));
+// {§model-catalog} Core composes the release-pinned Models.dev facts with the
+// provider owner's local readiness predicate. Enumeration is pure local work:
+// it never probes, authenticates, selects, or invokes a model.
+export const listModelCatalog = (input, env = process.env) => {
+    const query = Validator.assertModelCatalogQuery(input);
+    const requestedProvider = query.provider?.toLowerCase();
+    const search = query.search?.trim().toLowerCase() ?? "";
+    const availability = query.availability ?? "configured";
+    const offset = query.offset ?? 0;
+    const limit = query.limit ?? DEFAULT_LIMIT;
+    const providers = providerCatalogSnapshot();
+    const readinessByProvider = new Map();
+    const entries = [];
+    for (const [catalogProviderId, models] of Object.entries(catalogSnapshot())) {
+        const provider = providerNameFromCatalogId(catalogProviderId);
+        if (requestedProvider !== undefined && provider.toLowerCase() !== requestedProvider)
+            continue;
+        const providerInfo = providers[catalogProviderId];
+        if (providerInfo === undefined) {
+            throw new Error(`Models.dev catalog provider '${catalogProviderId}' has no provider facts`);
+        }
+        let readiness = readinessByProvider.get(provider);
+        if (readiness === undefined) {
+            const resolved = providerReadiness(provider, env);
+            if (resolved === null) {
+                throw new Error(`Models.dev catalog provider '${catalogProviderId}' has no supported runtime adapter`);
+            }
+            readiness = resolved;
+            readinessByProvider.set(provider, readiness);
+        }
+        if (availability === "configured" && !readiness.ready)
+            continue;
+        for (const [model, info] of Object.entries(models)) {
+            const selector = `${provider}/${model}`;
+            const entry = {
+                selector,
+                provider,
+                providerName: providerInfo.name,
+                model,
+                modelName: info.name,
+                limits: {
+                    contextTokens: info.contextWindow,
+                    ...(info.maxInputTokens === undefined ? {} : { inputTokens: info.maxInputTokens }),
+                    ...(info.maxOutputTokens === undefined ? {} : { outputTokens: info.maxOutputTokens }),
+                },
+                capabilities: {
+                    attachment: info.attachment,
+                    reasoning: info.reasoning,
+                    toolCall: info.toolCall,
+                    ...(info.structuredOutput === undefined ? {} : { structuredOutput: info.structuredOutput }),
+                    ...(info.temperature === undefined ? {} : { temperature: info.temperature }),
+                    inputModalities: [...info.modalities.input],
+                    outputModalities: [...info.modalities.output],
+                },
+                readiness,
+            };
+            if (search.length === 0 || entryMatches(entry, search))
+                entries.push(entry);
+        }
+    }
+    entries.sort((left, right) => compareText(left.selector, right.selector));
+    const items = entries.slice(offset, offset + limit);
+    const nextOffset = offset + items.length;
+    return Validator.assertModelCatalogPage({
+        items,
+        offset,
+        total: entries.length,
+        ...(nextOffset < entries.length ? { nextOffset } : {}),
+    });
+};
+//# sourceMappingURL=model-catalog.js.map

package/dist/server/model-catalog.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"model-catalog.js","sourceRoot":"","sources":["../../src/server/model-catalog.ts"],"names":[],"mappings":"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"}

package/dist/server/model-route.d.ts

@@ -0,0 +1,7 @@
+import type { ModelRoute } from "@plurnk/plurnk-contracts";
+import type { ProviderSpec } from "@plurnk/plurnk-providers";
+import type { Db } from "../core/Db.ts";
+export declare const routeForSpec: (db: Db, spec: ProviderSpec | null) => Promise<number | null>;
+export declare const specForRoute: (db: Db, routeId: number | null) => Promise<ProviderSpec | null>;
+export declare const projectModelRoute: (spec: ProviderSpec) => ModelRoute;
+//# sourceMappingURL=model-route.d.ts.map

package/dist/server/model-route.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"model-route.d.ts","sourceRoot":"","sources":["../../src/server/model-route.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AAC3D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAC7D,OAAO,KAAK,EAAE,EAAE,EAAE,MAAM,eAAe,CAAC;AAExC,eAAO,MAAM,YAAY,OAAc,EAAE,QAAQ,YAAY,GAAG,IAAI,KAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAmB3F,CAAC;AAEF,eAAO,MAAM,YAAY,OAAc,EAAE,WAAW,MAAM,GAAG,IAAI,KAAG,OAAO,CAAC,YAAY,GAAG,IAAI,CAU9F,CAAC;AAGF,eAAO,MAAM,iBAAiB,SAAU,YAAY,KAAG,UAIrD,CAAC"}

package/dist/server/model-route.js

@@ -0,0 +1,47 @@
+// {§worker-model-selection} — create-or-lookup for resolved model routes and the
+// inverse lookup. The owning boundary resolves aliases to a complete route before
+// persistence; no path re-resolves a historical selection through a possibly
+// changed alias declaration.
+export const routeForSpec = async (db, spec) => {
+    if (spec === null)
+        return null;
+    const alias = spec.alias ?? null;
+    const baseUrl = spec.baseUrl ?? null;
+    const existing = await db.model_route_lookup.get({
+        alias,
+        provider: spec.provider,
+        model: spec.model,
+        base_url: baseUrl,
+    });
+    if (existing !== undefined)
+        return existing.id;
+    const created = await db.model_route_create.get({
+        alias,
+        provider: spec.provider,
+        model: spec.model,
+        base_url: baseUrl,
+    });
+    if (created === undefined)
+        throw new Error("model_route_create returned no row");
+    return created.id;
+};
+export const specForRoute = async (db, routeId) => {
+    if (routeId === null)
+        return null;
+    const row = await db.model_route_by_id.get({ id: routeId });
+    if (row === undefined)
+        throw new Error(`model_route ${routeId} is missing`);
+    return {
+        ...(row.alias === null ? {} : { alias: row.alias }),
+        provider: row.provider,
+        model: row.model,
+        ...(row.base_url === null ? {} : { baseUrl: row.base_url }),
+    };
+};
+// The provider endpoint is durable construction state, not client model identity.
+export const projectModelRoute = (spec) => ({
+    ...(spec.alias === undefined ? {} : { alias: spec.alias }),
+    provider: spec.provider,
+    model: spec.model,
+});
+//# sourceMappingURL=model-route.js.map

package/dist/server/model-route.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"model-route.js","sourceRoot":"","sources":["../../src/server/model-route.ts"],"names":[],"mappings":"AAAA,iFAAiF;AACjF,kFAAkF;AAClF,6EAA6E;AAC7E,6BAA6B;AAM7B,MAAM,CAAC,MAAM,YAAY,GAAG,KAAK,EAAE,EAAM,EAAE,IAAyB,EAA0B,EAAE;IAC5F,IAAI,IAAI,KAAK,IAAI;QAAE,OAAO,IAAI,CAAC;IAC/B,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,IAAI,IAAI,CAAC;IACjC,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,IAAI,IAAI,CAAC;IACrC,MAAM,QAAQ,GAAG,MAAM,EAAE,CAAC,kBAAkB,CAAC,GAAG,CAAiB;QAC7D,KAAK;QACL,QAAQ,EAAE,IAAI,CAAC,QAAQ;QACvB,KAAK,EAAE,IAAI,CAAC,KAAK;QACjB,QAAQ,EAAE,OAAO;KACpB,CAAC,CAAC;IACH,IAAI,QAAQ,KAAK,SAAS;QAAE,OAAO,QAAQ,CAAC,EAAE,CAAC;IAC/C,MAAM,OAAO,GAAG,MAAM,EAAE,CAAC,kBAAkB,CAAC,GAAG,CAAiB;QAC5D,KAAK;QACL,QAAQ,EAAE,IAAI,CAAC,QAAQ;QACvB,KAAK,EAAE,IAAI,CAAC,KAAK;QACjB,QAAQ,EAAE,OAAO;KACpB,CAAC,CAAC;IACH,IAAI,OAAO,KAAK,SAAS;QAAE,MAAM,IAAI,KAAK,CAAC,oCAAoC,CAAC,CAAC;IACjF,OAAO,OAAO,CAAC,EAAE,CAAC;AACtB,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,YAAY,GAAG,KAAK,EAAE,EAAM,EAAE,OAAsB,EAAgC,EAAE;IAC/F,IAAI,OAAO,KAAK,IAAI;QAAE,OAAO,IAAI,CAAC;IAClC,MAAM,GAAG,GAAG,MAAM,EAAE,CAAC,iBAAiB,CAAC,GAAG,CAAqF,EAAE,EAAE,EAAE,OAAO,EAAE,CAAC,CAAC;IAChJ,IAAI,GAAG,KAAK,SAAS;QAAE,MAAM,IAAI,KAAK,CAAC,eAAe,OAAO,aAAa,CAAC,CAAC;IAC5E,OAAO;QACH,GAAG,CAAC,GAAG,CAAC,KAAK,KAAK,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,GAAG,CAAC,KAAK,EAAE,CAAC;QACnD,QAAQ,EAAE,GAAG,CAAC,QAAQ;QACtB,KAAK,EAAE,GAAG,CAAC,KAAK;QAChB,GAAG,CAAC,GAAG,CAAC,QAAQ,KAAK,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,GAAG,CAAC,QAAQ,EAAE,CAAC;KAC9D,CAAC;AACN,CAAC,CAAC;AAEF,kFAAkF;AAClF,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,IAAkB,EAAc,EAAE,CAAC,CAAC;IAClE,GAAG,CAAC,IAAI,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,CAAC;IAC1D,QAAQ,EAAE,IAAI,CAAC,QAAQ;IACvB,KAAK,EAAE,IAAI,CAAC,KAAK;CACpB,CAAC,CAAC"}

package/dist/server/module-discovery.d.ts

@@ -0,0 +1,13 @@
+import type { ApplicationPort } from "@plurnk/plurnk-contracts";
+import type { DaemonModule } from "./DaemonModule.ts";
+export declare const discoverDaemonModules: (options?: {
+    cwd?: string;
+    packageDirs?: Array<{
+        dir: string;
+        name: string;
+    }>;
+}) => Promise<{
+    readonly modules: ReadonlyArray<DaemonModule<ApplicationPort>>;
+    readonly skipped: readonly string[];
+}>;
+//# sourceMappingURL=module-discovery.d.ts.map

package/dist/server/module-discovery.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"module-discovery.d.ts","sourceRoot":"","sources":["../../src/server/module-discovery.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,0BAA0B,CAAC;AAChE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAmEtD,eAAO,MAAM,qBAAqB,aACrB;IAAE,GAAG,CAAC,EAAE,MAAM,CAAC;IAAC,WAAW,CAAC,EAAE,KAAK,CAAC;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAA;CAAE,KAC9E,OAAO,CAAC;IAAE,QAAQ,CAAC,OAAO,EAAE,aAAa,CAAC,YAAY,CAAC,eAAe,CAAC,CAAC,CAAC;IAAC,QAAQ,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE,CAAA;CAAE,CAoCjH,CAAC"}

package/dist/server/module-discovery.js

@@ -0,0 +1,103 @@
+var __rewriteRelativeImportExtension = (this && this.__rewriteRelativeImportExtension) || function (path, preserveJsx) {
+    if (typeof path === "string" && /^\.\.?\//.test(path)) {
+        return path.replace(/\.(tsx)$|((?:\.d)?)((?:\.[^./]+?)?)\.([cm]?)ts$/i, function (m, tsx, d, ext, cm) {
+            return tsx ? preserveJsx ? ".jsx" : ".js" : d && (!ext || !cm) ? m : (d + ext + "." + cm.toLowerCase() + "js");
+        });
+    }
+    return path;
+};
+import { join } from "node:path";
+import { pathToFileURL } from "node:url";
+import fs from "node:fs/promises";
+import Meta from "@plurnk/plurnk-meta";
+// {§module-discovery} — third-party daemon-module composition. A package
+// declares `plurnk: { kind: "module", module: "<export-subpath>" }`; the export
+// is one DaemonModule (an object, or a no-arg factory returning one).
+// Discovery mirrors the executor family ({§plugin-discovery}): scope-agnostic
+// package scan, trust gate ({§plugin-trust-boundary}), lazy import.
+//
+// The service's explicit composition — the AG-UI, hooks, and MCP modules —
+// carries init options and is wired in service.ts; discovery never duplicates
+// those packages.
+const EXPLICIT_COMPOSITION = new Set([
+    "@plurnk/plurnk-agui",
+    "@plurnk/plurnk-hooks",
+    "@plurnk/plurnk-mcp",
+]);
+const assertDaemonModule = (value, packageName, source) => {
+    if (typeof value !== "object" || value === null || Array.isArray(value)) {
+        const detail = source === "factory"
+            ? "factory returned a non-object DaemonModule"
+            : "must export a DaemonModule object or no-argument factory";
+        throw new TypeError(`module package '${packageName}' ${detail}.`);
+    }
+    for (const member of ["setup", "start", "close"]) {
+        const hook = value[member];
+        if (hook !== undefined && typeof hook !== "function") {
+            throw new TypeError(`module package '${packageName}' lifecycle member '${member}' must be a function when present.`);
+        }
+    }
+    return value;
+};
+const readManifest = async (dir) => {
+    let raw;
+    try {
+        raw = await fs.readFile(join(dir, "package.json"), "utf8");
+    }
+    catch {
+        return null;
+    }
+    let pkg;
+    try {
+        pkg = JSON.parse(raw);
+    }
+    catch {
+        return null;
+    }
+    const plurnk = pkg.plurnk;
+    if (!Meta.declaresKind(plurnk, "module"))
+        return null;
+    const moduleSubpath = plurnk.module;
+    if (typeof moduleSubpath !== "string" || moduleSubpath.length === 0)
+        return null;
+    const packageName = typeof pkg.name === "string" && pkg.name.length > 0 ? pkg.name : null;
+    if (packageName === null)
+        return null;
+    return { packageName, module: moduleSubpath };
+};
+export const discoverDaemonModules = async (options = {}) => {
+    const compareText = (left, right) => left < right ? -1 : left > right ? 1 : 0;
+    const dirs = (options.packageDirs
+        ?? await Meta.packageDirs(join(options.cwd ?? process.cwd(), "node_modules")))
+        .toSorted((left, right) => compareText(left.name, right.name) || compareText(left.dir, right.dir));
+    const pending = [];
+    const skipped = [];
+    for (const candidate of dirs) {
+        const manifest = await readManifest(candidate.dir);
+        if (manifest === null)
+            continue;
+        if (EXPLICIT_COMPOSITION.has(manifest.packageName))
+            continue;
+        if (!Meta.isTrusted(manifest.packageName)) {
+            skipped.push(manifest.packageName);
+            continue;
+        }
+        pending.push((async () => {
+            const imported = await import(__rewriteRelativeImportExtension(pathToFileURL(join(candidate.dir, manifest.module)).href));
+            const exported = imported.default;
+            if (exported === undefined) {
+                throw new Error(`module package '${manifest.packageName}' exports no default DaemonModule at '${manifest.module}'.`);
+            }
+            if (typeof exported !== "function") {
+                return assertDaemonModule(exported, manifest.packageName, "export");
+            }
+            if (exported.length !== 0) {
+                throw new TypeError(`module package '${manifest.packageName}' DaemonModule factory must accept no arguments.`);
+            }
+            const created = await exported();
+            return assertDaemonModule(created, manifest.packageName, "factory");
+        })());
+    }
+    return { modules: await Promise.all(pending), skipped };
+};
+//# sourceMappingURL=module-discovery.js.map

package/dist/server/module-discovery.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"module-discovery.js","sourceRoot":"","sources":["../../src/server/module-discovery.ts"],"names":[],"mappings":"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"}

package/dist/server/seam-entry-read.sql

@@ -1,12 +1,14 @@
--- CoreSeam readEntry queries. SPEC {§methods-entry-read}.
+-- ApplicationPort readEntry queries. SPEC {§methods-entry-read}.
 
 -- PREP: entry_read_lookup
-SELECT id, workspace_id, owner_id, scheme, pathname
-FROM entries
-WHERE workspace_id = $workspace_id
-  AND owner_id = $owner_id
-  AND scheme = $scheme
-  AND pathname = $pathname;
+SELECT e.id, owner.workspace_id, e.owner_id, e.scheme, e.authority, e.pathname
+FROM entries e
+JOIN workers owner ON owner.id = e.owner_id
+WHERE owner.workspace_id = $workspace_id
+  AND e.owner_id = $owner_id
+  AND e.scheme = $scheme
+  AND e.authority = $authority
+  AND e.pathname = $pathname;
 
 -- PREP: entry_read_channels
 SELECT name, content, 0 AS contentOffset, length(content) AS contentLength, mimetype, weight, state

package/dist/server/seam-log-read.sql

@@ -1,4 +1,4 @@
--- CoreSeam readLog query. SPEC {§methods-log-read}.
+-- ApplicationPort readLog query. SPEC {§methods-log-read}.
 -- Static query with IS-NULL guards on optional filters. The loops/turns joins
 -- resolve the DISPLAY coordinate (loop_seq/turn_seq/op-sequence) so a client can
 -- target one entry by its `L/T/S` coordinate instead of

package/dist/server/seam-loop.sql

@@ -1,4 +1,4 @@
--- CoreSeam runLoop queries. SPEC {§methods-loop-run}.
+-- ApplicationPort runLoop queries. SPEC {§methods-loop-run}.
 
 -- PREP: loop_run_next_sequence
 SELECT COALESCE(MAX(sequence), 0) + 1 AS next FROM loops WHERE worker_id = $worker_id;
@@ -7,3 +7,12 @@ SELECT COALESCE(MAX(sequence), 0) + 1 AS next FROM loops WHERE worker_id = $work
 INSERT INTO loops (worker_id, sequence, status, prompt)
 VALUES ($worker_id, $sequence, 102, $prompt)
 RETURNING id;
+
+-- PREP: application_list_worker_loops
+-- {§methods-worker-loops}: durable lifecycle projection for exterior adapters.
+SELECT id, worker_id AS workerId, sequence, status, prompt,
+       prompt_source AS promptSource, terminated_at AS terminatedAt,
+       terminal_result AS terminalResult
+FROM loops
+WHERE worker_id = $worker_id
+ORDER BY sequence;

package/dist/server/seam-proposal-list.sql

@@ -4,7 +4,8 @@
 -- Daemon nor an interface module reconstructs authority from this persistence shape.
 SELECT le.id AS logEntryId, r.workspace_id AS workspaceId,
     le.worker_id AS workerId, le.loop_id AS loopId, le.turn_id AS turnId,
-    le.op, le.signal, le.scheme, le.pathname, le.rx, le.attrs, l.flags AS loop_flags
+    le.op, le.signal, le.scheme, le.hostname, le.port, le.pathname, le.query,
+    le.rx, le.attrs, l.flags AS loop_flags
 FROM log_entries le
 JOIN workers r ON r.id = le.worker_id
 JOIN loops l ON l.id = le.loop_id
@@ -16,7 +17,8 @@ ORDER BY le.id;
 -- the live path. Both paths enter ProposalLifecycle's one projection function.
 SELECT le.id AS logEntryId, r.workspace_id AS workspaceId,
     le.worker_id AS workerId, le.loop_id AS loopId, le.turn_id AS turnId,
-    le.op, le.signal, le.scheme, le.pathname, le.rx, le.attrs, l.flags AS loop_flags
+    le.op, le.signal, le.scheme, le.hostname, le.port, le.pathname, le.query,
+    le.rx, le.attrs, l.flags AS loop_flags
 FROM log_entries le
 JOIN workers r ON r.id = le.worker_id
 JOIN loops l ON l.id = le.loop_id

package/dist/server/worker-capabilities.sql

@@ -0,0 +1,19 @@
+-- Durable module-owned Worker state. {§module-worker-state}
+
+-- PREP: worker_module_state_get
+SELECT state
+FROM worker_module_state
+WHERE worker_id = $worker_id
+  AND namespace_owner = $namespace_owner;
+
+-- PREP: worker_module_state_put
+INSERT INTO worker_module_state (worker_id, namespace_owner, state)
+VALUES ($worker_id, $namespace_owner, $state)
+ON CONFLICT (worker_id, namespace_owner) DO UPDATE SET
+    state = excluded.state,
+    updated_at = strftime('%Y-%m-%dT%H:%M:%fZ', 'now');
+
+-- PREP: worker_module_state_delete
+DELETE FROM worker_module_state
+WHERE worker_id = $worker_id
+  AND namespace_owner = $namespace_owner;

package/dist/service.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"service.d.ts","sourceRoot":"","sources":["../src/service.ts"],"names":[],"mappings":";AA0BA,MAAM,CAAC,OAAO,OAAO,OAAO;;IAyQxB,OAAa,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CA+EjC;CACJ"}
+{"version":3,"file":"service.d.ts","sourceRoot":"","sources":["../src/service.ts"],"names":[],"mappings":";AAoCA,MAAM,CAAC,OAAO,OAAO,OAAO;;IAqUxB,OAAa,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CAuGjC;CACJ"}