@deepseek-ai/dsh-typert-protocol 0.1.3-alpha.2 → 0.1.5-alpha.2

package/README.i18n.yaml

@@ -2,5 +2,5 @@
 # side as of the last confirmed-consistent state. Both languages carry equal authority;
 # after editing either side, bring the other along and re-record with:
 #   pnpm run verify-translation-pairing --write packages/typert/protocol/README.md
-README.md: ae18b92c162992eef5f860471e5e45543d8d2c88
-README.zh.md: 08f2146a269581cb8905c19488db8e37127399e4
+README.md: 43147c2c2f1746ff0c806c0842b5dba65457775a
+README.zh.md: 0633db1a9e95d9abda8131fec0f1cf659c484910

package/README.md

@@ -46,7 +46,7 @@ Generation turns the method into a wire endpoint under the service's namespace;
 
 ### Associating Host objects and Contexts with wire identities
 
-Complex Host objects cannot cross the wire directly. A business package declares the association through the merge-extensible `TypertLookupMap` and `TypertContextMap`. Host and Client Context adapters both map `Context` to a wire identity and that identity back to `Context`; the Host adapter also owns the stable wire declaration. Host composition may override its synchronous or asynchronous resolver. A resolver that refuses on policy grounds throws `RemoteError` with its own code, which reaches the caller unchanged.
+Complex Host objects cannot cross the wire directly. A business package declares the association through the merge-extensible `TypertLookupMap` and `TypertContextMap`. A Host Context adapter owns the stable wire declaration and resolves wire identities to live Contexts. A Client Context adapter maps in both directions because scoped calls originate from a Client Context and forwarded Host events resolve their explicit wire identity there. Host composition may override its synchronous or asynchronous resolver. A resolver that refuses on policy grounds throws `RemoteError` with its own code, which reaches the caller unchanged.
 
 ### Reporting and reading a Remote failure
 

package/README.zh.md

@@ -46,7 +46,7 @@ export class GoalService extends TypertRemoteService {
 
 ### 把 Host 对象与 Context 关联到 wire identity
 
-复杂的 Host 对象不能直接跨 wire 传输。业务包通过可合并扩展的 `TypertLookupMap` 与 `TypertContextMap` 声明关联。Host 与 Client Context adapter 都把 `Context` 映射为 wire identity，也把该 identity 映射回 `Context`；Host adapter 还拥有稳定 wire 声明。Host 组合可以覆盖其同步或异步 resolver。因策略而拒绝的 resolver 抛出带自有码的 `RemoteError`，该码原样到达调用方。
+复杂的 Host 对象不能直接跨 wire 传输。业务包通过可合并扩展的 `TypertLookupMap` 与 `TypertContextMap` 声明关联。Host Context adapter 拥有稳定 wire 声明，并把 wire identity 解析为活跃 Context。Client Context adapter 需要双向映射，因为作用域调用从 Client Context 发起，而转发的 Host 事件要在 Client 侧解析其显式 wire identity。Host 组合可以覆盖其同步或异步 resolver。因策略而拒绝的 resolver 抛出带自有码的 `RemoteError`，该码原样到达调用方。
 
 ### 报告与读取 Remote 失败
 

package/lib/types/index.d.ts

@@ -13,7 +13,7 @@ export { RemoteError, remoteErrorOf } from './remote-error.ts';
  * @returns whether the value can cross the shared RPC carrier unchanged.
  */
 export declare function isTypertRemoteSegment(value: string): boolean;
-export type { InvocationDescriptor, InvocationParameterDescriptor, InvocationSourceLocation, RemoteErrorCode, RemoteErrorDetailsMap, RemoteFailure, RemoteResult, TypertClientEventListener, TypertClientRemote, TypertClientContextAdapter, TypertCodec, TypertContext, TypertContextAdapter, TypertContextMap, TypertContextRegistry, TypertContextWire, TypertDisposer, TypertForwardableEvent, TypertForwardableEventEntry, TypertHostContextAdapter, TypertHostContextIdentity, TypertHostContextResolver, TypertLocalRegistry, TypertLookup, TypertLookupDefinition, TypertLookupHost, TypertLookupMap, TypertLookupProvider, TypertLookupResolver, TypertLookupRegistry, TypertLookupWire, TypertRemoteScopeApi, TypertRemoteScopeMap, TypertRemoteScopeNamespace, TypertRemoteContribution, TypertRemoteEvent, TypertRemoteEventSelection, TypertRemoteMap, TypertRemoteNamespace, TypertRemoteNamespaceMap, TypertRemoteRegistry, TypertRegistryChange, TypertRegistryListener, TypertSchema, TypertRegistryContract, } from './types.ts';
+export type { InvocationDescriptor, InvocationParameterDescriptor, InvocationSourceLocation, RemoteErrorCode, RemoteErrorDetailsMap, RemoteFailure, RemoteResult, TypertClientEventListener, TypertClientRemote, TypertClientContextAdapter, TypertCodec, TypertContext, TypertContextMap, TypertContextRegistry, TypertContextWire, TypertDisposer, TypertForwardableEvent, TypertForwardableEventEntry, TypertHostContextAdapter, TypertHostContextResolver, TypertLocalRegistry, TypertLookup, TypertLookupDefinition, TypertLookupHost, TypertLookupMap, TypertLookupProvider, TypertLookupResolver, TypertLookupRegistry, TypertLookupWire, TypertRemoteScopeApi, TypertRemoteScopeMap, TypertRemoteScopeNamespace, TypertRemoteContribution, TypertRemoteEvent, TypertRemoteEventSelection, TypertRemoteMap, TypertRemoteNamespace, TypertRemoteNamespaceMap, TypertRemoteRegistry, TypertRegistryChange, TypertRegistryListener, TypertSchema, TypertRegistryContract, } from './types.ts';
 /** Options for an explicit Service-to-Gateway binding. */
 export interface TypertGatewayBindingOptions {
     /** Wire namespace; defaults to the Cordis service key. */

package/lib/types/types.d.ts

@@ -281,29 +281,19 @@ export interface TypertLookupDefinition {
     /** Canonical wire type symbol used by strict generation. */
     readonly wireTypeSymbol: string;
 }
-/** Bidirectional projection between one environment's Context and its wire identity. */
-export interface TypertContextAdapter<Wire = unknown> {
-    /**
-     * Read the identity represented by a live Context.
-     * @param ctx - Context in this adapter's environment.
-     * @returns the wire identity, or `undefined` when the Context has another kind.
-     */
-    identity(ctx: Context): Wire | undefined;
+/** Host wire-to-Context resolver plus the declaration used by strict Remote methods. */
+export interface TypertHostContextAdapter<Wire = unknown> {
+    /** Wire field carrying the Context identity. */
+    readonly wire: string;
+    /** Canonical wire type symbol used by strict generation. */
+    readonly wireTypeSymbol: string;
     /**
-     * Resolve a wire identity to a live Context in this adapter's environment.
-     * An asynchronous Client resolver may wait for its owner to create the Context.
+     * Resolve a validated wire identity to a live Host Context.
      * @param id - validated wire identity.
      * @returns the Context, or `undefined` when it is unavailable.
      */
     resolve(id: Wire): Context | undefined | Promise<Context | undefined>;
 }
-/** Host Context adapter plus the wire declaration used by strict Remote methods. */
-export interface TypertHostContextAdapter<Wire = unknown> extends TypertContextAdapter<Wire> {
-    /** Wire field carrying the Context identity. */
-    readonly wire: string;
-    /** Canonical wire type symbol used by strict generation. */
-    readonly wireTypeSymbol: string;
-}
 /** Composition-owned resolver replacing one Host Context adapter's default lookup policy. */
 export type TypertHostContextResolver<Wire = unknown> = (id: Wire) => Context | undefined | Promise<Context | undefined>;
 /** Client-side bidirectional Context adapter. */
@@ -321,13 +311,6 @@ export interface TypertClientContextAdapter<Wire = unknown> {
      */
     resolve(id: Wire): Context | undefined;
 }
-/** Host Context identity selected from the registered adapter set. */
-export interface TypertHostContextIdentity {
-    /** Merge-declared Context kind whose adapter recognized the Context. */
-    readonly kind: string;
-    /** Wire identity returned by that adapter. */
-    readonly identity: unknown;
-}
 /** Notification emitted after a Typert runtime registry changes. */
 export interface TypertRegistryChange {
     readonly kind: 'local' | 'remote' | 'lookup' | 'host-context' | 'client-context';
@@ -420,7 +403,7 @@ export interface TypertContextRegistry {
     /**
      * Register a Host Context adapter.
      * @param key - merge-declared Context key.
-     * @param adapter - owning package's bidirectional Host projection.
+     * @param adapter - owning package's Host resolver and wire declaration.
      * @returns disposer withdrawing the exact adapter.
      */
     registerHost<K extends StringKeyOf<TypertContextMap>>(key: K, adapter: TypertHostContextAdapter<TypertContextWire<TypertContextMap[K]>>): TypertDisposer;
@@ -439,13 +422,6 @@ export interface TypertContextRegistry {
      * @returns disposer withdrawing the exact adapter.
      */
     registerClient<K extends StringKeyOf<TypertContextMap>>(key: K, adapter: TypertClientContextAdapter<TypertContextWire<TypertContextMap[K]>>): TypertDisposer;
-    /**
-     * Identify a live Host Context through the sole registered adapter set.
-     * @param ctx - Context projected by a Host-to-Client scoped event.
-     * @returns its kind and wire identity, or `undefined` when no adapter recognizes it.
-     * @throws when more than one Context kind recognizes the same Context.
-     */
-    identifyHost(ctx: Context): TypertHostContextIdentity | undefined;
     /**
      * Look up a Host Context adapter.
      * @param key - descriptor Context key.

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@deepseek-ai/dsh-typert-protocol",
   "description": "Compiler-independent Remote metadata and Typert provider protocols",
-  "version": "0.1.3-alpha.2",
+  "version": "0.1.5-alpha.2",
   "publishConfig": {
     "access": "public"
   },