@anscribe/core 0.1.0 → 1.0.1

package/README.md

@@ -1,10 +1,29 @@
 # @anscribe/core
 
-> Internal capture model shared by `@anscribe/opentui`, `@anscribe/mcp`, and `@anscribe/react`. **Not part of the public API.**
+> Framework-agnostic Capture model + `CaptureSink` registry. Peer dependency of every Anscribe adapter package.
 
-You almost certainly want [`@anscribe/opentui`](https://www.npmjs.com/package/@anscribe/opentui).
+You almost certainly want [`@anscribe/opentui`](https://www.npmjs.com/package/@anscribe/opentui) (`bun add @anscribe/opentui` pulls this in transitively).
 
-This package exists so the OpenTUI host, the MCP server, and the React enricher can share Schema definitions (`Capture`, `CapturedTarget`, `TerminalCellBounds`, …) and the framework-agnostic Capture Mode state machine without circular dependencies. Its surface is not stabilized; minor releases may break consumers.
+This package holds the Schema definitions (`Capture`, `CapturedTarget`, `TerminalCellBounds`, …), the framework-agnostic Capture Mode state machine, and the process-global `CaptureSink` registry that host adapters (`@anscribe/opentui`, future Ink/blessed adapters) read from and that sink producers (`@anscribe/mcp`) write into. Living here — and being a `peerDependencies` entry on every adapter — is what keeps the registry a single instance across packages.
+
+## Public API for sink authors
+
+Most users never import from `@anscribe/core` directly. The exception is anyone writing or wiring a custom `CaptureSink`:
+
+```ts
+import { type CaptureSink, registerCaptureSink } from "@anscribe/core";
+
+const webhookSink: CaptureSink = {
+  name: "webhook",
+  write: async (capture) => {
+    await fetch("https://example.com/captures", { method: "POST", body: JSON.stringify(capture) });
+  },
+};
+
+registerCaptureSink(webhookSink);
+```
+
+`readRegisteredCaptureSinks()` is provided for host adapters; `resetCaptureSinks()` is a test-only escape hatch.
 
 ## License
 

package/dist/index.d.mts

@@ -402,4 +402,14 @@ interface CaptureSink {
   readonly close?: () => Promise<void>;
 }
 //#endregion
-export { ANSCRIBE_OVERLAY, Capture, CaptureEnrichmentOutput, CaptureHostFailureReporter, CaptureId, CaptureInput, CaptureMetadata, CaptureMetadataEnricher, CaptureMetadataEnrichment, CaptureMode, CaptureModeDispatchError, CaptureModeDispatchResult, CaptureModeIntent, CaptureModeState, CapturePersistence, CapturePersistenceError, CaptureProjectResolutionError, CaptureSink, CaptureStatus, CaptureValidationError, CapturedTarget, CapturedTargetId, IsoTimestamp, type PickerState, ResolvedCaptureProject, SourceReference, TerminalCellBounds, captureStatusSchema, decodeAnscribeData, decodeAnscribeDataEffect, formatCaptureForClipboard, generateCaptureId, generateCapturedTargetId, initialState, isAnscribeOverlay, makeCapture, markAsOverlay, noCaptureEnrichment, parseIsoTimestampMillis, resolveCaptureProjectBoundary, resolveTargetAtCell, selectCurrentTarget, transition };
+//#region src/sink-registry.d.ts
+declare const registerCaptureSink: (sink: CaptureSink) => void;
+declare const readRegisteredCaptureSinks: () => ReadonlyArray<CaptureSink>;
+/**
+ * Test-only escape hatch. Production code should never call this — the
+ * registry is process-global so a stray reset between two consumers in the
+ * same process would silently break the second one.
+ */
+declare const resetCaptureSinks: () => void;
+//#endregion
+export { ANSCRIBE_OVERLAY, Capture, CaptureEnrichmentOutput, CaptureHostFailureReporter, CaptureId, CaptureInput, CaptureMetadata, CaptureMetadataEnricher, CaptureMetadataEnrichment, CaptureMode, CaptureModeDispatchError, CaptureModeDispatchResult, CaptureModeIntent, CaptureModeState, CapturePersistence, CapturePersistenceError, CaptureProjectResolutionError, CaptureSink, CaptureStatus, CaptureValidationError, CapturedTarget, CapturedTargetId, IsoTimestamp, type PickerState, ResolvedCaptureProject, SourceReference, TerminalCellBounds, captureStatusSchema, decodeAnscribeData, decodeAnscribeDataEffect, formatCaptureForClipboard, generateCaptureId, generateCapturedTargetId, initialState, isAnscribeOverlay, makeCapture, markAsOverlay, noCaptureEnrichment, parseIsoTimestampMillis, readRegisteredCaptureSinks, registerCaptureSink, resetCaptureSinks, resolveCaptureProjectBoundary, resolveTargetAtCell, selectCurrentTarget, transition };

package/dist/index.mjs

@@ -408,4 +408,19 @@ function formatSourceLocation(file, line) {
 	return line !== void 0 ? `${file}:${line}` : file;
 }
 //#endregion
-export { ANSCRIBE_OVERLAY, Capture, CaptureHostFailureReporter, CaptureId, CaptureMetadata, CaptureMetadataEnrichment, CaptureMode, CaptureModeIntent, CapturePersistence, CapturePersistenceError, CaptureProjectResolutionError, CaptureValidationError, CapturedTarget, CapturedTargetId, IsoTimestamp, SourceReference, TerminalCellBounds, captureStatusSchema, decodeAnscribeData, decodeAnscribeDataEffect, formatCaptureForClipboard, generateCaptureId, generateCapturedTargetId, initialState, isAnscribeOverlay, makeCapture, markAsOverlay, noCaptureEnrichment, parseIsoTimestampMillis, resolveCaptureProjectBoundary, resolveTargetAtCell, selectCurrentTarget, transition };
+//#region src/sink-registry.ts
+const registeredSinks = /* @__PURE__ */ new Map();
+const registerCaptureSink = (sink) => {
+	registeredSinks.set(sink.name, sink);
+};
+const readRegisteredCaptureSinks = () => Array.from(registeredSinks.values());
+/**
+* Test-only escape hatch. Production code should never call this — the
+* registry is process-global so a stray reset between two consumers in the
+* same process would silently break the second one.
+*/
+const resetCaptureSinks = () => {
+	registeredSinks.clear();
+};
+//#endregion
+export { ANSCRIBE_OVERLAY, Capture, CaptureHostFailureReporter, CaptureId, CaptureMetadata, CaptureMetadataEnrichment, CaptureMode, CaptureModeIntent, CapturePersistence, CapturePersistenceError, CaptureProjectResolutionError, CaptureValidationError, CapturedTarget, CapturedTargetId, IsoTimestamp, SourceReference, TerminalCellBounds, captureStatusSchema, decodeAnscribeData, decodeAnscribeDataEffect, formatCaptureForClipboard, generateCaptureId, generateCapturedTargetId, initialState, isAnscribeOverlay, makeCapture, markAsOverlay, noCaptureEnrichment, parseIsoTimestampMillis, readRegisteredCaptureSinks, registerCaptureSink, resetCaptureSinks, resolveCaptureProjectBoundary, resolveTargetAtCell, selectCurrentTarget, transition };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@anscribe/core",
-  "version": "0.1.0",
+  "version": "1.0.1",
   "description": "Anscribe core: OpenTUI-agnostic capture model, project discovery, and clipboard formatting.",
   "keywords": [
     "agent",