Skip to main content

behalf

DOI

A small framework for the recurring pattern of a scoped agent: hand it a brief, a fixed set of tools, and bounded authority, and it does one job.

Abstractions

  • Task what to elicit from the user, which tools the agent gets, and what a valid result is.
  • ToolSpec can be a single tool or action.
  • runner backend is the model like the Claude Agent SDK, Google ADK, or Strands on Bedrock.
from behalf import run_task, make_runner
outcome = await run_task(MyTask(), make_runner("aws"))

Manifests

manifest_schema() is sent to the model during setup (see render_setup_prompt), and finalize_setup only accepts a manifest that has every schema field. run_task raises ValueError if a manifest, conversed or passed in, is missing a field.

Results

Runners return None from run_agent; results come from tool side effects. record_tool(sink, fields) returns a tool that appends each call's arguments to sink:

from behalf import record_tool

class MyTask(Task):
    def build_tools(self, manifest):
        self.results = []
        return [record_tool(self.results, {"job": str, "site": str})]

Install

pip install behalf            # core only (no backend)
pip install behalf[claude]    # + Claude Agent SDK
pip install behalf[aws]       # + Strands / Bedrock
pip install behalf[gemini]    # + Google ADK

License

HPCIC DevTools is distributed under the terms of the MIT license. All new contributions must be made under this license.

See LICENSE, COPYRIGHT, and NOTICE for details.

SPDX-License-Identifier: (MIT)

LLNL-CODE- 842614

Metadata

Release files for behalf 0.2.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for behalf 0.2.0
File Size Uploaded Provenance Actions
behalf-0.2.0.tar.gz 19.8 kB Without provenance Details for behalf-0.2.0.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for behalf 0.2.0
File Interpreter ABI Platform Actions
behalf-0.2.0-py3-none-any.whl Python 3 none any Details for behalf-0.2.0-py3-none-any.whl

Total release size: 35.7 kB

Release files / behalf-0.2.0.tar.gz

Download URL behalf-0.2.0.tar.gz
Size 19.8 kB
Tags Source
SHA-256 checksum
How to use checksums
f63577eda78a90de6a176491b5b31769d17d0d153a093cab59245f3ca621ad96
BLAKE2b-256 checksum
How to use checksums
74da12d886369aecba26bbdc10ec2f9ba20600e09af60ce9818be0c8e50a23fb
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.2.0 CPython/3.12.2

Release files / behalf-0.2.0-py3-none-any.whl

Download URL behalf-0.2.0-py3-none-any.whl
Size 15.9 kB
Tags Python 3
SHA-256 checksum
How to use checksums
77e469df4e7c08d1fb2c52283f323aea04262b13163e62419d24e9ca912c6eb4
BLAKE2b-256 checksum
How to use checksums
e2d0e318cdfaabf33ba8266eb5cf5390fc0388831d193c83a9c34ca683472a4b
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.2.0 CPython/3.12.2

Security for behalf 0.2.0

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page