@aporthq/aport-agent-guardrails 1.0.8

package/external/aport-spec/oap/vc/tools/README.md

@@ -0,0 +1,278 @@
+# OAP VC Conversion Tools
+
+Practical tools for converting between Open Agent Passport (OAP) objects and Verifiable Credentials (VCs) for interoperability with VC/DID ecosystems.
+
+## 🚀 Quick Start
+
+### Installation
+
+```bash
+# Clone the OAP specification repository
+git clone https://github.com/aporthq/oap-spec.git
+cd oap-spec/spec/oap/vc/tools
+
+# Install dependencies
+npm install
+
+# Build the TypeScript code
+npm run build
+```
+
+### CLI Usage
+
+```bash
+# Export OAP Passport to VC
+node dist/cli.js export --type passport --input passport.json --output passport.vc.json --key registry-key.json
+
+# Export with verbose output (shows converted data)
+node dist/cli.js export --type passport --input passport.json --output passport.vc.json --key registry-key.json --verbose
+
+# Export OAP Decision to VC
+node dist/cli.js export --type decision --input decision.json --output decision.vc.json --key registry-key.json
+
+# Import VC to OAP Passport
+node dist/cli.js import --type passport --input passport.vc.json --output passport.json
+
+# Import with verbose output (shows converted data)
+node dist/cli.js import --type passport --input passport.vc.json --output passport.json --verbose
+
+# Import VC to OAP Decision
+node dist/cli.js import --type decision --input decision.vc.json --output decision.json
+
+# Validate OAP objects or VCs
+node dist/cli.js validate --type passport --input passport.json
+node dist/cli.js validate --type decision --input decision.json
+node dist/cli.js validate --type vc --input passport.vc.json
+
+# Generate a registry key
+node dist/cli.js generate-key --output my-registry-key.json
+```
+
+### SDK Usage
+
+```javascript
+import { 
+  exportPassportToVC, 
+  exportDecisionToVC, 
+  importVCToPassport, 
+  importVCToDecision 
+} from './dist/index.js';
+
+// Export OAP Passport to VC
+const passportVC = exportPassportToVC(passport, registryKey);
+
+// Export OAP Decision to VC
+const decisionVC = exportDecisionToVC(decision, registryKey);
+
+// Import VC to OAP Passport
+const passport = importVCToPassport(vc);
+
+// Import VC to OAP Decision
+const decision = importVCToDecision(vc);
+```
+
+## 📋 Requirements
+
+- Node.js 18+
+- TypeScript 5.3+
+- Registry key for signing VCs
+
+## 🔧 Configuration
+
+### Registry Key Format
+
+```json
+{
+  "issuer": "https://aport.io",
+  "kid": "key-2025-01",
+  "publicKey": "your-ed25519-public-key",
+  "privateKey": "your-ed25519-private-key"
+}
+```
+
+### OAP Passport Format
+
+```json
+{
+  "agent_id": "550e8400-e29b-41d4-a716-446655440000",
+  "kind": "template",
+  "spec_version": "oap/1.0",
+  "owner_id": "org_12345678",
+  "owner_type": "org",
+  "assurance_level": "L2",
+  "status": "active",
+  "capabilities": [
+    { "id": "finance.payment.refund", "params": { "currency_limits": { "USD": { "max_per_tx": 5000 } } } }
+  ],
+  "limits": { /* policy limits */ },
+  "regions": ["US", "CA"],
+  "metadata": { /* additional metadata */ },
+  "created_at": "2024-01-01T00:00:00Z",
+  "updated_at": "2024-01-15T10:30:00Z",
+  "version": "1.0.0"
+}
+```
+
+### OAP Decision Format
+
+```json
+{
+  "decision_id": "550e8400-e29b-41d4-a716-446655440002",
+  "policy_id": "finance.payment.refund.v1",
+  "agent_id": "550e8400-e29b-41d4-a716-446655440000",
+  "owner_id": "org_12345678",
+  "assurance_level": "L2",
+  "allow": true,
+  "reasons": [
+    { "code": "oap.allowed", "message": "Transaction within limits" }
+  ],
+  "created_at": "2024-01-15T10:30:00Z",
+  "expires_in": 3600,
+  "passport_digest": "sha256:abcd1234efgh5678ijkl9012mnop3456qrst7890uvwx1234yzab5678cdef",
+  "signature": "eyJhbGciOiJFUzI1NiIsInR5cCI6IkpXVCJ9...",
+  "kid": "oap:registry:key-2025-01",
+  "decision_token": "eyJhbGciOiJFUzI1NiIsInR5cCI6IkpXVCJ9..."
+}
+```
+
+## 🧪 Testing
+
+```bash
+# Run the simple test (no build required)
+node test-simple.js
+
+# Build and run full test suite
+npm run build
+npm test
+
+# Run specific test
+npm run test -- --grep "passport"
+```
+
+## 📚 API Reference
+
+### `exportPassportToVC(passport, registryKey)`
+
+Converts an OAP Passport to a Verifiable Credential.
+
+**Parameters:**
+
+- `passport` (OAPPassport): The OAP passport object
+- `registryKey` (RegistryKey): Registry key for signing
+
+**Returns:** `VerifiableCredential`
+
+### `exportDecisionToVC(decision, registryKey)`
+
+Converts an OAP Decision to a Verifiable Credential.
+
+**Parameters:**
+
+- `decision` (OAPDecision): The OAP decision object
+- `registryKey` (RegistryKey): Registry key for signing
+
+**Returns:** `VerifiableCredential`
+
+### `importVCToPassport(vc)`
+
+Converts a Verifiable Credential to an OAP Passport.
+
+**Parameters:**
+
+- `vc` (VerifiableCredential): The Verifiable Credential
+
+**Returns:** `OAPPassport`
+
+### `importVCToDecision(vc)`
+
+Converts a Verifiable Credential to an OAP Decision.
+
+**Parameters:**
+
+- `vc` (VerifiableCredential): The Verifiable Credential
+
+**Returns:** `OAPDecision`
+
+## 📊 Logging and Debugging
+
+The tools provide detailed logging to help you understand what's being converted:
+
+### Verbose Output
+
+Use the `--verbose` flag to see the full converted data:
+
+```bash
+# Show converted VC data
+node dist/cli.js export --type passport --input passport.json --output passport.vc.json --key registry-key.json --verbose
+
+# Show converted OAP data
+node dist/cli.js import --type passport --input passport.vc.json --output passport.json --verbose
+```
+
+### Example Output
+
+```text
+✅ Successfully exported passport to VC
+📁 Output written to: passport.vc.json
+
+📄 Converted VC Data:
+──────────────────────────────────────────────────
+{
+  "@context": [
+    "https://www.w3.org/2018/credentials/v1",
+    "https://raw.githubusercontent.com/aporthq/aport-spec/refs/heads/main/oap/vc/context-oap-v1.jsonld"
+  ],
+  "type": ["VerifiableCredential", "OAPPassportCredential"],
+  "credentialSubject": {
+    "agent_id": "550e8400-e29b-41d4-a716-446655440000",
+    "kind": "template",
+    "spec_version": "oap/1.0",
+    ...
+  },
+  "issuer": "https://aport.io",
+  "issuanceDate": "2024-01-01T00:00:00Z",
+  "expirationDate": "2025-01-01T00:00:00Z",
+  "proof": {
+    "type": "Ed25519Signature2020",
+    ...
+  }
+}
+──────────────────────────────────────────────────
+```
+
+## 🔒 Security Considerations
+
+- **Signing**: VCs are signed using Ed25519Signature2020
+- **Verification**: Always verify VC signatures before importing
+- **Key Management**: Store registry keys securely
+- **Expiration**: VCs include expiration dates for security
+
+## 🌐 Interoperability
+
+These tools enable OAP objects to work with:
+
+- **VC Wallets**: Store OAP objects in standard VC wallets
+- **VC Presentations**: Present OAP objects using VC presentation protocols
+- **VC Verification**: Verify OAP objects using standard VC libraries
+- **DID Ecosystems**: Integrate with Decentralized Identifier systems
+
+## 📖 Examples
+
+See the `examples/` directory for complete working examples:
+
+- `examples/passport-to-vc.js` - Convert passport to VC
+- `examples/decision-to-vc.js` - Convert decision to VC
+- `examples/vc-to-passport.js` - Convert VC to passport
+- `examples/vc-to-decision.js` - Convert VC to decision
+
+## 🤝 Contributing
+
+1. Fork the repository
+2. Create a feature branch
+3. Make your changes
+4. Add tests
+5. Submit a pull request
+
+## 📄 License
+
+MIT License - see LICENSE file for details.

package/external/aport-spec/oap/vc/tools/examples/decision-to-vc.js

@@ -0,0 +1,66 @@
+#!/usr/bin/env node
+
+/**
+ * Example: Convert OAP Decision to Verifiable Credential
+ */
+
+import { readFileSync, writeFileSync } from "fs";
+import { join, dirname } from "path";
+import { fileURLToPath } from "url";
+import { exportDecisionToVC } from "../dist/index.js";
+
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = dirname(__filename);
+
+// Sample OAP Decision
+const decision = {
+  decision_id: "550e8400-e29b-41d4-a716-446655440002",
+  policy_id: "finance.payment.refund.v1",
+  agent_id: "550e8400-e29b-41d4-a716-446655440000",
+  owner_id: "org_12345678",
+  assurance_level: "L2",
+  allow: true,
+  reasons: [{ code: "oap.allowed", message: "Transaction within limits" }],
+  created_at: "2024-01-15T10:30:00Z",
+  expires_in: 3600,
+  passport_digest:
+    "sha256:abcd1234efgh5678ijkl9012mnop3456qrst7890uvwx1234yzab5678cdef",
+  signature: "eyJhbGciOiJFUzI1NiIsInR5cCI6IkpXVCJ9...",
+  kid: "oap:registry:key-2025-01",
+  decision_token: "eyJhbGciOiJFUzI1NiIsInR5cCI6IkpXVCJ9...",
+};
+
+// Sample Registry Key
+const registryKey = {
+  issuer: "https://aport.io",
+  kid: "key-2025-01",
+  publicKey: "placeholder-public-key",
+  privateKey: "placeholder-private-key",
+};
+
+try {
+  console.log("🔄 Converting OAP Decision to Verifiable Credential...\n");
+
+  // Convert decision to VC
+  const vc = exportDecisionToVC(decision, registryKey);
+
+  // Save to file
+  const outputFile = join(__dirname, "decision.vc.json");
+  writeFileSync(outputFile, JSON.stringify(vc, null, 2));
+
+  console.log("✅ Conversion successful!");
+  console.log(`📄 VC Type: ${vc.type.join(", ")}`);
+  console.log(`🏢 Issuer: ${vc.issuer}`);
+  console.log(`📅 Issuance Date: ${vc.issuanceDate}`);
+  console.log(`⏰ Expiration Date: ${vc.expirationDate}`);
+  console.log(`📁 Output saved to: ${outputFile}`);
+
+  // Log the converted data
+  console.log("\n📄 Converted VC Data:");
+  console.log("─".repeat(50));
+  console.log(JSON.stringify(vc, null, 2));
+  console.log("─".repeat(50));
+} catch (error) {
+  console.error("❌ Conversion failed:", error.message);
+  process.exit(1);
+}

package/external/aport-spec/oap/vc/tools/examples/passport-to-vc.js

@@ -0,0 +1,83 @@
+#!/usr/bin/env node
+
+/**
+ * Example: Convert OAP Passport to Verifiable Credential
+ */
+
+import { readFileSync, writeFileSync } from "fs";
+import { join, dirname } from "path";
+import { fileURLToPath } from "url";
+import { exportPassportToVC } from "../dist/index.js";
+
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = dirname(__filename);
+
+// Sample OAP Passport
+const passport = {
+  agent_id: "550e8400-e29b-41d4-a716-446655440000",
+  kind: "template",
+  spec_version: "oap/1.0",
+  owner_id: "org_12345678",
+  owner_type: "org",
+  assurance_level: "L2",
+  status: "active",
+  capabilities: [
+    {
+      id: "finance.payment.refund",
+      params: { currency_limits: { USD: { max_per_tx: 5000 } } },
+    },
+    { id: "data.export", params: { max_rows: 100000 } },
+  ],
+  limits: {
+    "finance.payment.refund": {
+      currency_limits: {
+        USD: { max_per_tx: 5000, daily_cap: 50000 },
+      },
+      reason_codes: ["customer_request", "defective_product"],
+      idempotency_required: true,
+    },
+  },
+  regions: ["US", "CA"],
+  metadata: {
+    name: "Customer Support AI",
+    description: "AI agent for customer support operations",
+  },
+  created_at: "2024-01-01T00:00:00Z",
+  updated_at: "2024-01-15T10:30:00Z",
+  version: "1.0.0",
+};
+
+// Sample Registry Key
+const registryKey = {
+  issuer: "https://aport.io",
+  kid: "key-2025-01",
+  publicKey: "placeholder-public-key",
+  privateKey: "placeholder-private-key",
+};
+
+try {
+  console.log("🔄 Converting OAP Passport to Verifiable Credential...\n");
+
+  // Convert passport to VC
+  const vc = exportPassportToVC(passport, registryKey);
+
+  // Save to file
+  const outputFile = join(__dirname, "passport.vc.json");
+  writeFileSync(outputFile, JSON.stringify(vc, null, 2));
+
+  console.log("✅ Conversion successful!");
+  console.log(`📄 VC Type: ${vc.type.join(", ")}`);
+  console.log(`🏢 Issuer: ${vc.issuer}`);
+  console.log(`📅 Issuance Date: ${vc.issuanceDate}`);
+  console.log(`⏰ Expiration Date: ${vc.expirationDate}`);
+  console.log(`📁 Output saved to: ${outputFile}`);
+
+  // Log the converted data
+  console.log("\n📄 Converted VC Data:");
+  console.log("─".repeat(50));
+  console.log(JSON.stringify(vc, null, 2));
+  console.log("─".repeat(50));
+} catch (error) {
+  console.error("❌ Conversion failed:", error.message);
+  process.exit(1);
+}

package/external/aport-spec/oap/vc/tools/examples/vc-to-decision.js

@@ -0,0 +1,77 @@
+#!/usr/bin/env node
+
+/**
+ * Example: Convert Verifiable Credential to OAP Decision
+ */
+
+import { readFileSync, writeFileSync } from "fs";
+import { join, dirname } from "path";
+import { fileURLToPath } from "url";
+import { importVCToDecision } from "../dist/index.js";
+
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = dirname(__filename);
+
+// Sample Verifiable Credential (OAP Decision)
+const vc = {
+  "@context": [
+    "https://www.w3.org/2018/credentials/v1",
+    "https://raw.githubusercontent.com/aporthq/aport-spec/refs/heads/main/oap/vc/context-oap-v1.jsonld",
+  ],
+  type: ["VerifiableCredential", "OAPDecisionReceipt"],
+  credentialSubject: {
+    decision_id: "550e8400-e29b-41d4-a716-446655440002",
+    policy_id: "finance.payment.refund.v1",
+    agent_id: "550e8400-e29b-41d4-a716-446655440000",
+    owner_id: "org_12345678",
+    assurance_level: "L2",
+    allow: true,
+    reasons: [{ code: "oap.allowed", message: "Transaction within limits" }],
+    created_at: "2024-01-15T10:30:00Z",
+    expires_in: 3600,
+    passport_digest:
+      "sha256:abcd1234efgh5678ijkl9012mnop3456qrst7890uvwx1234yzab5678cdef",
+    signature: "eyJhbGciOiJFUzI1NiIsInR5cCI6IkpXVCJ9...",
+    kid: "oap:registry:key-2025-01",
+    decision_token: "eyJhbGciOiJFUzI1NiIsInR5cCI6IkpXVCJ9...",
+  },
+  issuer: "https://aport.io",
+  issuanceDate: "2024-01-15T10:30:00Z",
+  expirationDate: "2024-01-15T11:30:00Z",
+  proof: {
+    type: "Ed25519Signature2020",
+    created: "2024-01-15T10:30:00Z",
+    verificationMethod:
+      "https://aport.io/.well-known/oap/keys.json#ap_registry_ed25519_2024",
+    proofPurpose: "assertionMethod",
+    jws: "eyJhbGciOiJFUzI1NiIsInR5cCI6IkpXVCJ9.eyJjcmVkZW50aWFsU3ViamVjdCI6eyJkZWNpc2lvbl9pZCI6IjU1MGU4NDAwLWUyOWItNDFkNC1hNzE2LTQ0NjY1NTQ0MDAwMiIsInBvbGljeV9pZCI6InBheW1lbnRzLnJlZnVuZC52MSIsImFnZW50X2lkIjoiNTUwZTg0MDAtZTI5Yi00MWQ0LWE3MTYtNDQ2NjU1NDQwMDAwIiwib3duZXJfaWQiOiJvcmdfMTIzNDU2NzgiLCJhc3N1cmFuY2VfbGV2ZWwiOiJMMiIsImFsbG93Ijp0cnVlLCJyZWFzb25zIjpbeyJjb2RlIjoib2FwLmFsbG93ZWQiLCJtZXNzYWdlIjoiVHJhbnNhY3Rpb24gd2l0aGluIGxpbWl0cyJ9XSwicGFzc3BvcnRfZGlnZXN0Ijoic2hhMjU2OmFiY2QxMjM0ZWZnaDU2NzhpamtsOTAxMm1ub3AzNDU2cXJzdDc4OTB1dnd4MTIzNHl6YWI1Njc4Y2RlZiIsInNpZ25hdHVyZSI6ImV5SmhiR2NpT2lKU1V6STFOaUlzSW5SNWNDSTZJa3BYVkNKOS5leUpoYkdjaU9pSlNVekkxTmlJc0luUjVjQ0k2SWtwWFZDSjkucGxhY2Vob2xkZXIifQ.signature",
+  },
+};
+
+try {
+  console.log("🔄 Converting Verifiable Credential to OAP Decision...\n");
+
+  // Convert VC to decision
+  const decision = importVCToDecision(vc);
+
+  // Save to file
+  const outputFile = join(__dirname, "decision.json");
+  writeFileSync(outputFile, JSON.stringify(decision, null, 2));
+
+  console.log("✅ Conversion successful!");
+  console.log(`🆔 Decision ID: ${decision.decision_id}`);
+  console.log(`📋 Policy ID: ${decision.policy_id}`);
+  console.log(`✅ Allow: ${decision.allow}`);
+  console.log(`📝 Reasons: ${decision.reasons.length} reasons`);
+  console.log(`⏰ Expires In: ${decision.expires_in} seconds`);
+  console.log(`📁 Output saved to: ${outputFile}`);
+
+  // Log the converted data
+  console.log("\n📄 Converted Decision Data:");
+  console.log("─".repeat(50));
+  console.log(JSON.stringify(decision, null, 2));
+  console.log("─".repeat(50));
+} catch (error) {
+  console.error("❌ Conversion failed:", error.message);
+  process.exit(1);
+}

package/external/aport-spec/oap/vc/tools/examples/vc-to-passport.js

@@ -0,0 +1,94 @@
+#!/usr/bin/env node
+
+/**
+ * Example: Convert Verifiable Credential to OAP Passport
+ */
+
+import { readFileSync, writeFileSync } from "fs";
+import { join, dirname } from "path";
+import { fileURLToPath } from "url";
+import { importVCToPassport } from "../dist/index.js";
+
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = dirname(__filename);
+
+// Sample Verifiable Credential (OAP Passport)
+const vc = {
+  "@context": [
+    "https://www.w3.org/2018/credentials/v1",
+    "https://raw.githubusercontent.com/aporthq/aport-spec/refs/heads/main/oap/vc/context-oap-v1.jsonld",
+  ],
+  type: ["VerifiableCredential", "OAPPassportCredential"],
+  credentialSubject: {
+    agent_id: "550e8400-e29b-41d4-a716-446655440000",
+    kind: "template",
+    spec_version: "oap/1.0",
+    owner_id: "org_12345678",
+    owner_type: "org",
+    assurance_level: "L2",
+    status: "active",
+    capabilities: [
+      {
+        id: "finance.payment.refund",
+        params: { currency_limits: { USD: { max_per_tx: 5000 } } },
+      },
+      { id: "data.export", params: { max_rows: 100000 } },
+    ],
+    limits: {
+      "finance.payment.refund": {
+        currency_limits: {
+          USD: { max_per_tx: 5000, daily_cap: 50000 },
+        },
+        reason_codes: ["customer_request", "defective_product"],
+        idempotency_required: true,
+      },
+    },
+    regions: ["US", "CA"],
+    metadata: {
+      name: "Customer Support AI",
+      description: "AI agent for customer support operations",
+    },
+    created_at: "2024-01-01T00:00:00Z",
+    updated_at: "2024-01-15T10:30:00Z",
+    version: "1.0.0",
+  },
+  issuer: "https://aport.io",
+  issuanceDate: "2024-01-01T00:00:00Z",
+  expirationDate: "2025-01-01T00:00:00Z",
+  proof: {
+    type: "Ed25519Signature2020",
+    created: "2024-01-01T00:00:00Z",
+    verificationMethod:
+      "https://aport.io/.well-known/oap/keys.json#ap_registry_ed25519_2024",
+    proofPurpose: "assertionMethod",
+    jws: "eyJhbGciOiJFUzI1NiIsInR5cCI6IkpXVCJ9.eyJjcmVkZW50aWFsU3ViamVjdCI6eyJhZ2VudF9pZCI6IjU1MGU4NDAwLWUyOWItNDFkNC1hNzE2LTQ0NjY1NTQ0MDAwMCIsImtpbmQiOiJ0ZW1wbGF0ZSIsInNwZWNfdmVyc2lvbiI6Im9hcC8xLjAiLCJvd25lcl9pZCI6Im9yZ18xMjM0NTY3OCIsIm93bmVyX3R5cGUiOiJvcmciLCJhc3N1cmFuY2VfbGV2ZWwiOiJMMiIsInN0YXR1cyI6ImFjdGl2ZSIsImNhcGFiaWxpdGllcyI6W3siaWQiOiJwYXltZW50cy5yZWZ1bmQiLCJwYXJhbXMiOnsiY3VycmVuY3lfbGltaXRzIjp7IlVTRCI6eyJtYXhfcGVyX3R4Ijo1MDAwfX19fSx7ImlkIjoiZGF0YS5leHBvcnQiLCJwYXJhbXMiOnsibWF4X3Jvd3MiOjEwMDAwMH19XSwibGltaXRzIjp7InBheW1lbnRzLnJlZnVuZCI6eyJjdXJyZW5jeV9saW1pdHMiOnsiVVNEIjp7Im1heF9wZXJfdHgiOjUwMDAsImRhaWx5X2NhcCI6NTAwMDB9fSwicmVhc29uX2NvZGVzIjpbImN1c3RvbWVyX3JlcXVlc3QiLCJkZWZlY3RpdmVfcHJvZHVjdCJdLCJpZGVtcG90ZW5jeV9yZXF1aXJlZCI6dHJ1ZX19LCJyZWdpb25zIjpbIlVTIiwiQ0EiXSwibWV0YWRhdGEiOnsibmFtZSI6IkN1c3RvbWVyIFN1cHBvcnQgQUkiLCJkZXNjcmlwdGlvbiI6IkFJIGFnZW50IGZvciBjdXN0b21lciBzdXBwb3J0IG9wZXJhdGlvbnMifSwiY3JlYXRlZF9hdCI6IjIwMjQtMDEtMDFUMDA6MDA6MDBaIiwidXBkYXRlZF9hdCI6IjIwMjQtMDEtMTVUMTA6MzA6MDBaIiwidmVyc2lvbiI6IjEuMC4wIn0sImlzc3VlciI6Imh0dHBzOi8vYXBpLmFwb3J0LmRldiIsImlzc3VhbmNlRGF0ZSI6IjIwMjQtMDEtMDFUMDA6MDA6MDBaIiwiZXhwaXJhdGlvbkRhdGUiOiIyMDI1LTAxLTAxVDAwOjAwOjAwWiJ9.signature",
+  },
+};
+
+try {
+  console.log("🔄 Converting Verifiable Credential to OAP Passport...\n");
+
+  // Convert VC to passport
+  const passport = importVCToPassport(vc);
+
+  // Save to file
+  const outputFile = join(__dirname, "passport.json");
+  writeFileSync(outputFile, JSON.stringify(passport, null, 2));
+
+  console.log("✅ Conversion successful!");
+  console.log(`🆔 Agent ID: ${passport.agent_id}`);
+  console.log(`📋 Kind: ${passport.kind}`);
+  console.log(`🔐 Assurance Level: ${passport.assurance_level}`);
+  console.log(`📊 Capabilities: ${passport.capabilities.length} capabilities`);
+  console.log(`🌍 Regions: ${passport.regions.join(", ")}`);
+  console.log(`📁 Output saved to: ${outputFile}`);
+
+  // Log the converted data
+  console.log("\n📄 Converted Passport Data:");
+  console.log("─".repeat(50));
+  console.log(JSON.stringify(passport, null, 2));
+  console.log("─".repeat(50));
+} catch (error) {
+  console.error("❌ Conversion failed:", error.message);
+  process.exit(1);
+}

package/external/aport-spec/oap/vc/tools/package.json

@@ -0,0 +1,38 @@
+{
+  "name": "@oap/vc-tools",
+  "version": "1.0.0",
+  "description": "Open Agent Passport VC conversion tools",
+  "main": "dist/index.js",
+  "type": "module",
+  "bin": {
+    "oap-vc": "./dist/cli.js"
+  },
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "test": "node dist/test.js",
+    "convert": "node dist/cli.js"
+  },
+  "dependencies": {
+    "@noble/ed25519": "^3.0.0",
+    "ajv": "^8.12.0",
+    "ajv-formats": "^2.1.1",
+    "chalk": "^5.3.0",
+    "commander": "^11.1.0",
+    "crypto": "^1.0.1",
+    "ora": "^7.0.1"
+  },
+  "devDependencies": {
+    "@types/node": "^20.10.0",
+    "typescript": "^5.3.0"
+  },
+  "keywords": [
+    "oap",
+    "verifiable-credentials",
+    "vc",
+    "conversion",
+    "interoperability"
+  ],
+  "author": "Aport",
+  "license": "MIT"
+}