pulse-coding-agent 0.1.0__py3-none-any.whl

pulse_coding_agent-0.1.0.dist-info/METADATA

@@ -0,0 +1,211 @@
+Metadata-Version: 2.5
+Name: pulse-coding-agent
+Version: 0.1.0
+Summary: Permissioned coding-agent CLI with durable planning and isolated execution.
+Project-URL: Homepage, https://github.com/Roastedpotato21/pulse
+Project-URL: Repository, https://github.com/Roastedpotato21/pulse
+Project-URL: Issues, https://github.com/Roastedpotato21/pulse/issues
+Project-URL: Changelog, https://github.com/Roastedpotato21/pulse/blob/master/CHANGELOG.md
+Project-URL: Security, https://github.com/Roastedpotato21/pulse/security/policy
+Keywords: ai,coding-agent,developer-tools,sandbox
+Classifier: Development Status :: 4 - Beta
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3 :: Only
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Software Development
+Requires-Python: <3.14,>=3.11
+Requires-Dist: httpx==0.28.1
+Requires-Dist: keyring==25.7.0
+Requires-Dist: openai==2.44.0
+Requires-Dist: prompt-toolkit==3.0.52
+Requires-Dist: python-dotenv==1.2.2
+Requires-Dist: rich==15.0.0
+Requires-Dist: typer==0.26.8
+Requires-Dist: websockets==16.1
+Description-Content-Type: text/markdown
+
+# Pulse
+
+Pulse is a permissioned coding-agent CLI for working on software repositories.
+It combines repository-aware planning, durable task state, explicit mutation
+controls, sandboxed command execution, provider routing, audit trails, and cost
+tracking in one Python package.
+
+> **Public beta — 0.1.0:** Pulse is supported for controlled, local,
+> single-user use. The remote worker and VS Code extension are included for
+> evaluation and development, but they are not supported as multi-tenant or
+> unattended production services.
+
+## Requirements
+
+- Python 3.11, 3.12, or 3.13
+- An API key for the model provider you choose
+- Docker or Podman for local isolated execution, or access to a configured
+  Pulse remote worker
+
+## Install
+
+Install the first beta from PyPI:
+
+```bash
+uv tool install pulse-coding-agent==0.1.0
+```
+
+Alternatively, use `pipx install pulse-coding-agent==0.1.0` or install it in a
+dedicated virtual environment with `pip`.
+
+## Quick start
+
+Run these commands from the repository you want Pulse to work on:
+
+```bash
+pulse login
+pulse doctor --production --target local
+pulse ask "Explain this repository and identify the highest-risk missing test"
+```
+
+After Google login, Pulse guides provider selection, model selection, and hidden
+BYOK entry. New provider keys are stored in the native OS credential vault.
+Credentials can also be supplied through environment variables such as `OPENAI_API_KEY`,
+`ANTHROPIC_API_KEY`, `GEMINI_API_KEY`, or `OPENROUTER_API_KEY`. Do not commit a
+populated `.env` file.
+
+To run commands without installing Docker on the client workstation, configure
+a remote worker:
+
+```text
+PULSE_REMOTE_URL=wss://sandbox.example.com
+PULSE_REMOTE_TOKEN=<random token of at least 32 characters>
+PULSE_TLS_CERT=/absolute/path/to/client.crt
+PULSE_TLS_KEY=/absolute/path/to/client.key
+PULSE_TLS_CA=/absolute/path/to/ca.crt
+```
+
+When those variables are set, Pulse tries the remote sandbox first and uses a
+local Docker/Podman engine only as a secure fallback. The remote worker host
+still requires Docker or Podman; execution never silently falls back to the
+client host.
+
+Before allowing mutations or shell execution, review the proposed operation and
+its permission prompt. Treat model output, tool arguments, and repository
+content as untrusted input.
+
+## What the beta includes
+
+- Repository indexing and context-aware conversations
+- Durable plans, tasks, sessions, episodic memory, and recovery state
+- Permission-gated file mutations with transactional rollback
+- Host, Docker, Podman, and authenticated remote sandbox backends
+- Filesystem, network, resource, timeout, and secret-redaction policies
+- Multi-provider model routing and usage/cost accounting
+- Loopback JSON-RPC integration through `pulse-rpc` or `pulse serve`
+- Production preflight checks, structured audit events, and correlation IDs
+
+The package installs three entry points:
+
+```text
+pulse          Interactive CLI
+pulse-rpc      Loopback JSON-RPC server
+pulse-remote   Evaluation-only remote sandbox worker
+```
+
+Use `pulse --help` for the current command surface and command-specific help.
+`pulse-rpc` and `pulse serve` require a strong `PULSE_RPC_TOKEN` bearer secret
+and must stay bound to loopback.
+
+### Interactive shell
+
+Run `pulse` without arguments for the responsive project shell. Natural-language
+input goes to the agent; prefix any regular CLI command with `/` to run it in the
+same session, such as `/status`, `/keys list`, or `/chat switch ID`. Completions
+appear as you type and are always generated from the public CLI parser.
+
+- `Tab` or `Ctrl-Space`: open/accept command completion
+- `Up`/`Down`: navigate history; `Ctrl-R`: search history
+- `Alt-Enter`: insert a newline; `Enter`: submit
+- `Ctrl-C`: clear the current input; on an empty prompt, exit
+- `/help`, `/clear`, and `/exit`: shell controls
+
+History is stored locally in the Git-ignored `.pulse/history` file.
+
+### Account and provider keys
+
+```bash
+pulse version
+pulse login
+pulse auth-status
+pulse whoami
+pulse logout
+pulse keys
+pulse keys list
+pulse keys set openai
+pulse keys rotate openai
+pulse keys remove openai
+```
+
+`pulse keys` opens the status and rotation manager. Set and rotate operations
+prompt with hidden input; provider keys are never accepted as command-line
+arguments or printed back to the terminal. New keys are stored in a
+workspace-scoped entry in the native OS credential vault. Existing `.env` keys
+remain readable for compatibility and are removed for that provider after a
+successful vault-backed set or rotation. Environment variables and external
+secret managers remain supported as fallback sources.
+
+## Supported boundary
+
+The 0.1.0 beta supports the local CLI and loopback RPC server for one trusted
+user on one workstation. Pulse does not claim a security boundary between
+mutually untrusted tenants. Do not expose `pulse-rpc` or `pulse-remote` directly
+to the public internet.
+
+The remote worker requires authenticated transport, durable configuration, and
+container isolation. It remains evaluation-only until tenant isolation,
+centralized observability, load testing, disaster-recovery exercises, and an
+independent security review are complete. The VS Code extension is source-only
+and is not part of the Python distribution.
+
+Pulse sends prompts and selected repository context to the configured model
+provider. Data handling therefore also depends on that provider's terms and
+settings. Pulse itself does not include product analytics or telemetry export
+in this beta.
+
+## Development
+
+Clone the repository and create the locked development environment:
+
+```bash
+uv sync --locked
+uv run pulse --help
+```
+
+Run the local quality gates:
+
+```bash
+uv run ruff check src tests scripts
+uv run mypy
+uv run pytest tests/ -k "not sandbox" --cov=pulse --cov-report=term-missing --cov-fail-under=54
+uv build
+uv run python scripts/verify_release_artifacts.py dist --expected-version 0.1.0
+```
+
+Docker security tests require a working Docker daemon and are enforced by the
+hosted release workflow. See [OPERATIONS.md](OPERATIONS.md) for release and
+rollback procedures.
+
+## Documentation
+
+- [Architecture](ARCHITECTURE.md)
+- [Operations and releases](OPERATIONS.md)
+- [Security policy](SECURITY.md)
+- [Sandbox security boundary](src/pulse/sandbox/SECURITY.md)
+- [Privacy policy](PRIVACY.md)
+- [Changelog](CHANGELOG.md)
+
+To report a vulnerability, use GitHub private vulnerability reporting instead
+of a public issue. General defects and beta feedback belong in the
+[issue tracker](https://github.com/Roastedpotato21/pulse/issues).

pulse_coding_agent-0.1.0.dist-info/RECORD

@@ -0,0 +1,104 @@
+pulse/__init__.py,sha256=QUq3h5ZAnqr2gOSyrD_rLEQTFWyjah9F-1V0NBwFWn8,71
+pulse/__main__.py,sha256=pyMEpUjzVL5u9IiVQ3LnNHh2GrRtNosr-42a6LQx4nM,66
+pulse/agent.py,sha256=ZzrCkoDSTq_LjFdl4eJibyze_I5BmuvKTLBj4yFXVgw,12652
+pulse/agent_manager.py,sha256=DQX2C4iLLaNGvH2sgQq1A1audUXUmBE9KFKtkGebLPU,13899
+pulse/audit.py,sha256=dr6H92YBAaGUjJbwceq3SD7-2fTwNkqUiXjGVg0Cc74,2127
+pulse/auth.py,sha256=wysBCDzJisUow2bERxCzgdlMfPlrZn06HRsXTnpba5g,22109
+pulse/cli.py,sha256=TN6DTfS3aQUsbJPWfcSWVJK6jxAuHY5jESEkzlk9v64,45002
+pulse/cli_ui.py,sha256=pb7vo9xWvngHrXGgqXho4X52Q1XnCYUEcZze6bfN6n8,36157
+pulse/config.py,sha256=LFlgfOQGWl0wr5VCbuRNHkkjiDSQgytfCgQgaCdsmzI,5042
+pulse/context.py,sha256=clckyWCPq823kIrCj3KRGKvY-Np0SHwxzd1gCiaJfIs,37007
+pulse/edits.py,sha256=Pt-hwDliP0kHIk8cWZJvvAO3KUrLrC1UM4XDoybJvvM,2045
+pulse/episodic.py,sha256=Fzqq2VLcsnM7HK0zmxhqFhHvWBZz4sptow3E0zGDbyo,3227
+pulse/git.py,sha256=DdlV2G0a5W1mVqcs6OaNVfD-xOtW9kv5gJ4Mjp61iew,6286
+pulse/interactive.py,sha256=m8cQ2Sc1sgZ_Pv3HZUmKG8rwbMB0_RmrbpGA_Emiho8,8727
+pulse/memory.py,sha256=pyfK9irpV4578HmZEhca4hxxCFkxjZ1f7gtvLM7jMVQ,9157
+pulse/mutations.py,sha256=ImJSNtZ2R_8UY_1HzdwhTAy3cj-Lr5CkrIAPUlz-gco,10954
+pulse/patch.py,sha256=_XSbKCLXitI1WrxXMXQObE-3ElX-CXHcnuRi_zaukf8,4896
+pulse/production.py,sha256=x4mFDxLQ9RNPKbqLjpOF8oEmCLlXIedYwNCr6JXhooU,8235
+pulse/provider.py,sha256=w_oaPRce3U45E1iVjbS0_fM_VCA7ff2fB-m-Bqizb20,1802
+pulse/provider_keys.py,sha256=CrPO4Kqw3D31dh7joHSWDypBU407fYKnIaelmM7h6lY,11077
+pulse/py.typed,sha256=AbpHGcgLb-kRsJGnwFEktk7uzpZOCcBY74-YBdrKVGs,1
+pulse/reasoning.py,sha256=tKzYukaxGNQ65uCu_s8VSRY3JltakGViz16_m1-5dEs,24140
+pulse/repository.py,sha256=lO_0WSFlKGF8K6Ct9m0intC1bSge3Ra8T5k93sLpuLM,8533
+pulse/rpc.py,sha256=8alHF5HIjbPmJVEomaYRNyRYCfGektuhwX3wGL-qIy8,10677
+pulse/rule_synthesizer.py,sha256=m7-61MXragN7uKaEHIGwzPjlAna4EQoli9BISdoU5oo,1961
+pulse/runtime.py,sha256=aKGgSUsm-QvI0zzVgNSg9F_1STzwtr3eXO4O2jF19SI,7180
+pulse/session_manager.py,sha256=sF7Y7v-4USMF5HLnlLs29smriRjoDe3bOSzSuAJlHcI,13964
+pulse/software_engineer.py,sha256=sSbtJc4NU4JoVPPWByw_Qf8h9Ri4NNEn9iRkiYsZuaA,8123
+pulse/storage.py,sha256=LGAaKUhdwlM6S8ONrJXjzkl7hOvyfRoOQhntr5F5zGE,5377
+pulse/streaming.py,sha256=hDJlA1OeKOw1d-Jw-mSeFBh0Z2iBc_i49MwEk2nVPNE,17291
+pulse/subprocesses.py,sha256=YhENUEdmKn7viRCQXmqrhxDRpIfMo50YFS2kb1Doxuw,2029
+pulse/task_manager.py,sha256=VrRLySx5UwARpgGh69Kskp-9ZUb0ob5aul2RqTLAp6I,84017
+pulse/tool_policy.py,sha256=PZ1nIc9OxrmrJDcHn7fmDrrMa-TpCRGnqJnHlC1EO7c,6597
+pulse/tool_registry.py,sha256=qvY7VWza6gJFvZL2zOW5lwGjMAL9PdH18RipLm5mCkg,5966
+pulse/tools.py,sha256=KFHqxAfTU2Q85q70SulyFBFEXQrdivTyPQaWZKWce2o,16404
+pulse/verification.py,sha256=2W8fkjpbwkBWTrNXIlkNTxfHWA5z6eTKwK6F5hp7ZhY,4898
+pulse/ci/github_client.py,sha256=Wcn_FeM5aTA8EwMtsnLX9N6YP03cNaXBYL0wQ7BmvMM,2751
+pulse/ci/runner.py,sha256=aQnJ_M5c1FXnFySHsSSy5ahCZ6CO_zrmgHDTSn2KvW4,944
+pulse/conversations/__init__.py,sha256=cTFnPp87mmTkVhPsnd3PRtOITWGMZU0o6BYbKi2IjG0,257
+pulse/conversations/manager.py,sha256=L3yf6WUn13aMtlSpjOP-jccrVQs20ce2I5kSWrHH66U,12630
+pulse/core/agent.py,sha256=dAOTcYulisNrxR0DtH_B48aPYc6EnbaIUvf8VTAu4PQ,8013
+pulse/core/planner.py,sha256=8qubIZqYGNDhAVyGztNH7WIwB9LGIQVGrre9Sxd-lfw,3716
+pulse/core/protocols.py,sha256=P_N7YTKXx61uyPOYmQr0iqiLLAqA7PWiYQ3H7vVp6n8,1085
+pulse/eval/__init__.py,sha256=0658hX7tfbTCN22gOLa8yRo9kyGuezNCsXO4LDW0Lzo,299
+pulse/eval/trajectory_logger.py,sha256=nBPAM9w7cSur0K61RN8PGLzBKzulvDGnPWmEi3z-ViM,3216
+pulse/eval/verifier.py,sha256=HJSZuti_-JPfyhTRS37iUqiBcUMNjRq-UO4FAvRTntU,5033
+pulse/execution/__init__.py,sha256=wRHZo8UWQqCvGb6rv22jhIf3Q8IZiJgciiGhZzxb6qE,165
+pulse/execution/remote_task.py,sha256=gH5ACHa0ctZjgJRaiD-R145gsoP5N04DxeTQiiuJaks,2610
+pulse/mcp/__init__.py,sha256=wwWWMWewAoBXyNVNBlfUBkEy5k-VcARoRAi2SD6X43k,147
+pulse/mcp/client.py,sha256=35XgRRPYE9_wFElR_nwft0L88AiOBggEkCjJI82cWTk,9095
+pulse/mcp/local_tools.py,sha256=_oMnyjWuZxbgx3ExVsjNlqpXqnaoQ5DolnUkbDrtn8I,3973
+pulse/orchestration/__init__.py,sha256=wYhYpeyRvUtdxskOsxAWnSQpDy5vZMahiogjLzAKu-w,96
+pulse/orchestration/orchestrator.py,sha256=w_LY29xnZlTScnqBP_vfoOgcX4eHaJfMCFwzt85UTLY,6582
+pulse/planner/__init__.py,sha256=M8O7R_AYgUpWUDVFZxZ5tj2LhVSnnTNMaONFsfVFnsQ,144
+pulse/planner/dag_planner.py,sha256=vCDNtOQWZgILMqn7Nram3UwGRnqR6V8FOYsMEmFRbrU,2974
+pulse/planner/execution_loop.py,sha256=a5u23ySHxC4VeulLbinm82uyFuvsKnr6O80qB3mPKys,6241
+pulse/providers/__init__.py,sha256=9Aotqz492qjdB5l5RmxlzC88clU06RDDDkSXFwapzsM,827
+pulse/providers/anthropic.py,sha256=xxEekGZOQnbUTTMdL5EmeO6_qf58_AfvIJSbnZQV7hw,2262
+pulse/providers/base.py,sha256=anbY03KrjtPdoDz05peZ_J3-qCfP5z1bpp0epsgsETc,9201
+pulse/providers/deepseek.py,sha256=vXQ79nxP1GW-0y9tLYt5rfjKGufHPXXM4g0q8DDQQlo,283
+pulse/providers/failover.py,sha256=Zghl8UAS_VfZBSKYLKiPpF6AYv6h44nAR_dESyOQQTQ,1284
+pulse/providers/gemini.py,sha256=y-TmiZ2eTDQ3AKB9oKdqiIrEyK4N79yonTBkWSp5Yjs,2319
+pulse/providers/groq.py,sha256=9dnkg3T47IUATvQmGpaXqcFGCSxcoprKMxFWlTSEsIQ,277
+pulse/providers/manager.py,sha256=pgy3o_Pdh_FwZ7gf85naU7COb3k8EVIMaVzGyJyzpEI,11461
+pulse/providers/openai.py,sha256=sx1wK1tKnnkxdspo_8AqdynREg16ltTsZn2ZVq6f4OE,1271
+pulse/providers/openrouter.py,sha256=nId5Teqx4YvGMG59jTdGAtGdFHPAwK0iXCLByeTUkqY,549
+pulse/refactor/__init__.py,sha256=dH01Vx6V-I0ICGyVaL0iPugq4CwPvd6UswQgh9FC5jc,94
+pulse/refactor/impact_analyzer.py,sha256=h3v9nPOc6cH5FYEE7L5ePhjEKs7JLMw-vmIhZw7QbGU,1828
+pulse/safety/__init__.py,sha256=ylSOpzbjMZYyDjbTdJYTRVQI_ZIJF8L98dpeSTtRvoQ,107
+pulse/safety/safety_manager.py,sha256=qeqvgcu028DSh10gxNw577zjA4kt_qPrmtM41gROwTI,3187
+pulse/sandbox/SECURITY.md,sha256=u2EGwO8LySJdNFJhILj7OR37DICNjWeejY4mcHTv7A8,4616
+pulse/sandbox/__init__.py,sha256=QNH19wr3Es8Vgx9JcwgZP3z8mn4-hcNgCVj4JD3Ausk,2178
+pulse/sandbox/api.py,sha256=XoGkHaA8E6_RqdbBPv8FeEsVscIsX8FUmdV3HXk6jrs,26233
+pulse/sandbox/audit.py,sha256=Z2GOe3btbvQI6D7D6ucpKzONc1FFT6dTzs2PmWrLUrE,5082
+pulse/sandbox/errors.py,sha256=pak0DsBW_amk6NVVn5cXf_77OQQ3X8nwEpSzs4rEOUI,3983
+pulse/sandbox/filesystem.py,sha256=Oqn8IBuc7CHbKqwCM0nBPJU9_yJNhwb6x8Z33TJ6WVw,19990
+pulse/sandbox/git_safe.py,sha256=YqjpAYZhfAdWpsFSSzSiUf7jWEhcecvsP8Nv2f-GPXQ,1645
+pulse/sandbox/lifecycle.py,sha256=EDPZUJWgT0nahYu8ij4Jw3Hn86vCsLKWRrTACMzzgV0,3463
+pulse/sandbox/network.py,sha256=3JPG4sx-iYCii6TNXz0ffq9RiQ-JnJXP1xJLPTIMUDA,7095
+pulse/sandbox/path_validator.py,sha256=_gLZ0D28X1r-tfzTSRxdw-IInrJeSfAXEvRwhLsuR6A,10819
+pulse/sandbox/policy.py,sha256=2SMrIaqvgTEq1AlYhn5czSSN3DRZA6RCrEbcetx4WPQ,7915
+pulse/sandbox/process.py,sha256=uDiW5uxv8WL9AfaI4wB_d5c6MUprFI3_a3I2evrxTcQ,14041
+pulse/sandbox/project.py,sha256=bCZQOTSDVKl8aqAwaR3FXM1hctK4STQmvyxrWXXxYFU,7047
+pulse/sandbox/python_safe.py,sha256=orL_dlIKennNEmGWLL25TKwaazVW-nbnzwHb_rdoi00,2358
+pulse/sandbox/resources.py,sha256=jz7TZTh_S0wT1QGQ2KHUPAsN64dQHy5lIhAqJWOH_Vg,10196
+pulse/sandbox/secrets.py,sha256=LvnkvF8k2UdbLE08iQOhGYmzqq8W4-IHQACIml2C0ps,9427
+pulse/sandbox/backend/__init__.py,sha256=_2g9RDAz0YDRwYGy0kJdnBRG3REQGDq6_sBzXnHtEL0,293
+pulse/sandbox/backend/base.py,sha256=RSuH9lpAT9iFHGee83gSQbxNkxNpfFKOB8hfC-9ZcoQ,2781
+pulse/sandbox/backend/docker.py,sha256=ps8S1asLc9ais39XhJyC6UH1kLOzcb1dwhu8VYIdWHU,20869
+pulse/sandbox/backend/host.py,sha256=dpkYcuzj3367UPzlC3eqvunt2veL2G9SbwhaGesvUnA,5749
+pulse/sandbox/backend/remote.py,sha256=klvTyHQ5wx6Zd02lhZOzU9FsFr8RMpEIX2AiBCzfKcY,9440
+pulse/sandbox/remote/__init__.py,sha256=MPYb7VW5EcoMkpKO8NIgxqeDdZtmpNHgLsTok4OB4iM,53
+pulse/sandbox/remote/client.py,sha256=8q0oGhLHFjIBTaK4XO1wuzWFPRb91v3_vXtQ_-uubs8,15065
+pulse/sandbox/remote/models.py,sha256=ZCy5DZTKJW3lZQTZQaTP93ZNbs-9mWpD_FvYBnec1Po,6199
+pulse/sandbox/remote/protocol.py,sha256=EQyHTMkBvSh2NnyQCaYTwEbgSAHEBtJdova2G4EMB94,2105
+pulse/sandbox/remote/server.py,sha256=qlq5BzlD04kQ7k83fdPyAh1Xv3LkhkazodBKiaTye8k,42742
+pulse/sandbox/remote/worker.py,sha256=74eGPtJdGNREmHRzp9RW4TRMhhNpk4F6Vp0CSYkzRB0,6455
+pulse/telemetry/__init__.py,sha256=Y3p0johD-ZU5OavfwNdQ1LP2JI35cYakEedsz84yDlw,489
+pulse/telemetry/cost_tracker.py,sha256=XHSYdl84lCfT9ZJgJqEsOifJwcXrYmdmpTCpDZ4hytg,3284
+pulse/telemetry/logger.py,sha256=2wtpQGekK0jx_2f-zmWTuDcNuKA6fzB1TSJDos0MSNw,3364
+pulse_coding_agent-0.1.0.dist-info/METADATA,sha256=9w7MDTjLIqd4C0LBUAZ4oOiKAXDOUHeC5Zk-wefp0ko,7906
+pulse_coding_agent-0.1.0.dist-info/WHEEL,sha256=zOwg4jB6zX2kU910N-cMawjivD6tO8NEWvE12je1bVk,87
+pulse_coding_agent-0.1.0.dist-info/entry_points.txt,sha256=FGhyBEduElxG2-52nfw-QQnT7QnHHEdHFXIiHaSCiVs,116
+pulse_coding_agent-0.1.0.dist-info/RECORD,,

pulse_coding_agent-0.1.0.dist-info/WHEEL

@@ -0,0 +1,4 @@
+Wheel-Version: 1.0
+Generator: hatchling 1.32.0
+Root-Is-Purelib: true
+Tag: py3-none-any

pulse_coding_agent-0.1.0.dist-info/entry_points.txt

@@ -0,0 +1,4 @@
+[console_scripts]
+pulse = pulse.cli:main
+pulse-remote = pulse.sandbox.remote.server:main
+pulse-rpc = pulse.rpc:main