@openscout/protocol 0.2.64 → 0.2.82

package/dist/a2a.d.ts.map

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

package/dist/a2a.js

@@ -0,0 +1,225 @@
+export const A2A_PROTOCOL_VERSION = "1.0";
+export const A2A_JSON_RPC_CONTENT_TYPE = "application/json";
+export const A2A_HTTP_JSON_CONTENT_TYPE = "application/a2a+json";
+export const A2A_JSON_RPC_METHODS = {
+    sendMessage: "SendMessage",
+    sendStreamingMessage: "SendStreamingMessage",
+    getTask: "GetTask",
+    listTasks: "ListTasks",
+    cancelTask: "CancelTask",
+    subscribeToTask: "SubscribeToTask",
+    createTaskPushNotificationConfig: "CreateTaskPushNotificationConfig",
+    getTaskPushNotificationConfig: "GetTaskPushNotificationConfig",
+    listTaskPushNotificationConfigs: "ListTaskPushNotificationConfigs",
+    deleteTaskPushNotificationConfig: "DeleteTaskPushNotificationConfig",
+    getExtendedAgentCard: "GetExtendedAgentCard",
+};
+export const A2A_LEGACY_JSON_RPC_METHODS = {
+    sendMessage: "message/send",
+    sendStreamingMessage: "message/stream",
+    getTask: "tasks/get",
+    listTasks: "tasks/list",
+    cancelTask: "tasks/cancel",
+    subscribeToTask: "tasks/subscribe",
+    getExtendedAgentCard: "agent/getAuthenticatedExtendedCard",
+};
+export function a2aTaskStateFromFlightState(state) {
+    switch (state) {
+        case "queued":
+        case "waking":
+            return "TASK_STATE_SUBMITTED";
+        case "running":
+            return "TASK_STATE_WORKING";
+        case "waiting":
+            return "TASK_STATE_INPUT_REQUIRED";
+        case "completed":
+            return "TASK_STATE_COMPLETED";
+        case "failed":
+            return "TASK_STATE_FAILED";
+        case "cancelled":
+            return "TASK_STATE_CANCELED";
+        default: {
+            const exhaustive = state;
+            void exhaustive;
+            return "TASK_STATE_UNKNOWN";
+        }
+    }
+}
+export function isA2ATerminalTaskState(state) {
+    return state === "TASK_STATE_COMPLETED"
+        || state === "TASK_STATE_FAILED"
+        || state === "TASK_STATE_CANCELED"
+        || state === "TASK_STATE_REJECTED";
+}
+export function a2aTextPart(text, metadata) {
+    return metadata && Object.keys(metadata).length > 0 ? { text, metadata } : { text };
+}
+export function a2aTextMessage(input) {
+    return {
+        role: input.role,
+        parts: [a2aTextPart(input.text)],
+        messageId: input.messageId,
+        ...(input.contextId ? { contextId: input.contextId } : {}),
+        ...(input.taskId ? { taskId: input.taskId } : {}),
+        ...(input.metadata && Object.keys(input.metadata).length > 0 ? { metadata: input.metadata } : {}),
+    };
+}
+export function a2aTextFromParts(parts) {
+    if (!Array.isArray(parts)) {
+        return "";
+    }
+    return parts
+        .map((part) => {
+        if (!part || typeof part !== "object" || Array.isArray(part)) {
+            return "";
+        }
+        const record = part;
+        return typeof record.text === "string" ? record.text.trim() : "";
+    })
+        .filter(Boolean)
+        .join("\n\n")
+        .trim();
+}
+export function a2aTextFromMessage(message) {
+    if (!message || typeof message !== "object" || Array.isArray(message)) {
+        return "";
+    }
+    return a2aTextFromParts(message.parts);
+}
+export function a2aContextIdForInvocation(invocation, fallback = "openscout") {
+    return invocation.conversationId
+        ?? (typeof invocation.metadata?.a2aContextId === "string" ? invocation.metadata.a2aContextId : undefined)
+        ?? fallback;
+}
+export function a2aTaskFromFlight(flight, invocation, options = {}) {
+    const contextId = options.contextId ?? (invocation ? a2aContextIdForInvocation(invocation, flight.id) : flight.id);
+    const state = a2aTaskStateFromFlightState(flight.state);
+    const timestamp = options.timestamp ?? new Date(flight.completedAt ?? Date.now()).toISOString();
+    const statusText = flight.error ?? flight.summary;
+    const statusMessage = statusText
+        ? a2aTextMessage({
+            role: "ROLE_AGENT",
+            text: statusText,
+            messageId: `${flight.id}:status`,
+            taskId: flight.id,
+            contextId,
+        })
+        : undefined;
+    const output = typeof flight.output === "string" && flight.output.trim() ? flight.output.trim() : "";
+    const artifacts = output
+        ? [{
+                artifactId: `${flight.id}:output`,
+                name: "OpenScout output",
+                parts: [a2aTextPart(output)],
+            }]
+        : undefined;
+    const history = [];
+    if (options.includeHistory && invocation?.task) {
+        history.push(a2aTextMessage({
+            role: "ROLE_USER",
+            text: invocation.task,
+            messageId: invocation.messageId ?? `${invocation.id}:message`,
+            contextId,
+            taskId: flight.id,
+        }));
+        if (output) {
+            history.push(a2aTextMessage({
+                role: "ROLE_AGENT",
+                text: output,
+                messageId: `${flight.id}:reply`,
+                contextId,
+                taskId: flight.id,
+            }));
+        }
+    }
+    return {
+        id: flight.id,
+        contextId,
+        status: {
+            state,
+            ...(statusMessage ? { message: statusMessage } : {}),
+            timestamp,
+        },
+        ...(artifacts ? { artifacts } : {}),
+        ...(history.length > 0 ? { history } : {}),
+        metadata: {
+            scoutInvocationId: flight.invocationId,
+            scoutRequesterId: flight.requesterId,
+            scoutTargetAgentId: flight.targetAgentId,
+            ...(flight.metadata ?? {}),
+        },
+    };
+}
+function a2aSkillId(input, fallback) {
+    const normalized = input
+        .toLowerCase()
+        .replace(/[^a-z0-9._-]+/g, "-")
+        .replace(/^-+|-+$/g, "");
+    return normalized || fallback;
+}
+export function a2aAgentCardFromScoutCard(card, options) {
+    const inputModes = card.defaultInputModes?.length ? card.defaultInputModes : ["text/plain"];
+    const outputModes = card.defaultOutputModes?.length ? card.defaultOutputModes : ["text/plain"];
+    const skills = (card.skills?.length ? card.skills : [{
+            id: "chat",
+            name: "Chat",
+            description: `Route messages and invocations to ${card.displayName}.`,
+            tags: ["openscout", card.harness],
+        }]).map((skill, index) => ({
+        id: skill.id?.trim() || a2aSkillId(skill.name, `skill-${index + 1}`),
+        name: skill.name,
+        description: skill.description ?? skill.name,
+        ...(skill.tags?.length ? { tags: skill.tags } : {}),
+        ...(skill.examples?.length ? { examples: skill.examples } : {}),
+        inputModes,
+        outputModes,
+    }));
+    return {
+        protocolVersion: options.protocolVersion ?? A2A_PROTOCOL_VERSION,
+        name: card.displayName,
+        description: card.description ?? `OpenScout route for ${card.displayName}.`,
+        url: options.url,
+        preferredTransport: options.transport ?? "JSONRPC",
+        ...(card.provider?.organization ? {
+            provider: {
+                organization: card.provider.organization,
+                ...(card.provider.url ? { url: card.provider.url } : {}),
+            },
+        } : {}),
+        ...(card.version ? { version: card.version } : {}),
+        ...(card.documentationUrl ? { documentationUrl: card.documentationUrl } : {}),
+        capabilities: {
+            streaming: false,
+            pushNotifications: false,
+            stateTransitionHistory: true,
+            extendedAgentCard: true,
+            ...options.capabilities,
+        },
+        defaultInputModes: inputModes,
+        defaultOutputModes: outputModes,
+        skills,
+        supportedInterfaces: [
+            {
+                url: options.url,
+                protocolBinding: options.protocolBinding ?? "JSONRPC",
+                protocolVersion: options.protocolVersion ?? A2A_PROTOCOL_VERSION,
+                transport: options.transport ?? "http",
+                tenant: card.agentId,
+            },
+        ],
+        ...(card.securitySchemes ? { securitySchemes: card.securitySchemes } : {}),
+        ...(card.securityRequirements ? {
+            security: card.securityRequirements.map((requirement) => Object.fromEntries(requirement.map((scheme) => [scheme, []]))),
+        } : {}),
+        metadata: {
+            scoutAgentId: card.agentId,
+            scoutDefinitionId: card.definitionId,
+            scoutHandle: card.handle,
+            scoutSelector: card.selector,
+            scoutHarness: card.harness,
+            scoutTransport: card.transport,
+            brokerRegistered: card.brokerRegistered,
+            ...(card.metadata ?? {}),
+        },
+    };
+}

package/dist/activity.d.ts

@@ -0,0 +1,70 @@
+import type { MetadataMap, ScoutId } from "./common.js";
+import type { ObservedActivity, ObservedStatusPhase, ObservedStatusProjection } from "./observed-status.js";
+export type ScoutActivityAltitude = "shell" | "list" | "focused";
+export type ScoutActivityMotionLevel = "none" | "low" | "medium" | "high" | "blocked";
+export type ScoutActivitySeverity = "info" | "warning" | "critical";
+export type ScoutActivityEventKind = "message" | "invocation" | "flight" | "work_item" | "question" | "approval" | "permission" | "session" | "tool" | "edit" | "result" | "tail" | "error";
+export type ScoutActivitySourceKind = "broker_record" | "message" | "invocation" | "flight" | "collaboration_record" | "work_item" | "question" | "endpoint" | "tail_event" | "session_projection" | "observed_status";
+export interface ScoutActivitySourceRef {
+    kind: ScoutActivitySourceKind;
+    refId: ScoutId | string;
+    label?: string;
+}
+export interface ScoutActivityEvent {
+    id: ScoutId | string;
+    kind: ScoutActivityEventKind;
+    agentId?: ScoutId;
+    sessionId?: ScoutId;
+    conversationId?: ScoutId;
+    title?: string;
+    summary: string;
+    at: number;
+    severity?: ScoutActivitySeverity;
+    source: ScoutActivitySourceRef;
+    metadata?: MetadataMap;
+}
+export interface ScoutActivityWorkSummary {
+    title?: string;
+    summary?: string;
+    source?: ScoutActivitySourceRef;
+    metadata?: MetadataMap;
+}
+export interface ScoutAgentActivitySummary {
+    agentId: ScoutId;
+    displayName?: string;
+    phase: ObservedStatusPhase;
+    activity: ObservedActivity;
+    motion: ScoutActivityMotionLevel;
+    needsYou: boolean;
+    currentWork?: ScoutActivityWorkSummary;
+    latestEvent?: ScoutActivityEvent;
+    updatedAt: number;
+    staleAt?: number;
+    status?: ObservedStatusProjection;
+    metadata?: MetadataMap;
+}
+export interface ScoutActivityDigest {
+    label: string;
+    summary: string;
+    motion: ScoutActivityMotionLevel;
+    updatedAt: number;
+    needsYouCount: number;
+    workingCount: number;
+    latestEvent?: ScoutActivityEvent;
+    metadata?: MetadataMap;
+}
+export interface ScoutFleetActivitySummary {
+    totalAgents: number;
+    workingCount: number;
+    needsYouCount: number;
+    activeCount: number;
+    quietCount: number;
+    updatedAt: number;
+    agents: ScoutAgentActivitySummary[];
+    currentlyWorking: ScoutAgentActivitySummary[];
+    needsYou: ScoutAgentActivitySummary[];
+    latestEvents: ScoutActivityEvent[];
+    digest: ScoutActivityDigest;
+    metadata?: MetadataMap;
+}
+//# sourceMappingURL=activity.d.ts.map

package/dist/activity.d.ts.map

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

package/dist/activity.js

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

package/dist/actors.d.ts

@@ -1,7 +1,9 @@
-import type { ActorKind, AdvertiseScope, AgentState, MetadataMap, ScoutId } from "./common.js";
+import type { ActorKind, AdvertiseScope, AgentState, DeliveryTransport, MetadataMap, ScoutId } from "./common.js";
 export type AgentClass = "general" | "builder" | "reviewer" | "researcher" | "operator" | "bridge" | "system";
 export type AgentCapability = "chat" | "invoke" | "deliver" | "speak" | "listen" | "bridge" | "summarize" | "review" | "execute";
-export type AgentHarness = "codex" | "claude" | "native" | "worker" | "bridge" | "http" | "pi";
+export type AgentEndpointTransport = Extract<DeliveryTransport, "local_socket" | "http" | "websocket" | "pairing_bridge" | "claude_channel" | "claude_stream_json" | "codex_app_server" | "codex_exec" | "claude_resume" | "pi_rpc" | "grok_acp" | "kimi_acp" | "cursor_acp" | "opencode_acp" | "tmux" | "cursor_exec" | "cursor_cli_text" | "cursor_cli_stream_json" | "cursor_sdk_local">;
+export declare const AGENT_HARNESSES: readonly ["codex", "claude", "grok", "grok-acp", "kimi", "flue", "cursor", "opencode", "native", "worker", "bridge", "http", "pi"];
+export type AgentHarness = typeof AGENT_HARNESSES[number];
 export type WakePolicy = "manual" | "on_demand" | "keep_warm";
 export interface ActorIdentity {
     id: ScoutId;
@@ -38,8 +40,9 @@ export interface AgentEndpoint {
     agentId: ScoutId;
     nodeId: ScoutId;
     harness: AgentHarness;
-    transport: "local_socket" | "http" | "websocket" | "pairing_bridge" | "claude_stream_json" | "codex_app_server" | "codex_exec" | "claude_resume" | "tmux";
+    transport: AgentEndpointTransport;
     state: AgentState;
+    preferred?: boolean;
     address?: string;
     sessionId?: string;
     pane?: string;
@@ -47,3 +50,4 @@ export interface AgentEndpoint {
     projectRoot?: string;
     metadata?: MetadataMap;
 }
+//# sourceMappingURL=actors.d.ts.map

package/dist/actors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"actors.d.ts","sourceRoot":"","sources":["../src/actors.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,SAAS,EACT,cAAc,EACd,UAAU,EACV,iBAAiB,EACjB,WAAW,EACX,OAAO,EACR,MAAM,aAAa,CAAC;AAErB,MAAM,MAAM,UAAU,GAClB,SAAS,GACT,SAAS,GACT,UAAU,GACV,YAAY,GACZ,UAAU,GACV,QAAQ,GACR,QAAQ,CAAC;AAEb,MAAM,MAAM,eAAe,GACvB,MAAM,GACN,QAAQ,GACR,SAAS,GACT,OAAO,GACP,QAAQ,GACR,QAAQ,GACR,WAAW,GACX,QAAQ,GACR,SAAS,CAAC;AAEd,MAAM,MAAM,sBAAsB,GAAG,OAAO,CAC1C,iBAAiB,EACf,cAAc,GACd,MAAM,GACN,WAAW,GACX,gBAAgB,GAChB,gBAAgB,GAChB,oBAAoB,GACpB,kBAAkB,GAClB,YAAY,GACZ,eAAe,GACf,QAAQ,GACR,UAAU,GACV,UAAU,GACV,YAAY,GACZ,cAAc,GACd,MAAM,GACN,aAAa,GACb,iBAAiB,GACjB,wBAAwB,GACxB,kBAAkB,CACrB,CAAC;AAEF,eAAO,MAAM,eAAe,oIAclB,CAAC;AAEX,MAAM,MAAM,YAAY,GAAG,OAAO,eAAe,CAAC,MAAM,CAAC,CAAC;AAE1D,MAAM,MAAM,UAAU,GAAG,QAAQ,GAAG,WAAW,GAAG,WAAW,CAAC;AAE9D,MAAM,WAAW,aAAa;IAC5B,EAAE,EAAE,OAAO,CAAC;IACZ,IAAI,EAAE,SAAS,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;IAClB,QAAQ,CAAC,EAAE,WAAW,CAAC;CACxB;AAED,MAAM,WAAW,eAAgB,SAAQ,aAAa;IACpD,IAAI,EAAE,OAAO,CAAC;IACd,YAAY,EAAE,OAAO,CAAC;IACtB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,UAAU,EAAE,UAAU,CAAC;IACvB,YAAY,EAAE,eAAe,EAAE,CAAC;IAChC,UAAU,EAAE,UAAU,CAAC;IACvB,UAAU,EAAE,OAAO,CAAC;IACpB,eAAe,EAAE,OAAO,CAAC;IACzB,cAAc,EAAE,cAAc,CAAC;IAC/B,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED,MAAM,WAAW,gBAAiB,SAAQ,aAAa;IACrD,IAAI,EAAE,QAAQ,CAAC;IACf,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,EAAE,OAAO,CAAC;IAChB,MAAM,EAAE,YAAY,CAAC;IACrB,YAAY,EAAE,eAAe,EAAE,CAAC;CACjC;AAED,MAAM,WAAW,aAAa;IAC5B,EAAE,EAAE,OAAO,CAAC;IACZ,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,EAAE,OAAO,CAAC;IAChB,OAAO,EAAE,YAAY,CAAC;IACtB,SAAS,EAAE,sBAAsB,CAAC;IAClC,KAAK,EAAE,UAAU,CAAC;IAClB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,WAAW,CAAC;CACxB"}

package/dist/actors.js

@@ -1 +1,15 @@
-export {};
+export const AGENT_HARNESSES = [
+    "codex",
+    "claude",
+    "grok",
+    "grok-acp",
+    "kimi",
+    "flue",
+    "cursor",
+    "opencode",
+    "native",
+    "worker",
+    "bridge",
+    "http",
+    "pi",
+];

package/dist/agent-broker-feed.d.ts

@@ -0,0 +1,84 @@
+import type { AgentState, DeliveryTransport, MetadataMap, ScoutId } from "./common.js";
+import type { DeliveryAttempt, DeliveryIntent } from "./deliveries.js";
+import type { FlightRecord, InvocationRequest } from "./invocations.js";
+import type { MessageRecord } from "./messages.js";
+import type { ScoutDispatchRecord } from "./scout-dispatch.js";
+export type AgentBrokerFeedItemKind = "message" | "status" | "invocation" | "flight" | "delivery" | "delivery_attempt" | "dispatch";
+export type AgentBrokerFeedSeverity = "info" | "status" | "warning" | "error";
+export type AgentBrokerFeedSource = "activity" | "snapshot" | "delivery" | "dispatch";
+export interface AgentBrokerFeedEndpointStatus {
+    id: ScoutId;
+    nodeId: ScoutId;
+    harness: string;
+    transport: DeliveryTransport | string;
+    state: AgentState | string;
+    sessionId?: string;
+    projectRoot?: string;
+    cwd?: string;
+    lastError?: string;
+    lastFailureStage?: string;
+    updatedAt?: number;
+}
+export interface AgentBrokerFeedStatus {
+    agentId: ScoutId;
+    displayName?: string;
+    found: boolean;
+    agentState?: AgentState | string;
+    endpoints: AgentBrokerFeedEndpointStatus[];
+    activeFlightIds: ScoutId[];
+    pendingDeliveryIds: ScoutId[];
+    errorCount: number;
+    warningCount: number;
+    lastError?: string;
+    lastActivityAt?: number;
+}
+export interface AgentBrokerFeedItem {
+    id: string;
+    kind: AgentBrokerFeedItemKind;
+    severity: AgentBrokerFeedSeverity;
+    at: number;
+    title: string;
+    summary: string;
+    agentId?: ScoutId;
+    actorId?: ScoutId;
+    targetAgentId?: ScoutId;
+    conversationId?: ScoutId;
+    messageId?: ScoutId;
+    invocationId?: ScoutId;
+    flightId?: ScoutId;
+    deliveryId?: ScoutId;
+    dispatchId?: ScoutId;
+    status?: string;
+    reason?: string;
+    source: AgentBrokerFeedSource;
+    message?: MessageRecord;
+    invocation?: InvocationRequest;
+    flight?: FlightRecord;
+    delivery?: DeliveryIntent;
+    deliveryAttempt?: DeliveryAttempt;
+    dispatch?: ScoutDispatchRecord;
+    metadata?: MetadataMap;
+}
+export interface AgentBrokerFeedCounts {
+    items: number;
+    messages: number;
+    statuses: number;
+    invocations: number;
+    flights: number;
+    deliveries: number;
+    deliveryAttempts: number;
+    dispatches: number;
+    errors: number;
+    warnings: number;
+}
+export interface AgentBrokerFeed {
+    agentId: ScoutId;
+    generatedAt: number;
+    since: number | null;
+    limit: number;
+    cursor: number | null;
+    status: AgentBrokerFeedStatus;
+    counts: AgentBrokerFeedCounts;
+    items: AgentBrokerFeedItem[];
+}
+//# sourceMappingURL=agent-broker-feed.d.ts.map

package/dist/agent-broker-feed.d.ts.map

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

package/dist/agent-broker-feed.js

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

package/dist/agent-identity.d.ts

@@ -18,6 +18,7 @@ export interface AgentIdentityCandidate {
     profile?: string;
     harness?: string;
     model?: string;
+    referenceId?: string;
     aliases?: string[];
 }
 export interface AgentIdentityInput {
@@ -51,6 +52,12 @@ export declare function extractAgentMentions(text: string): {
     parsed: AgentIdentity[];
     unparsed: string[];
 };
+export declare function formatAgentReferenceIdentity<T extends AgentIdentityCandidate>(candidate: T, candidates: T[], options?: {
+    includeSigil?: boolean;
+    minLength?: number;
+    maxLength?: number;
+}): string;
+export declare function withAgentReferenceAliases<T extends AgentIdentityCandidate>(candidates: T[]): T[];
 export declare function agentIdentityMatches(identity: AgentIdentity, candidate: AgentIdentityCandidate): boolean;
 export declare function resolveAgentIdentity<T extends AgentIdentityCandidate>(identity: AgentIdentity, candidates: T[]): T | null;
 export type AgentIdentityDiagnosis<T extends AgentIdentityCandidate> = {
@@ -74,18 +81,34 @@ export declare function resolveAgentAlias(value: string, aliases: AgentIdentityA
 export declare function formatMinimalAgentIdentity<T extends AgentIdentityCandidate>(candidate: T, candidates: T[], options?: {
     includeSigil?: boolean;
 }): string;
+/** @deprecated Use {@link AgentIdentity} instead. */
 export type AgentAddress = AgentIdentity;
+/** @deprecated Use {@link AgentIdentityCandidate} instead. */
 export type AgentAddressCandidate = AgentIdentityCandidate;
+/** @deprecated Use {@link AgentIdentity} instead. */
 export type AgentSelector = AgentIdentity;
+/** @deprecated Use {@link AgentIdentityCandidate} instead. */
 export type AgentSelectorCandidate = AgentIdentityCandidate;
+/** @deprecated Use {@link parseAgentIdentity} instead. */
 export declare const parseAgentAddress: typeof parseAgentIdentity;
+/** @deprecated Use {@link formatAgentIdentity} instead. */
 export declare const formatAgentAddress: typeof formatAgentIdentity;
+/** @deprecated Use {@link constructAgentIdentity} instead. */
 export declare const constructAgentAddress: typeof constructAgentIdentity;
+/** @deprecated Use {@link extractAgentIdentities} instead. */
 export declare const extractAgentAddresses: typeof extractAgentIdentities;
+/** @deprecated Use {@link agentIdentityMatches} instead. */
 export declare const agentAddressMatches: typeof agentIdentityMatches;
+/** @deprecated Use {@link resolveAgentIdentity} instead. */
 export declare const resolveAgentAddress: typeof resolveAgentIdentity;
+/** @deprecated Use {@link parseAgentIdentity} instead. */
 export declare const parseAgentSelector: typeof parseAgentIdentity;
+/** @deprecated Use {@link formatAgentIdentity} instead. */
 export declare const formatAgentSelector: typeof formatAgentIdentity;
+/** @deprecated Use {@link extractAgentIdentities} instead. */
 export declare const extractAgentSelectors: typeof extractAgentIdentities;
+/** @deprecated Use {@link agentIdentityMatches} instead. */
 export declare const agentSelectorMatches: typeof agentIdentityMatches;
+/** @deprecated Use {@link resolveAgentIdentity} instead. */
 export declare const resolveAgentSelector: typeof resolveAgentIdentity;
+//# sourceMappingURL=agent-identity.d.ts.map

package/dist/agent-identity.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-identity.d.ts","sourceRoot":"","sources":["../src/agent-identity.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAE3C,MAAM,MAAM,sBAAsB,GAAG,WAAW,GAAG,SAAS,GAAG,SAAS,GAAG,OAAO,GAAG,MAAM,CAAC;AAE5F,MAAM,WAAW,aAAa;IAC5B,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;IACd,YAAY,EAAE,OAAO,CAAC;IACtB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,sBAAsB;IACrC,OAAO,EAAE,OAAO,CAAC;IACjB,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;CACpB;AAED,MAAM,WAAW,kBAAkB;IACjC,YAAY,EAAE,OAAO,CAAC;IACtB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,kBAAkB;IACjC,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,kBAAkB,CAAC;CAC5B;AAsBD,wBAAgB,6BAA6B,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAOnE;AAED,eAAO,MAAM,6BAA6B,sCAAgC,CAAC;AAE3E,eAAO,MAAM,yBAAyB,UAAU,CAAC;AACjD,eAAO,MAAM,8BAA8B,cAAc,CAAC;AAE1D,eAAO,MAAM,6BAA6B,EAAE,WAAW,CAAC,MAAM,CAK5D,CAAC;AAEH,wBAAgB,0BAA0B,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,OAAO,CAGpF;AAMD,wBAAgB,2BAA2B,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,OAAO,CAGrF;AA6ID,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,MAAM,GAAG,aAAa,GAAG,IAAI,CAetE;AAED,wBAAgB,mBAAmB,CACjC,KAAK,EAAE,kBAAkB,EACzB,OAAO,GAAE;IAAE,YAAY,CAAC,EAAE,OAAO,CAAA;CAAO,GACvC,MAAM,CA0BR;AAED,wBAAgB,sBAAsB,CACpC,KAAK,EAAE,kBAAkB,EACzB,OAAO,GAAE;IAAE,GAAG,CAAC,EAAE,MAAM,CAAA;CAAO,GAC7B,aAAa,GAAG,IAAI,CAgBtB;AAED,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,MAAM,GAAG,aAAa,EAAE,CAEpE;AAED,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,GAAG;IAAE,MAAM,EAAE,aAAa,EAAE,CAAC;IAAC,QAAQ,EAAE,MAAM,EAAE,CAAA;CAAE,CAsBlG;AA6ID,wBAAgB,4BAA4B,CAAC,CAAC,SAAS,sBAAsB,EAC3E,SAAS,EAAE,CAAC,EACZ,UAAU,EAAE,CAAC,EAAE,EACf,OAAO,GAAE;IAAE,YAAY,CAAC,EAAE,OAAO,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,CAAA;CAAO,GAC/E,MAAM,CAqCR;AAED,wBAAgB,yBAAyB,CAAC,CAAC,SAAS,sBAAsB,EACxE,UAAU,EAAE,CAAC,EAAE,GACd,CAAC,EAAE,CASL;AA+CD,wBAAgB,oBAAoB,CAClC,QAAQ,EAAE,aAAa,EACvB,SAAS,EAAE,sBAAsB,GAChC,OAAO,CAoCT;AAED,wBAAgB,oBAAoB,CAAC,CAAC,SAAS,sBAAsB,EACnE,QAAQ,EAAE,aAAa,EACvB,UAAU,EAAE,CAAC,EAAE,GACd,CAAC,GAAG,IAAI,CAGV;AAED,MAAM,MAAM,sBAAsB,CAAC,CAAC,SAAS,sBAAsB,IAC/D;IAAE,IAAI,EAAE,UAAU,CAAC;IAAC,KAAK,EAAE,CAAC,CAAA;CAAE,GAC9B;IAAE,IAAI,EAAE,WAAW,CAAC;IAAC,UAAU,EAAE,CAAC,EAAE,CAAA;CAAE,GACtC;IAAE,IAAI,EAAE,SAAS,CAAA;CAAE,CAAC;AAExB,wBAAgB,qBAAqB,CAAC,CAAC,SAAS,sBAAsB,EACpE,QAAQ,EAAE,aAAa,EACvB,UAAU,EAAE,CAAC,EAAE,GACd,sBAAsB,CAAC,CAAC,CAAC,CAsC3B;AAED,wBAAgB,mBAAmB,CAAC,KAAK,EAAE;IACzC,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,kBAAkB,CAAC;CAC5B,GAAG,kBAAkB,GAAG,IAAI,CAQ5B;AAED,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,kBAAkB,EAAE,OAAO,GAAE;IAAE,YAAY,CAAC,EAAE,OAAO,CAAA;CAAO,GAAG,MAAM,CAG5G;AAED,wBAAgB,iBAAiB,CAC/B,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,kBAAkB,EAAE,GAC5B,aAAa,GAAG,IAAI,CAYtB;AAmDD,wBAAgB,0BAA0B,CAAC,CAAC,SAAS,sBAAsB,EACzE,SAAS,EAAE,CAAC,EACZ,UAAU,EAAE,CAAC,EAAE,EACf,OAAO,GAAE;IAAE,YAAY,CAAC,EAAE,OAAO,CAAA;CAAO,GACvC,MAAM,CA8CR;AAED,qDAAqD;AACrD,MAAM,MAAM,YAAY,GAAG,aAAa,CAAC;AACzC,8DAA8D;AAC9D,MAAM,MAAM,qBAAqB,GAAG,sBAAsB,CAAC;AAC3D,qDAAqD;AACrD,MAAM,MAAM,aAAa,GAAG,aAAa,CAAC;AAC1C,8DAA8D;AAC9D,MAAM,MAAM,sBAAsB,GAAG,sBAAsB,CAAC;AAE5D,0DAA0D;AAC1D,eAAO,MAAM,iBAAiB,2BAAqB,CAAC;AACpD,2DAA2D;AAC3D,eAAO,MAAM,kBAAkB,4BAAsB,CAAC;AACtD,8DAA8D;AAC9D,eAAO,MAAM,qBAAqB,+BAAyB,CAAC;AAC5D,8DAA8D;AAC9D,eAAO,MAAM,qBAAqB,+BAAyB,CAAC;AAC5D,4DAA4D;AAC5D,eAAO,MAAM,mBAAmB,6BAAuB,CAAC;AACxD,4DAA4D;AAC5D,eAAO,MAAM,mBAAmB,6BAAuB,CAAC;AAExD,0DAA0D;AAC1D,eAAO,MAAM,kBAAkB,2BAAqB,CAAC;AACrD,2DAA2D;AAC3D,eAAO,MAAM,mBAAmB,4BAAsB,CAAC;AACvD,8DAA8D;AAC9D,eAAO,MAAM,qBAAqB,+BAAyB,CAAC;AAC5D,4DAA4D;AAC5D,eAAO,MAAM,oBAAoB,6BAAuB,CAAC;AACzD,4DAA4D;AAC5D,eAAO,MAAM,oBAAoB,6BAAuB,CAAC"}