@botfather/units-agent-plugin

Agent-facing compression plugin that turns raw UI trees into compact Units DSL context.

Install

npm install @botfather/units-agent-plugin

Usage

import { compressUiForAgent } from "@botfather/units-agent-plugin";

const result = await compressUiForAgent(uiTree, {
  sourceType: "dom", // also supports "a11y", "ir", "react", and "slack"
  target: "planner",
  maxTokens: 600,
  pluginConfig: {
    libraryDir: ".units/library",
  },
});

console.log(result.dsl);
console.log(result.unitsAst);
console.log(result.programId);

For Slack Block Kit, pass the message payload or blocks array with sourceType: "slack" (aliases: block-kit, blockkit, mrkdwn). Slack mrkdwn is normalized before transform and compile.

Compiler output is token-optimized by default (implicit role actions and redundant leaf name/text duplicates are omitted unless explicitly requested in compiler options). The middleware agent_tree payload also deduplicates redundant name/text pairs, omits role-implicit actions, prunes empty text leaves, and omits text-node ids by default.

Returns:

• dsl: compressed Units source text
• unitsAst: parsed Units AST
• programId: selected transform program id (or null)
• tokenEstimate: rough token estimate for the generated DSL
• rewrite and compile: full debug payloads from middleware + compiler

Exports

• createUnitsAgentPlugin(config)
• compressUiForAgent(uiTree, options)