@openscout/protocol 0.2.63 → 0.2.82

package/dist/index.d.ts

@@ -1,18 +1,52 @@
 export * from "./common.js";
+export * from "./time.js";
 export * from "./actors.js";
 export * from "./agent-identity.js";
-export * from "./agent-address.js";
-export * from "./agent-selectors.js";
+export * from "./provisional-agent-names.js";
+export * from "./a2a.js";
 export * from "./scout-agent-card.js";
 export * from "./relay-agent-card.js";
 export * from "./mesh.js";
 export * from "./conversations.js";
+export * from "./channel-identity.js";
 export * from "./collaboration.js";
+export * from "./assigned-roles.js";
+export * from "./orchestrator-prompt.js";
 export * from "./messages.js";
+export * from "./read-receipts.js";
 export * from "./invocations.js";
+export * from "./agent-runs.js";
+export * from "./budget.js";
+export * from "./agent-broker-feed.js";
+export * from "./durable-actions.js";
+export * from "./observed-status.js";
+export * from "./activity.js";
+export * from "./harness-feature-support.js";
+export * from "./host-integrations.js";
+export * from "./native-interactions.js";
+export * from "./session-display-state.js";
+export * from "./capability-matrix.js";
+export * from "./debug-attach.js";
 export * from "./scout-dispatch.js";
+export * from "./runtime-profiles.js";
+export * from "./runtime-execution.js";
+export * from "./runtime-catalog.js";
+export * from "./reserved-vocabulary.js";
+export * from "./route-aliases.js";
 export * from "./scout-delivery.js";
+export * from "./scout-reply-context.js";
+export * from "./scout-composer.js";
 export * from "./deliveries.js";
+export * from "./inbox.js";
 export * from "./transports.js";
 export * from "./events.js";
 export * from "./thread-events.js";
+export * from "./permission-policy.js";
+export * from "./cursor-transport.js";
+export * from "./terminal-surface-id.js";
+export * from "./terminal-sessions.js";
+export * from "./terminal-workspaces.js";
+export * from "./terminal-host-topology.js";
+export * from "./broker-routes.js";
+export * from "./rendezvous.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAC;AAC5B,cAAc,WAAW,CAAC;AAC1B,cAAc,aAAa,CAAC;AAC5B,cAAc,qBAAqB,CAAC;AACpC,cAAc,8BAA8B,CAAC;AAC7C,cAAc,UAAU,CAAC;AACzB,cAAc,uBAAuB,CAAC;AACtC,cAAc,uBAAuB,CAAC;AACtC,cAAc,WAAW,CAAC;AAC1B,cAAc,oBAAoB,CAAC;AACnC,cAAc,uBAAuB,CAAC;AACtC,cAAc,oBAAoB,CAAC;AACnC,cAAc,qBAAqB,CAAC;AACpC,cAAc,0BAA0B,CAAC;AACzC,cAAc,eAAe,CAAC;AAC9B,cAAc,oBAAoB,CAAC;AACnC,cAAc,kBAAkB,CAAC;AACjC,cAAc,iBAAiB,CAAC;AAChC,cAAc,aAAa,CAAC;AAC5B,cAAc,wBAAwB,CAAC;AACvC,cAAc,sBAAsB,CAAC;AACrC,cAAc,sBAAsB,CAAC;AACrC,cAAc,eAAe,CAAC;AAC9B,cAAc,8BAA8B,CAAC;AAC7C,cAAc,wBAAwB,CAAC;AACvC,cAAc,0BAA0B,CAAC;AACzC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,wBAAwB,CAAC;AACvC,cAAc,mBAAmB,CAAC;AAClC,cAAc,qBAAqB,CAAC;AACpC,cAAc,uBAAuB,CAAC;AACtC,cAAc,wBAAwB,CAAC;AACvC,cAAc,sBAAsB,CAAC;AACrC,cAAc,0BAA0B,CAAC;AACzC,cAAc,oBAAoB,CAAC;AACnC,cAAc,qBAAqB,CAAC;AACpC,cAAc,0BAA0B,CAAC;AACzC,cAAc,qBAAqB,CAAC;AACpC,cAAc,iBAAiB,CAAC;AAChC,cAAc,YAAY,CAAC;AAC3B,cAAc,iBAAiB,CAAC;AAChC,cAAc,aAAa,CAAC;AAC5B,cAAc,oBAAoB,CAAC;AACnC,cAAc,wBAAwB,CAAC;AACvC,cAAc,uBAAuB,CAAC;AACtC,cAAc,0BAA0B,CAAC;AACzC,cAAc,wBAAwB,CAAC;AACvC,cAAc,0BAA0B,CAAC;AACzC,cAAc,6BAA6B,CAAC;AAC5C,cAAc,oBAAoB,CAAC;AACnC,cAAc,iBAAiB,CAAC"}

package/dist/index.js

@@ -1,18 +1,51 @@
 export * from "./common.js";
+export * from "./time.js";
 export * from "./actors.js";
 export * from "./agent-identity.js";
-export * from "./agent-address.js";
-export * from "./agent-selectors.js";
+export * from "./provisional-agent-names.js";
+export * from "./a2a.js";
 export * from "./scout-agent-card.js";
 export * from "./relay-agent-card.js";
 export * from "./mesh.js";
 export * from "./conversations.js";
+export * from "./channel-identity.js";
 export * from "./collaboration.js";
+export * from "./assigned-roles.js";
+export * from "./orchestrator-prompt.js";
 export * from "./messages.js";
+export * from "./read-receipts.js";
 export * from "./invocations.js";
+export * from "./agent-runs.js";
+export * from "./budget.js";
+export * from "./agent-broker-feed.js";
+export * from "./durable-actions.js";
+export * from "./observed-status.js";
+export * from "./activity.js";
+export * from "./harness-feature-support.js";
+export * from "./host-integrations.js";
+export * from "./native-interactions.js";
+export * from "./session-display-state.js";
+export * from "./capability-matrix.js";
+export * from "./debug-attach.js";
 export * from "./scout-dispatch.js";
+export * from "./runtime-profiles.js";
+export * from "./runtime-execution.js";
+export * from "./runtime-catalog.js";
+export * from "./reserved-vocabulary.js";
+export * from "./route-aliases.js";
 export * from "./scout-delivery.js";
+export * from "./scout-reply-context.js";
+export * from "./scout-composer.js";
 export * from "./deliveries.js";
+export * from "./inbox.js";
 export * from "./transports.js";
 export * from "./events.js";
 export * from "./thread-events.js";
+export * from "./permission-policy.js";
+export * from "./cursor-transport.js";
+export * from "./terminal-surface-id.js";
+export * from "./terminal-sessions.js";
+export * from "./terminal-workspaces.js";
+export * from "./terminal-host-topology.js";
+export * from "./broker-routes.js";
+export * from "./rendezvous.js";

package/dist/invocations.d.ts

@@ -1,9 +1,51 @@
 import type { AgentHarness } from "./actors.js";
 import type { MetadataMap, ScoutId } from "./common.js";
+import type { ScoutPermissionProfile } from "./permission-policy.js";
+import type { ScoutExecutionResolution } from "./runtime-execution.js";
 export type InvocationAction = "consult" | "execute" | "summarize" | "status" | "wake";
 export type FlightState = "queued" | "waking" | "running" | "waiting" | "completed" | "failed" | "cancelled";
+export type InvocationSessionPolicy = "new" | "reuse" | "existing" | "fork"
+/** @deprecated use reuse */
+ | "any";
+/** Where a newly created harness session should be discoverable. */
+export type SessionPlacement = "background" | "foreground";
+export type InvocationForkSourceKind = "native_thread_clone" | "scout_state_snapshot";
+export interface InvocationForkContextOptions {
+    maxMessages?: number;
+    maxBytes?: number;
+    includeBrokerRecords?: boolean;
+    includeObservedHarnessMaterial?: boolean;
+}
+export interface InvocationSessionLineage {
+    parentSessionId?: ScoutId;
+    parentHarnessThreadId?: string;
+    forkSourceKind?: InvocationForkSourceKind;
+    forkSourceId?: ScoutId | string;
+    forkedAt?: number;
+    metadata?: MetadataMap;
+}
 export interface InvocationExecutionPreference {
     harness?: AgentHarness;
+    model?: string;
+    reasoningEffort?: string;
+    permissionProfile?: ScoutPermissionProfile;
+    /**
+     * Background sessions use Scout-managed harness state. Foreground sessions
+     * use the operator's native harness state so the task is openable there.
+     */
+    placement?: SessionPlacement;
+    /**
+     * Controls whether work should enter fresh model context, opportunistically
+     * reuse a warm compatible session, continue one exact session, or fork a new
+     * execution session from prior state. The legacy "any" value is a
+     * compatibility alias for "reuse"; exact continuation requires targetSessionId.
+     */
+    session?: InvocationSessionPolicy;
+    targetSessionId?: ScoutId;
+    forkFromStateId?: ScoutId;
+    forkFromSessionId?: ScoutId;
+    forkContext?: InvocationForkContextOptions;
+    lineage?: InvocationSessionLineage;
 }
 export interface InvocationRequest {
     id: ScoutId;
@@ -18,9 +60,11 @@ export interface InvocationRequest {
     messageId?: ScoutId;
     context?: MetadataMap;
     execution?: InvocationExecutionPreference;
+    executionResolution?: ScoutExecutionResolution;
     ensureAwake: boolean;
     stream: boolean;
     timeoutMs?: number;
+    labels?: string[];
     createdAt: number;
     metadata?: MetadataMap;
 }
@@ -35,5 +79,82 @@ export interface FlightRecord {
     error?: string;
     startedAt?: number;
     completedAt?: number;
+    labels?: string[];
     metadata?: MetadataMap;
 }
+/**
+ * One concrete harness session used while executing a flight. Flights are the
+ * stable coordination handle; sessions are ephemeral execution resources and
+ * may change when a dispatch is retried, resumed, or replaced.
+ */
+export interface FlightSessionTraceEntry {
+    sessionId: ScoutId;
+    endpointId?: ScoutId;
+    nodeId?: ScoutId;
+    harness?: AgentHarness;
+    transport?: string;
+    strategy?: string;
+    placement?: SessionPlacement;
+    executionResolution?: ScoutExecutionResolution;
+    startedAt: number;
+    lastAcknowledgedAt: number;
+    endedAt?: number;
+}
+export interface FlightDispatchAcknowledgement {
+    sessionId?: ScoutId | null;
+    /**
+     * Provisional session id replaced by `sessionId` for this same dispatch.
+     * Absent for a real transition between two concrete provider sessions.
+     */
+    refinesSessionId?: ScoutId | null;
+    endpointId?: ScoutId | null;
+    nodeId?: ScoutId | null;
+    harness?: AgentHarness | null;
+    transport?: string | null;
+    strategy?: string | null;
+    placement?: SessionPlacement | null;
+    executionResolution?: ScoutExecutionResolution | null;
+    acknowledgedAt?: number | null;
+}
+/**
+ * Read a flight's ordered session history. Legacy records that only contain a
+ * dispatch acknowledgement are projected as a one-session trace.
+ */
+export declare function flightSessionTrace(flightOrMetadata: Pick<FlightRecord, "metadata"> | MetadataMap | null | undefined): FlightSessionTraceEntry[];
+/** Append a dispatch acknowledgement without losing earlier session identity. */
+export declare function recordFlightSessionDispatch(metadata: MetadataMap | null | undefined, acknowledgement: unknown): MetadataMap;
+/**
+ * Mutable execution status for an invocation. Every field is optional — a
+ * freshly-created invocation has no flight or status yet.
+ *
+ * Note the dispatch job's scheduler state (attempts / leaseOwner /
+ * leaseExpiresAt / lastError) is deliberately NOT part of this: it is a distinct
+ * concern (worker-lease mechanics), stays its own journal-backed record, and is
+ * surfaced separately rather than folded into the domain status.
+ */
+export interface InvocationStatus {
+    /**
+     * Durable secondary id of the invocation's flight. Retained as a stable alias
+     * so projected run ids (`run:flight:<flightId>`) and follow links survive the
+     * flight→invocation storage merge.
+     */
+    flightId?: ScoutId;
+    state?: FlightState;
+    summary?: string;
+    output?: string;
+    error?: string;
+    startedAt?: number;
+    completedAt?: number;
+}
+/**
+ * The merged invocation record: the immutable request ({@link InvocationRequest})
+ * plus its mutable execution status ({@link InvocationStatus}). This is the
+ * single source of truth, from which the flight / work-item / agent-run views are
+ * projected. The standalone {@link FlightRecord} remains a compatibility shape
+ * over the same status subset.
+ */
+export type Invocation = InvocationRequest & InvocationStatus;
+export declare function normalizeInvocationSessionPolicy(policy: InvocationSessionPolicy | string | null | undefined): InvocationSessionPolicy | undefined;
+export declare function effectiveInvocationSessionPolicy(execution: Pick<InvocationExecutionPreference, "session" | "targetSessionId" | "forkFromStateId" | "forkFromSessionId"> | null | undefined): Exclude<InvocationSessionPolicy, "any">;
+export declare function validateInvocationExecutionPreference(execution: InvocationExecutionPreference | null | undefined): string[];
+//# sourceMappingURL=invocations.d.ts.map

package/dist/invocations.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"invocations.d.ts","sourceRoot":"","sources":["../src/invocations.ts"],"names":[],"mappings":"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"}

package/dist/invocations.js

@@ -1 +1,201 @@
-export {};
+function cleanTraceString(value) {
+    return typeof value === "string" && value.trim() ? value.trim() : undefined;
+}
+function cleanTraceTimestamp(value) {
+    return typeof value === "number" && Number.isFinite(value) && value >= 0
+        ? value
+        : undefined;
+}
+function cleanTracePlacement(value) {
+    return value === "background" || value === "foreground" ? value : undefined;
+}
+function parseFlightSessionTraceEntry(value) {
+    if (!value || typeof value !== "object" || Array.isArray(value))
+        return null;
+    const record = value;
+    const sessionId = cleanTraceString(record.sessionId);
+    const startedAt = cleanTraceTimestamp(record.startedAt);
+    const lastAcknowledgedAt = cleanTraceTimestamp(record.lastAcknowledgedAt) ?? startedAt;
+    if (!sessionId || startedAt === undefined || lastAcknowledgedAt === undefined)
+        return null;
+    const harness = cleanTraceString(record.harness);
+    const executionResolution = record.executionResolution
+        && typeof record.executionResolution === "object"
+        && !Array.isArray(record.executionResolution)
+        ? record.executionResolution
+        : undefined;
+    return {
+        sessionId,
+        ...(cleanTraceString(record.endpointId) ? { endpointId: cleanTraceString(record.endpointId) } : {}),
+        ...(cleanTraceString(record.nodeId) ? { nodeId: cleanTraceString(record.nodeId) } : {}),
+        ...(harness ? { harness: harness } : {}),
+        ...(cleanTraceString(record.transport) ? { transport: cleanTraceString(record.transport) } : {}),
+        ...(cleanTraceString(record.strategy) ? { strategy: cleanTraceString(record.strategy) } : {}),
+        ...(cleanTracePlacement(record.placement) ? { placement: cleanTracePlacement(record.placement) } : {}),
+        ...(executionResolution ? { executionResolution } : {}),
+        startedAt,
+        lastAcknowledgedAt,
+        ...(cleanTraceTimestamp(record.endedAt) !== undefined
+            ? { endedAt: cleanTraceTimestamp(record.endedAt) }
+            : {}),
+    };
+}
+function parseDispatchAcknowledgement(value) {
+    if (!value || typeof value !== "object" || Array.isArray(value))
+        return null;
+    const record = value;
+    const sessionId = cleanTraceString(record.sessionId);
+    const acknowledgedAt = cleanTraceTimestamp(record.acknowledgedAt);
+    if (!sessionId || acknowledgedAt === undefined)
+        return null;
+    const harness = cleanTraceString(record.harness);
+    const executionResolution = record.executionResolution
+        && typeof record.executionResolution === "object"
+        && !Array.isArray(record.executionResolution)
+        ? record.executionResolution
+        : null;
+    return {
+        sessionId,
+        refinesSessionId: cleanTraceString(record.refinesSessionId) ?? null,
+        endpointId: cleanTraceString(record.endpointId) ?? null,
+        nodeId: cleanTraceString(record.nodeId) ?? null,
+        harness: harness ? harness : null,
+        transport: cleanTraceString(record.transport) ?? null,
+        strategy: cleanTraceString(record.strategy) ?? null,
+        placement: cleanTracePlacement(record.placement) ?? null,
+        executionResolution,
+        acknowledgedAt,
+    };
+}
+/**
+ * Read a flight's ordered session history. Legacy records that only contain a
+ * dispatch acknowledgement are projected as a one-session trace.
+ */
+export function flightSessionTrace(flightOrMetadata) {
+    const metadata = (flightOrMetadata && "metadata" in flightOrMetadata
+        ? flightOrMetadata.metadata
+        : flightOrMetadata);
+    const recorded = Array.isArray(metadata?.sessionTrace)
+        ? metadata.sessionTrace
+            .map(parseFlightSessionTraceEntry)
+            .filter((entry) => entry !== null)
+        : [];
+    if (recorded.length > 0)
+        return recorded;
+    const dispatchAck = parseDispatchAcknowledgement(metadata?.dispatchAck);
+    if (!dispatchAck?.sessionId || dispatchAck.acknowledgedAt === null || dispatchAck.acknowledgedAt === undefined) {
+        return [];
+    }
+    return [{
+            sessionId: dispatchAck.sessionId,
+            ...(dispatchAck.endpointId ? { endpointId: dispatchAck.endpointId } : {}),
+            ...(dispatchAck.nodeId ? { nodeId: dispatchAck.nodeId } : {}),
+            ...(dispatchAck.harness ? { harness: dispatchAck.harness } : {}),
+            ...(dispatchAck.transport ? { transport: dispatchAck.transport } : {}),
+            ...(dispatchAck.strategy ? { strategy: dispatchAck.strategy } : {}),
+            ...(dispatchAck.placement ? { placement: dispatchAck.placement } : {}),
+            startedAt: dispatchAck.acknowledgedAt,
+            lastAcknowledgedAt: dispatchAck.acknowledgedAt,
+        }];
+}
+/** Append a dispatch acknowledgement without losing earlier session identity. */
+export function recordFlightSessionDispatch(metadata, acknowledgement) {
+    const dispatchAck = parseDispatchAcknowledgement(acknowledgement);
+    const nextMetadata = { ...(metadata ?? {}), dispatchAck: acknowledgement };
+    if (!dispatchAck?.sessionId || dispatchAck.acknowledgedAt === null || dispatchAck.acknowledgedAt === undefined) {
+        return nextMetadata;
+    }
+    const trace = flightSessionTrace(metadata).map((entry) => ({ ...entry }));
+    const previous = trace.at(-1);
+    const refinesSameDispatch = Boolean(previous
+        && dispatchAck.refinesSessionId
+        && previous.sessionId === dispatchAck.refinesSessionId
+        && previous.sessionId !== dispatchAck.sessionId
+        && previous.endpointId
+        && dispatchAck.endpointId
+        && previous.endpointId === dispatchAck.endpointId
+        && previous.startedAt === dispatchAck.acknowledgedAt);
+    if (previous
+        && (previous.sessionId === dispatchAck.sessionId || refinesSameDispatch)
+        && (previous.endpointId ?? null) === (dispatchAck.endpointId ?? null)) {
+        // A transport can acknowledge with Scout's provisional routing id, then
+        // refine that same acknowledgement once the provider id is known. The
+        // unchanged endpoint and timestamp prove this is identity promotion, not
+        // a second harness session span.
+        if (refinesSameDispatch) {
+            previous.sessionId = dispatchAck.sessionId;
+        }
+        previous.lastAcknowledgedAt = Math.max(previous.lastAcknowledgedAt, dispatchAck.acknowledgedAt);
+        previous.strategy = dispatchAck.strategy ?? previous.strategy;
+        previous.placement = dispatchAck.placement ?? previous.placement;
+        previous.harness = dispatchAck.harness ?? previous.harness;
+        previous.transport = dispatchAck.transport ?? previous.transport;
+        previous.nodeId = dispatchAck.nodeId ?? previous.nodeId;
+        previous.executionResolution = dispatchAck.executionResolution ?? previous.executionResolution;
+        delete previous.endedAt;
+    }
+    else {
+        if (previous && previous.endedAt === undefined) {
+            previous.endedAt = dispatchAck.acknowledgedAt;
+        }
+        trace.push({
+            sessionId: dispatchAck.sessionId,
+            ...(dispatchAck.endpointId ? { endpointId: dispatchAck.endpointId } : {}),
+            ...(dispatchAck.nodeId ? { nodeId: dispatchAck.nodeId } : {}),
+            ...(dispatchAck.harness ? { harness: dispatchAck.harness } : {}),
+            ...(dispatchAck.transport ? { transport: dispatchAck.transport } : {}),
+            ...(dispatchAck.strategy ? { strategy: dispatchAck.strategy } : {}),
+            ...(dispatchAck.placement ? { placement: dispatchAck.placement } : {}),
+            ...(dispatchAck.executionResolution ? { executionResolution: dispatchAck.executionResolution } : {}),
+            startedAt: dispatchAck.acknowledgedAt,
+            lastAcknowledgedAt: dispatchAck.acknowledgedAt,
+        });
+    }
+    nextMetadata.sessionTrace = trace;
+    return nextMetadata;
+}
+export function normalizeInvocationSessionPolicy(policy) {
+    switch (policy) {
+        case "new":
+        case "reuse":
+        case "existing":
+        case "fork":
+        case "any":
+            return policy;
+        default:
+            return undefined;
+    }
+}
+export function effectiveInvocationSessionPolicy(execution) {
+    if (!execution)
+        return "new";
+    if (execution.forkFromStateId || execution.forkFromSessionId || execution.session === "fork") {
+        return "fork";
+    }
+    if (execution.targetSessionId || execution.session === "existing") {
+        return "existing";
+    }
+    if (execution.session === "reuse" || execution.session === "any") {
+        return "reuse";
+    }
+    return "new";
+}
+export function validateInvocationExecutionPreference(execution) {
+    if (!execution)
+        return [];
+    const errors = [];
+    const policy = effectiveInvocationSessionPolicy(execution);
+    if (policy === "existing" && !execution.targetSessionId) {
+        errors.push("session existing requires targetSessionId");
+    }
+    if (policy === "fork" && !execution.forkFromStateId && !execution.forkFromSessionId) {
+        errors.push("session fork requires forkFromStateId or forkFromSessionId");
+    }
+    if (execution.session === "new" && execution.targetSessionId) {
+        errors.push("session new cannot target an existing session");
+    }
+    if (execution.session === "new" && (execution.forkFromStateId || execution.forkFromSessionId)) {
+        errors.push("session new cannot include fork source ids");
+    }
+    return errors;
+}

package/dist/mesh.d.ts

@@ -1,4 +1,69 @@
 import type { AdvertiseScope, MetadataMap, ScoutId } from "./common.js";
+export declare const OPENSCOUT_MESH_PROTOCOL_VERSION = 1;
+export declare const OPENSCOUT_IROH_MESH_ALPN = "openscout/mesh/0";
+export declare const DEFAULT_OPENSCOUT_MESH_RENDEZVOUS_URL = "https://mesh.oscout.net";
+export declare const DEFAULT_OPENSCOUT_MOBILE_PAIRING_RELAY_URL = "wss://mesh.oscout.net/v1/relay";
+export type NodeMeshEntrypoint = IrohMeshEntrypoint | CloudflareTunnelMeshEntrypoint | HttpMeshEntrypoint | MobilePairingMeshEntrypoint;
+export interface IrohMeshEntrypoint {
+    kind: "iroh";
+    endpointId: string;
+    endpointAddr: unknown;
+    alpn: typeof OPENSCOUT_IROH_MESH_ALPN;
+    bridgeProtocolVersion: typeof OPENSCOUT_MESH_PROTOCOL_VERSION;
+    lastSeenAt?: number;
+    expiresAt?: number;
+    metadata?: MetadataMap;
+}
+export interface CloudflareTunnelMeshEntrypoint {
+    kind: "cloudflare_tunnel";
+    url: string;
+    lastSeenAt?: number;
+    expiresAt?: number;
+    metadata?: MetadataMap;
+}
+export interface HttpMeshEntrypoint {
+    kind: "http";
+    url: string;
+    lastSeenAt?: number;
+    expiresAt?: number;
+    metadata?: MetadataMap;
+}
+export interface MobilePairingMeshEntrypoint {
+    kind: "mobile_pairing";
+    relay: string;
+    fallbackRelays?: string[];
+    room: string;
+    publicKey: string;
+    expiresAt: number;
+    lastSeenAt?: number;
+    metadata?: MetadataMap;
+}
+export type TrustedPeerTier = "observe" | "control";
+export type TrustedPeerGrantChannel = "sas" | "github" | "ssh";
+export interface TrustedPeerRecord {
+    /** Canonical machine identity: full SHA-256 hex of the DER public key. */
+    keyId: string;
+    /** Base64 DER spki Ed25519 public key. */
+    publicKey: string;
+    /** Short `osc1:xxxx-xxxx` form — display-only, never an identity key. */
+    fingerprint: string;
+    /** Remote node's runtime id, when known. */
+    nodeId?: ScoutId;
+    label: string;
+    tier: TrustedPeerTier;
+    grantedVia: TrustedPeerGrantChannel;
+    grantedAt: number;
+    expiresAt?: number;
+    revokedAt?: number;
+    lastSeenAt?: number;
+    /**
+     * §11.2 durable TLS pin: SHA-256 hex of the peer TLS certificate's
+     * SubjectPublicKeyInfo DER, copied from the peer's verified signed card at
+     * enrollment. Absent for Tailscale-path peers and pre-P1.5 enrollments.
+     */
+    tlsSpkiFingerprint?: string;
+    metadata?: MetadataMap;
+}
 export interface NodeDefinition {
     id: ScoutId;
     meshId: ScoutId;
@@ -6,6 +71,8 @@ export interface NodeDefinition {
     hostName?: string;
     advertiseScope: AdvertiseScope;
     brokerUrl?: string;
+    webUrl?: string;
+    meshEntrypoints?: NodeMeshEntrypoint[];
     tailnetName?: string;
     capabilities?: string[];
     labels?: string[];
@@ -13,3 +80,34 @@ export interface NodeDefinition {
     lastSeenAt?: number;
     registeredAt: number;
 }
+export interface OpenScoutMeshPresence {
+    v: typeof OPENSCOUT_MESH_PROTOCOL_VERSION;
+    meshId: ScoutId;
+    nodeId: ScoutId;
+    nodeName: string;
+    issuedAt: number;
+    expiresAt: number;
+    entrypoints: NodeMeshEntrypoint[];
+    signature?: {
+        algorithm: "ed25519";
+        keyId: string;
+        value: string;
+    };
+    metadata?: MetadataMap;
+}
+export interface OpenScoutMeshPresenceRecord extends OpenScoutMeshPresence {
+    observedAt: number;
+}
+export interface OpenScoutMeshRendezvousList {
+    v: typeof OPENSCOUT_MESH_PROTOCOL_VERSION;
+    meshId: ScoutId;
+    nodes: OpenScoutMeshPresenceRecord[];
+}
+export declare function buildUnsignedMeshPresence(input: {
+    node: Pick<NodeDefinition, "id" | "meshId" | "name">;
+    entrypoints: NodeMeshEntrypoint[];
+    issuedAt?: number;
+    ttlMs?: number;
+    metadata?: MetadataMap;
+}): OpenScoutMeshPresence;
+//# sourceMappingURL=mesh.d.ts.map

package/dist/mesh.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mesh.d.ts","sourceRoot":"","sources":["../src/mesh.ts"],"names":[],"mappings":"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"}

package/dist/mesh.js

@@ -1 +1,18 @@
-export {};
+export const OPENSCOUT_MESH_PROTOCOL_VERSION = 1;
+export const OPENSCOUT_IROH_MESH_ALPN = "openscout/mesh/0";
+export const DEFAULT_OPENSCOUT_MESH_RENDEZVOUS_URL = "https://mesh.oscout.net";
+export const DEFAULT_OPENSCOUT_MOBILE_PAIRING_RELAY_URL = "wss://mesh.oscout.net/v1/relay";
+export function buildUnsignedMeshPresence(input) {
+    const issuedAt = input.issuedAt ?? Date.now();
+    const ttlMs = input.ttlMs ?? 60_000;
+    return {
+        v: OPENSCOUT_MESH_PROTOCOL_VERSION,
+        meshId: input.node.meshId,
+        nodeId: input.node.id,
+        nodeName: input.node.name,
+        issuedAt,
+        expiresAt: issuedAt + ttlMs,
+        entrypoints: input.entrypoints,
+        ...(input.metadata ? { metadata: input.metadata } : {}),
+    };
+}

package/dist/messages.d.ts

@@ -22,6 +22,8 @@ export interface MessageAudience {
     notify?: ScoutId[];
     invoke?: ScoutId[];
     reason?: DeliveryReason;
+    /** Persist the message without scheduling any transport deliveries. */
+    delivery?: "none";
 }
 export interface MessageRecord {
     id: ScoutId;
@@ -41,3 +43,4 @@ export interface MessageRecord {
     createdAt: number;
     metadata?: MetadataMap;
 }
+//# sourceMappingURL=messages.d.ts.map

package/dist/messages.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"messages.d.ts","sourceRoot":"","sources":["../src/messages.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,cAAc,EACd,cAAc,EACd,WAAW,EACX,OAAO,EACP,eAAe,EAChB,MAAM,aAAa,CAAC;AAErB,MAAM,MAAM,YAAY,GAAG,OAAO,GAAG,KAAK,GAAG,QAAQ,GAAG,QAAQ,GAAG,UAAU,CAAC;AAE9E,MAAM,WAAW,sBAAsB;IACrC,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,aAAa,CAAC,EAAE,OAAO,CAAC;CACzB;AAED,MAAM,WAAW,iBAAiB;IAChC,EAAE,EAAE,OAAO,CAAC;IACZ,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,QAAQ,CAAC,EAAE,WAAW,CAAC;CACxB;AAED,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,OAAO,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,eAAe;IAC9B,SAAS,CAAC,EAAE,OAAO,EAAE,CAAC;IACtB,MAAM,CAAC,EAAE,OAAO,EAAE,CAAC;IACnB,MAAM,CAAC,EAAE,OAAO,EAAE,CAAC;IACnB,MAAM,CAAC,EAAE,cAAc,CAAC;IACxB,uEAAuE;IACvE,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,aAAa;IAC5B,EAAE,EAAE,OAAO,CAAC;IACZ,cAAc,EAAE,OAAO,CAAC;IACxB,OAAO,EAAE,OAAO,CAAC;IACjB,YAAY,EAAE,OAAO,CAAC;IACtB,KAAK,EAAE,YAAY,CAAC;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,oBAAoB,CAAC,EAAE,OAAO,CAAC;IAC/B,QAAQ,CAAC,EAAE,cAAc,EAAE,CAAC;IAC5B,WAAW,CAAC,EAAE,iBAAiB,EAAE,CAAC;IAClC,MAAM,CAAC,EAAE,sBAAsB,CAAC;IAChC,QAAQ,CAAC,EAAE,eAAe,CAAC;IAC3B,UAAU,EAAE,eAAe,CAAC;IAC5B,MAAM,EAAE,cAAc,CAAC;IACvB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,WAAW,CAAC;CACxB"}

package/dist/native-interactions.d.ts

@@ -0,0 +1,30 @@
+import type { ScoutId } from "./common.js";
+export type HarnessNativeInteractionKind = "question" | "plan_approval" | "task_projection" | "subagent_activity" | "tool_approval" | "follow_up" | "steer";
+export type ScoutNativeInteractionTargetKind = "question" | "work_item" | "invocation" | "flight" | "message" | "session_projection";
+export interface HarnessNativeInteractionSource {
+    harness: string;
+    sessionId?: ScoutId;
+    harnessThreadId?: string;
+    toolCallId?: string;
+    nativeName?: string;
+    rawEventId?: string;
+}
+export interface HarnessNativeInteraction {
+    id: ScoutId;
+    kind: HarnessNativeInteractionKind;
+    source: HarnessNativeInteractionSource;
+    title?: string;
+    summary?: string;
+    payload?: Record<string, unknown>;
+    observedAt: number;
+}
+export interface HarnessNativeInteractionMapping {
+    kind: HarnessNativeInteractionKind;
+    nativeNames: string[];
+    scoutTargets: ScoutNativeInteractionTargetKind[];
+    description: string;
+}
+export declare const DEFAULT_HARNESS_NATIVE_INTERACTION_MAPPINGS: readonly HarnessNativeInteractionMapping[];
+export declare function scoutTargetsForNativeInteraction(kind: HarnessNativeInteractionKind): ScoutNativeInteractionTargetKind[];
+export declare function nativeInteractionKindForName(nativeName: string): HarnessNativeInteractionKind | undefined;
+//# sourceMappingURL=native-interactions.d.ts.map