@agimon-ai/po-core 0.0.0-alpha.2 → 0.0.0-alpha.21

package/dist/src/services/chatgptWebSearch/index.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.mjs","names":[],"sources":["../../../../src/services/chatgptWebSearch/index.ts"],"sourcesContent":["import type { DoomHeadlessExecutionContext } from '../../schemas/headless';\nimport { CHATGPT_SIGN_IN_HINT, chatgptCredentials, readBoundedJson } from '../chatgptAuth';\nimport type { ChatgptBackendDependencies } from '../chatgptImages/type';\n\nconst ENDPOINT = 'https://chatgpt.com/backend-api/codex/alpha/search';\nconst MAX_OUTPUT_TOKENS = 10_000; // Codex models.json tool truncation budget.\nconst MAX_COMMANDS_BYTES = 64 * 1024;\n// Fits the layer's ~20k-character excerpt even when every character needs a six-byte JSON escape.\nconst MAX_CONVERSATION_BYTES = 256 * 1024;\nconst MAX_CONVERSATION_ITEMS = 16;\nconst MAX_RESPONSE_BYTES = 4 * 1024 * 1024;\nconst MAX_RESULTS = 100;\nconst LOGIN_MESSAGE = `Web search needs a ChatGPT sign-in. ${CHATGPT_SIGN_IN_HINT}`;\nconst INVALID_RESPONSE = 'Web search returned an invalid response.';\nconst FAILED = 'Web search request failed.';\nconst ACCESS = { cached: false, indexed: 'indexed', live: true } as const;\n// ponytail: copy of Pi's defaultModelPerProvider['openai-codex'] (model-resolver.js), which Pi does not export.\n// Used when the chat model is not a ChatGPT model; goes stale when Pi's catalog moves.\nconst DEFAULT_MODEL = 'gpt-6.1-sol';\n\nexport type WebSearchRequest = Parameters<NonNullable<DoomHeadlessExecutionContext['webSearch']>['search']>[0] & {\n  sessionId: string;\n  /** The active ChatGPT model id; omitted when the chat model belongs to another provider. */\n  model?: string;\n};\n\nfunction record(value: unknown): value is Record<string, unknown> {\n  return typeof value === 'object' && value !== null && !Array.isArray(value);\n}\n\n/** Detaches caller data into plain JSON so the wire body is exactly what was validated. */\nfunction boundedJson(value: unknown, limit: number, message: string): unknown {\n  let json: string | undefined;\n  try {\n    json = JSON.stringify(value);\n  } catch {\n    throw new Error(message);\n  }\n  if (json === undefined || Buffer.byteLength(json) > limit) throw new Error(message);\n  return JSON.parse(json) as unknown;\n}\n\nfunction conversationInput(conversation: unknown) {\n  if (conversation === undefined) return undefined;\n  const message = 'Invalid web search conversation.';\n  if (!Array.isArray(conversation) || conversation.length > MAX_CONVERSATION_ITEMS) throw new Error(message);\n  const items = boundedJson(conversation, MAX_CONVERSATION_BYTES, message) as unknown[];\n  if (items.length === 0) return undefined;\n  return items.map((item) => {\n    if (\n      !record(item) ||\n      (item.role !== 'user' && item.role !== 'assistant') ||\n      typeof item.text !== 'string' ||\n      !item.text\n    )\n      throw new Error(message);\n    return {\n      type: 'message',\n      role: item.role,\n      content: [{ type: item.role === 'user' ? 'input_text' : 'output_text', text: item.text }],\n    };\n  });\n}\n\n/** Host-only transport: authentication never crosses the facet boundary. */\nexport function createChatgptWebSearchClient(dependencies: ChatgptBackendDependencies) {\n  return {\n    async search(request: WebSearchRequest): Promise<{ output: string; results?: Record<string, unknown>[] }> {\n      const { signal } = request;\n      signal?.throwIfAborted();\n      if (!record(request.commands) || Object.keys(request.commands).length === 0)\n        throw new Error('Invalid web search commands.');\n      const commands = boundedJson(request.commands, MAX_COMMANDS_BYTES, 'Invalid web search commands.');\n      const input = conversationInput(request.conversation);\n      if (!Object.hasOwn(ACCESS, request.access)) throw new Error('Invalid web search access mode.');\n      const model = request.model ?? DEFAULT_MODEL;\n      if (typeof model !== 'string' || !/^[A-Za-z0-9._:-]{1,128}$/.test(model))\n        throw new Error('Invalid web search model.');\n      if (typeof request.sessionId !== 'string' || !/^[\\x21-\\x7e]{1,256}$/.test(request.sessionId))\n        throw new Error('Invalid web search session.');\n      const { token, accountId } = await chatgptCredentials(dependencies, LOGIN_MESSAGE, signal);\n      let response: Response;\n      try {\n        response = await (dependencies.fetch ?? globalThis.fetch)(ENDPOINT, {\n          method: 'POST',\n          redirect: 'error',\n          signal,\n          headers: {\n            Authorization: `Bearer ${token}`,\n            'chatgpt-account-id': accountId,\n            originator: 'po_web_search',\n            'User-Agent': '@agimon-ai/po-web-search',\n            'Content-Type': 'application/json',\n            Accept: 'application/json',\n          },\n          body: JSON.stringify({\n            id: request.sessionId,\n            model,\n            ...(input ? { input } : {}),\n            commands,\n            settings: { allowed_callers: ['direct'], external_web_access: ACCESS[request.access] },\n            max_output_tokens: MAX_OUTPUT_TOKENS,\n          }),\n        });\n      } catch {\n        signal?.throwIfAborted();\n        throw new Error(FAILED);\n      }\n      if (!response.ok) {\n        await response.body?.cancel().catch(() => undefined);\n        if (response.status === 401) throw new Error(LOGIN_MESSAGE);\n        if (response.status === 403) throw new Error('Web search is not available for this ChatGPT account.');\n        if (response.status === 429) {\n          const retry = response.headers.get('retry-after');\n          throw new Error(\n            `Web search quota reached.${retry && /^\\d{1,6}$/.test(retry) ? ` Try again in ${retry} seconds.` : ''}`,\n          );\n        }\n        throw new Error(`Web search request failed (HTTP ${response.status}).`);\n      }\n      let body: unknown;\n      try {\n        body = await readBoundedJson(response, MAX_RESPONSE_BYTES, signal);\n      } catch {\n        signal?.throwIfAborted();\n        throw new Error(INVALID_RESPONSE);\n      }\n      if (!record(body) || typeof body.output !== 'string') throw new Error(INVALID_RESPONSE);\n      const output = body.output.trim() ? body.output : 'Web search returned no results.';\n      // `results` is display-only, so a malformed list is dropped rather than failing the search.\n      const results =\n        Array.isArray(body.results) && body.results.length <= MAX_RESULTS && body.results.every(record)\n          ? body.results\n          : undefined;\n      return results ? { output, results } : { output };\n    },\n  };\n}\n"],"mappings":"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"}
+{"version":3,"file":"index.mjs","names":[],"sources":["../../../../src/services/chatgptWebSearch/index.ts"],"sourcesContent":["import type { PoHeadlessExecutionContext } from '../../schemas/headless';\nimport { CHATGPT_SIGN_IN_HINT, chatgptCredentials, readBoundedJson } from '../chatgptAuth';\nimport type { ChatgptBackendDependencies } from '../chatgptImages/type';\n\nconst ENDPOINT = 'https://chatgpt.com/backend-api/codex/alpha/search';\nconst MAX_OUTPUT_TOKENS = 10_000; // Codex models.json tool truncation budget.\nconst MAX_COMMANDS_BYTES = 64 * 1024;\n// Fits the layer's ~20k-character excerpt even when every character needs a six-byte JSON escape.\nconst MAX_CONVERSATION_BYTES = 256 * 1024;\nconst MAX_CONVERSATION_ITEMS = 16;\nconst MAX_RESPONSE_BYTES = 4 * 1024 * 1024;\nconst MAX_RESULTS = 100;\nconst LOGIN_MESSAGE = `Web search needs a ChatGPT sign-in. ${CHATGPT_SIGN_IN_HINT}`;\nconst INVALID_RESPONSE = 'Web search returned an invalid response.';\nconst FAILED = 'Web search request failed.';\nconst ACCESS = { cached: false, indexed: 'indexed', live: true } as const;\n// ponytail: copy of Pi's defaultModelPerProvider['openai-codex'] (model-resolver.js), which Pi does not export.\n// Used when the chat model is not a ChatGPT model; goes stale when Pi's catalog moves.\nconst DEFAULT_MODEL = 'gpt-6.1-sol';\n\nexport type WebSearchRequest = Parameters<NonNullable<PoHeadlessExecutionContext['webSearch']>['search']>[0] & {\n  sessionId: string;\n  /** The active ChatGPT model id; omitted when the chat model belongs to another provider. */\n  model?: string;\n};\n\nfunction record(value: unknown): value is Record<string, unknown> {\n  return typeof value === 'object' && value !== null && !Array.isArray(value);\n}\n\n/** Detaches caller data into plain JSON so the wire body is exactly what was validated. */\nfunction boundedJson(value: unknown, limit: number, message: string): unknown {\n  let json: string | undefined;\n  try {\n    json = JSON.stringify(value);\n  } catch {\n    throw new Error(message);\n  }\n  if (json === undefined || Buffer.byteLength(json) > limit) throw new Error(message);\n  return JSON.parse(json) as unknown;\n}\n\nfunction conversationInput(conversation: unknown) {\n  if (conversation === undefined) return undefined;\n  const message = 'Invalid web search conversation.';\n  if (!Array.isArray(conversation) || conversation.length > MAX_CONVERSATION_ITEMS) throw new Error(message);\n  const items = boundedJson(conversation, MAX_CONVERSATION_BYTES, message) as unknown[];\n  if (items.length === 0) return undefined;\n  return items.map((item) => {\n    if (\n      !record(item) ||\n      (item.role !== 'user' && item.role !== 'assistant') ||\n      typeof item.text !== 'string' ||\n      !item.text\n    )\n      throw new Error(message);\n    return {\n      type: 'message',\n      role: item.role,\n      content: [{ type: item.role === 'user' ? 'input_text' : 'output_text', text: item.text }],\n    };\n  });\n}\n\n/** Host-only transport: authentication never crosses the package boundary. */\nexport function createChatgptWebSearchClient(dependencies: ChatgptBackendDependencies) {\n  return {\n    async search(request: WebSearchRequest): Promise<{ output: string; results?: Record<string, unknown>[] }> {\n      const { signal } = request;\n      signal?.throwIfAborted();\n      if (!record(request.commands) || Object.keys(request.commands).length === 0)\n        throw new Error('Invalid web search commands.');\n      const commands = boundedJson(request.commands, MAX_COMMANDS_BYTES, 'Invalid web search commands.');\n      const input = conversationInput(request.conversation);\n      if (!Object.hasOwn(ACCESS, request.access)) throw new Error('Invalid web search access mode.');\n      const model = request.model ?? DEFAULT_MODEL;\n      if (typeof model !== 'string' || !/^[A-Za-z0-9._:-]{1,128}$/.test(model))\n        throw new Error('Invalid web search model.');\n      if (typeof request.sessionId !== 'string' || !/^[\\x21-\\x7e]{1,256}$/.test(request.sessionId))\n        throw new Error('Invalid web search session.');\n      const { token, accountId } = await chatgptCredentials(dependencies, LOGIN_MESSAGE, signal);\n      let response: Response;\n      try {\n        response = await (dependencies.fetch ?? globalThis.fetch)(ENDPOINT, {\n          method: 'POST',\n          redirect: 'error',\n          signal,\n          headers: {\n            Authorization: `Bearer ${token}`,\n            'chatgpt-account-id': accountId,\n            originator: 'po_web_search',\n            'User-Agent': '@agimon-ai/po-web-search',\n            'Content-Type': 'application/json',\n            Accept: 'application/json',\n          },\n          body: JSON.stringify({\n            id: request.sessionId,\n            model,\n            ...(input ? { input } : {}),\n            commands,\n            settings: { allowed_callers: ['direct'], external_web_access: ACCESS[request.access] },\n            max_output_tokens: MAX_OUTPUT_TOKENS,\n          }),\n        });\n      } catch {\n        signal?.throwIfAborted();\n        throw new Error(FAILED);\n      }\n      if (!response.ok) {\n        await response.body?.cancel().catch(() => undefined);\n        if (response.status === 401) throw new Error(LOGIN_MESSAGE);\n        if (response.status === 403) throw new Error('Web search is not available for this ChatGPT account.');\n        if (response.status === 429) {\n          const retry = response.headers.get('retry-after');\n          throw new Error(\n            `Web search quota reached.${retry && /^\\d{1,6}$/.test(retry) ? ` Try again in ${retry} seconds.` : ''}`,\n          );\n        }\n        throw new Error(`Web search request failed (HTTP ${response.status}).`);\n      }\n      let body: unknown;\n      try {\n        body = await readBoundedJson(response, MAX_RESPONSE_BYTES, signal);\n      } catch {\n        signal?.throwIfAborted();\n        throw new Error(INVALID_RESPONSE);\n      }\n      if (!record(body) || typeof body.output !== 'string') throw new Error(INVALID_RESPONSE);\n      const output = body.output.trim() ? body.output : 'Web search returned no results.';\n      // `results` is display-only, so a malformed list is dropped rather than failing the search.\n      const results =\n        Array.isArray(body.results) && body.results.length <= MAX_RESULTS && body.results.every(record)\n          ? body.results\n          : undefined;\n      return results ? { output, results } : { output };\n    },\n  };\n}\n"],"mappings":"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"}

package/dist/src/services/contextContributions/index.cjs

@@ -5,14 +5,14 @@ function compareContributions(left, right) {
 	return left.order - right.order || sourceOrder || idOrder;
 }
 function assertNonEmpty(value, field) {
-	if (value.trim().length === 0) throw new Error(`Doom context contribution ${field} must not be empty.`);
+	if (value.trim().length === 0) throw new Error(`Po context contribution ${field} must not be empty.`);
 }
 function contributionErrorMessage(error) {
 	return error instanceof Error ? error.message : String(error);
 }
-/** Creates the host-owned aggregation service for one Doom session generation. */
-function createDoomContextContributionsService(generation) {
-	if (!generation) throw new Error("Doom context contributions require a session generation.");
+/** Creates the host-owned aggregation service for one Po session generation. */
+function createPoContextContributionsService(generation) {
+	if (!generation) throw new Error("Po context contributions require a session generation.");
 	const contributions = /* @__PURE__ */ new Map();
 	return Object.freeze({
 		generation,
@@ -20,10 +20,10 @@ function createDoomContextContributionsService(generation) {
 			assertNonEmpty(contribution.source, "source");
 			assertNonEmpty(contribution.id, "id");
 			assertNonEmpty(contribution.label, "label");
-			if (!Number.isFinite(contribution.order)) throw new Error("Doom context contribution order must be a finite number.");
-			if (typeof contribution.snapshot !== "function") throw new Error("Doom context contribution snapshot must be a function.");
+			if (!Number.isFinite(contribution.order)) throw new Error("Po context contribution order must be a finite number.");
+			if (typeof contribution.snapshot !== "function") throw new Error("Po context contribution snapshot must be a function.");
 			const key = JSON.stringify([contribution.source, contribution.id]);
-			if (contributions.has(key)) throw new Error(`Doom context contribution is already registered: ${contribution.source}/${contribution.id}.`);
+			if (contributions.has(key)) throw new Error(`Po context contribution is already registered: ${contribution.source}/${contribution.id}.`);
 			const stored = Object.freeze({
 				key,
 				source: contribution.source,
@@ -74,6 +74,6 @@ function createDoomContextContributionsService(generation) {
 	});
 }
 //#endregion
-exports.createDoomContextContributionsService = createDoomContextContributionsService;
+exports.createPoContextContributionsService = createPoContextContributionsService;
 
 //# sourceMappingURL=index.cjs.map

package/dist/src/services/contextContributions/index.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.cjs","names":[],"sources":["../../../../src/services/contextContributions/index.ts"],"sourcesContent":["import type {\n  DoomContextContribution,\n  DoomContextContributionEntry,\n  DoomContextContributionError,\n  DoomContextContributionRegistration,\n  DoomContextContributionsService,\n  DoomContextContributionsSnapshot,\n} from '../../schemas/contextContributions';\n\ninterface StoredContribution extends DoomContextContribution {\n  readonly key: string;\n}\n\nfunction compareContributions(left: DoomContextContribution, right: DoomContextContribution): number {\n  const sourceOrder = left.source < right.source ? -1 : left.source > right.source ? 1 : 0;\n  const idOrder = left.id < right.id ? -1 : left.id > right.id ? 1 : 0;\n  return left.order - right.order || sourceOrder || idOrder;\n}\n\nfunction assertNonEmpty(value: string, field: string): void {\n  if (value.trim().length === 0) throw new Error(`Doom context contribution ${field} must not be empty.`);\n}\n\nfunction contributionErrorMessage(error: unknown): string {\n  return error instanceof Error ? error.message : String(error);\n}\n\n/** Creates the host-owned aggregation service for one Doom session generation. */\nexport function createDoomContextContributionsService(generation: string): DoomContextContributionsService {\n  if (!generation) throw new Error('Doom context contributions require a session generation.');\n\n  const contributions = new Map<string, StoredContribution>();\n  return Object.freeze({\n    generation,\n    register(contribution: DoomContextContribution): DoomContextContributionRegistration {\n      assertNonEmpty(contribution.source, 'source');\n      assertNonEmpty(contribution.id, 'id');\n      assertNonEmpty(contribution.label, 'label');\n      if (!Number.isFinite(contribution.order)) {\n        throw new Error('Doom context contribution order must be a finite number.');\n      }\n      if (typeof contribution.snapshot !== 'function') {\n        throw new Error('Doom context contribution snapshot must be a function.');\n      }\n\n      const key = JSON.stringify([contribution.source, contribution.id]);\n      if (contributions.has(key)) {\n        throw new Error(`Doom context contribution is already registered: ${contribution.source}/${contribution.id}.`);\n      }\n      const stored: StoredContribution = Object.freeze({\n        key,\n        source: contribution.source,\n        id: contribution.id,\n        label: contribution.label,\n        order: contribution.order,\n        snapshot: () => contribution.snapshot(),\n      });\n      contributions.set(key, stored);\n\n      let disposed = false;\n      return Object.freeze({\n        dispose(): void {\n          if (disposed) return;\n          disposed = true;\n          if (contributions.get(key) === stored) contributions.delete(key);\n        },\n      });\n    },\n    snapshot(): DoomContextContributionsSnapshot {\n      const entries: DoomContextContributionEntry[] = [];\n      const errors: DoomContextContributionError[] = [];\n      const ordered = [...contributions.values()].sort(compareContributions);\n\n      for (const contribution of ordered) {\n        const identity = {\n          source: contribution.source,\n          id: contribution.id,\n          label: contribution.label,\n          order: contribution.order,\n        };\n        try {\n          const text = contribution.snapshot();\n          if (text === undefined) continue;\n          if (typeof text !== 'string') throw new Error('Snapshot returned a non-string value.');\n          entries.push(Object.freeze({ ...identity, text }));\n        } catch (error) {\n          errors.push(Object.freeze({ ...identity, message: contributionErrorMessage(error) }));\n        }\n      }\n\n      return Object.freeze({ entries: Object.freeze(entries), errors: Object.freeze(errors) });\n    },\n  });\n}\n"],"mappings":";AAaA,SAAS,qBAAqB,MAA+B,OAAwC;CACnG,MAAM,cAAc,KAAK,SAAS,MAAM,SAAS,KAAK,KAAK,SAAS,MAAM,SAAS,IAAI;CACvF,MAAM,UAAU,KAAK,KAAK,MAAM,KAAK,KAAK,KAAK,KAAK,MAAM,KAAK,IAAI;CACnE,OAAO,KAAK,QAAQ,MAAM,SAAS,eAAe;AACpD;AAEA,SAAS,eAAe,OAAe,OAAqB;CAC1D,IAAI,MAAM,KAAK,CAAC,CAAC,WAAW,GAAG,MAAM,IAAI,MAAM,6BAA6B,MAAM,oBAAoB;AACxG;AAEA,SAAS,yBAAyB,OAAwB;CACxD,OAAO,iBAAiB,QAAQ,MAAM,UAAU,OAAO,KAAK;AAC9D;;AAGA,SAAgB,sCAAsC,YAAqD;CACzG,IAAI,CAAC,YAAY,MAAM,IAAI,MAAM,0DAA0D;CAE3F,MAAM,gCAAgB,IAAI,IAAgC;CAC1D,OAAO,OAAO,OAAO;EACnB;EACA,SAAS,cAA4E;GACnF,eAAe,aAAa,QAAQ,QAAQ;GAC5C,eAAe,aAAa,IAAI,IAAI;GACpC,eAAe,aAAa,OAAO,OAAO;GAC1C,IAAI,CAAC,OAAO,SAAS,aAAa,KAAK,GACrC,MAAM,IAAI,MAAM,0DAA0D;GAE5E,IAAI,OAAO,aAAa,aAAa,YACnC,MAAM,IAAI,MAAM,wDAAwD;GAG1E,MAAM,MAAM,KAAK,UAAU,CAAC,aAAa,QAAQ,aAAa,EAAE,CAAC;GACjE,IAAI,cAAc,IAAI,GAAG,GACvB,MAAM,IAAI,MAAM,oDAAoD,aAAa,OAAO,GAAG,aAAa,GAAG,EAAE;GAE/G,MAAM,SAA6B,OAAO,OAAO;IAC/C;IACA,QAAQ,aAAa;IACrB,IAAI,aAAa;IACjB,OAAO,aAAa;IACpB,OAAO,aAAa;IACpB,gBAAgB,aAAa,SAAS;GACxC,CAAC;GACD,cAAc,IAAI,KAAK,MAAM;GAE7B,IAAI,WAAW;GACf,OAAO,OAAO,OAAO,EACnB,UAAgB;IACd,IAAI,UAAU;IACd,WAAW;IACX,IAAI,cAAc,IAAI,GAAG,MAAM,QAAQ,cAAc,OAAO,GAAG;GACjE,EACF,CAAC;EACH;EACA,WAA6C;GAC3C,MAAM,UAA0C,CAAC;GACjD,MAAM,SAAyC,CAAC;GAChD,MAAM,UAAU,CAAC,GAAG,cAAc,OAAO,CAAC,CAAC,CAAC,KAAK,oBAAoB;GAErE,KAAK,MAAM,gBAAgB,SAAS;IAClC,MAAM,WAAW;KACf,QAAQ,aAAa;KACrB,IAAI,aAAa;KACjB,OAAO,aAAa;KACpB,OAAO,aAAa;IACtB;IACA,IAAI;KACF,MAAM,OAAO,aAAa,SAAS;KACnC,IAAI,SAAS,KAAA,GAAW;KACxB,IAAI,OAAO,SAAS,UAAU,MAAM,IAAI,MAAM,uCAAuC;KACrF,QAAQ,KAAK,OAAO,OAAO;MAAE,GAAG;MAAU;KAAK,CAAC,CAAC;IACnD,SAAS,OAAO;KACd,OAAO,KAAK,OAAO,OAAO;MAAE,GAAG;MAAU,SAAS,yBAAyB,KAAK;KAAE,CAAC,CAAC;IACtF;GACF;GAEA,OAAO,OAAO,OAAO;IAAE,SAAS,OAAO,OAAO,OAAO;IAAG,QAAQ,OAAO,OAAO,MAAM;GAAE,CAAC;EACzF;CACF,CAAC;AACH"}
+{"version":3,"file":"index.cjs","names":[],"sources":["../../../../src/services/contextContributions/index.ts"],"sourcesContent":["import type {\n  PoContextContribution,\n  PoContextContributionEntry,\n  PoContextContributionError,\n  PoContextContributionRegistration,\n  PoContextContributionsService,\n  PoContextContributionsSnapshot,\n} from '../../schemas/contextContributions';\n\ninterface StoredContribution extends PoContextContribution {\n  readonly key: string;\n}\n\nfunction compareContributions(left: PoContextContribution, right: PoContextContribution): number {\n  const sourceOrder = left.source < right.source ? -1 : left.source > right.source ? 1 : 0;\n  const idOrder = left.id < right.id ? -1 : left.id > right.id ? 1 : 0;\n  return left.order - right.order || sourceOrder || idOrder;\n}\n\nfunction assertNonEmpty(value: string, field: string): void {\n  if (value.trim().length === 0) throw new Error(`Po context contribution ${field} must not be empty.`);\n}\n\nfunction contributionErrorMessage(error: unknown): string {\n  return error instanceof Error ? error.message : String(error);\n}\n\n/** Creates the host-owned aggregation service for one Po session generation. */\nexport function createPoContextContributionsService(generation: string): PoContextContributionsService {\n  if (!generation) throw new Error('Po context contributions require a session generation.');\n\n  const contributions = new Map<string, StoredContribution>();\n  return Object.freeze({\n    generation,\n    register(contribution: PoContextContribution): PoContextContributionRegistration {\n      assertNonEmpty(contribution.source, 'source');\n      assertNonEmpty(contribution.id, 'id');\n      assertNonEmpty(contribution.label, 'label');\n      if (!Number.isFinite(contribution.order)) {\n        throw new Error('Po context contribution order must be a finite number.');\n      }\n      if (typeof contribution.snapshot !== 'function') {\n        throw new Error('Po context contribution snapshot must be a function.');\n      }\n\n      const key = JSON.stringify([contribution.source, contribution.id]);\n      if (contributions.has(key)) {\n        throw new Error(`Po context contribution is already registered: ${contribution.source}/${contribution.id}.`);\n      }\n      const stored: StoredContribution = Object.freeze({\n        key,\n        source: contribution.source,\n        id: contribution.id,\n        label: contribution.label,\n        order: contribution.order,\n        snapshot: () => contribution.snapshot(),\n      });\n      contributions.set(key, stored);\n\n      let disposed = false;\n      return Object.freeze({\n        dispose(): void {\n          if (disposed) return;\n          disposed = true;\n          if (contributions.get(key) === stored) contributions.delete(key);\n        },\n      });\n    },\n    snapshot(): PoContextContributionsSnapshot {\n      const entries: PoContextContributionEntry[] = [];\n      const errors: PoContextContributionError[] = [];\n      const ordered = [...contributions.values()].sort(compareContributions);\n\n      for (const contribution of ordered) {\n        const identity = {\n          source: contribution.source,\n          id: contribution.id,\n          label: contribution.label,\n          order: contribution.order,\n        };\n        try {\n          const text = contribution.snapshot();\n          if (text === undefined) continue;\n          if (typeof text !== 'string') throw new Error('Snapshot returned a non-string value.');\n          entries.push(Object.freeze({ ...identity, text }));\n        } catch (error) {\n          errors.push(Object.freeze({ ...identity, message: contributionErrorMessage(error) }));\n        }\n      }\n\n      return Object.freeze({ entries: Object.freeze(entries), errors: Object.freeze(errors) });\n    },\n  });\n}\n"],"mappings":";AAaA,SAAS,qBAAqB,MAA6B,OAAsC;CAC/F,MAAM,cAAc,KAAK,SAAS,MAAM,SAAS,KAAK,KAAK,SAAS,MAAM,SAAS,IAAI;CACvF,MAAM,UAAU,KAAK,KAAK,MAAM,KAAK,KAAK,KAAK,KAAK,MAAM,KAAK,IAAI;CACnE,OAAO,KAAK,QAAQ,MAAM,SAAS,eAAe;AACpD;AAEA,SAAS,eAAe,OAAe,OAAqB;CAC1D,IAAI,MAAM,KAAK,CAAC,CAAC,WAAW,GAAG,MAAM,IAAI,MAAM,2BAA2B,MAAM,oBAAoB;AACtG;AAEA,SAAS,yBAAyB,OAAwB;CACxD,OAAO,iBAAiB,QAAQ,MAAM,UAAU,OAAO,KAAK;AAC9D;;AAGA,SAAgB,oCAAoC,YAAmD;CACrG,IAAI,CAAC,YAAY,MAAM,IAAI,MAAM,wDAAwD;CAEzF,MAAM,gCAAgB,IAAI,IAAgC;CAC1D,OAAO,OAAO,OAAO;EACnB;EACA,SAAS,cAAwE;GAC/E,eAAe,aAAa,QAAQ,QAAQ;GAC5C,eAAe,aAAa,IAAI,IAAI;GACpC,eAAe,aAAa,OAAO,OAAO;GAC1C,IAAI,CAAC,OAAO,SAAS,aAAa,KAAK,GACrC,MAAM,IAAI,MAAM,wDAAwD;GAE1E,IAAI,OAAO,aAAa,aAAa,YACnC,MAAM,IAAI,MAAM,sDAAsD;GAGxE,MAAM,MAAM,KAAK,UAAU,CAAC,aAAa,QAAQ,aAAa,EAAE,CAAC;GACjE,IAAI,cAAc,IAAI,GAAG,GACvB,MAAM,IAAI,MAAM,kDAAkD,aAAa,OAAO,GAAG,aAAa,GAAG,EAAE;GAE7G,MAAM,SAA6B,OAAO,OAAO;IAC/C;IACA,QAAQ,aAAa;IACrB,IAAI,aAAa;IACjB,OAAO,aAAa;IACpB,OAAO,aAAa;IACpB,gBAAgB,aAAa,SAAS;GACxC,CAAC;GACD,cAAc,IAAI,KAAK,MAAM;GAE7B,IAAI,WAAW;GACf,OAAO,OAAO,OAAO,EACnB,UAAgB;IACd,IAAI,UAAU;IACd,WAAW;IACX,IAAI,cAAc,IAAI,GAAG,MAAM,QAAQ,cAAc,OAAO,GAAG;GACjE,EACF,CAAC;EACH;EACA,WAA2C;GACzC,MAAM,UAAwC,CAAC;GAC/C,MAAM,SAAuC,CAAC;GAC9C,MAAM,UAAU,CAAC,GAAG,cAAc,OAAO,CAAC,CAAC,CAAC,KAAK,oBAAoB;GAErE,KAAK,MAAM,gBAAgB,SAAS;IAClC,MAAM,WAAW;KACf,QAAQ,aAAa;KACrB,IAAI,aAAa;KACjB,OAAO,aAAa;KACpB,OAAO,aAAa;IACtB;IACA,IAAI;KACF,MAAM,OAAO,aAAa,SAAS;KACnC,IAAI,SAAS,KAAA,GAAW;KACxB,IAAI,OAAO,SAAS,UAAU,MAAM,IAAI,MAAM,uCAAuC;KACrF,QAAQ,KAAK,OAAO,OAAO;MAAE,GAAG;MAAU;KAAK,CAAC,CAAC;IACnD,SAAS,OAAO;KACd,OAAO,KAAK,OAAO,OAAO;MAAE,GAAG;MAAU,SAAS,yBAAyB,KAAK;KAAE,CAAC,CAAC;IACtF;GACF;GAEA,OAAO,OAAO,OAAO;IAAE,SAAS,OAAO,OAAO,OAAO;IAAG,QAAQ,OAAO,OAAO,MAAM;GAAE,CAAC;EACzF;CACF,CAAC;AACH"}

package/dist/src/services/contextContributions/index.d.mts

@@ -1,6 +1,6 @@
-import { DoomContextContributionsService } from "../../schemas/contextContributions.mjs";
+import { PoContextContributionsService } from "../../schemas/contextContributions.mjs";
 //#region src/services/contextContributions/index.d.ts
-/** Creates the host-owned aggregation service for one Doom session generation. */
-export declare function createDoomContextContributionsService(generation: string): DoomContextContributionsService;
+/** Creates the host-owned aggregation service for one Po session generation. */
+export declare function createPoContextContributionsService(generation: string): PoContextContributionsService;
 //#endregion
 //# sourceMappingURL=index.d.mts.map

package/dist/src/services/contextContributions/index.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.mts","names":[],"sources":["../../../../src/services/contextContributions/index.ts"],"mappings":";;;wBA4BgB,sCAAsC,qBAAqB"}
+{"version":3,"file":"index.d.mts","names":[],"sources":["../../../../src/services/contextContributions/index.ts"],"mappings":";;;wBA4BgB,oCAAoC,qBAAqB"}

package/dist/src/services/contextContributions/index.mjs

@@ -5,14 +5,14 @@ function compareContributions(left, right) {
 	return left.order - right.order || sourceOrder || idOrder;
 }
 function assertNonEmpty(value, field) {
-	if (value.trim().length === 0) throw new Error(`Doom context contribution ${field} must not be empty.`);
+	if (value.trim().length === 0) throw new Error(`Po context contribution ${field} must not be empty.`);
 }
 function contributionErrorMessage(error) {
 	return error instanceof Error ? error.message : String(error);
 }
-/** Creates the host-owned aggregation service for one Doom session generation. */
-function createDoomContextContributionsService(generation) {
-	if (!generation) throw new Error("Doom context contributions require a session generation.");
+/** Creates the host-owned aggregation service for one Po session generation. */
+function createPoContextContributionsService(generation) {
+	if (!generation) throw new Error("Po context contributions require a session generation.");
 	const contributions = /* @__PURE__ */ new Map();
 	return Object.freeze({
 		generation,
@@ -20,10 +20,10 @@ function createDoomContextContributionsService(generation) {
 			assertNonEmpty(contribution.source, "source");
 			assertNonEmpty(contribution.id, "id");
 			assertNonEmpty(contribution.label, "label");
-			if (!Number.isFinite(contribution.order)) throw new Error("Doom context contribution order must be a finite number.");
-			if (typeof contribution.snapshot !== "function") throw new Error("Doom context contribution snapshot must be a function.");
+			if (!Number.isFinite(contribution.order)) throw new Error("Po context contribution order must be a finite number.");
+			if (typeof contribution.snapshot !== "function") throw new Error("Po context contribution snapshot must be a function.");
 			const key = JSON.stringify([contribution.source, contribution.id]);
-			if (contributions.has(key)) throw new Error(`Doom context contribution is already registered: ${contribution.source}/${contribution.id}.`);
+			if (contributions.has(key)) throw new Error(`Po context contribution is already registered: ${contribution.source}/${contribution.id}.`);
 			const stored = Object.freeze({
 				key,
 				source: contribution.source,
@@ -74,6 +74,6 @@ function createDoomContextContributionsService(generation) {
 	});
 }
 //#endregion
-export { createDoomContextContributionsService };
+export { createPoContextContributionsService };
 
 //# sourceMappingURL=index.mjs.map

package/dist/src/services/contextContributions/index.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.mjs","names":[],"sources":["../../../../src/services/contextContributions/index.ts"],"sourcesContent":["import type {\n  DoomContextContribution,\n  DoomContextContributionEntry,\n  DoomContextContributionError,\n  DoomContextContributionRegistration,\n  DoomContextContributionsService,\n  DoomContextContributionsSnapshot,\n} from '../../schemas/contextContributions';\n\ninterface StoredContribution extends DoomContextContribution {\n  readonly key: string;\n}\n\nfunction compareContributions(left: DoomContextContribution, right: DoomContextContribution): number {\n  const sourceOrder = left.source < right.source ? -1 : left.source > right.source ? 1 : 0;\n  const idOrder = left.id < right.id ? -1 : left.id > right.id ? 1 : 0;\n  return left.order - right.order || sourceOrder || idOrder;\n}\n\nfunction assertNonEmpty(value: string, field: string): void {\n  if (value.trim().length === 0) throw new Error(`Doom context contribution ${field} must not be empty.`);\n}\n\nfunction contributionErrorMessage(error: unknown): string {\n  return error instanceof Error ? error.message : String(error);\n}\n\n/** Creates the host-owned aggregation service for one Doom session generation. */\nexport function createDoomContextContributionsService(generation: string): DoomContextContributionsService {\n  if (!generation) throw new Error('Doom context contributions require a session generation.');\n\n  const contributions = new Map<string, StoredContribution>();\n  return Object.freeze({\n    generation,\n    register(contribution: DoomContextContribution): DoomContextContributionRegistration {\n      assertNonEmpty(contribution.source, 'source');\n      assertNonEmpty(contribution.id, 'id');\n      assertNonEmpty(contribution.label, 'label');\n      if (!Number.isFinite(contribution.order)) {\n        throw new Error('Doom context contribution order must be a finite number.');\n      }\n      if (typeof contribution.snapshot !== 'function') {\n        throw new Error('Doom context contribution snapshot must be a function.');\n      }\n\n      const key = JSON.stringify([contribution.source, contribution.id]);\n      if (contributions.has(key)) {\n        throw new Error(`Doom context contribution is already registered: ${contribution.source}/${contribution.id}.`);\n      }\n      const stored: StoredContribution = Object.freeze({\n        key,\n        source: contribution.source,\n        id: contribution.id,\n        label: contribution.label,\n        order: contribution.order,\n        snapshot: () => contribution.snapshot(),\n      });\n      contributions.set(key, stored);\n\n      let disposed = false;\n      return Object.freeze({\n        dispose(): void {\n          if (disposed) return;\n          disposed = true;\n          if (contributions.get(key) === stored) contributions.delete(key);\n        },\n      });\n    },\n    snapshot(): DoomContextContributionsSnapshot {\n      const entries: DoomContextContributionEntry[] = [];\n      const errors: DoomContextContributionError[] = [];\n      const ordered = [...contributions.values()].sort(compareContributions);\n\n      for (const contribution of ordered) {\n        const identity = {\n          source: contribution.source,\n          id: contribution.id,\n          label: contribution.label,\n          order: contribution.order,\n        };\n        try {\n          const text = contribution.snapshot();\n          if (text === undefined) continue;\n          if (typeof text !== 'string') throw new Error('Snapshot returned a non-string value.');\n          entries.push(Object.freeze({ ...identity, text }));\n        } catch (error) {\n          errors.push(Object.freeze({ ...identity, message: contributionErrorMessage(error) }));\n        }\n      }\n\n      return Object.freeze({ entries: Object.freeze(entries), errors: Object.freeze(errors) });\n    },\n  });\n}\n"],"mappings":";AAaA,SAAS,qBAAqB,MAA+B,OAAwC;CACnG,MAAM,cAAc,KAAK,SAAS,MAAM,SAAS,KAAK,KAAK,SAAS,MAAM,SAAS,IAAI;CACvF,MAAM,UAAU,KAAK,KAAK,MAAM,KAAK,KAAK,KAAK,KAAK,MAAM,KAAK,IAAI;CACnE,OAAO,KAAK,QAAQ,MAAM,SAAS,eAAe;AACpD;AAEA,SAAS,eAAe,OAAe,OAAqB;CAC1D,IAAI,MAAM,KAAK,CAAC,CAAC,WAAW,GAAG,MAAM,IAAI,MAAM,6BAA6B,MAAM,oBAAoB;AACxG;AAEA,SAAS,yBAAyB,OAAwB;CACxD,OAAO,iBAAiB,QAAQ,MAAM,UAAU,OAAO,KAAK;AAC9D;;AAGA,SAAgB,sCAAsC,YAAqD;CACzG,IAAI,CAAC,YAAY,MAAM,IAAI,MAAM,0DAA0D;CAE3F,MAAM,gCAAgB,IAAI,IAAgC;CAC1D,OAAO,OAAO,OAAO;EACnB;EACA,SAAS,cAA4E;GACnF,eAAe,aAAa,QAAQ,QAAQ;GAC5C,eAAe,aAAa,IAAI,IAAI;GACpC,eAAe,aAAa,OAAO,OAAO;GAC1C,IAAI,CAAC,OAAO,SAAS,aAAa,KAAK,GACrC,MAAM,IAAI,MAAM,0DAA0D;GAE5E,IAAI,OAAO,aAAa,aAAa,YACnC,MAAM,IAAI,MAAM,wDAAwD;GAG1E,MAAM,MAAM,KAAK,UAAU,CAAC,aAAa,QAAQ,aAAa,EAAE,CAAC;GACjE,IAAI,cAAc,IAAI,GAAG,GACvB,MAAM,IAAI,MAAM,oDAAoD,aAAa,OAAO,GAAG,aAAa,GAAG,EAAE;GAE/G,MAAM,SAA6B,OAAO,OAAO;IAC/C;IACA,QAAQ,aAAa;IACrB,IAAI,aAAa;IACjB,OAAO,aAAa;IACpB,OAAO,aAAa;IACpB,gBAAgB,aAAa,SAAS;GACxC,CAAC;GACD,cAAc,IAAI,KAAK,MAAM;GAE7B,IAAI,WAAW;GACf,OAAO,OAAO,OAAO,EACnB,UAAgB;IACd,IAAI,UAAU;IACd,WAAW;IACX,IAAI,cAAc,IAAI,GAAG,MAAM,QAAQ,cAAc,OAAO,GAAG;GACjE,EACF,CAAC;EACH;EACA,WAA6C;GAC3C,MAAM,UAA0C,CAAC;GACjD,MAAM,SAAyC,CAAC;GAChD,MAAM,UAAU,CAAC,GAAG,cAAc,OAAO,CAAC,CAAC,CAAC,KAAK,oBAAoB;GAErE,KAAK,MAAM,gBAAgB,SAAS;IAClC,MAAM,WAAW;KACf,QAAQ,aAAa;KACrB,IAAI,aAAa;KACjB,OAAO,aAAa;KACpB,OAAO,aAAa;IACtB;IACA,IAAI;KACF,MAAM,OAAO,aAAa,SAAS;KACnC,IAAI,SAAS,KAAA,GAAW;KACxB,IAAI,OAAO,SAAS,UAAU,MAAM,IAAI,MAAM,uCAAuC;KACrF,QAAQ,KAAK,OAAO,OAAO;MAAE,GAAG;MAAU;KAAK,CAAC,CAAC;IACnD,SAAS,OAAO;KACd,OAAO,KAAK,OAAO,OAAO;MAAE,GAAG;MAAU,SAAS,yBAAyB,KAAK;KAAE,CAAC,CAAC;IACtF;GACF;GAEA,OAAO,OAAO,OAAO;IAAE,SAAS,OAAO,OAAO,OAAO;IAAG,QAAQ,OAAO,OAAO,MAAM;GAAE,CAAC;EACzF;CACF,CAAC;AACH"}
+{"version":3,"file":"index.mjs","names":[],"sources":["../../../../src/services/contextContributions/index.ts"],"sourcesContent":["import type {\n  PoContextContribution,\n  PoContextContributionEntry,\n  PoContextContributionError,\n  PoContextContributionRegistration,\n  PoContextContributionsService,\n  PoContextContributionsSnapshot,\n} from '../../schemas/contextContributions';\n\ninterface StoredContribution extends PoContextContribution {\n  readonly key: string;\n}\n\nfunction compareContributions(left: PoContextContribution, right: PoContextContribution): number {\n  const sourceOrder = left.source < right.source ? -1 : left.source > right.source ? 1 : 0;\n  const idOrder = left.id < right.id ? -1 : left.id > right.id ? 1 : 0;\n  return left.order - right.order || sourceOrder || idOrder;\n}\n\nfunction assertNonEmpty(value: string, field: string): void {\n  if (value.trim().length === 0) throw new Error(`Po context contribution ${field} must not be empty.`);\n}\n\nfunction contributionErrorMessage(error: unknown): string {\n  return error instanceof Error ? error.message : String(error);\n}\n\n/** Creates the host-owned aggregation service for one Po session generation. */\nexport function createPoContextContributionsService(generation: string): PoContextContributionsService {\n  if (!generation) throw new Error('Po context contributions require a session generation.');\n\n  const contributions = new Map<string, StoredContribution>();\n  return Object.freeze({\n    generation,\n    register(contribution: PoContextContribution): PoContextContributionRegistration {\n      assertNonEmpty(contribution.source, 'source');\n      assertNonEmpty(contribution.id, 'id');\n      assertNonEmpty(contribution.label, 'label');\n      if (!Number.isFinite(contribution.order)) {\n        throw new Error('Po context contribution order must be a finite number.');\n      }\n      if (typeof contribution.snapshot !== 'function') {\n        throw new Error('Po context contribution snapshot must be a function.');\n      }\n\n      const key = JSON.stringify([contribution.source, contribution.id]);\n      if (contributions.has(key)) {\n        throw new Error(`Po context contribution is already registered: ${contribution.source}/${contribution.id}.`);\n      }\n      const stored: StoredContribution = Object.freeze({\n        key,\n        source: contribution.source,\n        id: contribution.id,\n        label: contribution.label,\n        order: contribution.order,\n        snapshot: () => contribution.snapshot(),\n      });\n      contributions.set(key, stored);\n\n      let disposed = false;\n      return Object.freeze({\n        dispose(): void {\n          if (disposed) return;\n          disposed = true;\n          if (contributions.get(key) === stored) contributions.delete(key);\n        },\n      });\n    },\n    snapshot(): PoContextContributionsSnapshot {\n      const entries: PoContextContributionEntry[] = [];\n      const errors: PoContextContributionError[] = [];\n      const ordered = [...contributions.values()].sort(compareContributions);\n\n      for (const contribution of ordered) {\n        const identity = {\n          source: contribution.source,\n          id: contribution.id,\n          label: contribution.label,\n          order: contribution.order,\n        };\n        try {\n          const text = contribution.snapshot();\n          if (text === undefined) continue;\n          if (typeof text !== 'string') throw new Error('Snapshot returned a non-string value.');\n          entries.push(Object.freeze({ ...identity, text }));\n        } catch (error) {\n          errors.push(Object.freeze({ ...identity, message: contributionErrorMessage(error) }));\n        }\n      }\n\n      return Object.freeze({ entries: Object.freeze(entries), errors: Object.freeze(errors) });\n    },\n  });\n}\n"],"mappings":";AAaA,SAAS,qBAAqB,MAA6B,OAAsC;CAC/F,MAAM,cAAc,KAAK,SAAS,MAAM,SAAS,KAAK,KAAK,SAAS,MAAM,SAAS,IAAI;CACvF,MAAM,UAAU,KAAK,KAAK,MAAM,KAAK,KAAK,KAAK,KAAK,MAAM,KAAK,IAAI;CACnE,OAAO,KAAK,QAAQ,MAAM,SAAS,eAAe;AACpD;AAEA,SAAS,eAAe,OAAe,OAAqB;CAC1D,IAAI,MAAM,KAAK,CAAC,CAAC,WAAW,GAAG,MAAM,IAAI,MAAM,2BAA2B,MAAM,oBAAoB;AACtG;AAEA,SAAS,yBAAyB,OAAwB;CACxD,OAAO,iBAAiB,QAAQ,MAAM,UAAU,OAAO,KAAK;AAC9D;;AAGA,SAAgB,oCAAoC,YAAmD;CACrG,IAAI,CAAC,YAAY,MAAM,IAAI,MAAM,wDAAwD;CAEzF,MAAM,gCAAgB,IAAI,IAAgC;CAC1D,OAAO,OAAO,OAAO;EACnB;EACA,SAAS,cAAwE;GAC/E,eAAe,aAAa,QAAQ,QAAQ;GAC5C,eAAe,aAAa,IAAI,IAAI;GACpC,eAAe,aAAa,OAAO,OAAO;GAC1C,IAAI,CAAC,OAAO,SAAS,aAAa,KAAK,GACrC,MAAM,IAAI,MAAM,wDAAwD;GAE1E,IAAI,OAAO,aAAa,aAAa,YACnC,MAAM,IAAI,MAAM,sDAAsD;GAGxE,MAAM,MAAM,KAAK,UAAU,CAAC,aAAa,QAAQ,aAAa,EAAE,CAAC;GACjE,IAAI,cAAc,IAAI,GAAG,GACvB,MAAM,IAAI,MAAM,kDAAkD,aAAa,OAAO,GAAG,aAAa,GAAG,EAAE;GAE7G,MAAM,SAA6B,OAAO,OAAO;IAC/C;IACA,QAAQ,aAAa;IACrB,IAAI,aAAa;IACjB,OAAO,aAAa;IACpB,OAAO,aAAa;IACpB,gBAAgB,aAAa,SAAS;GACxC,CAAC;GACD,cAAc,IAAI,KAAK,MAAM;GAE7B,IAAI,WAAW;GACf,OAAO,OAAO,OAAO,EACnB,UAAgB;IACd,IAAI,UAAU;IACd,WAAW;IACX,IAAI,cAAc,IAAI,GAAG,MAAM,QAAQ,cAAc,OAAO,GAAG;GACjE,EACF,CAAC;EACH;EACA,WAA2C;GACzC,MAAM,UAAwC,CAAC;GAC/C,MAAM,SAAuC,CAAC;GAC9C,MAAM,UAAU,CAAC,GAAG,cAAc,OAAO,CAAC,CAAC,CAAC,KAAK,oBAAoB;GAErE,KAAK,MAAM,gBAAgB,SAAS;IAClC,MAAM,WAAW;KACf,QAAQ,aAAa;KACrB,IAAI,aAAa;KACjB,OAAO,aAAa;KACpB,OAAO,aAAa;IACtB;IACA,IAAI;KACF,MAAM,OAAO,aAAa,SAAS;KACnC,IAAI,SAAS,KAAA,GAAW;KACxB,IAAI,OAAO,SAAS,UAAU,MAAM,IAAI,MAAM,uCAAuC;KACrF,QAAQ,KAAK,OAAO,OAAO;MAAE,GAAG;MAAU;KAAK,CAAC,CAAC;IACnD,SAAS,OAAO;KACd,OAAO,KAAK,OAAO,OAAO;MAAE,GAAG;MAAU,SAAS,yBAAyB,KAAK;KAAE,CAAC,CAAC;IACtF;GACF;GAEA,OAAO,OAAO,OAAO;IAAE,SAAS,OAAO,OAAO,OAAO;IAAG,QAAQ,OAAO,OAAO,MAAM;GAAE,CAAC;EACzF;CACF,CAAC;AACH"}

package/dist/src/services/devProxyStore/devProxyRecords.cjs

@@ -0,0 +1,59 @@
+const require_index = require("../devProxyPolicy/index.cjs");
+//#region src/services/devProxyStore/devProxyRecords.ts
+/**
+* Registered proxy targets on disk.
+*
+* Persisted, unlike a remote session, because a target is a name the developer
+* typed into their own build configuration as `base: '/devproxy/<name>/'`.
+* Losing it on restart would silently break that line, and the file holds no
+* secret: a port number and a label the operator chose while sitting at the
+* machine.
+*/
+const TARGETS_FILE = "dev-proxy.json";
+/** Any bit set for group or other; a state file readable by another account is worth repairing. */
+const LOOSE_MODE_MASK = 63;
+/** Whether a file mode lets another account read the file. */
+function isLooseMode(mode) {
+	return (mode & LOOSE_MODE_MASK) !== 0;
+}
+/**
+* Rebuilds one record, dropping anything the current policy would refuse.
+*
+* The file is revalidated on read rather than trusted, because a name that was
+* legal when written is not necessarily legal now, and an edited file must not
+* be able to introduce a target the API would have rejected.
+*/
+function parseTarget(value) {
+	if (typeof value !== "object" || value === null) return void 0;
+	const record = value;
+	const name = require_index.validateTargetName(record.name);
+	if (!name.ok) return void 0;
+	if (typeof record.port !== "number" || !Number.isSafeInteger(record.port)) return void 0;
+	const createdAt = typeof record.createdAt === "number" ? record.createdAt : 0;
+	return {
+		name: name.name,
+		port: record.port,
+		createdAt
+	};
+}
+function parseDevProxyTargets(raw, targetsPath, notice) {
+	let parsed;
+	try {
+		parsed = JSON.parse(raw);
+	} catch {
+		notice(`dev proxy targets at ${targetsPath} are not valid JSON; none will load`);
+		return [];
+	}
+	if (!Array.isArray(parsed)) return [];
+	return parsed.map(parseTarget).filter((target) => target !== void 0);
+}
+function serializeDevProxyTargets(targets) {
+	return `${JSON.stringify(targets, void 0, 2)}\n`;
+}
+//#endregion
+exports.TARGETS_FILE = TARGETS_FILE;
+exports.isLooseMode = isLooseMode;
+exports.parseDevProxyTargets = parseDevProxyTargets;
+exports.serializeDevProxyTargets = serializeDevProxyTargets;
+
+//# sourceMappingURL=devProxyRecords.cjs.map

package/dist/src/services/devProxyStore/devProxyRecords.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"devProxyRecords.cjs","names":["validateTargetName"],"sources":["../../../../src/services/devProxyStore/devProxyRecords.ts"],"sourcesContent":["import type { DevProxyTarget } from '../../types/remote';\nimport { validateTargetName } from '../devProxyPolicy';\n\n/**\n * Registered proxy targets on disk.\n *\n * Persisted, unlike a remote session, because a target is a name the developer\n * typed into their own build configuration as `base: '/devproxy/<name>/'`.\n * Losing it on restart would silently break that line, and the file holds no\n * secret: a port number and a label the operator chose while sitting at the\n * machine.\n */\n\nexport const TARGETS_FILE = 'dev-proxy.json';\nexport const DIRECTORY_MODE = 0o700;\nexport const FILE_MODE = 0o600;\n/** Any bit set for group or other; a state file readable by another account is worth repairing. */\nconst LOOSE_MODE_MASK = 0o077;\n\n/** Whether a file mode lets another account read the file. */\nexport function isLooseMode(mode: number): boolean {\n  return (mode & LOOSE_MODE_MASK) !== 0;\n}\n\nexport interface DevProxyStoreOptions {\n  /** The same directory the remote-access store uses; defaults to ~/.po/web. */\n  stateDir: string;\n  onNotice?: (message: string) => void;\n}\n\nexport interface DevProxyStore {\n  targets(): readonly DevProxyTarget[];\n  find(name: string): DevProxyTarget | undefined;\n  /** Replaces any target already holding this name, so re-registering a moved port is one call. */\n  save(target: DevProxyTarget): void;\n  remove(name: string): boolean;\n}\n\n/**\n * Rebuilds one record, dropping anything the current policy would refuse.\n *\n * The file is revalidated on read rather than trusted, because a name that was\n * legal when written is not necessarily legal now, and an edited file must not\n * be able to introduce a target the API would have rejected.\n */\nfunction parseTarget(value: unknown): DevProxyTarget | undefined {\n  if (typeof value !== 'object' || value === null) return undefined;\n  const record = value as Partial<DevProxyTarget>;\n  const name = validateTargetName(record.name);\n  if (!name.ok) return undefined;\n  if (typeof record.port !== 'number' || !Number.isSafeInteger(record.port)) return undefined;\n  const createdAt = typeof record.createdAt === 'number' ? record.createdAt : 0;\n  return { name: name.name, port: record.port, createdAt };\n}\n\nexport function parseDevProxyTargets(\n  raw: string,\n  targetsPath: string,\n  notice: (message: string) => void,\n): DevProxyTarget[] {\n  let parsed: unknown;\n  try {\n    parsed = JSON.parse(raw);\n  } catch {\n    notice(`dev proxy targets at ${targetsPath} are not valid JSON; none will load`);\n    return [];\n  }\n  if (!Array.isArray(parsed)) return [];\n  return parsed.map(parseTarget).filter((target): target is DevProxyTarget => target !== undefined);\n}\n\nexport function serializeDevProxyTargets(targets: readonly DevProxyTarget[]): string {\n  return `${JSON.stringify(targets, undefined, 2)}\\n`;\n}\n"],"mappings":";;;;;;;;;;;AAaA,MAAa,eAAe;;AAI5B,MAAM,kBAAkB;;AAGxB,SAAgB,YAAY,MAAuB;CACjD,QAAQ,OAAO,qBAAqB;AACtC;;;;;;;;AAuBA,SAAS,YAAY,OAA4C;CAC/D,IAAI,OAAO,UAAU,YAAY,UAAU,MAAM,OAAO,KAAA;CACxD,MAAM,SAAS;CACf,MAAM,OAAOA,cAAAA,mBAAmB,OAAO,IAAI;CAC3C,IAAI,CAAC,KAAK,IAAI,OAAO,KAAA;CACrB,IAAI,OAAO,OAAO,SAAS,YAAY,CAAC,OAAO,cAAc,OAAO,IAAI,GAAG,OAAO,KAAA;CAClF,MAAM,YAAY,OAAO,OAAO,cAAc,WAAW,OAAO,YAAY;CAC5E,OAAO;EAAE,MAAM,KAAK;EAAM,MAAM,OAAO;EAAM;CAAU;AACzD;AAEA,SAAgB,qBACd,KACA,aACA,QACkB;CAClB,IAAI;CACJ,IAAI;EACF,SAAS,KAAK,MAAM,GAAG;CACzB,QAAQ;EACN,OAAO,wBAAwB,YAAY,oCAAoC;EAC/E,OAAO,CAAC;CACV;CACA,IAAI,CAAC,MAAM,QAAQ,MAAM,GAAG,OAAO,CAAC;CACpC,OAAO,OAAO,IAAI,WAAW,CAAC,CAAC,QAAQ,WAAqC,WAAW,KAAA,CAAS;AAClG;AAEA,SAAgB,yBAAyB,SAA4C;CACnF,OAAO,GAAG,KAAK,UAAU,SAAS,KAAA,GAAW,CAAC,EAAE;AAClD"}

package/dist/src/services/devProxyStore/devProxyRecords.mjs

@@ -0,0 +1,56 @@
+import { validateTargetName } from "../devProxyPolicy/index.mjs";
+//#region src/services/devProxyStore/devProxyRecords.ts
+/**
+* Registered proxy targets on disk.
+*
+* Persisted, unlike a remote session, because a target is a name the developer
+* typed into their own build configuration as `base: '/devproxy/<name>/'`.
+* Losing it on restart would silently break that line, and the file holds no
+* secret: a port number and a label the operator chose while sitting at the
+* machine.
+*/
+const TARGETS_FILE = "dev-proxy.json";
+/** Any bit set for group or other; a state file readable by another account is worth repairing. */
+const LOOSE_MODE_MASK = 63;
+/** Whether a file mode lets another account read the file. */
+function isLooseMode(mode) {
+	return (mode & LOOSE_MODE_MASK) !== 0;
+}
+/**
+* Rebuilds one record, dropping anything the current policy would refuse.
+*
+* The file is revalidated on read rather than trusted, because a name that was
+* legal when written is not necessarily legal now, and an edited file must not
+* be able to introduce a target the API would have rejected.
+*/
+function parseTarget(value) {
+	if (typeof value !== "object" || value === null) return void 0;
+	const record = value;
+	const name = validateTargetName(record.name);
+	if (!name.ok) return void 0;
+	if (typeof record.port !== "number" || !Number.isSafeInteger(record.port)) return void 0;
+	const createdAt = typeof record.createdAt === "number" ? record.createdAt : 0;
+	return {
+		name: name.name,
+		port: record.port,
+		createdAt
+	};
+}
+function parseDevProxyTargets(raw, targetsPath, notice) {
+	let parsed;
+	try {
+		parsed = JSON.parse(raw);
+	} catch {
+		notice(`dev proxy targets at ${targetsPath} are not valid JSON; none will load`);
+		return [];
+	}
+	if (!Array.isArray(parsed)) return [];
+	return parsed.map(parseTarget).filter((target) => target !== void 0);
+}
+function serializeDevProxyTargets(targets) {
+	return `${JSON.stringify(targets, void 0, 2)}\n`;
+}
+//#endregion
+export { TARGETS_FILE, isLooseMode, parseDevProxyTargets, serializeDevProxyTargets };
+
+//# sourceMappingURL=devProxyRecords.mjs.map

package/dist/src/services/devProxyStore/devProxyRecords.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"devProxyRecords.mjs","names":[],"sources":["../../../../src/services/devProxyStore/devProxyRecords.ts"],"sourcesContent":["import type { DevProxyTarget } from '../../types/remote';\nimport { validateTargetName } from '../devProxyPolicy';\n\n/**\n * Registered proxy targets on disk.\n *\n * Persisted, unlike a remote session, because a target is a name the developer\n * typed into their own build configuration as `base: '/devproxy/<name>/'`.\n * Losing it on restart would silently break that line, and the file holds no\n * secret: a port number and a label the operator chose while sitting at the\n * machine.\n */\n\nexport const TARGETS_FILE = 'dev-proxy.json';\nexport const DIRECTORY_MODE = 0o700;\nexport const FILE_MODE = 0o600;\n/** Any bit set for group or other; a state file readable by another account is worth repairing. */\nconst LOOSE_MODE_MASK = 0o077;\n\n/** Whether a file mode lets another account read the file. */\nexport function isLooseMode(mode: number): boolean {\n  return (mode & LOOSE_MODE_MASK) !== 0;\n}\n\nexport interface DevProxyStoreOptions {\n  /** The same directory the remote-access store uses; defaults to ~/.po/web. */\n  stateDir: string;\n  onNotice?: (message: string) => void;\n}\n\nexport interface DevProxyStore {\n  targets(): readonly DevProxyTarget[];\n  find(name: string): DevProxyTarget | undefined;\n  /** Replaces any target already holding this name, so re-registering a moved port is one call. */\n  save(target: DevProxyTarget): void;\n  remove(name: string): boolean;\n}\n\n/**\n * Rebuilds one record, dropping anything the current policy would refuse.\n *\n * The file is revalidated on read rather than trusted, because a name that was\n * legal when written is not necessarily legal now, and an edited file must not\n * be able to introduce a target the API would have rejected.\n */\nfunction parseTarget(value: unknown): DevProxyTarget | undefined {\n  if (typeof value !== 'object' || value === null) return undefined;\n  const record = value as Partial<DevProxyTarget>;\n  const name = validateTargetName(record.name);\n  if (!name.ok) return undefined;\n  if (typeof record.port !== 'number' || !Number.isSafeInteger(record.port)) return undefined;\n  const createdAt = typeof record.createdAt === 'number' ? record.createdAt : 0;\n  return { name: name.name, port: record.port, createdAt };\n}\n\nexport function parseDevProxyTargets(\n  raw: string,\n  targetsPath: string,\n  notice: (message: string) => void,\n): DevProxyTarget[] {\n  let parsed: unknown;\n  try {\n    parsed = JSON.parse(raw);\n  } catch {\n    notice(`dev proxy targets at ${targetsPath} are not valid JSON; none will load`);\n    return [];\n  }\n  if (!Array.isArray(parsed)) return [];\n  return parsed.map(parseTarget).filter((target): target is DevProxyTarget => target !== undefined);\n}\n\nexport function serializeDevProxyTargets(targets: readonly DevProxyTarget[]): string {\n  return `${JSON.stringify(targets, undefined, 2)}\\n`;\n}\n"],"mappings":";;;;;;;;;;;AAaA,MAAa,eAAe;;AAI5B,MAAM,kBAAkB;;AAGxB,SAAgB,YAAY,MAAuB;CACjD,QAAQ,OAAO,qBAAqB;AACtC;;;;;;;;AAuBA,SAAS,YAAY,OAA4C;CAC/D,IAAI,OAAO,UAAU,YAAY,UAAU,MAAM,OAAO,KAAA;CACxD,MAAM,SAAS;CACf,MAAM,OAAO,mBAAmB,OAAO,IAAI;CAC3C,IAAI,CAAC,KAAK,IAAI,OAAO,KAAA;CACrB,IAAI,OAAO,OAAO,SAAS,YAAY,CAAC,OAAO,cAAc,OAAO,IAAI,GAAG,OAAO,KAAA;CAClF,MAAM,YAAY,OAAO,OAAO,cAAc,WAAW,OAAO,YAAY;CAC5E,OAAO;EAAE,MAAM,KAAK;EAAM,MAAM,OAAO;EAAM;CAAU;AACzD;AAEA,SAAgB,qBACd,KACA,aACA,QACkB;CAClB,IAAI;CACJ,IAAI;EACF,SAAS,KAAK,MAAM,GAAG;CACzB,QAAQ;EACN,OAAO,wBAAwB,YAAY,oCAAoC;EAC/E,OAAO,CAAC;CACV;CACA,IAAI,CAAC,MAAM,QAAQ,MAAM,GAAG,OAAO,CAAC;CACpC,OAAO,OAAO,IAAI,WAAW,CAAC,CAAC,QAAQ,WAAqC,WAAW,KAAA,CAAS;AAClG;AAEA,SAAgB,yBAAyB,SAA4C;CACnF,OAAO,GAAG,KAAK,UAAU,SAAS,KAAA,GAAW,CAAC,EAAE;AAClD"}

package/dist/src/services/devProxyStore/index.cjs

@@ -1,107 +1,13 @@
 const require_runtime = require("../../../_virtual/_rolldown/runtime.cjs");
-const require_index = require("../devProxyPolicy/index.cjs");
-let node_fs = require("node:fs");
-node_fs = require_runtime.__toESM(node_fs, 1);
+require("../platformFiles/index.cjs");
+const require_index$1 = require("../serialRunner/index.cjs");
+require("./devProxyRecords.cjs");
+const require_sync = require("./sync.cjs");
 let node_path = require("node:path");
 node_path = require_runtime.__toESM(node_path, 1);
-//#region src/services/devProxyStore/index.ts
-/**
-* Registered proxy targets on disk.
-*
-* Persisted, unlike a remote session, because a target is a name the developer
-* typed into their own build configuration as `base: '/devproxy/<name>/'`.
-* Losing it on restart would silently break that line, and the file holds no
-* secret: a port number and a label the operator chose while sitting at the
-* machine.
-*/
-const TARGETS_FILE = "dev-proxy.json";
-const DIRECTORY_MODE = 448;
-const FILE_MODE = 384;
-/** Any bit set for group or other; a state file readable by another account is worth repairing. */
-const LOOSE_MODE_MASK = 63;
-/** Repairs a state file another account can read. */
-function tightenMode(filePath, notice) {
-	try {
-		if ((node_fs.default.statSync(filePath).mode & LOOSE_MODE_MASK) === 0) return;
-		node_fs.default.chmodSync(filePath, FILE_MODE);
-		notice(`tightened permissions on ${filePath}`);
-	} catch {}
-}
-/**
-* Rebuilds one record, dropping anything the current policy would refuse.
-*
-* The file is revalidated on read rather than trusted, because a name that was
-* legal when written is not necessarily legal now, and an edited file must not
-* be able to introduce a target the API would have rejected.
-*/
-function parseTarget(value) {
-	if (typeof value !== "object" || value === null) return void 0;
-	const record = value;
-	const name = require_index.validateTargetName(record.name);
-	if (!name.ok) return void 0;
-	if (typeof record.port !== "number" || !Number.isSafeInteger(record.port)) return void 0;
-	const createdAt = typeof record.createdAt === "number" ? record.createdAt : 0;
-	return {
-		name: name.name,
-		port: record.port,
-		createdAt
-	};
-}
-function createDevProxyStore(options) {
-	const notice = options.onNotice ?? (() => {});
-	const targetsPath = node_path.default.join(options.stateDir, TARGETS_FILE);
-	let held = load();
-	function load() {
-		let raw;
-		try {
-			raw = node_fs.default.readFileSync(targetsPath, "utf8");
-		} catch {
-			return [];
-		}
-		tightenMode(targetsPath, notice);
-		let parsed;
-		try {
-			parsed = JSON.parse(raw);
-		} catch {
-			notice(`dev proxy targets at ${targetsPath} are not valid JSON; none will load`);
-			return [];
-		}
-		if (!Array.isArray(parsed)) return [];
-		return parsed.map(parseTarget).filter((target) => target !== void 0);
-	}
-	function write() {
-		const temporary = `${targetsPath}.${String(process.pid)}.tmp`;
-		try {
-			node_fs.default.mkdirSync(options.stateDir, {
-				recursive: true,
-				mode: DIRECTORY_MODE
-			});
-			node_fs.default.writeFileSync(temporary, `${JSON.stringify(held, void 0, 2)}\n`, { mode: FILE_MODE });
-			node_fs.default.renameSync(temporary, targetsPath);
-		} catch (error) {
-			notice(`${targetsPath} could not be saved: ${error instanceof Error ? error.message : String(error)}`);
-			try {
-				node_fs.default.rmSync(temporary, { force: true });
-			} catch {}
-		}
-	}
-	return {
-		targets: () => held,
-		find: (name) => held.find((target) => target.name === name),
-		save(target) {
-			held = [...held.filter((existing) => existing.name !== target.name), target];
-			write();
-		},
-		remove(name) {
-			const next = held.filter((existing) => existing.name !== name);
-			if (next.length === held.length) return false;
-			held = next;
-			write();
-			return true;
-		}
-	};
-}
+require("@earendil-works/pi-durable/env");
+require_index$1.createSerialRunner();
 //#endregion
-exports.createDevProxyStore = createDevProxyStore;
+exports.createDevProxyStore = require_sync.createDevProxyStore;
 
 //# sourceMappingURL=index.cjs.map

package/dist/src/services/devProxyStore/index.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.cjs","names":["fs","validateTargetName","path"],"sources":["../../../../src/services/devProxyStore/index.ts"],"sourcesContent":["import fs from 'node:fs';\nimport path from 'node:path';\n\nimport type { DevProxyTarget } from '../../types/remote';\nimport { validateTargetName } from '../devProxyPolicy';\n\n/**\n * Registered proxy targets on disk.\n *\n * Persisted, unlike a remote session, because a target is a name the developer\n * typed into their own build configuration as `base: '/devproxy/<name>/'`.\n * Losing it on restart would silently break that line, and the file holds no\n * secret: a port number and a label the operator chose while sitting at the\n * machine.\n */\n\nconst TARGETS_FILE = 'dev-proxy.json';\nconst DIRECTORY_MODE = 0o700;\nconst FILE_MODE = 0o600;\n/** Any bit set for group or other; a state file readable by another account is worth repairing. */\nconst LOOSE_MODE_MASK = 0o077;\n\nexport interface DevProxyStoreOptions {\n  /** The same directory the remote-access store uses; defaults to ~/.po/web. */\n  stateDir: string;\n  onNotice?: (message: string) => void;\n}\n\nexport interface DevProxyStore {\n  targets(): readonly DevProxyTarget[];\n  find(name: string): DevProxyTarget | undefined;\n  /** Replaces any target already holding this name, so re-registering a moved port is one call. */\n  save(target: DevProxyTarget): void;\n  remove(name: string): boolean;\n}\n\n/** Repairs a state file another account can read. */\nfunction tightenMode(filePath: string, notice: (message: string) => void): void {\n  try {\n    if ((fs.statSync(filePath).mode & LOOSE_MODE_MASK) === 0) return;\n    fs.chmodSync(filePath, FILE_MODE);\n    notice(`tightened permissions on ${filePath}`);\n  } catch {\n    // The file is missing or unreadable; the caller's own read reports that.\n  }\n}\n\n/**\n * Rebuilds one record, dropping anything the current policy would refuse.\n *\n * The file is revalidated on read rather than trusted, because a name that was\n * legal when written is not necessarily legal now, and an edited file must not\n * be able to introduce a target the API would have rejected.\n */\nfunction parseTarget(value: unknown): DevProxyTarget | undefined {\n  if (typeof value !== 'object' || value === null) return undefined;\n  const record = value as Partial<DevProxyTarget>;\n  const name = validateTargetName(record.name);\n  if (!name.ok) return undefined;\n  if (typeof record.port !== 'number' || !Number.isSafeInteger(record.port)) return undefined;\n  const createdAt = typeof record.createdAt === 'number' ? record.createdAt : 0;\n  return { name: name.name, port: record.port, createdAt };\n}\n\nexport function createDevProxyStore(options: DevProxyStoreOptions): DevProxyStore {\n  const notice = options.onNotice ?? ((): void => {});\n  const targetsPath = path.join(options.stateDir, TARGETS_FILE);\n  let held = load();\n\n  function load(): DevProxyTarget[] {\n    let raw: string;\n    try {\n      raw = fs.readFileSync(targetsPath, 'utf8');\n    } catch {\n      // No file is the normal first run, so this is not worth a notice.\n      return [];\n    }\n    tightenMode(targetsPath, notice);\n    let parsed: unknown;\n    try {\n      parsed = JSON.parse(raw);\n    } catch {\n      notice(`dev proxy targets at ${targetsPath} are not valid JSON; none will load`);\n      return [];\n    }\n    if (!Array.isArray(parsed)) return [];\n    return parsed.map(parseTarget).filter((target): target is DevProxyTarget => target !== undefined);\n  }\n\n  function write(): void {\n    const temporary = `${targetsPath}.${String(process.pid)}.tmp`;\n    try {\n      fs.mkdirSync(options.stateDir, { recursive: true, mode: DIRECTORY_MODE });\n      fs.writeFileSync(temporary, `${JSON.stringify(held, undefined, 2)}\\n`, { mode: FILE_MODE });\n      // Rename rather than write in place, so a crash mid-write leaves the\n      // previous contents rather than a truncated file.\n      fs.renameSync(temporary, targetsPath);\n    } catch (error) {\n      notice(`${targetsPath} could not be saved: ${error instanceof Error ? error.message : String(error)}`);\n      try {\n        fs.rmSync(temporary, { force: true });\n      } catch {\n        // Nothing further to do; the temp file is inert either way.\n      }\n    }\n  }\n\n  return {\n    targets: () => held,\n    find: (name) => held.find((target) => target.name === name),\n\n    save(target) {\n      held = [...held.filter((existing) => existing.name !== target.name), target];\n      write();\n    },\n\n    remove(name) {\n      const next = held.filter((existing) => existing.name !== name);\n      if (next.length === held.length) return false;\n      held = next;\n      write();\n      return true;\n    },\n  };\n}\n"],"mappings":";;;;;;;;;;;;;;;;AAgBA,MAAM,eAAe;AACrB,MAAM,iBAAiB;AACvB,MAAM,YAAY;;AAElB,MAAM,kBAAkB;;AAiBxB,SAAS,YAAY,UAAkB,QAAyC;CAC9E,IAAI;EACF,KAAKA,QAAAA,QAAG,SAAS,QAAQ,CAAC,CAAC,OAAO,qBAAqB,GAAG;EAC1D,QAAA,QAAG,UAAU,UAAU,SAAS;EAChC,OAAO,4BAA4B,UAAU;CAC/C,QAAQ,CAER;AACF;;;;;;;;AASA,SAAS,YAAY,OAA4C;CAC/D,IAAI,OAAO,UAAU,YAAY,UAAU,MAAM,OAAO,KAAA;CACxD,MAAM,SAAS;CACf,MAAM,OAAOC,cAAAA,mBAAmB,OAAO,IAAI;CAC3C,IAAI,CAAC,KAAK,IAAI,OAAO,KAAA;CACrB,IAAI,OAAO,OAAO,SAAS,YAAY,CAAC,OAAO,cAAc,OAAO,IAAI,GAAG,OAAO,KAAA;CAClF,MAAM,YAAY,OAAO,OAAO,cAAc,WAAW,OAAO,YAAY;CAC5E,OAAO;EAAE,MAAM,KAAK;EAAM,MAAM,OAAO;EAAM;CAAU;AACzD;AAEA,SAAgB,oBAAoB,SAA8C;CAChF,MAAM,SAAS,QAAQ,mBAAyB,CAAC;CACjD,MAAM,cAAcC,UAAAA,QAAK,KAAK,QAAQ,UAAU,YAAY;CAC5D,IAAI,OAAO,KAAK;CAEhB,SAAS,OAAyB;EAChC,IAAI;EACJ,IAAI;GACF,MAAMF,QAAAA,QAAG,aAAa,aAAa,MAAM;EAC3C,QAAQ;GAEN,OAAO,CAAC;EACV;EACA,YAAY,aAAa,MAAM;EAC/B,IAAI;EACJ,IAAI;GACF,SAAS,KAAK,MAAM,GAAG;EACzB,QAAQ;GACN,OAAO,wBAAwB,YAAY,oCAAoC;GAC/E,OAAO,CAAC;EACV;EACA,IAAI,CAAC,MAAM,QAAQ,MAAM,GAAG,OAAO,CAAC;EACpC,OAAO,OAAO,IAAI,WAAW,CAAC,CAAC,QAAQ,WAAqC,WAAW,KAAA,CAAS;CAClG;CAEA,SAAS,QAAc;EACrB,MAAM,YAAY,GAAG,YAAY,GAAG,OAAO,QAAQ,GAAG,EAAE;EACxD,IAAI;GACF,QAAA,QAAG,UAAU,QAAQ,UAAU;IAAE,WAAW;IAAM,MAAM;GAAe,CAAC;GACxE,QAAA,QAAG,cAAc,WAAW,GAAG,KAAK,UAAU,MAAM,KAAA,GAAW,CAAC,EAAE,KAAK,EAAE,MAAM,UAAU,CAAC;GAG1F,QAAA,QAAG,WAAW,WAAW,WAAW;EACtC,SAAS,OAAO;GACd,OAAO,GAAG,YAAY,uBAAuB,iBAAiB,QAAQ,MAAM,UAAU,OAAO,KAAK,GAAG;GACrG,IAAI;IACF,QAAA,QAAG,OAAO,WAAW,EAAE,OAAO,KAAK,CAAC;GACtC,QAAQ,CAER;EACF;CACF;CAEA,OAAO;EACL,eAAe;EACf,OAAO,SAAS,KAAK,MAAM,WAAW,OAAO,SAAS,IAAI;EAE1D,KAAK,QAAQ;GACX,OAAO,CAAC,GAAG,KAAK,QAAQ,aAAa,SAAS,SAAS,OAAO,IAAI,GAAG,MAAM;GAC3E,MAAM;EACR;EAEA,OAAO,MAAM;GACX,MAAM,OAAO,KAAK,QAAQ,aAAa,SAAS,SAAS,IAAI;GAC7D,IAAI,KAAK,WAAW,KAAK,QAAQ,OAAO;GACxC,OAAO;GACP,MAAM;GACN,OAAO;EACT;CACF;AACF"}
+{"version":3,"file":"index.cjs","names":["createSerialRunner"],"sources":["../../../../src/services/devProxyStore/index.ts"],"sourcesContent":["import path from 'node:path';\n\nimport type { Context } from '@earendil-works/chord';\nimport { getOrThrow, type FileSystem } from '@earendil-works/pi-durable/env';\n\nimport type { DevProxyTarget } from '../../types/remote';\nimport { nodeHost } from '../nodeHost';\nimport { writeFileAtomic } from '../platformFiles';\nimport { createSerialRunner } from '../serialRunner';\nimport {\n  DIRECTORY_MODE,\n  FILE_MODE,\n  isLooseMode,\n  parseDevProxyTargets,\n  serializeDevProxyTargets,\n  TARGETS_FILE,\n  type DevProxyStoreOptions,\n} from './devProxyRecords';\n\nexport type { DevProxyStore, DevProxyStoreOptions } from './devProxyRecords';\nexport { createDevProxyStore } from './sync';\n\n/** One queue per targets file, so concurrent writes in this process never interleave. */\nconst targetWrites = createSerialRunner();\n\n/** The async twin of `DevProxyStore`: reads stay in memory, every write resolves once it is on disk. */\nexport interface DevProxyStoreAsync {\n  targets(): readonly DevProxyTarget[];\n  find(name: string): DevProxyTarget | undefined;\n  /** Replaces any target already holding this name, so re-registering a moved port is one call. */\n  save(target: DevProxyTarget): Promise<void>;\n  remove(name: string): Promise<boolean>;\n}\n\n/** Registered proxy targets on disk; a failed write is reported and never thrown, as in the sync store. */\nexport async function createDevProxyStoreAsync(\n  fs: FileSystem,\n  options: DevProxyStoreOptions,\n  context: Context,\n): Promise<DevProxyStoreAsync> {\n  const notice = options.onNotice ?? ((): void => {});\n  const targetsPath = path.join(options.stateDir, TARGETS_FILE);\n  const serial = targetWrites.forKey(targetsPath);\n\n  const load = async (): Promise<DevProxyTarget[]> => {\n    const raw = await fs.readTextFile(targetsPath, context);\n    // No file is the normal first run, so this is not worth a notice.\n    if (!raw.ok) return [];\n    // Repairs a state file another account can read.\n    try {\n      const mode = await nodeHost.fileMode(targetsPath);\n      if (mode !== undefined && isLooseMode(mode)) {\n        await nodeHost.setMode(targetsPath, FILE_MODE);\n        notice(`tightened permissions on ${targetsPath}`);\n      }\n    } catch {\n      // The file vanished or is unreadable between the read and the check; the read above already won.\n    }\n    return parseDevProxyTargets(raw.value, targetsPath, notice);\n  };\n\n  let held = await load();\n\n  const write = async (): Promise<void> => {\n    try {\n      if (!getOrThrow(await fs.exists(options.stateDir, context))) {\n        getOrThrow(await fs.createDir(options.stateDir, { recursive: true }, context));\n        await nodeHost.setMode(options.stateDir, DIRECTORY_MODE);\n      }\n      await writeFileAtomic(fs, targetsPath, serializeDevProxyTargets(held), context);\n      await nodeHost.setMode(targetsPath, FILE_MODE);\n    } catch (error) {\n      notice(`${targetsPath} could not be saved: ${error instanceof Error ? error.message : String(error)}`);\n    }\n  };\n\n  return {\n    targets: () => held,\n    find: (name) => held.find((target) => target.name === name),\n    save: (target) =>\n      serial(async () => {\n        held = [...held.filter((existing) => existing.name !== target.name), target];\n        await write();\n      }),\n    remove: (name) =>\n      serial(async () => {\n        const next = held.filter((existing) => existing.name !== name);\n        if (next.length === held.length) return false;\n        held = next;\n        await write();\n        return true;\n      }),\n  };\n}\n"],"mappings":";;;;;;;;AAuBqBA,gBAAAA,mBAAmB"}

package/dist/src/services/devProxyStore/index.mjs

@@ -1,104 +1,10 @@
-import { validateTargetName } from "../devProxyPolicy/index.mjs";
-import fs from "node:fs";
-import path from "node:path";
-//#region src/services/devProxyStore/index.ts
-/**
-* Registered proxy targets on disk.
-*
-* Persisted, unlike a remote session, because a target is a name the developer
-* typed into their own build configuration as `base: '/devproxy/<name>/'`.
-* Losing it on restart would silently break that line, and the file holds no
-* secret: a port number and a label the operator chose while sitting at the
-* machine.
-*/
-const TARGETS_FILE = "dev-proxy.json";
-const DIRECTORY_MODE = 448;
-const FILE_MODE = 384;
-/** Any bit set for group or other; a state file readable by another account is worth repairing. */
-const LOOSE_MODE_MASK = 63;
-/** Repairs a state file another account can read. */
-function tightenMode(filePath, notice) {
-	try {
-		if ((fs.statSync(filePath).mode & LOOSE_MODE_MASK) === 0) return;
-		fs.chmodSync(filePath, FILE_MODE);
-		notice(`tightened permissions on ${filePath}`);
-	} catch {}
-}
-/**
-* Rebuilds one record, dropping anything the current policy would refuse.
-*
-* The file is revalidated on read rather than trusted, because a name that was
-* legal when written is not necessarily legal now, and an edited file must not
-* be able to introduce a target the API would have rejected.
-*/
-function parseTarget(value) {
-	if (typeof value !== "object" || value === null) return void 0;
-	const record = value;
-	const name = validateTargetName(record.name);
-	if (!name.ok) return void 0;
-	if (typeof record.port !== "number" || !Number.isSafeInteger(record.port)) return void 0;
-	const createdAt = typeof record.createdAt === "number" ? record.createdAt : 0;
-	return {
-		name: name.name,
-		port: record.port,
-		createdAt
-	};
-}
-function createDevProxyStore(options) {
-	const notice = options.onNotice ?? (() => {});
-	const targetsPath = path.join(options.stateDir, TARGETS_FILE);
-	let held = load();
-	function load() {
-		let raw;
-		try {
-			raw = fs.readFileSync(targetsPath, "utf8");
-		} catch {
-			return [];
-		}
-		tightenMode(targetsPath, notice);
-		let parsed;
-		try {
-			parsed = JSON.parse(raw);
-		} catch {
-			notice(`dev proxy targets at ${targetsPath} are not valid JSON; none will load`);
-			return [];
-		}
-		if (!Array.isArray(parsed)) return [];
-		return parsed.map(parseTarget).filter((target) => target !== void 0);
-	}
-	function write() {
-		const temporary = `${targetsPath}.${String(process.pid)}.tmp`;
-		try {
-			fs.mkdirSync(options.stateDir, {
-				recursive: true,
-				mode: DIRECTORY_MODE
-			});
-			fs.writeFileSync(temporary, `${JSON.stringify(held, void 0, 2)}\n`, { mode: FILE_MODE });
-			fs.renameSync(temporary, targetsPath);
-		} catch (error) {
-			notice(`${targetsPath} could not be saved: ${error instanceof Error ? error.message : String(error)}`);
-			try {
-				fs.rmSync(temporary, { force: true });
-			} catch {}
-		}
-	}
-	return {
-		targets: () => held,
-		find: (name) => held.find((target) => target.name === name),
-		save(target) {
-			held = [...held.filter((existing) => existing.name !== target.name), target];
-			write();
-		},
-		remove(name) {
-			const next = held.filter((existing) => existing.name !== name);
-			if (next.length === held.length) return false;
-			held = next;
-			write();
-			return true;
-		}
-	};
-}
+import "../platformFiles/index.mjs";
+import { createSerialRunner } from "../serialRunner/index.mjs";
+import "./devProxyRecords.mjs";
 //#endregion
-export { createDevProxyStore };
+export { createDevProxyStore } from "./sync.mjs";
+import "node:path";
+import "@earendil-works/pi-durable/env";
+createSerialRunner();
 
 //# sourceMappingURL=index.mjs.map