open-index/open-npm huggingface dataset:
npm package: @sisu-ai/protocol
Description: Shared desktop runtime protocol contracts for TypeScript and generated client models.
Latest version: 0.2.0

# @sisu-ai/protocol

Shared desktop runtime protocol contracts for TypeScript and generated client models.

Exports include:

- Runtime health and dependency schemas
- Provider/model catalog schemas
- Chat generation, stream event, status, and cancellation schemas
- Conversation/thread/search/branch request-response schemas
- Default and per-thread model selection schemas
- Error envelope schema and parse helpers

## Development

```bash
pnpm --filter @sisu-ai/protocol build
pnpm --filter @sisu-ai/protocol lint
pnpm vitest run packages/protocol/test/protocol.test.ts
```

## Protocol version

Current protocol marker:

`PROTOCOL_VERSION = "2026-03-29"`

## Swift generation guidance

The schema names and TypeScript types in `src/index.ts` are the canonical source.
Swift models should map 1:1 to the exported schema payload fields.
npm package: @sisu-ai/runtime-desktop
Description: Desktop runtime for Sisu apps.
Latest version: 0.2.4

# @sisu-ai/runtime-desktop

Desktop runtime for Sisu apps.

This package provides:

- Runtime controller lifecycle (`starting`, `ready`, `degraded`, `stopped`)
- Localhost-only HTTP API server for desktop clients
- Streaming chat events (`message.started`, `token.delta`, terminal events)
- Provider/model catalog with OpenAI, Anthropic, and Ollama factory helpers
- Conversation persistence/search/branching (default in-memory implementation)

## Development

```bash
pnpm --filter @sisu-ai/runtime-desktop build
pnpm --filter @sisu-ai/runtime-desktop lint
pnpm vitest run packages/runtime-desktop/test/runtime-desktop.test.ts
```

## Run local desktop runtime

```bash
RUNTIME_HOST=127.0.0.1 \
RUNTIME_PORT=8787 \
OPENAI_API_KEY=... \
ANTHROPIC_API_KEY=... \
sisu-runtime-desktop
```

Optional variables:

- `RUNTIME_API_KEY` (Bearer token required by HTTP server when set)
- `OPENAI_BASE_URL`, `ANTHROPIC_BASE_URL`, `OLLAMA_BASE_URL`

## HTTP endpoints

- `GET /health`
- `GET /providers`
- `GET /threads`
- `POST /threads`
- `GET /threads/:threadId`
- `POST /threads/:threadId/override-model`
- `GET /search?query=...`
- `POST /threads/branch`
- `POST /chat/generate`
- `GET /streams/:streamId/events` (SSE)
- `GET /streams/:streamId/status`
- `POST /streams/:streamId/cancel`

All endpoints are loopback-restricted (`127.0.0.1` / `::1`).
npm package: @sisu-ai/skill-install
Description: Install the `sisu-framework` skill into supported agent environments from a single CLI.
Latest version: 0.4.0

# `@sisu-ai/skill-install`

Install the `sisu-framework` skill into supported agent environments from a single CLI.

[![Tests](https://github.com/finger-gun/sisu/actions/workflows/tests.yml/badge.svg?branch=main)](https://github.com/finger-gun/sisu/actions/workflows/tests.yml)
[![CodeQL](https://github.com/finger-gun/sisu/actions/workflows/github-code-scanning/codeql/badge.svg)](https://github.com/finger-gun/sisu/actions/workflows/github-code-scanning/codeql)
[![License](https://img.shields.io/badge/license-Apache--2.0-blue)](https://github.com/finger-gun/sisu/blob/main/LICENSE)
[![Downloads](https://img.shields.io/npm/dm/%40sisu-ai%2Fskill-install)](https://www.npmjs.com/package/@sisu-ai/skill-install)
[![PRs Welcome](https://img.shields.io/badge/PRs-welcome-brightgreen.svg)](https://github.com/finger-gun/sisu/blob/main/CONTRIBUTING.md)

## Usage

```bash
npx @sisu-ai/skill-install
```

After global install, you can also run:

```bash
sisu-skill-install
```

Interactive targets include:

- Claude Code / Claude Desktop
- Cline
- Roo Code
- Windsurf
- Kilo Code
- Codex CLI
- GitHub Copilot

## Flags

```bash
npx @sisu-ai/skill-install --target codex --scope workspace --yes
npx @sisu-ai/skill-install --target copilot --dir /path/to/project --scope custom --yes
npx @sisu-ai/skill-install --list
```

## What It Installs

- Native skill platforms receive a copied `sisu-framework` skill directory.
- Codex installs the skill under `.sisu/skills/sisu-framework` and adds a managed section to `AGENTS.md`.
- Copilot installs the skill under `.sisu/skills/sisu-framework` and adds a managed section to `.github/copilot-instructions.md`.

---

## Contributing

We build Sisu in the open. Contributions welcome.

[Contributing Guide](CONTRIBUTING.md) · [Report a Bug](https://github.com/finger-gun/sisu/issues/new?template=bug_report.md) · [Request a Feature](https://github.com/finger-gun/sisu/issues/new?template=feature_request.md) · [Code of Conduct](CODE_OF_CONDUCT.md)

<details>
<summary>All skill packages</summary>

- [@sisu-ai/skill-code-review](packages/skills/skill-code-review/README.md)
- [@sisu-ai/skill-debug](packages/skills/skill-debug/README.md)
- [@sisu-ai/skill-deploy](packages/skills/skill-deploy/README.md)
- [@sisu-ai/skill-explain](packages/skills/skill-explain/README.md)
- [@sisu-ai/skill-repo-search](packages/skills/skill-repo-search/README.md)
- [@sisu-ai/skill-test-gen](packages/skills/skill-test-gen/README.md)
- [@sisu-ai/skill-install](packages/skills/skill-install/README.md)
</details>

---

<div align="center">

**[Star on GitHub](https://github.com/finger-gun/sisu)** if Sisu helps you build better agents.

*Quiet, determined, relentlessly useful.*

[Apache 2.0 License](LICENSE)

</div>