github.com/humanagencyprotocol/hap-profiles/delegation@0.4
Delegation authority — lets an agent propose changes to its own setup: the agent brief and new mandates. Every proposal waits for a person's approval; nothing takes effect before it. Also lets the agent read the setup guides.
Bounds Schema
| Field | Type | Required | Description |
|---|---|---|---|
profile | string | Yes | - |
read_access | string | Yes | Allow the agent to read the guides for setting up a test: interview, test data, mandates, agent brief, the agent's own process, risks. |
brief_daily_max | number | Yes | How many times per day the agent may propose a new agent brief. Each proposal waits for your approval. |
mandate_daily_max | number | Yes | How many new mandates per day the agent may propose. Each one waits for your approval and is created only then. |
Key order: profile, read_access, brief_daily_max, mandate_daily_max
Scope Schema (local only)
| Field | Type | Required | Description |
|---|---|---|---|
allowed_profiles | string | Yes | Short profile names (e.g. sales, customers). A mandate proposal for any other profile is refused before a person sees it. Delegation itself can never be proposed. |
allowed_modes | string | Yes | review = every action under the proposed mandate needs approval; automatic = actions run within its limits. Choose review only, or review and automatic. |
Key order: allowed_profiles, allowed_modes
Full Definition
{
"id": "github.com/humanagencyprotocol/hap-profiles/delegation@0.4",
"name": "Delegation",
"version": "0.4",
"description": "Delegation authority — lets an agent propose changes to its own setup: the agent brief and new mandates. Every proposal waits for a person's approval; nothing takes effect before it. Also lets the agent read the setup guides.",
"whatsNew": "Says which kind of mandate the agent may propose: the profiles it may propose mandates for, and the modes (review only, or review and automatic). A proposal outside that is refused before anyone sees it. Needed for delegation on real systems, outside simulation mode. Limits are unchanged.",
"commitment_modes": [
"review"
],
"boundsSchema": {
"actionTypes": [
"brief",
"mandate"
],
"keyOrder": [
"profile",
"read_access",
"brief_daily_max",
"mandate_daily_max"
],
"fields": {
"profile": {
"type": "string",
"required": true
},
"read_access": {
"type": "string",
"required": true,
"displayName": "Read setup guides",
"description": "Allow the agent to read the guides for setting up a test: interview, test data, mandates, agent brief, the agent's own process, risks.",
"boundType": {
"kind": "enum",
"values": [
"unlimited",
"none"
]
},
"toolsDescription": "setup guides",
"default": "unlimited"
},
"brief_daily_max": {
"type": "number",
"required": true,
"displayName": "Brief proposals per day",
"description": "How many times per day the agent may propose a new agent brief. Each proposal waits for your approval.",
"unit": "count",
"boundType": {
"kind": "cumulative_count",
"window": "daily"
},
"appliesTo": [
"brief"
],
"default": 5
},
"mandate_daily_max": {
"type": "number",
"required": true,
"displayName": "Mandate proposals per day",
"description": "How many new mandates per day the agent may propose. Each one waits for your approval and is created only then.",
"unit": "count",
"boundType": {
"kind": "cumulative_count",
"window": "daily"
},
"appliesTo": [
"mandate"
],
"default": 30
}
}
},
"executionContextSchema": {
"fields": {
"brief_count_daily": {
"source": "cumulative",
"cumulativeField": "_count",
"window": "daily",
"description": "Running daily count of brief proposals",
"required": true,
"constraint": {
"type": "number",
"enforceable": [
"max"
]
}
},
"mandate_count_daily": {
"source": "cumulative",
"cumulativeField": "_count",
"window": "daily",
"description": "Running daily count of mandate proposals",
"required": true,
"constraint": {
"type": "number",
"enforceable": [
"max"
]
}
},
"allowed_profiles": {
"source": "declared",
"description": "Short name of the profile a mandate proposal is for",
"required": false,
"constraint": {
"type": "string",
"enforceable": [
"subset"
]
}
},
"allowed_modes": {
"source": "declared",
"description": "Commitment mode a mandate proposal asks for",
"required": false,
"constraint": {
"type": "string",
"enforceable": [
"subset"
]
}
}
}
},
"requiredGates": [
"bounds",
"intent",
"commitment",
"mandate_owner"
],
"ttl": {
"default": 86400,
"max": 2592000
},
"retention_minimum": 7776000,
"content_binding": {
"version": "1",
"kind": "jcs"
},
"scopeSchema": {
"keyOrder": [
"allowed_profiles",
"allowed_modes"
],
"fields": {
"allowed_profiles": {
"type": "string",
"required": true,
"displayName": "Profiles the agent may propose mandates for",
"description": "Short profile names (e.g. sales, customers). A mandate proposal for any other profile is refused before a person sees it. Delegation itself can never be proposed.",
"enum": [
"calendar",
"charge",
"customers",
"deploy",
"email",
"publish",
"purchase",
"records",
"reporting",
"sales"
],
"constraint": {
"type": "string",
"enforceable": [
"subset"
],
"requiredFor": [
"mandate"
]
}
},
"allowed_modes": {
"type": "string",
"required": true,
"displayName": "Modes the agent may propose",
"description": "review = every action under the proposed mandate needs approval; automatic = actions run within its limits. Choose review only, or review and automatic.",
"enum": [
"review",
"automatic"
],
"constraint": {
"type": "string",
"enforceable": [
"subset"
],
"requiredFor": [
"mandate"
]
}
}
}
}
}