imccyu
ec601ca13d
Machine-produced by `pnpm run rescope-vendor --apply` plus the regeneration it prints: `pnpm install` for the lockfile, `pnpm run gen-third-party-notices`, `verify-translation-pairing --write` for the touched bilingual pairs, `gen-doc-graphs`, and one typert snapshot whose ids embed character offsets. `pnpm run rescope-vendor --check` verifies the result. Renames nine vendored packages (cordis, cosmokit, schemastery and the six @cordisjs plugins) and every reference that resolves them: manifest names and dependency keys, module specifiers including declare-module merges, cordis.yml plugin names, tsconfig paths, every Markdown fence, and `docs/` prose. Directory names, upstream versions, and dependency ranges are unchanged, so vendor/README.md still reads as an upstream snapshot; its manifest table gains an upstream-name column so THIRD_PARTY_NOTICES keeps MIT attribution pointed at each fork's origin. The tutorial tier follows the rename end to end: its yaml fences named plugins the Loader can no longer resolve, its `ts ignore-check` fences disagreed with the compiled fences beside them, and its prose quoted both. The contracts that told readers to keep upstream names — the root convention and the vendoring cookbook's tree comment and manifest invariant — now say to rescope instead. Two rules read `@deepseek-ai/` as "another workspace plugin": the client bundle purity gate now names the vendored libraries a browser bundle inlines, and the files where a bare `cordis` is an agent-preset id keep that product data.
78 lines
3.3 KiB
TypeScript
78 lines
3.3 KiB
TypeScript
/**
|
|
* Client Agent-scope primitive: mint a Cordis context tagged with the owning
|
|
* Agent's identity. The mechanism mirrors the host `dsh-scope` architecture
|
|
* (no-op plugin fiber + context tag + `Context.filter` routing predicate);
|
|
* the shape deliberately diverges: the filter lives on the actx itself
|
|
* instead of a separate carrier object, so scoped dispatch is plain cordis —
|
|
* `actx.bail(actx, event, payload)` / `actx.emit(actx, ...)` — with no
|
|
* wrapper. The host needs a detached carrier because its dispatch subject is
|
|
* the business Agent object; client scope events carry only ids, so the
|
|
* actx is the natural subject. The second divergence stands: the scope key
|
|
* is the branded `SessionId` (value compared), not an object identity — the
|
|
* agent and its session share one id (1:1, same axis; no separate AgentId
|
|
* brand), and a client scope's identity IS that wire id. Third divergence,
|
|
* deliberate: the client scopes the Agent IDENTITY, not a live Agent object
|
|
* — a cold session's host Agent is already disposed while its client actx
|
|
* stays alive for history viewing.
|
|
*/
|
|
import { Context as CordisContext } from '@deepseek-ai/cordis'
|
|
import type { Context, Fiber } from '@deepseek-ai/cordis'
|
|
import type { SessionId } from '@deepseek-ai/dsh-client-connection/client'
|
|
import type { TypeRTClientRemote, TypeRTRemoteScopeApi } from '@deepseek-ai/dsh-type-meta'
|
|
|
|
/** Client Cordis Context carrying one Agent identity and its scoped Remote namespaces. */
|
|
export type AgentContext = Omit<Context, 'remote'> & {
|
|
readonly remote: TypeRTClientRemote & TypeRTRemoteScopeApi<'agent'>
|
|
}
|
|
|
|
/** Context tag written by {@link createScope}. */
|
|
const kScope = Symbol('dsh.client.scope')
|
|
|
|
/** A minted Agent scope and its disposal boundary. */
|
|
export interface AgentScopeHandle {
|
|
/**
|
|
* Tagged context: scope-owned registrations and scoped dispatch both go
|
|
* through it (passing it as the dispatch subject routes to this agent's
|
|
* tagged listeners plus every untagged one).
|
|
*/
|
|
ctx: AgentContext
|
|
/** Backing fiber (dispose tears down every scope-owned registration). */
|
|
fiber: Fiber
|
|
}
|
|
|
|
/** Shared no-op plugin backing each Agent scope fiber. */
|
|
function agentScope(): void {}
|
|
|
|
/**
|
|
* Mint an Agent scope under `ctx`: a no-op plugin fiber whose context
|
|
* carries the agent tag and the dispatch filter — untagged listeners are
|
|
* admitted globally, tagged listeners only for a matching agent.
|
|
* Registrations through the returned ctx dispose with the fiber.
|
|
* @param ctx - client root context the scope fiber mounts under.
|
|
* @param key - owning agent identity (the routing tag; agent id === session id).
|
|
* @returns the tagged context and its backing fiber.
|
|
*/
|
|
export function createScope(ctx: Context, key: SessionId): AgentScopeHandle {
|
|
const fiber = ctx.plugin(agentScope)
|
|
const scoped = fiber.ctx.extend({
|
|
[kScope]: key,
|
|
[CordisContext.filter](listenerCtx: Context): boolean {
|
|
const tag = scopeOf(listenerCtx)
|
|
return tag === undefined || tag === key
|
|
},
|
|
}) as AgentContext
|
|
return {
|
|
fiber,
|
|
ctx: scoped,
|
|
}
|
|
}
|
|
|
|
/**
|
|
* Read the nearest agent tag inherited by a context.
|
|
* @param ctx - any client context.
|
|
* @returns its agent identity (the session id), or undefined for root contexts.
|
|
*/
|
|
export function scopeOf(ctx: Context): SessionId | undefined {
|
|
return (ctx as Context & { [kScope]?: SessionId })[kScope]
|
|
}
|