@suveren/gateway 0.19.5 → 0.20.1

package/profiles/publish/0.6.profile.json

@@ -0,0 +1,187 @@
+{
+  "id": "github.com/humanagencyprotocol/hap-profiles/publish@0.6",
+  "name": "Content Publishing",
+  "version": "0.6",
+  "description": "Publishing authority — governs posting public content to social media, blogs, and other platforms",
+  "whatsNew": "Protocol v0.7 wording: the scope schema replaces the context schema, and the required gate is the Mandate Owner. Limits and scope are unchanged.",
+  "boundsSchema": {
+    "actionTypes": [
+      "delete",
+      "post"
+    ],
+    "keyOrder": [
+      "profile",
+      "post_daily_max",
+      "post_monthly_max"
+    ],
+    "fields": {
+      "profile": {
+        "type": "string",
+        "required": true
+      },
+      "post_daily_max": {
+        "type": "number",
+        "required": true,
+        "displayName": "Daily post limit",
+        "description": "Maximum posts published per day",
+        "unit": "count",
+        "boundType": {
+          "kind": "cumulative_count",
+          "window": "daily"
+        },
+        "appliesTo": [
+          "post"
+        ]
+      },
+      "post_monthly_max": {
+        "type": "number",
+        "required": true,
+        "displayName": "Monthly post limit",
+        "description": "Maximum posts published per month",
+        "unit": "count",
+        "boundType": {
+          "kind": "cumulative_count",
+          "window": "monthly"
+        },
+        "appliesTo": [
+          "post"
+        ]
+      }
+    }
+  },
+  "scopeSchema": {
+    "keyOrder": [
+      "allowed_platforms",
+      "content_type",
+      "audience"
+    ],
+    "fields": {
+      "allowed_platforms": {
+        "type": "string",
+        "required": true,
+        "displayName": "Platforms",
+        "description": "Authorized publishing platforms",
+        "enum": [
+          "linkedin"
+        ],
+        "constraint": {
+          "type": "string",
+          "enforceable": [
+            "subset"
+          ]
+        }
+      },
+      "content_type": {
+        "type": "string",
+        "required": true,
+        "displayName": "Content types",
+        "description": "Authorized content formats",
+        "enum": [
+          "text",
+          "image",
+          "article"
+        ],
+        "constraint": {
+          "type": "string",
+          "enforceable": [
+            "subset"
+          ]
+        }
+      },
+      "audience": {
+        "type": "string",
+        "required": true,
+        "displayName": "Audience",
+        "description": "Authorized audience visibility",
+        "enum": [
+          "public",
+          "connections"
+        ],
+        "constraint": {
+          "type": "string",
+          "enforceable": [
+            "subset"
+          ]
+        }
+      }
+    }
+  },
+  "executionContextSchema": {
+    "fields": {
+      "allowed_platforms": {
+        "source": "declared",
+        "description": "Platform being published to (checked against authorized platforms)",
+        "required": true,
+        "constraint": {
+          "type": "string",
+          "enforceable": [
+            "subset"
+          ]
+        }
+      },
+      "content_type": {
+        "source": "declared",
+        "description": "Content format being published",
+        "required": true,
+        "constraint": {
+          "type": "string",
+          "enforceable": [
+            "subset"
+          ]
+        }
+      },
+      "audience": {
+        "source": "declared",
+        "description": "Audience visibility for this post",
+        "required": true,
+        "constraint": {
+          "type": "string",
+          "enforceable": [
+            "subset"
+          ]
+        }
+      },
+      "post_count_daily": {
+        "source": "cumulative",
+        "cumulativeField": "_count",
+        "window": "daily",
+        "description": "Running daily post count (resolved from execution log)",
+        "required": true,
+        "constraint": {
+          "type": "number",
+          "enforceable": [
+            "max"
+          ]
+        }
+      },
+      "post_count_monthly": {
+        "source": "cumulative",
+        "cumulativeField": "_count",
+        "window": "monthly",
+        "description": "Running monthly post count (resolved from execution log)",
+        "required": true,
+        "constraint": {
+          "type": "number",
+          "enforceable": [
+            "max"
+          ]
+        }
+      }
+    }
+  },
+  "requiredGates": [
+    "bounds",
+    "intent",
+    "commitment",
+    "mandate_owner"
+  ],
+  "ttl": {
+    "default": 86400,
+    "max": 31536000
+  },
+  "retention_minimum": 7776000,
+  "content_binding": {
+    "version": "1",
+    "kind": "text"
+  }
+}

package/profiles/purchase/0.7.profile.json

@@ -0,0 +1,235 @@
+{
+  "id": "github.com/humanagencyprotocol/hap-profiles/purchase@0.7",
+  "name": "Purchase",
+  "version": "0.7",
+  "description": "Purchase authority — governs spending company money: subscriptions, supplies, services, advertising",
+  "whatsNew": "Protocol v0.7 wording: the scope schema replaces the context schema, and the required gate is the Mandate Owner. Limits and scope are unchanged.",
+  "boundsSchema": {
+    "actionTypes": [
+      "purchase"
+    ],
+    "keyOrder": [
+      "profile",
+      "spend_max",
+      "spend_daily_max",
+      "spend_monthly_max",
+      "transaction_count_daily_max"
+    ],
+    "fields": {
+      "profile": {
+        "type": "string",
+        "required": true
+      },
+      "spend_max": {
+        "type": "number",
+        "required": true,
+        "displayName": "Max per transaction",
+        "description": "Maximum spend per transaction in currency units",
+        "unit": "currency:EUR",
+        "boundType": {
+          "kind": "per_transaction",
+          "of": "spend",
+          "requiredFor": [
+            "purchase"
+          ]
+        }
+      },
+      "spend_daily_max": {
+        "type": "number",
+        "required": true,
+        "displayName": "Daily spend limit",
+        "description": "Maximum cumulative spend per day in currency units",
+        "unit": "currency:EUR",
+        "boundType": {
+          "kind": "cumulative_sum",
+          "of": "spend",
+          "window": "daily"
+        }
+      },
+      "spend_monthly_max": {
+        "type": "number",
+        "required": true,
+        "displayName": "Monthly spend limit",
+        "description": "Maximum cumulative spend per month in currency units",
+        "unit": "currency:EUR",
+        "boundType": {
+          "kind": "cumulative_sum",
+          "of": "spend",
+          "window": "monthly"
+        }
+      },
+      "transaction_count_daily_max": {
+        "type": "number",
+        "required": true,
+        "displayName": "Daily transaction limit",
+        "description": "Maximum number of purchase transactions per day",
+        "unit": "count",
+        "boundType": {
+          "kind": "cumulative_count",
+          "window": "daily"
+        },
+        "appliesTo": [
+          "purchase"
+        ]
+      }
+    }
+  },
+  "scopeSchema": {
+    "keyOrder": [
+      "currency",
+      "category",
+      "allowed_vendors"
+    ],
+    "fields": {
+      "currency": {
+        "type": "string",
+        "required": true,
+        "displayName": "Currency",
+        "description": "Permitted currency code",
+        "constraint": {
+          "type": "string",
+          "enforceable": [
+            "enum"
+          ]
+        },
+        "enum": [
+          "USD",
+          "EUR",
+          "GBP",
+          "CHF",
+          "JPY",
+          "CAD",
+          "AUD"
+        ]
+      },
+      "category": {
+        "type": "string",
+        "required": true,
+        "displayName": "Purchase category",
+        "description": "Authorized purchase category",
+        "constraint": {
+          "type": "string",
+          "enforceable": [
+            "enum"
+          ]
+        },
+        "enum": [
+          "subscription",
+          "supply",
+          "service",
+          "advertising"
+        ]
+      },
+      "allowed_vendors": {
+        "type": "string",
+        "required": false,
+        "displayName": "Allowed vendors",
+        "description": "Comma-separated list of approved vendor names",
+        "constraint": {
+          "type": "string",
+          "enforceable": [
+            "subset"
+          ]
+        }
+      }
+    }
+  },
+  "executionContextSchema": {
+    "fields": {
+      "spend": {
+        "source": "declared",
+        "description": "Purchase amount in currency units",
+        "required": true,
+        "constraint": {
+          "type": "number",
+          "enforceable": [
+            "max"
+          ]
+        }
+      },
+      "currency": {
+        "source": "declared",
+        "description": "Currency code",
+        "required": true,
+        "constraint": {
+          "type": "string",
+          "enforceable": [
+            "enum"
+          ]
+        }
+      },
+      "category": {
+        "source": "declared",
+        "description": "Purchase category",
+        "required": true,
+        "constraint": {
+          "type": "string",
+          "enforceable": [
+            "enum"
+          ]
+        }
+      },
+      "allowed_vendors": {
+        "source": "declared",
+        "description": "Vendor name for this purchase (checked against approved list)",
+        "required": false,
+        "constraint": {
+          "type": "string",
+          "enforceable": [
+            "subset"
+          ]
+        }
+      },
+      "spend_daily": {
+        "source": "cumulative",
+        "cumulativeField": "spend",
+        "window": "daily",
+        "description": "Running daily spend total (resolved from execution log)",
+        "required": true,
+        "constraint": {
+          "type": "number",
+          "enforceable": [
+            "max"
+          ]
+        }
+      },
+      "spend_monthly": {
+        "source": "cumulative",
+        "cumulativeField": "spend",
+        "window": "monthly",
+        "description": "Running monthly spend total (resolved from execution log)",
+        "required": true,
+        "constraint": {
+          "type": "number",
+          "enforceable": [
+            "max"
+          ]
+        }
+      },
+      "transaction_count_daily": {
+        "source": "cumulative",
+        "cumulativeField": "_count",
+        "window": "daily",
+        "description": "Running daily transaction count (resolved from execution log)",
+        "required": true,
+        "constraint": {
+          "type": "number",
+          "enforceable": [
+            "max"
+          ]
+        }
+      }
+    }
+  },
+  "requiredGates": [
+    "bounds",
+    "intent",
+    "commitment",
+    "mandate_owner"
+  ],
+  "ttl": {
+    "default": 86400,
+    "max": 2592000
+  },
+  "retention_minimum": 7776000
+}

package/profiles/records/0.6.profile.json

@@ -0,0 +1,118 @@
+{
+  "id": "github.com/humanagencyprotocol/hap-profiles/records@0.6",
+  "name": "Records",
+  "version": "0.6",
+  "description": "Records authority — governs accessing and managing personal structured data",
+  "whatsNew": "Protocol v0.7 wording: the scope schema replaces the context schema, and the required gate is the Mandate Owner. Limits and scope are unchanged.",
+  "boundsSchema": {
+    "actionTypes": [
+      "archive",
+      "delete",
+      "write"
+    ],
+    "keyOrder": [
+      "profile",
+      "read_access",
+      "write_daily_max",
+      "delete_access",
+      "archive_access"
+    ],
+    "fields": {
+      "profile": {
+        "type": "string",
+        "required": true
+      },
+      "read_access": {
+        "type": "string",
+        "required": true,
+        "displayName": "Read access",
+        "description": "Allow the agent to list, view, and search your records",
+        "boundType": {
+          "kind": "enum",
+          "values": [
+            "unlimited",
+            "none"
+          ]
+        },
+        "toolsDescription": "list_records, get_record, search_records",
+        "default": "unlimited"
+      },
+      "write_daily_max": {
+        "type": "number",
+        "required": true,
+        "displayName": "Daily create limit",
+        "description": "Maximum new records the agent can create per day",
+        "unit": "count",
+        "boundType": {
+          "kind": "cumulative_count",
+          "window": "daily"
+        },
+        "appliesTo": [
+          "write"
+        ]
+      },
+      "delete_access": {
+        "type": "string",
+        "required": true,
+        "displayName": "Delete access",
+        "description": "Allow the agent to permanently delete records",
+        "boundType": {
+          "kind": "enum",
+          "values": [
+            "allowed",
+            "none"
+          ]
+        },
+        "toolsDescription": "delete_record",
+        "default": "none"
+      },
+      "archive_access": {
+        "type": "string",
+        "required": true,
+        "displayName": "Archive access",
+        "description": "Allow the agent to archive records (non-destructive, records remain accessible)",
+        "boundType": {
+          "kind": "enum",
+          "values": [
+            "allowed",
+            "none"
+          ]
+        },
+        "toolsDescription": "archive_record",
+        "default": "none"
+      }
+    }
+  },
+  "executionContextSchema": {
+    "fields": {
+      "write_count_daily": {
+        "source": "cumulative",
+        "cumulativeField": "_count",
+        "window": "daily",
+        "description": "Running daily create operation count",
+        "required": true,
+        "constraint": {
+          "type": "number",
+          "enforceable": [
+            "max"
+          ]
+        }
+      }
+    }
+  },
+  "requiredGates": [
+    "bounds",
+    "intent",
+    "commitment",
+    "mandate_owner"
+  ],
+  "ttl": {
+    "default": 86400,
+    "max": 31536000
+  },
+  "retention_minimum": 7776000,
+  "content_binding": {
+    "version": "1",
+    "kind": "jcs"
+  }
+}

package/profiles/reporting/0.3.profile.json

@@ -0,0 +1,98 @@
+{
+  "id": "github.com/humanagencyprotocol/hap-profiles/reporting@0.3",
+  "name": "Reporting",
+  "version": "0.3",
+  "description": "Reporting authority — lets an agent read the evidence a gateway holds (tickets, approvals, mandates, records in the systems it connects) and write one report stored on that machine. Changes no system.",
+  "whatsNew": "Protocol v0.7 wording: the scope schema replaces the context schema, and the required gate is the Mandate Owner. Limits and scope are unchanged.",
+  "boundsSchema": {
+    "actionTypes": [
+      "report"
+    ],
+    "keyOrder": [
+      "profile",
+      "read_access",
+      "read_max_age_days",
+      "report_daily_max"
+    ],
+    "fields": {
+      "profile": {
+        "type": "string",
+        "required": true
+      },
+      "read_access": {
+        "type": "string",
+        "required": true,
+        "displayName": "Read evidence",
+        "description": "Allow the agent to read tickets, approvals, mandates and the records in connected systems, to build a report",
+        "boundType": {
+          "kind": "enum",
+          "values": [
+            "unlimited",
+            "none"
+          ]
+        },
+        "toolsDescription": "tickets, approvals, mandates, system records",
+        "default": "unlimited"
+      },
+      "read_max_age_days": {
+        "type": "number",
+        "required": true,
+        "displayName": "Reporting window (days)",
+        "description": "How far back the agent may read evidence for a report: tickets, approvals, mandates and records from the last N days, at most 366. Anything older is invisible to the agent and cannot enter a report or an export. Enforced locally by the gateway (reads carry no ticket); signed here so the window the owner approved is part of the mandate.",
+        "unit": "days",
+        "boundType": {
+          "kind": "per_transaction",
+          "of": "read_age_days"
+        },
+        "maximum": 366,
+        "default": 30
+      },
+      "report_daily_max": {
+        "type": "number",
+        "required": true,
+        "displayName": "Report updates per day",
+        "description": "Maximum times per day the agent may write or replace the report",
+        "unit": "count",
+        "boundType": {
+          "kind": "cumulative_count",
+          "window": "daily"
+        },
+        "appliesTo": [
+          "report"
+        ]
+      }
+    }
+  },
+  "executionContextSchema": {
+    "fields": {
+      "report_count_daily": {
+        "source": "cumulative",
+        "cumulativeField": "_count",
+        "window": "daily",
+        "description": "Running daily count of report writes",
+        "required": true,
+        "constraint": {
+          "type": "number",
+          "enforceable": [
+            "max"
+          ]
+        }
+      }
+    }
+  },
+  "requiredGates": [
+    "bounds",
+    "intent",
+    "commitment",
+    "mandate_owner"
+  ],
+  "ttl": {
+    "default": 86400,
+    "max": 2592000
+  },
+  "retention_minimum": 7776000,
+  "content_binding": {
+    "version": "1",
+    "kind": "jcs"
+  }
+}