@dobbyai/mcp-external 1.0.4 → 1.1.0

package/dist/tools/governance.js

@@ -0,0 +1,171 @@
+/**
+ * Governance MCP Tools
+ *
+ * Policy-as-Code operations via MCP for Claude Desktop/Cursor/VS Code users.
+ * 4 tools:
+ *   1. export_policies       — Export org governance policies as YAML/JSON
+ *   2. import_policies       — Import policies from YAML/JSON
+ *   3. validate_policies     — Dry-run validate a policy document
+ *   4. apply_guardrail       — Apply a guardrail template to an org
+ */
+// ============================================
+// Tool Definitions
+// ============================================
+export const governanceTools = {
+    export_policies: {
+        name: 'export_policies',
+        annotations: {
+            title: 'Export Policies',
+            readOnlyHint: true,
+            destructiveHint: false,
+            openWorldHint: false,
+        },
+        description: 'Export all governance policies for an organization as YAML or JSON. Returns a PolicyDocument with organization policies, gateway config, budgets, and kill-switch state. Useful for backup, version control, or cross-org deployment.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                organization_id: {
+                    type: 'string',
+                    description: 'Organization ID (org_xxx)',
+                },
+                format: {
+                    type: 'string',
+                    enum: ['yaml', 'json'],
+                    description: 'Export format (default: yaml)',
+                    default: 'yaml',
+                },
+            },
+            required: ['organization_id'],
+        },
+    },
+    import_policies: {
+        name: 'import_policies',
+        annotations: {
+            title: 'Import Policies',
+            readOnlyHint: false,
+            destructiveHint: true,
+            openWorldHint: false,
+        },
+        description: 'Import governance policies from a YAML/JSON document into an organization. Upserts policies by name — existing policies are updated, new ones are created. Kill-switch state is NOT imported for safety.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                organization_id: {
+                    type: 'string',
+                    description: 'Target organization ID (org_xxx)',
+                },
+                content: {
+                    type: 'string',
+                    description: 'Policy document content (YAML or JSON string)',
+                },
+            },
+            required: ['organization_id', 'content'],
+        },
+    },
+    validate_policies: {
+        name: 'validate_policies',
+        annotations: {
+            title: 'Validate Policies',
+            readOnlyHint: true,
+            destructiveHint: false,
+            openWorldHint: false,
+        },
+        description: 'Dry-run validate a policy document without applying it. Returns validation errors, warnings, and a diff showing what would change compared to current org state.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                organization_id: {
+                    type: 'string',
+                    description: 'Organization ID to validate against (org_xxx)',
+                },
+                content: {
+                    type: 'string',
+                    description: 'Policy document content (YAML or JSON string)',
+                },
+            },
+            required: ['organization_id', 'content'],
+        },
+    },
+    apply_guardrail: {
+        name: 'apply_guardrail',
+        annotations: {
+            title: 'Apply Guardrail',
+            readOnlyHint: false,
+            destructiveHint: true,
+            openWorldHint: false,
+        },
+        description: 'Apply a pre-built guardrail template to an organization. Templates include: conservative, balanced, enterprise, hipaa, sox, gdpr. Each template configures organization policies, gateway settings, and content rules appropriate for the compliance scenario.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                organization_id: {
+                    type: 'string',
+                    description: 'Organization ID (org_xxx)',
+                },
+                template: {
+                    type: 'string',
+                    enum: ['conservative', 'balanced', 'enterprise', 'hipaa', 'sox', 'gdpr'],
+                    description: 'Guardrail template name',
+                },
+            },
+            required: ['organization_id', 'template'],
+        },
+    },
+};
+// ============================================
+// Tool Handlers
+// ============================================
+export async function handleExportPolicies(args, client) {
+    const format = args.format || 'yaml';
+    const response = await client.post(`/api/v1/organizations/${args.organization_id}/policies/export`, { format });
+    if (typeof response === 'string') {
+        return response;
+    }
+    return JSON.stringify(response, null, 2);
+}
+export async function handleImportPolicies(args, client) {
+    const response = await client.post(`/api/v1/organizations/${args.organization_id}/policies/import`, { content: args.content });
+    const result = response;
+    if (result.success) {
+        return `Import successful: ${result.policiesCreated} created, ${result.policiesUpdated} updated` +
+            (result.gatewayPolicyUpdated ? ', gateway policy updated' : '') +
+            (result.errors?.length ? `\nWarnings: ${result.errors.join('; ')}` : '');
+    }
+    return `Import failed: ${result.errors?.join('; ') || 'Unknown error'}`;
+}
+export async function handleValidatePolicies(args, client) {
+    const response = await client.post(`/api/v1/organizations/${args.organization_id}/policies/validate`, { content: args.content });
+    const result = response;
+    const lines = [];
+    lines.push(`Valid: ${result.valid ? 'Yes' : 'No'}`);
+    if (result.errors?.length) {
+        lines.push(`\nErrors (${result.errors.length}):`);
+        result.errors.forEach((e) => lines.push(`  - ${e.path}: ${e.message}`));
+    }
+    if (result.warnings?.length) {
+        lines.push(`\nWarnings (${result.warnings.length}):`);
+        result.warnings.forEach((w) => lines.push(`  - ${w.path}: ${w.message}`));
+    }
+    if (result.diff) {
+        const d = result.diff;
+        if (d.added?.length)
+            lines.push(`\nAdded: ${d.added.join(', ')}`);
+        if (d.removed?.length)
+            lines.push(`Removed: ${d.removed.join(', ')}`);
+        if (d.changed?.length) {
+            lines.push(`Changed (${d.changed.length}):`);
+            d.changed.forEach((c) => lines.push(`  - ${c.path}`));
+        }
+    }
+    return lines.join('\n');
+}
+export async function handleApplyGuardrail(args, client) {
+    const response = await client.post(`/api/v1/organizations/${args.organization_id}/policies/templates`, { template: args.template });
+    const result = response;
+    if (result.success) {
+        return `Guardrail '${args.template}' applied: ${result.policiesCreated} policies created, ${result.policiesUpdated} updated` +
+            (result.gatewayPolicyUpdated ? ', gateway config updated' : '');
+    }
+    return `Failed to apply template: ${result.errors?.join('; ') || result.error || 'Unknown error'}`;
+}
+//# sourceMappingURL=governance.js.map

package/dist/tools/governance.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"governance.js","sourceRoot":"","sources":["../../src/tools/governance.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAIH,+CAA+C;AAC/C,mBAAmB;AACnB,+CAA+C;AAE/C,MAAM,CAAC,MAAM,eAAe,GAAG;IAC7B,eAAe,EAAE;QACf,IAAI,EAAE,iBAAiB;QACvB,WAAW,EAAE;YACX,KAAK,EAAE,iBAAiB;YACxB,YAAY,EAAE,IAAI;YAClB,eAAe,EAAE,KAAK;YACtB,aAAa,EAAE,KAAK;SACrB;QACD,WAAW,EACT,uOAAuO;QACzO,WAAW,EAAE;YACX,IAAI,EAAE,QAAiB;YACvB,UAAU,EAAE;gBACV,eAAe,EAAE;oBACf,IAAI,EAAE,QAAQ;oBACd,WAAW,EAAE,2BAA2B;iBACzC;gBACD,MAAM,EAAE;oBACN,IAAI,EAAE,QAAQ;oBACd,IAAI,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC;oBACtB,WAAW,EAAE,+BAA+B;oBAC5C,OAAO,EAAE,MAAM;iBAChB;aACF;YACD,QAAQ,EAAE,CAAC,iBAAiB,CAAC;SAC9B;KACF;IAED,eAAe,EAAE;QACf,IAAI,EAAE,iBAAiB;QACvB,WAAW,EAAE;YACX,KAAK,EAAE,iBAAiB;YACxB,YAAY,EAAE,KAAK;YACnB,eAAe,EAAE,IAAI;YACrB,aAAa,EAAE,KAAK;SACrB;QACD,WAAW,EACT,0MAA0M;QAC5M,WAAW,EAAE;YACX,IAAI,EAAE,QAAiB;YACvB,UAAU,EAAE;gBACV,eAAe,EAAE;oBACf,IAAI,EAAE,QAAQ;oBACd,WAAW,EAAE,kCAAkC;iBAChD;gBACD,OAAO,EAAE;oBACP,IAAI,EAAE,QAAQ;oBACd,WAAW,EAAE,+CAA+C;iBAC7D;aACF;YACD,QAAQ,EAAE,CAAC,iBAAiB,EAAE,SAAS,CAAC;SACzC;KACF;IAED,iBAAiB,EAAE;QACjB,IAAI,EAAE,mBAAmB;QACzB,WAAW,EAAE;YACX,KAAK,EAAE,mBAAmB;YAC1B,YAAY,EAAE,IAAI;YAClB,eAAe,EAAE,KAAK;YACtB,aAAa,EAAE,KAAK;SACrB;QACD,WAAW,EACT,kKAAkK;QACpK,WAAW,EAAE;YACX,IAAI,EAAE,QAAiB;YACvB,UAAU,EAAE;gBACV,eAAe,EAAE;oBACf,IAAI,EAAE,QAAQ;oBACd,WAAW,EAAE,+CAA+C;iBAC7D;gBACD,OAAO,EAAE;oBACP,IAAI,EAAE,QAAQ;oBACd,WAAW,EAAE,+CAA+C;iBAC7D;aACF;YACD,QAAQ,EAAE,CAAC,iBAAiB,EAAE,SAAS,CAAC;SACzC;KACF;IAED,eAAe,EAAE;QACf,IAAI,EAAE,iBAAiB;QACvB,WAAW,EAAE;YACX,KAAK,EAAE,iBAAiB;YACxB,YAAY,EAAE,KAAK;YACnB,eAAe,EAAE,IAAI;YACrB,aAAa,EAAE,KAAK;SACrB;QACD,WAAW,EACT,gQAAgQ;QAClQ,WAAW,EAAE;YACX,IAAI,EAAE,QAAiB;YACvB,UAAU,EAAE;gBACV,eAAe,EAAE;oBACf,IAAI,EAAE,QAAQ;oBACd,WAAW,EAAE,2BAA2B;iBACzC;gBACD,QAAQ,EAAE;oBACR,IAAI,EAAE,QAAQ;oBACd,IAAI,EAAE,CAAC,cAAc,EAAE,UAAU,EAAE,YAAY,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,CAAC;oBACxE,WAAW,EAAE,yBAAyB;iBACvC;aACF;YACD,QAAQ,EAAE,CAAC,iBAAiB,EAAE,UAAU,CAAC;SAC1C;KACF;CACF,CAAC;AAEF,+CAA+C;AAC/C,gBAAgB;AAChB,+CAA+C;AAE/C,MAAM,CAAC,KAAK,UAAU,oBAAoB,CACxC,IAAkD,EAClD,MAAmB;IAEnB,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,IAAI,MAAM,CAAC;IACrC,MAAM,QAAQ,GAAG,MAAM,MAAM,CAAC,IAAI,CAChC,yBAAyB,IAAI,CAAC,eAAe,kBAAkB,EAC/D,EAAE,MAAM,EAAE,CACX,CAAC;IAEF,IAAI,OAAO,QAAQ,KAAK,QAAQ,EAAE,CAAC;QACjC,OAAO,QAAQ,CAAC;IAClB,CAAC;IACD,OAAO,IAAI,CAAC,SAAS,CAAC,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;AAC3C,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,oBAAoB,CACxC,IAAkD,EAClD,MAAmB;IAEnB,MAAM,QAAQ,GAAG,MAAM,MAAM,CAAC,IAAI,CAChC,yBAAyB,IAAI,CAAC,eAAe,kBAAkB,EAC/D,EAAE,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE,CAC1B,CAAC;IAEF,MAAM,MAAM,GAAG,QAAe,CAAC;IAC/B,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC;QACnB,OAAO,sBAAsB,MAAM,CAAC,eAAe,aAAa,MAAM,CAAC,eAAe,UAAU;YAC9F,CAAC,MAAM,CAAC,oBAAoB,CAAC,CAAC,CAAC,0BAA0B,CAAC,CAAC,CAAC,EAAE,CAAC;YAC/D,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC,eAAe,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;IAC7E,CAAC;IACD,OAAO,kBAAkB,MAAM,CAAC,MAAM,EAAE,IAAI,CAAC,IAAI,CAAC,IAAI,eAAe,EAAE,CAAC;AAC1E,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,sBAAsB,CAC1C,IAAkD,EAClD,MAAmB;IAEnB,MAAM,QAAQ,GAAG,MAAM,MAAM,CAAC,IAAI,CAChC,yBAAyB,IAAI,CAAC,eAAe,oBAAoB,EACjE,EAAE,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE,CAC1B,CAAC;IAEF,MAAM,MAAM,GAAG,QAAe,CAAC;IAC/B,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,KAAK,CAAC,IAAI,CAAC,UAAU,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;IAEpD,IAAI,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC;QAC1B,KAAK,CAAC,IAAI,CAAC,aAAa,MAAM,CAAC,MAAM,CAAC,MAAM,IAAI,CAAC,CAAC;QAClD,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAM,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC;IAC/E,CAAC;IACD,IAAI,MAAM,CAAC,QAAQ,EAAE,MAAM,EAAE,CAAC;QAC5B,KAAK,CAAC,IAAI,CAAC,eAAe,MAAM,CAAC,QAAQ,CAAC,MAAM,IAAI,CAAC,CAAC;QACtD,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAM,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC;IACjF,CAAC;IACD,IAAI,MAAM,CAAC,IAAI,EAAE,CAAC;QAChB,MAAM,CAAC,GAAG,MAAM,CAAC,IAAI,CAAC;QACtB,IAAI,CAAC,CAAC,KAAK,EAAE,MAAM;YAAE,KAAK,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QAClE,IAAI,CAAC,CAAC,OAAO,EAAE,MAAM;YAAE,KAAK,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACtE,IAAI,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,CAAC;YACtB,KAAK,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC,OAAO,CAAC,MAAM,IAAI,CAAC,CAAC;YAC7C,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,CAAM,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC;QAC7D,CAAC;IACH,CAAC;IAED,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,oBAAoB,CACxC,IAAmD,EACnD,MAAmB;IAEnB,MAAM,QAAQ,GAAG,MAAM,MAAM,CAAC,IAAI,CAChC,yBAAyB,IAAI,CAAC,eAAe,qBAAqB,EAClE,EAAE,QAAQ,EAAE,IAAI,CAAC,QAAQ,EAAE,CAC5B,CAAC;IAEF,MAAM,MAAM,GAAG,QAAe,CAAC;IAC/B,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC;QACnB,OAAO,cAAc,IAAI,CAAC,QAAQ,cAAc,MAAM,CAAC,eAAe,sBAAsB,MAAM,CAAC,eAAe,UAAU;YAC1H,CAAC,MAAM,CAAC,oBAAoB,CAAC,CAAC,CAAC,0BAA0B,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;IACpE,CAAC;IACD,OAAO,6BAA6B,MAAM,CAAC,MAAM,EAAE,IAAI,CAAC,IAAI,CAAC,IAAI,MAAM,CAAC,KAAK,IAAI,eAAe,EAAE,CAAC;AACrG,CAAC"}