AIKernel.Contracts
0.0.5
dotnet add package AIKernel.Contracts --version 0.0.5
NuGet\Install-Package AIKernel.Contracts -Version 0.0.5
<PackageReference Include="AIKernel.Contracts" Version="0.0.5" />
<PackageVersion Include="AIKernel.Contracts" Version="0.0.5" />
<PackageReference Include="AIKernel.Contracts" />
paket add AIKernel.Contracts --version 0.0.5
#r "nuget: AIKernel.Contracts, 0.0.5"
#:package AIKernel.Contracts@0.0.5
#addin nuget:?package=AIKernel.Contracts&version=0.0.5
#tool nuget:?package=AIKernel.Contracts&version=0.0.5
AIKernel.NET
AIKernel.NET is a specification-first repository for Semantic Context OS contracts.
The src tree contains the canonical specification projects that define interfaces, DTOs, enums, and external boundary contracts.
Current Package Baseline
As of v0.0.5:
AIKernel.AbstractionsandAIKernel.Contractsexport interfaces only.- DTOs are owned by
AIKernel.Dtos. - Shared enum primitives are owned by
AIKernel.Enums. AIKernel.Vfsremains a public namespace insideAIKernel.Abstractions; there is no separateAIKernel.Vfspackage/project.- Legacy ambiguous ChatChain names such as
IResultandISemanticHasherare not exported from the ChatChain namespace. UseIChatTurnVerificationResultandIChatTurnSemanticHasher.
Keep all AIKernel.NET packages on the same version line. Do not mix AIKernel.Abstractions v0.0.5 with older AIKernel.Dtos or AIKernel.Enums packages.
Projects
AIKernel.Abstractions
- Purpose: Interface layer (no concrete business logic).
- Main namespaces:
AIKernel.Abstractions.CapabilitiesAIKernel.Abstractions.ContextAIKernel.Abstractions.ConversationAIKernel.Abstractions.DynamicSlmAIKernel.Abstractions.DslAIKernel.Abstractions.EventsAIKernel.Abstractions.ExecutionAIKernel.Abstractions.GovernanceAIKernel.Abstractions.HistoryAIKernel.Abstractions.HostingAIKernel.Abstractions.KernelAIKernel.Abstractions.MaterialAIKernel.Abstractions.ModelsAIKernel.Abstractions.PromptAIKernel.Abstractions.ProvidersAIKernel.Abstractions.RomAIKernel.Abstractions.RoutingAIKernel.Abstractions.SchedulingAIKernel.Abstractions.SecurityAIKernel.Abstractions.TasksAIKernel.Abstractions.TimeAIKernel.Abstractions.ToolingAIKernel.Vfs(Vfs contracts, owned by the Abstractions assembly)
- Project references:
AIKernel.Dtos,AIKernel.Enums
AIKernel.Contracts
- Purpose: Cross-boundary contract interfaces for orchestration/context projections. This package exports interfaces only.
- Main namespace:
AIKernel.Contracts - Project references:
AIKernel.Dtos,AIKernel.Enums
AIKernel.Dtos
- Purpose: POCO/record data carriers and wire metadata key constants only (no business logic).
- Main namespaces:
AIKernel.Dtos.CapabilitiesAIKernel.Dtos.ContextAIKernel.Dtos.CoreAIKernel.Dtos.DynamicSlmAIKernel.Dtos.DslAIKernel.Dtos.EventsAIKernel.Dtos.ExecutionAIKernel.Dtos.GovernanceAIKernel.Dtos.KernelAIKernel.Dtos.KernelContextAIKernel.Dtos.HistoryAIKernel.Dtos.MaterialAIKernel.Dtos.PromptAIKernel.Dtos.RomAIKernel.Dtos.RoutingAIKernel.Dtos.RulesAIKernel.Dtos.SandboxAIKernel.Dtos.SecurityAIKernel.Dtos.SemanticCompilationAIKernel.Dtos.TokenizationAIKernel.Dtos.TimeAIKernel.Dtos.Vfs
- Project references:
AIKernel.Enums
DTO packages may expose stable metadata key constants for wire formats such as DSL ROM and History ROM.
Those constants are part of the serialized contract surface; parsing, validation, and runtime behavior still belong to Core/Common or host implementations.
Shared enums such as execution status and prompt option primitives belong to AIKernel.Enums, not AIKernel.Dtos.
Capability DTOs describe external module manifests and invocation envelopes for CLI executable, managed assembly, native ABI, DSL ROM, and remote endpoint boundaries. Runtime loading, sandboxing, assembly resolution, and native invocation remain Core/Tools/provider responsibilities.
DynamicSLM DTOs describe Model ABI records only. Registry, lineage verification, payload materialization, scheduling, differential distillation planning, SeedSLM discipline enforcement, delegation, thought-artifact dumping, and memory placement belong to Core/Provider implementations behind AIKernel.Abstractions.DynamicSlm.
Distillation execution itself is represented as a background offload job so loaders do not block on training work.
HATL DTOs describe ledger entries, public anchors, Digital Deeds, verification results, and external cryptographic operator request/result records. Cryptographic runtime belongs to AIKernel.RH-backed operators or other audited Core/HATL modules.
Governance DTOs may carry admission replay evidence, critical-operation and computational-complexity gate evidence, and trajectory governance ellipsoid/score/action evaluation records, while AIKernel.Enums owns Semantic IR slot, admission decision/gate, task cost class, and critical-operation requirement vocabulary for Core-side ResultStep/ReplayLog adapters.
Semantic Compilation DTOs describe observable semantic state, structural Semantic IR, governed circuit descriptors, finite prototype spaces, semantic distance reports, deterministic synthesis descriptors, and replay-addressable transition descriptors; compiler execution and graph search remain Core/runtime responsibilities.
AIKernel.Enums
- Purpose: Shared enum primitives used across the specification layer.
- Main namespace:
AIKernel.Enums - Project references: none
Dependency Rules (Normative)
AIKernel.Abstractions→AIKernel.Dtos,AIKernel.EnumsAIKernel.Contracts→AIKernel.Dtos,AIKernel.EnumsAIKernel.Dtos→AIKernel.EnumsAIKernel.Enums→ (none)
Prohibited examples:
Abstractions→ContractsContracts→AbstractionsAbstractions→ separate Vfs package/project
AIKernel.Vfs is a public namespace inside AIKernel.Abstractions; the separate AIKernel.Vfs compatibility project was removed in v0.0.4.
Notes on Decomposition
AIKernel.KernelContextproject has been decomposed and moved intoAIKernel.Dtos.KernelContext(models) andAIKernel.Abstractions(contracts).AIKernel.Eventsproject has been decomposed and moved intoAIKernel.Dtos.Events(models) andAIKernel.Abstractions.Events(contracts).- Concrete runtime implementations are out of this repository scope and belong to
AIKernel.Core.
Testing
src/tests/AIKernel.Abstractions.Tests: spec-alignment and interface-composition tests.
License
MIT License
Copyright © 2026 Takuya Sogawa
| Product | Versions Compatible and additional computed target framework versions. |
|---|---|
| .NET | net10.0 is compatible. net10.0-android was computed. net10.0-browser was computed. net10.0-ios was computed. net10.0-maccatalyst was computed. net10.0-macos was computed. net10.0-tvos was computed. net10.0-windows was computed. |
-
net10.0
- AIKernel.Dtos (>= 0.0.5)
- AIKernel.Enums (>= 0.0.5)
NuGet packages (1)
Showing the top 1 NuGet packages that depend on AIKernel.Contracts:
| Package | Downloads |
|---|---|
|
AIKernel.Events
AIKernel is an operating-system-style framework for AI applications, designed around strict category separation, context isolation, and contract-driven orchestration. This package is part of the AIKernel Core and provides foundational components required by Kernel, Providers, and VFS layers. Provides audit and system event definitions for the AIKernel OS. Events represent observable state transitions and are designed for logging, monitoring, and governance without depending on syscall abstractions. AIKernel は AI アプリケーション向けの OS 的フレームワークであり、カテゴリ分離、コンテキスト隔離、契約駆動の設計思想に基づいています。本パッケージは AIKernel Core の一部であり、Kernel、Provider、VFS 層が利用する基盤コンポーネントを提供します。 AIKernel OS の監査およびシステムイベント定義を提供します。イベントは観測可能な状態遷移を表し、syscall 抽象に依存せずログ、監視、ガバナンス用途に設計されています。 |
GitHub repositories
This package is not used by any popular GitHub repositories.
AIKernel.NET v0.0.5 — Contract Surface Purity Cleanup, DynamicSLM, and HATL
• Completed the interface-only guarantee for AIKernel.Abstractions and AIKernel.Contracts.
• Removed leftover DTO and exception implementations from AIKernel.Abstractions.
• Unified Context Assembly, prompt generation, and Kernel request DTO usage on AIKernel.Dtos.
• Removed duplicate execution and prompt option enums from AIKernel.Dtos.
• Kept execution status and prompt option enums owned by AIKernel.Enums.
• Removed legacy ambiguous ChatChain interfaces IResult and ISemanticHasher.
• Kept chat-turn hashing on IChatTurnSemanticHasher and ROM hashing on AIKernel.Abstractions.Rom.ISemanticHasher.
• Preserved the package DAG: Enums -> none, Dtos -> Enums, Contracts -> Dtos/Enums, Abstractions -> Dtos/Enums.
• Added contract-only DynamicSLM Model ABI and distillation offload interfaces, DTOs, and enum primitives.
• Added SeedSLM discipline, delegation, thought artifact, and resident memory placement contract vocabulary.
• Added contract-only HATL ledger, anchor, Digital Deed, verification, and external cryptographic operator interfaces, DTOs, and enum primitives.
• Added external Capability module contracts for CLI executable, managed assembly, native ABI, DSL ROM, and remote endpoint boundaries.
• Added governance admissibility gate and trajectory evidence vocabulary for Core-side ReplayLog projection.
• Added Semantic Compilation DTO vocabulary for states, Semantic IR, governed circuits, prototype spaces, semantic distances, deterministic synthesis, and transitions.
• Kept Result/ResultStep/LINQ composition and HATL cryptographic runtime ownership in AIKernel.Common, Core, host, or external operator packages.
• Breaking change: consumers must use DTO and enum types from AIKernel.Dtos and AIKernel.Enums rather than leftover Abstractions-local duplicates.
AIKernel.NET v0.0.5 — Contract Surface Purity Cleanup、DynamicSLM、HATL
• AIKernel.Abstractions / AIKernel.Contracts の interface-only 保証を完了。
• AIKernel.Abstractions に残っていた DTO / 例外実装を削除。
• Context Assembly、prompt generation、Kernel request DTO の利用元を AIKernel.Dtos に統一。
• AIKernel.Dtos に残っていた execution / prompt option enum 重複を削除。
• execution status / prompt option enum の所有元を AIKernel.Enums に一本化。
• 旧 ChatChain interface の IResult / ISemanticHasher を削除。
• chat-turn hash は IChatTurnSemanticHasher、ROM hash は AIKernel.Abstractions.Rom.ISemanticHasher に整理。
• package DAG は Enums -> none、Dtos -> Enums、Contracts -> Dtos/Enums、Abstractions -> Dtos/Enums を維持。
• contract-only の DynamicSLM Model ABI / distillation offload interface、DTO、enum primitive を追加。
• SeedSLM discipline、delegation、thought artifact、resident memory placement contract vocabulary を追加。
• contract-only の HATL ledger、anchor、Digital Deed、verification、external cryptographic operator interface、DTO、enum primitive を追加。
• CLI executable、managed assembly、native ABI、DSL ROM、remote endpoint 境界向け external Capability module contract を追加。
• Core 側 ReplayLog 投影向け governance admissibility gate / trajectory evidence vocabulary を追加。
• state、Semantic IR、governed circuit、prototype space、semantic distance、deterministic synthesis、transition 向け Semantic Compilation DTO vocabulary を追加。
• Result / ResultStep / LINQ composition と HATL cryptographic runtime の所有は AIKernel.Common、Core、host、外部 operator package に残す。
• 破壊的変更: consumer は Abstractions に残っていた重複型ではなく、AIKernel.Dtos / AIKernel.Enums の DTO / enum を使用してください。