@archships/dim-plugin-auto-compact

Official supported auto compaction plugin for dim-agent-sdk.

What it does

• listens to context.compact.before
• summarizes older history into one canonical compaction segment
• keeps full session.messages intact for UI and restore
• stores provenance in pluginState['auto-compact']

Requirements

• configure compaction.ownerPluginId: 'auto-compact'
• grant model permission to the plugin runtime

Usage

import { createAgent, createModel } from '@archships/dim-agent-sdk'
import { createAutoCompactPlugin } from '@archships/dim-plugin-auto-compact'

const agent = createAgent({
  model: createModel(adapter),
  plugins: [
    createAutoCompactPlugin({
      retainMessages: 6,
      compaction: {
        auto: true,
        prune: true,
        reserved: 10_000,
      },
    }),
  ],
  compaction: {
    maxInputTokens: 32_000,
    triggerRatio: 0.8,
    ownerPluginId: 'auto-compact',
  },
})

Notes

• summaryModel is optional; the plugin defaults to context.status.model
• summary failures are fail-open and fall back to context_compaction_required
• run pnpm run demo:auto-compact in the repo for the scripted walkthrough