# runtimeuse

> AI agent runtime with WebSocket protocol, artifact handling, and secret management

- **URL**: https://www.freshcrate.ai/projects/runtimeuse
- **Author**: getlark-founders
- **Category**: Security
- **Latest version**: `0.15.1` (2026-05-01)
- **License**: non-standard
- **Source**: https://github.com/getlark/runtimeuse
- **Language**: Python
- **GitHub**: 8 stars, 1 forks
- **Registry**: npm (`runtimeuse`)
- **Tags**: `agent`, `ai`, `claude`, `npm`, `openai`, `runtime`, `sandbox`, `websocket`

## Description

AI agent runtime with WebSocket protocol, artifact handling, and secret management

## Recent releases

| Version | Date | Urgency | Changes |
| --- | --- | --- | --- |
| `0.15.1` | 2026-05-01 | High | ## What's Changed * Honor configured logger across the request lifecycle by @jackcbrown89 in https://github.com/getlark/runtimeuse/pull/40   **Full Changelog**: https://github.com/getlark/runtimeuse/compare/0.15.0...0.15.1 |
| `0.14.0` | 2026-04-26 | High | ## What's Changed * Document persistent sessions and command stdout by @jackcbrown89 in https://github.com/getlark/runtimeuse/pull/33 * Tag command stdout/stderr as command_output_message by @jackcbrown89 in https://github.com/getlark/runtimeuse/pull/36   **Full Changelog**: https://github.com/getlark/runtimeuse/compare/0.13.0...0.14.0 |
| `0.13.0` | 2026-04-21 | Low | Imported from npm (0.13.0) |
| `0.12.0` | 2026-04-19 | High | ## What's Changed * Add stdout to command execution results by @vijit-lark in https://github.com/getlark/runtimeuse/pull/32   **Full Changelog**: https://github.com/getlark/runtimeuse/compare/0.11.1...0.12.0 |
| `0.11.1` | 2026-04-17 | High | ## What's Changed * Drain artifact watcher before closing WS on end_session_message by @jackcbrown89 in https://github.com/getlark/runtimeuse/pull/29   **Full Changelog**: https://github.com/getlark/runtimeuse/compare/0.11.0...0.11.1 |
| `0.11.0` | 2026-04-17 | High | ## What's Changed * Fix delayed cancellation message by @jackcbrown89 in https://github.com/getlark/runtimeuse/pull/27 * Add persistent session support by @jackcbrown89 in https://github.com/getlark/runtimeuse/pull/28   **Full Changelog**: https://github.com/getlark/runtimeuse/compare/0.10.0...0.11.0 |
| `0.10.0` | 2026-04-14 | Medium | ## Changes  ### Command failure handling Non-zero exit codes from command execution are now returned in the result rather than raising an error. When a command in a batch fails, remaining commands are skipped and only executed commands appear in the result.  ### Unexpected disconnect warnings WebSocket sessions now log a warning when the connection closes unexpectedly (before finalization or cancellation), including the close code and reason. This helps diagnose cases where artifacts may n |
| `0.9.1` | 2026-04-14 | Medium | ## What's Changed * update docs for 0.9.0 by @jackcbrown89 in https://github.com/getlark/runtimeuse/pull/22 * fix redactSecrets stack overflow on circular references by @jackcbrown89 in https://github.com/getlark/runtimeuse/pull/23 * bump version (0.9.1) by @jackcbrown89 in https://github.com/getlark/runtimeuse/pull/24   **Full Changelog**: https://github.com/getlark/runtimeuse/compare/0.9.0...0.9.1 |
| `0.9.0` | 2026-04-13 | Medium | ## What's Changed * add `env` param to command type by @jackcbrown89 in https://github.com/getlark/runtimeuse/pull/20 * bump versions - 0.9.0 by @jackcbrown89 in https://github.com/getlark/runtimeuse/pull/21   **Full Changelog**: https://github.com/getlark/runtimeuse/compare/0.8.0...0.9.0 |
| `0.8.0` | 2026-04-12 | Medium | ## What's New  **`execute_commands()`** — Run shell commands in the sandbox without invoking the agent. Returns per-command exit codes with the same streaming, cancellation, timeout, secret redaction, and artifact upload support as `query()`.  ```python result = await client.execute_commands(     commands=[         CommandInterface(command="mkdir -p /app/output"),         CommandInterface(command="echo 'sandbox is ready' > /app/output/status.txt"),     ],     options=ExecuteCommandsOpt |

## Citation

- HTML: https://www.freshcrate.ai/projects/runtimeuse
- Markdown: https://www.freshcrate.ai/projects/runtimeuse.md
- Dependencies JSON: https://www.freshcrate.ai/api/projects/runtimeuse/deps

_Generated by freshcrate.ai. Indexes npm releases for AI-agent ecosystem packages._