@openscout/protocol 0.2.63 → 0.2.64

package/dist/index.d.ts

@@ -12,6 +12,7 @@ export * from "./messages.js";
 export * from "./invocations.js";
 export * from "./scout-dispatch.js";
 export * from "./scout-delivery.js";
+export * from "./scout-reply-context.js";
 export * from "./deliveries.js";
 export * from "./transports.js";
 export * from "./events.js";

package/dist/index.js

@@ -12,6 +12,7 @@ export * from "./messages.js";
 export * from "./invocations.js";
 export * from "./scout-dispatch.js";
 export * from "./scout-delivery.js";
+export * from "./scout-reply-context.js";
 export * from "./deliveries.js";
 export * from "./transports.js";
 export * from "./events.js";

package/dist/invocations.d.ts

@@ -4,6 +4,12 @@ export type InvocationAction = "consult" | "execute" | "summarize" | "status" |
 export type FlightState = "queued" | "waking" | "running" | "waiting" | "completed" | "failed" | "cancelled";
 export interface InvocationExecutionPreference {
     harness?: AgentHarness;
+    /**
+     * Controls whether a handoff should enter fresh model context or continue an
+     * already-running session. Broker-owned label delivery should default to
+     * "new" so stable agent names do not silently inherit unrelated context.
+     */
+    session?: "new" | "existing" | "any";
 }
 export interface InvocationRequest {
     id: ScoutId;

package/dist/scout-delivery.d.ts

@@ -5,7 +5,7 @@ import type { MessageRecord } from "./messages.js";
 import type { ScoutCallerContext, ScoutDispatchRecord, ScoutRoutePolicy, ScoutRouteTarget } from "./scout-dispatch.js";
 export type ScoutDeliverIntent = "tell" | "consult";
 export type ScoutDeliverRouteKind = "dm" | "channel" | "broadcast";
-export type ScoutDeliveryRemediationKind = "choose_target" | "register_target" | "wake_target" | "retry_later";
+export type ScoutDeliveryRemediationKind = "choose_target" | "register_target" | "wake_target" | "retry_later" | "stale_reference";
 export type ScoutDeliverRejectReason = "unknown_target" | "ambiguous_target" | "invalid_target" | "missing_target";
 export interface ScoutDeliverRequest {
     id?: ScoutId;
@@ -35,6 +35,7 @@ export interface ScoutDeliveryReceipt {
     requesterNodeId: ScoutId;
     targetAgentId?: ScoutId;
     targetLabel?: string;
+    bindingRef?: string;
     conversationId: ScoutId;
     messageId: ScoutId;
     flightId?: ScoutId;
@@ -55,6 +56,7 @@ export interface ScoutDeliverAcceptedResponse {
     conversation: ConversationDefinition;
     message: MessageRecord;
     targetAgentId?: ScoutId;
+    bindingRef?: string;
     flight?: FlightRecord;
 }
 export interface ScoutDeliverQuestionResponse {

package/dist/scout-dispatch.d.ts

@@ -2,7 +2,7 @@ import type { WakePolicy } from "./actors.js";
 import type { AdvertiseScope, DeliveryTransport, MetadataMap, ScoutId } from "./common.js";
 export type ScoutDispatchKind = "ambiguous" | "unknown" | "unparseable" | "unavailable";
 export type ScoutCandidateEndpointState = "online" | "offline" | "unknown";
-export type ScoutRouteTargetKind = "agent_id" | "agent_label" | "channel" | "broadcast";
+export type ScoutRouteTargetKind = "agent_id" | "agent_label" | "binding_ref" | "channel" | "broadcast";
 export type ScoutRouteAmbiguousPolicy = "reject" | "ask";
 export interface ScoutCallerContext {
     actorId?: ScoutId;
@@ -20,6 +20,10 @@ export type ScoutRouteTarget = {
     kind: "agent_label";
     label: string;
     value?: string;
+} | {
+    kind: "binding_ref";
+    ref: string;
+    value?: string;
 } | {
     kind: "channel";
     channel: string;

package/dist/scout-reply-context.d.ts

@@ -0,0 +1,13 @@
+import type { ScoutId } from "./common.js";
+import type { InvocationAction } from "./invocations.js";
+export type ScoutReplyPath = "final_response" | "mcp_reply";
+export interface ScoutReplyContext {
+    mode: "broker_reply";
+    fromAgentId: ScoutId;
+    toAgentId: ScoutId;
+    conversationId: ScoutId;
+    messageId: ScoutId;
+    replyToMessageId: ScoutId;
+    replyPath: ScoutReplyPath;
+    action?: InvocationAction;
+}

package/dist/scout-reply-context.js

@@ -0,0 +1 @@
+export {};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@openscout/protocol",
-  "version": "0.2.63",
+  "version": "0.2.64",
   "description": "Typed protocol for the OpenScout local control plane",
   "type": "module",
   "exports": {

package/src/index.ts

@@ -12,6 +12,7 @@ export * from "./messages.js";
 export * from "./invocations.js";
 export * from "./scout-dispatch.js";
 export * from "./scout-delivery.js";
+export * from "./scout-reply-context.js";
 export * from "./deliveries.js";
 export * from "./transports.js";
 export * from "./events.js";

package/src/invocations.ts

@@ -19,6 +19,12 @@ export type FlightState =
 
 export interface InvocationExecutionPreference {
   harness?: AgentHarness;
+  /**
+   * Controls whether a handoff should enter fresh model context or continue an
+   * already-running session. Broker-owned label delivery should default to
+   * "new" so stable agent names do not silently inherit unrelated context.
+   */
+  session?: "new" | "existing" | "any";
 }
 
 export interface InvocationRequest {

package/src/scout-delivery.ts

@@ -17,7 +17,8 @@ export type ScoutDeliveryRemediationKind =
   | "choose_target"
   | "register_target"
   | "wake_target"
-  | "retry_later";
+  | "retry_later"
+  | "stale_reference";
 
 export type ScoutDeliverRejectReason =
   | "unknown_target"
@@ -54,6 +55,7 @@ export interface ScoutDeliveryReceipt {
   requesterNodeId: ScoutId;
   targetAgentId?: ScoutId;
   targetLabel?: string;
+  bindingRef?: string;
   conversationId: ScoutId;
   messageId: ScoutId;
   flightId?: ScoutId;
@@ -76,6 +78,7 @@ export interface ScoutDeliverAcceptedResponse {
   conversation: ConversationDefinition;
   message: MessageRecord;
   targetAgentId?: ScoutId;
+  bindingRef?: string;
   flight?: FlightRecord;
 }
 

package/src/scout-dispatch.ts

@@ -5,7 +5,7 @@ export type ScoutDispatchKind = "ambiguous" | "unknown" | "unparseable" | "unava
 
 export type ScoutCandidateEndpointState = "online" | "offline" | "unknown";
 
-export type ScoutRouteTargetKind = "agent_id" | "agent_label" | "channel" | "broadcast";
+export type ScoutRouteTargetKind = "agent_id" | "agent_label" | "binding_ref" | "channel" | "broadcast";
 
 export type ScoutRouteAmbiguousPolicy = "reject" | "ask";
 
@@ -21,6 +21,7 @@ export interface ScoutCallerContext {
 export type ScoutRouteTarget =
   | { kind: "agent_id"; agentId: ScoutId; value?: string }
   | { kind: "agent_label"; label: string; value?: string }
+  | { kind: "binding_ref"; ref: string; value?: string }
   | { kind: "channel"; channel: string; value?: string }
   | { kind: "broadcast"; value?: string };
 

package/src/scout-reply-context.ts

@@ -0,0 +1,15 @@
+import type { ScoutId } from "./common.js";
+import type { InvocationAction } from "./invocations.js";
+
+export type ScoutReplyPath = "final_response" | "mcp_reply";
+
+export interface ScoutReplyContext {
+  mode: "broker_reply";
+  fromAgentId: ScoutId;
+  toAgentId: ScoutId;
+  conversationId: ScoutId;
+  messageId: ScoutId;
+  replyToMessageId: ScoutId;
+  replyPath: ScoutReplyPath;
+  action?: InvocationAction;
+}