aacp-ts 1.1.0

package/Src/encoders/workflows/payrollEncoder.ts

@@ -0,0 +1,110 @@
+/**
+ * AACP v1.1 Payroll Workflow Encoder
+ * Zero-cost deterministic encoding for HR payroll workflows.
+ * Mirrors Python PayrollEncoder exactly.
+ */
+
+import { RuleBasedEncoder } from "../ruleBasedEncoder";
+import { EncodedPacket } from "../../schema";
+
+export class PayrollEncoder {
+  private enc = new RuleBasedEncoder();
+
+  fetchEmployees(
+    period: string,
+    returnAgent = "HR-Agent",
+    priority = "1",
+  ): EncodedPacket {
+    return this.enc.encode({
+      task: "FETCH", domain: "HR",
+      res: "emp_salary", period,
+      filterExpr: "status=active", fmt: "json",
+      returnAgent, priority,
+    });
+  }
+
+  fetchBudgets(
+    period: string,
+    returnAgent = "HR-Agent",
+    priority = "1",
+  ): EncodedPacket {
+    return this.enc.encode({
+      task: "FETCH", domain: "FIN",
+      res: "budget_cc", period,
+      fmt: "json",
+      returnAgent, priority,
+    });
+  }
+
+  mergeAndCalculate(
+    period: string,
+    rules = "payroll_v2",
+    returnAgent = "HR-Agent",
+    priority = "1",
+  ): EncodedPacket {
+    return this.enc.encode({
+      task: "MERGE", domain: "HR",
+      rules, validate: "budget_cc",
+      returnAgent, priority,
+    });
+  }
+
+  generateReport(
+    period: string,
+    _prevPeriod: string,
+    returnAgent = "HR-Agent",
+    priority = "2",
+  ): EncodedPacket {
+    return this.enc.encode({
+      task: "REPORT", domain: "HR",
+      fmt: "pdf,xlsx", highlight: "REVIEW_REQ",
+      returnAgent, priority,
+    });
+  }
+
+  logRun(
+    _period: string,
+    actor = "HR-Agent",
+    chain?: string[],
+    status = "review_required",
+    returnAgent = "AUD-Agent",
+    priority = "2",
+  ): EncodedPacket {
+    return this.enc.encode({
+      task: "LOG", domain: "HR",
+      actor,
+      chain: chain ?? ["HRMS", "FIN", "PAY", "RPT"],
+      status,
+      returnAgent, priority,
+    });
+  }
+
+  sendReport(
+    period: string,
+    to?: string[],
+    flagMsg = "review_required",
+    returnAgent = "HR-Agent",
+    priority = "2",
+  ): EncodedPacket {
+    const periodLabel = period.replace(/-/g, "_");
+    return this.enc.encode({
+      task: "SEND", domain: "HR",
+      to: to ?? ["fin_director", "hr_director"],
+      subj: `payroll_${periodLabel}_REVIEW_REQ`,
+      att: `rpt://payroll/${period}:pdf`,
+      flagMsg,
+      returnAgent, priority,
+    });
+  }
+
+  fullRun(period: string, prevPeriod: string): EncodedPacket[] {
+    return [
+      this.fetchEmployees(period),
+      this.fetchBudgets(period),
+      this.mergeAndCalculate(period),
+      this.generateReport(period, prevPeriod),
+      this.logRun(period),
+      this.sendReport(period),
+    ];
+  }
+}

package/Src/index.ts

@@ -0,0 +1,27 @@
+/**
+ * AACP v1.1 TypeScript SDK
+ * Agent Action Compression Protocol
+ *
+ * @example
+ * import { PayrollEncoder, AACPValidator, AACPDecoder } from "aacp-ts";
+ *
+ * const enc = new PayrollEncoder();
+ * const pkt = enc.fetchEmployees("2026-03");
+ * console.log(pkt.packet);
+ * // FETCH|HR|return:HR-Agent|p:1|aacp:1.1|res:emp_salary|period:2026-03|filter:status=active|fmt:json
+ */
+
+export { AACP_VERSION, VALID_TASKS, VALID_DOMAINS, EXTENDED_FIELDS } from "./schema";
+export type {
+  EncodedPacket, DecodedPacket, ValidationResult,
+  EncodeParams, CompressionLoss, EncoderType,
+} from "./schema";
+
+export { AACPValidator }   from "./validator";
+export { AACPDecoder }     from "./decoder";
+export { RuleBasedEncoder } from "./encoders/ruleBasedEncoder";
+
+export { PayrollEncoder }  from "./encoders/workflows/payrollEncoder";
+export { ITEncoder }       from "./encoders/workflows/itEncoder";
+export { InvoiceEncoder }  from "./encoders/workflows/invoiceEncoder";
+export { ContractEncoder } from "./encoders/workflows/contractEncoder";

package/Src/schema.ts

@@ -0,0 +1,107 @@
+/**
+ * AACP v1.1 Schema
+ * Types and constants for the Agent Action Compression Protocol.
+ */
+
+export const AACP_VERSION = "1.1";
+
+export const VALID_TASKS = new Set([
+  "FETCH", "PROC", "FLAG", "RESOLVE", "LOG", "SEND",
+  "BUILD", "MERGE", "CALC", "REPORT", "ACK", "SYNC",
+]);
+
+export const VALID_DOMAINS = new Set([
+  "HR", "FIN", "SALES", "LEGAL", "IT", "CS", "MKT",
+]);
+
+export const VALID_PRIORITIES = new Set(["1", "2", "3"]);
+
+export const EXTENDED_FIELDS = new Set([
+  "src", "src_prev", "rules", "validate", "tmpl", "data_ptr",
+  "amt", "ccy", "sup", "match", "terms", "type", "party",
+  "clause", "issue", "risk", "block", "flags", "req",
+  "highlight", "status", "to", "subj", "att", "flag_msg",
+  "tone", "sentiment", "actor", "chain", "prog",
+  "ltv", "loyalty", "urgency",
+]);
+
+export type CompressionLoss = "none" | "minor" | "partial" | "significant";
+export type EncoderType = "rule_based" | "llm" | "fallback";
+
+export interface ValidationResult {
+  valid: boolean;
+  errors: string[];
+  warnings: string[];
+  summary(): string;
+}
+
+export interface EncodedPacket {
+  packet: string;
+  domain: string;
+  task: string;
+  tokenEstimateEnglish: number;
+  tokenEstimatePacket: number;
+  compressionLoss: CompressionLoss;
+  lossNote: string | null;
+  aacpVersion: string;
+  encoderType: EncoderType;
+  apiCostUsd: number;
+  readonly compressionRatio: number;
+  readonly reductionPct: string;
+  summary(): string;
+}
+
+export interface DecodedPacket {
+  english: string;
+  parsed: Record<string, string>;
+  isComplete: boolean;
+  caveat: string;
+}
+
+/** Encode parameters for the rule-based encoder */
+export interface EncodeParams {
+  task: string;
+  domain: string;
+  returnAgent: string;
+  res?: string;
+  period?: string;
+  filterExpr?: string;
+  fields?: string[];
+  fmt?: string;
+  priority?: string;
+  src?: string[];
+  srcPrev?: string;
+  rules?: string;
+  validate?: string;
+  template?: string;
+  dataPtr?: string;
+  amt?: string | number;
+  ccy?: string;
+  supplier?: string;
+  match?: string;
+  terms?: string;
+  docType?: string;
+  party?: string;
+  clause?: string;
+  issue?: string;
+  risk?: string;
+  block?: string;
+  flags?: string[];
+  flagsInherit?: string[];
+  req?: string[];
+  highlight?: string;
+  status?: string;
+  to?: string[];
+  subj?: string;
+  att?: string;
+  flagMsg?: string;
+  tone?: string;
+  sentiment?: string;
+  actor?: string;
+  chain?: string[];
+  prog?: number;
+  ltv?: string | number;
+  loyalty?: string;
+  urgency?: string;
+  [key: string]: unknown;
+}

package/Src/validator.ts

@@ -0,0 +1,127 @@
+/**
+ * AACP v1.1 Validator
+ * Validates pipe-delimited AACP packets against the v1.1 schema.
+ * Pure logic. No LLM calls. Fast and free.
+ */
+
+import {
+  VALID_TASKS, VALID_DOMAINS, VALID_PRIORITIES,
+  EXTENDED_FIELDS, AACP_VERSION,
+  ValidationResult,
+} from "./schema";
+
+class ValidationResultImpl implements ValidationResult {
+  constructor(
+    public valid: boolean,
+    public errors: string[] = [],
+    public warnings: string[] = [],
+  ) {}
+
+  summary(): string {
+    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");
+  }
+}
+
+export class AACPValidator {
+
+  validate(packet: string): ValidationResult {
+    const errors: string[] = [];
+    const warnings: string[] = [];
+
+    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: Record<string, string> = {};
+    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: ${[...VALID_TASKS].sort().join(", ")}`);
+    } else if (!VALID_TASKS.has(task)) {
+      errors.push(`Unknown TASK "${task}". Valid: ${[...VALID_TASKS].sort().join(", ")}`);
+    }
+
+    // Required: DOM
+    if (!dom) {
+      errors.push(`Field 1 (DOM) is empty. Valid: ${[...VALID_DOMAINS].sort().join(", ")}`);
+    } else if (!VALID_DOMAINS.has(dom)) {
+      errors.push(`Unknown DOM "${dom}". Valid: ${[...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:${AACP_VERSION}`);
+    } else if (named["aacp"] !== AACP_VERSION) {
+      warnings.push(`AACP version "${named["aacp"]}" — current is ${AACP_VERSION}`);
+    }
+
+    // Optional: priority
+    if (named["p"] && !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 (!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);
+  }
+}

package/dist/decoder.d.ts

@@ -0,0 +1,12 @@
+/**
+ * AACP v1.1 Decoder
+ * Expands AACP packets into human-readable English.
+ * Pure logic. No LLM calls.
+ * Note: decoded output is structural, not semantic.
+ * The packet is always the canonical record.
+ */
+import { DecodedPacket } from "./schema";
+export declare class AACPDecoder {
+    decode(packet: string): DecodedPacket;
+}
+//# sourceMappingURL=decoder.d.ts.map

package/dist/decoder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"decoder.d.ts","sourceRoot":"","sources":["../Src/decoder.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AA2BzC,qBAAa,WAAW;IAEtB,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,aAAa;CA6FtC"}

package/dist/decoder.js

@@ -0,0 +1,124 @@
+"use strict";
+/**
+ * AACP v1.1 Decoder
+ * Expands AACP packets into human-readable English.
+ * Pure logic. No LLM calls.
+ * Note: decoded output is structural, not semantic.
+ * The packet is always the canonical record.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AACPDecoder = void 0;
+const TASK_VERBS = {
+    FETCH: "Retrieve",
+    PROC: "Process",
+    FLAG: "Flag for review",
+    RESOLVE: "Resolve",
+    LOG: "Log to audit trail",
+    SEND: "Send",
+    BUILD: "Build or provision",
+    MERGE: "Merge and process",
+    CALC: "Calculate",
+    REPORT: "Generate report",
+    ACK: "Acknowledge",
+    SYNC: "Synchronise",
+};
+const DOMAIN_NAMES = {
+    HR: "Human Resources",
+    FIN: "Finance",
+    SALES: "Sales",
+    LEGAL: "Legal",
+    IT: "IT",
+    CS: "Customer Services",
+    MKT: "Marketing",
+};
+class AACPDecoder {
+    decode(packet) {
+        if (!packet || !packet.trim()) {
+            return {
+                english: "Empty packet.",
+                parsed: {},
+                isComplete: false,
+                caveat: "Decoded output is structural. Packet is the canonical record.",
+            };
+        }
+        const fields = packet.trim().split("|");
+        const task = fields[0]?.trim() ?? "";
+        const dom = fields[1]?.trim() ?? "";
+        const named = {};
+        for (const f of fields.slice(2)) {
+            const trimmed = f.trim();
+            if (!trimmed)
+                continue;
+            const colonIdx = trimmed.indexOf(":");
+            if (colonIdx !== -1) {
+                const key = trimmed.slice(0, colonIdx).toLowerCase();
+                const val = trimmed.slice(colonIdx + 1);
+                named[key] = val;
+            }
+        }
+        const verb = TASK_VERBS[task] ?? task.toLowerCase();
+        const domainName = DOMAIN_NAMES[dom] ?? dom;
+        const returnTo = named["return"] ?? "unknown agent";
+        const priority = named["p"] ?? "2";
+        const priorityLabel = priority === "1" ? "critical priority"
+            : priority === "3" ? "low priority"
+                : "standard priority";
+        const parts = [];
+        // Core action
+        const res = named["res"];
+        if (res) {
+            parts.push(`${verb} ${res.replace(/_/g, " ")} from the ${domainName} domain`);
+        }
+        else {
+            parts.push(`${verb} in the ${domainName} domain`);
+        }
+        // Time period
+        if (named["period"])
+            parts.push(`for period ${named["period"]}`);
+        // Filter
+        if (named["filter"])
+            parts.push(`filtered to ${named["filter"].replace(/=/g, ": ").replace(/_/g, " ")}`);
+        // Format
+        if (named["fmt"])
+            parts.push(`return as ${named["fmt"].toUpperCase()}`);
+        // Rules
+        if (named["rules"])
+            parts.push(`using rules ${named["rules"]}`);
+        // Validate
+        if (named["validate"])
+            parts.push(`validate against ${named["validate"].replace(/_/g, " ")}`);
+        // Flags
+        if (named["flags"])
+            parts.push(`flag: ${named["flags"].replace(/,/g, ", ")}`);
+        // Highlight
+        if (named["highlight"])
+            parts.push(`highlight: ${named["highlight"].replace(/_/g, " ")}`);
+        // Risk
+        if (named["risk"])
+            parts.push(`risk level: ${named["risk"]}`);
+        // Amount
+        if (named["amt"]) {
+            const ccy = named["ccy"] ?? "";
+            parts.push(`amount: ${ccy} ${named["amt"]}`.trim());
+        }
+        // Recipient
+        if (named["to"])
+            parts.push(`send to: ${named["to"].replace(/,/g, ", ")}`);
+        // Actor / chain
+        if (named["actor"])
+            parts.push(`initiated by ${named["actor"]}`);
+        if (named["chain"])
+            parts.push(`agent chain: ${named["chain"].replace(/,/g, " → ")}`);
+        // Routing
+        parts.push(`return result to ${returnTo} (${priorityLabel})`);
+        const english = parts.join(", ") + ".";
+        return {
+            english,
+            parsed: { task, domain: dom, ...named },
+            isComplete: true,
+            caveat: "Decoded output is structural. Packet is the canonical record.",
+        };
+    }
+}
+exports.AACPDecoder = AACPDecoder;
+//# sourceMappingURL=decoder.js.map

package/dist/decoder.js.map

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

package/dist/encoders/ruleBasedEncoder.d.ts

@@ -0,0 +1,12 @@
+/**
+ * AACP v1.1 Rule-Based Encoder
+ * Deterministic, zero-cost encoding for structured input.
+ * Everything except TASK and DOM is a named key:value pair.
+ * No empty positional slots. No LLM calls.
+ */
+import { EncodeParams, EncodedPacket } from "../schema";
+export declare class RuleBasedEncoder {
+    private validator;
+    encode(params: EncodeParams): EncodedPacket;
+}
+//# sourceMappingURL=ruleBasedEncoder.d.ts.map

package/dist/encoders/ruleBasedEncoder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ruleBasedEncoder.d.ts","sourceRoot":"","sources":["../../Src/encoders/ruleBasedEncoder.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAgB,YAAY,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAqCtE,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,SAAS,CAAuB;IAExC,MAAM,CAAC,MAAM,EAAE,YAAY,GAAG,aAAa;CA4F5C"}

package/dist/encoders/ruleBasedEncoder.js

@@ -0,0 +1,113 @@
+"use strict";
+/**
+ * AACP v1.1 Rule-Based Encoder
+ * Deterministic, zero-cost encoding for structured input.
+ * Everything except TASK and DOM is a named key:value pair.
+ * No empty positional slots. No LLM calls.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RuleBasedEncoder = void 0;
+const schema_1 = require("../schema");
+const validator_1 = require("../validator");
+class EncodedPacketImpl {
+    constructor(packet, domain, task, tokenEstimateEnglish, tokenEstimatePacket, compressionLoss, lossNote, aacpVersion, encoderType, apiCostUsd) {
+        this.packet = packet;
+        this.domain = domain;
+        this.task = task;
+        this.tokenEstimateEnglish = tokenEstimateEnglish;
+        this.tokenEstimatePacket = tokenEstimatePacket;
+        this.compressionLoss = compressionLoss;
+        this.lossNote = lossNote;
+        this.aacpVersion = aacpVersion;
+        this.encoderType = encoderType;
+        this.apiCostUsd = apiCostUsd;
+    }
+    get compressionRatio() {
+        if (this.tokenEstimateEnglish === 0)
+            return 0;
+        return 1 - this.tokenEstimatePacket / this.tokenEstimateEnglish;
+    }
+    get reductionPct() {
+        return `${(this.compressionRatio * 100).toFixed(1)}%`;
+    }
+    summary() {
+        return [
+            `PACKET [${this.domain}/${this.task}]`,
+            `  Encoder: ${this.encoderType}  Cost: $${this.apiCostUsd.toFixed(4)}`,
+            `  Loss:    ${this.compressionLoss}`,
+            "",
+            this.packet,
+        ].join("\n");
+    }
+}
+class RuleBasedEncoder {
+    constructor() {
+        this.validator = new validator_1.AACPValidator();
+    }
+    encode(params) {
+        const { task, domain, returnAgent, priority = "2", res, period, filterExpr, fields, fmt, src, srcPrev, rules, validate, template, dataPtr, amt, ccy, supplier, match, terms, docType, party, clause, issue, risk, block, flags, flagsInherit, req, highlight, status, to, subj, att, flagMsg, tone, sentiment, actor, chain, prog, ltv, loyalty, urgency, } = params;
+        // Core: TASK and DOM positional, everything else named
+        const parts = [
+            task.toUpperCase(),
+            domain.toUpperCase(),
+            `return:${returnAgent}`,
+            `p:${priority}`,
+            `aacp:${schema_1.AACP_VERSION}`,
+        ];
+        const add = (key, val) => {
+            if (val !== null && val !== undefined && String(val).trim() !== "") {
+                parts.push(`${key}:${val}`);
+            }
+        };
+        add("res", res);
+        add("period", period);
+        add("filter", filterExpr);
+        add("fields", fields?.join(","));
+        add("fmt", fmt);
+        add("src", src?.join(","));
+        add("src_prev", srcPrev);
+        add("rules", rules);
+        add("validate", validate);
+        add("tmpl", template);
+        add("data_ptr", dataPtr);
+        add("amt", amt !== undefined ? String(amt) : undefined);
+        add("ccy", ccy?.toUpperCase());
+        add("sup", supplier?.replace(/ /g, "-"));
+        add("match", match);
+        add("terms", terms);
+        add("type", docType?.toUpperCase());
+        add("party", party?.replace(/ /g, "-"));
+        add("clause", clause);
+        add("issue", issue?.replace(/ /g, "_").toLowerCase());
+        add("risk", risk?.toLowerCase());
+        add("block", block);
+        add("flags", flags?.join(","));
+        add("flags_inherit", flagsInherit?.join(","));
+        add("req", req?.join(","));
+        add("highlight", highlight);
+        add("status", status);
+        add("to", to?.join(","));
+        add("subj", subj?.replace(/ /g, "_"));
+        add("att", att);
+        add("flag_msg", flagMsg?.replace(/ /g, "_"));
+        add("sentiment", sentiment?.toLowerCase());
+        add("tone", tone?.toLowerCase());
+        add("prog", prog !== undefined ? prog.toFixed(2) : undefined);
+        add("actor", actor);
+        add("chain", chain?.join(","));
+        add("ltv", ltv !== undefined ? String(ltv) : undefined);
+        add("loyalty", loyalty);
+        add("urgency", urgency?.toLowerCase());
+        const packet = parts.join("|");
+        const validation = this.validator.validate(packet);
+        if (!validation.valid) {
+            throw new Error(`Rule-based encoder produced invalid packet:\n` +
+                validation.errors.join("\n") + "\n" + packet);
+        }
+        const tokenEstimatePacket = Math.max(1, Math.floor(packet.length / 4));
+        const tokenEstimateEnglish = 15 + parts.length * 8;
+        return new EncodedPacketImpl(packet, domain.toUpperCase(), task.toUpperCase(), tokenEstimateEnglish, tokenEstimatePacket, "none", null, schema_1.AACP_VERSION, "rule_based", 0.0);
+    }
+}
+exports.RuleBasedEncoder = RuleBasedEncoder;
+//# sourceMappingURL=ruleBasedEncoder.js.map

package/dist/encoders/ruleBasedEncoder.js.map

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

package/dist/encoders/workflows/contractEncoder.d.ts

@@ -0,0 +1,13 @@
+/**
+ * AACP v1.1 Contract Review Workflow Encoder
+ * Zero-cost deterministic encoding for legal contract review workflows.
+ */
+import { EncodedPacket } from "../../schema";
+export declare class ContractEncoder {
+    private enc;
+    flagClause(docType: string, party: string, clause: string, issue: string, risk: "low" | "medium" | "high" | "critical", blockAction?: string, returnAgent?: string, priority?: string): EncodedPacket;
+    reviewContract(docType: string, party: string, rules: string, returnAgent?: string, priority?: string): EncodedPacket;
+    logReview(docType: string, party: string, status: string, returnAgent?: string, priority?: string): EncodedPacket;
+    fullReview(docType: string, party: string, rules: string): EncodedPacket[];
+}
+//# sourceMappingURL=contractEncoder.d.ts.map