ai-character-engine 1.0.0__py3-none-any.whl

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (235) hide show
  1. ai_character_engine/__init__.py +788 -0
  2. ai_character_engine/_version.py +1 -0
  3. ai_character_engine/autonomy/__init__.py +25 -0
  4. ai_character_engine/autonomy/controller.py +67 -0
  5. ai_character_engine/autonomy/models.py +142 -0
  6. ai_character_engine/autonomy/policy.py +71 -0
  7. ai_character_engine/autonomy/scheduler.py +201 -0
  8. ai_character_engine/avatar/__init__.py +37 -0
  9. ai_character_engine/avatar/behavior.py +671 -0
  10. ai_character_engine/avatar/envelope.py +83 -0
  11. ai_character_engine/avatar/models.py +186 -0
  12. ai_character_engine/avatar/runtime.py +116 -0
  13. ai_character_engine/avatar/scheduler.py +112 -0
  14. ai_character_engine/avatar/viseme.py +167 -0
  15. ai_character_engine/character/__init__.py +0 -0
  16. ai_character_engine/character/profile.py +18 -0
  17. ai_character_engine/cognition/__init__.py +80 -0
  18. ai_character_engine/cognition/background.py +1132 -0
  19. ai_character_engine/cognition/errors.py +10 -0
  20. ai_character_engine/cognition/models.py +125 -0
  21. ai_character_engine/cognition/router.py +160 -0
  22. ai_character_engine/cognition/runtime.py +175 -0
  23. ai_character_engine/cognition/tasks.py +59 -0
  24. ai_character_engine/cognitive_evaluation/__init__.py +21 -0
  25. ai_character_engine/cognitive_evaluation/__main__.py +36 -0
  26. ai_character_engine/cognitive_evaluation/dataset.py +114 -0
  27. ai_character_engine/cognitive_evaluation/evaluator.py +386 -0
  28. ai_character_engine/cognitive_evaluation/models.py +490 -0
  29. ai_character_engine/collaboration/__init__.py +32 -0
  30. ai_character_engine/collaboration/models.py +237 -0
  31. ai_character_engine/collaboration/runtime.py +720 -0
  32. ai_character_engine/commit/__init__.py +19 -0
  33. ai_character_engine/commit/coordinator.py +1068 -0
  34. ai_character_engine/commit/models.py +80 -0
  35. ai_character_engine/companion/__init__.py +27 -0
  36. ai_character_engine/companion/access.py +203 -0
  37. ai_character_engine/companion/companion.py +1944 -0
  38. ai_character_engine/companion/settings.py +94 -0
  39. ai_character_engine/compatibility/__init__.py +53 -0
  40. ai_character_engine/compatibility/__main__.py +69 -0
  41. ai_character_engine/compatibility/checker.py +173 -0
  42. ai_character_engine/compatibility/contracts.py +61 -0
  43. ai_character_engine/compatibility/manifest.py +143 -0
  44. ai_character_engine/compatibility/models.py +205 -0
  45. ai_character_engine/context/__init__.py +19 -0
  46. ai_character_engine/context/budget.py +156 -0
  47. ai_character_engine/context/builder.py +877 -0
  48. ai_character_engine/distributed/__init__.py +47 -0
  49. ai_character_engine/distributed/broker.py +322 -0
  50. ai_character_engine/distributed/errors.py +14 -0
  51. ai_character_engine/distributed/models.py +400 -0
  52. ai_character_engine/distributed/runtime.py +175 -0
  53. ai_character_engine/evaluation/__init__.py +35 -0
  54. ai_character_engine/evaluation/__main__.py +31 -0
  55. ai_character_engine/evaluation/dataset.py +119 -0
  56. ai_character_engine/evaluation/evaluator.py +234 -0
  57. ai_character_engine/evaluation/models.py +304 -0
  58. ai_character_engine/events/__init__.py +3 -0
  59. ai_character_engine/events/models.py +37 -0
  60. ai_character_engine/extensions/__init__.py +51 -0
  61. ai_character_engine/extensions/discovery.py +54 -0
  62. ai_character_engine/extensions/errors.py +25 -0
  63. ai_character_engine/extensions/manager.py +85 -0
  64. ai_character_engine/extensions/models.py +156 -0
  65. ai_character_engine/extensions/policy.py +33 -0
  66. ai_character_engine/extensions/protocols.py +18 -0
  67. ai_character_engine/extensions/registry.py +245 -0
  68. ai_character_engine/goals/__init__.py +24 -0
  69. ai_character_engine/goals/manager.py +165 -0
  70. ai_character_engine/goals/models.py +195 -0
  71. ai_character_engine/goals/store.py +169 -0
  72. ai_character_engine/host/__init__.py +3 -0
  73. ai_character_engine/host/bridge.py +318 -0
  74. ai_character_engine/live/__init__.py +18 -0
  75. ai_character_engine/live/models.py +145 -0
  76. ai_character_engine/live/orchestrator.py +1236 -0
  77. ai_character_engine/llm/__init__.py +103 -0
  78. ai_character_engine/llm/base.py +27 -0
  79. ai_character_engine/llm/deployment.py +339 -0
  80. ai_character_engine/llm/errors.py +6 -0
  81. ai_character_engine/llm/gateway.py +542 -0
  82. ai_character_engine/llm/inference.py +501 -0
  83. ai_character_engine/llm/local.py +439 -0
  84. ai_character_engine/llm/models.py +48 -0
  85. ai_character_engine/llm/provider.py +126 -0
  86. ai_character_engine/llm/voice_stream.py +156 -0
  87. ai_character_engine/long_term_cognition/__init__.py +38 -0
  88. ai_character_engine/long_term_cognition/consolidation.py +228 -0
  89. ai_character_engine/long_term_cognition/manager.py +82 -0
  90. ai_character_engine/long_term_cognition/models.py +175 -0
  91. ai_character_engine/long_term_cognition/store.py +252 -0
  92. ai_character_engine/memory/__init__.py +138 -0
  93. ai_character_engine/memory/config.py +20 -0
  94. ai_character_engine/memory/consolidation.py +204 -0
  95. ai_character_engine/memory/embedding.py +189 -0
  96. ai_character_engine/memory/evaluation.py +156 -0
  97. ai_character_engine/memory/evidence.py +164 -0
  98. ai_character_engine/memory/hybrid.py +281 -0
  99. ai_character_engine/memory/ledger.py +127 -0
  100. ai_character_engine/memory/manager.py +257 -0
  101. ai_character_engine/memory/models.py +82 -0
  102. ai_character_engine/memory/policy.py +82 -0
  103. ai_character_engine/memory/production.py +341 -0
  104. ai_character_engine/memory/providers.py +59 -0
  105. ai_character_engine/memory/qdrant.py +331 -0
  106. ai_character_engine/memory/query.py +78 -0
  107. ai_character_engine/memory/ranking.py +148 -0
  108. ai_character_engine/memory/retriever.py +207 -0
  109. ai_character_engine/memory/revision.py +327 -0
  110. ai_character_engine/memory/store.py +140 -0
  111. ai_character_engine/memory/summarizer.py +70 -0
  112. ai_character_engine/memory/trace.py +64 -0
  113. ai_character_engine/memory/vector.py +90 -0
  114. ai_character_engine/multi_character/__init__.py +48 -0
  115. ai_character_engine/multi_character/errors.py +18 -0
  116. ai_character_engine/multi_character/models.py +134 -0
  117. ai_character_engine/multi_character/runtime.py +261 -0
  118. ai_character_engine/multi_character/scheduler.py +131 -0
  119. ai_character_engine/multi_character/store.py +212 -0
  120. ai_character_engine/observability/__init__.py +11 -0
  121. ai_character_engine/observability/eval.py +85 -0
  122. ai_character_engine/observability/models.py +99 -0
  123. ai_character_engine/observability/sink.py +98 -0
  124. ai_character_engine/observability/tracing.py +78 -0
  125. ai_character_engine/performance/__init__.py +34 -0
  126. ai_character_engine/performance/__main__.py +74 -0
  127. ai_character_engine/performance/budgets.py +143 -0
  128. ai_character_engine/performance/io.py +19 -0
  129. ai_character_engine/performance/models.py +288 -0
  130. ai_character_engine/performance/profiler.py +167 -0
  131. ai_character_engine/persistence/__init__.py +66 -0
  132. ai_character_engine/persistence/__main__.py +69 -0
  133. ai_character_engine/persistence/fixtures.py +95 -0
  134. ai_character_engine/persistence/io.py +96 -0
  135. ai_character_engine/persistence/models.py +162 -0
  136. ai_character_engine/persistence/registry.py +420 -0
  137. ai_character_engine/production/__init__.py +16 -0
  138. ai_character_engine/production/models.py +174 -0
  139. ai_character_engine/production/runtime.py +371 -0
  140. ai_character_engine/release/__init__.py +51 -0
  141. ai_character_engine/release/__main__.py +78 -0
  142. ai_character_engine/release/inspector.py +267 -0
  143. ai_character_engine/release/matrix.py +28 -0
  144. ai_character_engine/release/models.py +232 -0
  145. ai_character_engine/release_candidate/__init__.py +23 -0
  146. ai_character_engine/release_candidate/__main__.py +88 -0
  147. ai_character_engine/release_candidate/acceptance.py +184 -0
  148. ai_character_engine/release_candidate/collector.py +45 -0
  149. ai_character_engine/release_candidate/evidence.py +106 -0
  150. ai_character_engine/release_candidate/models.py +140 -0
  151. ai_character_engine/release_candidate/provenance.py +64 -0
  152. ai_character_engine/runtime/__init__.py +6 -0
  153. ai_character_engine/runtime/character_runtime.py +712 -0
  154. ai_character_engine/runtime/coordination.py +62 -0
  155. ai_character_engine/runtime/loop.py +69 -0
  156. ai_character_engine/runtime/models.py +38 -0
  157. ai_character_engine/service/__init__.py +68 -0
  158. ai_character_engine/service/app.py +335 -0
  159. ai_character_engine/service/auth.py +31 -0
  160. ai_character_engine/service/config.py +22 -0
  161. ai_character_engine/service/errors.py +58 -0
  162. ai_character_engine/service/models.py +129 -0
  163. ai_character_engine/service/service.py +326 -0
  164. ai_character_engine/service/streaming.py +101 -0
  165. ai_character_engine/session/__init__.py +41 -0
  166. ai_character_engine/session/factory.py +139 -0
  167. ai_character_engine/session/manager.py +172 -0
  168. ai_character_engine/session/models.py +154 -0
  169. ai_character_engine/session/runtime.py +99 -0
  170. ai_character_engine/session/serialization.py +143 -0
  171. ai_character_engine/session/store.py +151 -0
  172. ai_character_engine/stability/__init__.py +33 -0
  173. ai_character_engine/stability/__main__.py +44 -0
  174. ai_character_engine/stability/injection.py +52 -0
  175. ai_character_engine/stability/models.py +158 -0
  176. ai_character_engine/stability/probes.py +74 -0
  177. ai_character_engine/stability/soak.py +168 -0
  178. ai_character_engine/state/__init__.py +14 -0
  179. ai_character_engine/state/models.py +122 -0
  180. ai_character_engine/state/policy.py +41 -0
  181. ai_character_engine/state/relationship.py +186 -0
  182. ai_character_engine/state/rules.py +98 -0
  183. ai_character_engine/tasks/__init__.py +42 -0
  184. ai_character_engine/tasks/errors.py +18 -0
  185. ai_character_engine/tasks/models.py +209 -0
  186. ai_character_engine/tasks/runtime.py +523 -0
  187. ai_character_engine/tools/__init__.py +11 -0
  188. ai_character_engine/tools/errors.py +22 -0
  189. ai_character_engine/tools/executor.py +101 -0
  190. ai_character_engine/tools/models.py +44 -0
  191. ai_character_engine/tools/registry.py +47 -0
  192. ai_character_engine/tools/validation.py +79 -0
  193. ai_character_engine/training/__init__.py +37 -0
  194. ai_character_engine/training/__main__.py +55 -0
  195. ai_character_engine/training/dataset.py +122 -0
  196. ai_character_engine/training/gate.py +47 -0
  197. ai_character_engine/training/huggingface.py +115 -0
  198. ai_character_engine/training/models.py +233 -0
  199. ai_character_engine/training/planner.py +30 -0
  200. ai_character_engine/vision/__init__.py +37 -0
  201. ai_character_engine/vision/base.py +17 -0
  202. ai_character_engine/vision/errors.py +14 -0
  203. ai_character_engine/vision/memory.py +31 -0
  204. ai_character_engine/vision/models.py +160 -0
  205. ai_character_engine/vision/pipeline.py +151 -0
  206. ai_character_engine/vision/providers.py +112 -0
  207. ai_character_engine/vision/sampling.py +59 -0
  208. ai_character_engine/vision/validation.py +95 -0
  209. ai_character_engine/voice/__init__.py +75 -0
  210. ai_character_engine/voice/acceptance.py +117 -0
  211. ai_character_engine/voice/base.py +97 -0
  212. ai_character_engine/voice/devices.py +144 -0
  213. ai_character_engine/voice/duplex.py +72 -0
  214. ai_character_engine/voice/gpt_sovits.py +100 -0
  215. ai_character_engine/voice/live.py +216 -0
  216. ai_character_engine/voice/loop.py +84 -0
  217. ai_character_engine/voice/mac_providers.py +200 -0
  218. ai_character_engine/voice/models.py +96 -0
  219. ai_character_engine/voice/pipeline.py +269 -0
  220. ai_character_engine/voice/streaming.py +105 -0
  221. ai_character_engine/voice/text.py +50 -0
  222. ai_character_engine/voice/vad.py +113 -0
  223. ai_character_engine/voice/whisper_worker.py +51 -0
  224. ai_character_engine/world/__init__.py +50 -0
  225. ai_character_engine/world/errors.py +17 -0
  226. ai_character_engine/world/models.py +194 -0
  227. ai_character_engine/world/perception.py +30 -0
  228. ai_character_engine/world/runtime.py +228 -0
  229. ai_character_engine/world/store.py +278 -0
  230. ai_character_engine-1.0.0.dist-info/METADATA +219 -0
  231. ai_character_engine-1.0.0.dist-info/RECORD +235 -0
  232. ai_character_engine-1.0.0.dist-info/WHEEL +5 -0
  233. ai_character_engine-1.0.0.dist-info/entry_points.txt +3 -0
  234. ai_character_engine-1.0.0.dist-info/licenses/LICENSE +202 -0
  235. ai_character_engine-1.0.0.dist-info/top_level.txt +1 -0
@@ -0,0 +1,788 @@
1
+ from ai_character_engine.autonomy import (
2
+ AutonomyController,
3
+ AutonomyPolicy,
4
+ AutonomyScheduler,
5
+ ProactiveCandidate,
6
+ QuietHours,
7
+ )
8
+ from ai_character_engine.character.profile import CharacterProfile
9
+ from ai_character_engine.context import ContextBudget, ContextTrace
10
+ from ai_character_engine.events.models import CharacterEvent
11
+ from ai_character_engine.live import (
12
+ DuplexVoiceConfig,
13
+ DuplexVoiceError,
14
+ LiveVoicePhase,
15
+ LiveCharacterOrchestrator,
16
+ LiveEventType,
17
+ LiveInputKind,
18
+ LiveRuntimeBackpressureError,
19
+ LiveRuntimeConfig,
20
+ LiveRuntimeError,
21
+ LiveRuntimeEvent,
22
+ LiveTurnInput,
23
+ MouthActivityCue,
24
+ )
25
+ from ai_character_engine.llm import (
26
+ GatewayCircuitBreaker,
27
+ ModelEndpoint,
28
+ ModelGatewayClient,
29
+ RoutingRule,
30
+ RuleBasedModelRouter,
31
+ StaticModelRouter,
32
+ )
33
+ from ai_character_engine.long_term_cognition import (
34
+ SAFE_BELIEF_EVIDENCE_TYPES,
35
+ BeliefClaim,
36
+ BeliefConsolidationPolicy,
37
+ BeliefConsolidationResult,
38
+ BeliefRecord,
39
+ BeliefStatus,
40
+ CognitionEvidenceRef,
41
+ DeterministicBeliefConsolidator,
42
+ InMemoryLongTermCognitionStore,
43
+ JsonlLongTermCognitionStore,
44
+ LongTermCognitionManager,
45
+ LongTermCognitionStore,
46
+ ReflectionCommitResult,
47
+ ReflectionRecord,
48
+ ReflectionStatus,
49
+ )
50
+ from ai_character_engine.goals import (
51
+ GoalCommitResult,
52
+ GoalEvidenceRef,
53
+ GoalHorizon,
54
+ GoalManager,
55
+ GoalRecord,
56
+ GoalStatus,
57
+ GoalStore,
58
+ InMemoryGoalStore,
59
+ JsonlGoalStore,
60
+ MotivationKind,
61
+ MotivationSignal,
62
+ )
63
+ from ai_character_engine.memory import MemoryManager, MemoryRecord
64
+ from ai_character_engine.runtime import CharacterEventLoop, CharacterRunResult, CharacterRuntime
65
+ from ai_character_engine.session import (
66
+ CharacterRuntimeFactory,
67
+ ManagedCharacterSession,
68
+ SessionManager,
69
+ SessionRecord,
70
+ )
71
+ from ai_character_engine.state import CharacterState, StatePatch
72
+ from ai_character_engine.collaboration import (
73
+ CollaborationResult,
74
+ CollaborationSource,
75
+ CognitiveWorkItem,
76
+ CognitiveWorkPlan,
77
+ SpecialistCollaborationConfig,
78
+ SpecialistCollaborationRuntime,
79
+ SpecialistFinding,
80
+ SpecialistKind,
81
+ SpecialistRunStatus,
82
+ SpecialistSpec,
83
+ VerificationDecision,
84
+ VerificationIssue,
85
+ VerificationReport,
86
+ default_specialists,
87
+ )
88
+ from ai_character_engine.commit import (
89
+ CognitiveCommitCoordinator,
90
+ CommitLifecycleEvent,
91
+ CommitNextAction,
92
+ CommitResult,
93
+ CommitStatus,
94
+ CommitTargetPolicy,
95
+ StalePolicy,
96
+ )
97
+ from ai_character_engine.cognition import (
98
+ BackgroundCognitionConfig,
99
+ BackgroundCognitionEvent,
100
+ BackgroundCognitionKind,
101
+ BackgroundCognitionResult,
102
+ BackgroundCognitionRuntime,
103
+ BackgroundWorkerSpec,
104
+ StructuredBackgroundWorker,
105
+ CognitiveModelRouter,
106
+ CognitiveModelRuntime,
107
+ CognitiveOptimization,
108
+ CognitiveRole,
109
+ CognitiveRoleClient,
110
+ CognitiveRolePolicy,
111
+ CognitiveRouteDecision,
112
+ CognitiveRouteRequirements,
113
+ CognitiveTaskHandler,
114
+ )
115
+ from ai_character_engine.tasks import (
116
+ MultiTaskRuntime,
117
+ MultiTaskRuntimeConfig,
118
+ TaskContext,
119
+ TaskHandle,
120
+ TaskLifecycleEvent,
121
+ TaskOutput,
122
+ TaskPriority,
123
+ TaskProposal,
124
+ TaskRequest,
125
+ TaskResult,
126
+ TaskStatus,
127
+ )
128
+ from ai_character_engine.cognitive_evaluation import (
129
+ CallableCognitiveJudgeAdapter,
130
+ CognitiveAggregateMetrics,
131
+ CognitiveEvalCase,
132
+ CognitiveEvalDataset,
133
+ CognitiveEvalDimension,
134
+ CognitiveEvalPolicy,
135
+ CognitiveEvalReport,
136
+ CognitiveEvalResult,
137
+ CognitiveEvalSource,
138
+ CognitiveEvalTrace,
139
+ CognitiveEvaluator,
140
+ CognitiveJudgeAdapter,
141
+ CognitiveJudgeVerdict,
142
+ CognitiveTimelineFrame,
143
+ aggregate_cognitive_metrics,
144
+ evaluate_cognitive_dataset,
145
+ )
146
+ from ai_character_engine.production import (
147
+ CircuitBreakerPolicy,
148
+ CircuitState,
149
+ DegradedMode,
150
+ EvaluationGateDecision,
151
+ EvaluationGatePolicy,
152
+ FailureClass,
153
+ Idempotency,
154
+ OperationLifecycleEvent,
155
+ OperationResult,
156
+ OperationStatus,
157
+ ProductionHardeningConfig,
158
+ ProductionHardeningRuntime,
159
+ ProductionHealthSnapshot,
160
+ ResourceLimits,
161
+ RetryPolicy,
162
+ default_failure_classifier,
163
+ evaluation_gate,
164
+ )
165
+ from ai_character_engine.multi_character import (
166
+ CharacterExchange,
167
+ CharacterExchangeStore,
168
+ CharacterInteractionResult,
169
+ CharacterIsolationError,
170
+ CharacterSchedulerOverloadedError,
171
+ ExchangeStatus,
172
+ FairCharacterScheduler,
173
+ FairSchedulerConfig,
174
+ FairSchedulerSnapshot,
175
+ InMemoryCharacterExchangeStore,
176
+ InMemorySharedCognitionStore,
177
+ JsonlCharacterExchangeStore,
178
+ JsonlSharedCognitionStore,
179
+ KnowledgeVisibility,
180
+ MultiCharacterRuntime,
181
+ SharedCognitionAccessError,
182
+ SharedCognitionRecord,
183
+ SharedCognitionStore,
184
+ UnknownCharacterError,
185
+ )
186
+ from ai_character_engine.world import (
187
+ ExplicitWorldPerceptionPolicy,
188
+ InMemoryWorldObservationStore,
189
+ InMemoryWorldStore,
190
+ JsonlWorldObservationStore,
191
+ JsonlWorldStore,
192
+ WorldChangeKind,
193
+ WorldError,
194
+ WorldEvent,
195
+ WorldFactChange,
196
+ WorldObservation,
197
+ WorldObservationStore,
198
+ WorldPatch,
199
+ WorldPerceptionDeniedError,
200
+ WorldPerceptionPolicy,
201
+ WorldPerceptionProjection,
202
+ WorldPerceptionProjectionError,
203
+ WorldPerceptionScope,
204
+ WorldRevisionConflictError,
205
+ WorldRuntime,
206
+ WorldStateSnapshot,
207
+ WorldStore,
208
+ )
209
+ from ai_character_engine.distributed import (
210
+ DISTRIBUTED_PROTOCOL_VERSION,
211
+ CompletionDisposition,
212
+ CompletionReceipt,
213
+ DistributedBrokerConfig,
214
+ DistributedCompletion,
215
+ DistributedLease,
216
+ DistributedLifecycleEvent,
217
+ DistributedQueueFullError,
218
+ DistributedRuntimeError,
219
+ DistributedTaskBroker,
220
+ DistributedTaskCoordinator,
221
+ DistributedTaskEnvelope,
222
+ DistributedTaskHandler,
223
+ DistributedTaskNotFoundError,
224
+ DistributedTaskSnapshot,
225
+ DistributedTaskStatus,
226
+ DistributedWorker,
227
+ DistributedWorkerConfig,
228
+ DuplicateDistributedTaskError,
229
+ InMemoryDistributedTaskBroker,
230
+ )
231
+ from ai_character_engine.extensions import (
232
+ ENTRY_POINT_GROUP,
233
+ EXTENSION_API_VERSION,
234
+ DiscoveredPlugin,
235
+ ExtensionError,
236
+ ExtensionFactoryContext,
237
+ ExtensionNotFoundError,
238
+ ExtensionPlugin,
239
+ ExtensionPoint,
240
+ ExtensionRegistrar,
241
+ ExtensionRegistry,
242
+ ExtensionValidationError,
243
+ PluginActivationPolicy,
244
+ PluginActivationRecord,
245
+ PluginCapability,
246
+ PluginCompatibilityError,
247
+ PluginManager,
248
+ PluginManifest,
249
+ PluginPolicyError,
250
+ PluginRegistrationError,
251
+ RegisteredExtension,
252
+ ToolExtension,
253
+ discover_plugins,
254
+ load_plugin,
255
+ )
256
+ from ai_character_engine.compatibility import (
257
+ PUBLIC_API_CONTRACT_VERSION,
258
+ ApiStability,
259
+ ApiSymbolKind,
260
+ CompatibilityIssue,
261
+ CompatibilityReport,
262
+ CompatibilitySeverity,
263
+ ContractCompatibilityResult,
264
+ ContractSurface,
265
+ ContractVersionRequirement,
266
+ MigrationRule,
267
+ ParameterContract,
268
+ PublicApiManifest,
269
+ PublicApiSymbol,
270
+ build_public_api_manifest,
271
+ check_contract_requirements,
272
+ compare_public_api_manifests,
273
+ current_contract_versions,
274
+ load_public_api_manifest,
275
+ save_public_api_manifest,
276
+ )
277
+ from ai_character_engine.stability import (
278
+ AsyncioTaskProbe,
279
+ CallableProbe,
280
+ CompositeProbe,
281
+ FailureInjector,
282
+ FailureRule,
283
+ InjectedFailure,
284
+ MetricInvariant,
285
+ PythonRuntimeProbe,
286
+ SoakConfig,
287
+ SoakFailure,
288
+ SoakHarness,
289
+ SoakOperation,
290
+ SoakReport,
291
+ SoakSample,
292
+ SoakStatus,
293
+ SoakViolation,
294
+ StabilityProbe,
295
+ injected_failure,
296
+ )
297
+ from ai_character_engine.persistence import (
298
+ CURRENT_PERSISTENCE_SCHEMA_VERSIONS,
299
+ DEFAULT_PERSISTENCE_MIGRATIONS,
300
+ LEGACY_UNVERSIONED_SCHEMA_VERSION,
301
+ PERSISTENCE_FIXTURE_SCHEMA_VERSION,
302
+ PERSISTENCE_SCHEMA_CONTRACT_VERSION,
303
+ SCHEMA_VERSION_FIELD,
304
+ PersistenceFileFormat,
305
+ PersistenceFixtureError,
306
+ PersistenceMigrationError,
307
+ PersistenceMigrationPathError,
308
+ PersistenceMigrationRegistry,
309
+ PersistenceMigrationResult,
310
+ PersistenceMigrationStep,
311
+ PersistenceReplayFixture,
312
+ PersistenceReplayResult,
313
+ PersistenceSurface,
314
+ UnsupportedPersistenceSchemaError,
315
+ build_default_persistence_migration_registry,
316
+ canonical_persistence_json,
317
+ current_persistence_schema_version,
318
+ infer_persistence_surface,
319
+ load_persistence_replay_fixture,
320
+ migrate_persistence_file,
321
+ migrate_persistence_payload,
322
+ persistence_payload_fingerprint,
323
+ save_persistence_replay_fixture,
324
+ stamp_current_schema,
325
+ verify_persistence_fixture_directory,
326
+ verify_persistence_replay_fixture,
327
+ )
328
+ from ai_character_engine.performance import (
329
+ PERFORMANCE_REPORT_SCHEMA_VERSION,
330
+ BenchmarkConfig,
331
+ BenchmarkEnvironment,
332
+ BenchmarkMetrics,
333
+ BenchmarkResult,
334
+ BenchmarkRunner,
335
+ BenchmarkSample,
336
+ PerformanceBudget,
337
+ PerformanceEvaluation,
338
+ PerformanceStatus,
339
+ PerformanceViolation,
340
+ capture_benchmark_environment,
341
+ evaluate_performance_budget,
342
+ load_benchmark_result,
343
+ save_benchmark_result,
344
+ )
345
+ from ai_character_engine.release import (
346
+ RELEASE_MANIFEST_SCHEMA_VERSION,
347
+ SUPPORTED_PLATFORMS,
348
+ SUPPORTED_PYTHON_VERSIONS,
349
+ DistributionArtifact,
350
+ DistributionArtifactKind,
351
+ ReleaseCheck,
352
+ ReleaseCheckStatus,
353
+ ReleaseManifest,
354
+ ReleaseMatrix,
355
+ ReleaseReadinessReport,
356
+ ReleaseTarget,
357
+ artifact_hygiene_issues,
358
+ build_release_manifest,
359
+ check_release_readiness,
360
+ current_release_target,
361
+ default_release_matrix,
362
+ inspect_distribution_artifact,
363
+ load_release_manifest,
364
+ save_release_manifest,
365
+ sha256_file,
366
+ validate_distribution_artifact,
367
+ )
368
+ from ai_character_engine.training import (
369
+ CharacterSFTDataset,
370
+ HuggingFaceSFTBackend,
371
+ LoRAConfigSpec,
372
+ QuantizationConfigSpec,
373
+ SFTExample,
374
+ SFTTrainingConfig,
375
+ )
376
+ from ai_character_engine.voice import (
377
+ RuntimeCharacterTextStream, VoiceConversationLoop, VoicePipeline, VoicePipelineConfig,
378
+ )
379
+ from ai_character_engine.vision import ImageInput, VisionAnalysis, VisionFrame, VisionPipeline, VisionPipelineConfig
380
+
381
+ from ai_character_engine.avatar import (
382
+ AudioEnvelopeConfig,
383
+ AudioEnvelopePoint,
384
+ AvatarBehaviorConfig,
385
+ AvatarBehaviorCueBundle,
386
+ AvatarBehaviorPhase,
387
+ AvatarBehaviorRuntime,
388
+ AvatarCueBundle,
389
+ AvatarRuntime,
390
+ BlinkCue,
391
+ EmotionExpressionPolicy,
392
+ ExpressionCue,
393
+ ExpressionRequest,
394
+ ExpressionScheduler,
395
+ GazeCue,
396
+ GazeRequest,
397
+ GazeTarget,
398
+ GestureCue,
399
+ GestureRequest,
400
+ HeadMotionCue,
401
+ IdleMotionCue,
402
+ MetadataVisemeAdapter,
403
+ Pcm16EnvelopeAnalyzer,
404
+ TextVowelVisemeAdapter,
405
+ Viseme,
406
+ VisemeCue,
407
+ )
408
+ from ai_character_engine.host import CharacterHostBridge, HostBridgeConfig, HostBridgeError, image_from_host
409
+
410
+ from ai_character_engine._version import VERSION as __version__
411
+
412
+ __all__ = [
413
+ "RELEASE_MANIFEST_SCHEMA_VERSION",
414
+ "SUPPORTED_PLATFORMS",
415
+ "SUPPORTED_PYTHON_VERSIONS",
416
+ "DistributionArtifact",
417
+ "DistributionArtifactKind",
418
+ "ReleaseCheck",
419
+ "ReleaseCheckStatus",
420
+ "ReleaseManifest",
421
+ "ReleaseMatrix",
422
+ "ReleaseReadinessReport",
423
+ "ReleaseTarget",
424
+ "artifact_hygiene_issues",
425
+ "build_release_manifest",
426
+ "check_release_readiness",
427
+ "current_release_target",
428
+ "default_release_matrix",
429
+ "inspect_distribution_artifact",
430
+ "load_release_manifest",
431
+ "save_release_manifest",
432
+ "sha256_file",
433
+ "validate_distribution_artifact",
434
+
435
+ "CURRENT_PERSISTENCE_SCHEMA_VERSIONS",
436
+ "DEFAULT_PERSISTENCE_MIGRATIONS",
437
+ "LEGACY_UNVERSIONED_SCHEMA_VERSION",
438
+ "PERSISTENCE_FIXTURE_SCHEMA_VERSION",
439
+ "PERSISTENCE_SCHEMA_CONTRACT_VERSION",
440
+ "SCHEMA_VERSION_FIELD",
441
+ "PersistenceFileFormat",
442
+ "PersistenceFixtureError",
443
+ "PersistenceMigrationError",
444
+ "PersistenceMigrationPathError",
445
+ "PersistenceMigrationRegistry",
446
+ "PersistenceMigrationResult",
447
+ "PersistenceMigrationStep",
448
+ "PersistenceReplayFixture",
449
+ "PersistenceReplayResult",
450
+ "PersistenceSurface",
451
+ "UnsupportedPersistenceSchemaError",
452
+ "build_default_persistence_migration_registry",
453
+ "canonical_persistence_json",
454
+ "current_persistence_schema_version",
455
+ "infer_persistence_surface",
456
+ "load_persistence_replay_fixture",
457
+ "migrate_persistence_file",
458
+ "migrate_persistence_payload",
459
+ "persistence_payload_fingerprint",
460
+ "save_persistence_replay_fixture",
461
+ "stamp_current_schema",
462
+ "verify_persistence_fixture_directory",
463
+ "verify_persistence_replay_fixture",
464
+ "PERFORMANCE_REPORT_SCHEMA_VERSION",
465
+ "BenchmarkConfig",
466
+ "BenchmarkEnvironment",
467
+ "BenchmarkMetrics",
468
+ "BenchmarkResult",
469
+ "BenchmarkRunner",
470
+ "BenchmarkSample",
471
+ "PerformanceBudget",
472
+ "PerformanceEvaluation",
473
+ "PerformanceStatus",
474
+ "PerformanceViolation",
475
+ "capture_benchmark_environment",
476
+ "evaluate_performance_budget",
477
+ "load_benchmark_result",
478
+ "save_benchmark_result",
479
+ "AsyncioTaskProbe",
480
+ "CallableProbe",
481
+ "CompositeProbe",
482
+ "FailureInjector",
483
+ "FailureRule",
484
+ "InjectedFailure",
485
+ "MetricInvariant",
486
+ "PythonRuntimeProbe",
487
+ "SoakConfig",
488
+ "SoakFailure",
489
+ "SoakHarness",
490
+ "SoakOperation",
491
+ "SoakReport",
492
+ "SoakSample",
493
+ "SoakStatus",
494
+ "SoakViolation",
495
+ "StabilityProbe",
496
+ "injected_failure",
497
+ "PUBLIC_API_CONTRACT_VERSION",
498
+ "ApiStability",
499
+ "ApiSymbolKind",
500
+ "CompatibilityIssue",
501
+ "CompatibilityReport",
502
+ "CompatibilitySeverity",
503
+ "ContractCompatibilityResult",
504
+ "ContractSurface",
505
+ "ContractVersionRequirement",
506
+ "MigrationRule",
507
+ "ParameterContract",
508
+ "PublicApiManifest",
509
+ "PublicApiSymbol",
510
+ "build_public_api_manifest",
511
+ "check_contract_requirements",
512
+ "compare_public_api_manifests",
513
+ "current_contract_versions",
514
+ "load_public_api_manifest",
515
+ "save_public_api_manifest",
516
+ "DISTRIBUTED_PROTOCOL_VERSION",
517
+ "CompletionDisposition",
518
+ "CompletionReceipt",
519
+ "DistributedBrokerConfig",
520
+ "DistributedCompletion",
521
+ "DistributedLease",
522
+ "DistributedLifecycleEvent",
523
+ "DistributedQueueFullError",
524
+ "DistributedRuntimeError",
525
+ "DistributedTaskBroker",
526
+ "DistributedTaskCoordinator",
527
+ "DistributedTaskEnvelope",
528
+ "DistributedTaskHandler",
529
+ "DistributedTaskNotFoundError",
530
+ "DistributedTaskSnapshot",
531
+ "DistributedTaskStatus",
532
+ "DistributedWorker",
533
+ "DistributedWorkerConfig",
534
+ "DuplicateDistributedTaskError",
535
+ "InMemoryDistributedTaskBroker",
536
+ "ENTRY_POINT_GROUP",
537
+ "EXTENSION_API_VERSION",
538
+ "DiscoveredPlugin",
539
+ "ExtensionError",
540
+ "ExtensionFactoryContext",
541
+ "ExtensionNotFoundError",
542
+ "ExtensionPlugin",
543
+ "ExtensionPoint",
544
+ "ExtensionRegistrar",
545
+ "ExtensionRegistry",
546
+ "ExtensionValidationError",
547
+ "PluginActivationPolicy",
548
+ "PluginActivationRecord",
549
+ "PluginCapability",
550
+ "PluginCompatibilityError",
551
+ "PluginManager",
552
+ "PluginManifest",
553
+ "PluginPolicyError",
554
+ "PluginRegistrationError",
555
+ "RegisteredExtension",
556
+ "ToolExtension",
557
+ "discover_plugins",
558
+ "load_plugin",
559
+ "ExplicitWorldPerceptionPolicy",
560
+ "InMemoryWorldObservationStore",
561
+ "InMemoryWorldStore",
562
+ "JsonlWorldObservationStore",
563
+ "JsonlWorldStore",
564
+ "WorldChangeKind",
565
+ "WorldError",
566
+ "WorldEvent",
567
+ "WorldFactChange",
568
+ "WorldObservation",
569
+ "WorldObservationStore",
570
+ "WorldPatch",
571
+ "WorldPerceptionDeniedError",
572
+ "WorldPerceptionPolicy",
573
+ "WorldPerceptionProjection",
574
+ "WorldPerceptionProjectionError",
575
+ "WorldPerceptionScope",
576
+ "WorldRevisionConflictError",
577
+ "WorldRuntime",
578
+ "WorldStateSnapshot",
579
+ "WorldStore",
580
+ "CharacterExchange",
581
+ "CharacterExchangeStore",
582
+ "CharacterInteractionResult",
583
+ "CharacterIsolationError",
584
+ "CharacterSchedulerOverloadedError",
585
+ "ExchangeStatus",
586
+ "FairCharacterScheduler",
587
+ "FairSchedulerConfig",
588
+ "FairSchedulerSnapshot",
589
+ "InMemoryCharacterExchangeStore",
590
+ "InMemorySharedCognitionStore",
591
+ "JsonlCharacterExchangeStore",
592
+ "JsonlSharedCognitionStore",
593
+ "KnowledgeVisibility",
594
+ "MultiCharacterRuntime",
595
+ "SharedCognitionAccessError",
596
+ "SharedCognitionRecord",
597
+ "SharedCognitionStore",
598
+ "UnknownCharacterError",
599
+ "CircuitBreakerPolicy",
600
+ "CircuitState",
601
+ "DegradedMode",
602
+ "EvaluationGateDecision",
603
+ "EvaluationGatePolicy",
604
+ "FailureClass",
605
+ "Idempotency",
606
+ "OperationLifecycleEvent",
607
+ "OperationResult",
608
+ "OperationStatus",
609
+ "ProductionHardeningConfig",
610
+ "ProductionHardeningRuntime",
611
+ "ProductionHealthSnapshot",
612
+ "ResourceLimits",
613
+ "RetryPolicy",
614
+ "default_failure_classifier",
615
+ "evaluation_gate",
616
+ "CallableCognitiveJudgeAdapter",
617
+ "CognitiveAggregateMetrics",
618
+ "CognitiveEvalCase",
619
+ "CognitiveEvalDataset",
620
+ "CognitiveEvalDimension",
621
+ "CognitiveEvalPolicy",
622
+ "CognitiveEvalReport",
623
+ "CognitiveEvalResult",
624
+ "CognitiveEvalSource",
625
+ "CognitiveEvalTrace",
626
+ "CognitiveEvaluator",
627
+ "CognitiveJudgeAdapter",
628
+ "CognitiveJudgeVerdict",
629
+ "CognitiveTimelineFrame",
630
+ "aggregate_cognitive_metrics",
631
+ "evaluate_cognitive_dataset",
632
+ "CollaborationResult",
633
+ "CollaborationSource",
634
+ "CognitiveWorkItem",
635
+ "CognitiveWorkPlan",
636
+ "SpecialistCollaborationConfig",
637
+ "SpecialistCollaborationRuntime",
638
+ "SpecialistFinding",
639
+ "SpecialistKind",
640
+ "SpecialistRunStatus",
641
+ "SpecialistSpec",
642
+ "VerificationDecision",
643
+ "VerificationIssue",
644
+ "VerificationReport",
645
+ "default_specialists",
646
+ "GoalCommitResult",
647
+ "GoalEvidenceRef",
648
+ "GoalHorizon",
649
+ "GoalManager",
650
+ "GoalRecord",
651
+ "GoalStatus",
652
+ "GoalStore",
653
+ "InMemoryGoalStore",
654
+ "JsonlGoalStore",
655
+ "MotivationKind",
656
+ "MotivationSignal",
657
+ "SAFE_BELIEF_EVIDENCE_TYPES",
658
+ "BeliefClaim",
659
+ "BeliefConsolidationPolicy",
660
+ "BeliefConsolidationResult",
661
+ "BeliefRecord",
662
+ "BeliefStatus",
663
+ "CognitionEvidenceRef",
664
+ "DeterministicBeliefConsolidator",
665
+ "InMemoryLongTermCognitionStore",
666
+ "JsonlLongTermCognitionStore",
667
+ "LongTermCognitionManager",
668
+ "LongTermCognitionStore",
669
+ "ReflectionCommitResult",
670
+ "ReflectionRecord",
671
+ "ReflectionStatus",
672
+ "CognitiveCommitCoordinator",
673
+ "CommitLifecycleEvent",
674
+ "CommitNextAction",
675
+ "CommitResult",
676
+ "CommitStatus",
677
+ "CommitTargetPolicy",
678
+ "StalePolicy",
679
+ "StructuredBackgroundWorker",
680
+ "BackgroundWorkerSpec",
681
+ "BackgroundCognitionRuntime",
682
+ "BackgroundCognitionResult",
683
+ "BackgroundCognitionKind",
684
+ "BackgroundCognitionEvent",
685
+ "BackgroundCognitionConfig",
686
+ "CognitiveModelRouter",
687
+ "CognitiveModelRuntime",
688
+ "CognitiveOptimization",
689
+ "CognitiveRole",
690
+ "CognitiveRoleClient",
691
+ "CognitiveRolePolicy",
692
+ "CognitiveRouteDecision",
693
+ "CognitiveRouteRequirements",
694
+ "CognitiveTaskHandler",
695
+ "MultiTaskRuntime",
696
+ "MultiTaskRuntimeConfig",
697
+ "TaskContext",
698
+ "TaskHandle",
699
+ "TaskLifecycleEvent",
700
+ "TaskOutput",
701
+ "TaskPriority",
702
+ "TaskProposal",
703
+ "TaskRequest",
704
+ "TaskResult",
705
+ "TaskStatus",
706
+ "AudioEnvelopeConfig",
707
+ "AudioEnvelopePoint",
708
+ "AvatarBehaviorConfig",
709
+ "AvatarBehaviorCueBundle",
710
+ "AvatarBehaviorPhase",
711
+ "AvatarBehaviorRuntime",
712
+ "AvatarCueBundle",
713
+ "AvatarRuntime",
714
+ "BlinkCue",
715
+ "EmotionExpressionPolicy",
716
+ "ExpressionCue",
717
+ "ExpressionRequest",
718
+ "ExpressionScheduler",
719
+ "GazeCue",
720
+ "GazeRequest",
721
+ "GazeTarget",
722
+ "GestureCue",
723
+ "GestureRequest",
724
+ "HeadMotionCue",
725
+ "IdleMotionCue",
726
+ "MetadataVisemeAdapter",
727
+ "Pcm16EnvelopeAnalyzer",
728
+ "TextVowelVisemeAdapter",
729
+ "Viseme",
730
+ "VisemeCue",
731
+ "CharacterHostBridge",
732
+ "HostBridgeConfig",
733
+ "HostBridgeError",
734
+ "image_from_host",
735
+ "CharacterEvent",
736
+ "AutonomyController",
737
+ "AutonomyPolicy",
738
+ "AutonomyScheduler",
739
+ "ProactiveCandidate",
740
+ "QuietHours",
741
+ "ContextBudget",
742
+ "ContextTrace",
743
+ "CharacterEventLoop",
744
+ "CharacterProfile",
745
+ "CharacterRunResult",
746
+ "CharacterRuntime",
747
+ "CharacterState",
748
+ "MemoryManager",
749
+ "SessionRecord",
750
+ "SessionManager",
751
+ "ManagedCharacterSession",
752
+ "CharacterRuntimeFactory",
753
+ "DuplexVoiceConfig",
754
+ "DuplexVoiceError",
755
+ "LiveVoicePhase",
756
+ "LiveCharacterOrchestrator",
757
+ "LiveEventType",
758
+ "LiveInputKind",
759
+ "LiveRuntimeBackpressureError",
760
+ "LiveRuntimeConfig",
761
+ "LiveRuntimeError",
762
+ "LiveRuntimeEvent",
763
+ "LiveTurnInput",
764
+ "MouthActivityCue",
765
+ "GatewayCircuitBreaker",
766
+ "ModelEndpoint",
767
+ "ModelGatewayClient",
768
+ "RoutingRule",
769
+ "RuleBasedModelRouter",
770
+ "StaticModelRouter",
771
+ "MemoryRecord",
772
+ "StatePatch",
773
+ "RuntimeCharacterTextStream",
774
+ "VoicePipelineConfig",
775
+ "VoicePipeline",
776
+ "VoiceConversationLoop",
777
+ "ImageInput",
778
+ "VisionAnalysis",
779
+ "VisionFrame",
780
+ "VisionPipeline",
781
+ "VisionPipelineConfig",
782
+ "CharacterSFTDataset",
783
+ "HuggingFaceSFTBackend",
784
+ "LoRAConfigSpec",
785
+ "QuantizationConfigSpec",
786
+ "SFTExample",
787
+ "SFTTrainingConfig",
788
+ ]