@aifred/dsh-task-ledger

Readme

# Aifred DSH Task Ledger

Provider-neutral task lifecycle tools for DeepSeek Harness. The plugin can run independently with a local appendable JSON ledger, or connect to an Aifred-compatible bridge by setting `AIFRED_TASK_LEDGER_MODE=bridge` and `AIFRED_BRIDGE_URL`.

## Tools

- `aifred_task_create`
- `aifred_task_get`
- `aifred_task_list`
- `aifred_task_cancel`
- `aifred_task_resume`
- `aifred_task_event`

The plugin does not send messages, write family data, control devices, or bypass approvals. Aifred/Fubo remains the source of truth when bridge mode is enabled. Event IDs are idempotency keys; cancelled tasks must reject late results.

## Install

```text
dsh plugin --profile headless add github:qiaoji1990-alt/aifred-dsh-task-ledger
```

After an npm release, the package form will also be available:

```text
dsh plugin --profile headless add @aifred/dsh-task-ledger
```

## Aifred mode

```text
AIFRED_TASK_LEDGER_MODE=bridge
AIFRED_BRIDGE_URL=http://127.0.0.1:3888
AIFRED_BRIDGE_TOKEN=<token>
```

The bridge endpoint is `/api/aifred-bridge/tasks`. It is intentionally a separate optional integration surface so the plugin remains useful without Aifred.