@shield-agent/kya 0.1.0

package/dist/sample-tools.js

@@ -0,0 +1,37 @@
+/**
+ * Sample custom tools for light install — zero vertical packs (R8).
+ * Same descriptors as docs/dev/kya-custom-tools-sample.md.
+ */
+export const SAMPLE_TOOLS = [
+    {
+        toolId: "org.sample.safe.read",
+        displayName: "Safe read",
+        actionClass: "READ",
+        policyTier: "ALLOW",
+        irreversible: false,
+        dataClass: "INTERNAL",
+        metadata: { version: "1.0.0", owner: "sample" },
+    },
+    {
+        toolId: "org.sample.data.write",
+        displayName: "Data write",
+        actionClass: "WRITE",
+        policyTier: "REQUIRE_APPROVE",
+        irreversible: true,
+        dataClass: "CONFIDENTIAL",
+        metadata: { version: "1.0.0", owner: "sample" },
+    },
+    {
+        toolId: "org.sample.never.event",
+        displayName: "Never event",
+        actionClass: "EXTERNAL_SIDE_EFFECT",
+        policyTier: "DENY",
+        irreversible: true,
+        dataClass: "RESTRICTED",
+        metadata: { version: "1.0.0", owner: "sample" },
+    },
+];
+export function findSampleTool(toolId) {
+    return SAMPLE_TOOLS.find((t) => t.toolId === toolId);
+}
+//# sourceMappingURL=sample-tools.js.map

package/dist/sample-tools.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sample-tools.js","sourceRoot":"","sources":["../src/sample-tools.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAgBH,MAAM,CAAC,MAAM,YAAY,GAAoC;IAC3D;QACE,MAAM,EAAE,sBAAsB;QAC9B,WAAW,EAAE,WAAW;QACxB,WAAW,EAAE,MAAM;QACnB,UAAU,EAAE,OAAO;QACnB,YAAY,EAAE,KAAK;QACnB,SAAS,EAAE,UAAU;QACrB,QAAQ,EAAE,EAAE,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE;KAChD;IACD;QACE,MAAM,EAAE,uBAAuB;QAC/B,WAAW,EAAE,YAAY;QACzB,WAAW,EAAE,OAAO;QACpB,UAAU,EAAE,iBAAiB;QAC7B,YAAY,EAAE,IAAI;QAClB,SAAS,EAAE,cAAc;QACzB,QAAQ,EAAE,EAAE,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE;KAChD;IACD;QACE,MAAM,EAAE,wBAAwB;QAChC,WAAW,EAAE,aAAa;QAC1B,WAAW,EAAE,sBAAsB;QACnC,UAAU,EAAE,MAAM;QAClB,YAAY,EAAE,IAAI;QAClB,SAAS,EAAE,YAAY;QACvB,QAAQ,EAAE,EAAE,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE;KAChD;CACO,CAAC;AAEX,MAAM,UAAU,cAAc,CAAC,MAAc;IAC3C,OAAO,YAAY,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,MAAM,CAAC,CAAC;AACvD,CAAC"}

package/package.json

@@ -0,0 +1,65 @@
+{
+  "name": "@shield-agent/kya",
+  "version": "0.1.0",
+  "description": "Know Your Agent light CLI + local MCP gate (provider-agnostic, zero vertical packs required).",
+  "license": "MIT",
+  "type": "module",
+  "mcpName": "io.github.the-pixel-boys/shield-kya",
+  "bin": {
+    "kya": "./dist/cli.js",
+    "shield-kya": "./dist/cli.js"
+  },
+  "main": "./dist/index.js",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "server.json",
+    "LICENSE"
+  ],
+  "homepage": "https://shield-agent.com/install",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/The-Pixel-Boys/shield-kya.git",
+    "directory": "packages/kya"
+  },
+  "bugs": {
+    "url": "https://github.com/The-Pixel-Boys/shield-kya/issues"
+  },
+  "engines": {
+    "node": ">=20"
+  },
+  "devDependencies": {
+    "@types/node": "^22.10.5",
+    "@vitest/coverage-v8": "^2.1.8",
+    "typescript": "^5.7.2",
+    "vitest": "^2.1.8"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "keywords": [
+    "kya",
+    "know-your-agent",
+    "mcp",
+    "policy",
+    "shield-agent",
+    "cli",
+    "mcp-server"
+  ],
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "clean": "rm -rf dist coverage",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "test:coverage": "vitest run --coverage",
+    "pack:check": "pnpm run build && pnpm pack --pack-destination /tmp && node dist/cli.js --help"
+  }
+}

package/server.json

@@ -0,0 +1,59 @@
+{
+  "$schema": "https://static.modelcontextprotocol.io/schemas/2025-10-17/server.schema.json",
+  "name": "io.github.the-pixel-boys/shield-kya",
+  "description": "Know Your Agent (KYA) local MCP gate: policy evaluate, session ingest, approval request. Provider-agnostic; sole PEP is Shield.",
+  "status": "active",
+  "repository": {
+    "url": "https://github.com/The-Pixel-Boys/shield-agent",
+    "source": "github"
+  },
+  "version": "0.1.0",
+  "packages": [
+    {
+      "registryType": "npm",
+      "identifier": "@shield-agent/kya",
+      "version": "0.1.0",
+      "transport": {
+        "type": "stdio"
+      },
+      "packageArguments": [
+        {
+          "type": "positional",
+          "value": "serve-mcp"
+        },
+        {
+          "type": "positional",
+          "value": "--stdio"
+        }
+      ],
+      "environmentVariables": [
+        {
+          "name": "KYA_BASE_URL",
+          "description": "Control plane origin (e.g. http://127.0.0.1:8090 or hosted URL)",
+          "isRequired": true,
+          "format": "string"
+        },
+        {
+          "name": "KYA_API_KEY",
+          "description": "API key for the control plane (required when auth is on)",
+          "isRequired": true,
+          "isSecret": true,
+          "format": "string"
+        },
+        {
+          "name": "KYA_HOST",
+          "description": "Dual-plane host tag: ide (authoring) or runtime (production)",
+          "isRequired": false,
+          "format": "string",
+          "default": "ide"
+        },
+        {
+          "name": "KYA_AGENT_ID",
+          "description": "Registered agent principal id",
+          "isRequired": false,
+          "format": "string"
+        }
+      ]
+    }
+  ]
+}