aacp-ts 1.1.0

package/dist/validator.js

@@ -0,0 +1,112 @@
+"use strict";
+/**
+ * AACP v1.1 Validator
+ * Validates pipe-delimited AACP packets against the v1.1 schema.
+ * Pure logic. No LLM calls. Fast and free.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AACPValidator = void 0;
+const schema_1 = require("./schema");
+class ValidationResultImpl {
+    constructor(valid, errors = [], warnings = []) {
+        this.valid = valid;
+        this.errors = errors;
+        this.warnings = warnings;
+    }
+    summary() {
+        const lines = [
+            "VALIDATION RESULT",
+            `  Status: ${this.valid ? "VALID" : "INVALID"}`,
+        ];
+        for (const e of this.errors)
+            lines.push(`    ERROR: ${e}`);
+        for (const w of this.warnings)
+            lines.push(`    WARN:  ${w}`);
+        if (!this.errors.length && !this.warnings.length) {
+            lines.push("  No issues.");
+        }
+        return lines.join("\n");
+    }
+}
+class AACPValidator {
+    validate(packet) {
+        const errors = [];
+        const warnings = [];
+        if (!packet || !packet.trim()) {
+            return new ValidationResultImpl(false, ["Empty packet."]);
+        }
+        const fields = packet.trim().split("|");
+        if (fields.length < 3) {
+            return new ValidationResultImpl(false, [
+                `Packet has ${fields.length} fields. Minimum required: TASK|DOM|return:AGENT|aacp:VERSION`,
+            ]);
+        }
+        const task = fields[0].trim();
+        const dom = fields[1].trim();
+        // Named fields from position 2 onwards
+        const named = {};
+        for (const f of fields.slice(2)) {
+            const trimmed = f.trim();
+            if (!trimmed)
+                continue;
+            const colonIdx = trimmed.indexOf(":");
+            if (colonIdx === -1) {
+                warnings.push(`Field "${trimmed}" has no colon separator — expected key:value.`);
+                continue;
+            }
+            const key = trimmed.slice(0, colonIdx).toLowerCase();
+            const val = trimmed.slice(colonIdx + 1);
+            named[key] = val;
+        }
+        // Required: TASK
+        if (!task) {
+            errors.push(`Field 0 (TASK) is empty. Valid: ${[...schema_1.VALID_TASKS].sort().join(", ")}`);
+        }
+        else if (!schema_1.VALID_TASKS.has(task)) {
+            errors.push(`Unknown TASK "${task}". Valid: ${[...schema_1.VALID_TASKS].sort().join(", ")}`);
+        }
+        // Required: DOM
+        if (!dom) {
+            errors.push(`Field 1 (DOM) is empty. Valid: ${[...schema_1.VALID_DOMAINS].sort().join(", ")}`);
+        }
+        else if (!schema_1.VALID_DOMAINS.has(dom)) {
+            errors.push(`Unknown DOM "${dom}". Valid: ${[...schema_1.VALID_DOMAINS].sort().join(", ")}`);
+        }
+        // Required: return:
+        if (!named["return"]) {
+            errors.push("Missing required field: return: (receiving agent identifier)");
+        }
+        // Required: aacp:
+        if (!named["aacp"]) {
+            warnings.push(`Missing aacp: version field. Expected aacp:${schema_1.AACP_VERSION}`);
+        }
+        else if (named["aacp"] !== schema_1.AACP_VERSION) {
+            warnings.push(`AACP version "${named["aacp"]}" — current is ${schema_1.AACP_VERSION}`);
+        }
+        // Optional: priority
+        if (named["p"] && !schema_1.VALID_PRIORITIES.has(named["p"])) {
+            warnings.push(`Priority "${named["p"]}" non-standard. Expected 1, 2, or 3.`);
+        }
+        // Extended field validation
+        for (const key of Object.keys(named)) {
+            if (["return", "aacp", "p", "res", "period", "filter", "fields", "fmt"].includes(key)) {
+                continue;
+            }
+            if (!schema_1.EXTENDED_FIELDS.has(key)) {
+                warnings.push(`Unknown extended field "${key}". ` +
+                    `May be a valid extension — ensure receiving agent supports it.`);
+            }
+        }
+        // Companion rules
+        if (named["sentiment"] && !named["tone"]) {
+            warnings.push("sentiment field present without tone. " +
+                "Add tone:empathetic|formal|terse for human-facing tasks.");
+        }
+        if (named["ltv"] && !named["ccy"]) {
+            warnings.push("ltv field present without ccy — add currency context.");
+        }
+        return new ValidationResultImpl(errors.length === 0, errors, warnings);
+    }
+}
+exports.AACPValidator = AACPValidator;
+//# sourceMappingURL=validator.js.map

package/dist/validator.js.map

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

package/package.json

@@ -0,0 +1,47 @@
+{
+  "name": "aacp-ts",
+  "version": "1.1.0",
+  "description": "Agent Action Compression Protocol \u2014 TypeScript SDK for multi-agent LLM coordination",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    }
+  },
+  "scripts": {
+    "build": "tsc",
+    "test": "npx ts-node --compiler-options '{\"module\":\"CommonJS\"}' tests/smoke.test.ts",
+    "dev": "npx tsx src/index.ts",
+    "prepublishOnly": "npm run build && npm test"
+  },
+  "keywords": [
+    "aacp",
+    "agents",
+    "multi-agent",
+    "llm",
+    "protocol",
+    "coordination",
+    "ai",
+    "typescript"
+  ],
+  "author": "Andrew Mackay <mackayandrewr@gmail.com>",
+  "license": "MIT",
+  "homepage": "https://aacp.dev",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/MackayAndrew/aacp-ts"
+  },
+  "bugs": {
+    "url": "https://github.com/MackayAndrew/aacp-ts/issues"
+  },
+  "devDependencies": {
+    "typescript": "^5.4.0",
+    "@types/node": "^20.0.0",
+    "ts-node": "^10.9.2"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  }
+}

package/tests/smoke.test.ts

@@ -0,0 +1,162 @@
+/**
+ * AACP TypeScript SDK — Smoke Tests
+ * Run: npx tsx tests/smoke.test.ts
+ * No test framework needed — pure assertions.
+ */
+
+import {
+  PayrollEncoder, ITEncoder, InvoiceEncoder, ContractEncoder,
+  AACPValidator, AACPDecoder, AACP_VERSION,
+} from "../src/index";
+
+let passed = 0;
+let failed = 0;
+
+function assert(condition: boolean, label: string) {
+  if (condition) {
+    console.log(`  ✓ ${label}`);
+    passed++;
+  } else {
+    console.error(`  ✗ FAIL: ${label}`);
+    failed++;
+  }
+}
+
+function section(label: string) {
+  console.log(`\n${"=".repeat(50)}`);
+  console.log(`  ${label}`);
+  console.log("=".repeat(50));
+}
+
+// ── Payroll encoder ────────────────────────────────────────
+section("PayrollEncoder");
+const payroll = new PayrollEncoder();
+
+const p1 = payroll.fetchEmployees("2026-03");
+console.log(`  ${p1.packet}`);
+assert(p1.packet.startsWith("FETCH|HR|"), "FETCH|HR packet");
+assert(p1.packet.includes("res:emp_salary"), "res:emp_salary");
+assert(p1.packet.includes("period:2026-03"), "period:2026-03");
+assert(p1.packet.includes("filter:status=active"), "filter:status=active");
+assert(p1.packet.includes(`aacp:${AACP_VERSION}`), "correct version");
+assert(p1.apiCostUsd === 0.0, "zero cost");
+assert(p1.encoderType === "rule_based", "rule_based encoder");
+
+const p2 = payroll.fetchBudgets("2026-03");
+console.log(`  ${p2.packet}`);
+assert(p2.packet.startsWith("FETCH|FIN|"), "FETCH|FIN packet");
+
+const p3 = payroll.mergeAndCalculate("2026-03");
+console.log(`  ${p3.packet}`);
+assert(p3.packet.startsWith("MERGE|HR|"), "MERGE|HR packet");
+assert(p3.packet.includes("rules:payroll_v2"), "rules:payroll_v2");
+
+const p4 = payroll.generateReport("2026-03", "2026-02");
+console.log(`  ${p4.packet}`);
+assert(p4.packet.startsWith("REPORT|HR|"), "REPORT|HR packet");
+
+const fullRun = payroll.fullRun("2026-03", "2026-02");
+assert(fullRun.length === 6, "full run returns 6 packets");
+assert(fullRun.every(p => p.apiCostUsd === 0.0), "all packets zero cost");
+
+// ── IT encoder ────────────────────────────────────────────
+section("ITEncoder");
+const it = new ITEncoder();
+
+const it1 = it.createAccount("j.smith", "Engineering");
+console.log(`  ${it1.packet}`);
+assert(it1.packet.startsWith("BUILD|IT|"), "BUILD|IT packet");
+assert(it1.packet.includes("usr=j.smith"), "username in filter");
+
+const itRun = it.fullProvision("j.smith", "Engineering", ["M365", "Slack"]);
+assert(itRun.length === 5, "IT full provision returns 5 packets");
+
+// ── Invoice encoder ───────────────────────────────────────
+section("InvoiceEncoder");
+const inv = new InvoiceEncoder();
+
+const inv1 = inv.processInvoice("Acme-Ltd", 4200, "GBP", "PO-441");
+console.log(`  ${inv1.packet}`);
+assert(inv1.packet.startsWith("PROC|FIN|"), "PROC|FIN packet");
+assert(inv1.packet.includes("amt:4200"), "amount present");
+assert(inv1.packet.includes("ccy:GBP"), "currency present");
+assert(inv1.packet.includes("match:PO-441"), "PO number present");
+
+const invRun = inv.fullProcess("Acme-Ltd", 4200, "GBP", "PO-441");
+assert(invRun.length === 3, "invoice full process returns 3 packets");
+
+// ── Contract encoder ──────────────────────────────────────
+section("ContractEncoder");
+const contract = new ContractEncoder();
+
+const c1 = contract.flagClause(
+  "NDA", "Acme-Ltd", "s7", "ip_rights_restriction", "high", "signature"
+);
+console.log(`  ${c1.packet}`);
+assert(c1.packet.startsWith("FLAG|LEGAL|"), "FLAG|LEGAL packet");
+assert(c1.packet.includes("risk:high"), "risk level present");
+assert(c1.packet.includes("block:signature"), "block action present");
+
+// ── Validator ────────────────────────────────────────────
+section("AACPValidator");
+const v = new AACPValidator();
+
+const goodPacket = "FETCH|HR|return:HR-Agent|p:1|aacp:1.1|res:emp_salary|period:2026-03";
+const r1 = v.validate(goodPacket);
+assert(r1.valid, "valid packet passes");
+assert(r1.errors.length === 0, "no errors on valid packet");
+
+const badPacket = "INVALID|NODOMAIN|return:agent|aacp:1.1";
+const r2 = v.validate(badPacket);
+assert(!r2.valid, "invalid TASK fails validation");
+assert(r2.errors.length > 0, "errors returned on invalid packet");
+
+const emptyPacket = "";
+const r3 = v.validate(emptyPacket);
+assert(!r3.valid, "empty packet fails validation");
+
+// ── Decoder ──────────────────────────────────────────────
+section("AACPDecoder");
+const dec = new AACPDecoder();
+
+const decoded = dec.decode(
+  "FETCH|HR|return:HR-Agent|p:1|aacp:1.1|res:emp_salary|period:2026-03|filter:status=active|fmt:json"
+);
+console.log(`  ${decoded.english}`);
+assert(decoded.isComplete, "decode returns complete result");
+assert(decoded.english.length > 0, "decoded English is non-empty");
+assert(decoded.parsed["task"] === "FETCH", "task parsed correctly");
+assert(decoded.parsed["domain"] === "HR", "domain parsed correctly");
+assert(decoded.parsed["res"] === "emp_salary", "res parsed correctly");
+assert(decoded.caveat.length > 0, "caveat present");
+
+// ── All packets validate ──────────────────────────────────
+section("All generated packets validate");
+const allPackets = [
+  ...payroll.fullRun("2026-03", "2026-02"),
+  ...it.fullProvision("j.smith", "Engineering", ["M365"]),
+  ...inv.fullProcess("Acme-Ltd", 4200, "GBP", "PO-441"),
+  ...contract.fullReview("NDA", "Acme-Ltd", "tpl_nda_v2"),
+];
+
+let allValid = true;
+for (const pkt of allPackets) {
+  const result = v.validate(pkt.packet);
+  if (!result.valid) {
+    console.error(`  ✗ Invalid: ${pkt.packet}`);
+    console.error(`    Errors: ${result.errors.join(", ")}`);
+    allValid = false;
+  }
+}
+assert(allValid, `all ${allPackets.length} generated packets validate`);
+
+// ── Summary ───────────────────────────────────────────────
+console.log(`\n${"=".repeat(50)}`);
+console.log(`  RESULTS: ${passed} passed, ${failed} failed`);
+console.log("=".repeat(50));
+
+if (failed > 0) {
+  process.exit(1);
+} else {
+  console.log("\n  TypeScript SDK v1.1 — all tests passed\n");
+}

package/tsconfig.json

@@ -0,0 +1,29 @@
+{
+  "compilerOptions": {
+    "target": "ES2020",
+    "module": "CommonJS",
+    "moduleResolution": "node",
+    "outDir": "./dist",
+    "rootDir": "./src",
+    "declaration": true,
+    "declarationMap": true,
+    "sourceMap": true,
+    "strict": true,
+    "esModuleInterop": true,
+    "skipLibCheck": true,
+    "forceConsistentCasingInFileNames": true,
+    "resolveJsonModule": true
+  },
+  "include": [
+    "src/**/*"
+  ],
+  "exclude": [
+    "node_modules",
+    "dist",
+    "tests"
+  ],
+  "ts-node": {
+    "esm": false,
+    "experimentalSpecifierResolution": "node"
+  }
+}