ds4-context-reference-adapter 0.2.0-beta.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 DS4 Context Engine contributors
+
+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,70 @@
+# ds4-context-reference-adapter
+
+Non-Pi reference implementation of the DS4 `runtime-adapter-v1` contract.
+
+The package adapts an append-only JSONL conversation owned by a small callback-driven agent runtime. It is intentionally vendor-neutral: completion transport is injected by the host, while runtime SDK dependencies stay outside `ds4-context-core`.
+
+## Guarantees
+
+- JSONL is canonical; in-memory snapshots are disposable and rebuildable.
+- Canonical messages retain stable provenance and complete tool call/result atomic groups.
+- The trusted project root is canonicalized and must match the session header.
+- Model limits use the portable DS4 model descriptor.
+- Provider payloads pass privacy enforcement immediately before the injected transport.
+- Privacy failures fail closed; transport failures return an explicit native-fallback result.
+- Unsupported compaction, provider continuation, embeddings, and local KV reuse are negotiated independently with explicit diagnostics.
+- Shutdown is idempotent and rejects further history access.
+
+## Example
+
+```ts
+import {
+  JsonlReferenceRuntimeAdapter,
+  createReferenceHistory,
+} from "ds4-context-reference-adapter";
+
+createReferenceHistory({
+  historyFile: ".agent/session.jsonl",
+  runtimeId: "my-runtime",
+  sessionId: "session-1",
+  projectRoot: process.cwd(),
+  messages: [],
+});
+
+const adapter = new JsonlReferenceRuntimeAdapter({
+  historyFile: ".agent/session.jsonl",
+  projectRoot: process.cwd(),
+  runtimeId: "my-runtime",
+  model: {
+    provider: "my-provider",
+    id: "my-model",
+    contextWindow: 32_768,
+    maxTokens: 4_096,
+  },
+  transport: async ({ payload }) => invokeMyRuntime(payload),
+});
+
+const snapshot = await adapter.snapshotHistory();
+const negotiation = adapter.negotiateCapabilities([
+  { id: "compaction" },
+  { id: "embeddings" },
+]);
+```
+
+`createReferenceHistory` refuses to overwrite an existing canonical session. `appendReferenceHistoryMessage` appends one provenance-checked message. Applications should serialize canonical writes according to their own runtime lifecycle.
+
+## Conformance
+
+Adapter authors can reuse the framework-neutral kit exported by core:
+
+```ts
+import {
+  assertRuntimeAdapterConformance,
+  runRuntimeAdapterConformance,
+} from "ds4-context-core/adapter/conformance";
+
+const report = await runRuntimeAdapterConformance(myAdapterFactory);
+assertRuntimeAdapterConformance(report);
+```
+
+See the repository's `docs/RUNTIME_ADAPTER_KIT.md` for the complete contract, compatibility decision, packaging rules, and failure semantics.

package/dist/index.d.ts

@@ -0,0 +1,56 @@
+import { type RuntimeAdapter, type RuntimeAdapterDiagnostic, type RuntimeAdapterIdentity, type RuntimeCapabilityDeclaration, type RuntimeCapabilityNegotiation, type RuntimeCapabilityRequest, type RuntimeCompletionRequest, type RuntimeCompletionResult, type RuntimeCompletionTransport, type RuntimeHistorySnapshot, type RuntimePrivacyRequest, type RuntimePrivacyResult } from "ds4-context-core/adapter/runtime-adapter";
+import type { PrivacyConfig } from "ds4-context-core/config/config";
+import type { CanonicalMessage } from "ds4-context-core/core/canonical-message";
+import type { ModelDescriptor } from "ds4-context-core/core/model-profile";
+import type { EmbeddingPort } from "ds4-context-core/retrieval/embedding";
+export declare const REFERENCE_ADAPTER_VERSION = "0.2.0-beta.1";
+export declare const REFERENCE_HISTORY_RECORD_TYPE = "ds4-runtime-session-v1";
+export declare const REFERENCE_ADAPTER_DEFAULT_PRIVACY: PrivacyConfig;
+export interface CreateReferenceHistoryInput {
+    historyFile: string;
+    runtimeId?: string;
+    sessionId: string;
+    projectRoot: string;
+    messages?: readonly CanonicalMessage[];
+}
+export interface ReferenceRuntimeAdapterOptions {
+    historyFile: string;
+    projectRoot: string;
+    model: ModelDescriptor;
+    transport: RuntimeCompletionTransport;
+    runtimeId?: string;
+    privacy?: PrivacyConfig;
+    embeddingPort?: EmbeddingPort;
+    maxHistoryBytes?: number;
+    maxHistoryMessages?: number;
+}
+export declare function createReferenceHistory(input: CreateReferenceHistoryInput): string;
+export declare function appendReferenceHistoryMessage(historyFile: string, message: CanonicalMessage): void;
+export declare class JsonlReferenceRuntimeAdapter implements RuntimeAdapter {
+    readonly identity: RuntimeAdapterIdentity;
+    readonly embeddingPort?: EmbeddingPort;
+    private readonly historyFile;
+    private readonly projectRoot;
+    private readonly model;
+    private readonly transport;
+    private readonly privacy;
+    private readonly maxHistoryBytes;
+    private readonly maxHistoryMessages;
+    private readonly diagnosticEntries;
+    private cached?;
+    private closed;
+    constructor(options: ReferenceRuntimeAdapterOptions);
+    capabilityDeclarations(): readonly RuntimeCapabilityDeclaration[];
+    negotiateCapabilities(requested: readonly RuntimeCapabilityRequest[]): RuntimeCapabilityNegotiation;
+    snapshotHistory(): Promise<RuntimeHistorySnapshot>;
+    rebuildDerivedState(): Promise<RuntimeHistorySnapshot>;
+    currentModel(): Promise<ModelDescriptor>;
+    trustedProjectRoot(): Promise<string>;
+    enforcePrivacy<T>(request: RuntimePrivacyRequest<T>): Promise<RuntimePrivacyResult<T>>;
+    complete<T>(request: RuntimeCompletionRequest<T>): Promise<RuntimeCompletionResult>;
+    diagnostics(): readonly RuntimeAdapterDiagnostic[];
+    shutdown(): Promise<void>;
+    private assertOpen;
+    private pushDiagnostic;
+}
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/dist/index.js

@@ -0,0 +1,406 @@
+import { appendFileSync, chmodSync, mkdirSync, readFileSync, realpathSync, statSync, writeFileSync, } from "node:fs";
+import { dirname, resolve } from "node:path";
+import { RUNTIME_ADAPTER_CONTRACT_VERSION, RUNTIME_HISTORY_SCHEMA_VERSION, buildCanonicalToolAtomicGroups, negotiateRuntimeCapabilities, validateRuntimeHistorySnapshot, } from "ds4-context-core/adapter/runtime-adapter";
+import { PrivacyPolicyEngine } from "ds4-context-core/privacy/privacy-policy";
+import { sha256 } from "ds4-context-core/shared/hash";
+export const REFERENCE_ADAPTER_VERSION = "0.2.0-beta.1";
+export const REFERENCE_HISTORY_RECORD_TYPE = "ds4-runtime-session-v1";
+const DEFAULT_MAX_HISTORY_BYTES = 64 * 1024 * 1024;
+const DEFAULT_MAX_HISTORY_MESSAGES = 100_000;
+const MAX_DIAGNOSTICS = 100;
+export const REFERENCE_ADAPTER_DEFAULT_PRIVACY = {
+    enabled: true,
+    defaultClassification: "normal",
+    localProviders: ["ollama", "llama-cpp", "lmstudio"],
+    remoteDefaultAllowed: ["normal", "internal"],
+    remoteProviders: {},
+    redactSecrets: true,
+};
+function canonicalPath(path) {
+    return realpathSync.native(resolve(path));
+}
+function positiveInteger(value, fallback, label) {
+    const selected = value ?? fallback;
+    if (!Number.isSafeInteger(selected) || selected <= 0) {
+        throw new Error(`${label} must be a positive integer`);
+    }
+    return selected;
+}
+function recordLine(value) {
+    return `${JSON.stringify(value)}\n`;
+}
+function isRecord(value) {
+    return value !== null && typeof value === "object" && !Array.isArray(value);
+}
+function validCanonicalMessage(value) {
+    if (!isRecord(value)
+        || typeof value.id !== "string"
+        || typeof value.sourceEntryId !== "string"
+        || typeof value.role !== "string"
+        || !["system", "user", "assistant", "tool", "custom"].includes(value.role)
+        || !Array.isArray(value.blocks)
+        || !isRecord(value.provenance)
+        || !isRecord(value.flags))
+        return false;
+    const provenance = value.provenance;
+    if ((provenance.source !== "pi-session" && provenance.source !== "runtime-session")
+        || typeof provenance.sessionId !== "string"
+        || typeof provenance.entryId !== "string"
+        || (provenance.runtimeId !== undefined && typeof provenance.runtimeId !== "string"))
+        return false;
+    return value.blocks.every((block) => {
+        if (!isRecord(block) || typeof block.type !== "string")
+            return false;
+        switch (block.type) {
+            case "text": return typeof block.text === "string";
+            case "thinking": return typeof block.thinking === "string";
+            case "toolCall": return typeof block.id === "string" && typeof block.name === "string";
+            case "toolResult":
+                return typeof block.toolCallId === "string"
+                    && typeof block.toolName === "string"
+                    && typeof block.content === "string"
+                    && typeof block.isError === "boolean";
+            case "image":
+                return (block.mimeType === undefined || typeof block.mimeType === "string")
+                    && (block.data === undefined || typeof block.data === "string");
+            case "fileReference": return typeof block.path === "string";
+            case "artifactReference": return typeof block.artifactId === "string";
+            case "summaryReference": return typeof block.summaryId === "string";
+            case "opaqueProvider": return "value" in block;
+            default: return false;
+        }
+    });
+}
+function referenceSnapshot(input) {
+    return {
+        schemaVersion: RUNTIME_HISTORY_SCHEMA_VERSION,
+        runtimeId: input.runtimeId,
+        sessionId: input.sessionId,
+        revision: input.revision,
+        projectRoot: input.projectRoot,
+        messages: input.messages,
+        toolAtomicGroups: buildCanonicalToolAtomicGroups(input.messages),
+    };
+}
+function assertValidMessages(runtimeId, sessionId, projectRoot, messages) {
+    if (!messages.every(validCanonicalMessage)) {
+        throw new Error("Reference history contains an invalid canonical message");
+    }
+    const snapshot = referenceSnapshot({
+        runtimeId,
+        sessionId,
+        projectRoot,
+        revision: "pending-write",
+        messages: structuredClone([...messages]),
+    });
+    const issues = validateRuntimeHistorySnapshot(snapshot);
+    if (issues.length > 0) {
+        throw new Error(`Reference history is invalid: ${[...new Set(issues.map((issue) => issue.code))].join(", ")}`);
+    }
+}
+export function createReferenceHistory(input) {
+    const historyFile = resolve(input.historyFile);
+    const projectRoot = canonicalPath(input.projectRoot);
+    const runtimeId = input.runtimeId?.trim() || "jsonl-reference";
+    const sessionId = input.sessionId.trim();
+    if (!sessionId)
+        throw new Error("Reference session ID must be non-empty");
+    const messages = [...(input.messages ?? [])];
+    assertValidMessages(runtimeId, sessionId, projectRoot, messages);
+    const header = {
+        type: REFERENCE_HISTORY_RECORD_TYPE,
+        runtimeId,
+        sessionId,
+        projectRoot,
+    };
+    const serialized = [
+        recordLine(header),
+        ...messages.map((message) => recordLine({ type: "message", message })),
+    ].join("");
+    mkdirSync(dirname(historyFile), { recursive: true, mode: 0o700 });
+    writeFileSync(historyFile, serialized, { encoding: "utf8", flag: "wx", mode: 0o600 });
+    try {
+        chmodSync(historyFile, 0o600);
+    }
+    catch {
+        // Permission hardening is best effort on platforms without POSIX modes.
+    }
+    return historyFile;
+}
+export function appendReferenceHistoryMessage(historyFile, message) {
+    const path = resolve(historyFile);
+    const parsed = parseReferenceHistory(path, DEFAULT_MAX_HISTORY_BYTES, DEFAULT_MAX_HISTORY_MESSAGES);
+    const projectRoot = canonicalPath(parsed.header.projectRoot);
+    if (message.provenance.sessionId !== parsed.header.sessionId
+        || message.provenance.runtimeId !== parsed.header.runtimeId) {
+        throw new Error("Reference message provenance does not match the canonical session");
+    }
+    assertValidMessages(parsed.header.runtimeId, parsed.header.sessionId, projectRoot, [...parsed.messages, message]);
+    appendFileSync(path, recordLine({ type: "message", message }), { encoding: "utf8", mode: 0o600 });
+}
+function parseReferenceHistory(path, maxHistoryBytes, maxHistoryMessages) {
+    const stats = statSync(path);
+    if (!stats.isFile() || stats.size <= 0 || stats.size > maxHistoryBytes) {
+        throw new Error("Reference history file size is invalid");
+    }
+    const raw = readFileSync(path, "utf8");
+    if (!raw.endsWith("\n"))
+        throw new Error("Reference history has an unterminated final record");
+    const lines = raw.slice(0, -1).split("\n");
+    const firstLine = lines.shift();
+    if (!firstLine)
+        throw new Error("Reference history header is missing");
+    let header;
+    try {
+        header = JSON.parse(firstLine);
+    }
+    catch {
+        throw new Error("Reference history header is malformed");
+    }
+    if (header.type !== REFERENCE_HISTORY_RECORD_TYPE
+        || typeof header.runtimeId !== "string" || !header.runtimeId.trim()
+        || typeof header.sessionId !== "string" || !header.sessionId.trim()
+        || typeof header.projectRoot !== "string" || !header.projectRoot.trim()) {
+        throw new Error("Reference history header is invalid");
+    }
+    if (lines.length > maxHistoryMessages)
+        throw new Error("Reference history message limit exceeded");
+    const messages = lines.map((line) => {
+        let record;
+        try {
+            record = JSON.parse(line);
+        }
+        catch {
+            throw new Error("Reference history message record is malformed");
+        }
+        if (record.type !== "message" || !validCanonicalMessage(record.message)) {
+            throw new Error("Reference history message record is invalid");
+        }
+        return record.message;
+    });
+    return { header, raw, messages };
+}
+export class JsonlReferenceRuntimeAdapter {
+    identity;
+    embeddingPort;
+    historyFile;
+    projectRoot;
+    model;
+    transport;
+    privacy;
+    maxHistoryBytes;
+    maxHistoryMessages;
+    diagnosticEntries = [];
+    cached;
+    closed = false;
+    constructor(options) {
+        this.historyFile = resolve(options.historyFile);
+        this.projectRoot = canonicalPath(options.projectRoot);
+        this.model = structuredClone(options.model);
+        if (!this.model.provider.trim() || !this.model.id.trim()
+            || !Number.isFinite(this.model.contextWindow) || this.model.contextWindow <= 0) {
+            throw new Error("Reference adapter model descriptor is invalid");
+        }
+        this.transport = options.transport;
+        this.privacy = new PrivacyPolicyEngine(options.privacy ?? REFERENCE_ADAPTER_DEFAULT_PRIVACY);
+        this.maxHistoryBytes = positiveInteger(options.maxHistoryBytes, DEFAULT_MAX_HISTORY_BYTES, "maxHistoryBytes");
+        this.maxHistoryMessages = positiveInteger(options.maxHistoryMessages, DEFAULT_MAX_HISTORY_MESSAGES, "maxHistoryMessages");
+        if (options.embeddingPort)
+            this.embeddingPort = options.embeddingPort;
+        this.identity = {
+            runtimeId: options.runtimeId?.trim() || "jsonl-reference",
+            adapterName: "ds4-context-reference-adapter",
+            adapterVersion: REFERENCE_ADAPTER_VERSION,
+            contractVersion: RUNTIME_ADAPTER_CONTRACT_VERSION,
+        };
+    }
+    capabilityDeclarations() {
+        return [
+            { id: "compaction", supported: false, reason: "reference JSONL runtime has no native compaction hook" },
+            {
+                id: "provider-continuation",
+                supported: false,
+                reason: "reference completion transport exposes no provider continuation handle",
+            },
+            ...(this.embeddingPort
+                ? [{ id: "embeddings", supported: true, version: "embedding-port-v1" }]
+                : [{ id: "embeddings", supported: false, reason: "no embedding port was configured" }]),
+            { id: "local-kv-reuse", supported: false, reason: "reference completion transport exposes no local KV state" },
+        ];
+    }
+    negotiateCapabilities(requested) {
+        return negotiateRuntimeCapabilities(this.capabilityDeclarations(), requested);
+    }
+    async snapshotHistory() {
+        this.assertOpen();
+        let parsed;
+        let projectRoot;
+        try {
+            parsed = parseReferenceHistory(this.historyFile, this.maxHistoryBytes, this.maxHistoryMessages);
+            projectRoot = canonicalPath(parsed.header.projectRoot);
+        }
+        catch {
+            this.pushDiagnostic({
+                code: "canonical-history-read-failed",
+                severity: "error",
+                message: "Canonical JSONL history is missing, corrupt, truncated, or outside configured bounds",
+            });
+            throw new Error("Reference canonical history is unavailable");
+        }
+        if (parsed.header.runtimeId !== this.identity.runtimeId || projectRoot !== this.projectRoot) {
+            this.pushDiagnostic({
+                code: "canonical-history-identity-mismatch",
+                severity: "error",
+                message: "Canonical history identity does not match the trusted adapter configuration",
+            });
+            throw new Error("Reference canonical history identity mismatch");
+        }
+        const revision = sha256(parsed.raw);
+        if (this.cached?.revision === revision)
+            return structuredClone(this.cached);
+        const snapshot = referenceSnapshot({
+            runtimeId: parsed.header.runtimeId,
+            sessionId: parsed.header.sessionId,
+            projectRoot,
+            revision,
+            messages: parsed.messages,
+        });
+        const issues = validateRuntimeHistorySnapshot(snapshot);
+        if (issues.length > 0) {
+            this.pushDiagnostic({
+                code: "canonical-history-invalid",
+                severity: "error",
+                message: `Canonical history validation failed with ${issues.length} issue(s)`,
+            });
+            throw new Error("Reference canonical history validation failed");
+        }
+        this.cached = structuredClone(snapshot);
+        return structuredClone(snapshot);
+    }
+    async rebuildDerivedState() {
+        this.assertOpen();
+        this.cached = undefined;
+        const snapshot = await this.snapshotHistory();
+        this.pushDiagnostic({
+            code: "derived-state-rebuilt",
+            severity: "info",
+            message: "Disposable adapter state was rebuilt from canonical JSONL history",
+        });
+        return snapshot;
+    }
+    async currentModel() {
+        this.assertOpen();
+        return structuredClone(this.model);
+    }
+    async trustedProjectRoot() {
+        this.assertOpen();
+        return this.projectRoot;
+    }
+    async enforcePrivacy(request) {
+        this.assertOpen();
+        if (!request.provider.trim())
+            throw new Error("Privacy provider must be non-empty");
+        try {
+            const policy = this.privacy.policy(request.provider);
+            const sanitized = this.privacy.sanitizeProviderPayload(request.payload, request.provider);
+            return {
+                provider: request.provider,
+                destination: policy.destination,
+                payload: sanitized.value,
+                changed: sanitized.changed,
+                blockedBlocks: sanitized.blockedBlocks,
+                secretRedactions: sanitized.secretRedactions,
+            };
+        }
+        catch {
+            this.pushDiagnostic({
+                code: "privacy-enforcement-failed",
+                severity: "error",
+                message: "Privacy enforcement failed closed before completion transport",
+            });
+            throw new Error("Reference privacy enforcement failed closed");
+        }
+    }
+    async complete(request) {
+        if (this.closed) {
+            return {
+                status: "fallback",
+                code: "adapter-closed",
+                reason: "reference adapter is closed",
+                retryable: false,
+            };
+        }
+        if (!request.provider.trim() || !request.model.trim()) {
+            this.pushDiagnostic({
+                code: "completion-request-invalid",
+                severity: "warning",
+                message: "Completion request is missing provider or model identity",
+            });
+            return {
+                status: "fallback",
+                code: "invalid-request",
+                reason: "completion request is invalid",
+                retryable: false,
+            };
+        }
+        let sanitized;
+        try {
+            sanitized = await this.enforcePrivacy({ provider: request.provider, payload: request.payload });
+        }
+        catch {
+            return {
+                status: "fallback",
+                code: "privacy-enforcement-failed",
+                reason: "privacy enforcement failed closed",
+                retryable: false,
+            };
+        }
+        try {
+            const output = await this.transport({
+                provider: request.provider,
+                model: request.model,
+                destination: sanitized.destination,
+                payload: sanitized.payload,
+            });
+            const { payload: _payload, ...privacy } = sanitized;
+            return { status: "completed", output, privacy };
+        }
+        catch {
+            this.pushDiagnostic({
+                code: "completion-transport-failed",
+                severity: "warning",
+                message: "Completion transport failed; native runtime fallback remains available",
+            });
+            return {
+                status: "fallback",
+                code: "transport-failed",
+                reason: "completion transport failed",
+                retryable: true,
+            };
+        }
+    }
+    diagnostics() {
+        return this.diagnosticEntries.map((diagnostic) => ({ ...diagnostic }));
+    }
+    async shutdown() {
+        if (this.closed)
+            return;
+        this.closed = true;
+        this.cached = undefined;
+        this.pushDiagnostic({
+            code: "adapter-closed",
+            severity: "info",
+            message: "Reference adapter lifecycle closed cleanly",
+        });
+    }
+    assertOpen() {
+        if (this.closed)
+            throw new Error("Reference adapter is closed");
+    }
+    pushDiagnostic(diagnostic) {
+        this.diagnosticEntries.push(diagnostic);
+        if (this.diagnosticEntries.length > MAX_DIAGNOSTICS)
+            this.diagnosticEntries.shift();
+    }
+}
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -0,0 +1,55 @@
+{
+  "name": "ds4-context-reference-adapter",
+  "version": "0.2.0-beta.1",
+  "description": "Non-Pi JSONL reference runtime adapter and DS4 adapter-contract example.",
+  "type": "module",
+  "license": "MIT",
+  "author": "Alucard24",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/Alucard24/ds4-context-engine.git",
+    "directory": "packages/reference-adapter"
+  },
+  "homepage": "https://github.com/Alucard24/ds4-context-engine#runtime-adapter-kit",
+  "bugs": {
+    "url": "https://github.com/Alucard24/ds4-context-engine/issues"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "keywords": [
+    "context-engine",
+    "agent-runtime",
+    "runtime-adapter",
+    "jsonl",
+    "reference-implementation"
+  ],
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.build.json",
+    "typecheck": "tsc -p tsconfig.build.json --noEmit",
+    "prepack": "npm run build"
+  },
+  "engines": {
+    "node": ">=22.19.0"
+  },
+  "dependencies": {
+    "ds4-context-core": "0.2.0-beta.1"
+  },
+  "devDependencies": {
+    "@types/node": "22.19.19",
+    "typescript": "5.9.3"
+  }
+}