@kya-os/contracts 1.3.3 → 1.3.4

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kya-os/contracts",
-  "version": "1.3.3",
+  "version": "1.3.4",
   "description": "Shared types and schemas for XMCP-I ecosystem",
   "type": "commonjs",
   "sideEffects": false,
@@ -102,7 +102,8 @@
     "!dist/**/*.spec.*",
     "!dist/**/*.test.*",
     "!README.md",
-    "!*.md"
+    "!*.md",
+    "!CHANGELOG.md"
   ],
   "scripts": {
     "build": "tsc -p tsconfig.build.json && npm run emit-schemas",

package/README.md

@@ -1,130 +0,0 @@
-# @kya-os/contracts
-
-Shared types and schemas for the XMCP-I ecosystem. This package provides a single source of truth for all contracts used across runtime, CLI, verifier, and registry components.
-
-## Features
-
-- **Type-safe contracts** using Zod schemas
-- **Subpath exports** for modular imports
-- **JSON schemas** with versioning for external validation
-- **Zero runtime dependencies** (except Zod)
-- **ESM-only** with tree-shaking support
-
-## Installation
-
-```bash
-npm install @kya-os/contracts
-```
-
-## Usage
-
-### Subpath Imports
-
-```typescript
-// Import specific namespaces
-import { HandshakeRequest, SessionContext } from "@kya-os/contracts/handshake";
-import { DetachedProof, ProofMeta } from "@kya-os/contracts/proof";
-import { AgentContext, AGENT_HEADERS } from "@kya-os/contracts/verifier";
-import {
-  RegistrationResult,
-  MCP_I_CAPABILITIES,
-} from "@kya-os/contracts/registry";
-import { StatusReport, ERROR_CODES } from "@kya-os/contracts/cli";
-
-// Or import everything
-import * as Contracts from "@kya-os/contracts";
-```
-
-### Schema Validation
-
-```typescript
-import { DetachedProofSchema } from "@kya-os/contracts/proof";
-
-// Validate data at runtime
-const result = DetachedProofSchema.safeParse(data);
-if (result.success) {
-  // data is now typed as DetachedProof
-  console.log(result.data.meta.did);
-}
-```
-
-### JSON Schemas
-
-JSON schemas are available under the `/schemas/**` subpath:
-
-```typescript
-// Access versioned JSON schemas
-import proofSchema from "@kya-os/contracts/schemas/proof/v1.0.0.json";
-import agentSchema from "@kya-os/contracts/schemas/well-known/agent/v1.0.0.json";
-```
-
-## Namespaces
-
-### Handshake (`/handshake`)
-
-- `HandshakeRequest` - Nonce, audience, timestamp validation
-- `SessionContext` - Session management and TTL
-- `NonceCacheEntry` - Nonce cache storage
-
-### Proof (`/proof`)
-
-- `DetachedProof` - JWS signature with metadata
-- `ProofMeta` - Proof metadata fields
-- `AuditRecord` - Audit logging format
-
-### Verifier (`/verifier`)
-
-- `AgentContext` - Verified agent information
-- `VerifierResult` - Middleware validation results
-- `AGENT_HEADERS` - Frozen header name constants
-
-### Registry (`/registry`)
-
-- `RegistrationResult` - KTA registration response
-- `AgentStatus` - Agent status reporting
-- `MCP_I_CAPABILITIES` - Protocol capability constants
-
-### CLI (`/cli`)
-
-- `StatusReport` - CLI status command output
-- `ScaffolderResult` - Scaffolder operation results
-- `ERROR_CODES` - Error code constants
-
-## Versioning
-
-This package follows semantic versioning:
-
-- **Major**: Breaking changes to existing contracts
-- **Minor**: Additive changes (new fields, optional properties)
-- **Patch**: Bug fixes and documentation updates
-
-JSON schemas are versioned independently under `/schemas/{namespace}/v{major}.{minor}.{patch}.json`.
-
-## Type Safety
-
-All types are derived from Zod schemas to ensure runtime validation matches TypeScript types:
-
-```typescript
-// Schema definition
-export const ProofMetaSchema = z.object({
-  did: z.string().min(1),
-  kid: z.string().min(1),
-  // ...
-});
-
-// Type derived from schema
-export type ProofMeta = z.infer<typeof ProofMetaSchema>;
-```
-
-## Bundle Size
-
-This package is optimized for minimal bundle impact:
-
-- **Tarball size**: < 80 KB
-- **Side effects**: None (`"sideEffects": false`)
-- **Tree-shaking**: Full ESM support
-- **Dependencies**: Only Zod for schema validation
-
-## License
-
-MIT

package/dist/agentshield-api/endpoints.d.ts

@@ -1,21 +0,0 @@
-export declare const AGENTSHIELD_API_BASE: "/api/v1/bouncer";
-export declare const AGENTSHIELD_ENDPOINTS: {
-    readonly PROOFS: "/api/v1/bouncer/proofs";
-    readonly DELEGATIONS_VERIFY: "/api/v1/bouncer/delegations/verify";
-    readonly DELEGATIONS_GET: (id: string) => `/api/v1/bouncer/delegations/${string}`;
-    readonly DELEGATIONS_CREATE: "/api/v1/bouncer/delegations";
-    readonly DELEGATIONS_REVOKE: (id: string) => `/api/v1/bouncer/delegations/${string}/revoke`;
-    readonly CONFIG: (projectId: string) => `/api/v1/bouncer/config/${string}`;
-};
-export declare const AGENTSHIELD_METHODS: {
-    readonly PROOFS: "POST";
-    readonly DELEGATIONS_VERIFY: "POST";
-    readonly DELEGATIONS_GET: "GET";
-    readonly DELEGATIONS_CREATE: "POST";
-    readonly DELEGATIONS_REVOKE: "POST";
-    readonly CONFIG: "GET";
-};
-export interface AgentShieldAPIHeaders {
-    'Content-Type': 'application/json';
-    'Authorization': `Bearer ${string}`;
-}

package/dist/agentshield-api/endpoints.js

@@ -1,20 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.AGENTSHIELD_METHODS = exports.AGENTSHIELD_ENDPOINTS = exports.AGENTSHIELD_API_BASE = void 0;
-exports.AGENTSHIELD_API_BASE = '/api/v1/bouncer';
-exports.AGENTSHIELD_ENDPOINTS = {
-    PROOFS: `${exports.AGENTSHIELD_API_BASE}/proofs`,
-    DELEGATIONS_VERIFY: `${exports.AGENTSHIELD_API_BASE}/delegations/verify`,
-    DELEGATIONS_GET: (id) => `${exports.AGENTSHIELD_API_BASE}/delegations/${id}`,
-    DELEGATIONS_CREATE: `${exports.AGENTSHIELD_API_BASE}/delegations`,
-    DELEGATIONS_REVOKE: (id) => `${exports.AGENTSHIELD_API_BASE}/delegations/${id}/revoke`,
-    CONFIG: (projectId) => `${exports.AGENTSHIELD_API_BASE}/config/${projectId}`,
-};
-exports.AGENTSHIELD_METHODS = {
-    PROOFS: 'POST',
-    DELEGATIONS_VERIFY: 'POST',
-    DELEGATIONS_GET: 'GET',
-    DELEGATIONS_CREATE: 'POST',
-    DELEGATIONS_REVOKE: 'POST',
-    CONFIG: 'GET',
-};

package/dist/agentshield-api/index.d.ts

@@ -1,5 +0,0 @@
-export type { AgentShieldAPIResponse, ProofSubmissionRequest, ProofSubmissionResponse, VerifyDelegationRequest, VerifyDelegationResponse, VerifyDelegationAPIResponse, DelegationCredential, AgentShieldToolProtection, ToolProtectionConfigResponse, ToolProtectionConfigAPIResponse, CreateDelegationRequest, CreateDelegationResponse, CreateDelegationAPIResponse, RevokeDelegationRequest, RevokeDelegationResponse, RevokeDelegationAPIResponse, } from './types.js';
-export { AgentShieldAPIError } from './types.js';
-export type { AgentShieldAPIHeaders } from './endpoints.js';
-export { agentShieldAPIErrorSchema, agentShieldAPIResponseSchema, proofSubmissionRequestSchema, proofSubmissionResponseSchema, delegationCredentialSchema, verifyDelegationRequestSchema, verifyDelegationResponseSchema, verifyDelegationAPIResponseSchema, agentShieldToolProtectionSchema, toolProtectionConfigResponseSchema, toolProtectionConfigAPIResponseSchema, createDelegationRequestSchema, createDelegationResponseSchema, createDelegationAPIResponseSchema, revokeDelegationRequestSchema, revokeDelegationResponseSchema, revokeDelegationAPIResponseSchema, } from './schemas.js';
-export { AGENTSHIELD_API_BASE, AGENTSHIELD_ENDPOINTS, AGENTSHIELD_METHODS, } from './endpoints.js';

package/dist/agentshield-api/index.js

@@ -1,27 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.AGENTSHIELD_METHODS = exports.AGENTSHIELD_ENDPOINTS = exports.AGENTSHIELD_API_BASE = exports.revokeDelegationAPIResponseSchema = exports.revokeDelegationResponseSchema = exports.revokeDelegationRequestSchema = exports.createDelegationAPIResponseSchema = exports.createDelegationResponseSchema = exports.createDelegationRequestSchema = exports.toolProtectionConfigAPIResponseSchema = exports.toolProtectionConfigResponseSchema = exports.agentShieldToolProtectionSchema = exports.verifyDelegationAPIResponseSchema = exports.verifyDelegationResponseSchema = exports.verifyDelegationRequestSchema = exports.delegationCredentialSchema = exports.proofSubmissionResponseSchema = exports.proofSubmissionRequestSchema = exports.agentShieldAPIResponseSchema = exports.agentShieldAPIErrorSchema = exports.AgentShieldAPIError = void 0;
-var types_js_1 = require("./types.js");
-Object.defineProperty(exports, "AgentShieldAPIError", { enumerable: true, get: function () { return types_js_1.AgentShieldAPIError; } });
-var schemas_js_1 = require("./schemas.js");
-Object.defineProperty(exports, "agentShieldAPIErrorSchema", { enumerable: true, get: function () { return schemas_js_1.agentShieldAPIErrorSchema; } });
-Object.defineProperty(exports, "agentShieldAPIResponseSchema", { enumerable: true, get: function () { return schemas_js_1.agentShieldAPIResponseSchema; } });
-Object.defineProperty(exports, "proofSubmissionRequestSchema", { enumerable: true, get: function () { return schemas_js_1.proofSubmissionRequestSchema; } });
-Object.defineProperty(exports, "proofSubmissionResponseSchema", { enumerable: true, get: function () { return schemas_js_1.proofSubmissionResponseSchema; } });
-Object.defineProperty(exports, "delegationCredentialSchema", { enumerable: true, get: function () { return schemas_js_1.delegationCredentialSchema; } });
-Object.defineProperty(exports, "verifyDelegationRequestSchema", { enumerable: true, get: function () { return schemas_js_1.verifyDelegationRequestSchema; } });
-Object.defineProperty(exports, "verifyDelegationResponseSchema", { enumerable: true, get: function () { return schemas_js_1.verifyDelegationResponseSchema; } });
-Object.defineProperty(exports, "verifyDelegationAPIResponseSchema", { enumerable: true, get: function () { return schemas_js_1.verifyDelegationAPIResponseSchema; } });
-Object.defineProperty(exports, "agentShieldToolProtectionSchema", { enumerable: true, get: function () { return schemas_js_1.agentShieldToolProtectionSchema; } });
-Object.defineProperty(exports, "toolProtectionConfigResponseSchema", { enumerable: true, get: function () { return schemas_js_1.toolProtectionConfigResponseSchema; } });
-Object.defineProperty(exports, "toolProtectionConfigAPIResponseSchema", { enumerable: true, get: function () { return schemas_js_1.toolProtectionConfigAPIResponseSchema; } });
-Object.defineProperty(exports, "createDelegationRequestSchema", { enumerable: true, get: function () { return schemas_js_1.createDelegationRequestSchema; } });
-Object.defineProperty(exports, "createDelegationResponseSchema", { enumerable: true, get: function () { return schemas_js_1.createDelegationResponseSchema; } });
-Object.defineProperty(exports, "createDelegationAPIResponseSchema", { enumerable: true, get: function () { return schemas_js_1.createDelegationAPIResponseSchema; } });
-Object.defineProperty(exports, "revokeDelegationRequestSchema", { enumerable: true, get: function () { return schemas_js_1.revokeDelegationRequestSchema; } });
-Object.defineProperty(exports, "revokeDelegationResponseSchema", { enumerable: true, get: function () { return schemas_js_1.revokeDelegationResponseSchema; } });
-Object.defineProperty(exports, "revokeDelegationAPIResponseSchema", { enumerable: true, get: function () { return schemas_js_1.revokeDelegationAPIResponseSchema; } });
-var endpoints_js_1 = require("./endpoints.js");
-Object.defineProperty(exports, "AGENTSHIELD_API_BASE", { enumerable: true, get: function () { return endpoints_js_1.AGENTSHIELD_API_BASE; } });
-Object.defineProperty(exports, "AGENTSHIELD_ENDPOINTS", { enumerable: true, get: function () { return endpoints_js_1.AGENTSHIELD_ENDPOINTS; } });
-Object.defineProperty(exports, "AGENTSHIELD_METHODS", { enumerable: true, get: function () { return endpoints_js_1.AGENTSHIELD_METHODS; } });