@agent-surface/core 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Wiseair S.r.l.
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,48 @@
+# @agent-surface/core
+
+Framework-agnostic core of [agent-surface](https://github.com/Wiseair-srl/agent-surface): a registry for declaring an explicit, semantic, typed, policy-governed *agent surface* over a frontend — and nothing more. If a component or capability is not explicitly annotated, it does not exist for the agent.
+
+Zero runtime dependencies. Provides: canonical capability ids, the `AgentSchema` layer (Standard Schema + built-in JSON Schema subset validator), component/capability definitions, the registry (registration lifecycle, availability, versioning, staleness), synchronous snapshots, the 10-phase invocation pipeline, composable policies, single-use confirmation evidence, audit sinks, and a provider-neutral toolset projection for embedded agent loops.
+
+Docs: https://agent-surface-docs.vercel.app
+
+## Install
+
+```bash
+pnpm add @agent-surface/core
+```
+
+## Use
+
+```ts
+import {
+  createAgentSurfaceRegistry,
+  defineAgentComponent,
+  observation,
+  action,
+  fromStandardSchema,
+  createAgentToolset,
+} from "@agent-surface/core";
+
+const registry = createAgentSurfaceRegistry({
+  environment: import.meta.env.DEV ? "development" : "production",
+  context: () => ({ user: authStore.user }),
+});
+
+registry.register(
+  defineAgentComponent({
+    type: "devices.table",
+    description: "Table of the devices visible on the current page",
+    observations: { readState: observation({ /* … */ }) },
+    actions: { selectRows: action({ /* … */ }) },
+  }),
+);
+
+const toolset = createAgentToolset(registry, {
+  consumer: { id: "copilot", kind: "embedded" },
+});
+```
+
+React apps should use [`@agent-surface/react`](https://www.npmjs.com/package/@agent-surface/react) instead of calling `register` directly. Full specification: [docs](https://github.com/Wiseair-srl/agent-surface/tree/main/docs).
+
+MIT © Wiseair S.r.l.