Expand description
Exposes the agent_bridge runtime module.
ยงExamples
โ
use pharos_native::runtime::agent_bridge;ยงRelated
crate::runtimefor sibling modules in the same crate.
Structsยง
- Agent
Operation Lock - Repo-local write lock for agent authoring operations.
- Agent
Output - One bounded output reference emitted by a tool.
- Agent
Tool Result - Standard tool result payload shape for successful agent operations.
- AppAcceptance
Criterion Model - Task-specific acceptance criterion derived from the generated app model.
- AppAction
Model - Action planned by the app-model synthesis step.
- AppChange
Plan - Persisted change plan consumed by inspect/apply transaction tools.
- AppEntity
Model - Entity planned by the app-model synthesis step.
- AppManifest
Model - Manifest declarations planned before app-owned files are written.
- AppModel
- Versioned structured application model used before file planning.
- AppModel
Synthesis - Result returned by app-model synthesis.
- AppRoute
Model - Route planned by the app-model synthesis step.
- AppState
Mutation Model - State mutation planned by the app-model synthesis step.
- AppStatic
Asset Model - Static asset planned by the app-model synthesis step.
- AppTemplate
Model - Template planned by the app-model synthesis step.
- AppUi
Archetype Model - Typed UI archetype selected from generated product knowledge.
- AppWorkflow
Model - Workflow planned by the app-model synthesis step.
- Artifact
Manifest - Versioned artifact manifest produced by preparation lanes.
- Backup
AppParams ๐ - Deploy
Target ๐Params - Encrypted
File Credential Backend - Compatibility adapter retaining Architect errors over the shared encrypted credential store.
- File
Patch - Source patch accepted by the same reviewed authoring transaction for text and media.
- Integrations
AppParams - Jobs
AppParams ๐ - Json
RpcError - JSON-RPC error payload with self-healing metadata.
- Json
RpcError Data - JSON-RPC error metadata used by model and human callers.
- Json
RpcFailure - JSON-RPC failure response envelope returned by the agent bridge.
- Json
RpcRequest - JSON-RPC request envelope accepted by the agent bridge.
- Json
RpcSuccess - JSON-RPC success response envelope returned by the agent bridge.
- Lifecycle
AppParams ๐ - List
Targets ๐Params - Planned
File Change - One planned text-file write inside a bounded authoring transaction.
- Production
Readiness ๐Params - Provider
Completion - Provider completion response used by the bounded tool loop.
- Provider
Tool Call - Provider-emitted tool call after schema validation.
- Read
AppModel ๐Params - Release
Ledger Record - Release ledger record written after verified deployment.
- Restore
AppParams ๐ - Runtime
Json ๐RpcDispatcher - Scaffold
AppParams ๐ - Secret
RefMetadata - Target
Profile - Versioned target profile record supplied by Architect configuration.
Enumsยง
- Agent
Error Kind - Architect and agent bridge error taxonomy for schema and policy failures.
- Artifact
Kind - Artifact kind prepared for deployment.
- Capability
Class - Capability class enforced for one tool invocation.
- Export
Kind - Source export mode for Architect downloads.
- Path
Classification - Source/artifact/temp classification used before Architect file operations.
- Target
Environment - Deployment environment for a target profile.
- Target
List Format - Target listing output format.
- Target
Transport - Deployment transport for a target profile.
- Tool
Params - Versioned tool parameter records for the initial bridge contract.
Traitsยง
- Credential
Backend - Architect credential interface retained for existing provider and deployment consumers.
- Json
RpcDispatcher - Runtime-owned tool bodies used by the crate-owned JSON-RPC dispatch table.
Functionsยง
- acquire_
operation_ lock - Acquires a repo-local operation lock for write-capable agent tools.
- active_
cli_ verbs - Returns the currently active top-level CLI verbs known at the native entrypoint.
- agent_
sync_ report - Builds the deterministic agent sync report used by local hooks and checks.
- app_
model_ digest - Computes the stable digest for one app model.
- apply_
app_ change - Applies one saved text-file change plan with rollback on any write failure.
- backup_
restore_ ๐runtime_ context - Builds the same app runtime context used by native backup and restore entrypoints.
- baseline_
inventory_ value - Builds the Phase 0 baseline inventory document from the current source tree.
- builtin_
authoring_ patches - Generates deterministic app-owned edits from the built-in model for plan/apply.
- check_
product_ knowledge - Validates deterministic product knowledge outputs without writing files.
- check_
written_ product_ knowledge - Validates written product knowledge artifacts against the current source fingerprint.
- classify_
repo_ path - Classifies a repository-relative path as source, artifact, or temp.
- default_
repo_ ๐root - Resolves the current Pharos repository root for local agent commands.
- deploy_
target_ ๐gate - Returns a deploy gate report backed by built artifacts and target registry data.
- execute_
apply_ ๐app_ change - Applies one previously planned app change atomically with preimage rollback.
- execute_
backup_ ๐app - Executes one native backup operation through the agent bridge.
- execute_
deploy_ ๐target - Executes the declared deployment gate without claiming remote transport completion.
- execute_
host_ ๐detect - Detects the local host target through JSON-RPC.
- execute_
inspect_ ๐change - Executes a bounded inspection for one saved change plan.
- execute_
integrations_ ๐app - Executes bounded integration inspection or delivery through the agent bridge.
- execute_
jobs_ ๐app - Executes bounded job inspection or local job execution through the agent bridge.
- execute_
json_ rpc - Executes one JSON-RPC request through the crate-owned dispatch table.
- execute_
lifecycle_ ๐app - Executes one generic runtime lifecycle command through the agent bridge.
- execute_
list_ ๐targets - Lists checked-in cross-platform targets through JSON-RPC.
- execute_
plan_ ๐app_ change - Executes deterministic source-change planning without mutating app source.
- execute_
production_ ๐readiness - Reports production readiness for hard integration capabilities.
- execute_
read_ ๐app_ model - Executes a read-only app model inspection for one checked-in app root.
- execute_
restore_ ๐app - Executes one native restore operation through the agent bridge.
- execute_
scaffold_ ๐app - Executes the shared scaffold helper through the bounded JSON-RPC method.
- execute_
seed_ ๐app - Executes the standalone seed compatibility tool without shelling out.
- execute_
synthesize_ ๐app_ model - Executes the built-in app-model synthesis JSON-RPC method.
- execute_
validate_ ๐local - Executes build, verify, and doctor as the local validation bundle.
- host_
detection_ report - Detects the local host build target using the registry-backed native target map.
- inspect_
change_ plan - Inspects one saved change plan without touching app source.
- json_
rpc_ ๐failure - Serializes a JSON-RPC failure envelope with stable advice.
- json_
rpc_ ๐success - normalize_
app_ id - Normalizes a Pharos app identifier for tool parameters.
- normalize_
lifecycle_ ๐path - Normalizes lifecycle paths without permitting traversal.
- parse_
json_ rpc_ request - Parses a bounded JSON-RPC request envelope.
- parse_
target_ profile - Parses and validates one versioned target profile document.
- plan_
app_ change - Creates and stores one deterministic app source change plan.
- plan_
digest_ current - Returns whether a plan digest can be applied to the current source fingerprint.
- product_
knowledge_ outputs - production_
readiness_ report - Reports the maturity of hard production integrations without faking missing engines.
- read_
existing_ app_ model - Reads the current declarative model surfaces for one source app root.
- readiness_
check ๐ - readiness_
prerequisite ๐ - readiness_
rollup_ ๐status - redact_
secret_ like_ text - Redacts secret-looking text before it can enter reports or model transcripts.
- repo_
relative_ ๐path - resolve_
authoring_ output_ root - Resolves one output root for agent authoring without allowing artifact targets.
- resolve_
existing_ repo_ path - Serializes a JSON-RPC success envelope with structured tool data. Resolves an existing repository-relative path without allowing traversal or symlink escape.
- run_
integrations_ app_ tool - Inspects or delivers one configured integration event from app-owned contracts.
- run_
jobs_ ๐app_ tool - Inspects or processes queued local job rows through the configured adapter.
- run_
lifecycle_ app_ tool - Runs build, verify, or doctor through the existing generic app lifecycle dispatcher.
- runtime_
report_ identifiers - Returns the stable report identifiers used by active runtime app lifecycle verbs.
- secret_
token_ like - Checks whether one token resembles a secret and should be redacted.
- seed_
app_ tool - Applies seed data through the existing runtime migration preparation path.
- synthesize_
builtin_ app_ model - Synthesizes a deterministic baseline app model without provider secrets or network egress.
- target_
registry_ list_ text - Emits a bounded human-readable target list backed by the registry file.
- target_
registry_ projection - Emits the registry-declared target catalog as a stable JSON projection.
- validate_
json_ rpc_ request - Validates the JSON-RPC envelope fields used for dispatch.
- validate_
secret_ ref - Validates a secret reference name without accepting secret values.
- validate_
target_ profile - Validates target-profile policy without requiring any tracked target addresses.
- write_
baseline_ inventory - Writes the Phase 0 agent baseline inventory into the requested repository-local directory.
- write_
product_ knowledge - Writes deterministic product knowledge outputs for the Architect webapp agent.