@emilia-protocol/gate 0.1.0 → 0.7.0

package/adapters/gcp.js

@@ -0,0 +1,71 @@
+// SPDX-License-Identifier: Apache-2.0
+/**
+ * EMILIA Gate — Google Cloud System-of-Record adapter.
+ *
+ * "Install this before your agent can change cloud permissions or delete a
+ * project." Guards the high-blast-radius GCP operations — IAM policy set,
+ * service-account key create, project delete, storage bucket delete — so they
+ * never reach GCP without a receipt bound to THIS resource/member/role. Client
+ * is injected (the @google-cloud SDKs or a thin wrapper).
+ */
+import { createAdapter, manifestFromPack } from './_kit.js';
+
+export const GCP_ACTION_PACK = Object.freeze([
+  Object.freeze({
+    id: 'gcp.iam.set_policy', label: 'GCP IAM set policy', action_type: 'gcp.iam.set_policy',
+    risk: 'critical', receipt_required: true, assurance_class: 'quorum',
+    match: { protocol: 'gcp', tool: 'set_iam_policy' },
+    why: 'Grants cloud permissions. Bind resource+member+role; quorum.',
+    execution_binding: { required_fields: ['action_type', 'resource', 'member', 'role'] },
+  }),
+  Object.freeze({
+    id: 'gcp.sa_key.create', label: 'GCP service-account key create', action_type: 'gcp.sa_key.create',
+    risk: 'critical', receipt_required: true, assurance_class: 'class_a',
+    match: { protocol: 'gcp', tool: 'create_service_account_key' },
+    why: 'Mints long-lived cloud credentials. Bind the service account.',
+    execution_binding: { required_fields: ['action_type', 'service_account'] },
+  }),
+  Object.freeze({
+    id: 'gcp.project.delete', label: 'GCP project delete', action_type: 'gcp.project.delete',
+    risk: 'critical', receipt_required: true, assurance_class: 'quorum',
+    match: { protocol: 'gcp', tool: 'delete_project' },
+    why: 'Deletes an entire project. Quorum.',
+    execution_binding: { required_fields: ['action_type', 'project'] },
+  }),
+  Object.freeze({
+    id: 'gcp.storage.bucket_delete', label: 'GCP bucket delete', action_type: 'gcp.storage.bucket_delete',
+    risk: 'high', receipt_required: true, assurance_class: 'class_a',
+    match: { protocol: 'gcp', tool: 'delete_bucket' },
+    why: 'Destroys a storage bucket and its objects. Bind the bucket.',
+    execution_binding: { required_fields: ['action_type', 'bucket'] },
+  }),
+]);
+
+const OPS = {
+  'iam.set_policy': {
+    selector: { protocol: 'gcp', tool: 'set_iam_policy' },
+    observed: (p) => ({ action_type: 'gcp.iam.set_policy', resource: p.resource, member: p.member, role: p.role }),
+    perform: (c, p) => c.setIamPolicy({ resource: p.resource, member: p.member, role: p.role }),
+  },
+  'sa_key.create': {
+    selector: { protocol: 'gcp', tool: 'create_service_account_key' },
+    observed: (p) => ({ action_type: 'gcp.sa_key.create', service_account: p.service_account }),
+    perform: (c, p) => c.createServiceAccountKey({ service_account: p.service_account }),
+  },
+  'project.delete': {
+    selector: { protocol: 'gcp', tool: 'delete_project' },
+    observed: (p) => ({ action_type: 'gcp.project.delete', project: p.project }),
+    perform: (c, p) => c.deleteProject({ project: p.project }),
+  },
+  'storage.bucket_delete': {
+    selector: { protocol: 'gcp', tool: 'delete_bucket' },
+    observed: (p) => ({ action_type: 'gcp.storage.bucket_delete', bucket: p.bucket }),
+    perform: (c, p) => c.deleteBucket({ bucket: p.bucket }),
+  },
+};
+
+const adapter = createAdapter({ system: 'gcp', ops: OPS });
+export const GCP_OPS = adapter.OPS;
+export function createGcpManifest(extraActions = []) { return manifestFromPack(GCP_ACTION_PACK, extraActions); }
+export function guardGcpMutation(gate, client, args) { return adapter.guard(gate, client, args); }
+export default { GCP_ACTION_PACK, GCP_OPS, createGcpManifest, guardGcpMutation };

package/adapters/github-demo.mjs

@@ -0,0 +1,57 @@
+/**
+ * EMILIA Gate × GitHub — the 60-second "oh shit" demo. Run: node adapters/github-demo.mjs
+ *
+ * An agent tries to delete a production repo. Without a receipt: refused, and the
+ * GitHub API is never called. With a valid human signoff bound to THIS repo: it
+ * runs and produces a reliance packet. Change the target repo after approval:
+ * refused (drift). Replay the receipt: refused. Uses a fake Octokit so it runs
+ * with no credentials; swap in `new Octokit({ auth })` for the real thing.
+ * @license Apache-2.0
+ */
+import crypto from 'node:crypto';
+import { createGate } from '../index.js';
+import { createGithubManifest, guardGithubMutation } from './github.js';
+
+const canon = (v) => (v == null ? JSON.stringify(v)
+  : Array.isArray(v) ? `[${v.map(canon).join(',')}]`
+    : typeof v === 'object' ? `{${Object.keys(v).sort().map((k) => JSON.stringify(k) + ':' + canon(v[k])).join(',')}}`
+      : JSON.stringify(v));
+const { publicKey, privateKey } = crypto.generateKeyPairSync('ed25519');
+const ISSUER = publicKey.export({ type: 'spki', format: 'der' }).toString('base64url');
+let n = 0;
+const mint = (extra = {}) => {
+  const payload = {
+    receipt_id: `gh_${++n}`, subject: 'agent:repo-bot', issuer: 'ep:org:demo', created_at: new Date().toISOString(),
+    claim: { action_type: 'github.repo.delete', owner: 'acme', repo: 'prod', outcome: 'allow_with_signoff', approver: 'ep:approver:cto', ...extra },
+  };
+  return { '@version': 'EP-RECEIPT-v1', payload, signature: { algorithm: 'Ed25519', value: crypto.sign(null, Buffer.from(canon(payload), 'utf8'), privateKey).toString('base64url') } };
+};
+
+const octokit = {
+  repos: { delete: async (p) => { console.log(`        !! GitHub API: repos.delete(${p.owner}/${p.repo}) EXECUTED`); return { status: 204 }; } },
+};
+const gate = createGate({ manifest: createGithubManifest(), trustedKeys: [ISSUER] });
+const G = (s) => `\x1b[32m${s}\x1b[0m`; const R = (s) => `\x1b[31m${s}\x1b[0m`;
+const line = (s) => console.log(s);
+
+async function attempt(label, params, receipt) {
+  try {
+    const { reliance } = await guardGithubMutation(gate, octokit, { op: 'repo.delete', params, receipt });
+    line(`  ${label} -> ${G('ALLOWED')}  reliance=${reliance.verdict.toUpperCase()}`);
+  } catch (e) {
+    line(`  ${label} -> ${R(`REFUSED ${e.status || ''}`)} (${e.gate?.reason || e.message})`);
+  }
+}
+
+line('='.repeat(66));
+line('  EMILIA Gate × GitHub — agent tries to delete the production repo');
+line('='.repeat(66));
+await attempt('1. delete acme/prod, no receipt            ', { owner: 'acme', repo: 'prod' }, null);
+const approval = mint();
+await attempt('2. delete acme/prod, valid human signoff   ', { owner: 'acme', repo: 'prod' }, approval);
+await attempt('3. same receipt replayed                   ', { owner: 'acme', repo: 'prod' }, approval);
+const reAppro = mint();
+await attempt('4. approved acme/prod, but targets staging ', { owner: 'acme', repo: 'staging' }, reAppro);
+line('  ' + '-'.repeat(62));
+line('  No receipt, no mutation. The GitHub API is only reached on an allowed line.');
+line('='.repeat(66));

package/adapters/github.js

@@ -0,0 +1,110 @@
+// SPDX-License-Identifier: Apache-2.0
+/**
+ * EMILIA Gate — GitHub System-of-Record adapter.
+ *
+ * "Install this before your agent can touch production GitHub." Wraps destructive
+ * Octokit operations so the mutation NEVER reaches GitHub without a valid,
+ * sufficiently-assured, non-replayed human/quorum receipt bound to THIS repo —
+ * and on success returns a reliance packet proving exactly what was authorized
+ * and what executed.
+ *
+ *   import { Octokit } from '@octokit/rest';
+ *   import { createGate } from '@emilia-protocol/gate';
+ *   import { createGithubManifest, guardGithubMutation } from '@emilia-protocol/gate/adapters/github';
+ *
+ *   const gate = createGate({ manifest: createGithubManifest(), trustedKeys: [ISSUER] });
+ *   const octokit = new Octokit({ auth });
+ *   await guardGithubMutation(gate, octokit, {
+ *     op: 'repo.delete', params: { owner, repo }, receipt,  // throws if no valid receipt
+ *   });
+ *
+ * The receipt's claim must carry the same owner/repo (and username/permission or
+ * branch) as the call — a receipt for repo A cannot authorize deleting repo B.
+ */
+import { createAdapter, manifestFromPack } from './_kit.js';
+
+export const GITHUB_ACTION_PACK = Object.freeze([
+  Object.freeze({
+    id: 'github.repo.delete',
+    label: 'GitHub repo delete',
+    action_type: 'github.repo.delete',
+    risk: 'critical',
+    receipt_required: true,
+    assurance_class: 'class_a',
+    match: { protocol: 'github', tool: 'delete_repo' },
+    why: 'Destroys a repository and its history. Bind owner/repo to a named human approval.',
+    execution_binding: { required_fields: ['action_type', 'owner', 'repo'] },
+  }),
+  Object.freeze({
+    id: 'github.permission.change',
+    label: 'GitHub permission change',
+    action_type: 'github.permission.change',
+    risk: 'critical',
+    receipt_required: true,
+    assurance_class: 'quorum',
+    match: { protocol: 'github', tool: 'update_collaborator_permission' },
+    why: 'Changes who can act on the repo. Privilege change deserves the two-person rule.',
+    execution_binding: { required_fields: ['action_type', 'owner', 'repo', 'username', 'permission'] },
+  }),
+  Object.freeze({
+    id: 'github.branch_protection.remove',
+    label: 'GitHub branch-protection removal',
+    action_type: 'github.branch_protection.remove',
+    risk: 'critical',
+    receipt_required: true,
+    assurance_class: 'class_a',
+    match: { protocol: 'github', tool: 'delete_branch_protection' },
+    why: 'Removes the guard rails on a protected branch.',
+    execution_binding: { required_fields: ['action_type', 'owner', 'repo', 'branch'] },
+  }),
+]);
+
+const OPS = {
+  'repo.delete': {
+    selector: { protocol: 'github', tool: 'delete_repo' },
+    observed: (p) => ({ action_type: 'github.repo.delete', owner: p.owner, repo: p.repo }),
+    perform: (octokit, p) => octokit.repos.delete({ owner: p.owner, repo: p.repo }),
+  },
+  'permission.change': {
+    selector: { protocol: 'github', tool: 'update_collaborator_permission' },
+    observed: (p) => ({
+      action_type: 'github.permission.change',
+      owner: p.owner, repo: p.repo, username: p.username, permission: p.permission,
+    }),
+    perform: (octokit, p) => octokit.repos.addCollaborator({
+      owner: p.owner, repo: p.repo, username: p.username, permission: p.permission,
+    }),
+  },
+  'branch_protection.remove': {
+    selector: { protocol: 'github', tool: 'delete_branch_protection' },
+    observed: (p) => ({ action_type: 'github.branch_protection.remove', owner: p.owner, repo: p.repo, branch: p.branch }),
+    perform: (octokit, p) => octokit.repos.deleteBranchProtection({ owner: p.owner, repo: p.repo, branch: p.branch }),
+  },
+};
+
+const adapter = createAdapter({ system: 'github', ops: OPS });
+export const GITHUB_OPS = adapter.OPS;
+
+/** Build an action-risk manifest for the GitHub destructive ops (plus any extras). */
+export function createGithubManifest(extraActions = []) {
+  return manifestFromPack(GITHUB_ACTION_PACK, extraActions);
+}
+
+/**
+ * Guard a destructive GitHub mutation behind the gate. The call never reaches
+ * GitHub unless a valid, sufficiently-assured, non-replayed receipt bound to
+ * THIS repo is present.
+ * @param {object} gate     a gate built with createGithubManifest()
+ * @param {object} octokit  an Octokit-like client (@octokit/rest or compatible)
+ * @param {object} o
+ * @param {string} o.op     'repo.delete' | 'permission.change' | 'branch_protection.remove'
+ * @param {object} o.params { owner, repo, [username], [permission], [branch] }
+ * @param {object} o.receipt the EMILIA receipt authorizing THIS exact op
+ * @returns {Promise<{ result:any, reliance:object, execution:object }>}
+ * @throws  Error{code:'EMILIA_RECEIPT_REQUIRED'} if refused — the call never reaches GitHub
+ */
+export function guardGithubMutation(gate, octokit, args) {
+  return adapter.guard(gate, octokit, args);
+}
+
+export default { GITHUB_ACTION_PACK, GITHUB_OPS, createGithubManifest, guardGithubMutation };

package/adapters/jira.js

@@ -0,0 +1,55 @@
+// SPDX-License-Identifier: Apache-2.0
+/**
+ * EMILIA Gate — Jira System-of-Record adapter.
+ * Guards bulk issue delete, project delete, and permission grants so they never
+ * reach Jira without a receipt bound to THIS resource. Client injected.
+ */
+import { createAdapter, manifestFromPack, hashCanonical } from './_kit.js';
+
+export const JIRA_ACTION_PACK = Object.freeze([
+  Object.freeze({
+    id: 'jira.issue.bulk_delete', label: 'Bulk delete issues', action_type: 'jira.issue.bulk_delete',
+    risk: 'critical', receipt_required: true, assurance_class: 'class_a',
+    match: { protocol: 'jira', tool: 'bulk_delete_issues' },
+    why: 'Mass-destroys issues. Bind the exact JQL.',
+    execution_binding: { required_fields: ['action_type', 'project', 'jql_hash'] },
+  }),
+  Object.freeze({
+    id: 'jira.project.delete', label: 'Delete project', action_type: 'jira.project.delete',
+    risk: 'critical', receipt_required: true, assurance_class: 'quorum',
+    match: { protocol: 'jira', tool: 'delete_project' },
+    why: 'Deletes a project and its issues. Quorum.',
+    execution_binding: { required_fields: ['action_type', 'project_key'] },
+  }),
+  Object.freeze({
+    id: 'jira.permission.grant', label: 'Grant permission', action_type: 'jira.permission.grant',
+    risk: 'critical', receipt_required: true, assurance_class: 'quorum',
+    match: { protocol: 'jira', tool: 'grant_permission' },
+    why: 'Changes who can act. Quorum + bind project/principal/role.',
+    execution_binding: { required_fields: ['action_type', 'project', 'principal', 'role'] },
+  }),
+]);
+
+const OPS = {
+  'issue.bulk_delete': {
+    selector: { protocol: 'jira', tool: 'bulk_delete_issues' },
+    observed: (p) => ({ action_type: 'jira.issue.bulk_delete', project: p.project, jql_hash: hashCanonical(String(p.jql || '').trim()) }),
+    perform: (c, p) => c.bulkDeleteIssues({ project: p.project, jql: p.jql }),
+  },
+  'project.delete': {
+    selector: { protocol: 'jira', tool: 'delete_project' },
+    observed: (p) => ({ action_type: 'jira.project.delete', project_key: p.project_key }),
+    perform: (c, p) => c.deleteProject({ projectKey: p.project_key }),
+  },
+  'permission.grant': {
+    selector: { protocol: 'jira', tool: 'grant_permission' },
+    observed: (p) => ({ action_type: 'jira.permission.grant', project: p.project, principal: p.principal, role: p.role }),
+    perform: (c, p) => c.grantPermission({ project: p.project, principal: p.principal, role: p.role }),
+  },
+};
+
+const adapter = createAdapter({ system: 'jira', ops: OPS });
+export const JIRA_OPS = adapter.OPS;
+export function createJiraManifest(extra = []) { return manifestFromPack(JIRA_ACTION_PACK, extra); }
+export function guardJiraMutation(gate, client, args) { return adapter.guard(gate, client, args); }
+export default { JIRA_ACTION_PACK, JIRA_OPS, createJiraManifest, guardJiraMutation };

package/adapters/k8s.js

@@ -0,0 +1,71 @@
+// SPDX-License-Identifier: Apache-2.0
+/**
+ * EMILIA Gate — Kubernetes System-of-Record adapter.
+ *
+ * "Install this before your agent can touch the cluster." Guards the operations
+ * that take a cluster down or hand it away — namespace delete, workload delete,
+ * RBAC binding, secret delete — so they never reach the API server without a
+ * receipt bound to THIS namespace/resource. Client is injected (a @kubernetes/
+ * client-node wrapper or compatible).
+ */
+import { createAdapter, manifestFromPack } from './_kit.js';
+
+export const K8S_ACTION_PACK = Object.freeze([
+  Object.freeze({
+    id: 'k8s.namespace.delete', label: 'Delete namespace', action_type: 'k8s.namespace.delete',
+    risk: 'critical', receipt_required: true, assurance_class: 'quorum',
+    match: { protocol: 'k8s', tool: 'delete_namespace' },
+    why: 'Deletes an entire namespace and everything in it. Quorum.',
+    execution_binding: { required_fields: ['action_type', 'namespace'] },
+  }),
+  Object.freeze({
+    id: 'k8s.workload.delete', label: 'Delete workload', action_type: 'k8s.workload.delete',
+    risk: 'high', receipt_required: true, assurance_class: 'class_a',
+    match: { protocol: 'k8s', tool: 'delete_workload' },
+    why: 'Deletes a deployment/statefulset/job. Bind namespace+kind+name.',
+    execution_binding: { required_fields: ['action_type', 'namespace', 'kind', 'name'] },
+  }),
+  Object.freeze({
+    id: 'k8s.rbac.bind', label: 'RBAC binding', action_type: 'k8s.rbac.bind',
+    risk: 'critical', receipt_required: true, assurance_class: 'quorum',
+    match: { protocol: 'k8s', tool: 'create_role_binding' },
+    why: 'Grants cluster permissions. Privilege change → two-person rule.',
+    execution_binding: { required_fields: ['action_type', 'subject', 'role', 'namespace'] },
+  }),
+  Object.freeze({
+    id: 'k8s.secret.delete', label: 'Delete secret', action_type: 'k8s.secret.delete',
+    risk: 'high', receipt_required: true, assurance_class: 'class_a',
+    match: { protocol: 'k8s', tool: 'delete_secret' },
+    why: 'Destroys a secret. Bind namespace+name.',
+    execution_binding: { required_fields: ['action_type', 'namespace', 'name'] },
+  }),
+]);
+
+const OPS = {
+  'namespace.delete': {
+    selector: { protocol: 'k8s', tool: 'delete_namespace' },
+    observed: (p) => ({ action_type: 'k8s.namespace.delete', namespace: p.namespace }),
+    perform: (c, p) => c.deleteNamespace({ namespace: p.namespace }),
+  },
+  'workload.delete': {
+    selector: { protocol: 'k8s', tool: 'delete_workload' },
+    observed: (p) => ({ action_type: 'k8s.workload.delete', namespace: p.namespace, kind: p.kind, name: p.name }),
+    perform: (c, p) => c.deleteWorkload({ namespace: p.namespace, kind: p.kind, name: p.name }),
+  },
+  'rbac.bind': {
+    selector: { protocol: 'k8s', tool: 'create_role_binding' },
+    observed: (p) => ({ action_type: 'k8s.rbac.bind', subject: p.subject, role: p.role, namespace: p.namespace }),
+    perform: (c, p) => c.createRoleBinding({ subject: p.subject, role: p.role, namespace: p.namespace }),
+  },
+  'secret.delete': {
+    selector: { protocol: 'k8s', tool: 'delete_secret' },
+    observed: (p) => ({ action_type: 'k8s.secret.delete', namespace: p.namespace, name: p.name }),
+    perform: (c, p) => c.deleteSecret({ namespace: p.namespace, name: p.name }),
+  },
+};
+
+const adapter = createAdapter({ system: 'k8s', ops: OPS });
+export const K8S_OPS = adapter.OPS;
+export function createK8sManifest(extraActions = []) { return manifestFromPack(K8S_ACTION_PACK, extraActions); }
+export function guardK8sMutation(gate, client, args) { return adapter.guard(gate, client, args); }
+export default { K8S_ACTION_PACK, K8S_OPS, createK8sManifest, guardK8sMutation };

package/adapters/linear.js

@@ -0,0 +1,55 @@
+// SPDX-License-Identifier: Apache-2.0
+/**
+ * EMILIA Gate — Linear System-of-Record adapter.
+ * Guards issue deletion, bulk delete, and team deletion so they never reach
+ * Linear without a receipt bound to THIS resource. Client injected.
+ */
+import { createAdapter, manifestFromPack, hashCanonical } from './_kit.js';
+
+export const LINEAR_ACTION_PACK = Object.freeze([
+  Object.freeze({
+    id: 'linear.issue.delete', label: 'Delete issue', action_type: 'linear.issue.delete',
+    risk: 'high', receipt_required: true, assurance_class: 'class_a',
+    match: { protocol: 'linear', tool: 'delete_issue' },
+    why: 'Destroys an issue. Bind the issue id.',
+    execution_binding: { required_fields: ['action_type', 'issue_id'] },
+  }),
+  Object.freeze({
+    id: 'linear.issue.bulk_delete', label: 'Bulk delete issues', action_type: 'linear.issue.bulk_delete',
+    risk: 'critical', receipt_required: true, assurance_class: 'class_a',
+    match: { protocol: 'linear', tool: 'bulk_delete_issues' },
+    why: 'Mass-destroys issues. Bind the exact query.',
+    execution_binding: { required_fields: ['action_type', 'team', 'query_hash'] },
+  }),
+  Object.freeze({
+    id: 'linear.team.delete', label: 'Delete team', action_type: 'linear.team.delete',
+    risk: 'critical', receipt_required: true, assurance_class: 'quorum',
+    match: { protocol: 'linear', tool: 'delete_team' },
+    why: 'Deletes a team and its issues. Quorum.',
+    execution_binding: { required_fields: ['action_type', 'team_id'] },
+  }),
+]);
+
+const OPS = {
+  'issue.delete': {
+    selector: { protocol: 'linear', tool: 'delete_issue' },
+    observed: (p) => ({ action_type: 'linear.issue.delete', issue_id: p.issue_id }),
+    perform: (c, p) => c.deleteIssue({ issueId: p.issue_id }),
+  },
+  'issue.bulk_delete': {
+    selector: { protocol: 'linear', tool: 'bulk_delete_issues' },
+    observed: (p) => ({ action_type: 'linear.issue.bulk_delete', team: p.team, query_hash: hashCanonical(String(p.query || '').trim()) }),
+    perform: (c, p) => c.bulkDeleteIssues({ team: p.team, query: p.query }),
+  },
+  'team.delete': {
+    selector: { protocol: 'linear', tool: 'delete_team' },
+    observed: (p) => ({ action_type: 'linear.team.delete', team_id: p.team_id }),
+    perform: (c, p) => c.deleteTeam({ teamId: p.team_id }),
+  },
+};
+
+const adapter = createAdapter({ system: 'linear', ops: OPS });
+export const LINEAR_OPS = adapter.OPS;
+export function createLinearManifest(extra = []) { return manifestFromPack(LINEAR_ACTION_PACK, extra); }
+export function guardLinearMutation(gate, client, args) { return adapter.guard(gate, client, args); }
+export default { LINEAR_ACTION_PACK, LINEAR_OPS, createLinearManifest, guardLinearMutation };

package/adapters/salesforce.js

@@ -0,0 +1,55 @@
+// SPDX-License-Identifier: Apache-2.0
+/**
+ * EMILIA Gate — Salesforce System-of-Record adapter.
+ * Guards bulk record delete, data export, and permission-set assignment so they
+ * never reach Salesforce without a receipt bound to THIS object. Client injected.
+ */
+import { createAdapter, manifestFromPack, hashCanonical } from './_kit.js';
+
+export const SALESFORCE_ACTION_PACK = Object.freeze([
+  Object.freeze({
+    id: 'salesforce.records.bulk_delete', label: 'Bulk delete records', action_type: 'salesforce.records.bulk_delete',
+    risk: 'critical', receipt_required: true, assurance_class: 'class_a',
+    match: { protocol: 'salesforce', tool: 'bulk_delete' },
+    why: 'Mass-destroys CRM records. Bind object + the exact SOQL.',
+    execution_binding: { required_fields: ['action_type', 'object', 'soql_hash'] },
+  }),
+  Object.freeze({
+    id: 'salesforce.data.export', label: 'Bulk data export', action_type: 'salesforce.data.export',
+    risk: 'high', receipt_required: true, assurance_class: 'class_a',
+    match: { protocol: 'salesforce', tool: 'export' },
+    why: 'Exfiltrates CRM data. Bind object + recipient.',
+    execution_binding: { required_fields: ['action_type', 'object', 'recipient'] },
+  }),
+  Object.freeze({
+    id: 'salesforce.permission_set.assign', label: 'Assign permission set', action_type: 'salesforce.permission_set.assign',
+    risk: 'critical', receipt_required: true, assurance_class: 'quorum',
+    match: { protocol: 'salesforce', tool: 'assign_permission_set' },
+    why: 'Grants privileges. Quorum + bind user + permission set.',
+    execution_binding: { required_fields: ['action_type', 'user', 'permission_set'] },
+  }),
+]);
+
+const OPS = {
+  'records.bulk_delete': {
+    selector: { protocol: 'salesforce', tool: 'bulk_delete' },
+    observed: (p) => ({ action_type: 'salesforce.records.bulk_delete', object: p.object, soql_hash: hashCanonical(String(p.soql || '').trim()) }),
+    perform: (c, p) => c.bulkDelete({ object: p.object, soql: p.soql }),
+  },
+  'data.export': {
+    selector: { protocol: 'salesforce', tool: 'export' },
+    observed: (p) => ({ action_type: 'salesforce.data.export', object: p.object, recipient: p.recipient }),
+    perform: (c, p) => c.export({ object: p.object, recipient: p.recipient }),
+  },
+  'permission_set.assign': {
+    selector: { protocol: 'salesforce', tool: 'assign_permission_set' },
+    observed: (p) => ({ action_type: 'salesforce.permission_set.assign', user: p.user, permission_set: p.permission_set }),
+    perform: (c, p) => c.assignPermissionSet({ user: p.user, permissionSet: p.permission_set }),
+  },
+};
+
+const adapter = createAdapter({ system: 'salesforce', ops: OPS });
+export const SALESFORCE_OPS = adapter.OPS;
+export function createSalesforceManifest(extra = []) { return manifestFromPack(SALESFORCE_ACTION_PACK, extra); }
+export function guardSalesforceMutation(gate, client, args) { return adapter.guard(gate, client, args); }
+export default { SALESFORCE_ACTION_PACK, SALESFORCE_OPS, createSalesforceManifest, guardSalesforceMutation };

package/adapters/stripe.js

@@ -0,0 +1,82 @@
+// SPDX-License-Identifier: Apache-2.0
+/**
+ * EMILIA Gate — Stripe / payments System-of-Record adapter.
+ *
+ * "Install this before your agent can move money." Wraps the destructive Stripe
+ * operations so a payout, refund, or payout-destination change never reaches
+ * Stripe without a valid, sufficiently-assured, non-replayed receipt bound to
+ * THIS amount/destination. A receipt for $100 to acct_A cannot authorize
+ * $10,000 to acct_B.
+ *
+ *   import Stripe from 'stripe';
+ *   import { createGate } from '@emilia-protocol/gate';
+ *   import { createStripeManifest, guardStripeMutation } from '@emilia-protocol/gate/adapters/stripe';
+ *
+ *   const gate = createGate({ manifest: createStripeManifest(), trustedKeys: [ISSUER] });
+ *   await guardStripeMutation(gate, new Stripe(key), {
+ *     op: 'payout.create', params: { amount: 40000, currency: 'usd', destination: 'acct_x' }, receipt,
+ *   });
+ */
+import { createAdapter, manifestFromPack } from './_kit.js';
+
+export const STRIPE_ACTION_PACK = Object.freeze([
+  Object.freeze({
+    id: 'stripe.payout.create', label: 'Stripe payout', action_type: 'stripe.payout.create',
+    risk: 'critical', receipt_required: true, assurance_class: 'class_a',
+    match: { protocol: 'stripe', tool: 'create_payout' },
+    why: 'Moves money out. Bind amount/currency/destination to a named human approval.',
+    execution_binding: { required_fields: ['action_type', 'amount', 'currency', 'destination'] },
+  }),
+  Object.freeze({
+    id: 'stripe.refund.create', label: 'Stripe refund', action_type: 'stripe.refund.create',
+    risk: 'high', receipt_required: true, assurance_class: 'class_a',
+    match: { protocol: 'stripe', tool: 'create_refund' },
+    why: 'Returns funds. Bind the payment and amount so a refund cannot be silently inflated.',
+    execution_binding: { required_fields: ['action_type', 'payment_intent', 'amount'] },
+  }),
+  Object.freeze({
+    id: 'stripe.bank_account.change', label: 'Stripe payout-destination change', action_type: 'stripe.bank_account.change',
+    risk: 'critical', receipt_required: true, assurance_class: 'quorum',
+    match: { protocol: 'stripe', tool: 'update_external_account' },
+    why: 'Changes WHERE future money flows. Quorum: the classic redirect-the-payouts attack.',
+    execution_binding: { required_fields: ['action_type', 'account', 'external_account'] },
+  }),
+]);
+
+const OPS = {
+  'payout.create': {
+    selector: { protocol: 'stripe', tool: 'create_payout' },
+    observed: (p) => ({ action_type: 'stripe.payout.create', amount: p.amount, currency: p.currency, destination: p.destination }),
+    perform: (stripe, p) => stripe.payouts.create({ amount: p.amount, currency: p.currency, destination: p.destination }),
+  },
+  'refund.create': {
+    selector: { protocol: 'stripe', tool: 'create_refund' },
+    observed: (p) => ({ action_type: 'stripe.refund.create', payment_intent: p.payment_intent, amount: p.amount }),
+    perform: (stripe, p) => stripe.refunds.create({ payment_intent: p.payment_intent, amount: p.amount }),
+  },
+  'bank_account.change': {
+    selector: { protocol: 'stripe', tool: 'update_external_account' },
+    observed: (p) => ({ action_type: 'stripe.bank_account.change', account: p.account, external_account: p.external_account }),
+    perform: (stripe, p) => stripe.accounts.updateExternalAccount(p.account, p.external_account, p.update || {}),
+  },
+};
+
+const adapter = createAdapter({ system: 'stripe', ops: OPS });
+export const STRIPE_OPS = adapter.OPS;
+
+export function createStripeManifest(extraActions = []) {
+  return manifestFromPack(STRIPE_ACTION_PACK, extraActions);
+}
+
+/**
+ * Guard a destructive Stripe mutation behind the gate.
+ * @param {object} gate    a gate built with createStripeManifest()
+ * @param {object} stripe  a Stripe-like client (the official `stripe` SDK or compatible)
+ * @param {object} o       { op:'payout.create'|'refund.create'|'bank_account.change', params, receipt }
+ * @throws Error{code:'EMILIA_RECEIPT_REQUIRED'} if refused — the call never reaches Stripe
+ */
+export function guardStripeMutation(gate, stripe, args) {
+  return adapter.guard(gate, stripe, args);
+}
+
+export default { STRIPE_ACTION_PACK, STRIPE_OPS, createStripeManifest, guardStripeMutation };