@openscout/protocol 0.2.60 → 0.2.62

package/dist/index.d.ts

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

package/dist/index.js

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

package/dist/scout-delivery.d.ts

@@ -0,0 +1,47 @@
+import type { ConversationDefinition } from "./conversations.js";
+import type { MetadataMap, ScoutId } from "./common.js";
+import type { FlightRecord, InvocationExecutionPreference } from "./invocations.js";
+import type { MessageRecord } from "./messages.js";
+import type { ScoutDispatchRecord } from "./scout-dispatch.js";
+export type ScoutDeliverIntent = "tell" | "consult";
+export type ScoutDeliverRouteKind = "dm" | "channel" | "broadcast";
+export type ScoutDeliverRejectReason = "unknown_target" | "ambiguous_target" | "invalid_target" | "missing_target";
+export interface ScoutDeliverRequest {
+    id: ScoutId;
+    requesterId: ScoutId;
+    requesterNodeId: ScoutId;
+    body: string;
+    intent: ScoutDeliverIntent;
+    targetLabel?: string;
+    targetAgentId?: ScoutId;
+    channel?: string;
+    replyToMessageId?: ScoutId;
+    speechText?: string;
+    ensureAwake?: boolean;
+    execution?: InvocationExecutionPreference;
+    createdAt: number;
+    collaborationRecordId?: ScoutId;
+    messageMetadata?: MetadataMap;
+    invocationMetadata?: MetadataMap;
+}
+export interface ScoutDeliverAcceptedResponse {
+    kind: "delivery";
+    accepted: true;
+    routeKind: ScoutDeliverRouteKind;
+    conversation: ConversationDefinition;
+    message: MessageRecord;
+    targetAgentId?: ScoutId;
+    flight?: FlightRecord;
+}
+export interface ScoutDeliverQuestionResponse {
+    kind: "question";
+    accepted: false;
+    question: ScoutDispatchRecord;
+}
+export interface ScoutDeliverRejectedResponse {
+    kind: "rejected";
+    accepted: false;
+    reason: ScoutDeliverRejectReason;
+    rejection: ScoutDispatchRecord;
+}
+export type ScoutDeliverResponse = ScoutDeliverAcceptedResponse | ScoutDeliverQuestionResponse | ScoutDeliverRejectedResponse;

package/dist/scout-delivery.js

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

package/dist/scout-dispatch.d.ts

@@ -1,9 +1,12 @@
+import type { WakePolicy } from "./actors.js";
 import type { AdvertiseScope, DeliveryTransport, ScoutId } from "./common.js";
-export type ScoutDispatchKind = "ambiguous" | "unknown" | "unparseable";
+export type ScoutDispatchKind = "ambiguous" | "unknown" | "unparseable" | "unavailable";
 export type ScoutCandidateEndpointState = "online" | "offline" | "unknown";
+export type ScoutDispatchUnavailableReason = "manual_wake_required" | "retired" | "stale_registration" | "unknown";
 export interface ScoutDispatchCandidate {
     agentId: ScoutId;
     displayName: string;
+    label: string;
     authorityNodeId?: ScoutId;
     homeNodeId?: ScoutId;
     advertiseScope?: AdvertiseScope;
@@ -15,11 +18,22 @@ export interface ScoutDispatchCandidate {
     endpointState: ScoutCandidateEndpointState;
     transport?: DeliveryTransport | null;
 }
+export interface ScoutDispatchUnavailableTarget {
+    agentId: ScoutId;
+    displayName: string;
+    reason: ScoutDispatchUnavailableReason;
+    detail: string;
+    wakePolicy?: WakePolicy | null;
+    endpointState: ScoutCandidateEndpointState;
+    transport?: DeliveryTransport | null;
+    projectRoot?: string | null;
+}
 export interface ScoutDispatchEnvelope {
     kind: ScoutDispatchKind;
     askedLabel: string;
     detail: string;
     candidates: ScoutDispatchCandidate[];
+    target?: ScoutDispatchUnavailableTarget;
     dispatchedAt: number;
     dispatcherNodeId: ScoutId;
 }

package/package.json

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

package/src/index.ts

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

package/src/scout-delivery.ts

@@ -0,0 +1,62 @@
+import type { ConversationDefinition } from "./conversations.js";
+import type { MetadataMap, ScoutId } from "./common.js";
+import type { FlightRecord, InvocationExecutionPreference } from "./invocations.js";
+import type { MessageRecord } from "./messages.js";
+import type { ScoutDispatchRecord } from "./scout-dispatch.js";
+
+export type ScoutDeliverIntent = "tell" | "consult";
+
+export type ScoutDeliverRouteKind = "dm" | "channel" | "broadcast";
+
+export type ScoutDeliverRejectReason =
+  | "unknown_target"
+  | "ambiguous_target"
+  | "invalid_target"
+  | "missing_target";
+
+export interface ScoutDeliverRequest {
+  id: ScoutId;
+  requesterId: ScoutId;
+  requesterNodeId: ScoutId;
+  body: string;
+  intent: ScoutDeliverIntent;
+  targetLabel?: string;
+  targetAgentId?: ScoutId;
+  channel?: string;
+  replyToMessageId?: ScoutId;
+  speechText?: string;
+  ensureAwake?: boolean;
+  execution?: InvocationExecutionPreference;
+  createdAt: number;
+  collaborationRecordId?: ScoutId;
+  messageMetadata?: MetadataMap;
+  invocationMetadata?: MetadataMap;
+}
+
+export interface ScoutDeliverAcceptedResponse {
+  kind: "delivery";
+  accepted: true;
+  routeKind: ScoutDeliverRouteKind;
+  conversation: ConversationDefinition;
+  message: MessageRecord;
+  targetAgentId?: ScoutId;
+  flight?: FlightRecord;
+}
+
+export interface ScoutDeliverQuestionResponse {
+  kind: "question";
+  accepted: false;
+  question: ScoutDispatchRecord;
+}
+
+export interface ScoutDeliverRejectedResponse {
+  kind: "rejected";
+  accepted: false;
+  reason: ScoutDeliverRejectReason;
+  rejection: ScoutDispatchRecord;
+}
+
+export type ScoutDeliverResponse =
+  | ScoutDeliverAcceptedResponse
+  | ScoutDeliverQuestionResponse
+  | ScoutDeliverRejectedResponse;

package/src/scout-dispatch.ts

@@ -1,12 +1,20 @@
+import type { WakePolicy } from "./actors.js";
 import type { AdvertiseScope, DeliveryTransport, ScoutId } from "./common.js";
 
-export type ScoutDispatchKind = "ambiguous" | "unknown" | "unparseable";
+export type ScoutDispatchKind = "ambiguous" | "unknown" | "unparseable" | "unavailable";
 
 export type ScoutCandidateEndpointState = "online" | "offline" | "unknown";
 
+export type ScoutDispatchUnavailableReason =
+  | "manual_wake_required"
+  | "retired"
+  | "stale_registration"
+  | "unknown";
+
 export interface ScoutDispatchCandidate {
   agentId: ScoutId;
   displayName: string;
+  label: string;
   authorityNodeId?: ScoutId;
   homeNodeId?: ScoutId;
   advertiseScope?: AdvertiseScope;
@@ -19,11 +27,23 @@ export interface ScoutDispatchCandidate {
   transport?: DeliveryTransport | null;
 }
 
+export interface ScoutDispatchUnavailableTarget {
+  agentId: ScoutId;
+  displayName: string;
+  reason: ScoutDispatchUnavailableReason;
+  detail: string;
+  wakePolicy?: WakePolicy | null;
+  endpointState: ScoutCandidateEndpointState;
+  transport?: DeliveryTransport | null;
+  projectRoot?: string | null;
+}
+
 export interface ScoutDispatchEnvelope {
   kind: ScoutDispatchKind;
   askedLabel: string;
   detail: string;
   candidates: ScoutDispatchCandidate[];
+  target?: ScoutDispatchUnavailableTarget;
   dispatchedAt: number;
   dispatcherNodeId: ScoutId;
 }