@datalayer/agent-runtimes 1.5.50 → 1.5.51

package/lib/portable/hosts/agentClient.d.ts

@@ -36,6 +36,15 @@ export interface AgentClient<P> {
     startTurn(request: HostTurnRequest<P>): Promise<TurnStream>;
     stopTurn(sessionId: string, request: HostTurnRequest<P>): Promise<void>;
 }
+/**
+ * Maps a session to its host place again, once the place changed after the
+ * turn started (plans/DISCORD.md §3.2: Discord's answer thread exists only
+ * once the answer is shown, so the target is PUT again with it).
+ */
+export interface SessionBinder<P> {
+    /** Whether the session was mapped: `false` where nothing binds (development's credentials). */
+    bindSession(sessionId: string, request: HostTurnRequest<P>): Promise<boolean>;
+}
 /** Where a host asks from (`exchange.optional_request.place`): a channel, or a direct conversation. */
 export type Place = Readonly<{
     kind: 'channel' | 'direct';
@@ -160,7 +169,7 @@ export declare function agUiEventsOf(body: ReadableStream<Uint8Array>): AsyncIte
  * stream reduced to semantic events, and its session mapped to the host's
  * thread so that approvals and completions are delivered (§4.3, 3).
  */
-export declare class HttpAgentClient<P> implements AgentClient<P> {
+export declare class HttpAgentClient<P> implements AgentClient<P>, SessionBinder<P> {
     #private;
     readonly apiUrl: string;
     readonly credentials: HostCredentials<P>;
@@ -169,6 +178,11 @@ export declare class HttpAgentClient<P> implements AgentClient<P> {
     readonly hostKeyFor?: HostKeyLookup<P> | undefined;
     constructor(apiUrl: string, credentials: HostCredentials<P>, shape: HostShape<P>, fetchImplementation?: typeof fetch, hostKeyFor?: HostKeyLookup<P> | undefined);
     startTurn(request: HostTurnRequest<P>): Promise<TurnStream>;
+    /**
+     * The session mapped again with the shape's target for `request`, as the
+     * speaker (a fresh exchange): the binding is replaced, never doubled.
+     */
+    bindSession(sessionId: string, request: HostTurnRequest<P>): Promise<boolean>;
     stopTurn(sessionId: string, request: HostTurnRequest<P>): Promise<void>;
 }
 /**

package/lib/portable/hosts/agentClient.js

@@ -266,6 +266,20 @@ export class HttpAgentClient {
             updates: this.#updates(response.body, host, sessionId, run),
         };
     }
+    /**
+     * The session mapped again with the shape's target for `request`, as the
+     * speaker (a fresh exchange): the binding is replaced, never doubled.
+     */
+    async bindSession(sessionId, request) {
+        const host = await this.credentials.forTurn(request);
+        const hostKey = host.bindable && this.hostKeyFor
+            ? await this.hostKeyFor(request)
+            : undefined;
+        if (!hostKey)
+            return false;
+        await this.#bind(request, host, sessionId, hostKey);
+        return true;
+    }
     async stopTurn(sessionId, request) {
         const host = await this.credentials.forTurn(request);
         assertTrustedStreamUrl(this.apiUrl, host.sessionApiUrl);

package/lib/portable/hosts/index.d.ts

@@ -22,7 +22,7 @@ export * from '../semantic';
 export { askQuestionOf, semanticOf, turnOf, type TurnInfo, } from '../semanticOfAgUi';
 export * from './contracts';
 export { DatalayerHostClient, HostRefusedError, type BoundHost, type HostSelf, } from './client';
-export { agUiEventsOf, assertTrustedStreamUrl, DevelopmentCredentials, HostKeyCredentials, hostSessionOf, HostStarters, HttpAgentClient, InstallationCredentials, lastAnswer, type AgentClient, type HostCredentials, type HostKeyLookup, type HostSession, type HostShape, type HostTurnRequest, type Place, type Starter, type StarterSource, type TurnProvenance, type TurnStream, } from './agentClient';
+export { agUiEventsOf, assertTrustedStreamUrl, DevelopmentCredentials, HostKeyCredentials, hostSessionOf, HostStarters, HttpAgentClient, InstallationCredentials, lastAnswer, type AgentClient, type HostCredentials, type HostKeyLookup, type HostSession, type HostShape, type HostTurnRequest, type Place, type SessionBinder, type Starter, type StarterSource, type TurnProvenance, type TurnStream, } from './agentClient';
 export { hostSessionUid } from './sessionUid';
 export { DATALAYER_ONLY, MAIL_WORDS, RENDERERS, renderApproval, type RenderedAction, type RenderedField, } from './approvalRenderers';
 export { DELIVERY_PATH, DELIVERY_ROUTE, DeliveryPoller, deliveryRoute, receiveDelivery, type BoundHostKey, type DeliveryClaimStore, type DeliveryJob, type DeliverySink, } from './deliveries';

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@datalayer/agent-runtimes",
-    "version": "1.5.50",
+    "version": "1.5.51",
     "type": "module",
     "workspaces": [
         ".",