coakka-http-runtime-python 1.1.2__cp311-abi3-win_arm64.whl

coakka_http/__init__.py

@@ -0,0 +1,6 @@
+'Public Python API for the CoAkka HTTP host-inlined runtime.'
+from.runtime import InspectionOptions,NativeError,Runtime,features,inspect_runtime,plan_service
+from._service_cpu import ServiceStartInterrupted
+from.service import Builder,Handler,ResponseStreamProducer,ResponseStreamWriter,ServerSentEventsProducer,ServerSentEventsResponse,ServerSentEventsWriter,Service,ServiceCloseError,ServiceError,ServiceStartError,StreamingResponse,WebSocketHandler,WebSocketResponse,WebSocketSession
+from.values import ABI_VERSION,MONITOR_FIXED_LATENCY_BUCKETS,MONITOR_MAX_EVENTS_PER_READ,MONITOR_MAX_FAILURE_COUNTS,TIMEOUT_FOREVER,Activity,ApiAdditionalProperties,ApiExample,ApiMediaType,ApiParameter,ApiParameterLocation,ApiRequestBody,ApiResponse,ApiResponseHeader,ApiSchema,ApiSchemaDefinition,ApiSchemaKind,ApiSchemaProperty,ApiSecurityRequirement,ApiSecurityUse,BodyDelivery,BodyPolicy,Capability,Compression,CompressionMode,ControlCode,CpuInfo,CpuPlacement,CpuPolicy,DrainOutcome,DrainState,Event,EventKind,ExchangeId,ExecutionInfo,ExecutionMode,ExecutionReason,ExecutionSelection,Failure,FailureReason,FileAuthority,FileResponse,Header,Headers,Health,IoBackend,IoBackendFallbackReason,Limits,Listener,ListenerProtocol,MonitorApplyOutcome,MonitorApplyReason,MonitorCategory,MonitorCollection,MonitorConfig,MonitorEvent,MonitorEventKind,MonitorEventPage,MonitorFailureCount,MonitorLatency,MonitorLatencyBucket,MonitorNotification,MonitorOptions,MonitorPolicy,MonitorSnapshot,NotificationProfile,OutboundEndpoint,OutboundReason,OutboundPhase,OutboundRetry,OutboundCertainty,OutboundId,OutboundIdentity,OutboundRequest,OutboundStrategy,OutboundTarget,OutboundTerminal,OutboundTrust,PathParameter,QueryParameter,Request,RequestRetirement,RequestRetirementCode,RequestRetirementState,Response,ResultCode,Route,RouteApiMetadata,RouteIdentity,RoutePublication,RoutePublicationCode,RoutePublicationOutcome,RouteRebind,RouteRebindCode,RouteRebindOutcome,RouteSnapshot,RouteState,RuntimeConfig,RuntimeInfo,RuntimeInspection,ServicePlan,SseEvent,StaticMount,TlsCredentials,TlsReloadMode,TlsReloadOutcome,TlsReloadReason,TlsReloadRequest,TransportSecurity,WebSocketEvent,WebSocketEventKind,WebSocketId
+__all__='ExecutionInfo','ExecutionMode','ExecutionReason','ExecutionSelection','RequestRetirement','RequestRetirementCode','RequestRetirementState','CpuInfo','CpuPlacement','CpuPolicy','ServiceCloseError','ServiceStartError','ServiceStartInterrupted','DrainOutcome','DrainState','NotificationProfile','InspectionOptions','RuntimeInspection','inspect_runtime','ABI_VERSION','MONITOR_FIXED_LATENCY_BUCKETS','MONITOR_MAX_EVENTS_PER_READ','MONITOR_MAX_FAILURE_COUNTS','TIMEOUT_FOREVER','Activity','ApiAdditionalProperties','ApiExample','ApiMediaType','ApiParameter','ApiParameterLocation','ApiRequestBody','ApiResponse','ApiResponseHeader','ApiSchema','ApiSchemaDefinition','ApiSchemaKind','ApiSchemaProperty','ApiSecurityRequirement','ApiSecurityUse','BodyDelivery','BodyPolicy','Builder','Capability','Compression','CompressionMode','ControlCode','Event','EventKind','ExchangeId','Failure','FailureReason','FileAuthority','FileResponse','Header','Headers','Health','Handler','IoBackend','IoBackendFallbackReason','Limits','Listener','ListenerProtocol','MonitorApplyOutcome','MonitorApplyReason','MonitorCategory','MonitorCollection','MonitorConfig','MonitorEvent','MonitorEventKind','MonitorEventPage','MonitorFailureCount','MonitorLatency','MonitorLatencyBucket','MonitorNotification','MonitorOptions','MonitorPolicy','MonitorSnapshot','NativeError','OutboundEndpoint','OutboundReason','OutboundPhase','OutboundRetry','OutboundCertainty','OutboundId','OutboundIdentity','OutboundRequest','OutboundStrategy','OutboundTarget','OutboundTerminal','OutboundTrust','PathParameter','QueryParameter','Request','Response','ResponseStreamProducer','ResponseStreamWriter','ResultCode','Route','RouteApiMetadata','RouteIdentity','RoutePublication','RoutePublicationCode','RoutePublicationOutcome','RouteRebind','RouteRebindCode','RouteRebindOutcome','RouteSnapshot','RouteState','Runtime','RuntimeConfig','RuntimeInfo','ServicePlan','ServerSentEventsProducer','ServerSentEventsResponse','ServerSentEventsWriter','Service','ServiceError','SseEvent','StaticMount','StreamingResponse','TlsCredentials','TlsReloadMode','TlsReloadOutcome','TlsReloadReason','TlsReloadRequest','TransportSecurity','WebSocketEvent','WebSocketEventKind','WebSocketHandler','WebSocketId','WebSocketResponse','WebSocketSession','features','plan_service'

coakka_http/_native.py

@@ -0,0 +1,192 @@
+'Private ``ctypes`` projection of the focused CoAkka HTTP host ABI.'
+from __future__ import annotations
+import ctypes
+import ctypes.util
+import hashlib
+import json
+import os
+import re
+from collections.abc import Callable,Sequence
+from pathlib import Path
+from typing import Final,Literal,TypeVar,cast
+_Structure=TypeVar('_Structure',bound=ctypes.Structure)
+ABI_VERSION:Final=10
+STATUS_OK:Final=0
+STATUS_TIMEOUT:Final=11
+MAX_COPY_BYTES:Final=64<<20
+MAX_MONITOR_FAILURES:Final=48
+FIXED_LATENCY_BUCKETS:Final=16
+_BYTES_DATA=ctypes.PYFUNCTYPE(ctypes.c_void_p,ctypes.py_object)(('PyBytes_AsString',ctypes.pythonapi))
+_TEXT_DECODERS:Final[dict[str,Callable[[int,int,bytes],str]]]={encoding:cast(Callable[[int,int,bytes],str],ctypes.PYFUNCTYPE(ctypes.py_object,ctypes.c_void_p,ctypes.c_ssize_t,ctypes.c_char_p)((symbol,ctypes.pythonapi)))for(encoding,symbol)in(('ascii','PyUnicode_DecodeASCII'),('latin-1','PyUnicode_DecodeLatin1'),('utf-8','PyUnicode_DecodeUTF8'))}
+_GIL_LOCAL_FUNCTIONS:Final=('coakka_http_host_request_event_init','coakka_http_host_response_init','coakka_http_host_request_view_init','coakka_http_host_request_view','coakka_http_host_sse_event_init',*(f"coakka_http_host_request_{name}"for name in('stream_trailer_count','header','path_parameter','query_parameter','trailer','stream_trailer')))
+_GIL_OBSERVATION_FUNCTIONS:Final=('coakka_http_host_request_cancelled',)
+class NativeError(RuntimeError):
+	'A typed status returned by the native host library.'
+	def __init__(self,status:int,detail:str,*,reason:int=0,system_code:int=0,item_index:int=4294967295,actual:int=0,limit:int=0)->None:'Retain one copied causal failure returned by the native host.';super().__init__(detail);self.status=status;self.reason=reason;self.system_code=system_code;self.item_index=item_index;self.actual=actual;self.limit=limit
+class Issue(ctypes.Structure):'Bounded causal operation failure copied before the native call returns.';_fields_=[('struct_size',ctypes.c_uint32),('status',ctypes.c_int32),('reason',ctypes.c_uint32),('system_code',ctypes.c_int32),('item_index',ctypes.c_uint32),('reserved0',ctypes.c_uint32),('actual',ctypes.c_uint64),('limit',ctypes.c_uint64),('detail',ctypes.c_char*192)]
+class Bytes(ctypes.Structure):'Length-bearing byte address; ownership lives in its Arena/native lease.\n\n    c_void_p has the same C pointer ABI but avoids allocating a ctypes pointer\n    wrapper when reading each field. Never use c_char_p here: it would perform\n    an implicit NUL-terminated conversion and lose binary length semantics.\n    ';_fields_=[('data',ctypes.c_void_p),('size',ctypes.c_size_t)]
+class Header(ctypes.Structure):'Private native ABI structure layout.';_fields_=[('name',Bytes),('value',Bytes)]
+class BodyPolicy(ctypes.Structure):'Private native ABI structure layout.';_fields_=[('struct_size',ctypes.c_uint32),('enabled',ctypes.c_uint8),('accept_absent',ctypes.c_uint8),('accept_other',ctypes.c_uint8),('accept_form_urlencoded',ctypes.c_uint8),('accept_multipart_form_data',ctypes.c_uint8),('reserved0',ctypes.c_uint8*3),('max_body_bytes',ctypes.c_uint64)]
+class ApiSchema(ctypes.Structure):'Recursive native metadata schema layout.'
+class ApiExample(ctypes.Structure):'Private native ABI structure layout.';_fields_=[('struct_size',ctypes.c_uint32),('reserved0',ctypes.c_uint32),('name',Bytes),('summary',Bytes),('value',Bytes)]
+class ApiSchemaProperty(ctypes.Structure):'Private native ABI structure layout.';_fields_=[('struct_size',ctypes.c_uint32),('required',ctypes.c_uint8),('reserved0',ctypes.c_uint8*3),('name',Bytes),('description',Bytes),('schema',ctypes.POINTER(ApiSchema))]
+ApiSchema._fields_=[('struct_size',ctypes.c_uint32),('kind',ctypes.c_uint32),('format',Bytes),('reference',Bytes),('enum_values',ctypes.POINTER(Bytes)),('enum_value_count',ctypes.c_uint32),('additional_properties',ctypes.c_uint32),('items',ctypes.POINTER(ApiSchema)),('properties',ctypes.POINTER(ApiSchemaProperty)),('property_count',ctypes.c_uint32),('has_nullable',ctypes.c_uint8),('nullable',ctypes.c_uint8),('reserved0',ctypes.c_uint8*2)]
+class ApiSchemaDefinition(ctypes.Structure):'Private native ABI structure layout.';_fields_=[('struct_size',ctypes.c_uint32),('reserved0',ctypes.c_uint32),('name',Bytes),('schema',ctypes.POINTER(ApiSchema))]
+class ApiParameter(ctypes.Structure):'Private native ABI structure layout.';_fields_=[('struct_size',ctypes.c_uint32),('location',ctypes.c_uint32),('name',Bytes),('description',Bytes),('schema',ctypes.POINTER(ApiSchema)),('examples',ctypes.POINTER(ApiExample)),('example_count',ctypes.c_uint32),('required',ctypes.c_uint8),('reserved0',ctypes.c_uint8*3)]
+class ApiMediaType(ctypes.Structure):'Private native ABI structure layout.';_fields_=[('struct_size',ctypes.c_uint32),('reserved0',ctypes.c_uint32),('media_type',Bytes),('schema',ctypes.POINTER(ApiSchema)),('examples',ctypes.POINTER(ApiExample)),('example_count',ctypes.c_uint32),('reserved1',ctypes.c_uint32)]
+class ApiRequestBody(ctypes.Structure):'Private native ABI structure layout.';_fields_=[('struct_size',ctypes.c_uint32),('required',ctypes.c_uint8),('reserved0',ctypes.c_uint8*3),('description',Bytes),('content',ctypes.POINTER(ApiMediaType)),('content_count',ctypes.c_uint32),('reserved1',ctypes.c_uint32)]
+class ApiHeader(ctypes.Structure):'Private native ABI structure layout.';_fields_=[('struct_size',ctypes.c_uint32),('reserved0',ctypes.c_uint32),('name',Bytes),('description',Bytes),('schema',ctypes.POINTER(ApiSchema)),('examples',ctypes.POINTER(ApiExample)),('example_count',ctypes.c_uint32),('reserved1',ctypes.c_uint32)]
+class ApiResponse(ctypes.Structure):'Private native ABI structure layout.';_fields_=[('struct_size',ctypes.c_uint32),('selector',ctypes.c_uint32),('status_code',ctypes.c_uint32),('reserved0',ctypes.c_uint32),('description',Bytes),('headers',ctypes.POINTER(ApiHeader)),('header_count',ctypes.c_uint32),('reserved1',ctypes.c_uint32),('content',ctypes.POINTER(ApiMediaType)),('content_count',ctypes.c_uint32),('reserved2',ctypes.c_uint32)]
+class ApiSecurityUse(ctypes.Structure):'Private native ABI structure layout.';_fields_=[('struct_size',ctypes.c_uint32),('reserved0',ctypes.c_uint32),('scheme_reference',Bytes),('scopes',ctypes.POINTER(Bytes)),('scope_count',ctypes.c_uint32),('reserved1',ctypes.c_uint32)]
+class ApiSecurityRequirement(ctypes.Structure):'Private native ABI structure layout.';_fields_=[('struct_size',ctypes.c_uint32),('reserved0',ctypes.c_uint32),('uses',ctypes.POINTER(ApiSecurityUse)),('use_count',ctypes.c_uint32),('reserved1',ctypes.c_uint32)]
+class RouteApiMetadata(ctypes.Structure):'Private native ABI structure layout.';_fields_=[('struct_size',ctypes.c_uint32),('deprecated',ctypes.c_uint8),('reserved0',ctypes.c_uint8*3),('operation_id',Bytes),('summary',Bytes),('description',Bytes),('tags',ctypes.POINTER(Bytes)),('tag_count',ctypes.c_uint32),('reserved1',ctypes.c_uint32),('parameters',ctypes.POINTER(ApiParameter)),('parameter_count',ctypes.c_uint32),('reserved2',ctypes.c_uint32),('request_body',ctypes.POINTER(ApiRequestBody)),('responses',ctypes.POINTER(ApiResponse)),('response_count',ctypes.c_uint32),('reserved3',ctypes.c_uint32),('security_requirements',ctypes.POINTER(ApiSecurityRequirement)),('security_requirement_count',ctypes.c_uint32),('reserved4',ctypes.c_uint32),('schema_definitions',ctypes.POINTER(ApiSchemaDefinition)),('schema_definition_count',ctypes.c_uint32),('reserved5',ctypes.c_uint32)]
+class Route(ctypes.Structure):'Private native ABI structure layout.';_fields_=[('struct_size',ctypes.c_uint32),('flags',ctypes.c_uint32),('route_id',ctypes.c_uint64),('handler_binding_id',ctypes.c_uint64),('method',Bytes),('encoded_path_pattern',Bytes),('body_policy',BodyPolicy),('api_metadata',ctypes.POINTER(RouteApiMetadata))]
+class StaticMount(ctypes.Structure):'Private native ABI structure layout.';_fields_=[('struct_size',ctypes.c_uint32),('flags',ctypes.c_uint32),('url_prefix',Bytes),('root_path',Bytes),('index_file',Bytes),('spa_fallback_file',Bytes),('cache_control',Bytes)]
+class MonitorOptions(ctypes.Structure):'Private native ABI structure layout.';_fields_=[('struct_size',ctypes.c_uint32),('event_capacity',ctypes.c_uint32),('max_events_per_read',ctypes.c_uint32),('categories',ctypes.c_uint32),('initial_collection',ctypes.c_uint32),('signal_reserved',ctypes.c_uint8),('fixed_latency_buckets',ctypes.c_uint8),('reserved0',ctypes.c_uint8*2)]
+_LIMIT_U32_PREFIX='max_routes','max_total_segments','max_route_bytes'
+_LIMIT_U32_SUFFIX='max_captures_per_route','activation_history_capacity','max_connections','max_active_requests','request_queue_capacity','completion_queue_capacity','completion_batch_size','max_header_count','max_header_bytes','request_stream_chunk_slots','request_stream_max_retained_items','response_stream_chunk_slots','response_stream_max_retained_items','route_control_capacity','route_control_history_capacity','route_control_max_commands_per_turn','terminal_queue_capacity','deadline_tick_ms','connection_timeout_batch_size'
+_LIMIT_U32=_LIMIT_U32_PREFIX+_LIMIT_U32_SUFFIX
+_LIMIT_U64='max_total_route_metadata_bytes','max_request_body_bytes','max_response_body_bytes','keep_alive_timeout_ms','header_timeout_ms','body_timeout_ms','handler_timeout_ms','idle_timeout_ms','drain_timeout_ms','stop_timeout_ms','response_write_timeout_ms','request_stream_max_chunk_bytes','request_stream_max_trailer_bytes','request_stream_max_retained_bytes','request_stream_max_total_retained_bytes','response_stream_max_chunk_bytes','response_stream_max_trailer_bytes','response_stream_max_retained_bytes','response_stream_max_total_retained_bytes'
+class Limits(ctypes.Structure):'Private native ABI structure layout.';_fields_=[('struct_size',ctypes.c_uint32)]+[(name,ctypes.c_uint32)for name in _LIMIT_U32_PREFIX]+[('max_total_route_metadata_bytes',ctypes.c_uint64)]+[(name,ctypes.c_uint32)for name in _LIMIT_U32_SUFFIX]+[(name,ctypes.c_uint64)for name in _LIMIT_U64[1:]]+[('request_notification_profile',ctypes.c_uint32),('terminal_notification_profile',ctypes.c_uint32),('event_loop_cpu_mask',ctypes.c_uint64)]
+class Compression(ctypes.Structure):'Private native ABI structure layout.';_fields_=[('struct_size',ctypes.c_uint32),('enabled',ctypes.c_uint8),('reserved0',ctypes.c_uint8*3),('minimum_body_bytes',ctypes.c_uint64),('maximum_body_bytes',ctypes.c_uint64),('maximum_encoded_bytes',ctypes.c_uint64),('workspace_bytes',ctypes.c_uint64),('gzip_level',ctypes.c_int32),('reserved1',ctypes.c_uint32)]
+class FileAuthority(ctypes.Structure):'Private native ABI structure layout.';_fields_=[('struct_size',ctypes.c_uint32),('max_active_files',ctypes.c_uint32),('authority_id',ctypes.c_uint64),('root_path',Bytes),('max_file_bytes',ctypes.c_uint64)]
+class OutboundEndpoint(ctypes.Structure):'Private native ABI structure layout.';_fields_=[('struct_size',ctypes.c_uint32),('weight',ctypes.c_uint32),('node_id',Bytes),('connect_host',Bytes),('connect_port',ctypes.c_uint16),('reserved0',ctypes.c_uint16),('http_authority',Bytes),('security',ctypes.c_uint32),('available',ctypes.c_uint32),('tls_peer_identity',Bytes),('tls_trust_generation',ctypes.c_uint64),('tls_client_identity_generation',ctypes.c_uint64)]
+class OutboundTarget(ctypes.Structure):'Private native ABI structure layout.';_fields_=[('struct_size',ctypes.c_uint32),('strategy',ctypes.c_uint32),('name',Bytes),('generation',ctypes.c_uint64),('endpoints',ctypes.POINTER(OutboundEndpoint)),('endpoint_count',ctypes.c_uint32),('reserved0',ctypes.c_uint32)]
+class OutboundTrust(ctypes.Structure):'Private native ABI structure layout.';_fields_=[('struct_size',ctypes.c_uint32),('reserved0',ctypes.c_uint32),('generation',ctypes.c_uint64),('ca_pem',Bytes)]
+class OutboundIdentity(ctypes.Structure):'Private native ABI structure layout.';_fields_=[('struct_size',ctypes.c_uint32),('reserved0',ctypes.c_uint32),('generation',ctypes.c_uint64),('certificate_chain_pem',Bytes),('private_key_pem',Bytes)]
+class ExecutionOptions(ctypes.Structure):'Private construction intent copied synchronously by Core.';_fields_=[('struct_size',ctypes.c_uint32),('mode',ctypes.c_uint32),('event_loop_count',ctypes.c_uint32),('reserved',ctypes.c_uint32)]
+class ExecutionSelection(ctypes.Structure):'Immutable Core admission result, not local configuration inference.';_fields_=[('requested_mode',ctypes.c_uint32),('requested_count',ctypes.c_uint32),('selected_count',ctypes.c_uint32),('reason',ctypes.c_uint32)]
+class InspectionOptions(ctypes.Structure):'Native startup intent for authenticated inspection.';_fields_=[('struct_size',ctypes.c_uint32),('allow_plaintext_loopback',ctypes.c_uint8),('reserved0',ctypes.c_uint8*3),('runtime_instance_id',ctypes.c_uint64),('runtime_generation',ctypes.c_uint64),('bearer_file',Bytes)]
+class Configuration(ctypes.Structure):'Private native ABI structure layout.';_fields_=[('struct_size',ctypes.c_uint32),('port',ctypes.c_uint16),('reserved0',ctypes.c_uint16),('protocol',ctypes.c_uint32),('security',ctypes.c_uint32),('bind_address',Bytes),('credential_generation',ctypes.c_uint64),('credential_id',Bytes),('certificate_chain_file',Bytes),('private_key_file',Bytes),('trust_roots_file',Bytes),('use_io_uring',ctypes.c_uint8),('reserved1',ctypes.c_uint8*7),('static_mount_count',ctypes.c_uint32),('limits',Limits),('monitor',MonitorOptions),('static_mounts',ctypes.POINTER(StaticMount)),('max_total_static_assets',ctypes.c_uint32),('file_authority_count',ctypes.c_uint32),('file_authorities',ctypes.POINTER(FileAuthority)),('outbound_target_count',ctypes.c_uint32),('outbound_targets',ctypes.POINTER(OutboundTarget)),('outbound_trust_count',ctypes.c_uint32),('outbound_trusts',ctypes.POINTER(OutboundTrust)),('outbound_identity_count',ctypes.c_uint32),('outbound_identities',ctypes.POINTER(OutboundIdentity)),('compression',Compression),('reserved2',ctypes.c_uint32),('reserve_websocket',ctypes.c_uint8),('omit_buffered_success_events',ctypes.c_uint8),('reserved3',ctypes.c_uint8*2),('execution',ctypes.POINTER(ExecutionOptions))]
+class ServicePlanRequest(ctypes.Structure):'Private native ABI structure layout.';_fields_=[('struct_size',ctypes.c_uint32),('reserved',ctypes.c_uint32),('required_capabilities',ctypes.c_uint64),('adapter_capabilities',ctypes.c_uint64)]
+class ServicePlan(ctypes.Structure):'Private native ABI structure layout.';_fields_=[('struct_size',ctypes.c_uint32),('supported',ctypes.c_uint8),('reserved0',ctypes.c_uint8*3),('required_capabilities',ctypes.c_uint64),('adapter_capabilities',ctypes.c_uint64),('missing_capabilities',ctypes.c_uint64)]
+class ExecutionInfo(ctypes.Structure):'Core-issued cold loop observation, not CPU or Python worker counts.';_fields_=[('configured_event_loops',ctypes.c_uint32),('active_event_loops',ctypes.c_uint32),('draining_event_loops',ctypes.c_uint32),('failed_event_loops',ctypes.c_uint32),('observed',ctypes.c_uint8),('reserved',ctypes.c_uint8*7)]
+class RequestRetirement(ctypes.Structure):'Request-capture proof, independent of the publication outcome.';_fields_=[('state',ctypes.c_uint32),('code',ctypes.c_uint32),('quiescent_sources',ctypes.c_uint32),('sources',ctypes.c_uint32)]
+class ServiceInfo(ctypes.Structure):'Private native ABI structure layout.';_fields_=[('struct_size',ctypes.c_uint32),('abi_version',ctypes.c_uint32),('io_uring_requested',ctypes.c_uint8),('io_uring_effective',ctypes.c_uint8),('io_uring_compiled',ctypes.c_uint8),('io_uring_probed',ctypes.c_uint8),('io_uring_supported',ctypes.c_uint8),('service_started',ctypes.c_uint8),('reserved0',ctypes.c_uint8*2),('io_fallback_reason',ctypes.c_uint32),('io_uring_probe_error',ctypes.c_int32),('reserved1',ctypes.c_uint32),('request_notification_batch_size',ctypes.c_uint32),('event_loop_cpu_mask_supported',ctypes.c_uint8),('event_loop_cpu_mask_applied',ctypes.c_uint8),('reserved2',ctypes.c_uint8*2),('event_loop_cpu_mask',ctypes.c_uint64),('terminal_notification_batch_size',ctypes.c_uint32),('reserved3',ctypes.c_uint32),('execution',ExecutionInfo),('selection',ExecutionSelection)]
+class RuntimeInspection(ctypes.Structure):'Pointer-free facts returned by the loaded Core image.';_fields_=[('struct_size',ctypes.c_uint32),('abi_version',ctypes.c_uint32),('features',ctypes.c_uint64),('io_uring_compiled',ctypes.c_uint8),('io_uring_probed',ctypes.c_uint8),('io_uring_supported',ctypes.c_uint8),('reserved0',ctypes.c_uint8),('io_uring_probe_error',ctypes.c_int32)]
+class CpuInfo(ctypes.Structure):"Core's bounded entry-time CPU scope facts.";_fields_=[('struct_size',ctypes.c_uint32),('requested_policy',ctypes.c_uint32),('placement',ctypes.c_uint32),('available_cpu_count',ctypes.c_uint32),('selected_cpu_count',ctypes.c_uint32),('selected_cpu_ids',ctypes.c_uint32*2)]
+class Exchange(ctypes.Structure):'Private native ABI structure layout.';_fields_=[('slot',ctypes.c_uint64),('generation',ctypes.c_uint64)]
+class RequestEvent(ctypes.Structure):'Private native ABI structure layout.';_fields_=[('struct_size',ctypes.c_uint32),('kind',ctypes.c_uint32),('exchange',Exchange),('sequence',ctypes.c_uint64),('handler_binding_id',ctypes.c_uint64),('data',Bytes),('reserved_storage',ctypes.c_uint64*16)]
+class RequestView(ctypes.Structure):'Core-issued fixed fields; spans borrow the active request event lease.';_fields_=[('struct_size',ctypes.c_uint32),('body_delivery',ctypes.c_uint32),('method',Bytes),('scheme',Bytes),('authority',Bytes),('target',Bytes),('body',Bytes),('route_id',ctypes.c_uint64),('route_generation',ctypes.c_uint64),('binding_revision',ctypes.c_uint64),('header_count',ctypes.c_uint32),('path_parameter_count',ctypes.c_uint32),('query_parameter_count',ctypes.c_uint32),('trailer_count',ctypes.c_uint32)]
+class PathParameter(ctypes.Structure):'Private native ABI structure layout.';_fields_=[('name',Bytes),('encoded_value',Bytes)]
+class QueryParameter(ctypes.Structure):'Private native ABI structure layout.';_fields_=[('encoded_key',Bytes),('encoded_value',Bytes),('has_value',ctypes.c_uint8),('reserved0',ctypes.c_uint8*7)]
+class Response(ctypes.Structure):'Private native ABI structure layout.';_fields_=[('struct_size',ctypes.c_uint32),('status_code',ctypes.c_uint32),('headers',ctypes.POINTER(Header)),('header_count',ctypes.c_uint32),('reserved0',ctypes.c_uint32),('body',Bytes)]
+class FileResponse(ctypes.Structure):'Private native ABI structure layout.';_fields_=[('struct_size',ctypes.c_uint32),('reserved0',ctypes.c_uint32),('head',Response),('authority_id',ctypes.c_uint64),('encoded_path',Bytes)]
+class SseEvent(ctypes.Structure):'Private native ABI structure layout.';_fields_=[('struct_size',ctypes.c_uint32),('reserved0',ctypes.c_uint32),('data',Bytes),('event_type',Bytes),('id',Bytes),('retry_ms',ctypes.c_uint64),('has_event_type',ctypes.c_uint8),('has_id',ctypes.c_uint8),('has_retry',ctypes.c_uint8),('reserved1',ctypes.c_uint8*5)]
+class WebSocket(ctypes.Structure):'Private native ABI structure layout.';_fields_=[('slot',ctypes.c_uint64),('generation',ctypes.c_uint64)]
+class WebSocketEvent(ctypes.Structure):'Private native ABI structure layout.';_fields_=[('struct_size',ctypes.c_uint32),('kind',ctypes.c_uint32),('session',WebSocket),('origin_exchange',Exchange),('close_code',ctypes.c_uint32),('reserved0',ctypes.c_uint32),('data',Bytes),('reserved_storage',ctypes.c_uint64*12)]
+class OutboundCall(ctypes.Structure):'Private native ABI structure layout.';_fields_=[('slot',ctypes.c_uint64),('generation',ctypes.c_uint64)]
+class OutboundRequest(ctypes.Structure):'Private native ABI structure layout.';_fields_=[('struct_size',ctypes.c_uint32),('timeout_ms',ctypes.c_uint32),('logical_target',Bytes),('method',Bytes),('target',Bytes),('headers',ctypes.POINTER(Header)),('header_count',ctypes.c_uint32),('reserved0',ctypes.c_uint32),('body',Bytes)]
+class OutboundEvent(ctypes.Structure):'Private native ABI structure layout.';_fields_=[('struct_size',ctypes.c_uint32),('reason',ctypes.c_uint32),('call',OutboundCall),('logical_target',Bytes),('target_generation',ctypes.c_uint64),('selected_node_id',Bytes),('phase',ctypes.c_uint32),('retry',ctypes.c_uint32),('certainty',ctypes.c_uint32),('response_status',ctypes.c_uint16),('reserved0',ctypes.c_uint16),('provider_code',ctypes.c_int32),('response_header_count',ctypes.c_uint32),('response_body',Bytes),('diagnostic',Bytes),('reserved_storage',ctypes.c_uint64*20)]
+class Failure(ctypes.Structure):'Private native ABI structure layout.';_fields_=[('struct_size',ctypes.c_uint32),('reason',ctypes.c_uint32),('detail',Bytes)]
+class Activity(ctypes.Structure):'Private native ABI structure layout.';_fields_=[('struct_size',ctypes.c_uint32),('active_requests',ctypes.c_uint32),('pending_requests',ctypes.c_uint32),('active_connections',ctypes.c_uint32),('websocket_sessions',ctypes.c_uint32),('outbound_pending',ctypes.c_uint32),('reserved0',ctypes.c_uint32)]
+class Health(ctypes.Structure):'Private native ABI structure layout.';_fields_=[('struct_size',ctypes.c_uint32),('lifecycle',ctypes.c_uint32),('snapshot_sequence',ctypes.c_uint64),('observed_monotonic_ns',ctypes.c_uint64),('progress_sequence',ctypes.c_uint64),('progress_monotonic_ns',ctypes.c_uint64),('acknowledged_probe_sequence',ctypes.c_uint64),('acknowledged_probe_monotonic_ns',ctypes.c_uint64),('route_generation',ctypes.c_uint64),('metadata_generation',ctypes.c_uint64),('binding_change_sequence',ctypes.c_uint64),('ready',ctypes.c_uint8),('admission_open',ctypes.c_uint8),('reserved0',ctypes.c_uint8*6),('activity',Activity)]
+class RouteIdentity(ctypes.Structure):'Private native ABI structure layout.';_fields_=[('struct_size',ctypes.c_uint32),('route_count',ctypes.c_uint32),('route_generation',ctypes.c_uint64),('metadata_generation',ctypes.c_uint64),('binding_change_sequence',ctypes.c_uint64)]
+class RouteState(ctypes.Structure):'Private native ABI structure layout.';_fields_=[('route_id',ctypes.c_uint64),('handler_binding_id',ctypes.c_uint64),('binding_revision',ctypes.c_uint64)]
+class RebindRequest(ctypes.Structure):'Private native ABI structure layout.';_fields_=[('struct_size',ctypes.c_uint32),('reserved',ctypes.c_uint32),('activation_id',ctypes.c_uint64),('expected_route_generation',ctypes.c_uint64),('route_id',ctypes.c_uint64),('expected_binding_revision',ctypes.c_uint64),('new_handler_binding_id',ctypes.c_uint64)]
+class RebindOutcome(ctypes.Structure):'Private native ABI structure layout.';_fields_=[('struct_size',ctypes.c_uint32),('code',ctypes.c_uint32),('activation_id',ctypes.c_uint64),('operation_digest',ctypes.c_uint64),('route_generation',ctypes.c_uint64),('binding_change_sequence',ctypes.c_uint64),('route_id',ctypes.c_uint64),('previous_handler_binding_id',ctypes.c_uint64),('previous_binding_revision',ctypes.c_uint64),('effective_handler_binding_id',ctypes.c_uint64),('effective_binding_revision',ctypes.c_uint64),('changed',ctypes.c_uint8),('replayed',ctypes.c_uint8),('reserved0',ctypes.c_uint8*6),('request_retirement',RequestRetirement)]
+class PublicationRequest(ctypes.Structure):'Private native ABI structure layout.';_fields_=[('struct_size',ctypes.c_uint32),('route_count',ctypes.c_uint32),('activation_id',ctypes.c_uint64),('expected_route_generation',ctypes.c_uint64),('expected_metadata_generation',ctypes.c_uint64),('expected_binding_change_sequence',ctypes.c_uint64),('routes',ctypes.POINTER(Route))]
+class PublicationOutcome(ctypes.Structure):'Private native ABI structure layout.';_fields_=[('struct_size',ctypes.c_uint32),('code',ctypes.c_uint32),('activation_id',ctypes.c_uint64),('operation_digest',ctypes.c_uint64),('previous_route_generation',ctypes.c_uint64),('previous_metadata_generation',ctypes.c_uint64),('previous_binding_change_sequence',ctypes.c_uint64),('effective_route_generation',ctypes.c_uint64),('effective_metadata_generation',ctypes.c_uint64),('effective_binding_change_sequence',ctypes.c_uint64),('actual',ctypes.c_uint64),('limit',ctypes.c_uint64),('route_count',ctypes.c_uint32),('rejected_route_index',ctypes.c_uint32),('changed',ctypes.c_uint8),('replayed',ctypes.c_uint8),('reserved0',ctypes.c_uint8*6),('request_retirement',RequestRetirement)]
+class MonitorEvent(ctypes.Structure):'Private native ABI structure layout.';_fields_=[('struct_size',ctypes.c_uint32),('kind',ctypes.c_uint32),('sequence',ctypes.c_uint64),('change_sequence',ctypes.c_uint64),('config_generation',ctypes.c_uint64),('collection_epoch',ctypes.c_uint64),('observed_monotonic_ns',ctypes.c_uint64),('category',ctypes.c_uint32),('failure_reason',ctypes.c_uint32),('queue_scope',ctypes.c_uint32),('queue_depth',ctypes.c_uint32),('queue_capacity',ctypes.c_uint32),('exchange',Exchange)]
+class MonitorPage(ctypes.Structure):'Private native ABI structure layout.';_fields_=[('struct_size',ctypes.c_uint32),('count',ctypes.c_uint32),('oldest_sequence',ctypes.c_uint64),('latest_sequence',ctypes.c_uint64),('overwritten_events',ctypes.c_uint64),('remaining_events',ctypes.c_uint64)]
+class TlsReloadRequest(ctypes.Structure):'Native compare-and-apply input borrowed for the call.';_fields_=[('struct_size',ctypes.c_uint32),('mode',ctypes.c_uint32),('security',ctypes.c_uint32),('reserved0',ctypes.c_uint32),('expected_generation',ctypes.c_uint64),('credential_generation',ctypes.c_uint64),('credential_id',Bytes),('certificate_chain_file',Bytes),('private_key_file',Bytes),('trust_roots_file',Bytes)]
+class TlsCredentials(ctypes.Structure):'Native bounded snapshot of effective TLS credentials.';_fields_=[('struct_size',ctypes.c_uint32),('security',ctypes.c_uint32),('reload_mode',ctypes.c_uint32),('retired_generations',ctypes.c_uint32),('maximum_retired_generations',ctypes.c_uint32),('closed',ctypes.c_uint8),('preparing',ctypes.c_uint8),('reserved0',ctypes.c_uint8*2),('generation',ctypes.c_uint64),('drain_before_generation',ctypes.c_uint64),('credential_id',ctypes.c_char*129)]
+class TlsReloadOutcome(ctypes.Structure):'Native typed reload result with an effective snapshot.';_fields_=[('struct_size',ctypes.c_uint32),('reason',ctypes.c_uint32),('changed',ctypes.c_uint8),('reserved0',ctypes.c_uint8*7),('effective',TlsCredentials)]
+class MonitorPolicy(ctypes.Structure):'Private native ABI structure layout.';_fields_=[('struct_size',ctypes.c_uint32),('collection',ctypes.c_uint32),('notification',ctypes.c_uint32),('latency',ctypes.c_uint32),('active_event_capacity',ctypes.c_uint32),('aggregate_categories',ctypes.c_uint32),('event_categories',ctypes.c_uint32)]
+class MonitorConfig(ctypes.Structure):'Private native ABI structure layout.';pass
+MonitorConfig._fields_=[('struct_size',ctypes.c_uint32),('reserved0',ctypes.c_uint32),('generation',ctypes.c_uint64),('collection_epoch',ctypes.c_uint64),('change_sequence',ctypes.c_uint64),('epoch_started_monotonic_ns',ctypes.c_uint64),('policy_applied_monotonic_ns',ctypes.c_uint64),('supported_categories',ctypes.c_uint32),('reserved_event_capacity',ctypes.c_uint32),('max_events_per_read',ctypes.c_uint32),('signal_reserved',ctypes.c_uint8),('fixed_latency_buckets',ctypes.c_uint8),('reserved1',ctypes.c_uint8*6),('policy',MonitorPolicy)]
+class MonitorApplyOutcome(ctypes.Structure):'Private native ABI structure layout.';_fields_=[('struct_size',ctypes.c_uint32),('reason',ctypes.c_uint32),('actual',ctypes.c_uint64),('limit',ctypes.c_uint64),('changed',ctypes.c_uint8),('reserved0',ctypes.c_uint8*7),('effective',MonitorConfig)]
+class MonitorFailureCount(ctypes.Structure):'Private native ABI structure layout.';_fields_=[('reason',ctypes.c_uint32),('reserved0',ctypes.c_uint32),('count',ctypes.c_uint64)]
+class MonitorLatencyBucket(ctypes.Structure):'Private native ABI structure layout.';_fields_=[('upper_bound_ns',ctypes.c_uint64),('count',ctypes.c_uint64)]
+class MonitorSnapshot(ctypes.Structure):'Private native ABI structure layout.';_fields_=[('struct_size',ctypes.c_uint32),('failure_count',ctypes.c_uint32),('latency_bucket_count',ctypes.c_uint32),('collecting',ctypes.c_uint8),('stale',ctypes.c_uint8),('partial',ctypes.c_uint8),('reserved0',ctypes.c_uint8),('snapshot_sequence',ctypes.c_uint64),('observed_monotonic_ns',ctypes.c_uint64),('collected_change_sequence',ctypes.c_uint64),('admitted_requests',ctypes.c_uint64),('request_bytes',ctypes.c_uint64),('exchange_completed',ctypes.c_uint64),('exchange_failed',ctypes.c_uint64),('exchange_timed_out',ctypes.c_uint64),('exchange_disconnected',ctypes.c_uint64),('exchange_cancelled',ctypes.c_uint64),('response_status_family',ctypes.c_uint64*5),('retained_events',ctypes.c_uint64),('overwritten_events',ctypes.c_uint64),('dropped_events',ctypes.c_uint64),('signal_notifications',ctypes.c_uint64),('coalesced_signals',ctypes.c_uint64),('signal_failures',ctypes.c_uint64),('config',MonitorConfig),('health',Health),('failure_counts',MonitorFailureCount*MAX_MONITOR_FAILURES),('latency_buckets',MonitorLatencyBucket*FIXED_LATENCY_BUCKETS)]
+class Arena:
+	'Keeps borrowed input buffers and arrays alive through one native call.'
+	def __init__(self)->None:'Create an empty call-scoped ownership set.';(self.values):list[object]=[]
+	def bytes(self,value:bytes|bytearray|memoryview|str,*,encoding:str='utf-8')->Bytes:
+		'Hold one bounded byte value through a synchronous native call.'
+		if type(value)is bytes:data=value
+		elif isinstance(value,(bytes,bytearray,memoryview)):
+			view=memoryview(value)
+			if view.nbytes>MAX_COPY_BYTES:raise ValueError('native byte projection exceeds the Python bound')
+			data=view.tobytes()
+		elif isinstance(value,str):
+			if str.__len__(value)>MAX_COPY_BYTES:raise ValueError('native byte projection exceeds the Python bound')
+			data=str.encode(value,encoding)
+		else:raise TypeError('native byte projection requires bytes, buffer or str')
+		if not data:return Bytes()
+		if len(data)>MAX_COPY_BYTES:raise ValueError('native byte projection exceeds the Python bound')
+		self.values.append(data);return Bytes(_BYTES_DATA(data),len(data))
+	def array(self,item_type:type[_Structure],values:Sequence[_Structure])->ctypes.Array[_Structure]|None:
+		'Retain one typed ABI array for the duration of its native call.'
+		if not values:return None
+		array=(item_type*len(values))(*values);self.values.append(array);return array
+def copy_bytes(value:Bytes)->bytes:
+	'Copy one bounded native byte view before its lease is released.';size=int(value.size)
+	if size==0:return b''
+	if not value.data or size>MAX_COPY_BYTES:raise NativeError(127,'native byte view is outside the Python bound')
+	return ctypes.string_at(value.data,size)
+def copy_text(value:Bytes,encoding:Literal['ascii','latin-1','utf-8'])->str:
+	'Decode a bounded leased view into owned text, without intermediate bytes.\n\n    The caller must keep the immutable native view alive until this returns.\n    Length, not NUL termination, defines the input. The same byte ceiling and\n    strict codec errors as copy_bytes(...).decode(...) apply; no HTTP validation\n    moves here. Empty views never dereference data. Bodies still use copy_bytes.\n    ';size=int(value.size)
+	if size==0:return''
+	if not value.data or size>MAX_COPY_BYTES:raise NativeError(127,'native byte view is outside the Python bound')
+	return _TEXT_DECODERS[encoding](value.data,size,b'strict')
+def _package_images(package:Path)->tuple[Path,Path]:
+	'Validate both paired images before either package image is loaded.';receipt=package/'_package.json'
+	if receipt.is_symlink()or not receipt.is_file()or receipt.stat().st_size>4096:raise RuntimeError('invalid CoAkka HTTP package metadata')
+	metadata=json.loads(receipt.read_text('utf-8'));version='[0-9]+\\.[0-9]+\\.[0-9]+';allowed_library=re.compile(rf"native/(?:libcoakka_http_host\.(?:{version}\.dylib|so\.{version})|coakka_http_host\.dll)");allowed_projections={'native/_coakka_http_projection.abi3.so','native/_coakka_http_projection.pyd'}
+	if not isinstance(metadata,dict)or metadata.get('format')!='coakka.http.python-package.v2':raise RuntimeError('invalid CoAkka HTTP package metadata')
+	images:list[Path]=[]
+	for key in('library','projection'):
+		name=metadata.get(key);expected=metadata.get(key+'_sha256')
+		if not isinstance(name,str)or not isinstance(expected,str)or len(expected)!=64 or any(character not in'0123456789abcdef'for character in expected):raise RuntimeError('invalid CoAkka HTTP package image metadata')
+		if key=='library':admitted=allowed_library.fullmatch(name)is not None
+		else:admitted=name in allowed_projections
+		if not admitted:raise RuntimeError('invalid CoAkka HTTP package image metadata')
+		image=package/name
+		if image.parent.is_symlink()or image.is_symlink()or not image.is_file()or image.stat().st_size>MAX_COPY_BYTES:raise RuntimeError('CoAkka HTTP package image is missing or invalid')
+		if hashlib.sha256(image.read_bytes()).hexdigest()!=expected:raise RuntimeError('CoAkka HTTP package image identity mismatch')
+		images.append(image.absolute())
+	return images[0],images[1]
+def _library_path()->str:
+	"Resolve an explicit development override or the package's paired image.\n\n    Package metadata is distribution-owned, not effective runtime configuration.\n    A damaged installed package fails closed instead of searching the machine\n    for another library. Source checkouts retain their development discovery.\n    ";configured=os.environ.get('COAKKA_HTTP_HOST_PATH')
+	if configured is not None:
+		path=Path(configured)
+		if not path.is_absolute()or not path.is_file()or path.is_symlink():raise RuntimeError('COAKKA_HTTP_HOST_PATH must name an absolute regular file')
+		return str(path)
+	package=Path(__file__).parent;receipt=package/'_package.json'
+	if receipt.exists()or receipt.is_symlink():return str(_package_images(package)[0])
+	if(package/'native').exists():raise RuntimeError('CoAkka HTTP package metadata is missing')
+	discovered=ctypes.util.find_library('coakka_http_host')
+	if discovered:return discovered
+	raise RuntimeError('coakka_http_host is unavailable; set COAKKA_HTTP_HOST_PATH to the installed library')
+def _bind(library:ctypes.CDLL,name:str,arguments:list[object],result:object)->None:function=getattr(library,name);function.argtypes=arguments;function.restype=result
+class Library:
+	'Bound function table for one directly loaded host library.'
+	def __init__(self)->None:
+		'Load the installed library, bind its surface, and verify ABI 10.';path=_library_path();self.library=ctypes.CDLL(path);_bind(self.library,'coakka_http_host_abi_version',[],ctypes.c_uint32)
+		if int(self.library.coakka_http_host_abi_version())!=ABI_VERSION:raise RuntimeError('CoAkka HTTP host ABI version is incompatible')
+		self._bind_all();self._local=ctypes.PyDLL(path)
+		for name in(*_GIL_LOCAL_FUNCTIONS,*_GIL_OBSERVATION_FUNCTIONS):original=getattr(self.library,name);_bind(self._local,name,original.argtypes,original.restype);setattr(self.library,name,getattr(self._local,name))
+	def bind_inspection_startup(self)->None:
+		'Bind the focused startup extension when the caller opts in.';lib=self.library
+		try:_bind(lib,'coakka_http_host_inspection_options_init',[ctypes.POINTER(InspectionOptions)],None);_bind(lib,'coakka_http_host_service_create_with_inspection',[ctypes.POINTER(Configuration),ctypes.POINTER(InspectionOptions),ctypes.POINTER(Route),ctypes.c_uint32,ctypes.POINTER(ctypes.c_void_p),ctypes.POINTER(ctypes.c_uint32)],ctypes.c_int32)
+		except AttributeError as error:raise NotImplementedError('the loaded CoAkka HTTP host does not support inspection startup')from error
+	def bind_tls_control(self)->None:
+		'Bind the complete control surface when the caller requests it.';lib=self.library
+		try:_bind(lib,'coakka_http_host_tls_credentials_init',[ctypes.POINTER(TlsCredentials)],None);_bind(lib,'coakka_http_host_tls_reload_request_init',[ctypes.POINTER(TlsReloadRequest)],None);_bind(lib,'coakka_http_host_tls_reload_outcome_init',[ctypes.POINTER(TlsReloadOutcome)],None);_bind(lib,'coakka_http_host_tls_credentials',[ctypes.c_void_p,ctypes.POINTER(TlsCredentials)],ctypes.c_int32);_bind(lib,'coakka_http_host_tls_reload',[ctypes.c_void_p,ctypes.POINTER(TlsReloadRequest),ctypes.POINTER(TlsReloadOutcome)],ctypes.c_int32)
+		except AttributeError as error:raise NotImplementedError('the loaded CoAkka HTTP host does not support TLS credential control')from error
+	def _bind_all(self)->None:
+		lib=self.library;_bind(lib,'coakka_http_host_abi_version',[],ctypes.c_uint32);_bind(lib,'coakka_http_host_features',[],ctypes.c_uint64);_bind(lib,'coakka_http_host_runtime_inspect',[ctypes.POINTER(RuntimeInspection)],ctypes.c_int32);_bind(lib,'coakka_http_host_status_name',[ctypes.c_int32],ctypes.c_char_p);_bind(lib,'coakka_http_host_control_code_name',[ctypes.c_uint32],ctypes.c_char_p);initializers={'coakka_http_host_issue_init':Issue,'coakka_http_host_service_plan_request_init':ServicePlanRequest,'coakka_http_host_service_plan_init':ServicePlan,'coakka_http_host_route_init':Route,'coakka_http_host_api_example_init':ApiExample,'coakka_http_host_api_schema_property_init':ApiSchemaProperty,'coakka_http_host_api_schema_init':ApiSchema,'coakka_http_host_api_schema_definition_init':ApiSchemaDefinition,'coakka_http_host_api_parameter_init':ApiParameter,'coakka_http_host_api_media_type_init':ApiMediaType,'coakka_http_host_api_request_body_init':ApiRequestBody,'coakka_http_host_api_header_init':ApiHeader,'coakka_http_host_api_response_init':ApiResponse,'coakka_http_host_api_security_use_init':ApiSecurityUse,'coakka_http_host_api_security_requirement_init':ApiSecurityRequirement,'coakka_http_host_route_api_metadata_init':RouteApiMetadata,'coakka_http_host_static_mount_init':StaticMount,'coakka_http_host_limits_init':Limits,'coakka_http_host_monitor_options_init':MonitorOptions,'coakka_http_host_configuration_init':Configuration,'coakka_http_host_service_info_init':ServiceInfo,'coakka_http_host_runtime_info_init':RuntimeInspection,'coakka_http_host_request_event_init':RequestEvent,'coakka_http_host_request_view_init':RequestView,'coakka_http_host_response_init':Response,'coakka_http_host_body_policy_init':BodyPolicy,'coakka_http_host_file_authority_init':FileAuthority,'coakka_http_host_file_response_init':FileResponse,'coakka_http_host_compression_init':Compression,'coakka_http_host_sse_event_init':SseEvent,'coakka_http_host_websocket_event_init':WebSocketEvent,'coakka_http_host_outbound_endpoint_init':OutboundEndpoint,'coakka_http_host_outbound_target_init':OutboundTarget,'coakka_http_host_outbound_trust_init':OutboundTrust,'coakka_http_host_outbound_identity_init':OutboundIdentity,'coakka_http_host_outbound_request_init':OutboundRequest,'coakka_http_host_outbound_event_init':OutboundEvent,'coakka_http_host_failure_init':Failure,'coakka_http_host_activity_init':Activity,'coakka_http_host_health_init':Health,'coakka_http_host_route_identity_init':RouteIdentity,'coakka_http_host_rebind_request_init':RebindRequest,'coakka_http_host_rebind_outcome_init':RebindOutcome,'coakka_http_host_publication_request_init':PublicationRequest,'coakka_http_host_publication_outcome_init':PublicationOutcome,'coakka_http_host_monitor_event_init':MonitorEvent,'coakka_http_host_monitor_page_init':MonitorPage,'coakka_http_host_monitor_policy_init':MonitorPolicy,'coakka_http_host_monitor_config_init':MonitorConfig,'coakka_http_host_monitor_apply_outcome_init':MonitorApplyOutcome,'coakka_http_host_monitor_snapshot_init':MonitorSnapshot}
+		for(name,item_type)in initializers.items():_bind(lib,name,[ctypes.POINTER(item_type)],None)
+		service=ctypes.c_void_p;service_ptr=ctypes.POINTER(service);_bind(lib,'coakka_http_host_cpu_scope_enter',[ctypes.c_uint32,service_ptr,ctypes.POINTER(Issue)],ctypes.c_int32);_bind(lib,'coakka_http_host_cpu_scope_info',[service,ctypes.POINTER(CpuInfo)],ctypes.c_int32);_bind(lib,'coakka_http_host_cpu_scope_leave',[service_ptr,ctypes.POINTER(Issue)],ctypes.c_int32);_bind(lib,'coakka_http_host_plan_service',[ctypes.POINTER(ServicePlanRequest),ctypes.POINTER(ServicePlan)],ctypes.c_int32);_bind(lib,'coakka_http_host_service_create',[ctypes.POINTER(Configuration),ctypes.POINTER(Route),ctypes.c_uint32,service_ptr,ctypes.POINTER(ctypes.c_uint32)],ctypes.c_int32);_bind(lib,'coakka_http_host_service_start',[service,ctypes.POINTER(Issue)],ctypes.c_int32)
+		for name in('coakka_http_host_service_begin_drain','coakka_http_host_service_stop','coakka_http_host_interrupt_requests','coakka_http_host_interrupt_outbound','coakka_http_host_monitor_interrupt'):_bind(lib,name,[service],ctypes.c_int32)
+		_bind(lib,'coakka_http_host_service_destroy',[service_ptr],ctypes.c_int32);_bind(lib,'coakka_http_host_service_limits',[service,ctypes.POINTER(Limits)],ctypes.c_int32);_bind(lib,'coakka_http_host_service_wait_drained',[service,ctypes.c_uint64,ctypes.POINTER(ctypes.c_uint32)],ctypes.c_int32);_bind(lib,'coakka_http_host_service_info',[service,ctypes.POINTER(ServiceInfo)],ctypes.c_int32);_bind(lib,'coakka_http_host_service_port',[service,ctypes.POINTER(ctypes.c_uint16)],ctypes.c_int32);_bind(lib,'coakka_http_host_take_request',[service,ctypes.c_uint64,ctypes.POINTER(RequestEvent)],ctypes.c_int32);_bind(lib,'coakka_http_host_release_request',[service,ctypes.POINTER(RequestEvent)],ctypes.c_int32);_bind(lib,'coakka_http_host_request_view',[ctypes.POINTER(RequestEvent),ctypes.POINTER(RequestView)],ctypes.c_int32);_bind(lib,'coakka_http_host_request_stream_trailer_count',[ctypes.POINTER(RequestEvent)],ctypes.c_uint32);_bind(lib,'coakka_http_host_request_header',[ctypes.POINTER(RequestEvent),ctypes.c_uint32,ctypes.POINTER(Header)],ctypes.c_uint8);_bind(lib,'coakka_http_host_request_path_parameter',[ctypes.POINTER(RequestEvent),ctypes.c_uint32,ctypes.POINTER(PathParameter)],ctypes.c_uint8);_bind(lib,'coakka_http_host_request_query_parameter',[ctypes.POINTER(RequestEvent),ctypes.c_uint32,ctypes.POINTER(QueryParameter)],ctypes.c_uint8);_bind(lib,'coakka_http_host_request_trailer',[ctypes.POINTER(RequestEvent),ctypes.c_uint32,ctypes.POINTER(Header)],ctypes.c_uint8);_bind(lib,'coakka_http_host_request_stream_trailer',[ctypes.POINTER(RequestEvent),ctypes.c_uint32,ctypes.POINTER(Header)],ctypes.c_uint8);_bind(lib,'coakka_http_host_request_cancelled',[service,Exchange,ctypes.POINTER(ctypes.c_uint8)],ctypes.c_int32);_bind(lib,'coakka_http_host_respond',[service,Exchange,ctypes.POINTER(Response)],ctypes.c_int32);_bind(lib,'coakka_http_host_fail',[service,Exchange,ctypes.POINTER(Failure)],ctypes.c_int32);_bind(lib,'coakka_http_host_respond_file',[service,Exchange,ctypes.POINTER(FileResponse)],ctypes.c_int32);_bind(lib,'coakka_http_host_start_response_stream',[service,Exchange,ctypes.POINTER(Response)],ctypes.c_int32);_bind(lib,'coakka_http_host_write_response_stream',[service,Exchange,Bytes],ctypes.c_int32);_bind(lib,'coakka_http_host_finish_response_stream',[service,Exchange,ctypes.POINTER(Header),ctypes.c_uint32],ctypes.c_int32);_bind(lib,'coakka_http_host_start_sse',[service,Exchange,ctypes.POINTER(Header),ctypes.c_uint32],ctypes.c_int32);_bind(lib,'coakka_http_host_write_sse',[service,Exchange,ctypes.POINTER(SseEvent)],ctypes.c_int32);_bind(lib,'coakka_http_host_accept_websocket',[service,Exchange,Bytes],ctypes.c_int32);_bind(lib,'coakka_http_host_take_websocket',[service,ctypes.c_uint64,ctypes.POINTER(WebSocketEvent)],ctypes.c_int32);_bind(lib,'coakka_http_host_release_websocket',[service,ctypes.POINTER(WebSocketEvent)],ctypes.c_int32);_bind(lib,'coakka_http_host_send_websocket',[service,WebSocket,ctypes.c_uint32,Bytes],ctypes.c_int32);_bind(lib,'coakka_http_host_close_websocket',[service,WebSocket,ctypes.c_uint32,Bytes],ctypes.c_int32);_bind(lib,'coakka_http_host_submit_outbound',[service,ctypes.POINTER(OutboundRequest),ctypes.POINTER(OutboundCall)],ctypes.c_int32);_bind(lib,'coakka_http_host_cancel_outbound',[service,OutboundCall],ctypes.c_int32);_bind(lib,'coakka_http_host_take_outbound',[service,ctypes.c_uint64,ctypes.POINTER(OutboundEvent)],ctypes.c_int32);_bind(lib,'coakka_http_host_outbound_header',[service,ctypes.POINTER(OutboundEvent),ctypes.c_uint32,ctypes.POINTER(Header)],ctypes.c_uint8);_bind(lib,'coakka_http_host_release_outbound',[service,ctypes.POINTER(OutboundEvent)],ctypes.c_int32);_bind(lib,'coakka_http_host_service_health',[service,ctypes.POINTER(Health)],ctypes.c_int32);_bind(lib,'coakka_http_host_probe_liveness',[service,ctypes.c_uint64,ctypes.POINTER(Health)],ctypes.c_int32);_bind(lib,'coakka_http_host_route_snapshot',[service,ctypes.POINTER(RouteState),ctypes.c_uint32,ctypes.POINTER(RouteIdentity)],ctypes.c_int32);_bind(lib,'coakka_http_host_rebind',[service,ctypes.POINTER(RebindRequest),ctypes.POINTER(RebindOutcome)],ctypes.c_int32);_bind(lib,'coakka_http_host_publish_routes',[service,ctypes.POINTER(PublicationRequest),ctypes.POINTER(PublicationOutcome)],ctypes.c_int32);_bind(lib,'coakka_http_host_monitor_enabled',[service],ctypes.c_uint8);_bind(lib,'coakka_http_host_monitor_config',[service,ctypes.POINTER(MonitorConfig)],ctypes.c_int32);_bind(lib,'coakka_http_host_monitor_apply',[service,ctypes.c_uint64,ctypes.POINTER(MonitorPolicy),ctypes.POINTER(MonitorApplyOutcome)],ctypes.c_int32);_bind(lib,'coakka_http_host_monitor_read',[service,ctypes.c_uint64,ctypes.c_uint32,ctypes.POINTER(MonitorEvent),ctypes.c_uint32,ctypes.POINTER(MonitorPage)],ctypes.c_int32);_bind(lib,'coakka_http_host_monitor_snapshot',[service,ctypes.POINTER(MonitorSnapshot)],ctypes.c_int32);_bind(lib,'coakka_http_host_monitor_wait',[service,ctypes.c_uint64],ctypes.c_int32)
+	def check(self,status:int)->None:
+		'Raise a typed error unless ``status`` reports success.'
+		if int(status)==STATUS_OK:return
+		name=self.library.coakka_http_host_status_name(int(status));detail=name.decode('ascii',errors='replace')if name else'unknown';raise NativeError(int(status),detail)
+	def check_issue(self,status:int,issue:Issue)->None:
+		'Raise one copied causal error unless ``status`` reports success.'
+		if int(status)==STATUS_OK:return
+		detail=bytes(issue.detail).split(b'\x00',1)[0].decode('utf-8',errors='replace');raise NativeError(int(status),detail or'unknown',reason=int(issue.reason),system_code=int(issue.system_code),item_index=int(issue.item_index),actual=int(issue.actual),limit=int(issue.limit))
+LIBRARY=Library()

coakka_http/_package.json

@@ -0,0 +1,10 @@
+{
+  "candidate": false,
+  "format": "coakka.http.python-package.v2",
+  "library": "native/coakka_http_host.dll",
+  "library_sha256": "50cf9c6b90873d96ac7822f44fc50a1ce82d0e2d3c9f308676f593adf3d7a5ed",
+  "platform": "windows-aarch64",
+  "projection": "native/_coakka_http_projection.pyd",
+  "projection_sha256": "b856255cb8dee69e96e6337d17f9a05c67906d3728d2837408b9104ac39594ce",
+  "python_minimum": "3.11"
+}

coakka_http/_projection.py

@@ -0,0 +1,64 @@
+'Private CPython Stable-ABI projection for managed inbound service events.'
+from __future__ import annotations
+import ctypes
+from functools import partial
+import importlib.util
+import io
+import os
+from collections.abc import Callable
+from pathlib import Path
+import sys
+import threading
+from types import ModuleType
+from typing import Final,cast
+from.import _native as native
+from.values import Headers,Request
+_FUNCTIONS:Final=('coakka_http_host_request_event_init','coakka_http_host_request_view_init','coakka_http_host_take_request','coakka_http_host_release_request','coakka_http_host_request_view','coakka_http_host_request_header','coakka_http_host_request_path_parameter','coakka_http_host_request_query_parameter','coakka_http_host_request_trailer','coakka_http_host_request_stream_trailer_count','coakka_http_host_request_stream_trailer','coakka_http_host_request_cancelled','coakka_http_host_respond','coakka_http_host_response_init')
+_MODULE_NAME:Final='coakka_http._coakka_http_projection'
+_LOAD_LOCK:Final=threading.RLock()
+_loading=False
+_Create=Callable[[object,tuple[int,...]],object]
+_Take=Callable[[object,int,int],tuple[object,...]]
+_Respond=Callable[[object,int,int,int,object],int]
+_PrepareResponse=Callable[[object,int,object,int,bytes],None]
+_FailAfter=Callable[[int],None]
+_Request=Callable[...,Request]
+_BindRequest=Callable[[type[Request],object],_Request]
+_Headers=Callable[[tuple[str,...]],Headers]
+_BindHeaders=Callable[[],_Headers]
+_ServiceRecord=Callable[[tuple[object,...]],tuple[Request,int,int]]
+_BindServiceRecord=Callable[[_Request,_Headers],_ServiceRecord]
+def _projection_path()->Path|None:
+	'Resolve one explicit source adapter or the package-admitted image.';configured=os.environ.get('COAKKA_HTTP_PYTHON_PROJECTION_PATH')
+	if configured is not None:
+		path=Path(configured)
+		if not path.is_absolute()or not path.is_file()or path.is_symlink():raise RuntimeError('COAKKA_HTTP_PYTHON_PROJECTION_PATH must name an absolute regular file')
+		return path
+	package=Path(__file__).parent;receipt=package/'_package.json'
+	if not receipt.exists()and not receipt.is_symlink():return None
+	return native._package_images(package)[1]
+def _load(path:Path)->ModuleType:
+	'Load the exact private extension without searching another package.';global _loading
+	with _LOAD_LOCK:
+		existing=sys.modules.get(_MODULE_NAME)
+		if isinstance(existing,ModuleType):
+			if Path(cast(str,existing.__file__)).resolve()!=path.resolve():raise RuntimeError('CoAkka HTTP projection image identity changed')
+			return existing
+		if _loading:raise RuntimeError('CoAkka HTTP projection initialization reentered')
+		_loading=True
+		try:
+			specification=importlib.util.spec_from_file_location(_MODULE_NAME,path)
+			if specification is None or specification.loader is None:raise RuntimeError('CoAkka HTTP Python projection cannot be loaded')
+			module=importlib.util.module_from_spec(specification);specification.loader.exec_module(module);sys.modules[_MODULE_NAME]=module;return module
+		finally:_loading=False
+def _address(name:str)->int:
+	'Copy one admitted host-function address into the immutable cold table.';value=ctypes.cast(getattr(native.LIBRARY.library,name),ctypes.c_void_p).value
+	if value is None:raise RuntimeError(f"CoAkka HTTP projection function is missing: {name}")
+	return value
+class Projection:
+	'Own one immutable function table; no Runtime/service state is retained.';__slots__='_context','_fail','_module','take','respond','request','prepare_response','headers','service_record'
+	def __init__(self,module:ModuleType)->None:'Bind the adapter to the already ABI-checked host image.';self._module=module;bind_request=cast(_BindRequest,getattr(module,'bind_request'));self.request=bind_request(Request,io.BytesIO);bind_headers=cast(_BindHeaders,getattr(module,'bind_headers'));self.headers=bind_headers();bind_record=cast(_BindServiceRecord,getattr(module,'bind_service_record'));self.service_record=bind_record(self.request,self.headers);create=cast(_Create,getattr(module,'create'));self._fail=cast(_FailAfter,getattr(module,'_fail_after'));self._context=create(native.LIBRARY,tuple(_address(name)for name in _FUNCTIONS));self.take=cast(_Take,partial(getattr(module,'take_event'),self._context));self.respond=cast(_Respond,partial(getattr(module,'submit_response'),self._context));self.prepare_response=cast(_PrepareResponse,partial(getattr(module,'prepare_response'),self._context))
+	def fresh(self)->Projection:'Build a new cold table for a directed function-interposition test.';return Projection(self._module)
+	def fail_after(self,publications:int)->None:'Inject one private thread-local publication failure for tests.';self._fail(publications)
+_path=_projection_path()
+PROJECTION:Final=Projection(_load(_path))if _path is not None else None

coakka_http/_service_cpu.py

@@ -0,0 +1,63 @@
+"Same-OS-thread owner for Core's startup CPU placement lease.\n\nPython owns only thread lifetime and handoff. Core chooses/verifies/restores\nplacement and supplies all facts. This one sleeping lifecycle thread starts\nthe Core and Python workers so they inherit placement; it never handles an\nHTTP request, changes unrelated application threads or polls the OS.\n"
+from __future__ import annotations
+import ctypes
+import threading
+import time
+from collections.abc import Callable
+from typing import TYPE_CHECKING
+from.import _native as native
+from.values import CpuInfo,CpuPlacement,CpuPolicy
+if TYPE_CHECKING:from.service import Service
+class ServiceStartInterrupted(BaseException):
+	'Startup interruption whose bounded cleanup did not finish.\n\n    ``interruption`` preserves the original KeyboardInterrupt/SystemExit or\n    other caller interruption; ``cleanup_error`` preserves the failed cleanup.\n    Call ``close(timeout_ms)`` to retry. The exception retains the in-flight\n    startup owner even if no native Runtime has been published yet. It is a\n    BaseException so ordinary application exception handlers do not swallow a\n    lifecycle interruption accidentally.\n    '
+	def __init__(self,interruption:BaseException,owner:_ServiceCpuOwner)->None:'Retain one bounded startup handoff and its original interruption.';super().__init__('service startup interrupted; cleanup owner retained, call close()');self.interruption=interruption;(self.cleanup_error):BaseException|None=None;self._owner=owner
+	def close(self,timeout_ms:int=30000)->None:
+		'Await startup publication and retry cleanup within one finite wait budget.'
+		if isinstance(timeout_ms,bool)or not isinstance(timeout_ms,int)or not 1<=timeout_ms<=60000:raise ValueError('close timeout is invalid')
+		self._owner._close_interrupted(timeout_ms)
+class _ServiceCpuOwner:
+	'Own one Core scope from startup through child join and native destroy.'
+	def __init__(self,policy:CpuPolicy)->None:'Reserve one-shot synchronization, no unbounded command queue.';self._policy=policy;self._scope=ctypes.c_void_p();self._ready=threading.Event();self._finish=threading.Event();(self._thread):threading.Thread|None=None;(self._service):Service|None=None;(self._error):BaseException|None=None;(self._leave_error):BaseException|None=None;(self.info):CpuInfo|None=None
+	def start(self,build:Callable[[],Service],close_timeout_ms:int=30000)->Service:
+		'Create a private owner thread and await the bounded native startup.';self._thread=threading.Thread(target=self._run,args=(build,),name='coakka-http-lifecycle');self._thread.start()
+		try:self._ready.wait()
+		except BaseException as interruption:
+			retained=ServiceStartInterrupted(interruption,self)
+			try:retained.close(close_timeout_ms)
+			except BaseException as cleanup_error:retained.cleanup_error=cleanup_error;raise retained from interruption
+			raise
+		if self._error is not None:raise self._error
+		assert self._service is not None;return self._service
+	def _close_interrupted(self,timeout_ms:int)->None:
+		'Resolve the one-shot handoff before choosing its real cleanup owner.';from.service import ServiceStartError;deadline=time.monotonic()+timeout_ms/1000
+		if not self._ready.wait(timeout_ms/1000):raise TimeoutError('timed out waiting for interrupted startup')
+		if self._service is not None:
+			remaining_ms=int((deadline-time.monotonic())*1000)
+			if remaining_ms<=0:raise TimeoutError('interrupted startup cleanup budget expired')
+			self._service.close(remaining_ms)
+		elif isinstance(self._error,ServiceStartError):
+			remaining_ms=int((deadline-time.monotonic())*1000)
+			if remaining_ms<=0:raise TimeoutError('interrupted startup cleanup budget expired')
+			self._error.close(remaining_ms)
+		elif self._error is not None:raise self._error
+	def _run(self,build:Callable[[],Service])->None:
+		from.service import ServiceStartError;retained=False
+		try:
+			issue=native.Issue();native.LIBRARY.library.coakka_http_host_issue_init(ctypes.byref(issue));native.LIBRARY.check_issue(native.LIBRARY.library.coakka_http_host_cpu_scope_enter(int(self._policy),ctypes.byref(self._scope),ctypes.byref(issue)),issue);value=native.CpuInfo();value.struct_size=ctypes.sizeof(value);native.LIBRARY.check(native.LIBRARY.library.coakka_http_host_cpu_scope_info(self._scope,ctypes.byref(value)))
+			if value.selected_cpu_count>2:raise RuntimeError('Core CPU selection exceeds the public bound')
+			self.info=CpuInfo(requested_policy=CpuPolicy(value.requested_policy),placement=CpuPlacement(value.placement),available_cpu_count=int(value.available_cpu_count),selected_cpu_count=int(value.selected_cpu_count),selected_cpu_ids=tuple(int(value.selected_cpu_ids[index])for index in range(value.selected_cpu_count)));self._service=build();self._service._cpu_owner=self;retained=True
+		except ServiceStartError as error:error._cpu_owner=self;self._error=error;retained=True
+		except BaseException as error:self._error=error
+		finally:
+			if retained:self._ready.set();self._finish.wait()
+			self._leave()
+			if not retained and self._leave_error is not None:self._error=BaseExceptionGroup('startup and CPU cleanup failed',[error for error in(self._error,self._leave_error)if error is not None])
+			self._ready.set()
+	def _leave(self)->None:
+		if not self._scope.value:return
+		try:issue=native.Issue();native.LIBRARY.library.coakka_http_host_issue_init(ctypes.byref(issue));native.LIBRARY.check_issue(native.LIBRARY.library.coakka_http_host_cpu_scope_leave(ctypes.byref(self._scope),ctypes.byref(issue)),issue)
+		except BaseException as error:self._leave_error=error
+	def close(self,timeout:float|None=None)->None:
+		'Release on the entering thread only after every child has joined.';self._finish.set();assert self._thread is not None;self._thread.join(timeout)
+		if self._thread.is_alive():raise TimeoutError('timed out joining CPU scope owner')
+		if self._leave_error is not None:raise self._leave_error