truceptor 0.0.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Raja Datascientist
+
+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,35 @@
+# Truceptor (npm)
+
+**Truceptor** — governance at the tool boundary. This npm package reserves the name for the future TypeScript/JavaScript SDK.
+
+| Channel | Status |
+|---------|--------|
+| **npm `truceptor`** | Placeholder `0.0.1` — blocks the name until the real SDK ships |
+| **PyPI `truceptor`** | Active Python SDK — `pip install truceptor` |
+
+## Install (placeholder only)
+
+```bash
+npm install truceptor
+```
+
+This version exists to reserve the package name on npm. It does **not** provide a working governance client yet.
+
+## Roadmap
+
+TypeScript SDK is on the backlog after replay, forensics, drift, and MCP. Track progress in `product_status/status.yaml`.
+
+## Links
+
+- Repository: https://github.com/raja-datascientist/ACP
+- Python SDK: https://pypi.org/project/truceptor/
+
+## Publish (maintainers)
+
+From `sdk/npm`:
+
+```bash
+npm publish --access public
+```
+
+Requires npm login or `NPM_TOKEN` in the environment.

package/index.d.ts

@@ -0,0 +1,7 @@
+/** Placeholder types — full SDK forthcoming. */
+export declare const RESERVED_MESSAGE: string;
+export declare const version: string;
+
+export declare class ACPClient {
+  constructor(options?: { interceptorUrl?: string; bearerToken?: string });
+}

package/index.js

@@ -0,0 +1,26 @@
+/**
+ * Placeholder for the truceptor npm package (name reservation).
+ * Full TypeScript SDK: https://github.com/raja-datascientist/ACP (sdk/npm, roadmap NEXT #3)
+ *
+ * Python SDK today: pip install truceptor
+ */
+
+const RESERVED_MESSAGE =
+  "truceptor npm package (0.0.1): TypeScript SDK not released yet — use pip install truceptor for Python.";
+
+function notImplemented(method) {
+  throw new Error(`${RESERVED_MESSAGE} (${method} is not available.)`);
+}
+
+/** @type {import('./index.d.ts').ACPClient} */
+class ACPClient {
+  constructor() {
+    notImplemented("ACPClient");
+  }
+}
+
+module.exports = {
+  RESERVED_MESSAGE,
+  ACPClient,
+  version: "0.0.1",
+};

package/package.json

@@ -0,0 +1,33 @@
+{
+  "name": "truceptor",
+  "version": "0.0.1",
+  "description": "Truceptor — trusted intercept for agent tool calls (npm). TypeScript SDK TBD. Python: pip install truceptor.",
+  "main": "index.js",
+  "types": "index.d.ts",
+  "license": "MIT",
+  "author": "SV",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/raja-datascientist/ACP.git",
+    "directory": "sdk/npm"
+  },
+  "homepage": "https://github.com/raja-datascientist/ACP",
+  "bugs": {
+    "url": "https://github.com/raja-datascientist/ACP/issues"
+  },
+  "keywords": [
+    "acp",
+    "ai",
+    "agents",
+    "governance",
+    "control-plane",
+    "opa",
+    "mcp"
+  ],
+  "engines": {
+    "node": ">=18"
+  },
+  "publishConfig": {
+    "access": "public"
+  }
+}