Use Cases

Use Cases

Use percolation-inversion-compiler-ts when AI agent output should be checked before it is reused, routed, merged, sent to another agent, or treated as complete.

LLM Output Checking

Run a compact check before reusing a generated answer:

npx pic-ts agent check --compact --text "Candidate packet: preserve residuals." --profile development

This gives a JSON report that shows whether the output is accepted and what remains unresolved.

Node.js Agent Runtime

Use the SDK inside an agent loop:

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

const report = runAgentCheck({ agent_output: draftText }, true);

CI Report Artifact

Save a JSON report from a build job:

npx pic-ts agent check --compact --text "Candidate packet: preserve residuals." --output agent-check.json

Upload agent-check.json as an artifact.

Packet Exchange

Export runtime output as a packet file and inspect it without executing content.

npx pic-ts packet export --report runtime-report.json --output packet.json
npx pic-ts packet inspect --packet packet.json

Phase Planning

Ask for the next finite workflow plan:

npx pic-ts phase plan --compact --text "Candidate packet: preserve residuals." --profile development

Phase planning is recommendation-only. It does not execute commands.

Search-Friendly Summary

Common uses include AI agent output checking, LLM output validation, JSON schema validation, workflow report generation, residual ledger preservation, missing obligation tracking, packet inspection, Node.js agent runtime integration, and Python-compatible PIC reports.