anglesvideo-dsh-plugin

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:

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:

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:

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:

- 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