docs(session-title): record contracts and generated catalogs

docs/cordis-catalog/services.md

@@ -672,6 +672,13 @@ Live-preferred logical-corpus exact-read and relationship-tracing service.
  */
 listSessions(): Promise<SessionRecord[]>
 
+/**
+ * Fold the latest log-backed title from one live-preferred logical session.
+ * @param sessionId - live or persisted session id to read.
+ * @returns latest title snapshot, or `undefined` when the log has no title event.
+ */
+async readTitle(sessionId: SessionId): Promise<SessionTitleSnapshot | undefined>
+
 /**
  * List lightweight raw-log event records for one logical session.
  * @param sessionId - live-preferred session id to read.
@@ -703,9 +710,9 @@ async traceEvent(request: SessionEventTraceRequest): Promise<SessionEventTrace>
 async readEvent(request: SessionEventReadRequest): Promise<SessionEventWindow>
 ```
 
-Types: [SessionEventReadRequest](../core-data-structures/session-query.md) · [SessionEventRecord](../core-data-structures/session-query.md) · [SessionEventTrace](../core-data-structures/session-query.md) · [SessionEventTraceRequest](../core-data-structures/session-query.md) · [SessionEventWindow](../core-data-structures/session-query.md) · [SessionId](../core-data-structures/core.md) · [SessionLineageTrace](../core-data-structures/session-query.md) · [SessionRecord](../core-data-structures/session-query.md)
+Types: [SessionEventReadRequest](../core-data-structures/session-query.md) · [SessionEventRecord](../core-data-structures/session-query.md) · [SessionEventTrace](../core-data-structures/session-query.md) · [SessionEventTraceRequest](../core-data-structures/session-query.md) · [SessionEventWindow](../core-data-structures/session-query.md) · [SessionId](../core-data-structures/core.md) · [SessionLineageTrace](../core-data-structures/session-query.md) · [SessionRecord](../core-data-structures/session-query.md) · [SessionTitleSnapshot](../core-data-structures/session-title.md)
 
-Source: [`packages/session-query/session-query/src/index.ts:38`](../../packages/session-query/session-query/src/index.ts)
+Source: [`packages/session-query/session-query/src/index.ts:40`](../../packages/session-query/session-query/src/index.ts)
 
 ## `ctx.sessions` — `SessionStore`
 
@@ -801,6 +808,28 @@ announce(session: Session): void
  */
 async flush(session: Session): Promise<void>
 
+/**
+ * Append one plugin-declared log-only event without borrowing the agent
+ * loop's lifecycle. An open turn receives the event directly and remains
+ * responsible for its ordinary checkpoint. A closed log receives one
+ * zero-step turn around the event, followed by an awaited flush.
+ *
+ * Once the synthetic `turn/start` commits, this method always attempts its
+ * matching `turn/end` and flush, including when the target append fails.
+ * Detachment requested by an event or flush listener is deferred until that
+ * sequence settles, so publication cannot switch from a live scoped session
+ * to an unobserved bare `Session` halfway through the update.
+ *
+ * @param session - exact live session that owns the target log.
+ * @param type - event type opted into {@link OutOfBandSessionEventMap} by its owner.
+ * @param data - typed JSON payload for the target event.
+ * @param trigger - plugin-owned turn trigger used only when the log is closed.
+ * @returns the accepted target event with its assigned sequence and timestamp.
+ * @throws when the session is detached, another out-of-band append is active,
+ *   event acceptance fails, the synthetic turn cannot close, or flushing fails.
+ */
+async appendOutOfBand<T extends OutOfBandSessionEventType>( session: Session, type: T, data: SessionEventMap[T], trigger: TurnTrigger, ): Promise<SessionEvent<T>>
+
 /**
  * Look up a live session.
  * @param id - the session id to look up.
@@ -830,9 +859,43 @@ list(): Session[]
 fork(source: SessionForkSource, boundary?: number, childSessionId?: SessionId): Session
 ```
 
-Types: [CreateSessionOptions](../core-data-structures/persistence.md) · [Session](../core-data-structures/session.md) · [SessionId](../core-data-structures/core.md)
+Types: [CreateSessionOptions](../core-data-structures/persistence.md) · [OutOfBandSessionEventType](../core-data-structures/session.md) · [Session](../core-data-structures/session.md) · [SessionEvent](../core-data-structures/core.md) · [SessionEventMap](../core-data-structures/session.md) · [SessionId](../core-data-structures/core.md) · [TurnTrigger](../core-data-structures/session.md)
 
-Source: [`packages/core/session/src/index.ts:553`](../../packages/core/session/src/index.ts)
+Source: [`packages/core/session/src/index.ts:554`](../../packages/core/session/src/index.ts)
+
+## `ctx.sessionTitle` — `SessionTitleService`
+
+Log-backed title fold plus asynchronous fallback generation.
+
+```ts cordis-catalog
+/**
+ * Read the latest folded title from one live or replayed session.
+ * @param session - session whose log is the title source of truth.
+ * @returns latest title snapshot, or `undefined` before eligible input.
+ */
+get(session: Session): SessionTitleSnapshot | undefined
+
+/**
+ * Explicitly retry the registered provider, or materialize the built-in
+ * fallback when no provider is registered.
+ * @param session - exact live session to refresh.
+ * @param signal - optional caller cancellation.
+ * @returns latest accepted title, or `undefined` when no eligible text exists.
+ */
+async refresh(session: Session, signal?: AbortSignal): Promise<SessionTitleSnapshot | undefined>
+
+/**
+ * Register the sole optional title provider. Disposal aborts its pending and
+ * active work before another provider may register.
+ * @param provider - provider identity, cadence, and generation function.
+ * @returns exact Cordis effect disposer for HMR-safe unregistration.
+ */
+register(provider: SessionTitleProvider): () => void
+```
+
+Types: [Session](../core-data-structures/session.md) · [SessionTitleProvider](../core-data-structures/session-title.md) · [SessionTitleSnapshot](../core-data-structures/session-title.md)
+
+Source: [`packages/session-title/session-title/src/index.ts:233`](../../packages/session-title/session-title/src/index.ts)
 
 ## `ctx.skills` — `SkillService`