{"_id":"@alib8b8/dsh-plugin-aflare","name":"@alib8b8/dsh-plugin-aflare","dist-tags":{"latest":"0.1.0"},"versions":{"0.1.0":{"name":"@alib8b8/dsh-plugin-aflare","version":"0.1.0","description":"DeepSeek Harness (DSH) Cordis plugin exposing aflare workflow tools","license":"AGPL-3.0-or-later","type":"module","main":"dist/index.js","types":"dist/index.d.ts","dsh":{"bundle":{"patch":"./cordis.patch.yml"}},"scripts":{"build":"tsc -p tsconfig.json","typecheck":"tsc -p tsconfig.json --noEmit","test":"tsc -p tsconfig.json && node --test dist/*.test.js","prepublishOnly":"npm run typecheck && npm test"},"keywords":["deepseek-harness","dsh-plugin","cordis","aflare","workflow","mcp"],"engines":{"node":">=22.19.0"},"peerDependencies":{"@deepseek-ai/cordis":"*","@deepseek-ai/dsh-tools":"*"},"repository":{"type":"git","url":"git+https://github.com/alib8b8/aflare.git","directory":"integrations/dsh-plugin"},"devDependencies":{"@types/node":"^26.2.0","typescript":"^5.9.3"},"_id":"@alib8b8/dsh-plugin-aflare@0.1.0","gitHead":"1a5a9f630495535cd011ddf4c069d23657dbd0e9","bugs":{"url":"https://github.com/alib8b8/aflare/issues"},"homepage":"https://github.com/alib8b8/aflare#readme","_nodeVersion":"24.1.0","_npmVersion":"11.4.2","dist":{"integrity":"sha512-AM0TRQySF1bfB5w2/oH02VvhN1vtp27RrKv4zNGGMkkZ0QWBUYklxc5Atc5rIwVTakEKTS+IqHFk0jwyOMMlUg==","shasum":"5b97c7d5a53009f3946eddd34acb937d7205db11","tarball":"https://registry.npmjs.org/@alib8b8/dsh-plugin-aflare/-/dsh-plugin-aflare-0.1.0.tgz","fileCount":6,"unpackedSize":10355,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEYCIQChGCuagKqObEfIUZYnKAf3Kmx4bwz2rvG2Mz2tr5a9AAIhAJfRUeDSUNWBkuK5pBjlsiRTM4PHjR4wPScwEGB9+LYr"}]},"_npmUser":{"name":"songcharlie","email":"SongCharlie@proton.me"},"directories":{},"maintainers":[{"name":"songcharlie","email":"SongCharlie@proton.me"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/dsh-plugin-aflare_0.1.0_1786797890997_0.5329158095456028"},"_hasShrinkwrap":false}},"time":{"created":"2026-08-15T12:44:50.913Z","0.1.0":"2026-08-15T12:44:51.136Z","modified":"2026-08-15T12:44:51.294Z"},"maintainers":[{"name":"songcharlie","email":"SongCharlie@proton.me"}],"description":"DeepSeek Harness (DSH) Cordis plugin exposing aflare workflow tools","homepage":"https://github.com/alib8b8/aflare#readme","keywords":["deepseek-harness","dsh-plugin","cordis","aflare","workflow","mcp"],"repository":{"type":"git","url":"git+https://github.com/alib8b8/aflare.git","directory":"integrations/dsh-plugin"},"bugs":{"url":"https://github.com/alib8b8/aflare/issues"},"license":"AGPL-3.0-or-later","readme":"# @alib8b8/dsh-plugin-aflare\n\n[DeepSeek Harness](https://github.com/deepseek-ai/deepseek-harness) (DSH)\nCordis plugin that exposes [aflare](https://github.com/alib8b8/aflare)\nworkflow tools as native DSH tools.\n\nEvery tool spawns the local `aflare` binary with `execFile` (no shell), so\nnothing leaves your machine — the same local-first guarantee aflare itself\nmakes.\n\n## Tools\n\n| Tool | What it does |\n|---|---|\n| `aflare_version` | Installed aflare version |\n| `aflare_generate` | Create workflow YAML from a description (optional `ai: true` for LLM generation) |\n| `aflare_validate` | Validate a workflow YAML |\n| `aflare_run` | Execute a workflow YAML and return the output |\n| `aflare_template_list` | List built-in templates |\n| `aflare_template_run` | Run a template by ID |\n\n## Install\n\n### Prerequisite: the aflare binary\n\nThe plugin drives the local `aflare` CLI, so install it first (one line; see\nthe [aflare README](https://github.com/alib8b8/aflare) for Windows/source\noptions):\n\n```bash\ncurl -fsSL https://raw.githubusercontent.com/alib8b8/aflare/main/install.sh | bash\naflare version   # sanity check\n```\n\n### One-line install into DSH (once published to npm)\n\n```bash\ndsh plugin --profile web add @alib8b8/dsh-plugin-aflare\n```\n\nThe package declares its bundle patch (`dsh.bundle.patch` in `package.json`),\nso DSH registers the plugin entry automatically — restart `dsh web` and the\n`aflare_*` tools are live. No profile editing needed.\n\n### From a local checkout (works today)\n\n```bash\ngit clone https://github.com/alib8b8/aflare\ncd aflare/integrations/dsh-plugin\nnpm install && npm run build\ndsh plugin --profile web add \"$PWD\"\n```\n\nOr register the built entry manually with a `cordis.yml` patch overlay\n(absolute path required):\n\n```yaml\n- insert:\n    - id: aflare-tools\n      name: /absolute/path/to/aflare/integrations/dsh-plugin/dist/index.js\n```\n\nStart DSH with the overlay:\n\n```bash\npnpm dsh web --patch ./aflare-patch.yml\n```\n\n## Configuration\n\n| Env var | Default | Description |\n|---|---|---|\n| `AFLARE_BIN` | `aflare` | Path to the aflare executable |\n| `AFLARE_TIMEOUT_MS` | `300000` | Per-invocation timeout (ms) |\n\n## Security\n\n- All invocations use `execFile` — arguments are passed as argv, never\n  through a shell, so tool parameters cannot inject commands.\n- Output is truncated at 256 KB to protect model context.\n- aflare's own protections (path validation, safe mode, policy engine) apply\n  to every run. Set `AFLARE_SAFE_MODE=1` in the DSH process environment for\n  untrusted workflows.\n\n## Development\n\n```bash\nnpm install\nnpm run typecheck   # strict TS check\nnpm test            # compiles, then runs integration tests via node --test\n```\n\nThe tests execute the real `aflare` binary, resolved from `AFLARE_BIN` or\nthe repo-root build output (`make build` in the repository root). Without a\nbinary, the registration checks still run and the binary tests skip.\n\n## License\n\nAGPL-3.0-or-later (same as the aflare project).\n","readmeFilename":"README.md","_rev":"1-465d00ec5ed9629eaf11bb0dd5e52b6a"}