@yansirplus/core

Purpose

@yansirplus/core owns neutral agentOS substrate algebra: owner identity helpers, value brands, material refs, boundary contracts, AgentSchema, tool contracts, shared errors, and provider-neutral runtime, backend, LLM, and telemetry protocol vocabulary.

It contains no runtime service loop, backend interpreter, provider SDK, framework adapter, target ambient implementation, or disputed event-projection fold.

Public API Status

0.6.x active development. Public exports are listed for package ownership; they are not frozen.

Audience

| Entrypoint | Audience | Capability | | ------------------------------------------- | ---------------------------- | ------------------------------------------------------------------------------------------------- | | @yansirplus/core | advanced | neutral substrate algebra and brands | | @yansirplus/core/abort | advanced | abort vocabulary | | @yansirplus/core/agent-schema | advanced | agent schema authoring algebra | | @yansirplus/core/authored-value | advanced | authored value ownership | | @yansirplus/core/backend-protocol | advanced | backend protocol DTOs, conformance manifests, ledger archive proof algebra, and report validation | | @yansirplus/core/backend-protocol/reference | advanced | backend protocol reference helpers | | @yansirplus/core/boundary-contract | advanced | boundary contract declarations | | @yansirplus/core/carrier | advanced | carrier algebra | | @yansirplus/core/context | advanced | context value helpers | | @yansirplus/core/effect-claim | advanced | effect claim vocabulary | | @yansirplus/core/errors | advanced | shared error classes | | @yansirplus/core/extensions | advanced | extension declarations | | @yansirplus/core/live-edge | advanced | live edge protocol | | @yansirplus/core/llm-protocol | advanced | LLM protocol DTOs | | @yansirplus/core/material-ref | advanced | material refs | | @yansirplus/core/projection | advanced | projection algebra | | @yansirplus/core/quota | advanced | quota declarations | | @yansirplus/core/recorded-value | advanced | recorded value algebra | | @yansirplus/core/ref-resolver | advanced, generated-only | material ref resolution | | @yansirplus/core/runtime-protocol | generated-only | runtime DTOs emitted by generated targets | | @yansirplus/core/runtime-scope | advanced | runtime scope helpers | | @yansirplus/core/settlement-contract | advanced | settlement contract algebra | | @yansirplus/core/telemetry-protocol | advanced | telemetry protocol DTOs | | @yansirplus/core/tools | generated-only | tool definitions emitted by generated targets | | @yansirplus/core/types | advanced | shared type helpers | | @yansirplus/core/workspace-agent | advanced | workspace agent command/projection vocabulary |

Invariant

Core is a neutral axioms package. Package names are build metadata only; durable owner identity remains the frozen owner id string declared by the owning protocol or carrier.

Backend conformance facts are core algebra. The backend-protocol subpath owns the protocol version, ordered law manifest, capability matrix, report schema, and positive validator. It does not import a test runner or execute backend drivers.

Ledger archive segments and receipts are also core protocol facts. Canonical encoding, SHA-256 verification, exact truth identity, strict event ordering, and segment-chain validation are provider-neutral; archive storage and eviction remain runtime/backend responsibilities.

Minimal Usage

import { ABORT } from "@yansirplus/core";
import { defineAgentBindings } from "@yansirplus/core/runtime-protocol";

Verification

pnpm --filter @yansirplus/core test