@masons/agent-network 0.6.15 → 0.6.16

package/dist/_vendor/runtime-adapter-client/send-admission.d.ts

@@ -0,0 +1,89 @@
+import type { RuntimeWorkTargetRef } from "./types.js";
+export declare const SEND_ADMISSION_DECISIONS: readonly ["admit", "hold", "reject", "unknown"];
+export type SendAdmissionDecision = (typeof SEND_ADMISSION_DECISIONS)[number];
+export declare const SEND_ADMISSION_REASON_CODES: readonly ["admitted", "relationship_not_sendable", "policy_denied", "session_selection_required", "continuation_session_unavailable", "target_endpoint_unavailable", "missing_runtime_session_id", "runtime_work_target_unavailable", "capability_missing", "assignment_in_progress", "runtime_busy", "composer_read_only", "queued_recoverable", "setup_control_only", "message_loop_unproven", "receivability_unknown"];
+export type SendAdmissionReasonCode = (typeof SEND_ADMISSION_REASON_CODES)[number];
+export declare const SEND_ADMISSION_USER_ACTIONS: readonly ["none", "select_runtime_session", "wait", "refresh", "retry", "use_ordinary_node_conversation", "contact_owner_or_admin"];
+export type SendAdmissionUserAction = (typeof SEND_ADMISSION_USER_ACTIONS)[number];
+export type SendAdmissionActorKind = "owner" | "runtime_adapter" | "remote_node" | "system";
+export type SendAdmissionMessageContextKind = "remote_first_contact" | "remote_continuation" | "runtime_mailbox_dispatch" | "owner_directed_runtime_session" | "runtime_adapter_claim";
+export interface SendAdmissionRequest {
+    actor: {
+        kind: SendAdmissionActorKind;
+        principal_id?: string;
+        node_id?: string;
+    };
+    recipient: {
+        node_id: string;
+    };
+    caller_hints?: {
+        runtime_session_id?: string;
+        endpoint_id?: string;
+        runtime_work_target_ref?: RuntimeWorkTargetRef;
+        selected_by_owner?: boolean;
+    };
+    message_context: {
+        kind: SendAdmissionMessageContextKind;
+        source_message_id?: string;
+        origin_scid?: string;
+        origin_ncid?: string;
+        owner_session_message_id?: string;
+    };
+}
+export interface SendAdmissionReceiverPath {
+    kind: "runtime_pull" | "adapter_managed_turn" | "owner_session_delivery";
+    target_ref?: RuntimeWorkTargetRef;
+    runtime_session_identity_key?: string;
+    endpoint_id?: string;
+}
+export type SendAdmissionSourceFact = string | ({
+    kind: string;
+} & Record<string, unknown>);
+export interface SendAdmissionResponse {
+    decision: SendAdmissionDecision;
+    business_receivable_now: boolean;
+    reason_code: SendAdmissionReasonCode;
+    receiver_path?: SendAdmissionReceiverPath;
+    retryable: boolean;
+    user_action: SendAdmissionUserAction;
+    source_facts: SendAdmissionSourceFact[];
+}
+export declare const SEND_ADMISSION_FIXTURES: {
+    readonly admittedAdapterManagedTurn: {
+        readonly decision: "admit";
+        readonly business_receivable_now: true;
+        readonly reason_code: "admitted";
+        readonly receiver_path: {
+            readonly kind: "adapter_managed_turn";
+            readonly target_ref: {
+                readonly kind: "projection_endpoint";
+                readonly projection_endpoint_id: "ep1_codex";
+                readonly runtime_session_id: "thread_123";
+                readonly background_exchange_mode: "adapter_managed_turn";
+            };
+            readonly runtime_session_identity_key: "agent_1:codex:owner_1:a665a45920422f9d417e4867efdc4fb8";
+            readonly endpoint_id: "ep1_codex";
+        };
+        readonly retryable: false;
+        readonly user_action: "none";
+        readonly source_facts: ["services_derived_runtime_work_target"];
+    };
+    readonly holdSessionSelectionRequired: {
+        readonly decision: "hold";
+        readonly business_receivable_now: false;
+        readonly reason_code: "session_selection_required";
+        readonly retryable: true;
+        readonly user_action: "select_runtime_session";
+        readonly source_facts: ["multi_session_runtime_without_selected_session"];
+    };
+    readonly rejectSetupControlOnly: {
+        readonly decision: "reject";
+        readonly business_receivable_now: false;
+        readonly reason_code: "setup_control_only";
+        readonly retryable: false;
+        readonly user_action: "contact_owner_or_admin";
+        readonly source_facts: ["setup_reachable_without_business_receiver_path"];
+    };
+};
+export declare function parseSendAdmissionResponse(value: unknown): SendAdmissionResponse | null;
+//# sourceMappingURL=send-admission.d.ts.map

package/dist/_vendor/runtime-adapter-client/send-admission.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"send-admission.d.ts","sourceRoot":"","sources":["../../../src/_vendor/runtime-adapter-client/send-admission.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AAGvD,eAAO,MAAM,wBAAwB,iDAK3B,CAAC;AAEX,MAAM,MAAM,qBAAqB,GAAG,CAAC,OAAO,wBAAwB,CAAC,CAAC,MAAM,CAAC,CAAC;AAE9E,eAAO,MAAM,2BAA2B,2ZAiB9B,CAAC;AAEX,MAAM,MAAM,uBAAuB,GACjC,CAAC,OAAO,2BAA2B,CAAC,CAAC,MAAM,CAAC,CAAC;AAE/C,eAAO,MAAM,2BAA2B,qIAQ9B,CAAC;AAEX,MAAM,MAAM,uBAAuB,GACjC,CAAC,OAAO,2BAA2B,CAAC,CAAC,MAAM,CAAC,CAAC;AAE/C,MAAM,MAAM,sBAAsB,GAC9B,OAAO,GACP,iBAAiB,GACjB,aAAa,GACb,QAAQ,CAAC;AAEb,MAAM,MAAM,+BAA+B,GACvC,sBAAsB,GACtB,qBAAqB,GACrB,0BAA0B,GAC1B,gCAAgC,GAChC,uBAAuB,CAAC;AAE5B,MAAM,WAAW,oBAAoB;IACnC,KAAK,EAAE;QACL,IAAI,EAAE,sBAAsB,CAAC;QAC7B,YAAY,CAAC,EAAE,MAAM,CAAC;QACtB,OAAO,CAAC,EAAE,MAAM,CAAC;KAClB,CAAC;IACF,SAAS,EAAE;QACT,OAAO,EAAE,MAAM,CAAC;KACjB,CAAC;IACF,YAAY,CAAC,EAAE;QACb,kBAAkB,CAAC,EAAE,MAAM,CAAC;QAC5B,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,uBAAuB,CAAC,EAAE,oBAAoB,CAAC;QAC/C,iBAAiB,CAAC,EAAE,OAAO,CAAC;KAC7B,CAAC;IACF,eAAe,EAAE;QACf,IAAI,EAAE,+BAA+B,CAAC;QACtC,iBAAiB,CAAC,EAAE,MAAM,CAAC;QAC3B,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,wBAAwB,CAAC,EAAE,MAAM,CAAC;KACnC,CAAC;CACH;AAED,MAAM,WAAW,yBAAyB;IACxC,IAAI,EAAE,cAAc,GAAG,sBAAsB,GAAG,wBAAwB,CAAC;IACzE,UAAU,CAAC,EAAE,oBAAoB,CAAC;IAClC,4BAA4B,CAAC,EAAE,MAAM,CAAC;IACtC,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,MAAM,uBAAuB,GAC/B,MAAM,GACN,CAAC;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;AAEjD,MAAM,WAAW,qBAAqB;IACpC,QAAQ,EAAE,qBAAqB,CAAC;IAChC,uBAAuB,EAAE,OAAO,CAAC;IACjC,WAAW,EAAE,uBAAuB,CAAC;IACrC,aAAa,CAAC,EAAE,yBAAyB,CAAC;IAC1C,SAAS,EAAE,OAAO,CAAC;IACnB,WAAW,EAAE,uBAAuB,CAAC;IACrC,YAAY,EAAE,uBAAuB,EAAE,CAAC;CACzC;AAED,eAAO,MAAM,uBAAuB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAqCsB,CAAC;AAE3D,wBAAgB,0BAA0B,CACxC,KAAK,EAAE,OAAO,GACb,qBAAqB,GAAG,IAAI,CAiD9B"}

package/dist/_vendor/runtime-adapter-client/send-admission.js

@@ -0,0 +1,169 @@
+import { parseRuntimeWorkTargetRef } from "./work-target.js";
+export const SEND_ADMISSION_DECISIONS = [
+    "admit",
+    "hold",
+    "reject",
+    "unknown",
+];
+export const SEND_ADMISSION_REASON_CODES = [
+    "admitted",
+    "relationship_not_sendable",
+    "policy_denied",
+    "session_selection_required",
+    "continuation_session_unavailable",
+    "target_endpoint_unavailable",
+    "missing_runtime_session_id",
+    "runtime_work_target_unavailable",
+    "capability_missing",
+    "assignment_in_progress",
+    "runtime_busy",
+    "composer_read_only",
+    "queued_recoverable",
+    "setup_control_only",
+    "message_loop_unproven",
+    "receivability_unknown",
+];
+export const SEND_ADMISSION_USER_ACTIONS = [
+    "none",
+    "select_runtime_session",
+    "wait",
+    "refresh",
+    "retry",
+    "use_ordinary_node_conversation",
+    "contact_owner_or_admin",
+];
+export const SEND_ADMISSION_FIXTURES = {
+    admittedAdapterManagedTurn: {
+        decision: "admit",
+        business_receivable_now: true,
+        reason_code: "admitted",
+        receiver_path: {
+            kind: "adapter_managed_turn",
+            target_ref: {
+                kind: "projection_endpoint",
+                projection_endpoint_id: "ep1_codex",
+                runtime_session_id: "thread_123",
+                background_exchange_mode: "adapter_managed_turn",
+            },
+            runtime_session_identity_key: "agent_1:codex:owner_1:a665a45920422f9d417e4867efdc4fb8",
+            endpoint_id: "ep1_codex",
+        },
+        retryable: false,
+        user_action: "none",
+        source_facts: ["services_derived_runtime_work_target"],
+    },
+    holdSessionSelectionRequired: {
+        decision: "hold",
+        business_receivable_now: false,
+        reason_code: "session_selection_required",
+        retryable: true,
+        user_action: "select_runtime_session",
+        source_facts: ["multi_session_runtime_without_selected_session"],
+    },
+    rejectSetupControlOnly: {
+        decision: "reject",
+        business_receivable_now: false,
+        reason_code: "setup_control_only",
+        retryable: false,
+        user_action: "contact_owner_or_admin",
+        source_facts: ["setup_reachable_without_business_receiver_path"],
+    },
+};
+export function parseSendAdmissionResponse(value) {
+    if (!isRecord(value))
+        return null;
+    if (!includesLiteral(SEND_ADMISSION_DECISIONS, value.decision) ||
+        typeof value.business_receivable_now !== "boolean" ||
+        !includesLiteral(SEND_ADMISSION_REASON_CODES, value.reason_code) ||
+        typeof value.retryable !== "boolean" ||
+        !includesLiteral(SEND_ADMISSION_USER_ACTIONS, value.user_action) ||
+        !Array.isArray(value.source_facts)) {
+        return null;
+    }
+    const receiverPath = parseReceiverPath(value.receiver_path);
+    if (value.receiver_path !== undefined && receiverPath === null)
+        return null;
+    if (value.business_receivable_now &&
+        (value.decision !== "admit" || receiverPath === undefined)) {
+        return null;
+    }
+    if (value.decision === "admit" &&
+        (!value.business_receivable_now || receiverPath === undefined)) {
+        return null;
+    }
+    if (value.decision !== "admit" &&
+        (value.business_receivable_now || receiverPath !== undefined)) {
+        return null;
+    }
+    const admittedReceiverPath = receiverPath === null ? undefined : receiverPath;
+    const sourceFacts = parseSourceFacts(value.source_facts);
+    if (!sourceFacts)
+        return null;
+    return {
+        decision: value.decision,
+        business_receivable_now: value.business_receivable_now,
+        reason_code: value.reason_code,
+        ...(admittedReceiverPath !== undefined && {
+            receiver_path: admittedReceiverPath,
+        }),
+        retryable: value.retryable,
+        user_action: value.user_action,
+        source_facts: sourceFacts,
+    };
+}
+function parseReceiverPath(value) {
+    if (value === undefined)
+        return undefined;
+    if (!isRecord(value))
+        return null;
+    if (value.kind !== "runtime_pull" &&
+        value.kind !== "adapter_managed_turn" &&
+        value.kind !== "owner_session_delivery") {
+        return null;
+    }
+    const targetRef = value.target_ref === undefined
+        ? undefined
+        : parseRuntimeWorkTargetRef(value.target_ref);
+    if (value.target_ref !== undefined && targetRef === null)
+        return null;
+    if (value.runtime_session_identity_key !== undefined &&
+        typeof value.runtime_session_identity_key !== "string") {
+        return null;
+    }
+    if (value.endpoint_id !== undefined &&
+        typeof value.endpoint_id !== "string") {
+        return null;
+    }
+    const receiverTargetRef = targetRef === null ? undefined : targetRef;
+    return {
+        kind: value.kind,
+        ...(receiverTargetRef !== undefined && { target_ref: receiverTargetRef }),
+        ...(typeof value.runtime_session_identity_key === "string" && {
+            runtime_session_identity_key: value.runtime_session_identity_key,
+        }),
+        ...(typeof value.endpoint_id === "string" && {
+            endpoint_id: value.endpoint_id,
+        }),
+    };
+}
+function parseSourceFacts(value) {
+    const facts = [];
+    for (const item of value) {
+        if (typeof item === "string") {
+            facts.push(item);
+            continue;
+        }
+        if (isRecord(item) && typeof item.kind === "string") {
+            facts.push({ ...item, kind: item.kind });
+            continue;
+        }
+        return null;
+    }
+    return facts;
+}
+function includesLiteral(values, value) {
+    return typeof value === "string" && values.includes(value);
+}
+function isRecord(value) {
+    return typeof value === "object" && value !== null && !Array.isArray(value);
+}