Skip to main content

Variable: KernelErrorCode

const KernelErrorCode: object

Defined in: packages/plugin-sdk/src/kernel/errors.ts:12

Stable kernel-level error codes (rev4 §A2, §M2).

Type Declaration

BACKEND_UNAVAILABLE

readonly BACKEND_UNAVAILABLE: "BACKEND_UNAVAILABLE" = 'BACKEND_UNAVAILABLE'

Backend plugin runtime is unavailable or crashed.

CAPABILITY_DENIED

readonly CAPABILITY_DENIED: "CAPABILITY_DENIED" = 'CAPABILITY_DENIED'

The requested capability is not granted, expired or revoked.

CAPABILITY_REVOKED

readonly CAPABILITY_REVOKED: "CAPABILITY_REVOKED" = 'CAPABILITY_REVOKED'

A granted capability was revoked while the operation was in flight.

EVENT_BUFFER_EVICTED

readonly EVENT_BUFFER_EVICTED: "EVENT_BUFFER_EVICTED" = 'EVENT_BUFFER_EVICTED'

Buffered events were evicted before the consumer read them (§41).

EVENT_CURSOR_EXPIRED

readonly EVENT_CURSOR_EXPIRED: "EVENT_CURSOR_EXPIRED" = 'EVENT_CURSOR_EXPIRED'

Event subscription cursor fell outside the replay window (rev4 §J1).

HANDSHAKE_REJECTED

readonly HANDSHAKE_REJECTED: "HANDSHAKE_REJECTED" = 'HANDSHAKE_REJECTED'

Handshake rejected (nonce replay, wrong source, version mismatch).

IDEMPOTENCY_CONFLICT

readonly IDEMPOTENCY_CONFLICT: "IDEMPOTENCY_CONFLICT" = 'IDEMPOTENCY_CONFLICT'

Idempotent replay with a different request body.

INTERNAL

readonly INTERNAL: "INTERNAL" = 'INTERNAL'

Catch-all for unexpected host-side failures.

NETWORK_DESTINATION_DENIED

readonly NETWORK_DESTINATION_DENIED: "NETWORK_DESTINATION_DENIED" = 'NETWORK_DESTINATION_DENIED'

Network destination rejected by the SSRF policy (§29.1).

NETWORK_REDIRECT_DENIED

readonly NETWORK_REDIRECT_DENIED: "NETWORK_REDIRECT_DENIED" = 'NETWORK_REDIRECT_DENIED'

A redirect target was rejected by the capability policy (§29.1.3).

NOT_FOUND

readonly NOT_FOUND: "NOT_FOUND" = 'NOT_FOUND'

Target entity (chat, message, blob, job…) does not exist.

OPERATION_ABORTED

readonly OPERATION_ABORTED: "OPERATION_ABORTED" = 'OPERATION_ABORTED'

Operation aborted by caller (AbortSignal) or by the host.

OPERATION_DEADLINE

readonly OPERATION_DEADLINE: "OPERATION_DEADLINE" = 'OPERATION_DEADLINE'

Operation exceeded its deadline.

PLUGIN_QUOTA_EXCEEDED

readonly PLUGIN_QUOTA_EXCEEDED: "PLUGIN_QUOTA_EXCEEDED" = 'PLUGIN_QUOTA_EXCEEDED'

Operation exceeded a resource budget (rev4 §M2).

POLICY_DENIED

readonly POLICY_DENIED: "POLICY_DENIED" = 'POLICY_DENIED'

Policy (admin override, consent state) denied the operation.

PROTOCOL_INVALID

readonly PROTOCOL_INVALID: "PROTOCOL_INVALID" = 'PROTOCOL_INVALID'

Envelope failed validation or carried an unknown required version.

PROTOCOL_UNSUPPORTED

readonly PROTOCOL_UNSUPPORTED: "PROTOCOL_UNSUPPORTED" = 'PROTOCOL_UNSUPPORTED'

Unknown method or unsupported protocol feature.

RESOURCE_LIMIT_EXCEEDED

readonly RESOURCE_LIMIT_EXCEEDED: "RESOURCE_LIMIT_EXCEEDED" = 'RESOURCE_LIMIT_EXCEEDED'

Hard per-plugin limit reached; the operation/process was terminated.

RESOURCE_PRESSURE

readonly RESOURCE_PRESSURE: "RESOURCE_PRESSURE" = 'RESOURCE_PRESSURE'

Soft resource pressure: retryable, the host queues or rejects with a suggested retryAfterMs (ТЗ §19).

RESOURCE_PROFILE_DENIED

readonly RESOURCE_PROFILE_DENIED: "RESOURCE_PROFILE_DENIED" = 'RESOURCE_PROFILE_DENIED'

The requested resource profile is not allowed by policy.

REVISION_CONFLICT

readonly REVISION_CONFLICT: "REVISION_CONFLICT" = 'REVISION_CONFLICT'

Compare-and-set conflict: expectedRevision did not match.

SERVICE_CALL_CYCLE

readonly SERVICE_CALL_CYCLE: "SERVICE_CALL_CYCLE" = 'SERVICE_CALL_CYCLE'

The call would close a service cycle A→B→A (ТЗ §26.2.1).

SERVICE_ERROR

readonly SERVICE_ERROR: "SERVICE_ERROR" = 'SERVICE_ERROR'

The provider's handler threw; details.providerCode keeps its code.

SERVICE_METHOD_NOT_FOUND

readonly SERVICE_METHOD_NOT_FOUND: "SERVICE_METHOD_NOT_FOUND" = 'SERVICE_METHOD_NOT_FOUND'

The method is not declared by the service.

SERVICE_NOT_FOUND

readonly SERVICE_NOT_FOUND: "SERVICE_NOT_FOUND" = 'SERVICE_NOT_FOUND'

Cross-plugin service id does not exist (rev4 §D services).

SERVICE_TIMEOUT

readonly SERVICE_TIMEOUT: "SERVICE_TIMEOUT" = 'SERVICE_TIMEOUT'

Service call exceeded its deadline.

SERVICE_UNAVAILABLE

readonly SERVICE_UNAVAILABLE: "SERVICE_UNAVAILABLE" = 'SERVICE_UNAVAILABLE'

The providing plugin was removed or its frame is gone.

SERVICE_VERSION_MISMATCH

readonly SERVICE_VERSION_MISMATCH: "SERVICE_VERSION_MISMATCH" = 'SERVICE_VERSION_MISMATCH'

The provider's declared version does not satisfy the consumer.

STREAM_FAILED

readonly STREAM_FAILED: "STREAM_FAILED" = 'STREAM_FAILED'

Stream closed or failed mid-transfer.

TRUST_REQUIRED

readonly TRUST_REQUIRED: "TRUST_REQUIRED" = 'TRUST_REQUIRED'

The call needs a higher trust level than the caller holds (ТЗ §11).

VALIDATION_FAILED

readonly VALIDATION_FAILED: "VALIDATION_FAILED" = 'VALIDATION_FAILED'

Validation failed for params/registration payload.

WORKER_SPAWN_FAILED

readonly WORKER_SPAWN_FAILED: "WORKER_SPAWN_FAILED" = 'WORKER_SPAWN_FAILED'

Compute worker could not be spawned or crashed (rev4 §C2).