harnest.bundle

All Python modules · Import and compatibility guidance

Exports

Name	Kind
`BundleError`	Class
`BundleConventionError`	Class
`BundleImportError`	Class
`BundleExportError`	Class
`BundleDuplicateError`	Class
`BundleSkillError`	Class
`BundleEvalError`	Class
`EvalSuite`	Class
`compile_agent`	Function
`compile_app`	Function
`compile_application`	Function
`compile_artifact`	Function
`bundle_agent`	Function
`discover_evals`	Function

BundleError

Base error for invalid filesystem agent bundles.

Example

from harnest.bundle import BundleError

try:
    ...
except BundleError as error:
    ...

BundleConventionError

A bundle path does not follow the filesystem convention.

Example

from harnest.bundle import BundleConventionError

try:
    ...
except BundleConventionError as error:
    ...

BundleImportError

A discovered resource module could not be imported.

Example

from harnest.bundle import BundleImportError

try:
    ...
except BundleImportError as error:
    ...

BundleExportError

A discovered module does not export its file-stem resource.

Example

from harnest.bundle import BundleExportError

try:
    ...
except BundleExportError as error:
    ...

BundleDuplicateError

Two explicit or discovered resources have the same identity.

Example

from harnest.bundle import BundleDuplicateError

try:
    ...
except BundleDuplicateError as error:
    ...

BundleSkillError

A discovered progressive skill is invalid or cannot be loaded.

Example

from harnest.bundle import BundleSkillError

try:
    ...
except BundleSkillError as error:
    ...

BundleEvalError

A discovered ADK evaluation file is invalid.

Example

from harnest.bundle import BundleEvalError

try:
    ...
except BundleEvalError as error:
    ...

EvalSuite

Validated evaluation files associated with one agent folder.

EvalSuite(eval_sets: tuple[Path, ...], config: Path | None = None) -> None

Fields (— means no declared default):

Field	Type	Default
`eval_sets`	`tuple[Path, ...]`	`—`
`config`	`Path \| None`	`None`

Parameters and example

Parameter	Type	Default
`eval_sets`	`tuple[Path, ...]`	Required
`config`	`Path \| None`	`None`

from harnest.bundle import EvalSuite

suite = EvalSuite(eval_sets=...)

compile_agent

Compile a filesystem definition into its framework-native target. source may be the agent directory or its agent.py file. Authored modules import the compiler-provided namespace explicitly, for example from harnest.agent import Agent. The Harnest compiler/runtime provides that namespace; it does not belong in the agent’s requirements file.

compile_agent(
    source: str | Path,
    *,
    entrypoint: str = 'agent:root_agent',
    framework: str = 'adk',
    mode: str = 'managed',
) -> Any

Parameters and example

Parameter	Type	Default
`source`	`str \| Path`	Required
`entrypoint`	`str`	`'agent:root_agent'`
`framework`	`str`	`'adk'`
`mode`	`str`	`'managed'`

from harnest.bundle import compile_agent

result = compile_agent(source=...)

compile_app

Compile a filesystem definition and return its provider application.

compile_app(
    source: str | Path,
    *,
    entrypoint: str = 'agent:root_agent',
    framework: str = 'adk',
    mode: str = 'managed',
) -> Any

Parameters and example

Parameter	Type	Default
`source`	`str \| Path`	Required
`entrypoint`	`str`	`'agent:root_agent'`
`framework`	`str`	`'adk'`
`mode`	`str`	`'managed'`

from harnest.bundle import compile_app

result = compile_app(source=...)

compile_application

Compile one managed definition or advanced framework application.

compile_application(
    source: str | Path,
    *,
    entrypoint: str,
    framework: str = 'adk',
    mode: str = 'managed',
) -> CompiledApplication

Parameters and example

Parameter	Type	Default
`source`	`str \| Path`	Required
`entrypoint`	`str`	Required
`framework`	`str`	`'adk'`
`mode`	`str`	`'managed'`

from harnest.bundle import compile_application

application = compile_application(source=..., entrypoint=...)

compile_artifact

Build an artifact; source-run callers bypass compile-only bundle declarations.

compile_artifact(
    source: str | Path,
    output: str | Path,
    *,
    entrypoint: str = 'agent:root_agent',
    framework: str = 'adk',
    mode: str = 'managed',
    cli_enabled: bool = False,
    bundle_selection: bool = True,
) -> dict[str, Any]

Parameters and example

Parameter	Type	Default
`source`	`str \| Path`	Required
`output`	`str \| Path`	Required
`entrypoint`	`str`	`'agent:root_agent'`
`framework`	`str`	`'adk'`
`mode`	`str`	`'managed'`
`cli_enabled`	`bool`	`False`
`bundle_selection`	`bool`	`True`

from harnest.bundle import compile_artifact

result = compile_artifact(source=..., output=...)

bundle_agent

Discover sibling resources and build an ADK root agent. Pass __file__ from an agent folder’s agent.py. Public Python files below tools/, subagents/, and mcp/ are imported in sorted path order and must export an object named after their file stem. Directory-first plugins/ contribute MCP clients and skills without an aggregation import.

bundle_agent(anchor: str | Path, root: AgentDefinition) -> Any

Parameters and example

Parameter	Type	Default
`anchor`	`str \| Path`	Required
`root`	`AgentDefinition`	Required

from harnest.bundle import bundle_agent

result = bundle_agent(anchor=..., root=...)

discover_evals

Return validated, sorted ADK eval paths without building the agent.

discover_evals(anchor: str | Path) -> EvalSuite

Parameters and example

Parameter	Type	Default
`anchor`	`str \| Path`	Required

from harnest.bundle import discover_evals

suite = discover_evals(anchor=...)

Overview

Get started

Harnest Studio

Guides

API reference

harnest.bundle

Exports

BundleError

BundleConventionError

BundleImportError

BundleExportError

BundleDuplicateError

BundleSkillError

BundleEvalError

EvalSuite

compile_agent

compile_app

compile_application

compile_artifact

bundle_agent

discover_evals

​Exports

​BundleError

​BundleConventionError

​BundleImportError

​BundleExportError

​BundleDuplicateError

​BundleSkillError

​BundleEvalError

​EvalSuite

​compile_agent

​compile_app

​compile_application

​compile_artifact

​bundle_agent

​discover_evals

Exports

BundleError

BundleConventionError

BundleImportError

BundleExportError

BundleDuplicateError

BundleSkillError

BundleEvalError

EvalSuite

compile_agent

compile_app

compile_application

compile_artifact

bundle_agent

discover_evals