@agent-native/agentkit 0.1.0

package/dist/protocol/agui.js

@@ -0,0 +1,253 @@
+import { EventType } from "@ag-ui/core";
+import { AgentProtocolValidationError, parseAgentApprovalResponse, } from "./validation.js";
+/**
+ * The profile identifier carried on every frame. AG-UI has no protocol version
+ * of its own, so a reader that cannot recognise this string must not assume the
+ * Builder extensions below are absent — it must refuse the stream.
+ */
+export const AGENTKIT_PROFILE_NAME = "builder.agentkit";
+export const AGENTKIT_PROFILE_VERSION = 1;
+export const AGENTKIT_PROFILE_ID = `${AGENTKIT_PROFILE_NAME}.v${AGENTKIT_PROFILE_VERSION}`;
+/**
+ * Namespace for the Builder events that AG-UI has no counterpart for. They ride
+ * on `CUSTOM` as `<AGENTKIT_PROFILE_ID>/<domain event type>`.
+ */
+export const AGENTKIT_PROFILE_EVENT_PREFIX = `${AGENTKIT_PROFILE_ID}/`;
+/**
+ * Single metadata key holding every Builder extension. `@ag-ui/core` reserves
+ * `AGUI_METADATA_KEY` ("ag-ui") for itself, so nesting under one owned key
+ * keeps the two from colliding as either side adds fields.
+ */
+export const AGENTKIT_METADATA_KEY = AGENTKIT_PROFILE_NAME;
+/** HTTP header advertising the profile so negotiation fails before streaming. */
+export const AGENTKIT_PROFILE_HEADER = "x-agentkit-profile";
+/**
+ * Domain event types that reach a native AG-UI event, and which one.
+ *
+ * Reaching a native event is not the same as fitting in it. Only the types in
+ * {@link AGENTKIT_LOSSLESS_EVENT_TYPES} survive the trip on native fields
+ * alone; every other entry here also ships its domain payload in
+ * `residual`, because AG-UI's event carries a strict subset of the fields.
+ * `activity.updated` is the sharpest case: AG-UI's `ACTIVITY_DELTA` is a JSON
+ * Patch against prior state, which a stateless encoder cannot produce, so all
+ * three activity events map to `ACTIVITY_SNAPSHOT` instead.
+ */
+export const AGENTKIT_NATIVE_EVENT_TYPES = {
+    "run.started": EventType.RUN_STARTED,
+    "run.completed": EventType.RUN_FINISHED,
+    "run.failed": EventType.RUN_ERROR,
+    "run.status": EventType.STEP_STARTED,
+    "message.created": EventType.TEXT_MESSAGE_START,
+    "message.delta": EventType.TEXT_MESSAGE_CONTENT,
+    "message.completed": EventType.TEXT_MESSAGE_END,
+    "reasoning.delta": EventType.REASONING_MESSAGE_CONTENT,
+    "tool.started": EventType.TOOL_CALL_START,
+    "tool.delta": EventType.TOOL_CALL_ARGS,
+    "tool.updated": EventType.TOOL_CALL_RESULT,
+    "activity.started": EventType.ACTIVITY_SNAPSHOT,
+    "activity.updated": EventType.ACTIVITY_SNAPSHOT,
+    "activity.completed": EventType.ACTIVITY_SNAPSHOT,
+    "agent.registered": EventType.SUBAGENT_STARTED,
+    "agent.unregistered": EventType.SUBAGENT_FINISHED,
+    "approval.requested": EventType.RUN_FINISHED,
+};
+/**
+ * The mappings that need no residual. Two, out of the twelve the evaluation
+ * table calls "Direct" — the rest carry structure AG-UI's event has no slot
+ * for, so "direct" describes the event name, not the payload.
+ */
+export const AGENTKIT_LOSSLESS_EVENT_TYPES = [
+    "reasoning.delta",
+    "message.delta",
+];
+const LOSSLESS_EVENT_TYPE_SET = new Set(AGENTKIT_LOSSLESS_EVENT_TYPES);
+export function isNativeEventType(type) {
+    return type in AGENTKIT_NATIVE_EVENT_TYPES;
+}
+/**
+ * `message.delta` only fits when it does not set `format`; AG-UI's
+ * `TEXT_MESSAGE_CONTENT` has no formatting field.
+ */
+export function isLosslessEventType(type) {
+    return LOSSLESS_EVENT_TYPE_SET.has(type);
+}
+/**
+ * Everything else. These have no AG-UI counterpart at all and are the reason
+ * the profile exists: adopting AG-UI wholesale would delete the capabilities
+ * behind them, not express them differently.
+ *
+ * `approval.resolved` sits here rather than with the native mappings because
+ * AG-UI models resolution only as a `resume[]` command on the next run input.
+ * The command exists, but there is no event announcing it to other observers of
+ * the thread, so the profile keeps one.
+ */
+export const AGENTKIT_PROFILE_EVENT_TYPES = [
+    "run.cancelled",
+    "approval.resolved",
+    "agent.updated",
+    "agent.interaction",
+    "connection.requested",
+    "connection.updated",
+    "task.created",
+    "task.updated",
+    "task.completed",
+    "task-group.created",
+    "task-group.updated",
+    "task-group.completed",
+    "task-group.removed",
+    "artifact.created",
+    "widget.created",
+    "widget.updated",
+    "widget.removed",
+    "annotation.created",
+    "annotation.updated",
+    "annotation.removed",
+    "suggestions.updated",
+    "action.started",
+    "action.completed",
+    "action.failed",
+    "upload.progress",
+    "client.effect",
+    "client.deeplink",
+    "thread.updated",
+    "queue.updated",
+];
+const PROFILE_EVENT_TYPE_SET = new Set(AGENTKIT_PROFILE_EVENT_TYPES);
+/** Host-defined `x-*` events also travel as profile events. */
+export function isProfileEventType(type) {
+    return PROFILE_EVENT_TYPE_SET.has(type) || type.startsWith("x-");
+}
+export function profileEventName(type) {
+    return `${AGENTKIT_PROFILE_EVENT_PREFIX}${type}`;
+}
+/**
+ * Returns the domain event type for a `CUSTOM` name, or `undefined` when the
+ * name belongs to another profile. A foreign `CUSTOM` is another producer's
+ * business, not a malformed frame, so it is skipped rather than rejected.
+ */
+export function profileEventTypeFromName(name) {
+    if (!name.startsWith(AGENTKIT_PROFILE_EVENT_PREFIX))
+        return undefined;
+    return name.slice(AGENTKIT_PROFILE_EVENT_PREFIX.length);
+}
+function requireRecord(value, path) {
+    if (typeof value !== "object" || value === null || Array.isArray(value)) {
+        throw new AgentProtocolValidationError(path, "expected an object");
+    }
+    return value;
+}
+/**
+ * Reads the Builder extension off an AG-UI frame. A frame that reached an
+ * AgentKit consumer without it is unreadable, not empty: silently defaulting
+ * `seq` would let the reducer accept a stream it can no longer detect gaps in.
+ */
+export function readProfileExtension(metadata, path = "metadata") {
+    const container = requireRecord(metadata, path);
+    const extension = requireRecord(container[AGENTKIT_METADATA_KEY], `${path}.${AGENTKIT_METADATA_KEY}`);
+    const extensionPath = `${path}.${AGENTKIT_METADATA_KEY}`;
+    const version = extension.v;
+    if (version !== AGENTKIT_PROFILE_VERSION) {
+        throw new AgentProtocolValidationError(`${extensionPath}.v`, `unsupported profile version ${JSON.stringify(version)}; expected ${AGENTKIT_PROFILE_VERSION}`);
+    }
+    const domainType = extension.t;
+    if (typeof domainType !== "string" || domainType.length === 0) {
+        throw new AgentProtocolValidationError(`${extensionPath}.t`, "expected a domain event type");
+    }
+    const seq = extension.seq;
+    if (typeof seq !== "number" || !Number.isSafeInteger(seq) || seq < 1) {
+        throw new AgentProtocolValidationError(`${extensionPath}.seq`, "expected a positive safe integer sequence");
+    }
+    const id = extension.id;
+    if (typeof id !== "string" || id.length === 0) {
+        throw new AgentProtocolValidationError(`${extensionPath}.id`, "expected a non-empty event id");
+    }
+    const at = extension.at;
+    if (typeof at !== "string" || Number.isNaN(Date.parse(at))) {
+        throw new AgentProtocolValidationError(`${extensionPath}.at`, "expected an ISO-8601 timestamp");
+    }
+    const meta = extension.meta === undefined
+        ? undefined
+        : requireRecord(extension.meta, `${extensionPath}.meta`);
+    const residual = extension.residual === undefined
+        ? undefined
+        : requireRecord(extension.residual, `${extensionPath}.residual`);
+    return {
+        v: AGENTKIT_PROFILE_VERSION,
+        t: domainType,
+        seq,
+        id,
+        at,
+        meta,
+        residual,
+    };
+}
+export function writeProfileExtension(extension) {
+    const value = {
+        v: AGENTKIT_PROFILE_VERSION,
+        t: extension.t,
+        seq: extension.seq,
+        id: extension.id,
+        at: extension.at,
+    };
+    if (extension.meta !== undefined)
+        value.meta = extension.meta;
+    if (extension.residual !== undefined)
+        value.residual = extension.residual;
+    return { [AGENTKIT_METADATA_KEY]: value };
+}
+/**
+ * Approval decisions travel as AG-UI resume entries. Both directions live here
+ * so the client that writes an entry and the runtime that reads one cannot
+ * drift into two different payload shapes.
+ */
+export function resumeEntryFromApproval(input) {
+    return {
+        interruptId: input.approvalId,
+        status: "resolved",
+        payload: {
+            ...input.response,
+            ...(input.optionId === undefined ? {} : { optionId: input.optionId }),
+        },
+    };
+}
+function resumePayload(entry) {
+    return requireRecord(entry.payload, "resume.payload");
+}
+function approvalResponseFromPayload(payload) {
+    if (payload.decision !== "approve" && payload.decision !== "deny") {
+        throw new AgentProtocolValidationError("resume.payload.decision", 'An approval response must include decision "approve" or "deny".');
+    }
+    return parseAgentApprovalResponse({
+        decision: payload.decision,
+        ...(payload.optionIds === undefined
+            ? {}
+            : { optionIds: payload.optionIds }),
+        ...(payload.other === undefined ? {} : { other: payload.other }),
+        ...(payload.input === undefined ? {} : { input: payload.input }),
+    }, "resume.payload");
+}
+export function approvalResponseFromResume(entry) {
+    if (entry.status === "cancelled") {
+        if (entry.payload === undefined)
+            return { decision: "deny" };
+        const payload = resumePayload(entry);
+        if (payload.decision !== undefined && payload.decision !== "deny") {
+            throw new AgentProtocolValidationError("resume.payload.decision", 'A cancelled interrupt cannot contain an "approve" decision.');
+        }
+        return approvalResponseFromPayload({ ...payload, decision: "deny" });
+    }
+    const payload = resumePayload(entry);
+    return approvalResponseFromPayload(payload);
+}
+export function resumeOptionId(entry) {
+    if (entry.payload === undefined)
+        return undefined;
+    const optionId = resumePayload(entry).optionId;
+    if (optionId === undefined)
+        return undefined;
+    if (typeof optionId !== "string" || optionId.length === 0) {
+        throw new AgentProtocolValidationError("resume.payload.optionId", "expected a non-empty string");
+    }
+    return optionId;
+}
+//# sourceMappingURL=agui.js.map

package/dist/protocol/agui.js.map

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

package/dist/protocol/compatibility.d.ts

@@ -0,0 +1,35 @@
+import type { AgentCapabilities, AgentCapabilitiesDiscovery, AgentCapabilityAffordance, AgentCapabilityDescriptor, AgentCapabilityId, AgentProtocolCompatibility, AgentProtocolVersionOffer } from "./index.js";
+import { type AgentKitProtocolVersion } from "./version.js";
+/** Selects the highest mutually supported version and never guesses a fallback. */
+export declare function negotiateAgentKitProtocolVersion(peer: AgentProtocolVersionOffer, options?: {
+    correlationId?: string;
+}): AgentProtocolCompatibility;
+export declare function createAgentKitProtocolVersionOffer(): AgentProtocolVersionOffer;
+export declare function getAgentCapabilityStatus(discovery: AgentCapabilitiesDiscovery, capability: AgentCapabilityId): AgentCapabilityDescriptor | undefined;
+/**
+ * Enforces discovery semantics at a call site. Omitted descriptors are unknown,
+ * not silently unsupported, and therefore fail as temporarily unavailable.
+ */
+export declare function requireAgentCapability(discovery: AgentCapabilitiesDiscovery, capability: AgentCapabilityId): AgentCapabilityDescriptor;
+/**
+ * Lossy on purpose: the boolean map has no way to say "degraded" or "down
+ * right now", so it reports both as available and omits what discovery did
+ * not mention. Anything that gates behavior must use
+ * `resolveAgentCapabilityAffordance` against the descriptors instead.
+ */
+export declare function projectAgentCapabilities(discovery: AgentCapabilitiesDiscovery): AgentCapabilities;
+/**
+ * The single place capability presentation is decided. Enforcement in the
+ * client already branches on all four descriptor states, so a caller that
+ * reads the boolean projection instead will show controls the client then
+ * rejects, and hide ones that work. Both directions are silent.
+ */
+export declare function resolveAgentCapabilityAffordance(source: {
+    discovery?: AgentCapabilitiesDiscovery;
+    capabilities?: AgentCapabilities;
+}, capability: AgentCapabilityId): AgentCapabilityAffordance;
+/** Type-only assertion that keeps future protocol unions narrow. */
+export declare function asAgentKitProtocolVersion(compatibility: Extract<AgentProtocolCompatibility, {
+    status: "compatible";
+}>): AgentKitProtocolVersion;
+//# sourceMappingURL=compatibility.d.ts.map

package/dist/protocol/compatibility.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"compatibility.d.ts","sourceRoot":"","sources":["../../src/protocol/compatibility.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EACV,iBAAiB,EACjB,0BAA0B,EAC1B,yBAAyB,EACzB,yBAAyB,EACzB,iBAAiB,EACjB,0BAA0B,EAC1B,yBAAyB,EAC1B,MAAM,YAAY,CAAC;AACpB,OAAO,EAGL,KAAK,uBAAuB,EAC7B,MAAM,cAAc,CAAC;AAkBtB,mFAAmF;AACnF,wBAAgB,gCAAgC,CAC9C,IAAI,EAAE,yBAAyB,EAC/B,OAAO,GAAE;IAAE,aAAa,CAAC,EAAE,MAAM,CAAA;CAAO,GACvC,0BAA0B,CA+B5B;AAED,wBAAgB,kCAAkC,IAAI,yBAAyB,CAK9E;AAED,wBAAgB,wBAAwB,CACtC,SAAS,EAAE,0BAA0B,EACrC,UAAU,EAAE,iBAAiB,GAC5B,yBAAyB,GAAG,SAAS,CAEvC;AAED;;;GAGG;AACH,wBAAgB,sBAAsB,CACpC,SAAS,EAAE,0BAA0B,EACrC,UAAU,EAAE,iBAAiB,GAC5B,yBAAyB,CAiB3B;AAED;;;;;GAKG;AACH,wBAAgB,wBAAwB,CACtC,SAAS,EAAE,0BAA0B,GACpC,iBAAiB,CAgBnB;AAED;;;;;GAKG;AACH,wBAAgB,gCAAgC,CAC9C,MAAM,EAAE;IACN,SAAS,CAAC,EAAE,0BAA0B,CAAC;IACvC,YAAY,CAAC,EAAE,iBAAiB,CAAC;CAClC,EACD,UAAU,EAAE,iBAAiB,GAC5B,yBAAyB,CAyD3B;AAED,oEAAoE;AACpE,wBAAgB,yBAAyB,CACvC,aAAa,EAAE,OAAO,CAAC,0BAA0B,EAAE;IAAE,MAAM,EAAE,YAAY,CAAA;CAAE,CAAC,GAC3E,uBAAuB,CAEzB"}

package/dist/protocol/compatibility.js

@@ -0,0 +1,160 @@
+import { AgentKitProtocolError, createCapabilityUnavailableError, createProtocolVersionUnsupportedError, } from "./errors.js";
+import { AGENTKIT_PROTOCOL_NAME, AGENTKIT_SUPPORTED_PROTOCOL_VERSIONS, } from "./version.js";
+function validatedVersions(values, name) {
+    if (!Array.isArray(values) || values.length === 0) {
+        throw new TypeError(`${name} must contain at least one protocol version.`);
+    }
+    const versions = values.map((value) => {
+        if (!Number.isSafeInteger(value) || value < 1) {
+            throw new TypeError(`${name} must contain positive safe integers.`);
+        }
+        return value;
+    });
+    if (new Set(versions).size !== versions.length) {
+        throw new TypeError(`${name} must not contain duplicate versions.`);
+    }
+    return versions;
+}
+/** Selects the highest mutually supported version and never guesses a fallback. */
+export function negotiateAgentKitProtocolVersion(peer, options = {}) {
+    if (peer.protocol !== AGENTKIT_PROTOCOL_NAME) {
+        throw new TypeError(`protocol must be ${JSON.stringify(AGENTKIT_PROTOCOL_NAME)}.`);
+    }
+    const peerVersions = validatedVersions(peer.versions, "peer.versions");
+    const localVersions = [...AGENTKIT_SUPPORTED_PROTOCOL_VERSIONS];
+    const selectedVersion = [...localVersions]
+        .sort((left, right) => right - left)
+        .find((version) => peerVersions.includes(version));
+    if (selectedVersion !== undefined) {
+        return {
+            status: "compatible",
+            selectedVersion,
+            localVersions,
+            peerVersions,
+        };
+    }
+    return {
+        status: "incompatible",
+        localVersions,
+        peerVersions,
+        error: createProtocolVersionUnsupportedError(localVersions, peerVersions, options),
+    };
+}
+export function createAgentKitProtocolVersionOffer() {
+    return {
+        protocol: AGENTKIT_PROTOCOL_NAME,
+        versions: [...AGENTKIT_SUPPORTED_PROTOCOL_VERSIONS],
+    };
+}
+export function getAgentCapabilityStatus(discovery, capability) {
+    return discovery.capabilities.find((entry) => entry.id === capability);
+}
+/**
+ * Enforces discovery semantics at a call site. Omitted descriptors are unknown,
+ * not silently unsupported, and therefore fail as temporarily unavailable.
+ */
+export function requireAgentCapability(discovery, capability) {
+    const descriptor = getAgentCapabilityStatus(discovery, capability);
+    if (!descriptor) {
+        throw new AgentKitProtocolError(createCapabilityUnavailableError(capability, {
+            message: `The ${JSON.stringify(capability)} capability was not included in discovery.`,
+            retryable: true,
+        }));
+    }
+    if (descriptor.state === "unsupported") {
+        throw new AgentKitProtocolError(descriptor.error);
+    }
+    if (descriptor.state === "unavailable") {
+        throw new AgentKitProtocolError(descriptor.error);
+    }
+    return descriptor;
+}
+/**
+ * Lossy on purpose: the boolean map has no way to say "degraded" or "down
+ * right now", so it reports both as available and omits what discovery did
+ * not mention. Anything that gates behavior must use
+ * `resolveAgentCapabilityAffordance` against the descriptors instead.
+ */
+export function projectAgentCapabilities(discovery) {
+    const projected = {
+        protocolVersion: discovery.protocol.status === "compatible"
+            ? discovery.protocol.selectedVersion
+            : undefined,
+    };
+    for (const capability of discovery.capabilities) {
+        if (capability.id === "reasoning")
+            continue;
+        if (capability.state === "available" || capability.state === "degraded") {
+            projected[capability.id] = true;
+        }
+        else if (capability.state === "unsupported") {
+            projected[capability.id] = false;
+        }
+    }
+    return projected;
+}
+/**
+ * The single place capability presentation is decided. Enforcement in the
+ * client already branches on all four descriptor states, so a caller that
+ * reads the boolean projection instead will show controls the client then
+ * rejects, and hide ones that work. Both directions are silent.
+ */
+export function resolveAgentCapabilityAffordance(source, capability) {
+    const descriptor = source.discovery
+        ? getAgentCapabilityStatus(source.discovery, capability)
+        : undefined;
+    if (descriptor) {
+        const reason = descriptor.error?.message ?? descriptor.description;
+        switch (descriptor.state) {
+            case "available":
+                return {
+                    id: capability,
+                    state: "available",
+                    visible: true,
+                    enabled: true,
+                };
+            case "degraded":
+                return {
+                    id: capability,
+                    state: "degraded",
+                    visible: true,
+                    enabled: true,
+                    reason,
+                };
+            case "unavailable":
+                return {
+                    id: capability,
+                    state: "unavailable",
+                    visible: true,
+                    enabled: false,
+                    reason,
+                };
+            case "unsupported":
+                return {
+                    id: capability,
+                    state: "unsupported",
+                    visible: false,
+                    enabled: false,
+                    reason,
+                };
+        }
+    }
+    // Discovery that ran and omitted the capability is reporting unknown, not
+    // unsupported, so it must not be read as a denial.
+    if (source.discovery) {
+        return { id: capability, state: "unknown", visible: false, enabled: false };
+    }
+    const projected = source.capabilities?.[capability];
+    if (projected === undefined) {
+        return { id: capability, state: "unknown", visible: false, enabled: false };
+    }
+    const supported = capability === "reasoning" ? projected !== "none" : projected === true;
+    return supported
+        ? { id: capability, state: "available", visible: true, enabled: true }
+        : { id: capability, state: "unsupported", visible: false, enabled: false };
+}
+/** Type-only assertion that keeps future protocol unions narrow. */
+export function asAgentKitProtocolVersion(compatibility) {
+    return compatibility.selectedVersion;
+}
+//# sourceMappingURL=compatibility.js.map

package/dist/protocol/compatibility.js.map

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

package/dist/protocol/errors.d.ts

@@ -0,0 +1,24 @@
+import type { AgentCapabilityId, AgentCapabilityUnavailableError, AgentCapabilityUnsupportedError, AgentError, AgentOperationUnsupportedError, AgentRequestAbortedError, AgentProtocolMetadata, AgentProtocolVersionUnsupportedError } from "./index.js";
+export interface AgentErrorOptions {
+    message?: string;
+    correlationId?: string;
+    details?: unknown;
+    metadata?: AgentProtocolMetadata;
+}
+/** Error thrown by transports while retaining the serializable wire error. */
+export declare class AgentKitProtocolError<TError extends AgentError = AgentError> extends Error {
+    readonly protocolError: TError;
+    readonly code: TError["code"];
+    readonly retryable: TError["retryable"];
+    readonly correlationId: TError["correlationId"];
+    constructor(protocolError: TError);
+}
+export declare function createCapabilityUnsupportedError(capability: AgentCapabilityId, options?: AgentErrorOptions): AgentCapabilityUnsupportedError;
+export declare function createCapabilityUnavailableError(capability: AgentCapabilityId, options?: AgentErrorOptions & {
+    retryable?: boolean;
+}): AgentCapabilityUnavailableError;
+export declare function createOperationUnsupportedError(operation: string, options?: AgentErrorOptions): AgentOperationUnsupportedError;
+export declare function createRequestAbortedError(options?: AgentErrorOptions): AgentRequestAbortedError;
+export declare function createProtocolVersionUnsupportedError(supportedVersions: AgentProtocolVersionUnsupportedError["supportedVersions"], receivedVersions: number[], options?: AgentErrorOptions): AgentProtocolVersionUnsupportedError;
+export declare function isAgentKitProtocolError(value: unknown): value is AgentKitProtocolError;
+//# sourceMappingURL=errors.d.ts.map

package/dist/protocol/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/protocol/errors.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,iBAAiB,EACjB,+BAA+B,EAC/B,+BAA+B,EAC/B,UAAU,EACV,8BAA8B,EAC9B,wBAAwB,EACxB,qBAAqB,EACrB,oCAAoC,EACrC,MAAM,YAAY,CAAC;AAEpB,MAAM,WAAW,iBAAiB;IAChC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,QAAQ,CAAC,EAAE,qBAAqB,CAAC;CAClC;AAcD,8EAA8E;AAC9E,qBAAa,qBAAqB,CAChC,MAAM,SAAS,UAAU,GAAG,UAAU,CACtC,SAAQ,KAAK;aAKsB,aAAa,EAAE,MAAM;IAJxD,SAAgB,IAAI,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC;IACrC,SAAgB,SAAS,EAAE,MAAM,CAAC,WAAW,CAAC,CAAC;IAC/C,SAAgB,aAAa,EAAE,MAAM,CAAC,eAAe,CAAC,CAAC;IAEvD,YAAmC,aAAa,EAAE,MAAM,EAMvD;CACF;AAED,wBAAgB,gCAAgC,CAC9C,UAAU,EAAE,iBAAiB,EAC7B,OAAO,GAAE,iBAAsB,GAC9B,+BAA+B,CAUjC;AAED,wBAAgB,gCAAgC,CAC9C,UAAU,EAAE,iBAAiB,EAC7B,OAAO,GAAE,iBAAiB,GAAG;IAAE,SAAS,CAAC,EAAE,OAAO,CAAA;CAAO,GACxD,+BAA+B,CAUjC;AAED,wBAAgB,+BAA+B,CAC7C,SAAS,EAAE,MAAM,EACjB,OAAO,GAAE,iBAAsB,GAC9B,8BAA8B,CAUhC;AAED,wBAAgB,yBAAyB,CACvC,OAAO,GAAE,iBAAsB,GAC9B,wBAAwB,CAO1B;AAED,wBAAgB,qCAAqC,CACnD,iBAAiB,EAAE,oCAAoC,CAAC,mBAAmB,CAAC,EAC5E,gBAAgB,EAAE,MAAM,EAAE,EAC1B,OAAO,GAAE,iBAAsB,GAC9B,oCAAoC,CAatC;AAED,wBAAgB,uBAAuB,CACrC,KAAK,EAAE,OAAO,GACb,KAAK,IAAI,qBAAqB,CAEhC"}

package/dist/protocol/errors.js

@@ -0,0 +1,77 @@
+function optionalErrorFields(options) {
+    return {
+        ...(options.correlationId === undefined
+            ? {}
+            : { correlationId: options.correlationId }),
+        ...(options.details === undefined ? {} : { details: options.details }),
+        ...(options.metadata === undefined ? {} : { metadata: options.metadata }),
+    };
+}
+/** Error thrown by transports while retaining the serializable wire error. */
+export class AgentKitProtocolError extends Error {
+    protocolError;
+    code;
+    retryable;
+    correlationId;
+    constructor(protocolError) {
+        super(protocolError.message);
+        this.protocolError = protocolError;
+        this.name = "AgentKitProtocolError";
+        this.code = protocolError.code;
+        this.retryable = protocolError.retryable;
+        this.correlationId = protocolError.correlationId;
+    }
+}
+export function createCapabilityUnsupportedError(capability, options = {}) {
+    return {
+        code: "capability_unsupported",
+        capability,
+        message: options.message ??
+            `The ${JSON.stringify(capability)} capability is unsupported.`,
+        retryable: false,
+        ...optionalErrorFields(options),
+    };
+}
+export function createCapabilityUnavailableError(capability, options = {}) {
+    return {
+        code: "capability_unavailable",
+        capability,
+        message: options.message ??
+            `The ${JSON.stringify(capability)} capability is currently unavailable.`,
+        retryable: options.retryable ?? true,
+        ...optionalErrorFields(options),
+    };
+}
+export function createOperationUnsupportedError(operation, options = {}) {
+    return {
+        code: "operation_unsupported",
+        operation,
+        message: options.message ??
+            `The ${JSON.stringify(operation)} operation is unsupported.`,
+        retryable: false,
+        ...optionalErrorFields(options),
+    };
+}
+export function createRequestAbortedError(options = {}) {
+    return {
+        code: "request_aborted",
+        message: options.message ?? "The AgentKit operation was aborted.",
+        retryable: false,
+        ...optionalErrorFields(options),
+    };
+}
+export function createProtocolVersionUnsupportedError(supportedVersions, receivedVersions, options = {}) {
+    return {
+        code: "protocol_version_unsupported",
+        supportedVersions: [...supportedVersions],
+        receivedVersions: [...receivedVersions],
+        message: options.message ??
+            `No compatible AgentKit protocol version was offered. Supported versions: ${supportedVersions.join(", ") || "none"}.`,
+        retryable: false,
+        ...optionalErrorFields(options),
+    };
+}
+export function isAgentKitProtocolError(value) {
+    return value instanceof AgentKitProtocolError;
+}
+//# sourceMappingURL=errors.js.map

package/dist/protocol/errors.js.map

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