Skip to main content

Module agent_bridge

Module agent_bridge 

Source
Expand description

Exposes the agent_bridge runtime module.

ยงExamples

โ“˜
use pharos_native::runtime::agent_bridge;

Structsยง

AgentOperationLock
Repo-local write lock for agent authoring operations.
AgentOutput
One bounded output reference emitted by a tool.
AgentToolResult
Standard tool result payload shape for successful agent operations.
AppAcceptanceCriterionModel
Task-specific acceptance criterion derived from the generated app model.
AppActionModel
Action planned by the app-model synthesis step.
AppChangePlan
Persisted change plan consumed by inspect/apply transaction tools.
AppEntityModel
Entity planned by the app-model synthesis step.
AppManifestModel
Manifest declarations planned before app-owned files are written.
AppModel
Versioned structured application model used before file planning.
AppModelSynthesis
Result returned by app-model synthesis.
AppRouteModel
Route planned by the app-model synthesis step.
AppStateMutationModel
State mutation planned by the app-model synthesis step.
AppStaticAssetModel
Static asset planned by the app-model synthesis step.
AppTemplateModel
Template planned by the app-model synthesis step.
AppUiArchetypeModel
Typed UI archetype selected from generated product knowledge.
AppWorkflowModel
Workflow planned by the app-model synthesis step.
ArtifactManifest
Versioned artifact manifest produced by preparation lanes.
BackupAppParams ๐Ÿ”’
DeployTargetParams ๐Ÿ”’
EncryptedFileCredentialBackend
Compatibility adapter retaining Architect errors over the shared encrypted credential store.
FilePatch
Source patch accepted by the same reviewed authoring transaction for text and media.
IntegrationsAppParams
JobsAppParams ๐Ÿ”’
JsonRpcError
JSON-RPC error payload with self-healing metadata.
JsonRpcErrorData
JSON-RPC error metadata used by model and human callers.
JsonRpcFailure
JSON-RPC failure response envelope returned by the agent bridge.
JsonRpcRequest
JSON-RPC request envelope accepted by the agent bridge.
JsonRpcSuccess
JSON-RPC success response envelope returned by the agent bridge.
LifecycleAppParams ๐Ÿ”’
ListTargetsParams ๐Ÿ”’
PlannedFileChange
One planned text-file write inside a bounded authoring transaction.
ProductionReadinessParams ๐Ÿ”’
ProviderCompletion
Provider completion response used by the bounded tool loop.
ProviderToolCall
Provider-emitted tool call after schema validation.
ReadAppModelParams ๐Ÿ”’
ReleaseLedgerRecord
Release ledger record written after verified deployment.
RestoreAppParams ๐Ÿ”’
RuntimeJsonRpcDispatcher ๐Ÿ”’
ScaffoldAppParams ๐Ÿ”’
SecretRefMetadata
TargetProfile
Versioned target profile record supplied by Architect configuration.

Enumsยง

AgentErrorKind
Architect and agent bridge error taxonomy for schema and policy failures.
ArtifactKind
Artifact kind prepared for deployment.
CapabilityClass
Capability class enforced for one tool invocation.
ExportKind
Source export mode for Architect downloads.
PathClassification
Source/artifact/temp classification used before Architect file operations.
TargetEnvironment
Deployment environment for a target profile.
TargetListFormat
Target listing output format.
TargetTransport
Deployment transport for a target profile.
ToolParams
Versioned tool parameter records for the initial bridge contract.

Traitsยง

CredentialBackend
Architect credential interface retained for existing provider and deployment consumers.
JsonRpcDispatcher
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.