Files

hzhang c5593e3961 initial drop: Dialectic.PlexumPlugin v0.1

Port of Dialectic.OpenclawPlugin to the Plexum SDK. 8 dialectic_*
tools wired to Dialectic.Backend over HTTP:

  list_topics, topic_detail, list_arguments, propose_topic,
  signup, post_argument, submit_verdict, view_verdict

Differences from the OpenClaw port worth noting:

  - Per-agent API key storage: OpenClaw used secret-mgr (one entry
    per agent's keyspace). Plexum has no secret-mgr; v1 stores
    keys directly in plugin config (apiKey + agentKeys map).

  - Agent identity at tool dispatch: OpenClaw framework surfaces
    ctx.agentId; Plexum SDK doesn't yet plumb the calling agent
    through ToolPlugin.CallTool. v1 falls back to
    config.defaultAgentID — same stop-gap HarborForge.PlexumPlugin
    is on. Tracked as upstream SDK work.

  - HF on_call coverage pre-check on signup: stub that always
    returns "skipped", matching OpenClaw v1's behavior (HarborForge
    never shipped the cross-plugin coverage query). pre_validated
    is sent as false so the backend records audit honestly.
    DIALECTIC_PLUGIN_BYPASS_HF=1 env retains parity with OpenClaw.

  - Activation: lazy (no background services, unlike HarborForge's
    eager-spawn for the calendar scheduler + monitor bridge).

Backend client follows the bearer-auth contract OpenClaw's
backend-client.ts established; endpoint shapes are unchanged.

2026-06-03 11:57:24 +01:00

3.9 KiB

Raw Blame History

Dialectic.PlexumPlugin

Plexum plugin that gives agents tools to participate in Dialectic v2 debates. Ports Dialectic.OpenclawPlugin to the Plexum SDK.

Eight tools, one per Dialectic backend endpoint:

Tool	Backend call	Notes
`dialectic_list_topics`	`GET /api/topics`	filters: status/visibility/limit/offset
`dialectic_topic_detail`	`GET /api/topics/{id}`	lifecycle + camps + verdict pointer
`dialectic_list_arguments`	`GET /api/topics/{id}/arguments`	full transcript
`dialectic_propose_topic`	`POST /api/topics`	4 lifecycle timestamps + verdict schema
`dialectic_signup`	`POST /api/topics/{id}/signups`	with HF on_call coverage pre-check
`dialectic_post_argument`	`POST /api/topics/{id}/arguments`	during `debating` only
`dialectic_submit_verdict`	`POST /api/topics/{id}/verdict`	judge submits structured verdict
`dialectic_view_verdict`	`GET /api/topics/{id}/verdict`	404 until judge submits

Install

make install

Then add "dialectic" to ~/.plexum/plexum.json .plugins.allow and write ~/.plexum/plugins/dialectic/config.json:

{
  "backendUrl": "https://dialectic-api.hangman-lab.top",
  "apiKey": "g1_xxx",
  "defaultAgentID": "agent-xyz"
}

Multi-agent claws can use agentKeys instead of (or in addition to) apiKey:

{
  "backendUrl": "https://dialectic-api.hangman-lab.top",
  "agentKeys": {
    "agent-a": "g1_aaa",
    "agent-b": "g1_bbb"
  },
  "apiKey": "g1_default_fallback",
  "defaultAgentID": "agent-a"
}

Restart the host afterwards: systemctl --user restart plexum.

Config

Field	Default	Purpose
`backendUrl`	`https://dialectic-api.hangman-lab.top`	Dialectic API base. Env override: `DIALECTIC_BACKEND_URL`.
`apiKey`	—	Default bearer token.
`agentKeys`	`{}`	Per-agent bearer token overrides.
`defaultAgentID`	—	Agent id reported to the backend when host hasn't surfaced one via tool ctx.

How agent identity is resolved (v1 limitation)

Dialectic.OpenclawPlugin got the calling agent's id via the OpenClaw framework's ctx.agentId. The Plexum SDK doesn't yet surface this on tool dispatch — same constraint HarborForge.PlexumPlugin hits. v1 falls back to config.defaultAgentID. Multi-agent claws can configure agentKeys but the bearer token used per call is selected against the config default (not the true caller), which is fine for a homogeneous- role claw but won't sort signed verdicts apart by agent.

The fix (deferred): plumb AgentContext through ToolPlugin.CallTool in Plexum-sdk-go. Once landed, swap AgentIDFromCtx to read it.

HF on_call coverage pre-check

dialectic_signup is supposed to verify the agent has an HarborForge on_call slot covering the debate window before submitting. Like the OpenClaw plugin's v1, this Plexum port currently degrades to source="skipped" (HarborForge.Backend exposes no window-coverage query yet). Signups go through with pre_validated=false so the backend records the gap honestly.

Override with DIALECTIC_PLUGIN_BYPASS_HF=1 in the host's environment to make the skip explicit (matches the OpenClaw plugin escape hatch).

Deferred items

Per-call agent id — see "How agent identity is resolved" above.
HF window-coverage check — needs a backend-side endpoint or a Plexum cross-plugin contract for harbor-forge to surface HasOnCallCovering(agentID, from, to).
SSE subscriptions — agents poll via dialectic_topic_detail to see status/argument changes. Once Dialectic.Backend ships SSE, add dialectic_subscribe.
Token-cost reporting — dialectic_submit_verdict already accepts tokens_input / tokens_output; wire automatic accounting once Plexum exposes per-turn usage telemetry through HostAPI.

3.9 KiB Raw Blame History