mirror of
https://github.com/rcourtman/Pulse.git
synced 2026-07-10 16:31:32 +00:00
ee8a24e14a
Manifest-backed MCP tools, prompts, and resources with surface affordance contracts; agent capability manifest and governance projection; API contract tests and capability route projection; operations-loop and intelligence-funnel telemetry; release-control subsystem documentation, registry, and tooling; licensing and configuration.
66 lines
2.8 KiB
Go
66 lines
2.8 KiB
Go
package agentcapabilities
|
|
|
|
import "encoding/json"
|
|
|
|
// AgentErrCode* constants are the snake_case values exposed by the
|
|
// agent-surface error envelope and advertised in manifest errorCodes.
|
|
const (
|
|
AgentErrCodeResourceNotFound = "resource_not_found"
|
|
AgentErrCodeOperatorStateNotSet = "operator_state_not_set"
|
|
AgentErrCodeOperatorStateInvalid = "operator_state_invalid"
|
|
AgentErrCodeInvalidFindingRequest = "invalid_finding_request"
|
|
AgentErrCodeFindingNotFound = "finding_not_found"
|
|
AgentErrCodeFindingActionNotAllowed = "finding_action_not_allowed"
|
|
AgentErrCodePatrolUnavailable = "patrol_unavailable"
|
|
AgentErrCodeInvalidActionRequest = "invalid_action_request"
|
|
AgentErrCodeCapabilityNotFound = "capability_not_found"
|
|
AgentErrCodeActionExecutionUnavailable = "action_execution_unavailable"
|
|
AgentErrCodeMissingID = "missing_id"
|
|
AgentErrCodeInvalidID = "invalid_id"
|
|
AgentErrCodeInvalidActionDecision = "invalid_action_decision"
|
|
AgentErrCodeActionNotFound = "action_not_found"
|
|
AgentErrCodeActionNotPending = "action_not_pending"
|
|
AgentErrCodeActionPlanExpired = "action_plan_expired"
|
|
AgentErrCodeInvalidActionExecution = "invalid_action_execution"
|
|
AgentErrCodeActionNotApproved = "action_not_approved"
|
|
AgentErrCodeActionAlreadyExecuting = "action_already_executing"
|
|
AgentErrCodeActionExecutionFinal = "action_execution_final"
|
|
AgentErrCodeActionDryRunOnly = "action_dry_run_only"
|
|
AgentErrCodeActionPlanDrift = "action_plan_drift"
|
|
AgentErrCodeResourceRemediationLocked = "resource_remediation_locked"
|
|
AgentErrCodeActionExecutorUnavailable = "action_executor_unavailable"
|
|
)
|
|
|
|
// ErrorEnvelope is the stable failure shape emitted by Pulse Intelligence
|
|
// agent-surface endpoints. Agents branch on Error, not on Message.
|
|
type ErrorEnvelope struct {
|
|
Error string `json:"error"`
|
|
Message string `json:"message"`
|
|
Details map[string]string `json:"details,omitempty"`
|
|
}
|
|
|
|
// NewErrorEnvelope builds an agent-stable error envelope while preserving the
|
|
// two-field JSON shape when there are no structured details.
|
|
func NewErrorEnvelope(code, message string, details map[string]string) ErrorEnvelope {
|
|
if len(details) == 0 {
|
|
details = nil
|
|
}
|
|
return ErrorEnvelope{
|
|
Error: code,
|
|
Message: message,
|
|
Details: details,
|
|
}
|
|
}
|
|
|
|
// DecodeErrorEnvelope parses a response body as an agent-stable error envelope.
|
|
// The boolean is false when the body is not the shared shape.
|
|
func DecodeErrorEnvelope(body []byte) (ErrorEnvelope, bool) {
|
|
var envelope ErrorEnvelope
|
|
if err := json.Unmarshal(body, &envelope); err != nil {
|
|
return ErrorEnvelope{}, false
|
|
}
|
|
if envelope.Error == "" || envelope.Message == "" {
|
|
return ErrorEnvelope{}, false
|
|
}
|
|
return envelope, true
|
|
}
|