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

package/dist/src/schemas/pluginProtocol.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"pluginProtocol.mjs","names":[],"sources":["../../../src/schemas/pluginProtocol.ts"],"sourcesContent":["import { defineService, type Context, type JsonValue } from '@earendil-works/chord';\nimport { type Static, type TSchema, Type } from 'typebox';\nimport { Check } from 'typebox/value';\n\nimport type { DoomApiMount, DoomApiScope } from './packageApi';\n\n/** The address is always exact. A workspace call never resolves to a global service. */\nexport const DoomPluginMountSchema = Type.Union([\n  Type.Object({ scope: Type.Literal('global') }, { additionalProperties: false }),\n  Type.Object(\n    { scope: Type.Literal('workspace'), workspaceId: Type.String({ minLength: 1 }) },\n    { additionalProperties: false },\n  ),\n  Type.Object(\n    { scope: Type.Literal('session'), sessionId: Type.String({ minLength: 1 }) },\n    { additionalProperties: false },\n  ),\n]);\n\nexport const DoomPluginCallSchema = Type.Object(\n  {\n    mount: DoomPluginMountSchema,\n    service: Type.String({ minLength: 1 }),\n    method: Type.String({ minLength: 1 }),\n    input: Type.Unknown(),\n  },\n  { additionalProperties: false },\n);\n\nexport type DoomPluginCall = Static<typeof DoomPluginCallSchema>;\nexport type DoomPluginDirection = 'client-to-server' | 'server-to-client';\nexport interface DoomPluginCaller {\n  /** Authenticated connection that owns client capabilities and leases. */\n  connectionId?: string;\n  /** Aborted when the authenticated browser connection closes. Never supplied over the wire. */\n  signal?: AbortSignal;\n}\n\n/** Chord method shared by all authenticated Po clients. */\nexport interface DoomPluginService {\n  invoke(\n    call: {\n      mount: DoomApiMount;\n      service: string;\n      method: string;\n      input: JsonValue;\n    },\n    context: Context,\n  ): Promise<JsonValue>;\n}\n\nexport const DoomPluginService = defineService<DoomPluginService>('po.plugin.v1');\n\nexport interface DoomPluginMethod<TInput extends TSchema, TOutput extends TSchema> {\n  readonly service: string;\n  readonly method: string;\n  readonly scope: DoomApiScope;\n  readonly direction: DoomPluginDirection;\n  readonly input: TInput;\n  readonly output: TOutput;\n}\n\nexport function defineDoomPluginMethod<TInput extends TSchema, TOutput extends TSchema>(\n  definition: DoomPluginMethod<TInput, TOutput>,\n): DoomPluginMethod<TInput, TOutput> {\n  if (!definition.service || !definition.method) throw new Error('Plugin service and method must be named.');\n  return definition;\n}\n\nexport function doomPluginMountKey(mount: DoomApiMount): string {\n  if (!Check(DoomPluginMountSchema, mount)) throw new Error('Invalid plugin mount.');\n  switch (mount.scope) {\n    case 'global':\n      return 'global';\n    case 'workspace':\n      return `workspace:${mount.workspaceId}`;\n    case 'session':\n      return `session:${mount.sessionId}`;\n  }\n}\n\nexport class DoomPluginCallError extends Error {\n  constructor(\n    readonly code: 'INVALID_CALL' | 'METHOD_NOT_FOUND' | 'INVALID_INPUT' | 'INVALID_OUTPUT',\n    message: string,\n  ) {\n    super(message);\n    this.name = 'DoomPluginCallError';\n  }\n}\n\nexport interface DoomPluginRegistry {\n  register<TInput extends TSchema, TOutput extends TSchema>(\n    mount: DoomApiMount,\n    definition: DoomPluginMethod<TInput, TOutput>,\n    handler: (input: Static<TInput>, caller: DoomPluginCaller) => Static<TOutput> | Promise<Static<TOutput>>,\n  ): () => void;\n  invoke(call: unknown, direction: DoomPluginDirection, caller?: DoomPluginCaller): Promise<unknown>;\n  dispose(): void;\n}\n\n/** Transport-neutral dispatch, shared by Chord server services and client capability hosts. */\nexport function createDoomPluginRegistry(): DoomPluginRegistry {\n  const handlers = new Map<\n    string,\n    {\n      definition: DoomPluginMethod<TSchema, TSchema>;\n      handler: (input: never, caller: DoomPluginCaller) => unknown;\n    }\n  >();\n  let disposed = false;\n  const keyOf = (mount: DoomApiMount, service: string, method: string, direction: DoomPluginDirection): string =>\n    `${doomPluginMountKey(mount)}\\0${direction}\\0${service}\\0${method}`;\n  return {\n    register(mount, definition, handler) {\n      if (disposed) throw new Error('Plugin registry is disposed.');\n      if (mount.scope !== definition.scope)\n        throw new Error(`Method '${definition.service}.${definition.method}' requires ${definition.scope} scope.`);\n      const key = keyOf(mount, definition.service, definition.method, definition.direction);\n      if (handlers.has(key))\n        throw new Error(`Plugin method '${definition.service}.${definition.method}' is already mounted.`);\n      const entry = { definition, handler } as typeof handlers extends Map<string, infer TValue> ? TValue : never;\n      handlers.set(key, entry);\n      return () => {\n        if (handlers.get(key) === entry) handlers.delete(key);\n      };\n    },\n    async invoke(value, direction, caller = {}) {\n      if (disposed) throw new Error('Plugin registry is disposed.');\n      if (!Check(DoomPluginCallSchema, value)) throw new DoomPluginCallError('INVALID_CALL', 'Invalid plugin call.');\n      const call = value as DoomPluginCall;\n      const entry = handlers.get(keyOf(call.mount, call.service, call.method, direction));\n      if (!entry)\n        throw new DoomPluginCallError(\n          'METHOD_NOT_FOUND',\n          `Plugin method '${call.service}.${call.method}' is not mounted at this scope.`,\n        );\n      if (!Check(entry.definition.input, call.input))\n        throw new DoomPluginCallError('INVALID_INPUT', `Invalid input for '${call.service}.${call.method}'.`);\n      const output = await entry.handler(call.input as never, caller);\n      if (!Check(entry.definition.output, output))\n        throw new DoomPluginCallError('INVALID_OUTPUT', `Invalid output from '${call.service}.${call.method}'.`);\n      return output;\n    },\n    dispose() {\n      disposed = true;\n      handlers.clear();\n    },\n  };\n}\n\nexport async function invokeDoomPluginMethod<TInput extends TSchema, TOutput extends TSchema>(\n  transport: (call: DoomPluginCall) => Promise<unknown>,\n  mount: DoomApiMount,\n  definition: DoomPluginMethod<TInput, TOutput>,\n  input: Static<TInput>,\n): Promise<Static<TOutput>> {\n  if (mount.scope !== definition.scope)\n    throw new Error(`Method '${definition.service}.${definition.method}' requires ${definition.scope} scope.`);\n  if (!Check(definition.input, input))\n    throw new DoomPluginCallError('INVALID_INPUT', `Invalid input for '${definition.service}.${definition.method}'.`);\n  const output = await transport({ mount, service: definition.service, method: definition.method, input });\n  if (!Check(definition.output, output))\n    throw new DoomPluginCallError(\n      'INVALID_OUTPUT',\n      `Invalid output from '${definition.service}.${definition.method}'.`,\n    );\n  return output;\n}\n"],"mappings":"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"}
+{"version":3,"file":"pluginProtocol.mjs","names":[],"sources":["../../../src/schemas/pluginProtocol.ts"],"sourcesContent":["import type { JsonValue } from '@earendil-works/chord';\nimport type { Context } from '@earendil-works/chord/context';\nimport { type Static, type TSchema, Type } from 'typebox';\nimport { Check } from 'typebox/value';\n\nimport type { PoApiMount, PoApiScope } from './packageApi';\n\n/** The address is always exact. A workspace call never resolves to a global service. */\nexport const PoPluginMountSchema = Type.Union([\n  Type.Object({ scope: Type.Literal('global') }, { additionalProperties: false }),\n  Type.Object(\n    { scope: Type.Literal('workspace'), workspaceId: Type.String({ minLength: 1 }) },\n    { additionalProperties: false },\n  ),\n  Type.Object(\n    { scope: Type.Literal('session'), sessionId: Type.String({ minLength: 1 }) },\n    { additionalProperties: false },\n  ),\n]);\n\nexport const PoPluginCallSchema = Type.Object(\n  {\n    mount: PoPluginMountSchema,\n    service: Type.String({ minLength: 1 }),\n    method: Type.String({ minLength: 1 }),\n    input: Type.Unknown(),\n  },\n  { additionalProperties: false },\n);\n\nexport type PoPluginCall = Static<typeof PoPluginCallSchema>;\nexport type PoPluginDirection = 'client-to-server' | 'server-to-client';\nexport interface PoPluginCaller {\n  /** Authenticated connection that owns client capabilities and leases. */\n  connectionId?: string;\n  /** Aborted when the authenticated browser connection closes. Never supplied over the wire. */\n  signal?: AbortSignal;\n}\n\n/** Chord method shared by all authenticated Po clients. */\nexport interface PoPluginService {\n  invoke(\n    call: {\n      mount: PoApiMount;\n      service: string;\n      method: string;\n      input: JsonValue;\n    },\n    context: Context,\n  ): Promise<JsonValue>;\n}\n\nexport interface PoPluginMethod<TInput extends TSchema, TOutput extends TSchema> {\n  readonly service: string;\n  readonly method: string;\n  readonly scope: PoApiScope;\n  readonly direction: PoPluginDirection;\n  readonly input: TInput;\n  readonly output: TOutput;\n}\n\nexport function definePoPluginMethod<TInput extends TSchema, TOutput extends TSchema>(\n  definition: PoPluginMethod<TInput, TOutput>,\n): PoPluginMethod<TInput, TOutput> {\n  if (!definition.service || !definition.method) throw new Error('Plugin service and method must be named.');\n  return definition;\n}\n\nexport function poPluginMountKey(mount: PoApiMount): string {\n  if (!Check(PoPluginMountSchema, mount)) throw new Error('Invalid plugin mount.');\n  switch (mount.scope) {\n    case 'global':\n      return 'global';\n    case 'workspace':\n      return `workspace:${mount.workspaceId}`;\n    case 'session':\n      return `session:${mount.sessionId}`;\n  }\n}\n\nexport class PoPluginCallError extends Error {\n  constructor(\n    readonly code: 'INVALID_CALL' | 'METHOD_NOT_FOUND' | 'INVALID_INPUT' | 'INVALID_OUTPUT',\n    message: string,\n  ) {\n    super(message);\n    this.name = 'PoPluginCallError';\n  }\n}\n\nexport interface PoPluginRegistry {\n  register<TInput extends TSchema, TOutput extends TSchema>(\n    mount: PoApiMount,\n    definition: PoPluginMethod<TInput, TOutput>,\n    handler: (input: Static<TInput>, caller: PoPluginCaller) => Static<TOutput> | Promise<Static<TOutput>>,\n  ): () => void;\n  invoke(call: unknown, direction: PoPluginDirection, caller?: PoPluginCaller): Promise<unknown>;\n  dispose(): void;\n}\n\n/** Transport-neutral dispatch, shared by Chord server services and client capability hosts. */\nexport function createPoPluginRegistry(): PoPluginRegistry {\n  const handlers = new Map<\n    string,\n    {\n      definition: PoPluginMethod<TSchema, TSchema>;\n      handler: (input: never, caller: PoPluginCaller) => unknown;\n    }\n  >();\n  let disposed = false;\n  const keyOf = (mount: PoApiMount, service: string, method: string, direction: PoPluginDirection): string =>\n    `${poPluginMountKey(mount)}\\0${direction}\\0${service}\\0${method}`;\n  return {\n    register(mount, definition, handler) {\n      if (disposed) throw new Error('Plugin registry is disposed.');\n      if (mount.scope !== definition.scope)\n        throw new Error(`Method '${definition.service}.${definition.method}' requires ${definition.scope} scope.`);\n      const key = keyOf(mount, definition.service, definition.method, definition.direction);\n      if (handlers.has(key))\n        throw new Error(`Plugin method '${definition.service}.${definition.method}' is already mounted.`);\n      const entry = { definition, handler } as typeof handlers extends Map<string, infer TValue> ? TValue : never;\n      handlers.set(key, entry);\n      return () => {\n        if (handlers.get(key) === entry) handlers.delete(key);\n      };\n    },\n    async invoke(value, direction, caller = {}) {\n      if (disposed) throw new Error('Plugin registry is disposed.');\n      if (!Check(PoPluginCallSchema, value)) throw new PoPluginCallError('INVALID_CALL', 'Invalid plugin call.');\n      const call = value as PoPluginCall;\n      const entry = handlers.get(keyOf(call.mount, call.service, call.method, direction));\n      if (!entry)\n        throw new PoPluginCallError(\n          'METHOD_NOT_FOUND',\n          `Plugin method '${call.service}.${call.method}' is not mounted at this scope.`,\n        );\n      if (!Check(entry.definition.input, call.input))\n        throw new PoPluginCallError('INVALID_INPUT', `Invalid input for '${call.service}.${call.method}'.`);\n      const output = await entry.handler(call.input as never, caller);\n      if (!Check(entry.definition.output, output))\n        throw new PoPluginCallError('INVALID_OUTPUT', `Invalid output from '${call.service}.${call.method}'.`);\n      return output;\n    },\n    dispose() {\n      disposed = true;\n      handlers.clear();\n    },\n  };\n}\n\nexport async function invokePoPluginMethod<TInput extends TSchema, TOutput extends TSchema>(\n  transport: (call: PoPluginCall) => Promise<unknown>,\n  mount: PoApiMount,\n  definition: PoPluginMethod<TInput, TOutput>,\n  input: Static<TInput>,\n): Promise<Static<TOutput>> {\n  if (mount.scope !== definition.scope)\n    throw new Error(`Method '${definition.service}.${definition.method}' requires ${definition.scope} scope.`);\n  if (!Check(definition.input, input))\n    throw new PoPluginCallError('INVALID_INPUT', `Invalid input for '${definition.service}.${definition.method}'.`);\n  const output = await transport({ mount, service: definition.service, method: definition.method, input });\n  if (!Check(definition.output, output))\n    throw new PoPluginCallError('INVALID_OUTPUT', `Invalid output from '${definition.service}.${definition.method}'.`);\n  return output;\n}\n"],"mappings":"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"}

package/dist/src/schemas/profileIdentity.cjs

@@ -19,7 +19,7 @@ let typebox = require("typebox");
 * one, because a message written before a switch keeps the identity it was
 * written under. Collapsing would rewrite history.
 */
-const DOOM_PROFILE_IDENTITY_ENTRY_TYPE = "doom-profile-identity";
+const PO_PROFILE_IDENTITY_ENTRY_TYPE = "po-profile-identity";
 /**
 * Ceiling on the encoded icon, counted on the finished `data:` URL rather than
 * the file, so one number bounds both the journal entry and the transport.
@@ -59,7 +59,7 @@ const ProfileIdentityProjectionSchema = typebox.Type.Object({
 	}))
 }, { additionalProperties: false });
 //#endregion
-exports.DOOM_PROFILE_IDENTITY_ENTRY_TYPE = DOOM_PROFILE_IDENTITY_ENTRY_TYPE;
+exports.PO_PROFILE_IDENTITY_ENTRY_TYPE = PO_PROFILE_IDENTITY_ENTRY_TYPE;
 exports.PROFILE_ICON_MAX_DATA_URL_LENGTH = PROFILE_ICON_MAX_DATA_URL_LENGTH;
 exports.PROFILE_ICON_MIME_TYPES = PROFILE_ICON_MIME_TYPES;
 exports.ProfileIdentityProjectionSchema = ProfileIdentityProjectionSchema;

package/dist/src/schemas/profileIdentity.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"profileIdentity.cjs","names":["Type"],"sources":["../../../src/schemas/profileIdentity.ts"],"sourcesContent":["import { type Static, Type } from 'typebox';\n\n/**\n * The custom session entry the runtime journals when the active profile's\n * persona identity changes.\n *\n * A profile has always been prompt text only, so a cockpit had nothing to show\n * for it beyond the profile name already published as footer status. This entry\n * carries the persona's display name and avatar so the transcript can attribute\n * each assistant message to the persona that produced it.\n *\n * It rides Pi's `entry_appended` frames on the road the agent-model projection\n * already uses, so any RPC client sees the change live and on replay without a\n * new protocol.\n *\n * Unlike the minor-mode, context, and agent-model projections, this entry is\n * NOT a projection: it is transcript, positioned in journal order. A cockpit\n * folding it must keep every occurrence rather than collapsing to the latest\n * one, because a message written before a switch keeps the identity it was\n * written under. Collapsing would rewrite history.\n */\nexport const DOOM_PROFILE_IDENTITY_ENTRY_TYPE = 'doom-profile-identity';\n\n/**\n * Ceiling on the encoded icon, counted on the finished `data:` URL rather than\n * the file, so one number bounds both the journal entry and the transport.\n *\n * An avatar renders at 32 CSS pixels. This much room is already generous, and\n * the cap exists because the entry is replayed with the transcript: an oversize\n * icon is dropped and the persona keeps its name, never failing a profile load.\n */\nexport const PROFILE_ICON_MAX_DATA_URL_LENGTH = 262_144;\n\nconst MAX_PROFILE_NAME_LENGTH = 128;\n\n/**\n * Image types allowed for a persona icon.\n *\n * Deliberately narrower than the cockpit's general media catalog: `image/svg+xml`\n * is excluded because an SVG rendered same-origin executes script, and the icon\n * path comes from user-authored persona front-matter. Do not reconcile this list\n * with the broader media type map.\n */\nexport const PROFILE_ICON_MIME_TYPES = ['image/png', 'image/jpeg', 'image/gif', 'image/webp'] as const;\nexport type ProfileIconMimeType = (typeof PROFILE_ICON_MIME_TYPES)[number];\n\nexport const ProfileIdentityProjectionSchema = Type.Object(\n  {\n    profile: Type.String({ minLength: 1, maxLength: MAX_PROFILE_NAME_LENGTH }),\n    name: Type.Optional(Type.String({ minLength: 1, maxLength: MAX_PROFILE_NAME_LENGTH })),\n    icon: Type.Optional(Type.String({ minLength: 1, maxLength: PROFILE_ICON_MAX_DATA_URL_LENGTH })),\n  },\n  { additionalProperties: false },\n);\n\n/** The persona a message was produced under: the profile name, plus optional display name and icon. */\nexport type ProfileIdentityProjection = Static<typeof ProfileIdentityProjectionSchema>;\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;AAqBA,MAAa,mCAAmC;;;;;;;;;AAUhD,MAAa,mCAAmC;AAEhD,MAAM,0BAA0B;;;;;;;;;AAUhC,MAAa,0BAA0B;CAAC;CAAa;CAAc;CAAa;AAAY;AAG5F,MAAa,kCAAkCA,QAAAA,KAAK,OAClD;CACE,SAASA,QAAAA,KAAK,OAAO;EAAE,WAAW;EAAG,WAAW;CAAwB,CAAC;CACzE,MAAMA,QAAAA,KAAK,SAASA,QAAAA,KAAK,OAAO;EAAE,WAAW;EAAG,WAAW;CAAwB,CAAC,CAAC;CACrF,MAAMA,QAAAA,KAAK,SAASA,QAAAA,KAAK,OAAO;EAAE,WAAW;EAAG,WAAW;CAAiC,CAAC,CAAC;AAChG,GACA,EAAE,sBAAsB,MAAM,CAChC"}
+{"version":3,"file":"profileIdentity.cjs","names":["Type"],"sources":["../../../src/schemas/profileIdentity.ts"],"sourcesContent":["import { type Static, Type } from 'typebox';\n\n/**\n * The custom session entry the runtime journals when the active profile's\n * persona identity changes.\n *\n * A profile has always been prompt text only, so a cockpit had nothing to show\n * for it beyond the profile name already published as footer status. This entry\n * carries the persona's display name and avatar so the transcript can attribute\n * each assistant message to the persona that produced it.\n *\n * It rides Pi's `entry_appended` frames on the road the agent-model projection\n * already uses, so any RPC client sees the change live and on replay without a\n * new protocol.\n *\n * Unlike the minor-mode, context, and agent-model projections, this entry is\n * NOT a projection: it is transcript, positioned in journal order. A cockpit\n * folding it must keep every occurrence rather than collapsing to the latest\n * one, because a message written before a switch keeps the identity it was\n * written under. Collapsing would rewrite history.\n */\nexport const PO_PROFILE_IDENTITY_ENTRY_TYPE = 'po-profile-identity';\n\n/**\n * Ceiling on the encoded icon, counted on the finished `data:` URL rather than\n * the file, so one number bounds both the journal entry and the transport.\n *\n * An avatar renders at 32 CSS pixels. This much room is already generous, and\n * the cap exists because the entry is replayed with the transcript: an oversize\n * icon is dropped and the persona keeps its name, never failing a profile load.\n */\nexport const PROFILE_ICON_MAX_DATA_URL_LENGTH = 262_144;\n\nconst MAX_PROFILE_NAME_LENGTH = 128;\n\n/**\n * Image types allowed for a persona icon.\n *\n * Deliberately narrower than the cockpit's general media catalog: `image/svg+xml`\n * is excluded because an SVG rendered same-origin executes script, and the icon\n * path comes from user-authored persona front-matter. Do not reconcile this list\n * with the broader media type map.\n */\nexport const PROFILE_ICON_MIME_TYPES = ['image/png', 'image/jpeg', 'image/gif', 'image/webp'] as const;\nexport type ProfileIconMimeType = (typeof PROFILE_ICON_MIME_TYPES)[number];\n\nexport const ProfileIdentityProjectionSchema = Type.Object(\n  {\n    profile: Type.String({ minLength: 1, maxLength: MAX_PROFILE_NAME_LENGTH }),\n    name: Type.Optional(Type.String({ minLength: 1, maxLength: MAX_PROFILE_NAME_LENGTH })),\n    icon: Type.Optional(Type.String({ minLength: 1, maxLength: PROFILE_ICON_MAX_DATA_URL_LENGTH })),\n  },\n  { additionalProperties: false },\n);\n\n/** The persona a message was produced under: the profile name, plus optional display name and icon. */\nexport type ProfileIdentityProjection = Static<typeof ProfileIdentityProjectionSchema>;\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;AAqBA,MAAa,iCAAiC;;;;;;;;;AAU9C,MAAa,mCAAmC;AAEhD,MAAM,0BAA0B;;;;;;;;;AAUhC,MAAa,0BAA0B;CAAC;CAAa;CAAc;CAAa;AAAY;AAG5F,MAAa,kCAAkCA,QAAAA,KAAK,OAClD;CACE,SAASA,QAAAA,KAAK,OAAO;EAAE,WAAW;EAAG,WAAW;CAAwB,CAAC;CACzE,MAAMA,QAAAA,KAAK,SAASA,QAAAA,KAAK,OAAO;EAAE,WAAW;EAAG,WAAW;CAAwB,CAAC,CAAC;CACrF,MAAMA,QAAAA,KAAK,SAASA,QAAAA,KAAK,OAAO;EAAE,WAAW;EAAG,WAAW;CAAiC,CAAC,CAAC;AAChG,GACA,EAAE,sBAAsB,MAAM,CAChC"}

package/dist/src/schemas/profileIdentity.d.mts

@@ -19,7 +19,7 @@ import { Static, Type } from "typebox";
  * one, because a message written before a switch keeps the identity it was
  * written under. Collapsing would rewrite history.
  */
-export declare const DOOM_PROFILE_IDENTITY_ENTRY_TYPE = "doom-profile-identity";
+export declare const PO_PROFILE_IDENTITY_ENTRY_TYPE = "po-profile-identity";
 /**
  * Ceiling on the encoded icon, counted on the finished `data:` URL rather than
  * the file, so one number bounds both the journal entry and the transport.

package/dist/src/schemas/profileIdentity.mjs

@@ -19,7 +19,7 @@ import { Type } from "typebox";
 * one, because a message written before a switch keeps the identity it was
 * written under. Collapsing would rewrite history.
 */
-const DOOM_PROFILE_IDENTITY_ENTRY_TYPE = "doom-profile-identity";
+const PO_PROFILE_IDENTITY_ENTRY_TYPE = "po-profile-identity";
 /**
 * Ceiling on the encoded icon, counted on the finished `data:` URL rather than
 * the file, so one number bounds both the journal entry and the transport.
@@ -59,6 +59,6 @@ const ProfileIdentityProjectionSchema = Type.Object({
 	}))
 }, { additionalProperties: false });
 //#endregion
-export { DOOM_PROFILE_IDENTITY_ENTRY_TYPE, PROFILE_ICON_MAX_DATA_URL_LENGTH, PROFILE_ICON_MIME_TYPES, ProfileIdentityProjectionSchema };
+export { PO_PROFILE_IDENTITY_ENTRY_TYPE, PROFILE_ICON_MAX_DATA_URL_LENGTH, PROFILE_ICON_MIME_TYPES, ProfileIdentityProjectionSchema };
 
 //# sourceMappingURL=profileIdentity.mjs.map

package/dist/src/schemas/profileIdentity.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"profileIdentity.mjs","names":[],"sources":["../../../src/schemas/profileIdentity.ts"],"sourcesContent":["import { type Static, Type } from 'typebox';\n\n/**\n * The custom session entry the runtime journals when the active profile's\n * persona identity changes.\n *\n * A profile has always been prompt text only, so a cockpit had nothing to show\n * for it beyond the profile name already published as footer status. This entry\n * carries the persona's display name and avatar so the transcript can attribute\n * each assistant message to the persona that produced it.\n *\n * It rides Pi's `entry_appended` frames on the road the agent-model projection\n * already uses, so any RPC client sees the change live and on replay without a\n * new protocol.\n *\n * Unlike the minor-mode, context, and agent-model projections, this entry is\n * NOT a projection: it is transcript, positioned in journal order. A cockpit\n * folding it must keep every occurrence rather than collapsing to the latest\n * one, because a message written before a switch keeps the identity it was\n * written under. Collapsing would rewrite history.\n */\nexport const DOOM_PROFILE_IDENTITY_ENTRY_TYPE = 'doom-profile-identity';\n\n/**\n * Ceiling on the encoded icon, counted on the finished `data:` URL rather than\n * the file, so one number bounds both the journal entry and the transport.\n *\n * An avatar renders at 32 CSS pixels. This much room is already generous, and\n * the cap exists because the entry is replayed with the transcript: an oversize\n * icon is dropped and the persona keeps its name, never failing a profile load.\n */\nexport const PROFILE_ICON_MAX_DATA_URL_LENGTH = 262_144;\n\nconst MAX_PROFILE_NAME_LENGTH = 128;\n\n/**\n * Image types allowed for a persona icon.\n *\n * Deliberately narrower than the cockpit's general media catalog: `image/svg+xml`\n * is excluded because an SVG rendered same-origin executes script, and the icon\n * path comes from user-authored persona front-matter. Do not reconcile this list\n * with the broader media type map.\n */\nexport const PROFILE_ICON_MIME_TYPES = ['image/png', 'image/jpeg', 'image/gif', 'image/webp'] as const;\nexport type ProfileIconMimeType = (typeof PROFILE_ICON_MIME_TYPES)[number];\n\nexport const ProfileIdentityProjectionSchema = Type.Object(\n  {\n    profile: Type.String({ minLength: 1, maxLength: MAX_PROFILE_NAME_LENGTH }),\n    name: Type.Optional(Type.String({ minLength: 1, maxLength: MAX_PROFILE_NAME_LENGTH })),\n    icon: Type.Optional(Type.String({ minLength: 1, maxLength: PROFILE_ICON_MAX_DATA_URL_LENGTH })),\n  },\n  { additionalProperties: false },\n);\n\n/** The persona a message was produced under: the profile name, plus optional display name and icon. */\nexport type ProfileIdentityProjection = Static<typeof ProfileIdentityProjectionSchema>;\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;AAqBA,MAAa,mCAAmC;;;;;;;;;AAUhD,MAAa,mCAAmC;AAEhD,MAAM,0BAA0B;;;;;;;;;AAUhC,MAAa,0BAA0B;CAAC;CAAa;CAAc;CAAa;AAAY;AAG5F,MAAa,kCAAkC,KAAK,OAClD;CACE,SAAS,KAAK,OAAO;EAAE,WAAW;EAAG,WAAW;CAAwB,CAAC;CACzE,MAAM,KAAK,SAAS,KAAK,OAAO;EAAE,WAAW;EAAG,WAAW;CAAwB,CAAC,CAAC;CACrF,MAAM,KAAK,SAAS,KAAK,OAAO;EAAE,WAAW;EAAG,WAAW;CAAiC,CAAC,CAAC;AAChG,GACA,EAAE,sBAAsB,MAAM,CAChC"}
+{"version":3,"file":"profileIdentity.mjs","names":[],"sources":["../../../src/schemas/profileIdentity.ts"],"sourcesContent":["import { type Static, Type } from 'typebox';\n\n/**\n * The custom session entry the runtime journals when the active profile's\n * persona identity changes.\n *\n * A profile has always been prompt text only, so a cockpit had nothing to show\n * for it beyond the profile name already published as footer status. This entry\n * carries the persona's display name and avatar so the transcript can attribute\n * each assistant message to the persona that produced it.\n *\n * It rides Pi's `entry_appended` frames on the road the agent-model projection\n * already uses, so any RPC client sees the change live and on replay without a\n * new protocol.\n *\n * Unlike the minor-mode, context, and agent-model projections, this entry is\n * NOT a projection: it is transcript, positioned in journal order. A cockpit\n * folding it must keep every occurrence rather than collapsing to the latest\n * one, because a message written before a switch keeps the identity it was\n * written under. Collapsing would rewrite history.\n */\nexport const PO_PROFILE_IDENTITY_ENTRY_TYPE = 'po-profile-identity';\n\n/**\n * Ceiling on the encoded icon, counted on the finished `data:` URL rather than\n * the file, so one number bounds both the journal entry and the transport.\n *\n * An avatar renders at 32 CSS pixels. This much room is already generous, and\n * the cap exists because the entry is replayed with the transcript: an oversize\n * icon is dropped and the persona keeps its name, never failing a profile load.\n */\nexport const PROFILE_ICON_MAX_DATA_URL_LENGTH = 262_144;\n\nconst MAX_PROFILE_NAME_LENGTH = 128;\n\n/**\n * Image types allowed for a persona icon.\n *\n * Deliberately narrower than the cockpit's general media catalog: `image/svg+xml`\n * is excluded because an SVG rendered same-origin executes script, and the icon\n * path comes from user-authored persona front-matter. Do not reconcile this list\n * with the broader media type map.\n */\nexport const PROFILE_ICON_MIME_TYPES = ['image/png', 'image/jpeg', 'image/gif', 'image/webp'] as const;\nexport type ProfileIconMimeType = (typeof PROFILE_ICON_MIME_TYPES)[number];\n\nexport const ProfileIdentityProjectionSchema = Type.Object(\n  {\n    profile: Type.String({ minLength: 1, maxLength: MAX_PROFILE_NAME_LENGTH }),\n    name: Type.Optional(Type.String({ minLength: 1, maxLength: MAX_PROFILE_NAME_LENGTH })),\n    icon: Type.Optional(Type.String({ minLength: 1, maxLength: PROFILE_ICON_MAX_DATA_URL_LENGTH })),\n  },\n  { additionalProperties: false },\n);\n\n/** The persona a message was produced under: the profile name, plus optional display name and icon. */\nexport type ProfileIdentityProjection = Static<typeof ProfileIdentityProjectionSchema>;\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;AAqBA,MAAa,iCAAiC;;;;;;;;;AAU9C,MAAa,mCAAmC;AAEhD,MAAM,0BAA0B;;;;;;;;;AAUhC,MAAa,0BAA0B;CAAC;CAAa;CAAc;CAAa;AAAY;AAG5F,MAAa,kCAAkC,KAAK,OAClD;CACE,SAAS,KAAK,OAAO;EAAE,WAAW;EAAG,WAAW;CAAwB,CAAC;CACzE,MAAM,KAAK,SAAS,KAAK,OAAO;EAAE,WAAW;EAAG,WAAW;CAAwB,CAAC,CAAC;CACrF,MAAM,KAAK,SAAS,KAAK,OAAO;EAAE,WAAW;EAAG,WAAW;CAAiC,CAAC,CAAC;AAChG,GACA,EAAE,sBAAsB,MAAM,CAChC"}

package/dist/src/schemas/protocolChannelsContract.cjs

@@ -0,0 +1,27 @@
+const require_protocolContracts = require("./protocolContracts.cjs");
+let typebox = require("typebox");
+let dist_interop_chord_mjs = require("../../../dist/interop/chord.mjs");
+//#region src/schemas/protocolChannelsContract.ts
+const Json = typebox.Type.Unsafe({});
+const ChannelFrameSchema = typebox.Type.Object({
+	type: typebox.Type.String({ minLength: 1 }),
+	payload: Json
+});
+/** Latest payload per extension channel frame type. */
+const PoChannelsStateSchema = typebox.Type.Record(typebox.Type.String(), Json);
+/** A session's extension channels as seen by one connection. */
+const PoChannelsContract = (0, dist_interop_chord_mjs.remote)("po.channels", {
+	version: 1,
+	host: (0, dist_interop_chord_mjs.hostNamed)(require_protocolContracts.PO_SERVER_HOST),
+	input: typebox.Type.Object({ sessionId: typebox.Type.String({ minLength: 1 }) }),
+	variants: { default: {
+		state: { latest: PoChannelsStateSchema },
+		methods: require_protocolContracts.chordMethods({ receive: { args: ChannelFrameSchema } })
+	} }
+});
+//#endregion
+exports.ChannelFrameSchema = ChannelFrameSchema;
+exports.PoChannelsContract = PoChannelsContract;
+exports.PoChannelsStateSchema = PoChannelsStateSchema;
+
+//# sourceMappingURL=protocolChannelsContract.cjs.map

package/dist/src/schemas/protocolChannelsContract.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"protocolChannelsContract.cjs","names":["Type","remote","hostNamed","PO_SERVER_HOST","chordMethods"],"sources":["../../../src/schemas/protocolChannelsContract.ts"],"sourcesContent":["import { hostNamed, remote, type Ref } from '@earendil-works/chord';\nimport { Type } from 'typebox';\n\nimport { chordMethods, PO_SERVER_HOST } from './protocolContracts';\nimport type { JsonValue } from './sessionProtocol';\n\nconst Json = Type.Unsafe<JsonValue>({});\n\nexport const ChannelFrameSchema = Type.Object({ type: Type.String({ minLength: 1 }), payload: Json });\n/** Latest payload per extension channel frame type. */\nexport const PoChannelsStateSchema = Type.Record(Type.String(), Json);\n\n/** A session's extension channels as seen by one connection. */\nexport const PoChannelsContract = remote('po.channels', {\n  version: 1,\n  host: hostNamed(PO_SERVER_HOST),\n  input: Type.Object({ sessionId: Type.String({ minLength: 1 }) }),\n  variants: {\n    default: {\n      state: { latest: PoChannelsStateSchema },\n      methods: chordMethods({ receive: { args: ChannelFrameSchema } }),\n    },\n  },\n});\n\nexport type ChannelsRef = Ref<typeof PoChannelsContract>;\n"],"mappings":";;;;AAMA,MAAM,OAAOA,QAAAA,KAAK,OAAkB,CAAC,CAAC;AAEtC,MAAa,qBAAqBA,QAAAA,KAAK,OAAO;CAAE,MAAMA,QAAAA,KAAK,OAAO,EAAE,WAAW,EAAE,CAAC;CAAG,SAAS;AAAK,CAAC;;AAEpG,MAAa,wBAAwBA,QAAAA,KAAK,OAAOA,QAAAA,KAAK,OAAO,GAAG,IAAI;;AAGpE,MAAa,sBAAA,GAAqBC,uBAAAA,OAAAA,CAAO,eAAe;CACtD,SAAS;CACT,OAAA,GAAMC,uBAAAA,UAAAA,CAAUC,0BAAAA,cAAc;CAC9B,OAAOH,QAAAA,KAAK,OAAO,EAAE,WAAWA,QAAAA,KAAK,OAAO,EAAE,WAAW,EAAE,CAAC,EAAE,CAAC;CAC/D,UAAU,EACR,SAAS;EACP,OAAO,EAAE,QAAQ,sBAAsB;EACvC,SAASI,0BAAAA,aAAa,EAAE,SAAS,EAAE,MAAM,mBAAmB,EAAE,CAAC;CACjE,EACF;AACF,CAAC"}

package/dist/src/schemas/protocolChannelsContract.d.mts

@@ -0,0 +1,37 @@
+import { JsonValue as JsonValue$1 } from "./sessionProtocol.mjs";
+import { ChordMethods } from "./protocolContracts.mjs";
+import { Type } from "typebox";
+import { Ref } from "@earendil-works/chord";
+//#region src/schemas/protocolChannelsContract.d.ts
+export declare const ChannelFrameSchema: Type.TObject<{
+  type: Type.TString;
+  payload: Type.TUnsafe<JsonValue$1>;
+}>;
+/** Latest payload per extension channel frame type. */
+export declare const PoChannelsStateSchema: Type.TRecord<"^.*$", Type.TUnsafe<JsonValue$1>>;
+/** A session's extension channels as seen by one connection. */
+export declare const PoChannelsContract: import("@earendil-works/chord").RemoteContract<{
+  readonly version: 1;
+  readonly host: import("@earendil-works/chord").HostNamed;
+  readonly input: Type.TObject<{
+    sessionId: Type.TString;
+  }>;
+  readonly variants: {
+    default: {
+      state: {
+        latest: Type.TRecord<"^.*$", Type.TUnsafe<JsonValue$1>>;
+      };
+      methods: ChordMethods<{
+        receive: {
+          args: Type.TObject<{
+            type: Type.TString;
+            payload: Type.TUnsafe<JsonValue$1>;
+          }>;
+        };
+      }>;
+    };
+  };
+}>;
+export type ChannelsRef = Ref<typeof PoChannelsContract>;
+//#endregion
+//# sourceMappingURL=protocolChannelsContract.d.mts.map

package/dist/src/schemas/protocolChannelsContract.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"protocolChannelsContract.d.mts","names":["JsonValue","_$__protocolContracts0.ChordMethods"],"sources":["../../../src/schemas/protocolChannelsContract.ts"],"mappings":";;;;;qBAQa,oBAAkB,KAAA;;;;;qBAElB,uBAAqB,KAAA,gBAAA,KAAA,QAAAA;;qBAGrB,oDAAkB;;;;;;;IAK3B;MACE;QAAS,QAAM,KAAA,gBAAA,KAAA,QAAAA;;MACf,SAAuCC;;UAAJ,MAAI,KAAA;;;;;;;;;YAKjC,cAAc,WAAW"}

package/dist/src/schemas/protocolChannelsContract.mjs

@@ -0,0 +1,25 @@
+import { PO_SERVER_HOST, chordMethods } from "./protocolContracts.mjs";
+import { Type } from "typebox";
+import { hostNamed, remote } from "@earendil-works/chord";
+//#region src/schemas/protocolChannelsContract.ts
+const Json = Type.Unsafe({});
+const ChannelFrameSchema = Type.Object({
+	type: Type.String({ minLength: 1 }),
+	payload: Json
+});
+/** Latest payload per extension channel frame type. */
+const PoChannelsStateSchema = Type.Record(Type.String(), Json);
+/** A session's extension channels as seen by one connection. */
+const PoChannelsContract = remote("po.channels", {
+	version: 1,
+	host: hostNamed(PO_SERVER_HOST),
+	input: Type.Object({ sessionId: Type.String({ minLength: 1 }) }),
+	variants: { default: {
+		state: { latest: PoChannelsStateSchema },
+		methods: chordMethods({ receive: { args: ChannelFrameSchema } })
+	} }
+});
+//#endregion
+export { ChannelFrameSchema, PoChannelsContract, PoChannelsStateSchema };
+
+//# sourceMappingURL=protocolChannelsContract.mjs.map

package/dist/src/schemas/protocolChannelsContract.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"protocolChannelsContract.mjs","names":[],"sources":["../../../src/schemas/protocolChannelsContract.ts"],"sourcesContent":["import { hostNamed, remote, type Ref } from '@earendil-works/chord';\nimport { Type } from 'typebox';\n\nimport { chordMethods, PO_SERVER_HOST } from './protocolContracts';\nimport type { JsonValue } from './sessionProtocol';\n\nconst Json = Type.Unsafe<JsonValue>({});\n\nexport const ChannelFrameSchema = Type.Object({ type: Type.String({ minLength: 1 }), payload: Json });\n/** Latest payload per extension channel frame type. */\nexport const PoChannelsStateSchema = Type.Record(Type.String(), Json);\n\n/** A session's extension channels as seen by one connection. */\nexport const PoChannelsContract = remote('po.channels', {\n  version: 1,\n  host: hostNamed(PO_SERVER_HOST),\n  input: Type.Object({ sessionId: Type.String({ minLength: 1 }) }),\n  variants: {\n    default: {\n      state: { latest: PoChannelsStateSchema },\n      methods: chordMethods({ receive: { args: ChannelFrameSchema } }),\n    },\n  },\n});\n\nexport type ChannelsRef = Ref<typeof PoChannelsContract>;\n"],"mappings":";;;;AAMA,MAAM,OAAO,KAAK,OAAkB,CAAC,CAAC;AAEtC,MAAa,qBAAqB,KAAK,OAAO;CAAE,MAAM,KAAK,OAAO,EAAE,WAAW,EAAE,CAAC;CAAG,SAAS;AAAK,CAAC;;AAEpG,MAAa,wBAAwB,KAAK,OAAO,KAAK,OAAO,GAAG,IAAI;;AAGpE,MAAa,qBAAqB,OAAO,eAAe;CACtD,SAAS;CACT,MAAM,UAAU,cAAc;CAC9B,OAAO,KAAK,OAAO,EAAE,WAAW,KAAK,OAAO,EAAE,WAAW,EAAE,CAAC,EAAE,CAAC;CAC/D,UAAU,EACR,SAAS;EACP,OAAO,EAAE,QAAQ,sBAAsB;EACvC,SAAS,aAAa,EAAE,SAAS,EAAE,MAAM,mBAAmB,EAAE,CAAC;CACjE,EACF;AACF,CAAC"}

package/dist/src/schemas/protocolContracts.cjs

@@ -0,0 +1,168 @@
+let dist_interop_chord_mjs = require("../../../dist/interop/chord.mjs");
+//#region src/schemas/protocolContracts.ts
+/** Name of the Po server host; every Po contract places its objects on it. */
+const PO_SERVER_HOST = "server";
+/** Chord method specs for a schema table, typed so contracts built from them stay nameable. */
+function chordMethods(schemas) {
+	return Object.fromEntries(Object.entries(schemas).map(([name, { args, result }]) => [name, result !== void 0 ? (0, dist_interop_chord_mjs.method)(args, result) : args !== void 0 ? (0, dist_interop_chord_mjs.method)(args) : (0, dist_interop_chord_mjs.method)()]));
+}
+/**
+* A Chord link over any ordered text transport. Feed received text to `deliver` and the
+* transport's end to `ended`.
+*/
+function createTextLink(port) {
+	let handler;
+	let queue = [];
+	const closeHandlers = /* @__PURE__ */ new Set();
+	let closed = false;
+	const ended = (reason) => {
+		if (closed) return;
+		closed = true;
+		queue = [];
+		try {
+			port.close();
+		} finally {
+			for (const close of closeHandlers) close(reason);
+			closeHandlers.clear();
+		}
+	};
+	const link = {
+		get closed() {
+			return closed;
+		},
+		send(frame) {
+			if (closed) return void 0;
+			const text = JSON.stringify(frame);
+			port.send(text);
+			return text.length;
+		},
+		receive(next) {
+			handler = next;
+			for (const frame of queue.splice(0)) next(frame);
+		},
+		onClose(close) {
+			if (closed) close("closed");
+			else closeHandlers.add(close);
+		},
+		close(reason = "closed") {
+			if (closed) return;
+			try {
+				port.send(JSON.stringify({
+					t: "bye",
+					reason
+				}));
+			} catch {}
+			ended(reason);
+		}
+	};
+	return {
+		link,
+		deliver(text) {
+			if (closed) return;
+			let frame;
+			try {
+				frame = JSON.parse(text);
+				if (frame === null || typeof frame !== "object" || typeof frame.t !== "string") throw new TypeError("not a frame");
+			} catch {
+				link.close("protocol error");
+				return;
+			}
+			if (frame.t === "bye") {
+				ended(frame.reason ?? "peer closed");
+				return;
+			}
+			if (handler === void 0) queue.push(frame);
+			else handler(frame);
+		},
+		ended
+	};
+}
+/**
+* Whether `error` means this client's code is older than the server's. Chord refuses a changed contract with
+* `contract_mismatch`, which it reports to a client as `upgrade_required`; another protocol version is reported the
+* same way by `createProtocolClient`. Retrying cannot help, only new client code can.
+*/
+function isUpdateRequired(error) {
+	return (0, dist_interop_chord_mjs.isChordError)(error, "contract_mismatch") || (0, dist_interop_chord_mjs.isChordError)(error, "upgrade_required");
+}
+function createProtocolClient(options) {
+	const host = (0, dist_interop_chord_mjs.createHost)({
+		name: options.name ?? "client",
+		kind: "client",
+		self: { host: true }
+	});
+	const listeners = /* @__PURE__ */ new Set();
+	let current;
+	let connecting;
+	let disposed = false;
+	let updateError;
+	const emit = (state) => {
+		for (const listener of Array.from(listeners)) listener({ state });
+	};
+	const reportError = (error) => {
+		if (disposed || updateError !== void 0 || !isUpdateRequired(error)) return;
+		updateError = error;
+		emit("update_required");
+		current?.close();
+	};
+	return {
+		host,
+		get connected() {
+			return current !== void 0 && !current.closed;
+		},
+		get updateRequired() {
+			return updateError !== void 0;
+		},
+		connect() {
+			if (disposed) return Promise.reject(/* @__PURE__ */ new Error("The protocol client is disposed."));
+			if (updateError !== void 0) return Promise.reject(updateError);
+			if (current !== void 0 && !current.closed) return Promise.resolve();
+			connecting ??= (async () => {
+				try {
+					const link = await options.openLink();
+					if (disposed) {
+						link.close();
+						throw new Error("The protocol client is disposed.");
+					}
+					current = link;
+					link.onClose(() => {
+						if (current !== link) return;
+						current = void 0;
+						emit("disconnected");
+					});
+					host.connect(link, {
+						principal: { host: PO_SERVER_HOST },
+						onProtocolMismatch: ({ local, peer }) => reportError(new dist_interop_chord_mjs.ChordError("upgrade_required", `The Po server speaks Chord protocol ${peer}, this client speaks ${local}.`))
+					});
+					if (!link.closed) emit("connected");
+				} finally {
+					connecting = void 0;
+				}
+			})();
+			return connecting;
+		},
+		disconnect() {
+			current?.close();
+		},
+		reportError,
+		dispose() {
+			if (disposed) return;
+			disposed = true;
+			current?.close();
+			listeners.clear();
+			host.close().catch(() => void 0);
+		},
+		onConnectionStateChange(listener) {
+			listeners.add(listener);
+			return () => listeners.delete(listener);
+		}
+	};
+}
+//#endregion
+exports.PO_SERVER_HOST = PO_SERVER_HOST;
+exports.chordMethods = chordMethods;
+exports.createProtocolClient = createProtocolClient;
+exports.createTextLink = createTextLink;
+exports.isUpdateRequired = isUpdateRequired;
+
+//# sourceMappingURL=protocolContracts.cjs.map

package/dist/src/schemas/protocolContracts.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"protocolContracts.cjs","names":["method","isChordError","createHost","ChordError"],"sources":["../../../src/schemas/protocolContracts.ts"],"sourcesContent":["import { ChordError, createHost, isChordError, method, type Frame, type Host, type Link } from '@earendil-works/chord';\nimport type { TSchema } from 'typebox';\n\n/** Name of the Po server host; every Po contract places its objects on it. */\nexport const PO_SERVER_HOST = 'server';\n\n/** One method's argument and result schemas; a missing one means no arguments or a void result. */\nexport interface PoMethodSchemas {\n  readonly args?: TSchema;\n  readonly result?: TSchema;\n}\n\n/**\n * What Chord's `method(args, result)` returns. Chord keeps `MethodSpec` private, so declaration\n * emit cannot name an inferred `method()` result; this alias can.\n */\nexport type ChordMethod<A extends TSchema | undefined, R extends TSchema | undefined> = Omit<\n  ReturnType<typeof method<TSchema, TSchema>>,\n  'args' | 'result'\n> & { readonly args: A; readonly result: R };\n\nexport type ChordMethods<T extends Record<string, PoMethodSchemas>> = {\n  [K in keyof T]: ChordMethod<\n    T[K] extends { readonly args: infer A extends TSchema } ? A : undefined,\n    T[K] extends { readonly result: infer R extends TSchema } ? R : undefined\n  >;\n};\n\n/** Chord method specs for a schema table, typed so contracts built from them stay nameable. */\nexport function chordMethods<T extends Record<string, PoMethodSchemas>>(schemas: T): ChordMethods<T> {\n  return Object.fromEntries(\n    Object.entries<PoMethodSchemas>(schemas).map(([name, { args, result }]) => [\n      name,\n      result !== undefined ? method(args, result) : args !== undefined ? method(args) : method(),\n    ]),\n  ) as ChordMethods<T>;\n}\n\n/** A transport that carries text messages in order; `send` may be asynchronous (sealing). */\nexport interface TextPort {\n  send(text: string): void;\n  close(): void;\n}\n\n/**\n * A Chord link over any ordered text transport. Feed received text to `deliver` and the\n * transport's end to `ended`.\n */\nexport function createTextLink(port: TextPort): {\n  link: Link;\n  deliver(text: string): void;\n  ended(reason: string): void;\n} {\n  let handler: ((frame: Frame) => void) | undefined;\n  let queue: Frame[] = [];\n  const closeHandlers = new Set<(reason: string) => void>();\n  let closed = false;\n  const ended = (reason: string): void => {\n    if (closed) return;\n    closed = true;\n    queue = [];\n    try {\n      port.close();\n    } finally {\n      for (const close of closeHandlers) close(reason);\n      closeHandlers.clear();\n    }\n  };\n  const link: Link = {\n    get closed() {\n      return closed;\n    },\n    send(frame) {\n      if (closed) return undefined;\n      const text = JSON.stringify(frame);\n      port.send(text);\n      // Reported like Chord's WebSocket link, so this link joins its flow control.\n      return text.length;\n    },\n    receive(next) {\n      handler = next;\n      for (const frame of queue.splice(0)) next(frame);\n    },\n    onClose(close) {\n      if (closed) close('closed');\n      else closeHandlers.add(close);\n    },\n    close(reason = 'closed') {\n      if (closed) return;\n      try {\n        port.send(JSON.stringify({ t: 'bye', reason }));\n      } catch {\n        // The transport may already be gone.\n      }\n      ended(reason);\n    },\n  };\n  return {\n    link,\n    deliver(text) {\n      if (closed) return;\n      let frame: Frame;\n      try {\n        frame = JSON.parse(text) as Frame;\n        if (frame === null || typeof frame !== 'object' || typeof (frame as { t?: unknown }).t !== 'string')\n          throw new TypeError('not a frame');\n      } catch {\n        link.close('protocol error');\n        return;\n      }\n      if ((frame as { t: string }).t === 'bye') {\n        ended((frame as { reason?: string }).reason ?? 'peer closed');\n        return;\n      }\n      if (handler === undefined) queue.push(frame);\n      else handler(frame);\n    },\n    ended,\n  };\n}\n\n/**\n * Whether `error` means this client's code is older than the server's. Chord refuses a changed contract with\n * `contract_mismatch`, which it reports to a client as `upgrade_required`; another protocol version is reported the\n * same way by `createProtocolClient`. Retrying cannot help, only new client code can.\n */\nexport function isUpdateRequired(error: unknown): boolean {\n  return isChordError(error, 'contract_mismatch') || isChordError(error, 'upgrade_required');\n}\n\n/** `update_required` is heard once, before the closing link's `disconnected`; the client never connects again. */\nexport type ProtocolConnectionState = 'connected' | 'disconnected' | 'update_required';\n\n/** A browser or native Chord client host with one reconnectable link to the Po server. */\nexport interface ProtocolClient {\n  readonly host: Host;\n  readonly connected: boolean;\n  /** The server needs newer client code; `connect` rejects from now on. */\n  readonly updateRequired: boolean;\n  connect(): Promise<void>;\n  /** Closes the current link; listeners hear `disconnected`. */\n  disconnect(): void;\n  /** Hands over the error a held reference ended with; an update-required error stops the client for good. */\n  reportError(error: unknown): void;\n  dispose(): void;\n  onConnectionStateChange(listener: (change: { state: ProtocolConnectionState }) => void): () => void;\n}\n\nexport function createProtocolClient(options: { name?: string; openLink: () => Promise<Link> }): ProtocolClient {\n  const host = createHost({ name: options.name ?? 'client', kind: 'client', self: { host: true } });\n  const listeners = new Set<(change: { state: ProtocolConnectionState }) => void>();\n  let current: Link | undefined;\n  let connecting: Promise<void> | undefined;\n  let disposed = false;\n  let updateError: unknown;\n  const emit = (state: ProtocolConnectionState) => {\n    for (const listener of Array.from(listeners)) listener({ state });\n  };\n  const reportError = (error: unknown): void => {\n    if (disposed || updateError !== undefined || !isUpdateRequired(error)) return;\n    updateError = error;\n    emit('update_required');\n    current?.close();\n  };\n  return {\n    host,\n    get connected() {\n      return current !== undefined && !current.closed;\n    },\n    get updateRequired() {\n      return updateError !== undefined;\n    },\n    connect() {\n      if (disposed) return Promise.reject(new Error('The protocol client is disposed.'));\n      if (updateError !== undefined) return Promise.reject(updateError);\n      if (current !== undefined && !current.closed) return Promise.resolve();\n      connecting ??= (async () => {\n        try {\n          const link = await options.openLink();\n          if (disposed) {\n            link.close();\n            throw new Error('The protocol client is disposed.');\n          }\n          current = link;\n          link.onClose(() => {\n            if (current !== link) return;\n            current = undefined;\n            emit('disconnected');\n          });\n          host.connect(link, {\n            principal: { host: PO_SERVER_HOST },\n            onProtocolMismatch: ({ local, peer }) =>\n              reportError(\n                new ChordError(\n                  'upgrade_required',\n                  `The Po server speaks Chord protocol ${peer}, this client speaks ${local}.`,\n                ),\n              ),\n          });\n          if (!link.closed) emit('connected');\n        } finally {\n          connecting = undefined;\n        }\n      })();\n      return connecting;\n    },\n    disconnect() {\n      current?.close();\n    },\n    reportError,\n    dispose() {\n      if (disposed) return;\n      disposed = true;\n      current?.close();\n      listeners.clear();\n      void host.close().catch(() => undefined);\n    },\n    onConnectionStateChange(listener) {\n      listeners.add(listener);\n      return () => listeners.delete(listener);\n    },\n  };\n}\n"],"mappings":"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"}

package/dist/src/schemas/protocolContracts.d.mts

@@ -0,0 +1,69 @@
+import { TSchema } from "typebox";
+import { Host, Link, method } from "@earendil-works/chord";
+//#region src/schemas/protocolContracts.d.ts
+/** Name of the Po server host; every Po contract places its objects on it. */
+export declare const PO_SERVER_HOST = "server";
+/** One method's argument and result schemas; a missing one means no arguments or a void result. */
+export interface PoMethodSchemas {
+  readonly args?: TSchema;
+  readonly result?: TSchema;
+}
+/**
+ * What Chord's `method(args, result)` returns. Chord keeps `MethodSpec` private, so declaration
+ * emit cannot name an inferred `method()` result; this alias can.
+ */
+export type ChordMethod<A extends TSchema | undefined, R extends TSchema | undefined> = Omit<ReturnType<typeof method<TSchema, TSchema>>, 'args' | 'result'> & {
+  readonly args: A;
+  readonly result: R;
+};
+export type ChordMethods<T extends Record<string, PoMethodSchemas>> = { [K in keyof T]: ChordMethod<T[K] extends {
+  readonly args: infer A extends TSchema;
+} ? A : undefined, T[K] extends {
+  readonly result: infer R extends TSchema;
+} ? R : undefined>; };
+/** Chord method specs for a schema table, typed so contracts built from them stay nameable. */
+export declare function chordMethods<T extends Record<string, PoMethodSchemas>>(schemas: T): ChordMethods<T>;
+/** A transport that carries text messages in order; `send` may be asynchronous (sealing). */
+export interface TextPort {
+  send(text: string): void;
+  close(): void;
+}
+/**
+ * A Chord link over any ordered text transport. Feed received text to `deliver` and the
+ * transport's end to `ended`.
+ */
+export declare function createTextLink(port: TextPort): {
+  link: Link;
+  deliver(text: string): void;
+  ended(reason: string): void;
+};
+/**
+ * Whether `error` means this client's code is older than the server's. Chord refuses a changed contract with
+ * `contract_mismatch`, which it reports to a client as `upgrade_required`; another protocol version is reported the
+ * same way by `createProtocolClient`. Retrying cannot help, only new client code can.
+ */
+export declare function isUpdateRequired(error: unknown): boolean;
+/** `update_required` is heard once, before the closing link's `disconnected`; the client never connects again. */
+export type ProtocolConnectionState = 'connected' | 'disconnected' | 'update_required';
+/** A browser or native Chord client host with one reconnectable link to the Po server. */
+export interface ProtocolClient {
+  readonly host: Host;
+  readonly connected: boolean;
+  /** The server needs newer client code; `connect` rejects from now on. */
+  readonly updateRequired: boolean;
+  connect(): Promise<void>;
+  /** Closes the current link; listeners hear `disconnected`. */
+  disconnect(): void;
+  /** Hands over the error a held reference ended with; an update-required error stops the client for good. */
+  reportError(error: unknown): void;
+  dispose(): void;
+  onConnectionStateChange(listener: (change: {
+    state: ProtocolConnectionState;
+  }) => void): () => void;
+}
+export declare function createProtocolClient(options: {
+  name?: string;
+  openLink: () => Promise<Link>;
+}): ProtocolClient;
+//#endregion
+//# sourceMappingURL=protocolContracts.d.mts.map

package/dist/src/schemas/protocolContracts.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"protocolContracts.d.mts","names":[],"sources":["../../../src/schemas/protocolContracts.ts"],"mappings":";;;;qBAIa;;iBAGI;WACN,OAAO;WACP,SAAS;;;;;;YAOR,YAAY,UAAU,qBAAqB,UAAU,uBAAuB,KACtF,kBAAkB,OAAO,SAAS;WAErB,MAAM;WAAY,QAAQ;;YAE7B,aAAa,UAAU,eAAe,uBAC/C,WAAW,IAAI,YACd,EAAE;WAAsB,YAAY,UAAU;IAAY,eAC1D,EAAE;WAAsB,cAAc,UAAU;IAAY;;wBAKhD,aAAa,UAAU,eAAe,kBAAkB,SAAS,IAAI,aAAa;;iBAUjF;EACf,KAAK;EACL;;;;;;wBAOc,eAAe,MAAM;EACnC,MAAM;EACN,QAAQ;EACR,MAAM;;;;;;;wBA2EQ,iBAAiB;;YAKrB;;iBAGK;WACN,MAAM;WACN;;WAEA;EACT,WAAW;;EAEX;;EAEA,YAAY;EACZ;EACA,wBAAwB,WAAW;IAAU,OAAO;;;wBAGtC,qBAAqB;EAAW;EAAe,gBAAgB,QAAQ;IAAU"}