JavaScript SDK

JavaScript SDK

The package can be used from JavaScript and TypeScript without running the CLI.

All public SDK calls return JSON-serializable objects.

Root Import

import {
  a2aTaskHandoffReport,
  buildPhaseAccelerationPlan,
  buildRuntimeStep,
  mcpToolDescriptorReport,
  mcpToolInvocationPreflight,
  operationGateReport,
  phaseAccelerationCompactPayload,
  phaseAccelerationReport,
  runAgentCheck,
  schemaByType,
  targetValidityCheck,
  validateData,
} from "percolation-inversion-compiler-ts";

Compact Agent Check

import { runAgentCheck } from "percolation-inversion-compiler-ts";

const report = runAgentCheck(
  { agent_output: "Candidate packet: preserve residuals." },
  true,
);

console.log(report.accepted);
console.log(report.workflow_usable);
console.log(report.settled);

Do not treat accepted=true or workflow_usable=true as settlement. Read settled, missing_obligations, and residual fields.

CARA Phase Acceleration

import {
  phaseAccelerationReport,
  targetValidityCheck,
} from "percolation-inversion-compiler-ts";

const target = targetValidityCheck({
  target_id: "target:demo",
  capability_basis: ["capability:x"],
  target_set: { thresholds: { "coord:x": 1 } },
  mission_law: { status: "accepted" },
  generated_law: { status: "accepted" },
  externality_law: { status: "accepted" },
  hazard_envelope: { status: "accepted" },
  authority_envelope: { status: "approved" },
  capability_envelope: { status: "accepted" },
  viability_set: { status: "accepted" },
  raw_net_capital_floor: 0,
  horizon: "P7D",
  target_validity_certificate_ref: "tvc:demo",
  baseline_upper_envelope_ref: "baseline:demo",
});

console.log(target.ok);

certified_acceleration_candidate=true is a scoped comparison result, not real ASI proof.

MCP And A2A

import {
  a2aTaskHandoffReport,
  mcpToolDescriptorReport,
  mcpToolInvocationPreflight,
} from "percolation-inversion-compiler-ts";

These helpers check candidate evidence. They do not dispatch tools or delegate authority.

TRC Operation Gate

import {
  operationGateReport,
  traceNormalFormReport,
} from "percolation-inversion-compiler-ts";

operation_ready=true is readiness over a trace record. It is not execution.

CCR Interop Subpath

import {
  ccrResidualsFromPhasePlan,
  ccrTasksFromPhasePlan,
  phaseResponseControlStep,
  traceCheckReport,
  traceNormalFormReport,
  tracePacketCandidate,
} from "percolation-inversion-compiler-ts/interop/ccr";

These helpers are data-only. They preserve residuals and candidate status for downstream scheduling.