anglesvideo-dsh-plugin

Readme

# Angles for DeepSeek Harness

An open-source DeepSeek Harness bundle for turning safe software repository context into reviewable Angles launch-video concepts.

This package is an early integration for the DeepSeek Harness developer preview. The DSH runtime can change compatibility contracts; pin the plugin version and the DSH version used in production.

## What it does

The plugin registers these tools:

- `angles_inspect_repository` reads an allowlist of product-facing files locally and returns a bounded context summary.
- `angles_create_launch_concepts` sends a structured product brief to Angles and returns three concepts.
- `angles_list_templates` lists templates and media requirements.
- `angles_preview_launch_render` checks blockers and warnings without consuming a render allowance.
- `angles_upload_launch_asset` uploads one user-selected screenshot or clip.
- `angles_render_launch_video` starts a render only when `confirmed` is `true`.
- `angles_get_video_status` returns render progress and the final video or editor URL.

The plugin does not upload a raw repository. It skips dotfiles, common build directories, sensitive path names, and lines that look like credentials. Review the returned context before creating concepts.

## Requirements

- Node.js 22.19 or newer
- DeepSeek Harness developer preview
- An Angles API key with the capabilities required by the tool you call

Set the key in the environment used to start DSH:

```sh
export ANGLES_API_KEY="your-angles-api-key"
```

Create an API key from Angles Integrations. Do not commit it to `cordis.yml`, a repository, or a prompt.

## Install from the public repository

The repository is public, but it is still in early development. Pin a commit when installing from GitHub:

```sh
dsh plugin --profile demo add github:anglesvideo/anglesvideo-dsh-plugin#<commit-sha>
dsh --profile demo web
```

GitHub installs may ask pnpm to allow the package build step. That is expected for a TypeScript source install; inspect the package source before approving it. An npm distribution will be added after the first compatibility smoke test.

For local development:

```sh
git clone https://github.com/anglesvideo/anglesvideo-dsh-plugin.git
cd anglesvideo-dsh-plugin
npm install
npm run build
dsh plugin --profile demo add .
```

## Recommended workflow

1. Ask DSH to call `angles_inspect_repository`.
2. Review the file list and context summary.
3. Ask DSH to produce a concise product brief from that summary.
4. Call `angles_create_launch_concepts` and review all three concepts.
5. Choose a concept and compatible template.
6. Call `angles_preview_launch_render` and review blockers, warnings, and media usage.
7. Ask the user for explicit confirmation before rendering.
8. Pass uploaded asset URLs as the `mediaAssets` JSON argument when needed, then call `angles_render_launch_video` with `confirmed: true`.
9. Poll with `angles_get_video_status` until the final URL is available.

The render tool rejects `confirmed: false` and the API also requires an idempotency key. A render consumes the Angles allowance only when the render request is accepted.

## Configuration

The bundle accepts these optional fields in a profile patch:

```yaml
- insert:
    - id: anglesvideo-dsh-plugin
      name: anglesvideo-dsh-plugin
      config:
        apiBaseUrl: https://api.angles.video/api/developer/v1
        workspaceRoot: /absolute/path/to/your/project
```

Prefer `ANGLES_API_KEY` in the process environment. `apiKey` is supported for local experiments but should not be committed.

## Status

Developer preview. The first public version is intentionally small: it uses the Angles Developer API and does not include a custom DSH panel or an embedded video editor.

## License

MIT